@getrift/rift 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/src/observability/tool-usage.js

@@ -40,51 +40,174 @@ export function sanitizeArgs(raw) {
 }
 // --- Result extraction ---
 /**
- * Try to extract result_count from search-tool responses.
- *
- * Slice 1: search tools now emit markdown on the text channel and put the
- * compact DTO in `structuredContent`. We read from structuredContent first
- * and fall back to JSON-parsing the text channel for backwards compatibility
- * with tools that still return JSON there.
+ * Tools whose responses carry a retrieval-size signal we can count toward
+ * `context_hits`. Explicit whitelist (not a substring match on "search") so
+ * future non-retrieval tools that happen to return a `results` array don't
+ * pollute the metric.
  */
-export function extractResultCount(tool, mcpResult) {
-    if (!tool.includes("search"))
-        return undefined;
-    const fromStructured = mcpResult.structuredContent?.["results"];
-    if (Array.isArray(fromStructured))
-        return fromStructured.length;
-    try {
-        const text = mcpResult.content[0]?.text;
-        if (!text)
+const RETRIEVAL_TOOLS = new Set([
+    "rift_search",
+    "rift_conversations_search",
+    "rift_context_pack",
+]);
+/**
+ * Per-tool extractor for `(result_count, degraded)` derived from the MCP
+ * response. Search tools expose `results: []`; context_pack exposes four
+ * named buckets we sum. Anything else returns `undefined` for both.
+ */
+function extractRetrievalSignal(tool, mcpResult) {
+    if (!RETRIEVAL_TOOLS.has(tool))
+        return {};
+    const sc = mcpResult.structuredContent;
+    const parseText = () => {
+        try {
+            const text = mcpResult.content[0]?.text;
+            if (!text)
+                return undefined;
+            const parsed = JSON.parse(text);
+            return typeof parsed === "object" && parsed !== null
+                ? parsed
+                : undefined;
+        }
+        catch {
             return undefined;
-        const parsed = JSON.parse(text);
-        if (Array.isArray(parsed.results))
-            return parsed.results.length;
+        }
+    };
+    if (tool === "rift_context_pack") {
+        // context_pack always writes structuredContent (see tools/context-pack.ts).
+        // Skip the text-channel fallback — the text is human-readable markdown,
+        // not JSON, so attempting to parse it would always fail.
+        if (!sc)
+            return {};
+        const sum = (key) => {
+            const v = sc[key];
+            return Array.isArray(v) ? v.length : 0;
+        };
+        const count = sum("decisions") + sum("constraints") + sum("examples") + sum("rules");
+        const out = { count };
+        if (typeof sc["degraded"] === "boolean")
+            out.degraded = sc["degraded"];
+        return out;
     }
-    catch {
-        // not parseable — fine
+    // Search tools: prefer structuredContent, fall back to JSON-on-text for
+    // backwards compatibility with the pre-Slice-1 response shape.
+    const fromStructured = sc?.["results"];
+    if (Array.isArray(fromStructured)) {
+        const out = {
+            count: fromStructured.length,
+        };
+        if (typeof sc?.["degraded"] === "boolean")
+            out.degraded = sc["degraded"];
+        return out;
     }
-    return undefined;
+    const parsed = parseText();
+    if (!parsed)
+        return {};
+    const out = {};
+    if (Array.isArray(parsed.results))
+        out.count = parsed.results.length;
+    if (typeof parsed.degraded === "boolean")
+        out.degraded = parsed.degraded;
+    return out;
 }
 /**
- * Try to extract degraded flag from search-tool responses.
+ * Try to extract `result_count` from a retrieval-tool response. For search
+ * tools this is `results.length`; for `rift_context_pack` it is the sum of
+ * all four bucket sizes (decisions + constraints + examples + rules).
+ * Returns `undefined` for non-retrieval tools.
+ */
+export function extractResultCount(tool, mcpResult) {
+    return extractRetrievalSignal(tool, mcpResult).count;
+}
+/**
+ * Try to extract the `degraded` flag from a retrieval-tool response.
+ * Returns `undefined` for non-retrieval tools and for retrieval tools whose
+ * response did not carry the flag.
  */
 export function extractDegraded(tool, mcpResult) {
-    if (!tool.includes("search"))
+    return extractRetrievalSignal(tool, mcpResult).degraded;
+}
+// --- rift_search metadata extraction ---
+/**
+ * Derive search-mode metadata from the raw rift_search args. Mirrors the
+ * direct-lookup gate on `/search`: `id` + (`middle` | `full`) → exact_id;
+ * anything else is ranked retrieval, even if `id` is present alongside
+ * `detail="summary"` (which doesn't trigger the strict path).
+ */
+export function deriveSearchModeMeta(args) {
+    const detail = (args["detail"] === "middle" || args["detail"] === "full"
+        ? args["detail"]
+        : "summary");
+    const id_present = typeof args["id"] === "string" && args["id"].length > 0;
+    const tier_present = typeof args["tier"] === "string" && args["tier"].length > 0;
+    const source_table_present = typeof args["source_table"] === "string" &&
+        args["source_table"].length > 0;
+    const search_mode = id_present && (detail === "middle" || detail === "full")
+        ? "exact_id"
+        : "ranked";
+    return {
+        search_mode,
+        detail,
+        id_present,
+        tier_present,
+        source_table_present,
+    };
+}
+/**
+ * Derive result-side metadata for a successful rift_search call:
+ *   - has_truncated_content: any returned hit with content_truncated=true
+ *   - max_content_tokens_estimate: max content_tokens_estimate across hits
+ *
+ * Reads from `structuredContent.results` (the canonical compact DTO).
+ * Returns `{}` when the result shape is unknown — never throws.
+ */
+export function extractSearchResultMeta(mcpResult) {
+    const results = mcpResult.structuredContent?.["results"];
+    if (!Array.isArray(results))
+        return {};
+    let truncated = false;
+    let maxTokens;
+    for (const r of results) {
+        if (!r || typeof r !== "object")
+            continue;
+        const hit = r;
+        if (hit["content_truncated"] === true)
+            truncated = true;
+        const tokens = hit["content_tokens_estimate"];
+        if (typeof tokens === "number" && (maxTokens === undefined || tokens > maxTokens)) {
+            maxTokens = tokens;
+        }
+    }
+    const out = {};
+    if (truncated)
+        out.has_truncated_content = true;
+    if (maxTokens !== undefined)
+        out.max_content_tokens_estimate = maxTokens;
+    return out;
+}
+/**
+ * Try to parse the typed error code (`id_not_found`, `ambiguous_id`, …)
+ * out of a failure response's text channel. `formatError` formats typed
+ * 404/409 bodies as `"<Prefix>: { "error": "id_not_found", … }"`, so we
+ * locate the first `{`, JSON.parse to end, and return the `error` field
+ * when it's a string. Returns `undefined` for transport-only failures
+ * (no body), untyped responses, or unparseable text.
+ */
+export function parseTypedError(text) {
+    if (!text)
+        return undefined;
+    const braceIdx = text.indexOf("{");
+    if (braceIdx < 0)
         return undefined;
-    const fromStructured = mcpResult.structuredContent?.["degraded"];
-    if (typeof fromStructured === "boolean")
-        return fromStructured;
+    const jsonPart = text.slice(braceIdx);
     try {
-        const text = mcpResult.content[0]?.text;
-        if (!text)
-            return undefined;
-        const parsed = JSON.parse(text);
-        if (typeof parsed.degraded === "boolean")
-            return parsed.degraded;
+        const parsed = JSON.parse(jsonPart);
+        const err = parsed["error"];
+        if (typeof err === "string" && err.length > 0)
+            return err;
     }
     catch {
-        // not parseable — fine
+        // not a parseable JSON tail — likely a plain transport message
     }
     return undefined;
 }
@@ -131,6 +254,38 @@ export class ToolUsageLogger {
             const deg = extractDegraded(tool, result);
             if (deg !== undefined)
                 entry.degraded = deg;
+            if (!result.isError) {
+                let textBytes = 0;
+                for (const part of result.content ?? []) {
+                    if (typeof part?.text === "string") {
+                        textBytes += Buffer.byteLength(part.text, "utf8");
+                    }
+                }
+                entry.response_text_bytes = textBytes;
+            }
+            if (tool === "rift_search") {
+                const meta = deriveSearchModeMeta(args);
+                entry.search_mode = meta.search_mode;
+                entry.detail = meta.detail;
+                entry.id_present = meta.id_present;
+                entry.tier_present = meta.tier_present;
+                entry.source_table_present = meta.source_table_present;
+                if (result.isError) {
+                    const typed = parseTypedError(result.content[0]?.text);
+                    if (typed)
+                        entry.typed_error = typed;
+                }
+                else {
+                    const resultMeta = extractSearchResultMeta(result);
+                    if (resultMeta.has_truncated_content !== undefined) {
+                        entry.has_truncated_content = resultMeta.has_truncated_content;
+                    }
+                    if (resultMeta.max_content_tokens_estimate !== undefined) {
+                        entry.max_content_tokens_estimate =
+                            resultMeta.max_content_tokens_estimate;
+                    }
+                }
+            }
             this.log(entry);
             return result;
         }, (err) => {
@@ -144,6 +299,14 @@ export class ToolUsageLogger {
                 success: false,
                 error: err instanceof Error ? err.message : String(err),
             };
+            if (tool === "rift_search") {
+                const meta = deriveSearchModeMeta(args);
+                entry.search_mode = meta.search_mode;
+                entry.detail = meta.detail;
+                entry.id_present = meta.id_present;
+                entry.tier_present = meta.tier_present;
+                entry.source_table_present = meta.source_table_present;
+            }
             this.log(entry);
             throw err;
         });

package/dist/src/observability/tool-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-usage.js","sourceRoot":"","sources":["../../../src/observability/tool-usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iBAAiB;AAEjB,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO;IACP,QAAQ;IACR,UAAU;IACV,eAAe;IACf,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAgBH,uBAAuB;AAEvB,MAAM,UAAU,YAAY,CAC1B,GAA4B;IAE5B,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC1B,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;YAC7E,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,iBAAiB,KAAK,CAAC,MAAM,GAAG,CAAC;QACtF,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,qBAAqB;gBACvD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,iBAAiB,CAAC,CAAC,MAAM,GAAG;gBAClE,CAAC,CAAC,CAAC,CACN,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4BAA4B;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,SAGC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,cAAc,GAAG,SAAS,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC,MAAM,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,SAGC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,cAAc,GAAG,SAAS,CAAC,iBAAiB,EAAE,CAAC,UAAU,CAAC,CAAC;IACjE,IAAI,OAAO,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iBAAiB;AAEjB,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IAEjC,YAAY,OAAe;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IAC1D,CAAC;IAED,2CAA2C;IAC3C,GAAG,CAAC,KAAqB;QACvB,IAAI,CAAC;YACH,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,0CAA0C;YAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,CAOF,IAAY,EACZ,IAA6B,EAC7B,OAAyB;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,OAAO,EAAE,CAAC,IAAI,CACnB,CAAC,MAAM,EAAE,EAAE;YACT,MAAM,KAAK,GAAmB;gBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,IAAI,EAAE,eAAe;gBACrB,IAAI;gBACJ,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;gBACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC9B,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO;aACzB,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;gBACxC,IAAI,OAAO;oBAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5C,IAAI,EAAE,KAAK,SAAS;gBAAE,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1C,IAAI,GAAG,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,qEAAqE;YACrE,MAAM,KAAK,GAAmB;gBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,IAAI,EAAE,eAAe;gBACrB,IAAI;gBACJ,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;gBACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,MAAM,GAAG,CAAC;QACZ,CAAC,CACF,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,OAAO;QACL,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,GAAG;iBACP,IAAI,EAAE;iBACN,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,OAAO,CAAC;iBACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAgB;IAEhB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAQ,MAAkC,CAAC,WAAW,CAAC,KAAK,QAAQ;YACpE,OAAQ,MAAkC,CAAC,MAAM,CAAC,KAAK,QAAQ;YAC/D,OAAQ,MAAkC,CAAC,SAAS,CAAC,KAAK,SAAS,EACnE,CAAC;YACD,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,MAAwB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"tool-usage.js","sourceRoot":"","sources":["../../../src/observability/tool-usage.ts"],"names":[],"mappings":"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"}

package/dist/src/observability/version-check.d.ts

@@ -0,0 +1,71 @@
+export interface VersionCheckSnapshot {
+    /** Installed version (from getBuildInfo().version). */
+    installed: string;
+    /** Latest version on the `beta` dist-tag, or null when the probe failed. */
+    latest_beta: string | null;
+    /** ISO timestamp of the probe attempt (success or failure). */
+    checked_at: string;
+    /** Compact error class on failure, or null on success. */
+    error: string | null;
+}
+export declare function versionCheckPath(dataDir: string): string;
+/**
+ * Write the snapshot atomically. Best-effort: a write failure logs to
+ * stderr but never throws — the update-check feature must not be able
+ * to break the daemon.
+ */
+export declare function writeVersionCheck(dataDir: string, snapshot: VersionCheckSnapshot): void;
+/**
+ * Read the snapshot. Returns null when the file is missing or unparseable
+ * (a missing file is the steady-state on a fresh install before the first
+ * probe runs).
+ */
+export declare function readVersionCheck(dataDir: string): VersionCheckSnapshot | null;
+/**
+ * Compare two `x.y.z-beta.N` versions. Returns:
+ *   negative if a < b
+ *   zero    if a === b
+ *   positive if a > b
+ *
+ * Anything we cannot parse is treated as equal — the status renderer
+ * uses this only to decide whether to *show* an update hint, so the
+ * conservative behavior on bad input is "don't nag."
+ *
+ * This is intentionally tiny and beta-aware rather than a full semver
+ * implementation. Our publish channel today is `x.y.z-beta.N` only.
+ */
+export declare function compareBetaVersions(a: string, b: string): number;
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/@getrift/rift";
+export declare const VERSION_CHECK_INTERVAL_MS: number;
+/**
+ * Hit the npm registry for the `beta` dist-tag. Metadata-only fetch —
+ * no auth, no headers beyond the default. Returns the resolved version
+ * or null on any failure (the caller writes the failure into the
+ * snapshot's `error` field).
+ *
+ * Test hook: `fetchFn` lets us mock the network without touching the
+ * global fetch.
+ */
+export declare function probeLatestBeta(opts?: {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<{
+    ok: true;
+    latest_beta: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Run one probe and persist the result. Pure orchestration: probe →
+ * write snapshot. On error, still writes a snapshot so the daemon's
+ * last attempt is observable.
+ */
+export declare function runVersionCheck(opts: {
+    dataDir: string;
+    installed: string;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+    now?: () => Date;
+}): Promise<VersionCheckSnapshot>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/src/observability/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../src/observability/version-check.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,oBAAoB,GAAG,IAAI,CAe7B;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAahE;AAsBD,eAAO,MAAM,gBAAgB,6CACe,CAAC;AAE7C,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAC1C,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CACjE,CA8BA;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwBhC"}

package/dist/src/observability/version-check.js

@@ -0,0 +1,198 @@
+/**
+ * Version-check lane — single-file snapshot, not append-only.
+ *
+ * Hourly, the daemon hits the npm registry for `@getrift/rift` and writes
+ * the latest `beta` dist-tag alongside the currently-installed version
+ * into `data/observability/version-check.json`. The CLI's `rift status`
+ * header reads this file (auth-gated via /status/friend) and surfaces an
+ * update-available hint when `installed` lags `latest_beta`.
+ *
+ * Privacy: the probe is metadata-only — a plain `fetch` of
+ * `https://registry.npmjs.org/@getrift/rift`. No content, no telemetry,
+ * no friend-identifying info leaves the machine. See
+ * docs/feedback/PRIVACY.md.
+ *
+ * Failure mode: probe errors are non-fatal — they are recorded in the
+ * `error` field so the renderer can stay silent. A previous successful
+ * snapshot is preserved across failures so a transient outage does not
+ * blank the update line.
+ */
+import fs from "node:fs";
+import path from "node:path";
+export function versionCheckPath(dataDir) {
+    return path.join(dataDir, "observability", "version-check.json");
+}
+/**
+ * Write the snapshot atomically. Best-effort: a write failure logs to
+ * stderr but never throws — the update-check feature must not be able
+ * to break the daemon.
+ */
+export function writeVersionCheck(dataDir, snapshot) {
+    const filePath = versionCheckPath(dataDir);
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        const tmp = `${filePath}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(snapshot, null, 2) + "\n");
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        process.stderr.write(`[version-check] write failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+/**
+ * Read the snapshot. Returns null when the file is missing or unparseable
+ * (a missing file is the steady-state on a fresh install before the first
+ * probe runs).
+ */
+export function readVersionCheck(dataDir) {
+    let raw;
+    try {
+        raw = fs.readFileSync(versionCheckPath(dataDir), "utf-8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isVersionCheckSnapshot(parsed))
+        return null;
+    return parsed;
+}
+function isVersionCheckSnapshot(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const v = value;
+    return (typeof v["installed"] === "string" &&
+        (v["latest_beta"] === null || typeof v["latest_beta"] === "string") &&
+        typeof v["checked_at"] === "string" &&
+        (v["error"] === null || typeof v["error"] === "string"));
+}
+/**
+ * Compare two `x.y.z-beta.N` versions. Returns:
+ *   negative if a < b
+ *   zero    if a === b
+ *   positive if a > b
+ *
+ * Anything we cannot parse is treated as equal — the status renderer
+ * uses this only to decide whether to *show* an update hint, so the
+ * conservative behavior on bad input is "don't nag."
+ *
+ * This is intentionally tiny and beta-aware rather than a full semver
+ * implementation. Our publish channel today is `x.y.z-beta.N` only.
+ */
+export function compareBetaVersions(a, b) {
+    if (a === b)
+        return 0;
+    const pa = parseBetaVersion(a);
+    const pb = parseBetaVersion(b);
+    if (!pa || !pb)
+        return 0;
+    if (pa.major !== pb.major)
+        return pa.major - pb.major;
+    if (pa.minor !== pb.minor)
+        return pa.minor - pb.minor;
+    if (pa.patch !== pb.patch)
+        return pa.patch - pb.patch;
+    // Stable (`x.y.z`) sorts above any prerelease of the same x.y.z.
+    if (pa.beta === null && pb.beta === null)
+        return 0;
+    if (pa.beta === null)
+        return 1;
+    if (pb.beta === null)
+        return -1;
+    return pa.beta - pb.beta;
+}
+function parseBetaVersion(v) {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)(?:-beta\.(\d+))?$/);
+    if (!m)
+        return null;
+    const major = Number(m[1]);
+    const minor = Number(m[2]);
+    const patch = Number(m[3]);
+    const beta = m[4] !== undefined ? Number(m[4]) : null;
+    if (!Number.isFinite(major) ||
+        !Number.isFinite(minor) ||
+        !Number.isFinite(patch) ||
+        (beta !== null && !Number.isFinite(beta))) {
+        return null;
+    }
+    return { major, minor, patch, beta };
+}
+export const NPM_REGISTRY_URL = "https://registry.npmjs.org/@getrift/rift";
+export const VERSION_CHECK_INTERVAL_MS = 60 * 60 * 1000;
+/**
+ * Hit the npm registry for the `beta` dist-tag. Metadata-only fetch —
+ * no auth, no headers beyond the default. Returns the resolved version
+ * or null on any failure (the caller writes the failure into the
+ * snapshot's `error` field).
+ *
+ * Test hook: `fetchFn` lets us mock the network without touching the
+ * global fetch.
+ */
+export async function probeLatestBeta(opts = {}) {
+    const f = opts.fetchFn ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    try {
+        const res = await f(NPM_REGISTRY_URL, {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok) {
+            return { ok: false, error: `registry_${res.status}` };
+        }
+        const json = (await res.json());
+        const tag = json["dist-tags"]?.["beta"];
+        if (typeof tag !== "string" || tag.length === 0) {
+            return { ok: false, error: "missing_beta_tag" };
+        }
+        return { ok: true, latest_beta: tag };
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === "TimeoutError") {
+            return { ok: false, error: "timeout" };
+        }
+        return {
+            ok: false,
+            error: err instanceof TypeError
+                ? "network"
+                : `unknown:${err instanceof Error ? err.message.slice(0, 64) : String(err).slice(0, 64)}`,
+        };
+    }
+}
+/**
+ * Run one probe and persist the result. Pure orchestration: probe →
+ * write snapshot. On error, still writes a snapshot so the daemon's
+ * last attempt is observable.
+ */
+export async function runVersionCheck(opts) {
+    const now = opts.now ? opts.now() : new Date();
+    const probeOpts = {};
+    if (opts.fetchFn)
+        probeOpts.fetchFn = opts.fetchFn;
+    if (opts.timeoutMs !== undefined)
+        probeOpts.timeoutMs = opts.timeoutMs;
+    const probe = await probeLatestBeta(probeOpts);
+    const snapshot = probe.ok
+        ? {
+            installed: opts.installed,
+            latest_beta: probe.latest_beta,
+            checked_at: now.toISOString(),
+            error: null,
+        }
+        : {
+            installed: opts.installed,
+            // Preserve the last successful probe's latest_beta across failures
+            // so a transient outage cannot blank out an already-known update.
+            // Only ever null when no probe has ever succeeded.
+            latest_beta: readVersionCheck(opts.dataDir)?.latest_beta ?? null,
+            checked_at: now.toISOString(),
+            error: probe.error,
+        };
+    writeVersionCheck(opts.dataDir, snapshot);
+    return snapshot;
+}
+//# sourceMappingURL=version-check.js.map

package/dist/src/observability/version-check.js.map

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

package/dist/src/providers/basic-metadata-extraction.d.ts

@@ -0,0 +1,60 @@
+/**
+ * BasicMetadataExtractor — deterministic, AI-free metadata for fast import.
+ *
+ * Auto-capture and historical backfill enrich conversation metadata with an
+ * LLM (Codex CLI / Ollama). That enrichment improves search but must NOT be
+ * required for a friend to import an export and search it: a missing or
+ * unauthenticated AI worker cannot block first useful recall.
+ *
+ * This extractor fills the same `ConversationMetadata` shape with safe,
+ * deterministic defaults and a non-empty topic derived from the conversation
+ * text — no network, no subprocess, never throws. Rows it produces are marked
+ * `metadata_provider = "rift-basic"` (via `getProvenance`), which is the only
+ * metadata-enrichment backfill target. Its default domain/intent/quality are
+ * intentionally generic and must not be treated as authoritative facets,
+ * filters, or ranking boosts (that retrieval-side guard is a separate slice).
+ */
+import type { MetadataExtractor, ConversationMetadata, RetryConfig, MetadataExtractionProvenance } from "./types.js";
+/** `metadata_provider` marker for deterministic basic metadata. */
+export declare const RIFT_BASIC_METADATA_PROVIDER = "rift-basic";
+/**
+ * True when a row's metadata was produced by the no-AI basic extractor.
+ * Centralized so retrieval read-boundaries share one definition rather than
+ * scattering string comparisons. Such rows carry intentionally generic
+ * placeholder `domain`/`intent`/`quality` (see the defaults below) that must
+ * NOT be surfaced as searchable facets or ranking signals — the retrieval
+ * layer drops them at read time and keeps only the real, text-derived fields
+ * (content, topics).
+ */
+export declare function isRiftBasicMetadata(provider: string | undefined): boolean;
+/**
+ * SQL `where` fragment that excludes no-AI basic rows from a metadata FACET
+ * filter (domain/intent/quality). `rift-basic` rows carry intentionally
+ * generic placeholder facets (tech/research/medium — see the defaults below)
+ * that are NOT real classifications, so an explicit facet filter must not match
+ * them: otherwise an un-enriched import surfaces as if it had been classified
+ * into a facet it never was. Single-sourced so every facet-filter path applies
+ * it identically. Deliberately NOT applied to `source`, which is real
+ * provenance even on basic rows. Only apply it to tables that carry the
+ * `metadata_provider` column (conversation tables — not digests). The provider
+ * name is a safe constant, so no SQL escaping is needed.
+ */
+export declare const RIFT_BASIC_METADATA_EXCLUSION_CLAUSE = "metadata_provider != 'rift-basic'";
+/** Used when no topic can be derived from the conversation text. */
+export declare const BASIC_TOPIC_FALLBACK = "imported conversation";
+export declare class BasicMetadataExtractor implements MetadataExtractor {
+    readonly retry: RetryConfig;
+    extractMetadata(text: string): Promise<ConversationMetadata>;
+    getProvenance(): MetadataExtractionProvenance;
+}
+/**
+ * Derive a single, non-empty topic string from conversation text without an
+ * LLM. Deterministic and cheap: prefer the first Markdown heading, else the
+ * first substantive line (role labels like "User:"/"Assistant:" stripped),
+ * trimmed to a handful of words. Always returns a non-empty string so the
+ * `topics.min(1)` contract holds even for empty/whitespace input.
+ *
+ * Exported for direct unit testing of the derivation rules.
+ */
+export declare function deriveBasicTopic(text: string): string;
+//# sourceMappingURL=basic-metadata-extraction.d.ts.map

package/dist/src/providers/basic-metadata-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-metadata-extraction.d.ts","sourceRoot":"","sources":["../../../src/providers/basic-metadata-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAGpB,mEAAmE;AACnE,eAAO,MAAM,4BAA4B,eAAe,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oCAAoC,sCAA2D,CAAC;AAE7G,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAW5D,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAwB;IAG7C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWlE,aAAa,IAAI,4BAA4B;CAO9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BrD"}