Skip to content

docs(parity): record the non-BuildKit Feature-staging gap as an open nonconformance - #720

Merged
pofallon merged 1 commit into
mainfrom
docs/ledger-row-719
Aug 28, 2026
Merged

docs(parity): record the non-BuildKit Feature-staging gap as an open nonconformance#720
pofallon merged 1 commit into
mainfrom
docs/ledger-row-719

Conversation

@pofallon

Copy link
Copy Markdown
Contributor

Filing #719 put the Ledger (issue coverage) check into exactly the state it exists to catch — a behavioral-scope issue asserting a deacon-vs-reference difference with no row citing it:

SPEC_STATUS.md: open issue #719 (`fix(features): stage Feature content without
BuildKit build contexts, as the reference does`) asserts a deacon-vs-reference
difference but no behavior row cites it

Verified red before this commit and green after (16 open issue(s) checked, every obligation discharged), rather than assumed.

What the row records

Both measured axes of the gap:

  • Compose Feature builds under podman — 3 of 7 fail with the classic builder doesn't support additional contexts, because podman runs its external compose provider with DOCKER_BUILDKIT=0. Only build:-shape services; the image: shape passes.
  • --buildkit never on plain docker — deacon refuses with Installing Features requires BuildKit, which the current settings disable.

That second one is worth stating precisely rather than lumping in: the refusal is honest and fail-fast, so it is not a defect on its own terms. It's the same missing capability wearing a better error. I'd assumed it was a silent failure until I ran it.

And what is deliberately not filed

The other three podman-lane exclusions are buildx exporter gaps. podman buildx version prints buildah 1.33.7 and exits 0, so the reference's own regex detection (dockerUtils.ts:245) would reach the same wrong conclusion, emit buildx build, and pass flags buildah rejects. Same failure on both sides is not a divergence — and writing that down is what stops it being re-investigated in three months.

Census: 233 recorded behaviors, 1 open nonconformance.

🤖 Generated with Claude Code

https://claude.ai/code/session_016SFzA2sTh2EpX8MZU3TWNS

…nonconformance

Filing issue 719 put the `Ledger (issue coverage)` check into the state it exists
to catch: a behavioral-scope issue asserting a deacon-vs-reference difference
with no row citing it. Verified red before this commit and green after, rather
than assumed.

The row carries both measured axes — compose Feature builds under podman, where
the provider runs with DOCKER_BUILDKIT=0, and `--buildkit never` on plain docker,
where deacon refuses cleanly rather than failing. The second is worth stating
precisely: the refusal is honest and fail-fast, so it is not a defect on its own
terms; it is the same missing capability wearing a better error.

It also records what is deliberately NOT filed. The other three podman-lane
exclusions are buildx exporter gaps, and `podman buildx version` printing
`buildah 1.33.7` with exit 0 means the reference's own regex detection would
reach the same wrong conclusion and pass the same rejected flags. Same failure on
both sides is not a divergence, and writing that down is what stops it being
re-investigated.

Census: 233 recorded behaviors, 1 open nonconformance.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016SFzA2sTh2EpX8MZU3TWNS
@github-actions github-actions Bot added the docs Documentation changes label Aug 28, 2026
@pofallon
pofallon merged commit 8db4717 into main Aug 28, 2026
15 of 16 checks passed
@pofallon
pofallon deleted the docs/ledger-row-719 branch August 28, 2026 12:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant