trucontext 0.8.6 → 0.9.1

package/bin/cli.js

@@ -12,15 +12,19 @@ import { initCommand } from '../src/commands/init.js';
 import { ingestCommand } from '../src/commands/ingest.js';
 import { queryCommand } from '../src/commands/query.js';
 import { recallCommand } from '../src/commands/recall.js';
-import { contextsListCommand, contextsCreateCommand, contextsDeleteCommand } from '../src/commands/contexts.js';
 import { schemaShowCommand, schemaGenerateCommand, schemaSetAuthorshipCommand } from '../src/commands/schema.js';
 import { entitiesListCommand, entitiesGetCommand, entitiesCreateCommand, entitiesUpdateCommand, entitiesDeleteCommand, entitiesEdgesCommand } from '../src/commands/entities.js';
-import { recipesListCommand, recipesGetCommand, recipesCreateCommand, recipesDeleteCommand } from '../src/commands/recipes.js';
-import { relationshipTypesListCommand } from '../src/commands/relationship-types.js';
+import { recipesListCommand, recipesGetCommand, recipesCreateCommand, recipesUpdateCommand, recipesDeleteCommand } from '../src/commands/recipes.js';
+import { relationshipTypesListCommand, relationshipTypesCreateCommand, relationshipTypesDeleteCommand } 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';
 import { usageCommand, usageHistoryCommand, plansCommand } from '../src/commands/billing.js';
+import { keysListCommand, keysCreateCommand, keysRevokeCommand } from '../src/commands/keys.js';
+import { graphOverviewCommand, graphSearchCommand, graphNodeCommand, graphNeighborsCommand } from '../src/commands/graph.js';
+import { mindPresenceCommand, mindThoughtsCommand } from '../src/commands/mind.js';
+import { settingsShowCommand, settingsUpdateCommand } from '../src/commands/settings.js';
+import { provisionCommand } from '../src/commands/agents.js';
 
 program
   .name('trucontext')
@@ -83,15 +87,6 @@ program.command('recall <query>')
   .option('-d, --depth <n>', 'Graph expansion depth', '2')
   .action(recallCommand);
 
-// Contexts (deprecated — use entities with contexts array)
-const contexts = program.command('contexts').description('Manage contexts (deprecated — use entities)').action(function() { this.help(); });
-contexts.command('list').description('List contexts').action(contextsListCommand);
-contexts.command('create <name>')
-  .description('Create a context')
-  .option('--metadata <json>', 'JSON metadata object')
-  .action(contextsCreateCommand);
-contexts.command('delete <id>').description('Delete a context').action(contextsDeleteCommand);
-
 // Entities
 const entities = program.command('entities').description('Manage entities').action(function() { this.help(); });
 entities.command('list')
@@ -152,15 +147,31 @@ recipes.command('create')
   .option('--decay-profile <text>', 'Decay profile description')
   .option('--confidence-bias <text>', 'Confidence bias description')
   .action(recipesCreateCommand);
+recipes.command('update <recipeId>')
+  .description('Update a custom recipe')
+  .option('--name <name>', 'New name')
+  .option('--file <path>', 'JSON file with updated interpretation')
+  .option('--purpose <text>', 'Update purpose text')
+  .action(recipesUpdateCommand);
 recipes.command('delete <recipeId>')
   .description('Delete a recipe')
   .action(recipesDeleteCommand);
 
 // Relationship Types
-program.command('relationship-types')
+const relTypes = program.command('relationship-types').description('Manage relationship types').action(relationshipTypesListCommand);
+relTypes.command('list')
   .description('List relationship types')
   .option('--category <cat>', 'Filter by category')
   .action(relationshipTypesListCommand);
+relTypes.command('create')
+  .description('Create a custom relationship type')
+  .requiredOption('--type <type>', 'Relationship type (UPPER_SNAKE_CASE)')
+  .requiredOption('--description <text>', 'Description of the relationship')
+  .option('--category <cat>', 'Category (default: Custom)')
+  .action(relationshipTypesCreateCommand);
+relTypes.command('delete <type>')
+  .description('Delete a custom relationship type')
+  .action(relationshipTypesDeleteCommand);
 
 // Schema
 const schema = program.command('schema').description('Manage app schema').action(function() { this.help(); });
