chat-recall 0.5.3 → 0.5.5

package/dist/mcp.js

@@ -6149,6 +6149,24 @@ async function parseSessionFile(sessionPath, maxMessages = 50) {
   }
   const filesToParse = hasSubagentsDir(sessionPath) ? [sessionPath, ...getSubagentPaths(sessionPath)] : [sessionPath];
   let userCount = 0;
+  const seenPrompts = /* @__PURE__ */ new Set();
+  const recordPrompt = (raw, line, dedupe = false) => {
+    if (userCount >= maxMessages)
+      return;
+    const withoutReminders = raw.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, "");
+    if (!withoutReminders.trim() || withoutReminders.trim().length <= 10)
+      return;
+    const cleanedText = stripInjectedBanners(withoutReminders).trim();
+    if (cleanedText.length < 10)
+      return;
+    if (dedupe && seenPrompts.has(cleanedText))
+      return;
+    seenPrompts.add(cleanedText);
+    content.userMessages.push({ text: cleanedText, lineNumber: line, contentType: "user" });
+    userCount++;
+    if (!content.firstPrompt)
+      content.firstPrompt = cleanedText.slice(0, 1e3);
+  };
   let assistantCount = 0;
   let toolCount = 0;
   let lineNum = 0;
@@ -6227,19 +6245,11 @@ async function parseSessionFile(sessionPath, maxMessages = 50) {
               text = textParts.join("\n");
             }
           }
