@getrift/rift 0.0.0 → 0.1.0-beta.1

package/dist/src/server/middleware/multipart.js

@@ -0,0 +1,86 @@
+import multipart from "@fastify/multipart";
+export async function registerMultipart(server, config) {
+    const limitBytes = config.request_limits.multipart_limit_bytes;
+    await server.register(multipart, {
+        limits: {
+            fileSize: limitBytes,
+            files: 1, // Only one file per upload
+        },
+        attachFieldsToBody: false,
+    });
+}
+/**
+ * Central multipart consumer that returns both the file and form fields.
+ *
+ * Used by routes that accept a file plus metadata fields (e.g. POST /ingest).
+ */
+export async function consumeMultipartUpload(request, limitBytes) {
+    const data = await request.file();
+    if (!data) {
+        const err = new Error("No file uploaded");
+        err.statusCode = 400;
+        throw err;
+    }
+    // Extract form fields from the parsed multipart data.
+    // data.fields contains all parts (files and non-file fields).
+    const fields = {};
+    for (const [key, value] of Object.entries(data.fields)) {
+        if (value &&
+            !Array.isArray(value) &&
+            typeof value === "object" &&
+            "value" in value &&
+            value.type === "field") {
+            fields[key] = String(value.value);
+        }
+    }
+    const chunks = [];
+    for await (const chunk of data.file) {
+        chunks.push(chunk);
+    }
+    if (data.file.truncated) {
+        const err = new Error(`Upload exceeds ${limitBytes} byte limit`);
+        err.statusCode = 413;
+        throw err;
+    }
+    return {
+        file: {
+            filename: data.filename,
+            mimetype: data.mimetype,
+            data: Buffer.concat(chunks),
+        },
+        fields,
+    };
+}
+/**
+ * Central multipart file consumer.
+ *
+ * Every route that accepts a file upload MUST call this function
+ * instead of accessing `request.file()` directly.  It enforces the
+ * size limit centrally so individual routes cannot forget.
+ *
+ * @throws Fastify error with statusCode 413 when the file is truncated
+ * @throws Fastify error with statusCode 400 when no file is present
+ */
+export async function consumeMultipartFile(request, limitBytes) {
+    const file = await request.file();
+    if (!file) {
+        const err = new Error("No file uploaded");
+        err.statusCode = 400;
+        throw err;
+    }
+    const chunks = [];
+    for await (const chunk of file.file) {
+        chunks.push(chunk);
+    }
+    if (file.file.truncated) {
+        const err = new Error(`Upload exceeds ${limitBytes} byte limit`);
+        err.statusCode = 413;
+        throw err;
+    }
+    return {
+        filename: file.filename,
+        mimetype: file.mimetype,
+        data: Buffer.concat(chunks),
+    };
+}
+//# sourceMappingURL=multipart.js.map

package/dist/src/server/middleware/multipart.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * POST /compact route — Slice 11.
+ *
+ * Trigger on-demand compaction (hot->cold migration + digest) or rollback.
+ * Async: returns 202 Accepted with { job_id }.
+ * Mutually exclusive with reindex and reconcile -> 409 Conflict.
+ *
+ * Ordering follows PRD 4.1:
+ * 1. Idempotency check (read-only, no job creation)
+ * 2. Rollback eligibility check (only for rollback requests)
+ * 3. Job creation via queue (handles mutual exclusion)
+ *
+ * This ensures a retry of a completed rollback with the same
+ * idempotency_key returns 200 duplicate (step 1), while a fresh
+ * rollback with no eligible manifest returns 409 without polluting
+ * the job queue (step 2 runs before step 3).
+ */
+import { z } from "zod";
+import type { FastifyInstance } from "fastify";
+import type { JobQueue } from "../../jobs/queue.js";
+declare const CompactRequestSchema: z.ZodObject<{
+    rollback: z.ZodDefault<z.ZodBoolean>;
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    dry_run: boolean;
+    rollback: boolean;
+    idempotency_key?: string | undefined;
+}, {
+    idempotency_key?: string | undefined;
+    dry_run?: boolean | undefined;
+    rollback?: boolean | undefined;
+}>;
+export type CompactPayload = z.infer<typeof CompactRequestSchema>;
+export declare function registerCompactRoute(server: FastifyInstance, queue: JobQueue, dataDir: string): void;
+export {};
+//# sourceMappingURL=compact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;EAMf,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,GACd,IAAI,CAuDN"}

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

