Skip to content

Anchor the ERR-04 baseline to a commit, not a date - #278

Merged
entelecheia merged 2 commits into
mainfrom
docs/err04-baseline-repin
Aug 23, 2026
Merged

Anchor the ERR-04 baseline to a commit, not a date#278
entelecheia merged 2 commits into
mainfrom
docs/err04-baseline-repin

Conversation

@entelecheia

Copy link
Copy Markdown
Member

Planning-docs only. No source changes.

The problem

Phase 3's ERR-04 gate asserts the Result<T, String> signature count lands
inside [1118, 1138]. The 1,138 baseline was measured on a working tree that
happened to contain the then-uncommitted hwped.rs.

The number was right. Its provenance was accidental — 19 of the 1,138 matches
live in that file
. On a tree without it the pinned command reads 1,119, and
after the planned 10-signature migration the count lands at 1,109, below the
band
. Anyone re-deriving the baseline from a checkout that predated #277 would
have set a band Phase 3 could not satisfy.

What changed

Re-confirmed 1,138 on the committed tree at 34f96ee and recorded that
commit as the provenance in 03-02-PLAN.md and 03-04-PLAN.md. The band itself
is unchanged.

  • 03-04 now requires re-measuring the baseline at the start of the plan,
    rather than only "if concurrent sessions touched src-tauri/src". The
    hwp-editor track is still active, so drift is expected, not exceptional.
  • 03-04's full-gate step drops the Phase 1/2 escape hatch for uncommitted
    hwped.rs/lib.rs. That work is committed and make verify is green on it,
    so a red gate there is now Phase 3's to diagnose rather than to write off.
  • ROADMAP success criterion 4 and requirement ERR-04 both cited CONCERNS.md's
    stale 1,118. They now cite the measured 1,138 and name the stale figure as
    stale — 03-RESEARCH.md Pitfall 6 had already flagged it, but the roadmap and
    requirements had never been updated to match.
  • The same stale figure in PROJECT.md's Out-of-Scope bullet and Key Decisions
    row is aligned.

Verification

$ grep -roE "Result<.*, String>" src-tauri/src --include="*.rs" | wc -l
1138
$ grep -roE "Result<.*, String>" src-tauri/src/hwped.rs | wc -l
19

Measured on 34f96ee. No code touched, so no gate run is implicated.

The 1,138 figure was measured on a working tree that happened to contain the
then-uncommitted hwped.rs. The number was right, but its provenance was
accidental: 19 of the 1,138 matches live in that file, so on a tree without it
the count reads 1,119 and the post-migration count lands at 1,109 - below the
[1118, 1138] band the plan asserts against.

Re-confirmed 1,138 on the committed tree at 34f96ee, and recorded that commit
as the provenance in 03-02 and 03-04. The band itself is unchanged.

- 03-04 now requires re-measuring the baseline at the start of the plan rather
  than only "if concurrent sessions touched src-tauri/src" - the hwp-editor
  track is still active, so drift is expected, not exceptional
- 03-04's full-gate step drops the Phase 1/2 escape hatch for uncommitted
  hwped.rs/lib.rs: that work is committed and make verify is green on it, so a
  red gate is now this phase's to diagnose
- ROADMAP success criterion 4 and requirement ERR-04 cited CONCERNS.md's stale
  1,118; both now cite the measured 1,138 and name the stale figure as stale
  (RESEARCH Pitfall 6 had already flagged it)
Copilot AI lite review requested due to automatic review settings August 23, 2026 01:26

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2ab0a7e7ad

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .planning/phases/03-typed-ipc-error-contract/03-04-PLAN.md Outdated
Comment thread .planning/REQUIREMENTS.md
…after

Two review findings on #278, both correct.

P2 — the re-measure instruction landed in the wrong plan. 03-04 runs after
03-01 and 03-02 have already flipped signatures, so "re-measure the baseline
at the start of this plan" observes the post-migration count (~1,128), not a
baseline. Recording that as one and shifting the band would let unintended
conversions pass unnoticed.

The measurement moves to where the tree is still pristine: 03-01's action now
opens by running the pinned command and recording the result as the phase's
pre-migration baseline B, before any file is edited (03-01 flips
evidence_binder_mutate, so it cannot be taken later). 03-02 records its count
against B minus 10; 03-04 asserts within [B-20, B] and derives the band from
B rather than re-deriving a baseline. The literal [1118, 1138] stays as the
expected values, with an explicit substitution note in the automated check.

P2 — 03-CONTEXT.md still prescribed 1,118 in two places while the requirement
now says 1,138. The plans consume that context as implementation guidance, so
the two sources were prescribing incompatible guards. Context now cites the
measured baseline, and the CONCERNS.md quotation is marked stale in place
(RESEARCH Pitfall 6 had already established that).
@entelecheia
entelecheia merged commit 44ea236 into main Aug 23, 2026
1 check passed
@entelecheia
entelecheia deleted the docs/err04-baseline-repin branch August 23, 2026 01:51
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.

2 participants