History

Claude 2cfc6ad251 fix(cognition): claimant-tracked speculative markers — the refcount fix was wrong (H-13) `71542e61` fixed only half of H-13 and asserted a premise that is false. This replaces it, and records why, because the failure mode is the one this arc exists to catch. WHAT WAS WRONG. The refcount rested on "seeding and eviction walk the same source list, so the counts balance." They do not. The call site's arms are MUTUALLY EXCLUSIVE (pipeline.py §10b): a proposal is seeded when SPECULATIVE or released when COHERENT, never both. So a release never balances a claim the same proposal made, and a COHERENT proposal ALWAYS releases claims it never held. Refcounting therefore repaired only the sub-case where both proposals had been taught speculatively. The ordinary case — an unreviewed `wisdom`, then a separate correction about `practical wisdom` that passes review on its own turn — still stripped the marker. Measured against the landed refcount: `sibling marked? False`. The first attempt's tests passed because their helpers split tokens themselves, mirroring a call pattern production no longer used — tests written to the fix instead of to the defect. That is the same "asserted past the evidence" failure diagnosed in two external assessments earlier today, committed here one commit later, and catchable by reading fifteen lines at the call site. WHAT IS CORRECT. _speculative_subjects maps token -> SET OF CLAIMING SUBJECTS. A token is evicted exactly when the subject that actually claimed it is reviewed; discarding an absent claimant is a no-op, so a neighbour's marker survives. Token derivation moved out of the call site into _speculative_index_tokens, because ownership is what the call site cannot see — doing the split out there made every token its own claimant, which was the bug. Tests rewritten to call the cache exactly as §10b does. The lead pin (test_coherent_proposal_does_not_unmark_an_unrelated_subject) was confirmed to FAIL against the refcount design before this landed, so it discriminates rather than merely passing. 13 pins green; the 8 pre-existing lifecycle pins unchanged. SUITE MEMBERSHIP, resolved rather than deferred. The file pinning this behavior sat in NO curated suite, reachable only through `full` — which is why the regression was invisible (G-7's mechanism, on the pin that would have caught it). Registered now in BOTH TEST_SUITES["smoke"] and smoke.yml, per the #136 precedent that an unregistered pin runs nowhere. Verified the local/CI delta is unchanged at exactly ten files (local 24, CI 14, CI-only 0), so this is compatible with all three R-14 options and settles none of them; PR-4 still owns the standing ten. Cleanup as found: three unambiguously dead imports removed from pipeline.py (hashlib, RatificationOutcome, RatifiedIntent). ruff 4 -> 1; the survivor is a pre-existing structural E402, left alone. Ratification note unchanged: this changes served surfaces — markers appear on turns where they previously vanished. Direction is toward disclosure and it restores ADR-0021 §Articulation's stated intent rather than extending it. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wcw2pnMBwyvmNyQg4uPEt4		2026-07-28 03:38:53 +00:00
..
adr	docs(adr): ratify ADR-0265 — Accepted, Joshua Shay 2026-07-27	2026-07-27 13:17:57 -07:00
agents/grok
analysis
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	fix(cognition): claimant-tracked speculative markers — the refcount fix was wrong (H-13)	2026-07-28 03:38:53 +00:00
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	feat(evals): measure the reader/writer construction inventories against each other	2026-07-27 14:11:07 -07:00
research	docs(assessment): re-anchor the §5 provenance SHAs to the commits that landed	2026-07-28 03:00:46 +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	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
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

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.