README.md
Current Specs/DOC73/README.md
# DOC73 V1.6 OPERATIVE — Release Wave
**Frozen:** 2026-05-03 (R1.0 freeze)
**RESCINDED:** 2026-05-04 (CSA extraction; pending red-team Round 1)
**Latest revisions:** Artifact 1 R0.5, Artifact 2 R0.4, Artifact 3 R0.3, Artifact 4 R0.4, Artifact 5 R0.3, Helper Homes R0.2, Deferral Inventory R1.1
**Status:** Spec is CSA-free; pending red-team Round 1
This folder contains the operative DOC73 V1.6 release wave AFTER the 2026-05-04 CSA extraction. Process records (audits, extraction reports, integration trace) are in `Audit and Process Records/`. Non-operative historical material (V1.5.1 predecessor; pre-CSA-extraction copies) is in `_Archived/`.
---
## §1. Folder structure
```
DOC73 V1.6 R1.0 OPERATIVE/
├── README.md (this file)
│
├── DOC73_Artifact1_R0.5.md Core
├── DOC73_Artifact2_R0.4.md Legal & Corpus Surfaces
├── DOC73_Artifact3_R0.3.md EC + DOC73 Transaction Kernel
├── DOC73_Artifact4_R0.4.md DOC24 + EC Session & Search Runtime
├── DOC73_Artifact5_R0.3.md DOC25 Legal Artifact & Materialization
│
├── DOC73_V1_6_HELPER_HOMES_R0.2.md Helper-home appendix (coding agents reference)
├── DOC73_V1_6_DEFERRAL_INVENTORY_R1.1.md V1.6.1 / V1.7+ backlog tracker
│
├── Audit and Process Records/ Historical process records + V1.6.1 review aids
│ ├── README.md
│ ├── DOC73_V1_6_CSA_EXTRACTION_REPORT.md
│ ├── DOC73_V1_6_CSA_EXTRACTION_PRE_REPORT.md
│ ├── DOC73_V1_6_CSA_EXTRACTION_AUDIT.md
│ └── DOC73_V1_6_CSA_INTEGRATION_TRACE_R0.1.md
│
└── _Archived/ Non-operative; preserved for record only
├── README.md
├── DOC73_V1_5_1_FINAL.md V1.5.1 predecessor (superseded by V1.6)
└── pre_CSA_extraction_2026-05-04/
└── (6 R1.0-frozen pre-CSA-extraction copies)
```
---
## §2. The 5 core DOC73 V1.6 artifacts (post-CSA-extraction revisions)
| # | File | Lines | Scope |
|---|---|---|---|
| 1 | `DOC73_Artifact1_R0.5.md` | ~4,700 | **Core** — V1.5.1 carry-forward + Group A schemas + V16 cross-cutting INVs + Mechanism 4 RecentActivityRollup canonical + §A type appendix. **R0.5 = CSA extraction** (CSA refs + OrientationContextEntry removed; INV-N-ORIENTATION-1 renamed to INV-N-NOT-EVIDENCE-1; P8 principle rewritten; source_kind enum value renamed) |
| 2 | `DOC73_Artifact2_R0.4.md` | ~6,500 | **Legal & Corpus Surfaces** — Group J + Group O + Group K + Group N. **R0.4 = CSA extraction** (§25 Group N reframed to consume RecentActivityRollup directly; activity entry arrays consumed directly without OrientationContextEntry wrapper) |
| 3 | `DOC73_Artifact3_R0.3.md` | ~7,400 | **EC + DOC73 Transaction Kernel** — Group A runtime + Group B2 write-time + Group G simulation + Group K kernel runtime + ExtractionStateMachine. **R0.3 = CSA extraction** (3 inadvertent CSA-implied refs removed: cross-ref table, §7.7 EC3 example block, §16 cross-reference framing) |
| 4 | `DOC73_Artifact4_R0.4.md` | ~5,000 | **DOC24 + EC Session & Search Runtime** — capability registry + Group I session + share-link + Group M search router + read-time access overlay + Group K read path. **R0.4 = CSA extraction** (§18 CSAInjectionTierPolicy DELETED in entirety; SessionProfile.csa_injection_tier_policy_ref removed; G-ACT-3 acceptance test removed; consumer-side session-orientation orchestration deferred to DOC72) |
| 5 | `DOC73_Artifact5_R0.3.md` | ~4,100 | **DOC25 Legal Artifact & Materialization** — SourceArtifact + ECF parser + MaterializationState + extraction pipeline. **Not modified by CSA extraction** (zero CSA refs confirmed) |
---
## §3. Operative supporting documents
| File | Purpose |
|---|---|
| `DOC73_V1_6_HELPER_HOMES_R0.2.md` | **Helper-home appendix.** Canonical declarations of helper functions referenced across artifacts. Coding agents implementing V1.6 reference this to find the canonical home for each helper. R0.2 = CSA extraction (§1.26 `lookup_csa_injection_tier_policy` removed → reserved-note) |
| `DOC73_V1_6_DEFERRAL_INVENTORY_R1.1.md` | **V1.6.1 / V1.7+ backlog tracker.** Includes the 3 V1.6.1 review items (`DOC2_CSA_INTEGRATION_REVIEW` SUPERSEDED, `MECH4_PROPOSAL_FIDELITY_REVIEW` still active, `DOC73_TO_DOC72_CSA_INTERFACE_REVIEW` new). Ongoing reference for what was punted and when to come back to it. |
---
## §4. Three V1.6.1-deferred items pending architect review
Tracked in `DOC73_V1_6_DEFERRAL_INVENTORY_R1.1.md` §1.2:
### 4.1 `DOC2_CSA_INTEGRATION_REVIEW` — SUPERSEDED 2026-05-04
DOC73 V1.6 no longer absorbs CSA; the original question ("does CSA absorption obviate DOC2 integration?") no longer applies at V1.6 level. DOC2's architectural fate is now independent of V1.6 release wave — DOC72/DOC2 architectural work on its own timeline.
### 4.2 `MECH4_PROPOSAL_FIDELITY_REVIEW` — STILL ACTIVE
Original Mechanism 4 V1 proposal (DOC73-authored 2026-04-29) was folded into V1.6 with modifications. Post-extraction has additional divergences (CSA orchestration scaffolding removed entirely; consumer contract pointer added). Q-MECH4-1 through Q-MECH4-6 in `Audit and Process Records/DOC73_V1_6_CSA_INTEGRATION_TRACE_R0.1.md` §11 remain relevant.
**Review entry point:** `Audit and Process Records/DOC73_V1_6_CSA_INTEGRATION_TRACE_R0.1.md` §11 (6 Q-MECH4-* questions; Q-MECH4-2 cadence model is the load-bearing question)
**Estimated review time:** 1-2 hours
### 4.3 `DOC73_TO_DOC72_CSA_INTERFACE_REVIEW` — NEW (R1.1)
When DOC72 ships session-orientation orchestration (whatever form CSA takes in DOC72), confirm DOC73 V1.6's RecentActivityRollup producer/consumer contract aligns with DOC72's consumer-side architecture. Architect preference for tier_3_minimal_orientation semantics (per Q-3-A4-7 historical record in BUILD_QUESTIONS §11.1) carries forward.
**Not blocking R1.0 freeze of DOC73 V1.6.** Triggered when DOC72 ships its design.
---
## §5. OPA calibration baseline
**OPA V3.11** (operative as of 2026-05-04) is the calibration baseline for DOC73 V1.6 post-CSA-extraction. V3.11 = V3.10 + 5 CSA-extraction changes:
- REMOVED: `OBL-D72-CSA-R2-DOC73-ALIGN-01`
- REMOVED: `OBL-D72-CSA-R2-MECH4`
- REMOVED: `OBL-D73-CSA-R2-ABSORPTION`
- RENAMED: `OBL-D73-N-ORIENTATION-INV-01` → `OBL-D73-N-NOT-EVIDENCE-INV-01`
- ADDED: `OBL-D73-RECENT-ACTIVITY-ROLLUP-CONSUMER-CONTRACT-01`
- Plus V3-AT-22 + V3-AT-12 description rewrites to remove CSA framing
OPA V3.11 lives at `../OPA_V3_11.md` (parent CURRENT SPECS folder, not this operative folder).
---
## §6. What is NOT in this folder
Working drafts and per-artifact audits live in `../../DOC73 R1.6 Build/`:
- Prior artifact revisions (R0.1, R0.2, R0.3 where superseded by higher revision)
- Per-artifact audits: `AUDIT_DOC73_Artifact{1,2,3,4,5}_R0.1.md`
- Cross-artifact audit: `AUDIT_CROSS_ARTIFACT_R0.1.md`
- V4 source materials: `*copy.md` files
- `DOC73_V1_6_BUILD_QUESTIONS.md` (CLOSED; per architect decision 2026-05-04 it's not in operative folder; latest annotated version in build folder)
Cross-doc forecast docs (in their own working folders elsewhere):
- DOC72 R5.74+ — filing-relationship edge types + WorkContextConstellation + decay floor + StorageRegistryEntry consumer surface (CSA is DOC72's separate concern; not part of DOC73 V1.6)
- DOC25 V2.0+ — per A1-A9 amendments tracked in Artifact 5 §1.2
- DOC24 R3.1+ — capability registry + reason-code namespace
- DOC2 — architectural fate independent of V1.6 (per CSA extraction decision)
CSA + Mechanism 4 source proposals:
- CSA R2 proposal: `../Addenda Proposals & In Progress/DOC72 Addenda and Proposals/DOC72_PROPOSAL_CONTINUITY_SYNTHESIS_ARCHITECTURE_R2.md`
- DOC73 Mechanism 4 V1 proposal: `../Addenda Proposals & In Progress/DOC73 Addenda and Proposals/DOC73_PROPOSAL_SECTION_6_4_MECHANISM_4_ROLLUP_V1.md`
---
## §7. Reading order for cold reader
For a coding agent or new collaborator picking this up cold:
```
1. README.md (this file) — orientation
2. Audit and Process Records/DOC73_V1_6_CSA_EXTRACTION_REPORT.md — what changed 2026-05-04
3. DOC73_Artifact1_R0.5.md — Core (start here for spec foundations)
4. DOC73_Artifact3_R0.3.md — kernel runtime (substrate for 2/4/5)
5. DOC73_Artifact5_R0.3.md — DOC25 ingestion + extraction
6. DOC73_Artifact2_R0.4.md — legal-domain surfaces (consumes 1+3+5)
7. DOC73_Artifact4_R0.4.md — read-time runtime + search (consumes 1+2+3+5)
8. DOC73_V1_6_HELPER_HOMES_R0.2.md — helper signatures (look up here before inventing locally)
9. DOC73_V1_6_DEFERRAL_INVENTORY_R1.1.md — V1.6.1 / V1.7+ deferrals
10. Audit and Process Records/DOC73_V1_6_CSA_INTEGRATION_TRACE_R0.1.md §11 — when doing MECH4_PROPOSAL_FIDELITY_REVIEW
```
---
## §8. Status summary
```text
V1.6 release wave R1.0 status: RESCINDED 2026-05-04 (CSA extraction)
Current status: pending red-team Round 1
Audit cycle complete (pre-extraction):
Step 0a — OPA V3.8 patch session ✓
Step 0b — Deferral inventory ✓
Steps 1-8 — Artifact drafting + audits ✓
Step 9 — Cross-artifact audit ✓
CSA extraction 2026-05-04 complete:
Architect-issued extraction prompt ✓
Phase 1 pre-extraction grep + report ✓
Phase 2 surgical removal (6 file revisions) ✓
Phase 3 verification grep + extraction report ✓
Self-audit (5 bugs found and fixed) ✓
OPA V3.11 produced + 2 audit-found bugs fixed ✓
Operative folder updated + archive + organized ✓ (this update)
Pending architect work (NOT blocking R1.0 candidates):
MECH4_PROPOSAL_FIDELITY_REVIEW (architect; 1-2h)
DOC73_TO_DOC72_CSA_INTERFACE_REVIEW (triggered when DOC72 ships
session-orientation orchestration)
Next process step:
Red-team Round 1 (next architect process step)
```
---
— End of README.md —