mindlink 2.1.0 → 2.2.0

package/README.md

@@ -22,9 +22,9 @@ Git gave every developer a shared version history. MindLink gives your AI team a
 
 ---
 
-> ### ◉ 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)
+> ### ◉ Latest — v2.2.0
+> **`mindlink learn` — teach your AI from any file or URL · Smart init · `mindlink recap` · `mindlink search`**
+> [→ Full release notes](https://github.com/404-not-found/mindlink/releases/tag/v2.2.0)
 
 ---
 

package/dist/cli.js

@@ -2,11 +2,11 @@
 import "./chunk-2H7UOFLK.js";
 
 // src/cli.ts
-import { Command as Command22 } from "commander";
-import chalk22 from "chalk";
+import { Command as Command23 } from "commander";
+import chalk23 from "chalk";
 
 // src/utils/version.ts
-var VERSION = "2.1.0";
+var VERSION = "2.2.0";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -1583,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((resolve19) => {
+    return new Promise((resolve20) => {
       const req = https.get(
         "https://registry.npmjs.org/mindlink/latest",
         { headers: { "User-Agent": "mindlink-cli" } },
@@ -1595,17 +1595,17 @@ async function latestVersion() {
           res.on("end", () => {
             try {
               const parsed = JSON.parse(data);
-              resolve19(parsed.version ?? null);
+              resolve20(parsed.version ?? null);
             } catch {
-              resolve19(null);
+              resolve20(null);
             }
           });
         }
       );
-      req.on("error", () => resolve19(null));
+      req.on("error", () => resolve20(null));
       req.setTimeout(8e3, () => {
         req.destroy();
-        resolve19(null);
+        resolve20(null);
       });
     });
   } catch {
@@ -3810,8 +3810,222 @@ Examples:
   }
 });
 
