@getrift/rift 0.0.0 → 0.1.0-beta.1

package/dist/src/observability/coverage.js

@@ -0,0 +1,180 @@
+import { getTable, TABLE_NAMES } from "../storage/tables.js";
+import { isUnverifiedHealthy, isManualStale, isScanFreshnessMet, isWatcherHealthy, } from "./staleness.js";
+// --- Table stats ---
+export async function getTableStats() {
+    const countEntries = await Promise.all(TABLE_NAMES.map(async (name) => [name, await getTable(name).countRows()]));
+    const countMap = Object.fromEntries(countEntries);
+    const sdTable = getTable("structured_docs");
+    const sdRows = (await sdTable.query().toArray());
+    // Also check structured_docs_local for last_indexed
+    const sdLocalTable = getTable("structured_docs_local");
+    const sdLocalRows = (await sdLocalTable.query().toArray());
+    let lastIndexed = null;
+    for (const row of [...sdRows, ...sdLocalRows]) {
+        if (row.indexed_at && (!lastIndexed || row.indexed_at > lastIndexed)) {
+            lastIndexed = row.indexed_at;
+        }
+    }
+    const sdCount = (countMap["structured_docs"] ?? 0) + (countMap["structured_docs_local"] ?? 0);
+    const hotCount = countMap["conversations_hot"] ?? 0;
+    const coldCount = countMap["conversations_cold"] ?? 0;
+    const digestCount = countMap["digests"] ?? 0;
+    return {
+        structured_docs: { count: sdCount, last_indexed: lastIndexed },
+        conversations_hot: { count: hotCount },
+        conversations_cold: { count: coldCount },
+        digests: { count: digestCount },
+        conversation_artifacts_total: hotCount + coldCount + digestCount,
+    };
+}
+// --- Source coverage ---
+const SAVE_SOURCES = ["claude_code", "gemini_cli", "codex_cli"];
+const MANUAL_SOURCES = ["claude_web", "grok_web", "gemini_web"];
+export async function getSourceCoverage(deps) {
+    const { config, scanner, watchers, capabilities } = deps;
+    const maintenanceState = deps.getMaintenanceState();
+    const effectiveNow = maintenanceState.active && maintenanceState.startedAt
+        ? maintenanceState.startedAt
+        : new Date();
+    // --- Verified: filesystem_watched ---
+    let watchedStatus;
+    if (!capabilities.watchEnabled) {
+        watchedStatus = { indexed_files: 0, healthy: true };
+    }
+    else {
+        const cloudRows = await getTable("structured_docs")
+            .query()
+            .where("source_type = 'filesystem_watched'")
+            .toArray();
+        const localRows = await getTable("structured_docs_local")
+            .query()
+            .where("source_type = 'filesystem_watched'")
+            .toArray();
+        watchedStatus = {
+            indexed_files: cloudRows.length + localRows.length,
+            healthy: isWatcherHealthy(watchers, maintenanceState.active),
+        };
+    }
+    // --- Verified: filesystem_scheduled_scan ---
+    let scanStatus;
+    if (!capabilities.scanEnabled) {
+        scanStatus = {
+            indexed_files: 0,
+            last_scan_at: null,
+            next_scan_at: null,
+            scan_schedule: "none",
+            freshness_slo_met: true,
+        };
+    }
+    else {
+        const cloudScanRows = await getTable("structured_docs")
+            .query()
+            .where("source_type = 'filesystem_scheduled_scan'")
+            .toArray();
+        const localScanRows = await getTable("structured_docs_local")
+            .query()
+            .where("source_type = 'filesystem_scheduled_scan'")
+            .toArray();
+        const rows = [...cloudScanRows, ...localScanRows];
+        const scanState = scanner?.scanState ?? {
+            last_scan_at: null,
+            next_scan_at: null,
+        };
+        scanStatus = {
+            indexed_files: rows.length,
+            last_scan_at: scanState.last_scan_at,
+            next_scan_at: scanState.next_scan_at,
+            scan_schedule: `every ${config.scan.interval_seconds}s`,
+            freshness_slo_met: isScanFreshnessMet(scanState.last_scan_at, config.scan.interval_seconds, effectiveNow),
+        };
+    }
+    // --- Conversation source timestamps ---
+    const hotRows = (await getTable("conversations_hot")
+        .query()
+        .toArray());
+    const coldRows = (await getTable("conversations_cold")
+        .query()
+        .toArray());
+    const allConvRows = [...hotRows, ...coldRows];
+    const lastTimestampBySource = new Map();
+    for (const row of allConvRows) {
+        const src = row.source;
+        const existing = lastTimestampBySource.get(src);
+        if (!existing || row.indexed_at > existing) {
+            lastTimestampBySource.set(src, row.indexed_at);
+        }
+    }
+    // --- Unverified sources ---
+    function buildUnverifiedStatus(source) {
+        if (!capabilities.supportedSources.has(source)) {
+            return { last_save: null, healthy: true };
+        }
+        const lastSave = lastTimestampBySource.get(source) ?? null;
+        const result = isUnverifiedHealthy(lastSave, effectiveNow);
+        return {
+            last_save: lastSave,
+            healthy: result.healthy,
+            ...(result.warning ? { warning: result.warning } : {}),
+        };
+    }
+    // --- Manual sources ---
+    function buildManualStatus(source) {
+        if (!capabilities.supportedSources.has(source)) {
+            return { last_ingest: null, stale: false };
+        }
+        const lastIngest = lastTimestampBySource.get(source) ?? null;
+        return {
+            last_ingest: lastIngest,
+            stale: isManualStale(lastIngest, effectiveNow),
+        };
+    }
+    // --- Inbox ---
+    let inboxStatus;
+    if (!capabilities.inboxEnabled) {
+        inboxStatus = { last_processed: null, healthy: true };
+    }
+    else {
+        const lastProcessed = lastTimestampBySource.get("inbox") ?? null;
+        const result = isUnverifiedHealthy(lastProcessed, effectiveNow);
+        inboxStatus = {
+            last_processed: lastProcessed,
+            healthy: result.healthy,
+            ...(result.warning
+                ? { warning: result.warning.replace("saves", "inbox activity") }
+                : {}),
+        };
+    }
+    return {
+        verified_autonomous: {
+            filesystem_watched: watchedStatus,
+            filesystem_scheduled_scan: scanStatus,
+        },
+        unverified_autonomous: {
+            claude_code: buildUnverifiedStatus("claude_code"),
+            gemini_cli: buildUnverifiedStatus("gemini_cli"),
+            codex_cli: buildUnverifiedStatus("codex_cli"),
+            inbox: inboxStatus,
+        },
+        manual: {
+            claude_web: buildManualStatus("claude_web"),
+            grok_web: buildManualStatus("grok_web"),
+            gemini_web: buildManualStatus("gemini_web"),
+        },
+    };
+}
+// --- Automation gate ---
+export function computeAutomationGate(coverage) {
+    return {
+        verified_sources_healthy: coverage.verified_autonomous.filesystem_watched.healthy &&
+            coverage.verified_autonomous.filesystem_scheduled_scan.freshness_slo_met,
+        note: "Includes both filesystem_watched and filesystem_scheduled_scan types.",
+    };
+}
+// --- Full stats orchestrator ---
+export async function buildFullStats(deps) {
+    const tables = await getTableStats();
+    const source_coverage = await getSourceCoverage(deps);
+    const automation_gate = computeAutomationGate(source_coverage);
+    return { tables, source_coverage, automation_gate };
+}
+//# sourceMappingURL=coverage.js.map

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

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

