Upload evidence_faithful_reasoning_release_brief.md with huggingface_hub

evidence_faithful_reasoning_release_brief.md

@@ -8,15 +8,20 @@ Author: darcar0
 Hugging Face model release:
 [`darcar0/evidence-faithful-reasoning-pilot-3`](https://huggingface.co/darcar0/evidence-faithful-reasoning-pilot-3)
 
-Public GitHub release repo: `PUBLIC_REPO_URL`
+Companion files on this page:
+
+- [`technical_note_evidence_faithful_reasoning.md`](./technical_note_evidence_faithful_reasoning.md)
+- [`standalone_holdout_comparison.svg`](./standalone_holdout_comparison.svg)
+- [`benchmark_progression.svg`](./benchmark_progression.svg)
+- [`project_release_arc.svg`](./project_release_arc.svg)
 
 ## Executive summary
 
-I built this project because I wanted a model release where reasoning had to
-cash out into recoverable evidence instead of hiding behind fluent language.
-The result is a strict evidence-faithful reasoning benchmark, a
-benchmark-winning hybrid system, and pilot 3: the strongest standalone model
-from the same project, released as a LoRA adapter on Hugging Face.
+I built this project because I wanted a release where reasoning had to prove
+itself from the evidence instead of hiding behind fluent language. The result
+is a strict evidence-faithful benchmark, a benchmark-winning hybrid system,
+and pilot 3: the standalone model release, shipped here as a LoRA adapter on
+Hugging Face.
 
 The contract is strict. On every bounded evidence packet, the system has to:
 
@@ -26,7 +31,7 @@ The contract is strict. On every bounded evidence packet, the system has to:
 4. abstain with `Insufficient evidence.` when the packet does not justify a
    claim.
 
-This release ships two finished outputs. The benchmark-facing winner is a
+This release ends in two finished outputs. The benchmark-facing winner is a
 hybrid stack — bridge `checkpoint-2` plus `deterministic_v3` packet-local
 quote normalization — that clears every gate on the frozen held-out
 `probe_v0` benchmark. The main downloadable artifact is pilot 3, the
@@ -34,33 +39,11 @@ standalone model release, which beats the earlier bridge model on a fresh
 mixed public holdout and roughly doubles raw quote-faithful behavior at the
 model level.
 
-## Benchmark-facing winner
-
-The benchmark-facing winner is the strongest full system from the project.
-Training moved the model past the older frozen baseline. Deterministic
-packet-local normalization closed the remaining quote-faithfulness and strict
-grounded-success gap without leaving the bounded-packet setting.
-
-| Metric | Frozen probe_v0 |
-|---|---:|
-| Task success | **1.0000** |
-| Strict grounded success | **1.0000** |
-| Mean evidence F1 | **1.0000** |
-| Mean quote F1 | **1.0000** |
-| Verify label accuracy | **1.0000** |
-| Grounded QA accuracy | **1.0000** |
-| Contrastive consistency | **1.0000** |
-| Invalid / missing rate | **0.0000** |
-
-Canonical memo:
-[`reports/sft_v1_final_artifact_status.md`](../reports/sft_v1_final_artifact_status.md)
-
-## Standalone model release: pilot 3
+## Standalone model release
 
 Pilot 3 is the strongest standalone model from the project and the release I
-want people to download first. It is the first standalone checkpoint in the
-project to hold up across multiple non-`probe_v0` evaluation surfaces, and it
-moves a meaningful amount of the winning behavior into the model itself.
+want people to open first. It is the first standalone checkpoint in the
+project that holds up across multiple non-`probe_v0` evaluation surfaces.
 
 Fresh 36-task mixed public holdout:
 
@@ -75,16 +58,30 @@ Pilot 3 beats bridge on task accuracy, evidence F1, and quote F1 in both raw
 and normalized form, ties normalized strict, and roughly doubles raw quote F1
 (`0.3343` → `0.6815`) at the model level.
 
-Canonical memos:
-- [`reports/standalone_model_v2_freeze_memo.md`](../reports/standalone_model_v2_freeze_memo.md)
-- [`reports/standalone_model_v2_holdout_v1_bridge_vs_pilot3_status.md`](../reports/standalone_model_v2_holdout_v1_bridge_vs_pilot3_status.md)
+## Benchmark-facing winner
+
+The benchmark-facing hybrid stack is the strongest full system from the
+project. Training moved the model past the older frozen baseline.
+Deterministic packet-local normalization closed the remaining quote-faithful
+gap without leaving the bounded-packet setting.
+
+| Metric | Frozen probe_v0 |
+|---|---:|
+| Task success | **1.0000** |
+| Strict grounded success | **1.0000** |
+| Mean evidence F1 | **1.0000** |
+| Mean quote F1 | **1.0000** |
+| Verify label accuracy | **1.0000** |
+| Grounded QA accuracy | **1.0000** |
+| Contrastive consistency | **1.0000** |
+| Invalid / missing rate | **0.0000** |
 
 ## Project arc and stopping point
 
-The project followed a full research-engineering loop: baseline mapping,
-benchmark design, prompt and structure interventions, a training-backed bridge
-model, deterministic quote normalization, and then a teacher-student
-distillation cycle to move the winning behavior into the model itself.
+The release has two public faces: a standalone model you can load directly and
+a benchmark-facing hybrid stack that closes the last quote-faithfulness gap.
+That split is part of the project story, not something hidden behind the fine
+print.
 
 A targeted follow-up, pilot 4, fixed one specific FEVER
 month/date temporal-insufficiency case but weakened broader behavior on larger
@@ -113,6 +110,9 @@ Important boundaries:
   [`darcar0/evidence-faithful-reasoning-pilot-3`](https://huggingface.co/darcar0/evidence-faithful-reasoning-pilot-3)
 - Technical note:
   [`docs/technical_note_evidence_faithful_reasoning.md`](./technical_note_evidence_faithful_reasoning.md)
-- Release page:
-  [`release/index.html`](../release/index.html)
-- Public GitHub release repo: `PUBLIC_REPO_URL`
+- Fresh public holdout chart:
+  [`standalone_holdout_comparison.svg`](./standalone_holdout_comparison.svg)
+- Frozen benchmark progression chart:
+  [`benchmark_progression.svg`](./benchmark_progression.svg)
+- Release architecture chart:
+  [`project_release_arc.svg`](./project_release_arc.svg)