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

package/dist/src/mcp/tools/log-outcome.js

@@ -0,0 +1,59 @@
+/**
+ * rift_log_outcome MCP tool — delegates to POST /outcome/log.
+ *
+ * Logs the substantive task outcome and records positive feedback for evidence
+ * the agent explicitly cites as used. Returned-but-unused hits are never credit.
+ */
+import { z } from "zod";
+import { formatError } from "../errors.js";
+const citedEvidenceSchema = z.object({
+    stable_evidence_key: z.string().optional(),
+    id: z.string().optional(),
+    source_id: z.string().optional(),
+    source_table: z
+        .enum([
+        "structured_docs",
+        "conversations_hot",
+        "conversations_cold",
+        "digests",
+        "structured_docs_local",
+    ])
+        .optional(),
+    source_path: z.string().optional(),
+    parent_id: z.string().optional(),
+    source: z.string().optional(),
+    digest_id: z.string().optional(),
+    rank_at_retrieval: z.number().int().positive().optional(),
+    result_count: z.number().int().positive().optional(),
+    context_pack_bucket: z.string().optional(),
+    position_in_bucket: z.number().int().positive().optional(),
+    reason: z.string().optional(),
+});
+export const logOutcomeSchema = {
+    session_id: z.string().min(1).describe("Stable agent session id"),
+    summary: z.string().min(1).describe("Short outcome summary for this task"),
+    project: z.string().optional().describe("Project/worktree/root this outcome belongs to"),
+    intent: z
+        .enum(["current_truth", "reasoning_archive", "blended"])
+        .describe("Context intent, usually from rift_context_pack.intent"),
+    task: z.string().optional().describe("Original task/request"),
+    cited_evidence: z
+        .array(citedEvidenceSchema)
+        .optional()
+        .describe("Evidence actually used in the answer. Prefer stable_evidence_key from rift_open_evidence; otherwise pass id + source_table."),
+};
+export async function handleRiftLogOutcome(args, client) {
+    try {
+        const { data } = await client.post("/outcome/log", args);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(data, null, 2) },
+            ],
+            structuredContent: data,
+        };
+    }
+    catch (err) {
+        return formatError(err);
+    }
+}
+//# sourceMappingURL=log-outcome.js.map

package/dist/src/mcp/tools/log-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-outcome.js","sourceRoot":"","sources":["../../../../src/mcp/tools/log-outcome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC;QACJ,iBAAiB;QACjB,mBAAmB;QACnB,oBAAoB;QACpB,SAAS;QACT,uBAAuB;KACxB,CAAC;SACD,QAAQ,EAAE;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACjE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACxF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,eAAe,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;SACvD,QAAQ,CAAC,uDAAuD,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC7D,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,mBAAmB,CAAC;SAC1B,QAAQ,EAAE;SACV,QAAQ,CACP,6HAA6H,CAC9H;CACJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAA6B,EAC7B,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aAC/D;YACD,iBAAiB,EAAE,IAA+B;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/mcp/tools/open-evidence.d.ts

