chat-recall 0.6.4 → 0.6.6

package/dist/mcp-relay.js

@@ -118,7 +118,7 @@ function daemonEnabled() {
 }
 
 // src/mcp-relay.ts
-var VERSION = true ? "0.6.4" : "0.0.0";
+var VERSION = true ? "0.6.6" : "0.0.0";
 var SERVER_URL = new URL("./mcp.js", import.meta.url);
 var SERVER_PATH = fileURLToPath(SERVER_URL);
 var START_TIMEOUT_MS = 15e3;

package/dist/mcp.js

@@ -15259,12 +15259,12 @@ function extractEntities(text, context = {}) {
         if (chosen && looksLikeStrictTool(chosen) && looksLikeStrictTool(rejected)) {
           const c = canonTool(chosen), r = canonTool(rejected);
           if (projectName)
-            addTriple(projectName, "chose", c, 0.8);
-          addTriple(projectName || "project", "rejected", r, 0.7);
-          addTriple(c, "chosen_over", r, 0.8);
+            addTriple(projectName, "chose", c, DECISION_GUESS_CONFIDENCE);
+          addTriple(projectName || "project", "rejected", r, DECISION_GUESS_CONFIDENCE);
+          addTriple(c, "chosen_over", r, DECISION_GUESS_CONFIDENCE);
         }
       } else if (chosen && looksLikeDecisionObject(chosen) && projectName) {
-        addTriple(projectName, "chose", canonTool(chosen), 0.8);
+        addTriple(projectName, "chose", canonTool(chosen), DECISION_GUESS_CONFIDENCE);
       }
     }
   }
@@ -15301,7 +15301,7 @@ function extractEntities(text, context = {}) {
   }
   return triples;
 }
