core/docs/plans/adr-0242-drive-complete-plan-d0-d10.md

ADR-0241 / ADR-0242 Drive-Complete Plan (Post-Cohesion Gap Close)

Plan ID: Plan B — Drive-complete gap close
Status (archive 2026-07-15): Macro implementation landed on PR #38 (D0–D8, D3–D7 vectors, plus P11a backend hygiene). Remaining: D9 optional Rust f64 GP parity / second runner (P11a partial), D10 Joshua Accept. PR #38 tip 015c9fac — smoke green; lane-shas red on Act (local pins 9/9).
Branch: feat/adr-0241-p9-contemplation-trace-a (PR #38 only — no micro-PRs)
Date (plan authored): 2026-07-15
Date (archived to docs): 2026-07-15
Policy: PRs only at macro-phase completion for life of this plan.

Authority sources (Drive = design truth)

The four Drive documents that authored this plan:

#	Source	Drive doc_id	In-repo mirror
1	ADR-0241 wave-field hyperbolic atlas	1F_7QYtPysBP4qMbLGlGPnXgYx9IXug8nUYrpiCGSunE	docs/adr/ADR-0241-wave-field-driven-hyperbolic-atlas-and-resonant-cognition.md
2	ADR-0242 deterministic Fibonacci + evidence-gated optimization	15_NECCPy-tEWGfYi_BNqawm8GytUTMkz1DsOqGVMXhI	docs/adr/ADR-0242-atlas-packing-and-fibonacci.md
3	core_ha unification / deprecation	1eFNoXQl5BbUo6g4GBzRXi5tyIhT5RUGZQG6afaVXTg4	docs/analysis/core_ha_unification_and_deprecation_plan.md
4	Fibonacci applications R&D memo	1wcuxwfxk6AW6du4SgKe4AuRxMaE5tipxG2VbrXeWM6c	docs/analysis/fibonacci_applications_in_core_substrate.md

Supporting (not the Drive quartet, but load-bearing):

Source	Path
Cohesion master plan (entity I-*)	docs/analysis/core_cohesion_master_plan.md
Fidelity ledger	docs/research/third-door-blueprint-fidelity.md §12
Acceptance checklist	docs/audit/adr_0241_cohesion_acceptance_checklist.md

Critical discovery (2026-07-15): Cohesion packages P0–P12 are implemented. That is not full fidelity to the Drive ADR-0242 five-vector thesis or the Fibonacci applications memo. In-repo ADR-0242 was scoped as packing + section search only; Drive ADR-0242 is broader (evidence-gated operators + five vectors + sovereignty invariant).

---

Phase A — Already landed (do not re-open)

A1. Cohesion plan P0–P12 (PR #37 + PR #38)

Pkg	Deliverable	Proof
P0–P3	Cohesion plan, vault ABI, I-01…I-05, reconstruct	tests/test_third_door_cohesion.py, holographic vault
P4–P5	Golden-Angle packing, Fibonacci section search core	atlas_packing.py, fibonacci_search.py, ADR-0242 draft
P6	\rho algebra (I-04)	phase_correlation
P7–P8	Polar honesty (conjugacy authority); chiral non-vacuous spinor path	wave_manifold tests + briefs
P9	Trace A wave_seam SPECULATIVE seal / hypothesis vs evidence	core/contemplation/wave_seam.py
P10	Wave residual → energy/trajectory; \tau_n=F_n\tau_0 table; crystallization gate	wave_energy_boundary.py
P12	runtime_contracts wave section; acceptance checklist; ADRs Proposed+ready	governance tests

A2. ADR-0241 local operators (Drive core math, progressive continuous field)

Requirement	Status
\psi multivector field, sandwich/left transport	🟢
Spectral leakage → surprise	🟢
Resonant recall / reconstruct	🟢
Holographic vault SPECULATIVE + public ABI	🟢
GoldTether unitary residual	🟢
Chiral \mathcal{Q} (spinor path)	🟢
Continuous \int_M / \sup_X continuum	🟡 progressive (mode samples / pointwise)
True multi-grade \mathcal{C}_{AB} polar	⚪ retired honestly (conjugacy = polar for sandwich)
Sensorium \psi_\text{total}=\sum\psi_\text{mod}	🔴 open (feed)

A3. core_ha deprecation (Python path)

Item	Status
No live core_ha / hygiene pins	🟢
Absorption into wave / GoldTether / energy / biography	🟢
Rust expm / SIMD residual hot path	🔴 (Step 2 — optional mechanical sympathy)

A4. Explicit non-goals (all plans)

• Serve-path wiring of wave / Fibonacci / packing / seams
• Resurrecting core_ha or Poincaré as runtime memory truth
• Cosine / ANN multimodal ranking
• Hot-path silent unitize / nearest-versor drift repair
• Fibonacci dictating proposition truth, safety, identity, or auto-promotion (Drive sovereignty invariant)
• V5 anyons entering production without proofs

---

Phase B — Drive gaps (new work packages)

Authority: Drive ADR-0242 five vectors + Fibonacci memo + residual ADR-0241 progressive items + core_ha Step 2.

D0  Align in-repo docs to Drive ADR-0242 scope (no silent scope shrink)
D1  V1: FibonacciSearchCertificate + OptimizationFailure + evidence gate
D2  V1b: GoldTether κ optional path — cert-only, fail → baseline κ=1.0
D3  V2: Multi-band E_n(t) temporal basis (research → evals quarantine first)
D4  V3 polish: reconstruction-over-storage allocator identity + packing honesty pins
D5  V4: Fibonacci-word observability scheduler (telemetry only)
D6  V5: topological_reasoning research scaffold (isolated, blocked from prod)
D7  Sensorium → ψ packets thin feed (I-04 boundary; no cosine)
D8  Land Fibonacci applications memo in-repo + fidelity honesty pass
D9  Optional P11 Rust/MLX parity (core_ha Step 2) — only after Python authority frozen
D10 Governance re-close: ADR-0242 rewrite, CLAIMS if needed, Joshua Accept path

Priority / leverage order

Rank	Pkg	Why
1	D0	Stop docs lying about scope
2	D1	Highest fidelity gap to Drive ADR-0242 production Phase 1
3	D2	Makes V1 load-bearing (κ) without dogma
4	D8	Canonical memo path for agents
5	D4	Cheap honesty / reconstruction-over-storage
6	D3	Research prototype; do not promote without benchmark
7	D5	Outside truth path; scheduling only
8	D7	Closes I-04 “feed still open”
9	D6	Explicit pre-research quarantine
10	D9	Mechanical sympathy after freeze
11	D10	Human Accept after D1–D2 (minimum) or full vector set

---

Package detail

D0 — Doc alignment (mandatory first)

1. Rewrite / expand docs/adr/ADR-0242-*.md to match Drive title thesis:
   • Deterministic Fibonacci operators and evidence-gated optimization
   • Five vectors + sovereignty invariant + phase order
2. Keep packing + section search as V1/V3 landings, not the whole ADR.
3. Cross-link Fibonacci memo, cohesion plan, fidelity §12.
4. Honesty table: what is GREEN vs RESEARCH vs RETIRED.

Exit: In-repo ADR-0242 no longer understates Drive.

---

D1 — V1 certificate discipline (production-ready)

Drive API surface (freeze):

BoundedUnimodalObjective          # exists
fibonacci_section_search(...)  → FibonacciSearchCertificate | OptimizationFailure
  # never raw float; never silent accept
FibonacciSearchCertificate:
  minimizer, final_interval, evaluations,
  ordered_points, ordered_values,
  objective_id, objective_version
  # content-addressed / replayable (hash of ordered trace + ids)
OptimizationFailure:
  reason, final_interval, evaluations, objective_id, objective_version

Implementation notes vs current code:

Current	Required
SearchTrace + raise ValueError	Typed cert or failure return (or exception that maps 1:1 to failure reasons)
partial certificate dict	Full frozen dataclass + deterministic cert_id / digest
unimodality fail raises	OptimizationFailure(reason="unimodality_violation_...")

Tests (RED first):

• Success path returns cert; digest stable across dual-run
• Budget too low → typed failure
• Nonfinite / bounds → typed failure
• Multi-extrema unimodality → typed failure
• Never returns bare float as public API
• Serve quarantine still holds

Exit: Drive Phase 1 API green; SearchTrace either deprecated or thin adapter over cert.

---

D2 — GoldTether κ cert gate (optional path)

Drive Phase 1 integration seam:

1. Bounded κ line search may use fibonacci_section_search.
2. On cert success: telemetry records cert; caller may propose κ (not auto-mutate identity).
3. On OptimizationFailure: default κ = 1.0, log failure; no silent use of half-search.
4. Must not authorize COHERENT / pack mutation / serve autonomy change.

Exit: Integration test with synthetic unimodal residual; failure path forced.

---

D3 — V2 multi-scale temporal basis (research → evals)

Drive formula:

[ E_n(t) = E_n(t_0),\exp\bigl(-(t-t_0)/(F_n\tau_0)\bigr) ]

1. Implement pure helper (e.g. multi_scale_energy_vector) — not dogmatic production default.
2. Comparative harness in evals/ or calibration/: Fibonacci vs dyadic 2^n\tau_0 vs log under fixed replay.
3. Promote into FieldEnergyOperator only with written benchmark win + Joshua gate.
4. Optional: surprise persistence across bands (F_5)–F_7 → DiscoveryCandidate (contemplation), SPECULATIVE only.

Exit: Research prototype + benchmark artifact; production energy path unchanged until gate.

---

D4 — V3 allocator polish

Already: Golden-Angle packing + d_{\min}.

Add:

1. Explicit allocator identity + version in metadata (golden_angle_v1) so layout is reconstructible from ordinal sequence.
2. Document honest metric: CGA null-point Euclidean d, not full H^2 geodesic.
3. Optional insertion-cost metric only in evals quarantine (R-04).

Exit: Reconstruction-over-storage pin; no opaque mutable layout table as truth.

---

D5 — V4 Fibonacci-word observability scheduler

Drive:

[ W_0=B,; W_1=A,; W_{n+1}=W_n W_{n-1} ]

• A = low-cost local measurement
• B = high-cost cross-band check

Constraints:

• Outside cognitive truth path
• Cannot mutate field / vault COHERENT / packs
• Module e.g. core/physics/fibonacci_word_schedule.py or telemetry/
• AST pin: not imported by chat/runtime.py

Exit: Deterministic word generator + schedule iterator tests; no serve import.

---

D6 — V5 topological reasoning scaffold (pre-research)

1. Create isolated package path algebra/topological_reasoning/ (or docs/research/ + empty module stub).
2. README: fusion \tau\otimes\tau=1\oplus\tau, blocked from FFI / production imports.
3. Architectural test: production packages must not import it.

Exit: Quarantine exists; zero production coupling.

---

D7 — Sensorium → ψ feed (I-04 boundary)

1. Thin adapter: modality packet → 32-vec \psi at construction boundary only.
2. Superposition \psi_\text{total}=\sum\psi_i for available packets.
3. Use phase_correlation only — ban cosine/ANN.
4. If compilers incomplete: fake deterministic packets + real algebra (honest).

Exit: I-04 “feed open” closed or explicitly staged with fake packets + real \rho.

---

D8 — Land Fibonacci applications memo

1. Export Drive memo → docs/analysis/fibonacci_applications_in_core_substrate.md.
2. Cross-link ADR-0241/0242, energy, packing.
3. Mark anyons / braid as research (align D6).

Exit: Canonical path matches Drive “Canonical path” field.

---

D9 — Optional Rust hot path (core_ha Step 2 / P11)

Only after D1 Python cert authority frozen:

Binding	Role
diffusion.rs::expm	Unitarity-aware R=\exp(B\Delta t)
versor_unit_residual	SIMD GoldTether residual
Optional cl41::wedge	Exterior product

Parity tests: Rust ≈ Python within tol; no scipy as truth.

Exit: Optional; not required for ADR-0242 Phase 1 Accept.

---

D10 — Governance re-close + Joshua Accept

Minimum for Drive Phase 1 Accept (ADR-0242 production slice):

• D0 + D1 (+ D2 preferred)
• Fidelity ledger V1/V3 honest
• Sovereignty invariant documented + test-pinned

Full Drive multi-vector Accept later:

• D3–D5 as landed or explicit RESEARCH
• D6 quarantine
• ADR-0241 remaining progressive items called out

Never self-Accept — Joshua only.

---

Success definitions

Minimum Drive-complete (Phase 1)

#	Criterion
M0	In-repo ADR-0242 matches Drive five-vector thesis (scope honesty)
M1	V1 typed cert/failure API + dual-run stable digest
M2	No silent raw-float public minimizer
M3	Optional κ path fail-closed to baseline
M4	Serve quarantine unchanged
M5	Sovereignty: fib never sets truth / COHERENT / identity

Full Drive-complete (all five vectors)

M0–M5 plus V2 research artifact, V3 allocator identity, V4 scheduler, V5 isolated scaffold, sensorium feed staged, fidelity/governance updated.

Absolute mastery (stretch)

• continuous field integrals, Rust parity, comparative V2 promotion into production energy with evidence.

---

Verification lanes

# After D1
python3 -m pytest tests/test_adr_0242_fibonacci.py tests/test_adr_0242_*cert* -q

# Cohesion regression (must stay green)
python3 -m pytest tests/test_third_door_cohesion.py tests/test_adr_0241_*.py -q

# Serve quarantine
python3 -m pytest tests/test_third_door_cohesion.py -k serve_path -q

# Optional later
python3 -m pytest tests/test_adr_0242_fibonacci_word*.py -q
core test --suite algebra -q

Do not run full verify_lane_shas unless demos/showcase touched.

---

Execution order after plan approval

1. D0 doc align ADR-0242 + land Fibonacci memo (D8 can parallel)
2. D1 TDD cert/failure API
3. D2 GoldTether κ cert gate (optional path)
4. D4 allocator identity polish
5. D3 multi-scale energy research harness (no production flip without evidence)
6. D5 Fibonacci-word scheduler
7. D7 sensorium feed thin adapter
8. D6 anyon research quarantine
9. D9 Rust only if requested
10. D10 fidelity + Joshua Accept package

---

Agent orchestration

Orchestrator
  D0/D8  docs (doc-updater discipline)
  D1     tdd-guide → implement → python-reviewer → security-reviewer
  D2     tdd → goldtether integration (fail-closed)
  D3     evals quarantine first; no production promote without benchmark
  D4–D5  small pure modules + AST quarantine pins
  D6     isolation + import hygiene test
  D7     sensorium boundary + I-04 pins
  D9     rust-build-resolver only if greenlit
  D10    governance tests + human Joshua

Adversarial checklist after each package:

1. Namesake-green?
2. Evidence-gated (cert/failure) where Drive requires?
3. Serve quarantine held?
4. Sovereignty invariant held?
5. Docs / fidelity / code agree?

---

Branch strategy

• Prefer continue PR #38 branch if still open, or fresh feat/adr-0242-evidence-gated-fibonacci from post-merge main after #38 lands.
• Keep changes small: D0/D1 first PR if #38 is already large.
• Forgejo only; no GitHub.

---

Summary

Layer	Status
Cohesion living-entity (P0–P12)	🟢 done
Drive ADR-0241 operators	🟢 / progressive continuous field + sensorium feed open
Drive ADR-0242 V1 cert discipline	🟢 landed on PR #38 (FibonacciSearchCertificate / OptimizationFailure)
Drive ADR-0242 V2–V5	🟢 research/scaffold landed (V2 multi-scale, V3 allocator id, V4 word schedule, V5 quarantine)
core_ha Python deprecation	🟢; Rust Step 2 optional — P11a backend dispatch landed
Fibonacci memo in-repo	🟢 docs/analysis/fibonacci_applications_in_core_substrate.md

This plan’s job: close the gap between “cohesion complete” and “Drive ADR-0242 evidence-gated Fibonacci operators complete,” without re-litigating polar/chiral/packing or opening serve.