total-recall-brain 3.41.3 → 3.41.5

package/bin/total-recall.mjs

@@ -67,6 +67,7 @@ async function printHelp() {
     remember / forget / edit   Write-path memory (SSSS vault)
     recall              Read-path hybrid search
     context "<task>"    Required-rule capsule to read before acting (require ready:true)
+    preflight <cmd>     ack | check | gate: the receipt every harness hook enforces (alias: tr-preflight)
     auth secret <cmd>   Credentials (the only secrets path): list|get|set|rotate|remote deploy|diff-env|export-env
     compile             Rebuild instruction surfaces
     dream               Memory consolidation cycle
@@ -84,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, …
 
@@ -133,13 +135,21 @@ 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',
-    'doctor', 'brief', 'startup', 'init', 'connect', 'new'
+    'doctor', 'brief', 'startup', 'init', 'connect', 'new', 'preflight', 'tr-preflight'
   ]);
 
+  // Consulting Total Recall is what the repository-sweep policy looks for. Never fatal.
+  if (['recall', 'context', 'compact', 'help'].includes(command)) {
+    try {
+      const { touchConsult, findRoot } = await import('../src/core/preflight-receipt.mjs');
+      touchConsult(findRoot());
+    } catch { /* the stamp is advisory */ }
+  }
+
   // Check installed plugins first for any non-core commands (e.g. deploy, phone, text)
   if (!CORE_BUILTINS.has(command)) {
     try {

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
 ```