trucontext 0.9.0 → 0.9.2

package/bin/cli.js

@@ -13,7 +13,7 @@ import { ingestCommand } from '../src/commands/ingest.js';
 import { queryCommand } from '../src/commands/query.js';
 import { recallCommand } from '../src/commands/recall.js';
 import { schemaShowCommand, schemaGenerateCommand, schemaSetAuthorshipCommand } from '../src/commands/schema.js';
-import { entitiesListCommand, entitiesGetCommand, entitiesCreateCommand, entitiesUpdateCommand, entitiesDeleteCommand, entitiesEdgesCommand } from '../src/commands/entities.js';
+import { entitiesListCommand, entitiesGetCommand, entitiesCreateCommand, entitiesUpdateCommand, entitiesDeleteCommand, entitiesEdgesCommand, edgesCreateCommand, edgesDeleteCommand } from '../src/commands/entities.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';
@@ -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')
@@ -128,6 +129,19 @@ entities.command('delete <entityId>')
 entities.command('edges <entityId>')
   .description('List edges for an entity')
   .action(entitiesEdgesCommand);
+entities.command('edges-create')
+  .description('Create an edge between two entities')
+  .requiredOption('--type <type>', 'Edge type (UPPER_SNAKE_CASE)')
+  .requiredOption('--from <entityId>', 'Source entity ID')
+  .requiredOption('--to <entityId>', 'Target entity ID')
+  .option('--properties <json>', 'Edge properties as JSON')
+  .action(edgesCreateCommand);
+entities.command('edges-delete')
+  .description('Delete an edge between two entities')
+  .requiredOption('--type <type>', 'Edge type')
+  .requiredOption('--from <entityId>', 'Source entity ID')
+  .requiredOption('--to <entityId>', 'Target entity ID')
+  .action(edgesDeleteCommand);
 
 // Recipes
 const recipes = program.command('recipes').description('Manage recipes').action(function() { this.help(); });
@@ -261,4 +275,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.2",
   "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/entities.js

@@ -197,6 +197,64 @@ export async function entitiesDeleteCommand(entityId) {
   }
 }
 
+export async function edgesCreateCommand(options) {
+  try {
+    const body = {
+      type: options.type,
+      from: {},
+      to: {},
+    };
+
+    // From reference
+    if (options.from) body.from.entityId = options.from;
+    if (options.fromType && options.fromKey) {
+      body.from = { nodeType: options.fromType, key: JSON.parse(options.fromKey) };
+    }
+
+    // To reference
+    if (options.to) body.to.entityId = options.to;
+    if (options.toType && options.toKey) {
+      body.to = { nodeType: options.toType, key: JSON.parse(options.toKey) };
+    }
+
+    // Properties
+    if (options.properties) {
+      try {
+        body.properties = JSON.parse(options.properties);
+      } catch {
+        console.error(chalk.red('Invalid properties JSON'));
+        process.exit(1);
+      }
+    }
+
+    const res = await dataPlane('POST', '/v1/entities/edges', body);
+    const edge = res.data;
+    console.log(chalk.green(`Edge created: ${edge.source || options.from} -[${chalk.cyan(options.type)}]-> ${edge.target || options.to}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function edgesDeleteCommand(options) {
+  try {
+    const body = {
+      type: options.type,
+      from: {},
+      to: {},
+    };
+
+    if (options.from) body.from.entityId = options.from;
+    if (options.to) body.to.entityId = options.to;
+
+    await dataPlane('DELETE', '/v1/entities/edges', body);
+    console.log(chalk.green(`Edge deleted: ${options.from} -[${options.type}]-> ${options.to}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
 export async function entitiesEdgesCommand(entityId) {
   try {
     const appId = getActiveApp();

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}`));