package/dist/src/observability/rift-context.d.ts

@@ -0,0 +1,47 @@
+export interface CapabilityCounts {
+    /** Total structured documents across cloud + local tables. */
+    structured_docs: number;
+    /** Hot tier conversation rows. */
+    conversations_hot: number;
+    /** Cold tier conversation rows. */
+    conversations_cold: number;
+    /** Digest summary rows. */
+    digests: number;
+}
+export interface CapabilityMapOptions {
+    maintenanceActive?: boolean;
+}
+/**
+ * Hard character cap enforced in tests. 2400 chars is a conservative
+ * ceiling for the plan's 600-token target at ~4 chars/token for
+ * English markdown. Keep the rendered output well below this.
+ */
+export declare const CAPABILITY_MAP_MAX_CHARS = 2400;
+/** Plan-level token target (see PLAN.MD "Capability Map Contract"). */
+export declare const CAPABILITY_MAP_MAX_TOKENS = 600;
+/**
+ * Rough token estimate. Not a tokenizer — uses chars/4 rounded up,
+ * a documented approximation suitable for a size guard. If a real
+ * tokenizer is later added to the repo, swap this implementation.
+ */
+export declare function approxTokenCount(text: string): number;
+/**
+ * Fetch the counts the capability map needs. Uses `countRows()` only
+ * (no full-table `.toArray()` walks). Callers get a small, cheap
+ * object; failures propagate so the route can decide how to respond.
+ */
+export declare function getCapabilityCounts(): Promise<CapabilityCounts>;
+/**
+ * Generate the capability-map markdown from cheap counts.
+ * Deterministic for identical input; regenerated on each request
+ * (no TTL cache in Phase 1).
+ */
+export declare function generateCapabilityMap(counts: CapabilityCounts, opts?: CapabilityMapOptions): string;
+/**
+ * Write the capability map to `{dataDir}/rift-context.md`.
+ * Best-effort — returns { written: false } on failure without throwing.
+ */
+export declare function writeRiftContext(dataDir: string, capabilityMap: string): Promise<{
+    written: boolean;
+}>;
+//# sourceMappingURL=rift-context.d.ts.map

