Skip to content
Cockpit0.29.0
A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

I1305

An observed contract has a fingerprint, a compatibility state and a fixture

Where it stands

devtask.issue
Readiness
blocked 1 of its dependencies is not DONE
Status
BLOCKED
Can start
not now
Milestone
external-workspaces
Milestone status
ACTIVE
Wave
3
Waiting on
I1304
Holds back
I1306I1307
Behind it in all
2
Evidence
0 of 5
In the waySubjectDetail
issueI1304I1304 is not DONE

Moves

plan.transition
A move writes the repository: it stamps one field of this issue's record and appends one event to the ledger, and a commit will carry both.
The same moves from a terminal

majordomus plan start I1305

majordomus plan verify I1305

majordomus plan done I1305

What it is

Objective
Record what the browser observed as a versioned contract: a fingerprint of the shape, a compatibility state, and a sanitised fixture that CI replays — so that a private surface changing is a diagnosable event rather than a silent wrong answer.
Why
A vendor's undocumented surface is not a contract and will change. The failure this must prevent is not the loud one; it is a parse that half succeeds and writes plausible nonsense into the store.
Now
Nothing exists.
Wanted
Each observed operation carries a schema fingerprint and a state — compatible, degraded, incompatible. A shape that no longer matches marks the contract degraded, refuses to persist a partial parse, falls back to the browser transport, and captures a new sanitised observation for a person to review. No observation ever promotes itself to a production contract.
Done when
unknown: the record declares no `completion`
Risk
A fixture is a recording of private conversation. Sanitisation that runs after capture is sanitisation that has already failed; it runs before anything reaches disk.

Acceptance

  • Every observed operation has a fingerprint over its shape and a compatibility state
  • A mismatched shape fails closed; nothing partial is persisted
  • A degraded contract falls back to the browser transport where one exists, and reports unavailability where none does
  • Fixtures are sanitised at capture time and CI replays them with no network and no account
  • Promoting a new contract requires a person and a passing test, and the mechanism cannot do it alone
Validation
bash test/run.sh
Evidence required
fingerprintedfails_closedfallback_provenfixtures_sanitisedpromotion_manual
Evidence present
unknown: the record carries no `evidence` entries

Scope

Touches
scripts/libtest/casesdocs
Not
Hardcoding any endpoint path taken from a prompt, a gist or documentation rather than from observed authorised trafficAutomatic promotion of a new observed shape
Depends on
I1304
Priority
p1
Profile
deep-work
Parallel safe
true
Owner
unknown: the record declares no `owner`

The work so far

Branches
none
Merged
none
Commits
0
Trunk
master
Sessions
none
Created
2026-09-09
Updated
2026-09-09
Started
unknown: the record declares no `started_at`
Verified
unknown: the record declares no `verified_at`
Completed
unknown: the record declares no `completed_at`

Synchronisation

Adapter
scripts/github-sync
Repository
unknown: the derived plan's header carries no repository
External issue
unknown: a live GitHub state; this executable makes no network call, so only `scripts/github-sync --check` can answer it
State there
unknown: a live GitHub state; this executable makes no network call, so only `scripts/github-sync --check` can answer it

Findings

Nothing is wrong with these records.