@@ -0,0 +1,77 @@
+/**
+ * POST /compact route — Slice 11.
+ *
+ * Trigger on-demand compaction (hot->cold migration + digest) or rollback.
+ * Async: returns 202 Accepted with { job_id }.
+ * Mutually exclusive with reindex and reconcile -> 409 Conflict.
+ *
+ * Ordering follows PRD 4.1:
+ * 1. Idempotency check (read-only, no job creation)
+ * 2. Rollback eligibility check (only for rollback requests)
+ * 3. Job creation via queue (handles mutual exclusion)
+ *
+ * This ensures a retry of a completed rollback with the same
+ * idempotency_key returns 200 duplicate (step 1), while a fresh
+ * rollback with no eligible manifest returns 409 without polluting
+ * the job queue (step 2 runs before step 3).
+ */
+import { z } from "zod";
+import { toJobStatusView } from "../../jobs/types.js";
+import { hasEligibleRollback } from "../../jobs/handlers/compact.js";
+const CompactRequestSchema = z
+    .object({
+    rollback: z.boolean().default(false),
+    dry_run: z.boolean().default(false),
+    idempotency_key: z.string().optional(),
+})
+    .strict();
+export function registerCompactRoute(server, queue, dataDir) {
+    server.post("/compact", async (request, reply) => {
+        const parsed = CompactRequestSchema.safeParse(request.body ?? {});
+        if (!parsed.success) {
+            return reply.code(400).send({
+                error: "validation_error",
+                details: parsed.error.issues,
+            });
+        }
+        const payload = parsed.data;
+        // --- Step 1: Idempotency pre-check (PRD 4.1 — checked first) ---
+        // Read-only lookup: does NOT create a job or trigger processing.
+        if (payload.idempotency_key) {
+            const existing = queue.findDuplicate(payload.idempotency_key);
+            if (existing) {
+                return reply.code(200).send({
+                    job_id: existing.id,
+                    duplicate: true,
+                    ...toJobStatusView(existing),
+                });
+            }
+        }
+        // --- Step 2: Rollback eligibility (before job creation) ---
+        if (payload.rollback && !hasEligibleRollback(dataDir)) {
+            return reply
+                .code(409)
+                .send({ error: "no_eligible_rollback" });
+        }
+        // --- Step 3: Create job (handles mutual exclusion + persistence) ---
+        const opts = {
+            payload,
+        };
+        if (payload.idempotency_key !== undefined) {
+            opts.idempotency_key = payload.idempotency_key;
+        }
+        const result = await queue.create("compact", opts);
+        if ("conflict" in result) {
+            return reply.code(409).send({ error: "conflict" });
+        }
+        if (result.duplicate) {
+            return reply.code(200).send({
+                job_id: result.job.id,
+                duplicate: true,
+                ...toJobStatusView(result.job),
+            });
+        }
+        return reply.code(202).send({ job_id: result.job.id });
+    });
+}
+//# sourceMappingURL=compact.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../../../src/server/routes/compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,UAAU,oBAAoB,CAClC,MAAuB,EACvB,KAAe,EACf,OAAe;IAEf,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,KAAK,EAAE,kBAAkB;gBACzB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QAE5B,kEAAkE;QAClE,iEAAiE;QACjE,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAC9D,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,QAAQ,CAAC,EAAE;oBACnB,SAAS,EAAE,IAAI;oBACf,GAAG,eAAe,CAAC,QAAQ,CAAC;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,OAAO,KAAK;iBACT,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,sEAAsE;QACtE,MAAM,IAAI,GAA2D;YACnE,OAAO;SACR,CAAC;QACF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QACjD,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEnD,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;gBACrB,SAAS,EAAE,IAAI;gBACf,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/server/routes/context.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 registerContextRoute(server: FastifyInstance, embedding: EmbeddingProvider, sources?: readonly SourceDir[]): void;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/context.ts"],"names":[],"mappings":"AAUA,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;AAyBxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,GAC7B,IAAI,CAwBN"}

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

