Skip to content

docs(handoff): the CI runbook names the Aegis leg and the real job count - #173

Merged
aliasfoxkde merged 2 commits into
mainfrom
docs/ci-runbook-aegis-leg
Nov 17, 2026
Merged

aliasfoxkde merged 2 commits into
mainfrom
docs/ci-runbook-aegis-leg

Conversation

@aliasfoxkde

Copy link
Copy Markdown
Owner

Summary

A documentation-only change, on purpose: it is the proof that the Aegis
secret/PII scan runs on a diff that touches no code.

docs/HANDOFF.md §6.1 described a ten-job pipeline and listed the jobs
that were not there. It now names all twelve, in order, and documents the
aegis job that decision 0132 added: no skip_if, the pinned scanner
installed through scripts/install-aegis.sh, and the installer's failure modes
exercised first by scripts/install-aegis-selftest.sh.

The diff is docs/HANDOFF.md and nothing else — 17 insertions, 7 deletions.
That is the point: this PR is the receipt for T27-62's stopping condition,
"the scan runs on a documentation-only change in both CI systems, and the job
logs show it". Before decision 0132 this diff would have been scanned by
neither system.

Verification

  • cargo run -p xtask -- ci passes — the parent change (#172) is
    green on 7bcf28fd: GitForge run 03cd5604 succeeded with all twelve
    jobs, and GitHub's gate is green on both the push and the PR event.
    This PR changes one documentation file and no code, so the gate it
    inherits is the gate of its parent.
  • The Aegis gate is green on this tree — the same parent receipt; the
    aegis job in run 03cd5604 reported [xtask] aegis ok
  • bash scripts/verify_release_ledger.sh . reports rows=62 tickets=62 problems=0 — unchanged by this diff
  • New behavior is covered by tests — none is added here; the behaviour
    being proven is CI wiring, whose test is scripts/install-aegis-selftest.sh
    in the parent change
  • Any new non-code asset has a docs/ATTRIBUTION.md row — no asset is
    added by this change
  • User-visible changes noted in docs/CHANGELOG.md — none: this change
    touches documentation only

What this PR does not claim: it does not claim the runbook is complete,
only that the pipeline shape it documents is the shape that now runs.

Clean-room attestation

This change contains no code, assets, or extracted constants copied
from proprietary sources; anything derived from observed behavior is
written fresh against public specs and evidence.

🤖 Generated with Claude Code

The CI runbook still described a ten-job pipeline and listed the jobs
that were not there. It now names all twelve, in order, and documents
the `aegis` job: it carries no `skip_if`, it installs the pinned scanner
through `scripts/install-aegis.sh`, and the installer's failure modes
are exercised first by `scripts/install-aegis-selftest.sh`.

The point of the runbook entry is that an agent reading it knows a
documentation-only change is still scanned, in both CI systems.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 7 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 8cef54fd-2209-462e-8fd9-4a4ee3051aba
Commits

Reviewing files that changed from the base of the PR and between 7bcf28f and 8c980ef.

Files selected for processing: 1

  • docs/HANDOFF.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

The GitForge mirror's `main` lagged `origin`'s `main` by twenty-five files,
so the pipeline's change classifier took its base from the stale mirror and
reported `CI_CHANGE_INCLUDE_CODE=1` for a diff that touches one
documentation file. The `aegis` job ran anyway — it carries no `skip_if` —
but the run could not show what the row needs to show: a diff classified as
documentation-only, scanned anyway.

The mirror's `main` is synced at `7bcf28fd`. This commit changes no file; it
re-runs the pipeline against the correct base, so the log shows
`CI_CHANGE_INCLUDE_CODE=0` and the scan still running.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@aliasfoxkde
aliasfoxkde merged commit 5ae7b91 into main Nov 17, 2026
13 checks passed
@aliasfoxkde
aliasfoxkde deleted the docs/ci-runbook-aegis-leg branch November 17, 2026 15:15
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