Skip to content

docs: the #155 phase 2 design record the tree cites - #318

Merged
JC-000 merged 2 commits into
masterfrom
docs/155-phase2-design-record
Oct 18, 2026
Merged

JC-000 merged 2 commits into
masterfrom
docs/155-phase2-design-record

Conversation

@JC-000

@JC-000 JC-000 commented Oct 18, 2026 •

Copy link
Copy Markdown
Owner

What

Adds the #155 phase 2 design record as docs/155-phase2/. Until now it was an untracked folder outside the repo, but the tree cites it. Only what the tree cites, or what still drives a decision, is kept:

File Why it is kept
DECISIONS.md The binding user decisions. Cited as "DECISIONS N" by tools/trust_bundle.py, tools/test_trust_release_guard.py, tools/test_typed_target.py, tools/uci/rig_trust_store.py, tools/package/_common.sh, src/cert_pin.s and the TEST_ONLY key header. #155 is still open. Also holds the still-open production-key call and the P-384 reopen constraints.
S3-trust-design.md (+ data/ survey, 3 small files) Trust semantics and the record format. Cited as "S3 §5" by tools/trust_bundle.py.
L3-design.md Trust-policy design. DECISIONS 11 answers its §6.
S4-reu-banking.md REU code-banking study, the input for any future banking, including the reu_layout / Lim-Lee overlap trap.
README.md An index, plus the S1 hardware storage findings (DOS-target hazards, the 891 B WRITE_DATA cap), which are recorded nowhere else.

Dropped as superseded:

tools/trust_bundle.py's first cite now names the path.

Evidence

  • No src/, Makefile or cfg change. The only edit outside docs/ is a docstring in tools/trust_bundle.py, so the PRG bytes cannot move.
  • tools/test_reserved_test_host.py, which scans tracked files: 9/9 pass.
  • pytest tools/test_trust_bundle_unit.py tools/test_pytest_boundary.py: 29 passed.
  • pytest --co collects 530; docs/**/*.py is outside testpaths.

🤖 Generated with Claude Code

JC-000 and others added 2 commits October 18, 2026 11:55
The spike folder lived out of tree in a scratch worktree directory, yet
tools/, src/ and tools/package/ cite "DECISIONS N" from it. Copied as it
stood (survey.err, empty, dropped), with an archive note on the README;
trust_bundle.py's first cite now names docs/155-phase2/DECISIONS.md.
No source or build change.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Flatten to DECISIONS, S3, L3 and S4 plus the S3 survey data in data/;
the README is now an index plus the S1 hardware storage findings, which
are recorded nowhere else. Dropped as superseded: the S2 reclaim patch
(merged as #260), the M3 client sketch (uci-m3 merged in #271) and the
S4 probe script and raw JSON (the figures stay in S4-reu-banking.md).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@JC-000 JC-000 changed the title docs: move the #155 phase 2 design record into the tree docs: the #155 phase 2 design record the tree cites Oct 18, 2026
@JC-000
JC-000 merged commit 75b1843 into master Oct 18, 2026
@JC-000
JC-000 deleted the docs/155-phase2-design-record branch October 18, 2026 17:12
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