Skip to content

Document compiler-generated job authentication - #54100

Merged
pelikhan merged 2 commits into
mainfrom
copilot/add-jobs-instruction-file
Aug 20, 2026
Merged

Document compiler-generated job authentication#54100
pelikhan merged 2 commits into
mainfrom
copilot/add-jobs-instruction-file

Conversation

CopilotAI commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Adds a reference mapping compiler-generated workflow and maintenance jobs to their credential configuration points.

  • Job reference

    • Documents generated job IDs, conditions, dependencies, and roles.
    • Covers state, evaluation, and safe-output fan-out jobs.
  • Authentication mapping

    • Maps trigger, agent, and safe-output jobs to github-token and github-app configuration.
    • Preserves read-only agent/detection isolation and safe-output write boundaries.
  • Agent discovery

    • Registers jobs.md in the embedded .github/aw fallback file list.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

@pelikhanpelikhan left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Optimize this instruction file for agentic consumption and information density.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

CopilotAI commented Aug 20, 2026

Copy link
Copy Markdown
ContributorAuthor

@copilot Optimize this instruction file for agentic consumption and information density.

Optimized in cea0974: condensed the reference into credential and job-graph lookup tables while preserving generated-job and permission-boundary details.

CopilotAI requested a review from pelikhanAugust 20, 2026 00:43
@pelikhan
pelikhan marked this pull request as ready for review August 20, 2026 00:44
CopilotAI balanced review requested due to automatic review settings August 20, 2026 00:44
@pelikhan
pelikhan merged commit 6486d10 into mainAug 20, 2026
1 check passed
@pelikhan
pelikhan deleted the copilot/add-jobs-instruction-file branch August 20, 2026 00:44

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents compiler-generated workflow jobs and their authentication boundaries, and exposes the reference through agent discovery.

Changes:

  • Adds a generated-job and credential reference.
  • Registers jobs.md in the embedded fallback list.
Show a summary per file
FileDescription
.github/aw/jobs.mdDocuments generated jobs, dependencies, and authentication.
pkg/cli/data/agentic_workflows_fallback_aw_files.jsonAdds the new reference to fallback discovery.

Review details

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Suppressed comments (1)

.github/aw/jobs.md:45

  • The call job does not accept a called-workflow token/app input. It forwards the worker's declared secrets and permission envelope, so credentials must be configured on the consuming feature inside the called workflow. The current wording directs users to a nonexistent input path.
| `call-<sanitized-worker-name>` | `safe-outputs.call-workflow` worker | — | Configure the called workflow input through the worker's `github-token` or `github-app`. |
  • Files reviewed: 2/2 changed files
  • Comments generated: 3
  • Review effort level: Balanced

Comment thread.github/aw/jobs.md
Comment on lines +7 to +9
Generated job IDs are reserved. Built-in job configuration may add
`setup-steps`, `pre-steps`, `needs`, and `if`; it cannot replace compiler-managed
permissions or authentication.
Comment thread.github/aw/jobs.md
|---|---|---|
| `pre_activation`, `activation` | `on.github-token` | `on.github-app` |
| `agent` | `tools.github.github-token: ${{ secrets.MY_TOKEN }}` | `tools.github.github-app` |
| `safe_outputs`, `upload_assets`, `upload_code_scanning_sarif`, `call-*` | `safe-outputs.github-token` or handler `github-token` | `safe-outputs.github-app` or handler `github-app` |
Comment thread.github/aw/jobs.md
Comment on lines +29 to +30
| Job | Created when | Needs | Notes |
|---|---|---|---|
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This pull request is included in a new release.

Release: v0.87.2

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@pelikhan