onadit 0.0.1 → 1.0.0

package/dist/src/capture/observability.d.ts

@@ -0,0 +1,131 @@
+import type { AutoCaptureSource, CaptureReport, CaptureSourceCounts } from "./auto-capture.js";
+export declare const AUTO_CAPTURE_RUNS_FILE = "auto-capture-runs.jsonl";
+export declare const AUTO_CAPTURE_RUNS_MAX_LINES = 1000;
+export interface AutoCaptureRunError {
+    sessionId: string;
+    source?: AutoCaptureSource;
+    error: string;
+}
+/**
+ * Who initiated a capture run. `daemon` = the scheduled hourly loop;
+ * `manual` = a `onadit capture` invocation; `onboard` = the first-capture pass
+ * inside `onadit onboard`. Only `daemon` runs represent the scheduled loop's
+ * health; `manual`/`onboard` are ad-hoc runs that prove "capture works now"
+ * without speaking for the daemon. Optional on the record because rows
+ * written before this field existed carry no trigger — every reader MUST
+ * treat a missing trigger as `daemon` (the daemon was the only writer then).
+ * See `summarizeAutoCaptureRuns` here and the friend-status route.
+ */
+export type AutoCaptureTrigger = "daemon" | "manual" | "onboard";
+export interface AutoCaptureRunRecord {
+    timestamp: string;
+    enabled_sources: AutoCaptureSource[];
+    run_ok: boolean;
+    preflight_ok: boolean;
+    duration_ms: number;
+    counts_by_source: Partial<Record<AutoCaptureSource, CaptureSourceCounts>>;
+    errors: AutoCaptureRunError[];
+    run_error?: string;
+    /**
+     * Why preflight failed, when `preflight_ok` is false. Recorded here rather
+     * than in `errors[]` so a probe failure never inflates the conversation-
+     * failure count. Absent on legacy rows and on healthy runs.
+     */
+    preflight_error?: string;
+    /**
+     * Which triage worker ran this capture's preflight (`codex` | `claude`),
+     * persisted from the provider that actually ran. Lets status/doctor attribute
+     * a failure to the worker that truly failed without re-inferring it from the
+     * current config (which may have been flipped since the run) or from the error
+     * text (which can be ambiguous, or — for a too-old Codex — even name the other
+     * worker). Absent on legacy rows → readers fall back to the config + error-text
+     * heuristic for those.
+     */
+    preflight_worker?: "codex" | "claude";
+    /** Who ran this capture. Absent on legacy rows → read as `daemon`. */
+    trigger?: AutoCaptureTrigger;
+    /**
+     * Native-Cursor discovery outcome for this run, present only when Cursor
+     * discovery was ATTEMPTED (scheduled via config, or env-enabled). Absent on
+     * runs that didn't attempt Cursor and on legacy rows. `false` = the store read
+     * failed (sqlite3 missing / corrupt query) even though the file exists —
+     * status reads this to warn rather than claim "capture on".
+     */
+    cursor_discovery_ok?: boolean;
+    /** Why Cursor discovery failed, when `cursor_discovery_ok` is false. */
+    cursor_discovery_error?: string;
+    /**
+     * Claude Desktop agent/Cowork discovery outcome for this run, present only
+     * when that opt-in source was attempted. `false` means the store read failed
+     * and was skipped without bootstrapping.
+     */
+    claude_desktop_discovery_ok?: boolean;
+    /** Why Cowork discovery failed, when `claude_desktop_discovery_ok` is false. */
+    claude_desktop_discovery_error?: string;
+}
+export interface AutoCaptureSourceSuccess {
+    timestamp: string;
+    saved: number;
+    review: number;
+    discarded: number;
+    new: number;
+}
+export interface AutoCaptureRunSummary {
+    /** Newest run of any trigger — drives the "last capture" freshness line. */
+    last_run: AutoCaptureRunRecord | null;
+    /**
+     * Newest run that came from the daemon's scheduled loop (legacy untagged
+     * rows count as daemon). Tracked separately from `last_run` so a manual
+     * success can refresh status WITHOUT laundering a still-failing scheduled
+     * loop: the daemon's own health stays observable here.
+     */
+    last_daemon_run: AutoCaptureRunRecord | null;
+    last_success_by_source: Partial<Record<AutoCaptureSource, AutoCaptureSourceSuccess | null>>;
+    /**
+     * The newest run (any trigger) that ATTEMPTED native-Cursor discovery, or null
+     * if no recorded run did. Drives the honest Cursor status line: a scheduled
+     * opt-in whose last discovery FAILED must warn ("can't read your store"),
+     * never read "capture on" off the file-presence probe alone.
+     */
+    last_cursor_discovery: {
+        ok: boolean;
+        error?: string;
+    } | null;
+    /**
+     * Newest run (any trigger) that attempted Claude Desktop agent/Cowork
+     * discovery, or null if no recorded run did. Drives the honest Cowork status
+     * line for scheduled opt-ins.
+     */
+    last_claude_desktop_discovery: {
+        ok: boolean;
+        error?: string;
+    } | null;
+}
+export declare function autoCaptureRunsPath(dataDir: string): string;
+export declare function buildAutoCaptureRunRecord(opts: {
+    timestamp: string;
+    enabledSources: AutoCaptureSource[];
+    durationMs: number;
+    report: CaptureReport;
+    /** Daemon loop vs. a manual `onadit capture`. */
+    trigger: AutoCaptureTrigger;
+}): AutoCaptureRunRecord;
+export declare function appendAutoCaptureRunRecord(dataDir: string, record: AutoCaptureRunRecord, maxLines?: number): Promise<void>;
+export declare function readAutoCaptureRunRecords(dataDir: string): AutoCaptureRunRecord[];
+/**
+ * Whether a recorded run failed, across ALL three failure shapes:
+ *   - `run_ok: false`  — the loop threw (daemon catch-all path).
+ *   - `preflight_ok: false` — e.g. an expired `codex login`. Recorded with
+ *     `run_ok: true` because the run completed; this is the COMMON real
+ *     failure, so a `run_ok`-only check would miss it and let a manual
+ *     success launder the daemon green.
+ *   - `errors.length > 0` — the run completed but hit per-session errors.
+ * Mirrors how diagnostics treats a live capture as broken
+ * (`last_errors > 0` OR `codex.last_preflight_ok === false`), so the
+ * daemon's own latest outcome is judged by the same bar.
+ */
+export declare function autoCaptureRunFailed(record: AutoCaptureRunRecord): boolean;
+export declare function summarizeAutoCaptureRuns(records: AutoCaptureRunRecord[], sources?: AutoCaptureSource[]): AutoCaptureRunSummary;
+export declare function readAutoCaptureRunSummary(dataDir: string, sources?: AutoCaptureSource[]): AutoCaptureRunSummary;
+export declare function formatAutoCaptureSummary(summary: AutoCaptureRunSummary): string;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/capture/observability.d.ts.map

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