@@ -0,0 +1,37 @@
+/**
+ * rift_open_evidence MCP tool — delegates to POST /evidence/open.
+ *
+ * Opens a specific compact hit by id/source_table and records a positive
+ * retrieval-feedback event only after the daemon resolves the exact evidence.
+ */
+import { z } from "zod";
+import type { HttpClient } from "../../cli/http-client.js";
+export declare const openEvidenceSchema: {
+    id: z.ZodString;
+    source_table: z.ZodEnum<["structured_docs", "conversations_hot", "conversations_cold", "digests", "structured_docs_local"]>;
+    detail: z.ZodOptional<z.ZodEnum<["middle", "full"]>>;
+    session_id: z.ZodString;
+    tool_call_id: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    intent: z.ZodEnum<["current_truth", "reasoning_archive", "blended"]>;
+    query: z.ZodOptional<z.ZodString>;
+    task: z.ZodOptional<z.ZodString>;
+    rank_at_retrieval: z.ZodOptional<z.ZodNumber>;
+    result_count: z.ZodOptional<z.ZodNumber>;
+    context_pack_bucket: z.ZodOptional<z.ZodString>;
+    position_in_bucket: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handleRiftOpenEvidence(args: Record<string, unknown>, client: HttpClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+}>;
+//# sourceMappingURL=open-evidence.d.ts.map

package/dist/src/mcp/tools/open-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-evidence.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/open-evidence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;CAgD9B,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU;;;;;;;;;;;uBAQa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;GAKvD"}

package/dist/src/mcp/tools/open-evidence.js

@@ -0,0 +1,72 @@
+/**
+ * rift_open_evidence MCP tool — delegates to POST /evidence/open.
+ *
+ * Opens a specific compact hit by id/source_table and records a positive
+ * retrieval-feedback event only after the daemon resolves the exact evidence.
+ */
+import { z } from "zod";
+import { formatError } from "../errors.js";
+export const openEvidenceSchema = {
+    id: z.string().min(1).describe("Hit id from a compact result's expand.params"),
+    source_table: z
+        .enum([
+        "structured_docs",
+        "conversations_hot",
+        "conversations_cold",
+        "digests",
+        "structured_docs_local",
+    ])
+        .describe("Authoritative backing table from expand.params.source_table"),
+    detail: z
+        .enum(["middle", "full"])
+        .optional()
+        .describe("Evidence detail to open. Prefer middle; use full only when needed."),
+    session_id: z
+        .string()
+        .min(1)
+        .describe("Stable agent session id for deduping repeat opens"),
+    tool_call_id: z.string().optional().describe("Optional host tool-call id"),
+    project: z.string().optional().describe("Project/worktree/root this evidence helped"),
+    intent: z
+        .enum(["current_truth", "reasoning_archive", "blended"])
+        .describe("Context intent, usually from rift_context_pack.intent"),
+    query: z.string().optional().describe("Original search query, if any"),
+    task: z.string().optional().describe("Original context-pack task, if any"),
+    rank_at_retrieval: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-based rank when this hit was returned; used to discount position bias"),
+    result_count: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Total returned results in that list"),
+    context_pack_bucket: z
+        .string()
+        .optional()
+        .describe("Bucket name when opening a ContextPack item"),
+    position_in_bucket: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-based position inside the ContextPack bucket"),
+};
+export async function handleRiftOpenEvidence(args, client) {
+    try {
+        const { data } = await client.post("/evidence/open", args);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(data, null, 2) },
+            ],
+            structuredContent: data,
+        };
+    }
+    catch (err) {
+        return formatError(err);
+    }
+}
+//# sourceMappingURL=open-evidence.js.map

package/dist/src/mcp/tools/open-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-evidence.js","sourceRoot":"","sources":["../../../../src/mcp/tools/open-evidence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC;QACJ,iBAAiB;QACjB,mBAAmB;QACnB,oBAAoB;QACpB,SAAS;QACT,uBAAuB;KACxB,CAAC;SACD,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mDAAmD,CAAC;IAChE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACrF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,eAAe,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;SACvD,QAAQ,CAAC,uDAAuD,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC1E,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;IACtF,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,mBAAmB,EAAE,CAAC;SACnB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAA6B,EAC7B,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aAC/D;YACD,iBAAiB,EAAE,IAA+B;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/mcp/tools/save.d.ts

@@ -1,8 +1,13 @@
 /**
  * rift_save MCP tool — delegates to POST /save.
  *
- * Source enum restricted to unverified-autonomous agents only
- * (same restriction as the HTTP route in src/server/routes/save.ts).
+ * Source enum is DELIBERATELY NARROWER than the HTTP route: it omits
+ * `cursor_composer`. That source means "Rift's own native Cursor capture
+ * produced this", so an external agent calling rift_save must not be able to
+ * self-declare it. The HTTP route in src/server/routes/save.ts accepts it
+ * because the local CLI capture path persists through `POST /save`; this MCP
+ * surface is caller-facing, so it stays restricted. Keep the two enums separate
+ * — do NOT dedupe them.
  */
 import { z } from "zod";
 import type { HttpClient } from "../../cli/http-client.js";