-          if (text && !text.includes("<system-reminder>") && text.trim().length > 10) {
-            const cleanedText = stripInjectedBanners(text).trim();
-            if (cleanedText.length < 10)
-              continue;
-            content.userMessages.push({
-              text: cleanedText,
-              lineNumber: lineNum,
-              contentType: "user"
-            });
-            userCount++;
-            if (!content.firstPrompt) {
-              content.firstPrompt = cleanedText.slice(0, 1e3);
-            }
+          if (text)
+            recordPrompt(text, lineNum);
+        } else if (msgType === "queue-operation") {
+          if (obj.operation === "enqueue" && typeof obj.content === "string") {
+            recordPrompt(obj.content, lineNum, true);
           }
         } else if (msgType === "assistant") {
           const msg = obj.message;
@@ -8541,6 +8551,9 @@ var init_generic_engine = __esm({
 // ../engine/dist/core/backends/claude.js
 import { existsSync as existsSync10, readdirSync as readdirSync6, readFileSync as readFileSync6, statSync as statSync8, openSync as openSync4, readSync as readSync4, closeSync as closeSync4 } from "fs";
 import { join as join10, basename as basename8 } from "path";
+function stripReminders(text) {
+  return text.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, "").trim();
+}
 function parseExitCode(text) {
   const m = text.match(/(?:^|\n)\s*(?:exit\s+code|returncode|exit\s+status|exit)\s*[:=]\s*(\d+)\b/i);
   return m ? Number(m[1]) : void 0;
@@ -8849,6 +8862,15 @@ var init_claude2 = __esm({
             }
             const tsIso = typeof obj.timestamp === "string" ? obj.timestamp : void 0;
             const ts = tsIso ? Date.parse(tsIso) || mtime : mtime;
+            if (obj.type === "queue-operation") {
+              if (obj.operation === "enqueue" && typeof obj.content === "string") {
+                const queued = stripReminders(obj.content);
+                if (queued && !queued.startsWith("<task-notification")) {
+                  events.push({ kind: "user", ts, tsIso, line: lineNum, text: queued });
+                }
+              }
+              continue;
+            }
             if (obj.type === "user") {
               const msg = obj.message;
               const content = msg?.content;
@@ -8882,9 +8904,9 @@ var init_claude2 = __esm({
                   }
                 }
               }
-              if (text && !text.includes("<system-reminder>")) {
-                events.push({ kind: "user", ts, tsIso, line: lineNum, text });
-              }
+              const spoken = stripReminders(text);
+              if (spoken)
+                events.push({ kind: "user", ts, tsIso, line: lineNum, text: spoken });
               for (const tr of toolResults) {
                 events.push({
                   kind: "tool_result",
@@ -10499,23 +10521,24 @@ var init_codex2 = __esm({
         return null;
       }
       /**
-       * Stream a Codex JSONL rollout into canonical events. Codex separates:
-       *   - event_msg + payload.type='user_message'        → user
-       *   - response_item + payload.type='message'         → assistant_text
-       *   - response_item + payload.type='function_call'   → tool_use
-       *   - response_item + payload.type='function_call_output' → tool_result
-       *
-       * Filters Codex's wrapper-bearing user messages (environment_context etc.).
-       *
-       * **Subagent fan-out:** Codex orchestrates work via `spawn_agent` calls
-       * that produce sibling rollout files in the same YYYY/MM/DD directory.
-       * Sub-agent rollouts carry `payload.source.subagent.thread_spawn` linking
-       * back to the parent. The actual file edits often happen inside those
-       * subagent rollouts — without folding their events into the parent's
-       * stream, replay/scan would see the parent as edit-free. We append every
-       * subagent rollout's events here so the generic engine sees one unified
-       * stream per user-facing session.
-       */
+        * Stream a Codex JSONL rollout into canonical events. Codex separates:
+        *   - event_msg + payload.type='user_message'        → user
+        *   - response_item + payload.type='message'         → user OR assistant_text,
+      *                                                       by payload.role
+        *   - response_item + payload.type='function_call'   → tool_use
+        *   - response_item + payload.type='function_call_output' → tool_result
+        *
+        * Filters Codex's wrapper-bearing user messages (environment_context etc.).
+        *
+        * **Subagent fan-out:** Codex orchestrates work via `spawn_agent` calls
+        * that produce sibling rollout files in the same YYYY/MM/DD directory.
+        * Sub-agent rollouts carry `payload.source.subagent.thread_spawn` linking
+        * back to the parent. The actual file edits often happen inside those
+        * subagent rollouts — without folding their events into the parent's
+        * stream, replay/scan would see the parent as edit-free. We append every
+        * subagent rollout's events here so the generic engine sees one unified
+        * stream per user-facing session.
+        */
       readEvents(rawId) {
         const located = findCodexSessionFile(this.toRawId(rawId));
         if (!located)
@@ -10585,6 +10608,11 @@ var init_codex2 = __esm({
             if (text && !isCodexInjectedWrapper2(text)) {
               events.push({ kind: "user", ts, tsIso, line: lineNum, text });
             }
+          } else if (obj.type === "response_item" && payload.type === "message" && payload.role === "user") {
+            const text = flattenContent(payload.content).trim();
+            if (text && !isCodexInjectedWrapper2(text)) {
+              events.push({ kind: "user", ts, tsIso, line: lineNum, text });
+            }
           } else if (obj.type === "response_item" && payload.type === "message" && payload.role === "assistant") {
             const text = flattenContent(payload.content).trim();
             if (text)
@@ -17008,7 +17036,9 @@ var init_extractor_version = __esm({
     "use strict";
     BASE_EXTRACTOR_VERSION = 2;
     TOOL_EXTRACTOR_BUMP = {
-      agy: 2
+      agy: 2,
+      claude: 1,
+      codex: 1
     };
     EXTRACTOR_VERSION = BASE_EXTRACTOR_VERSION;
   }
@@ -17326,7 +17356,7 @@ var init_http = __esm({
       CLI_VERSION = JSON.parse(readFileSync31(new URL("../package.json", import.meta.url), "utf-8")).version || CLI_VERSION;
     } catch {
       try {
-        if (true) CLI_VERSION = "0.5.3";
+        if (true) CLI_VERSION = "0.5.5";
       } catch {
       }
     }
@@ -17900,6 +17930,17 @@ async function syncToTarget(cred, opts = {}) {
         if (res.status === 401 || res.status === 403) {
           throw new Error(`server rejected this machine's device token (HTTP ${res.status} \u2014 revoked?). Reconnect with: chat-recall login ${base}`);
         }
+        if (res.status === 402) {
+          let detail = text;
+          try {
+            const body2 = JSON.parse(text);
+            detail = body2.error ?? text;
+            if (body2.resetsAt) detail += ` (resets ${new Date(body2.resetsAt).toISOString().slice(0, 10)})`;
+            if (body2.upgradeUrl) detail += ` \u2014 ${body2.upgradeUrl}`;
+          } catch {
+          }
+          throw new Error(`sync paused by the server: ${detail}`);
+        }
         if (!retryable) throw new Error(`sync failed: HTTP ${res.status} ${text}`);
         if (attempt >= RETRY_DELAYS_MS.length) throw new Error(`sync failed after ${attempt + 1} attempts: HTTP ${res.status} ${text}`);
         const retryAfterS = Number(res.headers.get("retry-after"));
@@ -18784,7 +18825,7 @@ var init_sync_client = __esm({
       ownVersion = JSON.parse(readFileSync32(join41(dir, "../package.json"), "utf-8")).version || ownVersion;
     } catch {
       try {
-        if (true) ownVersion = "0.5.3";
+        if (true) ownVersion = "0.5.5";
       } catch {
       }
     }
@@ -19625,6 +19666,14 @@ async function collectCode(opts) {
       agentPrompt: manifestPrompt(v.violation_type ?? "", file, v.line ?? null, v.description ?? "")
     });
   }
+  {
+    const before = findings.length;
+    const own = findings.filter((f) => !f.file || !isGenerated(f.file));
+    if (own.length !== before) {
+      findings.splice(0, before, ...own);
+      log6(`dropped ${before - own.length} finding(s) in vendored/generated files`);
+    }
+  }
   const godSet = new Set((coup?.god_modules ?? []).map((m) => rel(m.file)));
   const cloneSet = /* @__PURE__ */ new Set();
   for (const g of clones?.groups ?? [])
@@ -19710,7 +19759,9 @@ async function collectCode(opts) {
   }
   for (const g of clones?.groups ?? []) {
     if ((g.count ?? 0) >= 3 || (g.lines ?? 0) >= 12) {
-      const fns = (g.functions ?? []).filter((x) => x && typeof x === "object");
+      const fns = (g.functions ?? []).filter((x) => x && typeof x === "object").filter((x) => !isGenerated(rel(x.file)));
+      if (fns.length < 2)
+        continue;
       const names = [...new Set(fns.map((x) => x.name))];
       const locs = fns.map((x) => rel(x.file)).slice(0, 5);
       pushAction((g.lines ?? 0) * (g.count ?? 0) >= 150 ? 1 : 2, "duplication", `${names.join(", ")} copy-pasted ${g.count}\xD7 (${g.lines} lines each)`, "Extract one shared implementation and replace the copies.", locs.map((f) => ({ file: f })), clonePrompt(names, g.lines ?? 0, g.count ?? 0, locs));
@@ -19729,10 +19780,14 @@ async function collectCode(opts) {
   }
   for (const m of (coup?.god_modules ?? []).slice(0, 5)) {
     const file = rel(m.file);
+    if (isGenerated(file))
+      continue;
     pushAction(2, "modularity", `God module ${file} (fan-in ${m.fan_in}, fan-out ${m.fan_out})`, "Split into cohesive sub-modules; introduce interfaces to cut fan-out.", [{ file }], couplingPrompt(file, m.fan_in ?? 0, m.fan_out ?? 0, Math.round((m.instability ?? 0) * 100) / 100));
   }
   for (const c of (cyc?.cycles ?? []).slice(0, 5)) {
-    const chain = (c.files ?? []).map(rel);
+    const chain = (c.files ?? []).map(rel).filter((f) => !isGenerated(f));
+    if (chain.length < 2)
+      continue;
     pushAction(2, "architecture", `Circular dependency (${chain.length} files)`, "Break the cycle: extract the shared type/interface into a separate module.", chain.slice(0, 4).map((f) => ({ file: f })), cyclePrompt(chain.slice(0, 6)));
   }
   for (const h of hotspotsAll.slice(0, 5)) {
@@ -19871,7 +19926,31 @@ var init_collector = __esm({
       "migration_parity",
       "manifest_compliance"
     ];
-    GENERATED = ["generated/", ".pb.go", ".gen.", "_pb2.py", "/gen/", ".g.dart", "/node_modules/", "/vendor/", ".lock"];
+    GENERATED = [
+      "generated/",
+      "__generated__/",
+      ".pb.go",
+      ".gen.",
+      "_pb2.py",
+      "/gen/",
+      ".g.dart",
+      "/node_modules/",
+      "/vendor/",
+      "/third_party/",
+      "/site-packages/",
+      ".lock",
+      "/dist/",
+      "/build/",
+      "/out/",
+      "/target/",
+      "/.next/",
+      "/coverage/",
+      ".min.js",
+      ".min.css",
+      ".bundle.js",
+      "-bundle.js",
+      ".map"
+    ];
     CF_RE = /\b(if|for|while|switch|case|catch|elif|when|loop|&&|\|\||\?)\b|\?/g;
     DEPTH = 2;
     MCP_OUT_MAX_BYTES = 64 * 1024 * 1024;
@@ -20362,6 +20441,46 @@ var init_service_installer = __esm({
 
 // src/mcp.ts
 import { config } from "dotenv";
+
+// src/mcp-diagnostics.ts
+async function buildHttpError(path, res) {
+  const status = res.status;
+  let body = null;
+  try {
+    body = await res.clone().json();
+  } catch {
+  }
+  const str = (k) => typeof body?.[k] === "string" ? body[k] : "";
+  if (status === 402) {
+    const parts = [str("error") || "payment required"];
+    if (str("detail")) parts.push(str("detail"));
+    if (str("feature")) {
+      parts.push(`This is the "${str("feature")}" capability${str("requires") ? `, on the ${str("requires")} plan` : ""}.`);
+    }
+    if (str("upgradeUrl")) parts.push(`Upgrade: ${str("upgradeUrl")}`);
+    if (str("checkoutHint")) parts.push(str("checkoutHint"));
+    if (str("resendHint")) parts.push(str("resendHint"));
+    parts.push("Nothing has been deleted. The free plan keeps sync and recent-history search working.");
+    return new Error(`server ${path}: ${parts.join(" ")}`);
+  }
+  const hint = status === 401 || status === 403 ? "auth failed \u2014 re-run `chat-recall login <server-url>`" : status === 404 ? "not found \u2014 the id may be wrong, or the server is older than this CLI" : status === 429 ? "rate limited \u2014 retry in a moment" : status >= 500 ? "server error \u2014 check the chat-recall server logs" : str("error") || str("detail") || "request rejected";
+  return new Error(`server ${path}: HTTP ${status} (${hint})`);
+}
+function stalenessBanner(state) {
+  if (!state || state.entitled) return null;
+  const since = state.periodEnd ? new Date(state.periodEnd).toISOString().slice(0, 10) : null;
+  const days = state.periodEnd ? Math.max(0, Math.floor((Date.now() - state.periodEnd) / 864e5)) : null;
+  const reason = state.status === "trialing" ? "the trial has ended" : state.status === "past_due" ? "a payment has not gone through" : "the subscription has lapsed";
+  return [
+    `\u26A0 FREE PLAN \u2014 ${reason}.`,
+    "Search and lists cover only the recent window (default 7 days); older history is stored but locked.",
+    since ? `The plan lapsed ${since}${days !== null ? ` (${days} days ago)` : ""}.` : "",
+    "Do not tell the user their older work does not exist; say it is locked behind the free plan and unlocks on upgrade.",
+    "Sync continues under a monthly quota, export always works, and nothing has been deleted."
+  ].filter(Boolean).join(" ");
+}
+
+// src/mcp.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -20699,10 +20818,6 @@ function remoteCredentials() {
     return null;
   }
 }
-function httpError(path, status) {
-  const hint = status === 401 || status === 403 ? "auth failed \u2014 re-run `chat-recall login <server-url>`" : status === 404 ? "not found \u2014 the id may be wrong, or the server is older than this CLI" : status === 429 ? "rate limited \u2014 retry in a moment" : status >= 500 ? "server error \u2014 check the chat-recall server logs" : "request rejected";
-  return new Error(`server ${path}: HTTP ${status} (${hint})`);
-}
 async function remotePost(path, body) {
   const cred = remoteCredentials();
   if (!cred) throw new Error('scope "server" needs a login \u2014 run `chat-recall login <server-url>` first.');
@@ -20711,7 +20826,7 @@ async function remotePost(path, body) {
     headers: { "content-type": "application/json", authorization: `Bearer ${cred.token}` },
     body: JSON.stringify(body)
   });
-  if (!res.ok) throw httpError(path, res.status);
+  if (!res.ok) throw await buildHttpError(path, res);
   return res.json();
 }
 async function remoteGet(path) {
@@ -20720,7 +20835,7 @@ async function remoteGet(path) {
   const res = await fetch(cred.base + path, {
     headers: { authorization: `Bearer ${cred.token}` }
   });
-  if (!res.ok) throw httpError(path, res.status);
+  if (!res.ok) throw await buildHttpError(path, res);
   return res.json();
 }
 async function remotePatch(path, body) {
@@ -20731,7 +20846,7 @@ async function remotePatch(path, body) {
     headers: { "content-type": "application/json", authorization: `Bearer ${cred.token}` },
     body: JSON.stringify(body)
   });
-  if (!res.ok) throw httpError(path, res.status);
+  if (!res.ok) throw await buildHttpError(path, res);
   return res.json();
 }
 function requireRemote() {
@@ -20777,7 +20892,7 @@ Re-run with a longer prefix or the full id.`;
     }
     return { status: res.status, data: null, message };
   }
-  if (!res.ok) throw httpError(path, res.status);
+  if (!res.ok) throw await buildHttpError(path, res);
   return { status: res.status, data: await res.json() };
 }
 var RecallSearchSchema = z.object({
@@ -20915,7 +21030,12 @@ var RecallTaskUpdateSchema = z.object({
   status: z.enum(TASK_STATUSES).optional(),
   assignee: z.string().optional().describe("Reassign to this user id (sub); empty string unassigns"),
   title: z.string().optional(),
-  comment: z.string().optional().describe("Add a comment to the task")
+  comment: z.string().optional().describe("Add a comment to the task"),
+  linked_session_id: z.string().nullable().optional().describe("Session id to attach to the task (null detaches). Pass YOUR OWN current session id when you start working on the task.")
+});
+var RecallTaskCommentSchema = z.object({
+  task_id: z.string().describe("Task id (t_\u2026) from recall_tasks"),
+  body: z.string().describe("The comment text")
 });
 var RecallKGQuerySchema = z.object({
   entity: z.string().describe('Entity name to query (e.g., "Alice", "chat-recall", "PostgreSQL")'),
@@ -21053,12 +21173,47 @@ var server = new Server(
     }
   }
 );
+var LEAN_TOOLS = /* @__PURE__ */ new Set([
+  // Resume and cold start — the reason most people reach for this at all.
+  "recall_smart_resume",
+  "recall_wake_up",
+  "recall_recent",
+  // Find things.
+  "recall_search",
+  "recall_memory_search",
+  "recall_user_prompts",
+  // Read one session.
+  "recall_context",
+  "recall_summary",
+  "recall_show",
+  // What changed.
+  "recall_edits_timeline",
+  "recall_diff",
+  "recall_commits",
+  // Project state and tasks.
+  "recall_project_context",
+  "recall_tasks",
+  "recall_task_create",
+  "recall_task_update",
+  // Durable memory.
+  "recall_kg_query",
+  "recall_kg_add",
+  "recall_decision_record",
+  "recall_diary_write",
+  "recall_diary_read",
+  // Health, and the one that pays out on day one.
+  "recall_status",
+  "recall_index",
+  "recall_security_summary"
+]);
+function toolProfile() {
+  return (process.env.CHAT_RECALL_MCP_PROFILE || "").toLowerCase() === "full" ? "full" : "lean";
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: "recall_search",
-        description: `Search for relevant past sessions to resume.
+  const all = [
+    {
+      name: "recall_search",
+      description: `Search for relevant past sessions to resume.
 
 Find past conversations matching your current task. Returns session IDs that
 can be used with \`claude --resume <session_id>\`.
@@ -21069,45 +21224,45 @@ Three modes on one tool:
   first prompt as the search text, excludes itself, groups hits by project).
 - \`include_outcome: true\` \u2014 append a per-result outcome one-liner (shipped /
   interrupted / abandoned + edit stats) to judge whether each hit is worth resuming.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: { type: "string", description: `What you're looking for (e.g., "OAuth implementation"). Required unless like_session is set.` },
-            like_session: { type: "string", description: "Find sessions similar to this session id instead of a free-text query." },
-            include_outcome: { type: "boolean", default: false, description: "Append per-result outcome one-liners (status + edit stats)." },
-            top_k: { type: "number", default: 5, description: "Number of results to return" },
-            project_filter: { type: "string", description: "Optional filter by project path substring" },
-            skip_ranking: { type: "boolean", default: false, description: "Skip Claude ranking for faster results" },
-            provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama", description: "Embedding provider" },
-            scope: { type: "string", enum: ["local", "server"], default: "local", description: "Accepted for back-compat; search always runs against the synced server." }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: `What you're looking for (e.g., "OAuth implementation"). Required unless like_session is set.` },
+          like_session: { type: "string", description: "Find sessions similar to this session id instead of a free-text query." },
+          include_outcome: { type: "boolean", default: false, description: "Append per-result outcome one-liners (status + edit stats)." },
+          top_k: { type: "number", default: 5, description: "Number of results to return" },
+          project_filter: { type: "string", description: "Optional filter by project path substring" },
+          skip_ranking: { type: "boolean", default: false, description: "Skip Claude ranking for faster results" },
+          provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama", description: "Embedding provider" },
+          scope: { type: "string", enum: ["local", "server"], default: "local", description: "Accepted for back-compat; search always runs against the synced server." }
         }
-      },
-      {
-        name: "recall_index",
-        description: `Index all Claude Code sessions for semantic search.
+      }
+    },
+    {
+      name: "recall_index",
+      description: `Index all Claude Code sessions for semantic search.
 
 Scans ~/.claude/projects/ and creates embeddings for all sessions.
 By default, only indexes new or changed sessions.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            force: { type: "boolean", default: false, description: "Force re-index all sessions" },
-            provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama", description: "Embedding provider" }
-          }
-        }
-      },
-      {
-        name: "recall_status",
-        description: "Show index status and statistics: synced sessions, chunks, freshness, top projects, plus the full memory-system breakdown (items/chunks per source type, per AI tool, link count).",
-        inputSchema: {
-          type: "object",
-          properties: {}
+      inputSchema: {
+        type: "object",
+        properties: {
+          force: { type: "boolean", default: false, description: "Force re-index all sessions" },
+          provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama", description: "Embedding provider" }
         }
-      },
-      {
-        name: "recall_show",
-        description: `Get conversation content from a specific session \u2014 or the full text of a plan.
+      }
+    },
+    {
+      name: "recall_status",
+      description: "Show index status and statistics: synced sessions, chunks, freshness, top projects, plus the full memory-system breakdown (items/chunks per source type, per AI tool, link count).",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      }
+    },
+    {
+      name: "recall_show",
+      description: `Get conversation content from a specific session \u2014 or the full text of a plan.
 
 Use this after recall_search to get full context from a session. Also accepts a
 plan id (the plan filename without .md, as returned by
@@ -21116,57 +21271,57 @@ recall_memory_search(source_types:['plan'])) and renders the complete plan text.
 Set \`from_end: N\` to fetch the last N messages (no line-number guessing).
 Set \`include_code: true\` to keep code blocks instead of redacting them \u2014 useful
 when the user is asking "what did we change?" and the diffs/SQL/commands matter.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID from search results, or a plan id (filename without .md)" },
-            around_line: { type: "number", description: "Optional line number to show context around" },
-            max_messages: { type: "number", default: 10, description: "Maximum messages to return" },
-            from_end: { type: "number", description: "Return the last N messages (alternative to around_line)." },
-            include_code: { type: "boolean", default: false, description: "Keep code blocks in assistant messages." }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_recent",
-        description: `List recent Claude Code sessions.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID from search results, or a plan id (filename without .md)" },
+          around_line: { type: "number", description: "Optional line number to show context around" },
+          max_messages: { type: "number", default: 10, description: "Maximum messages to return" },
+          from_end: { type: "number", description: "Return the last N messages (alternative to around_line)." },
+          include_code: { type: "boolean", default: false, description: "Keep code blocks in assistant messages." }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_recent",
+      description: `List recent Claude Code sessions.
 
 Shows your most recent conversations across all projects or filtered by project.
 Use this when the user says "continue our last conversation" or wants to see recent work.
 
 Pass \`since_hours: N\` to restrict to sessions modified in the last N hours.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            project_filter: { type: "string", description: 'Filter by project name (e.g., "inco", "poly")' },
-            limit: { type: "number", default: 10, description: "Number of recent sessions to show" },
-            since_hours: { type: "number", description: "Only include sessions modified in the last N hours." },
-            scope: { type: "string", enum: ["local", "server"], default: "local", description: "server = synced cross-device history (needs chat-recall login)." }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_filter: { type: "string", description: 'Filter by project name (e.g., "inco", "poly")' },
+          limit: { type: "number", default: 10, description: "Number of recent sessions to show" },
+          since_hours: { type: "number", description: "Only include sessions modified in the last N hours." },
+          scope: { type: "string", enum: ["local", "server"], default: "local", description: "server = synced cross-device history (needs chat-recall login)." }
         }
-      },
-      {
-        name: "recall_rename_session",
-        description: `Give a conversation a memorable name \u2014 or rename it \u2014 so you (and the user) can find and resume it later.
+      }
+    },
+    {
+      name: "recall_rename_session",
+      description: `Give a conversation a memorable name \u2014 or rename it \u2014 so you (and the user) can find and resume it later.
 
 Mirrors Claude Code's session naming (\`/rename\`). The name replaces the auto-generated summary in
 recall_recent and the web UI. Use it when the user says "name this conversation X", "call this session Y",
 or "rename this to Z". Pass an empty string to clear the name and revert to the auto title.
 
 The name persists across re-syncs and summary regeneration (it's stored separately from the AI summary).`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to name (from recall_recent / recall_search)." },
-            name: { type: "string", description: "The name to give this conversation. Empty string clears it." }
-          },
-          required: ["session_id", "name"]
-        }
-      },
-      {
-        name: "recall_edits_timeline",
-        description: `Chronological list of file edits across recent sessions, spanning every AI tool
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to name (from recall_recent / recall_search)." },
+          name: { type: "string", description: "The name to give this conversation. Empty string clears it." }
+        },
+        required: ["session_id", "name"]
+      }
+    },
+    {
+      name: "recall_edits_timeline",
+      description: `Chronological list of file edits across recent sessions, spanning every AI tool
 chat-recall indexes \u2014 Claude Code, Gemini CLI, OpenCode, Codex and Antigravity.
 
 Returns rows shaped like (timestamp, tool, session_id, project, file, op) sorted newest
@@ -21179,28 +21334,28 @@ two hours of edits across every session and every AI tool.
 
 Pass \`group_by: "session"\` (with \`pattern\` + a wide \`since_hours\`, e.g. 720) to
 aggregate per session instead \u2014 "which sessions edited auth.rs in the last month?".`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            since_hours: { type: "number", default: 24, description: "Time window in hours" },
-            limit: { type: "number", default: 100, description: "Maximum edit rows to return" },
-            pattern: { type: "string", description: "Optional substring filter on file path" },
-            project_filter: { type: "string", description: "Filter by encoded project directory name" },
-            include_reads: { type: "boolean", default: false, description: "Include Read tool_uses too" },
-            tools: {
-              type: "array",
-              items: { type: "string", enum: ["claude", "gemini", "opencode", "codex"] },
-              description: "Restrict to specific AI tools. Default: all four."
-            },
-            group_by_repo: { type: "boolean", default: false, description: "Group results by detected git repo root." },
-            view: { type: "string", enum: ["timeline", "summary"], default: "timeline", description: "timeline = chronological edit rows; summary = aggregated rollup over the same window" },
-            group_by: { type: "string", enum: ["session"], description: '"session" = aggregate edits per session (which sessions touched files matching pattern).' }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          since_hours: { type: "number", default: 24, description: "Time window in hours" },
+          limit: { type: "number", default: 100, description: "Maximum edit rows to return" },
+          pattern: { type: "string", description: "Optional substring filter on file path" },
+          project_filter: { type: "string", description: "Filter by encoded project directory name" },
+          include_reads: { type: "boolean", default: false, description: "Include Read tool_uses too" },
+          tools: {
+            type: "array",
+            items: { type: "string", enum: ["claude", "gemini", "opencode", "codex"] },
+            description: "Restrict to specific AI tools. Default: all four."
+          },
+          group_by_repo: { type: "boolean", default: false, description: "Group results by detected git repo root." },
+          view: { type: "string", enum: ["timeline", "summary"], default: "timeline", description: "timeline = chronological edit rows; summary = aggregated rollup over the same window" },
+          group_by: { type: "string", enum: ["session"], description: '"session" = aggregate edits per session (which sessions touched files matching pattern).' }
         }
-      },
-      {
-        name: "recall_context",
-        description: `Get structured context from a session for continuation.
+      }
+    },
+    {
+      name: "recall_context",
+      description: `Get structured context from a session for continuation.
 
 Returns:
 - Your requests/inputs
@@ -21210,17 +21365,17 @@ Returns:
 - Summary if available
 
 Use this to understand what happened in a session before resuming.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to get context from" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_summary",
-        description: `Get the summary for a session \u2014 including its OUTCOME classification.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to get context from" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_summary",
+      description: `Get the summary for a session \u2014 including its OUTCOME classification.
 
 By default returns a *rich* summary that combines the AI summary (when available)
 with the structured outcome derived from the transcript itself: status (shipped /
@@ -21231,18 +21386,18 @@ markers, and the last assistant claim paired with the user's reaction to it
 This is the triage call when scanning a session list \u2014 it answers the question
 the AI summary doesn't: did this work actually land?
 Pass \`rich: false\` to fall back to the legacy single-line AI summary only.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to get summary for" },
-            rich: { type: "boolean", default: true, description: "Include structured outcome alongside AI summary" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_diff",
-        description: `Replay a session's Edit/Write/MultiEdit/NotebookEdit tool calls into a unified
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to get summary for" },
+          rich: { type: "boolean", default: true, description: "Include structured outcome alongside AI summary" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_diff",
+      description: `Replay a session's Edit/Write/MultiEdit/NotebookEdit tool calls into a unified
 diff per file. Lets you see what the agent actually changed \u2014 not just that it
 edited, but how \u2014 without grepping the raw transcript.
 
@@ -21253,21 +21408,21 @@ Pass \`file\` to focus on a single absolute path. Pass \`context_only: true\` fo
 just the per-file stats (lines added/removed) when you don't need the diff body.
 Pass \`files_only: true\` for just the list of files the session touched (grouped
 by extension, with tools used) \u2014 "which files did session X actually touch?".`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to replay" },
-            file: { type: "string", description: "Absolute file path to focus on (optional)" },
-            context_only: { type: "boolean", default: false, description: "Skip diff bodies, return stats only" },
-            files_only: { type: "boolean", default: false, description: "Return just the file list (no diffs/stats)" },
-            max_diff_chars: { type: "number", default: 4e3, description: "Truncate each per-file unified diff" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_commits",
-        description: `Find git commits that landed during a session's edit window, grouped by repo.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to replay" },
+          file: { type: "string", description: "Absolute file path to focus on (optional)" },
+          context_only: { type: "boolean", default: false, description: "Skip diff bodies, return stats only" },
+          files_only: { type: "boolean", default: false, description: "Return just the file list (no diffs/stats)" },
+          max_diff_chars: { type: "number", default: 4e3, description: "Truncate each per-file unified diff" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_commits",
+      description: `Find git commits that landed during a session's edit window, grouped by repo.
 
 Multi-repo aware: a session that touched ~/code/personal/k8s_gpu and
 ~/code/personal/munbot returns commits from each repo, with overlap shown
@@ -21275,18 +21430,18 @@ between commit-files and session-touched-files.
 
 Use this to verify "shipped" claims \u2014 if the session edited 18 files but no
 matching commit exists, work probably stayed local.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to look up commits for" },
-            buffer_minutes: { type: "number", default: 30, description: "Window padding on each side" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_markers",
-        description: `Tag every user prompt in a session with sentiment / corrective markers:
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to look up commits for" },
+          buffer_minutes: { type: "number", default: 30, description: "Window padding on each side" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_markers",
+      description: `Tag every user prompt in a session with sentiment / corrective markers:
 
   \u2022 interrupt              \u2014 user hit ESC mid-response
   \u2022 frustrated             \u2014 caps, profanity, "wtf", "ffs"
@@ -21298,43 +21453,43 @@ matching commit exists, work probably stayed local.`,
 
 Returns per-prompt markers + a session-level summary count. Use this to spot
 sessions where things went sideways before reading the whole transcript.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to mark prompts in" },
-            limit: { type: "number", default: 200, description: "Maximum prompts to return" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_memory_search",
-        description: `Search across all memory types: sessions, plans, tasks, CLAUDE.md files, history, paste cache, and agent diaries.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to mark prompts in" },
+          limit: { type: "number", default: 200, description: "Maximum prompts to return" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_memory_search",
+      description: `Search across all memory types: sessions, plans, tasks, CLAUDE.md files, history, paste cache, and agent diaries.
 
 Returns results from any memory source, ranked by relevance. Use source_types to filter.
 Plans and tasks are found here (source_types: ['plan', 'task']); read a full plan
 with recall_show (pass the plan id).`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: { type: "string", description: "What you're looking for across all memory types" },
-            top_k: { type: "number", default: 10, description: "Number of results" },
-            source_types: {
-              type: "array",
-              items: { type: "string", enum: ["session", "plan", "task", "claude_md", "paste", "history", "diary"] },
-              description: "Filter by source types (default: all)"
-            },
-            project_filter: { type: "string", description: "Filter by project path" },
-            provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama" },
-            scope: { type: "string", enum: ["local", "server"], default: "local", description: "server = synced cross-device history (needs chat-recall login)." },
-            semantic: { type: "boolean", default: false, description: "Also run the pgvector semantic tier, not just keyword FTS. Needs an embedder configured server-side; ignored otherwise." }
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "What you're looking for across all memory types" },
+          top_k: { type: "number", default: 10, description: "Number of results" },
+          source_types: {
+            type: "array",
+            items: { type: "string", enum: ["session", "plan", "task", "claude_md", "paste", "history", "diary"] },
+            description: "Filter by source types (default: all)"
           },
-          required: ["query"]
-        }
-      },
-      {
-        name: "recall_smart_resume",
-        description: `Get structured resume context for a session.
+          project_filter: { type: "string", description: "Filter by project path" },
+          provider: { type: "string", enum: ["ollama", "gemini"], default: "ollama" },
+          scope: { type: "string", enum: ["local", "server"], default: "local", description: "server = synced cross-device history (needs chat-recall login)." },
+          semantic: { type: "boolean", default: false, description: "Also run the pgvector semantic tier, not just keyword FTS. Needs an embedder configured server-side; ignored otherwise." }
+        },
+        required: ["query"]
+      }
+    },
+    {
+      name: "recall_smart_resume",
+      description: `Get structured resume context for a session.
 
 Returns:
 - What was done (completed work, decisions made)
@@ -21344,17 +21499,17 @@ Returns:
 - Resume command
 
 Use this instead of recall_context for a more actionable summary when resuming work.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID to resume" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_project_context",
-        description: `Get the full project dossier as markdown \u2014 rich project context.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID to resume" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_project_context",
+      description: `Get the full project dossier as markdown \u2014 rich project context.
 
 Aggregates everything the index knows about one project into a single report:
 overview (from CLAUDE.md), tech stack (KG uses), architecture / deployment / security
@@ -21369,20 +21524,20 @@ Accepts EITHER a project path / name substring (e.g. "munbot", "chat-recall",
   - "user:<custom>"               (declared in ~/.chat-recall/projects.json)
 
 Use at the START of a new session to understand what's been happening in a project.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            project_path: { type: "string", description: "Project path, name substring, or project_id (git:/ws:/git-local:/user:)" },
-            limit: { type: "number", default: 5, description: "Number of recent sessions to include" },
-            tasks: { type: "number", default: 20, description: "Max open tasks to list" },
-            plans: { type: "number", default: 20, description: "Max plans to list" }
-          },
-          required: ["project_path"]
-        }
-      },
-      {
-        name: "recall_weekly_digest",
-        description: `Get a weekly activity digest across all projects.
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_path: { type: "string", description: "Project path, name substring, or project_id (git:/ws:/git-local:/user:)" },
+          limit: { type: "number", default: 5, description: "Number of recent sessions to include" },
+          tasks: { type: "number", default: 20, description: "Max open tasks to list" },
+          plans: { type: "number", default: 20, description: "Max plans to list" }
+        },
+        required: ["project_path"]
+      }
+    },
+    {
+      name: "recall_weekly_digest",
+      description: `Get a weekly activity digest across all projects.
 
 Returns:
 - Session count, total cost, coding time
@@ -21392,16 +21547,16 @@ Returns:
 - Git activity summary
 
 Use to understand overall productivity and spending.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            weeks_back: { type: "number", default: 0, description: "0 = current week, 1 = last week" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          weeks_back: { type: "number", default: 0, description: "0 = current week, 1 = last week" }
         }
-      },
-      {
-        name: "recall_team_activity",
-        description: `See what each teammate did, grouped by project \u2014 the team activity view.
+      }
+    },
+    {
+      name: "recall_team_activity",
+      description: `See what each teammate did, grouped by project \u2014 the team activity view.
 
 Returns a per-member \xD7 per-project rollup (session counts + last activity) for
 your team. Scoped to what you're allowed to see: your own work plus teammates'
@@ -21409,210 +21564,236 @@ work on projects they've shared into the team (private projects never appear).
 
 Use for "what has the team been working on", "what did <teammate> do on <project>",
 or standup/status. Filter by project, by member, or by recency (since_days).`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            project: { type: "string", description: "Filter to one project_id" },
-            member: { type: "string", description: "Filter to one teammate (user id / sub)" },
-            since_days: { type: "number", description: "Only activity in the last N days" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          project: { type: "string", description: "Filter to one project_id" },
+          member: { type: "string", description: "Filter to one teammate (user id / sub)" },
+          since_days: { type: "number", description: "Only activity in the last N days" }
         }
-      },
-      {
-        name: "recall_tasks",
-        description: `List collaborative team tasks (the shared task board).
+      }
+    },
+    {
+      name: "recall_tasks",
+      description: `List collaborative team tasks (the shared task board).
 
 Team-visible tasks with status, assignee, and project. Use for "what's on the
 team's plate", "my tasks", or to find a task id to update. Filter by mine /
 project / status.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            mine: { type: "boolean", description: "Only tasks assigned to me" },
-            project: { type: "string", description: "Filter to one project_id" },
-            status: { type: "string", enum: [...TASK_STATUSES], description: "Filter by status" }
-          }
-        }
-      },
-      {
-        name: "recall_task_create",
-        description: `Create a collaborative team task. Optionally assign it to a teammate and
-attach it to a project. Returns the new task id.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            title: { type: "string", description: "Task title" },
-            description: { type: "string" },
-            project: { type: "string", description: "project_id this task belongs to" },
-            assignee: { type: "string", description: "Teammate user id (sub) to assign" }
-          },
-          required: ["title"]
-        }
-      },
-      {
-        name: "recall_task_update",
-        description: `Update a team task: change status, reassign, rename, and/or add a comment.
-Pass the task id (t_\u2026) from recall_tasks.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            id: { type: "string", description: "Task id (t_\u2026)" },
-            status: { type: "string", enum: [...TASK_STATUSES] },
-            assignee: { type: "string", description: "Reassign to this user id (sub)" },
-            title: { type: "string" },
-            comment: { type: "string", description: "Add a comment" }
-          },
-          required: ["id"]
+      inputSchema: {
+        type: "object",
+        properties: {
+          mine: { type: "boolean", description: "Only tasks assigned to me" },
+          project: { type: "string", description: "Filter to one project_id" },
+          status: { type: "string", enum: [...TASK_STATUSES], description: "Filter by status" }
         }
-      },
-      // ── Knowledge Graph Tools ──────────────────────────────────
-      {
-        name: "recall_kg_query",
-        description: `Query the knowledge graph for an entity's relationships.
+      }
+    },
+    {
+      name: "recall_task_create",
+      description: `Create a collaborative team task. Optionally assign it to a teammate and
+attach it to a project. Returns the new task id.
+
+When you then START working on a task, use recall_task_update to set status
+'in_progress' and link your current session (linked_session_id) \u2014 that is what
+lets the board verify the work actually shipped.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          title: { type: "string", description: "Task title" },
+          description: { type: "string" },
+          project: { type: "string", description: "project_id this task belongs to" },
+          assignee: { type: "string", description: "Teammate user id (sub) to assign" }
+        },
+        required: ["title"]
+      }
+    },
+    {
+      name: "recall_task_update",
+      description: `Update a team task: change status, reassign, rename, link a session, and/or
+add a comment. Pass the task id (t_\u2026) from recall_tasks.
+
+WORKFLOW \u2014 do this whenever the user asks you to work on a task from the board:
+1. When you start, set status 'in_progress' AND pass your own current session id
+   as linked_session_id (the session id you know from your own context; this MCP
+   server cannot see it). The board uses that link to show whether the linked
+   session actually shipped \u2014 files, diff stats, commits.
+2. When you finish, set status 'done'.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Task id (t_\u2026)" },
+          status: { type: "string", enum: [...TASK_STATUSES] },
+          assignee: { type: "string", description: "Reassign to this user id (sub)" },
+          title: { type: "string" },
+          comment: { type: "string", description: "Add a comment" },
+          linked_session_id: { type: "string", description: "Session id to attach \u2014 pass YOUR OWN current session id when you start working on this task, so the board can check whether the work shipped. Null detaches." }
+        },
+        required: ["id"]
+      }
+    },
+    {
+      name: "recall_task_comment",
+      description: `Leave a progress note on a team task \u2014 a comment visible to everyone on the
+board. Use it to record what you did, what is blocked, or why a status changed,
+without editing the task itself. Pass the task id (t_\u2026) from recall_tasks.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          task_id: { type: "string", description: "Task id (t_\u2026) from recall_tasks" },
+          body: { type: "string", description: "The comment text" }
+        },
+        required: ["task_id", "body"]
+      }
+    },
+    // ── Knowledge Graph Tools ──────────────────────────────────
+    {
+      name: "recall_kg_query",
+      description: `Query the knowledge graph for an entity's relationships.
 
 Returns typed facts with temporal validity. E.g. "chat-recall" \u2192 uses TypeScript, has source FTS5.
 Filter by date with as_of to see what was true at a specific point in time.
 Use this to VERIFY facts before asserting them.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            entity: { type: "string", description: 'Entity to query (e.g., "Alice", "chat-recall")' },
-            as_of: { type: "string", description: "Date filter (YYYY-MM-DD, optional)" },
-            direction: { type: "string", enum: ["outgoing", "incoming", "both"], default: "both" }
-          },
-          required: ["entity"]
-        }
-      },
-      {
-        name: "recall_kg_add",
-        description: `Add a fact to the knowledge graph. Subject \u2192 predicate \u2192 object with optional time window.
+      inputSchema: {
+        type: "object",
+        properties: {
+          entity: { type: "string", description: 'Entity to query (e.g., "Alice", "chat-recall")' },
+          as_of: { type: "string", description: "Date filter (YYYY-MM-DD, optional)" },
+          direction: { type: "string", enum: ["outgoing", "incoming", "both"], default: "both" }
+        },
+        required: ["entity"]
+      }
+    },
+    {
+      name: "recall_kg_add",
+      description: `Add a fact to the knowledge graph. Subject \u2192 predicate \u2192 object with optional time window.
 
 E.g. ("chat-recall", "uses", "LanceDB", valid_from="2024-01-15")`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            subject: { type: "string", description: "The entity doing/being something" },
-            predicate: { type: "string", description: 'Relationship type (e.g., "uses", "works_on", "prefers")' },
-            object: { type: "string", description: "The entity being connected to" },
-            valid_from: { type: "string", description: "When this became true (YYYY-MM-DD, optional)" },
-            source_session: { type: "string", description: "Session ID where this was learned (optional)" }
-          },
-          required: ["subject", "predicate", "object"]
-        }
-      },
-      {
-        name: "recall_kg_invalidate",
-        description: `Mark a fact as no longer true. Use when things change \u2014 tools replaced, decisions reversed, people leave.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            subject: { type: "string", description: "Entity" },
-            predicate: { type: "string", description: "Relationship" },
-            object: { type: "string", description: "Connected entity" },
-            ended: { type: "string", description: "When it stopped being true (YYYY-MM-DD, default: today)" }
-          },
-          required: ["subject", "predicate", "object"]
+      inputSchema: {
+        type: "object",
+        properties: {
+          subject: { type: "string", description: "The entity doing/being something" },
+          predicate: { type: "string", description: 'Relationship type (e.g., "uses", "works_on", "prefers")' },
+          object: { type: "string", description: "The entity being connected to" },
+          valid_from: { type: "string", description: "When this became true (YYYY-MM-DD, optional)" },
+          source_session: { type: "string", description: "Session ID where this was learned (optional)" }
+        },
+        required: ["subject", "predicate", "object"]
+      }
+    },
+    {
+      name: "recall_kg_invalidate",
+      description: `Mark a fact as no longer true. Use when things change \u2014 tools replaced, decisions reversed, people leave.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          subject: { type: "string", description: "Entity" },
+          predicate: { type: "string", description: "Relationship" },
+          object: { type: "string", description: "Connected entity" },
+          ended: { type: "string", description: "When it stopped being true (YYYY-MM-DD, default: today)" }
+        },
+        required: ["subject", "predicate", "object"]
+      }
+    },
+    {
+      name: "recall_kg_timeline",
+      description: `Get chronological timeline of facts. Shows the story of an entity (or everything) in order.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          entity: { type: "string", description: "Entity to get timeline for (optional)" },
+          limit: { type: "number", default: 50 }
         }
-      },
+      }
+    },
+    {
+      name: "recall_kg_stats",
+      description: "Knowledge graph overview: entities, triples, current vs expired facts, relationship types.",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      }
+    },
+    // ── Diary Tools ────────────────────────────────────────────
+    {
+      name: "recall_diary_write",
+      description: `Write to your agent diary. Record observations, decisions, what you worked on, what matters.
+
+Each agent gets their own persistent diary across sessions. Use this at the end of sessions
+or when you learn something important that should persist.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_name: { type: "string", description: "Your name \u2014 each agent gets their own diary" },
+          entry: { type: "string", description: "What happened, what you learned, what matters" },
+          topic: { type: "string", default: "general", description: "Topic tag" },
+          session_id: { type: "string", description: "Current session ID (for linking)" },
+          project_path: { type: "string", description: "Project path (for context)" }
+        },
+        required: ["agent_name", "entry"]
+      }
+    },
+    {
+      name: "recall_diary_read",
+      description: `Read your recent diary entries. See what past versions of yourself recorded across sessions.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_name: { type: "string", description: "Agent name to read diary for" },
+          last_n: { type: "number", default: 10, description: "Number of recent entries" }
+        },
+        required: ["agent_name"]
+      }
+    },
+    // ── Code intelligence (codeindex companion) ──
+    // Registered ONLY when the codeindex binary is on PATH: recall_code_index
+    // runs the analyzer locally, and the other three are its server-side
+    // browse companions — without the binary the family is dead surface.
+    ...codeindexAvailable() ? [
       {
-        name: "recall_kg_timeline",
-        description: `Get chronological timeline of facts. Shows the story of an entity (or everything) in order.`,
+        name: "recall_code_index",
+        description: `Index a code repository with codeindex and sync its findings/hotspots/actions to your chat-recall server. Runs the codeindex analyzer LOCALLY (needs the repo files + git history), then ships the result. Use before recall_code_findings/actions if a repo hasn't been indexed yet.`,
         inputSchema: {
           type: "object",
-          properties: {
-            entity: { type: "string", description: "Entity to get timeline for (optional)" },
-            limit: { type: "number", default: 50 }
-          }
+          properties: { path: { type: "string", description: "Repo path (default: cwd)" } }
         }
       },
       {
-        name: "recall_kg_stats",
-        description: "Knowledge graph overview: entities, triples, current vs expired facts, relationship types.",
-        inputSchema: {
-          type: "object",
-          properties: {}
-        }
+        name: "recall_code_projects",
+        description: `List code-indexed projects on your server with health score, finding count, and label (poc/production/engineering).`,
+        inputSchema: { type: "object", properties: {} }
       },
-      // ── Diary Tools ────────────────────────────────────────────
       {
-        name: "recall_diary_write",
-        description: `Write to your agent diary. Record observations, decisions, what you worked on, what matters.
-
-Each agent gets their own persistent diary across sessions. Use this at the end of sessions
-or when you learn something important that should persist.`,
+        name: "recall_code_findings",
+        description: `List code findings (security / hardcoded literals / copy-paste clones / reinvention / dead code / coupling / cycles). Each finding carries a concrete, ready-to-run agent prompt that references codeindex tools. Filter by project/severity/category.`,
         inputSchema: {
           type: "object",
           properties: {
-            agent_name: { type: "string", description: "Your name \u2014 each agent gets their own diary" },
-            entry: { type: "string", description: "What happened, what you learned, what matters" },
-            topic: { type: "string", default: "general", description: "Topic tag" },
-            session_id: { type: "string", description: "Current session ID (for linking)" },
-            project_path: { type: "string", description: "Project path (for context)" }
-          },
-          required: ["agent_name", "entry"]
+            project: { type: "string", description: "Project id (omit for all)" },
+            severity: { type: "string", enum: ["critical", "high", "medium", "low", "info"] },
+            category: { type: "string", description: "security|literal|clone|duplication|dead_code|coupling|cycle" },
+            limit: { type: "number", default: 50 },
+            view: { type: "string", enum: ["findings", "summary", "hotspots", "file-sessions"], default: "findings", description: "findings = the list; summary = counts by severity/category; hotspots = churn-ranked files; file-sessions = which sessions touched `file`" },
+            file: { type: "string", description: "view=file-sessions only: repo-relative path" }
+          }
         }
       },
       {
-        name: "recall_diary_read",
-        description: `Read your recent diary entries. See what past versions of yourself recorded across sessions.`,
+        name: "recall_code_actions",
+        description: `The ranked, actionable plan for a codebase \u2014 prioritised tasks synthesised from the findings, each with a ready agent prompt. This is the "what should I fix next" list. Filter by project/status.`,
         inputSchema: {
           type: "object",
           properties: {
-            agent_name: { type: "string", description: "Agent name to read diary for" },
-            last_n: { type: "number", default: 10, description: "Number of recent entries" }
-          },
-          required: ["agent_name"]
-        }
-      },
-      // ── Code intelligence (codeindex companion) ──
-      // Registered ONLY when the codeindex binary is on PATH: recall_code_index
-      // runs the analyzer locally, and the other three are its server-side
-      // browse companions — without the binary the family is dead surface.
-      ...codeindexAvailable() ? [
-        {
-          name: "recall_code_index",
-          description: `Index a code repository with codeindex and sync its findings/hotspots/actions to your chat-recall server. Runs the codeindex analyzer LOCALLY (needs the repo files + git history), then ships the result. Use before recall_code_findings/actions if a repo hasn't been indexed yet.`,
-          inputSchema: {
-            type: "object",
-            properties: { path: { type: "string", description: "Repo path (default: cwd)" } }
-          }
-        },
-        {
-          name: "recall_code_projects",
-          description: `List code-indexed projects on your server with health score, finding count, and label (poc/production/engineering).`,
-          inputSchema: { type: "object", properties: {} }
-        },
-        {
-          name: "recall_code_findings",
-          description: `List code findings (security / hardcoded literals / copy-paste clones / reinvention / dead code / coupling / cycles). Each finding carries a concrete, ready-to-run agent prompt that references codeindex tools. Filter by project/severity/category.`,
-          inputSchema: {
-            type: "object",
-            properties: {
-              project: { type: "string", description: "Project id (omit for all)" },
-              severity: { type: "string", enum: ["critical", "high", "medium", "low", "info"] },
-              category: { type: "string", description: "security|literal|clone|duplication|dead_code|coupling|cycle" },
-              limit: { type: "number", default: 50 },
-              view: { type: "string", enum: ["findings", "summary", "hotspots", "file-sessions"], default: "findings", description: "findings = the list; summary = counts by severity/category; hotspots = churn-ranked files; file-sessions = which sessions touched `file`" },
-              file: { type: "string", description: "view=file-sessions only: repo-relative path" }
-            }
-          }
-        },
-        {
-          name: "recall_code_actions",
-          description: `The ranked, actionable plan for a codebase \u2014 prioritised tasks synthesised from the findings, each with a ready agent prompt. This is the "what should I fix next" list. Filter by project/status.`,
-          inputSchema: {
-            type: "object",
-            properties: {
-              project: { type: "string", description: "Project id (omit for all)" },
-              status: { type: "string", enum: ["suggested", "queued", "done", "dismissed"] },
-              limit: { type: "number", default: 30 }
-            }
+            project: { type: "string", description: "Project id (omit for all)" },
+            status: { type: "string", enum: ["suggested", "queued", "done", "dismissed"] },
+            limit: { type: "number", default: 30 }
           }
         }
-      ] : [],
-      {
-        name: "recall_recommendations",
-        description: `Actionable recommendations, two scopes on one tool:
+      }
+    ] : [],
+    {
+      name: "recall_recommendations",
+      description: `Actionable recommendations, two scopes on one tool:
 
 - scope "account" (default) \u2014 from YOUR chat-recall data: leaked secrets found by
   the scanner + session behaviour (unresolved/abandoned). Returns concrete
@@ -21622,21 +21803,21 @@ or when you learn something important that should persist.`,
   a skill, set a project label, or reset a POC db. Reasons over BOTH the code
   findings and how sessions in this project went (failed/abandoned, recurring
   corrections). Each has rationale + evidence + an apply-action.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            scope: { type: "string", enum: ["account", "project"], default: "account", description: "account = your chat-recall data; project = one code-indexed project" },
-            project: { type: "string", description: 'Project id (from recall_code_projects). Required when scope is "project".' }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          scope: { type: "string", enum: ["account", "project"], default: "account", description: "account = your chat-recall data; project = one code-indexed project" },
+          project: { type: "string", description: 'Project id (from recall_code_projects). Required when scope is "project".' }
         }
-      },
-      // ── Aggregated views over the recommendation engines ──
-      // Registered UNGATED, unlike the recall_code_* family: they read findings
-      // the SERVER already holds, so a machine without the codeindex binary can
-      // still see them. Both degrade to account scope when no project is indexed.
-      {
-        name: "recall_claude_suggestions",
-        description: `Every finding that turns into an agent-instruction change, in one list \u2014 the
+      }
+    },
+    // ── Aggregated views over the recommendation engines ──
+    // Registered UNGATED, unlike the recall_code_* family: they read findings
+    // the SERVER already holds, so a machine without the codeindex binary can
+    // still see them. Both degrade to account scope when no project is indexed.
+    {
+      name: "recall_claude_suggestions",
+      description: `Every finding that turns into an agent-instruction change, in one list \u2014 the
 "what should I tell Claude about this?" view.
 
 Merges the CLAUDE.md rules and skill installs from BOTH recommendation engines:
@@ -21648,18 +21829,18 @@ paste.
 This is the read side. To apply one, use the apply rail the recommendation
 already names (recall_recommendations documents it) \u2014 this tool never edits a
 CLAUDE.md itself.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            project: { type: "string", description: "Limit to one code-indexed project id (from recall_code_projects)" },
-            include_projects: { type: "boolean", default: true, description: "Also fan out over code-indexed projects. false = account scope only." },
-            kind: { type: "string", enum: [...INSTRUCTION_KINDS], description: "rule = a CLAUDE.md line; skill = a skill to install. Omit for both." }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          project: { type: "string", description: "Limit to one code-indexed project id (from recall_code_projects)" },
+          include_projects: { type: "boolean", default: true, description: "Also fan out over code-indexed projects. false = account scope only." },
+          kind: { type: "string", enum: [...INSTRUCTION_KINDS], description: "rule = a CLAUDE.md line; skill = a skill to install. Omit for both." }
         }
-      },
-      {
-        name: "recall_improvements",
-        description: `Every improvement worth doing, ranked highest-priority first \u2014 the "what should
+      }
+    },
+    {
+      name: "recall_improvements",
+      description: `Every improvement worth doing, ranked highest-priority first \u2014 the "what should
 I fix next, across everything" view.
 
 Merges the ranked code actions (recall_code_actions) with the non-instruction
@@ -21670,273 +21851,322 @@ severity; both are mapped onto one scale so a single ordered list is honest.
 Set \`create_tasks: true\` to open one task per improvement on the shared team
 board (recall_tasks). It is off by default \u2014 this reads unless you ask it to
 write.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            project: { type: "string", description: "Limit to one code-indexed project id" },
-            min_severity: { type: "string", enum: [...SEVERITIES], default: "low", description: "Drop anything below this severity" },
-            limit: { type: "number", default: 30, description: "Maximum improvements to return, after ranking" },
-            create_tasks: { type: "boolean", default: false, description: "Create one team task per returned improvement" },
-            assignee: { type: "string", description: "create_tasks only: teammate user id (sub) to assign each task to" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          project: { type: "string", description: "Limit to one code-indexed project id" },
+          min_severity: { type: "string", enum: [...SEVERITIES], default: "low", description: "Drop anything below this severity" },
+          limit: { type: "number", default: 30, description: "Maximum improvements to return, after ranking" },
+          create_tasks: { type: "boolean", default: false, description: "Create one team task per returned improvement" },
+          assignee: { type: "string", description: "create_tasks only: teammate user id (sub) to assign each task to" }
         }
-      },
-      // ── User-prompts / decision-record ──
-      {
-        name: "recall_user_prompts",
-        description: `List the human-typed prompts from a session (or recent sessions). Tool results
+      }
+    },
+    // ── User-prompts / decision-record ──
+    {
+      name: "recall_user_prompts",
+      description: `List the human-typed prompts from a session (or recent sessions). Tool results
 and system banners are stripped \u2014 you get only what the user actually wrote. Useful for "what was
 I asking yesterday?" or "what did I tell the agent in this session?".`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "If set, only that session's prompts" },
