Merge pull request 'fix(physics): close A-04 transitive serve breach + W1 adversarial findings + blueprint integration plan' (#40) from feat/adr-0241-0242-mastery-close into main
This commit is contained in:
commit
54228d453e
11 changed files with 1545 additions and 36 deletions
19
AGENTS.md
19
AGENTS.md
|
|
@ -233,12 +233,23 @@ Before branch movement or edits:
|
|||
- Prefer a fresh worktree from `origin/main` for non-trivial implementation.
|
||||
|
||||
### Git and Forgejo Setup
|
||||
**CRITICAL**: This repository is hosted on a private **Forgejo** server, NOT GitHub. We are explicitly deprecating GitHub usage.
|
||||
**CRITICAL**: This repository is hosted on a private **Forgejo** server, NOT GitHub. GitHub is deprecated for core work and CI testing.
|
||||
Our sole remote and CI/CD platform is **core-gitquarters.acbcontent.org**.
|
||||
- **DO NOT** use the `gh` (GitHub) CLI.
|
||||
- **DO NOT** attempt to push, pull, or clone from `github.com`.
|
||||
- **DO NOT** use the `gh` (GitHub) CLI for normal work or PR management.
|
||||
- **DO NOT** attempt to push, pull, or clone from `github.com` for developer/agent loops.
|
||||
- **USE** the provided Forgejo MCP tools if available.
|
||||
- If the Forgejo MCP tools are not available or not working, **attempt utilizing the `gitea` / `tea` CLI or `forgejo` CLI** for issues, PRs, and repository management targeting `core-gitquarters.acbcontent.org`.
|
||||
- **USE** the `tea` CLI (Gitea/Forgejo CLI) for issues, PRs, and repository management targeting `core-gitquarters.acbcontent.org`.
|
||||
|
||||
### Local-First CI Validation Protocol
|
||||
To optimize server resources and bypass external CI billing dependencies, all agents and developers must run validation suites locally.
|
||||
- **Pre-Push Gate:** Before pushing any branch to Forgejo, you **MUST** run the `smoke` test suite locally using:
|
||||
```bash
|
||||
uv run core test --suite smoke -q
|
||||
```
|
||||
Ensure all 108+ tests pass. Pushing broken code is a critical protocol violation.
|
||||
- **Pre-Merge Gate:** Before proposing a merge or requesting a review on a PR, you **MUST** run the larger validation suite relevant to your changes (e.g. `uv run core test --suite cognition` or `uv run core test --suite algebra`).
|
||||
- **PR Documentation:** When creating a PR on Forgejo (via `tea pr create`), document the local test execution in the PR description, matching this format:
|
||||
`[Verification]: Smoke suite passed locally (<run_duration>s, <test_count> passed)`
|
||||
|
||||
### Pre-Edit Sweep & Versor Coherence Guardian Protocol
|
||||
Before modifying any module in `algebra/`, `field/`, `vault/`, or `generate/`:
|
||||
|
|
|
|||
|
|
@ -26,6 +26,16 @@ TEST_SUITES: dict[str, tuple[str, ...]] = {
|
|||
"tests/test_runtime_config.py",
|
||||
"tests/test_cognitive_turn_pipeline.py",
|
||||
"tests/test_architectural_invariants.py",
|
||||
# Audio sensorium lane — part of the smoke.yml PR gate (compiler,
|
||||
# CRDT merge, eval gates, pack manifest, mount, teachers; ~3s).
|
||||
# Listed explicitly so the local-first pre-push gate (AGENTS.md
|
||||
# protocol) equals the CI gate rather than silently narrowing it.
|
||||
"tests/test_audio_compiler.py",
|
||||
"tests/test_audio_crdt_merge.py",
|
||||
"tests/test_audio_eval_gates.py",
|
||||
"tests/test_audio_pack_manifest.py",
|
||||
"tests/test_audio_sensorium_mount.py",
|
||||
"tests/test_audio_teachers.py",
|
||||
# ADR-0043 — identity falsifiability: ratified identity packs must
|
||||
# produce distinct, directionally-correct articulations, with a
|
||||
# pack-invariant grounding/refusal floor and zero fabrication. Lives
|
||||
|
|
|
|||
|
|
@ -78,36 +78,81 @@ from core.physics.trajectory_invariants import (
|
|||
relative_holonomy,
|
||||
trajectory_divergence,
|
||||
)
|
||||
from core.physics.holographic_vault import (
|
||||
HolographicVaultError,
|
||||
HolographicVaultStore,
|
||||
SealedMode,
|
||||
)
|
||||
from core.physics.wave_energy_boundary import (
|
||||
CrystallizationDecision,
|
||||
assess_wave_trajectory,
|
||||
crystallization_for_holographic_seal,
|
||||
energy_profile_from_wave,
|
||||
fibonacci_tau_schedule,
|
||||
recency_band_index,
|
||||
wave_unitary_residual,
|
||||
)
|
||||
from core.physics.fibonacci_search import (
|
||||
BASELINE_KAPPA,
|
||||
BoundedUnimodalObjective,
|
||||
FibonacciSearchCertificate,
|
||||
OptimizationFailure,
|
||||
fibonacci_number,
|
||||
fibonacci_section_search,
|
||||
propose_kappa_from_search,
|
||||
)
|
||||
from core.physics.multi_scale_energy import (
|
||||
comparative_residual_separation,
|
||||
dyadic_tau_schedule,
|
||||
multi_scale_energy_for_schedule,
|
||||
multi_scale_energy_vector,
|
||||
schedule_mid_span_fraction,
|
||||
)
|
||||
# --- Off-serving (Tier-2) LAZY exports — serve quarantine (ADR-0241/0242) --------
|
||||
# These are OFF-SERVING extensions: durable memory (holographic_vault) and
|
||||
# evidence-gated optimization / research thermodynamics (fibonacci_search,
|
||||
# wave_energy_boundary, multi_scale_energy). Eager-importing them here would drag
|
||||
# the whole substrate into the serve process (chat.runtime) via this package barrel
|
||||
# — the A-04 transitive breach documented in
|
||||
# docs/research/adr-0241-0242-adversarial-and-fidelity-findings.md (Finding #2).
|
||||
# They stay importable as `from core.physics import X` via PEP 562 __getattr__, but
|
||||
# resolve lazily only on explicit off-serving access. Guarded by
|
||||
# tests/test_serve_quarantine_transitive.py.
|
||||
#
|
||||
# NOTE (Joshua ruling 2026-07-15): wave_manifold is Tier-1 sanctioned serve
|
||||
# substrate (goldtether/surprise/biography delegate to it) and stays eager above.
|
||||
_LAZY_EXPORTS: dict[str, str] = {
|
||||
# holographic_vault — durable memory (L10 / persistence gate)
|
||||
"HolographicVaultError": "core.physics.holographic_vault",
|
||||
"HolographicVaultStore": "core.physics.holographic_vault",
|
||||
"SealedMode": "core.physics.holographic_vault",
|
||||
# wave_energy_boundary — P10 Trace B energy/τ gate (never serve)
|
||||
"CrystallizationDecision": "core.physics.wave_energy_boundary",
|
||||
"assess_wave_trajectory": "core.physics.wave_energy_boundary",
|
||||
"crystallization_for_holographic_seal": "core.physics.wave_energy_boundary",
|
||||
"energy_profile_from_wave": "core.physics.wave_energy_boundary",
|
||||
"fibonacci_tau_schedule": "core.physics.wave_energy_boundary",
|
||||
"recency_band_index": "core.physics.wave_energy_boundary",
|
||||
"wave_unitary_residual": "core.physics.wave_energy_boundary",
|
||||
# fibonacci_search — V1 evidence-gated optimization (never serve)
|
||||
"BASELINE_KAPPA": "core.physics.fibonacci_search",
|
||||
"BoundedUnimodalObjective": "core.physics.fibonacci_search",
|
||||
"FibonacciSearchCertificate": "core.physics.fibonacci_search",
|
||||
"OptimizationFailure": "core.physics.fibonacci_search",
|
||||
"fibonacci_number": "core.physics.fibonacci_search",
|
||||
"fibonacci_section_search": "core.physics.fibonacci_search",
|
||||
"propose_kappa_from_search": "core.physics.fibonacci_search",
|
||||
# multi_scale_energy — V2 research multi-band E_n(t) (never serve)
|
||||
"comparative_residual_separation": "core.physics.multi_scale_energy",
|
||||
"dyadic_tau_schedule": "core.physics.multi_scale_energy",
|
||||
"multi_scale_energy_for_schedule": "core.physics.multi_scale_energy",
|
||||
"multi_scale_energy_vector": "core.physics.multi_scale_energy",
|
||||
"schedule_mid_span_fraction": "core.physics.multi_scale_energy",
|
||||
}
|
||||
|
||||
from typing import TYPE_CHECKING
|
||||
|
||||
if TYPE_CHECKING: # static-analysis only — never imported at runtime (serve quarantine)
|
||||
from core.physics.holographic_vault import (
|
||||
HolographicVaultError,
|
||||
HolographicVaultStore,
|
||||
SealedMode,
|
||||
)
|
||||
from core.physics.wave_energy_boundary import (
|
||||
CrystallizationDecision,
|
||||
assess_wave_trajectory,
|
||||
crystallization_for_holographic_seal,
|
||||
energy_profile_from_wave,
|
||||
fibonacci_tau_schedule,
|
||||
recency_band_index,
|
||||
wave_unitary_residual,
|
||||
)
|
||||
from core.physics.fibonacci_search import (
|
||||
BASELINE_KAPPA,
|
||||
BoundedUnimodalObjective,
|
||||
FibonacciSearchCertificate,
|
||||
OptimizationFailure,
|
||||
fibonacci_number,
|
||||
fibonacci_section_search,
|
||||
propose_kappa_from_search,
|
||||
)
|
||||
from core.physics.multi_scale_energy import (
|
||||
comparative_residual_separation,
|
||||
dyadic_tau_schedule,
|
||||
multi_scale_energy_for_schedule,
|
||||
multi_scale_energy_vector,
|
||||
schedule_mid_span_fraction,
|
||||
)
|
||||
|
||||
__all__ = [
|
||||
"SalienceOperator", "SalienceMap", "FieldRegion",
|
||||
|
|
@ -163,3 +208,16 @@ __all__ = [
|
|||
"multi_scale_energy_vector",
|
||||
"schedule_mid_span_fraction",
|
||||
]
|
||||
|
||||
|
||||
def __getattr__(name: str): # PEP 562 — lazy off-serving (Tier-2) exports
|
||||
module = _LAZY_EXPORTS.get(name)
|
||||
if module is None:
|
||||
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
|
||||
import importlib
|
||||
|
||||
return getattr(importlib.import_module(module), name)
|
||||
|
||||
|
||||
def __dir__() -> list[str]:
|
||||
return sorted(set(globals()) | set(_LAZY_EXPORTS))
|
||||
|
|
|
|||
|
|
@ -0,0 +1,283 @@
|
|||
# ADR-0241 / ADR-0242 Session Completion Summary
|
||||
|
||||
**Date:** 2026-07-15
|
||||
**Purpose:** Pickup document — resume without re-deriving plans or re-litigating finished packages.
|
||||
**Companion plan archives:**
|
||||
|
||||
| Plan | File |
|
||||
|------|------|
|
||||
| **Plan A** — Cohesion mastery P0–P12 | [`docs/plans/adr-0241-cohesion-mastery-plan-p0-p12.md`](./adr-0241-cohesion-mastery-plan-p0-p12.md) |
|
||||
| **Plan B** — Drive-complete D0–D10 | [`docs/plans/adr-0242-drive-complete-plan-d0-d10.md`](./adr-0242-drive-complete-plan-d0-d10.md) |
|
||||
|
||||
**Acceptance checklist:** [`docs/audit/adr_0241_cohesion_acceptance_checklist.md`](../audit/adr_0241_cohesion_acceptance_checklist.md)
|
||||
**Fidelity ledger:** [`docs/research/third-door-blueprint-fidelity.md`](../research/third-door-blueprint-fidelity.md)
|
||||
|
||||
---
|
||||
|
||||
## 1. North star (unchanged)
|
||||
|
||||
```text
|
||||
listen → comprehend → recall → think → articulate → learn from reviewed correction → replay deterministically
|
||||
```
|
||||
|
||||
Wave-field work strengthens **recall / think / articulate / learn** on an inspectable Cl(4,1) substrate:
|
||||
|
||||
- **Recall:** resonant reconstruct + holographic SPECULATIVE modes (never COHERENT without teaching).
|
||||
- **Think:** residual / energy / multi-scale τ as deterministic control, not LLM fill.
|
||||
- **Learn:** contemplation SPECULATIVE seal only; COHERENT via teaching corridor (INV-21…30).
|
||||
- **Replay:** Fibonacci cert digests, path-stable env, soft demo budgets — pins stay honest.
|
||||
|
||||
Doctrine that never bends: `versor_condition < 1e-6`; no hot-path unitize; no cosine/ANN runtime memory; no serve wiring of wave/Fibonacci; no self-Accept of ADRs.
|
||||
|
||||
---
|
||||
|
||||
## 2. The four documents that authored both plans
|
||||
|
||||
These are the **design-truth quartet**. Plans A and B are projections of them into execution packages.
|
||||
|
||||
| # | Authority | In-repo path | Role in the program |
|
||||
|---|-----------|--------------|---------------------|
|
||||
| **1** | **ADR-0241** — wave-field hyperbolic atlas + resonant cognition | `docs/adr/ADR-0241-wave-field-driven-hyperbolic-atlas-and-resonant-cognition.md` | Continuous multivector field ψ, sandwich/left transport, spectral leakage → surprise, resonant recall, holographic vault, GoldTether residual, chiral Q, progressive continuous field honesty |
|
||||
| **2** | **ADR-0242** — deterministic Fibonacci + evidence-gated optimization | `docs/adr/ADR-0242-atlas-packing-and-fibonacci.md` | Five vectors V1–V5, sovereignty invariant (fib never sets truth/COHERENT/identity), cert-or-failure public API, packing as reconstructible allocator |
|
||||
| **3** | **core_ha** unification / deprecation | `docs/analysis/core_ha_unification_and_deprecation_plan.md` | Absorb HA into wave/GoldTether/energy/biography; kill live `core_ha`; optional Rust Step 2 mechanical sympathy |
|
||||
| **4** | **Fibonacci applications** R&D memo | `docs/analysis/fibonacci_applications_in_core_substrate.md` | Non-forced φ/F_n integration map: packing, section search, multi-scale τ, word schedule, anyons-as-research |
|
||||
|
||||
**Entity glue (Plan A dual authority):** `docs/analysis/core_cohesion_master_plan.md` — I-01…I-05, Trace A/B, Phase 0 A-01…A-04, living-entity definition of done.
|
||||
|
||||
**Critical discovery that forced Plan B:** Cohesion P0–P12 can be green while still **understating Drive ADR-0242** (in-repo ADR was packing+search only; Drive is five-vector + evidence-gated operators). Plan B closed that honesty gap without re-opening polar/chiral/packing fights.
|
||||
|
||||
---
|
||||
|
||||
## 3. Program shape (how the two plans relate)
|
||||
|
||||
```text
|
||||
┌─────────────────────────────────────┐
|
||||
│ Four Drive / cohesion authorities │
|
||||
└─────────────────┬───────────────────┘
|
||||
│
|
||||
┌───────────────────────┴───────────────────────┐
|
||||
▼ ▼
|
||||
Plan A — Cohesion entity mastery Plan B — Drive gap close
|
||||
P0–P12 living Cl(4,1) entity D0–D10 five-vector Fibonacci
|
||||
PR #37 (P0–P8) + PR #38 (P9–P12) all on PR #38 (macro only)
|
||||
│ │
|
||||
└───────────────────────┬───────────────────────┘
|
||||
▼
|
||||
Optional: P11a / D9 mechanical sympathy
|
||||
CI optim (#39) so gates are runnable
|
||||
▼
|
||||
D10 Joshua Accept (human only)
|
||||
```
|
||||
|
||||
**PR policy held:** no micro-PRs for Plan B; sole feature PR **#38** after #37 substrate.
|
||||
|
||||
---
|
||||
|
||||
## 4. What shipped — by package
|
||||
|
||||
### 4.1 Plan A — Cohesion (P0–P12)
|
||||
|
||||
| Pkg | Deliverable | Where it lives | Status |
|
||||
|-----|-------------|----------------|--------|
|
||||
| **P0** | Cohesion master plan + Phase 0 A-01…A-04 + pre-deprecation grep | `docs/analysis/core_cohesion_master_plan.md`, `tests/test_third_door_cohesion.py` | 🟢 |
|
||||
| **P1** | Vault public ABI; serve + Fibonacci quarantine; I-03 | `vault/store.py`, holographic vault, AST quarantine tests | 🟢 |
|
||||
| **P2** | Entity suite I-01…I-05 (honest float32/64) | `tests/test_third_door_cohesion.py` | 🟢 |
|
||||
| **P3** | Superposition reconstruct ∑ c_k ψ_k | `WaveManifold.resonant_reconstruct` | 🟢 |
|
||||
| **P4** | Golden-Angle packing + d_min + allocator identity | `core/physics/atlas_packing.py`, `tests/test_adr_0242_atlas_packing.py` | 🟢 |
|
||||
| **P5** | Fibonacci section search core | `core/physics/fibonacci_search.py`, `tests/test_adr_0242_fibonacci.py` | 🟢 (later upgraded by D1 cert API) |
|
||||
| **P6** | Multimodal ρ algebra (I-04) | `phase_correlation` on wave manifold | 🟢 algebra; feed closed by D7 |
|
||||
| **P7** | Polar honesty — conjugacy authority; multi-grade analytic retired honestly | wave_manifold + `docs/briefs/ADR-0241-cross-spectral-polar-brief.md` | 🟢 |
|
||||
| **P8** | Non-vacuous chiral / spinor path | wave_manifold chiral suite + chiral brief | 🟢 |
|
||||
| **P9** | Trace A: contemplation → SPECULATIVE holographic seal; hypothesis vs evidence reconstruct | `core/contemplation/wave_seam.py`, `tests/test_adr_0241_wave_contemplation_seam.py` | 🟢 on #38 |
|
||||
| **P10** | Trace B: wave residual → energy/trajectory; τ_n = F_n τ_0 table; crystallization gate | `wave_energy_boundary.py`, multi-scale helpers, energy tests | 🟢 on #38 |
|
||||
| **P11** | Rust/MLX optional | **P11a partial:** physics hot paths via `algebra.backend` (f32→Rust, f64→Python SOT) | 🟡 partial on #38 |
|
||||
| **P12** | runtime_contracts wave section; acceptance checklist; ADRs Proposed + ready for Joshua | `docs/audit/adr_0241_cohesion_acceptance_checklist.md`, `tests/test_adr_0241_governance_p12.py` | 🟢 ready; **not** Accepted |
|
||||
|
||||
### 4.2 Plan B — Drive gaps (D0–D10)
|
||||
|
||||
| Pkg | Deliverable | Status |
|
||||
|-----|-------------|--------|
|
||||
| **D0** | In-repo ADR-0242 matches Drive five-vector thesis (no silent scope shrink) | 🟢 |
|
||||
| **D1** | `FibonacciSearchCertificate` \| `OptimizationFailure`; never raw float public minimizer; stable cert digest | 🟢 |
|
||||
| **D2** | GoldTether κ optional path: cert success may propose κ; failure → κ=1.0 fail-closed | 🟢 |
|
||||
| **D3** | Multi-band E_n(t) research helper + evals quarantine (not production energy default) | 🟢 scaffold |
|
||||
| **D4** | Allocator identity/version + packing honesty pins | 🟢 |
|
||||
| **D5** | Fibonacci-word observability scheduler (telemetry only; not in serve/truth path) | 🟢 `fibonacci_word_schedule.py` |
|
||||
| **D6** | `algebra/topological_reasoning/` quarantine; production import blocked | 🟢 |
|
||||
| **D7** | Sensorium → ψ thin feed; real ρ; no cosine | 🟢 `sensorium_wave_feed.py` |
|
||||
| **D8** | Fibonacci applications memo in-repo + fidelity honesty | 🟢 |
|
||||
| **D9** | Rust f64 GP parity / deeper FFI | 🟡 **P11a** dispatch hygiene only; full f64 GP still open |
|
||||
| **D10** | Joshua Accept path | ⚪ human gate only |
|
||||
|
||||
### 4.3 CI / runner program (collateral, required for gates)
|
||||
|
||||
Shipped on **main via PR #39** (not #38), because single Act runner was starving PR checks:
|
||||
|
||||
| Change | Effect |
|
||||
|--------|--------|
|
||||
| `full-pytest.yml` → fast marker (`not quarantine and not slow`) | Main post-merge no longer holds runner 1–2h |
|
||||
| `nightly-full-pytest.yml` | Full soak at 02:00 UTC + dispatch |
|
||||
| `lane-shas.yml` job-level path skip | Skip heavy verify when no pin-relevant paths; still report green |
|
||||
| Soft `public_demo` budget (HARD only if `CORE_SHOWCASE_HARD_BUDGET=1`) | Cold Act wall-clock ≠ content failure |
|
||||
| Path-stable env deltas | Stop cancelled-run / thrash from poisoning pins |
|
||||
| Docs | `docs/ci-optimization.md`, updates to `docs/testing-lanes.md` |
|
||||
|
||||
**Validated:** main run **#164** lane-shas fully green after optim.
|
||||
|
||||
---
|
||||
|
||||
## 5. PR / branch map (resume orientation)
|
||||
|
||||
| PR | Branch | Content | Merge state (as of archive) |
|
||||
|----|--------|---------|------------------------------|
|
||||
| **#37** | `feat/adr-0241-0242-implementation` | Cohesion substrate P0–P8 + Gemini P4/P5 handoff | ✅ merged to `main` (`40859f9c`) |
|
||||
| **#39** | `optimize-ci-test-suites` | CI fast-lane + nightly + skip-safe lane-shas | ✅ merged to `main` (`b80f262f`) |
|
||||
| **#38** | `feat/adr-0241-p9-contemplation-trace-a` | P9–P12 + Drive D0–D8 + P11a + timeout bump | 🔴 **open** — tip `015c9fac` |
|
||||
|
||||
### #38 commit spine (tip → base)
|
||||
|
||||
```text
|
||||
015c9fac chore(ci): increase lane-shas timeout to 45 minutes ← Gemini
|
||||
44f7258b fix(algebra): P11a physics hot paths via algebra.backend
|
||||
db6430ed feat(adr-0242): macro-phase V2–V5 + sensorium feed
|
||||
bbd3b667 feat(adr-0242): Drive V1 cert discipline + doc align five vectors
|
||||
9d543f6a docs(governance): P12 cohesion close
|
||||
f123e0ea feat(wave): P10 Trace B energy + multi-scale τ
|
||||
aa86f1ae feat(wave): P9 Trace A contemplation SPECULATIVE seal
|
||||
```
|
||||
|
||||
Base: `b80f262f` (main post-#39). Mergeable when checks green.
|
||||
|
||||
### #38 CI state at archive time
|
||||
|
||||
| Check | Tip `015c9fac` |
|
||||
|-------|----------------|
|
||||
| smoke | ✅ ~6 min |
|
||||
| lane-shas | ❌ failed after ~22m39s (run #167); logs truncated mid-install/verify |
|
||||
|
||||
**Local truth:** `python scripts/verify_lane_shas.py` → **9/9** pins + CLAIMS current (~9 min) on this tip. Pins are not the suspected root cause; likely per-lane 900s timeout / Act resource under cold path, or incomplete Forgejo log. **Do not re-pin** unless CI logs show SHA mismatch.
|
||||
|
||||
**Obsolete noise:** run #161 was pre-#39 / wrong pin context — ignore.
|
||||
|
||||
---
|
||||
|
||||
## 6. Load-bearing modules (mental map)
|
||||
|
||||
| Concern | Module(s) |
|
||||
|---------|-----------|
|
||||
| Wave field / ρ / reconstruct / chiral / polar honesty | `core/physics/wave_manifold.py` |
|
||||
| Holographic modes + status-filtered reconstruct | `core/physics/holographic_vault.py` |
|
||||
| Contemplation Trace A seam | `core/contemplation/wave_seam.py` |
|
||||
| Energy / residual boundary Trace B | `core/physics/wave_energy_boundary.py` |
|
||||
| Multi-scale energy research | `core/physics/multi_scale_energy.py` |
|
||||
| Fibonacci cert search | `core/physics/fibonacci_search.py` |
|
||||
| Golden-Angle packing | `core/physics/atlas_packing.py` |
|
||||
| Fibonacci-word telemetry schedule | `core/physics/fibonacci_word_schedule.py` |
|
||||
| Sensorium → ψ feed | `core/physics/sensorium_wave_feed.py` |
|
||||
| GoldTether κ + residual | `core/physics/goldtether.py` |
|
||||
| Backend dispatch (P11a) | `algebra/backend.py` |
|
||||
| Topological quarantine | `algebra/topological_reasoning/` |
|
||||
| Entity + serve quarantine suite | `tests/test_third_door_cohesion.py` |
|
||||
| Backend AST hygiene | `tests/test_physics_backend_dispatch_hygiene.py` |
|
||||
|
||||
---
|
||||
|
||||
## 7. Invariants & non-goals still in force
|
||||
|
||||
### Must hold
|
||||
|
||||
- `versor_condition(F) < 1e-6`; closure only at owned algebra/construction boundaries.
|
||||
- INV-21 allowlist for `VaultStore.store`; contemplation uses `seal_mode` only (SPECULATIVE).
|
||||
- Serve AST quarantine: no wave / holographic / Fibonacci / packing / wave_seam on wrong=0 path.
|
||||
- Fibonacci **sovereignty:** never proposition truth, safety, identity, or auto COHERENT promotion.
|
||||
- Exact recall only (no cosine/ANN as memory truth).
|
||||
- ADRs: agents may mark **Proposed + ready**; only Joshua **Accepts**.
|
||||
|
||||
### Explicit non-goals (do not “finish” by doing these)
|
||||
|
||||
- Serve-path wiring of wave / Fibonacci / packing.
|
||||
- Resurrecting `core_ha` or Poincaré as runtime memory truth.
|
||||
- Continuous continuum ψ(X,t) solver as merge blocker.
|
||||
- Stripping semantic demo fields to force pin green.
|
||||
- Self-Accept of ADR-0241 / ADR-0242.
|
||||
|
||||
---
|
||||
|
||||
## 8. Verification recipes (pickup)
|
||||
|
||||
```bash
|
||||
# Cohesion + ADR regression (Plan A/B product)
|
||||
python3 -m pytest \
|
||||
tests/test_third_door_cohesion.py \
|
||||
tests/test_adr_0241_*.py \
|
||||
tests/test_adr_0242_*.py \
|
||||
tests/test_adr_0241_governance_p12.py \
|
||||
tests/test_physics_backend_dispatch_hygiene.py \
|
||||
-q
|
||||
|
||||
# Optional Rust path (needs core_rs built)
|
||||
CORE_BACKEND=rust python3 -m pytest tests/test_adr_0241_wave_manifold.py tests/test_third_door_cohesion.py -q
|
||||
|
||||
# Lane pins (same as CI body; soft public_demo by default)
|
||||
uv run python scripts/verify_lane_shas.py
|
||||
uv run python scripts/generate_claims.py --check
|
||||
|
||||
# Smallest CLI smoke
|
||||
core test --suite smoke -q
|
||||
```
|
||||
|
||||
**Do not** treat full-pytest / nightly as PR gate; that is main fast-lane + nightly after #39.
|
||||
|
||||
---
|
||||
|
||||
## 9. Exact next concrete steps (hit the ground running)
|
||||
|
||||
### Immediate — unblock merge of #38
|
||||
|
||||
1. Diagnose **lane-shas run #167** full step log on the Act host (Forgejo UI log is truncated).
|
||||
2. If **TimeoutExpired** on a lane: raise per-lane `timeout=900` in `scripts/verify_lane_shas.py` and/or slim cold path — **job** timeout alone (45m) does not fix 15m single-lane kills.
|
||||
3. If **SHA mismatch**: only then re-pin with `--update` and CLAIMS check (local was 9/9).
|
||||
4. Re-run lane-shas on tip `015c9fac` (or fix commit + push). Gemini (low) is set to merge on green — do not force-merge past red.
|
||||
5. After merge: pull `main`, delete session-break noise, confirm post-merge main smoke/lane-shas.
|
||||
|
||||
### Post-merge product backlog (ordered)
|
||||
|
||||
| Priority | Item | Notes |
|
||||
|----------|------|--------|
|
||||
| 1 | **D10 Joshua review** | Flip ADR-0241/0242 → Accepted only after human read of checklist |
|
||||
| 2 | **D9 / P11 remainder** | Rust f64 geometric product parity if UMA path must match f64 wave residuals |
|
||||
| 3 | **Runner capacity** | Second Act runner or larger VM — only real concurrent PR fix (`docs/ci-optimization.md`) |
|
||||
| 4 | Progressive continuous field | Still progressive (mode samples); not a merge blocker |
|
||||
| 5 | V2 energy production promotion | Only with benchmark win + explicit gate — currently research |
|
||||
|
||||
### Do not re-open without cause
|
||||
|
||||
- P7 polar retirement decision (conjugacy authority).
|
||||
- P4 packing metric honesty (null-point Euclidean readout vs full H² geodesic).
|
||||
- Soft public_demo budget design (content cases remain hard).
|
||||
|
||||
---
|
||||
|
||||
## 10. Session continuity pointers
|
||||
|
||||
| Need | Location |
|
||||
|------|----------|
|
||||
| Plan A full text | `docs/plans/adr-0241-cohesion-mastery-plan-p0-p12.md` |
|
||||
| Plan B full text | `docs/plans/adr-0242-drive-complete-plan-d0-d10.md` |
|
||||
| This summary | `docs/plans/adr-0241-0242-session-completion-summary-2026-07-15.md` |
|
||||
| Cohesion acceptance (C0–C8 + human gate) | `docs/audit/adr_0241_cohesion_acceptance_checklist.md` |
|
||||
| CI bottleneck doctrine | `docs/ci-optimization.md` |
|
||||
| Gemini math briefs | `docs/briefs/ADR-0241-*.md`, `docs/briefs/ADR-0242-*.md` |
|
||||
| Remote | Forgejo `core-labs/core` — **not** GitHub |
|
||||
|
||||
**Remote / tools:** `forgejo` remote → `core-gitquarters.acbcontent.org/core-labs/core`. Use Forgejo MCP / `tea`, never `gh` for this repo.
|
||||
|
||||
---
|
||||
|
||||
## 11. One-paragraph brief for the next agent
|
||||
|
||||
You are resuming CORE ADR-0241/0242 work. Plan A (cohesion P0–P12) and Plan B (Drive D0–D8 + P11a) are **implemented on open PR #38** (`feat/adr-0241-p9-contemplation-trace-a`, tip `015c9fac`); CI optim is already on main via #39. Product is implementation-complete for cohesion and Drive Phase 1–vector scaffold; **Joshua Accept** and **full Rust f64 parity** remain. Merge is blocked on **lane-shas CI red** despite **local 9/9 pins** — fix runner/timeout or get full #167 logs before re-pinning. Read the two plan archives and this summary; re-run the pytest recipe above; do not wire serve or self-Accept ADRs.
|
||||
|
||||
---
|
||||
|
||||
*Archived from session work on 2026-07-15. Plans A/B copied from session plan artifacts; status tables updated to match branch tip and CI reality at archive time.*
|
||||
435
docs/plans/adr-0241-cohesion-mastery-plan-p0-p12.md
Normal file
435
docs/plans/adr-0241-cohesion-mastery-plan-p0-p12.md
Normal file
|
|
@ -0,0 +1,435 @@
|
|||
# ADR-0241 / Cohesion Mastery Plan (P0–P12)
|
||||
|
||||
**Plan ID:** Plan A — Cohesion entity mastery
|
||||
**Status:** Implementation complete on Forgejo PR #37 (P0–P8 substrate) + PR #38 (P9–P12 + later Drive work). Human **Accepted** flip remains Joshua-only.
|
||||
**Branch lineage:** `feat/adr-0241-0242-implementation` (#37) → `feat/adr-0241-p9-contemplation-trace-a` (#38)
|
||||
**Date (plan authored):** 2026-07-14
|
||||
**Date (archived to docs):** 2026-07-15
|
||||
**Policy:** Entity cohesion over module greenness; fail-closed residual doctrine; Gemini/Antigravity design stops for pure math.
|
||||
|
||||
## Framing
|
||||
|
||||
ADR-0241 local wave operators are green. The cohesion master plan reframes "done" as **Hyperbolic Atlas absorbed into a single living Cl(4,1) entity** with Trace A/B, entity invariants I-01…I-05, Golden-Angle packing, Fibonacci optimization (ADR-0242), multimodal algebraic resonance, formal Phase 0 deprecation safety, and mechanical-sympathy Rust depth. This plan makes those facts load-bearing, keeps AGENTS.md fail-closed doctrine (reject silent dual-correction repair), and gates deepest math through Gemini/Antigravity design stop-points.
|
||||
|
||||
### Authority sources used to author this plan
|
||||
|
||||
| # | Document | Path / origin |
|
||||
|---|----------|----------------|
|
||||
| 1 | ADR-0241 wave-field hyperbolic atlas | `docs/adr/ADR-0241-wave-field-driven-hyperbolic-atlas-and-resonant-cognition.md` (+ Drive export) |
|
||||
| 2 | ADR-0242 Fibonacci / packing (then draft) | `docs/adr/ADR-0242-atlas-packing-and-fibonacci.md` (+ Drive export) |
|
||||
| 3 | Cohesion master plan | `docs/analysis/core_cohesion_master_plan.md` |
|
||||
| 4 | core_ha unification / deprecation | `docs/analysis/core_ha_unification_and_deprecation_plan.md` |
|
||||
|
||||
Supporting: `docs/research/third-door-blueprint-fidelity.md`, Fibonacci applications memo (later D8).
|
||||
|
||||
---
|
||||
|
||||
### Entity-Level Invariants (success criteria)
|
||||
|
||||
| ID | Requirement | Current gap |
|
||||
|----|-------------|-------------|
|
||||
| **I-01** | Biography holonomy closed + **reboot-invariant** from content-addressed ledger | Session-only registry; no durable bio ledger pin |
|
||||
| **I-02** | Wave ψ vaulted via CRDT/teaching chain reconstructs with \(\\|\psi_2-\psi_1\\|_F < 10^{-12}\) | No end-to-end bit-stable pin |
|
||||
| **I-03** | Self-authorship never mutates active manifold / never writes COHERENT | Pattern exists; must pin against holographic seal abuse |
|
||||
| **I-04** | Multimodal match via \(\langle \psi_A\widetilde{\psi}_B + \psi_B\widetilde{\psi}_A\rangle_0\) only (no cosine/ANN) | Operator + sensorium seam missing |
|
||||
| **I-05** | GoldTether unitary residual \(< 10^{-6}\) on every wave transition | Local dual-check exists; not entity-wide boundary suite |
|
||||
|
||||
### Hyperbolic Atlas facts (under-specified before)
|
||||
|
||||
| Atlas concern | Cohesion / Fibonacci requirement | Implementation surface |
|
||||
|---------------|----------------------------------|------------------------|
|
||||
| Thaw loss | Resonant lock-in / reconstruct, not coordinate thaw | `WaveManifold` + `HolographicVaultStore` |
|
||||
| Node eviction rigidity | Continuous mode spectrum + packing, not discrete node IDs | Standing-wave modes; **no** `atlas_id` resurrection |
|
||||
| Mode packing | Golden-Angle / hyperbolic phyllotaxis on horosphere | New: `atlas_packing` or methods on `WaveManifold` |
|
||||
| Separation | Pairwise geodesic \(d_{\min}=0.12\) or reject | Benchmark + allocator fail-closed |
|
||||
| Insertion cost | CPU/alloc metric for mode registration | `evals/` / calibration only (R-04 gated observability) |
|
||||
| Coordinate dissolution (ADR-0003) | Poincaré may be used **only as a construction lift** into Cl(4,1); never as runtime memory truth | Construction boundary only |
|
||||
|
||||
### Tension with AGENTS.md (resolve explicitly)
|
||||
|
||||
| Cohesion text | Risk vs CORE doctrine | Resolution in this plan |
|
||||
|---------------|----------------------|-------------------------|
|
||||
| R-01 “dual-correction fallback to nearest exact versor” on drift | Forbidden **hot-path drift repair** / unitize outside owned boundaries | **Fail-closed** on residual breach in propagate-like paths; any close/unitize only at **construction / admit** boundaries (`wave_manifold` exp construction, holographic `_admit`, biography construction). No silent nearest-versor repair in field/generate/vault hot paths. |
|
||||
| Sketch tests use `np.random` + Euclidean norm of ψ | Non-deterministic, non-algebraic | Deterministic fixtures; CGA/reverse-product norms |
|
||||
| `sup_X` continuous field residual | API is still pointwise 32-vec | Document progressive meaning: residual on registered mode samples / manifold sample set until continuous field representation exists |
|
||||
|
||||
---
|
||||
|
||||
## Recommended approach
|
||||
|
||||
Treat mastery as **entity cohesion**, not module greenness.
|
||||
|
||||
1. **Land the cohesion master plan** in-repo as the dual authority beside ADR-0241.
|
||||
2. **Phase 0 audits first** (A-01…A-04 + pre-deprecation grep) — already mostly true, must become **CI-pinned**.
|
||||
3. **Trust + entity invariant suite** (I-01…I-05 RED→GREEN) as the definition of “cohesive.”
|
||||
4. **Atlas packing + Fibonacci (ADR-0242 track)** as first-class under dual branch scope, with Antigravity/Gemini design stops for pure math.
|
||||
5. **True polar / chiral** remain algebraic mastery upgrades with design handoffs.
|
||||
6. **Rust FFI** after Python authority exists for exp/residual (mechanical sympathy), not before.
|
||||
7. Continuous adversarial audits after every GREEN package.
|
||||
|
||||
---
|
||||
|
||||
## Work package map (revised)
|
||||
|
||||
```text
|
||||
P0 Land cohesion plan + Phase 0 audits (A-01…A-04) + honesty ledger
|
||||
P1 Trust hardening (Vault public ABI, serve+Fibonacci quarantine, I-03 pins)
|
||||
P2 Entity suite I-01…I-05 (tests/test_third_door_cohesion.py + entity invariants)
|
||||
P3 Superposition reconstruction ∑ c_k ψ_k
|
||||
P4 Hyperbolic Atlas packing (Golden-Angle / d_min) ── STOP → Gemini design brief
|
||||
P5 Fibonacci search + GoldTether κ (ADR-0242 slice A) ── STOP → Gemini design brief
|
||||
P6 Multimodal phase correlation (I-04) sensorium-facing pure algebra
|
||||
P7 True C_AB + Clifford polar ── STOP → Gemini design brief
|
||||
P8 Non-vacuous chiral (spinor path) ── STOP → Gemini design brief
|
||||
P9 Cognition seam Trace A (contemplation SPECULATIVE → teaching corridor)
|
||||
P10 Energy boundary + multi-scale τ (Trace B + Fibonacci τ_n optional)
|
||||
P11 Rust/MLX FFI (wedge / expm / versor_unit_residual) after P7 authority
|
||||
P12 Governance close (CLAIMS, runtime_contracts, ADR-0241 Accepted, draft ADR-0242)
|
||||
```
|
||||
|
||||
**Minimum for “ADR-0241 + cohesion complete”:** P0–P3, P6, P9, P12 (with P4–P5 honesty: either implement or demote claims).
|
||||
**Absolute mastery / genius bar:** all P0–P12 with P7–P8 math landed (not demoted).
|
||||
|
||||
---
|
||||
|
||||
## Critical files
|
||||
|
||||
### New
|
||||
| Path | Purpose |
|
||||
|------|---------|
|
||||
| `docs/analysis/core_cohesion_master_plan.md` | Canonical cohesion authority (from Downloads) |
|
||||
| `tests/test_third_door_cohesion.py` | Unified entity + Fibonacci + deprecation suite |
|
||||
| `tests/test_entity_invariants_i01_i05.py` (or section of cohesion suite) | I-01…I-05 pins |
|
||||
| `core/physics/fibonacci_search.py` | Bounded unimodal Fibonacci section search (ADR-0242) |
|
||||
| `core/physics/atlas_packing.py` (or WaveManifold methods) | Golden-Angle mode packing + \(d_{\min}\) |
|
||||
| `docs/briefs/ADR-0241-cross-spectral-polar-brief.md` | Gemini handoff |
|
||||
| `docs/briefs/ADR-0241-chiral-spinor-brief.md` | Gemini handoff |
|
||||
| `docs/briefs/ADR-0242-atlas-packing-and-fibonacci-brief.md` | Gemini handoff |
|
||||
| `docs/adr/ADR-0242-*.md` | Draft after P5/P4 design acceptance |
|
||||
|
||||
### Modify
|
||||
| Path | Purpose |
|
||||
|------|---------|
|
||||
| `vault/store.py` | Public versor/entry read ABI |
|
||||
| `core/physics/holographic_vault.py` | Drop `_versors`; I-02 reload path |
|
||||
| `core/physics/wave_manifold.py` | Reconstruct, packing hooks, phase correlation, residual samples |
|
||||
| `core/physics/biography.py` | I-01 durable reconstruct path (ledger/holographic) |
|
||||
| `core/physics/goldtether.py` | κ search integration surface (eval-only by default) |
|
||||
| `core/physics/energy.py` | Crystallization Trace B; optional Fibonacci τ schedule |
|
||||
| `core/physics/self_authorship.py` | I-03 pins vs holographic COHERENT |
|
||||
| `core/physics/surprise.py` / `dynamic_manifold.py` | Remain delegates; polar upgrade post-P7 |
|
||||
| `tests/test_architectural_invariants.py` | Containment + INV-21 + grep-like hygiene |
|
||||
| `docs/adr/ADR-0241-...md` | Entity traces + I-* cross-links; honest status |
|
||||
| `docs/research/third-door-blueprint-fidelity.md` | Cohesion rows; demote thin 🟢 |
|
||||
| `CLAIMS.md`, `docs/specs/runtime_contracts.md` | After pins hold |
|
||||
|
||||
### Reuse
|
||||
| Primitive | Path |
|
||||
|-----------|------|
|
||||
| Algebra product / reverse / scalar | `algebra/cl41.py` |
|
||||
| `cga_inner`, null points | `algebra/cga.py`, `algebra/null_point.py` |
|
||||
| Versor residual / apply / condition | `algebra/versor.py` |
|
||||
| Holonomy encode | `algebra/holonomy.py` |
|
||||
| Metric project / leakage | `wave_manifold._metric_project` |
|
||||
| VaultStore.store / iter_metadata | `vault/store.py` |
|
||||
| EpistemicStatus | `teaching.epistemic` |
|
||||
| Trajectory energy bound | `trajectory_invariants.py` |
|
||||
| Existing ADR-0241 tests | `tests/test_adr_0241_*.py` |
|
||||
| Rust surfaces | `core-rs/src/{cl41,diffusion,versor,vault,lib}.rs` |
|
||||
|
||||
---
|
||||
|
||||
## Package detail
|
||||
|
||||
### P0 — Land cohesion plan + Phase 0 (mandatory first)
|
||||
|
||||
1. Copy/normalize Downloads master plan → `docs/analysis/core_cohesion_master_plan.md` (fix escaped LaTeX/markdown; keep meaning).
|
||||
2. Cross-link from ADR-0241, deprecation plan, fidelity ledger.
|
||||
3. Execute **A-01…A-04** as a written checklist artifact in `docs/audit/` or test-pinned notes:
|
||||
- **A-01** branch parity (this worktree vs `main` / third-door branches)
|
||||
- **A-02** WaveManifold bindings present in `dynamic_manifold.py` / `surprise.py`
|
||||
- **A-03** no Euclidean-only projection as truth in active invariant tests (metric-exact already pinned for leakage; extend scan)
|
||||
- **A-04** serve-path quarantine for wave **and** Fibonacci
|
||||
4. Pre-deprecation grep as **automated test** (not manual one-off):
|
||||
- no `import core_ha` / `from core_ha`
|
||||
- no `hyperbolic_primitives`
|
||||
- flag bare `poincare` / Poincaré **runtime** fixtures (construction-lift tests may whitelist)
|
||||
5. Honesty pass on fidelity §12: mark thin polar/chiral/atlas-packing as 🟡 until P4/P7/P8.
|
||||
|
||||
**Agents:** orchestrator + `doc-updater`.
|
||||
**Adversarial audit:** skeptic — every prior 🟢 must map to either entity invariant or local pin.
|
||||
|
||||
**Exit:** cohesion plan in-repo; Phase 0 suite green.
|
||||
|
||||
---
|
||||
|
||||
### P1 — Trust hardening
|
||||
|
||||
1. **Public VaultStore read ABI**; remove `holographic_vault` private `_versors`.
|
||||
2. **Serve containment** AST/import tests: `chat/runtime.py` (and wrong=0 serve entry) must not import `wave_manifold`, `holographic_vault`, or future `fibonacci_search` / `atlas_packing`.
|
||||
3. **I-03 pin:** self-authorship + holographic path cannot write COHERENT without explicit review gate; SPECULATIVE only.
|
||||
4. COHERENT seal remains non-self-authorizing; document ADR-0092 still deferred.
|
||||
5. Dual residual checks stay fail-closed (I-05 local).
|
||||
|
||||
**Agents:** `tdd-guide` → implement → `security-reviewer` + `python-reviewer` → adversarial `code-reviewer`.
|
||||
|
||||
**Exit:** restart holographic tests green without private ABI; containment + I-03 green.
|
||||
|
||||
---
|
||||
|
||||
### P2 — Entity invariant suite (definition of cohesion)
|
||||
|
||||
Implement `tests/test_third_door_cohesion.py` (and/or dedicated entity file) with **deterministic** fixtures (reject random-norm sketch as authority):
|
||||
|
||||
| Test | Invariant |
|
||||
|------|-----------|
|
||||
| Biography holonomy closed + reconstruct after vault-backed mode reload | I-01 |
|
||||
| Seal ψ₁ SPECULATIVE → reload spectrum → \(\\|\psi_2-\psi_1\\|_F < 10^{-12}\) (float64 path; document float32 store policy if dtype differs) | I-02 |
|
||||
| Self-authorship / miner cannot COHERENT-seal holographic modes | I-03 |
|
||||
| Phase-correlation API rejects cosine path; algebraic symmetry pin | I-04 (stub until P6 full multimodal) |
|
||||
| Schrödinger/sandwich step residual < 1e-6 dual-checked | I-05 |
|
||||
| `core_ha` import raises / find_spec None | Deprecation |
|
||||
| Fibonacci search stub xfail until P5 | ADR-0242 placeholder |
|
||||
|
||||
**Float32 note:** VaultStore may store float32; I-02’s \(10^{-12}\) may require float64 path or a dual tolerance (float64 exact / float32 ≤ 1e-6). Pin **honestly** — do not fake bit-identity across dtype cast.
|
||||
|
||||
**Agents:** `tdd-guide` → implement missing glue only → `code-reviewer`.
|
||||
|
||||
**Exit:** entity suite exists and fails closed on regressions; I-02 dtype policy documented.
|
||||
|
||||
---
|
||||
|
||||
### P3 — Superposition reconstruction
|
||||
|
||||
Realize \(\hat\psi = \sum_k c_k \psi_k\) from reverse-product overlaps (not only argmax).
|
||||
|
||||
- RED: partial-combo query reconstructs closer to combo than pure modes.
|
||||
- Empty refuse preserved.
|
||||
- Keep `resonant_recall` as lock-in index API for biography compatibility.
|
||||
|
||||
**Exit:** W5 upgraded from argmax-only to interference-capable.
|
||||
|
||||
---
|
||||
|
||||
### P4 — Hyperbolic Atlas packing (Golden-Angle)
|
||||
|
||||
**STOP → Antigravity/Gemini brief:** `docs/briefs/ADR-0242-atlas-packing-and-fibonacci-brief.md` (section A).
|
||||
|
||||
Must specify:
|
||||
1. Lift of Golden Angle \(\theta_k = 2\pi k\phi^{-1}\), \(r_k=\tanh(\alpha\sqrt{k})\) into **Cl(4,1) horosphere points** (null vectors / CGA), without making Poincaré runtime truth (ADR-0003).
|
||||
2. Geodesic separation metric on horosphere and fail if \(d_{\min}<0.12\).
|
||||
3. Insertion cost measurement only in `evals/` / `calibration/` (R-04).
|
||||
4. How modes register into `WaveManifold` / holographic vault.
|
||||
5. Non-goals: resurrecting `core_ha` package, node IDs, thaw coordinates.
|
||||
|
||||
**After design return:** TDD allocator + rejection threshold + packing determinism.
|
||||
|
||||
**Exit:** packing pins green; insertion-cost benchmark in evals quarantine.
|
||||
|
||||
---
|
||||
|
||||
### P5 — Fibonacci section search + GoldTether κ (ADR-0242 slice)
|
||||
|
||||
**STOP → same Gemini brief (section B)** or resume from P4 brief.
|
||||
|
||||
1. `core/physics/fibonacci_search.py`: `BoundedUnimodalObjective`, `fibonacci_section_search`, certificate/trace (eval sequence length = budget).
|
||||
2. Integration test: minimize synthetic unimodal residual for κ (cohesion sketch, deterministic).
|
||||
3. Optional later: real Procrustes residual line search under fixed N evals (Fidelity Score metric).
|
||||
4. **Never** import into `chat/runtime.py` (A-04).
|
||||
5. Unimodality violation → fail-closed (cohesion §4.2).
|
||||
6. Draft **ADR-0242** from Fibonacci + packing decisions.
|
||||
|
||||
**Exit:** cohesion Fibonacci test green; ADR-0242 draft ready for review.
|
||||
|
||||
---
|
||||
|
||||
### P6 — Multimodal phase correlation (I-04)
|
||||
|
||||
Implement pure algebra helper:
|
||||
|
||||
\[
|
||||
\rho(\psi_A,\psi_B)=\langle \psi_A\widetilde{\psi}_B + \psi_B\widetilde{\psi}_A\rangle_0
|
||||
\]
|
||||
|
||||
1. On `WaveManifold` (or `wave_resonance.py`).
|
||||
2. Tests: symmetry, no cosine imports, deterministic.
|
||||
3. Thin adapter at sensorium boundary for text/audio/vision/motor **ψ packets** if already compilable; else pin operator + fake multimodal vectors until sensorium compilers feed real packets.
|
||||
4. Forbidden: sklearn neighbors, faiss, cosine ranking as truth.
|
||||
|
||||
**Exit:** I-04 fully behavioral (not stub).
|
||||
|
||||
---
|
||||
|
||||
### P7 — True \(\mathcal{C}_{AB}\) + Clifford polar
|
||||
|
||||
**STOP → Gemini brief** `docs/briefs/ADR-0241-cross-spectral-polar-brief.md`.
|
||||
|
||||
Same bar as prior plan: algebra-native only; tests that thin wrap fails; `wave_analogical_polar` becomes truth; Procrustes field path delegates.
|
||||
|
||||
---
|
||||
|
||||
### P8 — Non-vacuous chiral
|
||||
|
||||
**STOP → Gemini brief** `docs/briefs/ADR-0241-chiral-spinor-brief.md`.
|
||||
|
||||
Preserve even-versor honesty (#19); spinor path informative conserved Q; Trace B topological charge real.
|
||||
|
||||
---
|
||||
|
||||
### P9 — Contemplation / teaching seam (Trace A)
|
||||
|
||||
1. Contemplation or sealed-practice path may **SPECULATIVE-seal** standing-wave modes.
|
||||
2. Proposals only; teaching corridor for COHERENT.
|
||||
3. Resonant reconstruct available as hypothesis, never as evidence without `min_status=COHERENT`.
|
||||
4. Serve still quarantined.
|
||||
|
||||
**Agents:** `architect` for seam choice → `tdd-guide` → `security-reviewer`.
|
||||
|
||||
---
|
||||
|
||||
### P10 — Energy boundary + multi-scale τ (Trace B)
|
||||
|
||||
1. Wire wave unitary residual into energy / trajectory boundary checks.
|
||||
2. Optional \(\tau_n = F_n \tau_0\) recency hierarchy (Fibonacci memo §4) as **constants table**, not dogma.
|
||||
3. Crystallization E0–E1 → vault candidate aligns with holographic seal policy.
|
||||
|
||||
---
|
||||
|
||||
### P11 — Rust / mechanical sympathy
|
||||
|
||||
Only after Python math authority for exp residual:
|
||||
|
||||
| Binding | Role |
|
||||
|---------|------|
|
||||
| `cl41::wedge` | Exterior product / PCA blades |
|
||||
| `diffusion.rs::expm` | Unitarity-aware \(R=\exp(B\Delta t)\) |
|
||||
| `versor_unit_residual` | SIMD GoldTether residual |
|
||||
|
||||
Parity tests: Rust == Python within tol; no scipy truth.
|
||||
**Hand off optional** to Antigravity for Rust micro-optim if Python contracts frozen.
|
||||
|
||||
---
|
||||
|
||||
### P12 — Governance close
|
||||
|
||||
1. CLAIMS pins for I-01…I-05 (or subset landed).
|
||||
2. `runtime_contracts.md`: off-serve wave + SPECULATIVE holographic kind + Fibonacci quarantine.
|
||||
3. ADR-0241 → Accepted path after Joshua review.
|
||||
4. ADR-0242 draft → Proposed.
|
||||
5. Fidelity ledger truth.
|
||||
6. Cohesion checklist boxes I-* and A-* reflected as tests, not prose.
|
||||
|
||||
---
|
||||
|
||||
## Antigravity / Gemini mandatory stop-points
|
||||
|
||||
| When | Brief | Resume when |
|
||||
|------|-------|-------------|
|
||||
| Before P4/P5 | `docs/briefs/ADR-0242-atlas-packing-and-fibonacci-brief.md` | Horosphere lift + d_min + Fibonacci search contracts review-passed |
|
||||
| Before P7 | `docs/briefs/ADR-0241-cross-spectral-polar-brief.md` | Algebra-native polar design; thin-wrap-failing RED tests listed |
|
||||
| Before P8 | `docs/briefs/ADR-0241-chiral-spinor-brief.md` | Non-vacuous spinor Q without reviving #19 |
|
||||
| Optional P11 | Rust expm/residual micro-arch brief | Python parity suite frozen |
|
||||
|
||||
Each brief must include: ADR citations, AGENTS.md invariant compliance, non-goals, RED tests current code cannot pass, numerical thresholds from cohesion plan.
|
||||
|
||||
---
|
||||
|
||||
## Agent orchestration
|
||||
|
||||
```text
|
||||
Orchestrator
|
||||
P0 docs + Phase 0 automation
|
||||
P1 tdd → impl → security + python review → adversarial code-review
|
||||
P2 tdd entity suite → impl glue → adversarial
|
||||
P3 tdd reconstruct → impl → review
|
||||
⏸ Gemini: atlas packing + Fibonacci (P4/P5)
|
||||
P4–P5 implement after design
|
||||
P6 multimodal ρ
|
||||
⏸ Gemini: polar (P7)
|
||||
⏸ Gemini: chiral (P8)
|
||||
P9 cognition seam (architect + security)
|
||||
P10 energy
|
||||
P11 rust (optional Antigravity)
|
||||
P12 governance + human Joshua acceptance
|
||||
```
|
||||
|
||||
**Adversarial review after every package:**
|
||||
(1) namesake-green? (2) entity invariant covered? (3) serve quarantine held? (4) docs/ledger/code agree?
|
||||
|
||||
---
|
||||
|
||||
## Success definition
|
||||
|
||||
### Cohesion-complete (dual-ADR branch minimum)
|
||||
|
||||
| # | Criterion |
|
||||
|---|-----------|
|
||||
| C0 | Cohesion master plan in-repo; Phase 0 A-01…A-04 automated/pinned |
|
||||
| C1 | I-01…I-05 suite green under honest tolerances |
|
||||
| C2 | Vault public ABI; no private `_versors` |
|
||||
| C3 | Serve + Fibonacci quarantine AST-green |
|
||||
| C4 | Superposition reconstruct behavioral pins |
|
||||
| C5 | Multimodal ρ operator (I-04) green |
|
||||
| C6 | Contemplation SPECULATIVE holographic seam (Trace A) without serve |
|
||||
| C7 | Pre-deprecation grep CI-green |
|
||||
| C8 | CLAIMS + runtime_contracts + ADR-0241 acceptance path |
|
||||
|
||||
### Absolute mastery
|
||||
|
||||
All of the above **plus**: Golden-Angle packing \(d_{\min}\); Fibonacci κ search + ADR-0242 draft; true polar; non-vacuous chiral; energy boundary; optional Rust parity.
|
||||
|
||||
### Explicit non-goals for “complete”
|
||||
|
||||
- Wiring wave/Fibonacci into wrong=0 serve
|
||||
- Resurrecting `core_ha`
|
||||
- Cosine/ANN multimodal matching
|
||||
- Hot-path silent unitize “nearest versor” repair (reject R-01 as written; use fail-closed)
|
||||
- Claiming continuous \(\psi(X,t)\) continuum solver before packing+modes give progressive field semantics
|
||||
|
||||
---
|
||||
|
||||
## Verification lanes
|
||||
|
||||
```bash
|
||||
# Phase 0 / hygiene
|
||||
python3 -m pytest tests/test_third_door_cohesion.py tests/test_adr_0241_*.py -q
|
||||
python3 -m pytest tests/test_architectural_invariants.py -q -k "INV21 or vault or wave or holographic or core_ha or poincare"
|
||||
|
||||
# Third-Door regression
|
||||
python3 -m pytest tests/test_adr_0238*.py tests/test_adr_0239*.py tests/test_adr_0240*.py tests/test_third_door*.py -q
|
||||
|
||||
# Broader
|
||||
core test --suite algebra -q
|
||||
core test --suite runtime -q
|
||||
core test --suite smoke -q
|
||||
```
|
||||
|
||||
**Quantifiable thresholds (from cohesion plan, adjusted for honesty):**
|
||||
|
||||
| Metric | Threshold |
|
||||
|--------|-----------|
|
||||
| Unitary residual (I-05) | \(< 10^{-6}\) |
|
||||
| Vault round-trip float64 (I-02) | \(< 10^{-12}\) (or documented float32 ≤ 1e-6) |
|
||||
| Biography closure (I-01) | `versor_condition < 1e-6` post-reboot reconstruct |
|
||||
| Horosphere packing (P4) | pairwise geodesic \(\ge 0.12\) or reject |
|
||||
| Fibonacci search (P5) | best point within 1e-3 of known unimodal min; eval count = budget |
|
||||
| Phase correlation (I-04) | algebraic identity pins; no banned imports |
|
||||
| Serve imports | zero illegal modules |
|
||||
|
||||
---
|
||||
|
||||
## Execution order after plan approval
|
||||
|
||||
1. P0 land cohesion plan + Phase 0 automation
|
||||
2. P1 trust ABI + quarantine
|
||||
3. P2 entity suite (RED → GREEN)
|
||||
4. P3 reconstruct
|
||||
5. **STOP:** emit ADR-0242 packing+Fibonacci brief to Antigravity/Gemini
|
||||
6. P6 multimodal ρ (can parallel while Gemini works)
|
||||
7. On brief return → P4 packing, P5 Fibonacci + draft ADR-0242
|
||||
8. **STOP:** polar brief → P7
|
||||
9. **STOP:** chiral brief → P8
|
||||
10. P9 Trace A seam
|
||||
11. P10 energy
|
||||
12. P11 Rust only if needed
|
||||
13. P12 governance + Joshua acceptance
|
||||
403
docs/plans/adr-0242-drive-complete-plan-d0-d10.md
Normal file
403
docs/plans/adr-0242-drive-complete-plan-d0-d10.md
Normal file
|
|
@ -0,0 +1,403 @@
|
|||
# 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.
|
||||
|
||||
```text
|
||||
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):
|
||||
|
||||
```text
|
||||
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
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
```text
|
||||
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.
|
||||
122
docs/research/adr-0241-0242-adversarial-and-fidelity-findings.md
Normal file
122
docs/research/adr-0241-0242-adversarial-and-fidelity-findings.md
Normal file
|
|
@ -0,0 +1,122 @@
|
|||
# ADR-0241/0242 — Adversarial Verification & Blueprint-Fidelity Findings (W1)
|
||||
|
||||
**Author:** Claude (fresh-eyes adversary; did not author the code under attack — P7/P8/cert/seal are Gemini/Grok-session work).
|
||||
**Date:** 2026-07-15
|
||||
**Base under attack:** `forgejo/main @ 4853a55c` (post #38 merge + debug-print revert), worktree `feat/adr-0241-0242-mastery-close`.
|
||||
**Method:** line-level read **plus hostile execution** (grade decomposition, live func-call counters, `sys.modules` import-graph trace, `-X importtime` ancestry), not read-only inspection. All 3 dedicated suites independently re-run green (46 passed).
|
||||
|
||||
**Yardstick:** the 4 authority blueprints in `docs/research/*.gdoc`. ADR-0241 read in full; core_ha + fibonacci_applications read; **ADR-0242 "deterministic-fibonacci-operators-and-evidence-gated-optimization" memo not yet available as a local export** — its fidelity slice is partial (noted below).
|
||||
|
||||
---
|
||||
|
||||
## Verdict summary
|
||||
|
||||
| # | Attack target | Verdict | Severity |
|
||||
|---|---------------|---------|----------|
|
||||
| 1 | Chiral non-vacuity (P8) | ✅ **CONFIRMED SOLID** — genuinely non-vacuous, exactly conserved | — |
|
||||
| 3 | Fibonacci cert: budget exactness + digest stability (V1) | ✅ **CONFIRMED SOLID** | — |
|
||||
| 4 | P9 seal discipline (SPECULATIVE-only) | ✅ **SOLID** + one precision wrinkle | LOW |
|
||||
| 5 | Fidelity-ledger spot-check | 🟡 mostly honest, **one prose-only green row** | LOW |
|
||||
| 2 | Serve-quarantine transitivity (A-04) | 🔴 **LIVE BREACH — not a coverage gap** | **HIGH** |
|
||||
|
||||
---
|
||||
|
||||
## 🔴 Finding #2 (HIGH) — the serve quarantine is breached transitively
|
||||
|
||||
**Claimed invariant.** A-04 (`test_phase0_a04_serve_path_quarantines_wave_and_fibonacci`) + ledger §12 row *"Serve path not wired to wave / Fibonacci (containment) 🟢"* + module docstrings (`wave_manifold`: "Off-serving until explicit gates"; `wave_energy_boundary`/`multi_scale_energy`: **"never serve"**). The stated invariant is **process-level**: the serve path must not pull in the wave/fibonacci substrate.
|
||||
|
||||
**What is actually true.** Importing `chat.runtime` transitively loads **five** banned modules into `sys.modules`:
|
||||
`core.physics.wave_manifold`, `core.physics.holographic_vault`, `core.physics.fibonacci_search`, `core.physics.multi_scale_energy`, `core.physics.wave_energy_boundary`.
|
||||
|
||||
**Exact chain (`-X importtime` ancestry):**
|
||||
```
|
||||
chat.runtime → chat.pack_grounding → packs.anchor_lens.loader → formation.smelter
|
||||
→ teaching.correction → generate.intent → generate.proposition
|
||||
→ field.state → field.propagate → core.physics.energy → [core/physics/__init__.py barrel]
|
||||
→ goldtether → wave_manifold
|
||||
→ wave_energy_boundary → fibonacci_search
|
||||
→ multi_scale_energy
|
||||
→ holographic_vault
|
||||
```
|
||||
|
||||
**Root cause.** `core/physics/__init__.py` is a **barrel init that eagerly imports the entire physics surface**, including `wave_manifold` (line 72), `goldtether` (line 28, which itself hard-imports `WaveManifold` at `goldtether.py:35`), `holographic_vault`, `wave_energy_boundary`, `multi_scale_energy`. `field/propagate.py` needs only `from core.physics.energy import FieldEnergyOperator` — one lightweight submodule — but importing any `core.physics.*` submodule runs the barrel and drags in everything.
|
||||
|
||||
**Why the pin missed it.** The A-04 test walks only `chat/runtime.py`'s **own** AST import nodes → catches **direct** imports only. A 2+-hop chain through a package barrel is invisible to it. Demonstrated: direct `import wave_manifold` → flagged `True`; transitive chain → flagged `False`. No complementary `sys.modules` guard exists anywhere in the suite.
|
||||
|
||||
**Severity = HIGH.** This directly falsifies a 🟢 acceptance-checklist row Joshua would rely on to Accept, loads modules explicitly labeled "never serve" into the serve process (startup cost + memory + containment-doctrine violation), and — because the guarding pin stays green — a future edit to `energy.py`/`goldtether` could begin *invoking* wave functions on the hot path with nothing to catch it.
|
||||
|
||||
### Design-intent fork (Joshua's call — not mine to decide)
|
||||
`wave_manifold` sits on **both** sides: the subsumption map says `goldtether`/`surprise`/`biography` (Third-Door serve operators) **delegate to** `WaveManifold` (`goldtether.coherence_residual` → `WaveManifold().measure_unitary_residual`), yet `wave_manifold` is on the A-04 **ban** list. Both cannot be true. Two honest resolutions:
|
||||
|
||||
- **(A) Quarantine wave_manifold for real:** de-barrel the off-serving modules (PEP 562 lazy `__getattr__` in `core/physics/__init__.py`) **and** make `goldtether`'s `WaveManifold` import lazy (2 call sites). Restores the letter of A-04. Only coherent if serving never calls `coherence_residual` on the hot path.
|
||||
- **(B) Accept wave_manifold as serve substrate:** remove `wave_manifold` from the A-04 ban list, correct the ledger row, and keep only the genuinely-off-serving research modules quarantined (`multi_scale_energy`, `wave_energy_boundary`, `holographic_vault`, `fibonacci_search`, `wave_seam`, `sensorium_wave_feed`, `atlas_packing`).
|
||||
|
||||
**Unambiguous either way:** the modules labeled *"never serve"* must leave the barrel's eager path, and a **transitive `sys.modules` guard test** must replace/augment the direct-AST pin so this can never regress silently.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Finding #1 — Chiral non-vacuity (P8): CONFIRMED SOLID
|
||||
|
||||
Blueprint ADR-0241 §2.4C: `Q = ⟨ψ I₅ ψ̃⟩₀`, non-vacuous for odd-capable mixed-parity spinors, conserved under `ψ → Rψ`.
|
||||
|
||||
Executed with the algebra's **graded-lexicographic** convention (grade-1 = idx 1–5; my first probe's bit-count grade map was wrong and is discarded):
|
||||
- Fixture `psi = v + v·I₅`, `v = e1 + 0.5·e3` → grades **{1: 1.118 (odd), 4: 1.118 (even)}** — genuinely mixed parity, **not** a pure even field-state.
|
||||
- `Q(psi) = −2.5` (|Q| ≫ 0.1 threshold — comfortably non-zero, not borderline).
|
||||
- Conserved under `left_spinor_step`: drift `|q0 − q1| = 0.000e+00` (exact).
|
||||
- Even unit versor → `Q = 0.000e+00` (honest; does **not** revive the retired-#19 vacuous gate).
|
||||
|
||||
**Fidelity win:** the blueprint's own §4 prototype used `np.outer(psi_B, psi_A)` + `la.svd` (Euclidean matrix proxies). The implementation correctly rejected that in favor of exact `geometric_product`/`cga_inner`. The impl is *more faithful to the algebra than the blueprint's reference code.*
|
||||
|
||||
---
|
||||
|
||||
## ✅ Finding #3 — Fibonacci cert (V1): CONFIRMED SOLID
|
||||
|
||||
- **Budget exactness** via a live func-call counter across budgets **8/15/20/21**: actual `func` calls == `cert.evaluations` == `budget` == `len(ordered_points)` in every case. No off-by-one at bracket init. (Structurally: 2 initial evals + `(n−2)` single-eval loop iterations = `n`.)
|
||||
- **Digest stability:** dual independent runs → identical `cert_id` (64-hex) and identical `as_dict()`. Pure arithmetic (no RNG / set-ordering), so bit-stable by construction.
|
||||
- Typed `Certificate | Failure` surface; fail-closed on nonfinite / unimodality / bounds; never a bare float.
|
||||
|
||||
**Precision nit (LOW):** the certificate's `minimizer` returns `best_x` (a sampled point) when it lies inside the final bracket, else the midpoint — but the docstring says *"Drive cert uses midpoint of final bracket."* Code prefers the better sample; harmless, but doc and code disagree. One-line doc fix.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Finding #4 — P9 seal discipline: SOLID (one precision wrinkle, LOW)
|
||||
|
||||
- `HolographicVaultStore.seal_mode` sets `EpistemicStatus.SPECULATIVE` by construction (`holographic_vault.py:153`); COHERENT lives only in `seal_mode_reviewed(authorized=True)` (refuses without authorization). `speculative_seal_from_contemplation` calls **only** `seal_mode`, with a defensive re-check that raises on any non-SPECULATIVE return. Contemplation can never emit COHERENT. ✅
|
||||
- `reconstruct_as_evidence` excludes SPECULATIVE (min_status=COHERENT) and refuses on empty spectrum. ✅
|
||||
|
||||
**Precision wrinkle:** the stated invariant is *"physics never imports teaching,"* but `core/physics/holographic_vault.py:30` imports `teaching.epistemic.EpistemicStatus`. The **tested** invariant (`test_wave_manifold_module_does_not_import_teaching`) guards only `wave_manifold.py`, which is clean. Not a live breach — `EpistemicStatus` is boundary vocabulary — but the clean "physics ⊥ teaching" story has one sanctioned seam. Design note: consider relocating `EpistemicStatus` to a shared non-teaching kernel (e.g. `core/epistemic_state.py`) so the boundary is literal.
|
||||
|
||||
---
|
||||
|
||||
## 🟡 Finding #5 — Fidelity-ledger spot-check: mostly honest, one prose-only green
|
||||
|
||||
Mapped 4 §12 rows → named pins:
|
||||
1. *"Chiral non-vacuous … conserved … even ~0"* → `test_chiral_charge_{nonzero,conserved,honest}` — fails if Q=0 / not conserved. ✅ real behavioral pin.
|
||||
2. *"Fibonacci cert/failure (V1)"* → `test_fibonacci_search_eval_count_equals_budget` + `test_certificate_digest_stable_dual_run` — fails on off-by-one / digest drift. ✅ real.
|
||||
3. *"Serve path not wired (containment)"* → `test_phase0_a04…` — maps to a real pin, **but the prose "not wired" overstates a direct-import-only test** (see Finding #2). Downgrade the claim or strengthen the pin.
|
||||
4. *"Fibonacci anyons (V5) 🟢 quarantine package only; zero production imports"* → **no anyon package exists in the repo and no test references "anyon."** A 🟢 row with no code and no pin — the "namesake-green" trap §7 warns about. "Zero production imports" is vacuously true of a nonexistent module. **Downgrade to "not built / claim-quarantined"** (consistent with the R&D-memo anyon "immune to float32 drift" claim being deliberately not implemented).
|
||||
|
||||
Other V-vectors (V2 `multi_scale_energy`, V4 `fibonacci_word_schedule`, sensorium, `wave_energy_boundary`, `atlas_packing`) each carry 2–4 real test files.
|
||||
|
||||
---
|
||||
|
||||
## Blueprint fidelity (ADR-0241) — deviations for the acceptance packet
|
||||
|
||||
| Blueprint clause | Implementation | Fidelity |
|
||||
|---|---|---|
|
||||
| §2.4A analogical = **closed-form Clifford polar** `C=RS`, extract R directly | **Demoted** to numerical sandwich conjugacy (SVD + Spin GN); `test_true_clifford_polar_fails_on_multigrade_field` proves `~C C` is non-scalar for multigrade fields → analytic polar **ill-posed** | **Honest deviation** — recommend accept-as-honest per the #19 RETIRE precedent. **P7 headline for Joshua.** |
|
||||
| §2.4C chiral grade-5 charge | Faithful + non-vacuous (Finding #1) | ✅ |
|
||||
| §2.4D GoldTether = unitary amplitude residual | `measure_unitary_residual` dual-checks `‖ψψ̃−1‖` | ✅ |
|
||||
| §2.2 holographic recall = **exact reconstruction, zero thaw loss** | `resonant_recall`/`resonant_reconstruct` + durable `HolographicVaultStore`, but **float32 storage** (I-02 honest tol 1e-6, not bit-exact 1e-12) | Softened to "float32-honest" — already flagged in-suite; note for ruling |
|
||||
| §2.3 continuous multimodal / sensorium | **Staged/fake sensorium packets** + real ρ (`sensorium_wave_feed`) | Open by design (W5) |
|
||||
| §5.2 MLX/UMA + Rust exact GP | `algebra.backend` P11a (Rust-ready; Python is truth); f64 GP parity deferred (D9) | Staged |
|
||||
|
||||
**ADR-0242 memo slice — partial:** the "deterministic-fibonacci-operators-and-evidence-gated-optimization" R&D memo is not yet available as a local export, so the memo-vs-impl fidelity check is incomplete. What is verifiable: the implementation's Fibonacci cert is solid (Finding #3), and the memo's flagged-dubious claims appear correctly filtered — the **anyon** claim is not built (Finding #5), and the "Fibonacci division-cost" R&D claim did not land as a production optimization. Full slice pending the memo export.
|
||||
|
||||
---
|
||||
|
||||
## Recommended actions
|
||||
|
||||
1. **Finding #2 (HIGH)** — resolve before Accept. Unambiguous part: de-barrel the "never serve" modules from `core/physics/__init__.py` (lazy `__getattr__`) + add a transitive `sys.modules` guard test. Design fork (A vs B on `wave_manifold`) → Joshua.
|
||||
2. **Finding #4 / #5 / #3 nits (LOW)** — batch: relocate `EpistemicStatus` (or document the sanctioned seam); downgrade the anyon ledger row; fix the Fibonacci `minimizer` docstring.
|
||||
3. Everything else verified solid — no other fix-forward required.
|
||||
91
docs/research/adr-0241-0242-blueprint-integration-plan.md
Normal file
91
docs/research/adr-0241-0242-blueprint-integration-plan.md
Normal file
|
|
@ -0,0 +1,91 @@
|
|||
# ADR-0241/0242 + core_ha + Fibonacci — Blueprint↔Codebase Integration Plan
|
||||
|
||||
**Purpose:** audit **all four authority blueprints** against the current codebase and plan how each mechanism is masterfully worked into the implemented design — retiring or re-shaping old work that doesn't fit the R&D vision **without ever losing the capability it provided**.
|
||||
**Author:** Claude (fresh-eyes). **Date:** 2026-07-15. **Base:** `feat/adr-0241-0242-mastery-close` off `forgejo/main @ 4853a55c`.
|
||||
**Companion:** `adr-0241-0242-adversarial-and-fidelity-findings.md` (the W1 hostile-verification results this plan builds on).
|
||||
|
||||
**Authority docs & availability:**
|
||||
| Doc | Read | Status |
|
||||
|---|---|---|
|
||||
| ADR-0241 wave-field hyperbolic atlas + resonant cognition | ✅ full | audited deep |
|
||||
| core_ha unification & deprecation plan | ✅ full | audited |
|
||||
| fibonacci_applications_in_core_substrate | ✅ full | audited |
|
||||
| ADR-0242 deterministic-fibonacci-operators + evidence-gated-optimization | ❌ **no local export** | **BLOCKED — needs export**; cert impl verified against its own contract |
|
||||
|
||||
---
|
||||
|
||||
## 1. The governing reconciliation
|
||||
|
||||
The recurring pattern across all four docs: the blueprints were written when the **wave-field was speculative**, so they hedged it as "off-serving / separate database / optional." The implementation then made the wave substrate **load-bearing** (Third-Door serve operators delegate to it). Where an old boundary or claim no longer fits, we **retire it and re-develop the capability in the shape the R&D actually validated** — matching your "field = electricity" principle: the field is the substrate everything runs on.
|
||||
|
||||
**Already landed this session (first instance):** the serve-quarantine reconciliation — one substrate, two tiers (T1 sanctioned serve = `wave_manifold`; T2 evidence-gated off-serving = holographic vault, Fibonacci/energy research). De-barreled `core/physics/__init__.py`, added the transitive `sys.modules` guard, corrected A-04 + ledger. 179 affected tests green.
|
||||
|
||||
---
|
||||
|
||||
## 2. Per-mechanism disposition (every clause, 5 buckets)
|
||||
|
||||
### ✅ FAITHFUL — built and verified
|
||||
| Blueprint clause | Landed | Evidence |
|
||||
|---|---|---|
|
||||
| ADR-0241 §2 ψ transport (sandwich + left-spinor) | `wave_manifold.sandwich_step`/`left_spinor_step` | unitary residual <1e-6, determinism pinned |
|
||||
| §2.4B surprise = non-resonant spectral leakage | `compute_spectral_leakage` (metric-exact) | delegates from `surprise_residual` |
|
||||
| §2.4C chiral grade-5 charge (readout) | `chiral_charge` | **Q=−2.5 non-vacuous, conserved exactly** (executed) |
|
||||
| §2.4D GoldTether unitary residual | `measure_unitary_residual` | dual-checked ‖ψψ̃−1‖ |
|
||||
| §2.2 holographic recall / standing-wave spectrum | `resonant_recall`/`resonant_reconstruct` + `HolographicVaultStore` | I-01/I-02 suite |
|
||||
| core_ha runtime_memory → Field Energy E0–E1 deep / E2–E3 active | `energy.py EnergyClass` | E0/E1 `is_deep` ✓ |
|
||||
| core_ha steward → GoldTether drift gating | `goldtether.py` | ✓ |
|
||||
| core_ha §5.1 unitary <1e-6 fail-closed | `versor_condition`/`measure_unitary_residual` gates | behavior present |
|
||||
| core_ha §5.3 Hamiltonian energy boundary `E_exertion ≤ κ·E_sensory` | `trajectory_invariants.energy_boundary_ok` | **exact, +refuses negative energy** |
|
||||
| Fibonacci §2.1 golden-spiral phyllotaxis packing | `atlas_packing.golden_angle_pack` (`golden_angle_v1`, 137.5°) | V1/V3 |
|
||||
| Fibonacci §2.3 evidence-gated section search | `fibonacci_section_search` → `FibonacciSearchCertificate` | **budget-exact + digest-stable** (executed) |
|
||||
| Fibonacci §4 multi-scale `τ_n=F_n·τ_0` | `multi_scale_energy`, `wave_energy_boundary.fibonacci_tau_schedule` | V2 pins |
|
||||
|
||||
### 🟢 HONEST DEVIATION — the impl is *more correct than the blueprint*; keep, document for Joshua
|
||||
| Blueprint said | Impl did | Why it's forward, not backward |
|
||||
|---|---|---|
|
||||
| §2.4A analogical = closed-form Clifford polar `C=RS` | numerical sandwich conjugacy (SVD+Spin-GN) | `test_true_clifford_polar_fails_on_multigrade_field` **proves** `~C C` non-scalar → analytic polar ill-posed for multigrade fields (P7; #19-RETIRE precedent). **Headline for ruling.** |
|
||||
| §4 prototype `np.outer` + `la.svd` | exact `geometric_product`/`cga_inner` | rejects the blueprint's own Euclidean-matrix proxy |
|
||||
| Fibonacci §2.3 "avoids division, addition-only" | uses `f_{n-1}/f_{n+1}` float division | the "no-division" micro-claim only holds on an integer lattice; real-bracket subdivision needs division. Dubious perf claim correctly filtered. |
|
||||
| core_ha §5.1 `ClosureViolationException` (named) | `ValueError`/`WaveSpectralLeakageError` + versor gate | equivalent fail-closed behavior, different type name |
|
||||
| §2.2 "exact recall / zero thaw loss" | float32-honest (I-02 tol 1e-6, not 1e-12) | honest about storage precision instead of over-claiming bit-exactness |
|
||||
|
||||
### 🔨 MISSING PIECE — capability the vision specifies but the code does **not** yet enforce; **build anew** so we don't go backwards
|
||||
| Missing invariant | Current state | Build |
|
||||
|---|---|---|
|
||||
| **Chiral SIGN-preservation gate** (ADR-0241 §2.4C + core_ha §5.2: `sgn(∫⟨ψIψ̃⟩₀)=const`, mirror-inversion protection) | `chiral_charge` is a verified non-vacuous **readout**, but its only consumer (`goldtether.py:230`) takes `abs(...)` — **discarding the sign** — and it's ~0 on serve-path even-versors. No fail-closed `sgn(Q)=const` gate exists. | A `chiral_orientation_gate` that latches the initial sign and fails closed on flip during transport; wire the *signed* charge (not `abs`) where a non-vacuous spinor path exists. Preserves the "topologically secure alignment" the blueprint promises. |
|
||||
| **CRDT delta-sync semilattice** (core_ha §2/§3 tombstone → "commutative/associative/idempotent Delta-CRDT in `core/sync/`") | `core/sync/` is a journal/object-store (no `merge`/idempotent/semilattice semantics found). Determinism today = bit-exact `array_codec` + single-writer `VaultStore` (Shape B+), **not** multi-writer CRDT merge. | Decide: either build the CRDT (needed for genuine multi-agent/multi-writer "one continuous life") **or** correct the doc to state determinism is single-writer bit-exact. Don't leave the claim floating. |
|
||||
|
||||
### ⛔ SCRAP / DO-NOT-BUILD — correctly rejected over-claims
|
||||
| Blueprint clause | Disposition |
|
||||
|---|---|
|
||||
| Fibonacci §2.2 **anyons** "immune to float32 drift" | Most speculative claim in the corpus; **not built** (no package, no test). Correct call — "float32-immune topological logic" is an over-promise. **Action:** downgrade the ledger's `V5 anyons 🟢` row to "not built / claim-quarantined" (namesake-green, Finding #5). Revisit only if non-abelian braiding is explicitly greenlit. |
|
||||
|
||||
### 🕗 STAGED / GATED — deferred by design, not regression
|
||||
- Rust wave kernels (bivector exp-map, `C_AB`, `versor_unit_residual`) in `core-rs/{lib,versor,diffusion,vault}.rs` — files exist; f64 GP parity **deferred (D9)**; Python is truth via `algebra.backend` (P11a).
|
||||
- Sensorium §2.3 continuous multimodal — staged/fake packets + real ρ (`sensorium_wave_feed`); real compilers open.
|
||||
- Continuous field integrals — mode samples today.
|
||||
- T2 serve promotion — evidence-gated (ADR-0242 cert discipline).
|
||||
|
||||
---
|
||||
|
||||
## 3. Invariant preservation (your named guardrails)
|
||||
|
||||
| Requirement | Held? | How the reconciliation protects it |
|
||||
|---|---|---|
|
||||
| **Determinism** | ✅ | T1 wave ops closed-by-construction, no RNG; Fibonacci cert bit-stable; T2 gating = "evidence-gated optimization" (never promote without replayable cert). The one open item (CRDT vs bit-exact) is a *determinism-mechanism* clarification, not a hole. |
|
||||
| **Safety + alignment** | ✅/🔨 | GoldTether stays the alignment gate on the real substrate (strengthened). **The missing chiral sign-gate is an alignment capability to restore** — mirror-orientation is part of "topologically secure alignment." Safety/ethics/refusal packs untouched. |
|
||||
| **core_logos** | ✅ | Articulation layer above physics; unaffected by substrate boundary moves. |
|
||||
| **Substrate goals: memory / logic-topology / thermodynamics** | ✅ | Memory = holographic vault (T2, persistence-gated). Logic-topology = Cl(4,1) ψ field promoted to live substrate (T1). Thermodynamics = `energy.py` + `energy_boundary_ok` (faithful) + gated multi-scale research (T2). |
|
||||
|
||||
---
|
||||
|
||||
## 4. Sequenced build plan (no capability regression)
|
||||
|
||||
1. **DONE** — Finding #2 serve-boundary reconciliation (de-barrel + transitive guard + A-04/ledger correction). Green.
|
||||
2. **Next fix-forward (LOW, batch):** downgrade anyon ledger row; `EpistemicStatus` boundary note (or relocate to shared kernel); Fibonacci `minimizer` docstring; `ClosureViolationException` naming note.
|
||||
3. **Build-anew (capability):** chiral **sign-preservation gate** (§5.2) — the one true missing safeguard; TDD a `sgn(Q)=const` fail-closed gate + signed wiring.
|
||||
4. **Decision + build/doc:** CRDT-vs-bit-exact determinism story for `core/sync` (affects multi-agent "one continuous life").
|
||||
5. **Get ADR-0242 memo export** → close its fidelity slice (evidence-gated-optimization vs the cert impl; confirm no further deviations).
|
||||
6. Staged/gated items (Rust parity D9, sensorium compilers, continuous integrals) remain post-Accept backlog.
|
||||
|
||||
**Acceptance framing:** ADR-0241/0242 are Accept-ready on the FAITHFUL + HONEST-DEVIATION set once #2 lands green (in progress). The MISSING-PIECE items (chiral sign-gate, CRDT clarification) are **new capability work**, not blockers — but they must be tracked so the vision's safeguards aren't quietly dropped.
|
||||
|
|
@ -46,6 +46,39 @@ def test_core_test_lists_curated_suites(capsys) -> None:
|
|||
assert "full" in captured.out.splitlines()
|
||||
|
||||
|
||||
def test_cli_smoke_suite_covers_ci_smoke_gate() -> None:
|
||||
"""Local-first parity pin: the CLI ``smoke`` suite must cover every test
|
||||
path the CI smoke gate (.github/workflows/smoke.yml) runs.
|
||||
|
||||
AGENTS.md makes ``core test --suite smoke`` the mandatory pre-push gate;
|
||||
if the CI yaml gains a path the CLI tuple lacks, the local gate silently
|
||||
narrows and regressions clear it — this pin makes that divergence loud.
|
||||
"""
|
||||
from core.cli_test import TEST_SUITES
|
||||
|
||||
root = Path(__file__).resolve().parents[1]
|
||||
workflow = (root / ".github/workflows/smoke.yml").read_text(encoding="utf-8")
|
||||
|
||||
ci_paths: set[str] = set()
|
||||
for token in workflow.split():
|
||||
token = token.strip("\\\"'")
|
||||
if not token.startswith("tests/"):
|
||||
continue
|
||||
if "*" in token:
|
||||
matches = sorted(root.glob(token))
|
||||
assert matches, f"CI smoke glob {token!r} matches no files"
|
||||
ci_paths.update(str(m.relative_to(root)) for m in matches)
|
||||
else:
|
||||
ci_paths.add(token)
|
||||
|
||||
assert ci_paths, "no tests/ paths parsed from smoke.yml — pin needs updating"
|
||||
missing = ci_paths - set(TEST_SUITES["smoke"])
|
||||
assert not missing, (
|
||||
"CLI smoke suite is narrower than the CI smoke gate; add to "
|
||||
f"core/cli_test.py TEST_SUITES['smoke']: {sorted(missing)}"
|
||||
)
|
||||
|
||||
|
||||
def test_core_test_suite_expands_to_expected_pytest_paths(monkeypatch) -> None:
|
||||
calls: list[tuple[str, ...]] = []
|
||||
|
||||
|
|
|
|||
60
tests/test_serve_quarantine_transitive.py
Normal file
60
tests/test_serve_quarantine_transitive.py
Normal file
|
|
@ -0,0 +1,60 @@
|
|||
"""A-04 (transitive) — the serve process must not LOAD the wave/fibonacci substrate.
|
||||
|
||||
The existing `test_phase0_a04_serve_path_quarantines_wave_and_fibonacci` walks only
|
||||
`chat/runtime.py`'s own AST import nodes, so it catches DIRECT imports only. The
|
||||
stated invariant is process-level ("serve path stays quarantined"; modules labelled
|
||||
"never serve"). This pin enforces the stated invariant: importing `chat.runtime` in
|
||||
a clean interpreter must not pull any banned module into `sys.modules`.
|
||||
|
||||
RED until the `core/physics/__init__.py` barrel stops eagerly importing the
|
||||
off-serving substrate (Finding #2, docs/research/adr-0241-0242-adversarial-and-fidelity-findings.md).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import subprocess
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
_ROOT = Path(__file__).resolve().parents[1]
|
||||
|
||||
# Genuinely off-serving; must never load into the serve process.
|
||||
_BANNED = (
|
||||
"core.physics.holographic_vault",
|
||||
"core.physics.fibonacci_search",
|
||||
"core.physics.fibonacci_word_schedule",
|
||||
"core.physics.atlas_packing",
|
||||
"core.physics.wave_seam",
|
||||
"core.physics.wave_energy_boundary",
|
||||
"core.physics.multi_scale_energy",
|
||||
"core.physics.sensorium_wave_feed",
|
||||
# NOTE: core.physics.wave_manifold is intentionally excluded pending the
|
||||
# Joshua design ruling (goldtether delegates to it). Add it here if the
|
||||
# ruling is "quarantine wave_manifold for real".
|
||||
)
|
||||
|
||||
|
||||
def test_import_chat_runtime_does_not_load_offserving_substrate():
|
||||
probe = (
|
||||
"import importlib, sys, json;"
|
||||
"importlib.import_module('chat.runtime');"
|
||||
f"banned={list(_BANNED)!r};"
|
||||
"leaked=sorted(m for m in sys.modules for b in banned if m==b or m.startswith(b+'.'));"
|
||||
"print(json.dumps(leaked))"
|
||||
)
|
||||
result = subprocess.run(
|
||||
[sys.executable, "-c", probe],
|
||||
cwd=str(_ROOT),
|
||||
capture_output=True,
|
||||
text=True,
|
||||
env={"PYTHONPATH": str(_ROOT), "PATH": ""},
|
||||
)
|
||||
assert result.returncode == 0, f"probe failed: {result.stderr[-2000:]}"
|
||||
leaked = result.stdout.strip().splitlines()[-1]
|
||||
import json as _json
|
||||
|
||||
leaked_list = _json.loads(leaked)
|
||||
assert not leaked_list, (
|
||||
"serve process transitively loaded off-serving modules "
|
||||
f"(A-04 breach via core/physics barrel): {leaked_list}"
|
||||
)
|
||||
|
|
@ -56,8 +56,12 @@ def test_phase0_a04_serve_path_quarantines_wave_and_fibonacci():
|
|||
runtime_path = _ROOT / "chat/runtime.py"
|
||||
src = runtime_path.read_text()
|
||||
tree = ast.parse(src)
|
||||
# Tier-2 OFF-SERVING modules only. wave_manifold is Tier-1 sanctioned serve
|
||||
# substrate (goldtether/surprise/biography delegate to it) per the 2026-07-15
|
||||
# reconciliation — see docs/research/adr-0241-0242-adversarial-and-fidelity-findings.md.
|
||||
# Process-level (transitive) quarantine of these is enforced by
|
||||
# tests/test_serve_quarantine_transitive.py; this pin catches direct imports.
|
||||
banned_roots = {
|
||||
"wave_manifold",
|
||||
"holographic_vault",
|
||||
"fibonacci_search",
|
||||
"fibonacci_word_schedule",
|
||||
|
|
@ -68,7 +72,6 @@ def test_phase0_a04_serve_path_quarantines_wave_and_fibonacci():
|
|||
"sensorium_wave_feed", # D7 I-04 sensorium→ψ feed, never serve
|
||||
}
|
||||
banned_substrings = (
|
||||
"wave_manifold",
|
||||
"holographic_vault",
|
||||
"fibonacci_search",
|
||||
"fibonacci_word_schedule",
|
||||
|
|
|
|||
Loading…
Reference in a new issue