Skip to content

release: 1.2.0 — and tell consumers what changed about failing (C-111) - #299

Merged
Polichinel merged 1 commit into
developmentfrom
release/1.2.0
Aug 26, 2026
Merged

release: 1.2.0 — and tell consumers what changed about failing (C-111)#299
Polichinel merged 1 commit into
developmentfrom
release/1.2.0

Conversation

@Polichinel

Copy link
Copy Markdown
Collaborator

Bumps 1.1.11.2.0 and adds the CHANGELOG.md this repo has never had.

Why MINOR, not PATCH

New module delivery/findability.py, three new exception types, store_port.upload() now returns the file id, build_provenance gained a required kwarg.

Why the changelog is part of the release rather than after it

C-111's trigger is "the next version is cut". This is that release, and the delta puts three exception types on a path that escapes into a launcher:

exception what it replaces
DeliveryNotFindableError a delivery landing where the consumer can't see it, reporting success
FindabilityUnverifiedError "could not ask" silently treated as "asked and got nothing"
ProducerClientUnavailable a broken env degrading open and shipping unobserved months as observed history
TornRunError a torn upload leaving undocumented orphans

All deliberate. Each replaces a silent failure with a loud one. views-models would otherwise learn about them only from an integer in VIEWS_POSTPROCESSING_PIN.

Probes retired, and one lesson

S2 (2026-08-21) and H1 (2026-08-25) asserted this same gap — one finding located twice, because the second audit designed probes without reading the first's stubs. Both retire here; the lesson is recorded in the test module where the next auditor meets it.

Still open and xfail: S1 (the expiry tripwire blocks releases from 2026-10-18 — C-110), S3 (tag push doesn't publish), S4 (publish job runs no tests). None blocks this release; all three are about the release path.

Verification

507 passed, 40 xfailed, ruff clean, test_register_integrity green (C-111 → Resolved, 32→31 open).

🤖 Generated with Claude Code

Bumps 1.1.1 -> 1.2.0. MINOR rather than PATCH: the delta adds a new module
(delivery/findability.py), three exception types, a changed return value on
store_port.upload(), and a required keyword on build_provenance.

Adds CHANGELOG.md, which this repository has never had. C-111's trigger was
"the next version is cut — write what changed for a consumer, or record why the
number alone is enough", and this is that release. The entry leads with the
three exceptions that can now escape into a launcher, because the sharp one is
C-94: a delivery whose artifacts land where the consumer cannot see them
previously reported success and now raises. That is the intended behaviour and
still a change views-models would otherwise learn about only as an integer.

Venue chosen deliberately: the root CHANGELOG.md rather than the GitHub release
body, so a consumer reading the source tree at a pinned version sees it without
leaving the checkout. C-111 left the venue open; this is the choice, recorded.

Two falsification probes asserted this gap and both retire here — S2 from the
2026-08-21 audit and H1 from the 2026-08-25 one. They are one finding located
twice, because the second audit designed probes without reading the first's
stubs. Noted in the test module rather than the register: it is a lesson about
the audit procedure, not about the concern.

Three probes stay open and xfail: the expiry tripwire blocking releases from
2026-10-18 (S1/C-110), tag-push not publishing (S3), and the publish job
shipping without running tests (S4). None blocks this release; all three are
about the release path rather than the package.

Register: C-111 moved to Resolved, counts 32->31 open, 80->81 resolved,
verified by tests/test_register_integrity.py.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@Polichinel
Polichinel merged commit 7f7ae12 into development Aug 26, 2026
4 checks passed
@Polichinel
Polichinel deleted the release/1.2.0 branch August 26, 2026 00:01
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