-            since_days: { type: "number", default: 7 },
-            limit: { type: "number", default: 50 }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "If set, only that session's prompts" },
+          since_days: { type: "number", default: 7 },
+          limit: { type: "number", default: 50 }
         }
-      },
-      {
-        name: "recall_decision_record",
-        description: `Record an explicit decision so it shows up in wake-up context. Writes a KG triple
+      }
+    },
+    {
+      name: "recall_decision_record",
+      description: `Record an explicit decision so it shows up in wake-up context. Writes a KG triple
 (subject \u2192 decided \u2192 decision) plus a diary entry. Use this when you and the user agree on
 something non-obvious that future sessions should remember.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            subject: { type: "string", description: "What the decision is about" },
-            decision: { type: "string", description: "The decision itself" },
-            reason: { type: "string", description: "Why this was decided" },
-            importance: { type: "number", minimum: 1, maximum: 5, default: 4 },
-            session_id: { type: "string" },
-            agent_name: { type: "string", default: "agent" }
-          },
-          required: ["subject", "decision"]
-        }
-      },
-      {
-        name: "recall_analytics_summary",
-        description: `Cross-tool spend & activity overview. Returns total sessions, total cost,
+      inputSchema: {
+        type: "object",
+        properties: {
+          subject: { type: "string", description: "What the decision is about" },
+          decision: { type: "string", description: "The decision itself" },
+          reason: { type: "string", description: "Why this was decided" },
+          importance: { type: "number", minimum: 1, maximum: 5, default: 4 },
+          session_id: { type: "string" },
+          agent_name: { type: "string", default: "agent" }
+        },
+        required: ["subject", "decision"]
+      }
+    },
+    {
+      name: "recall_analytics_summary",
+      description: `Cross-tool spend & activity overview. Returns total sessions, total cost,
 weekly delta, top tools/projects/models, and how many sessions had unknown pricing
 (Gemini/Ollama/custom). Same data as the web Dashboard, available to the agent so it
 can answer "how much have I spent this week" without you opening the UI.
 
 \`view: "patterns"\` returns behavioural patterns across sessions instead of the spend rollup.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            view: { type: "string", enum: ["summary", "patterns"], default: "summary", description: "summary = spend/activity rollup; patterns = behavioural patterns across sessions" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          view: { type: "string", enum: ["summary", "patterns"], default: "summary", description: "summary = spend/activity rollup; patterns = behavioural patterns across sessions" }
         }
-      },
-      {
-        name: "recall_wake_up",
-        description: `Build startup context for an AI session: identity blurb + the top
+      }
+    },
+    {
+      name: "recall_wake_up",
+      description: `Build startup context for an AI session: identity blurb + the top
 classifier-flagged facts (decisions/preferences/milestones at importance >=4) +
 current knowledge-graph facts. Replaces a manual context dump. Call this once at
 the start of a session to "remember who you are and what's true right now".`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            max_facts: { type: "number", default: 10 },
-            max_kg_facts: { type: "number", default: 15 },
-            identity: { type: "string" },
-            project_filter: { type: "string", description: "Scope facts and KG entities to a project (substring match). Without it, facts are global." }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          max_facts: { type: "number", default: 10 },
+          max_kg_facts: { type: "number", default: 15 },
+          identity: { type: "string" },
+          project_filter: { type: "string", description: "Scope facts and KG entities to a project (substring match). Without it, facts are global." }
         }
