@getrift/rift 0.0.0 → 0.1.0-beta.0

package/dist/src/capture/auto-capture.d.ts

@@ -0,0 +1,162 @@
+import { type AutoCaptureSource } from "./sources.js";
+export type { AutoCaptureSource } from "./sources.js";
+export interface CaptureStateEntry {
+    /** Content hash of the last processed version. */
+    fingerprint: string;
+    /** Idempotency key used for the last save (for row replacement on update). */
+    idempotency_key: string;
+}
+export interface CaptureState {
+    /** Map of sessionId -> processing state. */
+    processed: Record<string, string | CaptureStateEntry>;
+    /**
+     * Sources whose existing corpus was intentionally watermarked on first
+     * enablement. This prevents a newly enabled source from importing all
+     * historical local sessions as if they were live deltas.
+     */
+    bootstrapped_sources?: Partial<Record<AutoCaptureSource, string>>;
+}
+export interface CaptureSourceCounts {
+    discovered: number;
+    bootstrapped: number;
+    new: number;
+    skipped: number;
+    saved: number;
+    review: number;
+    discarded: number;
+    /**
+     * Sessions skipped before triage because the source file exceeds the
+     * configured size threshold. The source file is never mutated; an
+     * operator-recovery record is written to `data/quarantine/`.
+     */
+    quarantined: number;
+    errors: number;
+    deferred: number;
+}
+export interface CaptureResult {
+    source: AutoCaptureSource;
+    sessionId: string;
+    title: string;
+    decision: "save" | "discard" | "review";
+    confidence: number;
+    /** Model ID that produced the triage (e.g. "gpt-5.4-nano"). */
+    model: string;
+    /** Provider tag from the triage result (e.g. "openai"). */
+    provider: string;
+    summary: string;
+}
+export interface CaptureReport {
+    total_discovered: number;
+    new_conversations: number;
+    saved: number;
+    discarded: number;
+    review: number;
+    quarantined: number;
+    errors: number;
+    preflight_ok: boolean;
+    counts_by_source: Partial<Record<AutoCaptureSource, CaptureSourceCounts>>;
+    results: CaptureResult[];
+    error_details: Array<{
+        sessionId: string;
+        source?: AutoCaptureSource;
+        error: string;
+    }>;
+}
+export interface AutoCaptureDeps {
+    /** Path to data directory (for state file and review queue). */
+    dataDir: string;
+    /** Path to Claude config directory (default: ~/.claude). */
+    claudeDir?: string;
+    /** Path to Codex config directory (default: ~/.codex). */
+    codexDir?: string;
+    /** Function to save a conversation via the daemon. */
+    saveFn: (opts: {
+        source: string;
+        summary: string;
+        content: string;
+        topics: string[];
+        domain?: string;
+        idempotency_key: string;
+        /** When replacing a previously-saved version, the old key to delete. */
+        replace_idempotency_key?: string;
+    }) => Promise<void>;
+    /** Dry run — triage but don't save/review/update state. */
+    dryRun?: boolean;
+    /** Optional source filter for one-off backfills. */
+    sources?: AutoCaptureSource[];
+    /** Preflight hook for credential/runtime readiness. */
+    preflightTriage?: () => Promise<void>;
+    /**
+     * Maximum byte size for a single Codex CLI session before the size guard
+     * quarantines it. Defaults to `DEFAULT_CODEX_MAX_SESSION_BYTES`.
+     */
+    codexMaxSessionBytes?: number;
+}
+/**
+ * Default upper bound for a Codex CLI session that auto-capture will hand
+ * to the triage subprocess. Real sessions in `~/.codex/sessions/` are tens
+ * of KB to ~2 MB; 8 MB is well above healthy traffic and well below the
+ * 25 MB outliers that have been observed to make Codex CLI exit 1.
+ *
+ * Operators raise this in `config.json` under `capture.codex_cli.max_session_bytes`.
+ */
+export declare const DEFAULT_CODEX_MAX_SESSION_BYTES: number;
+/** Sentinel idempotency_key written into capture-state.json for oversized sessions. */
+export declare const QUARANTINED_OVERSIZED_KEY = "quarantined:oversized";
+/**
+ * Translate the operator-facing `capture.codex_cli.max_session_bytes` config
+ * field into the partial `AutoCaptureDeps` shape that every entry point
+ * (daemon scheduled run, `rift capture`, `rift onboard` first-capture) must
+ * spread into its `runAutoCapture()` call. Centralizing this resolution
+ * keeps the three call sites from drifting and gives behavioral tests a
+ * single observable contract.
+ *
+ * Returns an empty object (so the spread is a no-op) when the override is
+ * absent — the consuming `runAutoCapture` then falls through to
+ * `DEFAULT_CODEX_MAX_SESSION_BYTES`.
+ */
+export declare function resolveCodexCaptureDeps(config: {
+    capture?: {
+        codex_cli?: {
+            max_session_bytes?: number | undefined;
+        } | undefined;
+    } | undefined;
+}): {
+    codexMaxSessionBytes?: number;
+};
+/**
+ * Build the full daemon-scheduled `runAutoCapture` deps from config + the
+ * job-queue-backed `saveFn`. The factory exists so the daemon path is
+ * directly unit-testable: callers can assert the returned shape without
+ * standing up the full daemon. The CLI paths (`rift capture`, `rift onboard
+ * --first-capture`) build their deps inline because they vary per-invocation
+ * (source filter, dry-run, claudeDir/codexDir overrides, HTTP-client save).
+ */
+export declare function buildDaemonAutoCaptureDeps(opts: {
+    config: {
+        capture: {
+            sources: AutoCaptureSource[];
+            codex_cli?: {
+                max_session_bytes?: number | undefined;
+            } | undefined;
+        };
+        data_paths: {
+            data_dir: string;
+        };
+    };
+    saveFn: AutoCaptureDeps["saveFn"];
+}): AutoCaptureDeps;
+export declare function zeroCounts(): CaptureSourceCounts;
+export declare function makeErrorCounts(errors?: number): CaptureSourceCounts;
+/**
+ * Run the auto-capture pipeline.
+ *
+ * 1. Discover all supported local CLI conversation files
+ * 2. Filter out already-processed conversations (by session UUID + content hash)
+ * 3. Parse each new conversation
+ * 4. Triage via Haiku (with Sonnet escalation)
+ * 5. Route: save/review/discard
+ * 6. Update dedupe state
+ */
+export declare function runAutoCapture(deps: AutoCaptureDeps): Promise<CaptureReport>;
+//# sourceMappingURL=auto-capture.d.ts.map

package/dist/src/capture/auto-capture.d.ts.map

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