total-recall-brain 3.41.0 → 3.41.2

package/scaffold/.agent/skills/total-recall/plugins/openwiki/README.md

@@ -14,8 +14,19 @@ Peers install it with `npx total-recall plugin install peer:<this-node>/openwiki
 
 ## Features
 
+OpenWiki owns documentation bootstrap and templates. Total Recall core initializes portable memory without creating OpenWiki pages. After installing this plugin, create missing documentation explicitly:
+
+```sh
+total-recall openwiki bootstrap --brain /absolute/path/to/brain \
+  --project-root /absolute/path/to/repository --json
+```
+
+`--brain` is required. `--project-root` adds repository documentation; omit it to seed only the brain's `openwiki/` directory. Existing files and page symlinks are preserved. A symlinked destination directory or a non-file page fails explicitly. `--dry-run` reports planned pages without writing. Bootstrap is a local Node-only operation and does not require credentials, a Total Recall server, ingestion or a provider request.
+
+`total-recall openwiki hubs --json` lists repository pages. `total-recall openwiki ingest <directory> --project` explicitly imports documentation through the existing memory CLI. A successful bootstrap does not claim indexing or runtime readiness.
+
 - **Identifier**: `openwiki`
-- **Version**: 0.1.0
+- **Version**: 0.1.1
 - **SSSS Category**: `openwiki-hubs`
 - **CLI Command**: `npx total-recall openwiki`
 - **UI**: `ui/panel.js` custom element with DESIGN.md tokens

package/scaffold/.agent/skills/total-recall/plugins/openwiki/cli.mjs

@@ -6,11 +6,9 @@
 // Scaffold: report honestly what exists. Add each real subcommand to
 // IMPLEMENTED and to plugin.json "cli.subcommands" as it is built.
 
-import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-
-const TR = process.env.TOTAL_RECALL_BIN || "total-recall";
+import { runBootstrapCommand } from './src/bootstrap.mjs';
 
 async function probeCommand(args) {
   const json = args.includes("--json");
@@ -24,6 +22,7 @@ async function probeCommand(args) {
     const result = { status, ok, latency_ms, endpoint: "/health" };
     if (json) console.log(JSON.stringify(result));
     else console.log(`Health probe: HTTP ${status} (${latency_ms}ms) from ${host}`);
+    if (!ok) process.exitCode = 1;
   } catch (err) {
     const latency_ms = Date.now() - start;
     const result = { status: 503, ok: false, latency_ms, error: err.message };
@@ -84,6 +83,7 @@ const IMPLEMENTED = {};
 IMPLEMENTED.probe = probeCommand;
 IMPLEMENTED.hubs = hubsCommand;
 IMPLEMENTED.ingest = ingestCommand;
+IMPLEMENTED.bootstrap = runBootstrapCommand;
 
 
 export async function run(argv = []) {
@@ -112,12 +112,15 @@ export async function run(argv = []) {
     probe [--json]            Check subsystem health
     hubs [--json]             List indexed documentation hubs
     ingest <path> [options]   Ingest Markdown files into knowledge graph
+    bootstrap --brain <path> [--project-root <path>] [--dry-run] [--json]
+                              Create missing plugin-owned documentation pages
 `);
     return;
   }
 
-  if (IMPLEMENTED[sub]) return IMPLEMENTED[sub](args.slice(1));
+  if (Object.hasOwn(IMPLEMENTED, sub)) return IMPLEMENTED[sub](args.slice(1));
 
+  if (json) console.log(JSON.stringify({ ok: false, error: `OpenWiki operation is not implemented: ${sub}` }));
   console.error(`OpenWiki: "${sub}" is not implemented.`);
   process.exitCode = 2;
 }

package/scaffold/.agent/skills/total-recall/plugins/openwiki/package-lock.json

@@ -1,15 +1,15 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-openwiki",
-      "version": "0.1.1",
+      "version": "0.1.2",
       "license": "MIT",
       "devDependencies": {
-        "total-recall-brain": "^3.40.7"
+        "total-recall-brain": "3.41.1"
       }
     },
     "node_modules/@hexagon/base64": {
@@ -2556,9 +2556,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.40.7",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.40.7.tgz",
-      "integrity": "sha512-G+sEWXVucI5Zs8uV1ie8P+mV/6cncWX76ES72T5dnPB3sFAwlcG9ous2SYTUaYUOETGB2vHTSo3cV4XWkHQ0Ww==",
+      "version": "3.41.1",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.41.1.tgz",
+      "integrity": "sha512-QraXzcZpCTMssx1gaz8xjvSKf5KqirAaxzzER/ICBrWvawdNTLUDDMsVEYQUA/7thgwtL1QVIxU4dpfCGZwp+g==",
       "dev": true,
       "license": "MIT",
       "workspaces": [

package/scaffold/.agent/skills/total-recall/plugins/openwiki/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-openwiki",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall",
   "scripts": {
@@ -13,6 +13,7 @@
     "README.md",
     "LICENSE",
     "ui/",
-    "src/"
+    "src/",
+    "templates/"
   ]
 }

package/scaffold/.agent/skills/total-recall/plugins/openwiki/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "openwiki",
   "name": "OpenWiki",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Multi-repo knowledge graph and documentation wiki engine for Total Recall.",
   "license": "MIT",
   "branding": {
@@ -83,6 +83,39 @@
         "timeout_ms": 600000,
         "effect": "write"
       },
+      {
+        "name": "bootstrap",
+        "description": "Create missing OpenWiki documentation pages in explicit brain and project directories",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "brain",
+            "flag": "--brain",
+            "label": "Brain directory",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "projectRoot",
+            "flag": "--project-root",
+            "label": "Project root",
+            "type": "string"
+          },
+          {
+            "name": "dryRun",
+            "flag": "--dry-run",
+            "label": "Preview without writing",
+            "type": "boolean"
+          },
+          {
+            "name": "json",
+            "flag": "--json",
+            "label": "JSON output",
+            "type": "boolean"
+          }
+        ]
+      },
       {
         "name": "probe",
         "description": "Run HTTP 200 health verification probe",

package/scaffold/.agent/skills/total-recall/plugins/openwiki/src/bootstrap.mjs

@@ -0,0 +1,99 @@
+/** Plugin-owned, create-only documentation bootstrap. No host runtime required. */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const templatesDir = fileURLToPath(new URL('../templates/openwiki/', import.meta.url));
+
+function requireAbsolute(value, label) {
+  if (typeof value !== 'string' || !value || !path.isAbsolute(value)) throw new Error(`${label} must be an absolute directory path`);
+  return path.resolve(value);
+}
+
+function inspectDirectory(directory) {
+  const stat = fs.lstatSync(directory, { throwIfNoEntry: false });
+  if (stat && (stat.isSymbolicLink() || !stat.isDirectory())) throw new Error(`Unsafe documentation directory: ${directory}`);
+}
+
+function inspectTarget(root) {
+  inspectDirectory(root);
+  const directory = path.join(root, 'openwiki');
+  inspectDirectory(directory);
+  return directory;
+}
+
+/** Preserve every existing page; filesystem projections are not canonical memory. */
+export function bootstrapOpenWiki({ brain, projectRoot = null, dryRun = false } = {}) {
+  const brainRoot = requireAbsolute(brain, '--brain');
+  const project = projectRoot === null ? null : requireAbsolute(projectRoot, '--project-root');
+  const roots = [...new Set([brainRoot, ...(project ? [project] : [])])];
+  const directories = roots.map(inspectTarget);
+  const templates = fs.readdirSync(templatesDir, { withFileTypes: true })
+    .sort((a, b) => a.name.localeCompare(b.name));
+  if (!templates.length || templates.some(entry => !entry.isFile() || !entry.name.endsWith('.md'))) {
+    throw new Error('OpenWiki documentation templates are missing or invalid');
+  }
+
+  // Validate every destination before creating any directory or page.
+  for (const directory of directories) for (const entry of templates) {
+    const destination = path.join(directory, entry.name);
+    const stat = fs.lstatSync(destination, { throwIfNoEntry: false });
+    if (stat && !stat.isFile() && !stat.isSymbolicLink()) throw new Error(`Documentation page is not a file: ${destination}`);
+  }
+
+  const targets = directories.map(directory => {
+    const created = [], preserved = [], planned = [];
+    if (!dryRun) fs.mkdirSync(directory, { recursive: true });
+    for (const entry of templates) {
+      const destination = path.join(directory, entry.name);
+      if (fs.lstatSync(destination, { throwIfNoEntry: false })) {
+        preserved.push(entry.name);
+        continue;
+      }
+      if (dryRun) { planned.push(entry.name); continue; }
+      try {
+        fs.copyFileSync(path.join(templatesDir, entry.name), destination, fs.constants.COPYFILE_EXCL);
+        created.push(entry.name);
+      } catch (err) {
+        // A concurrently authored page belongs to its author, never the template.
+        if (err.code !== 'EEXIST') throw err;
+        preserved.push(entry.name);
+      }
+    }
+    return { directory, created, preserved, planned };
+  });
+  return { ok: true, dry_run: dryRun, targets,
+    files_created: targets.reduce((sum, target) => sum + target.created.length, 0),
+    files_preserved: targets.reduce((sum, target) => sum + target.preserved.length, 0),
+    files_planned: targets.reduce((sum, target) => sum + target.planned.length, 0) };
+}
+
+export async function runBootstrapCommand(args = []) {
+  const json = args.includes('--json');
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log('Usage: total-recall openwiki bootstrap --brain <absolute-directory> [--project-root <absolute-directory>] [--dry-run] [--json]');
+    return { ok: true, help: true };
+  }
+  try {
+    const options = {};
+    for (let index = 0; index < args.length; index++) {
+      const arg = args[index];
+      if (arg === '--brain' || arg === '--project-root') {
+        const value = args[++index];
+        if (!value || value.startsWith('--')) throw new Error(`Missing value for ${arg}`);
+        options[arg === '--brain' ? 'brain' : 'projectRoot'] = value;
+      } else if (arg === '--dry-run') options.dryRun = true;
+      else if (arg !== '--json') throw new Error(`Unknown bootstrap option: ${arg}`);
+    }
+    const result = bootstrapOpenWiki(options);
+    if (json) console.log(JSON.stringify(result));
+    else console.log(`OpenWiki: ${result.files_created} pages created, ${result.files_preserved} preserved${result.dry_run ? `, ${result.files_planned} planned (dry run)` : ''}.`);
+    return result;
+  } catch (err) {
+    const result = { ok: false, error: err.message };
+    if (json) console.log(JSON.stringify(result));
+    console.error(`OpenWiki bootstrap failed: ${err.message}`);
+    process.exitCode = 1;
+    return result;
+  }
+}

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/README.md

@@ -0,0 +1,10 @@
+# OpenWiki
+
+Portable knowledge documentation for this Total Recall brain.
+
+| Layer | Purpose |
+|-------|---------|
+| **Memory vault** | SSSS nodes (rules, prefs, facts) — machine-enforceable |
+| **OpenWiki** | Human/agent docs (architecture, how-tos, stack notes) |
+
+OpenWiki documentation is provided by the OpenWiki plugin. Edit freely; do not put secrets here.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/architecture.md

@@ -0,0 +1,5 @@
+# Architecture (this brain)
+
+Describe the systems this brain cares about: repos, stacks, deploy targets.
+
+Project brains should document the local codebase; the global brain documents cross-repo identity and preferences.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/ide.md

@@ -0,0 +1,10 @@
+# IDE personalization
+
+```bash
+npx total-recall connect claude-code   # CLAUDE.md
+npx total-recall connect codex         # AGENTS.md
+npx total-recall connect cursor        # .cursor/rules/
+npx total-recall connect gemini        # GEMINI.md
+```
+
+Total Recall only writes inside managed inject markers. Your local rules stay intact.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/memory.md

@@ -0,0 +1,11 @@
+# Memory
+
+Use the Total Recall CLI for durable memory:
+
+```bash
+npx total-recall remember invariant "Never commit secrets." --importance 5
+npx total-recall recall "secrets"
+npx total-recall compile
+```
+
+Categories: invariants, preferences, facts, decisions, patterns, anti-patterns, concepts, lore.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/secrets.md

@@ -0,0 +1,7 @@
+# Secrets & API keys
+
+Manage credentials through the auth plugin: `total-recall auth secret list|set|rotate|audit`.
+
+**Never** put API keys in openwiki pages or compiled IDE instruction files.
+
+Credential values belong in the encrypted auth store, never in documentation.

package/scaffold/.agent/skills/total-recall/plugins/openwiki/templates/openwiki/skills.md

@@ -0,0 +1,7 @@
+# Skills
+
+- **Total Recall skill** (only nested agent skill): `.agent/skills/total-recall/SKILL.md`
+- **User skills**: `.agent/skills/<name>/SKILL.md` — project or global
+- **TR modules** (not skills): `.agent/skills/total-recall/modules/` — internal docs/scripts
+
+TR will track skill installs across repos and support adaptive deploy (see TR_CORE_FOCUS).

package/scaffold/.agent/skills/total-recall/plugins/security/package-lock.json

@@ -10,7 +10,7 @@
       "license": "MIT",
       "devDependencies": {
         "jsdom": "^26.1.0",
-        "total-recall-brain": "^3.40.7"
+        "total-recall-brain": "3.41.1"
       }
     },
     "node_modules/@asamuzakjp/css-color": {
@@ -2916,9 +2916,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.40.7",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.40.7.tgz",
-      "integrity": "sha512-G+sEWXVucI5Zs8uV1ie8P+mV/6cncWX76ES72T5dnPB3sFAwlcG9ous2SYTUaYUOETGB2vHTSo3cV4XWkHQ0Ww==",
+      "version": "3.41.1",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.41.1.tgz",
+      "integrity": "sha512-QraXzcZpCTMssx1gaz8xjvSKf5KqirAaxzzER/ICBrWvawdNTLUDDMsVEYQUA/7thgwtL1QVIxU4dpfCGZwp+g==",
       "dev": true,
       "license": "MIT",
       "workspaces": [

package/scaffold/.agent/skills/total-recall/references/auth.md

@@ -8,6 +8,8 @@ There is one secrets store per host: the global auth store. The CLI never select
 
 For provider key setup, verify against an authenticated provider operation before saving; format-only checks and timeouts are not verification. Require HTTPS except explicit loopback development, reject redirects containing credentials, and return safe errors. Rotation follows verify → store/project → deploy/verify → revoke, respecting the provider's supported recipe and user authorization. Manual provider steps remain manual. Exported environment files are deployment projections, not an alternate credential authority.
 
+Every secret operation goes through `total-recall auth secret`; never read, compare or copy credential values with shell tools. Check a copied credential with `fingerprint --from-clipboard --expect-prefix <p> --not <KEY>` before `rotate <KEY> --from-clipboard`. After `remote deploy <target> --keys … [--path <repo>]`, confirm with `remote verify <target> --keys …` (fingerprint match, no values). A process manager can keep a captured environment that overrides the deployed file (pm2 does): move the keys the app uses into the store with `remote import-pm2 <target> --app <name> --keys … --apply`, then restart the app with a clean environment so it reads only the projection. Stripe webhook signing secrets are issued by Stripe; roll them in the dashboard, never mint them.
+
 Current migration remains in progress until package/bootstrap tests, all-plugin bypass checks, owner suites and end-to-end UI/API checks pass. Manifest `auth.plugin` declarations alone do not certify any of these properties.
 
 ## Sessions, passwords and legacy data

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']