-      },
-      {
-        name: "recall_set",
-        description: `Persist a small key/value pair across sessions. Use this for
+      }
+    },
+    {
+      name: "recall_set",
+      description: `Persist a small key/value pair across sessions. Use this for
 state that doesn't fit the diary (narrative) or knowledge graph (entity-relationship facts) \u2014
 things like "current PR url", "branch I'm working on", "user's preferred test runner".
 Scope namespaces keys so per-project state doesn't collide.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            key: { type: "string", description: "Key name" },
-            value: { type: "string", description: "Value to store. JSON-encode if structured." },
-            scope: { type: "string", default: "default", description: "Namespace" }
-          },
-          required: ["key", "value"]
-        }
-      },
-      {
-        name: "recall_get",
-        description: `Read a key/value pair previously written with recall_set \u2014 or, when \`key\` is
+      inputSchema: {
+        type: "object",
+        properties: {
+          key: { type: "string", description: "Key name" },
+          value: { type: "string", description: "Value to store. JSON-encode if structured." },
+          scope: { type: "string", default: "default", description: "Namespace" }
+        },
+        required: ["key", "value"]
+      }
+    },
+    {
+      name: "recall_get",
+      description: `Read a key/value pair previously written with recall_set \u2014 or, when \`key\` is
 omitted, LIST the recorded keys (in one scope, or across all scopes when \`scope\` is
 also omitted). Use the list mode to discover what state has been recorded without
 remembering specific keys.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            key: { type: "string", description: "Key name. Omit to list keys instead." },
-            scope: { type: "string", description: 'Namespace (default "default" when reading; omit to list across all scopes)' },
-            limit: { type: "number", default: 50, description: "Max entries in list mode" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          key: { type: "string", description: "Key name. Omit to list keys instead." },
+          scope: { type: "string", description: 'Namespace (default "default" when reading; omit to list across all scopes)' },
+          limit: { type: "number", default: 50, description: "Max entries in list mode" }
         }
-      },
-      // ── Security / Secret Findings Tools ─────────────────────────
-      {
-        name: "recall_security_summary",
-        description: `Get a security overview from the synced chat-recall server.
+      }
+    },
+    // ── Security / Secret Findings Tools ─────────────────────────
+    {
+      name: "recall_security_summary",
+      description: `Get a security overview from the synced chat-recall server.
 
 Returns the action-required list of distinct leaked secrets (grouped by redacted
 preview), plus per-detector totals and top rules. Use this when the user asks
 "do we have any leaked secrets?" or "security findings" or "what should I rotate".
 
 Call this first; then call recall_security_session for specific sessions.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            include_dismissed: { type: "boolean", default: false, description: "Show previously dismissed findings" },
-            top_k: { type: "number", default: 20, description: "Max distinct secrets to list" },
-            group_by: { type: "string", enum: ["detector", "rule", "project", "trend", "sessions"], default: "detector", description: "detector = action-required view; rule/project = grouped counts; trend = daily counts; sessions = one row per session with findings" },
-            days: { type: "number", default: 30, description: "group_by=trend only: window in days (1-365)" },
-            min_detectors: { type: "number", description: "group_by=sessions only: require N detectors agreeing" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          include_dismissed: { type: "boolean", default: false, description: "Show previously dismissed findings" },
+          top_k: { type: "number", default: 20, description: "Max distinct secrets to list" },
+          group_by: { type: "string", enum: ["detector", "rule", "project", "trend", "sessions"], default: "detector", description: "detector = action-required view; rule/project = grouped counts; trend = daily counts; sessions = one row per session with findings" },
+          days: { type: "number", default: 30, description: "group_by=trend only: window in days (1-365)" },
+          min_detectors: { type: "number", description: "group_by=sessions only: require N detectors agreeing" }
         }
-      },
-      {
-        name: "recall_security_session",
-        description: `Get secret findings for a specific session.
+      }
+    },
+    {
+      name: "recall_security_session",
+      description: `Get secret findings for a specific session.
 
 Use after recall_search or recall_security_summary to show exactly which lines
 in a session matched which detector.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            session_id: { type: "string", description: "Session ID from search results" }
-          },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_security_dismiss",
-        description: `Mark a secret finding as rotated, false_positive, or dismissed.
+      inputSchema: {
+        type: "object",
+        properties: {
+          session_id: { type: "string", description: "Session ID from search results" }
+        },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_security_dismiss",
+      description: `Mark a secret finding as rotated, false_positive, or dismissed.
 
 Use when the user confirms a key was rotated or that the match is not a real
 secret. The dismissal syncs across devices.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            preview: { type: "string", description: "Masked secret preview from the security dashboard" },
-            status: { type: "string", enum: ["rotated", "false_positive", "dismissed", "undismissed"], description: "Resolution status, or `undismissed` to put the finding back on the action-required list" },
-            reason: { type: "string", description: "Optional note" }
-          },
-          required: ["preview", "status"]
-        }
-      },
-      {
-        name: "recall_security_rules",
-        description: `List tenant custom secret-detection rules, or test a regex in the sandbox.
+      inputSchema: {
+        type: "object",
+        properties: {
+          preview: { type: "string", description: "Masked secret preview from the security dashboard" },
+          status: { type: "string", enum: ["rotated", "false_positive", "dismissed", "undismissed"], description: "Resolution status, or `undismissed` to put the finding back on the action-required list" },
+          reason: { type: "string", description: "Optional note" }
+        },
+        required: ["preview", "status"]
+      }
+    },
+    {
+      name: "recall_security_rules",
+      description: `List tenant custom secret-detection rules, or test a regex in the sandbox.
 
 Tenant rules are configured in the chat-recall dashboard; this tool exposes them
 to the agent and lets you test new regexes without persisting them.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            action: { type: "string", enum: ["list", "test"], default: "list", description: "list = existing rules; test = regex sandbox" },
-            name: { type: "string", description: "For test: rule name" },
-            regex: { type: "string", description: "For test: regex to evaluate" },
-            sample: { type: "string", description: "For test: text to match against" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          action: { type: "string", enum: ["list", "test"], default: "list", description: "list = existing rules; test = regex sandbox" },
+          name: { type: "string", description: "For test: rule name" },
+          regex: { type: "string", description: "For test: regex to evaluate" },
+          sample: { type: "string", description: "For test: text to match against" }
         }
-      },
-      {
-        name: "recall_subagent_search",
-        description: `Search inside SUBAGENT transcripts \u2014 the explore/compact/aside sub-tasks that run within a session and whose work never appears in the main conversation.
+      }
+    },
+    {
+      name: "recall_subagent_search",
+      description: `Search inside SUBAGENT transcripts \u2014 the explore/compact/aside sub-tasks that run within a session and whose work never appears in the main conversation.
 
 Use when a session's own turns don't contain what you remember: the finding may have come from a subagent. Indexed server-side, so it works across devices.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: { type: "string", description: "Text to find inside subagent transcripts" },
-            session_id: { type: "string", description: "Restrict to one session" },
-            kind: { type: "string", description: "Restrict to one subagent kind" },
-            limit: { type: "number", default: 20 }
-          },
-          required: ["query"]
-        }
-      },
-      {
-        name: "recall_redundant_files",
-        description: `Before creating a file, check whether you have written one like it before. Scores the filename against every file touched in your synced history.
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Text to find inside subagent transcripts" },
+          session_id: { type: "string", description: "Restrict to one session" },
+          kind: { type: "string", description: "Restrict to one subagent kind" },
+          limit: { type: "number", default: 20 }
+        },
+        required: ["query"]
+      }
+    },
+    {
+      name: "recall_redundant_files",
+      description: `Before creating a file, check whether you have written one like it before. Scores the filename against every file touched in your synced history.
 
 Answers "have I built this already?" \u2014 the reinvention check.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            filename: { type: "string", description: "Filename you are about to create" },
-            project: { type: "string", description: "Restrict to one project" },
-            limit: { type: "number", default: 20 }
-          },
-          required: ["filename"]
-        }
-      },
-      {
-        name: "recall_heal_audit",
-        description: `Report how many of your sessions are DAMAGED \u2014 the rendered conversation is thinner than the shrink-protected raw archive, which happens when an upstream tool truncates a transcript in place (a resume/compaction rewrite, or a script mirroring a shorter file over a longer one).
+      inputSchema: {
+        type: "object",
+        properties: {
+          filename: { type: "string", description: "Filename you are about to create" },
+          project: { type: "string", description: "Restrict to one project" },
+          limit: { type: "number", default: 20 }
+        },
+        required: ["filename"]
+      }
+    },
+    {
+      name: "recall_heal_audit",
+      description: `Report how many of your sessions are DAMAGED \u2014 the rendered conversation is thinner than the shrink-protected raw archive, which happens when an upstream tool truncates a transcript in place (a resume/compaction rewrite, or a script mirroring a shorter file over a longer one).
 
 This is the authoritative "0 remaining" check. Read-only by default; apply=true heals, and healing only ever makes a conversation FULLER.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            since_hours: { type: "number", description: "Bound the scan to the last N hours" },
-            apply: { type: "boolean", default: false, description: "false = audit only; true = heal now" }
-          }
+      inputSchema: {
+        type: "object",
+        properties: {
+          since_hours: { type: "number", description: "Bound the scan to the last N hours" },
+          apply: { type: "boolean", default: false, description: "false = audit only; true = heal now" }
         }
-      },
-      {
-        name: "recall_memory_item",
-        description: `Fetch ONE memory item, its full text, or its links \u2014 or browse a whole source type.
+      }
+    },
+    {
+      name: "recall_memory_item",
+      description: `Fetch ONE memory item, its full text, or its links \u2014 or browse a whole source type.
 
 Complements recall_memory_search: search finds candidates, this reads the specific item. mode=browse lists a type (e.g. every skill, every plan) without a query.`,
-        inputSchema: {
-          type: "object",
-          properties: {
-            source_type: { type: "string", enum: ["session", "plan", "task", "claude_md", "paste", "history", "diary"] },
-            id: { type: "string", description: "Item id. Omit with mode=browse." },
-            mode: { type: "string", enum: ["item", "content", "links", "browse"], default: "item", description: "item = metadata, content = full text, links = related items, browse = list the type" },
-            limit: { type: "number", default: 50, description: "browse mode only" }
-          },
-          required: ["source_type"]
-        }
-      },
-      {
-        name: "recall_regenerate_summary",
-        description: "Force a fresh AI summary for one session \u2014 use when its stored summary is missing, stale, or plainly wrong.",
-        inputSchema: {
-          type: "object",
-          properties: { session_id: { type: "string" } },
-          required: ["session_id"]
-        }
-      },
-      {
-        name: "recall_outcome_summary",
-        description: 'Aggregate session outcomes (shipped / interrupted / abandoned / in_progress) over the last N days \u2014 "how much of my work actually landed?".',
-        inputSchema: {
-          type: "object",
-          properties: { days: { type: "number", default: 7, description: "1-90" } }
-        }
-      },
-      {
-        name: "recall_shares",
-        description: "Which projects are shared into your team. scope=mine for your own shares, scope=all for every share visible to you. Private by default \u2014 nothing is visible to teammates until shared.",
-        inputSchema: {
-          type: "object",
-          properties: { scope: { type: "string", enum: ["mine", "all"], default: "mine" } }
-        }
-      },
-      {
-        name: "recall_reclassify",
-        description: "Re-run the memory classifier over already-indexed chunks so classifier improvements reach old data. Idempotent \u2014 only rewrites tags that actually changed.",
-        inputSchema: { type: "object", properties: {} }
+      inputSchema: {
+        type: "object",
+        properties: {
+          source_type: { type: "string", enum: ["session", "plan", "task", "claude_md", "paste", "history", "diary"] },
+          id: { type: "string", description: "Item id. Omit with mode=browse." },
+          mode: { type: "string", enum: ["item", "content", "links", "browse"], default: "item", description: "item = metadata, content = full text, links = related items, browse = list the type" },
+          limit: { type: "number", default: 50, description: "browse mode only" }
+        },
+        required: ["source_type"]
       }
-    ]
-  };
+    },
+    {
+      name: "recall_regenerate_summary",
+      description: "Force a fresh AI summary for one session \u2014 use when its stored summary is missing, stale, or plainly wrong.",
+      inputSchema: {
+        type: "object",
+        properties: { session_id: { type: "string" } },
+        required: ["session_id"]
+      }
+    },
+    {
+      name: "recall_outcome_summary",
+      description: 'Aggregate session outcomes (shipped / interrupted / abandoned / in_progress) over the last N days \u2014 "how much of my work actually landed?".',
+      inputSchema: {
+        type: "object",
+        properties: { days: { type: "number", default: 7, description: "1-90" } }
+      }
+    },
+    {
+      name: "recall_shares",
+      description: "Which projects are shared into your team. scope=mine for your own shares, scope=all for every share visible to you. Private by default \u2014 nothing is visible to teammates until shared.",
+      inputSchema: {
+        type: "object",
+        properties: { scope: { type: "string", enum: ["mine", "all"], default: "mine" } }
+      }
+    },
+    {
+      name: "recall_reclassify",
+      description: "Re-run the memory classifier over already-indexed chunks so classifier improvements reach old data. Idempotent \u2014 only rewrites tags that actually changed.",
+      inputSchema: { type: "object", properties: {} }
+    }
+  ];
+  if (toolProfile() === "full") return { tools: all };
+  const lean = all.filter((t) => LEAN_TOOLS.has(t.name));
+  const hidden = all.length - lean.length;
+  if (hidden > 0) {
+    lean.push({
+      name: "recall_help",
+      description: `List the ${hidden} additional chat-recall tools that are not registered in this profile (analytics, knowledge-graph navigation, code intelligence, sharing, security triage, maintenance). They all still WORK if called by name. Set CHAT_RECALL_MCP_PROFILE=full to register every tool up front.`,
+      inputSchema: { type: "object", properties: {} }
+    });
+  }
+  return { tools: lean };
 });
