trucontext 0.9.0 → 0.9.1

package/bin/cli.js

@@ -24,6 +24,7 @@ import { keysListCommand, keysCreateCommand, keysRevokeCommand } from '../src/co
 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')
@@ -261,4 +262,20 @@ settings.command('update')
 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.9.0",
+  "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/settings.js

@@ -5,7 +5,7 @@ import { getActiveApp } from '../config.js';
 export async function settingsShowCommand() {
   try {
     const appId = getActiveApp();
-    const res = await controlPlane('GET', `/apps/${appId}/settings`);
+    const res = await controlPlane('GET', `/apps/${appId}/intelligence/debug-settings`);
     const settings = res.data;
 
     console.log(chalk.bold('App Settings'));
@@ -41,7 +41,7 @@ export async function settingsUpdateCommand(options) {
       process.exit(1);
     }
 
-    const res = await controlPlane('PUT', `/apps/${appId}/settings`, updates);
+    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}`));