token-optimizer-opencode 1.0.3

package/README.md

@@ -0,0 +1,127 @@
+# Token Optimizer for OpenCode
+
+Context quality scoring, smart compaction, and session continuity for [OpenCode](https://github.com/anomalyco/opencode). Full parity with the Claude Code Token Optimizer plugin.
+
+## What It Does
+
+Token Optimizer monitors your OpenCode sessions and helps you get the most out of your context window:
+
+- **7-signal quality scoring** with dual ResourceHealth (monotonic) + SessionEfficiency (rolling window) architecture
+- **Smart compaction** with mode-aware PRESERVE/DROP guidance (code/debug/review/infra/general)
+- **Session continuity** that restores context from prior sessions via keyword matching
+- **Quality nudges** that warn when context health drops, fill exceeds thresholds, or retry loops are detected
+- **Dashboard** with quality trends, session history, and daily aggregates
+- **`token_status` tool** for on-demand quality reports
+- **`token_dashboard` tool** to generate and open the visual dashboard
+
+## Install
+
+```bash
+opencode plugin token-optimizer-opencode
+```
+
+Or add it to your `opencode.json` (or `.opencode/opencode.jsonc`) plugin array:
+
+```jsonc
+{
+  "plugin": ["token-optimizer-opencode"]
+}
+```
+
+### Offline / no-npm install
+
+If you can't (or don't want to) install from npm, clone the repo and run the
+bundled installer. It builds a single-file plugin and copies it into
+`~/.config/opencode/plugins/`, which OpenCode auto-loads at startup:
+
+```bash
+git clone https://github.com/alexgreensh/token-optimizer.git
+token-optimizer/install.sh --opencode
+```
+
+Requires [bun](https://bun.sh) (OpenCode's own runtime). Re-run after a
+`git pull` to update.
+
+## Configure
+
+Add plugin options in `.opencode/opencode.jsonc`:
+
+```jsonc
+{
+  "plugin": [
+    ["token-optimizer-opencode", {
+      "qualityWindow": 20,
+      "features": {
+        "qualityNudges": true,
+        "loopDetection": true,
+        "smartCompaction": true,
+        "continuity": true,
+        "activityTracking": true,
+        "trends": true
+      }
+    }]
+  ]
+}
+```
+
+All options are optional. Defaults are shown above.
+
+## Environment Variables
+
+Override any threshold via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TOKEN_OPTIMIZER_QUALITY_WINDOW` | 20 | Rolling window size for ratio signals |
+| `TOKEN_OPTIMIZER_TOOL_CALL_WARN` | auto | Tool call warning threshold (scales with context window) |
+| `TOKEN_OPTIMIZER_TOOL_CALL_CRITICAL` | auto | Tool call critical threshold |
+| `TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_DAYS` | 7 | Days to keep checkpoints |
+| `TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_MAX` | 50 | Max checkpoints to scan for restore |
+| `TOKEN_OPTIMIZER_RELEVANCE_THRESHOLD` | 0.3 | Min relevance score for checkpoint restore |
+| `TOKEN_OPTIMIZER_NUDGES` | true | Enable quality nudges |
+| `TOKEN_OPTIMIZER_LOOP_DETECTION` | true | Enable retry loop detection |
+| `TOKEN_OPTIMIZER_SMART_COMPACTION` | true | Enable compaction context injection |
+| `TOKEN_OPTIMIZER_CONTINUITY` | true | Enable session continuity |
+| `TOKEN_OPTIMIZER_ACTIVITY` | true | Enable activity tracking |
+| `TOKEN_OPTIMIZER_TRENDS` | true | Enable trends collection |
+
+## Quality Scoring
+
+The quality score uses a dual-composite architecture:
+
+**ResourceHealth** (monotonic, can only decrease within a session):
+- Context fill degradation (50%) - MRCR-curve-based quality estimate
+- Compaction depth (30%) - information loss from repeated compaction
+- Absolute waste tokens (20%) - stale reads + bloated results
+
+**SessionEfficiency** (rolling window, can rise or fall):
+- Stale reads (30%) - re-reading files after writing them
+- Bloated results (30%) - large tool outputs never referenced
+- Decision density (20%) - ratio of substantive messages
+- Agent efficiency (20%) - agent dispatch result/prompt ratio
+
+Grades: S (90+), A (80+), B (70+), C (55+), D (40+), F (<40)
+
+## Hooks Used
+
+| Hook | Purpose |
+|------|---------|
+| `chat.message` | Track user messages, trigger quality scoring |
+| `tool.execute.before` | Record file reads |
+| `tool.execute.after` | Record tool results, file writes, agent dispatches, activity tracking |
+| `experimental.chat.system.transform` | Inject warnings, restore session continuity |
+| `experimental.session.compacting` | Inject mode-aware compaction guidance, capture checkpoint |
+| `experimental.compaction.autocontinue` | Reset signals post-compaction, refresh quality |
+| `event` | Handle session lifecycle (created/deleted) |
+
+## Model Support
+
+Context window sizes are mapped for 30+ models across all major providers:
+Anthropic (Opus/Sonnet 1M, Haiku 200K), OpenAI (GPT-5.x, GPT-4.1, o3/o4), Google (Gemini 2.x/3.x),
+DeepSeek, Qwen, Mistral, xAI Grok, and more.
+
+MRCR quality curves are calibrated per model family for accurate fill-degradation estimates.
+
+## License
+
+PolyForm Noncommercial 1.0.0

package/dist/activity/intel.d.ts

@@ -0,0 +1,10 @@
+/** Tool output at or above this size (chars) is treated as "large". */
+export declare const LARGE_OUTPUT_THRESHOLD = 8192;
+/**
+ * Rate-limit marker for large tool outputs, scoped to a single session's state.
+ * `recentSummaries` is mutated in place (it lives on the per-session state, so
+ * each session keeps its own cooldown). Returns true if the event was counted,
+ * false if the per-window cap is already reached.
+ */
+export declare function trackLargeOutputEvent(recentSummaries: number[]): boolean;
+//# sourceMappingURL=intel.d.ts.map

package/dist/activity/intel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intel.d.ts","sourceRoot":"","sources":["../../src/activity/intel.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAcxE"}

package/dist/activity/intel.js

@@ -0,0 +1,26 @@
+const MAX_SUMMARIES_PER_WINDOW = 3;
+const COOLDOWN_WINDOW_MS = 5 * 60 * 1000;
+/** Tool output at or above this size (chars) is treated as "large". */
+export const LARGE_OUTPUT_THRESHOLD = 8192;
+/**
+ * Rate-limit marker for large tool outputs, scoped to a single session's state.
+ * `recentSummaries` is mutated in place (it lives on the per-session state, so
+ * each session keeps its own cooldown). Returns true if the event was counted,
+ * false if the per-window cap is already reached.
+ */
+export function trackLargeOutputEvent(recentSummaries) {
+    const now = Date.now();
+    const cutoff = now - COOLDOWN_WINDOW_MS;
+    // Drop expired markers in place.
+    let w = 0;
+    for (let r = 0; r < recentSummaries.length; r++) {
+        if (recentSummaries[r] >= cutoff)
+            recentSummaries[w++] = recentSummaries[r];
+    }
+    recentSummaries.length = w;
+    if (recentSummaries.length >= MAX_SUMMARIES_PER_WINDOW)
+        return false;
+    recentSummaries.push(now);
+    return true;
+}
+//# sourceMappingURL=intel.js.map

package/dist/activity/intel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intel.js","sourceRoot":"","sources":["../../src/activity/intel.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzC,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAyB;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,GAAG,kBAAkB,CAAC;IAExC,iCAAiC;IACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,MAAM;YAAE,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IAE3B,IAAI,eAAe,CAAC,MAAM,IAAI,wBAAwB;QAAE,OAAO,KAAK,CAAC;IACrE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/activity/tracker.d.ts

@@ -0,0 +1,12 @@
+import type { SessionStore } from "../storage/session-store.js";
+export declare const isFileReadTool: (tool: string) => boolean;
+export declare const isFileWriteTool: (tool: string) => boolean;
+export declare const isAgentDispatchTool: (tool: string) => boolean;
+/** Read a file-path argument under either naming convention (filePath | file_path). */
+export declare function extractFilePath(args: unknown): string | null;
+export type ToolBucket = "edit" | "read" | "agent" | "mcp" | "bash_infra" | "bash_git" | "bash_install" | "bash_other" | "web" | "other";
+export type SessionMode = "code" | "debug" | "review" | "infra" | "general";
+export declare function classifyTool(toolName: string, command?: string): ToolBucket;
+export declare function detectMode(recentBuckets: ToolBucket[], hasRecentErrors?: boolean): SessionMode;
+export declare function logToolUse(store: SessionStore, toolName: string, command?: string, hasError?: boolean, resultSize?: number): SessionMode | null;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/activity/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/activity/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAmBhE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAoC,CAAC;AACnF,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OAA+B,CAAC;AAC/E,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,OAAyC,CAAC;AAE7F,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK5D;AAYD,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,YAAY,GACZ,UAAU,GACV,cAAc,GACd,YAAY,GACZ,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,UAAU,CAa/E;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,UAAU,EAAE,EAAE,eAAe,GAAE,OAAe,GAAG,WAAW,CAmBrG;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAW,EACpB,QAAQ,GAAE,OAAe,EACzB,UAAU,GAAE,MAAU,GACrB,WAAW,GAAG,IAAI,CAiCpB"}

package/dist/activity/tracker.js

@@ -0,0 +1,101 @@
+const WINDOW_SIZE = 10;
+const PRUNE_THRESHOLD = 30;
+const PRUNE_KEEP = 20;
+// Tool names span two ecosystems: Claude Code (PascalCase: Read/Write/Edit/Agent)
+// and OpenCode native (lowercase: read/write/edit/task/grep/glob/bash). Both must
+// be recognized or activity tracking silently no-ops on whichever host is in use.
+const EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "NotebookEdit", "file_write", "file_edit", "edit", "write"]);
+const READ_TOOLS = new Set(["Read", "Glob", "Grep", "file_read", "find", "read", "grep", "glob"]);
+const AGENT_TOOLS = new Set(["Agent", "TaskCreate", "TaskUpdate", "TaskGet", "TaskList", "task"]);
+// Focused sets for the hooks that record a single file path / dispatch. The
+// writers are exactly EDIT_TOOLS; reads/dispatches are narrower than the broad
+// classifier sets (no Glob/Grep, no Task* status tools).
+const FILE_READ_TOOLS = new Set(["Read", "file_read", "read"]);
+const AGENT_DISPATCH_TOOLS = new Set(["Agent", "TaskCreate", "task"]);
+export const isFileReadTool = (tool) => FILE_READ_TOOLS.has(tool);
+export const isFileWriteTool = (tool) => EDIT_TOOLS.has(tool);
+export const isAgentDispatchTool = (tool) => AGENT_DISPATCH_TOOLS.has(tool);
+/** Read a file-path argument under either naming convention (filePath | file_path). */
+export function extractFilePath(args) {
+    if (!args || typeof args !== "object")
+        return null;
+    const a = args;
+    const p = a.filePath ?? a.file_path;
+    return typeof p === "string" ? p : null;
+}
+// Module-level prune cadence: run the COUNT+DELETE only every PRUNE_THRESHOLD
+// calls instead of COUNT(*) on every single tool call (cheap, keeps the table
+// bounded). Shared across sessions, which only affects which call triggers a prune.
+let callsSincePrune = 0;
+const INFRA_BASH_RE = /\b(?:systemctl|nginx|docker|kubectl|service|daemon|launchctl|brew|apt|apt-get|yum|dnf|pacman)\b/;
+const GIT_WRITE_RE = /\bgit\s+(?:push|pull|merge|rebase|cherry-pick|tag)\b/;
+const INSTALL_RE = /\b(?:pip|npm|pnpm|yarn|bun|cargo|go)\s+(?:install|add|update|upgrade)\b/;
+export function classifyTool(toolName, command = "") {
+    if (EDIT_TOOLS.has(toolName))
+        return "edit";
+    if (READ_TOOLS.has(toolName))
+        return "read";
+    if (AGENT_TOOLS.has(toolName))
+        return "agent";
+    if (toolName.startsWith("mcp__") || toolName.startsWith("mcp_"))
+        return "mcp";
+    if (toolName === "Bash" || toolName === "shell" || toolName === "bash") {
+        if (INFRA_BASH_RE.test(command))
+            return "bash_infra";
+        if (GIT_WRITE_RE.test(command))
+            return "bash_git";
+        if (INSTALL_RE.test(command))
+            return "bash_install";
+        return "bash_other";
+    }
+    if (toolName === "WebSearch" || toolName === "WebFetch")
+        return "web";
+    return "other";
+}
+export function detectMode(recentBuckets, hasRecentErrors = false) {
+    if (recentBuckets.length < 3)
+        return "general";
+    const editCount = recentBuckets.filter((b) => b === "edit").length;
+    const readCount = recentBuckets.filter((b) => b === "read").length;
+    const infraCount = recentBuckets.filter((b) => b === "bash_infra" || b === "bash_git" || b === "bash_install").length;
+    const webCount = recentBuckets.filter((b) => b === "web").length;
+    const bashOther = recentBuckets.filter((b) => b === "bash_other").length;
+    if (infraCount >= 3)
+        return "infra";
+    if (hasRecentErrors && readCount >= 3 && editCount <= 1)
+        return "debug";
+    if (editCount >= 4)
+        return "code";
+    if (readCount >= 4 && editCount === 0)
+        return "review";
+    if (webCount >= 3)
+        return "review";
+    if (editCount >= 2 && (bashOther >= 2 || readCount >= 2))
+        return "code";
+    return "general";
+}
+export function logToolUse(store, toolName, command = "", hasError = false, resultSize = 0) {
+    try {
+        const bucket = classifyTool(toolName, command);
+        const db = store.connect();
+        db.run("INSERT INTO activity_log (tool_name, tool_bucket, has_error, result_size, timestamp) VALUES (?, ?, ?, ?, ?)", [toolName.slice(0, 64), bucket, hasError ? 1 : 0, resultSize, Date.now() / 1000]);
+        const rows = db
+            .query("SELECT tool_bucket, has_error FROM activity_log ORDER BY id DESC LIMIT ?")
+            .all(WINDOW_SIZE);
+        // Prune on a fixed cadence instead of COUNT(*) every call.
+        if (++callsSincePrune >= PRUNE_THRESHOLD) {
+            callsSincePrune = 0;
+            db.run("DELETE FROM activity_log WHERE id NOT IN (SELECT id FROM activity_log ORDER BY id DESC LIMIT ?)", [PRUNE_KEEP]);
+        }
+        const recentBuckets = rows.map((r) => r.tool_bucket);
+        const hasRecentErrors = rows.some((r) => r.has_error === 1);
+        const mode = detectMode(recentBuckets, hasRecentErrors);
+        store.setMeta("current_mode", mode);
+        return mode;
+    }
+    catch (e) {
+        console.warn("[Token Optimizer] logToolUse failed:", e);
+        return null;
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/activity/tracker.js.map

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

package/dist/compaction/checkpoint.d.ts

@@ -0,0 +1,17 @@
+import { type SessionStore } from "../storage/session-store.js";
+import type { SessionMode } from "../activity/tracker.js";
+import type { TokenOptimizerConfig } from "../util/env.js";
+export interface Checkpoint {
+    sessionId: string;
+    trigger: string;
+    mode: SessionMode;
+    qualityScore: number | null;
+    fillPct: number | null;
+    activeFiles: string[];
+    decisions: string[];
+    content: string;
+    createdAt: number;
+}
+export declare function captureCheckpoint(store: SessionStore, sessionId: string, trigger: string, mode: SessionMode, qualityScore: number | null, fillPct: number | null): Checkpoint;
+export declare function pruneCheckpoints(store: SessionStore, config: TokenOptimizerConfig): number;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/compaction/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/compaction/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,UAAU,CA6EZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAY1F"}

package/dist/compaction/checkpoint.js

@@ -0,0 +1,82 @@
+import { sanitizeSessionId } from "../storage/session-store.js";
+export function captureCheckpoint(store, sessionId, trigger, mode, qualityScore, fillPct) {
+    const recentReads = store.getRecentReads(20);
+    const recentWrites = store.getRecentWrites(20);
+    const allPaths = new Set();
+    for (const r of recentReads)
+        allPaths.add(r.path);
+    for (const w of recentWrites)
+        allPaths.add(w.path);
+    const activeFiles = [...allPaths].slice(0, 15);
+    const decisions = [];
+    const cachedData = store.getQualityCache()?.data;
+    if (cachedData) {
+        try {
+            const parsed = JSON.parse(cachedData);
+            if (Array.isArray(parsed.decisions)) {
+                decisions.push(...parsed.decisions.slice(0, 10));
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const safeSessionId = sanitizeSessionId(sessionId);
+    // This content is later injected into a system prompt, so neutralize anything
+    // that isn't plausibly part of a file path. Drop punctuation an attacker would
+    // use to smuggle instructions, collapse whitespace, and cap length.
+    const sanitizePath = (p) => p.replace(/[^a-zA-Z0-9 /._-]/g, "").replace(/\s+/g, " ").trim().slice(0, 512);
+    const lines = [
+        `# Checkpoint: ${trigger}`,
+        `Session: ${safeSessionId}`,
+        `Mode: ${mode}`,
+        `Quality: ${qualityScore !== null ? Math.round(qualityScore) : "N/A"}/100`,
+        `Fill: ${fillPct !== null ? Math.round(fillPct * 100) : "N/A"}%`,
+        "",
+        "## Active Files",
+        ...activeFiles.map((f) => `- ${sanitizePath(f)}`),
+    ];
+    if (decisions.length > 0) {
+        lines.push("", "## Decisions");
+        for (const d of decisions) {
+            lines.push(`- ${d.replace(/[\r\n]/g, " ").slice(0, 200)}`);
+        }
+    }
+    const content = lines.join("\n");
+    const db = store.connect();
+    db.run(`INSERT INTO checkpoints (session_id, trigger, mode, quality_score, fill_pct, active_files, decisions, content, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+        sessionId,
+        trigger,
+        mode,
+        qualityScore,
+        fillPct,
+        JSON.stringify(activeFiles),
+        JSON.stringify(decisions),
+        content,
+        Date.now() / 1000,
+    ]);
+    return {
+        sessionId,
+        trigger,
+        mode,
+        qualityScore,
+        fillPct,
+        activeFiles,
+        decisions,
+        content,
+        createdAt: Date.now() / 1000,
+    };
+}
+export function pruneCheckpoints(store, config) {
+    if (config.checkpointRetentionDays <= 0)
+        return 0;
+    const db = store.connect();
+    const cutoff = Date.now() / 1000 - config.checkpointRetentionDays * 86400;
+    // Always keep the 3 newest checkpoints, even if they're past the cutoff. A
+    // short retention window or a clock skew must never wipe the checkpoint we
+    // just wrote and need for continuity restore.
+    const result = db.run("DELETE FROM checkpoints WHERE created_at < ? AND id NOT IN (SELECT id FROM checkpoints ORDER BY created_at DESC LIMIT 3)", [cutoff]);
+    return result.changes;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/compaction/checkpoint.js.map

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

package/dist/compaction/dynamic-instructions.d.ts

@@ -0,0 +1,3 @@
+import type { SessionMode } from "../activity/tracker.js";
+export declare function generateCompactionContext(mode: SessionMode, activeFiles: string[], qualityScore: number | null, fillPct: number | null): string[];
+//# sourceMappingURL=dynamic-instructions.d.ts.map

package/dist/compaction/dynamic-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-instructions.d.ts","sourceRoot":"","sources":["../../src/compaction/dynamic-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA4C1D,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,EAAE,CAoBV"}

package/dist/compaction/dynamic-instructions.js

@@ -0,0 +1,54 @@
+const MODE_INSTRUCTIONS = {
+    code: [
+        "PRESERVE: All file paths edited or created in this session.",
+        "PRESERVE: Recent Edit/Write tool calls with their file paths and the intent behind each change.",
+        "PRESERVE: Build/test outcomes and any error patterns being investigated.",
+        "DROP: Full file contents already persisted to disk (keep paths, drop bodies).",
+        "DROP: Intermediate Read results for files that were subsequently edited.",
+    ].join("\n"),
+    debug: [
+        "PRESERVE: Error messages, stack traces, and exception types.",
+        "PRESERVE: Hypotheses tested and their outcomes (confirmed/rejected).",
+        "PRESERVE: Root cause analysis progress and remaining candidates.",
+        "DROP: Verbose log output already analyzed.",
+        "DROP: Read results for files confirmed not involved.",
+    ].join("\n"),
+    review: [
+        "PRESERVE: Files reviewed and findings per file.",
+        "PRESERVE: Code patterns flagged and severity assessments.",
+        "PRESERVE: Coverage notes and areas not yet reviewed.",
+        "DROP: Full file contents (keep paths and line references).",
+        "DROP: Grep/Glob results that were scanned but yielded no findings.",
+    ].join("\n"),
+    infra: [
+        "PRESERVE: Infrastructure commands executed and their outcomes.",
+        "PRESERVE: Service states, deployment steps completed.",
+        "PRESERVE: Configuration changes made and their locations.",
+        "DROP: Verbose command output already summarized.",
+        "DROP: Repeated status checks with identical output.",
+    ].join("\n"),
+    general: [
+        "PRESERVE: Key decisions and the reasoning behind them.",
+        "PRESERVE: Action items and commitments made.",
+        "PRESERVE: File paths mentioned as relevant to ongoing work.",
+        "DROP: Exploratory reads that did not inform decisions.",
+        "DROP: Verbose tool output already summarized.",
+    ].join("\n"),
+};
+export function generateCompactionContext(mode, activeFiles, qualityScore, fillPct) {
+    const context = [];
+    context.push(`[Token Optimizer] Session mode: ${mode}`);
+    context.push(MODE_INSTRUCTIONS[mode]);
+    if (activeFiles.length > 0) {
+        const sanitized = activeFiles.slice(0, 15).map((f) => f.replace(/[\r\n]/g, " ").slice(0, 256));
+        context.push(`Active files (PRESERVE paths): ${sanitized.join(", ")}`);
+    }
+    if (qualityScore !== null) {
+        context.push(`Context quality before compaction: ${Math.round(qualityScore)}/100`);
+    }
+    if (fillPct !== null && fillPct > 0.7) {
+        context.push("HIGH FILL WARNING: Aggressively drop verbose output and intermediate results.");
+    }
+    return context;
+}
+//# sourceMappingURL=dynamic-instructions.js.map

package/dist/compaction/dynamic-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-instructions.js","sourceRoot":"","sources":["../../src/compaction/dynamic-instructions.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAgC;IACrD,IAAI,EAAE;QACJ,6DAA6D;QAC7D,iGAAiG;QACjG,0EAA0E;QAC1E,+EAA+E;QAC/E,0EAA0E;KAC3E,CAAC,IAAI,CAAC,IAAI,CAAC;IAEZ,KAAK,EAAE;QACL,8DAA8D;QAC9D,sEAAsE;QACtE,kEAAkE;QAClE,4CAA4C;QAC5C,sDAAsD;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC;IAEZ,MAAM,EAAE;QACN,iDAAiD;QACjD,2DAA2D;QAC3D,sDAAsD;QACtD,4DAA4D;QAC5D,oEAAoE;KACrE,CAAC,IAAI,CAAC,IAAI,CAAC;IAEZ,KAAK,EAAE;QACL,gEAAgE;QAChE,uDAAuD;QACvD,2DAA2D;QAC3D,kDAAkD;QAClD,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC;IAEZ,OAAO,EAAE;QACP,wDAAwD;QACxD,8CAA8C;QAC9C,6DAA6D;QAC7D,wDAAwD;QACxD,+CAA+C;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,IAAiB,EACjB,WAAqB,EACrB,YAA2B,EAC3B,OAAsB;IAEtB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,OAAO,CAAC,IAAI,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,kCAAkC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/continuity/matcher.d.ts

@@ -0,0 +1,14 @@
+export declare function scoreRelevance(userPrompt: string, checkpointContent: string): number;
+export interface CheckpointMatch {
+    content: string;
+    score: number;
+    sessionId: string;
+    mode: string;
+}
+export declare function findBestCheckpoint(userPrompt: string, checkpoints: Array<{
+    session_id: string;
+    content: string;
+    mode: string;
+    created_at: number;
+}>, threshold: number, maxChars?: number): CheckpointMatch | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/continuity/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/continuity/matcher.ts"],"names":[],"mappings":"AAoBA,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAYpF;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7F,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAa,GACtB,eAAe,GAAG,IAAI,CAkBxB"}

package/dist/continuity/matcher.js

@@ -0,0 +1,57 @@
+const STOP_WORDS = new Set([
+    "the", "a", "an", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "shall",
+    "should", "may", "might", "must", "can", "could", "to", "of", "in",
+    "for", "on", "with", "at", "by", "from", "as", "into", "about",
+    "like", "through", "after", "over", "between", "out", "up", "down",
+    "that", "this", "it", "its", "my", "your", "his", "her", "we", "they",
+    "them", "what", "which", "who", "when", "where", "how", "not", "no",
+    "but", "or", "and", "if", "then", "so", "than", "too", "very", "just",
+    "i", "me", "let", "us",
+]);
+function extractKeywords(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_.-]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !STOP_WORDS.has(w));
+}
+export function scoreRelevance(userPrompt, checkpointContent) {
+    const promptKeywords = extractKeywords(userPrompt);
+    if (promptKeywords.length === 0)
+        return 0;
+    const contentLower = checkpointContent.toLowerCase();
+    let matches = 0;
+    for (const kw of promptKeywords) {
+        if (contentLower.includes(kw))
+            matches++;
+    }
+    return matches / promptKeywords.length;
+}
+function safeSlice(str, maxChars) {
+    if (str.length <= maxChars)
+        return str;
+    let end = maxChars;
+    const code = str.charCodeAt(end - 1);
+    if (code >= 0xd800 && code <= 0xdbff)
+        end--;
+    return str.slice(0, end) + "\n[... truncated]";
+}
+export function findBestCheckpoint(userPrompt, checkpoints, threshold, maxChars = 2000) {
+    let best = null;
+    let bestScore = 0;
+    for (const cp of checkpoints) {
+        const score = scoreRelevance(userPrompt, cp.content);
+        if (score > bestScore && score >= threshold) {
+            bestScore = score;
+            best = {
+                content: safeSlice(cp.content, maxChars),
+                score,
+                sessionId: cp.session_id,
+                mode: cp.mode,
+            };
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/continuity/matcher.js.map

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

package/dist/continuity/restore.d.ts

@@ -0,0 +1,4 @@
+import { type CheckpointMatch } from "./matcher.js";
+import type { TokenOptimizerConfig } from "../util/env.js";
+export declare function restoreCheckpoint(dataDir: string, userPrompt: string, currentSessionId: string, config: TokenOptimizerConfig): CheckpointMatch | null;
+//# sourceMappingURL=restore.d.ts.map

package/dist/continuity/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/continuity/restore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,oBAAoB,GAC3B,eAAe,GAAG,IAAI,CA4DxB"}

package/dist/continuity/restore.js

@@ -0,0 +1,53 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { Database } from "bun:sqlite";
+import { findBestCheckpoint } from "./matcher.js";
+import { sanitizeSessionId } from "../storage/session-store.js";
+export function restoreCheckpoint(dataDir, userPrompt, currentSessionId, config) {
+    if (!config.features.continuity)
+        return null;
+    const sessDir = join(dataDir, "token-optimizer", "sessions");
+    if (!existsSync(sessDir))
+        return null;
+    // DB filenames are the sanitized session id, so compare like-for-like or a
+    // session whose id contains special chars would fail to exclude its own file.
+    const safeCurrentId = sanitizeSessionId(currentSessionId);
+    const cutoff = config.checkpointRetentionDays <= 0
+        ? 0
+        : Date.now() / 1000 - config.checkpointRetentionDays * 86400;
+    const allCheckpoints = [];
+    try {
+        const allFiles = readdirSync(sessDir);
+        const dbFiles = allFiles.filter((f) => f.endsWith(".db")).slice(0, config.checkpointRetentionMax);
+        for (const file of dbFiles) {
+            const sessionId = file.replace(".db", "");
+            if (sessionId === safeCurrentId)
+                continue;
+            const dbPath = join(sessDir, file);
+            let db = null;
+            try {
+                db = new Database(dbPath, { readonly: true });
+                db.exec("PRAGMA busy_timeout=500");
+                const rows = db
+                    .query("SELECT session_id, content, mode, created_at FROM checkpoints WHERE created_at > ? ORDER BY created_at DESC LIMIT ?")
+                    .all(cutoff, config.checkpointRetentionMax);
+                allCheckpoints.push(...rows);
+            }
+            catch {
+                // skip corrupt/locked DBs
+            }
+            finally {
+                db?.close();
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    if (allCheckpoints.length === 0)
+        return null;
+    allCheckpoints.sort((a, b) => b.created_at - a.created_at);
+    const candidates = allCheckpoints.slice(0, config.checkpointRetentionMax);
+    return findBestCheckpoint(userPrompt, candidates, config.relevanceThreshold, config.checkpointMaxChars);
+}
+//# sourceMappingURL=restore.js.map