Skip to content

ci(verify): automate downstream consumer verification fan-out (network_system, pacs_system)#702

Open
kcenon wants to merge 1 commit into
developfrom
ci/issue-695-downstream-verification-fan-out
Open

ci(verify): automate downstream consumer verification fan-out (network_system, pacs_system)#702
kcenon wants to merge 1 commit into
developfrom
ci/issue-695-downstream-verification-fan-out

Conversation

@kcenon
Copy link
Copy Markdown
Owner

@kcenon kcenon commented May 31, 2026

Closes #695

Summary

Adds .github/workflows/downstream-verification.yml — a workflow_dispatch fan-out that triggers the network_system and pacs_system sanitizer and integration-tests gates from a single invocation, replacing the four per-repo gh workflow run commands documented in VERIFICATION_GATES.md.

  • Matrix: {network_system, pacs_system} × {sanitizers.yml, integration-tests.yml} (all four target workflows already expose workflow_dispatch).
  • Cross-repo dispatch uses a DOWNSTREAM_DISPATCH_TOKEN secret — the default GITHUB_TOKEN cannot dispatch workflows in other repositories. A missing secret fails the job with actionable guidance.
  • Each dispatch and a link to its result runs are written to the workflow's job summary.

Acceptance criteria

  • Downstream verification can be triggered without manual per-repo commands — one workflow_dispatch fans out to all four gates.
  • VERIFICATION_GATES.md reflects the automated path — the Downstream Consumer Verification section documents the fan-out as preferred (manual commands kept as fallback), and the Missing Gates / Follow-up gap is marked closed.
  • Release checklist references the automated downstream result — added to the PRODUCTION_QUALITY.md production readiness checklist.

Test Plan

  • Workflow YAML validated (parses; workflow_dispatch trigger + 2×2 matrix present).
  • Functional dispatch requires the DOWNSTREAM_DISPATCH_TOKEN secret to be configured by a maintainer; the workflow self-reports a clear error if it is absent.

Setup note

To enable the fan-out, add a repository (or org) secret DOWNSTREAM_DISPATCH_TOKEN containing a PAT able to dispatch workflows in kcenon/network_system and kcenon/pacs_system (classic: repo + workflow; fine-grained: actions: write).

Add .github/workflows/downstream-verification.yml: a workflow_dispatch
fan-out that triggers the network_system and pacs_system sanitizer and
integration-tests workflows from a single invocation, replacing the
per-repo 'gh workflow run' commands documented in VERIFICATION_GATES.md.
The matrix covers both consumers x both gates; each dispatch and its
result-runs link are recorded in the job summary. Cross-repo dispatch
uses the DOWNSTREAM_DISPATCH_TOKEN secret (the default GITHUB_TOKEN
cannot dispatch into other repositories); a missing secret fails the
job with actionable guidance.

Update docs/contributing/VERIFICATION_GATES.md: document the automated
fan-out as the preferred path (manual commands kept as fallback) and
mark the 'automated downstream verification' follow-up gap as closed.
Reference the automated downstream gate in the PRODUCTION_QUALITY.md
production readiness checklist.

Closes #695
Sign up for free to 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.

1 participant