somtum 2.3.0 → 3.1.0

package/dist/agents/claude_code.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from './types.js';
+export declare const claudeCode: AgentAdapter;
+//# sourceMappingURL=claude_code.d.ts.map

package/dist/agents/claude_code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_code.d.ts","sourceRoot":"","sources":["../../src/agents/claude_code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiH/C,eAAO,MAAM,UAAU,EAAE,YAKxB,CAAC"}

package/dist/agents/claude_code.js

@@ -0,0 +1,112 @@
+import { truncateToolInput, truncateToolResult } from './shared.js';
+const FILE_TOOL_NAMES = new Set(['Read', 'Edit', 'Write', 'NotebookEdit']);
+// Claude Code transcripts deliver tool results as user-role messages whose
+// content is tool_result blocks. Those are not real user prompts: treating
+// them as such splits prompt→response pairs at every tool call and pollutes
+// the cache. Detect them so they can be reclassified as role 'tool'.
+function isToolResultContent(content) {
+    if (!Array.isArray(content))
+        return false;
+    let sawToolResult = false;
+    for (const block of content) {
+        if (block == null || typeof block !== 'object')
+            continue;
+        const t = block.type;
+        if (t === 'tool_result')
+            sawToolResult = true;
+        else if (t === 'text')
+            return false;
+    }
+    return sawToolResult;
+}
+function extractFilesFromBlock(block) {
+    if (block == null || typeof block !== 'object')
+        return [];
+    const b = block;
+    if (b.type !== 'tool_use' || b.name === undefined)
+        return [];
+    if (!FILE_TOOL_NAMES.has(b.name))
+        return [];
+    const input = b.input;
+    const p = input?.file_path ?? input?.notebook_path;
+    return typeof p === 'string' && p.length > 0 ? [p] : [];
+}
+function coerceContent(content) {
+    if (typeof content === 'string')
+        return { text: content, files: [] };
+    if (Array.isArray(content)) {
+        const files = [];
+        const text = content
+            .map((block) => {
+            if (block == null)
+                return '';
+            if (typeof block === 'string')
+                return block;
+            if (typeof block === 'object' &&
+                'text' in block &&
+                typeof block.text === 'string') {
+                return block.text;
+            }
+            if (typeof block === 'object' &&
+                'type' in block &&
+                block.type === 'tool_use') {
+                const b = block;
+                files.push(...extractFilesFromBlock(block));
+                return `[tool_use ${b.name ?? ''} ${truncateToolInput(JSON.stringify(b.input ?? {}))}]`;
+            }
+            if (typeof block === 'object' &&
+                'type' in block &&
+                block.type === 'tool_result') {
+                const b = block;
+                return `[tool_result ${truncateToolResult(coerceContent(b.content).text)}]`;
+            }
+            return '';
+        })
+            .filter((s) => s.length > 0)
+            .join('\n');
+        return { text, files };
+    }
+    return { text: '', files: [] };
+}
+function parse(raw) {
+    const lines = raw.split(/\r?\n/).filter((l) => l.trim().length > 0);
+    const turns = [];
+    for (const line of lines) {
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // Meta lines (caveats, command wrappers) and sidechain (subagent) turns
+        // are not part of the main conversation.
+        if (obj.isMeta === true || obj.isSidechain === true)
+            continue;
+        let role = (obj.message?.role ?? obj.role ?? obj.type ?? 'user');
+        if (role !== 'user' && role !== 'assistant' && role !== 'system' && role !== 'tool')
+            continue;
+        const content = obj.message?.content ?? obj.content;
+        if (role === 'user' && isToolResultContent(content))
+            role = 'tool';
+        const { text, files } = coerceContent(content);
+        if (text.length === 0)
+            continue;
+        const turn = { role, text };
+        if (obj.timestamp)
+            turn.timestamp = obj.timestamp;
+        if (files.length > 0)
+            turn.files_touched = files;
+        turns.push(turn);
+    }
+    return turns;
+}
+// Claude Code is the fallback format: generic {role, content} JSONL parses
+// correctly through it, so detect() accepts anything.
+export const claudeCode = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    detect: () => true,
+    parse,
+};
+//# sourceMappingURL=claude_code.js.map

package/dist/agents/claude_code.js.map

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

package/dist/agents/codex.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from './types.js';
+export declare const codex: AgentAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/agents/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6K/C,eAAO,MAAM,KAAK,EAAE,YAMnB,CAAC"}

package/dist/agents/codex.js

