ci+docs: ADR-decision binding gate + AI-pipeline runbook (closes #166, closes #127)#205
Merged
Conversation
…closes #127) #166: a NON-BLOCKING online ADR<->decision binding check. scripts/ci/ check-adr-decision-binding.sh (POSIX sh, gh) reconciles closed decision-needed issues against ADR Issue: headers in both directions; .github/workflows/ adr-governance.yml runs it weekly + on-demand + on PRs touching the binding files, read-only perms, exits 0 on mismatch (advisory), exits 2 only on env failure. The offline check-adr-index.sh remains the hard gate. docs/adr/README.md updated to point at the live job instead of the 'tracked in #166' note. Completes #4 rule 6. #127: docs/AI_PIPELINE.md, the runbook for the AI-assisted design pipeline (agent fan-out mining -> independent adversarial verifier -> offline citation/ uniqueness gate -> human merge gate), with the trace-replay reproduction bar documented as harness-blocked/deferred. Absorbs #94. CI passes. Signed-off-by: Zeke <ezequiel.lares@outlook.com>
GNU comm (CI ubuntu) aborts with 'not in sorted order' when fed numerically- sorted input; BSD comm (macOS) tolerates it, so the job passed locally but failed in Actions. Sort lexically under LC_ALL=C so sort and comm agree on every runner. Verified exit 0 under both LC_ALL=C sh and dash; the advisory report is unchanged. Signed-off-by: Zeke <ezequiel.lares@outlook.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Final M1 PR. Authored + adversarially reviewed via workflow.
#166 (ADR<->decision binding): a non-blocking online check.
scripts/ci/check-adr-decision-binding.sh(POSIX sh, gh) reconciles closeddecision-neededissues against ADRIssue:headers both directions (closed decision with no ADR; ADR header pointing at a missing/open/unlabeled issue)..github/workflows/adr-governance.ymlruns it weekly + on-demand + on PRs touching the binding files, read-only perms, exits 0 on mismatch (advisory), exits 2 only on env failure. The offlinecheck-adr-index.shstays the hard gate.docs/adr/README.mdnow points at the live job. Completes #4 rule 6.#127 (AI pipeline):
docs/AI_PIPELINE.md, the runbook for the agent-fan-out-mining to adversarial-verifier to offline-gate to human-merge loop that produced claims.yaml and the AUDIT, with the trace-replay reproduction bar documented as harness-blocked/deferred. Absorbs #94.CI passes (prior-art, adr-index; new script sh-syntax-clean; workflow yaml valid). Closes #166, closes #127.
🤖 Generated with Claude Code