mindlink 1.1.5 → 2.0.0

package/commands/update.md

@@ -1,6 +1,6 @@
 # mindlink update
 
-Update mindlink to the latest version.
+Update mindlink to the latest version and refresh all project files.
 
 **Run in your terminal only** — this downloads and installs software. Always prompts before doing anything.
 
@@ -16,9 +16,18 @@ mindlink update
 
 ## Description
 
-Checks the latest version on [GitHub Releases](https://github.com/404-not-found/mindlink/releases) and prompts before installing. Never updates silently — you are always shown what version you're moving to and can cancel.
+Checks the latest version on npm and prompts before installing. Never updates silently — you are always shown what version you're moving to and can cancel.
 
-Release notes for every version are available at:
+After installing (or if you're already up to date), `mindlink update` automatically refreshes every initialized project on your machine:
+
+- **Agent instruction files** (`CLAUDE.md`, `.cursorrules`, etc.) are overwritten with the latest templates in all registered projects. These files are owned by MindLink — any manual edits will be replaced.
+- **Claude Code hooks** (`.claude/settings.json`) are refreshed to the latest hook commands.
+- **MEMORY.md migrations** are applied non-destructively — new sections introduced in this version are injected into existing MEMORY.md files if they are absent. Your existing content is never touched.
+- **Missing brain files** are created if a new version introduced a new `.brain/` file that didn't exist in older projects.
+
+This means running `mindlink update` is always safe — your memory is preserved and your projects are brought to current spec automatically.
+
+Release notes for every version:
 ```
 https://github.com/404-not-found/mindlink/releases
 ```
@@ -44,10 +53,18 @@ Latest version    : x.y.z+1
   Skip this version
   Cancel
 
-[████████████████████] 100%
-
 ✓  Updated to x.y.z+1
    See what's new: github.com/404-not-found/mindlink/releases/tag/vx.y.z+1
+
+  Refreshing agent files in 3 projects...
+
+  /Users/you/projects/my-app
+    ✓  CLAUDE.md
+    ✓  CURSOR.md
+    ✓  .claude/settings.json
+    ✓  .brain/MEMORY.md
+
+  All agent files are up to date.
 ```
 
 **Already up to date:**
@@ -59,4 +76,5 @@ Latest version    : x.y.z+1
 
 ## Related Commands
 
+- [`mindlink init`](init.md) — set up a new project
 - [`mindlink help`](index.md) — see all commands

package/commands/verify.md

@@ -0,0 +1,122 @@
+# mindlink verify
+
+Check that `.brain/` memory is healthy and up to date.
+
+---
+
+## Synopsis
+
+```bash
+mindlink verify [--json] [--fix]
+```
+
+---
+
+## Description
+
+Runs a health check on the current project's `.brain/` directory. Answers: "is my AI's memory in good shape right now?"
+
+Unlike `mindlink doctor` (which checks setup correctness), `mindlink verify` checks **content quality** — whether memory files are actually filled in, whether the AI is actively writing session state, and whether MEMORY.md is getting too large to be useful.
+
+**Your AI can run this.** Ask it to run `mindlink verify` to check its own work before closing a session.
+
+---
+
+## Checks
+
+| Check | Pass | Warn | Fail |
+|---|---|---|---|
+| **Core section** | Has real content | — | Empty or placeholder only |
+| **User Profile** | Has real content | — | Empty or placeholder only |
+| **SESSION.md freshness** | Updated < 3 days ago | 3–7 days | > 7 days |
+| **LOG.md present** | Exists | — | Missing |
+| **MEMORY.md size** | < 100 real lines | 100–200 lines | > 200 lines |
+| **Agent files** | All present | Some missing | None present |
+
+---
+
+## Output
+
+```
+  ◉ MindLink Verify
+  /Users/you/my-project
+
+  ✓  Core section — filled
+  ✓  User Profile — filled
+  ⚠  SESSION.md — last updated 5 days ago
+       SESSION.md is getting stale...
+  ✓  LOG.md — 14 sessions logged
+  ✗  MEMORY.md — 217 lines (target: under 200)
+       Run mindlink prune to consolidate stale entries.
+  ✓  Agent files — all 2 present
+
+  1 error, 1 warning.
+  Run mindlink verify --fix to auto-repair 0 issues.
+```
+
+---
+
+## Options
+
+| Flag | Description |
+|---|---|
+| `--json` | Output results as JSON — useful for scripting or AI consumption |
+| `--fix` | Auto-fix recoverable issues (regenerate missing agent files) |
+
+---
+
+## `--fix` Behavior
+
+Auto-fix only applies to recoverable issues. It **never touches user-written memory content**.
+
+| Check | `--fix` action |
+|---|---|
+| `agent_files` missing | Re-generate from current templates |
+| `core` / `user_profile` empty | Print actionable message — no auto-fill |
+| `memory_size` too large | Print actionable message — run `mindlink prune` |
+| `session_fresh` stale | No auto-fix — AI must update SESSION.md |
+
+---
+
+## Examples
+
+**Check memory health:**
+```bash
+mindlink verify
+```
+
+**Machine-readable output:**
+```bash
+mindlink verify --json
+```
+
+**Auto-fix missing agent files:**
+```bash
+mindlink verify --fix
+```
+
+---
+
+## JSON Output
+
+```json
+{
+  "ok": false,
+  "checks": [
+    { "id": "core",         "label": "Core section — filled",       "status": "pass", "message": "", "fixable": false },
+    { "id": "user_profile", "label": "User Profile — filled",       "status": "pass", "message": "", "fixable": false },
+    { "id": "session_fresh","label": "SESSION.md — last updated 5 days ago", "status": "warn", "message": "...", "fixable": false },
+    { "id": "log_present",  "label": "LOG.md — 14 sessions logged", "status": "pass", "message": "", "fixable": false },
+    { "id": "memory_size",  "label": "MEMORY.md — 217 lines (target: under 200)", "status": "fail", "message": "Run mindlink prune...", "fixable": false },
+    { "id": "agent_files",  "label": "Agent files — all 2 present", "status": "pass", "message": "", "fixable": false }
+  ]
+}
+```
+
+---
+
+## Related Commands
+
+- [`mindlink prune`](prune.md) — retire stale MEMORY.md entries interactively
+- [`mindlink doctor`](doctor.md) — check setup correctness (files, hooks, config)
+- [`mindlink diff`](diff.md) — see what the AI wrote this session

package/dist/chunk-2H7UOFLK.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-2H7UOFLK.js.map

package/dist/chunk-2H7UOFLK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}