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

package/dist/src/observability/index-events.js

@@ -0,0 +1,148 @@
+/**
+ * Index-events lane — append-only JSONL.
+ *
+ * One row per write boundary against LanceDB (`table.add(...)`). This
+ * complements `embedding-events.jsonl`: the embedding lane proves the
+ * vector was produced, this lane proves the row was actually persisted
+ * to LanceDB and is searchable. Without it, `/status/friend` cannot
+ * distinguish "embedded but not indexed yet" from "fully searchable".
+ *
+ * Provider-agnostic and table-agnostic: `table` and `pipeline` are
+ * payload fields. Reads / search queries are deliberately NOT wrapped —
+ * they're not write events and would muddy `index.last_update_at`.
+ *
+ * Failure mode: writes are best-effort and never throw — observability
+ * must not break indexing. The reader is tolerant of bad lines so one
+ * corrupt row doesn't blank the status dashboard.
+ */
+import fs from "node:fs";
+import path from "node:path";
+const MAX_ERROR_MESSAGE_LEN = 512;
+export function indexEventsFilePath(dataDir) {
+    return path.join(dataDir, "observability", "index-events.jsonl");
+}
+/**
+ * Append a single event to the lane. Never throws — telemetry must not
+ * break indexing. On filesystem error, writes a single stderr line so
+ * the failure is at least visible to operators tailing logs.
+ */
+export function appendIndexEvent(dataDir, event) {
+    const filePath = indexEventsFilePath(dataDir);
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.appendFileSync(filePath, JSON.stringify(event) + "\n");
+    }
+    catch (err) {
+        process.stderr.write(`[index-events] write failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+/**
+ * Run a LanceDB write and record one event. Re-throws errors so the
+ * caller's existing failure-handling path is unchanged; logging is a
+ * pure side effect.
+ *
+ * Use this only at write boundaries (`table.add(...)`). Do NOT use it
+ * for reads, queries, or deletes — keeping the lane write-only is what
+ * makes `last_update_at` meaningful.
+ */
+export async function recordIndexWrite(dataDir, ctx, fn) {
+    const start = Date.now();
+    const phase = ctx.phase ?? "live";
+    try {
+        const result = await fn();
+        appendIndexEvent(dataDir, {
+            ts: new Date().toISOString(),
+            table: ctx.table,
+            pipeline: ctx.pipeline,
+            operation: ctx.operation,
+            outcome: "success",
+            row_count: ctx.row_count,
+            ms: Date.now() - start,
+            phase,
+        });
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        appendIndexEvent(dataDir, {
+            ts: new Date().toISOString(),
+            table: ctx.table,
+            pipeline: ctx.pipeline,
+            operation: ctx.operation,
+            outcome: "error",
+            row_count: ctx.row_count,
+            ms: Date.now() - start,
+            phase,
+            error_class: classifyError(err),
+            error_message: message.slice(0, MAX_ERROR_MESSAGE_LEN),
+        });
+        throw err;
+    }
+}
+/**
+ * Best-effort classification for the `error_class` field. LanceDB
+ * surfaces schema mismatches, IO errors, and lock contention with
+ * different shapes — pick a coarse class so dashboards can group.
+ */
+function classifyError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const lower = msg.toLowerCase();
+    if (lower.includes("schema"))
+        return "schema_mismatch";
+    if (lower.includes("lock") || lower.includes("conflict"))
+        return "lock_conflict";
+    if (lower.includes("enoent") || lower.includes("eacces") || lower.includes("eio")) {
+        return "io";
+    }
+    if (err instanceof TypeError)
+        return "type";
+    return "unknown";
+}
+/**
+ * Tolerant reader. One bad JSON line is skipped; the rest are returned.
+ * Returns [] if the file is missing.
+ */
+export function readIndexEvents(dataDir) {
+    let raw;
+    try {
+        raw = fs.readFileSync(indexEventsFilePath(dataDir), "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!isIndexEvent(parsed))
+            continue;
+        out.push(parsed);
+    }
+    return out;
+}
+function isIndexEvent(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const v = value;
+    if (!(typeof v["ts"] === "string" &&
+        typeof v["table"] === "string" &&
+        typeof v["pipeline"] === "string" &&
+        typeof v["operation"] === "string" &&
+        (v["outcome"] === "success" || v["outcome"] === "error") &&
+        typeof v["row_count"] === "number" &&
+        typeof v["ms"] === "number")) {
+        return false;
+    }
+    const phase = v["phase"];
+    if (phase !== undefined && phase !== "live" && phase !== "shadow")
+        return false;
+    return true;
+}
+//# sourceMappingURL=index-events.js.map

package/dist/src/observability/index-events.js.map

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

package/dist/src/observability/onboarding-metric.d.ts

@@ -0,0 +1,131 @@
+/** MCP retrieval tools that can satisfy the end-event condition. */
+export declare const RETRIEVAL_TOOLS: Set<string>;
+export type RetrievalTool = "rift_search" | "rift_conversations_search" | "rift_context_pack";
+export interface OnboardingMetric {
+    install_id: string;
+    useful_state_reached_at: string | null;
+    first_useful_recall_at: string | null;
+    first_useful_recall_tool: RetrievalTool | null;
+}
+export type OnboardingState = {
+    state: "hidden";
+} | {
+    state: "pending";
+    useful_state_reached_at: string;
+} | {
+    state: "completed";
+    useful_state_reached_at: string;
+    first_useful_recall_at: string;
+    first_useful_recall_tool: RetrievalTool;
+    duration_seconds: number;
+};
+export declare function onboardingMetricPath(dataDir: string): string;
+/**
+ * Read-or-bootstrap. A missing/corrupt file is replaced with a fresh
+ * record whose `install_id` is a new UUID. Unknown fields in an existing
+ * file are dropped on the next write (sanitizer drops everything outside
+ * the fixed key set).
+ */
+export declare function readOnboardingMetric(dataDir: string): OnboardingMetric;
+export interface ReadinessSignals {
+    daemonHealthy: boolean;
+    voyageKeyValid: boolean;
+    /**
+     * True when the install is in the intentional no-key local mode (no Voyage
+     * key present), so keyword/lexical search is the active retrieval surface.
+     * A no-key install that has imported content IS useful — it can search its
+     * archive — even though semantic search is off. Distinct from
+     * `voyageKeyValid`: a key that is PRESENT but never round-tripped is a broken
+     * setup, not intentional local mode, so it sets neither flag.
+     */
+    lexicalModeAvailable: boolean;
+    indexedCount: number;
+}
+/**
+ * Useful state = the product delivered first value: the daemon is healthy,
+ * there is indexed content to retrieve, AND at least one working retrieval
+ * surface — semantic (valid Voyage embeddings) OR keyword (intentional no-key
+ * lexical mode). Gating on Voyage alone would make the shipped no-key path
+ * never count as activated, skewing beta telemetry.
+ */
+export declare function isUsefulStateReached(signals: ReadinessSignals): boolean;
+/**
+ * Stamp `useful_state_reached_at` if (a) readiness is observed and
+ * (b) the field is still null. No-op otherwise. Returns the (possibly
+ * updated) record.
+ */
+export declare function stampUsefulStateIfReady(dataDir: string, opts: {
+    ready: boolean;
+    now: string;
+}): OnboardingMetric;
+/**
+ * Stamp `first_useful_recall_*` if eligible. Eligibility:
+ *   1. tool is one of `RETRIEVAL_TOOLS`
+ *   2. response was not degraded
+ *   3. response had at least one hit
+ *   4. `first_useful_recall_at` is still null (write-once)
+ *   5. `useful_state_reached_at` was already observed (non-null)
+ *
+ * The metric measures "first MCP retrieval *after* start." If start
+ * has not been observed yet, end stamping is skipped — recording an
+ * end alongside a synthesised start would report a near-zero duration
+ * that doesn't reflect a real "from readiness to first useful recall"
+ * measurement. Callers that want to avoid dropping the first real
+ * recall should evaluate readiness via the shared helper
+ * (`stampOnboardingStartIfReady` on the daemon, exposed through
+ * `/status/friend`) before invoking this function.
+ */
+export declare function stampFirstUsefulRecallIfEligible(dataDir: string, opts: {
+    tool: string;
+    isDegraded: boolean;
+    hitCount: number;
+    now: string;
+}): OnboardingMetric;
+/**
+ * Project the persisted metric to the three rendering states the
+ * status surface needs. Hidden = no start yet (don't show the line at
+ * all). Pending = start, no end. Completed = both, with a derived
+ * `duration_seconds`.
+ */
+export declare function computeOnboardingState(metric: OnboardingMetric): OnboardingState;
+/**
+ * MCP-side bridge between a finished retrieval-tool call and the
+ * end-event stamper. Mirrors the extractor logic in
+ * `observability/tool-usage.ts` for `result_count` and `degraded`, but
+ * stays self-contained so this module has no dependency on the logger.
+ *
+ * Readiness handshake: end stamping requires `useful_state_reached_at`
+ * to already be set (the metric is "first MCP retrieval *after*
+ * start", per the v1 spec). When the recorder finds start still null
+ * but the response is otherwise eligible, it invokes the optional
+ * `pingReadiness` callback (the MCP wrapper passes one that GETs
+ * `/status/friend` on the daemon, which evaluates readiness signals
+ * and stamps start lazily). After the ping returns, the metric is
+ * re-read and end is stamped only if start has now landed. When no
+ * callback is provided, or readiness still cannot be observed, the
+ * end event is silently dropped — that matches the contract that
+ * end-without-start would otherwise misreport as a near-zero duration.
+ *
+ * Never throws: persistence errors and ping errors are swallowed so
+ * onboarding telemetry can never break a tool call. CLI callers do not
+ * invoke this helper (it lives behind the MCP server's tool
+ * registration), so the "MCP-only end" constraint is enforced by
+ * construction.
+ */
+export declare function recordMcpRetrievalForOnboarding(dataDir: string, tool: string, mcpResult: {
+    content?: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+}, opts?: {
+    now?: string;
+    pingReadiness?: () => Promise<void>;
+}): Promise<void>;
+/**
+ * Render a duration like `7m 42s` / `1h 03m 17s` / `12s`. Used by the
+ * friend-status header so the value reads in human time, not seconds.
+ */
+export declare function formatOnboardingDuration(totalSeconds: number): string;
+//# sourceMappingURL=onboarding-metric.d.ts.map

package/dist/src/observability/onboarding-metric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-metric.d.ts","sourceRoot":"","sources":["../../../src/observability/onboarding-metric.ts"],"names":[],"mappings":"AA4BA,oEAAoE;AACpE,eAAO,MAAM,eAAe,aAI1B,CAAC;AAEH,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,2BAA2B,GAC3B,mBAAmB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,wBAAwB,EAAE,aAAa,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,uBAAuB,EAAE,MAAM,CAAA;CAAE,GACrD;IACE,KAAK,EAAE,WAAW,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,aAAa,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAwCtE;AAuBD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC,gBAAgB,CAUlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,GACA,gBAAgB,CAclB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,GACvB,eAAe,CAwBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE;IACT,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,EACD,IAAI,GAAE;IACJ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,GACL,OAAO,CAAC,IAAI,CAAC,CA+Df;AAuDD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAYrE"}

package/dist/src/observability/onboarding-metric.js

@@ -0,0 +1,351 @@
+/**
+ * `time_to_first_useful_recall` v1 instrumentation.
+ *
+ * Persists exactly four fields under `<data_dir>/metrics/onboarding.json`:
+ *   - install_id                  (random UUID, minted on first read)
+ *   - useful_state_reached_at     (ISO timestamp or null)
+ *   - first_useful_recall_at      (ISO timestamp or null)
+ *   - first_useful_recall_tool    (one of the three retrieval tools)
+ *
+ * Privacy contract: query text, response text, hit IDs, source paths and
+ * client identifiers MUST NEVER land in this file. Writes go through a
+ * fixed-key sanitizer so an upstream caller that hands in extra fields
+ * cannot leak them by accident. Tests assert the persisted shape.
+ *
+ * Write-once: once a field is set, it is never overwritten. End
+ * stamping (`first_useful_recall_*`) requires `useful_state_reached_at`
+ * to have already been observed by a real readiness check — the metric's
+ * definition is "first MCP retrieval *after start*", so a recorded end
+ * without a prior recorded start would lie about the latency. If start
+ * is null when end fires, the end is dropped. To avoid losing the first
+ * real recall, callers should evaluate readiness via
+ * `stampOnboardingStartIfReady` (the shared helper used by
+ * `/status/friend`) before invoking the end-event recorder.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+/** MCP retrieval tools that can satisfy the end-event condition. */
+export const RETRIEVAL_TOOLS = new Set([
+    "rift_search",
+    "rift_conversations_search",
+    "rift_context_pack",
+]);
+export function onboardingMetricPath(dataDir) {
+    return path.join(dataDir, "metrics", "onboarding.json");
+}
+function isRetrievalTool(v) {
+    return typeof v === "string" && RETRIEVAL_TOOLS.has(v);
+}
+/**
+ * Read-or-bootstrap. A missing/corrupt file is replaced with a fresh
+ * record whose `install_id` is a new UUID. Unknown fields in an existing
+ * file are dropped on the next write (sanitizer drops everything outside
+ * the fixed key set).
+ */
+export function readOnboardingMetric(dataDir) {
+    const file = onboardingMetricPath(dataDir);
+    let parsed;
+    try {
+        const raw = fs.readFileSync(file, "utf8");
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj === "object") {
+            parsed = obj;
+        }
+    }
+    catch {
+        // missing or unreadable — fall through to bootstrap
+    }
+    if (!parsed ||
+        typeof parsed["install_id"] !== "string" ||
+        parsed["install_id"].length === 0) {
+        const fresh = {
+            install_id: randomUUID(),
+            useful_state_reached_at: null,
+            first_useful_recall_at: null,
+            first_useful_recall_tool: null,
+        };
+        writeOnboardingMetric(dataDir, fresh);
+        return fresh;
+    }
+    return {
+        install_id: parsed["install_id"],
+        useful_state_reached_at: typeof parsed["useful_state_reached_at"] === "string"
+            ? parsed["useful_state_reached_at"]
+            : null,
+        first_useful_recall_at: typeof parsed["first_useful_recall_at"] === "string"
+            ? parsed["first_useful_recall_at"]
+            : null,
+        first_useful_recall_tool: isRetrievalTool(parsed["first_useful_recall_tool"])
+            ? parsed["first_useful_recall_tool"]
+            : null,
+    };
+}
+/**
+ * Persist the metric. The sanitizer copies exactly four named fields —
+ * anything else a caller might have spliced onto the object is discarded
+ * before it touches disk. This is the privacy guard that the schema
+ * test pins.
+ */
+function writeOnboardingMetric(dataDir, metric) {
+    const file = onboardingMetricPath(dataDir);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const sanitized = {
+        install_id: metric.install_id,
+        useful_state_reached_at: metric.useful_state_reached_at,
+        first_useful_recall_at: metric.first_useful_recall_at,
+        first_useful_recall_tool: metric.first_useful_recall_tool,
+    };
+    fs.writeFileSync(file, JSON.stringify(sanitized, null, 2));
+}
+/**
+ * Useful state = the product delivered first value: the daemon is healthy,
+ * there is indexed content to retrieve, AND at least one working retrieval
+ * surface — semantic (valid Voyage embeddings) OR keyword (intentional no-key
+ * lexical mode). Gating on Voyage alone would make the shipped no-key path
+ * never count as activated, skewing beta telemetry.
+ */
+export function isUsefulStateReached(signals) {
+    return (signals.daemonHealthy &&
+        (signals.voyageKeyValid || signals.lexicalModeAvailable) &&
+        signals.indexedCount >= 1);
+}
+/**
+ * Stamp `useful_state_reached_at` if (a) readiness is observed and
+ * (b) the field is still null. No-op otherwise. Returns the (possibly
+ * updated) record.
+ */
+export function stampUsefulStateIfReady(dataDir, opts) {
+    const current = readOnboardingMetric(dataDir);
+    if (current.useful_state_reached_at !== null)
+        return current;
+    if (!opts.ready)
+        return current;
+    const next = {
+        ...current,
+        useful_state_reached_at: opts.now,
+    };
+    writeOnboardingMetric(dataDir, next);
+    return next;
+}
+/**
+ * Stamp `first_useful_recall_*` if eligible. Eligibility:
+ *   1. tool is one of `RETRIEVAL_TOOLS`
+ *   2. response was not degraded
+ *   3. response had at least one hit
+ *   4. `first_useful_recall_at` is still null (write-once)
+ *   5. `useful_state_reached_at` was already observed (non-null)
+ *
+ * The metric measures "first MCP retrieval *after* start." If start
+ * has not been observed yet, end stamping is skipped — recording an
+ * end alongside a synthesised start would report a near-zero duration
+ * that doesn't reflect a real "from readiness to first useful recall"
+ * measurement. Callers that want to avoid dropping the first real
+ * recall should evaluate readiness via the shared helper
+ * (`stampOnboardingStartIfReady` on the daemon, exposed through
+ * `/status/friend`) before invoking this function.
+ */
+export function stampFirstUsefulRecallIfEligible(dataDir, opts) {
+    const current = readOnboardingMetric(dataDir);
+    if (!RETRIEVAL_TOOLS.has(opts.tool))
+        return current;
+    if (opts.isDegraded)
+        return current;
+    if (opts.hitCount < 1)
+        return current;
+    if (current.first_useful_recall_at !== null)
+        return current;
+    if (current.useful_state_reached_at === null)
+        return current;
+    const next = {
+        ...current,
+        first_useful_recall_at: opts.now,
+        first_useful_recall_tool: opts.tool,
+    };
+    writeOnboardingMetric(dataDir, next);
+    return next;
+}
+/**
+ * Project the persisted metric to the three rendering states the
+ * status surface needs. Hidden = no start yet (don't show the line at
+ * all). Pending = start, no end. Completed = both, with a derived
+ * `duration_seconds`.
+ */
+export function computeOnboardingState(metric) {
+    if (!metric.useful_state_reached_at)
+        return { state: "hidden" };
+    if (!metric.first_useful_recall_at ||
+        !metric.first_useful_recall_tool) {
+        return {
+            state: "pending",
+            useful_state_reached_at: metric.useful_state_reached_at,
+        };
+    }
+    const startMs = Date.parse(metric.useful_state_reached_at);
+    const endMs = Date.parse(metric.first_useful_recall_at);
+    const duration_seconds = Number.isNaN(startMs) || Number.isNaN(endMs)
+        ? 0
+        : Math.max(0, Math.round((endMs - startMs) / 1000));
+    return {
+        state: "completed",
+        useful_state_reached_at: metric.useful_state_reached_at,
+        first_useful_recall_at: metric.first_useful_recall_at,
+        first_useful_recall_tool: metric.first_useful_recall_tool,
+        duration_seconds,
+    };
+}
+/**
+ * MCP-side bridge between a finished retrieval-tool call and the
+ * end-event stamper. Mirrors the extractor logic in
+ * `observability/tool-usage.ts` for `result_count` and `degraded`, but
+ * stays self-contained so this module has no dependency on the logger.
+ *
+ * Readiness handshake: end stamping requires `useful_state_reached_at`
+ * to already be set (the metric is "first MCP retrieval *after*
+ * start", per the v1 spec). When the recorder finds start still null
+ * but the response is otherwise eligible, it invokes the optional
+ * `pingReadiness` callback (the MCP wrapper passes one that GETs
+ * `/status/friend` on the daemon, which evaluates readiness signals
+ * and stamps start lazily). After the ping returns, the metric is
+ * re-read and end is stamped only if start has now landed. When no
+ * callback is provided, or readiness still cannot be observed, the
+ * end event is silently dropped — that matches the contract that
+ * end-without-start would otherwise misreport as a near-zero duration.
+ *
+ * Never throws: persistence errors and ping errors are swallowed so
+ * onboarding telemetry can never break a tool call. CLI callers do not
+ * invoke this helper (it lives behind the MCP server's tool
+ * registration), so the "MCP-only end" constraint is enforced by
+ * construction.
+ */
+export async function recordMcpRetrievalForOnboarding(dataDir, tool, mcpResult, opts = {}) {
+    if (!RETRIEVAL_TOOLS.has(tool))
+        return;
+    if (mcpResult.isError)
+        return;
+    const initialNow = opts.now ?? new Date().toISOString();
+    try {
+        const signal = extractRetrievalSignal(tool, mcpResult);
+        if (signal.count === undefined)
+            return;
+        if (signal.degraded === true)
+            return;
+        if (signal.count < 1)
+            return;
+        // Cheap pre-check: if end is already stamped, skip everything
+        // (write-once means stampFirstUsefulRecallIfEligible would no-op
+        // anyway, but bailing here avoids a needless readiness ping).
+        let current = readOnboardingMetric(dataDir);
+        if (current.first_useful_recall_at !== null)
+            return;
+        // Readiness handshake: only when start is missing AND a ping is
+        // available. The end-condition (non-degraded, ≥ 1 hit) strictly
+        // implies the start-conditions hold in the wider system, but we
+        // still want the daemon to do the formal readiness observation
+        // (env present + last_embed_at + capability counts) before
+        // recording an end timestamp — otherwise the metric would lie
+        // about its own definition.
+        if (current.useful_state_reached_at === null && opts.pingReadiness) {
+            try {
+                await opts.pingReadiness();
+            }
+            catch {
+                // Ping failures degrade to "skip end this time" rather than
+                // breaking the tool call. The next eligible retrieval will
+                // re-attempt the ping.
+            }
+            // Re-read so the ordering clamp below sees the freshly stamped
+            // start (if any) before we record end.
+            current = readOnboardingMetric(dataDir);
+        }
+        // Ordering clamp: the metric measures "first MCP retrieval *after*
+        // start", so `first_useful_recall_at` must never be earlier than
+        // `useful_state_reached_at`. When the readiness ping above lazily
+        // stamps start during this same call, the retrieval `now` captured
+        // before the ping can be older than the freshly written start —
+        // recording the older `now` as end would produce an inverted pair
+        // that the duration projection then silently clamps to 0s, hiding
+        // the bug. Take the max so the persisted end is always >= start.
+        let now = initialNow;
+        if (current.useful_state_reached_at !== null &&
+            now < current.useful_state_reached_at) {
+            now = current.useful_state_reached_at;
+        }
+        stampFirstUsefulRecallIfEligible(dataDir, {
+            tool,
+            isDegraded: false,
+            hitCount: signal.count,
+            now,
+        });
+    }
+    catch {
+        // Telemetry must never break tool execution.
+    }
+}
+/**
+ * Per-tool `(count, degraded)` extraction. Duplicated from
+ * `tool-usage.ts` rather than imported to avoid circular dependency
+ * risk and to keep this module's contract narrow.
+ */
+function extractRetrievalSignal(tool, mcpResult) {
+    const sc = mcpResult.structuredContent;
+    if (tool === "rift_context_pack") {
+        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;
+    }
+    // search-style tools: prefer structuredContent.results, fall back to JSON-in-text.
+    const fromStructured = sc?.["results"];
+    if (Array.isArray(fromStructured)) {
+        const out = {
+            count: fromStructured.length,
+        };
+        if (typeof sc?.["degraded"] === "boolean") {
+            out.degraded = sc["degraded"];
+        }
+        return out;
+    }
+    try {
+        const text = mcpResult.content?.[0]?.text;
+        if (!text)
+            return {};
+        const parsed = JSON.parse(text);
+        const out = {};
+        if (Array.isArray(parsed["results"])) {
+            out.count = parsed["results"].length;
+        }
+        if (typeof parsed["degraded"] === "boolean") {
+            out.degraded = parsed["degraded"];
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Render a duration like `7m 42s` / `1h 03m 17s` / `12s`. Used by the
+ * friend-status header so the value reads in human time, not seconds.
+ */
+export function formatOnboardingDuration(totalSeconds) {
+    const s = Math.max(0, Math.floor(totalSeconds));
+    const hours = Math.floor(s / 3600);
+    const minutes = Math.floor((s % 3600) / 60);
+    const seconds = s % 60;
+    if (hours > 0) {
+        return `${hours}h ${String(minutes).padStart(2, "0")}m ${String(seconds).padStart(2, "0")}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${String(seconds).padStart(2, "0")}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=onboarding-metric.js.map

package/dist/src/observability/onboarding-metric.js.map

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