package/dist/src/observability/rift-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rift-context.d.ts","sourceRoot":"","sources":["../../../src/observability/rift-context.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAcrE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,MAAM,CAqER;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAU/B"}

package/dist/src/observability/rift-context.js

@@ -0,0 +1,118 @@
+/**
+ * Generates the Zero-Prompt Awareness capability map served by
+ * GET /status, MCP rift_status, and CLI `status`, and writes the
+ * `rift-context.md` flat file as a side effect.
+ *
+ * Phase 1 contract (Slice 2):
+ * - introduces Rift as a capability, not a preloaded prompt
+ * - names the three available memory classes: conversations, digests,
+ *   structured documents
+ * - names the three existing tools and when to use each
+ * - keeps infra metrics secondary (inline counts only)
+ *
+ * Size budget:
+ *   PLAN.MD's Capability Map Contract targets `<= 600 tokens` for the
+ *   markdown form. No tokenizer ships in-repo, so Phase 1 enforces a
+ *   measurable char-based proxy plus a rough chars/4 token estimate.
+ *   Both bounds are comfortably conservative relative to the plan's
+ *   intent and are validated by the test suite.
+ *
+ * Data dependency:
+ *   Generation needs only cheap per-table `countRows()` calls; it must
+ *   not depend on full source-coverage scans (`.toArray()` walks). This
+ *   keeps `/status` fast and keeps it working when secondary
+ *   observability/source-health collection fails.
+ */
+import { atomicWrite } from "../storage/atomic.js";
+import { getTable } from "../storage/tables.js";
+import path from "node:path";
+/**
+ * Hard character cap enforced in tests. 2400 chars is a conservative
+ * ceiling for the plan's 600-token target at ~4 chars/token for
+ * English markdown. Keep the rendered output well below this.
+ */
+export const CAPABILITY_MAP_MAX_CHARS = 2400;
+/** Plan-level token target (see PLAN.MD "Capability Map Contract"). */
+export const CAPABILITY_MAP_MAX_TOKENS = 600;
+/**
+ * Rough token estimate. Not a tokenizer — uses chars/4 rounded up,
+ * a documented approximation suitable for a size guard. If a real
+ * tokenizer is later added to the repo, swap this implementation.
+ */
+export function approxTokenCount(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Fetch the counts the capability map needs. Uses `countRows()` only
+ * (no full-table `.toArray()` walks). Callers get a small, cheap
+ * object; failures propagate so the route can decide how to respond.
+ */
+export async function getCapabilityCounts() {
+    const [sd, sdLocal, hot, cold, digests] = await Promise.all([
+        getTable("structured_docs").countRows(),
+        getTable("structured_docs_local").countRows(),
+        getTable("conversations_hot").countRows(),
+        getTable("conversations_cold").countRows(),
+        getTable("digests").countRows(),
+    ]);
+    return {
+        structured_docs: sd + sdLocal,
+        conversations_hot: hot,
+        conversations_cold: cold,
+        digests,
+    };
+}
+/**
+ * Generate the capability-map markdown from cheap counts.
+ * Deterministic for identical input; regenerated on each request
+ * (no TTL cache in Phase 1).
+ */
+export function generateCapabilityMap(counts, opts) {
+    const conversationsTotal = counts.conversations_hot + counts.conversations_cold;
+    const lines = [];
+    lines.push("# Rift Capability Map");
+    lines.push("");
+    lines.push("Rift is a local memory service. Agents call it on demand to look up prior conversations, higher-level summaries of past activity, and indexed project or reference documents — not as a preloaded prompt blob. Use the tools below only when relevant context is likely to live in memory.");
+    lines.push("");
+    if (opts?.maintenanceActive) {
+        lines.push("> **Maintenance in progress** — an exclusive job is running. Some indexers are paused; results may be partial.");
+        lines.push("");
+    }
+    lines.push("## Available Memory");
+    lines.push(`- **conversations** — prior chat/session memory (hot + cold tiers). ${conversationsTotal} indexed.`);
+    lines.push(`- **digests** — higher-level summaries of past activity. ${counts.digests} indexed.`);
+    lines.push(`- **structured documents** — indexed project/client/reference files. ${counts.structured_docs} indexed.`);
+    lines.push("");
+    lines.push("## Which Tool To Use");
+    lines.push("- `rift_search` — broad search across all memory classes. Start here when you do not know which class holds the answer.");
+    lines.push("- `rift_conversations_search` — conversation-specific search with structured filters (source, domain, intent, decisions, topics). Use when the question is clearly about prior chats.");
+    lines.push("- `rift_context_pack` — compact bucketed context for an active task (decisions / constraints / examples / rules). Byte-bounded; never returns raw transcripts. Use to steer an agent, not to fetch a ranked hit list.");
+    lines.push("- `rift_status` — system and capability overview (this map). Not for content retrieval.");
+    lines.push("");
+    lines.push("## Default Behavior");
+    lines.push("- Start compact. Issue one focused query before broadening.");
+    lines.push("- Read each compact hit (title, snippet, summary) first. Expand only the specific hit that justifies it.");
+    lines.push("- Do not pull raw history by default. Raw content is archive, not the default payload.");
+    lines.push("");
+    lines.push("## Escalation");
+    lines.push("- Need the full body of a hit? Follow the hit's `expand` pointer (typically `/search` with `detail=\"full\"`).");
+    lines.push("- Need conversation-specific filters (source, decisions, topics)? Switch to `rift_conversations_search`.");
+    lines.push("- Only broaden the query if the compact search returned no plausible candidate.");
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Write the capability map to `{dataDir}/rift-context.md`.
+ * Best-effort — returns { written: false } on failure without throwing.
+ */
+export async function writeRiftContext(dataDir, capabilityMap) {
+    try {
+        await atomicWrite(path.join(dataDir, "rift-context.md"), capabilityMap);
+        return { written: true };
+    }
+    catch (err) {
+        process.stderr.write(`Failed to write rift-context.md: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { written: false };
+    }
+}
+//# sourceMappingURL=rift-context.js.map

package/dist/src/observability/rift-context.js.map

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

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

@@ -0,0 +1,43 @@
+/**
+ * Pure threshold logic for source health and freshness evaluation.
+ *
+ * All time-based functions accept an explicit `now` parameter so callers
+ * can freeze the clock during maintenance windows.
+ */
+import type { Watcher } from "../ingestion/watcher.js";
+/** Unverified-autonomous sources are unhealthy after this many days without a save. */
+export declare const UNVERIFIED_STALENESS_DAYS = 15;
+/** Manual sources are stale after this many days without an ingest. */
+export declare const MANUAL_STALENESS_DAYS = 30;
+/** Scheduled scan freshness SLO: last_scan_at must be within interval × this factor. */
+export declare const SCAN_SLO_SLACK_FACTOR = 1.5;
+/**
+ * Evaluate health of an unverified-autonomous source.
+ * Returns { healthy: true } if the source has a recent save,
+ * or { healthy: false, warning } if stale or no data.
+ */
+export declare function isUnverifiedHealthy(lastSave: string | null, now: Date): {
+    healthy: boolean;
+    warning?: string;
+};
+/**
+ * Evaluate staleness of a manual source.
+ * Returns true if the source has no data or data older than the threshold.
+ */
+export declare function isManualStale(lastIngest: string | null, now: Date): boolean;
+/**
+ * Evaluate whether the scheduled scan freshness SLO is met.
+ * Met when `last_scan_at` is within `intervalSeconds × SCAN_SLO_SLACK_FACTOR` of `now`.
+ */
+export declare function isScanFreshnessMet(lastScanAt: string | null, intervalSeconds: number, now: Date): boolean;
+/**
+ * Evaluate watcher health.
+ * Healthy when maintenance is active (pause is expected) or when not all watchers are paused.
+ * An empty watchers array with no maintenance → true (nothing to be broken).
+ */
+export declare function isWatcherHealthy(watchers: readonly Watcher[], maintenanceActive: boolean): boolean;
+/**
+ * Format a human-readable staleness warning.
+ */
+export declare function formatStalenessWarning(source: string, lastTimestamp: string | null, thresholdDays: number): string;
+//# sourceMappingURL=staleness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../../src/observability/staleness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAWzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,GAAG,EAAE,IAAI,GACR;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAYxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAG3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,IAAI,GACR,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,EAAE,MAAM,GACpB,MAAM,CAMR"}

package/dist/src/observability/staleness.js

@@ -0,0 +1,74 @@
+// --- Thresholds ---
+/** Unverified-autonomous sources are unhealthy after this many days without a save. */
+export const UNVERIFIED_STALENESS_DAYS = 15;
+/** Manual sources are stale after this many days without an ingest. */
+export const MANUAL_STALENESS_DAYS = 30;
+/** Scheduled scan freshness SLO: last_scan_at must be within interval × this factor. */
+export const SCAN_SLO_SLACK_FACTOR = 1.5;
+// --- Helpers ---
+function daysSince(timestamp, now) {
+    const then = new Date(timestamp).getTime();
+    return (now.getTime() - then) / (1000 * 60 * 60 * 24);
+}
+// --- Evaluation functions ---
+/**
+ * Evaluate health of an unverified-autonomous source.
+ * Returns { healthy: true } if the source has a recent save,
+ * or { healthy: false, warning } if stale or no data.
+ */
+export function isUnverifiedHealthy(lastSave, now) {
+    if (lastSave === null) {
+        return { healthy: false, warning: "No saves recorded" };
+    }
+    const days = daysSince(lastSave, now);
+    if (days > UNVERIFIED_STALENESS_DAYS) {
+        return {
+            healthy: false,
+            warning: `No saves in ${Math.floor(days)} days`,
+        };
+    }
+    return { healthy: true };
+}
+/**
+ * Evaluate staleness of a manual source.
+ * Returns true if the source has no data or data older than the threshold.
+ */
+export function isManualStale(lastIngest, now) {
+    if (lastIngest === null)
+        return true;
+    return daysSince(lastIngest, now) > MANUAL_STALENESS_DAYS;
+}
+/**
+ * Evaluate whether the scheduled scan freshness SLO is met.
+ * Met when `last_scan_at` is within `intervalSeconds × SCAN_SLO_SLACK_FACTOR` of `now`.
+ */
+export function isScanFreshnessMet(lastScanAt, intervalSeconds, now) {
+    if (lastScanAt === null)
+        return false;
+    const thresholdMs = intervalSeconds * SCAN_SLO_SLACK_FACTOR * 1000;
+    const elapsed = now.getTime() - new Date(lastScanAt).getTime();
+    return elapsed <= thresholdMs;
+}
+/**
+ * Evaluate watcher health.
+ * Healthy when maintenance is active (pause is expected) or when not all watchers are paused.
+ * An empty watchers array with no maintenance → true (nothing to be broken).
+ */
+export function isWatcherHealthy(watchers, maintenanceActive) {
+    if (maintenanceActive)
+        return true;
+    if (watchers.length === 0)
+        return true;
+    return !watchers.every((w) => w.isPaused);
+}
+/**
+ * Format a human-readable staleness warning.
+ */
+export function formatStalenessWarning(source, lastTimestamp, thresholdDays) {
+    if (lastTimestamp === null) {
+        return `${source}: no activity recorded`;
+    }
+    const days = Math.floor(daysSince(lastTimestamp, new Date()));
+    return `${source}: no activity in ${days} days (threshold: ${thresholdDays}d)`;
+}
+//# sourceMappingURL=staleness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../../../src/observability/staleness.ts"],"names":[],"mappings":"AAQA,qBAAqB;AAErB,uFAAuF;AACvF,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,kBAAkB;AAElB,SAAS,SAAS,CAAC,SAAiB,EAAE,GAAS;IAC7C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,+BAA+B;AAE/B;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAuB,EACvB,GAAS;IAET,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,IAAI,GAAG,yBAAyB,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO;SAChD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAyB,EAAE,GAAS;IAChE,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAyB,EACzB,eAAuB,EACvB,GAAS;IAET,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,WAAW,GAAG,eAAe,GAAG,qBAAqB,GAAG,IAAI,CAAC;IACnE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/D,OAAO,OAAO,IAAI,WAAW,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,iBAA0B;IAE1B,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,aAA4B,EAC5B,aAAqB;IAErB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,GAAG,MAAM,wBAAwB,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,MAAM,oBAAoB,IAAI,qBAAqB,aAAa,IAAI,CAAC;AACjF,CAAC"}

package/dist/src/observability/tool-usage-stats.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure aggregation over MCP tool-usage entries.
+ *
+ * No filesystem reads, no parsing — callers pass an already-decoded
+ * `ToolUsageEntry[]` (typically via `readToolUsageEntriesTolerant`).
+ * Buckets calls into today/week/month/all-time and applies a fixed
+ * per-tool tokens-saved heuristic so historical entries (which were
+ * never instrumented for size) yield a usable estimate.
+ */
+import type { ToolUsageEntry } from "./tool-usage.js";
+export interface UsageWindow {
+    calls: number;
+    tokens_saved: number;
+}
+export interface UsageSummary {
+    today: UsageWindow;
+    week: UsageWindow;
+    month: UsageWindow;
+    all_time: UsageWindow;
+    by_tool: Record<string, number>;
+}
+export declare function aggregateUsage(entries: ToolUsageEntry[], now?: Date): UsageSummary;
+//# sourceMappingURL=tool-usage-stats.d.ts.map

package/dist/src/observability/tool-usage-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-usage-stats.d.ts","sourceRoot":"","sources":["../../../src/observability/tool-usage-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAyCtD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAkBD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EAAE,EACzB,GAAG,GAAE,IAAiB,GACrB,YAAY,CA4Cd"}

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

@@ -0,0 +1,83 @@
+/**
+ * Tokens-saved estimates per MCP tool call. The numbers are the
+ * approximate tokens an agent would have to spend stuffing equivalent
+ * context into a system prompt or doing the same query without the
+ * compact, bucketed retrieval the MCP server provides.
+ *
+ * Unknown tools fall back to `DEFAULT_TOKENS_SAVED` so future tools
+ * report a non-zero baseline.
+ */
+const TOKENS_SAVED_PER_TOOL = {
+    rift_context_pack: 12_000,
+    rift_conversations_search: 8_000,
+    rift_search: 6_000,
+    rift_save: 2_000,
+    rift_status: 1_000,
+};
+const DEFAULT_TOKENS_SAVED = 1_000;
+/**
+ * Map legacy tool names from JSONL rows written before the rename onto
+ * their canonical `rift_*` equivalents so SwiftBar tokens-saved counters
+ * stay continuous on a machine that upgrades. Hidden migration only —
+ * never surfaces in user-visible output.
+ */
+const LEGACY_TOOL_RENAMES = {
+    life_save: "rift_save",
+    life_search: "rift_search",
+    life_conversations_search: "rift_conversations_search",
+    life_context_pack: "rift_context_pack",
+    life_status: "rift_status",
+};
+function canonicalToolName(tool) {
+    return LEGACY_TOOL_RENAMES[tool] ?? tool;
+}
+const DAY_MS = 24 * 60 * 60 * 1000;
+function emptyWindow() {
+    return { calls: 0, tokens_saved: 0 };
+}
+function tokensSavedFor(tool) {
+    return TOKENS_SAVED_PER_TOOL[tool] ?? DEFAULT_TOKENS_SAVED;
+}
+function startOfUtcDay(date) {
+    return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+}
+export function aggregateUsage(entries, now = new Date()) {
+    const todayStartMs = startOfUtcDay(now);
+    const nowMs = now.getTime();
+    const weekStartMs = nowMs - 7 * DAY_MS;
+    const monthStartMs = nowMs - 30 * DAY_MS;
+    const summary = {
+        today: emptyWindow(),
+        week: emptyWindow(),
+        month: emptyWindow(),
+        all_time: emptyWindow(),
+        by_tool: {},
+    };
+    const todayEndMs = todayStartMs + DAY_MS;
+    for (const entry of entries) {
+        const ts = Date.parse(entry.timestamp);
+        if (Number.isNaN(ts))
+            continue;
+        const tool = canonicalToolName(entry.tool);
+        const tokens = entry.success ? tokensSavedFor(tool) : 0;
+        summary.all_time.calls += 1;
+        summary.all_time.tokens_saved += tokens;
+        summary.by_tool[tool] = (summary.by_tool[tool] ?? 0) + 1;
+        if (ts > nowMs)
+            continue;
+        if (ts >= monthStartMs) {
+            summary.month.calls += 1;
+            summary.month.tokens_saved += tokens;
+        }
+        if (ts >= weekStartMs) {
+            summary.week.calls += 1;
+            summary.week.tokens_saved += tokens;
+        }
+        if (ts >= todayStartMs && ts < todayEndMs) {
+            summary.today.calls += 1;
+            summary.today.tokens_saved += tokens;
+        }
+    }
+    return summary;
+}
+//# sourceMappingURL=tool-usage-stats.js.map

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

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