Skip to content

docs(adr): addendum to ADR-0008 after three days of production - #14

Merged
mspinola merged 1 commit into
mainfrom
docs/adr-0008-addendum
Aug 2, 2026
Merged

docs(adr): addendum to ADR-0008 after three days of production#14
mspinola merged 1 commit into
mainfrom
docs/adr-0008-addendum

Conversation

@mspinola

@mspinola mspinola commented Aug 2, 2026

Copy link
Copy Markdown
Owner

ADR-0008 was accepted 2026-07-30 with the work already done. Three days of production have made three statements in it false, most visibly a Status block reading "No production vintage has been captured yet" while the store holds 224,280 observation rows.

The decision itself is unchanged, so this does not rewrite the record. It adds a pointer under the Status block and an addendum at the end.

What the addendum carries

Corrections. Capture has run daily on the Windows producer since 2026-07-31, syncing outward. Disaggregated/TFF canonicalisers shipped in cotdata #83, closing the open question that says only Legacy is wired. And zero revisions have been detected so far, which is not a defect but does mean every claim here about revision behaviour is untested against a real CFTC restatement — the honest status of the subsystem's central purpose.

Open questions resolved, including one recorded outside this ADR: the announced release-date tier, which cot_vintage.md §9 had as acceptance criterion 5 unmet on the grounds that reading a release date out of prose would be guessing. Sound reasoning, unchecked premise — CFTC publishes an exact table. Built in cotdata #91; 36,296 rows move off the derived fallback.

Open questions closed as deliberate DEFERRALS, which is the part that matters for hygiene: futures-and-options-combined, revision-driven cache invalidation, and retention are decided, not pending. Reopening one is a new decision rather than a resumption. An open-questions list that never distinguishes those becomes a backlog nobody owns.

Two things worth carrying. The deployment constraint the Consequences section predicted held up under contact, and now has a watchdog on the replica because the existing sync check watched a file the vintage task does not write. And the first operational defect was in the alarm rather than the data (cotdata #90): an expectation written per week and evaluated per run, with the design doc containing both halves of the contradiction in adjacent paragraphs.

🤖 Generated with Claude Code

The decision is unchanged and the record is not rewritten. What changed is that
three statements in it are no longer true, and an ADR whose status block says "no
production vintage has been captured yet" while the store holds 224,280 rows is the
stale-status-line failure this workspace keeps paying for.

So: a pointer under the Status block, and an addendum at the end carrying the
corrections, the open questions now closed, and, separately, the ones closed as
deliberate DEFERRALS rather than left dangling. Reopening a deferral is a new
decision, not a resumption, which is the distinction that keeps an open-questions
list from becoming a backlog nobody owns.

Corrections: capture has been running daily on the producer since 2026-07-31;
disaggregated/TFF canonicalisers shipped in cotdata #83; and zero revisions have
been detected, so every claim here about revision behaviour is still untested
against a real CFTC restatement, which is the honest status of the subsystem's
central purpose.

Also records that the deployment constraint the Consequences section predicted held
up under contact, and that the first operational defect was in the alarm rather than
the data (cotdata #90): an expectation written per week and evaluated per run.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mspinola
mspinola merged commit 8fdf9fb into main Aug 2, 2026
1 check passed
@mspinola
mspinola deleted the docs/adr-0008-addendum branch August 2, 2026 20:44
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