efa84002cd
Finding #20 (Super-Blueprint §3.2). surprise_residual was Euclidean Gram-Schmidt on flat 32-coefficient vectors — metric-blind (it ignored the (+,+,+,+,-) signature and the blade grade structure), so "inside the admissible span" was judged by the wrong geometry. Operator math (core/physics/surprise.py): - Exact metric-orthogonal projection: solve the normal equations G c = r (G_ij = cga_inner(b_i,b_j), r_i = cga_inner(b_i,x)) via lstsq, under cga_inner (32-vec) / eta (5-vec). - Fail-closed (typed SurpriseResidualError) on a metric-degenerate span, keyed on rank(G) < rank(B) — a null direction with no reciprocal (lone n_o). Refines the literal "rank(G) < k": mere linear dependence among non-null columns is admitted (lstsq projects onto the span), so a redundant live basis [1, source] and the non-degenerate pair {n_o, n_inf} are admitted; only a lone n_o is refused. The disclosure names the Gram null-space direction (not just zero-diagonal columns). - Reconciled productivity polarity: productive_transfer = low Procrustes AND low surprise (was `sur_norm >= 0.0`, always true). High surprise routes to discovery (split follow-up). Corrects the ledger's transfer/discovery conflation. Adversarial verification (3 independent lenses) found, and this fixes: - HIGH soundness hole: sur_norm was the reversion pseudo-norm, which VANISHES on a nonzero metric-null residual (the n_o/n_inf light cone) -> false-zero surprise -> an out-of-span light-cone probe was wrongly admitted as in-span. Now the DEFINITE (Euclidean) norm of the residual: the projection stays metric-exact, the magnitude is 0 iff nothing is unexplained. - HIGH regression: the analogical-transfer harness called surprise_residual OUTSIDE its try/except, so a degenerate source crashed the whole run. Now guarded: records a refused case and continues. - grade-support `allowed` -> exact-nonzero (removes a spurious-leak edge under coefficient amplification of sub-tolerance grade dust). DiscoveryCandidate wiring into the contemplation loop is split to its own follow-up (a distinct cross-cutting surface). Off-serving (nothing in serving/runtime imports core.physics.*). Tests: 15 behavioral tests (metric-vs-Euclidean divergence, null-cone regression, null refusal + combination-degenerate disclosure, 5-vector branch, polarity); 139-test physics sweep green; ruff clean. |
||
|---|---|---|
| .. | ||
| adr | ||
| agents/grok | ||
| analysis | ||
| architecture | ||
| audit | ||
| benchmarks | ||
| briefs | ||
| curriculum | ||
| decisions | ||
| evals | ||
| examples | ||
| handoffs | ||
| implementation | ||
| issues | ||
| lab | ||
| outreach | ||
| plans | ||
| research | ||
| sessions | ||
| specs | ||
| workbench | ||
| zig | ||
| 3lang-depth-pr-plan.md | ||
| admissibility-exemplars.md | ||
| core-rd-base-prompts.md | ||
| ethics_packs.md | ||
| EVAL_AUDIT_2026-05-20.md | ||
| eval_methodology.md | ||
| frontier_baselines.md | ||
| gaps.md | ||
| handoff_template.md | ||
| hitl-backpressure.md | ||
| holdout_recipients.txt | ||
| identity_packs.md | ||
| master-plan-post-substrate-audit.md | ||
| memo.html | ||
| model_dependency_size_tally.md | ||
| pack_inventory_2026-05-21.md | ||
| position_paper.md | ||
| PROGRESS.md | ||
| README.md | ||
| recognizer-registry.md | ||
| refusal-taxonomy.md | ||
| reviewers.yaml | ||
| RUST.md | ||
| safety_packs.md | ||
| sponsors.md | ||
| teaching_order.md | ||
| test-debt-quarantine.md | ||
| testing-lanes.md | ||
| Whitepaper.md | ||
| Yellowpaper.md | ||
CORE Documentation Index
This is the central index for all documentation in the CORE project.
Canonical Root Documents
- Whitepaper.md - The CORE architectural and philosophical whitepaper.
- Yellowpaper.md - Technical specifications and mathematical formulation of the CORE engine.
- PROGRESS.md - High-level project progress tracking.
- specs/runtime_contracts.md - Critical invariants and bounds for the runtime execution flow.
Directories
Architecture & Design
- adr/ - Architecture Decision Records (ADRs). The canonical history of all ratified engineering choices.
- architecture/ - High-level architectural documents (e.g., pipelines, schemas).
- analysis/ - Deep dives and master plans for structural changes.
- specs/ - Detailed technical specifications and invariants.
Planning & Progress
- plans/ - Capability roadmaps and implementation plans.
- briefs/ - Project briefs and scoping documents for upcoming work.
- issues/ - Detailed issue analyses and technical reproductions (not standard trackers).
- audit/ - Audit reports and claims ledgers.
Operations & Usage
- examples/ - Usage examples and reference integrations.
- workbench/ - Documentation for the CORE workbench UI and related tooling.
- agents/ - Agent-specific operational guides.
Note regarding
agents/grok/: Operational guide for using Grok 4.3 + Grok Build with CORE. This is not architecture documentation.
Learning & Evaluation
- curriculum/ - Documentation on the teaching/learning order and knowledge progression.
- evals/ - Evaluation methodology and performance criteria documentation.
- benchmarks/ - Benchmark evidence and performance tracking logs.
Historical & Experimental
- sessions/ - Chronological session logs documenting the "decision trail" and intellectual history of major choices.
- handoffs/ - Legacy brief, audit, and investigation notes (historical; the formal HANDOFF mechanism is retired — see AGENTS.md for the current lightweight
session-break-summary-<DATETIME>.mdconvention). - research/ - Raw research notes and preliminary findings.
- lab/ - Experimental content (Warning: Not ratified; must not be referenced as authoritative in production PRs).