@getrift/rift 0.0.0 → 0.1.0-beta.0

package/dist/src/capture/openai-triage-provider.js

@@ -0,0 +1,267 @@
+/**
+ * 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 { TRIAGE_VERSION, BilledOpenAIError, } from "./triage-provider.js";
+import { scoreHistoricalTriage, } from "./triage-lane.js";
+/** Confidence threshold below which the cheap model escalates. */
+export const ESCALATION_CONFIDENCE = 0.7;
+/** Input length above which the cheap model always escalates. */
+export const HIGH_VALUE_LENGTH = 8000;
+/** Locked default models for the OpenAI runtime. */
+export const DEFAULT_CHEAP_MODEL = "gpt-5.4-nano";
+export const DEFAULT_ESCALATION_MODEL = "gpt-5.4-mini";
+/** Cap on the prompt content sent to the model. */
+const MAX_TRIAGE_CHARS = 12000;
+export const DEFAULT_PRICING = {
+    "gpt-5.4-nano": { inputPer1k: 0.0001, outputPer1k: 0.0004 },
+    "gpt-5.4-mini": { inputPer1k: 0.0010, outputPer1k: 0.0040 },
+};
+const TRIAGE_PROMPT = `You are a triage classifier for a personal knowledge base. Given a conversation between a user and an AI assistant, decide whether it should be saved to long-term memory.
+
+Classify as one of:
+- "save": Contains valuable decisions, technical knowledge, project context, personal insights, client work details, or reference-worthy information the user would want to recall later.
+- "discard": Trivial, purely mechanical (e.g., "fix this lint error"), repetitive, or contains no lasting value. Quick Q&A with no novel insight.
+- "review": Borderline — might be valuable but you're not sure. Contains some useful content mixed with noise, or the value depends on context you don't have.
+
+Respond with ONLY valid JSON (no markdown fences):
+{
+  "decision": "save" | "discard" | "review",
+  "confidence": 0.0 to 1.0,
+  "summary": "one-line summary of what the conversation is about",
+  "topics": ["topic1", "topic2"],
+  "rationale": "brief explanation of why this decision"
+}
+
+CONVERSATION:
+`;
+export class OpenAITriageProvider {
+    cheapModel;
+    escalationModel;
+    baseUrl;
+    requestTimeoutMs;
+    pricing;
+    fetchImpl;
+    apiKeyResolver;
+    keyPromise = null;
+    constructor(opts) {
+        this.apiKeyResolver = opts.apiKey;
+        this.cheapModel = opts.cheapModel ?? DEFAULT_CHEAP_MODEL;
+        this.escalationModel = opts.escalationModel ?? DEFAULT_ESCALATION_MODEL;
+        this.baseUrl = opts.baseUrl ?? "https://api.openai.com/v1";
+        this.requestTimeoutMs = opts.requestTimeoutMs ?? 30_000;
+        this.pricing = opts.pricing ?? DEFAULT_PRICING;
+        this.fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    }
+    /** Pre-flight max-cost estimate. Uses the escalation model upper bound. */
+    estimateMaxCostUsd(input) {
+        const inputChars = Math.min(input.content.length, MAX_TRIAGE_CHARS) +
+            TRIAGE_PROMPT.length;
+        const inputTokens = Math.ceil(inputChars / 4);
+        const outputTokens = 256;
+        const escalationPrice = this.pricing[this.escalationModel] ?? {
+            inputPer1k: 0.005,
+            outputPer1k: 0.02,
+        };
+        const cheapPrice = this.pricing[this.cheapModel] ?? {
+            inputPer1k: 0.001,
+            outputPer1k: 0.004,
+        };
+        const cheapCost = (inputTokens / 1000) * cheapPrice.inputPer1k +
+            (outputTokens / 1000) * cheapPrice.outputPer1k;
+        const escalationCost = (inputTokens / 1000) * escalationPrice.inputPer1k +
+            (outputTokens / 1000) * escalationPrice.outputPer1k;
+        return cheapCost + escalationCost;
+    }
+    /** Convenience wrapper for callers that don't need cost reporting. */
+    async triage(input) {
+        const { result } = await this.triageWithCost(input);
+        return result;
+    }
+    /**
+     * 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.
+     */
+    async triageWithCost(input) {
+        const truncated = truncate(input.content, MAX_TRIAGE_CHARS);
+        const prompt = TRIAGE_PROMPT + truncated;
+        let totalUsd = 0;
+        // --- Cheap pass ---
+        let cheap;
+        try {
+            cheap = await this.callOnce(input, prompt, this.cheapModel);
+        }
+        catch (err) {
+            // If the cheap call billed us before failing (200 + bad JSON),
+            // surface the cost so the budget retains it.
+            if (err instanceof BilledOpenAIError) {
+                throw new BilledOpenAIError(err.message, totalUsd + err.costUsd, { cause: err.cause ?? err });
+            }
+            throw err;
+        }
+        totalUsd += cheap.cost;
+        const isLowConfidence = cheap.result.confidence < ESCALATION_CONFIDENCE;
+        const isLong = input.content.length > HIGH_VALUE_LENGTH;
+        if (!isLowConfidence && !isLong) {
+            return { result: cheap.result, cost: { usd: totalUsd } };
+        }
+        // --- Escalation ---
+        try {
+            const escalated = await this.callOnce(input, prompt, this.escalationModel);
+            totalUsd += escalated.cost;
+            return { result: escalated.result, cost: { usd: totalUsd } };
+        }
+        catch (err) {
+            // Don't lose the batch over a single escalation blip — fall back to
+            // the cheap result. But if the escalation billed us before failing,
+            // include that cost in the returned total so the budget is correct.
+            if (err instanceof BilledOpenAIError) {
+                totalUsd += err.costUsd;
+            }
+            return { result: cheap.result, cost: { usd: totalUsd } };
+        }
+    }
+    async callOnce(input, prompt, model) {
+        const apiKey = await this.resolveKey();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+        let raw;
+        try {
+            const res = await this.fetchImpl(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: [{ role: "user", content: prompt }],
+                    temperature: 0,
+                    response_format: { type: "json_object" },
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new Error(`OpenAI ${model} HTTP ${res.status}: ${body.slice(0, 500)}`);
+            }
+            raw = (await res.json());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const content = raw.choices?.[0]?.message?.content ?? "";
+        const usage = raw.usage ?? {};
+        const price = this.pricing[model];
+        let cost = 0;
+        if (price) {
+            cost =
+                ((usage.prompt_tokens ?? 0) / 1000) * price.inputPer1k +
+                    ((usage.completion_tokens ?? 0) / 1000) * price.outputPer1k;
+        }
+        if (!content) {
+            // Empty content — the API still billed us for prompt tokens.
+            throw new BilledOpenAIError(`OpenAI ${model} returned empty content`, cost);
+        }
+        try {
+            const parsed = parseTriageResponse(content);
+            const scoring = scoreHistoricalTriage({
+                content: input.content,
+                decision: parsed.decision,
+                confidence: parsed.confidence,
+                summary: parsed.summary,
+                rationale: parsed.rationale,
+                topics: parsed.topics,
+                ...(input.source ? { source: input.source } : {}),
+            });
+            const result = {
+                decision: parsed.decision,
+                lane: scoring.lane,
+                confidence: parsed.confidence,
+                score: scoring.score,
+                summary: parsed.summary,
+                topics: parsed.topics,
+                rationale: parsed.rationale,
+                model,
+                provider: "openai",
+                version: TRIAGE_VERSION,
+                score_breakdown: scoring.debug.score_breakdown,
+                debug: scoring.debug,
+            };
+            return { result, cost };
+        }
+        catch (parseErr) {
+            // 200 OK with token usage but unparsable / invalid JSON. The
+            // upstream API has already billed us; surface the cost so the
+            // batch budget retains it (don't refund a call we paid for).
+            throw new BilledOpenAIError(parseErr instanceof Error ? parseErr.message : String(parseErr), cost, { cause: parseErr });
+        }
+    }
+    /**
+     * Resolve the API key once and share the in-flight promise across
+     * concurrent callers, so the Keychain isn't hit N times under load.
+     */
+    resolveKey() {
+        if (this.keyPromise === null) {
+            this.keyPromise = this.apiKeyResolver().catch((err) => {
+                // Don't cache failures — let the next call retry.
+                this.keyPromise = null;
+                throw err;
+            });
+        }
+        return this.keyPromise;
+    }
+}
+function truncate(content, maxChars) {
+    if (content.length <= maxChars)
+        return content;
+    const half = Math.floor(maxChars / 2);
+    return (content.slice(0, half) +
+        "\n\n[...middle truncated for triage...]\n\n" +
+        content.slice(-half));
+}
+function parseTriageResponse(raw) {
+    let cleaned = raw
+        .replace(/^```json\s*/i, "")
+        .replace(/^```\s*/i, "")
+        .replace(/\s*```$/i, "")
+        .trim();
+    const start = cleaned.indexOf("{");
+    const end = cleaned.lastIndexOf("}");
+    if (start === -1 || end === -1) {
+        throw new Error(`No JSON object in OpenAI triage response: ${raw.slice(0, 200)}`);
+    }
+    cleaned = cleaned.slice(start, end + 1);
+    const parsed = JSON.parse(cleaned);
+    const decision = parsed.decision;
+    if (decision !== "save" && decision !== "discard" && decision !== "review") {
+        throw new Error(`Invalid triage decision: ${String(decision)}`);
+    }
+    const confidence = Number(parsed.confidence);
+    if (Number.isNaN(confidence) || confidence < 0 || confidence > 1) {
+        throw new Error(`Invalid confidence: ${String(parsed.confidence)}`);
+    }
+    return {
+        decision,
+        confidence,
+        summary: String(parsed.summary ?? ""),
+        topics: Array.isArray(parsed.topics) ? parsed.topics.map(String) : [],
+        rationale: String(parsed.rationale ?? ""),
+    };
+}
+//# sourceMappingURL=openai-triage-provider.js.map

package/dist/src/capture/openai-triage-provider.js.map

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

package/dist/src/capture/review-queue-index.d.ts

@@ -0,0 +1,51 @@
+import type { ReviewItem } from "./review-queue.js";
+export type ReviewQueueSortBy = "queued_at" | "confidence" | "source";
+export type ReviewQueueSortOrder = "asc" | "desc";
+export interface ReviewQueueFilters {
+    source?: string;
+    min_confidence?: number;
+    max_confidence?: number;
+    topic?: string;
+    queued_after?: string;
+    queued_before?: string;
+    search?: string;
+}
+export interface ReviewQueueListOptions extends ReviewQueueFilters {
+    page?: number;
+    per_page?: number;
+    sort_by?: ReviewQueueSortBy;
+    sort_order?: ReviewQueueSortOrder;
+}
+export interface ReviewQueuePage {
+    items: ReviewItem[];
+    total: number;
+    page: number;
+    per_page: number;
+}
+export interface ReviewQueueSelectionOptions extends ReviewQueueFilters {
+    ids?: string[];
+    sort_by?: ReviewQueueSortBy;
+    sort_order?: ReviewQueueSortOrder;
+    limit?: number;
+}
+export interface ReviewQueueSelection {
+    items: ReviewItem[];
+    total: number;
+    missing_ids: string[];
+}
+/**
+ * Query the review queue with deterministic filtering, sorting, and
+ * offset/limit-style pagination expressed as page/per_page.
+ *
+ * Default sort order is newest first (`queued_at` descending).
+ */
+export declare function queryReviewQueue(dataDir: string, options?: ReviewQueueListOptions): ReviewQueuePage;
+/**
+ * Resolve a review-queue selection for batch operations.
+ *
+ * - explicit ids preserve caller order
+ * - filter-driven selection uses the same filter/sort logic as list
+ * - limit applies after filter+sort for "top N" workflows
+ */
+export declare function selectReviewQueueItems(dataDir: string, options: ReviewQueueSelectionOptions): ReviewQueueSelection;
+//# sourceMappingURL=review-queue-index.d.ts.map

package/dist/src/capture/review-queue-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-queue-index.d.ts","sourceRoot":"","sources":["../../../src/capture/review-queue-index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAoKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAwBjB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B,GACnC,oBAAoB,CAoCtB"}

package/dist/src/capture/review-queue-index.js

@@ -0,0 +1,204 @@
+/**
+ * In-memory query/index layer for the file-backed review queue.
+ *
+ * Source of truth remains the JSON files in `data/review-queue/`.
+ * This module builds a transient in-memory view at command time so
+ * list/batch workflows can filter, sort, paginate, and search without
+ * migrating queue storage into LanceDB.
+ */
+import fs from "node:fs";
+import path from "node:path";
+const DEFAULT_PAGE = 1;
+const DEFAULT_PER_PAGE = 50;
+function reviewDir(dataDir) {
+    const dir = path.join(dataDir, "review-queue");
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function queuedAtMs(item) {
+    const ms = Date.parse(item.queued_at);
+    return Number.isFinite(ms) ? ms : 0;
+}
+function normalize(text) {
+    return (text ?? "").trim().toLowerCase();
+}
+function resolveSortOrder(sortBy, sortOrder) {
+    if (sortOrder)
+        return sortOrder;
+    if (sortBy === "source")
+        return "asc";
+    return "desc";
+}
+function parseFilterTime(value) {
+    if (!value)
+        return null;
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms)) {
+        throw new Error(`Invalid queued timestamp filter: ${value}`);
+    }
+    return ms;
+}
+function readReviewItems(dataDir) {
+    const dir = reviewDir(dataDir);
+    const files = fs.readdirSync(dir).filter((file) => file.endsWith(".json"));
+    const items = [];
+    for (const file of files) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            items.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip corrupt files rather than breaking the queue.
+        }
+    }
+    return items;
+}
+function applyReviewFilters(items, filters) {
+    const source = normalize(filters.source);
+    const topic = normalize(filters.topic);
+    const search = normalize(filters.search);
+    const minConfidence = filters.min_confidence;
+    const maxConfidence = filters.max_confidence;
+    const queuedAfter = parseFilterTime(filters.queued_after);
+    const queuedBefore = parseFilterTime(filters.queued_before);
+    return items.filter((item) => {
+        if (source && normalize(item.source) !== source) {
+            return false;
+        }
+        if (minConfidence !== undefined &&
+            item.triage.confidence < minConfidence) {
+            return false;
+        }
+        if (maxConfidence !== undefined &&
+            item.triage.confidence > maxConfidence) {
+            return false;
+        }
+        if (topic &&
+            !item.triage.topics.some((value) => normalize(value) === topic)) {
+            return false;
+        }
+        const queuedAt = queuedAtMs(item);
+        if (queuedAfter !== null && queuedAt < queuedAfter) {
+            return false;
+        }
+        if (queuedBefore !== null && queuedAt > queuedBefore) {
+            return false;
+        }
+        if (search) {
+            const haystack = [
+                item.summary,
+                item.source,
+                item.project ?? "",
+                item.triage.topics.join(" "),
+            ]
+                .join("\n")
+                .toLowerCase();
+            if (!haystack.includes(search)) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+function compareReviewItems(left, right, sortBy, sortOrder) {
+    let primary = 0;
+    if (sortBy === "queued_at") {
+        primary = queuedAtMs(left) - queuedAtMs(right);
+    }
+    else if (sortBy === "confidence") {
+        primary = left.triage.confidence - right.triage.confidence;
+    }
+    else {
+        primary = left.source.localeCompare(right.source, undefined, {
+            sensitivity: "base",
+        });
+    }
+    if (primary !== 0) {
+        return sortOrder === "asc" ? primary : -primary;
+    }
+    const queuedCompare = queuedAtMs(right) - queuedAtMs(left);
+    if (queuedCompare !== 0)
+        return queuedCompare;
+    return left.id.localeCompare(right.id);
+}
+function sortReviewItems(items, sortBy, sortOrder) {
+    return [...items].sort((left, right) => compareReviewItems(left, right, sortBy, sortOrder));
+}
+function dedupeIds(ids) {
+    const seen = new Set();
+    const unique = [];
+    for (const id of ids) {
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        unique.push(id);
+    }
+    return unique;
+}
+/**
+ * Query the review queue with deterministic filtering, sorting, and
+ * offset/limit-style pagination expressed as page/per_page.
+ *
+ * Default sort order is newest first (`queued_at` descending).
+ */
+export function queryReviewQueue(dataDir, options = {}) {
+    const page = options.page ?? DEFAULT_PAGE;
+    const perPage = options.per_page ?? DEFAULT_PER_PAGE;
+    if (page < 1 || !Number.isInteger(page)) {
+        throw new Error(`page must be a positive integer (received ${page})`);
+    }
+    if (perPage < 1 || !Number.isInteger(perPage)) {
+        throw new Error(`per_page must be a positive integer (received ${perPage})`);
+    }
+    const sortBy = options.sort_by ?? "queued_at";
+    const sortOrder = resolveSortOrder(sortBy, options.sort_order);
+    const filtered = applyReviewFilters(readReviewItems(dataDir), options);
+    const sorted = sortReviewItems(filtered, sortBy, sortOrder);
+    const offset = (page - 1) * perPage;
+    return {
+        items: sorted.slice(offset, offset + perPage),
+        total: sorted.length,
+        page,
+        per_page: perPage,
+    };
+}
+/**
+ * Resolve a review-queue selection for batch operations.
+ *
+ * - explicit ids preserve caller order
+ * - filter-driven selection uses the same filter/sort logic as list
+ * - limit applies after filter+sort for "top N" workflows
+ */
+export function selectReviewQueueItems(dataDir, options) {
+    const allItems = readReviewItems(dataDir);
+    if (options.ids && options.ids.length > 0) {
+        const byId = new Map(allItems.map((item) => [item.id, item]));
+        const items = [];
+        const missingIds = [];
+        for (const id of dedupeIds(options.ids)) {
+            const item = byId.get(id);
+            if (item) {
+                items.push(item);
+            }
+            else {
+                missingIds.push(id);
+            }
+        }
+        return {
+            items,
+            total: items.length,
+            missing_ids: missingIds,
+        };
+    }
+    const sortBy = options.sort_by ?? "queued_at";
+    const sortOrder = resolveSortOrder(sortBy, options.sort_order);
+    const filtered = applyReviewFilters(allItems, options);
+    const sorted = sortReviewItems(filtered, sortBy, sortOrder);
+    const limit = options.limit !== undefined ? Math.max(0, options.limit) : undefined;
+    return {
+        items: limit !== undefined ? sorted.slice(0, limit) : sorted,
+        total: filtered.length,
+        missing_ids: [],
+    };
+}
+//# sourceMappingURL=review-queue-index.js.map

package/dist/src/capture/review-queue-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-queue-index.js","sourceRoot":"","sources":["../../../src/capture/review-queue-index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA2C7B,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB;IAClC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAyB,EACzB,SAAgC;IAEhC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CACzB,KAA4B,EAC5B,OAA2B;IAE3B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAC7C,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,aAAa,KAAK,SAAS;YAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,aAAa,EACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,aAAa,KAAK,SAAS;YAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,aAAa,EACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,KAAK;YACL,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,EAC/D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,WAAW,KAAK,IAAI,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG;gBACf,IAAI,CAAC,OAAO;gBACZ,IAAI,CAAC,MAAM;gBACX,IAAI,CAAC,OAAO,IAAI,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aAC7B;iBACE,IAAI,CAAC,IAAI,CAAC;iBACV,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAgB,EAChB,KAAiB,EACjB,MAAyB,EACzB,SAA+B;IAE/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;SAAM,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE;YAC3D,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClD,CAAC;IAED,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAE9C,OAAO,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CACtB,KAA4B,EAC5B,MAAyB,EACzB,SAA+B;IAE/B,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACrC,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAsB;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,UAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACrD,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,iDAAiD,OAAO,GAAG,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC;IAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,IAAI;QACJ,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,OAAoC;IAEpC,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,WAAW,EAAE,UAAU;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC;IAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,OAAO;QACL,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;QAC5D,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/src/capture/review-queue.d.ts

@@ -0,0 +1,43 @@
+import { type TriageResult } from "./triage-provider.js";
+export interface ReviewItem {
+    /** Stable ID derived from session/conversation ID. */
+    id: string;
+    /** Source type (e.g., "claude_code"). */
+    source: string;
+    /** Original session/conversation ID. */
+    conversationId: string;
+    /** Triage-generated summary. */
+    summary: string;
+    /** Full conversation content. */
+    content: string;
+    /** Triage result that led to review. */
+    triage: TriageResult;
+    /** When the item was queued for review. */
+    queued_at: string;
+    /** Project context if available. */
+    project?: string;
+}
+/**
+ * Add a conversation to the review queue.
+ * Idempotent — re-adding the same conversation overwrites the file.
+ */
+export declare function addToReview(dataDir: string, item: Omit<ReviewItem, "id" | "queued_at">): Promise<ReviewItem>;
+/**
+ * List all items in the review queue.
+ * Returns items sorted by queued_at (newest first).
+ */
+export declare function listReview(dataDir: string): ReviewItem[];
+/**
+ * Get a single review item by ID.
+ */
+export declare function getReviewItem(dataDir: string, id: string): ReviewItem | null;
+/**
+ * Remove a review item (used for both promote and discard).
+ * Returns the item that was removed, or null if not found.
+ */
+export declare function removeReviewItem(dataDir: string, id: string): ReviewItem | null;
+/**
+ * Count items in the review queue.
+ */
+export declare function reviewQueueSize(dataDir: string): number;
+//# sourceMappingURL=review-queue.d.ts.map

package/dist/src/capture/review-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-queue.d.ts","sourceRoot":"","sources":["../../../src/capture/review-queue.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,GACzC,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAsBxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,UAAU,GAAG,IAAI,CAWnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,UAAU,GAAG,IAAI,CAcnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD"}