@getrift/rift 0.0.0 → 0.1.0-beta.1

package/dist/src/server/routes/save.js

@@ -0,0 +1,112 @@
+/**
+ * POST /save route — Slice 8: agent session save.
+ *
+ * Validates body per PRD Section 4, creates a job via the queue,
+ * and returns 202 Accepted with `{ job_id }`.
+ *
+ * Sources restricted to unverified-autonomous agents:
+ * claude_code, gemini_cli, codex_cli.
+ *
+ * Slice 2 additions:
+ * - Grades the payload via gradeSavePayload; surfaces `tier` and
+ *   `warnings` in the response so callers see shape feedback.
+ * - Auto-derives a deterministic idempotency_key when content is
+ *   present and the caller omitted one, so re-sends dedupe instead
+ *   of piling up duplicate rows.
+ */
+import crypto from "node:crypto";
+import { z } from "zod";
+import { toJobStatusView } from "../../jobs/types.js";
+import { gradeSavePayload } from "../save-quality.js";
+const SaveRequestSchema = z.object({
+    source: z.enum(["claude_code", "gemini_cli", "codex_cli"]),
+    summary: z.string().min(1),
+    /** Full conversation text — used for embedding and search when provided. */
+    content: z.string().optional(),
+    domain: z
+        .enum([
+        "business",
+        "tech",
+        "personal",
+        "travel",
+        "health",
+        "finance",
+        "creative",
+    ])
+        .optional(),
+    decisions: z.array(z.string()).optional(),
+    key_outputs: z.array(z.string()).optional(),
+    topics: z.array(z.string()).optional(),
+    idempotency_key: z.string().optional(),
+    /** When re-saving an updated conversation, the old key whose row should be replaced. */
+    replace_idempotency_key: z.string().optional(),
+});
+/**
+ * Build a deterministic idempotency key from the payload content.
+ * Same (source, content) pair always produces the same key, so
+ * re-sending the same transcript dedupes at the job layer.
+ *
+ * Returns undefined when content is missing: hashing a short summary
+ * collapses unrelated thin saves (e.g. multiple "quick test" pings
+ * from the same source) into one row, which is silent data loss.
+ * Thin saves instead go through without an auto-key and the grader
+ * warning already tells the caller to send an explicit one.
+ */
+function deriveIdempotencyKey(payload) {
+    if (!payload.content)
+        return undefined;
+    const fingerprint = crypto
+        .createHash("sha256")
+        .update(payload.content)
+        .digest("hex")
+        .slice(0, 12);
+    return `${payload.source}:auto:${fingerprint}`;
+}
+export function registerSaveRoute(server, queue) {
+    server.post("/save", async (request, reply) => {
+        const parsed = SaveRequestSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.code(400).send({
+                error: "validation_error",
+                details: parsed.error.issues,
+            });
+        }
+        const quality = gradeSavePayload(parsed.data);
+        const payload = { ...parsed.data };
+        let derivedKey = false;
+        if (!payload.idempotency_key) {
+            const derived = deriveIdempotencyKey(payload);
+            if (derived) {
+                payload.idempotency_key = derived;
+                derivedKey = true;
+            }
+        }
+        const opts = { payload };
+        if (payload.idempotency_key !== undefined) {
+            opts.idempotency_key = payload.idempotency_key;
+        }
+        const result = await queue.create("save", opts);
+        if ("conflict" in result) {
+            // save is not an exclusive job, so this should never happen
+            return reply.code(409).send({ error: "conflict" });
+        }
+        const qualityResponse = {
+            tier: quality.tier,
+            warnings: quality.warnings,
+            ...(derivedKey ? { idempotency_key: payload.idempotency_key } : {}),
+        };
+        if (result.duplicate) {
+            return reply.code(200).send({
+                job_id: result.job.id,
+                duplicate: true,
+                ...toJobStatusView(result.job),
+                quality: qualityResponse,
+            });
+        }
+        return reply.code(202).send({
+            job_id: result.job.id,
+            quality: qualityResponse,
+        });
+    });
+}
+//# sourceMappingURL=save.js.map

package/dist/src/server/routes/save.js.map

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

