docs: establish Effect-native replacement foundation
CH
1mo ago+1966+1966+0123456789012345678901234567890123456789-5789-5789-0123456789012345678901234567890123456789
Purpose
Docs-only planning foundation for #174 and specification #180. Records the accepted Effect-native replacement contracts, retained research and migration/acceptance map, and retires superseded prerelease guides. This is not one of implementation tickets #181–#204.
Stack
- Base:
mainatc343410fc855af6cc2fb472ff2f2d2ba466becf6 - Head:
docs/effect-native-planning-checkpointat9e1917971f09252ef0f6629720cbbc882c6e87d9 - Commits:
8313b31,0064d67and9e19179 - Next stack PR: #206 (#181 native baseline), followed by #207 (partial #170 contracts). #181 is stack-satisfied at its reviewed/tested ancestor for descendant work; all PRs remain draft and unmerged.
Verification and limitations
- Coordinator reran
git diff --check c343410fc855af6cc2fb472ff2f2d2ba466becf6 0064d6745f276d8e2e895d0ffdc282d13e70d562: exit 0. - Coordinator reran installed
oxfmt --checkon all 52 added/modified files: exit 0. - CI verify passed: lint/format/types/build (28 tasks, 2 cached), test pipeline (17 tasks, 9 cached), docs prerender (6 pages). CI used merge ref
cd9e23c246f4cabb5d278371e24f0b25320b90c4; coordinator verified its tree equals the then-head0064d67. This verifies the existing implementation with the docs delta, not the native replacement. - Follow-up
9e19179replaces eight duplicated policy bullets with an ADR index (-5 lines). Parent format/whitespace checks pass; all index anchors resolve. Detailed protocols and historical evidence are unchanged. The prior CI result above is bound to0064d67. Current CI verify also passed for9e19179; parent verified merge ref8699c96f361bceff0aa160a0437961d04a07a7f2has the same tree. - Installed compiler verified as
7.0.2+effect-tsgo.0.36.5; repository Effect remains4.0.0-rc.108. No dependency change. - Independent Standards/Spec reviews found no issues on
0064d67. The separate Ponytail review found duplicated policy text; that finding is resolved on9e19179, with independent follow-up confirming all removed policies remain in ADR-0056 and no new normative policy was introduced. Parent carries earlier coverage forward only for unchanged content; the new index has its own checks/review. - Still draft and awaiting external review; silence is not approval. The new-head bounded feedback window ended with CI green and no external reviews or threads. Changesets bot reminder is informational for this docs-only PR. No production replacement, durable backend, native-platform or machine-failure gate is claimed complete.
- #174/#180 remain open. No merge/release is requested or performed.