docs: remove REPORT.md (superseded by model card)
Browse filesThe README model card fully covers the public-facing documentation; the internal delivery report is redundant.
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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|