mindlink 2.0.4 → 2.1.0

package/README.md

@@ -22,9 +22,9 @@ Git gave every developer a shared version history. MindLink gives your AI team a
 
 ---
 
-> ### ◉ Latest — v2.0.2
-> **MCP integration for 6 agents · Smart loading · `mindlink verify` · `mindlink profile` · `mindlink prune`**
-> [→ Full release notes](https://github.com/404-not-found/mindlink/releases/tag/v2.0.2)
+> ### ◉ Latest — v2.1.0
+> **Smart init from git history · Stack-aware templates · `mindlink recap` · `mindlink search`**
+> [→ Full release notes](https://github.com/404-not-found/mindlink/releases/tag/v2.1.0)
 
 ---
 

package/dist/cli.js

@@ -2,11 +2,11 @@
 import "./chunk-2H7UOFLK.js";
 
 // src/cli.ts
-import { Command as Command20 } from "commander";
-import chalk20 from "chalk";
+import { Command as Command22 } from "commander";
+import chalk22 from "chalk";
 
 // src/utils/version.ts
-var VERSION = "2.0.4";
+var VERSION = "2.1.0";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -228,7 +228,113 @@ function detectProjectInfo(projectPath) {
     if (dirs.length > 0) topDirs = dirs.join(", ");
   } catch {
   }
-  return { name, description, stack, recentActivity, topDirs, date };
+  const git = analyzeGitHistory(projectPath);
+  return { name, description, stack, recentActivity, topDirs, date, git };
+}
+function analyzeGitHistory(projectPath) {
+  const exec = (cmd) => execSync(cmd, { cwd: projectPath, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  try {
+    exec("git rev-parse HEAD");
+  } catch {
+    return null;
+  }
+  let recentWork = "";
+  let topModules = "";
+  let topDecisions = "";
+  let isTeam = false;
+  let projectAge = "";
+  try {
+    const messages = exec('git log --pretty=format:"%s" -30').split("\n").map((m) => m.trim()).filter((m) => m.length > 0 && m.length < 120);
+    if (messages.length > 0) {
+      recentWork = messages.slice(0, 8).join("\n");
+    }
+  } catch {
+  }
+  try {
+    const diffstat = exec("git log --name-only --pretty=format: -30").split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+    const counts = {};
+    for (const file of diffstat) {
+      const parts = file.split("/");
+      const key = parts.length > 1 ? parts[0] + "/" : file;
+      counts[key] = (counts[key] ?? 0) + 1;
+    }
+    const sorted = Object.entries(counts).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([k]) => k);
+    if (sorted.length > 0) topModules = sorted.join(", ");
+  } catch {
+  }
+  try {
+    const authors = exec('git log --pretty=format:"%ae" -30').split("\n").map((e) => e.trim()).filter((e) => e.length > 0);
+    const unique = new Set(authors);
+    isTeam = unique.size > 1;
+  } catch {
+  }
+  try {
+    const firstDate = exec('git log --pretty=format:"%ad" --date=short | tail -1');
+    if (firstDate) {
+      const ms = Date.now() - new Date(firstDate).getTime();
+      const days = Math.floor(ms / 864e5);
+      if (days < 7) projectAge = `${days}d old`;
+      else if (days < 30) projectAge = `${Math.floor(days / 7)}w old`;
+      else if (days < 365) projectAge = `${Math.floor(days / 30)}mo old`;
+      else projectAge = `${Math.floor(days / 365)}y old`;
+    }
+  } catch {
+  }
+  try {
+    const messages = exec('git log --pretty=format:"%s" -50').split("\n").map((m) => m.trim());
+    const decisionKeywords = ["add", "switch", "replace", "migrate", "refactor", "remove", "use ", "adopt", "drop", "move"];
+    const decisions = messages.filter((m) => decisionKeywords.some((k) => m.toLowerCase().startsWith(k))).slice(0, 4).map((m) => m.slice(0, 80));
+    if (decisions.length > 0) topDecisions = decisions.join("\n");
+  } catch {
+  }
+  if (!recentWork && !topModules && !projectAge) return null;
+  return { recentWork, topModules, topDecisions, isTeam, projectAge };
+}
+function buildStackHints(stack) {
+  const s = stack.toLowerCase();
+  if (s.includes("next.js") || s.includes("nextjs")) {
+    return `Pages: app/ or pages/ router
+API routes: app/api/ or pages/api/
+Components: components/
+State: (fill in \u2014 context, zustand, redux?)`;
+  }
+  if (s.includes("react") && !s.includes("next")) {
+    return `Components: src/components/
+State: (fill in \u2014 context, zustand, redux?)
+Routing: (fill in \u2014 react-router, tanstack?)`;
+  }
+  if (s.includes("express") || s.includes("fastify") || s.includes("koa")) {
+    return `Entry: src/index.ts or server.ts
+Routes: src/routes/
+Middleware: src/middleware/
+DB: (fill in)`;
+  }
+  if (s.includes("python")) {
+    return `Entry: main.py or src/
+Dependencies: requirements.txt or pyproject.toml
+Virtual env: .venv/ or venv/`;
+  }
+  if (s.includes("rust")) {
+    return `Entry: src/main.rs or src/lib.rs
+Key crates: (fill in from Cargo.toml)
+Modules: src/`;
+  }
+  if (s.includes("go")) {
+    return `Entry: main.go or cmd/
+Packages: internal/ or pkg/
+Dependencies: go.mod`;
+  }
+  if (s.includes("java") || s.includes("kotlin")) {
+    return `Entry: src/main/
+Tests: src/test/
+Build: pom.xml or build.gradle`;
+  }
+  if (s.includes("ruby")) {
+    return `Entry: app/ (Rails) or lib/
+Dependencies: Gemfile
+Tests: spec/ or test/`;
+  }
+  return "";
 }
 function memoryHasRealContent(memoryPath) {
   try {
@@ -295,7 +401,14 @@ ${info2.stack}
   }
   const focusLines = [];
   if (info2.topDirs) focusLines.push(`Directories: ${info2.topDirs}`);
-  if (info2.recentActivity) focusLines.push(`Recent commits: ${info2.recentActivity}`);
+  if (info2.git?.recentWork) {
+    const firstLine = info2.git.recentWork.split("\n")[0];
+    focusLines.push(`Recent work: ${firstLine}`);
+  } else if (info2.recentActivity) {
+    focusLines.push(`Recent commits: ${info2.recentActivity}`);
+  }
+  if (info2.git?.projectAge) focusLines.push(`Project age: ${info2.git.projectAge}`);
+  if (info2.git?.isTeam) focusLines.push(`Team project: multiple contributors detected`);
   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(
@@ -303,6 +416,28 @@ ${info2.stack}
     `### Current focus
 ${focusBlock}`
   );
+  if (info2.git?.topDecisions) {
+    const decisionLines = info2.git.topDecisions.split("\n").map((d) => `- ${d} <!-- inferred from git history \u2014 verify and update -->`).join("\n");
+    content = content.replace(
+      /### Top decisions\n<!--[^]*?-->/,
+      `### Top decisions
+${decisionLines}
+<!-- The 3\u20135 most important locked-in choices. One line each. -->`
+    );
+  }
+  const stackHints = buildStackHints(info2.stack);
+  const archLines = [];
+  if (info2.git?.topModules) archLines.push(`Most active modules (from git history): ${info2.git.topModules}`);
+  if (stackHints) archLines.push(stackHints);
+  if (archLines.length > 0) {
+    content = content.replace(
+      /## Architecture[^\n]*\n\n<!--[^]*?-->/,
+      `## Architecture  <!-- Read when the task involves project structure -->
+
+` + archLines.join("\n") + `
+<!-- High-level structure: main components and how they relate. Update when the structure changes. -->`
+    );
+  }
   return content;
 }
 var BRAIN_FILES = [
@@ -782,7 +917,8 @@ function extractSection(markdown, heading) {
     if (match) {
       const level = match[1].length;
       const title = match[2].trim();
-      if (title.toLowerCase() === heading.toLowerCase()) {
+      const cleanTitle = title.replace(/<!--.*?-->/g, "").trim();
+      if (cleanTitle.toLowerCase() === heading.toLowerCase()) {
         inSection = true;
         headingLevel = level;
         continue;
@@ -1447,7 +1583,7 @@ 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((resolve17) => {
+    return new Promise((resolve19) => {
       const req = https.get(
         "https://registry.npmjs.org/mindlink/latest",
         { headers: { "User-Agent": "mindlink-cli" } },
@@ -1459,17 +1595,17 @@ async function latestVersion() {
           res.on("end", () => {
             try {
               const parsed = JSON.parse(data);
-              resolve17(parsed.version ?? null);
+              resolve19(parsed.version ?? null);
             } catch {
-              resolve17(null);
+              resolve19(null);
             }
           });
         }
       );
-      req.on("error", () => resolve17(null));
+      req.on("error", () => resolve19(null));
       req.setTimeout(8e3, () => {
         req.destroy();
-        resolve17(null);
+        resolve19(null);
       });
     });
   } catch {
@@ -3422,8 +3558,260 @@ ${summary.trim()}
   await server.connect(transport);
 });
 
+// src/commands/recap.ts
+import { Command as Command20 } from "commander";
+import chalk20 from "chalk";
+import { existsSync as existsSync20, readFileSync as readFileSync18 } from "fs";
+import { join as join20, resolve as resolve17 } from "path";
+var recapCommand = new Command20("recap").description("Summary of everything your AI learned across recent sessions").option("--days <n>", "How many days back to include", "7").option("--sessions <n>", "Max number of sessions to include").addHelpText("after", `
+Examples:
+  mindlink recap
+  mindlink recap --days 30
+  mindlink recap --sessions 5
+  `).action((opts) => {
+  const projectPath = resolve17(process.cwd());
+  const brainDir = join20(projectPath, BRAIN_DIR);
+  if (!existsSync20(brainDir)) {
+    console.log(`  ${chalk20.red("\u2717")}  No .brain/ found in this directory.`);
+    console.log(`     Run ${chalk20.cyan("mindlink init")} to get started.`);
+    console.log("");
+    process.exit(1);
+  }
+  const logPath = join20(brainDir, "LOG.md");
+  const memoryPath = join20(brainDir, "MEMORY.md");
+  if (!existsSync20(logPath)) {
+    console.log(`  ${chalk20.dim("No session history yet.")}`);
+    console.log(`  Start working with your AI \u2014 it will build up a log automatically.`);
+    console.log("");
+    process.exit(0);
+  }
+  const logContent = readFileSync18(logPath, "utf8");
+  const allEntries = parseLogEntries(logContent);
+  if (allEntries.length === 0) {
+    console.log(`  ${chalk20.dim("No sessions logged yet.")}`);
+    console.log("");
+    process.exit(0);
+  }
+  const maxDays = parseInt(opts.days ?? "7", 10);
+  const maxSessions = opts.sessions ? parseInt(opts.sessions, 10) : void 0;
+  const cutoff = Date.now() - maxDays * 864e5;
+  function parseEntryDate(heading) {
+    const clean = heading.replace(/^⭐\s*/, "").trim();
+    const d = new Date(clean);
+    return isNaN(d.getTime()) ? null : d;
+  }
+  let filtered = allEntries.filter((e) => {
+    const d = parseEntryDate(e.heading);
+    if (!d) return true;
+    return d.getTime() >= cutoff;
+  });
+  if (maxSessions && filtered.length > maxSessions) {
+    filtered = filtered.slice(0, maxSessions);
+  }
+  function extractField(body, label) {
+    const lines = body.split("\n");
+    const results = [];
+    const labelLower = label.toLowerCase();
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineLower = line.toLowerCase();
+      const inlinePatterns = [
+        new RegExp(`\\*\\*${label}[:\\*s]*\\*\\*:?\\s*(.+)`, "i"),
+        new RegExp(`^${label}:?\\s*(.+)`, "i")
+      ];
+      for (const pat of inlinePatterns) {
+        const m = line.match(pat);
+        if (m?.[1]) {
+          const items = m[1].split(/[·,]/).map((s) => s.trim()).filter((s) => s.length > 0);
+          results.push(...items);
+        }
+      }
+      if (lineLower.includes(labelLower + ":") && !line.includes("\u2192") && results.length === 0) {
+        let j = i + 1;
+        while (j < lines.length) {
+          const next = lines[j].trim();
+          if (!next || next.startsWith("**") || next.startsWith("##")) break;
+          const t = next.replace(/^[-*]\s*/, "").trim();
+          if (t.length > 0) results.push(t);
+          j++;
+        }
+      }
+    }
+    return results;
+  }
+  const completedItems = [];
+  const decisions = [];
+  const nextItems = [];
+  for (const entry of filtered) {
+    completedItems.push(...extractField(entry.body, "completed"));
+    completedItems.push(...extractField(entry.body, "what was completed"));
+    decisions.push(...extractField(entry.body, "decisions"));
+    nextItems.push(...extractField(entry.body, "next"));
+    nextItems.push(...extractField(entry.body, "up next"));
+    nextItems.push(...extractField(entry.body, "what's next"));
+  }
+  const dedup = (arr) => [...new Set(arr)].filter((s) => s.length > 0 && s !== "(none)");
+  const completed = dedup(completedItems).slice(0, 8);
+  const decidedItems = dedup(decisions).slice(0, 6);
+  const upNext = dedup(nextItems).slice(0, 4);
+  let memoryState = "";
+  if (existsSync20(memoryPath)) {
+    const mem = readFileSync18(memoryPath, "utf8");
+    const core = extractSection(mem, "Core");
+    const coreLines = core.split("\n").filter((l) => {
+      const t = l.trim();
+      return t.length > 0 && !t.startsWith("<!--") && !t.startsWith("#") && t !== "---";
+    });
+    if (coreLines.length > 0) memoryState = coreLines.slice(0, 4).join("\n");
+  }
+  console.log("");
+  console.log(`  ${chalk20.bold("\u25C9 MindLink \u2014 Session Recap")}  ${chalk20.dim(`last ${maxDays} days \xB7 ${filtered.length} session${filtered.length !== 1 ? "s" : ""}`)}`);
+  console.log("");
+  if (memoryState) {
+    console.log(`  ${chalk20.cyan("Memory snapshot")}`);
+    for (const line of memoryState.split("\n")) {
+      console.log(`    ${chalk20.dim(line)}`);
+    }
+    console.log("");
+  }
+  if (completed.length > 0) {
+    console.log(`  ${chalk20.green("What got done")}`);
+    for (const item of completed) {
+      console.log(`  ${chalk20.green("\u2192")}  ${item}`);
+    }
+    console.log("");
+  }
+  if (decidedItems.length > 0) {
+    console.log(`  ${chalk20.yellow("Decisions made")}`);
+    for (const item of decidedItems) {
+      console.log(`  ${chalk20.yellow("\u2192")}  ${item}`);
+    }
+    console.log("");
+  }
+  if (upNext.length > 0) {
+    console.log(`  ${chalk20.blue("Up next")}`);
+    for (const item of upNext) {
+      console.log(`  ${chalk20.blue("\u2192")}  ${item}`);
+    }
+    console.log("");
+  }
+  if (completed.length === 0 && decidedItems.length === 0 && upNext.length === 0) {
+    console.log(`  ${chalk20.dim("Sessions found but no structured content extracted.")}`);
+    console.log(`  ${chalk20.dim("Ask your AI to use the standard log format: completed / decisions / next.")}`);
+    console.log("");
+  }
+});
+
+// src/commands/search.ts
+import { Command as Command21 } from "commander";
+import chalk21 from "chalk";
+import { existsSync as existsSync21, readFileSync as readFileSync19 } from "fs";
+import { join as join21, resolve as resolve18 } from "path";
+var MEMORY_SECTIONS = ["Core", "Architecture", "Decisions", "Conventions", "User Profile", "Important Context"];
+function searchFile(filePath, pattern, sectionFilter) {
+  if (!existsSync21(filePath)) return [];
+  const content = readFileSync19(filePath, "utf8");
+  const results = [];
+  const filename = filePath.split("/").pop() ?? "";
+  if (filename === "MEMORY.md") {
+    for (const section of MEMORY_SECTIONS) {
+      if (sectionFilter && section.toLowerCase() !== sectionFilter.toLowerCase()) continue;
+      const sectionContent = extractSection(content, section);
+      const matchingLines2 = sectionContent.split("\n").filter((l) => {
+        const t = l.trim();
+        return t.length > 0 && !t.startsWith("<!--") && !t.startsWith("#") && t !== "---" && pattern.test(l);
+      }).map((l) => l.trim()).slice(0, 3);
+      if (matchingLines2.length > 0) {
+        results.push({ section, lines: matchingLines2 });
+      }
+    }
+    return results;
+  }
+  const matchingLines = content.split("\n").filter((l) => pattern.test(l)).map((l) => l.trim()).filter((l) => l.length > 0).slice(0, 3);
+  if (matchingLines.length > 0) {
+    results.push({ section: "Log", lines: matchingLines });
+  }
+  return results;
+}
+var searchCommand = new Command21("search").description("Search across all project memories").argument("<query>", "Text or pattern to search for").option("--project <name>", "Limit search to a specific project path (partial match)").option("--section <name>", "Limit search to a specific MEMORY.md section (e.g. decisions, architecture)").option("--log", "Also search session logs (LOG.md)").addHelpText("after", `
+Examples:
+  mindlink search "postgres"
+  mindlink search "auth" --section decisions
+  mindlink search "stripe" --project myapp
+  mindlink search "api key" --log
+  `).action((query, opts) => {
+  const cwd = resolve18(process.cwd());
+  const registered = getRegisteredProjects().filter((p) => existsSync21(join21(p, BRAIN_DIR, "config.json")));
+  const projects = registered.includes(cwd) ? registered : existsSync21(join21(cwd, BRAIN_DIR, "config.json")) ? [cwd, ...registered] : registered;
+  if (projects.length === 0) {
+    console.log("");
+    console.log(`  ${chalk21.dim("No MindLink projects found.")}`);
+    console.log(`  Run ${chalk21.cyan("mindlink init")} in a project directory first.`);
+    console.log("");
+    process.exit(0);
+  }
+  const filteredProjects = opts.project ? projects.filter((p) => p.toLowerCase().includes(opts.project.toLowerCase())) : projects;
+  if (filteredProjects.length === 0) {
+    console.log("");
+    console.log(`  ${chalk21.dim(`No projects matching "${opts.project}"`)}`);
+    console.log("");
+    process.exit(0);
+  }
+  let pattern;
+  try {
+    pattern = new RegExp(query, "i");
+  } catch {
+    pattern = new RegExp(query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
+  }
+  const matches = [];
+  for (const projectPath of filteredProjects) {
+    const brainDir = join21(projectPath, BRAIN_DIR);
+    if (!existsSync21(brainDir)) continue;
+    const memoryMatches = searchFile(join21(brainDir, "MEMORY.md"), pattern, opts.section);
+    for (const m of memoryMatches) {
+      matches.push({ projectPath, file: "MEMORY.md", section: m.section, lines: m.lines });
+    }
+    if (opts.log) {
+      const logMatches = searchFile(join21(brainDir, "LOG.md"), pattern, void 0);
+      for (const m of logMatches) {
+        matches.push({ projectPath, file: "LOG.md", section: m.section, lines: m.lines });
+      }
+    }
+  }
+  console.log("");
+  if (matches.length === 0) {
+    console.log(`  ${chalk21.dim(`No matches for "${query}"`)}`);
+    if (!opts.log) {
+      console.log(`  ${chalk21.dim("Add --log to also search session history.")}`);
+    }
+    console.log("");
+    process.exit(0);
+  }
+  const byProject = {};
+  for (const m of matches) {
+    if (!byProject[m.projectPath]) byProject[m.projectPath] = [];
+    byProject[m.projectPath].push(m);
+  }
+  const totalProjects = Object.keys(byProject).length;
+  console.log(`  ${chalk21.bold(`Found in ${totalProjects} project${totalProjects !== 1 ? "s" : ""}:`)}  ${chalk21.dim(`"${query}"`)}`);
+  console.log("");
+  for (const [projectPath, projectMatches] of Object.entries(byProject)) {
+    const parts = projectPath.split("/");
+    const projectName = parts[parts.length - 1] ?? projectPath;
+    console.log(`  ${chalk21.bold(projectName)}  ${chalk21.dim(projectPath)}`);
+    for (const m of projectMatches) {
+      console.log(`    ${chalk21.cyan(m.file)} ${chalk21.dim("\u2192")} ${chalk21.cyan(m.section)}`);
+      for (const line of m.lines) {
+        const highlighted = line.replace(pattern, (match) => chalk21.yellow(match));
+        console.log(`      ${chalk21.dim("\xB7")} ${highlighted}`);
+      }
+    }
+    console.log("");
+  }
+});
+
 // src/cli.ts
-var program = new Command20();
+var program = new Command22();
 program.name("mindlink").description("Give your AI a brain.").version(VERSION, "-v, --version");
 program.addCommand(initCommand);
 program.addCommand(statusCommand);
@@ -3444,9 +3832,11 @@ program.addCommand(verifyCommand);
 program.addCommand(profileCommand);
 program.addCommand(pruneCommand);
 program.addCommand(mcpCommand);
+program.addCommand(recapCommand);
+program.addCommand(searchCommand);
 program.on("command:*", (operands) => {
   const unknown = operands[0];
-  const known = ["init", "status", "log", "clear", "reset", "config", "sync", "update", "summary", "uninstall", "export", "import", "doctor", "version", "diff", "verify", "profile", "prune", "mcp"];
+  const known = ["init", "status", "log", "clear", "reset", "config", "sync", "update", "summary", "uninstall", "export", "import", "doctor", "version", "diff", "verify", "profile", "prune", "mcp", "recap", "search"];
   function levenshtein(a, b) {
     const m = a.length, n = b.length;
     const dp = Array.from(
@@ -3462,11 +3852,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(`  ${chalk20.red("\u2717")}  Unknown command: ${chalk20.bold(unknown)}`);
+  console.log(`  ${chalk22.red("\u2717")}  Unknown command: ${chalk22.bold(unknown)}`);
   if (closest && closest.dist <= 3) {
-    console.log(`     Did you mean ${chalk20.cyan("mindlink " + closest.cmd)}?`);
+    console.log(`     Did you mean ${chalk22.cyan("mindlink " + closest.cmd)}?`);
   }
-  console.log(`     Run ${chalk20.cyan("mindlink --help")} to see all commands.`);
+  console.log(`     Run ${chalk22.cyan("mindlink --help")} to see all commands.`);
   console.log("");
   process.exit(1);
 });