-var KNOWN_TOOLS, AMBIGUOUS_TOOLS, toolContextRe, TOOL_PATTERNS, DECISION_PATTERNS2, DECISION_OBJECT_STOPWORDS, KNOWN_TOOL_NAMES, CANONICAL_TOOL, canonTool, PROJECT_PATH_PATTERN, PEOPLE_PATTERNS, NOT_PEOPLE;
+var KNOWN_TOOLS, AMBIGUOUS_TOOLS, toolContextRe, TOOL_PATTERNS, DECISION_PATTERNS2, DECISION_OBJECT_STOPWORDS, KNOWN_TOOL_NAMES, CANONICAL_TOOL, canonTool, DECISION_GUESS_CONFIDENCE, PROJECT_PATH_PATTERN, PEOPLE_PATTERNS, NOT_PEOPLE;
 var init_entity_extractor = __esm({
   "../engine/dist/core/entity-extractor.js"() {
     "use strict";
@@ -15522,6 +15522,7 @@ var init_entity_extractor = __esm({
       "nextjs": "next.js"
     };
     canonTool = (n) => CANONICAL_TOOL[n.toLowerCase()] ?? n;
+    DECISION_GUESS_CONFIDENCE = 0.6;
     PROJECT_PATH_PATTERN = /\/(?:home|Users)\/\w+\/(?:code|projects|work|dev|src)\/(?:\w+\/)?([a-zA-Z][a-zA-Z0-9_-]{1,40})/g;
     PEOPLE_PATTERNS = [
       /\b(?:my name is|I'm|I am)\s+([A-Z][a-z]{1,15}(?:\s+[A-Z][a-z]{1,15})?)/g,
@@ -19727,7 +19728,7 @@ var init_http = __esm({
       CLI_VERSION = JSON.parse(readFileSync35(new URL("../package.json", import.meta.url), "utf-8")).version || CLI_VERSION;
     } catch {
       try {
-        if (true) CLI_VERSION = "0.6.4";
+        if (true) CLI_VERSION = "0.6.6";
       } catch {
       }
     }
@@ -20247,7 +20248,7 @@ var init_telemetry = __esm({
     init_sync_client();
     cliVersion2 = () => {
       try {
-        return true ? "0.6.4" : "dev";
+        return true ? "0.6.6" : "dev";
       } catch {
         return "dev";
       }
@@ -20397,12 +20398,16 @@ var init_server_probe = __esm({
 // src/auto-update.ts
 var auto_update_exports = {};
 __export(auto_update_exports, {
+  clearUpdateFailures: () => clearUpdateFailures,
   compareVersions: () => compareVersions,
   executeAutoUpdate: () => executeAutoUpdate,
+  hasGivenUpOn: () => hasGivenUpOn,
   installedVersion: () => installedVersion,
   isAutoUpdateEnabled: () => isAutoUpdateEnabled,
   newerOf: () => newerOf,
+  noteUpdateFailure: () => noteUpdateFailure,
   planAutoUpdate: () => planAutoUpdate,
+  readUpdateState: () => readUpdateState,
   runAutoUpdate: () => runAutoUpdate,
   runningPrefix: () => runningPrefix,
   sweepStaleStaging: () => sweepStaleStaging,
@@ -20411,9 +20416,9 @@ __export(auto_update_exports, {
 import { execSync as execSync4 } from "node:child_process";
 import { readFileSync as readFileSync36 } from "node:fs";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { writeFileSync as writeFileSync9, mkdtempSync as mkdtempSync3, rmSync as rmSync5, readdirSync as readdirSync31, statSync as statSync40 } from "node:fs";
+import { writeFileSync as writeFileSync9, mkdtempSync as mkdtempSync3, rmSync as rmSync5, readdirSync as readdirSync31, statSync as statSync40, mkdirSync as mkdirSync12 } from "node:fs";
 import { join as join47, dirname as dirname19, sep as sep3 } from "node:path";
-import { tmpdir as tmpdir3 } from "node:os";
+import { tmpdir as tmpdir3, homedir as homedir17 } from "node:os";
 import { createHash as createHash10 } from "node:crypto";
 function compareVersions(a, b) {
   const pa = String(a).split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
@@ -20527,16 +20532,25 @@ function runningPrefix(moduleUrl = import.meta.url) {
   const beforeNodeModules = here.slice(0, at);
   return beforeNodeModules.endsWith(`${sep3}lib`) ? beforeNodeModules.slice(0, -4) : beforeNodeModules;
 }
+function npmInstall(cmd) {
+  try {
+    execSync4(cmd, { stdio: ["ignore", "ignore", "pipe"] });
+  } catch (e) {
+    const err = e;
+    const detail = String(err.stderr ?? "").trim().split("\n").filter((l) => l.trim() && !/^npm (notice|warn)\b/i.test(l)).slice(-4).join(" | ").slice(0, 400);
+    throw new Error(detail ? `${err.message ?? "install failed"} \u2014 ${detail}` : err.message ?? "install failed");
+  }
+}
 function realInstall(tgz) {
   const prefix = runningPrefix();
   if (prefix) {
-    execSync4(`npm install -g --prefix "${prefix}" "${tgz}"`, { stdio: "ignore" });
+    npmInstall(`npm install -g --prefix "${prefix}" "${tgz}"`);
     return;
   }
   try {
-    execSync4(`npm install -g "${tgz}"`, { stdio: "ignore" });
+    npmInstall(`npm install -g "${tgz}"`);
   } catch {
-    execSync4(`npm install -g --prefix "${process.env.HOME}/.local" "${tgz}"`, { stdio: "ignore" });
+    npmInstall(`npm install -g --prefix "${process.env.HOME}/.local" "${tgz}"`);
   }
 }
 function realRestart(platform2) {
@@ -20544,6 +20558,37 @@ function realRestart(platform2) {
   else if (platform2 === "darwin") execSync4("launchctl kickstart -k gui/$(id -u)/com.chat-recall.watch", { stdio: "ignore", shell: "/bin/bash" });
   else if (platform2 === "win32") execSync4("schtasks /End /TN chat-recall-watch & schtasks /Run /TN chat-recall-watch", { stdio: "ignore" });
 }
+function updateStatePath() {
+  const dir = process.env.CHAT_RECALL_DATA_DIR || join47(homedir17(), ".chat-recall");
+  return join47(dir, "auto-update-state.json");
+}
+function readUpdateState() {
+  try {
+    return JSON.parse(readFileSync36(updateStatePath(), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function writeUpdateState(st) {
+  try {
+    const p = updateStatePath();
+    mkdirSync12(dirname19(p), { recursive: true });
+    writeFileSync9(p, JSON.stringify(st), "utf8");
+  } catch {
+  }
+}
+function hasGivenUpOn(target, st = readUpdateState()) {
+  return st.target === target && (st.failures ?? 0) >= GIVE_UP_AFTER;
+}
+function noteUpdateFailure(target) {
+  const st = readUpdateState();
+  const failures = st.target === target ? (st.failures ?? 0) + 1 : 1;
+  writeUpdateState({ target, failures });
+  return failures;
+}
+function clearUpdateFailures() {
+  writeUpdateState({});
+}
 async function runAutoUpdate(base, authHeaders, ownVersion2, deps) {
   let caps;
   try {
@@ -20566,6 +20611,10 @@ async function runAutoUpdate(base, authHeaders, ownVersion2, deps) {
     }
     return { updated: false, reason: plan.reason };
   }
+  const target = plan.to ?? "";
+  if (target && hasGivenUpOn(target)) {
+    return { updated: false, reason: `gave up installing ${plan.to} after ${GIVE_UP_AFTER} failed attempts \u2014 run \`npm install -g chat-recall\` by hand` };
+  }
   const result = await executeAutoUpdate(plan, {
     download: deps?.download ?? realDownload,
     install: deps?.install ?? realInstall,
@@ -20573,20 +20622,27 @@ async function runAutoUpdate(base, authHeaders, ownVersion2, deps) {
     platform: deps?.platform
   });
   if (!result.updated) {
-    try {
-      const { reportClientEvent: reportClientEvent3 } = await Promise.resolve().then(() => (init_client_events(), client_events_exports));
-      reportClientEvent3("auto_update_failed", { message: `${plan.from} \u2192 ${plan.to}: ${result.reason}` });
-    } catch {
+    const failures = target ? noteUpdateFailure(target) : 1;
+    if (failures <= GIVE_UP_AFTER) {
+      try {
+        const { reportClientEvent: reportClientEvent3 } = await Promise.resolve().then(() => (init_client_events(), client_events_exports));
+        const suffix = failures >= GIVE_UP_AFTER ? ` \u2014 giving up after ${failures} attempts, needs a manual \`npm install -g chat-recall\`` : ` (attempt ${failures} of ${GIVE_UP_AFTER})`;
+        reportClientEvent3("auto_update_failed", { message: `${plan.from} \u2192 ${plan.to}: ${result.reason}${suffix}` });
+      } catch {
+      }
     }
+  } else {
+    clearUpdateFailures();
   }
   return result;
 }
-var tarballUrl, reportedStandingSkip;
+var tarballUrl, GIVE_UP_AFTER, reportedStandingSkip;
 var init_auto_update = __esm({
   "src/auto-update.ts"() {
     "use strict";
     init_http();
     tarballUrl = (base) => `${base.replace(/\/+$/, "")}/install/chat-recall.tgz`;
+    GIVE_UP_AFTER = 3;
     reportedStandingSkip = /* @__PURE__ */ new Set();
   }
 });
@@ -20621,7 +20677,7 @@ __export(sync_client_exports, {
   syncSessions: () => syncSessions
 });
 import { join as join48, dirname as dirname20, basename as basename21 } from "node:path";
-import { readFileSync as readFileSync37, writeFileSync as writeFileSync10, mkdirSync as mkdirSync12, mkdtempSync as mkdtempSync4, rmSync as rmSync6, chmodSync as chmodSync6, unlinkSync as unlinkSync3, readdirSync as readdirSync32, statSync as statSync41 } from "node:fs";
+import { readFileSync as readFileSync37, writeFileSync as writeFileSync10, mkdirSync as mkdirSync13, mkdtempSync as mkdtempSync4, rmSync as rmSync6, chmodSync as chmodSync6, unlinkSync as unlinkSync3, readdirSync as readdirSync32, statSync as statSync41 } from "node:fs";
 import { tmpdir as tmpdir4, hostname as hostname2 } from "node:os";
 import { createHash as createHash11 } from "node:crypto";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -20656,7 +20712,7 @@ function classifyError(msg, err) {
 }
 function saveCredentials(c) {
   assertTransportSafe(c.serverUrl);
-  mkdirSync12(dirname20(credPath()), { recursive: true });
+  mkdirSync13(dirname20(credPath()), { recursive: true });
   const targets = loadAllCredentials().filter((t) => t.serverUrl !== c.serverUrl);
   targets.unshift(c);
   writeFileSync10(credPath(), JSON.stringify({ targets }, null, 2));
@@ -20751,7 +20807,7 @@ function persistSyncConfig(base, config2) {
   try {
     const all = readPersistedSyncConfigs();
     all[base] = { fetchedAt: Date.now(), config: config2 };
-    mkdirSync12(dirname20(syncConfigCachePath()), { recursive: true });
+    mkdirSync13(dirname20(syncConfigCachePath()), { recursive: true });
     writeFileSync10(syncConfigCachePath(), JSON.stringify(all, null, 2));
   } catch {
   }
@@ -22157,7 +22213,7 @@ var init_sync_client = __esm({
       ownVersion = JSON.parse(readFileSync37(join48(dir, "../package.json"), "utf-8")).version || ownVersion;
     } catch {
       try {
-        if (true) ownVersion = "0.6.4";
+        if (true) ownVersion = "0.6.6";
       } catch {
       }
     }
@@ -22380,7 +22436,7 @@ __export(install_skills_exports, {
   skillsSourceDir: () => skillsSourceDir,
   uninstallSkills: () => uninstallSkills
 });
-import { readdirSync as readdirSync33, existsSync as existsSync45, mkdirSync as mkdirSync13, rmSync as rmSync7, cpSync, writeFileSync as writeFileSync12, readFileSync as readFileSync40, statSync as statSync42, realpathSync as realpathSync4 } from "fs";
+import { readdirSync as readdirSync33, existsSync as existsSync45, mkdirSync as mkdirSync14, rmSync as rmSync7, cpSync, writeFileSync as writeFileSync12, readFileSync as readFileSync40, statSync as statSync42, realpathSync as realpathSync4 } from "fs";
 import { createHash as createHash12 } from "crypto";
 import { join as join50, basename as basename22 } from "path";
 function skillsSourceDir() {
@@ -22490,7 +22546,7 @@ function installSkills(opts = {}) {
         skippedUserOwned.push(name);
         continue;
       }
-      mkdirSync13(t.dir, { recursive: true });
+      mkdirSync14(t.dir, { recursive: true });
       rmSync7(dest, { recursive: true, force: true });
       cpSync(join50(src, name), dest, { recursive: true });
       writeFileSync12(join50(dest, MARKER), `${stamp}
@@ -22588,14 +22644,14 @@ __export(service_installer_exports, {
   uninstallService: () => uninstallService
 });
 import { execSync as execSync5 } from "child_process";
-import { existsSync as existsSync46, mkdirSync as mkdirSync14, readFileSync as readFileSync41, rmSync as rmSync8, writeFileSync as writeFileSync13 } from "fs";
-import { homedir as homedir17 } from "os";
+import { existsSync as existsSync46, mkdirSync as mkdirSync15, readFileSync as readFileSync41, rmSync as rmSync8, writeFileSync as writeFileSync13 } from "fs";
+import { homedir as homedir18 } from "os";
 import { join as join51 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function resolveDaemonPaths() {
   const watchJs = fileURLToPath4(new URL("./watch.js", import.meta.url));
   const node = process.execPath;
-  const dataDir = join51(homedir17(), ".chat-recall");
+  const dataDir = join51(homedir18(), ".chat-recall");
   const logFile = join51(dataDir, "watch.log");
   return { watchJs, node, logFile, dataDir };
 }
@@ -22623,7 +22679,7 @@ function refreshServiceDefinition() {
   if (process.platform !== "linux") return false;
   try {
     const { watchJs, node, logFile } = resolveDaemonPaths();
-    const unitPath = join51(homedir17(), ".config", "systemd", "user", "chat-recall-watch.service");
+    const unitPath = join51(homedir18(), ".config", "systemd", "user", "chat-recall-watch.service");
     if (!existsSync46(unitPath)) return false;
     const current = readFileSync41(unitPath, "utf8");
     if (!current.includes(watchJs)) return false;
@@ -22638,7 +22694,7 @@ function refreshServiceDefinition() {
 }
 function installService() {
   const { watchJs, node, logFile, dataDir } = resolveDaemonPaths();
-  mkdirSync14(dataDir, { recursive: true });
+  mkdirSync15(dataDir, { recursive: true });
   if (process.platform === "linux") {
     return installSystemd(watchJs, node, logFile);
   }
@@ -22654,10 +22710,10 @@ function installService() {
   );
 }
 function installSystemd(watchJs, node, logFile) {
-  const unitDir = join51(homedir17(), ".config", "systemd", "user");
+  const unitDir = join51(homedir18(), ".config", "systemd", "user");
   const unitPath = join51(unitDir, "chat-recall-watch.service");
   const unit = renderSystemdUnit(watchJs, node, logFile);
-  mkdirSync14(unitDir, { recursive: true });
+  mkdirSync15(unitDir, { recursive: true });
   writeFileSync13(unitPath, unit);
   try {
     execSync5("systemctl --user daemon-reload && systemctl --user enable chat-recall-watch.service && systemctl --user restart chat-recall-watch.service", { stdio: "inherit" });
@@ -22729,10 +22785,10 @@ function renderSystemdUnit(watchJs, node, logFile) {
 }
 function installLaunchd(watchJs, node, logFile) {
   const label = "com.chat-recall.watch";
-  const plistDir = join51(homedir17(), "Library", "LaunchAgents");
+  const plistDir = join51(homedir18(), "Library", "LaunchAgents");
   const plistPath = join51(plistDir, `${label}.plist`);
   const plist = renderLaunchdPlist(watchJs, node, logFile, label);
-  mkdirSync14(plistDir, { recursive: true });
+  mkdirSync15(plistDir, { recursive: true });
   writeFileSync13(plistPath, plist);
   try {
     try {
@@ -22786,7 +22842,7 @@ function uninstallService() {
       removed = true;
     } catch {
     }
-    const unitPath = join51(homedir17(), ".config", "systemd", "user", "chat-recall-watch.service");
+    const unitPath = join51(homedir18(), ".config", "systemd", "user", "chat-recall-watch.service");
     if (existsSync46(unitPath)) {
       rmSync8(unitPath, { force: true });
       removed = true;
@@ -22798,7 +22854,7 @@ function uninstallService() {
     return removed;
   }
   if (process.platform === "darwin") {
-    const plistPath = join51(homedir17(), "Library", "LaunchAgents", "com.chat-recall.watch.plist");
+    const plistPath = join51(homedir18(), "Library", "LaunchAgents", "com.chat-recall.watch.plist");
     try {
       execSync5(`launchctl unload "${plistPath}" 2>/dev/null`, { stdio: "ignore" });
     } catch {
@@ -23008,6 +23064,118 @@ function resumeCommandFor(sessionId, tool) {
 
 // ../engine/dist/mcp/tools.js
 init_project_resolver();
+
+// ../engine/dist/core/decision-areas.js
+var DECISION_AREAS = [
+  "auth",
+  "database",
+  "payments",
+  "api",
+  "frontend",
+  "deploy",
+  "testing",
+  "observability",
+  "security",
+  "pricing",
+  "licensing",
+  "positioning"
+];
+var AREA_SET = new Set(DECISION_AREAS);
+var AREA_ALIASES = {
+  // auth
+  authentication: "auth",
+  authn: "auth",
+  authz: "auth",
+  authorisation: "auth",
+  authorization: "auth",
+  login: "auth",
+  "sign-in": "auth",
+  signin: "auth",
+  sso: "auth",
+  identity: "auth",
+  // database
+  db: "database",
+  datastore: "database",
+  storage: "database",
+  persistence: "database",
+  orm: "database",
+  migrations: "database",
+  // payments
+  billing: "payments",
+  payment: "payments",
+  checkout: "payments",
+  subscriptions: "payments",
+  // api
+  backend: "api",
+  server: "api",
+  rpc: "api",
+  // frontend
+  ui: "frontend",
+  client: "frontend",
+  web: "frontend",
+  styling: "frontend",
+  css: "frontend",
+  // deploy
+  deployment: "deploy",
+  infra: "deploy",
+  infrastructure: "deploy",
+  hosting: "deploy",
+  ci: "deploy",
+  cd: "deploy",
+  "ci-cd": "deploy",
+  release: "deploy",
+  // testing
+  tests: "testing",
+  test: "testing",
+  qa: "testing",
+  e2e: "testing",
+  // observability
+  monitoring: "observability",
+  logging: "observability",
+  metrics: "observability",
+  alerting: "observability",
+  tracing: "observability",
+  // security
+  secrets: "security",
+  compliance: "security",
+  privacy: "security",
+  // pricing
+  price: "pricing",
+  plans: "pricing",
+  tiers: "pricing",
+  // licensing
+  licence: "licensing",
+  license: "licensing",
+  // positioning
+  marketing: "positioning",
+  branding: "positioning",
+  messaging: "positioning"
+};
+function canonArea(raw) {
+  if (!raw)
+    return null;
+  const lowered = raw.trim().toLowerCase();
+  if (!lowered)
+    return null;
+  const slug = lowered.replace(/[\s_/]+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
+  if (!slug)
+    return null;
+  if (AREA_SET.has(slug))
+    return slug;
+  if (AREA_ALIASES[slug])
+    return AREA_ALIASES[slug];
+  return slug.slice(0, 40);
+}
+function isKnownArea(key2) {
+  return !!key2 && AREA_SET.has(key2);
+}
+var ACCOUNT_SCOPE = "*";
+function decisionSubject(project, area) {
+  const p = (project || "").trim() || ACCOUNT_SCOPE;
+  return `${p}:${area}`;
+}
+
+// ../engine/dist/mcp/tools.js
 import { config } from "dotenv";
 
 // ../engine/dist/mcp/diagnostics.js
@@ -23856,10 +24024,20 @@ var RecallDecisionRecordSchema = z.object({
   subject: z.string().describe('What the decision is about (e.g., "chat-recall", "auth strategy")'),
   decision: z.string().describe('The decision itself in plain words (e.g., "use Postgres full-text search as the default backend")'),
   reason: z.string().optional().describe("Why this was decided \u2014 short rationale"),
+  // The key a reversal supersedes on. Without it the subject is free text, so
+  // "auth", "authentication" and "auth setup" are three separate facts and a
+  // later decision never closes an earlier one — see core/decision-areas.ts.
+  area: z.string().optional().describe(`The area this decides, so a later decision about the SAME area supersedes it. Use one of: ${DECISION_AREAS.join(", ")} \u2014 or any short slug for an area not listed. Without it the decision is recorded but nothing it contradicts is closed.`),
+  project: z.string().optional().describe("Project this decision applies to. Omit for an account-wide decision that applies everywhere."),
   importance: z.number().min(1).max(5).optional().default(4).describe("1\u20135; the classifier surfaces 4+ in wake-up context"),
   session_id: z.string().optional().describe("Session this decision was made in (for traceability)"),
   agent_name: z.string().optional().default("agent").describe("Who recorded the decision (for diary linkage)")
 });
+var RecallDecisionsSchema = z.object({
+  area: z.string().optional().describe("Only this area"),
+  project: z.string().optional().describe("Resolve for this project"),
+  include_candidates: z.boolean().optional().default(false)
+});
 var RecallAnalyticsSummarySchema = z.object({
   // No required inputs — returns the same summary the dashboard renders.
   view: z.enum(["summary", "patterns"]).optional().default("summary").describe("summary = spend/activity rollup; patterns = behavioural patterns across sessions")
@@ -24008,6 +24186,7 @@ var LEAN_TOOLS = /* @__PURE__ */ new Set([
   "recall_kg_query",
   "recall_kg_add",
   "recall_decision_record",
+  "recall_decisions",
   "recall_diary_write",
   "recall_diary_read",
   // Health, and the one that pays out on day one.
@@ -24904,13 +25083,19 @@ I asking yesterday?" or "what did I tell the agent in this session?".`,
         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.`,
+something non-obvious that future sessions should remember.
+
+PASS \`area\`. It is the key a reversal supersedes on: recording a new \`auth\` decision closes the
+previous \`auth\` one and leaves every other area alone. Without it the decision is stored but
+nothing it contradicts is closed, and both answers stay live forever.`,
         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" },
+            area: { type: "string", description: `The area this decides, so a later decision on the same area supersedes it. Standard areas: ${DECISION_AREAS.join(", ")}. Any short slug works for an area not listed.` },
+            project: { type: "string", description: "Project this applies to. Omit for an account-wide decision that applies everywhere." },
             importance: { type: "number", minimum: 1, maximum: 5, default: 4, description: "1-5. Only 4 and 5 surface in the wake-up bundle, so reserve those for decisions a future session must not miss." },
             session_id: { type: "string", description: "Session this decision came out of. Pass your own current session id so the decision can be traced back to the conversation that made it." },
             agent_name: { type: "string", default: "agent", description: "Which agent is recording this, so diary entries stay separable per agent." }
@@ -24918,6 +25103,25 @@ something non-obvious that future sessions should remember.`,
           required: ["subject", "decision"]
         }
       },
+      {
+        name: "recall_decisions",
+        description: `What this codebase has already settled \u2014 read it BEFORE choosing a library, a
+datastore, an auth method or anything else in a decided area, and you will not rebuild what was
+already ruled out.
+
+Returns one effective value per area with the cascade already resolved (project beats account;
+personal preferences fill gaps and never override a team decision), what each value replaced and
+when, and the session it came from. Also returns \`gaps\` \u2014 areas nobody has decided, where you are
+free to choose, and where recording the choice afterwards is worth doing.`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            area: { type: "string", description: `Only this area. Standard areas: ${DECISION_AREAS.join(", ")}.` },
+            project: { type: "string", description: "Resolve for this project, so its overrides win over account-wide decisions. Omit for the account-wide view." },
+            include_candidates: { type: "boolean", default: false, description: "Also return unconfirmed guesses the indexer extracted. These are NOT decisions \u2014 never treat one as settled." }
+          }
+        }
+      },
       {
         name: "recall_analytics_summary",
         description: `Cross-tool spend & activity overview. Returns total sessions, total cost,
@@ -27028,8 +27232,10 @@ ${JSON.stringify(r, null, 2)}
         const wal = getWAL();
         wal.log("decision_record", { subject: params.subject, importance: params.importance });
         const confidence = Math.min(1, params.importance / 5);
+        const area = canonArea(params.area);
+        const kgSubject = area ? decisionSubject(params.project, area) : params.subject;
         await remotePost("/api/kg/add", {
-          subject: params.subject,
+          subject: kgSubject,
           predicate: "decided",
           object: params.decision,
           confidence,
@@ -27037,11 +27243,12 @@ ${JSON.stringify(r, null, 2)}
         });
         if (params.reason) {
           await remotePost("/api/kg/add", {
-            subject: params.subject,
+            subject: kgSubject,
             predicate: "because",
             object: params.reason,
             confidence,
-            source_session: params.session_id
+            source_session: params.session_id,
+            supersede: false
           });
         }
         const diaryText = params.reason ? `Decided: ${params.decision}
@@ -27057,12 +27264,58 @@ Subject: ${params.subject}`;
         return {
           content: [{
             type: "text",
-            text: `Decision recorded.
-- KG: ${params.subject} \u2192 decided \u2192 ${params.decision}
-- Diary entry: ${diary.id} (importance ${params.importance})`
+            text: [
+              "Decision recorded.",
+              `- KG: ${kgSubject} \u2192 decided \u2192 ${params.decision}`,
+              area ? `- Area: ${area}${isKnownArea(area) ? "" : " (not a standard area \u2014 kept as a slug)"} \xB7 a later decision on this area supersedes this one` : "- No area given, so nothing this contradicts was closed. Pass `area` to make reversals work.",
+              `- Diary entry: ${diary.id} (importance ${params.importance})`
+            ].join("\n")
           }]
         };
       }
+      // ── The decision register ──────────────────────────────────
+      case "recall_decisions": {
+        const p = RecallDecisionsSchema.parse(args ?? {});
+        requireRemote();
+        const r = await remoteGetQS("/api/decisions", {
+          project: p.project,
+          include_candidates: p.include_candidates ? "1" : "0"
+        });
+        const rows = p.area ? r.decisions.filter((d) => d.area === canonArea(p.area)) : r.decisions;
+        const lines = [];
+        lines.push(r.project ? `Decisions for ${r.project}` : "Decisions \u2014 account-wide");
+        if (rows.length === 0) {
+          lines.push("", p.area ? `Nothing decided for "${p.area}". You are free to choose \u2014 record it afterwards with recall_decision_record.` : "Nothing decided yet.");
+        } else {
+          lines.push("");
+          for (const d of rows) {
+            const tags = [
+              d.override ? "OVERRIDES ACCOUNT" : "",
+              d.inherited ? "inherited from account" : "",
+              d.advisory ? "advisory \u2014 a personal preference, not binding" : ""
+            ].filter(Boolean).join(" \xB7 ");
+            lines.push(`${d.area}: ${d.value}${d.since ? `  (since ${d.since})` : ""}${tags ? `  [${tags}]` : ""}`);
+            if (d.why)
+              lines.push(`    why: ${d.why}`);
+            const replaced = d.history.filter((h) => !h.current);
+            for (const h of replaced)
+              lines.push(`    replaced: ${h.value} (ended ${h.to})`);
+            if (d.source_session)
+              lines.push(`    from session ${d.source_session}`);
+          }
+        }
+        if (!p.area && r.gaps.length) {
+          lines.push("", `Not decided: ${r.gaps.map((g) => g.area).join(", ")}`);
+          lines.push("Free to choose in these. Record the choice so the next session inherits it.");
+        }
+        if (p.include_candidates && r.candidates?.length) {
+          lines.push("", "Unconfirmed guesses from indexing \u2014 NOT decisions, do not treat as settled:");
+          for (const c of r.candidates.slice(0, 10)) {
+            lines.push(`  ${c.value} (seen ${c.mentions}\xD7${c.last_seen ? `, latest ${c.last_seen}` : ""})`);
+          }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
       // ── Analytics summary ──────────────────────────────────────
       case "recall_analytics_summary": {
         const analyticsParams = RecallAnalyticsSummarySchema.parse(args ?? {});
@@ -27808,7 +28061,7 @@ function installCrashGuards() {
     reportClientEvent2("mcp_crash", { message: err.stack || err.message });
   });
 }
-var RELAY_VERSION = true ? "0.6.4" : "0.0.0";
+var RELAY_VERSION = true ? "0.6.6" : "0.0.0";
 function daemonIdleSecs() {
   const raw = process.env.CHAT_RECALL_DAEMON_IDLE_SECS;
   if (raw === void 0) return 900;

package/dist/star-nudge.d.ts

@@ -0,0 +1,13 @@
+export declare function shouldAskForStar(resultCount: number): boolean;
+/** Record that it has been shown. A failure here means it may be shown once
+ *  more on the next run, which is the harmless direction to fail in. */
+export declare function markStarAsked(): void;
+/**
+ * Print the ask and record it. Writes to stderr so a piped stdout carries only
+ * search results.
+ *
+ * `dim` is passed in rather than imported so this module pulls in no colour
+ * dependency of its own and a caller can hand it a no-op.
+ */
+export declare function askForStar(resultCount: number, dim: (s: string) => string): void;
+//# sourceMappingURL=star-nudge.d.ts.map

package/dist/star-nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"star-nudge.d.ts","sourceRoot":"","sources":["../src/star-nudge.ts"],"names":[],"mappings":"AA6CA,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO7D;AAED;wEACwE;AACxE,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAKhF"}