package/dist/src/mcp/tools/save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/save.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,eAAO,MAAM,UAAU;;;;;;;;;;CA+CtB,CAAC;AAEF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU;;;;;;;;;;;GAQnB"}
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,eAAO,MAAM,UAAU;;;;;;;;;;CA+CtB,CAAC;AAEF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU;;;;;;;;;;;GAQnB"}

package/dist/src/mcp/tools/save.js

@@ -1,8 +1,13 @@
 /**
  * rift_save MCP tool — delegates to POST /save.
  *
- * Source enum restricted to unverified-autonomous agents only
- * (same restriction as the HTTP route in src/server/routes/save.ts).
+ * Source enum is DELIBERATELY NARROWER than the HTTP route: it omits
+ * `cursor_composer`. That source means "Rift's own native Cursor capture
+ * produced this", so an external agent calling rift_save must not be able to
+ * self-declare it. The HTTP route in src/server/routes/save.ts accepts it
+ * because the local CLI capture path persists through `POST /save`; this MCP
+ * surface is caller-facing, so it stays restricted. Keep the two enums separate
+ * — do NOT dedupe them.
  */
 import { z } from "zod";
 import { formatError } from "../errors.js";

package/dist/src/mcp/tools/save.js.map

@@ -1 +1 @@
-{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../../src/mcp/tools/save.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;SAChD,QAAQ,CAAC,yCAAyC,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yLAAyL,CAC1L;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC;QACJ,UAAU;QACV,MAAM;QACN,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,UAAU;KACX,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;IAChD,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yTAAyT,CAC1T;IACH,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mLAAmL,CACpL;CACJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA6B,EAC7B,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../../src/mcp/tools/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;SAChD,QAAQ,CAAC,yCAAyC,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yLAAyL,CAC1L;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC;QACJ,UAAU;QACV,MAAM;QACN,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,UAAU;KACX,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;IAChD,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yTAAyT,CAC1T;IACH,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mLAAmL,CACpL;CACJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA6B,EAC7B,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/mcp/tools/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAO3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;CA2ExB,CAAC;AAWF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU;;;;;;;;;;;uBAYwB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;GAKlE"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQ3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;CA2ExB,CAAC;AAWF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU;;;;;;;;;;;uBAiBwB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;GAKlE"}

package/dist/src/mcp/tools/search.js

@@ -8,6 +8,7 @@
 import { z } from "zod";
 import { formatError } from "../errors.js";
 import { renderCompactMarkdown, } from "../../retrieval/compact.js";
+import { buildSearchReceipt, withReceipt } from "../../retrieval/receipt.js";
 export const searchSchema = {
     query: z
         .string()
@@ -78,7 +79,12 @@ export async function handleRiftSearch(args, client) {
             ...(resp.mode === "lexical" ? { lexical: true } : {}),
         });
         return {
-            content: [{ type: "text", text }],
+            content: [
+                {
+                    type: "text",
+                    text: withReceipt(buildSearchReceipt(resp.results), text),
+                },
+            ],
             structuredContent: resp,
         };
     }

package/dist/src/mcp/tools/search.js.map

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

package/dist/src/mcp/tools/status.d.ts

@@ -1,7 +1,17 @@
 /**
- * rift_status MCP tool — delegates to GET /status.
+ * rift_status MCP tool — capability map (GET /status) + capture diagnostics.
+ *
+ * The capability map is the documented contract and always leads. We then
+ * fetch the structured `/status/friend` payload and append a leak-free
+ * capture/preflight diagnosis so an agent can self-diagnose a stalled
+ * auto-capture (preflight worker, error class, summary, next action, recent
+ * capture-error count) without a human dropping to the CLI. The friend payload
+ * carries only canned summaries + counts — never raw stderr or conversation
+ * content — so surfacing it here cannot leak.
  */
 import type { HttpClient } from "../../cli/http-client.js";
