core/docs
Shay 47e7eb4e65 feat(adr-0246): Opus audit + §3.7 admit surface + serve wiring + §6.3 discrimination
Opus 4.8 audit of Fable's slice-1 scaffold + authorized hardening (Step 2).
Stacked on feat/adr-0246-slice1-scaffold. Not a PR, not merged, no status flip.

AUDIT (Step 1) — VERDICT PASS. Re-derived A(F)/d_orth/d_stab/typed channels from
§3.1/3.2/3.6 independently: BIT-EXACT vs impl (0.00e+00). Confirmed in code (not
just comments): H_id={I} locked (singleton hardcoded, no enlargement path); path
composes lawful only, refused=break marker, never raw, never soft-I; no §7 scope
creep; serve byte-identity. Finding F1 (doc, not bug): composition uses the raw
CERTIFIED action (required for §6.2 accumulation, else A_path≡I detects nothing) —
now documented for ADR ratification.

HARDENING (Step 2):
  §3.7 pure surface (identity_action.py): AdmissionPolicy (calibrated flag),
    evaluate_admission (admit-or-abstain, no corrector); CERTIFIED_GAMMA_ID pinned
    == identity._WAVE_LEAKAGE_BOUND; all other bounds UNCERTIFIED placeholders.
  §3.7 SERVE WIRING (Steps 2.1/2.2): new default-off flag identity_action_surface
    (config); threaded chat/runtime -> check -> _wave_field_score; refusal folds
    into flagged -> existing would_violate/conjugate_correct abstains; IdentityScore
    gains action_surface_active/d_orth/d_stab (legacy defaults). Flag-off is
    byte-identical (D4 gate surfaces green unchanged; smoke 176 post-wiring).
  §6.3 DISCRIMINATION REPORT (evals/adr_0246_discrimination) — HONEST numbers:
    benign pass 0.00, false refusal 1.00, adversarial detect 1.00, control pass
    1.00; d_stab AUC 0.375 (95% CI [0.15,0.62]) — BELOW chance. Benign cognition
    sits ~18x farther from the frame (mean d_stab 27.8) than the attacks (1.55).
    The gate refuses everything and does NOT discriminate; must stay off; usable
    separation needs the §11 grounding work, not threshold tuning. Claims language
    enforced: 'lawfulness relative to the declared frozen frame', NOT 'semantic
    inalienability'.
  Ledger raw-sneak hardening test (Step 2.3): mixed lawful/refused sequence must
    equal the lawful sub-product, fails if raw sneaks into A_path_lawful.

Handoff to Sonnet: §4.1 per-turn record, path-ledger serve integration, ADR-0246
body + acceptance packet (Proposed, no self-Accept), §11 grounding-feasibility.

[Verification]: uv run core test --suite smoke -q => 176 passed (post-wiring);
ADR-0246 suites 80 passed; egress wiring + D4 gate surfaces 47 passed
(byte-identity); §6.1/6.2 eval 14/14; discrimination report numbers above.
See docs/audit/adr-0246-slice1-opus-audit-and-hardening.md + run log.
2026-07-17 22:51:46 -07:00
..
adr docs(adr-0244-d4): RATIFIED — ADR-0244 + ADR-0245 Proposed→Accepted (Joshua Shay) 2026-07-17 20:28:18 -07:00
agents/grok docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
analysis docs(adr-0244,adr-0245): D4 Phase 0 — governance reconciliation 2026-07-17 15:32:09 -07:00
architecture Lane 4: Registry Consolidation (language_packs to packs) 2026-07-04 15:11:28 -07:00
audit feat(adr-0246): Opus audit + §3.7 admit surface + serve wiring + §6.3 discrimination 2026-07-17 22:51:46 -07:00
benchmarks feat(bench): add MLX exact CGA recall experiment (#909) 2026-06-24 13:53:50 -07:00
briefs feat(adr-0246): Opus audit + §3.7 admit surface + serve wiring + §6.3 discrimination 2026-07-17 22:51:46 -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
handoff draft(adr-0246): slice-1 scaffold — §6.1/§6.2 eval suite + malformed-F guard 2026-07-17 22:09:32 -07:00
handoffs feat(abi): Implement GeometricDelta ABI, validator, delta store, and documentation 2026-07-11 02:16:57 -07:00
implementation docs: propose semantic-symbolic binding graph layer (#170) 2026-05-23 09:58:39 -07:00
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 docs(adr-0243): Phase 3 lane brief pack (A/B/C) + correct stale readback-rules claim 2026-07-17 06:48:33 -07:00
research docs(analysis): rejected Drive-draft re-implementation — assessment + sketch-defect pins 2026-07-16 10:13:04 -07:00
sessions chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
specs fix(algebra): P11a physics hot paths via algebra.backend (Rust-ready) 2026-07-14 21:08:02 -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
ci-optimization.md ci: fast-lane main gate, nightly full suite, skip-safe lane-shas 2026-07-14 21:02:43 -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 chore(evals): contracts + bench json + Lane B viewer + chart + audit + demo schema (#62) 2026-05-20 13:53:13 -07:00
eval_methodology.md feat: ADR-0113 rename expert-demoaudit-passed; reserve expert namespace (ADR-0114 GSM8K roadmap) 2026-05-22 15:36:10 -07:00
frontier_baselines.md feat(evals): frontier structural-zero baselines for Phase 2 v1 lanes 2026-05-16 12:45:28 -07:00
gaps.md Add chain-first capability ledger and domain seeds (#97) 2026-05-20 21:33:24 -07:00
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 feat(ADR-0161.3): submission-time invariants — duplicate + dependent_on_pending auto-reject (#313) 2026-05-26 16:46:25 -07:00
holdout_recipients.txt feat: ADR-0119.1 — seal fabrication_control holdout with age encryption (Obligation #1) 2026-05-22 17:22:46 -07:00
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 memo: tighten for Karpathy + Anthropic exec audience 2026-06-10 16:10:47 -07:00
model_dependency_size_tally.md fix(ci): arm64 runner toolchain — pyrage aarch64 wheel + lane-shas via uv 2026-07-12 17:12:22 -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 fix(demo): harden epistemic truth-state authority — sealed corpus + entailment-decided inference 2026-06-11 23:38:03 -07:00
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 fix(algebra): P11a physics hot paths via algebra.backend (Rust-ready) 2026-07-14 21:08:02 -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 feat: close ADR-0241/0242 post-Accept backlog (local-first mastery) 2026-07-16 15:25:43 -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.