claude-mem-lite 6.29.3 → 6.30.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "6.29.3",
+      "version": "6.30.0",
       "source": "./",
       "homepage": "https://github.com/sdsrss/claude-mem-lite",
       "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. FTS5 BM25 keyword search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark)."

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "6.29.3",
+  "version": "6.30.0",
   "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. FTS5 BM25 keyword search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark).",
   "author": {
     "name": "sdsrss"

package/adopt-cli.mjs

@@ -50,7 +50,7 @@ import {
   claudeMdPath,
   detailDocPath,
   addAgentsImports,
-  holdsOnlyOwnLines,
+  holdsOnlyPluginLines,
   straySentinelLines,
 } from './claudemd.mjs';
 import { PLUGIN_SLUG, CURRENT_SENTINEL_VERSION, buildClaudeMdBlock, getDetailDoc } from './adopt-content.mjs';
@@ -77,7 +77,9 @@ import {
   isSharedAncestor,
   samePath,
   localFileLinked,
+  userInstructionFiles,
 } from './lib/local-steering.mjs';
+import { CLI_INVOKE } from './cli-path.mjs';
 
 /**
  * Remove the auto-written local block (CLAUDE.local.md, or the D#212 rules file) for the project at
@@ -226,7 +228,7 @@ function adoptOne(cwd, { force, dryRun }) {
   const sharedNote = (verb) =>
     switchesOffBelow
       ? [
-          `  ⚠ ${claudeMdPath(cwd)} ${verb} Claude Code reading the AGENTS.md of every project below ${cwd} that has one; to steer one project, run adopt inside it instead${verb === 'stops' ? ' (`claude-mem-lite unadopt` here takes this back)' : ''}, or set Project instructions to claude-md-and-agents-md in /config`,
+          `  ⚠ ${claudeMdPath(cwd)} ${verb} Claude Code reading the AGENTS.md of every project below ${cwd} that has one; to steer one project, run adopt inside it instead${verb === 'stops' ? ` (\`${CLI_INVOKE} unadopt\` here takes this back)` : ''}, or set Project instructions to claude-md-and-agents-md in /config`,
         ]
       : [];
 
@@ -262,7 +264,12 @@ function adoptOne(cwd, { force, dryRun }) {
           : local.action === 'failed'
             ? ` (could not remove the block from ${local.path}, so sessions here load it twice)`
             : ` (+removed the block from ${local.path})`;
-    log(`[adopt] ${cwd} → ${r.action}${migNote}${localNote}${importNote}`);
+    // The block's disposition alone read "unchanged" over a rewritten detail doc (D#470).
+    const docNote =
+      r.action === 'unchanged' && r.docAction !== 'unchanged'
+        ? ` (+${r.docAction === 'created' ? 'wrote' : 'refreshed'} detail doc)`
+        : '';
+    log(`[adopt] ${cwd} → ${r.action}${docNote}${migNote}${localNote}${importNote}`);
     for (const line of elsewhere('stops')) log(line);
     for (const line of sharedNote('stops')) log(line);
     // The copy that could not come out loads beside CLAUDE.md: said, and not a success (R3-4).
@@ -373,13 +380,17 @@ export function silentAutoAdopt({ cwd, markerDir, markerKey }) {
     // cost most of the proactive memory writes (1.5 vs 5.25 per trajectory) and never reached
     // subagents (0/12). Inside a git work tree the block now goes to CLAUDE.local.md, which the
     // host loads like CLAUDE.md and info/exclude keeps out of commits (5.25 writes, 12/12).
-    const hasBlock = blockIn(cwd);
+    // managed-only loads no project CLAUDE.md either (code.claude.com/docs/en/memory): a block in
+    // one steers nothing, so the session goes on to the refused local file and injects, and the
+    // file stays as it is (v6.30.0 pre-tag defects review P2-2).
+    const managedOnly = userInstructionFiles() === 'managed-only';
+    const hasBlock = !managedOnly && blockIn(cwd);
     if (!hasBlock) {
       if (markerDir && markerKey) writeMarker(markerDir, markerKey);
       // A damaged sentinel line (`… --> (team note)`) leaves the block's text in CLAUDE.md, which
       // the host loads, while the block no longer parses: a copy written to CLAUDE.local.md or
       // injected here was a second one. Neither; `adopt` names the line and the fix (D#369 B14).
-      const stray = straySentinelLines(claudeMdPath(cwd), PLUGIN_SLUG);
+      const stray = managedOnly ? [] : straySentinelLines(claudeMdPath(cwd), PLUGIN_SLUG);
       if (stray.length > 0) return { ok: true, action: 'damaged', reason: 'stray-sentinel', lines: stray };
       const root = localSteeringRoot(cwd);
       if (root) {
@@ -387,7 +398,13 @@ export function silentAutoAdopt({ cwd, markerDir, markerKey }) {
         // loads the root's CLAUDE.md as an ancestor, so a block there already steers this
         // session; and an opt-out recorded for the root covers the file that lives there.
         if (!samePath(root, cwd)) {
-          if (blockIn(root)) return { ok: true, action: 'already-adopted', reason: 'root-claude-md' };
+          const above = managedOnly ? null : blockAbove(cwd, root);
+          if (above)
+            return {
+              ok: true,
+              action: 'already-adopted',
+              reason: samePath(above, root) ? 'root-claude-md' : 'ancestor-claude-md',
+            };
           // Off for the project means off here too: no file, no injected copy, no /adopt offer
           // (delta review P2-2; lib/quiet-scope.mjs mirrors it).
           if (isAutoAdoptDisabledFor(root)) return { ok: true, action: 'disabled', reason: 'root-disabled' };
@@ -421,7 +438,11 @@ export function silentAutoAdopt({ cwd, markerDir, markerKey }) {
           agentsMd: r.agentsMd,
         };
       }
-      return { ok: true, action: 'inject' };
+      // managed-only loads no project CLAUDE.md, so the hook does not offer /adopt (v6.30.0 pre-tag
+      // claims review P2-5; inside a git work tree the reason is local-managed-only).
+      return managedOnly
+        ? { ok: true, action: 'inject', reason: 'managed-only' }
+        : { ok: true, action: 'inject' };
     }
     dropLocalSteering(cwd, { atRootOnly: true, keepTracked: true });
     let action = 'already-adopted';
@@ -462,8 +483,8 @@ function syncAgentsImports(cwd) {
   // project below it, each asking to approve an import from outside its directory.
   if (isSharedAncestor(cwd)) return null;
   // The cheap check first: most CLAUDE.md files hold the user's own lines, and the full answer
-  // asks git.
-  if (!holdsOnlyOwnLines(claudeMdPath(cwd), PLUGIN_SLUG)) return null;
+  // asks git. Another plugin's managed block counts as plugin text, not the user's (D#220).
+  if (!holdsOnlyPluginLines(claudeMdPath(cwd), PLUGIN_SLUG)) return null;
   const agents = agentsMdForNewClaudeMd(cwd, PLUGIN_SLUG);
   if (!agents) return null;
   const imported =
@@ -501,6 +522,16 @@ function blockIn(dir) {
   }
 }
 
+// The nearest directory above `cwd`, up to and including `root`, whose CLAUDE.md carries the block:
+// the host loads it as an ancestor. `adopt` run in packages/ and a session in packages/web/src got a
+// root CLAUDE.local.md on top of packages/CLAUDE.md, the block twice (D#177(2)).
+function blockAbove(cwd, root) {
+  for (let d = dirname(cwd); ; d = dirname(d)) {
+    if (blockIn(d)) return d;
+    if (samePath(d, root) || dirname(d) === d) return null;
+  }
+}
+
 function writeMarker(markerDir, markerKey) {
   if (!existsSync(markerDir)) mkdirSync(markerDir, { recursive: true });
   const path = join(markerDir, `.auto-adopt-${markerKey}`);
@@ -620,9 +651,11 @@ function cmdEnable(args) {
 function localSteeringStatus(cwd) {
   const root = localSteeringRoot(cwd);
   const runs = autoAdoptRuns(cwd, root);
-  // CLAUDE.md first: where it carries the block, no local file is written and nothing is injected,
-  // in a git work tree or not (pre-tag delta review of the D#212 repairs, D11).
-  if (blockIn(cwd) || (root && blockIn(root))) {
+  // CLAUDE.md first: where it carries the block, no local file is written, in a git work tree or not
+  // (pre-tag delta review of the D#212 repairs, D11).
+  if (blockIn(cwd) || (root && !samePath(root, cwd) && blockAbove(cwd, root))) {
+    if (userInstructionFiles() === 'managed-only')
+      return '⚠ CLAUDE.md carries the block, but Project instructions is set to managed-only, which does not load it';
     const cur = root ? readLocalSteering(root, PLUGIN_SLUG) : null;
     if (cur === null || cur.body === null) return '— none: CLAUDE.md carries the block';
     const kept = localFileLinked(root, cur.path)
@@ -642,7 +675,7 @@ function localSteeringStatus(cwd) {
   }
   // Before "not a git work tree": with auto-adopt off nothing is injected either (R3-13).
   if (isAutoAdoptDisabledFor(cwd) || (root && isAutoAdoptDisabledFor(root)))
-    return '— none: auto-adopt is off for this project (`claude-mem-lite adopt --enable` turns it back on)';
+    return `— none: auto-adopt is off for this project (\`${CLI_INVOKE} adopt --enable\` turns it back on)`;
   if (process.env.MEM_NO_AUTO_ADOPT === '1')
     return '— none: MEM_NO_AUTO_ADOPT=1, so no local file is written';
   if (!root)
@@ -656,10 +689,10 @@ function localSteeringStatus(cwd) {
     const plan = planLocalSteering(root, PLUGIN_SLUG, cwd);
     const beside = plan.agentsMd ?? 'the AGENTS.md';
     if (plan.file === RULES_MD && plan.refusal === 'off')
-      return `${removed}; beside ${beside} a file comes back only with CLAUDE_MEM_RULES_STEERING=1 and then \`claude-mem-lite adopt --enable\``;
+      return `${removed}; beside ${beside} a file comes back only with CLAUDE_MEM_RULES_STEERING=1 and then \`${CLI_INVOKE} adopt --enable\``;
     if (plan.file === RULES_MD && plan.refusal)
       return `${removed}; beside ${beside}, ${rulesWhy(plan.refusal)}`;
-    return `${removed}; after \`claude-mem-lite adopt --enable\` the next session may write it again`;
+    return `${removed}; after \`${CLI_INVOKE} adopt --enable\` the next session may write it again`;
   }
   const plan = planLocalSteering(root, PLUGIN_SLUG, cwd);
   if (!plan.refusal)
@@ -671,7 +704,7 @@ function localSteeringStatus(cwd) {
     ways.settingGivesFile
       ? 'set Project instructions to claude-md-and-agents-md in /config and CLAUDE.local.md is written instead'
       : null,
-    ways.adoptImports ? 'run `claude-mem-lite adopt`, whose CLAUDE.md imports AGENTS.md' : null,
+    ways.adoptImports ? `run \`${CLI_INVOKE} adopt\`, whose CLAUDE.md imports AGENTS.md` : null,
   ].filter(Boolean);
   return `✗ not written: Claude Code stops reading ${plan.agentsMd ?? 'the AGENTS.md'} once a CLAUDE.local.md exists, and ${rulesWhy(plan.refusal)} (steering is injected at session start${alt.length ? `; ${alt.join(', or ')}` : ''})`;
 }
@@ -685,6 +718,9 @@ function currentLocalLine(root, cwd, cur, runs) {
     return `✓ ${cur.path} (behind a symbolic link; the plugin leaves it as it is)`;
   if (trackedByGit(root, rel)) return `✓ ${cur.path} (tracked by git; the plugin leaves it as it is)`;
   const plan = runs ? planLocalSteering(root, PLUGIN_SLUG, cwd) : null;
+  // Left in place under managed-only (writeLocalSteering, D#219), not removed.
+  if (plan?.refusal === 'managed-only')
+    return `⚠ ${cur.path} (auto-written, but CLAUDE.local.md ${LOCAL_REFUSAL_TEXT['managed-only']}; the steering is injected, and the file stays for when the setting changes)`;
   if (plan?.refusal) {
     const why =
       plan.file === LOCAL_MD
@@ -764,7 +800,7 @@ function statusAll() {
     `[adopt --status] scanned ${dirs.length} memdir(s): ${legacy} with legacy sentinel (await migration), ${disabled} auto-adopt-disabled.`,
   );
   if (legacy > 0)
-    log('[adopt --status] run `claude-mem-lite adopt --all` to sweep legacy memory-dir sentinels now.');
+    log(`[adopt --status] run \`${CLI_INVOKE} adopt --all\` to sweep legacy memory-dir sentinels now.`);
 
   const known = listKnownProjectDirs();
   let adoptedCount = 0;
@@ -773,7 +809,7 @@ function statusAll() {
     `[adopt --status] known projects (~/.claude.json): ${known.length} scanned, ${adoptedCount} with a CLAUDE.md managed block or partial residue (detail doc/state).`,
   );
   if (adoptedCount > 0)
-    log('[adopt --status] run `claude-mem-lite unadopt --all` to remove every CLAUDE.md block.');
+    log(`[adopt --status] run \`${CLI_INVOKE} unadopt --all\` to remove every CLAUDE.md block.`);
 
   const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT ? 'set' : 'unset';
   const noAutoAdopt = process.env.MEM_NO_AUTO_ADOPT === '1' ? '1 (opt-out)' : 'unset';
@@ -783,7 +819,7 @@ function statusAll() {
     `  CLAUDE_PLUGIN_ROOT  = ${pluginRoot}  (any install path is consent; gate is the per-project opt-out below)`,
   );
   log(`  MEM_NO_AUTO_ADOPT   = ${noAutoAdopt}  (global escape hatch)`);
-  log('Per-project opt-out: `claude-mem-lite adopt --disable` (run --enable to re-arm).');
+  log(`Per-project opt-out: \`${CLI_INVOKE} adopt --disable\` (run --enable to re-arm).`);
 }
 
 /**
@@ -852,7 +888,7 @@ function unadoptAll(args) {
   if (failures > 0) process.exitCode = 1;
   if (projectDirs.length === 0) {
     log(
-      '[unadopt --all] no known projects found in ~/.claude.json — if a project was adopted but never opened in Claude Code, run `claude-mem-lite unadopt` from inside it.',
+      `[unadopt --all] no known projects found in ~/.claude.json — if a project was adopted but never opened in Claude Code, run \`${CLI_INVOKE} unadopt\` from inside it.`,
     );
   }
 }

package/adopt-content.mjs

@@ -73,7 +73,6 @@ export function getDetailDoc() {
 
 > 由 \`${CLI} adopt\` 生成、随版本自动刷新；卸载用 \`${CLI} unadopt\`。
 > 精炼触发表由 SessionStart 注入会话上下文（显式 \`${CLI} adopt\` 过的项目则写在 \`CLAUDE.md\` 的 \`claude-mem-lite\` 托管块里）；本文件是其展开。
-> 设计背景见 docs/CLAUDE-MD-STEERING-PLAN.md。
 
 > **本文下方所有命令写作 \`${CLI} <cmd>\`。** 该名字只在全局装过
 > （\`npm i -g claude-mem-lite\`）时才在 PATH 上；否则用等价的

package/claudemd.mjs

@@ -181,6 +181,31 @@ export function holdsOnlyOwnLines(p, slug) {
   }
 }
 
+// Another plugin's managed block: the same sentinel shape under any slug (code-graph-mcp writes
+// `<!-- code-graph-mcp:begin v2 -->` … `<!-- code-graph-mcp:end -->`). The backreference pairs a
+// begin with its own slug's end, so an unpaired line of one slug never closes another's block.
+const ANY_BLOCK_RE_G =
+  /<!-- ([a-z0-9][a-z0-9._-]*):begin v\d+ -->\r?\n(?:(?!<!-- \1:(?:begin|end))[\s\S])*?\r?\n<!-- \1:end -->/g;
+
+/**
+ * Whether the instructions file at `p` holds no line a person wrote: this plugin's blocks and
+ * imports, and other plugins' managed blocks. For "did plugin text alone switch AGENTS.md off"
+ * (D#220), never for deleting the file — another plugin's block is not ours to remove, and
+ * holdsOnlyOwnLines answers that question. False for a missing file.
+ * @param {string} p absolute path
+ * @param {string} slug
+ * @returns {boolean}
+ */
+export function holdsOnlyPluginLines(p, slug) {
+  try {
+    if (!existsSync(p)) return false;
+    const rest = readFileSync(p, 'utf8').replace(blockRegexG(slug), '').replace(ANY_BLOCK_RE_G, '');
+    return rest.trim() === '' || isOwnImportsOnly(rest, slug);
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Put adopt's AGENTS.md imports at the top of <cwd>/CLAUDE.md (created if absent), unless the
  * marker is there already. `imports` are paths relative to `cwd` (`AGENTS.md`,
@@ -365,7 +390,8 @@ export function needsRefresh(cwd, { slug, version, block, doc }) {
  * CLAUDE.md is created if absent. Only our slug-scoped region is rewritten;
  * everything else in the file is preserved verbatim.
  *
- * @returns {{action: 'created'|'updated'|'unchanged'}} (block disposition)
+ * @returns {{action: 'created'|'updated'|'unchanged', docAction: 'created'|'updated'|'unchanged'}}
+ *   (block disposition, and the detail doc's)
  */
 export function writeManaged(cwd, { slug, version, block, doc }) {
   const { action } = writeBlockAt(claudeMdPath(cwd), { slug, version, block });
@@ -378,6 +404,7 @@ export function writeManaged(cwd, { slug, version, block, doc }) {
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   const existingDoc = existsSync(dp) ? readFileSync(dp, 'utf8') : null;
   if (existingDoc !== docContent) atomicWrite(dp, docContent);
+  const docAction = existingDoc === null ? 'created' : existingDoc === docContent ? 'unchanged' : 'updated';
 
   // Only when what the sidecar records changed: it is committed alongside the block in a team
   // repo, and a fresh writtenAt on every re-run of `adopt` left a diff each time (E2E
@@ -393,7 +420,7 @@ export function writeManaged(cwd, { slug, version, block, doc }) {
   if (!(prev?.version === version && prev?.blockHash === blockHash && prev?.docHash === docHash)) {
     writeState(cwd, slug, { version, blockHash, docHash, writtenAt: new Date().toISOString() });
   }
-  return { action };
+  return { action, docAction };
 }
 
 /**

package/cli/activity.mjs

@@ -15,6 +15,7 @@ import { parseArgs, out, fail, rejectBareStringFlags } from './common.mjs';
 import { parseIntFlag, isNumericToken } from '../lib/cli-flags.mjs';
 import { snapshotDb } from '../lib/db-backup.mjs';
 import { isBlankText } from '../lib/blank-text.mjs';
+import { CLI_INVOKE } from '../cli-path.mjs';
 
 function formatActivityResults(rows) {
   if (!rows || rows.length === 0) return '(no events)';
@@ -31,7 +32,7 @@ function eventIdOf(token) {
 export async function cmdActivity(db, args) {
   const sub = args[0];
   if (!sub) {
-    fail('[mem] Usage: claude-mem-lite activity <save|search|recent|show|delete|promote> ...');
+    fail(`[mem] Usage: ${CLI_INVOKE} activity <save|search|recent|show|delete|promote> ...`);
     return;
   }
 
@@ -171,7 +172,7 @@ export async function cmdActivity(db, args) {
     // This command lets users prune them by ID without dropping to raw SQL.
     const idStr = positional.join(',').trim();
     if (!idStr) {
-      fail('[mem] Usage: claude-mem-lite activity delete <id1,id2,...> [--confirm]');
+      fail(`[mem] Usage: ${CLI_INVOKE} activity delete <id1,id2,...> [--confirm]`);
       return;
     }
     const tokens = idStr

package/cli/common.mjs

@@ -9,7 +9,8 @@
 // consistent.
 
 import { editDistance } from '../lib/edit-distance.mjs';
-import { neutralizeContextDelimiters, neutralizeSkillDelimiters } from '../format-utils.mjs';
+import { neutralizeContextDelimiters, neutralizeSkillDelimiters, truncate } from '../format-utils.mjs';
+import { CLI_INVOKE } from '../cli-path.mjs';
 
 // ─── Argument Parsing ────────────────────────────────────────────────────────
 
@@ -250,7 +251,7 @@ export function inertFilterFlagNotice(cmd, inert) {
   const verb = inert.length > 1 ? 'were' : 'was';
   return (
     `[mem] ${names} ${verb} ignored — \`${cmd}\` does not filter on ${inert.length > 1 ? 'them' : 'it'}, ` +
-    `so the results above are UNFILTERED. Run "claude-mem-lite help" for the flags this command reads.`
+    `so the results above are UNFILTERED. Run "${CLI_INVOKE} help" for the flags this command reads.`
   );
 }
 
@@ -647,3 +648,28 @@ export function formatProbeHints(probe) {
   if (probe.event?.length > 0) hints.push(`E#${probe.event.join(', E#')} (event)`);
   return hints;
 }
+
+/**
+ * The line under one side of a scan's Needs-review pair (D#461), from reviewRows: type, project,
+ * date, the lesson or that there is none, and the start of the narrative — enough to tell two rows
+ * with near-identical titles apart without `get`, which counts as an access.
+ * @param {{id: number, type?: string, project?: string, created_at_epoch?: number,
+ *   narrative?: string|null, lesson_learned?: string|null}|undefined} row
+ * @returns {string}
+ */
+export function formatReviewSide(row) {
+  if (!row) return '';
+  const flat = (v, n) =>
+    truncate(
+      String(v ?? '')
+        .replace(/\s+/g, ' ')
+        .trim(),
+      n,
+    );
+  const lesson =
+    row.lesson_learned && row.lesson_learned !== 'none'
+      ? `lesson: ${flat(row.lesson_learned, 100)}`
+      : 'no lesson';
+  const date = row.created_at_epoch ? new Date(row.created_at_epoch).toISOString().slice(0, 10) : '?';
+  return `#${row.id} ${row.type || '?'} · ${row.project} · ${date} · ${lesson} · ${flat(row.narrative, 120) || '(no narrative)'}`;
+}

package/cli/fts-check.mjs

@@ -3,12 +3,13 @@
 
 import { checkFTSIntegrity, rebuildFTS } from '../schema.mjs';
 import { parseArgs, out, fail } from './common.mjs';
+import { CLI_INVOKE } from '../cli-path.mjs';
 
 export function cmdFtsCheck(db, args) {
   const { positional } = parseArgs(args);
   const action = positional[0];
   if (!action) {
-    fail('[mem] Usage: claude-mem-lite fts-check <check|rebuild>');
+    fail(`[mem] Usage: ${CLI_INVOKE} fts-check <check|rebuild>`);
     return;
   }
   if (!['check', 'rebuild'].includes(action)) {

package/cli/verify-apply.mjs

@@ -23,12 +23,12 @@ import {
   markUndone,
 } from '../lib/verify-apply-core.mjs';
 import { parseArgs, out, fail, rejectBareStringFlags } from './common.mjs';
-import { shellWord } from '../cli-path.mjs';
+import { shellWord, CLI_INVOKE } from '../cli-path.mjs';
 
 const USAGE =
-  '[mem] Usage: claude-mem-lite verify-apply <proposals.json> [--project P]          (dry run)\n' +
-  '       claude-mem-lite verify-apply <proposals.json> [--project P] --apply --digest <d>\n' +
-  '       claude-mem-lite verify-apply --undo <backup.json>';
+  `[mem] Usage: ${CLI_INVOKE} verify-apply <proposals.json> [--project P]          (dry run)\n` +
+  `       ${CLI_INVOKE} verify-apply <proposals.json> [--project P] --apply --digest <d>\n` +
+  `       ${CLI_INVOKE} verify-apply --undo <backup.json>`;
 
 const SNIPPET_CONTEXT = 60;
 const BACKUP_DIR = join(DB_DIR, 'backups');

package/cli.mjs

@@ -338,8 +338,12 @@ if (cmd === '--version' || cmd === '-v' || cmd === '-V' || cmd === 'version') {
   if (best && bestDist <= 2) {
     process.stderr.write(`[mem] Did you mean: ${best}?\n`);
   } else {
+    // By path (D#462: the bare name is on PATH only after a global npm install). Imported here,
+    // not at the top: this entry takes no static local imports (D#26), and a module it cannot
+    // load leaves the old wording rather than no hint.
+    const { CLI_INVOKE } = await import('./cli-path.mjs').catch(() => ({ CLI_INVOKE: 'claude-mem-lite' }));
     process.stderr.write(
-      '[mem] Run "claude-mem-lite help" for CLI commands or "claude-mem-lite install" for setup\n',
+      `[mem] Run "${CLI_INVOKE} help" for CLI commands or "${CLI_INVOKE} install" for setup\n`,
     );
   }
   process.exitCode = 1;

package/commands/adopt.md

@@ -59,10 +59,10 @@ doc). Other plugins' blocks (e.g. `code-graph-mcp:*`) and your own prose survive
 - `/unadopt` removes the CLAUDE.md block + `.claude/` detail doc (your prose stays),
   and the local block. The next session writes a local file if the plugin never
   created one in this repository; one it created before is not written back (the
-  text is injected instead) until `claude-mem-lite adopt --enable`. Beside an
+  text is injected instead) until `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" adopt --enable`. Beside an
   `AGENTS.md` that `CLAUDE.local.md` would switch off, no file is written unless
   `CLAUDE_MEM_RULES_STEERING=1`.
-- `claude-mem-lite adopt --disable` permanently stops auto-adopt for this project
+- `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" adopt --disable` permanently stops auto-adopt for this project
   (also for sessions started in its subdirectories) and removes the local block; a
   `CLAUDE.md` block stays until `/unadopt`.
 - `MEM_NO_AUTO_ADOPT=1` disables auto-adopt globally; blocks already written stay.

package/commands/unadopt.md

@@ -43,10 +43,10 @@ project (slug-scoped — other plugins' blocks survive).
 
 `/unadopt` removes files, not the steering. A local block the plugin created is not
 written back; the text is added to each session's context instead
-(`claude-mem-lite adopt --enable` lets it write the file again). A project whose
+(`node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" adopt --enable` lets it write the file again). A project whose
 `CLAUDE.md` block you removed gets a local file on the next session, unless the
 plugin created one there before. Beside an `AGENTS.md` that `CLAUDE.local.md` would
-switch off, no file is written unless `CLAUDE_MEM_RULES_STEERING=1`. To stop the steering: `claude-mem-lite adopt --disable`
+switch off, no file is written unless `CLAUDE_MEM_RULES_STEERING=1`. To stop the steering: `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" adopt --disable`
 (per project) or `MEM_NO_AUTO_ADOPT=1` (global).
 
 ## Aftermath

package/commands/update.md

@@ -24,7 +24,7 @@ Run each command below via Bash; the CLI reaches the maintenance operations whet
 2. Report scan results to the user (duplicates, stale items, broken items, boostable items, **pending purge** items)
 3. **If pending purge items > 0**: first run the purge command below without `--confirm`: it prints how many rows it would delete and deletes nothing. If that count is 0, tell the user nothing is old enough to purge yet and go on to the next step. Otherwise report that count to the user and ask for confirmation. If confirmed, run `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" maintain execute --ops purge_stale --confirm`. **`--confirm` is required:** without it the command prints a dry-run preview and deletes nothing while still succeeding, so you would report a purge that never happened. User may optionally add `--retain-days N` (default 30, allowed range 7–365) to both runs to control how many days of data to keep; the CLI rejects a value outside that range, so tell the user instead of substituting the default. Do NOT purge without explicit user confirmation. The purge comes before the next step on purpose: decay there queues more rows for purge, and those wait for a later run instead of joining the purge the user approved.
 4. Run `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" maintain execute` to apply safe automatic changes — with no `--ops` it runs the default set: cleanup, decay, boost, then demote_pinned (left out when `CLAUDE_MEM_SKIP_DEMOTE_PINNED=1`)
-5. If duplicates were found in scan, review them and run `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" maintain execute --ops dedup --merge-ids keepId:removeId,...` — keep the more important/recent observation in each pair. Groups are comma-separated and the first id in each is kept (`10:11,20:21:22`). For pairs similar enough to merge without review the scan prints a ready-to-run command after `Ready-to-use:`; run it as printed
+5. If duplicates were found in scan, review them and run `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" maintain execute --ops dedup --merge-ids keepId:removeId,...` — keep the more important/recent observation in each pair. Groups are comma-separated and the first id in each is kept (`10:11,20:21:22`). For pairs similar enough to merge without review the scan prints a ready-to-run command after `Ready-to-use:`; run it as printed. Judge each pair under `Needs review:` from the two lines the scan prints below it; do not read them with `get`: that counts as an access and can raise a row's importance
 6. Run `node "${CLAUDE_PLUGIN_ROOT}/cli.mjs" compress --execute` for old low-value observations (without `--execute` it only previews)
 
 ### Phase 2: Summary

package/haiku-client.mjs

@@ -832,7 +832,11 @@ function claudeArgs(modelName) {
  * their output tokens and latency (measured above, 2026-09-29; the model the CLI ran then was
  * not recorded). Claude Code 2.1.301 does not change its request for Claude Haiku 5.5 on this
  * variable: the body carries adaptive thinking either way (D#334). Earlier versions were not
- * checked.
+ * checked. CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 drops Claude Code's auto-memory section, about 2.2 KB
+ * of every system prompt that tells the model about a memory directory these calls never use
+ * (stub-probed on 2.1.304: system 8,964 -> 6,688 B). The 2026-10-20 A/B on the cli leg, gate set
+ * before the run (D#483): usable 8/8, 8/8, 7/8 against the same without it; kept lessons 3 vs 4
+ * at n=8, inside floor(0.9 x 4).
  */
 function cliSpawnEnv() {
   return {
@@ -840,6 +844,7 @@ function cliSpawnEnv() {
     CLAUDE_MEM_HOOK_RUNNING: '1',
     DISABLE_CLAUDEMD_HOOKS: '1',
     MAX_THINKING_TOKENS: '0',
+    CLAUDE_CODE_DISABLE_AUTO_MEMORY: '1',
   };
 }
 

package/hook-llm.mjs

@@ -93,15 +93,19 @@ export function retractPreSavedObs(db, obsId, where) {
   // Both statements run in one transaction so a crash between them cannot leave that state
   // either; nesting under persistHaikuSummary's transaction is safe (better-sqlite3 uses
   // savepoints).
-  return db.transaction(() => {
-    const live = db.prepare(`SELECT 1 FROM observations WHERE id = ? AND ${liveObsFilterSql('')}`).get(obsId);
-    if (!live) {
-      debugLog('DEBUG', 'llm-episode', `${where}: pre-saved obs #${obsId} no longer live — left in place`);
-      return false;
-    }
-    recoverChildrenOf(db, [obsId]);
-    return db.prepare('DELETE FROM observations WHERE id = ?').run(obsId).changes > 0;
-  })();
+  return db
+    .transaction(() => {
+      const live = db
+        .prepare(`SELECT 1 FROM observations WHERE id = ? AND ${liveObsFilterSql('')}`)
+        .get(obsId);
+      if (!live) {
+        debugLog('DEBUG', 'llm-episode', `${where}: pre-saved obs #${obsId} no longer live — left in place`);
+        return false;
+      }
+      recoverChildrenOf(db, [obsId]);
+      return db.prepare('DELETE FROM observations WHERE id = ?').run(obsId).changes > 0;
+    })
+    .immediate();
 }
 // T9: memdir-incompatible types live in the `events` table, not `observations`.
 // Set lookup is O(1) — authoritative source is lib/activity.mjs::EVENT_TYPES.
@@ -544,13 +548,15 @@ export function persistHaikuSummary(db, summary, ctx) {
       });
 
     if (ctx.preSavedObsId) {
-      const id = db.transaction(() => {
-        // Same live-row guard as the in-place upgrade (FLOW-7); the event gets written
-        // either way. Shared helper since audit 2026-09-02 P0-6 — this was the only one
-        // of the three retraction sites that carried the guard.
-        retractPreSavedObs(db, ctx.preSavedObsId, 'upgrade-delete');
-        return insertEvent();
-      })();
+      const id = db
+        .transaction(() => {
+          // Same live-row guard as the in-place upgrade (FLOW-7); the event gets written
+          // either way. Shared helper since audit 2026-09-02 P0-6 — this was the only one
+          // of the three retraction sites that carried the guard.
+          retractPreSavedObs(db, ctx.preSavedObsId, 'upgrade-delete');
+          return insertEvent();
+        })
+        .immediate();
       return { table: 'events', id };
     }