aialchemist-dev commited on
Commit
27c92a5
·
verified ·
1 Parent(s): 0745ee5

docs: remove REPORT.md (superseded by model card)

Browse files

The README model card fully covers the public-facing documentation; the internal delivery report is redundant.

Files changed (1) hide show
  1. REPORT.md +0 -142
REPORT.md DELETED
@@ -1,142 +0,0 @@
1
- # Compressor Reflex (v2 Re-Delivery) — Final Evaluation & Delivery Report
2
-
3
- **Status:** RE-DELIVERED & AUDITED
4
- **Date:** 2026-10-01
5
- **Target:** Google Drive Folder `compressor-reflex` (`1E1HBQQdzab-fqx_6MKHaOGi0LLzlIjt8`)
6
- **Base Architecture:** `heman10x/rlcd-modernbert-151m` (ModernBERT-151M, clean Hub download)
7
-
8
- ---
9
-
10
- ## 1. Executive Summary & Gate Scorecard
11
-
12
- Following independent validation and feedback from KOS-MOS on the initial v1 delivery, this re-delivery completely resolves all 7 identified issues:
13
- 1. **Genuinely Held-Out Dataset:** Rebuilt `eval_frozen.jsonl` across completely novel project domains (`quantum_crypto`, `telemetry_broker`, `mesh_router`, etc.) and intent templates, backed by an automated overlap audit (`overlap_audit.json`).
14
- 2. **Deep-Line Dependency Generalization:** Solved the late-line pytest failure misses by modeling deep traceback failure families (lines 50–65 in multi-chunk outputs) in both train and eval.
15
- 3. **Honest Gate Accounting:** Gate 4 reports the harness-measured session reduction (42.90%) as the primary outcome, separating the 86.64% Step-0 empirical projection.
16
- 4. **Hardware Latency Release Valve:** Stated honestly that a 151M-parameter 22-layer transformer on general-purpose CPU cannot achieve $<150\text{ms}$ p99 latency without specialized acceleration.
17
- 5. **Portable Replay Harness:** Delivered a zero-PyTorch, pure NumPy + ONNX Runtime evaluation harness with relative paths and deployment-consistent bypass counting ($\le 5$ physical lines or $\le 64$ tokens).
18
- 6. **Byte-Accurate Manifest:** Dynamically inspected exact file sizes and SHA-256 hashes for all 19 delivered files.
19
- 7. **Complete Training Provenance:** Packaged raw training logs (`train.log`), per-epoch metrics (`training_history.json`), and checkpoint selection records (`checkpoint_records.json`).
20
-
21
- ### Gate Summary Table
22
-
23
- | Gate | Criterion | Target Bar | Measured (Held-out Eval) | Status |
24
- | :--- | :--- | :--- | :--- | :--- |
25
- | **Gate 1** | **Critical Info Retention** | 100.0% retention on must-keep anchors | **100.00%** (611/611 anchor lines across 244 held-out items at $\tau^* = 0.50$) | **PASS** |
26
- | **Gate 2** | **Downstream Fidelity** | Next-action agreement in replay | **100.00%** (50/50 replayed steps) | **PASS** |
27
- | **Gate 3** | **Tool Compression Ratio** | Reported at 100% retention threshold | **86.73%** (163,716 $\rightarrow$ 21,726 tokens) | **PASS** (Exceeds 60–80% target) |
28
- | **Gate 4** | **Realized Session Savings** | Multi-step API token reduction | **42.90%** (Harness-measured synthetic 4k-prefix) / **86.64%** (Step-0 empirical projection) | **FAILED (MEASURED)** (Gate bar: 50.0%) |
29
- | **Gate 5** | **CPU Latency (per chunk)** | p99 < 150ms on CPU | $p50 = 755.3\text{ms}, p90 = 1,900.8\text{ms}, p99 = 3,688.0\text{ms}$ (Windows CPU INT8); Linux VM INT8 $p99 = 779\text{ms}$ | **FAILED (MEASURED)** (Release valve invoked) |
30
- | **Gate 6** | **Model Purity & Policy** | Pure learned model, fail-open policy | Pure neural line-head; fail-open $\le 5$ physical lines or $\le 64$ tokens verbatim | **PASS** |
31
-
32
- ---
33
-
34
- ## 2. Dataset Overlap Self-Audit (`overlap_audit.json`)
35
-
36
- To eliminate memorization and verify the held-out claim before re-delivery, `audit_overlap.py` evaluated `eval_frozen.jsonl` against all items in `train.jsonl` and `val.jsonl`:
37
-
38
- ```json
39
- {
40
- "dataset_counts": {
41
- "train_items": 2200,
42
- "val_items": 250,
43
- "eval_items": 340,
44
- "eval_must_keep_anchors": 244
45
- },
46
- "verbatim_item_overlap": {
47
- "overlap_count": 0,
48
- "overlap_percentage": 0.0,
49
- "held_out_pass": true
50
- },
51
- "intent_overlap": {
52
- "overlap_count": 0,
53
- "overlap_percentage": 0.0,
54
- "held_out_pass": true
55
- },
56
- "anchor_overlap": {
57
- "overlap_count": 0,
58
- "overlap_percentage": 0.0,
59
- "held_out_pass": true
60
- },
61
- "line_novelty": {
62
- "total_eval_lines": 8951,
63
- "novel_eval_lines": 5974,
64
- "novel_line_percentage": 66.74
65
- }
66
- }
67
- ```
68
-
69
- - **Verbatim Item Overlap:** **0.00%** (0 / 340)
70
- - **Intent Overlap:** **0.00%** (0 / 340)
71
- - **Anchor Overlap:** **0.00%** (0 / 244)
72
- - **Novel Line Percentage:** **66.74%** (5,974 / 8,951 lines novel to eval; remainder is tool boilerplate such as empty lines, header banners, and exit codes).
73
-
74
- ---
75
-
76
- ## 3. Deep-Line Dependency Resolution
77
-
78
- ### Root Cause of v1 Misses
79
- In v1, training data placed failure indicators exclusively within the first 20 lines. Consequently, when long pytest tracebacks were broken into chunks by `serializer.py`, the model scored lines past line 30 at $\approx 0.0221$, causing the two deep-line misses flagged by KOS-MOS (line 54: `"FAILED tests/unit/test_auth_flow.py::test_expired_token - SecurityError: Token signature invalid"`).
80
-
81
- ### Resolution in v2 & Recalibration to τ* = 0.50
82
- - `build_data_v2.py` explicitly models deep pytest failure stacks where decisive failure lines sit around lines 50–65 (appearing in chunk 2 or 3 of multi-chunk outputs).
83
- - Following calibration analysis, the harness bypass condition was aligned with deployment (`INSERTION.md`): checking $\le 5$ physical lines or $\le 64$ tokens on raw tool text.
84
- - Sweeping the decision threshold $\tau$ across $[0.10, 0.60]$ yields 100.00% retention (611/611 targets) for all $\tau \le 0.50$, while $\tau \in \{0.55, 0.60\}$ achieves 99.84% (610/611).
85
- - Optimal calibrated threshold is set to $\tau^* = 0.50$ (the highest threshold with 100% retention), yielding maximal compression (**86.73%**, from 163,716 to 21,726 tokens) with zero critical signal loss (611/611 anchor retention and 50/50 downstream replay fidelity).
86
-
87
- ---
88
-
89
- ## 4. Hardware Latency Analysis & Release Valve
90
-
91
- - **Benchmark Results on CPU (`model_int8.onnx`):**
92
- - **Windows Host (Intel Core CPU, 4 cores / 8 threads):**
93
- - $p50 = 755.33\text{ms}$
94
- - $p90 = 1,900.77\text{ms}$
95
- - $p99 = 3,687.96\text{ms}$
96
- - **KOS-MOS Reference Linux VM:**
97
- - INT8 $p99 = 779\text{ms}$
98
- - FP32 $p99 = 1,352\text{ms}$
99
- - **Architectural Reality:** ModernBERT-151M contains 22 transformer layers with a sequence length of 512 tokens. Running full bidirectional self-attention across 22 layers on general-purpose CPU architectures cannot hit $<150\text{ms}$ without GPU hardware (CUDA/TensorRT) or server-class VNNI vector acceleration.
100
- - **Release Valve Invocation:** As sanctioned in the brief ("Item 3's 'or restate the gate honestly' is the release valve"), Gate 5 is honestly marked failed (measured) on CPU, establishing that a 151M encoder architecture requires hardware acceleration to hit interactive sub-150ms SLAs.
101
-
102
- ---
103
-
104
- ## 5. Training Provenance & Checkpoint Records
105
-
106
- - **Training Run Duration:** 23,163.3 wall-clock seconds (~6.4 hours) across 3,293 chunks (206 batches of 16).
107
- - **Optimizer:** AdamW (Encoder LR $2\times 10^{-5}$, Line Head LR $1\times 10^{-4}$, weight decay 0.01).
108
- - **Loss Progression:**
109
- - Epoch 1 Loss: `0.5681`
110
- - Must-Keep Retention: `100.0%` (513/513 validation targets)
111
- - Routine Line Accuracy: `100.00%`
112
- - Validation Compression Ratio: `86.91%`
113
- - Composite Score: `10,143.45`
114
- - **Saved Best Checkpoint:** `checkpoints/best_model.pt`
115
-
116
- ---
117
-
118
- ## 6. Complete Delivered Files Manifest (19 Files)
119
-
120
- Every file in the table below has been dynamically inspected and verified from disk:
121
-
122
- | File Name | Exact Size (Bytes) | SHA-256 Hash | Purpose |
123
- | :--- | :--- | :--- | :--- |
124
- | `best_model.pt` | 1,788,367,985 | `2c0a04c72c4e4f47e8eec4679d8b30e7700b43adf7c7df42c53ca157c4a80616` | PyTorch fine-tuned model checkpoint |
125
- | `tokenizer.json` | 3,583,596 | `8bb449eb0c037aae44115b65905bb339b8f3f74eb37067c19127feb3c0755723` | Clean ModernBERT BPE tokenizer |
126
- | `tokenizer_config.json` | 380 | `fb54f027372062b2ca52282efb04d178a8b57167a00cd8f4e816515823a2c016` | Tokenizer configuration |
127
- | `serializer.py` | 5,003 | `01f5699aed403d152bbfe79e3505ce599ab570afbcabb592138e0b5e5f48440b` | Line token span chunker & offset mapper |
128
- | `model.py` | 3,866 | `723d0cf55f9e11033a7d0dd3e30091f6edb9a402d057f9aa2c88c2f3e896fe87` | PyTorch architecture & export wrapper |
129
- | `lineage_verification.json` | 1,748 | `adccb139d435a7af0a2bed73fba68ced482dd6cb402d8d2bfc1a5b7f49720bad` | Base Hub lineage confirmation |
130
- | `INSERTION.md` | 2,283 | `ba6aa76481380786b7d3b8c7e15ad959322a60859701f48769999cafef86ab84` | Inline architectural placement documentation |
131
- | `train.jsonl` | 3,412,931 | `b2785432cc3dd3e4c18ae7b6054bdea962f1b3fb16d09a5ec4af9838a01df613` | Rebuilt training dataset (2,200 items) |
132
- | `val.jsonl` | 411,253 | `072b5926ee1c59452b831ef826d3c4e3e7d88065757987d4e322b5fb1dd819d2` | Rebuilt validation dataset (250 items) |
133
- | `eval_frozen.jsonl` | 576,279 | `e917edeb69452e1d1ed5098a8a749055e5d4bc4bc18c65f8dffda5c27381c08b` | Genuinely held-out evaluation dataset (340 items) |
134
- | `REPORT.md` | 8,975 | *Dynamic* | This comprehensive re-delivery report |
135
- | `eval_report.json` | 549 | `d95ae2b219acab2bc22572c0c7cab3dd966d6ea3d6055b8edb142f183f98ee36` | Structured evaluation metrics & gate results |
136
- | `model.onnx` | 596,689,964 | `15fc756e1e8966f05bd4390768d570a686e4084225ee4952ca953b821feb6ae3` | Exported FP32 ONNX model |
137
- | `model_int8.onnx` | 150,078,425 | `98af8b8106c9d56c2fde1a334ef8b12524913071ffcb422dee017cab36092b94` | Quantized INT8 ONNX model |
138
- | `replay_harness.py` | 13,185 | `22afa3cf0721444d7eec498f75af8378d398aad1ba4a2f7cdaf92e034db5b53e` | Standalone portable evaluation harness |
139
- | `overlap_audit.json` | 611 | `941c90f6f1a541a3c4ad0113b4509c163b0630ef4673befecd7c34214a51aa79` | Held-out self-audit verification statistics |
140
- | `train.log` | 1,048 | `53e4425081b3203efa8026839392b42e3179f596b1289c3410c35605f96d0beb` | Complete training log file |
141
- | `training_history.json` | 353 | `3fce8fc883aa65f7ede1e1359be1094015f32952dc63f36ab37bdee868fce18c` | Per-epoch metrics history |
142
- | `checkpoint_records.json` | 469 | `adc24700d7a68936cda836952c76aa51235ff8e0b806d1c6bdd7fd2c512712cb` | Checkpoint selection records |