+// src/commands/learn.ts
+import { Command as Command22 } from "commander";
+import chalk22 from "chalk";
+import { existsSync as existsSync22, readFileSync as readFileSync20, writeFileSync as writeFileSync11 } from "fs";
+import { join as join22, resolve as resolve19, extname as extname2 } from "path";
+function resolveSection(hint) {
+  if (!hint) return "Important Context";
+  const h = hint.toLowerCase();
+  if (h.includes("core")) return "Core";
+  if (h.includes("arch")) return "Architecture";
+  if (h.includes("dec")) return "Decisions";
+  if (h.includes("conv")) return "Conventions";
+  return "Important Context";
+}
+async function fetchUrl(url) {
+  const { default: https } = await (url.startsWith("https") ? import("https") : import("http"));
+  return new Promise((resolve20, reject) => {
+    const req = https.get(url, { headers: { "User-Agent": "mindlink-learn/1.0" } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        fetchUrl(res.headers.location).then(resolve20).catch(reject);
+        return;
+      }
+      if (res.statusCode < 200 || res.statusCode >= 300) {
+        reject(new Error(`HTTP ${res.statusCode}`));
+        return;
+      }
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk;
+      });
+      res.on("end", () => resolve20(data));
+    });
+    req.on("error", reject);
+    req.setTimeout(15e3, () => {
+      req.destroy();
+      reject(new Error("Request timed out"));
+    });
+  });
+}
+function stripHtml(html) {
+  return html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/\s{2,}/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+}
+function readLocalFile(filePath) {
+  const ext = extname2(filePath).toLowerCase();
+  const raw = readFileSync20(filePath, "utf8");
+  if (ext === ".json") {
+    try {
+      return JSON.stringify(JSON.parse(raw), null, 2).slice(0, 8e3);
+    } catch {
+      return raw;
+    }
+  }
+  return raw;
+}
+function extractFacts(text3, maxLines = 60) {
+  const SKIP_PATTERNS = [
+    /^(cookie|privacy|terms|copyright|all rights reserved|subscribe|sign up|log in|home|menu|search|navigation)/i,
+    /^\s*[\|<>\/\\]\s*$/,
+    /^https?:\/\//
+  ];
+  const lines = text3.split("\n").map((l) => l.trim()).filter(
+    (l) => l.length > 10 && l.length < 300 && !SKIP_PATTERNS.some((p) => p.test(l))
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const deduped = [];
+  for (const line of lines) {
+    const key = line.toLowerCase().replace(/\s+/g, " ");
+    if (!seen.has(key)) {
+      seen.add(key);
+      deduped.push(line);
+    }
+  }
+  return deduped.slice(0, maxLines).join("\n");
+}
+function appendToMemory(memoryPath, section, facts, source) {
+  let content = readFileSync20(memoryPath, "utf8");
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const entry = `<!-- learned from: ${source} on ${date} -->
+${facts.trim()}`;
+  const lines = content.split("\n");
+  let headingIdx = -1;
+  let nextSectionIdx = lines.length;
+  let headingLevel = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const match = lines[i].match(/^(#{1,6})\s+(.+)/);
+    if (match) {
+      const level = match[1].length;
+      const title = match[2].replace(/<!--.*?-->/g, "").trim();
+      if (headingIdx < 0 && title.toLowerCase() === section.toLowerCase()) {
+        headingIdx = i;
+        headingLevel = level;
+      } else if (headingIdx >= 0 && level <= headingLevel) {
+        nextSectionIdx = i;
+        break;
+      }
+    }
+  }
+  if (headingIdx < 0) {
+    content = content.trimEnd() + `
+
+## ${section}
+
+${entry}
+`;
+  } else {
+    const insertAt = nextSectionIdx > 0 && lines[nextSectionIdx - 1].trim() === "---" ? nextSectionIdx - 1 : nextSectionIdx;
+    lines.splice(insertAt, 0, "", entry, "");
+    content = lines.join("\n");
+  }
+  writeFileSync11(memoryPath, content);
+}
+var learnCommand = new Command22("learn").description("Extract facts from a file or URL and save them into project memory").argument("<source>", "File path or URL to learn from").option("--section <name>", "Target memory section (core, architecture, decisions, conventions, context)", "context").option("--preview", "Show what would be learned without writing anything").addHelpText("after", `
+Examples:
+  mindlink learn ./docs/architecture.md
+  mindlink learn https://example.com/api-docs
+  mindlink learn ./package.json --section architecture
+  mindlink learn ./DECISIONS.md --section decisions
+  mindlink learn https://stripe.com/docs/webhooks --preview
+  `).action(async (source, opts) => {
+  const projectPath = resolve19(process.cwd());
+  const brainDir = join22(projectPath, BRAIN_DIR);
+  if (!existsSync22(brainDir)) {
+    console.log(`  ${chalk22.red("\u2717")}  No .brain/ found in this directory.`);
+    console.log(`     Run ${chalk22.cyan("mindlink init")} to get started.`);
+    console.log("");
+    process.exit(1);
+  }
+  const memoryPath = join22(brainDir, "MEMORY.md");
+  if (!existsSync22(memoryPath)) {
+    console.log(`  ${chalk22.red("\u2717")}  MEMORY.md not found in .brain/.`);
+    console.log(`     Run ${chalk22.cyan("mindlink init")} to set up memory.`);
+    console.log("");
+    process.exit(1);
+  }
+  const section = resolveSection(opts.section);
+  const isUrl = source.startsWith("http://") || source.startsWith("https://");
+  console.log("");
+  let rawText = "";
+  if (isUrl) {
+    process.stdout.write(`  Fetching ${chalk22.dim(source)}...
+`);
+    try {
+      const html = await fetchUrl(source);
+      rawText = stripHtml(html);
+    } catch (err) {
+      console.log(`  ${chalk22.red("\u2717")}  Could not fetch URL: ${err instanceof Error ? err.message : String(err)}`);
+      console.log(`     Check the URL is reachable and try again.`);
+      console.log("");
+      process.exit(1);
+    }
+  } else {
+    const absPath = resolve19(projectPath, source);
+    if (!existsSync22(absPath)) {
+      console.log(`  ${chalk22.red("\u2717")}  File not found: ${absPath}`);
+      console.log("");
+      process.exit(1);
+    }
+    try {
+      rawText = readLocalFile(absPath);
+    } catch (err) {
+      console.log(`  ${chalk22.red("\u2717")}  Could not read file: ${err instanceof Error ? err.message : String(err)}`);
+      console.log("");
+      process.exit(1);
+    }
+  }
+  if (!rawText.trim()) {
+    console.log(`  ${chalk22.yellow("\u2192")}  Source is empty \u2014 nothing to learn.`);
+    console.log("");
+    process.exit(0);
+  }
+  const facts = extractFacts(rawText);
+  if (!facts.trim()) {
+    console.log(`  ${chalk22.yellow("\u2192")}  Could not extract any meaningful content from this source.`);
+    console.log("");
+    process.exit(0);
+  }
+  if (opts.preview) {
+    console.log(`  ${chalk22.bold("Preview")} \u2014 would add to ${chalk22.cyan("## " + section)} in MEMORY.md:`);
+    console.log("");
+    const previewLines = facts.split("\n").slice(0, 20);
+    for (const line of previewLines) {
+      console.log(`  ${chalk22.dim("\xB7")} ${line}`);
+    }
+    if (facts.split("\n").length > 20) {
+      console.log(`  ${chalk22.dim(`... and ${facts.split("\n").length - 20} more lines`)}`);
+    }
+    console.log("");
+    console.log(`  Run without ${chalk22.cyan("--preview")} to save.`);
+    console.log("");
+    process.exit(0);
+  }
+  try {
+    appendToMemory(memoryPath, section, facts, source);
+  } catch (err) {
+    console.log(`  ${chalk22.red("\u2717")}  Failed to write to MEMORY.md: ${err instanceof Error ? err.message : String(err)}`);
+    console.log("");
+    process.exit(1);
+  }
+  const lineCount = facts.split("\n").filter((l) => l.trim()).length;
+  console.log(`  ${chalk22.green("\u2713")}  Learned ${lineCount} lines from ${chalk22.dim(source)}`);
+  console.log(`     Added to ${chalk22.cyan("## " + section)} in MEMORY.md`);
+  console.log("");
+  console.log(`  ${chalk22.dim("Your AI will see this context starting next session.")}`);
+  console.log(`  ${chalk22.dim("Run mindlink verify to check memory health.")}`);
+  console.log("");
+  const existing = extractSection(readFileSync20(memoryPath, "utf8"), section);
+  const existingLines = existing.split("\n").filter((l) => l.trim() && !l.startsWith("<!--")).length;
+  if (existingLines > 80) {
+    console.log(`  ${chalk22.yellow("\u2192")}  ## ${section} is getting large (${existingLines} lines).`);
+    console.log(`     Run ${chalk22.cyan("mindlink prune")} to retire stale entries.`);
+    console.log("");
+  }
+});
+
 // src/cli.ts
-var program = new Command22();
+var program = new Command23();
 program.name("mindlink").description("Give your AI a brain.").version(VERSION, "-v, --version");
 program.addCommand(initCommand);
 program.addCommand(statusCommand);
@@ -3834,9 +4048,10 @@ program.addCommand(pruneCommand);
 program.addCommand(mcpCommand);
 program.addCommand(recapCommand);
 program.addCommand(searchCommand);
+program.addCommand(learnCommand);
 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", "recap", "search"];
+  const known = ["init", "status", "log", "clear", "reset", "config", "sync", "update", "summary", "uninstall", "export", "import", "doctor", "version", "diff", "verify", "profile", "prune", "mcp", "recap", "search", "learn"];
   function levenshtein(a, b) {
     const m = a.length, n = b.length;
     const dp = Array.from(
@@ -3852,11 +4067,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(`  ${chalk22.red("\u2717")}  Unknown command: ${chalk22.bold(unknown)}`);
+  console.log(`  ${chalk23.red("\u2717")}  Unknown command: ${chalk23.bold(unknown)}`);
   if (closest && closest.dist <= 3) {
-    console.log(`     Did you mean ${chalk22.cyan("mindlink " + closest.cmd)}?`);
+    console.log(`     Did you mean ${chalk23.cyan("mindlink " + closest.cmd)}?`);
   }
-  console.log(`     Run ${chalk22.cyan("mindlink --help")} to see all commands.`);
+  console.log(`     Run ${chalk23.cyan("mindlink --help")} to see all commands.`);
   console.log("");
   process.exit(1);
 });