@@ -0,0 +1,50 @@
+/**
+ * POST /context/pack — Slice 3: ContextPack retrieval primitive.
+ *
+ * Agent-facing compact context endpoint. Given a task description, returns
+ * a small, bucketed view of prior decisions, constraints, examples, and
+ * project rules drawn from conversations + documents.
+ *
+ * Never returns raw transcripts; bytes are strictly bounded.
+ */
+import { z } from "zod";
+import { buildContextPack, MAX_PER_BUCKET_CEILING, MAX_BYTES_CEILING, TASK_MAX, } from "../../retrieval/context-pack.js";
+const ContextPackRequestSchema = z.object({
+    task: z
+        .string()
+        .min(1)
+        .max(TASK_MAX)
+        .describe("Short description of the current task / query."),
+    cwd: z.string().optional(),
+    since: z.string().datetime().optional(),
+    max_per_bucket: z
+        .number()
+        .int()
+        .positive()
+        .max(MAX_PER_BUCKET_CEILING)
+        .optional(),
+    max_bytes: z.number().int().positive().max(MAX_BYTES_CEILING).optional(),
+});
+export function registerContextRoute(server, embedding, sources) {
+    server.post("/context/pack", async (request, reply) => {
+        const parsed = ContextPackRequestSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.code(400).send({
+                error: "validation_error",
+                details: parsed.error.issues,
+            });
+        }
+        const { task, cwd, since, max_per_bucket, max_bytes } = parsed.data;
+        const pack = await buildContextPack({
+            task,
+            embedding,
+            ...(cwd ? { cwd } : {}),
+            ...(sources ? { sources } : {}),
+            ...(since ? { since } : {}),
+            ...(max_per_bucket !== undefined ? { maxPerBucket: max_per_bucket } : {}),
+            ...(max_bytes !== undefined ? { maxBytes: max_bytes } : {}),
+        });
+        return pack;
+    });
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/server/routes/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,QAAQ,GACT,MAAM,iCAAiC,CAAC;AAEzC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,QAAQ,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,sBAAsB,CAAC;SAC3B,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,MAAuB,EACvB,SAA4B,EAC5B,OAA8B;IAE9B,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC1B,KAAK,EAAE,kBAAkB;gBACzB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAEpE,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;YAClC,IAAI;YACJ,SAAS;YACT,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { EmbeddingProvider } from "../../providers/types.js";
+export declare function registerConversationSearchRoute(server: FastifyInstance, embedding: EmbeddingProvider): void;
+//# sourceMappingURL=conversations-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversations-search.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/conversations-search.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AA6DlE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,iBAAiB,GAC3B,IAAI,CA+MN"}

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

