mindlink 1.1.3 → 1.1.5

package/README.md

@@ -12,15 +12,17 @@ Three things break AI-assisted development:
 
 MindLink fixes all three. One command per project.
 
+Git gave every developer a shared version history. MindLink gives your AI team a shared memory — persistent, version-controlled, and not locked inside any one tool.
+
 [![npm version](https://img.shields.io/npm/v/mindlink)](https://www.npmjs.com/package/mindlink)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)](#installation)
 
 ---
 
-> ### ◉ Latest — v1.1.3
-> **Session memory · Cross-session sync · Cross-agent · 8 AI agents supported · Auto-refresh agent files on every update**
-> [→ Full release notes](https://github.com/404-not-found/mindlink/releases/tag/v1.1.3)
+> ### ◉ Latest — v1.1.5
+> **Stronger memory enforcement · MEMORY.md trigger checklist · mtime-based session verification · "git for AI memory" positioning · Claude Code best-in-class section**
+> [→ Full release notes](https://github.com/404-not-found/mindlink/releases/tag/v1.1.5)
 
 ---
 
@@ -32,7 +34,7 @@ MindLink fixes all three. One command per project.
 - [Supported Agents](#supported-agents)
 - [Commands](#commands)
 - [Can My AI Run These Commands?](#can-my-ai-run-these-commands-itself)
-- [The Hook (Claude Code)](#the-hook-claude-code-users)
+- [Best with Claude Code](#best-with-claude-code)
 - [License](#license)
 - [Contributing](#contributing)
 
@@ -90,7 +92,7 @@ Close any AI session whenever you want — Claude Code, Cursor, Codex, whatever
 
 **One memory, every agent** — use Claude Code in the morning, switch to Cursor in the afternoon — both read the exact same `.brain/` folder. No syncing. No duplicating context. No "but I told the other AI this already." Every agent you use shares one brain, because the memory lives in your project, not inside any particular tool. This is something no AI vendor can replicate — they each only know their own product.
 
-**Team memory out of the box** — commit `.brain/` to git and your whole team shares the same AI context. New teammate joins, does `git pull`, and their AI agent is already fully briefed on the project. No onboarding session, no copying notes, no "let me catch you up."
+**Team memory, like git** — commit `.brain/` to git and your whole team shares the same AI context, automatically. New developer joins, does `git pull` — their AI is already fully briefed. Two developers in the same project? Their agents share context in real time, just like working off the same branch. No onboarding session, no copying notes, no "let me catch you up." This is what git did for code history — MindLink does for AI memory.
 
 **Plug in, not lock in** — works with Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Windsurf, Cline, Aider, and more. Because MindLink just writes files that agents read — no APIs, no SDKs, no version dependencies — it works with whatever version you have installed today and every version that comes after.
 
@@ -179,9 +181,28 @@ The one exception: `mindlink sync` in watch mode runs continuously — keep it i
 
 ---
 
-## The Hook (Claude Code users)
+## Best with Claude Code
+
+MindLink works with every agent listed above. But Claude Code users get something the others don't: **a second enforcement layer**.
+
+Every other agent reads the instruction file at startup and follows it as best it can. That's the instruction layer — guidance, not guarantees. The agent can skip a step, misread a section, or forget to write after a long session.
+
+Claude Code gets both the instruction file **and** an OS-level hook that fires before every single message — outside the AI's control. This hook:
+
+- Scans for memory triggers and reminds the agent to write `MEMORY.md` before answering
+- Forces `SESSION.md` to be updated as the last action of every response
+- Runs a shell-level check after every response: if `MEMORY.md` still contains only placeholders, the agent is immediately flagged and must fill it in before continuing
+
+**The practical difference:**
+
+| | All other agents | Claude Code |
+|---|---|---|
+| Persistent memory | ✓ instruction file | ✓ instruction file + hook |
+| Enforced on every message | ✗ | ✓ OS-level hook |
+| Post-response memory verification | ✗ | ✓ shell check |
+| Context compaction recovery | ✓ instruction | ✓ instruction + hook |
 
-Claude Code users get an extra layer: a `UserPromptSubmit` hook in `.claude/settings.json` that fires on every message, reminding your agent to re-read `.brain/` if its context was just compacted. Other agents rely on their instruction files — Claude Code gets both because it supports OS-level hooks. Same protection, different delivery.
+If you're choosing an agent specifically to use with MindLink, Claude Code gives you the most reliable memory behavior. Other agents work well — Claude Code works harder.
 
 ---
 

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command as Command15 } from "commander";
 import chalk16 from "chalk";
 
 // src/utils/version.ts
-var VERSION = "1.1.3";
+var VERSION = "1.1.5";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -88,6 +88,11 @@ function registerProject(projectPath) {
 function getRegisteredProjects() {
   return load();
 }
+function pruneRegistry(isValid) {
+  const paths = load();
+  const pruned = paths.filter(isValid);
+  if (pruned.length !== paths.length) save(pruned);
+}
 
 // src/commands/init.ts
 function detectProjectInfo(projectPath) {
@@ -577,7 +582,7 @@ Examples:
 // src/commands/clear.ts
 import { Command as Command4 } from "commander";
 import chalk5 from "chalk";
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync3, unlinkSync } from "fs";
 import { join as join6, resolve as resolve4 } from "path";
 var clearCommand = new Command4("clear").description("Reset SESSION.md for a fresh session start").option("-y, --yes", "Skip confirmation prompt").addHelpText("after", `
 What it does:
@@ -606,6 +611,8 @@ Examples:
     const templatePath = join6(BRAIN_TEMPLATES_DIR, "SESSION.md");
     const destPath = join6(brainDir, "SESSION.md");
     writeFileSync3(destPath, readFileSync5(templatePath, "utf8"));
+    const tsDest = join6(brainDir, ".session_ts");
+    if (existsSync5(tsDest)) unlinkSync(tsDest);
   } catch (err) {
     console.log(`  ${chalk5.red("\u2717")}  ${err instanceof Error ? err.message : String(err)}`);
     console.log("");
@@ -694,7 +701,7 @@ import {
   writeFileSync as writeFileSync5,
   appendFileSync as appendFileSync2,
   mkdirSync as mkdirSync3,
-  unlinkSync
+  unlinkSync as unlinkSync2
 } from "fs";
 import { join as join8, resolve as resolve6, dirname as dirname3 } from "path";
 function readConfig(brainDir) {
@@ -734,7 +741,7 @@ function removeAgentFile(projectPath, agentValue) {
   if (!agent) return null;
   const destPath = join8(projectPath, agent.destFile);
   if (!existsSync7(destPath)) return null;
-  unlinkSync(destPath);
+  unlinkSync2(destPath);
   return agent.destFile;
 }
 function addClaudeHook(projectPath) {
@@ -1128,7 +1135,11 @@ Examples:
       process.exit(1);
     }
   }
-  const projects = getRegisteredProjects().filter((p) => existsSync9(join10(p, BRAIN_DIR, "config.json")));
+  const cwd = process.cwd();
+  const validProjects = getRegisteredProjects().filter((p) => existsSync9(join10(p, BRAIN_DIR, "config.json")));
+  pruneRegistry((p) => existsSync9(join10(p, BRAIN_DIR, "config.json")));
+  const cwdHasBrain = existsSync9(join10(cwd, BRAIN_DIR, "config.json"));
+  const projects = cwdHasBrain && !validProjects.includes(cwd) ? [cwd, ...validProjects] : validProjects;
   if (projects.length > 0) {
     console.log("");
     console.log(`  Refreshing agent files in ${projects.length} project${projects.length > 1 ? "s" : ""}...`);
@@ -1162,6 +1173,30 @@ Examples:
         } catch {
         }
       }
+      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 -->
+
+<!-- Job, company, level, years of experience, immigration status -->
+<!-- Age, health, physical details -->
+<!-- Family, relationships, major life events -->
+<!-- Long-term goals: career, financial, personal -->
+<!-- Strong opinions, values, preferences -->
+<!-- Update in place \u2014 do not append; consolidate when it grows -->
+
+
+---
+
+`;
+            writeFileSync6(memoryPath, content.replace("## Important Context", userProfileBlock + "## Important Context"));
+            refreshed.push(".brain/MEMORY.md");
+          }
+        } catch {
+        }
+      }
       console.log(`  ${chalk9.bold(projectPath)}`);
       for (const f of refreshed) {
         console.log(`    ${chalk9.green("\u2713")}  ${f}`);
@@ -1292,7 +1327,7 @@ to get a full briefing on the current project state.
 import { Command as Command10 } from "commander";
 import { select as select4, isCancel as isCancel5, cancel as cancel5 } from "@clack/prompts";
 import chalk11 from "chalk";
-import { existsSync as existsSync11, readFileSync as readFileSync11, rmSync, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync11, rmSync, unlinkSync as unlinkSync3 } from "fs";
 import { join as join12, resolve as resolve9 } from "path";
 var uninstallCommand = new Command10("uninstall").description("Remove MindLink from the current project").option("-y, --yes", "Skip confirmation and remove all project files").addHelpText("after", `
 What gets removed:
@@ -1374,7 +1409,7 @@ Examples:
     const destPath = join12(projectPath, agent.destFile);
     if (existsSync11(destPath)) {
       try {
-        unlinkSync2(destPath);
+        unlinkSync3(destPath);
         removed.push(agent.destFile);
       } catch (err) {
         errors.push(`${agent.destFile}: ${err instanceof Error ? err.message : String(err)}`);
@@ -1385,7 +1420,7 @@ Examples:
     const hookPath = join12(projectPath, ".claude", "settings.json");
     if (existsSync11(hookPath)) {
       try {
-        unlinkSync2(hookPath);
+        unlinkSync3(hookPath);
         removed.push(".claude/settings.json");
       } catch {
       }