@@ -196,8 +207,75 @@ billing.command('plans')
   .description('View available plans')
   .action(plansCommand);
 
+// API Keys
+const keys = program.command('keys').description('Manage API keys').action(keysListCommand);
+keys.command('list').description('List API keys').action(keysListCommand);
+keys.command('create')
+  .description('Create a new API key')
+  .requiredOption('--name <name>', 'Key name')
+  .action(keysCreateCommand);
+keys.command('revoke <keyId>')
+  .description('Revoke an API key')
+  .action(keysRevokeCommand);
+
+// Graph Explorer
+const graph = program.command('graph').description('Explore the knowledge graph').action(function() { this.help(); });
+graph.command('overview')
+  .description('Graph overview (node/edge counts)')
+  .option('-l, --limit <n>', 'Max nodes to return', '100')
+  .action(graphOverviewCommand);
+graph.command('search <query>')
+  .description('Search graph by keyword')
+  .option('--type <type>', 'Filter by node type')
+  .option('-l, --limit <n>', 'Max results', '50')
+  .action(graphSearchCommand);
+graph.command('node <nodeId>')
+  .description('Get detailed node info')
+  .action(graphNodeCommand);
+graph.command('neighbors <nodeId>')
+  .description('Get node neighbors')
+  .option('-l, --limit <n>', 'Max neighbors', '20')
+  .action(graphNeighborsCommand);
+
+// Mind
+const mind = program.command('mind').description('View mind state and thoughts').action(function() { this.help(); });
+mind.command('presence')
+  .description('View consciousness state')
+  .action(mindPresenceCommand);
+mind.command('thoughts')
+  .description('View dream diary')
+  .option('-l, --limit <n>', 'Max entries', '20')
+  .option('-m, --mode <mode>', 'Filter by dream type')
+  .action(mindThoughtsCommand);
+
+// Settings
+const settings = program.command('settings').description('Manage app settings').action(settingsShowCommand);
+settings.command('show').description('Show current settings').action(settingsShowCommand);
+settings.command('update')
+  .description('Update settings')
+  .option('--json <json>', 'JSON object with settings to update')
+  .option('--key <key>', 'Setting key')
+  .option('--value <value>', 'Setting value')
+  .action(settingsUpdateCommand);
+
 // Root nodes + Curiosity (registered as subcommand groups)
 registerRootsCommand(program);
 registerCuriosityCommand(program);
 
+// Agent provision
+const agents = program.command('agents').description('Agent provisioning');
+agents.command('provision')
+  .description('Provision an agent (create or update root node, ingest content, generate memory briefing)')
+  .requiredOption('--agent-id <id>', 'Agent identifier')
+  .requiredOption('--name <name>', 'Agent display name')
+  .requiredOption('--role <role>', 'Agent role description')
+  .option('--user-root <root>', 'User root node ID')
+  .requiredOption('--soul <fileOrText>', 'Path to SOUL.md or inline text')
+  .option('--agents <fileOrText>', 'Path to AGENTS.md or inline text')
+  .option('--identity <fileOrText>', 'Path to IDENTITY.md or inline text')
+  .option('--memory <files...>', 'Path(s) to memory files')
+  .option('--recipe <recipeId>', 'Recipe hint (skip inference)')
+  .option('--dry-run', 'Preview what would happen without doing it')
+  .action(provisionCommand);
+
 program.parse();

package/package.json

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

package/src/commands/agents.js

