core/docs
Shay b652a627ba
Some checks failed
smoke / smoke (-m "not quarantine") (pull_request) Failing after 58s
lane-shas / verify pinned lane SHAs (pull_request) Failing after 4m23s
refactor(third-door): retire vacuous §3.3 grade-5 pseudoscalar gate (#19)
The Super-Blueprint §3.3 "grade-5 pseudoscalar alignment anchor" is
mathematically vacuous in odd-dimensional Cl(4,1) and cannot be built as
specified (3-agent R&D convergence — Opus/Grok/Terra — ratified):

- I₅ is central in odd dim → V·I₅·Ṽ = ±I₅ for every versor; orientation is
  invariant by construction (nothing to block).
- Field-state versors are even → F[31] ≡ 0; the gated ⟨F·F̃⟩₅ = 0 for the
  source and target of every transition. The gate compares 0 == 0.
- The "even-versor parity gate" repair is equally vacuous (even subalgebra is
  closed under the sandwich; odd-grade mass ≡ 0 on the sanctioned path).

Removes the namesake rather than leaving it masking an absence:
- Delete _PSEUDOSCALAR_IDX + all F[31] reads (dead `ps` history element and
  CoherenceResidual.pseudoscalar — both structural zeros).
- Rename telemetry channel pseudoscalar_floor → autonomy_floor (it was always
  self.floor, the earned-autonomy ceiling).
- Bump telemetry schema goldtether_coherence_v1 → v2 (shape changed).

The integrity-anchor role is subsumed by versor closure + GoldTether harmonized
residual (#24) + biography/identity holonomy. Ledger §5 rewritten with the
vacuity proof, subsumption, and the reusable "would this gate ever fire on the
sanctioned construction path?" meta-criterion.

No serving/runtime path touched (core.physics.* is off-serving). Tests: 33 pass
/ 1 xfail (Cartan #2) across goldtether + fidelity + miner + transfer suites;
ruff clean.
2026-07-12 13:07:17 -07:00
..
adr fix(third-door): align with perfected package contracts from Downloads artifacts (refs #10 #11 #12 #13) 2026-07-11 22:05:02 -07:00
agents/grok docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
analysis Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
architecture Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
audit Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
benchmarks feat(bench): add MLX exact CGA recall experiment (#909) 2026-06-24 13:53:50 -07:00
briefs Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
curriculum Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
decisions docs(adr): land Third-Door Super-Blueprint + ADR-0238/0239/0240 (refs #10 #11 #12 #13) 2026-07-11 22:01:08 -07:00
evals chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
examples docs(agent-governance): add Grok 4.3 / Grok Build engineering harness (#798) 2026-06-17 07:27:50 -07:00
handoffs feat(abi): Implement GeometricDelta ABI, validator, delta store, and documentation 2026-07-11 02:16:57 -07:00
implementation
issues chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
lab docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
outreach feat(bench): add Apple UMA demo package builder (#913) 2026-06-24 15:51:45 -07:00
plans Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
research refactor(third-door): retire vacuous §3.3 grade-5 pseudoscalar gate (#19) 2026-07-12 13:07:17 -07:00
sessions chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
specs feat: integrate 3-core-language depth into PropositionGraph spine for bidirectional unification 2026-07-06 09:01:43 -07:00
workbench Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
zig chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
3lang-depth-pr-plan.md fix(3lang-depth): remove is_fully_grounded gate from depth enrichment so result always gets node_depths/gau for 3-lang; fix fixture to use combined packs + explicit skip docs; add runtime docstrings for contract; update draft md evidence 2026-07-08 08:02:01 -07:00
admissibility-exemplars.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
core-rd-base-prompts.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
ethics_packs.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
EVAL_AUDIT_2026-05-20.md
eval_methodology.md
frontier_baselines.md
gaps.md
handoff_template.md feat: 3lang depth PropGraph unification - phase refinements, wiring, tests + session pickup cleanups/governance 2026-07-08 07:07:11 -07:00
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 chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
memo.html
model_dependency_size_tally.md Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
pack_inventory_2026-05-21.md Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
position_paper.md
PROGRESS.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
README.md feat: 3lang depth PropGraph unification - phase refinements, wiring, tests + session pickup cleanups/governance 2026-07-08 07:07:11 -07:00
recognizer-registry.md feat(derivation): Workstream A inc 2 — frontier report + rate_with_currency apply_rate injection (#797) 2026-06-17 06:38:45 -07:00
refusal-taxonomy.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
reviewers.yaml chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
RUST.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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 chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
testing-lanes.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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.