total-recall-brain 3.41.4 → 3.41.6

package/bin/total-recall.mjs

@@ -85,6 +85,7 @@ async function printHelp() {
 ${pluginsSection}
   Optional:
     update [--apply]    Auto-download total-recall-brain for registered repos
+    release <action>    Publish, propagate and verify a package release (plan|publish|propagate|verify|all)
     research, share, ingest, import, export, relay, setup, deploy,
     start, backup, restore, config, map, generate-pat, lint, sync, …
 
@@ -134,7 +135,7 @@ async function main() {
 
   // Core built-in memory and rules commands that always run from core
   const CORE_BUILTINS = new Set([
-    'remember', 'forget', 'edit', 'recall', 'context', 'rules',
+    'remember', 'forget', 'edit', 'recall', 'context', 'compact', 'rules',
     'compile', 'rebuild', 'dream', 'proposals', 'proposal', 'task',
     'daemon', 'skill', 'plugin', 'plugins',
     'harness', 'agent', 'agents', 'brain', 'status',
@@ -142,7 +143,7 @@ async function main() {
   ]);
 
   // Consulting Total Recall is what the repository-sweep policy looks for. Never fatal.
-  if (['recall', 'context', 'help'].includes(command)) {
+  if (['recall', 'context', 'compact', 'help'].includes(command)) {
     try {
       const { touchConsult, findRoot } = await import('../src/core/preflight-receipt.mjs');
       touchConsult(findRoot());
@@ -155,7 +156,7 @@ async function main() {
       const { discoverPlugins } = await import('../src/core/plugin-loader.mjs');
       const plugins = discoverPlugins(process.cwd());
       for (const p of plugins) {
-        if (p.valid && p.manifest.cli?.command === command) {
+        if (p.valid && (p.manifest.cli?.command === command || p.manifest.cli?.alias === command)) {
           const handlerRel = p.manifest.cli.handler;
           if (handlerRel) {
             const { runPluginCommand } = await import('../src/core/plugin-runner.mjs');
@@ -165,7 +166,8 @@ async function main() {
               if(result.stdout)process.stdout.write(result.stdout);
               if(result.stderr)process.stderr.write(result.stderr);
             }else if(result.output)process.stdout.write(result.output);
-            process.exit(result.ok ? 0 : (result.exitCode || 1));
+            const { exitAfterFlush } = await import('../src/core/stdio-flush.mjs');
+            await exitAfterFlush(result.ok ? 0 : (result.exitCode || 1));
           }
         }
       }
@@ -221,7 +223,8 @@ async function main() {
         const { default: dispatch } = await import('../src/cli/integration-dispatcher.mjs');
         const result = await dispatch(command, action, options);
         console.log(typeof result === 'object' ? JSON.stringify(result, null, 2) : result);
-        process.exit(0);
+        const { exitAfterFlush } = await import('../src/core/stdio-flush.mjs');
+        await exitAfterFlush(0);
       }
 
     } catch (err) {
@@ -235,7 +238,8 @@ async function main() {
       if ((await loadApiRoutes()).some((r) => r.group === command)) {
         const { default: apiCli } = await import('../src/cli/api.mjs');
         await apiCli(args);
-        process.exit(process.exitCode ?? 0);
+        const { exitAfterFlush } = await import('../src/core/stdio-flush.mjs');
+        await exitAfterFlush(process.exitCode ?? 0);
       }
     } catch (err) {
       console.error(`Error: ${err.message}`);

package/docs/reference/cli-reference.md

@@ -89,9 +89,27 @@ Autonomously learn and save a new memory node to the vault.
 
 ---
 
+### `compact`
+Fit the applicable rules into a token budget you choose, ranked against the task.
+
+```sh
+total-recall compact "task description" --budget 2000 --action edit,test
+total-recall compact "task description" --expand some-rule-slug
+```
+
+The default budget is 4,000 estimated tokens and counts everything printed.
+Ranking uses vault embeddings through the local or mesh provider and falls back to
+lexical matching, reported as `ranking:`. Rules keep their own words: full text, a
+leading excerpt, or a slug under `Referenced`. Near-duplicates become references
+and absolute-priority rules are named first. The header counts every tier, so nothing
+disappears silently. Output is partial by design; `context` prints the complete
+capsule. Exit 2 means the budget cannot hold the header or the expanded rules.
+
 ### `context`
 Assemble applicable required rules for the current task before action.
 
+Over its budget, `context` compacts automatically and reports `ready:true compacted:true`: every absolute rule keeps at least a verbatim summary and every other rule keeps at least its slug. Configured budgets are capped at 7000 tokens so the capsule prints inline; pass a larger `--budget` to print the full capsule. Exit 2 means the budget cannot hold every rule, and the output names the budget that can.
+
 ```sh
 total-recall context "task description" --action edit,test
 ```