mindlink 1.1.5 → 1.2.0

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { Command as Command15 } from "commander";
-import chalk16 from "chalk";
+import { Command as Command16 } from "commander";
+import chalk17 from "chalk";
 
 // src/utils/version.ts
 var VERSION = "1.1.5";
@@ -24,8 +24,10 @@ import {
   mkdirSync as mkdirSync2,
   readFileSync as readFileSync2,
   writeFileSync as writeFileSync2,
-  appendFileSync
+  appendFileSync,
+  readdirSync
 } from "fs";
+import { execSync } from "child_process";
 import { join as join3, resolve, dirname as dirname2, basename } from "path";
 
 // src/utils/paths.ts
@@ -58,7 +60,11 @@ var AGENTS = [
   { value: "copilot", label: "GitHub Copilot", hint: ".github/copilot-instructions.md", templateFile: "copilot-instructions.md", destFile: ".github/copilot-instructions.md", selected: true },
   { value: "windsurf", label: "Windsurf", hint: ".windsurfrules", templateFile: ".windsurfrules", destFile: ".windsurfrules", selected: true },
   { value: "cline", label: "Cline", hint: ".clinerules", templateFile: ".clinerules", destFile: ".clinerules", selected: false },
-  { value: "aider", label: "Aider", hint: "CONVENTIONS.md", templateFile: "CONVENTIONS.md", destFile: "CONVENTIONS.md", selected: false }
+  { value: "aider", label: "Aider", hint: "CONVENTIONS.md", templateFile: "CONVENTIONS.md", destFile: "CONVENTIONS.md", selected: false },
+  { value: "zed", label: "Zed", hint: ".rules", templateFile: ".rules", destFile: ".rules", selected: false },
+  { value: "kiro", label: "Kiro", hint: ".kiro/steering/mindlink.md", templateFile: "kiro-steering.md", destFile: ".kiro/steering/mindlink.md", selected: false },
+  { value: "continue", label: "Continue.dev", hint: ".continue/rules/mindlink.md", templateFile: "continue-rules.md", destFile: ".continue/rules/mindlink.md", selected: false },
+  { value: "trae", label: "Trae", hint: ".trae/rules/mindlink.md", templateFile: "trae-rules.md", destFile: ".trae/rules/mindlink.md", selected: false }
 ];
 
 // src/utils/registry.ts
