claude-mem-lite 2.32.8 → 2.33.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "2.32.8",
+      "version": "2.33.0",
       "source": "./",
       "description": "Lightweight persistent memory system for Claude Code — FTS5 search, episode batching, error-triggered recall"
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.32.8",
+  "version": "2.33.0",
   "description": "Lightweight persistent memory system for Claude Code — FTS5 search, episode batching, error-triggered recall",
   "author": {
     "name": "sdsrss"

package/adopt-cli.mjs

@@ -9,7 +9,7 @@
 // --dry-run = print intent without writing
 // --status = list all adopted projects + versions
 
-import { existsSync, readdirSync, statSync } from 'fs';
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 import {
@@ -121,6 +121,58 @@ function adoptOne(memdir, { force, dryRun, all }) {
   }
 }
 
+/**
+ * silentAutoAdopt — plugin-mode first-run auto-adopt helper (v2.33.0).
+ *
+ * Preconditions (caller must gate): CLAUDE_PLUGIN_ROOT set, MEM_NO_AUTO_ADOPT!=1,
+ * MEM_QUIET_HOOKS!=1, first-attempt marker absent. This helper does NOT re-check
+ * those — it only does the write + marker persistence.
+ *
+ * Behavior:
+ *   - Writes plugin sentinel + detail doc to the memdir for `cwd`.
+ *   - Writes a per-project first-attempt marker under `markerDir` so a later
+ *     `/unadopt` is respected (no re-adopt loop).
+ *   - Silent: never logs, never throws. Returns structured result.
+ *
+ * Returns { ok, action, reason } — caller uses for telemetry / debugLog only.
+ */
+export function silentAutoAdopt({ cwd, markerDir, markerKey }) {
+  const memdir = memdirPath(cwd);
+  try {
+    if (isAdopted(memdir, PLUGIN_SLUG)) {
+      writeMarker(markerDir, markerKey);
+      return { ok: true, action: 'already-adopted' };
+    }
+    writePluginSection(memdir, {
+      slug: PLUGIN_SLUG,
+      version: CURRENT_SENTINEL_VERSION,
+      contentLine: getIndexLine(),
+      force: false,
+    });
+    writePluginDoc(memdir, PLUGIN_SLUG, getDetailDoc());
+    writeMarker(markerDir, markerKey);
+    return { ok: true, action: 'adopted' };
+  } catch (e) {
+    // Budget exceeded, user-edited conflict, or FS error — write marker so we
+    // don't retry on every SessionStart. User can run /adopt --force manually.
+    try { writeMarker(markerDir, markerKey); } catch { /* marker best-effort */ }
+    const reason = e instanceof UserEditedError ? 'user-edited'
+      : e instanceof BudgetExceededError ? 'budget-exceeded'
+      : 'error';
+    return { ok: false, action: 'skipped', reason, err: e };
+  }
+}
+
+function writeMarker(markerDir, markerKey) {
+  if (!existsSync(markerDir)) mkdirSync(markerDir, { recursive: true });
+  const path = join(markerDir, `.auto-adopt-${markerKey}`);
+  writeFileSync(path, JSON.stringify({ firstAttemptAt: new Date().toISOString() }));
+}
+
+export function hasAutoAdoptMarker(markerDir, markerKey) {
+  return existsSync(join(markerDir, `.auto-adopt-${markerKey}`));
+}
+
 function statusAll() {
   const dirs = listAllMemdirs();
   log('[adopt --status] scanning ~/.claude/projects/*/memory/');

package/hook.mjs

@@ -32,6 +32,7 @@ import { searchRelevantMemories } from './hook-memory.mjs';
 import { buildAndSaveHandoff, detectContinuationIntent, renderHandoffInjection, extractUnfinishedSummary } from './hook-handoff.mjs';
 import { checkForUpdate } from './hook-update.mjs';
 import { handleLLMOptimize } from './hook-optimize.mjs';
+import { silentAutoAdopt, hasAutoAdoptMarker } from './adopt-cli.mjs';
 // plugin-cache-guard.mjs loaded dynamically — pre-2.31.2 installs that auto-upgraded
 // from an older hook-update.mjs SOURCE_FILES (which did not list this module) would
 // crash on static import. Degrade gracefully to no-op when the module is absent.
@@ -425,6 +426,35 @@ async function handleSessionStart() {
     }
   } catch (e) { debugCatch(e, 'session-start-cache-heal'); }
 
+  // v2.33.0: plugin-mode first-run auto-adopt. /plugin install IS consent to
+  // integration — writing the MEMORY.md sentinel once per project on first
+  // SessionStart avoids the opt-in friction. Scope is narrow:
+  //   - gated by CLAUDE_PLUGIN_ROOT (npm/npx installs stay opt-in)
+  //   - gated by !MEM_NO_AUTO_ADOPT (explicit escape hatch)
+  //   - gated by !MEM_QUIET_HOOKS (quiet = no side-effects semantics)
+  //   - first-attempt marker persists in RUNTIME_DIR so a subsequent /unadopt
+  //     is respected (no re-adopt loop).
+  // Failures (user-edited sentinel, budget exceeded, FS errors) are swallowed;
+  // the marker is still written so we don't retry on every SessionStart.
+  try {
+    if (
+      process.env.CLAUDE_PLUGIN_ROOT
+      && process.env.MEM_NO_AUTO_ADOPT !== '1'
+      && process.env.MEM_QUIET_HOOKS !== '1'
+    ) {
+      const project = inferProject();
+      if (!hasAutoAdoptMarker(RUNTIME_DIR, project)) {
+        const cwd = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+        const r = silentAutoAdopt({ cwd, markerDir: RUNTIME_DIR, markerKey: project });
+        if (r.ok) {
+          debugLog('DEBUG', 'session-start-auto-adopt', `action=${r.action} project=${project}`);
+        } else {
+          debugLog('DEBUG', 'session-start-auto-adopt', `skipped project=${project} reason=${r.reason}`);
+        }
+      }
+    }
+  } catch (e) { debugCatch(e, 'session-start-auto-adopt'); }
+
   // Read CC real session_id from hook stdin — used to scope handoff rows so parallel
   // sessions for the same project don't clobber each other (see docs/bug.txt).
   let ccSessionId = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.32.8",
+  "version": "2.33.0",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {