trucontext 0.10.0 → 0.11.1

package/bin/cli.js

@@ -25,6 +25,7 @@ import { graphOverviewCommand, graphSearchCommand, graphNodeCommand, graphNeighb
 import { mindPresenceCommand, mindThoughtsCommand } from '../src/commands/mind.js';
 import { settingsShowCommand, settingsUpdateCommand } from '../src/commands/settings.js';
 import { provisionCommand } from '../src/commands/agents.js';
+import { memoryLoadCommand, hotTopicsCommand } from '../src/commands/memory-load.js';
 
 program
   .name('trucontext')
@@ -86,6 +87,7 @@ program.command('recall <query>')
   .option('-c, --context <id>', 'Further scope within the root ego network')
   .option('-l, --limit <n>', 'Max seed results', '10')
   .option('-d, --depth <n>', 'Graph expansion depth', '2')
+  .option('-i, --intent <intent>', 'Query intent: TEMPORAL, CAUSAL, ENTITY, COMPARATIVE, EXPLORATORY (auto-detected if omitted)')
   .action(recallCommand);
 
 // Entities
@@ -276,8 +278,8 @@ settings.command('update')
 registerRootsCommand(program);
 registerCuriosityCommand(program);
 
-// Agent provision
-const agents = program.command('agents').description('Agent provisioning');
+// Agent provision + memory
+const agents = program.command('agents').description('Agent provisioning & memory');
 agents.command('provision')
   .description('Provision an agent (create or update root node, ingest content, generate memory briefing)')
   .requiredOption('--agent-id <id>', 'Agent identifier')
@@ -292,4 +294,15 @@ agents.command('provision')
   .option('--dry-run', 'Preview what would happen without doing it')
   .action(provisionCommand);
 
+agents.command('memory-load')
+  .description('Get the pre-computed MLC briefing document for an agent')
+  .requiredOption('-a, --agent <id>', 'Agent ID')
+  .action(memoryLoadCommand);
+
+agents.command('hot-topics')
+  .description('List or view hot topic deep-dive documents')
+  .requiredOption('-a, --agent <id>', 'Agent ID')
+  .option('-t, --topic <slug>', 'Specific topic slug to view')
+  .action(hotTopicsCommand);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trucontext",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "TruContext CLI — contextual memory for AI applications",
   "type": "module",
   "bin": {

package/src/commands/memory-load.js

@@ -0,0 +1,93 @@
+// commands/memory-load.js — Memory Load Cache CLI
+//
+// trucontext agents memory-load --agent <id>
+// trucontext agents hot-topics --agent <id>
+// trucontext agents hot-topics --agent <id> --topic <slug>
+
+import chalk from 'chalk';
+import { dataPlane } from '../client.js';
+
+export async function memoryLoadCommand(options) {
+  try {
+    const agentId = options.agent;
+    if (!agentId) {
+      console.error(chalk.red('--agent <id> is required'));
+      process.exit(1);
+    }
+
+    const res = await dataPlane('GET', `/v1/agents/${agentId}/memory-load`);
+    const data = res.data;
+
+    if (data.status === 'pending') {
+      console.log(chalk.yellow('MLC not yet generated. The heartbeat will produce one after the next dream cycle.'));
+      return;
+    }
+
+    // Print document
+    console.log(chalk.bold(`\nMemory Load Cache — ${agentId}`));
+    console.log(chalk.dim(`Generated: ${data.generated_at} | Cycle: ${data.heartbeat_cycle} | Recipe: ${data.recipe_id}`));
+    console.log(chalk.dim('─'.repeat(60)));
+    console.log(data.document);
+
+    // Print hot topics manifest
+    if (data.hot_topics?.length > 0) {
+      console.log(chalk.dim('─'.repeat(60)));
+      console.log(chalk.bold(`\nHot Topics (${data.hot_topics.length}):`));
+      for (const t of data.hot_topics) {
+        console.log(`  ${chalk.cyan(t.slug)} — ${t.label}`);
+        if (t.teaser) console.log(`    ${chalk.dim(t.teaser)}`);
+      }
+      console.log(chalk.dim('\nUse: trucontext agents hot-topics --agent ' + agentId + ' --topic <slug>'));
+    }
+  } catch (err) {
+    console.error(chalk.red(`Memory load failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function hotTopicsCommand(options) {
+  try {
+    const agentId = options.agent;
+    if (!agentId) {
+      console.error(chalk.red('--agent <id> is required'));
+      process.exit(1);
+    }
+
+    // If --topic is specified, fetch individual document
+    if (options.topic) {
+      const res = await dataPlane('GET', `/v1/agents/${agentId}/hot-topics/${options.topic}`);
+      const data = res.data;
+
+      console.log(chalk.bold(`\nHot Topic: ${data.label}`));
+      console.log(chalk.dim(`Generated: ${data.generated_at} | Atoms: ${data.atoms_referenced} | Confidence: ${(data.confidence * 100).toFixed(0)}%`));
+      console.log(chalk.dim('─'.repeat(60)));
+      console.log(data.document);
+      return;
+    }
+
+    // List all hot topics
+    const res = await dataPlane('GET', `/v1/agents/${agentId}/hot-topics`);
+    const topics = res.data;
+
+    if (!topics || topics.length === 0) {
+      console.log(chalk.yellow('No hot topics cached. The heartbeat will generate them after the next dream cycle.'));
+      return;
+    }
+
+    console.log(chalk.bold(`\nHot Topics for ${agentId} (${topics.length}):\n`));
+    for (const t of topics) {
+      const conf = t.confidence ? ` ${chalk.dim(`${(t.confidence * 100).toFixed(0)}%`)}` : '';
+      const atoms = t.atoms_referenced ? ` ${chalk.dim(`${t.atoms_referenced} atoms`)}` : '';
+      console.log(`  ${chalk.cyan(t.slug)} — ${t.label}${conf}${atoms}`);
+      console.log(`    ${chalk.dim(t.generated_at)}`);
+    }
+    console.log(chalk.dim('\nUse --topic <slug> to read a specific hot topic document.'));
+  } catch (err) {
+    if (err.status === 404) {
+      console.log(chalk.yellow('Hot topic not found. It may have expired (TTL 4 days). Use recall for a live query.'));
+    } else {
+      console.error(chalk.red(`Hot topics failed: ${err.message}`));
+      process.exit(1);
+    }
+  }
+}

package/src/commands/recall.js

@@ -21,6 +21,15 @@ export async function recallCommand(query, options) {
     };
 
     if (options.context) body.context_id = options.context;
+    if (options.intent) {
+      const validIntents = ['TEMPORAL', 'CAUSAL', 'ENTITY', 'COMPARATIVE', 'EXPLORATORY'];
+      const intent = options.intent.toUpperCase();
+      if (!validIntents.includes(intent)) {
+        console.error(chalk.red(`Invalid intent: ${options.intent}. Must be one of: ${validIntents.join(', ')}`));
+        process.exit(1);
+      }
+      body.intent = intent;
+    }
 
     const res = await dataPlane('POST', `/v1/recall`, body);
     const data = res.data;
@@ -46,6 +55,9 @@ export async function recallCommand(query, options) {
       console.log(chalk.dim(`\nGraph: ${data.context.nodes?.length || 0} nodes, ${data.context.edges?.length || 0} edges`));
     }
 
+    if (data.intent) {
+      console.log(chalk.dim(`Intent: ${data.intent}`));
+    }
     console.log(chalk.dim(`${data.latency_ms}ms`));
   } catch (err) {
     console.error(chalk.red(`Recall failed: ${err.message}`));