trucontext 0.7.1 → 0.8.0

package/bin/cli.js

@@ -19,6 +19,7 @@ import { recipesListCommand, recipesGetCommand, recipesCreateCommand, recipesDel
 import { relationshipTypesListCommand } from '../src/commands/relationship-types.js';
 import { docsListCommand, docsShowCommand } from '../src/commands/docs.js';
 import { registerRootsCommand } from '../src/commands/roots.js';
+import { registerCuriosityCommand } from '../src/commands/curiosity.js';
 
 program
   .name('trucontext')
@@ -136,6 +137,9 @@ entities.command('edges <entityId>')
 // Root Nodes
 registerRootsCommand(program);
 
+// Curiosity
+registerCuriosityCommand(program);
+
 // Recipes
 const recipes = program.command('recipes').description('Manage recipes').action(function() { this.help(); });
 recipes.command('list')

package/package.json

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

package/src/commands/curiosity.js

@@ -0,0 +1,97 @@
+// curiosity.js — Curiosity Engine commands
+//
+// Trigger curiosity analysis and view knowledge gaps for a root node.
+// Curiosity analysis is always scoped to a root node's ego network.
+
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getConfig, getActiveApp } from '../config.js';
+
+export function registerCuriosityCommand(program) {
+  const curiosity = program
+    .command('curiosity')
+    .description('Curiosity engine — discover knowledge gaps')
+    .action(function() { this.help(); });
+
+  // List curiosity packets
+  curiosity
+    .command('list')
+    .description('List curiosity packets for a root node')
+    .option('--root <rootId>', 'Root node ID (uses active root if not specified)')
+    .option('--status <status>', 'Filter by status: PENDING, DISMISSED', 'PENDING')
+    .option('--limit <n>', 'Max packets to return', '20')
+    .action(async (opts) => {
+      const appId = getActiveApp();
+      const config = getConfig();
+      const rootId = opts.root || config.activeRoot;
+      if (!rootId) {
+        console.error(chalk.red('No root specified. Use --root <id> or set active root with: trucontext roots use <id>'));
+        process.exit(1);
+      }
+
+      try {
+        const res = await controlPlane('GET', `/apps/${appId}/mind/curiosity?root_id=${rootId}&status=${opts.status}&limit=${opts.limit}`);
+        const packets = res.data?.packets || [];
+
+        if (packets.length === 0) {
+          console.log(chalk.dim(`No ${opts.status.toLowerCase()} curiosity packets for root: ${rootId}`));
+          return;
+        }
+
+        console.log(chalk.bold(`Curiosity Packets (${packets.length}) — root: ${rootId}\n`));
+        for (const p of packets) {
+          const typeColor = p.curiosity_type === 'EXTERNAL' ? chalk.cyan : chalk.yellow;
+          console.log(`  ${typeColor(`[${p.gap_type}]`)} ${p.question}`);
+          if (p.why_it_matters) console.log(chalk.dim(`    Why: ${p.why_it_matters}`));
+          if (p.suggested_approach) console.log(chalk.dim(`    Approach: ${p.suggested_approach}`));
+          console.log(chalk.dim(`    Priority: ${p.priority_score?.toFixed(2) || '?'} | Status: ${p.status} | ID: ${p.packet_id}`));
+          console.log();
+        }
+      } catch (err) {
+        console.error(chalk.red('Failed:'), err.response?.data?.error || err.message);
+        process.exit(1);
+      }
+    });
+
+  // Trigger on-demand curiosity evaluation
+  curiosity
+    .command('trigger')
+    .description('Run curiosity analysis on a root node')
+    .option('--root <rootId>', 'Root node ID (uses active root if not specified)')
+    .action(async (opts) => {
+      const appId = getActiveApp();
+      const config = getConfig();
+      const rootId = opts.root || config.activeRoot;
+      if (!rootId) {
+        console.error(chalk.red('No root specified. Use --root <id> or set active root with: trucontext roots use <id>'));
+        process.exit(1);
+      }
+
+      try {
+        console.log(chalk.dim(`Triggering curiosity analysis for root: ${rootId}...`));
+        await controlPlane('POST', `/apps/${appId}/mind/curiosity/trigger`, {
+          root_id: rootId,
+        });
+        console.log(chalk.green(`Curiosity analysis started for root: ${rootId}`));
+        console.log(chalk.dim(`Results will appear shortly. Check with: trucontext curiosity list --root ${rootId}`));
+      } catch (err) {
+        console.error(chalk.red('Failed:'), err.response?.data?.error || err.message);
+        process.exit(1);
+      }
+    });
+
+  // Dismiss a curiosity packet
+  curiosity
+    .command('dismiss <packetId>')
+    .description('Dismiss a curiosity packet')
+    .action(async (packetId) => {
+      const appId = getActiveApp();
+      try {
+        await controlPlane('PUT', `/apps/${appId}/mind/curiosity/${packetId}/dismiss`);
+        console.log(chalk.green(`Dismissed: ${packetId}`));
+      } catch (err) {
+        console.error(chalk.red('Failed:'), err.response?.data?.error || err.message);
+        process.exit(1);
+      }
+    });
+}