5f18b7e58f
G-9's charge: "law-enforced-by-review is weaker than law-enforced-by-test." Its stated method — verification pass first, then mechanical PRs — is what made this worth doing, because the three prohibitions turned out to be in three different states and only one of them was the state the register assumed. (a) EXACT RECALL — the real gap, and worse than recorded. "Would a cosine ranker actually fail a test?" answers NO across nearly the whole surface. The only import ban in the repository covers exactly one file (core/physics/wave_manifold.py, via test_third_door_cohesion.py — itself in no curated suite). Meanwhile generate/realize/recall.py, which IS the recall path, states the prohibition in its module docstring — "an exact, deterministic equality scan (no cosine / HNSW / ANN)" — and nothing enforced it. Law asserted where it executes, enforced nowhere: H-8's failure mode applied to a prohibition rather than a record. Now scanned across vault/, generate/realize/, generate/meaning_graph/, field/, recognition/ for banned ANN libraries AND for hand-rolled cosine* definitions. The second half matters: an import ban only stops the convenient version, and ten lines of numpy is the realistic way a well-meaning contributor violates this. A third pin ties the docstring claim to the scan, so the sentence and its enforcement cannot drift apart. (b) GOVERNANCE BYPASS — now exact. INV-07 proves governance works WHEN CALLED; nothing proved it could not be skipped. Mechanism: no function in chat/runtime.py may construct a TurnVerdicts without invoking safety_check.check, and every such call must pass self.safety_pack — because a bypass need not skip the call, it can substitute the pack. Measured at close: two verdict-constructing functions, both governed. (c) SAFETY-PACK NON-SWAPPABILITY — already well pinned; the gap was REACH, not coverage. tests/test_safety_pack.py pins unratified-pack-refused-in-production, missing-companion-report-refused, seal-failure-refused, path-traversal-rejected, missing-pack-fails-closed — and ran in NO curated suite, so a fail-closed safety contract was verified only after merge. Promoted onto the gate; the new pin guards that placement rather than duplicating the substance. FOUR SABOTAGES, EACH OBSERVED RED, each caught by its own pin: a banned library imported on a recall path, a hand-rolled cosine ranker, a serving path assembling verdicts without governing, the safety pack demoted off the gate. Both new files registered in TEST_SUITES["smoke"] on creation (#136). Source scans only — no runtime behavior, no flag, no serving path touched. Registers: G-9 CLOSED with the per-item findings; PR-6 marked LANDED. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wcw2pnMBwyvmNyQg4uPEt4 |
||
|---|---|---|
| .. | ||
| adr | ||
| agents/grok | ||
| analysis | ||
| architecture | ||
| assessment | ||
| audit | ||
| benchmarks | ||
| briefs | ||
| curriculum | ||
| decisions | ||
| evals | ||
| examples | ||
| handoff | ||
| handoffs | ||
| implementation | ||
| issues | ||
| lab | ||
| outreach | ||
| paradigm-archive | ||
| plans | ||
| research | ||
| sessions | ||
| specs | ||
| workbench | ||
| zig | ||
| 3lang-depth-pr-plan.md | ||
| admissibility-exemplars.md | ||
| ci-optimization.md | ||
| conceptualizing_engineering_mastery.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).