+var syncStateCache = null;
+var SYNC_STATE_TTL_MS = 5 * 60 * 1e3;
+async function syncState() {
+  if (syncStateCache && Date.now() - syncStateCache.at < SYNC_STATE_TTL_MS) return syncStateCache.state;
+  let state = null;
+  try {
+    const cred = remoteCredentials();
+    if (cred) {
+      const res = await fetch(cred.base + "/api/billing", {
+        headers: { authorization: `Bearer ${cred.token}` }
+      });
+      if (res.ok) {
+        const b = await res.json();
+        if (typeof b.entitled === "boolean") {
+          state = {
+            entitled: b.entitled,
+            status: typeof b.status === "string" ? b.status : "unknown",
+            periodEnd: typeof b.currentPeriodEnd === "number" ? b.currentPeriodEnd : null
+          };
+        }
+      }
+    }
+  } catch {
+  }
+  syncStateCache = { at: Date.now(), state };
+  return state;
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const result = await dispatchTool(request);
+  try {
+    const banner = stalenessBanner(await syncState());
+    if (!banner) return result;
+    const content = result.content;
+    if (!Array.isArray(content) || !content.length) return result;
+    return { ...result, content: [{ type: "text", text: banner }, ...content] };
+  } catch {
+    return result;
+  }
+});
+async function dispatchTool(request) {
   const { name, arguments: args } = request.params;
   try {
     if (/^recall_code_(index|projects|findings|actions)$/.test(name) && !codeindexAvailable()) {
@@ -22809,6 +23039,7 @@ ${lines.join("\n")}` }] };
         if (params.status) patch.status = params.status;
         if (params.assignee !== void 0) patch.assigneeSub = params.assignee || null;
         if (params.title) patch.title = params.title;
+        if (params.linked_session_id !== void 0) patch.linkedSessionId = params.linked_session_id;
         let did = false;
         if (Object.keys(patch).length > 0) {
           await remotePatch(`/api/tasks/${encodeURIComponent(params.id)}`, patch);
@@ -22818,9 +23049,18 @@ ${lines.join("\n")}` }] };
           await remotePost(`/api/tasks/${encodeURIComponent(params.id)}/comments`, { body: params.comment });
           did = true;
         }
