knitbrain 0.1.1 → 0.2.0

package/dist/optimizer/structured.js

@@ -0,0 +1,196 @@
+/**
+ * Structured-output handlers — search results, build/test logs, unified
+ * diffs. These shapes dominated the misrouted residue of the code bucket
+ * (markdown reports, grep dumps, test runs tripping the loose isCode
+ * heuristic), so their detectors run BEFORE isCode in the router.
+ *
+ * Shared invariant: failure/error lines are NEVER elided — a compressed log
+ * that loses the FATAL line is worse than no compression at all.
+ */
+/** Lines that must survive any elision (failures live mid-output). */
+export const IMPORTANT_LINE = /\b(FAIL(ED|URE)?|FATAL|ERROR|Error:|error(\s+TS\d+|\[E\d+\])?:|✗|✘|✖|npm ERR!|Exception|Traceback|AssertionError|fatal:|panic:|Segmentation fault|undefined reference)\b|^\s*(✗|✘|✖)/m;
+/** Result-summary lines (test/build totals) — the other thing an agent always
+ * needs from a run. Rescued alongside errors by every elision path. */
+export const RESULT_LINE = /^\s*(Tests?|Test (Suites?|Files)|Suites?|Duration|Time:|Ran \d+|\d+ (passing|failing|pending|tests? (passed|failed)))\b/m;
+// ---------------------------------------------------------------------------
+// Search results (grep -n / ripgrep / eslint style: path:line[:col]: content)
+// ---------------------------------------------------------------------------
+const SEARCH_LINE = /^(\S[^:\n]*):(\d+)(?::\d+)?[:-]/;
+const MIN_SEARCH_LINES = 10;
+/** Matches kept per file before the rest collapse to a count. */
+const KEEP_PER_FILE = 2;
+/** ≥50% of non-empty lines look like `path:line:` matches (and enough of them). */
+export function isSearchResults(text) {
+    const lines = text.split("\n").filter((l) => l.trim().length > 0);
+    if (lines.length < MIN_SEARCH_LINES)
+        return false;
+    let hits = 0;
+    for (const l of lines)
+        if (SEARCH_LINE.test(l))
+            hits += 1;
+    return hits >= lines.length * 0.5 && hits >= MIN_SEARCH_LINES;
+}
+/**
+ * Collapse search output by file: keep the first matches per file (the
+ * locations), count the rest. Agents almost always act on file+line, not on
+ * the repeated match text — and the full set is one retrieve away.
+ */
+export function compressSearchResults(original, ccr) {
+    const lines = original.split("\n");
+    const out = [];
+    let currentFile = "";
+    let keptInFile = 0;
+    let droppedInFile = 0;
+    let files = 0;
+    let matches = 0;
+    const flushDrops = () => {
+        if (droppedInFile > 0)
+            out.push(`  ⟪… +${droppedInFile} more matches in this file⟫`);
+        droppedInFile = 0;
+    };
+    for (const line of lines) {
+        const m = SEARCH_LINE.exec(line);
+        if (m === null) {
+            flushDrops();
+            currentFile = "";
+            if (line.trim().length > 0)
+                out.push(line);
+            continue;
+        }
+        matches += 1;
+        if (m[1] !== currentFile) {
+            flushDrops();
+            currentFile = m[1];
+            keptInFile = 0;
+            files += 1;
+        }
+        if (keptInFile < KEEP_PER_FILE || IMPORTANT_LINE.test(line)) {
+            out.push(line);
+            keptInFile += 1;
+        }
+        else {
+            droppedInFile += 1;
+        }
+    }
+    flushDrops();
+    const handle = ccr.put(original);
+    out.push(`⟪${matches} matches across ${files} files · exact original: ⟨ccr:${handle}⟩⟫`);
+    return { skeleton: out.join("\n"), handle, contentType: "search" };
+}
+// ---------------------------------------------------------------------------
+// Build / test logs
+// ---------------------------------------------------------------------------
+const LOG_SIGNATURE = /^\[?\d{4}-\d{2}-\d{2}[T ]|^\d{2}:\d{2}:\d{2}|\b(INFO|DEBUG|WARN(ING)?|ERROR|TRACE)\b|^\s*(PASS|FAIL|ok|not ok)\b|^\s*[✓✔✗✘✖·❯]|\b(PASSED|FAILED|SKIPPED)\b|^={5,}|^-{5,}|^⎯{5,}|^\s*> Task |^npm (warn|notice|http|error)|^\s*at .+\(?.+:\d+:\d+\)?$|^\s*\d+\||^\s*(Test Files|Tests|Duration|Start at)\s|^\s*RUN\s+v\d|^>\s\S+@\d/;
+const MIN_LOG_LINES = 20;
+/** ≥30% of lines carry a log/test signature (timestamps, levels, test
+ * markers, vitest/jest code frames `123|`, stack frames, run summaries). */
+export function isLogOutput(text) {
+    const lines = text.split("\n");
+    if (lines.length < MIN_LOG_LINES)
+        return false;
+    let hits = 0;
+    for (const l of lines)
+        if (LOG_SIGNATURE.test(l))
+            hits += 1;
+    return hits >= lines.length * 0.3;
+}
+const LOG_HEAD = 5;
+const LOG_TAIL = 10;
+/** Runs of routine lines shorter than this stay inline. */
+const MIN_RUN = 4;
+/**
+ * Log skeleton: keep the head (what ran), the tail (summaries land at the
+ * end), and EVERY error/failure line; collapse runs of routine lines to
+ * counted markers. The router still race-checks this against the generic
+ * text handler and keeps whichever is smaller.
+ */
+export function compressLog(original, ccr) {
+    const lines = original.split("\n");
+    const keep = new Array(lines.length).fill(false);
+    for (let i = 0; i < lines.length; i += 1) {
+        if (i < LOG_HEAD || i >= lines.length - LOG_TAIL)
+            keep[i] = true;
+        else if (IMPORTANT_LINE.test(lines[i]) || RESULT_LINE.test(lines[i]))
+            keep[i] = true;
+    }
+    const out = [];
+    let run = [];
+    const flushRun = () => {
+        if (run.length === 0)
+            return;
+        // Tiny gaps stay inline — the elision marker would cost more than it saves.
+        if (run.length < MIN_RUN)
+            out.push(...run);
+        else
+            out.push(`⟪… ${run.length} routine lines⟫`);
+        run = [];
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        if (keep[i]) {
+            flushRun();
+            out.push(lines[i]);
+        }
+        else {
+            run.push(lines[i]);
+        }
+    }
+    flushRun();
+    const handle = ccr.put(original);
+    out.push(`⟪exact original: ⟨ccr:${handle}⟩⟫`);
+    return { skeleton: out.join("\n"), handle, contentType: "log" };
+}
+// ---------------------------------------------------------------------------
+// Unified diffs
+// ---------------------------------------------------------------------------
+const DIFF_FILE_HEADER = /^(diff --git |index [0-9a-f]+\.\.|--- |\+\+\+ )/;
+const HUNK_HEADER = /^@@ -\d+(,\d+)? \+\d+(,\d+)? @@/;
+/** Unified diff: a `diff --git` header, or ---/+++ pair plus a hunk header. */
+export function isDiff(text) {
+    const head = text.slice(0, 4000);
+    if (/^diff --git /m.test(head))
+        return true;
+    return /^--- /m.test(head) && /^\+\+\+ /m.test(head) && HUNK_HEADER.test(text.split("\n").find((l) => l.startsWith("@@")) ?? "");
+}
+/** Hunk bodies longer than this elide to a ±count marker. */
+const MAX_INLINE_HUNK = 14;
+/**
+ * Diff skeleton: keep file headers and hunk headers (the WHERE), keep error
+ * lines, elide long hunk bodies to `⟪… +a/-b/~c lines⟫` (the churn size).
+ * Reviewers and agents mostly need which files/regions changed and how much;
+ * the full patch is one retrieve away.
+ */
+export function compressDiff(original, ccr) {
+    const lines = original.split("\n");
+    const out = [];
+    let body = [];
+    const flushBody = () => {
+        if (body.length === 0)
+            return;
+        if (body.length <= MAX_INLINE_HUNK) {
+            out.push(...body);
+        }
+        else {
+            const adds = body.filter((l) => l.startsWith("+")).length;
+            const dels = body.filter((l) => l.startsWith("-")).length;
+            const ctx = body.length - adds - dels;
+            const rescued = body.filter((l) => IMPORTANT_LINE.test(l));
+            out.push(`⟪… hunk elided: +${adds}/-${dels} lines, ${ctx} context⟫`);
+            out.push(...rescued);
+        }
+        body = [];
+    };
+    for (const line of lines) {
+        if (DIFF_FILE_HEADER.test(line) || HUNK_HEADER.test(line)) {
+            flushBody();
+            out.push(line);
+        }
+        else {
+            body.push(line);
+        }
+    }
+    flushBody();
+    const handle = ccr.put(original);
+    out.push(`⟪exact diff: ⟨ccr:${handle}⟩⟫`);
+    return { skeleton: out.join("\n"), handle, contentType: "diff" };
+}
+//# sourceMappingURL=structured.js.map

package/dist/optimizer/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/optimizer/structured.ts"],"names":[],"mappings":"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"}

package/dist/optimizer/text.js

@@ -1,3 +1,4 @@
+import { IMPORTANT_LINE, RESULT_LINE } from "./structured.js";
 /** Below this many lines, line-dedup isn't worth attempting. */
 const MIN_LINES_FOR_DEDUP = 20;
 /**
@@ -24,8 +25,11 @@ export function compressText(original, ccr) {
         const counts = new Map();
         const firstSeen = new Map();
         const order = [];
+        let uniq = 0;
         for (const line of lines) {
-            const key = normalize(line);
+            // Error lines never collapse into a ×N template: assertion failures
+            // differ exactly in the bits the normalizer erases (the values).
+            const key = IMPORTANT_LINE.test(line) ? `!imp${(uniq += 1)}` : normalize(line);
             const seen = counts.get(key);
             if (seen === undefined) {
                 counts.set(key, 1);
@@ -75,14 +79,41 @@ const TAIL_SENTENCES = 1;
  * Returns null when there aren't enough sentences to anchor.
  */
 export function compressShortProse(original, ccr) {
-    const sentences = original.split(SENTENCE_SPLIT);
-    if (sentences.length < MIN_SENTENCES)
+    // Find sentence boundaries by OFFSET so head/tail keep the original bytes
+    // verbatim (joining split sentences with " " used to break mid-line after
+    // colons, splitting error lines across the elision boundary).
+    const re = new RegExp(SENTENCE_SPLIT.source, "g");
+    const bounds = [];
+    for (let m = re.exec(original); m !== null; m = re.exec(original)) {
+        bounds.push({ end: m.index, next: m.index + m[0].length });
+    }
+    if (bounds.length + 1 < MIN_SENTENCES)
         return null;
-    const head = sentences.slice(0, HEAD_SENTENCES).join(" ");
-    const tail = sentences.slice(-TAIL_SENTENCES).join(" ");
-    const elided = sentences.length - HEAD_SENTENCES - TAIL_SENTENCES;
+    // Snap both boundaries to LINE breaks: a sentence boundary can land
+    // mid-line (": 1"), and splitting a line across the elision turns one
+    // error line into two fragments. Lines are the unit of fidelity.
+    const tailBound = bounds[bounds.length - TAIL_SENTENCES];
+    let headEnd = original.indexOf("\n", bounds[HEAD_SENTENCES - 1].end);
+    if (headEnd === -1)
+        headEnd = bounds[HEAD_SENTENCES - 1].end;
+    let tailStart = original.lastIndexOf("\n", tailBound.next) + 1;
+    if (tailStart <= headEnd) {
+        // Single-line prose (no newline between the anchors): line snapping is
+        // moot — cut at the sentence boundaries directly.
+        headEnd = bounds[HEAD_SENTENCES - 1].end;
+        tailStart = tailBound.next;
+    }
+    const head = original.slice(0, headEnd);
+    const tail = original.slice(tailStart);
+    const middle = original.slice(headEnd, tailStart);
+    // Error/failure and result-summary LINES are never elided — same invariant
+    // as every other handler (a skeleton that loses the error is worse than no
+    // skeleton). Whole lines, so the exact original text survives.
+    const rescued = middle.split("\n").filter((l) => IMPORTANT_LINE.test(l) || RESULT_LINE.test(l));
+    const elided = bounds.length + 1 - HEAD_SENTENCES - TAIL_SENTENCES;
     const handle = ccr.put(original);
-    const skeleton = `${head}\n⟪… ${elided} sentences elided · exact original: ⟨ccr:${handle}⟩ …⟫\n${tail}`;
+    const rescueBlock = rescued.length > 0 ? `\n${rescued.join("\n")}` : "";
+    const skeleton = `${head}\n⟪… ${elided} sentences elided · exact original: ⟨ccr:${handle}⟩ …⟫${rescueBlock}\n${tail}`;
     return { skeleton, handle, contentType: "prose" };
 }
 //# sourceMappingURL=text.js.map

package/dist/optimizer/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/optimizer/text.ts"],"names":[],"mappings":"AAGA,gEAAgE;AAChE,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAa;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,uEAAuE;IACvE,qEAAqE;IACrE,kEAAkE;IAClE,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CACtC,CAAC;SACE,OAAO,CAAC,iCAAiC,EAAE,MAAM,CAAC;SAClD,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC;SACvC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5B,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACnB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,8EAA8E;QAC9E,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACxC,IAAI,GAAG,KAAK;iBACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7E,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,IAAI,MAAM,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,0CAA0C,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,QAAQ,GACZ,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,UAAU,MAAM,GAAG,CAAC;IACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC;AAED,mFAAmF;AACnF,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D;;8EAE8E;AAC9E,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,GAAa;IAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,MAAM,GAAG,aAAa;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,cAAc,GAAG,cAAc,CAAC;IAClE,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,IAAI,QAAQ,MAAM,4CAA4C,MAAM,SAAS,IAAI,EAAE,CAAC;IACxG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/optimizer/text.ts"],"names":[],"mappings":"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"}

package/dist/optimizer/types.d.ts

@@ -1,7 +1,9 @@
 /** Content categories the router can detect and the handlers produce.
  * "prose" is produced (not detected): short prose that took the sentence
- * anchor — its own TOIN kind so over-retrieval backs it off independently. */
-export type ContentType = "json" | "code" | "text" | "prose";
+ * anchor — its own TOIN kind so over-retrieval backs it off independently.
+ * "search" / "log" / "diff" are structured shapes with dedicated handlers
+ * (detected before the looser code heuristic). */
+export type ContentType = "json" | "code" | "text" | "prose" | "search" | "log" | "diff";
 /** Output of compressing one payload: the skeleton view + its CCR handle. */
 export interface CompressResult {
     /** The compressed, still-readable skeleton (carries the ⟨ccr:…⟩ handle). */

package/dist/platforms.d.ts

@@ -34,8 +34,18 @@ export declare const KNITBRAIN_HOOKS: {
 export declare function claudeArtifacts(cfg: SetupConfig): Artifact[];
 /** Cursor: .cursor/mcp.json + an always-on rules file. */
 export declare function cursorArtifacts(): Artifact[];
-/** VS Code (Copilot): .vscode/mcp.json (uses "servers" key) + instructions. */
+/** Copilot CLI: MCP config is global (~/.copilot) — print a snippet. The
+ * project-side .github/instructions file is shared with VS Code Copilot. */
+export declare function copilotSnippet(): string;
+/** VS Code (GitHub Copilot agent mode): .vscode/mcp.json (uses "servers"
+ * key) + .github/instructions — the native Copilot instruction surface. */
 export declare function vscodeArtifacts(): Artifact[];
+/** Windsurf: project rules are native; MCP config is global (snippet). */
+export declare function windsurfArtifacts(): Artifact[];
+/** Windsurf's MCP config lives in ~/.codeium/windsurf — never clobber it. */
+export declare function windsurfSnippet(): string;
+/** Zed: MCP servers live in global settings — print a snippet. */
+export declare function zedSnippet(): string;
 /** Codex CLI: global config — print a snippet rather than touching ~/.codex. */
 export declare function codexSnippet(cfg: SetupConfig): string;
 /**

package/dist/platforms.js

@@ -68,7 +68,16 @@ export function cursorArtifacts() {
         },
     ];
 }
-/** VS Code (Copilot): .vscode/mcp.json (uses "servers" key) + instructions. */
+/** Copilot CLI: MCP config is global (~/.copilot) — print a snippet. The
+ * project-side .github/instructions file is shared with VS Code Copilot. */
+export function copilotSnippet() {
+    return [
+        "# Add to ~/.copilot/mcp-config.json :",
+        '{ "mcpServers": { "knitbrain": { "type": "local", "command": "knitbrain", "tools": ["*"] } } }',
+    ].join("\n");
+}
+/** VS Code (GitHub Copilot agent mode): .vscode/mcp.json (uses "servers"
+ * key) + .github/instructions — the native Copilot instruction surface. */
 export function vscodeArtifacts() {
     return [
         { path: ".vscode/mcp.json", content: "", mode: "json-merge-mcp" },
@@ -79,6 +88,30 @@ export function vscodeArtifacts() {
         },
     ];
 }
+/** Windsurf: project rules are native; MCP config is global (snippet). */
+export function windsurfArtifacts() {
+    return [
+        {
+            path: ".windsurf/rules/knitbrain.md",
+            mode: "write",
+            content: `---\ntrigger: always_on\n---\n\n${NOTATION_GUIDE}\n\n${TERSE_MODE}\n`,
+        },
+    ];
+}
+/** Windsurf's MCP config lives in ~/.codeium/windsurf — never clobber it. */
+export function windsurfSnippet() {
+    return [
+        "# Add to ~/.codeium/windsurf/mcp_config.json :",
+        '{ "mcpServers": { "knitbrain": { "command": "knitbrain" } } }',
+    ].join("\n");
+}
+/** Zed: MCP servers live in global settings — print a snippet. */
+export function zedSnippet() {
+    return [
+        "# Add to Zed settings.json (cmd-,) :",
+        '"context_servers": { "knitbrain": { "command": { "path": "knitbrain" } } }',
+    ].join("\n");
+}
 /** Codex CLI: global config — print a snippet rather than touching ~/.codex. */
 export function codexSnippet(cfg) {
     return [

package/dist/platforms.js.map

@@ -1 +1 @@
-{"version":3,"file":"platforms.js","sourceRoot":"","sources":["../src/platforms.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"platforms.js","sourceRoot":"","sources":["../src/platforms.ts"],"names":[],"mappings":"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"}

package/dist/proxy/cache-aligner.d.ts

@@ -1,9 +1,30 @@
 /**
- * CacheAligner — stabilize the request's stable prefix (the system prompt) so
- * the provider's KV-cache hits across turns. We only do meaning-preserving
- * whitespace normalization (collapse trailing whitespace + blank-line runs);
- * the instruction text itself is never altered.
+ * CacheAligner — make the request's stable prefix actually stable, so the
+ * provider's KV-cache hits across turns.
+ *
+ * Three meaning-preserving levers:
+ *  1. whitespace normalization (collapse trailing whitespace + blank runs);
+ *  2. dynamic-content extraction — lines like "Today's date is 2026-06-11"
+ *     change every session and sit near the TOP of system prompts, breaking
+ *     byte-identity for everything after them. They move to a marked section
+ *     at the END of the prompt (content kept verbatim, position changes);
+ *  3. Anthropic cache_control breakpoints — inserted only when the client
+ *     didn't set its own (never fight the host's caching strategy).
+ *
+ * Compression upstream is deterministic (same text → same skeleton), so
+ * optimized history prefixes stay byte-stable turn over turn.
  */
 export declare function normalizePrefix(prefix: string): string;
 /** Stable content hash of the normalized prefix — for cache-hit metrics. */
 export declare function prefixHash(prefix: string): string;
+export interface AlignResult {
+    text: string;
+    /** Number of volatile lines moved to the tail section. */
+    moved: number;
+}
+/**
+ * Move volatile lines out of the prefix to a marked tail section. Content is
+ * preserved verbatim — only position changes — and the result is idempotent
+ * (already-aligned prompts pass through unchanged).
+ */
+export declare function alignDynamicContent(text: string): AlignResult;

package/dist/proxy/cache-aligner.js

@@ -1,9 +1,19 @@
 import { sha256 } from "../ccr/store.js";
 /**
- * CacheAligner — stabilize the request's stable prefix (the system prompt) so
- * the provider's KV-cache hits across turns. We only do meaning-preserving
- * whitespace normalization (collapse trailing whitespace + blank-line runs);
- * the instruction text itself is never altered.
+ * CacheAligner — make the request's stable prefix actually stable, so the
+ * provider's KV-cache hits across turns.
+ *
+ * Three meaning-preserving levers:
+ *  1. whitespace normalization (collapse trailing whitespace + blank runs);
+ *  2. dynamic-content extraction — lines like "Today's date is 2026-06-11"
+ *     change every session and sit near the TOP of system prompts, breaking
+ *     byte-identity for everything after them. They move to a marked section
+ *     at the END of the prompt (content kept verbatim, position changes);
+ *  3. Anthropic cache_control breakpoints — inserted only when the client
+ *     didn't set its own (never fight the host's caching strategy).
+ *
+ * Compression upstream is deterministic (same text → same skeleton), so
+ * optimized history prefixes stay byte-stable turn over turn.
  */
 export function normalizePrefix(prefix) {
     return prefix.replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n");
@@ -12,4 +22,35 @@ export function normalizePrefix(prefix) {
 export function prefixHash(prefix) {
     return sha256(normalizePrefix(prefix));
 }
+/**
+ * Strong volatile-line signals only: explicit "today/current date/time"
+ * phrasing, or a line that is mostly a timestamp/UUID. A date appearing
+ * inside instructions ("use ISO dates like 2024-01-01") stays put unless the
+ * phrasing marks it as session state.
+ */
+const DYNAMIC_LINE = /\b(today'?s? (date )?is|the current (date|time|month) is|current (date|time):|as of (today|now)[,:]|session id[:=]|generated at[:=]?)\b/i;
+const MOSTLY_TIMESTAMP = /^\s*[\d:T Z.+-]{8,40}\s*$|^\s*[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\s*$/i;
+const MARKER = "[session context — moved here so the prompt prefix stays cache-stable]";
+/**
+ * Move volatile lines out of the prefix to a marked tail section. Content is
+ * preserved verbatim — only position changes — and the result is idempotent
+ * (already-aligned prompts pass through unchanged).
+ */
+export function alignDynamicContent(text) {
+    if (text.includes(MARKER))
+        return { text, moved: 0 }; // already aligned (idempotent)
+    const lines = text.split("\n");
+    const stable = [];
+    const movedLines = [];
+    for (const line of lines) {
+        if (DYNAMIC_LINE.test(line) || MOSTLY_TIMESTAMP.test(line))
+            movedLines.push(line);
+        else
+            stable.push(line);
+    }
+    if (movedLines.length === 0)
+        return { text: normalizePrefix(text), moved: 0 };
+    const aligned = `${normalizePrefix(stable.join("\n")).replace(/\n+$/, "")}\n\n${MARKER}\n${movedLines.join("\n")}`;
+    return { text: aligned, moved: movedLines.length };
+}
 //# sourceMappingURL=cache-aligner.js.map

package/dist/proxy/cache-aligner.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-aligner.js","sourceRoot":"","sources":["../../src/proxy/cache-aligner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"cache-aligner.js","sourceRoot":"","sources":["../../src/proxy/cache-aligner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,YAAY,GAChB,0IAA0I,CAAC;AAC7I,MAAM,gBAAgB,GACpB,iGAAiG,CAAC;AAQpG,MAAM,MAAM,GAAG,wEAAwE,CAAC;AAExF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,+BAA+B;IAErF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC7E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAE9E,MAAM,OAAO,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AACrD,CAAC"}

package/dist/proxy/optimize-request.d.ts

@@ -27,6 +27,10 @@ export interface OptimizeOptions {
     minBlockChars?: number;
     /** Whether short-prose sentence anchoring may apply (TOIN-gated by callers). */
     allowProse?: boolean;
+    /** Wire protocol — enables provider-specific cache strategy (cache_control). */
+    provider?: "anthropic" | "openai";
+    /** CacheAligner master switch (default on). */
+    cacheAlign?: boolean;
 }
 export interface ProxyStats {
     originalTokens: number;
@@ -38,6 +42,12 @@ export interface ProxyStats {
     handles: string[];
     /** Content kind per compressed handle — lets callers feed TOIN (onCompress). */
     kinds: Record<string, ContentType>;
+    /** Volatile lines CacheAligner moved out of the system prefix. */
+    dynamicMoved: number;
+    /** Anthropic cache_control breakpoints we inserted (0 if client had its own). */
+    cacheBreakpoints: number;
+    /** Hash of the aligned system prefix — equal across turns ⇒ cache-hittable. */
+    prefixHash: string;
 }
 /**
  * Optimize an LLM request: protect the recent turns + the current intent +