friction-log 0.0.0-stage → 0.6.0

package/dist/commands/sync-export.d.ts

@@ -0,0 +1,46 @@
+import { type FrictionLogConfig } from "../config.js";
+export interface SyncExportCommandInput {
+    dbPath?: string;
+    configPath?: string;
+}
+export interface SyncExportCommandOutput {
+    path: string;
+    origin: string;
+    count: number;
+}
+/**
+ * `friction-log sync-export`: explicit, on-demand write of the full
+ * deterministic export. Throws (CLI exits non-zero) when `sync_export` is
+ * not configured, since the whole point of calling this verb is to produce
+ * the file; unlike the write-through helper below, silence would be
+ * surprising here.
+ */
+export declare function runSyncExport(input?: SyncExportCommandInput): SyncExportCommandOutput;
+/**
+ * Write-through helper: called after a successful mutation from each of the
+ * six mutating commands (log, scan, import, update, rm, file). Config-gated
+ * exact no-op when `sync_export` is not configured, so existing users see
+ * zero behavior change.
+ *
+ * Config loading happens INSIDE this function's own try/catch, not at the
+ * call site: the friction row is already committed by the time any of the
+ * six commands calls this, so a config-load failure (a malformed
+ * config.yml, even one with no `sync_export` block at all; or a half-set
+ * FRICTION_LOG_SYNC_EXPORT_* env pair) must degrade to the same stderr
+ * warning as a write failure, never propagate and crash the command. A
+ * crash here previously meant the mutation had already succeeded but the
+ * CLI reported failure, inviting a retry that would duplicate the row.
+ *
+ * Two ways to call it: pass `configPath` (log, scan, import, update, rm,
+ * none of which need the config for anything else) or an already-loaded
+ * `config` (file.ts, which needs it beforehand anyway to merge sink
+ * options, and would otherwise load it twice).
+ */
+export declare function maybeSyncExport(params: {
+    dbPath: string;
+    configPath?: string;
+}): void;
+export declare function maybeSyncExport(params: {
+    dbPath: string;
+    config: FrictionLogConfig;
+}): void;

package/dist/commands/sync-export.js