-        if (!did) return { content: [{ type: "text", text: "Nothing to update \u2014 pass status, assignee, title, and/or comment." }] };
+        if (!did) return { content: [{ type: "text", text: "Nothing to update \u2014 pass status, assignee, title, linked_session_id, and/or comment." }] };
         return { content: [{ type: "text", text: `Updated task ${params.id}.` }] };
       }
+      case "recall_task_comment": {
+        const params = RecallTaskCommentSchema.parse(args);
+        requireRemote();
+        const { comment } = await remotePost(
+          `/api/tasks/${encodeURIComponent(params.task_id)}/comments`,
+          { body: params.body }
+        );
+        return { content: [{ type: "text", text: `Commented on task ${comment.taskId} (comment ${comment.id}).` }] };
+      }
       // ── Knowledge Graph Handlers ─────────────────────────────────
       case "recall_kg_query": {
         const params = RecallKGQuerySchema.parse(args);
@@ -23524,6 +23764,12 @@ ${row.value}`
           max_facts: params.max_facts,
           max_kg_facts: params.max_kg_facts
         });
+        const ot = wake.openTasks;
+        if (ot && ot.total > 0) {
+          lines.push("## Task board");
+          lines.push(`  ${ot.total} open task(s)${ot.auto ? ` \u2014 ${ot.auto} auto-filed from code findings` : ""}. List them with recall_tasks; when you start one, set it in_progress and pass your session id as linked_session_id.`);
+          lines.push("");
+        }
         if (wake.highFacts.length > 0) {
           lines.push("## High-importance facts");
           for (const c of wake.highFacts) lines.push(`  [${c.type}] ${c.text}`);
@@ -23807,6 +24053,29 @@ ${JSON.stringify(r, null, 2)}
         if (r.error) return { content: [{ type: "text", text: `Reclassify unavailable: ${r.error}` }] };
         return { content: [{ type: "text", text: `${r.message ?? "Reclassify complete"} \u2014 scanned ${r.scanned ?? 0}, updated ${r.updated ?? 0}.` }] };
       }
+      case "recall_help": {
+        const lines = [
+          "# chat-recall tools not registered in this profile",
+          "",
+          "They all still work \u2014 call them by name. To register every tool up front,",
+          "set CHAT_RECALL_MCP_PROFILE=full and restart the MCP server.",
+          ""
+        ];
+        const groups = [
+          ["Aggregate views", ["recall_weekly_digest", "recall_analytics_summary", "recall_team_activity", "recall_outcome_summary"]],
+          ["Task board", ["recall_task_comment"]],
+          ["Knowledge graph", ["recall_kg_timeline", "recall_kg_stats", "recall_kg_invalidate"]],
+          ["Session detail", ["recall_markers", "recall_subagent_search", "recall_memory_item", "recall_rename_session", "recall_regenerate_summary"]],
+          ["Code intelligence", ["recall_code_index", "recall_code_projects", "recall_code_findings", "recall_code_actions"]],
+          ["Recommendations", ["recall_recommendations", "recall_improvements", "recall_claude_suggestions", "recall_redundant_files"]],
+          ["Security triage", ["recall_security_session", "recall_security_dismiss", "recall_security_rules"]],
+          ["State + maintenance", ["recall_set", "recall_get", "recall_shares", "recall_reclassify", "recall_heal_audit"]]
+        ];
+        for (const [label, names] of groups) {
+          lines.push(`## ${label}`, names.map((n) => `- ${n}`).join("\n"), "");
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
     }
@@ -23818,7 +24087,7 @@ ${JSON.stringify(r, null, 2)}
     reportClientEvent("tool_error", { tool: name, message: msg });
     return { content: [{ type: "text", text: `Error: ${msg}` }] };
   }
-});
+}
 function runIndexChild(force) {
   return new Promise((resolve2) => {
     let cliPath;