+import { type CaptureDiagnostics } from "../capture-diagnostics.js";
+import type { MemoryCoverageDiagnostics } from "../../diagnostics/memory-coverage.js";
 export declare function handleRiftStatus(_args: Record<string, unknown>, client: HttpClient): Promise<{
     content: {
         type: "text";
@@ -9,6 +19,10 @@ export declare function handleRiftStatus(_args: Record<string, unknown>, client:
     }[];
     isError: true;
 } | {
+    structuredContent?: {
+        capture_diagnostics?: CaptureDiagnostics;
+        memory_diagnostics?: MemoryCoverageDiagnostics;
+    };
     content: {
         type: "text";
         text: string;

package/dist/src/mcp/tools/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU;;;;;;;;;;;GASnB"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAkBtF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU;;;;;;;;8BAgBY,kBAAkB;6BACnB,yBAAyB;;;;;;GAmCvD"}

package/dist/src/mcp/tools/status.js

@@ -1,9 +1,60 @@
 import { formatError } from "../errors.js";
+import { buildCaptureDiagnostics, renderCaptureDiagnostics, } from "../capture-diagnostics.js";
+import { renderMemoryDiagnostics } from "../memory-diagnostics.js";
+/**
+ * Narrow an arbitrary `/status/friend` response to the payload shape before we
+ * trust it. Guards against an older daemon, a non-JSON body, or a transient
+ * read returning something we cannot diagnose — in those cases we degrade to
+ * the capability map alone rather than rendering a half-empty block.
+ */
+function isFriendStatusPayload(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        "codex" in value &&
+        "capture" in value &&
+        "daemon" in value);
+}
 export async function handleRiftStatus(_args, client) {
     try {
+        // Capability map first — this is the tool's documented contract and must
+        // always be returned, even if diagnostics are unavailable.
         const data = await client.get("/status");
-        const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
-        return { content: [{ type: "text", text }] };
+        const capabilityMap = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+        // Capture diagnostics — best-effort. A failure to read /status/friend (an
+        // older daemon without the route, an auth or transient error) must never
+        // break the capability map, so it degrades silently to map-only (the
+        // prior behavior).
+        let diagnosticsSection = "";
+        let structuredContent;
+        try {
+            const friend = await client.get("/status/friend");
+            if (isFriendStatusPayload(friend)) {
+                const diag = buildCaptureDiagnostics(friend, Date.now());
+                diagnosticsSection = `\n\n${renderCaptureDiagnostics(diag)}`;
+                structuredContent = { capture_diagnostics: diag };
+                if (friend.memory) {
+                    diagnosticsSection += `\n\n${renderMemoryDiagnostics(friend.memory, {
+                        ...(friend.daemon.config_path
+                            ? { configPath: friend.daemon.config_path }
+                            : {}),
+                        dataDir: friend.daemon.data_dir,
+                    })}`;
+                    structuredContent.memory_diagnostics = friend.memory;
+                }
+            }
+        }
+        catch {
+            // Degrade to capability map only.
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${capabilityMap}${diagnosticsSection}`,
+                },
+            ],
+            ...(structuredContent ? { structuredContent } : {}),
+        };
     }
     catch (err) {
         return formatError(err);

package/dist/src/mcp/tools/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA8B,EAC9B,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,IAAI,KAAK;QAChB,SAAS,IAAI,KAAK;QAClB,QAAQ,IAAI,KAAK,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA8B,EAC9B,MAAkB;IAElB,IAAI,CAAC;QACH,yEAAyE;QACzE,2DAA2D;QAC3D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,aAAa,GACjB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElE,0EAA0E;QAC1E,yEAAyE;QACzE,qEAAqE;QACrE,mBAAmB;QACnB,IAAI,kBAAkB,GAAG,EAAE,CAAC;QAC5B,IAAI,iBAKS,CAAC;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAClD,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzD,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,iBAAiB,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;gBAClD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,kBAAkB,IAAI,OAAO,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE;wBAClE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW;4BAC3B,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;4BAC3C,CAAC,CAAC,EAAE,CAAC;wBACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;qBAChC,CAAC,EAAE,CAAC;oBACL,iBAAiB,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,GAAG,aAAa,GAAG,kBAAkB,EAAE;iBAC9C;aACF;YACD,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/src/observability/retrieval-feedback.d.ts

@@ -0,0 +1,82 @@
+import type { StableEvidenceIdentity } from "../retrieval/evidence-key.js";
+export declare const RETRIEVAL_FEEDBACK_FILE = "retrieval-feedback.jsonl";
+export declare const B_FEED_NEUTRAL = 1;
+export declare const B_FEED_MAX = 1.25;
+export type RetrievalFeedbackEventType = "evidence_opened" | "evidence_cited" | "feedback_reset";
+export interface RetrievalFeedbackEvent {
+    timestamp: string;
+    type: RetrievalFeedbackEventType;
+    stable_evidence_key: string;
+    evidence_kind?: string;
+    source_table?: string;
+    source_id?: string;
+    source_path?: string;
+    parent_id?: string;
+    digest_id?: string;
+    session_id?: string;
+    tool_call_id?: string;
+    outcome_id?: string;
+    project?: string;
+    intent?: string;
+    query?: string;
+    task?: string;
+    rank_at_retrieval?: number;
+    result_count?: number;
+    context_pack_bucket?: string;
+    position_in_bucket?: number;
+    reason?: string;
+    dedupe_key?: string;
+}
+export interface AppendRetrievalFeedbackInput {
+    type: RetrievalFeedbackEventType;
+    identity: StableEvidenceIdentity;
+    session_id?: string;
+    tool_call_id?: string;
+    outcome_id?: string;
+    project?: string;
+    intent?: string;
+    query?: string;
+    task?: string;
+    rank_at_retrieval?: number;
+    result_count?: number;
+    context_pack_bucket?: string;
+    position_in_bucket?: number;
+    reason?: string;
+    dedupe_key?: string;
+    now?: Date;
+}
+export interface AppendRetrievalFeedbackResult {
+    event: RetrievalFeedbackEvent;
+    written: boolean;
+    duplicate: boolean;
+}
+export interface FeedbackBoost {
+    stable_evidence_key: string;
+    B_feed: number;
+    weighted_credit: number;
+    positive_event_count: number;
+    reset_count: number;
+    applied: false;
+}
+export interface FeedbackScope {
+    project?: string;
+    intent?: string;
+    now?: Date;
+}
+export declare function retrievalFeedbackPath(dataDir: string): string;
+export declare function appendRetrievalFeedbackEvent(dataDir: string, input: AppendRetrievalFeedbackInput): AppendRetrievalFeedbackResult;
+export declare function appendFeedbackReset(dataDir: string, input: {
+    identity: StableEvidenceIdentity;
+    session_id?: string;
+    project?: string;
+    intent?: string;
+    reason?: string;
+    now?: Date;
+}): AppendRetrievalFeedbackResult;
+export declare function readRetrievalFeedbackEvents(dataDir: string): RetrievalFeedbackEvent[];
+export declare function computeFeedbackBoosts(events: readonly RetrievalFeedbackEvent[], stableEvidenceKeys: readonly string[], scope?: FeedbackScope): Map<string, FeedbackBoost>;
+export declare function explainFeedback(dataDir: string, stableEvidenceKey: string, scope?: FeedbackScope): FeedbackBoost & {
+    events: RetrievalFeedbackEvent[];
+};
+export declare function positionBiasWeight(event: RetrievalFeedbackEvent): number;
+//# sourceMappingURL=retrieval-feedback.d.ts.map

package/dist/src/observability/retrieval-feedback.d.ts.map

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