specmem-hardwicksoftware 3.7.32 → 3.7.33

package/dist/mcp/compactionProxyDaemon.js

@@ -26,6 +26,9 @@ import {
   handleRequest,
   log,
   togglePause,
+  setPaused,
+  startReaper,
+  hasLiveProjects,
   PROXY_PORT,
   PORT_FILE,
   PID_FILE,
@@ -37,9 +40,9 @@ import {
 // Precondition checks
 // ============================================================================
 
-if (existsSync(DISABLED_FILE)) {
-  process.exit(0);
-}
+// If disabled, start in paused (passthrough) mode instead of exiting.
+// The proxy must always be in the request path for seamless on/off toggling.
+const startPaused = existsSync(DISABLED_FILE);
 
 // ============================================================================
 // Port collision check
@@ -73,6 +76,9 @@ const KYS_IDLE_THRESHOLD = 120000;  // 2 minutes without Claude → exit
 const KYS_GRACE_PERIOD = 60000;     // 60s grace after startup
 
 function isClaudeAlive() {
+  // Check registry first — much cheaper than pgrep
+  if (hasLiveProjects()) return true;
+  // Fallback to pgrep for cases where MCP didn't register (old versions)
   try {
     const result = execSync(
       'pgrep -f "claude" 2>/dev/null',
@@ -122,7 +128,15 @@ async function main() {
   server.listen(PROXY_PORT, '127.0.0.1', () => {
     // Write port file on successful bind — MCP and bashrc use this to find us
     writeFileSync(PORT_FILE, String(PROXY_PORT), { mode: 0o644 });
-    log('info', `Daemon started: PID=${process.pid} port=${PROXY_PORT}`);
+    // If disabled flag existed at startup, start in passthrough mode
+    if (startPaused) {
+      setPaused(true);
+      log('info', `Daemon started in PASSTHROUGH mode (disabled flag): PID=${process.pid} port=${PROXY_PORT}`);
+    } else {
+      log('info', `Daemon started: PID=${process.pid} port=${PROXY_PORT}`);
+    }
+    // Start the stale project reaper
+    startReaper();
   });
 
   // --- Signal handlers ---

package/dist/mcp/specMemServer.js

@@ -2072,6 +2072,14 @@ export class SpecMemServer {
         catch (err) {
             logger.warn({ error: err }, 'Error closing MCP server');
         }
+        // Step 6.5: Deregister from compaction proxy daemon
+        try {
+            stopCompactionProxy();
+            logger.debug('Compaction proxy deregistered');
+        }
+        catch (err) {
+            logger.debug({ error: err }, 'Could not deregister from compaction proxy');
+        }
         // FIX 6.10 + CRIT-2: unhandledRejection/uncaughtException use once() so auto-remove.
         // Only remove SIGINT/SIGTERM/SIGHUP which may still be registered.
         if (this._processHandlers) {

package/dist/watcher/index.js

@@ -30,6 +30,7 @@ export class WatcherManager {
     syncInProgress = false;
     syncTimeout = null;
     lastLowScoreResyncAt = 0;
+    lastLowScoreResyncScore = null; // track score at last resync to detect drops
     constructor(config) {
         // Create handler first - it's the core component
         this.handler = new AutoUpdateTheMemories(config.handler);
@@ -120,21 +121,34 @@ export class WatcherManager {
                 logger.debug('periodic sync: indexing pending, skipping resync');
                 return;
             }
-            // Low-score trigger: if score drops below threshold, force resync w/ debounce
+            // Low-score trigger: only force resync if score DROPPED by >=10% since last resync
+            // This prevents infinite resync loops when score is stuck below threshold
             const LOW_SCORE_THRESHOLD = parseFloat(process.env['SPECMEM_LOW_SCORE_THRESHOLD'] || '0.85');
+            const LOW_SCORE_DROP_THRESHOLD = parseFloat(process.env['SPECMEM_LOW_SCORE_DROP_THRESHOLD'] || '0.10');
             const LOW_SCORE_DEBOUNCE_MS = parseInt(process.env['SPECMEM_LOW_SCORE_DEBOUNCE_MS'] || String(15 * 60 * 1000), 10);
             if (report.syncScore < LOW_SCORE_THRESHOLD) {
+                // First time seeing low score — always resync
+                // After that, only resync if score dropped by >=10% from the post-resync score
+                const scoreDrop = this.lastLowScoreResyncScore !== null
+                    ? this.lastLowScoreResyncScore - report.syncScore
+                    : Infinity; // first time = always trigger
+                if (scoreDrop < LOW_SCORE_DROP_THRESHOLD) {
+                    logger.warn({ syncScore: report.syncScore, lastResyncScore: this.lastLowScoreResyncScore, scoreDrop }, 'sync score below threshold but has not dropped by >=10% since last resync — skipping');
+                    return;
+                }
                 const now = Date.now();
                 const debounceRemaining = LOW_SCORE_DEBOUNCE_MS - (now - this.lastLowScoreResyncAt);
                 if (debounceRemaining > 0) {
                     logger.warn({ syncScore: report.syncScore, debounceRemainingSec: Math.round(debounceRemaining / 1000) }, 'sync score below threshold but debounce active — skipping forced resync');
                 } else {
                     this.lastLowScoreResyncAt = now;
-                    logger.warn({ syncScore: report.syncScore, threshold: LOW_SCORE_THRESHOLD }, 'sync score below threshold — forcing resync');
+                    logger.warn({ syncScore: report.syncScore, threshold: LOW_SCORE_THRESHOLD, scoreDrop }, 'sync score below threshold with >=10% drop — forcing resync');
                     const resyncResult = await this.syncChecker.resyncEverythingFrFr();
                     logger.info({ filesAdded: resyncResult.filesAdded, filesUpdated: resyncResult.filesUpdated, errors: resyncResult.errors.length }, 'low-score forced resync complete');
                     const postReport = await this.syncChecker.checkSync();
                     await this.writeSyncScore(postReport.syncScore);
+                    // Track the post-resync score so we can detect future drops
+                    this.lastLowScoreResyncScore = postReport.syncScore;
                 }
                 return;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specmem-hardwicksoftware",
-  "version": "3.7.32",
+  "version": "3.7.33",
   "type": "module",
   "description": "Your Claude Code sessions don't have to start from scratch anymore — SpecMem gives your AI real memory. It won't forget your conversations, your code, or your architecture decisions between sessions. That's the whole point. Semantic code indexing that actually works: TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, C, C++, HTML and more. It doesn't just track functions — it gets classes, methods, fields, constants, enums, macros, imports, structs, the whole codebase graph. There's chat memory too, powered by pgvector embeddings. You've also got token compression, team coordination, multi-agent comms, and file watching built in. 74+ MCP tools. Runs on PostgreSQL + Docker. It's kind of a big deal. justcalljon.pro",
   "main": "dist/index.js",

package/scripts/deploy-hooks.cjs

@@ -1014,7 +1014,10 @@ function configureMCP() {
     console.log(`${C.dim}Backed up to ${backupPath}${C.reset}`);
   }
 
-  fs.writeFileSync(CLAUDE_JSON, JSON.stringify(claudeJson, null, 2));
+  // ATOMIC WRITE: write to temp then rename to prevent corruption
+  const tmpClaudePath = CLAUDE_JSON + '.tmp.' + process.pid;
+  fs.writeFileSync(tmpClaudePath, JSON.stringify(claudeJson, null, 2));
+  fs.renameSync(tmpClaudePath, CLAUDE_JSON);
   console.log(`${C.green}✓${C.reset} Configured MCP server: specmem for project ${PROJECT_PATH}`);
 
   // ACK verification - re-read and verify

package/scripts/specmem-init.cjs

@@ -1292,53 +1292,50 @@ fi
   }
 
   // ── Step 3b: Add ANTHROPIC_BASE_URL proxy routing to bashrc ─────────────
-  // Routes Claude Code API calls through the SpecMem compaction proxy for
-  // automatic token compression (40-80% savings). Reads port from the port
-  // file written by the proxy on startup. Only activates if proxy has run.
+  // Always routes Claude Code API calls through the compaction proxy.
+  // Proxy runs in passthrough mode when disabled — seamless on/off toggling.
   // Does NOT touch ANTHROPIC_API_KEY — only sets the base URL.
   const proxyMarker = '# specmem-proxy-env';
+  const defaultProxyPort = process.env.COMPACTION_PROXY_PORT || '4080';
   let hasProxyFix = false;
   try {
     if (fs.existsSync(bashrcPath)) {
       const currentBashrc = fs.readFileSync(bashrcPath, 'utf8');
       hasProxyFix = currentBashrc.includes(proxyMarker);
+      // If old conditional version exists, replace it with the unconditional one
+      if (hasProxyFix && currentBashrc.includes('.compaction-proxy-port')) {
+        const cleaned = currentBashrc.replace(/\n?# specmem-proxy-env\n(?:# [^\n]*\n)*if \[ -f "\$HOME\/\.claude\/\.compaction-proxy-port" \];[\s\S]*?fi\n?/g, '');
+        fs.writeFileSync(bashrcPath, cleaned);
+        hasProxyFix = false; // Will re-add the new version below
+        initLog('Replaced old conditional proxy bashrc block with unconditional version');
+      }
     }
   } catch (e) { /* no .bashrc */ }
 
   if (!hasProxyFix) {
     const proxyFix = `
 ${proxyMarker}
-# SpecMem: Route Claude Code API calls through compaction proxy for token savings
-# Reads port from proxy port file — only activates if proxy has been started
-if [ -f "$HOME/.claude/.compaction-proxy-port" ]; then
-  _specmem_proxy_port="$(cat "$HOME/.claude/.compaction-proxy-port" 2>/dev/null)"
-  if [ -n "$_specmem_proxy_port" ]; then
-    export ANTHROPIC_BASE_URL="http://127.0.0.1:$_specmem_proxy_port"
-  fi
-  unset _specmem_proxy_port
-fi
+# SpecMem: Always route API calls through compaction proxy (passthrough when disabled)
+export ANTHROPIC_BASE_URL="http://127.0.0.1:\${COMPACTION_PROXY_PORT:-${defaultProxyPort}}"
 `;
     try {
       fs.appendFileSync(bashrcPath, proxyFix);
       result.proxyEnvFixed = true;
       result.fixed = true;
-      initLog('Added ANTHROPIC_BASE_URL proxy routing to .bashrc');
+      initLog('Added unconditional ANTHROPIC_BASE_URL proxy routing to .bashrc');
     } catch (e) {
       initLog('Failed to write .bashrc proxy fix', e);
     }
   }
 
-  // Also set for current session if port file exists
-  try {
-    const portFile = path.join(homeDir, '.claude', '.compaction-proxy-port');
-    if (fs.existsSync(portFile)) {
-      const port = fs.readFileSync(portFile, 'utf8').trim();
-      if (port && !process.env.ANTHROPIC_BASE_URL) {
-        process.env.ANTHROPIC_BASE_URL = `http://127.0.0.1:${port}`;
-        initLog(`Set ANTHROPIC_BASE_URL=http://127.0.0.1:${port} for current session`);
-      }
+  // Always set for current session — proxy is always in the path
+  {
+    const proxyUrl = `http://127.0.0.1:${defaultProxyPort}`;
+    if (process.env.ANTHROPIC_BASE_URL !== proxyUrl) {
+      process.env.ANTHROPIC_BASE_URL = proxyUrl;
+      initLog(`Set ANTHROPIC_BASE_URL=${proxyUrl} for current session`);
     }
-  } catch (e) { /* non-fatal */ }
+  }
 
   // ── Step 4: Set TERM for current session ────────────────────────────────
   if (result.needed && !term.includes('256color')) {
@@ -7266,16 +7263,9 @@ async function launchScreenSessions(projectPath, ui) {
       // Uses screen hardcopy to tmpfs on-demand instead of continuous logging
       // -h 5000 sets scrollback buffer to 5000 lines for hardcopy capture
       const claudeBin = getClaudeBinary();
-      // FIX: Set ANTHROPIC_BASE_URL for compaction proxy routing.
-      // bash -c is non-interactive so .bashrc isn't sourced — read port file directly.
-      const portFile = path.join(os.homedir(), '.claude', '.compaction-proxy-port');
-      let proxyEnv = '';
-      try {
-        if (fs.existsSync(portFile)) {
-          const port = fs.readFileSync(portFile, 'utf8').trim();
-          if (port) proxyEnv = `ANTHROPIC_BASE_URL="http://127.0.0.1:${port}" `;
-        }
-      } catch (e) { /* non-fatal */ }
+      // Always set ANTHROPIC_BASE_URL — proxy runs in passthrough mode when disabled
+      const proxyPort = process.env.COMPACTION_PROXY_PORT || '4080';
+      const proxyEnv = `ANTHROPIC_BASE_URL="http://127.0.0.1:${proxyPort}" `;
       execSync(`screen -h 5000 -dmS ${claudeSession} bash -c 'cd "${projectPath}" && ${proxyEnv}SPECMEM_DASHBOARD=1 "${claudeBin}" 2>&1; exec bash'`, { stdio: 'ignore' });
       await sleep(300);
 
@@ -8843,7 +8833,10 @@ CREATE INDEX IF NOT EXISTS idx_embedding_queue_project ON embedding_queue (proje
       };
       claudeJson.projects[projectPath].hasTrustDialogAccepted = true;
 
-      fs.writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2));
+      // ATOMIC WRITE: write to temp then rename to prevent corruption
+      const tmpPath1 = claudeJsonPath + '.tmp.' + process.pid;
+      fs.writeFileSync(tmpPath1, JSON.stringify(claudeJson, null, 2));
+      fs.renameSync(tmpPath1, claudeJsonPath);
       initLog('[SETUP] ✓ MCP server configured in ~/.claude.json for ' + projectPath);
     } catch (e) {
       initLog('[SETUP] ⚠ Failed to configure MCP in .claude.json: ' + e.message);
@@ -10555,7 +10548,10 @@ priority=999
             };
             claudeJson.projects[projectPath].hasTrustDialogAccepted = true;
 
-            fs.writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2));
+            // ATOMIC WRITE: write to temp then rename to prevent corruption
+            const tmpPath2 = claudeJsonPath + '.tmp.' + process.pid;
+            fs.writeFileSync(tmpPath2, JSON.stringify(claudeJson, null, 2));
+            fs.renameSync(tmpPath2, claudeJsonPath);
             initLog('[CONTAINER] ✓ MCP server configured in ~/.claude.json for ' + projectPath);
             ui.setStatus('MCP configured');
 

package/scripts/specmem-uninstall.cjs

@@ -119,7 +119,10 @@ function cleanClaudeConfigs() {
       if (changed) {
         const backup = claudeJsonPath + '.pre-uninstall.' + Date.now();
         fs.copyFileSync(claudeJsonPath, backup);
-        fs.writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2));
+        // ATOMIC WRITE: write to temp then rename to prevent corruption
+        const tmpPath = claudeJsonPath + '.tmp.' + process.pid;
+        fs.writeFileSync(tmpPath, JSON.stringify(claudeJson, null, 2));
+        fs.renameSync(tmpPath, claudeJsonPath);
         console.log(`  ${c.green}✓${c.reset} Removed SpecMem MCP server from .claude.json`);
         console.log(`  ${c.dim}  Backup: ${backup}${c.reset}`);
       }

package/specmem/model-config.json

@@ -35,12 +35,12 @@
   },
   "resources": {
     "cpuMin": 10,
-    "cpuMax": 45,
+    "cpuMax": 30,
     "cpuCoreMin": 1,
     "cpuCoreMax": 4,
     "ramMinMb": 4000,
     "ramMaxMb": 15000,
-    "updatedAt": "2026-02-24T19:22:11.693Z"
+    "updatedAt": "2026-02-24T20:01:48.721Z"
   },
   "resourcePool": {
     "embedding": {
@@ -95,7 +95,7 @@
   },
   "heavyOps": {
     "enabled": true,
-    "enabledAt": "2026-02-24T11:57:35.508Z",
+    "enabledAt": "2026-02-26T14:18:50.747Z",
     "originalBatchSize": 32,
     "batchSizeMultiplier": 2,
     "throttleReduction": 0.2

package/specmem/supervisord.conf

@@ -1,6 +1,6 @@
 ; ============================================
 ; SPECMEM BRAIN CONTAINER - DYNAMIC SUPERVISORD CONFIG
-; Generated by specmem-init at 2026-02-24T19:19:59.260Z
+; Generated by specmem-init at 2026-02-26T14:42:59.603Z
 ; Thread counts from model-config.json resourcePool
 ; ============================================
 

package/svg-sections/readme-install.svg

@@ -1,82 +1,118 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 700 240" width="700" height="240">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 420" width="800" height="420">
   <defs>
-    <linearGradient id="termBg" x1="0%" y1="0%" x2="100%" y2="100%">
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
       <stop offset="0%" style="stop-color:#0d1117"/>
       <stop offset="100%" style="stop-color:#161b22"/>
     </linearGradient>
-    <linearGradient id="accentGradient" x1="0%" y1="0%" x2="100%" y2="0%">
+    <linearGradient id="cardGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1c2128;stop-opacity:0.9"/>
+      <stop offset="100%" style="stop-color:#21262d;stop-opacity:0.85"/>
+    </linearGradient>
+    <linearGradient id="titleGrad" x1="0%" y1="0%" x2="100%" y2="0%">
       <stop offset="0%" style="stop-color:#00bfff"/>
-      <stop offset="100%" style="stop-color:#a855f7"/>
+      <stop offset="50%" style="stop-color:#a855f7"/>
+      <stop offset="100%" style="stop-color:#00bfff"/>
     </linearGradient>
-    <linearGradient id="stepGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+    <linearGradient id="cyanPurple" x1="0%" y1="0%" x2="100%" y2="0%">
       <stop offset="0%" style="stop-color:#00bfff"/>
       <stop offset="100%" style="stop-color:#a855f7"/>
     </linearGradient>
-    <filter id="checkGlow" x="-50%" y="-50%" width="200%" height="200%">
-      <feGaussianBlur in="SourceAlpha" stdDeviation="3" result="blur"/>
-      <feFlood flood-color="#22c55e" flood-opacity="0.6"/>
-      <feComposite in2="blur" operator="in"/>
-      <feMerge><feMergeNode/><feMergeNode in="SourceGraphic"/></feMerge>
-    </filter>
-    <filter id="stepGlow" x="-50%" y="-50%" width="200%" height="200%">
-      <feGaussianBlur in="SourceAlpha" stdDeviation="2" result="blur"/>
-      <feFlood flood-color="#00bfff" flood-opacity="0.3"/>
-      <feComposite in2="blur" operator="in"/>
-      <feMerge><feMergeNode/><feMergeNode in="SourceGraphic"/></feMerge>
-    </filter>
+    <linearGradient id="greenGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#22c55e"/>
+      <stop offset="100%" style="stop-color:#4ade80"/>
+    </linearGradient>
   </defs>
 
-  <rect width="700" height="240" rx="12" ry="12" fill="url(#termBg)"/>
-  <rect width="700" height="240" rx="12" ry="12" fill="none" stroke="url(#accentGradient)" stroke-width="1" stroke-opacity="0.3"/>
+  <!-- Background -->
+  <rect width="800" height="420" rx="16" ry="16" fill="url(#bgGrad)"/>
+  <rect width="800" height="420" rx="16" ry="16" fill="none" stroke="url(#cyanPurple)" stroke-width="1" stroke-opacity="0.25"/>
 
-  <text x="350" y="30" text-anchor="middle" font-family="system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" font-size="15" font-weight="700" fill="#f5f5f5">Quick Install</text>
-
-  <!-- Connecting line -->
-  <line x1="50" y1="78" x2="50" y2="168" stroke="#2d333b" stroke-width="2" stroke-dasharray="4,4"/>
+  <!-- Title -->
+  <text x="400" y="38" text-anchor="middle" font-family="system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" font-size="22" font-weight="700" fill="url(#titleGrad)">Quick Install</text>
+  <text x="400" y="60" text-anchor="middle" font-family="system-ui, sans-serif" font-size="12" fill="#8b949e">3 steps. No root required. Works on Debian, Ubuntu, Mint, Kali.</text>
 
   <!-- Step 1 -->
-  <g transform="translate(30, 48)">
-    <circle cx="20" cy="20" r="13" fill="none" stroke="url(#stepGradient)" stroke-width="2" filter="url(#stepGlow)"/>
-    <text x="20" y="25" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" font-weight="700" fill="#00bfff">1</text>
-    <rect x="44" y="3" width="618" height="34" rx="6" ry="6" fill="#1a1f26"/>
-    <text x="57" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
-    <text x="72" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13">
+  <g transform="translate(30, 78)">
+    <rect width="740" height="72" rx="12" fill="url(#cardGrad)" stroke="#30363d" stroke-width="1"/>
+    <rect width="740" height="3" rx="1.5" fill="url(#cyanPurple)"/>
+    <!-- Step badge -->
+    <circle cx="36" cy="42" r="16" fill="none" stroke="#00bfff" stroke-width="1.5" stroke-opacity="0.6"/>
+    <text x="36" y="47" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="700" fill="#00bfff">1</text>
+    <!-- Command -->
+    <rect x="64" y="20" width="660" height="32" rx="6" fill="#0d1117" stroke="#21262d" stroke-width="1"/>
+    <text x="78" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
+    <text x="94" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13">
       <tspan fill="#ff7b72">npm</tspan>
-      <tspan fill="#f5f5f5"> install </tspan>
+      <tspan fill="#e6edf3"> install </tspan>
       <tspan fill="#ffa657">-g</tspan>
-      <tspan fill="#f5f5f5"> specmem-hardwicksoftware</tspan>
+      <tspan fill="#e6edf3"> specmem-hardwicksoftware</tspan>
     </text>
+    <text x="64" y="65" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">Install globally from npm</text>
   </g>
 
+  <!-- Connector line -->
+  <line x1="66" y1="150" x2="66" y2="168" stroke="#30363d" stroke-width="2" stroke-dasharray="3,3"/>
+
   <!-- Step 2 -->
-  <g transform="translate(30, 96)">
-    <circle cx="20" cy="20" r="13" fill="none" stroke="url(#stepGradient)" stroke-width="2" filter="url(#stepGlow)"/>
-    <text x="20" y="25" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" font-weight="700" fill="#00bfff">2</text>
-    <rect x="44" y="3" width="618" height="34" rx="6" ry="6" fill="#1a1f26"/>
-    <text x="57" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
-    <text x="72" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13">
+  <g transform="translate(30, 168)">
+    <rect width="740" height="72" rx="12" fill="url(#cardGrad)" stroke="#30363d" stroke-width="1"/>
+    <rect width="740" height="3" rx="1.5" fill="url(#cyanPurple)"/>
+    <circle cx="36" cy="42" r="16" fill="none" stroke="#a855f7" stroke-width="1.5" stroke-opacity="0.6"/>
+    <text x="36" y="47" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="700" fill="#a855f7">2</text>
+    <rect x="64" y="20" width="660" height="32" rx="6" fill="#0d1117" stroke="#21262d" stroke-width="1"/>
+    <text x="78" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
+    <text x="94" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13">
       <tspan fill="#ff7b72">cd</tspan>
-      <tspan fill="#f5f5f5"> /your/project/directory</tspan>
+      <tspan fill="#e6edf3"> /your/project/directory</tspan>
     </text>
+    <text x="64" y="65" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">Navigate to your project root</text>
   </g>
 
+  <!-- Connector line -->
+  <line x1="66" y1="240" x2="66" y2="258" stroke="#30363d" stroke-width="2" stroke-dasharray="3,3"/>
+
   <!-- Step 3 -->
-  <g transform="translate(30, 144)">
-    <circle cx="20" cy="20" r="13" fill="none" stroke="url(#stepGradient)" stroke-width="2" filter="url(#stepGlow)"/>
-    <text x="20" y="25" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" font-weight="700" fill="#00bfff">3</text>
-    <rect x="44" y="3" width="618" height="34" rx="6" ry="6" fill="#1a1f26"/>
-    <text x="57" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
-    <text x="72" y="25" font-family="'SF Mono', 'Cascadia Code', 'Fira Code', Consolas, monospace" font-size="13">
-      <tspan fill="#ff7b72">specmem</tspan>
-      <tspan fill="#f5f5f5"> init</tspan>
+  <g transform="translate(30, 258)">
+    <rect width="740" height="72" rx="12" fill="url(#cardGrad)" stroke="#22c55e" stroke-width="1.5"/>
+    <rect width="740" height="3" rx="1.5" fill="url(#greenGrad)"/>
+    <circle cx="36" cy="42" r="16" fill="none" stroke="#22c55e" stroke-width="1.5" stroke-opacity="0.6"/>
+    <text x="36" y="47" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="700" fill="#4ade80">3</text>
+    <rect x="64" y="20" width="660" height="32" rx="6" fill="#0d1117" stroke="#21262d" stroke-width="1"/>
+    <text x="78" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13" fill="#6e7681">$</text>
+    <text x="94" y="40" font-family="'SF Mono', 'Fira Code', Consolas, monospace" font-size="13">
+      <tspan fill="#4ade80">specmem</tspan>
+      <tspan fill="#e6edf3"> init</tspan>
     </text>
+    <text x="64" y="65" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">One-time setup — models, DB, hooks, everything</text>
   </g>
 
-  <!-- Done -->
-  <g transform="translate(30, 192)">
-    <circle cx="20" cy="16" r="13" fill="#22c55e" fill-opacity="0.2" stroke="#22c55e" stroke-width="2" filter="url(#checkGlow)"/>
-    <path d="M13 16 L18 21 L28 11" fill="none" stroke="#22c55e" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
-    <text x="50" y="21" font-family="system-ui, sans-serif" font-size="13" font-weight="600" fill="#22c55e">Done.</text>
-    <text x="98" y="21" font-family="system-ui, sans-serif" font-size="12" fill="#8b949e">Claude now remembers your entire codebase across every session.</text>
-  </g>
+  <!-- Done bar -->
+  <rect x="30" y="350" width="740" height="52" rx="12" fill="#22c55e" fill-opacity="0.08" stroke="#22c55e" stroke-width="1" stroke-opacity="0.3"/>
+  <!-- Checkmark -->
+  <circle cx="66" cy="376" r="12" fill="none" stroke="#22c55e" stroke-width="2"/>
+  <path d="M60 376 L64 381 L74 370" fill="none" stroke="#4ade80" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="90" y="372" font-family="system-ui, sans-serif" font-size="13" font-weight="600" fill="#4ade80">Done.</text>
+  <text x="90" y="389" font-family="system-ui, sans-serif" font-size="11" fill="#6e7681">Claude now has full semantic memory of your codebase — persistent across every session.</text>
+
+  <!-- OS logos (right side of done bar) -->
+  <!-- Ubuntu circle pattern -->
+  <circle cx="600" cy="376" r="10" fill="none" stroke="#E95420" stroke-width="1.5"/>
+  <circle cx="600" cy="376" r="3" fill="#E95420"/>
+  <circle cx="600" cy="366" r="2" fill="#E95420"/>
+  <circle cx="591" cy="381" r="2" fill="#E95420"/>
+  <circle cx="609" cy="381" r="2" fill="#E95420"/>
+
+  <!-- Debian swirl (simplified) -->
+  <circle cx="630" cy="376" r="10" fill="none" stroke="#A80030" stroke-width="1.5"/>
+  <path d="M630 368 C636 368 638 374 634 379 C630 384 624 382 622 378" fill="none" stroke="#D70751" stroke-width="2" stroke-linecap="round"/>
+  <circle cx="630" cy="376" r="2" fill="#D70751"/>
+
+  <!-- Mint LM badge -->
+  <rect x="647" y="366" width="20" height="20" rx="5" fill="none" stroke="#87CF3E" stroke-width="1.5"/>
+  <text x="657" y="380" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" font-weight="700" fill="#87CF3E">LM</text>
+
+  <!-- Kali dragon shape (simplified) -->
+  <path d="M688 366 L696 374 L694 380 L700 388 L688 382 L676 388 L682 380 L680 374 Z" fill="none" stroke="#557C94" stroke-width="1.5" stroke-linejoin="round"/>
+
+  <text x="710" y="374" font-family="system-ui, sans-serif" font-size="9" fill="#484f58">+ more</text>
 </svg>