@@ -0,0 +1,173 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { truncateToolInput, truncateToolResult } from './shared.js';
+// User-role blocks Codex injects itself: environment, AGENTS.md, permissions,
+// app state. Most are one <snake_case> tag wrapping the whole block, and new
+// ones keep appearing, so match that shape as well as the known prefixes.
+const INJECTED_PREFIXES = ['# AGENTS.md instructions', '<permissions'];
+const INJECTED_TAG_BLOCK = /^<([a-z]+(?:_[a-z]+)+)>[\s\S]*<\/\1>$/;
+// IDE extensions wrap the prompt as "# Context from my IDE setup: ...
+// ## My request for Codex:\n<prompt>". The heading text varies by version.
+const IDE_CONTEXT_PREFIX = '# Context from my IDE setup';
+const IDE_REQUEST_MARKER = /^## My request[^\n]*:\n/m;
+const PATCH_FILE_LINE = /^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm;
+function userText(blocks) {
+    const parts = [];
+    for (const b of blocks) {
+        const text = b.text?.trim();
+        if (!text)
+            continue;
+        if (INJECTED_PREFIXES.some((p) => text.startsWith(p)))
+            continue;
+        if (INJECTED_TAG_BLOCK.test(text))
+            continue;
+        if (text.startsWith(IDE_CONTEXT_PREFIX)) {
+            const m = IDE_REQUEST_MARKER.exec(text);
+            if (m)
+                parts.push(text.slice(m.index + m[0].length).trim());
+            continue;
+        }
+        parts.push(text);
+    }
+    return parts.join('\n');
+}
+function assistantText(blocks) {
+    return blocks
+        .map((b) => b.text ?? '')
+        .filter((t) => t.length > 0)
+        .join('\n');
+}
+function asText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === undefined || value === null)
+        return '';
+    return JSON.stringify(value);
+}
+function patchedFiles(patch) {
+    return [...patch.matchAll(PATCH_FILE_LINE)].map((m) => m[1].trim());
+}
+// Guardian reviews and other subagent threads get their own rollout file.
+// They are Codex talking to itself, not the user's session.
+function isSubagentSession(meta) {
+    const threadSource = meta['thread_source'];
+    if (typeof threadSource === 'string' && threadSource !== 'user')
+        return true;
+    return typeof meta['source'] === 'object' && meta['source'] !== null;
+}
+function toTurn(line) {
+    const p = line.payload ?? {};
+    let turn = null;
+    switch (p['type']) {
+        case 'message': {
+            const blocks = (Array.isArray(p['content']) ? p['content'] : []);
+            if (p['role'] === 'user') {
+                const text = userText(blocks);
+                if (text)
+                    turn = { role: 'user', text };
+            }
+            else if (p['role'] === 'assistant') {
+                const text = assistantText(blocks);
+                if (text)
+                    turn = { role: 'assistant', text };
+            }
+            break;
+        }
+        case 'function_call':
+            turn = {
+                role: 'assistant',
+                text: `[tool_use ${asText(p['name'])} ${truncateToolInput(asText(p['arguments']))}]`,
+            };
+            break;
+        case 'custom_tool_call': {
+            const input = asText(p['input']);
+            turn = {
+                role: 'assistant',
+                text: `[tool_use ${asText(p['name'])} ${truncateToolInput(input)}]`,
+            };
+            if (p['name'] === 'apply_patch') {
+                const files = patchedFiles(input);
+                if (files.length > 0)
+                    turn.files_touched = files;
+            }
+            break;
+        }
+        case 'function_call_output':
+        case 'custom_tool_call_output':
+            turn = { role: 'tool', text: `[tool_result ${truncateToolResult(asText(p['output']))}]` };
+            break;
+    }
+    if (turn && line.timestamp)
+        turn.timestamp = line.timestamp;
+    return turn;
+}
+function parse(raw) {
+    const turns = [];
+    for (const lineText of raw.split(/\r?\n/)) {
+        if (lineText.trim().length === 0)
+            continue;
+        let line;
+        try {
+            line = JSON.parse(lineText);
+        }
+        catch {
+            continue;
+        }
+        if (line.type === 'session_meta' && isSubagentSession(line.payload ?? {}))
+            return [];
+        if (line.type !== 'response_item')
+            continue;
+        const turn = toTurn(line);
+        if (turn)
+            turns.push(turn);
+    }
+    return turns;
+}
+function detect(raw) {
+    const nl = raw.indexOf('\n');
+    const firstLine = (nl === -1 ? raw : raw.slice(0, nl)).trim();
+    try {
+        const obj = JSON.parse(firstLine);
+        return ((obj.type === 'session_meta' || obj.type === 'response_item') &&
+            typeof obj.payload === 'object');
+    }
+    catch {
+        return false;
+    }
+}
+function sessionsDir() {
+    return join(process.env['CODEX_HOME'] ?? join(homedir(), '.codex'), 'sessions');
+}
+// Codex hooks may send transcript_path: null. Rollout filenames end in the
+// session id, so search the date folders newest-first.
+function findTranscript(sessionId) {
+    const root = sessionsDir();
+    if (!existsSync(root))
+        return null;
+    const suffix = `${sessionId}.jsonl`;
+    const newestFirst = (dir) => readdirSync(dir).sort().reverse();
+    try {
+        for (const y of newestFirst(root)) {
+            for (const m of newestFirst(join(root, y))) {
+                for (const d of newestFirst(join(root, y, m))) {
+                    const hit = readdirSync(join(root, y, m, d)).find((f) => f.endsWith(suffix));
+                    if (hit)
+                        return join(root, y, m, d, hit);
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export const codex = {
+    id: 'codex',
+    name: 'Codex',
+    detect,
+    parse,
+    findTranscript,
+};
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+import type { AgentAdapter, AgentId } from './types.js';
+export type { AgentAdapter, AgentId } from './types.js';
+export { AGENT_IDS } from './types.js';
+export declare function getAgent(id: AgentId): AgentAdapter;
+export declare function detectAgent(raw: string): AgentAdapter;
+export declare function findTranscript(sessionId: string): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIxD,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,CAIlD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAErD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D"}

package/dist/agents/index.js

@@ -0,0 +1,24 @@
+import { claudeCode } from './claude_code.js';
+import { codex } from './codex.js';
+export { AGENT_IDS } from './types.js';
+// Order matters: detect() runs in sequence and Claude Code accepts anything,
+// so it must stay last.
+const ADAPTERS = [codex, claudeCode];
+export function getAgent(id) {
+    const agent = ADAPTERS.find((a) => a.id === id);
+    if (!agent)
+        throw new Error(`Unknown agent: ${id}`);
+    return agent;
+}
+export function detectAgent(raw) {
+    return ADAPTERS.find((a) => a.detect(raw)) ?? claudeCode;
+}
+export function findTranscript(sessionId) {
+    for (const agent of ADAPTERS) {
+        const path = agent.findTranscript?.(sessionId);
+        if (path)
+            return path;
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,6EAA6E;AAC7E,wBAAwB;AACxB,MAAM,QAAQ,GAA4B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAE9D,MAAM,UAAU,QAAQ,CAAC,EAAW;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,UAAU,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agents/shared.d.ts

@@ -0,0 +1,3 @@
+export declare function truncateToolResult(text: string): string;
+export declare function truncateToolInput(text: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/agents/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/agents/shared.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/agents/shared.js

@@ -0,0 +1,18 @@
+// Tool results can be huge (full file dumps, command output). Keep enough for
+// the extractor to understand what happened without letting a single result
+// crowd real conversation out of the transcript token budget.
+const MAX_TOOL_RESULT_CHARS = 1000;
+export function truncateToolResult(text) {
+    if (text.length <= MAX_TOOL_RESULT_CHARS)
+        return text;
+    return `${text.slice(0, MAX_TOOL_RESULT_CHARS)}… [truncated]`;
+}
+// Tool-call arguments carry whole files (Write content, Edit strings, patches).
+// The extractor needs to know which tool ran on what, not the payload.
+const MAX_TOOL_INPUT_CHARS = 300;
+export function truncateToolInput(text) {
+    if (text.length <= MAX_TOOL_INPUT_CHARS)
+        return text;
+    return `${text.slice(0, MAX_TOOL_INPUT_CHARS)}… [truncated]`;
+}
+//# sourceMappingURL=shared.js.map

package/dist/agents/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/agents/shared.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,IAAI,CAAC,MAAM,IAAI,qBAAqB;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC;AAChE,CAAC;AAED,gFAAgF;AAChF,uEAAuE;AACvE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,IAAI,CAAC,MAAM,IAAI,oBAAoB;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,eAAe,CAAC;AAC/D,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,11 @@
+import type { Turn } from '../core/transcript.js';
+export type AgentId = 'claude-code' | 'codex';
+export declare const AGENT_IDS: readonly AgentId[];
+export interface AgentAdapter {
+    id: AgentId;
+    name: string;
+    detect(raw: string): boolean;
+    parse(raw: string): Turn[];
+    findTranscript?(sessionId: string): string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC;AAE9C,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAA6B,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;IAE3B,cAAc,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACnD"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export const AGENT_IDS = ['claude-code', 'codex'];
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC"}

package/dist/cli/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CA8NnE;AAED,wBAAsB,aAAa,CACjC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,MAAM,CAAC,CAuBjB"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAKD,wBAAgB,SAAS,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAmNnE;AAED,wBAAsB,aAAa,CACjC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/cli/doctor.js

@@ -1,11 +1,14 @@
 import { join } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
-import { execSync } from 'node:child_process';
 import { openDb, hasFts5, appliedVersions } from '../core/db.js';
 import { MemoryStore } from '../core/store.js';
 import { PromptCache } from '../core/cache.js';
 import { resolveProjectId } from '../core/project_id.js';
+import { pickBackend } from '../core/llm_backend.js';
+import { TokenLedger } from '../core/ledger.js';
 import { loadConfig, projectDir, GLOBAL_DIR, GLOBAL_CONFIG_PATH } from '../config.js';
+// Too few gated reads says nothing about whether gating pays off.
+const GATE_VERDICT_MIN_EVENTS = 10;
 export function runDoctor(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const checks = [];
@@ -80,40 +83,26 @@ export function runDoctor(opts = {}) {
                 ? `applied: [${applied.join(', ')}]`
                 : `missing migrations: [${missing.join(', ')}]`,
         });
-        // 7. Memory count + tokens saved
+        // 7. Memory count
         const store = new MemoryStore(db);
         const memCount = store.countByProject(projectId);
-        const saved = store.totalTokensSaved(projectId);
-        const spent = store.totalTokensSpent(projectId);
+        checks.push({ name: 'memories', ok: true, detail: `${memCount} memories` });
+        // 8. Metered token use, and whether file gating is paying for itself
+        const ledger = new TokenLedger(db).summary(projectId);
         checks.push({
-            name: 'memories',
+            name: 'token_overhead',
             ok: true,
-            detail: `${memCount} memories, ${saved} tokens saved, ${spent} tokens spent`,
+            detail: `${ledger.overhead_tokens} tokens metered (extraction ${ledger.extraction.tokens}, summaries ${ledger.file_summary.tokens}, injected ${ledger.injection.tokens}); see \`somtum stats\``,
         });
-        // 8. Breakeven ratio warning
-        if (spent > 0) {
-            const ratio = saved / spent;
-            const ok = ratio >= 1.5;
+        const gate = ledger.file_gate;
+        if (gate.denied.events >= GATE_VERDICT_MIN_EVENTS && gate.net_tokens < 0) {
             checks.push({
-                name: 'breakeven_ratio',
-                ok,
-                detail: `${ratio.toFixed(2)}x${ok ? '' : ' — below 1.5x, extraction cost may exceed savings'}`,
-                ...(ok
-                    ? {}
-                    : {
-                        fix: [
-                            'somtum config set retrieval.strategy bm25   # match what is actually running',
-                            '# or, to enable real hybrid retrieval:',
-                            'somtum config set retrieval.embeddings.enabled true && somtum reindex',
-                            '# or reduce injection overhead:',
-                            'somtum config set injection.k 2',
-                        ],
-                    }),
+                name: 'file_gating',
+                ok: false,
+                detail: `costing more than it saves: net ${gate.net_tokens} tokens over ${gate.denied.events} gated reads`,
+                fix: ['somtum config set file_gating.enabled false'],
             });
         }
-        else {
-            checks.push({ name: 'breakeven_ratio', ok: true, detail: 'n/a (no extraction cost yet)' });
-        }
         // 9. Stale memories: older than 90 days, never confirmed via retrieval
         const staleCount = store.countStale(projectId, 90);
         checks.push({
@@ -143,74 +132,72 @@ export function runDoctor(opts = {}) {
                 ? `enabled (model: ${config.retrieval.embeddings.model}) — run \`somtum reindex\` to embed missing`
                 : 'disabled (set retrieval.embeddings.enabled=true to enable)',
         });
-        // 11. Extraction auth: ANTHROPIC_API_KEY or claude CLI fallback
-        const apiKey = process.env['ANTHROPIC_API_KEY'];
-        const hasApiKey = Boolean(apiKey && apiKey.trim().length > 0);
-        let claudeCliAvailable = false;
-        if (!hasApiKey) {
-            try {
-                execSync('claude --version', { stdio: 'pipe' });
-                claudeCliAvailable = true;
-            }
-            catch {
-                // not in PATH
-            }
-        }
-        const apiKeyOk = hasApiKey || claudeCliAvailable;
+        // 11. Extraction backend: Anthropic credentials, claude CLI or codex CLI
+        const backend = pickBackend(config);
         checks.push({
-            name: 'api_key',
-            ok: apiKeyOk,
-            detail: hasApiKey
-                ? 'ANTHROPIC_API_KEY is set'
-                : claudeCliAvailable
-                    ? 'No ANTHROPIC_API_KEY — using claude CLI fallback (Claude Code subscription)'
-                    : 'Neither ANTHROPIC_API_KEY nor claude CLI available — extraction will fail',
-            ...(apiKeyOk
+            name: 'extraction_backend',
+            ok: backend !== null,
+            detail: backend
+                ? `${backend}${config.extraction.backend === 'auto' ? ' (auto)' : ''}`
+                : 'none available — extraction will fail',
+            ...(backend
                 ? {}
                 : {
                     fix: [
-                        'Fix A (Claude Code): which claude',
-                        '  If nothing prints, reinstall Claude Code or add its binary to PATH.',
-                        'Fix B (API key):     export ANTHROPIC_API_KEY="sk-ant-..." >> ~/.zshrc && source ~/.zshrc',
+                        'Claude Code: which claude   (reinstall or add it to PATH if nothing prints)',
+                        'Codex:       which codex',
+                        'API key:     export ANTHROPIC_API_KEY="sk-ant-..." >> ~/.zshrc && source ~/.zshrc',
                         'Docs: https://riz007.github.io/somtum/troubleshooting.html#memories-0',
                     ],
                 }),
         });
-        // 12. Hook files in .claude/settings.json
-        const settingsPath = join(cwd, '.claude', 'settings.json');
-        if (existsSync(settingsPath)) {
+        // 12. Hooks: Claude Code (.claude/settings.json) and/or Codex (.codex/hooks.json)
+        const hookFiles = [join('.claude', 'settings.json'), join('.codex', 'hooks.json')];
+        const installedIn = [];
+        const unreadable = [];
+        for (const rel of hookFiles) {
+            const path = join(cwd, rel);
+            if (!existsSync(path))
+                continue;
             try {
-                const raw = JSON.parse(readFileSync(settingsPath, 'utf8'));
-                const hooks = raw['hooks'];
-                const hasSessionEnd = hooks && JSON.stringify(hooks).includes('somtum');
-                checks.push({
-                    name: 'hooks_installed',
-                    ok: Boolean(hasSessionEnd),
-                    detail: hasSessionEnd
-                        ? 'somtum hooks found in .claude/settings.json'
-                        : 'somtum hooks not found — run `somtum init`',
-                    ...(hasSessionEnd
-                        ? {}
-                        : { fix: ['somtum init --all   # run from the project root you open with Claude Code'] }),
-                });
+                const hooks = JSON.parse(readFileSync(path, 'utf8'))['hooks'];
+                if (hooks && JSON.stringify(hooks).includes('somtum'))
+                    installedIn.push(rel);
             }
             catch {
-                checks.push({
-                    name: 'hooks_installed',
-                    ok: false,
-                    detail: 'could not parse .claude/settings.json',
-                    fix: ['somtum init --all'],
-                });
+                unreadable.push(rel);
             }
         }
-        else {
+        const claudeSettings = join(cwd, '.claude', 'settings.json');
+        const preReadInstalled = existsSync(claudeSettings) && readFileSync(claudeSettings, 'utf8').includes('hook pre_read');
+        if (preReadInstalled && !config.file_gating.enabled) {
             checks.push({
-                name: 'hooks_installed',
+                name: 'file_gating',
                 ok: false,
-                detail: '.claude/settings.json not found — run `somtum init`',
-                fix: ['somtum init --all   # run from the project root you open with Claude Code'],
+                detail: 'PreToolUse hook installed but file_gating.enabled is false (the default since v3.1)',
+                fix: [
+                    'somtum config set file_gating.enabled true   # keep using it; check `somtum stats` after a few sessions',
+                    '# or remove the PreToolUse somtum entry from .claude/settings.json',
+                ],
             });
         }
+        checks.push({
+            name: 'hooks_installed',
+            ok: installedIn.length > 0,
+            detail: installedIn.length > 0
+                ? `somtum hooks found in ${installedIn.join(', ')}`
+                : unreadable.length > 0
+                    ? `could not parse ${unreadable.join(', ')}`
+                    : 'no somtum hooks in .claude/settings.json or .codex/hooks.json',
+            ...(installedIn.length > 0
+                ? {}
+                : {
+                    fix: [
+                        'somtum init                  # Claude Code, from the project root',
+                        'somtum init --agent codex    # Codex, from the project root',
+                    ],
+                }),
+        });
     }
     finally {
         db.close();