@@ -0,0 +1,80 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { loadConfig, } from "../config.js";
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { frictionToExport } from "./export.js";
+/**
+ * `friction-log sync-export`: explicit, on-demand write of the full
+ * deterministic export. Throws (CLI exits non-zero) when `sync_export` is
+ * not configured, since the whole point of calling this verb is to produce
+ * the file; unlike the write-through helper below, silence would be
+ * surprising here.
+ */
+export function runSyncExport(input = {}) {
+    const config = loadConfig(input.configPath);
+    if (!config.syncExport) {
+        throw new Error('friction-log: sync-export requires a "sync_export" block (path + origin) in config.yml, or the ' +
+            "FRICTION_LOG_SYNC_EXPORT_PATH / FRICTION_LOG_SYNC_EXPORT_ORIGIN env vars");
+    }
+    const dbPath = input.dbPath ?? defaultDbPath();
+    const count = writeSyncExportFile(dbPath, config.syncExport);
+    return {
+        path: config.syncExport.path,
+        origin: config.syncExport.origin,
+        count,
+    };
+}
+export function maybeSyncExport(params) {
+    const { dbPath } = params;
+    try {
+        const config = params.config ?? loadConfig(params.configPath);
+        if (!config.syncExport)
+            return;
+        writeSyncExportFile(dbPath, config.syncExport);
+    }
+    catch (err) {
+        process.stderr.write(`friction-log: warning: sync-export write-through failed: ${err.message}\n`);
+    }
+}
+function writeSyncExportFile(dbPath, cfg) {
+    const db = new FrictionDb(dbPath);
+    try {
+        const frictions = db.listAllFrictionsForSyncExport();
+        const records = frictions.map((f) => ({
+            ...frictionToExport(f),
+            tags: db.tagsFor(f.id),
+        }));
+        // Fixed key order ({ origin, records }, ExportRecord fields always built
+        // in the same order by frictionToExport) and no exportedAt/timestamp
+        // field: two runs with no intervening mutation produce byte-identical
+        // JSON, which is exploited immediately below to skip the write (and the
+        // mtime bump) entirely when nothing actually changed.
+        const payload = { origin: cfg.origin, records };
+        const json = JSON.stringify(payload, null, 2) + "\n";
+        let existing = null;
+        try {
+            existing = readFileSync(cfg.path, "utf8");
+        }
+        catch {
+            existing = null;
+        }
+        if (existing !== json) {
+            mkdirSync(dirname(cfg.path), { recursive: true });
+            // Atomic write: write to a same-directory tmp file, then rename over
+            // the real path, so a reader (or a sync tool) never observes a
+            // partially-written file.
+            // PID suffix: two concurrent writers sharing one config (Stop-hook
+            // scan racing an operator-run command) must not share a temp file,
+            // or the rename can publish a mix of two snapshots.
+            const tmpPath = `${cfg.path}.${process.pid}.tmp`;
+            writeFileSync(tmpPath, json, "utf8");
+            renameSync(tmpPath, cfg.path);
+        }
+        return records.length;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=sync-export.js.map

package/dist/commands/sync-export.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,12 @@
+import type { FrictionStatus } from "../types.js";
+export interface UpdateCommandInput {
+    frictionId: number;
+    status: FrictionStatus;
+    dbPath?: string;
+    configPath?: string;
+}
+export interface UpdateCommandOutput {
+    id: number;
+    status: FrictionStatus;
+}
+export declare function runUpdate(input: UpdateCommandInput): UpdateCommandOutput;

package/dist/commands/update.js

@@ -0,0 +1,24 @@
+import { FrictionDb } from "../db.js";
+import { defaultDbPath } from "../paths.js";
+import { maybeSyncExport } from "./sync-export.js";
+export function runUpdate(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`);
+        }
+        db.updateFrictionStatus(input.frictionId, input.status);
+        // Skip write-through when the status did not actually change (the
+        // export payload's status field would be identical either way).
+        if (friction.status !== input.status) {
+            maybeSyncExport({ dbPath, configPath: input.configPath });
+        }
+        return { id: input.frictionId, status: input.status };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.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;AAenD,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,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,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,kEAAkE;QAClE,gEAAgE;QAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACrC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACxD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+export type SinkConfig = Record<string, unknown>;
+/**
+ * Config-gated write-through + read-only peer merge. Absent this block,
+ * `sync-export` and the per-mutation write-through are exact no-ops (see
+ * commands/sync-export.ts). `peerPaths` are files written by OTHER machines'
+ * own `sync_export.path` (or write-through); `digest --include-peers` reads
+ * them read-only. Transport between machines (Dropbox, iCloud,
+ * agent-memory-sync, ...) is out of scope for this package.
+ */
+export interface SyncExportConfig {
+    path: string;
+    origin: string;
+    peerPaths: string[];
+}
+export interface FrictionLogConfig {
+    sinks: Record<string, SinkConfig>;
+    syncExport?: SyncExportConfig;
+}
+export declare function loadConfig(path?: string): FrictionLogConfig;
+/**
+ * Merge per-sink config with CLI overrides. CLI wins on key collision so a
+ * one-off `--sink-opt repo=other/repo` overrides the config's default repo.
+ */
+export declare function mergeSinkOpts(configSection: SinkConfig | undefined, cliOverrides: SinkConfig | undefined): SinkConfig;
+/**
+ * Parse repeated `--sink-opt key=value` CLI flags into a SinkConfig.
+ * Values are coerced from string with cheap heuristics: comma-separated lists
+ * become arrays, "true"/"false" become booleans, integers become numbers. To
+ * keep a literal that looks like a list/number, prefix with `s:`.
+ */
+export declare function parseSinkOpts(pairs: string[]): SinkConfig;

package/dist/config.js

@@ -0,0 +1,145 @@
+import { readFileSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
+import { defaultConfigPath, syncExportOriginOverride, syncExportPathOverride, } from "./paths.js";
+const EMPTY_CONFIG = { sinks: {} };
+export function loadConfig(path = defaultConfigPath()) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        // ENOENT is the common case: the user has not created a config file. Any
+        // other error (permission, bad symlink) is worth surfacing so we don't
+        // silently fall back to defaults when the user thinks they have a config.
+        if (err.code === "ENOENT") {
+            return applySyncExportEnvOverrides(EMPTY_CONFIG);
+        }
+        throw new Error(`friction-log: failed to read config file ${path}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`friction-log: failed to parse YAML in ${path}: ${err.message}`);
+    }
+    if (parsed == null)
+        return applySyncExportEnvOverrides(EMPTY_CONFIG);
+    if (typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`friction-log: config at ${path} must be a YAML mapping at the top level`);
+    }
+    const root = parsed;
+    const sinksRaw = root.sinks;
+    const sinks = {};
+    if (sinksRaw != null) {
+        if (typeof sinksRaw !== "object" || Array.isArray(sinksRaw)) {
+            throw new Error(`friction-log: config at ${path} has a non-mapping "sinks" value`);
+        }
+        for (const [name, value] of Object.entries(sinksRaw)) {
+            if (value == null)
+                continue;
+            if (typeof value !== "object" || Array.isArray(value)) {
+                throw new Error(`friction-log: config sinks.${name} must be a YAML mapping`);
+            }
+            sinks[name] = value;
+        }
+    }
+    const syncExport = parseSyncExportBlock(root.sync_export, path);
+    return applySyncExportEnvOverrides({ sinks, syncExport });
+}
+function parseSyncExportBlock(raw, configPath) {
+    if (raw == null)
+        return undefined;
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`friction-log: config at ${configPath} has a non-mapping "sync_export" value`);
+    }
+    const obj = raw;
+    const rawPath = obj.path;
+    const rawOrigin = obj.origin;
+    const rawPeers = obj.peer_paths;
+    if (typeof rawPath !== "string" || !rawPath.trim()) {
+        throw new Error(`friction-log: config sync_export.path at ${configPath} must be a non-empty string`);
+    }
+    if (typeof rawOrigin !== "string" || !rawOrigin.trim()) {
+        throw new Error(`friction-log: config sync_export.origin at ${configPath} must be a non-empty string`);
+    }
+    let peerPaths = [];
+    if (rawPeers != null) {
+        if (!Array.isArray(rawPeers) ||
+            !rawPeers.every((p) => typeof p === "string")) {
+            throw new Error(`friction-log: config sync_export.peer_paths at ${configPath} must be a list of strings`);
+        }
+        peerPaths = rawPeers;
+    }
+    return { path: rawPath, origin: rawOrigin, peerPaths };
+}
+/**
+ * FRICTION_LOG_SYNC_EXPORT_PATH / FRICTION_LOG_SYNC_EXPORT_ORIGIN win over
+ * the YAML `sync_export` block when set (paths.ts env-var convention), so a
+ * config.yml can be shared across machines (e.g. via dotfiles) while each
+ * machine supplies its own path/origin via env. Either var alone, with no
+ * counterpart resolvable from config or env, is a config error rather than
+ * a silent partial activation.
+ */
+function applySyncExportEnvOverrides(config) {
+    const envPath = syncExportPathOverride();
+    const envOrigin = syncExportOriginOverride();
+    if (envPath === undefined && envOrigin === undefined)
+        return config;
+    const path = envPath ?? config.syncExport?.path;
+    const origin = envOrigin ?? config.syncExport?.origin;
+    if (!path || !origin) {
+        throw new Error("friction-log: FRICTION_LOG_SYNC_EXPORT_PATH / FRICTION_LOG_SYNC_EXPORT_ORIGIN require both a path and an origin " +
+            "(from the env vars or the config sync_export block) to activate sync-export");
+    }
+    return {
+        ...config,
+        syncExport: { path, origin, peerPaths: config.syncExport?.peerPaths ?? [] },
+    };
+}
+/**
+ * Merge per-sink config with CLI overrides. CLI wins on key collision so a
+ * one-off `--sink-opt repo=other/repo` overrides the config's default repo.
+ */
+export function mergeSinkOpts(configSection, cliOverrides) {
+    return { ...(configSection ?? {}), ...(cliOverrides ?? {}) };
+}
+const KV_PATTERN = /^([A-Za-z0-9_.-]+)=(.*)$/s;
+/**
+ * Parse repeated `--sink-opt key=value` CLI flags into a SinkConfig.
+ * Values are coerced from string with cheap heuristics: comma-separated lists
+ * become arrays, "true"/"false" become booleans, integers become numbers. To
+ * keep a literal that looks like a list/number, prefix with `s:`.
+ */
+export function parseSinkOpts(pairs) {
+    const out = {};
+    for (const pair of pairs) {
+        const m = KV_PATTERN.exec(pair);
+        if (!m) {
+            throw new Error(`friction-log: --sink-opt expected key=value, got "${pair}"`);
+        }
+        const key = m[1];
+        const rawValue = m[2];
+        out[key] = coerceValue(rawValue);
+    }
+    return out;
+}
+function coerceValue(raw) {
+    if (raw.startsWith("s:"))
+        return raw.slice(2);
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    if (raw === "null")
+        return null;
+    if (/^-?\d+$/.test(raw))
+        return Number(raw);
+    if (raw.includes(","))
+        return raw
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+    return raw;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,81 @@
+import type { Friction, FrictionSource, FrictionStatus, Severity, Session, Task } from "./types.js";
+export interface InsertFrictionInput {
+    sessionId?: string | null;
+    toolSurface?: string | null;
+    title: string;
+    description?: string | null;
+    capturedAt?: string;
+    severity?: Severity | null;
+    category?: string | null;
+    source: FrictionSource;
+    recurrenceOfId?: number | null;
+}
+export interface ListFrictionsFilter {
+    status?: FrictionStatus;
+    tool?: string;
+    category?: string;
+    source?: FrictionSource;
+    sinceIso?: string;
+    limit?: number;
+}
+export type DigestGroupBy = "tool" | "category" | "severity" | "source";
+export interface DigestRow {
+    group: string;
+    total: number;
+    open: number;
+    filed: number;
+    resolved: number;
+    wontfix: number;
+    recurrences: number;
+    avgHoursToTriage: number | null;
+}
+export interface InsertTaskInput {
+    frictionId: number;
+    sinkName: string;
+    sinkTarget?: string | null;
+    externalRef?: string | null;
+    prUrl?: string | null;
+    resolutionStatus?: string | null;
+}
+export declare class FrictionDb {
+    private readonly db;
+    constructor(path: string);
+    private migrate;
+    schemaVersion(): number;
+    upsertSession(s: Session): void;
+    /**
+     * Create a minimal sessions row for `id` if none exists yet. Used by
+     * the `log` command path so `friction-log log --session <fresh-id>`
+     * can attribute a friction to a live runtime session without a prior
+     * `friction-log import`. Defaults: started_at = now, adapter =
+     * 'manual' (mirrors `frictions.source = 'manual'` for log-path rows).
+     * Idempotent: a subsequent `upsertSession` from an `import` or `scan`
+     * later overwrites the placeholder with full metadata.
+     */
+    ensureSession(id: string): void;
+    getSession(id: string): Session | null;
+    insertFriction(input: InsertFrictionInput): Friction;
+    findRecurrenceRoot(toolSurface: string | null, title: string): number | null;
+    getFriction(id: number): Friction | null;
+    updateFrictionStatus(id: number, status: FrictionStatus): void;
+    deleteFriction(id: number): boolean;
+    findFrictionByTriple(sessionId: string | null, toolSurface: string | null, title: string): Friction | null;
+    listFrictionsForSession(sessionId: string): Friction[];
+    getMostRecentSession(): Session | null;
+    listFrictions(filter?: ListFrictionsFilter): Friction[];
+    /**
+     * Every friction, no limit, sorted oldest-first with an `id` tiebreaker.
+     * Dedicated to sync-export: `listFrictions` caps at 10_000 and sorts
+     * newest-first for interactive use, neither of which is right for a full,
+     * deterministic machine-readable dump.
+     */
+    listAllFrictionsForSyncExport(): Friction[];
+    insertTask(input: InsertTaskInput): Task;
+    getTask(id: number): Task | null;
+    listTasksForFriction(frictionId: number): Task[];
+    addTag(frictionId: number, tag: string): void;
+    tagsFor(frictionId: number): string[];
+    searchFrictions(query: string, filter?: ListFrictionsFilter): Friction[];
+    digest(groupBy: DigestGroupBy, sinceIso?: string): DigestRow[];
+    close(): void;
+}