total-recall-brain 3.41.0 → 3.41.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "total-recall-brain",
-  "version": "3.41.0",
+  "version": "3.41.1",
   "description": "The Vibe Coding Brain & Autonomous Software Factory: memory, rules, secrets, and 33 visual plugins automatically managed across all your devices.",
   "type": "module",
   "bin": {

package/scaffold/.agent/skills/meta-harness/references/optimized/original.md

@@ -23,7 +23,7 @@ Total Recall connects to every major IDE, CLI harness, and local neural runtime:
   - **Lovable**: Repository root `AGENTS.md` and `CLAUDE.md`.
   - **DeepSeek Harness (`dsh`)**: `.dsh/memory/MEMORY.md` and `AGENTS.md`.
   - **OpenClaw**: `SOUL.md`, `AGENTS.md`, `USER.md`, and `MEMORY.md`.
-  - **Hermes Agent**: `.hermes/memories/MEMORY.md`, `USER.md`, and `AGENTS.md`.
+  - **Hermes Agent**: `AGENTS.md` (loaded as a context file from the git root to cwd) and `.hermes/skills/`. `~/.hermes/memories/` is Hermes' own notes store and is never written.
   - **Cline**: `.clinerules/total-recall.md` and `.cline/skills/`.
   - **VS Code**: `.github/copilot-instructions.md` and `.vscode/copilot-instructions.md`.
 

package/src/cli/brain.mjs

@@ -16,6 +16,10 @@ function printHelp() {  console.log(`
     register <project-path>    Track any project path (full brain + registry)
     unregister <project-path>  Remove a project directory path from the registry
     ensure <project-path>      Ensure a full project brain layout + register
+    import <vault-dir> --to <project-path> [--dry-run]
+                               Import every memory node from another vault directory
+                               (an archive or a retired brain) into that project's
+                               brain through validated writes; existing slugs are kept
 
   Any repo works — pass absolute or relative paths you choose. No product defaults.
 
@@ -27,6 +31,7 @@ function printHelp() {  console.log(`
     npx total-recall brain off hermes-agent
     npx total-recall brain on global
     npx total-recall brain unregister /path/to/project
+    npx total-recall brain import ~/Archive/old-brain/memory-vault --to ~/code/my-lib
 
   Skill multi-repo sync: registered projects + TR_SYNC_REPOS + skill track/--repo
   `);
@@ -58,6 +63,9 @@ export default async function brain(args) {
     case 'ensure':
       await handleEnsure(args.slice(1), globalBrainDir);
       break;
+    case 'import':
+      await handleImport(args.slice(1));
+      break;
     case 'on':
     case 'off':
       await handleToggle(subcommand.toLowerCase() === 'on', args.slice(1), globalBrainDir);
@@ -104,11 +112,14 @@ async function handleEnsure(targetArgs, globalBrainDir) {
     tags: ['project-brain', 'full-brain'],
   });
   const health = inspectProjectBrain(abs);
+  const { ensureProjectGitignore } = await import('./init.mjs');
+  const ignored = ensureProjectGitignore(abs);
   console.log(`\n  ✅ Full project brain ready`);
   console.log(`     Repo:  ${result.repoRoot}`);
   console.log(`     Brain: ${result.brainDir}`);
   console.log(`     complete=${health.complete} full_brain=${health.full_brain}`);
   console.log(`     directories created +${result.dirs_created}`);
+  if (ignored.length) console.log(`     .gitignore +${ignored.length} brain-state exclusions`);
   console.log('');
 }
 
@@ -224,6 +235,11 @@ async function handleRegister(registryPath, targetArgs) {
       register: true,
     });
     console.log(`  ✅ Full project brain ready at ${path.join(absoluteRoot, '.agent', 'skills', 'total-recall')}`);
+    // A registered repo carries a brain whose config holds a live PAT; keep it
+    // out of git the same way `init --project` does.
+    const { ensureProjectGitignore } = await import('./init.mjs');
+    const ignored = ensureProjectGitignore(absoluteRoot);
+    if (ignored.length) console.log(`  ✅ .gitignore +${ignored.length} brain-state exclusions`);
   } catch (err) {
     console.error(`  ⚠️  Could not fully provision brain layout: ${err.message}`);
     process.exitCode = 1;
@@ -300,6 +316,58 @@ async function handleUnregister(registryPath, targetArgs) {
   console.log(`  ✅ Successfully unregistered project: "${absoluteRoot}"`);
 }
 
+/**
+ * Import memory nodes from a vault directory into a project's brain.
+ *
+ * The source is read, never written: an archived brain, or the vault of a brain
+ * being retired. Every node goes through the validated SSSS write path at the
+ * same vault-relative path, so the target's event log records each one. A slug
+ * the target already holds is left alone, which makes a rerun safe.
+ */
+async function handleImport(targetArgs) {
+  const toIdx = targetArgs.indexOf('--to');
+  const source = targetArgs.find((a, i) => !a.startsWith('-') && i !== toIdx + 1);
+  const target = toIdx !== -1 ? targetArgs[toIdx + 1] : null;
+  const dryRun = targetArgs.includes('--dry-run');
+  if (!source || !target) {
+    console.error('  ⚠️  Usage: npx total-recall brain import <vault-dir> --to <project-path> [--dry-run]');
+    process.exit(1);
+  }
+  const sourceDir = path.resolve(source);
+  const projectRoot = path.resolve(target);
+  if (!fs.existsSync(sourceDir) || !fs.statSync(sourceDir).isDirectory()) {
+    console.error(`  ⚠️  Source vault not found: ${sourceDir}`);
+    process.exit(1);
+  }
+  const vaultDir = path.join(projectRoot, '.agent', 'skills', 'total-recall', 'memory-vault');
+  if (!fs.existsSync(vaultDir)) {
+    console.error(`  ⚠️  No project brain at ${projectRoot}. Run: npx total-recall brain register ${projectRoot}`);
+    process.exit(1);
+  }
+  if (path.resolve(sourceDir) === path.resolve(vaultDir)) {
+    console.error('  ⚠️  Source and target are the same vault.');
+    process.exit(1);
+  }
+  const { loadNodes } = await import('../core/vault.mjs');
+  const { writeNodeValidatedAsync } = await import('../core/validated-write.mjs');
+  const existing = new Set(loadNodes(vaultDir).map(n => n.slug));
+  let imported = 0, skipped = 0;
+  const failed = [];
+  for (const node of loadNodes(sourceDir)) {
+    if (existing.has(node.slug)) { skipped++; continue; }
+    const rel = path.relative(sourceDir, node._filePath).split(path.sep).join('/');
+    if (dryRun) { imported++; continue; }
+    const { _filePath, _filepath, ...clean } = node;
+    const result = await writeNodeValidatedAsync(clean, vaultDir, { path: rel });
+    if (result.success) { imported++; existing.add(node.slug); }
+    else failed.push(`${rel}: ${result.validation?.errors?.join('; ') || result.error}`);
+  }
+  const verb = dryRun ? 'Would import' : 'Imported';
+  console.log(`  ${failed.length ? '⚠️ ' : '✅'} ${verb} ${imported} node(s) into ${vaultDir}; ${skipped} already present`);
+  for (const line of failed) console.error(`     ✗ ${line}`);
+  if (failed.length) process.exitCode = 1;
+}
+
 function countMdFiles(dir) {
   if (!fs.existsSync(dir)) return 0;
   let count = 0;

package/src/cli/connect.mjs

@@ -25,16 +25,20 @@ export const CLIENTS = {
   },
   hermes: {
     label: 'Hermes Agent',
-    mode: 'hermes',
-    memoryPath: path.join(os.homedir(), '.hermes', 'memories', 'MEMORY.md'),
-    userPath:   path.join(os.homedir(), '.hermes', 'memories', 'USER.md'),
+    mode: 'symlink',
+    // Hermes loads the AGENTS.md chain (git root to cwd) as context files.
+    // ~/.hermes/memories/MEMORY.md is the agent's own notes store, read only
+    // from HERMES_HOME; Total Recall never writes it.
+    target: 'AGENTS.md',
     skillsProjection: { scope: 'project', dir: path.join('.hermes', 'skills') }
   },
   'hermes-agent': {
     label: 'Hermes Agent',
-    mode: 'hermes',
-    memoryPath: path.join(os.homedir(), '.hermes', 'memories', 'MEMORY.md'),
-    userPath:   path.join(os.homedir(), '.hermes', 'memories', 'USER.md'),
+    mode: 'symlink',
+    // Hermes loads the AGENTS.md chain (git root to cwd) as context files.
+    // ~/.hermes/memories/MEMORY.md is the agent's own notes store, read only
+    // from HERMES_HOME; Total Recall never writes it.
+    target: 'AGENTS.md',
     skillsProjection: { scope: 'project', dir: path.join('.hermes', 'skills') }
   },
   dsh: {
@@ -884,39 +888,6 @@ export default async function connect(args) {
       result.projection = { targetPath, action: 'symlinked' };
     }
     result.notes.push(`  ~/.pi/agent/AGENTS.md → ${instructionsPath}`);
-  } else if (preset.mode === 'hermes') {
-    // Hermes: write compiled MEMORY.md to ~/.hermes/memories/MEMORY.md (max 2200 chars)
-    // and project-local .hermes/memories/MEMORY.md if inside a project workspace
-    const instructions = readInstructions(cwd, agentDir);
-    if (!instructions) throw new Error('No INSTRUCTIONS.md found. Run npx total-recall init or compile first.');
-    const homeDir = process.env.HOME || os.homedir();
-    const globalMemPath = path.join(homeDir, '.hermes', 'memories', 'MEMORY.md');
-    const capped = instructions.slice(0, 2200);
-
-    let wroteGlobal = false;
-    try {
-      fs.mkdirSync(path.dirname(globalMemPath), { recursive: true });
-      fs.writeFileSync(globalMemPath, capped, 'utf8');
-      wroteGlobal = true;
-    } catch {
-      // Gracefully continue if global directory is unwritable in sandbox
-    }
-
-    let localMemPath = null;
-    if (!isHome) {
-      localMemPath = path.join(cwd, '.hermes', 'memories', 'MEMORY.md');
-      fs.mkdirSync(path.dirname(localMemPath), { recursive: true });
-      fs.writeFileSync(localMemPath, capped, 'utf8');
-    }
-
-    result.projection = { targetPath: localMemPath || globalMemPath, action: 'written' };
-    if (wroteGlobal) {
-      result.notes.push(`  Hermes MEMORY.md (${capped.length} chars) → ${globalMemPath}`);
-    }
-    if (localMemPath) {
-      result.notes.push(`  Hermes local MEMORY.md → ${localMemPath}`);
-    }
-    result.notes.push('  Note: Hermes has a 2,200-char limit on MEMORY.md. Total Recall auto-caps this.');
   } else if (preset.mode === 'dsh') {
     // DeepSeek Harness: write global ~/.dsh/memory/MEMORY.md and symlink project AGENTS.md
     const instructions = readInstructions(cwd, agentDir);

package/src/core/surface.mjs

@@ -567,8 +567,8 @@ const CLIENT_SHIMS = {
   vscode:             ['.github/copilot-instructions.md', '.vscode/copilot-instructions.md'],
   githubCopilot:      ['.github/copilot-instructions.md'],
   pi:                 ['AGENTS.md'],
-  hermes:             ['.hermes/memories/MEMORY.md'],
-  'hermes-agent':     ['.hermes/memories/MEMORY.md'],
+  hermes:             ['AGENTS.md'],
+  'hermes-agent':     ['AGENTS.md'],
   dsh:                ['AGENTS.md'],
   'deepseek-harness': ['AGENTS.md'],
   openclaw:           ['MEMORY.md', 'AGENTS.md']