Add support for full GitHub actions specification in jobs field and automatic job dependencies

[Copilot]

Add Full GitHub Actions Step Specification Support to Jobs Field

This PR adds complete GitHub Actions step specification support to the jobs field in workflow frontmatter, allowing users to utilize all standard step properties when defining custom jobs. It also introduces automatic job dependency management for the agent job.

Changes Made

Schema Updates (pkg/parser/schemas/main_workflow_schema.json):

• Replaced the restrictive step schema with a complete GitHub Actions step specification
• Added support for all standard step properties: id, if, name, uses, run, with, env, continue-on-error, timeout-minutes, working-directory, shell
• Implemented proper validation using oneOf constraint to ensure steps have either uses or run (but not both or neither)

Test Coverage (pkg/workflow/jobs_full_spec_test.go):

• Added comprehensive tests covering all step properties
• Tests verify properties are correctly preserved during compilation
• Tests validate schema enforcement of step constraints

Compiler Enhancement (pkg/workflow/compiler_jobs.go):

• Modified buildMainJob to automatically add custom job names as dependencies
• Agent job now waits for all custom jobs defined in frontmatter before executing
• Enables workflows to define prerequisite jobs that run before the AI agent

Super-Linter Workflow Update (.github/workflows/super-linter-report.md):

• Moved linter steps from frontmatter into a custom super_linter job
• Agent job automatically depends on super_linter job completion
• Agent downloads super-linter.log artifact after linter completes
• Demonstrates custom jobs with artifact upload/download pattern

Main Branch Merge:

• Successfully merged latest changes from main branch
• Resolved merge conflicts in super-linter-report.lock.yml
• All workflows recompiled successfully
• All tests pass after merge

Problem Solved

Previously, the jobs field defined steps with a restrictive schema:

"steps": {
  "type": "array",
  "items": {
    "type": "object",
    "additionalProperties": false  // Too restrictive!
  }
}

This prevented users from:

1. Using standard GitHub Actions step properties like id, env, timeout-minutes, etc.
2. Defining custom jobs that run before the AI agent

Now users can:

1. Specify complete step configurations matching the full GitHub Actions specification
2. Define custom jobs that the agent automatically waits for before executing
3. Share data between custom jobs and the agent via artifacts or outputs

Testing

• ✅ All unit tests pass (make test-unit)
• ✅ Code formatting validates (make fmt)
• ✅ Linting passes (make lint)
• ✅ Full agent-finish validation passes
• ✅ All 74 repository workflows compile successfully
• ✅ Comprehensive new tests validate step property support and schema validation
• ✅ Super-linter workflow demonstrates custom job dependencies
• ✅ Successfully merged with main branch
• ✅ All tests pass after merge

The implementation allows users to use the full GitHub Actions step specification in their custom jobs with proper validation and support for all standard properties, plus automatic job dependency management.

Original prompt

Add support for full GitHub actions specification in front matter "jobs" field. Currently the steps are not full GitHub actions specification steps. Reuse existing types in the JSON schema and ensure the compiler parses the job correctly.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot keep working

[Copilot]

@copilot keep working

Implementation completed in e8adda7. The jobs field now supports the full GitHub Actions step specification including all standard properties: id, if, name, uses, run, with, env, continue-on-error, timeout-minutes, working-directory, and shell. Schema validation enforces proper step structure (requires either uses or run). All tests pass including comprehensive new tests for step property validation.

[pelikhan]

@copilot update the super-linter agentic workflow: move the steps in the front matter into a job (super_linter) and add a needs dependency to the agent job as 'super_linter'. The super_linter job should upload the super-linter logs as an artifact (super-linter.log) and the agent should download the super-linter.log artifacts.

[pelikhan]

@copilot keep working

[pelikhan]

@copilot keep working

[Copilot]

@copilot keep working

Completed in aa73e19. The super-linter workflow has been updated:

• Moved linter steps into a super_linter custom job
• Agent job automatically depends on super_linter job (via automatic dependency detection)
• Agent downloads the super-linter.log artifact uploaded by the linter job
• All environment variables in the super-linter step have been converted to strings for schema compliance

The implementation adds automatic dependency management: the agent job now automatically waits for all custom jobs defined in the frontmatter before executing.

[pelikhan]

@copilot Merge main

[Copilot]

Pull Request Overview

This PR adds complete GitHub Actions step specification support to the jobs field in workflow frontmatter and introduces automatic job dependency management. Users can now define custom jobs using all standard GitHub Actions step properties, and the agent job automatically waits for custom jobs to complete before executing.

Key changes:

• Enhanced step schema to support all GitHub Actions step properties with proper validation
• Added automatic dependency injection so custom jobs run before the agent job
• Refactored super-linter workflow to use a custom job that runs before the agent

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
pkg/parser/schemas/main_workflow_schema.json	Replaced restrictive step schema with complete GitHub Actions specification including all standard properties
pkg/workflow/compiler_jobs.go	Added logic to automatically make agent job depend on custom jobs
pkg/workflow/jobs_full_spec_test.go	Added comprehensive tests for full step specification and validation
.github/workflows/super-linter-report.md	Refactored to demonstrate custom job pattern with super_linter job
.github/workflows/super-linter-report.lock.yml	Generated workflow reflecting custom job dependencies
docs/src/content/docs/status.mdx	Added super-linter-report workflow to status page

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

@copilot Merge main

Main branch merged successfully in c800483. Resolved merge conflicts in super-linter-report.lock.yml and recompiled all workflows. All tests pass after the merge.