friction-log 0.0.0-stage → 0.6.0

package/dist/commands/init.js

@@ -0,0 +1,256 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { defaultConfigPath } from "../paths.js";
+export async function runInit(input = {}) {
+    const configPath = input.configPath ?? defaultConfigPath();
+    const detected = (input.detect ?? defaultDetect)();
+    const interactive = input.yes !== true;
+    const prompt = input.prompt ?? readlinePrompter();
+    const defaultSink = input.sink ??
+        (interactive
+            ? (await prompt.select("Default sink", [
+                "markdown-file",
+                "stdout-json",
+                "github-issues",
+                "agent-tasks",
+                "linear",
+            ], suggestSink(detected)))
+            : suggestSink(detected));
+    const configExistedBefore = existsSync(configPath);
+    const existing = configExistedBefore ? readFileSync(configPath, "utf8") : "";
+    const newConfig = mergeConfigYaml(existing, defaultSink, input.syncExport);
+    // Only write when the content actually changes; idempotency matters when
+    // init is run multiple times during onboarding.
+    let configWritten = false;
+    if (newConfig !== existing) {
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, newConfig, "utf8");
+        configWritten = true;
+    }
+    let stopHookWrittenTo = null;
+    const wantHook = input.installStopHook ??
+        (detected.claudeCodeSettingsPath !== null &&
+            (interactive
+                ? await prompt.confirm("Install friction-log scan as a Claude Code Stop-hook?", true)
+                : false));
+    if (wantHook && detected.claudeCodeSettingsPath) {
+        const path = detected.claudeCodeSettingsPath;
+        const before = existsSync(path) ? readFileSync(path, "utf8") : "{}";
+        const after = mergeStopHook(before);
+        if (after !== before) {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, after, "utf8");
+        }
+        stopHookWrittenTo = path;
+    }
+    return {
+        configPath,
+        configWritten,
+        configExistedBefore,
+        defaultSink,
+        stopHookWrittenTo,
+        detected,
+        nextSteps: buildNextSteps(defaultSink, configPath, stopHookWrittenTo, input.syncExport),
+    };
+}
+function suggestSink(d) {
+    if (d.agentTasksTokenPresent)
+        return "agent-tasks";
+    if (d.linearKeyPresent)
+        return "linear";
+    if (d.ghAvailable)
+        return "github-issues";
+    return "markdown-file";
+}
+function defaultDetect() {
+    const claudeHome = process.env.CLAUDE_HOME ?? join(homedir(), ".claude");
+    const settingsPath = join(claudeHome, "settings.json");
+    const claudeCodeSettingsPath = existsSync(claudeHome) ? settingsPath : null;
+    const which = spawnSync("which", ["gh"], { encoding: "utf8" });
+    const ghAvailable = which.status === 0 && Boolean((which.stdout ?? "").trim());
+    return {
+        claudeCodeSettingsPath,
+        ghAvailable,
+        linearKeyPresent: Boolean(process.env.LINEAR_API_KEY),
+        agentTasksTokenPresent: Boolean(process.env.AGENT_TASKS_TOKEN),
+    };
+}
+export function mergeConfigYaml(existingYaml, defaultSink, syncExport) {
+    // Parse as best-effort; if existing config is corrupt we still want init
+    // to land a clean default scaffolding rather than wedging the user.
+    let parsed = {};
+    if (existingYaml.trim()) {
+        try {
+            const tmp = parseYaml(existingYaml);
+            if (tmp && typeof tmp === "object" && !Array.isArray(tmp)) {
+                parsed = tmp;
+            }
+        }
+        catch {
+            parsed = {};
+        }
+    }
+    const sinks = parsed.sinks &&
+        typeof parsed.sinks === "object" &&
+        !Array.isArray(parsed.sinks)
+        ? parsed.sinks
+        : {};
+    if (!sinks[defaultSink]) {
+        sinks[defaultSink] = scaffoldForSink(defaultSink);
+    }
+    parsed.sinks = sinks;
+    parsed.default_sink = defaultSink;
+    // Opt-in only, and this is the ONLY place that writes sync_export: when
+    // `syncExport` is omitted (the default `init` path), any existing
+    // sync_export block in `parsed` is passed through untouched below since we
+    // never delete or overwrite the key. This is the fix for the drift bug
+    // where init.ts wrote `default_sink` but loadConfig never read it back:
+    // config.ts's loadConfig reads this exact `sync_export` shape (see
+    // parseSyncExportBlock).
+    if (syncExport) {
+        parsed.sync_export = {
+            path: syncExport.path,
+            origin: syncExport.origin,
+            ...(syncExport.peerPaths && syncExport.peerPaths.length
+                ? { peer_paths: syncExport.peerPaths }
+                : {}),
+        };
+    }
+    return stringifyYaml(parsed);
+}
+function scaffoldForSink(sink) {
+    switch (sink) {
+        case "markdown-file":
+            return {};
+        case "stdout-json":
+            return {};
+        case "github-issues":
+            return { repo: "owner/repo", labels: ["friction"] };
+        case "agent-tasks":
+            return {
+                mode: "rest",
+                apiBase: "https://agent-tasks.example.test",
+                projectId: "<uuid>",
+            };
+        case "linear":
+            return { teamId: "<team-uuid>", state: "Backlog" };
+    }
+}
+const STOP_HOOK = {
+    type: "command",
+    command: "friction-log scan --silent --stdin-payload",
+};
+export function mergeStopHook(existingJson) {
+    let parsed = {};
+    if (existingJson.trim()) {
+        try {
+            const tmp = JSON.parse(existingJson);
+            if (tmp && typeof tmp === "object" && !Array.isArray(tmp)) {
+                parsed = tmp;
+            }
+        }
+        catch {
+            parsed = {};
+        }
+    }
+    const hooks = parsed.hooks &&
+        typeof parsed.hooks === "object" &&
+        !Array.isArray(parsed.hooks)
+        ? parsed.hooks
+        : {};
+    const stopEntries = Array.isArray(hooks.Stop)
+        ? hooks.Stop
+        : [];
+    let group = stopEntries.find((e) => e && typeof e === "object" && (!("matcher" in e) || e.matcher === ""));
+    if (!group) {
+        group = { matcher: "", hooks: [] };
+        stopEntries.push(group);
+    }
+    const groupHooks = Array.isArray(group.hooks)
+        ? group.hooks
+        : [];
+    if (!groupHooks.some((h) => h?.command === STOP_HOOK.command)) {
+        groupHooks.push({ ...STOP_HOOK });
+    }
+    group.hooks = groupHooks;
+    hooks.Stop = stopEntries;
+    parsed.hooks = hooks;
+    return JSON.stringify(parsed, null, 2) + "\n";
+}
+function buildNextSteps(sink, configPath, stopHook, syncExport) {
+    const out = [];
+    out.push(`Configuration written to ${configPath}.`);
+    out.push(`Default sink: ${sink}.`);
+    if (stopHook) {
+        out.push(`Stop-hook installed at ${stopHook}; new sessions auto-scan on close.`);
+    }
+    else {
+        out.push(`Stop-hook not installed. Run "friction-log scan" manually at end of session, or re-run "init" later.`);
+    }
+    if (syncExport) {
+        out.push(`sync-export configured: origin=${syncExport.origin}, writes to ${syncExport.path} after every mutation.`);
+    }
+    out.push("Quick smoke:");
+    out.push(`  friction-log log --title "first friction" --tool "demo" --category tool-error`);
+    out.push(`  friction-log list`);
+    out.push(`  friction-log file 1 --sink ${sink}`);
+    return out;
+}
+/** Minimal readline-based prompter so init has no new runtime dep. */
+function readlinePrompter() {
+    return {
+        async select(question, choices, def) {
+            const rl = await loadReadline();
+            try {
+                const list = choices
+                    .map((c, i) => `  ${i + 1}) ${c}${c === def ? " (default)" : ""}`)
+                    .join("\n");
+                const prompt = `${question}\n${list}\nChoice [${def ?? choices[0]}]: `;
+                const raw = (await rl.question(prompt)).trim();
+                if (!raw)
+                    return def ?? choices[0];
+                const asIdx = Number(raw);
+                if (Number.isInteger(asIdx) && asIdx >= 1 && asIdx <= choices.length) {
+                    return choices[asIdx - 1];
+                }
+                if (choices.includes(raw))
+                    return raw;
+                process.stderr.write(`(invalid choice "${raw}"; using ${def ?? choices[0]})\n`);
+                return def ?? choices[0];
+            }
+            finally {
+                rl.close();
+            }
+        },
+        async confirm(question, def = true) {
+            const rl = await loadReadline();
+            try {
+                const hint = def ? "Y/n" : "y/N";
+                const raw = (await rl.question(`${question} [${hint}]: `))
+                    .trim()
+                    .toLowerCase();
+                if (!raw)
+                    return def;
+                if (raw === "y" || raw === "yes")
+                    return true;
+                if (raw === "n" || raw === "no")
+                    return false;
+                return def;
+            }
+            finally {
+                rl.close();
+            }
+        },
+    };
+}
+async function loadReadline() {
+    const readline = await import("node:readline/promises");
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,16 @@
+import type { Friction, FrictionSource, FrictionStatus } from "../types.js";
+export interface ListCommandInput {
+    status?: FrictionStatus;
+    tool?: string;
+    category?: string;
+    source?: FrictionSource;
+    age?: string;
+    limit?: number;
+    dbPath?: string;
+}
+export interface ListCommandOutput {
+    frictions: Friction[];
+}
+export declare function parseAge(age: string | undefined, now?: Date): string | undefined;
+export declare function runList(input: ListCommandInput): ListCommandOutput;
+export declare function formatTable(frictions: Friction[]): string;

package/dist/commands/list.js

@@ -0,0 +1,57 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+const AGE_PATTERN = /^(\d+)([dwh])$/;
+export function parseAge(age, now = new Date()) {
+    if (!age)
+        return undefined;
+    const match = AGE_PATTERN.exec(age);
+    if (!match) {
+        throw new Error(`friction-log: invalid --age "${age}". Use e.g. 14d, 4w, 12h`);
+    }
+    const n = Number(match[1]);
+    const unit = match[2];
+    const ms = unit === "h"
+        ? n * 3600_000
+        : unit === "d"
+            ? n * 86_400_000
+            : n * 7 * 86_400_000;
+    return new Date(now.getTime() - ms).toISOString();
+}
+export function runList(input) {
+    const db = new FrictionDb(input.dbPath ?? defaultDbPath());
+    try {
+        const filter = {
+            status: input.status,
+            tool: input.tool,
+            category: input.category,
+            source: input.source,
+            sinceIso: parseAge(input.age),
+            limit: input.limit,
+        };
+        return { frictions: db.listFrictions(filter) };
+    }
+    finally {
+        db.close();
+    }
+}
+export function formatTable(frictions) {
+    if (frictions.length === 0)
+        return "(no frictions match)";
+    const header = ["id", "status", "tool", "category", "captured", "title"];
+    const rows = frictions.map((f) => [
+        String(f.id),
+        f.status,
+        f.toolSurface ?? "-",
+        f.category ?? "-",
+        f.capturedAt.slice(0, 16).replace("T", " "),
+        truncate(f.title, 60),
+    ]);
+    const widths = header.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+    const sep = widths.map((w) => "-".repeat(w)).join("  ");
+    const fmt = (row) => row.map((c, i) => c.padEnd(widths[i])).join("  ");
+    return [fmt(header), sep, ...rows.map(fmt)].join("\n");
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 1) + "…";
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/log.d.ts

@@ -0,0 +1,18 @@
+import type { Severity } from "../types.js";
+export interface LogCommandInput {
+    title: string;
+    description?: string;
+    tool?: string;
+    category?: string;
+    severity?: Severity;
+    sessionId?: string;
+    recurrenceOfId?: number;
+    dbPath?: string;
+    configPath?: string;
+}
+export interface LogCommandOutput {
+    id: number;
+    capturedAt: string;
+    recurrenceOfId: number | null;
+}
+export declare function runLog(input: LogCommandInput): LogCommandOutput;

package/dist/commands/log.js

@@ -0,0 +1,52 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { maybeSyncExport } from "./sync-export.js";
+export function runLog(input) {
+    const dbPath = input.dbPath ?? defaultDbPath();
+    const db = new FrictionDb(dbPath);
+    try {
+        if (input.recurrenceOfId !== undefined) {
+            const parent = db.getFriction(input.recurrenceOfId);
+            if (!parent) {
+                throw new Error(`friction-log: --recurrence-of ${input.recurrenceOfId} does not match any friction`);
+            }
+        }
+        // Normalise empty string to null so a `--session ''` (or a wrapper
+        // that always passes the flag with a possibly-empty value) does not
+        // sneak past the upsert and then trip the FK on the friction insert.
+        const sessionId = typeof input.sessionId === "string" && input.sessionId !== ""
+            ? input.sessionId
+            : null;
+        // Sessions row must exist before the friction insert, otherwise the
+        // frictions.session_id FK violates and the log path exits 1 with a
+        // raw SQLite error. The common case is an agent attributing a
+        // mid-session friction to its live runtime session id (e.g.
+        // $CLAUDE_CODE_SESSION_ID) which was never imported. Upsert a
+        // placeholder so the call just works; a later `friction-log import`
+        // or `scan` overwrites it with full metadata via `upsertSession`.
+        if (sessionId !== null) {
+            db.ensureSession(sessionId);
+        }
+        const insert = {
+            title: input.title,
+            description: input.description ?? null,
+            toolSurface: input.tool ?? null,
+            category: input.category ?? null,
+            severity: input.severity ?? null,
+            sessionId,
+            recurrenceOfId: input.recurrenceOfId ?? null,
+            source: "manual",
+        };
+        const f = db.insertFriction(insert);
+        maybeSyncExport({ dbPath, configPath: input.configPath });
+        return {
+            id: f.id,
+            capturedAt: f.capturedAt,
+            recurrenceOfId: f.recurrenceOfId,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/commands/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/commands/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoBnD,MAAM,UAAU,MAAM,CAAC,KAAsB;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,CAAC,cAAc,8BAA8B,CACpF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,mEAAmE;QACnE,oEAAoE;QACpE,qEAAqE;QACrE,MAAM,SAAS,GACb,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,EAAE;YAC3D,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,IAAI,CAAC;QACX,oEAAoE;QACpE,mEAAmE;QACnE,8DAA8D;QAC9D,4DAA4D;QAC5D,8DAA8D;QAC9D,oEAAoE;QACpE,kEAAkE;QAClE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,MAAM,GAAwB;YAClC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;YAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,SAAS;YACT,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;YAC5C,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,cAAc,EAAE,CAAC,CAAC,cAAc;SACjC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/commands/rm.d.ts

@@ -0,0 +1,9 @@
+export interface RmCommandInput {
+    frictionId: number;
+    dbPath?: string;
+    configPath?: string;
+}
+export interface RmCommandOutput {
+    removed: boolean;
+}
+export declare function runRm(input: RmCommandInput): RmCommandOutput;

package/dist/commands/rm.js

@@ -0,0 +1,22 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { maybeSyncExport } from "./sync-export.js";
+export function runRm(input) {
+    const dbPath = input.dbPath ?? defaultDbPath();
+    const db = new FrictionDb(dbPath);
+    try {
+        const friction = db.getFriction(input.frictionId);
+        if (!friction) {
+            throw new Error(`friction-log: friction id=${input.frictionId} not found`);
+        }
+        const removed = db.deleteFriction(input.frictionId);
+        if (removed) {
+            maybeSyncExport({ dbPath, configPath: input.configPath });
+        }
+        return { removed };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=rm.js.map

package/dist/commands/rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../src/commands/rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAYnD,MAAM,UAAU,KAAK,CAAC,KAAqB;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,CAAC,UAAU,YAAY,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,25 @@
+import type { Friction } from "../types.js";
+export interface ScanCommandInput {
+    sessionId?: string;
+    transcriptPath?: string;
+    adapter?: string;
+    dbPath?: string;
+    configPath?: string;
+}
+export interface ScanCommandOutput {
+    sessionId: string;
+    candidatesFound: number;
+    inserted: number;
+    skippedDuplicates: number;
+    adapter: string;
+}
+export declare function runScan(input: ScanCommandInput): Promise<ScanCommandOutput>;
+export interface StopHookPayload {
+    session_id?: string;
+    sessionId?: string;
+    transcript_path?: string;
+    transcriptPath?: string;
+}
+export declare function payloadToScanInput(payload: StopHookPayload, adapter?: string): ScanCommandInput;
+export declare function summarize(output: ScanCommandOutput, sessionId: string): string;
+export { Friction };

package/dist/commands/scan.js

@@ -0,0 +1,73 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { loadScanner } from "../scanners/index.js";
+import { maybeSyncExport } from "./sync-export.js";
+export async function runScan(input) {
+    const adapterName = input.adapter ?? "claude-code";
+    const scanner = loadScanner(adapterName);
+    const result = await scanner.scan({
+        sessionId: input.sessionId,
+        transcriptPath: input.transcriptPath,
+    });
+    const dbPath = input.dbPath ?? defaultDbPath();
+    const db = new FrictionDb(dbPath);
+    try {
+        db.upsertSession({
+            id: result.session.id,
+            startedAt: result.session.startedAt,
+            endedAt: result.session.endedAt,
+            projectPaths: result.session.projectPaths ?? null,
+            transcriptPath: result.session.transcriptPath ?? null,
+            adapter: result.session.adapter ?? adapterName,
+        });
+        let inserted = 0;
+        let skipped = 0;
+        for (const c of result.frictionCandidates) {
+            const existing = db.findFrictionByTriple(result.session.id, c.toolSurface ?? null, c.title);
+            if (existing) {
+                skipped++;
+                continue;
+            }
+            const insert = {
+                sessionId: result.session.id,
+                toolSurface: c.toolSurface ?? null,
+                title: c.title,
+                description: c.description ?? null,
+                severity: c.severity ?? null,
+                category: c.category ?? null,
+                source: "scan",
+            };
+            db.insertFriction(insert);
+            inserted++;
+        }
+        // Skip write-through entirely when nothing was actually inserted (all
+        // candidates were duplicates, or there were none): the export payload
+        // only carries frictions, so a session-only upsert with zero new
+        // frictions can never change its content anyway.
+        if (inserted > 0) {
+            maybeSyncExport({ dbPath, configPath: input.configPath });
+        }
+        return {
+            sessionId: result.session.id,
+            candidatesFound: result.frictionCandidates.length,
+            inserted,
+            skippedDuplicates: skipped,
+            adapter: adapterName,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+export function payloadToScanInput(payload, adapter) {
+    return {
+        sessionId: payload.session_id ?? payload.sessionId,
+        transcriptPath: payload.transcript_path ?? payload.transcriptPath,
+        adapter,
+    };
+}
+export function summarize(output, sessionId) {
+    return (`scanned session=${sessionId} adapter=${output.adapter} ` +
+        `candidates=${output.candidatesFound} inserted=${output.inserted} skipped=${output.skippedDuplicates}`);
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/commands/search.d.ts

@@ -0,0 +1,15 @@
+import type { Friction, FrictionSource, FrictionStatus } from "../types.js";
+export interface SearchCommandInput {
+    query: string;
+    status?: FrictionStatus;
+    tool?: string;
+    category?: string;
+    source?: FrictionSource;
+    age?: string;
+    limit?: number;
+    dbPath?: string;
+}
+export interface SearchCommandOutput {
+    frictions: Friction[];
+}
+export declare function runSearch(input: SearchCommandInput): SearchCommandOutput;

package/dist/commands/search.js

@@ -0,0 +1,37 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { parseAge } from "./list.js";
+export function runSearch(input) {
+    if (!input.query || !input.query.trim()) {
+        throw new Error("friction-log: search query must not be empty");
+    }
+    const db = new FrictionDb(input.dbPath ?? defaultDbPath());
+    try {
+        const filter = {
+            status: input.status,
+            tool: input.tool,
+            category: input.category,
+            source: input.source,
+            sinceIso: parseAge(input.age),
+            limit: input.limit,
+        };
+        try {
+            return { frictions: db.searchFrictions(input.query, filter) };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // better-sqlite3 surfaces FTS5 parse failures as opaque SQLite errors
+            // ("unterminated string", "fts5: syntax error near ...", etc). The
+            // surrounding query is parameterized, so any error here is the user's
+            // MATCH expression. Turn it into a hint pointing at the FTS5 docs.
+            if (/fts5|MATCH|unterminated|syntax error|near "/i.test(msg)) {
+                throw new Error(`friction-log: invalid FTS5 query "${input.query}". See https://sqlite.org/fts5.html#full_text_query_syntax`);
+            }
+            throw err;
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAiBrC,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAwB;YAClC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;QACF,IAAI,CAAC;YACH,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,sEAAsE;YACtE,mEAAmE;YACnE,sEAAsE;YACtE,mEAAmE;YACnE,IAAI,8CAA8C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,qCAAqC,KAAK,CAAC,KAAK,4DAA4D,CAC7G,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}