History

Shay df6332fcb5 refactor(generate): one owner per linguistic fact (Phase 2A) Collapses the duplicated closed English tables into generate/lexicon.py. Measured on main @ `0948f7cd`: the same facts were encoded up to five times across the reading and writing paths, each copy written independently as a successive deduction band landed. The 2A/2B split is decided empirically per #129 — make the change, run the 11 pinned lanes, let byte-identity rule. Result: 11/11 byte-identical, so this entire unit is 2A and nothing spilled into the authorization-gated 2B. Collapsed to one object: - connectives 3 identical copies (member, verb, cond_member) - predicate display 2 identical 26-entry copies (semantic_templates, templates) - be-form inventory 5 copies, not the 2 §1.3 counted. The structural test found realizer_guard._BE_AUX and chat/runtime._BE_FORMS, which a COPULA-shaped grep could never see. Derived rather than duplicated, so they can no longer drift: - STRUCTURAL = CONNECTIVES \| {therefore} - QUANTIFIER_TOKENS = QUANTIFIER_LEAD \| QUANTIFIER_NON_LEAD - NEGATION_BEARING_WITH_NOT = NEGATION_BEARING \| {not} - READER_IRREGULAR_SINGULARS = IRREGULAR_SINGULARS restricted to 8 keys §1.3 re-measured while doing this, and it overstated the disease (plan §1.9). Almost nothing contradicts: - the "3 divergent plural tables" are 1 pluralizer + 2 singularizers, i.e. inverse directions; comparing them as copies is a category error - reader's 8 singulars are a STRICT SUBSET of member's 29 with the difference in reader's favour empty, so its values are all correct and only its coverage is short - the "3 divergent quantifier sets" are 3 distinct facts; every/each lead a clause but take singular nouns, so their absence from PLURAL_QUANTIFIERS is correct - english's negation set is a subset of member's, and the difference is principled: v2-EN normalizes "<copula> not", v3-MEM refuses it Exactly one genuine contradiction exists in the whole inventory: discourse_planner maps is_defined_as -> "is" where the others map it to "is defined as". Preserved as a register choice, pinned by test. Found while reading, pinned as current behaviour for 2B to flip: reader._singularize does NOT refuse uncovered plurals despite a comment claiming it does — it falls through to a bare -s strip, so news -> new and species -> specy, exactly the corruptions member.py's table comment says its table exists to prevent. Two 2A exit criteria were unmeasurable as written and are replaced: - "Jaccard -> 1.00" cannot work. measure_grammar_seam.py scans source literals, so unifying a fact removes it from those files and Jaccard FELL, 0.083 -> 0.023 — the success direction reported by a metric shaped to read like failure. Replaced with an object-identity count: 3 distinct objects behind 8 names, from 8-behind-8. Value comparison cannot tell a shared object from two equal copies. - "one table per fact" presumed §1.3's inventory was right. The report now separates must-be-one-object (all UNIFIED) from related-but-distinct (6 relations, all HOLD). ADR-0258 §5 already decided morphology's destination is a ratified pack, triggered by a grc/he member band. No such band exists, so the promotion is correctly deferred and lexicon.py is a staging area, not a rival home — no new ADR. Destination measured for whoever picks it up: packs/en/morphology .jsonl has 9 records and zero irregular plurals, features.number has no consumer, and _pack_morph_roots_for reads a top-level "root" key that 0 of 31 records across all four packs define, so it returns {} every call. [Verification]: in-worktree on CPython 3.12.13, uv sync --locked — smoke 621 unchanged; deductive 383 (364 + 19 new); scripts/verify_lane_shas.py 11/11 byte-identical.		2026-07-26 17:45:27 -07:00
..
adr	docs(adr): ratify ADR-0264 — Accepted, and §4.1 self-superseded by its own R5	2026-07-26 14:39:56 -07:00
agents/grok
analysis
architecture
audit
benchmarks
briefs
curriculum
decisions
evals
examples
handoff	docs(arc): reconcile the arc's records with what the units measured	2026-07-26 12:33:30 -07:00
handoffs
implementation
issues
lab
outreach
paradigm-archive
plans	refactor(generate): one owner per linguistic fact (Phase 2A)	2026-07-26 17:45:27 -07:00
research	Merge pull request 'Rust parity: cargo green, lane parity unfalsifiable — plus `core rust build` was broken (plan §6A)' (#124 ) from fix/rust-build-env-and-parity-report into main	2026-07-26 20:20:16 +00:00
sessions
specs	fix(runtime): defer the turn-event sink emission to the serve boundary (R7)	2026-07-26 10:56:03 -07:00
workbench
zig
3lang-depth-pr-plan.md
admissibility-exemplars.md
ci-optimization.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	chore: Refactor CLI and Governance Anchors (#926 )	2026-07-03 12:34:56 -07:00
test-debt-quarantine.md
testing-lanes.md
Whitepaper.md
Yellowpaper.md

README.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>.md convention).
research/ - Raw research notes and preliminary findings.
lab/ - Experimental content (Warning: Not ratified; must not be referenced as authoritative in production PRs).

External

outreach/ - External communications and messaging.
zig/ - Scoped documentation for the Zig language components.