@@ -0,0 +1,243 @@
+/**
+ * POST /conversations/search route — Slice 9.
+ *
+ * Authoritative conversation retrieval with explicit metadata filters
+ * and detail-level tier control (PRD Section 4).
+ *
+ * - detail: "summary" → conversations_hot + digests
+ * - detail: "full"    → conversations_cold
+ *
+ * Metadata filters (source, domain, intent, quality, since) are applied
+ * at the LanceDB WHERE-clause level, not post-filter.
+ */
+import { z } from "zod";
+import { CONVERSATION_SOURCES, DOMAINS, INTENTS, QUALITY_LEVELS, } from "../../providers/types.js";
+import { rerank } from "../../retrieval/reranker.js";
+import { lexicalSearchTables } from "../../retrieval/lexical.js";
+import { applyPostFilters } from "../../retrieval/post-filter.js";
+import { getTable } from "../../storage/tables.js";
+import { buildCompactHit, fetchRawRowsForRanked, } from "../../retrieval/compact.js";
+// --- Request schema ---
+const ConversationSearchRequestSchema = z.object({
+    query: z.string().min(1),
+    detail: z.enum(["summary", "full"]).default("summary"),
+    source: z.enum([...CONVERSATION_SOURCES, "all"]).default("all"),
+    domain: z.enum([...DOMAINS, "all"]).default("all"),
+    intent: z.enum([...INTENTS, "all"]).default("all"),
+    quality: z.enum([...QUALITY_LEVELS, "all"]).default("all"),
+    since: z.string().datetime().optional(),
+    top_k: z.number().int().positive().default(10),
+    topic: z.string().min(1).optional(),
+    decision: z.string().min(1).optional(),
+});
+// --- Helpers ---
+/** Minimal SQL value escaping to prevent injection in where clauses. */
+function escapeSql(value) {
+    return value.replace(/'/g, "''");
+}
+/**
+ * Build WHERE clause parts from non-"all" metadata filter values.
+ * These apply to conversation tables (hot/cold) only — digests lack
+ * source/domain/intent/quality fields.
+ */
+function buildMetadataWhere(filters) {
+    const clauses = [];
+    if (filters.source !== "all")
+        clauses.push(`source = '${escapeSql(filters.source)}'`);
+    if (filters.domain !== "all")
+        clauses.push(`domain = '${escapeSql(filters.domain)}'`);
+    if (filters.intent !== "all")
+        clauses.push(`intent = '${escapeSql(filters.intent)}'`);
+    if (filters.quality !== "all")
+        clauses.push(`quality = '${escapeSql(filters.quality)}'`);
+    return clauses;
+}
+// --- Route registration ---
+export function registerConversationSearchRoute(server, embedding) {
+    server.post("/conversations/search", async (request, reply) => {
+        const parsed = ConversationSearchRequestSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.code(400).send({
+                error: "validation_error",
+                details: parsed.error.issues,
+            });
+        }
+        const { query, detail, source, domain, intent, quality, since, top_k, topic, decision } = parsed.data;
+        const metadataClauses = buildMetadataWhere({ source, domain, intent, quality });
+        const hasPostFilter = !!topic || !!decision;
+        const fetchK = hasPostFilter
+            ? Math.max(top_k * 6, 60)
+            : Math.max(top_k * 3, 30);
+        // Determine target tables.
+        // Digests lack source/domain/intent/quality columns, so they are excluded
+        // whenever any metadata filter is active — otherwise unfiltered digests
+        // would leak into results that should only contain matching conversations.
+        const conversationTable = detail === "summary" ? "conversations_hot" : "conversations_cold";
+        const hasMetadataFilter = metadataClauses.length > 0;
+        const includeDigests = detail === "summary" && !hasMetadataFilter && !hasPostFilter;
+        // --- Vector search ---
+        let degraded = false;
+        let degradedReason;
+        const vectorResults = [];
+        try {
+            const queryVec = await embedding.embed(query);
+            // Vector search on conversation table (with metadata + since filters)
+            const convClauses = [...metadataClauses];
+            if (since)
+                convClauses.push(`indexed_at >= '${escapeSql(since)}'`);
+            let convQuery = getTable(conversationTable)
+                .query()
+                .nearestTo(queryVec)
+                .distanceType("cosine")
+                .limit(fetchK);
+            if (convClauses.length > 0) {
+                convQuery = convQuery.where(convClauses.join(" AND "));
+            }
+            const convRows = await convQuery.toArray();
+            for (const row of convRows) {
+                const entry = {
+                    id: row.id,
+                    content: row.content || row.summary || "",
+                    score: 1 - (row._distance ?? 0),
+                    source_table: conversationTable,
+                };
+                const ts = row.indexed_at;
+                if (ts)
+                    entry.indexed_at = ts;
+                const q = row.quality;
+                if (q)
+                    entry.quality = q;
+                const t = row.topics;
+                if (t)
+                    entry.topics = t;
+                const d = row.decisions;
+                if (d)
+                    entry.decisions = d;
+                vectorResults.push(entry);
+            }
+            // Vector search on digests (since filter only, no metadata filters)
+            if (includeDigests) {
+                const digestClauses = [];
+                if (since)
+                    digestClauses.push(`created_at >= '${escapeSql(since)}'`);
+                let digestQuery = getTable("digests")
+                    .query()
+                    .nearestTo(queryVec)
+                    .distanceType("cosine")
+                    .limit(fetchK);
+                if (digestClauses.length > 0) {
+                    digestQuery = digestQuery.where(digestClauses.join(" AND "));
+                }
+                const digestRows = await digestQuery.toArray();
+                for (const row of digestRows) {
+                    const entry = {
+                        id: row.id,
+                        content: row.content || row.summary || "",
+                        score: 1 - (row._distance ?? 0),
+                        source_table: "digests",
+                    };
+                    const ts = row.created_at;
+                    if (ts)
+                        entry.indexed_at = ts;
+                    vectorResults.push(entry);
+                }
+            }
+        }
+        catch (err) {
+            degraded = true;
+            degradedReason = `vector search failed: ${err instanceof Error ? err.message : String(err)}`;
+        }
+        // --- Lexical search ---
+        // Conversation table: with metadata extraClauses
+        const convLexOpts = {
+            top_k: fetchK,
+        };
+        if (metadataClauses.length > 0)
+            convLexOpts.extraClauses = metadataClauses;
+        if (since)
+            convLexOpts.since = since;
+        const convLexResults = await lexicalSearchTables(query, [conversationTable], convLexOpts);
+        // Digests: no metadata extraClauses
+        let digestLexResults = [];
+        if (includeDigests) {
+            const digestLexOpts = { top_k: fetchK };
+            if (since)
+                digestLexOpts.since = since;
+            digestLexResults = await lexicalSearchTables(query, ["digests"], digestLexOpts);
+        }
+        const lexResults = [...convLexResults, ...digestLexResults];
+        // --- Merge vector + lexical (same dedup pattern as hybridSearch) ---
+        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: vr.source_table,
+                retrieval_method: lexMatch ? "hybrid" : "vector",
+            };
+            if (vr.indexed_at)
+                entry.indexed_at = vr.indexed_at;
+            if (vr.quality)
+                entry.quality = vr.quality;
+            if (vr.topics)
+                entry.topics = vr.topics;
+            if (vr.decisions)
+                entry.decisions = vr.decisions;
+            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: lr.source_table,
+                    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;
+                if (lr.topics)
+                    entry.topics = lr.topics;
+                if (lr.decisions)
+                    entry.decisions = lr.decisions;
+                merged.set(lr.id, entry);
+            }
+        }
+        // --- Post-filter on merged candidate pool (BEFORE rerank, per spec) ---
+        const candidates = Array.from(merged.values());
+        const filtered = applyPostFilters(candidates, {
+            ...(topic ? { topic } : {}),
+            ...(decision ? { decision } : {}),
+        });
+        // --- Rerank filtered candidates ---
+        const ranked = rerank(filtered);
+        const topRanked = ranked.slice(0, top_k);
+        const rawRows = await fetchRawRowsForRanked(topRanked);
+        // Detail maps directly to the compact contract: "full" includes raw
+        // content (and already routes to the cold tier above); "summary" emits
+        // only the compact DTO fields. `expand.route` is the unified /search
+        // endpoint per the Slice 1 locked contract, so hot/digest hits can be
+        // expanded round-trip without re-searching conversations_cold only.
+        const topResults = topRanked.map((r) => buildCompactHit(r, rawRows.get(r.id), {
+            query,
+            detail,
+            expandRoute: "/search",
+        }));
+        const response = {
+            results: topResults,
+            degraded,
+        };
+        if (degradedReason)
+            response.degraded_reason = degradedReason;
+        return response;
+    });
+}
+//# sourceMappingURL=conversations-search.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * GET /status/friend — structured payload for the `rift status` header.
+ *
+ * The existing `/status` route returns the capability-map markdown and
+ * stays untouched (it's part of the MCP-tool contract). This route
+ * collects only the signals a friend-readable header needs:
+ *   - build + daemon: from getBuildInfo() + uptime + config.server.port +
+ *     env(VOYAGE_API_KEY) presence
+ *   - voyage: optional `project_label` from config + last successful save
+ *     timestamp from auto-capture-runs.jsonl as a proxy for "last embed"
+ *   - codex: latest auto-capture-runs.jsonl row's preflight_ok + ts
+ *   - capture: latest auto-capture-runs.jsonl row's totals
+ *   - feedback: relay enabled flag from feedback-config.json
+ *
+ * Friend's username, paths, and key bytes never appear in the payload.
+ * MCP-client presence detection is intentionally CLI-side (the friend's
+ * client config files are local, and the renderer needs to print client
+ * names anyway).
+ */
+import type { FastifyInstance } from "fastify";
+import type { Config } from "../../config/schema.js";
+export interface FriendStatusBuild {
+    name: string;
+    version: string;
+    commit: string;
+    node: string;
+}
+export interface FriendStatusDaemon {
+    uptime_seconds: number;
+    port: number;
+    voyage_key_present: boolean;
+}
+export interface FriendStatusVoyage {
+    project_label: string | null;
+    last_embed_at: string | null;
+}
+export interface FriendStatusCodex {
+    last_preflight_at: string | null;
+    last_preflight_ok: boolean | null;
+}
+export interface FriendStatusCapture {
+    last_run_at: string | null;
+    last_run_ok: boolean | null;
+    last_saved: number;
+    last_review: number;
+    last_errors: number;
+    /**
+     * Sessions skipped before triage by the byte-size guard. Surfaced to the
+     * operator-side `--json` payload; the friend-readable header keeps these
+     * out of the "failed" count because quarantining is a graceful skip,
+     * not an error.
+     */
+    last_quarantined: number;
+}
+export interface FriendStatusFeedback {
+    relay_enabled: boolean;
+}
+export interface FriendStatusPayload {
+    build: FriendStatusBuild;
+    daemon: FriendStatusDaemon;
+    voyage: FriendStatusVoyage;
+    codex: FriendStatusCodex;
+    capture: FriendStatusCapture;
+    feedback: FriendStatusFeedback;
+}
+export interface FriendStatusDeps {
+    config: Config;
+    startTime: number;
+}
+export declare function buildFriendStatusPayload(deps: FriendStatusDeps): FriendStatusPayload;
+export declare function registerFriendStatusRoute(server: FastifyInstance, deps: FriendStatusDeps): void;
+//# sourceMappingURL=friend-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"friend-status.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/friend-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GACrB,mBAAmB,CA+DrB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAIN"}