@@ -100,13 +106,21 @@ function detectProjectInfo(projectPath) {
   let name = basename(projectPath);
   let description = "";
   let stack = "";
+  let recentActivity = "";
+  let topDirs = "";
   const pkgPath = join3(projectPath, "package.json");
   if (existsSync2(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
       if (pkg.name) name = pkg.name;
       if (pkg.description) description = pkg.description;
-      stack = "Node.js";
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      const layers = ["Node.js"];
+      if (deps["typescript"] || deps["ts-node"] || deps["tsup"]) layers.push("TypeScript");
+      if (deps["react"] || deps["next"]) layers.push(deps["next"] ? "Next.js" : "React");
+      if (deps["express"] || deps["fastify"] || deps["koa"]) layers.push("Express/Fastify");
+      if (deps["vite"]) layers.push("Vite");
+      stack = layers.join(" + ");
     } catch {
     }
   }
@@ -119,7 +133,48 @@ function detectProjectInfo(projectPath) {
     else if (existsSync2(join3(projectPath, "composer.json"))) stack = "PHP";
     else if (existsSync2(join3(projectPath, "Gemfile"))) stack = "Ruby";
   }
-  return { name, description, stack, date };
+  if (!description) {
+    const readmePath = join3(projectPath, "README.md");
+    if (existsSync2(readmePath)) {
+      try {
+        const lines = readFileSync2(readmePath, "utf8").split("\n");
+        for (const line of lines.slice(0, 30)) {
+          const trimmed = line.trim();
+          if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("!") && !trimmed.startsWith("<") && trimmed.length > 10) {
+            description = trimmed.replace(/\*\*/g, "").slice(0, 120);
+            break;
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  try {
+    const log = execSync("git log --oneline -5", { cwd: projectPath, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    if (log) {
+      recentActivity = log.split("\n").slice(0, 3).join(" \xB7 ");
+    }
+  } catch {
+  }
+  const SKIP_DIRS = /* @__PURE__ */ new Set([".git", "node_modules", "dist", "build", ".brain", "binaries", ".cache", "coverage", ".next", "out"]);
+  try {
+    const entries = readdirSync(projectPath, { withFileTypes: true });
+    const dirs = entries.filter((e) => e.isDirectory() && !SKIP_DIRS.has(e.name) && !e.name.startsWith(".")).map((e) => e.name).slice(0, 6);
+    if (dirs.length > 0) topDirs = dirs.join(", ");
+  } catch {
+  }
+  return { name, description, stack, recentActivity, topDirs, date };
+}
+function memoryHasRealContent(memoryPath) {
+  try {
+    const lines = readFileSync2(memoryPath, "utf8").split("\n");
+    return lines.some((line) => {
+      const t = line.trim();
+      return t.length > 0 && !t.startsWith("#") && !t.startsWith("<!--") && !t.startsWith(">") && !t.startsWith("|") && t !== "---";
+    });
+  } catch {
+    return false;
+  }
 }
 function buildMemoryMd(templateContent, info2) {
   let content = templateContent;
@@ -138,10 +193,15 @@ ${info2.stack}
 <!-- Add layers: Frontend, Backend, Infra, etc. -->`
     );
   }
+  const focusLines = [];
+  if (info2.topDirs) focusLines.push(`Directories: ${info2.topDirs}`);
+  if (info2.recentActivity) focusLines.push(`Recent commits: ${info2.recentActivity}`);
+  const focusBlock = focusLines.length > 0 ? focusLines.join("\n") + `
+<!-- Initialized ${info2.date} \u2014 update to reflect the current active focus -->` : `<!-- Initialized ${info2.date} \u2014 ask your AI to fill this in after your first session -->`;
   content = content.replace(
     /### Current focus\n<!--[^]*?-->/,
     `### Current focus
-<!-- Initialized ${info2.date} \u2014 ask your AI to fill this in after your first session -->`
+${focusBlock}`
   );
   return content;
 }
@@ -161,41 +221,155 @@ Examples:
   const brainDir = join3(projectPath, BRAIN_DIR);
   printBanner();
   if (existsSync2(brainDir)) {
-    if (opts.yes) {
+    const memoryPath = join3(brainDir, "MEMORY.md");
+    const hasMemory = existsSync2(memoryPath) && memoryHasRealContent(memoryPath);
+    if (!opts.yes && hasMemory) {
+      const hasAnyAgentFile = AGENTS.some((a) => existsSync2(join3(projectPath, a.destFile)));
+      if (!hasAnyAgentFile) {
+        console.log("");
+        console.log(`  ${chalk2.cyan("\u25C9")}  MindLink memory found in this project.`);
+        console.log(`     ${chalk2.dim("MEMORY.md has content \u2014 this looks like a team project.")}`);
+        console.log("");
+        const action = await select({
+          message: "What would you like to do?",
+          options: [
+            { value: "restore", label: "Set up agent files", hint: "recommended for new team members \u2014 writes CLAUDE.md, .cursorrules, etc." },
+            { value: "reinit", label: "Full re-init", hint: "recreate everything, reconfigure settings" },
+            { value: "exit", label: "Cancel", hint: "" }
+          ]
+        });
+        if (isCancel(action) || action === "exit") {
+          process.exit(0);
+        }
+        if (action === "restore") {
+          const agentChoices = AGENTS.map((a) => ({
+            value: a.value,
+            label: `${a.label.padEnd(18)} ${chalk2.dim(a.hint)}`,
+            hint: a.selected ? "recommended" : void 0
+          }));
+          const agentResult = await multiselect({
+            message: "Which AI agents do you use?",
+            options: agentChoices,
+            initialValues: AGENTS.filter((a) => a.selected).map((a) => a.value),
+            required: false
+          });
+          if (isCancel(agentResult)) {
+            cancel("Cancelled.");
+            process.exit(0);
+          }
+          const toRestore = agentResult;
+          const restored = [];
+          for (const agentValue of toRestore) {
+            const agent = AGENTS.find((a) => a.value === agentValue);
+            if (!agent) continue;
+            const destPath = join3(projectPath, agent.destFile);
+            mkdirSync2(dirname2(destPath), { recursive: true });
+            writeFileSync2(destPath, readFileSync2(join3(AGENT_TEMPLATES_DIR, agent.templateFile), "utf8"));
+            restored.push(agent.destFile);
+          }
+          if (toRestore.includes("claude")) {
+            const hookDest = join3(projectPath, ".claude", "settings.json");
+            if (!existsSync2(hookDest)) {
+              mkdirSync2(dirname2(hookDest), { recursive: true });
+              writeFileSync2(hookDest, readFileSync2(join3(HOOKS_TEMPLATES_DIR, "claude-settings.json"), "utf8"));
+              restored.push(".claude/settings.json");
+            }
+          }
+          const configPath = join3(brainDir, "config.json");
+          if (!existsSync2(configPath)) {
+            const config = {
+              gitTracking: true,
+              autoSync: true,
+              agents: toRestore,
+              maxLogEntries: DEFAULT_MAX_LOG_ENTRIES
+            };
+            writeFileSync2(configPath, JSON.stringify(config, null, 2));
+            restored.push(".brain/config.json");
+          }
+          try {
+            registerProject(projectPath);
+          } catch {
+          }
+          console.log("");
+          for (const f of restored) console.log(`  ${chalk2.green("\u2713")}  ${f}`);
+          console.log("");
+          console.log(`  ${chalk2.green("\u2713")}  Agent files ready. Start a new session \u2014 your AI is already briefed.`);
+          console.log("");
+          process.exit(0);
+        }
+      } else {
+        if (opts.yes) {
+          console.log(`  ${chalk2.red("\u2717")}  Already initialized at this path.`);
+          console.log(`     Run ${chalk2.cyan("mindlink config")} to change settings.`);
+          console.log("");
+          process.exit(1);
+        }
+        const action = await select({
+          message: ".brain/ already exists at this path. What would you like to do?",
+          options: [
+            { value: "config", label: "Change settings", hint: "mindlink config" },
+            { value: "status", label: "View current status", hint: "mindlink status" },
+            { value: "exit", label: "Nothing \u2014 exit", hint: "" }
+          ]
+        });
+        if (isCancel(action) || action === "exit") {
+          process.exit(0);
+        }
+        if (action === "status") {
+          try {
+            execSync("mindlink status", { cwd: projectPath, stdio: "inherit" });
+          } catch {
+          }
+        }
+        if (action === "config") {
+          console.log(`  Run ${chalk2.cyan("mindlink config")} to change settings.`);
+        }
+        console.log("");
+        process.exit(0);
+      }
+    } else if (opts.yes) {
       console.log(`  ${chalk2.red("\u2717")}  Already initialized at this path.`);
       console.log(`     Run ${chalk2.cyan("mindlink config")} to change settings.`);
       console.log("");
       process.exit(1);
-    }
-    const action = await select({
-      message: ".brain/ already exists at this path. What would you like to do?",
-      options: [
-        { value: "config", label: "Change settings", hint: "mindlink config" },
-        { value: "status", label: "View current status", hint: "mindlink status" },
-        { value: "exit", label: "Nothing \u2014 exit", hint: "" }
-      ]
-    });
-    if (isCancel(action) || action === "exit") {
-      process.exit(0);
-    }
-    if (action === "status") {
-      const { execSync: execSync2 } = await import("child_process");
-      try {
-        execSync2("mindlink status", { stdio: "inherit" });
-      } catch {
+    } else if (!hasMemory) {
+    } else {
+      const action = await select({
+        message: ".brain/ already exists at this path. What would you like to do?",
+        options: [
+          { value: "config", label: "Change settings", hint: "mindlink config" },
+          { value: "status", label: "View current status", hint: "mindlink status" },
+          { value: "exit", label: "Nothing \u2014 exit", hint: "" }
+        ]
+      });
+      if (isCancel(action) || action === "exit") {
+        process.exit(0);
       }
+      if (action === "status") {
+        try {
+          execSync("mindlink status", { cwd: projectPath, stdio: "inherit" });
+        } catch {
+        }
+      }
+      if (action === "config") {
+        console.log(`  Run ${chalk2.cyan("mindlink config")} to change settings.`);
+      }
+      console.log("");
+      process.exit(0);
     }
-    if (action === "config") {
-      console.log(`  Run ${chalk2.cyan("mindlink config")} to change settings.`);
-    }
-    console.log("");
-    process.exit(0);
   }
   intro(chalk2.bold("Initializing memory for this project:"));
   console.log(`  ${chalk2.dim(projectPath)}`);
   console.log(`  ${chalk2.dim("This creates a .brain/ folder scoped to this project only.")}`);
   console.log(`  ${chalk2.dim("Run mindlink init once per project \u2014 never needs to be run again.")}`);
   console.log("");
+  if (process.platform === "win32") {
+    console.log(`  ${chalk2.yellow("\u26A0")}  ${chalk2.bold("Windows detected")}`);
+    console.log(`     Claude Code hooks use bash and won't run on Windows.`);
+    console.log(`     Memory enforcement (Stop hook, session timestamps) will be disabled.`);
+    console.log(`     All other features work normally.`);
+    console.log("");
+  }
   let selectedAgents;
   if (opts.yes) {
     selectedAgents = AGENTS.filter((a) => a.selected).map((a) => a.value);
@@ -511,7 +685,7 @@ Examples:
 // src/commands/log.ts
 import { Command as Command3 } from "commander";
 import chalk4 from "chalk";
-import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
 import { join as join5, resolve as resolve3 } from "path";
 var logCommand = new Command3("log").description("Print session history").option("--all", "Show full history").option("--limit <n>", "Show last N sessions", "10").option("--since <date>", "Show sessions from a date (matched against heading text)").option("--json", "Output as JSON").addHelpText("after", `
 Examples:
@@ -568,7 +742,7 @@ Examples:
     }
     console.log("");
   }
-  const archiveFiles = readdirSync(brainDir).filter((f) => /^LOG-\d{4}-\d{2}-\d{2}\.md$/.test(f)).sort();
+  const archiveFiles = readdirSync2(brainDir).filter((f) => /^LOG-\d{4}-\d{2}-\d{2}\.md$/.test(f)).sort();
   if (archiveFiles.length > 0) {
     console.log(`  ${chalk4.dim("\u2500".repeat(44))}`);
     console.log(`  ${chalk4.dim("Like all human brains, MindLink forgets old sessions")}`);
@@ -1019,13 +1193,14 @@ Examples:
 import { Command as Command8 } from "commander";
 import { select as select3, isCancel as isCancel4, cancel as cancel4, spinner as spinner2 } from "@clack/prompts";
 import chalk9 from "chalk";
-import { execSync } from "child_process";
+import { execSync as execSync2 } from "child_process";
 import { join as join10, dirname as dirname4 } from "path";
 import { existsSync as existsSync9, readFileSync as readFileSync9, writeFileSync as writeFileSync6, mkdirSync as mkdirSync4 } from "fs";
+var REQUIRED_BRAIN_FILES = ["MEMORY.md", "SESSION.md", "SHARED.md", "LOG.md"];
 async function latestVersion() {
   try {
     const { default: https } = await import("https");
-    return new Promise((resolve13) => {
+    return new Promise((resolve14) => {
       const req = https.get(
         "https://registry.npmjs.org/mindlink/latest",
         { headers: { "User-Agent": "mindlink-cli" } },
@@ -1037,17 +1212,17 @@ async function latestVersion() {
           res.on("end", () => {
             try {
               const parsed = JSON.parse(data);
-              resolve13(parsed.version ?? null);
+              resolve14(parsed.version ?? null);
             } catch {
-              resolve13(null);
+              resolve14(null);
             }
           });
         }
       );
-      req.on("error", () => resolve13(null));
+      req.on("error", () => resolve14(null));
       req.setTimeout(8e3, () => {
         req.destroy();
-        resolve13(null);
+        resolve14(null);
       });
     });
   } catch {
@@ -1119,7 +1294,7 @@ Examples:
     const s2 = spinner2();
     s2.start(`Installing mindlink@${latest}...`);
     try {
-      execSync(`npm install -g mindlink@${latest}`, { stdio: "pipe" });
+      execSync2(`npm install -g mindlink@${latest}`, { stdio: "pipe" });
       s2.stop("Done.");
       console.log("");
       console.log(`  ${chalk9.green("\u2713")}  Updated to ${latest}.`);
@@ -1153,6 +1328,19 @@ Examples:
       }
       const agentValues = config.agents ?? AGENTS.filter((a) => a.selected).map((a) => a.value);
       const refreshed = [];
+      for (const brainFile of REQUIRED_BRAIN_FILES) {
+        const dest = join10(projectPath, BRAIN_DIR, brainFile);
+        if (!existsSync9(dest)) {
+          try {
+            const template = join10(BRAIN_TEMPLATES_DIR, brainFile);
+            if (existsSync9(template)) {
+              writeFileSync6(dest, readFileSync9(template, "utf8"));
+              refreshed.push(`.brain/${brainFile}`);
+            }
+          } catch {
+          }
+        }
+      }
       for (const agentValue of agentValues) {
         const agent = AGENTS.find((a) => a.value === agentValue);
         if (!agent) continue;
@@ -1176,9 +1364,13 @@ Examples:
       const memoryPath = join10(projectPath, BRAIN_DIR, "MEMORY.md");
       if (existsSync9(memoryPath)) {
         try {
-          const content = readFileSync9(memoryPath, "utf8");
-          if (!content.includes("## User Profile") && content.includes("## Important Context")) {
-            const userProfileBlock = `## User Profile  <!-- READ EVERY SESSION \u2014 personal facts about the user -->
+          let content = readFileSync9(memoryPath, "utf8");
+          let memoryChanged = false;
+          const migrations = [
+            {
+              // v1.1.5: Add ## User Profile section
+              marker: "## User Profile",
+              block: `## User Profile  <!-- READ EVERY SESSION \u2014 personal facts about the user -->
 
 <!-- Job, company, level, years of experience, immigration status -->
 <!-- Age, health, physical details -->
@@ -1190,8 +1382,20 @@ Examples:
 
 ---
 
-`;
-            writeFileSync6(memoryPath, content.replace("## Important Context", userProfileBlock + "## Important Context"));
+`,
+              before: "## Important Context"
+            }
+            // Future migrations go here — same pattern:
+            // { marker: '## New Section', block: '## New Section\n\n<!-- ... -->\n\n\n---\n\n', before: '## Some Existing Section' },
+          ];
+          for (const m of migrations) {
+            if (!content.includes(m.marker) && content.includes(m.before)) {
+              content = content.replace(m.before, m.block + m.before);
+              memoryChanged = true;
+            }
+          }
+          if (memoryChanged) {
+            writeFileSync6(memoryPath, content);
             refreshed.push(".brain/MEMORY.md");
           }
         } catch {
@@ -1438,7 +1642,7 @@ Examples:
 import { Command as Command11 } from "commander";
 import { text as text2, isCancel as isCancel6, cancel as cancel6 } from "@clack/prompts";
 import chalk12 from "chalk";
-import { existsSync as existsSync12, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync12, readdirSync as readdirSync3 } from "fs";
 import { join as join13, resolve as resolve10, basename as basename3 } from "path";
 import AdmZip from "adm-zip";
 var exportCommand = new Command11("export").description("Export .brain/ memory to a shareable zip file").option("--output <path>", "Directory or full path to save the zip file").option("--include-agents", "Also include agent instruction files (CLAUDE.md, CURSOR.md, etc.)").addHelpText("after", `
@@ -1485,8 +1689,7 @@ Examples:
     const answer = await text2({
       message: "Where should the zip be saved?",
       placeholder: projectPath,
-      initialValue: projectPath,
-      hint: `default filename: ${defaultFilename}`
+      initialValue: projectPath
     });
     if (isCancel6(answer)) {
       cancel6("Cancelled.");
@@ -1514,7 +1717,7 @@ Examples:
       skipped.push(`.brain/${file}`);
     }
   }
-  const archiveFiles = readdirSync2(brainDir).filter((f) => /^LOG-\d{4}-\d{2}-\d{2}\.md$/.test(f));
+  const archiveFiles = readdirSync3(brainDir).filter((f) => /^LOG-\d{4}-\d{2}-\d{2}\.md$/.test(f));
   for (const file of archiveFiles) {
     zip.addLocalFile(join13(brainDir, file), ".brain");
     included.push(`.brain/${file}`);
@@ -1661,7 +1864,7 @@ Examples:
 // src/commands/doctor.ts
 import { Command as Command13 } from "commander";
 import chalk14 from "chalk";
-import { existsSync as existsSync14, readFileSync as readFileSync12, statSync as statSync3, readdirSync as readdirSync3 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync12, statSync as statSync3, readdirSync as readdirSync4 } from "fs";
 import { join as join15, resolve as resolve12 } from "path";
 var CORE_LINE_LIMIT = 50;
 var CORE_WARN_THRESHOLD = 40;
@@ -1793,7 +1996,7 @@ Examples:
         checks.push(ok(`LOG.md \u2014 ${entryCount} sessions logged (last: ${newestHeading}, going back to: ${oldestHeading})`));
       }
     }
-    const archives = readdirSync3(brainDir).filter((f) => /^LOG-\d{4}-\d{2}\.md$/.test(f));
+    const archives = readdirSync4(brainDir).filter((f) => /^LOG-\d{4}-\d{2}\.md$/.test(f));
     if (archives.length > 0) {
       checks.push(info(`${archives.length} archive file${archives.length !== 1 ? "s" : ""} \u2014 old sessions are stored in LOG-*.md, not gone`));
     }
@@ -1876,8 +2079,167 @@ var versionCommand = new Command14("version").description("Show the current Mind
   console.log("");
 });
 
+// src/commands/diff.ts
+import { Command as Command15 } from "commander";
+import chalk16 from "chalk";
+import { existsSync as existsSync15, readFileSync as readFileSync13, statSync as statSync4 } from "fs";
+import { join as join16, resolve as resolve13 } from "path";
+import { execSync as execSync3 } from "child_process";
+var BRAIN_FILES3 = ["MEMORY.md", "SESSION.md", "LOG.md", "SHARED.md"];
+function relativeTime2(ms) {
+  const secs = Math.floor(ms / 1e3);
+  if (secs < 60) return `${secs}s ago`;
+  const mins = Math.floor(secs / 60);
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  return `${Math.floor(hours / 24)}d ago`;
+}
+function getGitDiff(filePath, since) {
+  try {
+    const dir = resolve13(filePath, "..");
+    execSync3("git rev-parse --is-inside-work-tree", { cwd: dir, stdio: "pipe" });
+    const ref = since || "HEAD~1";
+    const diff = execSync3(`git diff ${ref} -- "${filePath}"`, {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return diff || null;
+  } catch {
+    return null;
+  }
+}
+function parseDiffSummary(diff) {
+  const added = [];
+  const removed = [];
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("+") && !line.startsWith("+++")) {
+      const t = line.slice(1).trim();
+      if (t && !t.startsWith("<!--") && !t.startsWith("#") && t !== "---") added.push(t);
+    } else if (line.startsWith("-") && !line.startsWith("---")) {
+      const t = line.slice(1).trim();
+      if (t && !t.startsWith("<!--") && !t.startsWith("#") && t !== "---") removed.push(t);
+    }
+  }
+  return { added, removed };
+}
+var diffCommand = new Command15("diff").description("Show what changed in .brain/ since last session").option("--since <ref>", "Git ref or date to diff against (default: last mindlink clear or HEAD~1)").option("--json", "Output as JSON").addHelpText("after", `
+What it does:
+  Shows what changed in each .brain/ file since your last session.
+  Uses git diff when .brain/ is tracked; falls back to file modification times.
+
+Examples:
+  mindlink diff
+  mindlink diff --since HEAD~3
+  mindlink diff --since "2026-04-10"
+  `).action((opts) => {
+  const projectPath = resolve13(process.cwd());
+  const brainDir = join16(projectPath, BRAIN_DIR);
+  if (!existsSync15(brainDir)) {
+    console.log("");
+    console.log(`  ${chalk16.red("\u2717")}  No .brain/ found in this directory.`);
+    console.log(`     Run ${chalk16.cyan("mindlink init")} to get started.`);
+    console.log("");
+    process.exit(1);
+  }
+  const results = {};
+  const sessionTsPath = join16(brainDir, ".session_ts");
+  const sessionTs = existsSync15(sessionTsPath) ? parseInt(readFileSync13(sessionTsPath, "utf8").trim(), 10) * 1e3 : null;
+  const now = Date.now();
+  const isGitTracked = (() => {
+    try {
+      execSync3("git rev-parse --is-inside-work-tree", { cwd: projectPath, stdio: "pipe" });
+      const tracked = execSync3("git ls-files --error-unmatch .brain/MEMORY.md", {
+        cwd: projectPath,
+        stdio: "pipe"
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  })();
+  for (const file of BRAIN_FILES3) {
+    const filePath = join16(brainDir, file);
+    if (!existsSync15(filePath)) {
+      results[file] = { exists: false };
+      continue;
+    }
+    const stat = statSync4(filePath);
+    const mtime = stat.mtimeMs;
+    const content = readFileSync13(filePath, "utf8");
+    const sizeLines = content.split("\n").length;
+    let diff = null;
+    let added = [];
+    let removed = [];
+    if (isGitTracked) {
+      diff = getGitDiff(filePath, opts.since);
+      if (diff) {
+        const summary = parseDiffSummary(diff);
+        added = summary.added.slice(0, 5);
+        removed = summary.removed.slice(0, 5);
+      }
+    }
+    results[file] = { exists: true, mtime, diff, added, removed, sizeLines };
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(results, null, 2));
+    return;
+  }
+  console.log("");
+  console.log(`  ${chalk16.bold(".brain/ changes")}`);
+  if (sessionTs) {
+    console.log(`  ${chalk16.dim(`Session started ${relativeTime2(now - sessionTs)}`)}`);
+  }
+  if (isGitTracked) {
+    const sinceRef = opts.since || "HEAD~1";
+    console.log(`  ${chalk16.dim(`Git diff against: ${sinceRef}`)}`);
+  } else {
+    console.log(`  ${chalk16.dim(".brain/ is not git-tracked \u2014 showing modification times only")}`);
+  }
+  console.log("");
+  for (const file of BRAIN_FILES3) {
+    const r = results[file];
+    if (!r.exists) {
+      console.log(`  ${chalk16.dim("\u2014")}  ${file}  ${chalk16.dim("(not found)")}`);
+      continue;
+    }
+    const age = r.mtime ? relativeTime2(now - r.mtime) : "";
+    const changedThisSession = sessionTs && r.mtime ? r.mtime > sessionTs : false;
+    const indicator = changedThisSession ? chalk16.green("\u25CF") : chalk16.dim("\u25CB");
+    const label = changedThisSession ? chalk16.green(file) : chalk16.dim(file);
+    console.log(`  ${indicator}  ${label}  ${chalk16.dim(`${r.sizeLines} lines \xB7 modified ${age}`)}`);
+    if (isGitTracked && r.diff) {
+      for (const line of (r.added ?? []).slice(0, 3)) {
+        console.log(`       ${chalk16.green("+")} ${line.length > 80 ? line.slice(0, 80) + "\u2026" : line}`);
+      }
+      for (const line of (r.removed ?? []).slice(0, 3)) {
+        console.log(`       ${chalk16.red("-")} ${line.length > 80 ? line.slice(0, 80) + "\u2026" : line}`);
+      }
+    } else if (!isGitTracked && changedThisSession) {
+      console.log(`       ${chalk16.dim("(content diff unavailable \u2014 commit .brain/ to git for line-level diff)")}`);
+    } else if (isGitTracked && !r.diff) {
+      console.log(`       ${chalk16.dim("no changes since last commit")}`);
+    }
+  }
+  console.log("");
+  const changedCount = BRAIN_FILES3.filter((f) => {
+    const r = results[f];
+    return r.exists && sessionTs && r.mtime && r.mtime > sessionTs;
+  }).length;
+  if (changedCount === 0) {
+    console.log(`  ${chalk16.dim("No .brain/ files were modified this session.")}`);
+    if (sessionTs) {
+      console.log(`  ${chalk16.dim("If the session just started, this is expected.")}`);
+    }
+  } else {
+    console.log(`  ${chalk16.green("\u2713")}  ${changedCount} file${changedCount !== 1 ? "s" : ""} updated this session.`);
+  }
+  console.log("");
+});
+
 // src/cli.ts
-var program = new Command15();
+var program = new Command16();
 program.name("mindlink").description("Give your AI a brain.").version(VERSION, "-v, --version");
 program.addCommand(initCommand);
 program.addCommand(statusCommand);
@@ -1893,9 +2255,10 @@ program.addCommand(exportCommand);
 program.addCommand(importCommand);
 program.addCommand(doctorCommand);
 program.addCommand(versionCommand);
+program.addCommand(diffCommand);
 program.on("command:*", (operands) => {
   const unknown = operands[0];
-  const known = ["init", "status", "log", "clear", "reset", "config", "sync", "update", "summary", "uninstall", "export", "import", "doctor", "version"];
+  const known = ["init", "status", "log", "clear", "reset", "config", "sync", "update", "summary", "uninstall", "export", "import", "doctor", "version", "diff"];
   function levenshtein(a, b) {
     const m = a.length, n = b.length;
     const dp = Array.from(
@@ -1911,11 +2274,11 @@ program.on("command:*", (operands) => {
   }
   const closest = known.map((cmd) => ({ cmd, dist: levenshtein(unknown, cmd) })).sort((a, b) => a.dist - b.dist)[0];
   console.log("");
-  console.log(`  ${chalk16.red("\u2717")}  Unknown command: ${chalk16.bold(unknown)}`);
+  console.log(`  ${chalk17.red("\u2717")}  Unknown command: ${chalk17.bold(unknown)}`);
   if (closest && closest.dist <= 3) {
-    console.log(`     Did you mean ${chalk16.cyan("mindlink " + closest.cmd)}?`);
+    console.log(`     Did you mean ${chalk17.cyan("mindlink " + closest.cmd)}?`);
   }
-  console.log(`     Run ${chalk16.cyan("mindlink --help")} to see all commands.`);
+  console.log(`     Run ${chalk17.cyan("mindlink --help")} to see all commands.`);
   console.log("");
   process.exit(1);
 });