supercontexterlisted

# Supercontexter — index + on-demand retrieval Real mechanism, honest math: the saving comes from NOT loading text you don't need yet. The index card (≤ ~100 tokens) sits in context; the full document (thousands of tokens) stays on disk, hash-verified, retrievable per section, verbatim. Nothing is summarized away, so nothing can be hallucinated back. ## `/sc <file>` — index ```bash python supercontexter/scripts/quantum_compressor.py <file> ``` Parses the file into sections (markdown headings; 50-line chunks otherwise), writes `compressed_states/Ψ_<hash>.qstate` (+ `latest.qstate`), prints the index card: one line per section with id, line range, token estimate, title, extract. ## `/uc [state] [section-ids…]` — use ```bash python supercontexter/scripts/quantum_decompressor.py # card of latest python supercontexter/scripts/quantum_decompressor.py Ψ_ab12cd34 s1 s3 # exact sections ``` Section mode verifies the source file's sha256 first — source changed → refuses and demands re-index (never serves stale line ranges). ## Agent contract - Keep only the card in context. Retrieve the specific sections the CURRENT task needs — not the whole file "just in case". - Answer from retrieved sections only. Card extract insufficient → retrieve the section; never guess from the extract. - Task needs most sections → just Read the file normally; the index has no value there. - Never quote token-savings ratios as quality claims: this is lossless deferral, not compression. The ca