Adopt braids and strands hardening roadmap

[flyingrobots]

Summary

Adopts a post-PR #545 hardening roadmap for strands, braids, proof envelopes, blinded member references, braid shell identity, replay, witness receipts, sealed membership, and plurality laws.

The roadmap now carries the active progress tracker for this campaign:

• five ordered goalposts
• checkbox slices under each goalpost
• focused design docs for each goalpost under docs/design/braids-and-strands-hardening/
• BEARING and docs index links that identify the roadmap as the current architecture hardening focus

What Changed

• Added docs/design/braids-and-strands-roadmap.md as the live roadmap and slice checklist.
• Added five goalpost design docs:
  • lawful construction and typed failures
  • stable identity and privacy posture
  • historical membership and replay
  • witness receipts and sealed capabilities
  • named plurality laws
• Linked the roadmap and goalpost packet from docs/BEARING.md.
• Added docs index entries for the roadmap and goalpost docs.
• Preserved Echo core boundaries by keeping domain law families adapter-provided and framing historical braid membership as append-only interval history.

Validation

• pnpm exec markdownlint-cli2 docs/design/braids-and-strands-roadmap.md docs/design/braids-and-strands-hardening/*.md docs/BEARING.md docs/index.md
• git diff --cached --check
• scripts/check_spdx.sh
• pre-commit markdownlint and Prettier
• pre-push docs-only verification
• scan confirmed no DIND, editorial, Cool-Idea, SHOULD, should, or removed terms remain in the roadmap packet

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds docs/design/braids-and-strands-roadmap.md (680 lines), a hardening roadmap for strands, braid shells, proof envelopes, blinded member references, and replay/audit tooling targeting warp-core admission APIs. Updates docs/BEARING.md with a refreshed date and a pointer to the new file.

Changes

Braids and Strands Hardening Roadmap Documentation

Layer / File(s)	Summary
BEARING.md pointer and date update docs/BEARING.md	Last-updated date bumped to 2026-06-15; maintenance pointer for the post-PR #545 hardening roadmap redirected to docs/design/braids-and-strands-roadmap.md.
Roadmap header, destination, current truth, and dependency graph docs/design/braids-and-strands-roadmap.md	SPDX header, roadmap title/status, end-state destination semantics for strands/braid membership/proof typing/sealed privacy/replayability, current truth invariants, north star vocabulary table and checklist, dependency graph with prerequisite ordering, and ownership labels.
DoD, issue format, non-goals, threat model, and compatibility classes docs/design/braids-and-strands-roadmap.md	Universal definition of done, required issue output format, non-goals, threat model notes, and compatibility classes with identity stability rules, migration requirements, and required compat notes for digest/proof/shell/witness/replay identity changes.
Nine-section execution order docs/design/braids-and-strands-roadmap.md	Ordered workstreams: constructor boundary sealing, structured error/transition vocabulary, golden vectors for digest/proof identity, blinding salt privacy posture, historical braid membership with append-only views, replay/audit optics with flight recorder and CLI, external witness receipts with simulator fixtures, sealed membership capabilities with disclosure budgets and presentation token, named plurality laws with law cards.
PR sequence, negative capability tests, bad-code register, and issue seeds docs/design/braids-and-strands-roadmap.md	Required PR sequence A–I with skip-risk and dependency constraints, mandatory negative capability tests for disallowed construction/parsing behaviors, bad-code register of hardening debt, promoted design targets, sequencing guardrails (prohibits real ZK, premature plural-law nouns, sealed capability before prerequisites, etc.), and issue seeds with executable witness requirements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• flyingrobots/echo#366: Modifies docs/BEARING.md roadmap/checklist structure into a "Roadmap Status" table — directly coupled to the same BEARING roadmap section this PR updates.

Poem

📜 Strands twist, braids tighten, the roadmap unfurls,
Nine workstreams in sequence, no skipping allowed,
Golden vectors locked, blinding salts kept discrete,
Flight recorders armed, law cards on the table,
The witnesses wait — deterministic, not proud. 🔐

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	Title accurately summarizes the main change: adoption of a hardening roadmap for braids and strands architecture with explicit execution sequence and prerequisites.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch roadmap/braids-strands-hardening

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}