Skip to content

Commit 0d604a3

Browse files
Limit standard to caller contract
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent cf7d210 commit 0d604a3

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

docs/content/reference/process-workflow-fleet-standard.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ decisions before canonical guides, templates, or consumer workflows adopt it:
141141

142142
| Decision | Candidate | Alternatives still open |
143143
| --- | --- | --- |
144-
| Wrapper scope | Exactly one reusable-workflow job. | Permit repository-specific jobs in the same file, or define pre/post extension jobs. |
144+
| Contract scope | Standardize the `Process-PSModule` caller job and its shared workflow controls, not every job in the file. | Selected for the candidate; repository-owned jobs remain outside the caller contract. |
145145
| Trigger ownership | The caller owns manual, schedule, default-branch push, and pull-request triggers. | Move some trigger policy into separate workflows or omit selected event classes. |
146146
| Pull-request activities | Keep all six listed activity types. | Reduce the activity list if a v8 behavior is intentionally unsupported. |
147147
| Concurrency | Use the workflow plus PR-number-or-full-ref key and cancel only pull-request runs. | Selected for the candidate: PR reconciliation must be resumable; non-PR runs serialize by full ref. |
@@ -189,7 +189,7 @@ fleet campaign. Branch names, `latest`, floating minor tags, and unqualified tar
189189
| Event gate | Keep the caller unconditional and authorize capabilities in `Plan`. | The reusable workflow owns execution policy; fork pull requests may validate but cannot obtain App credentials, publish, deploy, clean up, or mutate repository state. |
190190
| Reference | Use the intended internal floating major tag (`v8`) after tag governance is enforced. | Compatible owned releases roll out centrally; breaking releases require a new major and campaign. |
191191
| Credentials | Explicitly map the three required secrets. | Satisfies the `v7+` contract and prevents unrelated secret inheritance. |
192-
| Scope | Keep the caller as a single delegation job. | Repository-specific automation remains independently understandable and maintainable. |
192+
| Scope | Require one conforming `Process-PSModule` delegation job. | Additional repository-owned jobs do not change caller conformance. |
193193

194194
## Candidate optional elements
195195

@@ -220,7 +220,6 @@ an approved structure:
220220
- a concurrency key other than workflow plus PR number or full ref, or cancellation behavior other than pull-request-only;
221221
- a caller-level fork or event-authorization condition;
222222
- trigger-level path filters that bypass Process-PSModule important-file evaluation;
223-
- unrelated additional jobs in the caller wrapper;
224223
- caller permissions beyond `contents: read`, `pages: write`, and `id-token: write`.
225224

226225
Use the built-in `GITHUB_TOKEN` for non-user-facing operations confined to the calling repository, including checkout
@@ -240,9 +239,10 @@ evaluating Settings. Privileged-context events such as
240239
`pull_request_target` remain unsupported unless separately designed to prevent untrusted code from crossing the
241240
credential boundary.
242241

243-
The candidate keeps repository-specific automation in a separate workflow file. That keeps the Process-PSModule wrapper
244-
identical enough for automated comparison while allowing modules to own unrelated schedules, generation, or integration
245-
tasks.
242+
The contract applies to the shared workflow controls and the `Process-PSModule` delegation job shown above. Repositories
243+
may define additional jobs in the same file or separate workflows. The inventory reports those jobs for visibility, but
244+
the contract does not prescribe their implementation. Additional jobs must not weaken or bypass the permissions,
245+
authorization, trigger, or concurrency controls governing the Process-PSModule call.
246246

247247
## Rollout boundary
248248

0 commit comments

Comments
 (0)