@@ -0,0 +1,75 @@
+// commands/agents.js — Agent Provision CLI
+//
+// trucontext agents provision --agent-id <id> --name <name> --role <role> \
+//   --user-root <root> --soul <file> [--agents <file>] [--identity <file>] \
+//   [--memory <file>...] [--recipe <recipeId>] [--dry-run]
+
+import { readFileSync, existsSync } from 'fs';
+import { dataPlane } from '../client.js';
+import { getConfig } from '../config.js';
+
+export async function provisionCommand(options) {
+  const config = getConfig();
+  if (!config.activeApp) {
+    console.error('No active app. Run: trucontext use <app>');
+    process.exit(1);
+  }
+
+  const { agentId, name, role, userRoot, soul, agents, identity, memory, recipe, dryRun } = options;
+
+  // Read file contents
+  const soulText = readFileOrText(soul);
+  if (!soulText) {
+    console.error('--soul is required (file path or inline text)');
+    process.exit(1);
+  }
+
+  const content = {
+    soul: soulText,
+    agents: agents ? readFileOrText(agents) : undefined,
+    identity: identity ? readFileOrText(identity) : undefined,
+    memory: (memory || []).map(m => readFileOrText(m)).filter(Boolean),
+  };
+
+  const body = {
+    agent: { id: agentId, name, role },
+    user: { root_node: userRoot || config.activeRoot || 'dustin' },
+    content,
+    hints: recipe ? { recipe } : {},
+    options: { dry_run: dryRun || false },
+  };
+
+  try {
+    const res = await dataPlane('POST', '/v1/agents/provision', body);
+    const data = res.data;
+
+    if (dryRun) {
+      console.log(`Dry run — would ${data.status === 'would_create' ? 'create' : 'update'}`);
+      console.log(`  Agent root: ${data.agent_root}`);
+      console.log(`  User root: ${data.user_root}`);
+      console.log(`  Changes: ${Object.entries(data.changes || {}).filter(([,v]) => v).map(([k]) => k).join(', ') || 'none'}`);
+      return;
+    }
+
+    console.log(`${data.status === 'created' ? 'Provisioned' : 'Updated'}: ${data.agent_root}`);
+    console.log(`  Recipe: ${data.recipe_id}`);
+    console.log(`  Recipe inference: ${data.recipe_inference}`);
+    console.log(`  Content ingested: soul=${data.content_ingested?.soul}, agents=${data.content_ingested?.agents}, identity=${data.content_ingested?.identity}, memory=${data.content_ingested?.memory_files}`);
+
+    if (data.prompt_fragment) {
+      console.log(`\n--- Prompt Fragment (${data.prompt_fragment.length} chars) ---`);
+      console.log(data.prompt_fragment);
+    }
+  } catch (err) {
+    console.error('Failed:', err.message);
+    process.exit(1);
+  }
+}
+
+function readFileOrText(input) {
+  if (!input) return null;
+  if (existsSync(input)) {
+    return readFileSync(input, 'utf8');
+  }
+  return input;
+}

package/src/commands/curiosity.js

