Skip to content

docs(adr): ADR-0061, add the image APT component on the first publication run (amends ADR-0059 step 3) - #167

Merged
bketelsen merged 1 commit into
mainfrom
lucilla/adr-0061-image-auto-add
Oct 25, 2026
Merged

bketelsen merged 1 commit into
mainfrom
lucilla/adr-0061-image-auto-add

Conversation

@frostyard-machines

@frostyard-machines frostyard-machines commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Records Brian's decision T215a (2026-10-25, option a): apt-publisher adds the empty APT component image to trixie and forky by itself, on the first publication run after frostyard/apt-publisher#16 merges. No gap, no manual run.

ADR-0059 step 3 says "apt-publisher, manual run". Accepted ADRs are semantically immutable (ADR-0001, TEMPLATE.md), and ADR-0033 permits only link maintenance in them. So this PR follows the ADR-0053/ADR-0012 pattern:

  • New ADR-0061 (Accepted, 2026-10-25) amends only ADR-0059 step 3 and the order of steps 2 and 3: the first publication run adds image; the rest of step 2 (key file, Debian-name audit, move workflow, apt-publisher ADR-0002) can follow the empty image; step 4 starts when both Release files list image; step 5 still waits for step 2. Evidence links: apt-publisher#15 (mechanism) and [org] publish-to-r2 consumed @main in bootc-debian, first-setup, and incus #16 (configuration and addition).
  • ADR-0059: one separately labelled Amended by: ADR-0061 link in References (ADR-0033 successor link). No other text changes.
  • docs/README.md: index line for 0061.

The ADR states facts only (ADR-0051); the decision's origin (T215a) is here, not in the ADR. Merging the PR accepts ADR-0061; if Brian prefers a Proposed stage first, the status line changes to Proposed.

Risk tier

Risk tier: 1 — docs only (a new ADR, one link line, one index line). It changes no code and no live system. The live change is apt-publisher#16 (risk high there).

Docs housekeeping

  • New docs started from their category's TEMPLATE.md
  • Every new doc indexed in docs/README.md
  • Cross-links added in both directions (ADR-0061 → ADR-0059 "Amends"; ADR-0059 → ADR-0061 "Amended by")
  • New significant decision recorded as an ADR first, in this PR
  • New/edited ADRs are fact-only (ADR-0051)
  • Conformance aliases (ADR-0029) untouched

Verification

  • npm run check green locally (check-docs: docs_index_coverage 1.000, link_integrity 1.000, symlink_resolution 1.000; check-scripts; tests)

Cross-review

  • Reviewer openai/gpt-6.1-sol, coder claude-opus. Base e783a9a, head ffed672. It checked ADR-0061's claims against apt-publisher#16 at fff7344.
  • Initial review: Ready, Blocking: none, no findings.
  • CI at ffed672: docs-gate, fleet-conventions, scaffold-e2e pass.

@frostyard-machines frostyard-machines added the ready-for-human Reviewed, CI green: ready for Brian to review and merge label Oct 25, 2026
@bketelsen
bketelsen added this pull request to the merge queue Oct 25, 2026
Merged via the queue into main with commit 07bf901 Oct 25, 2026
3 checks passed
@bketelsen
bketelsen deleted the lucilla/adr-0061-image-auto-add branch October 25, 2026 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-human Reviewed, CI green: ready for Brian to review and merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants