total-recall-brain 3.41.2 → 3.41.4

package/src/cli/connect.mjs

@@ -151,17 +151,7 @@ export const CLIENTS = {
     label: 'Antigravity',
     mode: 'symlink',
     target: '.agents/rules/AGENTS.md',
-    // Antigravity reads workspace skills from .agents/skills and exposes
-    // native /name invocation; Gemini TOML commands are a separate surface.
-    skillsProjection: { scope: 'project', dir: path.join('.agents', 'skills') }
-  },
-  gemini: {
-    label: 'Gemini',
-    mode: 'symlink',
-    target: '.agents/rules/GEMINI.md',
-    writeSlashCommands: true,
-    // Gemini CLI activates workspace skills from .agents/skills via /skills;
-    // explicit /name commands require separate .gemini/commands/*.toml files.
+    // Antigravity reads workspace skills from .agents/skills and exposes native /name invocation
     skillsProjection: { scope: 'project', dir: path.join('.agents', 'skills') }
   },
   aider: {
@@ -233,7 +223,6 @@ function printHelp() {
     claude-code
     codex
     antigravity
-    gemini
     grok
     replit
     lovable
@@ -643,94 +632,6 @@ $ARGUMENTS`
   return written;
 }
 
-function writeGeminiSlashCommands(opts) {
-  const globalDir = path.join(os.homedir(), '.gemini', 'commands');
-  const localDir = path.join(process.cwd(), '.gemini', 'commands');
-
-  fs.mkdirSync(globalDir, { recursive: true });
-  fs.mkdirSync(localDir, { recursive: true });
-
-  const base = (opts.brain || 'http://127.0.0.1:3000').replace(/\/$/, '');
-  const token = '<YOUR_PAT_TOKEN>';
-
-  const commands = {
-    'memory.toml': {
-      description: 'Search or manage Total Recall memory',
-      prompt: `You are Antigravity, an AI assistant with the Total Recall SSSS v2 memory vault.
-Search the semantic memory vault or fetch nodes using the following query:
-{{args}}
-
-Instructions:
-Perform a POST request to \`${base}/api/memory/search/semantic\` with the body \`{"query": "{{args}}", "top_k": 5}\` and Authorization: Bearer ${token}.`
-    },
-    'brain.toml': {
-      description: 'Show Total Recall brain status and health',
-      prompt: `Show the health, loaded model status, and statistics of the local Total Recall Total Recall System brain.
-
-Instructions:
-Query the health of the local brain by sending a GET request to \`${base}/health\` with Authorization: Bearer ${token}.`
-    },
-    'vault.toml': {
-      description: 'Compile or inspect the Total Recall SSSS memory vault',
-      prompt: `Compile, rebuild, or inspect the Structured Semantic Syntax System (SSSS) memory vault.
-
-Instructions:
-1. If the argument is "compile", send a POST request to \`${base}/api/vault/compile\` with Authorization: Bearer ${token} or run \`npx total-recall compile\`.
-2. If the argument is "nodes", send a GET request to \`${base}/api/memory\` with Authorization: Bearer ${token}.
-3. Summarize the changes and verify rule propagation across the workspace.`
-    },
-    'ssss.toml': {
-      description: 'Explore SSSS cognitive graph, backlinks, and network statistics',
-      prompt: `You are Antigravity, an AI assistant with the Total Recall SSSS v2 memory vault.
-Explore the SSSS cognitive graph, backlinks, and network topology using the query:
-{{args}}
-
-Instructions:
-1. Parse the arguments.
-2. If "stats", run \`npx total-recall map --relations\` to retrieve and summarize cognitive graph metrics, Highly Connected Hubs, and unlinked Orphans.
-3. If "map <slug>", print the inbound backlinks and outbound relations for the specified memory node slug using \`npx total-recall map --relations\`.
-4. If "compile", send a POST request to \`${base}/api/vault/compile\` with Authorization: Bearer ${token} or run \`npx total-recall compile\`.
-5. If "help", explain the SSSS v2 specification, categories (invariants, preferences, anti-patterns, patterns, decisions, concepts, facts, lore) and the bidirectional backlink structure.`
-    },
-    'recall.toml': {
-      description: 'Ask Total Recall brain a question or run a specialized agent task',
-      prompt: `Send a direct conversational query or task instruction to the Total Recall local brain.
-Query: {{args}}
-
-Instructions:
-1. Query the memory vault for relevant context by sending a POST request to \`${base}/api/memory/search/semantic\` with the body \`{"query": "{{args}}", "top_k": 5}\` and Authorization: Bearer ${token}.
-2. Address the user's inquiry thoroughly, referencing active memory nodes where applicable.`
-    }
-  };
-
-  const written = [];
-  for (const [filename, cmd] of Object.entries(commands)) {
-    const tomlContent = `description = "${cmd.description}"\nprompt = """\n${cmd.prompt}\n"""\n`;
-
-    // Write global command
-    const globalPath = path.join(globalDir, filename);
-    const globalExisted = fs.existsSync(globalPath);
-    if (!globalExisted || opts.force) {
-      fs.writeFileSync(globalPath, tomlContent, 'utf8');
-      written.push({ file: `global/${filename}`, action: globalExisted ? 'updated' : 'created' });
-    } else {
-      written.push({ file: `global/${filename}`, action: 'exists' });
-    }
-
-    // Write local command
-    const localPath = path.join(localDir, filename);
-    const localExisted = fs.existsSync(localPath);
-    if (!localExisted || opts.force) {
-      fs.writeFileSync(localPath, tomlContent, 'utf8');
-      written.push({ file: `local/${filename}`, action: localExisted ? 'updated' : 'created' });
-    } else {
-      written.push({ file: `local/${filename}`, action: 'exists' });
-    }
-  }
-
-  return written;
-}
-
 
 export default async function connect(args) {
   const opts = parseArgs(args);
@@ -739,6 +640,11 @@ export default async function connect(args) {
     return;
   }
 
+  if (opts.client === 'gemini') {
+    console.error("Gemini CLI was deprecated by Google; Antigravity (agy) is the official Google agent harness. Run 'total-recall connect antigravity' instead.");
+    process.exit(1);
+  }
+
   const preset = CLIENTS[opts.client];
   if (!preset) {
     console.error(`Unknown client: ${opts.client}`);
@@ -967,22 +873,12 @@ export default async function connect(args) {
 
   // Write slash commands
   if (preset.writeSlashCommands) {
-    if (opts.client === 'gemini') {
-      const slashResults = writeGeminiSlashCommands(opts);
-      result.slash_commands = slashResults;
-      const created = slashResults.filter(r => r.action !== 'exists');
-      if (created.length > 0) {
-        result.notes.push(`  Slash commands written to ~/.gemini/commands/ and .gemini/commands/:\n` +
-          created.map(r => `    ${r.file} (${r.action})`).join('\n'));
-      }
-    } else {
-      const slashResults = writeClaudeCodeSlashCommands(opts);
-      result.slash_commands = slashResults;
-      const created = slashResults.filter(r => r.action !== 'exists');
-      if (created.length > 0) {
-        result.notes.push(`  Slash commands written to ~/.claude/commands/:\n` +
-          created.map(r => `    /${r.file.replace('.md', '')} (${r.action})`).join('\n'));
-      }
+    const slashResults = writeClaudeCodeSlashCommands(opts);
+    result.slash_commands = slashResults;
+    const created = slashResults.filter(r => r.action !== 'exists');
+    if (created.length > 0) {
+      result.notes.push(`  Slash commands written to ~/.claude/commands/:\n` +
+        created.map(r => `    /${r.file.replace('.md', '')} (${r.action})`).join('\n'));
     }
   }
 

package/src/cli/daemon.mjs

@@ -218,7 +218,29 @@ export default async function daemon(args) {
 
   switch (subcommand) {
     case 'ensure': {
-      if(!useSystemd)throw new Error('Managed daemon ensure currently requires systemd on the daemon host');
+      if(useLaunchd){
+        // macOS: the launchd agent owns the daemon. Load it if needed, restart it
+        // on --restart (or start it when nothing runs), then verify the process
+        // launchd reports is the one holding the brain lock.
+        const label='com.totalrecall.daemon',target=`gui/${process.getuid()}/${label}`;
+        const launchdPid=()=>{const r=spawnSync('launchctl',['list',label],{encoding:'utf8'});const m=r.status===0&&/"PID"\s*=\s*(\d+)/.exec(r.stdout||'');return m?Number(m[1]):0;};
+        if(spawnSync('launchctl',['list',label],{stdio:'ignore'}).status!==0){
+          const boot=spawnSync('launchctl',['bootstrap',`gui/${process.getuid()}`,launchAgentPlist(label)],{encoding:'utf8'});
+          if(boot.status!==0)throw new Error(`Cannot load ${label}: ${(boot.stderr||'').trim()}`);
+        }
+        const owner=readPid(),managedPid=launchdPid();
+        if(owner && owner!==managedPid && !await stopDaemon())throw new Error('Cannot stop verified detached daemon');
+        if(args.includes('--restart') || !managedPid || (owner && owner!==managedPid)){
+          const kick=spawnSync('launchctl',['kickstart','-k',target],{encoding:'utf8'});
+          if(kick.status!==0)throw new Error(`launchctl kickstart failed: ${(kick.stderr||'').trim()}`);
+        }
+        await new Promise(resolve=>setTimeout(resolve,3000));
+        const pid=readPid(),current=launchdPid();
+        if(!pid || pid!==current)throw new Error('Managed daemon did not retain ownership of the brain lock');
+        console.log(JSON.stringify({ok:true,manager:'launchd',pid,enabled:true}));
+        break;
+      }
+      if(!useSystemd)throw new Error('Managed daemon ensure needs systemd or a launchd agent on the daemon host');
       // A detached worker can hold the same brain lock while systemd reports a
       // successful short-lived start. Stop that verified owner before takeover.
       const managed=spawnSync('systemctl',['show','total-recall-daemon','--property=MainPID','--value'],{encoding:'utf8'});

package/src/cli/harness.mjs

@@ -21,7 +21,6 @@ Available Harness IDs:
   claude                    Claude Code CLI (Deep codebase refactoring & Unix execution)
   codex                     OpenAI Codex CLI (Program synthesis & sandbox execution)
   grok                      xAI Grok Build CLI (Autonomous coding, inspection, shell execution)
-  gemini                    Google Gemini CLI (Fast utilities & completion chaining)
   ollama                    Ollama Local LLM (Local neural reasoning, zero API cost)
   hermes                    Hermes Agent Runtime (Autonomous supervisor & messaging gateway)
   dsh                       DeepSeek Harness DSH (High-throughput reasoning engine)

package/src/cli/plugin/copies.mjs

@@ -17,8 +17,9 @@ export function pluginCopyRows(projectRoot = process.cwd(), { sharedDir = global
     root: projectRoot,
     sharedDir,
     count: audit.count,
-    removable: audit.copies.filter(copy => copy.edited === false).map(copy => copy.id),
-    edited: audit.copies.filter(copy => copy.edited === true).map(copy => copy.id),
+    removable: audit.copies.filter(copy => copy.edited === false || copy.stale === true).map(copy => copy.id),
+    edited: audit.copies.filter(copy => copy.edited === true && copy.stale !== true).map(copy => copy.id),
+    stale: audit.copies.filter(copy => copy.stale === true).map(copy => copy.id),
     unverified: audit.copies.filter(copy => copy.edited === null).map(copy => copy.id),
     copies: audit.copies
   };
@@ -58,11 +59,13 @@ export async function manageProjectPluginCopies(args = []) {
     return;
   }
   for (const copy of report.copies) {
-    const verdict = copy.edited === false ? 'identical to the shared install' : copy.edited === true ? 'DIFFERS from the shared install' : 'no shared install to compare';
+    const verdict = copy.stale === true ? 'STALE — older than the shared install; it shadows the shared plugin and must be removed'
+      : copy.edited === false ? 'identical to the shared install'
+      : copy.edited === true ? 'DIFFERS from the shared install' : 'no shared install to compare';
     console.log(`  ${copy.id} v${copy.version || '?'} (shared: v${copy.sharedVersion || '—'}) — ${verdict}`);
   }
-  console.log(`\n  ${report.removable.length} removable, ${report.edited.length} edited, ${report.unverified.length} unverified`);
+  console.log(`\n  ${report.removable.length} removable (${report.stale.length} stale), ${report.edited.length} edited, ${report.unverified.length} unverified`);
   if (report.removal) console.log(`  Removed: ${report.removal.removed.join(', ') || 'none'}${report.removal.failed.length ? `; failed: ${report.removal.failed.map(row => row.id).join(', ')}` : ''}`);
-  else if (report.removable.length) console.log('  Re-run with --apply to remove the identical copies.');
+  else if (report.removable.length) console.log('  Re-run with --apply to remove the removable copies.');
   console.log();
 }

package/src/cli/plugin/create.mjs

@@ -289,6 +289,17 @@ export async function createPlugin(args = []) {
         { name: "status", description: `Show which ${pluginName} subcommands are implemented`, effect: "read", output: "json" }
       ]
     };
+    if (apiKeys.length) {
+      manifest.cli.subcommands.push({
+        name: "token",
+        description: `Manage ${pluginName} API credentials in the secrets store`,
+        effect: "write",
+        args: [
+          { name: "action", positional: true, type: "choice", options: ["status", "set"], label: "Action" },
+          { name: "value", secret: true, type: "string", label: "Secret value passed over stdin" }
+        ]
+      });
+    }
     // The card contract reads the plugin's real state through a declared read
     // command; a scaffold without this shows no live status.
     manifest.status = { command: "status", refresh_seconds: 60 };
@@ -433,6 +444,10 @@ export default generateContext;
     fs.writeFileSync(path.join(pluginDir, "generator.mjs"), generatorContent, "utf8");
   }
 
+  manifest.capability = {
+    entry: "capability/index.mjs",
+    exports: ["getCapabilityStatus"]
+  };
 
   const validation = validatePluginManifest(manifest);
   if (!validation.valid) {
@@ -490,13 +505,51 @@ export default generateContext;
     private: true,
     type: 'module',
     description: pluginDesc,
-    scripts: { test: 'node --test test/*.test.mjs' },
-    devDependencies: { 'total-recall-brain': '^3.35.0' },
+    scripts: {
+      test: 'node --test test/*.test.mjs',
+      ssss: 'ssss',
+      export: 'ssss export vault --profile sale --out dist/bundle.ucw.json',
+      validate: 'ssss conformance --engine'
+    },
+    dependencies: {
+      '@gregiteen/ssss-cli': '0.14.3'
+    },
+    devDependencies: {
+      'total-recall-brain': '3.41.3'
+    },
     license: 'MIT'
   }, null, 2) + '\n', 'utf8');
-  fs.writeFileSync(path.join(pluginDir, '.gitignore'), 'node_modules/\n.env*\n.agent/skills/total-recall/\ndist/\nreports/\n.DS_Store\nINSTRUCTIONS.md\nAGENTS.md\nGEMINI.md\n', 'utf8');
+  fs.writeFileSync(path.join(pluginDir, '.gitignore'), 'node_modules/\n.env*\n.agent/skills/total-recall/\ndist/\nreports/\n.DS_Store\nINSTRUCTIONS.md\nAGENTS.md\n', 'utf8');
   fs.writeFileSync(path.join(pluginDir, 'LICENSE'), mitLicense(holder), 'utf8');
+
+  // Capability brick
+  fs.mkdirSync(path.join(pluginDir, 'capability'), { recursive: true });
+  fs.writeFileSync(path.join(pluginDir, 'capability', 'index.mjs'), `/**
+ * Portable capability brick for ${pluginName}.
+ * Zero host dependencies; pure portable JavaScript.
+ */
+export async function getCapabilityStatus() {
+  return { ready: true, initialized: true };
+}
+`, 'utf8');
+  fs.writeFileSync(path.join(pluginDir, 'capability', 'BRICK.md'), `# ${pluginName} — Capability Brick
+
+Portable core capability for ${pluginName}.
+
+## Exported Functions
+- \`getCapabilityStatus()\`: Returns capability readiness and initialization status.
+`, 'utf8');
+
   fs.mkdirSync(path.join(pluginDir, 'test'), { recursive: true });
+  fs.writeFileSync(path.join(pluginDir, 'test', 'capability.test.mjs'), `import test from 'node:test';
+import assert from 'node:assert/strict';
+import { getCapabilityStatus } from '../capability/index.mjs';
+
+test('capability brick loads and exports status', async () => {
+  const status = await getCapabilityStatus();
+  assert.equal(status.ready, true);
+});
+`, 'utf8');
   fs.writeFileSync(path.join(pluginDir, 'test', 'manifest.test.mjs'), `import test from 'node:test';
 import assert from 'node:assert/strict';
 import fs from 'node:fs';

package/src/cli/plugin/index.mjs

@@ -5,9 +5,9 @@ import { listAvailable, listPeers, searchPlugins } from './search.mjs';
 import { createPlugin } from './create.mjs';
 import { vendorPlugin, listProjectBricks } from './vendor.mjs';
 import { manageProjectPluginCopies } from './copies.mjs';
-import { managePluginLicense } from './monetization.mjs';
-import { getPlugin, getPluginMonetization } from '../../core/plugin-loader.mjs';
-import { describePlugin } from '../../core/plugin-store.mjs';
+import { managePluginLicense, monetizePlugin, publishPluginToStore } from './monetization.mjs';
+import { getPlugin, getPluginMonetization, globalPluginsDir, projectPluginsDir } from '../../core/plugin-loader.mjs';
+import { describePlugin, pruneReplacementArchives, replacementArchiveDir } from '../../core/plugin-store.mjs';
 import { buildPluginCatalog } from '../../core/plugin-catalog.mjs';
 import { setPluginActive } from '../../core/plugin-activation.mjs';
 
@@ -29,6 +29,10 @@ Commands:
   refresh                   Rebuild installed command inventories and instruction surfaces
   copies [dir] [--apply]    Audit this repository's leftover copies of the shared default
                             plugins; --apply removes only the ones identical to the shared install
+  replacements [--prune] [--keep N] [--project] [--json]
+                            Copies kept by install --replace (default: shared folder). Reports
+                            the space; --prune keeps the newest N per plugin (default 1) and
+                            drops node_modules from the kept ones
   on <id> / off <id>         Enable/disable host execution for this repository alone
                               --all-repos   Change the shared setting for every repository
                               --clear       Drop this repository's override; follow the shared setting
@@ -51,8 +55,10 @@ Commands:
                             in 'update --automatic')
    share <id>                Offer an installed plugin by direct link and mesh
   unshare <id>              Stop offering it
+  publish <id>              Publish plugin to the Store and lock release (--no-lock)
+  monetize <id>             Configure plugin pricing, period, and payout recipient
   remove <id>               Uninstall (--global for the machine-wide copy)
-  license <id> [cmd]        Check or activate plugin license (status, activate, verify)
+  license <id> [cmd]        Check or activate plugin license (status, activate, checkout, verify)
   info <id>                 Manifest, provenance, hash and task history
   vendor <source> [dir]     Add a plugin to this project as a brick (default bricks/<id>); the
                             project then owns the code. <source>: bundled id, git URL or path.
@@ -136,6 +142,25 @@ export async function run(argv = []) {
     return;
   }
 
+  if (command === 'replacements') {
+    const keepAt = rest.indexOf('--keep');
+    const keep = keepAt === -1 ? 1 : Number(rest[keepAt + 1]);
+    if (!Number.isInteger(keep) || keep < 0) {
+      console.error('Usage: total-recall plugin replacements [--prune] [--keep N] [--project] [--json]');
+      process.exitCode = 1;
+      return;
+    }
+    const dir = replacementArchiveDir(rest.includes('--project') ? projectPluginsDir(process.cwd()) : globalPluginsDir());
+    const apply = rest.includes('--prune');
+    const r = pruneReplacementArchives(dir, { keep, apply });
+    if (rest.includes('--json')) { console.log(JSON.stringify({ ...r, applied: apply }, null, 2)); return; }
+    const gb = (r.bytesFreed / 1073741824).toFixed(2);
+    console.log(`\n  ${r.archiveDir}`);
+    console.log(`  ${r.kept.length + r.removed.length} retained cop${r.kept.length + r.removed.length === 1 ? 'y' : 'ies'}; keeping ${r.kept.length}, ${apply ? 'removed' : 'would remove'} ${r.removed.length}, ${apply ? 'stripped' : 'would strip'} node_modules from ${r.stripped.length}`);
+    console.log(`  ${apply ? 'Freed' : 'Would free'} ${gb} GB${apply ? '' : ' — run with --prune to apply'}\n`);
+    return;
+  }
+
   if (command === 'copies' || command === 'duplicates') {
     await manageProjectPluginCopies(rest);
     return;
@@ -221,7 +246,17 @@ export async function run(argv = []) {
     return;
   }
 
-  if (command === 'license' || command === 'lic' || command === 'monetize') {
+  if (command === 'publish' || command === 'deploy-store') {
+    await publishPluginToStore(rest);
+    return;
+  }
+
+  if (command === 'monetize') {
+    await monetizePlugin(rest);
+    return;
+  }
+
+  if (command === 'license' || command === 'lic') {
     await managePluginLicense(rest);
     return;
   }