@@ -4,7 +4,7 @@
 // Curiosity analysis is always scoped to a root node's ego network.
 
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getConfig, getActiveApp } from '../config.js';
 
 export function registerCuriosityCommand(program) {
@@ -30,7 +30,7 @@ export function registerCuriosityCommand(program) {
       }
 
       try {
-        const res = await controlPlane('GET', `/apps/${appId}/mind/curiosity?root_id=${rootId}&status=${opts.status}&limit=${opts.limit}`);
+        const res = await dataPlane('GET', `/v1/curiosity?root_id=${rootId}&status=${opts.status}&limit=${opts.limit}`);
         const packets = res.data?.packets || [];
 
         if (packets.length === 0) {
@@ -69,7 +69,7 @@ export function registerCuriosityCommand(program) {
 
       try {
         console.log(chalk.dim(`Triggering curiosity analysis for root: ${rootId}...`));
-        await controlPlane('POST', `/apps/${appId}/mind/curiosity/trigger`, {
+        await dataPlane('POST', `/v1/curiosity`, {
           root_id: rootId,
         });
         console.log(chalk.green(`Curiosity analysis started for root: ${rootId}`));
@@ -87,7 +87,7 @@ export function registerCuriosityCommand(program) {
     .action(async (packetId) => {
       const appId = getActiveApp();
       try {
-        await controlPlane('PUT', `/apps/${appId}/mind/curiosity/${packetId}/dismiss`);
+        await dataPlane('PUT', `/v1/curiosity/${packetId}/dismiss`);
         console.log(chalk.green(`Dismissed: ${packetId}`));
       } catch (err) {
         console.error(chalk.red('Failed:'), err.response?.data?.error || err.message);

package/src/commands/entities.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getActiveApp } from '../config.js';
 
 // Fields stored on the node but not user-declared properties
@@ -46,9 +46,9 @@ export async function entitiesListCommand(options) {
     if (options.scope) params.set('scope', options.scope);
     if (options.limit) params.set('limit', options.limit);
     const qs = params.toString();
-    const path = `/apps/${appId}/entities${qs ? `?${qs}` : ''}`;
+    const path = `/v1/entities${qs ? `?${qs}` : ''}`;
 
-    const res = await controlPlane('GET', path);
+    const res = await dataPlane('GET', path);
     const entities = Array.isArray(res.data) ? res.data : [];
 
     if (entities.length === 0) {
@@ -69,13 +69,13 @@ export async function entitiesListCommand(options) {
 export async function entitiesGetCommand(entityId) {
   try {
     const appId = getActiveApp();
-    const res = await controlPlane('GET', `/apps/${appId}/entities/${entityId}`);
+    const res = await dataPlane('GET', `/v1/entities/${entityId}`);
     const e = res.data;
     displayEntity(e);
 
     // Show edges if available
     try {
-      const edgeRes = await controlPlane('GET', `/apps/${appId}/entities/${entityId}/edges`);
+      const edgeRes = await dataPlane('GET', `/v1/entities/${entityId}/edges`);
       const edges = edgeRes.data;
       if (edges.length > 0) {
         console.log(chalk.dim(`\n  Edges (${edges.length}):`));
@@ -137,7 +137,7 @@ export async function entitiesCreateCommand(options) {
       });
     }
 
-    const res = await controlPlane('POST', `/apps/${appId}/entities`, body);
+    const res = await dataPlane('POST', `/v1/entities`, body);
     const e = res.data;
     console.log(chalk.green(`Created: ${chalk.bold(e.entityId || options.id)}`));
   } catch (err) {
@@ -178,7 +178,7 @@ export async function entitiesUpdateCommand(entityId, options) {
       });
     }
 
-    await controlPlane('PUT', `/apps/${appId}/entities/${entityId}`, body);
+    await dataPlane('PUT', `/v1/entities/${entityId}`, body);
     console.log(chalk.green(`Updated: ${entityId}`));
   } catch (err) {
     console.error(chalk.red(`Failed: ${err.message}`));
@@ -189,7 +189,7 @@ export async function entitiesUpdateCommand(entityId, options) {
 export async function entitiesDeleteCommand(entityId) {
   try {
     const appId = getActiveApp();
-    await controlPlane('DELETE', `/apps/${appId}/entities/${entityId}`);
+    await dataPlane('DELETE', `/v1/entities/${entityId}`);
     console.log(chalk.green(`Deleted: ${entityId}`));
   } catch (err) {
     console.error(chalk.red(`Failed: ${err.message}`));
@@ -200,7 +200,7 @@ export async function entitiesDeleteCommand(entityId) {
 export async function entitiesEdgesCommand(entityId) {
   try {
     const appId = getActiveApp();
-    const res = await controlPlane('GET', `/apps/${appId}/entities/${entityId}/edges`);
+    const res = await dataPlane('GET', `/v1/entities/${entityId}/edges`);
     const edges = Array.isArray(res.data) ? res.data : [];
 
     if (edges.length === 0) {

package/src/commands/graph.js

@@ -0,0 +1,101 @@
+import chalk from 'chalk';
+import { dataPlane } from '../client.js';
+
+export async function graphOverviewCommand(options) {
+  try {
+    const res = await dataPlane('GET', `/v1/graph/overview?limit=${options.limit || 100}`);
+    const data = res.data;
+
+    console.log(chalk.bold('Graph Overview'));
+    if (data.stats) {
+      const s = data.stats;
+      console.log(`  Nodes: ${s.nodeCount || 0}`);
+      console.log(`  Edges: ${s.edgeCount || 0}`);
+      if (s.typeCounts) {
+        console.log('  By type:');
+        for (const [type, count] of Object.entries(s.typeCounts)) {
+          console.log(`    ${type}: ${count}`);
+        }
+      }
+    }
+    if (data.nodes && data.nodes.length > 0) {
+      console.log(`\n  ${data.nodes.length} nodes returned`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function graphSearchCommand(query, options) {
+  try {
+    const params = [`q=${encodeURIComponent(query)}`];
+    if (options.type) params.push(`type=${options.type}`);
+    if (options.limit) params.push(`limit=${options.limit}`);
+    const res = await dataPlane('GET', `/v1/graph/search?${params.join('&')}`);
+    const nodes = res.data?.nodes || res.data || [];
+
+    if (nodes.length === 0) {
+      console.log('No matches found.');
+      return;
+    }
+
+    for (const node of nodes) {
+      const label = node.label || node.displayName || node.name || node.entityId || node.id;
+      const type = node.type || (node.labels || []).filter(l => l !== 'Entity')[0] || '?';
+      console.log(`${chalk.bold(label)} [${type}]`);
+      if (node.snippet) console.log(`  ${chalk.dim(node.snippet.slice(0, 120))}`);
+    }
+    console.log(`\n${nodes.length} result${nodes.length !== 1 ? 's' : ''}`);
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function graphNodeCommand(nodeId) {
+  try {
+    const res = await dataPlane('GET', `/v1/graph/node/${encodeURIComponent(nodeId)}`);
+    const node = res.data;
+    if (!node) {
+      console.log('Node not found.');
+      return;
+    }
+    console.log(chalk.bold(node.label || node.displayName || node.name || nodeId));
+    console.log(`  Type: ${node.type || (node.labels || []).join(', ')}`);
+    if (node.properties) {
+      for (const [k, v] of Object.entries(node.properties)) {
+        console.log(`  ${k}: ${v}`);
+      }
+    }
+    if (node.edges) {
+      console.log(`  Edges: ${node.edges.length}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function graphNeighborsCommand(nodeId, options) {
+  try {
+    const res = await dataPlane('GET', `/v1/graph/neighbors/${encodeURIComponent(nodeId)}?limit=${options.limit || 20}`);
+    const neighbors = res.data?.neighbors || res.data || [];
+
+    if (neighbors.length === 0) {
+      console.log('No neighbors found.');
+      return;
+    }
+
+    for (const n of neighbors) {
+      const label = n.label || n.displayName || n.name || n.entityId || n.id;
+      const type = n.type || '?';
+      const rel = n.relationship || n.edgeType || '';
+      console.log(`  ${rel ? `[${rel}]` : ''} ${chalk.bold(label)} (${type})`);
+    }
+    console.log(`\n${neighbors.length} neighbor${neighbors.length !== 1 ? 's' : ''}`);
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/ingest.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import { readFileSync, existsSync } from 'fs';
 import { basename } from 'path';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getActiveApp } from '../config.js';
 
 export async function ingestCommand(source, options) {
@@ -52,7 +52,7 @@ export async function ingestCommand(source, options) {
       };
     });
 
-    const res = await controlPlane('POST', `/apps/${appId}/ingest`, body);
+    const res = await dataPlane('POST', `/v1/ingest`, body);
     const data = res.data;
     console.log(chalk.green('Accepted'));
     console.log(chalk.dim(`Content ID: ${data.contentId}`));

package/src/commands/init.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import input from '@inquirer/input';
 import select from '@inquirer/select';
-import { controlPlane } from '../client.js';
+import { controlPlane, dataPlane } from '../client.js';
 import { setActiveApp } from '../config.js';
 
 export async function initCommand(name, options) {
@@ -105,7 +105,7 @@ export async function initCommand(name, options) {
     const rootName = await input({ message: 'Display name (e.g., Dustin Henderson):' });
 
     try {
-      await controlPlane('POST', `/apps/${app.appId}/roots`, {
+      await dataPlane('POST', `/v1/roots`, {
         entityId: rootId,
         type: rootType,
         recipe_id: rootRecipe,

package/src/commands/keys.js

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+export async function keysListCommand() {
+  try {
+    const appId = getActiveApp();
+    const res = await controlPlane('GET', `/apps/${appId}/keys`);
+    const keys = Array.isArray(res.data) ? res.data : [];
+
+    if (keys.length === 0) {
+      console.log('No API keys. Create one with: trucontext keys create --name "My Key"');
+      return;
+    }
+
+    for (const key of keys) {
+      const status = key.status === 'active'
+        ? chalk.green('Active')
+        : chalk.red(key.status || 'Unknown');
+      console.log(`${chalk.bold(key.name || key.keyId)} ${status}`);
+      console.log(`  ID: ${key.keyId}`);
+      if (key.createdAt) console.log(`  Created: ${key.createdAt}`);
+      if (key.lastUsed) console.log(`  Last used: ${key.lastUsed}`);
+      console.log('');
+    }
+    console.log(`${keys.length} key${keys.length !== 1 ? 's' : ''}`);
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function keysCreateCommand(options) {
+  try {
+    const appId = getActiveApp();
+    if (!options.name) {
+      console.error(chalk.red('--name is required'));
+      process.exit(1);
+    }
+    const res = await controlPlane('POST', `/apps/${appId}/keys`, { name: options.name });
+    const key = res.data;
+
+    console.log(chalk.green('API Key Created'));
+    console.log(`  Name: ${key.name || options.name}`);
+    console.log(`  Key:  ${chalk.bold(key.plainKey || key.key)}`);
+    console.log('');
+    console.log(chalk.yellow('Save this key now — you will not see it again.'));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function keysRevokeCommand(keyId) {
+  try {
+    const appId = getActiveApp();
+    await controlPlane('DELETE', `/apps/${appId}/keys/${keyId}`);
+    console.log(chalk.green(`Revoked: ${keyId}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/mind.js

@@ -0,0 +1,66 @@
+import chalk from 'chalk';
+import { dataPlane } from '../client.js';
+
+export async function mindPresenceCommand() {
+  try {
+    const res = await dataPlane('GET', '/v1/mind/presence');
+    const p = res.data;
+
+    console.log(chalk.bold('Mind Presence'));
+    if (p.status) console.log(`  Status: ${p.status}`);
+    if (p.lastCycle) console.log(`  Last cycle: ${p.lastCycle}`);
+    if (p.cycleNumber != null) console.log(`  Cycle: ${p.cycleNumber}`);
+    if (p.events != null) console.log(`  Events: ${p.events}`);
+    if (p.insights != null) console.log(`  Insights: ${p.insights}`);
+    if (p.patterns != null) console.log(`  Patterns: ${p.patterns}`);
+    if (p.confirmed != null) console.log(`  Confirmed: ${p.confirmed}`);
+    if (p.rejected != null) console.log(`  Rejected: ${p.rejected}`);
+    if (p.thought) {
+      console.log(`\n  ${chalk.italic(p.thought.slice(0, 200))}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function mindThoughtsCommand(options) {
+  try {
+    const params = [];
+    if (options.limit) params.push(`limit=${options.limit}`);
+    if (options.mode) params.push(`mode=${options.mode}`);
+    const qs = params.length > 0 ? `?${params.join('&')}` : '';
+    const res = await dataPlane('GET', `/v1/mind/thoughts${qs}`);
+    const thoughts = res.data?.thoughts || res.data || [];
+
+    if (thoughts.length === 0) {
+      console.log('No thoughts recorded yet.');
+      return;
+    }
+
+    for (const t of thoughts) {
+      const mode = t.mode || t.dream_type || '?';
+      const cycle = t.cycle_number != null ? `cycle ${t.cycle_number}` : '';
+      const ts = t.created_at || t.createdAt || '';
+      const ago = ts ? timeSince(ts) : '';
+      console.log(`  ${chalk.cyan(`[${mode}]`)} ${cycle} ${chalk.dim(ago)}`);
+      if (t.diary || t.thought) {
+        console.log(`    ${(t.diary || t.thought).slice(0, 200)}`);
+      }
+      console.log('');
+    }
+    console.log(`${thoughts.length} thought${thoughts.length !== 1 ? 's' : ''}`);
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+function timeSince(dateStr) {
+  const diff = Date.now() - new Date(dateStr).getTime();
+  const mins = Math.floor(diff / 60000);
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  return `${Math.floor(hours / 24)}d ago`;
+}

package/src/commands/query.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getConfig, getActiveApp } from '../config.js';
 
 export async function queryCommand(question, options) {
@@ -27,7 +27,7 @@ export async function queryCommand(question, options) {
 
     if (options.context) body.context_id = options.context;
 
-    const res = await controlPlane('POST', `/apps/${appId}/mind/query`, body);
+    const res = await dataPlane('POST', `/v1/query`, body);
     const data = res.data;
 
     // Print answer

package/src/commands/recall.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getConfig, getActiveApp } from '../config.js';
 
 export async function recallCommand(query, options) {
@@ -22,7 +22,7 @@ export async function recallCommand(query, options) {
 
     if (options.context) body.context_id = options.context;
 
-    const res = await controlPlane('POST', `/apps/${appId}/recall`, body);
+    const res = await dataPlane('POST', `/v1/recall`, body);
     const data = res.data;
 
     // Print synthesis

package/src/commands/recipes.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'fs';
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getActiveApp } from '../config.js';
 
 function requireApp() {
@@ -15,7 +15,7 @@ function requireApp() {
 export async function recipesListCommand() {
   try {
     const appId = requireApp();
-    const res = await controlPlane('GET', `/apps/${appId}/recipes`);
+    const res = await dataPlane('GET', `/v1/recipes`);
     const recipes = res.data;
 
     if (recipes.length === 0) {
@@ -36,7 +36,7 @@ export async function recipesListCommand() {
 export async function recipesGetCommand(recipeId) {
   try {
     const appId = requireApp();
-    const res = await controlPlane('GET', `/apps/${appId}/recipes/${recipeId}`);
+    const res = await dataPlane('GET', `/v1/recipes/${recipeId}`);
     const r = res.data;
 
     console.log(chalk.bold(r.recipeId || recipeId));
@@ -138,7 +138,7 @@ export async function recipesCreateCommand(options) {
       if (options.confidenceBias) body.interpretation.confidence_bias = options.confidenceBias;
     }
 
-    const res = await controlPlane('POST', `/apps/${appId}/recipes`, body);
+    const res = await dataPlane('POST', `/v1/recipes`, body);
     const r = res.data;
     console.log(chalk.green(`Created: ${chalk.bold(r.recipeId || options.id)}`));
   } catch (err) {
@@ -147,10 +147,41 @@ export async function recipesCreateCommand(options) {
   }
 }
 
+export async function recipesUpdateCommand(recipeId, options) {
+  try {
+    const appId = requireApp();
+    const body = {};
+
+    if (options.name) body.name = options.name;
+
+    if (options.file) {
+      const fs = await import('fs');
+      const content = fs.readFileSync(options.file, 'utf8');
+      body.interpretation = JSON.parse(content);
+    }
+
+    if (options.purpose) {
+      body.interpretation = body.interpretation || {};
+      body.interpretation.purpose = options.purpose;
+    }
+
+    if (Object.keys(body).length === 0) {
+      console.error(chalk.red('Nothing to update. Provide --name, --file, or --purpose'));
+      process.exit(1);
+    }
+
+    const res = await dataPlane('PUT', `/v1/recipes/${recipeId}`, body);
+    console.log(chalk.green(`Updated: ${recipeId}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
 export async function recipesDeleteCommand(recipeId) {
   try {
     const appId = requireApp();
-    await controlPlane('DELETE', `/apps/${appId}/recipes/${recipeId}`);
+    await dataPlane('DELETE', `/v1/recipes/${recipeId}`);
     console.log(chalk.green(`Deleted: ${recipeId}`));
   } catch (err) {
     console.error(chalk.red(`Failed: ${err.message}`));

package/src/commands/relationship-types.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getActiveApp } from '../config.js';
 
 export async function relationshipTypesListCommand(options) {
@@ -13,9 +13,9 @@ export async function relationshipTypesListCommand(options) {
     const params = new URLSearchParams();
     if (options.category) params.set('category', options.category);
     const qs = params.toString();
-    const path = `/apps/${appId}/relationship-types${qs ? `?${qs}` : ''}`;
+    const path = `/v1/relationship-types${qs ? `?${qs}` : ''}`;
 
-    const res = await controlPlane('GET', path);
+    const res = await dataPlane('GET', path);
     const types = res.data.types;
 
     if (Array.isArray(types) && types.length === 0) {
@@ -54,3 +54,40 @@ export async function relationshipTypesListCommand(options) {
     process.exit(1);
   }
 }
+
+export async function relationshipTypesCreateCommand(options) {
+  try {
+    const appId = getActiveApp();
+    if (!options.type) {
+      console.error(chalk.red('--type is required'));
+      process.exit(1);
+    }
+    if (!options.description) {
+      console.error(chalk.red('--description is required'));
+      process.exit(1);
+    }
+
+    const body = {
+      type: options.type,
+      description: options.description,
+      category: options.category || 'Custom',
+    };
+
+    const res = await dataPlane('POST', '/v1/relationship-types', body);
+    console.log(chalk.green(`Created: ${chalk.bold(res.data.type)}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function relationshipTypesDeleteCommand(type) {
+  try {
+    const appId = getActiveApp();
+    await dataPlane('DELETE', `/v1/relationship-types/${encodeURIComponent(type)}`);
+    console.log(chalk.green(`Deleted: ${type}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/roots.js

@@ -4,7 +4,7 @@
 // carry recipes, and control which dreams run. Queries require a root_id.
 
 import chalk from 'chalk';
-import { controlPlane } from '../client.js';
+import { dataPlane } from '../client.js';
 import { getConfig, saveConfig, getActiveApp } from '../config.js';
 
 export function registerRootsCommand(program) {
@@ -55,7 +55,7 @@ export function registerRootsCommand(program) {
         }
 
         const appId = getActiveApp();
-        const res = await controlPlane('POST', `/apps/${appId}/roots`, body);
+        const res = await dataPlane('POST', `/v1/roots`, body);
         const r = res.data;
         console.log(chalk.green(`Root node created: ${r.entityId}`));
         console.log(`  Type: ${r.type}`);
@@ -75,7 +75,7 @@ export function registerRootsCommand(program) {
     .action(async () => {
       try {
         const appId = getActiveApp();
-        const res = await controlPlane('GET', `/apps/${appId}/roots`);
+        const res = await dataPlane('GET', `/v1/roots`);
         const rootNodes = Array.isArray(res.data) ? res.data : [];
         if (rootNodes.length === 0) {
           console.log('No root nodes. Create one with: trucontext roots create');
@@ -102,7 +102,7 @@ export function registerRootsCommand(program) {
     .action(async (rootId) => {
       try {
         const appId = getActiveApp();
-        const res = await controlPlane('GET', `/apps/${appId}/roots/${rootId}`);
+        const res = await dataPlane('GET', `/v1/roots/${rootId}`);
         const r = res.data;
         console.log(chalk.bold(`Root: ${r.entityId}`));
         console.log(`  Type: ${r.type}`);
@@ -148,7 +148,7 @@ export function registerRootsCommand(program) {
         }
 
         const appId = getActiveApp();
-        await controlPlane('PUT', `/apps/${appId}/roots/${rootId}`, body);
+        await dataPlane('PUT', `/v1/roots/${rootId}`, body);
         console.log(chalk.green(`Updated: ${rootId}`));
       } catch (err) {
         console.error(chalk.red('Failed:'), err.response?.data?.error || err.message);
@@ -163,7 +163,7 @@ export function registerRootsCommand(program) {
     .action(async (rootId) => {
       try {
         const appId = getActiveApp();
-        await controlPlane('DELETE', `/apps/${appId}/roots/${rootId}`);
+        await dataPlane('DELETE', `/v1/roots/${rootId}`);
         console.log(chalk.green(`Demoted: ${rootId} (no longer a root node)`));
 
         const config = getConfig();
@@ -184,7 +184,7 @@ export function registerRootsCommand(program) {
     .action(async (rootId) => {
       try {
         const appId = getActiveApp();
-        await controlPlane('GET', `/apps/${appId}/roots/${rootId}`);
+        await dataPlane('GET', `/v1/roots/${rootId}`);
         const config = getConfig();
         config.activeRoot = rootId;
         saveConfig(config);

package/src/commands/settings.js

@@ -0,0 +1,50 @@
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+export async function settingsShowCommand() {
+  try {
+    const appId = getActiveApp();
+    const res = await controlPlane('GET', `/apps/${appId}/intelligence/debug-settings`);
+    const settings = res.data;
+
+    console.log(chalk.bold('App Settings'));
+    if (typeof settings === 'object') {
+      for (const [k, v] of Object.entries(settings)) {
+        const val = typeof v === 'object' ? JSON.stringify(v) : v;
+        console.log(`  ${k}: ${val}`);
+      }
+    } else {
+      console.log('  No settings configured.');
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function settingsUpdateCommand(options) {
+  try {
+    const appId = getActiveApp();
+    let updates;
+    if (options.json) {
+      try {
+        updates = JSON.parse(options.json);
+      } catch {
+        console.error(chalk.red('Invalid JSON'));
+        process.exit(1);
+      }
+    } else if (options.key && options.value !== undefined) {
+      updates = { [options.key]: options.value };
+    } else {
+      console.error(chalk.red('Provide --json or --key + --value'));
+      process.exit(1);
+    }
+
+    const res = await controlPlane('PUT', `/apps/${appId}/intelligence/debug-settings`, updates);
+    console.log(chalk.green('Settings updated'));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}