package/dist/src/capture/observability.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+import { atomicWrite } from "../storage/atomic.js";
+import { DEFAULT_AUTO_CAPTURE_SOURCES } from "./sources.js";
+export const AUTO_CAPTURE_RUNS_FILE = "auto-capture-runs.jsonl";
+export const AUTO_CAPTURE_RUNS_MAX_LINES = 1000;
+export function autoCaptureRunsPath(dataDir) {
+    return path.join(dataDir, "observability", AUTO_CAPTURE_RUNS_FILE);
+}
+export function buildAutoCaptureRunRecord(opts) {
+    return {
+        timestamp: opts.timestamp,
+        enabled_sources: opts.enabledSources,
+        // If runAutoCapture returned a report, the run completed. run_ok: false
+        // is only written by the daemon's catch-all path (a thrown run); both
+        // the daemon and the manual command reach this builder on a completed
+        // run, distinguished by `trigger`.
+        run_ok: true,
+        preflight_ok: opts.report.preflight_ok,
+        duration_ms: opts.durationMs,
+        counts_by_source: opts.report.counts_by_source,
+        errors: opts.report.error_details.map((err) => ({
+            sessionId: err.sessionId,
+            ...(err.source ? { source: err.source } : {}),
+            error: err.error,
+        })),
+        ...(opts.report.preflight_error
+            ? { preflight_error: opts.report.preflight_error }
+            : {}),
+        ...(opts.report.preflight_worker
+            ? { preflight_worker: opts.report.preflight_worker }
+            : {}),
+        ...(opts.report.cursor_discovery
+            ? {
+                cursor_discovery_ok: opts.report.cursor_discovery.ok,
+                ...(opts.report.cursor_discovery.error
+                    ? { cursor_discovery_error: opts.report.cursor_discovery.error }
+                    : {}),
+            }
+            : {}),
+        ...(opts.report.claude_desktop_discovery
+            ? {
+                claude_desktop_discovery_ok: opts.report.claude_desktop_discovery.ok,
+                ...(opts.report.claude_desktop_discovery.error
+                    ? {
+                        claude_desktop_discovery_error: opts.report.claude_desktop_discovery.error,
+                    }
+                    : {}),
+            }
+            : {}),
+        trigger: opts.trigger,
+    };
+}
+export async function appendAutoCaptureRunRecord(dataDir, record, maxLines = AUTO_CAPTURE_RUNS_MAX_LINES) {
+    const filePath = autoCaptureRunsPath(dataDir);
+    // Two writers now: the daemon's scheduled loop and a manual `onadit capture`
+    // (tagged via `record.trigger`). The final write is atomic, but the
+    // read/modify/write is not locked, so a daemon tick firing in the exact
+    // same window as a manual run could drop one row. That's an acceptable
+    // loss for an append-only health log (no correctness impact, just a
+    // missed observability line) and far cheaper than a file lock; revisit
+    // only if a third concurrent writer appears.
+    const lines = fs.existsSync(filePath)
+        ? fs.readFileSync(filePath, "utf-8").split("\n").filter(Boolean)
+        : [];
+    lines.push(JSON.stringify(record));
+    const capped = lines.slice(-maxLines);
+    await atomicWrite(filePath, `${capped.join("\n")}\n`);
+}
+export function readAutoCaptureRunRecords(dataDir) {
+    const filePath = autoCaptureRunsPath(dataDir);
+    if (!fs.existsSync(filePath))
+        return [];
+    return fs
+        .readFileSync(filePath, "utf-8")
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+/**
+ * Whether a recorded run failed, across ALL three failure shapes:
+ *   - `run_ok: false`  — the loop threw (daemon catch-all path).
+ *   - `preflight_ok: false` — e.g. an expired `codex login`. Recorded with
+ *     `run_ok: true` because the run completed; this is the COMMON real
+ *     failure, so a `run_ok`-only check would miss it and let a manual
+ *     success launder the daemon green.
+ *   - `errors.length > 0` — the run completed but hit per-session errors.
+ * Mirrors how diagnostics treats a live capture as broken
+ * (`last_errors > 0` OR `codex.last_preflight_ok === false`), so the
+ * daemon's own latest outcome is judged by the same bar.
+ */
+export function autoCaptureRunFailed(record) {
+    return !record.run_ok || !record.preflight_ok || record.errors.length > 0;
+}
+export function summarizeAutoCaptureRuns(records, sources = DEFAULT_AUTO_CAPTURE_SOURCES) {
+    const lastSuccess = {};
+    for (const source of sources) {
+        lastSuccess[source] = null;
+    }
+    for (const record of records) {
+        if (record.run_ok === false)
+            continue;
+        for (const source of sources) {
+            const counts = record.counts_by_source[source];
+            if (!counts || counts.saved <= 0)
+                continue;
+            lastSuccess[source] = {
+                timestamp: record.timestamp,
+                saved: counts.saved,
+                review: counts.review,
+                discarded: counts.discarded,
+                new: counts.new,
+            };
+        }
+    }
+    // Walk back to the newest daemon-triggered (or legacy untagged) run. This
+    // is what keeps an ad-hoc success from masking a failing scheduled loop:
+    // `last_run` reflects the freshest capture of any kind, while this stays
+    // pinned to the daemon's own latest outcome. `manual` AND `onboard` runs
+    // are ad-hoc and excluded here — only `daemon` (or a legacy untagged row,
+    // written when the daemon was the sole writer) speaks for the loop.
+    let lastDaemonRun = null;
+    for (let i = records.length - 1; i >= 0; i--) {
+        const record = records[i];
+        if (record && (record.trigger === "daemon" || record.trigger === undefined)) {
+            lastDaemonRun = record;
+            break;
+        }
+    }
+    // Newest run that attempted Cursor discovery, regardless of trigger: a manual
+    // `onadit capture` or onboard pass that read Cursor is just as authoritative
+    // about "can Onadit read the store" as a daemon tick. Absent on every run (or
+    // only legacy rows) → null, and status falls back to the file-presence probe.
+    let lastCursorDiscovery = null;
+    for (let i = records.length - 1; i >= 0; i--) {
+        const record = records[i];
+        if (record && record.cursor_discovery_ok !== undefined) {
+            lastCursorDiscovery = {
+                ok: record.cursor_discovery_ok,
+                ...(record.cursor_discovery_error
+                    ? { error: record.cursor_discovery_error }
+                    : {}),
+            };
+            break;
+        }
+    }
+    let lastClaudeDesktopDiscovery = null;
+    for (let i = records.length - 1; i >= 0; i--) {
+        const record = records[i];
+        if (record && record.claude_desktop_discovery_ok !== undefined) {
+            lastClaudeDesktopDiscovery = {
+                ok: record.claude_desktop_discovery_ok,
+                ...(record.claude_desktop_discovery_error
+                    ? { error: record.claude_desktop_discovery_error }
+                    : {}),
+            };
+            break;
+        }
+    }
+    return {
+        last_run: records.at(-1) ?? null,
+        last_daemon_run: lastDaemonRun,
+        last_success_by_source: lastSuccess,
+        last_cursor_discovery: lastCursorDiscovery,
+        last_claude_desktop_discovery: lastClaudeDesktopDiscovery,
+    };
+}
+export function readAutoCaptureRunSummary(dataDir, sources = DEFAULT_AUTO_CAPTURE_SOURCES) {
+    return summarizeAutoCaptureRuns(readAutoCaptureRunRecords(dataDir), sources);
+}
+export function formatAutoCaptureSummary(summary) {
+    const lines = ["", "## Auto-capture"];
+    lines.push(`- last run: ${summary.last_run?.timestamp ?? "none"}`);
+    for (const [source, success] of Object.entries(summary.last_success_by_source)) {
+        lines.push(success
+            ? `- ${source}: last successful save ${success.timestamp} (${success.saved} saved, ${success.new} new)`
+            : `- ${source}: no successful saves recorded`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=observability.js.map

package/dist/src/capture/observability.js.map

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

package/dist/src/capture/openai-triage-provider.d.ts

@@ -0,0 +1,92 @@
+/**
+ * OpenAI-backed triage provider.
+ *
+ * Locked model family:
+ *   - cheap (default):  gpt-5.4-nano
+ *   - escalation:       gpt-5.4-mini
+ *
+ * Two-tier strategy:
+ *   1. Always call cheap first.
+ *   2. Escalate to mini when:
+ *        - cheap result confidence < 0.7, OR
+ *        - input length > 8000 chars
+ *   3. If escalation fails, fall back to the cheap result so the batch
+ *      doesn't lose work over a single transient API blip.
+ *
+ * The provider implements CostReportingTriageProvider so a BatchBudget
+ * can true-up spend after each call.
+ */
+import { type TriageInput, type TriageResult } from "./triage-provider.js";
+import type { CostReportingTriageProvider, TriageCost } from "./batch-budget.js";
+/** Confidence threshold below which the cheap model escalates. */
+export declare const ESCALATION_CONFIDENCE = 0.7;
+/** Input length above which the cheap model always escalates. */
+export declare const HIGH_VALUE_LENGTH = 8000;
+/** Locked default models for the OpenAI runtime. */
+export declare const DEFAULT_CHEAP_MODEL = "gpt-5.4-nano";
+export declare const DEFAULT_ESCALATION_MODEL = "gpt-5.4-mini";
+/**
+ * Per-1k-token USD pricing. Values are best-effort defaults; can be
+ * overridden via `pricing` for tests or future re-pricing.
+ */
+export interface ModelPricing {
+    inputPer1k: number;
+    outputPer1k: number;
+}
+export declare const DEFAULT_PRICING: Record<string, ModelPricing>;
+/**
+ * Fetch dependency, broken out so tests can swap in a mock without
+ * monkey-patching the global. Matches the standard `fetch` signature.
+ */
+export type FetchFn = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface OpenAIProviderOptions {
+    /** Resolves the API key — typically a Keychain read. Called lazily, once. */
+    apiKey: () => Promise<string>;
+    cheapModel?: string;
+    escalationModel?: string;
+    baseUrl?: string;
+    requestTimeoutMs?: number;
+    pricing?: Record<string, ModelPricing>;
+    fetchImpl?: FetchFn;
+}
+export declare class OpenAITriageProvider implements CostReportingTriageProvider {
+    private readonly cheapModel;
+    private readonly escalationModel;
+    private readonly baseUrl;
+    private readonly requestTimeoutMs;
+    private readonly pricing;
+    private readonly fetchImpl;
+    private readonly apiKeyResolver;
+    private keyPromise;
+    constructor(opts: OpenAIProviderOptions);
+    /** Pre-flight max-cost estimate. Uses the escalation model upper bound. */
+    estimateMaxCostUsd(input: TriageInput): number;
+    /** Convenience wrapper for callers that don't need cost reporting. */
+    triage(input: TriageInput): Promise<TriageResult>;
+    /**
+     * Run triage and return the result + actual cost incurred. All cost
+     * accounting is local to this call; concurrent invocations don't share
+     * any mutable state.
+     */
+    triageWithCost(input: TriageInput): Promise<{
+        result: TriageResult;
+        cost: TriageCost;
+    }>;
+    private callOnce;
+    /**
+     * Resolve the API key once and share the in-flight promise across
+     * concurrent callers, so the Keychain isn't hit N times under load.
+     */
+    private resolveKey;
+}
+//# sourceMappingURL=openai-triage-provider.d.ts.map

package/dist/src/capture/openai-triage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-triage-provider.d.ts","sourceRoot":"","sources":["../../../src/capture/openai-triage-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAKvD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAGxD,CAAC;AAwCF;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC9F,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAEjG,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,oBAAqB,YAAW,2BAA2B;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,UAAU,CAAgC;gBAEtC,IAAI,EAAE,qBAAqB;IAUvC,2EAA2E;IAC3E,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAsB9C,sEAAsE;IAChE,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAKvD;;;;OAIG;IACG,cAAc,CAClB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;YAiDxC,QAAQ;IA2FtB;;;OAGG;IACH,OAAO,CAAC,UAAU;CAUnB"}