package/dist/src/server/routes/search.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from "fastify";
+import type { EmbeddingProvider } from "../../providers/types.js";
+import type { SourceDir } from "../../config/schema.js";
+export declare function registerSearchRoute(server: FastifyInstance, embedding: EmbeddingProvider | undefined, localEmbedding?: EmbeddingProvider, sourceDirs?: readonly SourceDir[]): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/src/server/routes/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/search.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAoFxD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,cAAc,CAAC,EAAE,iBAAiB,EAClC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAChC,IAAI,CA+LN"}

package/dist/src/server/routes/search.js

@@ -0,0 +1,400 @@
+/**
+ * POST /search route — Slice 7: hybrid retrieval + reranking + degraded mode.
+ *
+ * Zod-validated request body per PRD Section 4.
+ * Uses hybrid (vector + lexical) retrieval with deterministic reranking.
+ * Implicit cold-tier fallback when top results score < 0.4.
+ */
+import { z } from "zod";
+import { hybridSearch } from "../../retrieval/hybrid.js";
+import { rerank } from "../../retrieval/reranker.js";
+import { lexicalSearchTables } from "../../retrieval/lexical.js";
+import { getTable, TABLE_NAMES } from "../../storage/tables.js";
+import { resolveCwdRoot, escapeLike } from "../../retrieval/cwd.js";
+import { buildCompactHit, buildCompactHitFromRow, fetchRawRowsForRanked, fetchRowByIdForTier, } from "../../retrieval/compact.js";
+const COLD_TIER_THRESHOLD = 0.4;
+const TIER_VALUES = ["hot", "cold", "digest", "document", "structured_doc"];
+/**
+ * /search request schema.
+ *
+ * Two modes:
+ * - Retrieval mode: `query` is required. Runs hybrid search + rerank.
+ * - Expansion mode: `detail="full"` + `id` + `tier` — skips retrieval
+ *   entirely and fetches the row by id from the table inferred from `tier`.
+ *   This makes compact-hit `expand` pointers round-trippable from the
+ *   payload alone, without the caller needing to re-run the search.
+ *
+ * `query` becomes optional in expansion mode.
+ */
+const SearchRequestSchema = z
+    .object({
+    query: z.string().min(1).optional(),
+    scope: z
+        .enum(["all", "clients", "projects", "conversations", "documents"])
+        .default("all"),
+    client: z.string().optional(),
+    since: z.string().datetime().optional(),
+    top_k: z.number().int().positive().default(10),
+    cwd: z.string().optional(),
+    detail: z.enum(["summary", "full"]).default("summary"),
+    /** With detail="full", expand a single hit by id (bypasses ranking). */
+    id: z.string().optional(),
+    /** Tier of the id being expanded. Required in expansion mode. */
+    tier: z.enum(TIER_VALUES).optional(),
+    /**
+     * Authoritative backing table for the id. When provided, disambiguates
+     * rows that share an id across the cloud/local structured-doc tables.
+     * Optional — absent requests fall back to tier-based first-match lookup.
+     */
+    source_table: z.enum(TABLE_NAMES).optional(),
+})
+    .refine((d) => !!d.query || (d.detail === "full" && !!d.id && !!d.tier), {
+    message: "Either `query` is required, or provide `id`+`tier`+`detail=\"full\"` for expansion.",
+})
+    .refine((d) => {
+    // If both tier and source_table are provided in expansion mode, the
+    // source_table must be one the tier can legitimately resolve to.
+    // This catches callers that hand-craft pointers with inconsistent
+    // tier/source_table hints (e.g., tier=hot + source_table=digests).
+    if (!d.tier || !d.source_table)
+        return true;
+    const valid = {
+        hot: ["conversations_hot"],
+        cold: ["conversations_cold"],
+        digest: ["digests"],
+        document: ["structured_docs", "structured_docs_local"],
+        structured_doc: ["structured_docs", "structured_docs_local"],
+    };
+    return valid[d.tier].includes(d.source_table);
+}, {
+    message: "`source_table` is not compatible with the provided `tier`.",
+    path: ["source_table"],
+});
+export function registerSearchRoute(server, embedding, localEmbedding, sourceDirs) {
+    server.post("/search", async (request, reply) => {
+        const parsed = SearchRequestSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.code(400).send({
+                error: "validation_error",
+                details: parsed.error.issues,
+            });
+        }
+        const { query, scope, client, since, top_k, cwd, detail, id: expandId, tier: expandTier, source_table: expandSourceTable, } = parsed.data;
+        const searchScope = scope;
+        // --- Expansion mode: direct id-based fetch, bypass retrieval/ranking ---
+        // Triggered when caller follows a compact hit's `expand` pointer
+        // verbatim: `{id, tier, source_table, detail: "full"}`. Guarantees the
+        // requested row is returned even if it would rank below `top_k` in search,
+        // and honors `source_table` to disambiguate cloud vs. local structured docs.
+        if (detail === "full" && expandId && expandTier) {
+            const fetched = await fetchRowByIdForTier(expandId, expandTier, expandSourceTable);
+            const hit = fetched
+                ? buildCompactHitFromRow(fetched.row, fetched.sourceTable, {
+                    ...(query ? { query } : {}),
+                    expandRoute: "/search",
+                })
+                : null;
+            return {
+                results: hit ? [hit] : [],
+                degraded: false,
+                cwd_matched: false,
+                cwd_scope_applied_to: [],
+            };
+        }
+        if (!query) {
+            // Defensive: the refine() above guarantees this branch is unreachable,
+            // but TypeScript's narrowing can't see that through the schema.
+            return reply.code(400).send({
+                error: "validation_error",
+                details: [{ message: "query is required" }],
+            });
+        }
+        // Resolve cwd to a configured source root for project-scoped search
+        const cwdMatch = cwd && sourceDirs ? resolveCwdRoot(cwd, sourceDirs) : null;
+        const sourcePathPrefix = cwdMatch?.rootPath;
+        // 1. Run hybrid search (vector + lexical) on cloud tables — requires cloud embedding
+        const candidates = [];
+        let finalDegraded = false;
+        let finalDegradedReason;
+        if (embedding) {
+            const cloudResult = await hybridSearch(query, embedding, { scope: searchScope, client, since, top_k, ...(sourcePathPrefix ? { sourcePathPrefix } : {}) });
+            candidates.push(...cloudResult.candidates);
+            finalDegraded = cloudResult.degraded;
+            finalDegradedReason = cloudResult.degraded_reason;
+        }
+        // 1b. Search local table if local embedding is configured
+        const scopeIncludesDocs = searchScope === "all" ||
+            searchScope === "documents" ||
+            searchScope === "clients" ||
+            searchScope === "projects";
+        if (localEmbedding && scopeIncludesDocs) {
+            try {
+                const localCandidates = await searchLocalTable(query, localEmbedding, { scope: searchScope, ...(client ? { client } : {}), ...(since ? { since } : {}), top_k, ...(sourcePathPrefix ? { sourcePathPrefix } : {}) });
+                const existingIds = new Set(candidates.map((c) => c.id));
+                for (const lc of localCandidates) {
+                    if (!existingIds.has(lc.id)) {
+                        candidates.push(lc);
+                    }
+                }
+            }
+            catch (err) {
+                if (!finalDegraded) {
+                    finalDegraded = true;
+                    finalDegradedReason = `local search failed: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            }
+        }
+        // 2. Rerank candidates
+        const rerankInput = candidates.map((c) => {
+            const entry = {
+                id: c.id,
+                content: c.content,
+                raw_sim: c.raw_sim,
+                raw_bm25: c.raw_bm25,
+                source_table: c.source_table,
+                retrieval_method: c.retrieval_method,
+            };
+            if (c.indexed_at)
+                entry.indexed_at = c.indexed_at;
+            if (c.quality)
+                entry.quality = c.quality;
+            return entry;
+        });
+        let ranked = rerank(rerankInput);
+        // 3. Implicit cold-tier fallback: if top results score < 0.4,
+        //    also search conversations_cold (only for scopes that include conversations)
+        const scopeIncludesConversations = searchScope === "all" || searchScope === "conversations";
+        const needsColdFallback = embedding &&
+            scopeIncludesConversations &&
+            (ranked.length === 0 || ranked[0].score < COLD_TIER_THRESHOLD);
+        if (needsColdFallback) {
+            const coldOpts = {
+                top_k,
+                degraded: finalDegraded,
+            };
+            if (since)
+                coldOpts.since = since;
+            const coldResult = await searchColdTier(query, embedding, coldOpts);
+            // Propagate cold-tier degradation
+            if (coldResult.degraded && !finalDegraded) {
+                finalDegraded = true;
+                finalDegradedReason = coldResult.degraded_reason;
+            }
+            // Deduplicate against existing results
+            const existingIds = new Set(ranked.map((r) => r.id));
+            const newCold = coldResult.candidates.filter((c) => !existingIds.has(c.id));
+            if (newCold.length > 0) {
+                const coldRanked = rerank(newCold);
+                ranked = [...ranked, ...coldRanked].sort((a, b) => b.score - a.score);
+            }
+        }
+        const topRanked = ranked.slice(0, top_k);
+        const rawRows = await fetchRawRowsForRanked(topRanked);
+        const topResults = topRanked.map((r) => buildCompactHit(r, rawRows.get(r.id), {
+            query,
+            detail,
+            expandRoute: "/search",
+        }));
+        // Build cwd observability fields
+        const cwdScopeAppliedTo = [];
+        if (cwdMatch) {
+            cwdScopeAppliedTo.push("structured_docs");
+            if (localEmbedding && scopeIncludesDocs) {
+                cwdScopeAppliedTo.push("structured_docs_local");
+            }
+        }
+        const response = {
+            results: topResults,
+            degraded: finalDegraded,
+            cwd_matched: !!cwdMatch,
+            cwd_scope_applied_to: cwdScopeAppliedTo,
+        };
+        if (finalDegradedReason)
+            response.degraded_reason = finalDegradedReason;
+        return response;
+    });
+}
+/**
+ * Search conversations_cold for cold-tier fallback.
+ * Returns rerank-ready candidates and degradation status.
+ */
+async function searchColdTier(query, embedding, opts) {
+    const fetchK = opts.top_k * 3;
+    // Lexical search on cold tier
+    const lexOpts = { top_k: fetchK };
+    if (opts.since)
+        lexOpts.since = opts.since;
+    const lexResults = await lexicalSearchTables(query, ["conversations_cold"], lexOpts);
+    // Vector search on cold tier (if not already degraded)
+    const vectorResults = [];
+    let coldDegraded = false;
+    let coldDegradedReason;
+    if (!opts.degraded) {
+        try {
+            const queryVec = await embedding.embed(query);
+            const coldTable = getTable("conversations_cold");
+            const clauses = [];
+            if (opts.since) {
+                clauses.push(`indexed_at >= '${opts.since.replace(/'/g, "''")}'`);
+            }
+            let vq = coldTable
+                .query()
+                .nearestTo(queryVec)
+                .distanceType("cosine")
+                .limit(fetchK);
+            if (clauses.length > 0) {
+                vq = vq.where(clauses.join(" AND "));
+            }
+            const vRows = await vq.toArray();
+            for (const row of vRows) {
+                const entry = {
+                    id: row.id,
+                    content: row.content || row.summary || "",
+                    score: 1 - (row._distance ?? 0),
+                };
+                const ts = row.indexed_at;
+                if (ts)
+                    entry.indexed_at = ts;
+                const q = row.quality;
+                if (q)
+                    entry.quality = q;
+                vectorResults.push(entry);
+            }
+        }
+        catch (err) {
+            // Cold-tier vector failure: surface degradation
+            coldDegraded = true;
+            coldDegradedReason = `cold-tier vector search failed: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    // Merge and tag retrieval method
+    const vectorIds = new Set(vectorResults.map((r) => r.id));
+    const lexicalById = new Map(lexResults.map((r) => [r.id, r]));
+    const merged = new Map();
+    for (const vr of vectorResults) {
+        const lexMatch = lexicalById.get(vr.id);
+        const entry = {
+            id: vr.id,
+            content: vr.content,
+            raw_sim: vr.score,
+            raw_bm25: lexMatch?.score ?? 0,
+            source_table: "conversations_cold",
+            retrieval_method: lexMatch ? "hybrid" : "vector",
+        };
+        if (vr.indexed_at)
+            entry.indexed_at = vr.indexed_at;
+        if (vr.quality)
+            entry.quality = vr.quality;
+        merged.set(vr.id, entry);
+    }
+    for (const lr of lexResults) {
+        if (!merged.has(lr.id)) {
+            const entry = {
+                id: lr.id,
+                content: lr.content,
+                raw_sim: 0,
+                raw_bm25: lr.score,
+                source_table: "conversations_cold",
+                retrieval_method: vectorIds.has(lr.id) ? "hybrid" : "lexical",
+            };
+            if (lr.indexed_at)
+                entry.indexed_at = lr.indexed_at;
+            if (lr.quality)
+                entry.quality = lr.quality;
+            merged.set(lr.id, entry);
+        }
+    }
+    const result = {
+        candidates: Array.from(merged.values()),
+        degraded: coldDegraded,
+    };
+    if (coldDegradedReason)
+        result.degraded_reason = coldDegradedReason;
+    return result;
+}
+/**
+ * Search the local-embedding table (structured_docs_local).
+ * Runs vector search with the local embedding provider + lexical search,
+ * then merges into hybrid candidates. Same pattern as searchColdTier.
+ */
+async function searchLocalTable(query, localEmbedding, opts) {
+    const fetchK = opts.top_k * 3;
+    const tableName = "structured_docs_local";
+    // Build WHERE clauses (same logic as cloud structured_docs)
+    const clauses = [];
+    if (opts.scope === "documents")
+        clauses.push("source_scope = 'document'");
+    else if (opts.scope === "clients")
+        clauses.push("source_scope = 'client'");
+    else if (opts.scope === "projects")
+        clauses.push("source_scope = 'project'");
+    if (opts.client)
+        clauses.push(`client_name = '${opts.client.replace(/'/g, "''")}'`);
+    if (opts.sourcePathPrefix)
+        clauses.push(`source_path LIKE '${escapeLike(opts.sourcePathPrefix).replace(/'/g, "''")}%' ESCAPE '\\'`);
+    if (opts.since)
+        clauses.push(`indexed_at >= '${opts.since.replace(/'/g, "''")}'`);
+    // Vector search with local embedding
+    const vectorResults = [];
+    const queryVec = await localEmbedding.embed(query);
+    const table = getTable(tableName);
+    let vq = table.query().nearestTo(queryVec).distanceType("cosine").limit(fetchK);
+    if (clauses.length > 0)
+        vq = vq.where(clauses.join(" AND "));
+    const vRows = await vq.toArray();
+    for (const row of vRows) {
+        const entry = {
+            id: row.id,
+            content: row.content || "",
+            score: 1 - (row._distance ?? 0),
+        };
+        const ts = row.indexed_at;
+        if (ts)
+            entry.indexed_at = ts;
+        vectorResults.push(entry);
+    }
+    // Lexical search on same table — pass scope so fetchRows applies the same
+    // source_scope/client/sourcePathPrefix filters as the vector path above.
+    const lexResults = await lexicalSearchTables(query, [tableName], {
+        top_k: fetchK,
+        scope: opts.scope,
+        since: opts.since,
+        client: opts.client,
+        sourcePathPrefix: opts.sourcePathPrefix,
+    });
+    // Merge vector + lexical
+    const vectorIds = new Set(vectorResults.map((r) => r.id));
+    const lexicalById = new Map(lexResults.map((r) => [r.id, r]));
+    const merged = [];
+    for (const vr of vectorResults) {
+        const lexMatch = lexicalById.get(vr.id);
+        const entry = {
+            id: vr.id,
+            content: vr.content,
+            raw_sim: vr.score,
+            raw_bm25: lexMatch?.score ?? 0,
+            source_table: tableName,
+            retrieval_method: lexMatch ? "hybrid" : "vector",
+        };
+        if (vr.indexed_at)
+            entry.indexed_at = vr.indexed_at;
+        merged.push(entry);
+    }
+    for (const lr of lexResults) {
+        if (!vectorIds.has(lr.id)) {
+            const entry = {
+                id: lr.id,
+                content: lr.content,
+                raw_sim: 0,
+                raw_bm25: lr.score,
+                source_table: tableName,
+                retrieval_method: "lexical",
+            };
+            if (lr.indexed_at)
+                entry.indexed_at = lr.indexed_at;
+            merged.push(entry);
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=search.js.map

package/dist/src/server/routes/search.js.map

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

package/dist/src/server/routes/stats.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GET /stats route — Slice 16: full PRD Section 4 schema.
+ *
+ * Returns table counts, source coverage, staleness, and automation gate.
+ * On LanceDB read failure → 500.
+ */
+import type { FastifyInstance } from "fastify";
+import { type ObservabilityDeps } from "../../observability/coverage.js";
+export declare function registerStatsRoute(server: FastifyInstance, deps: ObservabilityDeps): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/src/server/routes/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAWN"}

package/dist/src/server/routes/stats.js

@@ -0,0 +1,15 @@
+import { buildFullStats, } from "../../observability/coverage.js";
+export function registerStatsRoute(server, deps) {
+    server.get("/stats", async (_request, reply) => {
+        try {
+            return await buildFullStats(deps);
+        }
+        catch (err) {
+            return reply.code(500).send({
+                error: "stats_unavailable",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/src/server/routes/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../../src/server/routes/stats.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,cAAc,GAEf,MAAM,iCAAiC,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAChC,MAAuB,EACvB,IAAuB;IAEvB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,OAAO,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/server/routes/status.d.ts

@@ -0,0 +1,20 @@
+/**
+ * GET /status route.
+ *
+ * Slice 2 (Zero-Prompt Awareness): returns the capability-map
+ * markdown describing what memory exists and which tool to use.
+ *
+ * Data path: uses only cheap per-table `countRows()` calls via
+ * `getCapabilityCounts()`. Deliberately does NOT call
+ * `buildFullStats()` — source-coverage / source-health collection
+ * walks whole tables with `.toArray()` and is unrelated to the
+ * capability-map contract. Keeping these decoupled also means
+ * `/status` continues to work if secondary observability collection
+ * breaks.
+ *
+ * Side-effect: writes `rift-context.md` (best-effort).
+ */
+import type { FastifyInstance } from "fastify";
+import type { ObservabilityDeps } from "../../observability/coverage.js";
+export declare function registerStatusRoute(server: FastifyInstance, deps: ObservabilityDeps): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/server/routes/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAWzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAiCN"}

package/dist/src/server/routes/status.js

@@ -0,0 +1,31 @@
+import { generateCapabilityMap, getCapabilityCounts, writeRiftContext, } from "../../observability/rift-context.js";
+import { formatAutoCaptureSummary, readAutoCaptureRunSummary, } from "../../capture/observability.js";
+export function registerStatusRoute(server, deps) {
+    server.get("/status", async (_request, reply) => {
+        let counts;
+        try {
+            counts = await getCapabilityCounts();
+        }
+        catch (err) {
+            return reply.code(500).send({
+                error: "capability_counts_unavailable",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        const maintenanceState = deps.getMaintenanceState();
+        const capabilityMap = generateCapabilityMap(counts, {
+            maintenanceActive: maintenanceState.active,
+        });
+        let statusMarkdown = capabilityMap;
+        try {
+            statusMarkdown += formatAutoCaptureSummary(readAutoCaptureRunSummary(deps.config.data_paths.data_dir, deps.config.capture.sources));
+        }
+        catch {
+            statusMarkdown += "\n\n## Auto-capture\n- status unavailable";
+        }
+        // Best-effort side-effect write
+        await writeRiftContext(deps.config.data_paths.data_dir, statusMarkdown);
+        return reply.type("text/markdown").send(statusMarkdown);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/src/server/routes/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/server/routes/status.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,MAAuB,EACvB,IAAuB;IAEvB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC9C,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,KAAK,EAAE,+BAA+B;gBACtC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACpD,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,EAAE;YAClD,iBAAiB,EAAE,gBAAgB,CAAC,MAAM;SAC3C,CAAC,CAAC;QACH,IAAI,cAAc,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC;YACH,cAAc,IAAI,wBAAwB,CACxC,yBAAyB,CACvB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAC5B,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,cAAc,IAAI,2CAA2C,CAAC;QAChE,CAAC;QAED,gCAAgC;QAChC,MAAM,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAExE,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}