linksee-memory 0.11.1 → 0.11.2

package/README.md

@@ -425,6 +425,23 @@ All editors share the same `~/.linksee-memory/memory.db`. A decision made in Cla
 
 Default: `~/.linksee-memory/memory.db`. Override with `LINKSEE_MEMORY_DIR` env var.
 
+### Uninstall
+
+```bash
+# 1. Remove the MCP server registration
+claude mcp remove linksee
+
+# 2. Remove the hooks from settings.json (edit the file, delete the linksee entries):
+#    ~/.claude/settings.json          → the Stop hook running "npx -y linksee-memory sync"
+#    <project>/.claude/settings.json  → the SessionStart/PreToolUse hooks running "npx -y linksee-memory guard"
+
+# 3. Remove the installed skill and all local memory (optional)
+rm -rf ~/.claude/skills/linksee-memory
+rm -rf ~/.linksee-memory   # deletes all stored memory — nothing is kept anywhere else
+```
+
+Nothing ever leaves your machine, so step 3 fully erases everything Linksee stored.
+
 ## What's new in v0.9
 
 | Feature | Detail |
@@ -787,6 +804,11 @@ After install, in a new Claude session ask: *"Can you remember that I prefer Typ
 
 ## Changelog
 
+### v0.11.2 — More cold-start hardening (2026-06-16)
+
+- **`stats` works on a fresh database** instead of crashing with `no such table` — it ensures the schema exists first (it may be the first command a new user runs).
+- **`map --help`** prints usage instead of trying to import a map.
+
 ### v0.11.1 — Cold-start fixes (2026-06-16)
 
 - **Run any CLI through the package name:** `npx -y linksee-memory setup` (and `map`, `sync`, `guard`, `stats`, `import`, `install-skill`). A fresh user couldn't reach the standalone bins (`linksee-memory-setup`, …) via `npx` — npx resolves package names, not sibling bin names — so the one-command install 404'd. The main bin now dispatches subcommands; the standalone bins remain as aliases.

package/dist/bin/map-import.js

@@ -39,6 +39,20 @@ for (let i = 0; i < argv.length; i++) {
 const sub = positionals[0] ?? 'import';
 const arg1 = positionals[1]; // the node-id / file / topic for explain|blast|affects|where
 const mapPath = flagValue(argv, 'file', join(process.cwd(), 'map.yaml'));
+if (argv.includes('--help') || argv.includes('-h') || sub === 'help') {
+    process.stdout.write(`linksee-memory map — navigate your product map (map.yaml) and catch drift\n\n` +
+        `Usage: npx -y linksee-memory map <command> [args]\n\n` +
+        `  where [<file>]    where am I? (no arg = infer from recent edits) → node + what it affects\n` +
+        `  explain <node>    why this status? — declared vs reality + file:line evidence + fix\n` +
+        `  affects <node>    what to change together if you touch this node\n` +
+        `  status            whole-project health % + what needs attention\n` +
+        `  next              the prioritized next fix candidate(s)\n` +
+        `  reconcile         re-check the map against the real code/files\n` +
+        `  inspect --json    machine-readable dump (CI / tooling)\n` +
+        `  blueprint         stage x node board (colors = live verdict)\n\n` +
+        `Flags: --file <map.yaml>  --root <repo>  --lang ja\n`);
+    process.exit(0);
+}
 const db = openDb();
 runMigrations(db);
 // Graceful exit when there's no map yet (the cold-user state) — never a raw stack trace.

package/dist/bin/stats.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 // linksee-memory-stats — summary of the local memory DB.
 // Usage:
-//   npx linksee-memory-stats
-//   npx linksee-memory-stats --json
-//   npx linksee-memory-stats --per-entity 10
+//   npx -y linksee-memory stats
+//   npx -y linksee-memory stats --json
+//   npx -y linksee-memory stats --per-entity 10
 //
 // Safe to run anytime (read-only).
 import { statSync } from 'node:fs';
-import { openDb, getDbPath } from '../db/migrate.js';
+import { openDb, runMigrations, getDbPath } from '../db/migrate.js';
 function parseArgs() {
     const argv = process.argv.slice(2);
     const a = { json: false, perEntity: 5, help: false };
@@ -68,6 +68,7 @@ function main() {
     }
     catch { /* no db yet */ }
     const db = openDb();
+    runMigrations(db); // ensure schema exists — `stats` may be the first command a fresh user runs
     const counts = {
         entities: db.prepare('SELECT COUNT(*) as c FROM entities').get().c,
         memories: db.prepare('SELECT COUNT(*) as c FROM memories').get().c,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linksee-memory",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "mcpName": "io.github.michielinksee/linksee-memory",
   "description": "Local-first agent memory MCP — cross-agent brain with drift detection, 6-layer structured memory + token-saving file diff cache",
   "type": "module",