core/docs
Shay 94f05ba84f feat(evals,tests,docs): FA-1 — the semantic ground collapses; "alignment" is implemented as overwrite
`packs.compiler._blend_feature_versors` ignores its strength argument and
returns the target verbatim. All three "nudge" sites — cross-language alignment
(0.10), morphology clustering (0.40), mount-time domain resonance (0.40) — are
therefore total overwrites, and ADR-0015's two explicit requirements ("a
weighted graph, not a translation table"; "without flattening their
distinctions") are violated bit-exactly.

Measured: mounting the depth packs onto English REMOVES 37 distinct coordinates
(239 surfaces -> 202 points). English alone is collision-free (220/220), Greek
alone is collision-free (11/11), so the loss is created by the mount. Nine
English question words -- ask, question, what, who, where, how, why, when,
which -- share one coordinate, dragged there by a single Greek verb in their
primary domain. `word`, `דבר`, `דברים` and `λόγος` are one point. English is the
mount-time prototype, so the design's depth-anchor roles run backwards: the
depth languages are deleted into the articulation surface.

Four more findings in the same layer:

  * 63 of 83 authored alignment edges resolve to nothing -- including every edge
    of the two packs serving actually grounds HE/GRC against -- because
    `_infer_foreign_pack_ids` maps id prefixes through a table hardcoded to the
    original three packs, and a miss is a silent `continue`. The corpus was
    grown 7.5x; the growth was never connected.
  * `algebra.holonomy.holonomy_encode` never closes. The reverse walk was
    deleted at fca6216e and the docstring describing it left in place; `alpha`
    is validated and never read (alpha=0.0 and alpha=1.0 return bit-identical
    arrays) while core/physics/biography.py:94 passes it.
  * Four token-level "resonance proofs" are green because the compared arrays
    are the same array -- the open follow-up the 2026-06-14 clause-level finding
    explicitly deferred, now closed as decoration.
  * The cure was already one layer down and never called: algebra/rotor.py has
    shipped `rotor_power` + `word_transition_rotor` (the group geodesic) since
    the algebra layer's first commit. A naive lerp leaves the versor group and
    VocabManifold.update() correctly refuses it -- the overwrite is what a lerp
    degrades into once the guard bites. The guard was right; the escape was not.

This is the missing half of every "geometry adds nothing" verdict: no operator
can distinguish what its ground does not distinguish.

Lands as instrument, not repair -- ../core is the quarry, and L2 is rebuilt in
the keel with these measurements as its provenance. The four decoration tests
are deliberately left standing and named in the analysis doc: green-for-the-
wrong-reason and red are different signals, and replacing them belongs to the
rebuild.

  * evals/logos/manifold_collapse.py -- deterministic, bit-exact census
  * tests/test_manifold_collapse_floor.py -- both directions plus the
    English-alone control that attributes the loss to the mount. Two sabotages
    observed red: a real interpolation (ValueError from the versor guard, which
    is how the cure was found) and disabling the mount site (37 -> 3, which is
    how the 34/2/1 site attribution was measured).

Also lands the FA-1 gate PRE-REGISTRATION -- criterion, corpus, negative
classes and anti-gaming rules committed here so they demonstrably predate any
discrimination number, per the ADR-0252 §5 precedent. The repairs it tests are
mechanism (the geodesic, the closed loop, fail-closed edge resolution), not
tuning; the declared strengths are used as written and are not free parameters.

Charter and gap register corrected where this contradicts them: the corpus is
83 edges not 11, the holonomy machinery is not core/physics/digest.py, and
FA-1's "the gate has never been measured" was false -- the 2026-06-14 negative
exists and is pinned. That error, made in the document that records the
three-negatives correction, is the fourth instance of the pattern this arc
keeps finding, and is recorded as such rather than quietly fixed.

[Verification]: uv run core test --suite smoke -q -> 782 passed in 224.37s, EXIT=0
2026-07-28 14:19:15 -07:00
..
adr feat(ledger,tests,adr): PR-14 — the outcome-mix rule, and the four expected licences dissolve under it (R-8) 2026-07-28 07:59:01 +00:00
agents/grok
analysis feat(evals,tests,docs): FA-1 — the semantic ground collapses; "alignment" is implemented as overwrite 2026-07-28 14:19:15 -07:00
arc docs(arc): the commit index and rollback map for the assessment arc 2026-07-28 12:07:43 +00:00
architecture docs: apply the Wave 0 record amendments that need no ruling (N-1…N-7, H-12) 2026-07-27 17:38:12 -07:00
assessment feat(evals,tests,docs): FA-1 — the semantic ground collapses; "alignment" is implemented as overwrite 2026-07-28 14:19:15 -07:00
audit feat(wave-1): retire the dead instruments, delete the aliases nobody calls (PR-3, PR-3b, R-7) 2026-07-28 05:40:45 +00:00
benchmarks
briefs docs(governance): weekly-audit rulings T1/T7/T8/T9 — INV-32/33/34 registration, ADR-0243 fold, residual escalation, path sweep, prune ledger 2026-07-22 19:18:59 -07:00
curriculum
decisions
evals chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
examples
handoff docs(arc): reconcile the arc's records with what the units measured 2026-07-26 12:33:30 -07:00
handoffs docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
implementation docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
issues fix(tests): session-scoped engine-state isolation baseline — close module-scope escape to the live life-store 2026-07-22 20:32:06 -07:00
lab
outreach
paradigm-archive docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
plans feat(evals,tests,docs): FA-1 — the semantic ground collapses; "alignment" is implemented as overwrite 2026-07-28 14:19:15 -07:00
research feat(config,specs,tests): PR-5 — the flag register, profiles as units, and the daemon's missing fourth flag (R-3 + R-4) 2026-07-28 06:47:21 +00:00
sessions
specs docs(specs): the four posture statements — and R-11's measurement dissolves its own question 2026-07-28 08:26:48 +00:00
workbench docs(governance): weekly-audit rulings T1/T7/T8/T9 — INV-32/33/34 registration, ADR-0243 fold, residual escalation, path sweep, prune ledger 2026-07-22 19:18:59 -07:00
zig
3lang-depth-pr-plan.md
admissibility-exemplars.md
ci-optimization.md
conceptualizing_engineering_mastery.md docs(assessment): Phase 0 — ground truth, corpus triage, and the Phase 1 handoff 2026-07-27 15:19:54 -07:00
core-rd-base-prompts.md
ethics_packs.md
EVAL_AUDIT_2026-05-20.md
eval_methodology.md
frontier_baselines.md
gaps.md feat(wave-1): retire the dead instruments, delete the aliases nobody calls (PR-3, PR-3b, R-7) 2026-07-28 05:40:45 +00:00
handoff_template.md
hitl-backpressure.md
holdout_recipients.txt
identity_packs.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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 chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
sponsors.md docs: remove unestablished NSF SBIR and DARPA claims from Path B 2026-06-25 14:36:12 -07:00
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 chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
Yellowpaper.md Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00

CORE Documentation Index

This is the central index for all documentation in the CORE project.

Canonical Root Documents

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.