trucontext 0.2.1 → 0.3.1

package/bin/cli.js

@@ -11,14 +11,14 @@ 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 } from '../src/commands/entities.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';
 
 program
   .name('trucontext')
   .description('TruContext CLI — contextual memory for AI applications')
-  .version('0.2.1');
+  .version('0.3.1');
 
 // Auth
 program.command('login')
@@ -88,7 +88,9 @@ const entities = program.command('entities').description('Manage entities').acti
 entities.command('list')
   .description('List entities')
   .option('--type <type>', 'Filter by entity type')
-  .option('-l, --limit <n>', 'Max results')
+  .option('--context <id>', 'Filter by context')
+  .option('--scope <scope>', 'Filter by scope')
+  .option('-l, --limit <n>', 'Max results (default: 50)')
   .action(entitiesListCommand);
 entities.command('get <entityId>')
   .description('Get an entity')
@@ -114,10 +116,14 @@ entities.command('update <entityId>')
   .option('--confidence <n>', 'Confidence level (0.0-1.0)')
   .option('--temporal', 'Content can decay over time')
   .option('--no-temporal', 'Content is a permanent fact')
+  .option('-c, --context <entry>', 'Link to context (entity-id:RELATIONSHIP, repeatable)', (val, prev) => [...prev, val], [])
   .action(entitiesUpdateCommand);
 entities.command('delete <entityId>')
   .description('Delete an entity')
   .action(entitiesDeleteCommand);
+entities.command('edges <entityId>')
+  .description('List edges for an entity')
+  .action(entitiesEdgesCommand);
 
 // Recipes
 const recipes = program.command('recipes').description('Manage recipes').action(function() { this.help(); });

package/package.json

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

package/src/commands/entities.js

@@ -1,10 +1,47 @@
 import chalk from 'chalk';
 import { dataPlane } from '../client.js';
 
+// Fields stored on the node but not user-declared properties
+const SYSTEM_FIELDS = new Set([
+  'tenantId', 'entityId', 'provenance', 'scope', 'createdAt', 'updatedAt',
+  'lastReinforcedAt', 'confidence', 'temporal', 'heartbeat_enabled', 'recipe_id',
+]);
+
+function displayEntity(e) {
+  const props = e.properties || {};
+  const type = e.type || e.labels?.[0] || 'Unknown';
+  const entityId = e.entityId || props.entityId;
+  const confidence = e.confidence ?? props.confidence;
+  const temporal = e.temporal ?? props.temporal;
+  const recipeId = e.recipe_id ?? props.recipe_id;
+  const heartbeat = e.heartbeat_enabled ?? props.heartbeat_enabled;
+  const provenance = e.provenance ?? props.provenance;
+
+  console.log(`${chalk.bold(entityId)} ${chalk.dim(`[${type}]`)}`);
+  if (provenance) console.log(`  provenance: ${chalk.dim(provenance)}`);
+  if (recipeId) console.log(`  recipe: ${chalk.cyan(recipeId)}`);
+  if (confidence !== undefined) console.log(`  confidence: ${chalk.dim(confidence)}`);
+  if (temporal !== undefined) console.log(`  temporal: ${chalk.dim(temporal)}`);
+  if (heartbeat !== undefined) console.log(`  heartbeat: ${chalk.dim(heartbeat)}`);
+
+  // Show user-declared properties (exclude system fields)
+  const userProps = {};
+  for (const [k, v] of Object.entries(props)) {
+    if (!SYSTEM_FIELDS.has(k) && v !== null && v !== undefined) {
+      userProps[k] = v;
+    }
+  }
+  if (Object.keys(userProps).length > 0) {
+    console.log(`  properties: ${chalk.dim(JSON.stringify(userProps))}`);
+  }
+}
+
 export async function entitiesListCommand(options) {
   try {
     const params = new URLSearchParams();
     if (options.type) params.set('type', options.type);
+    if (options.context) params.set('context_id', options.context);
+    if (options.scope) params.set('scope', options.scope);
     if (options.limit) params.set('limit', options.limit);
     const qs = params.toString();
     const path = `/v1/entities${qs ? `?${qs}` : ''}`;
@@ -18,15 +55,9 @@ export async function entitiesListCommand(options) {
     }
 
     for (const e of entities) {
-      console.log(`${chalk.bold(e.entityId)} ${chalk.dim(`[${e.type}]`)}`);
-      if (e.recipe_id) console.log(`  recipe: ${chalk.dim(e.recipe_id)}`);
-      if (e.properties && Object.keys(e.properties).length > 0) {
-        console.log(`  properties: ${chalk.dim(JSON.stringify(e.properties))}`);
-      }
-      if (e.heartbeat_enabled !== undefined) console.log(`  heartbeat: ${chalk.dim(e.heartbeat_enabled)}`);
-      if (e.confidence !== undefined) console.log(`  confidence: ${chalk.dim(e.confidence)}`);
-      if (e.temporal !== undefined) console.log(`  temporal: ${chalk.dim(e.temporal)}`);
+      displayEntity(e);
     }
+    console.log(chalk.dim(`\n${entities.length} entities`));
   } catch (err) {
     console.error(chalk.red(`Failed: ${err.message}`));
     process.exit(1);
@@ -37,15 +68,22 @@ export async function entitiesGetCommand(entityId) {
   try {
     const res = await dataPlane('GET', `/v1/entities/${entityId}`);
     const e = res.data || res;
-
-    console.log(`${chalk.bold(e.entityId)} ${chalk.dim(`[${e.type}]`)}`);
-    if (e.recipe_id) console.log(`  recipe: ${chalk.dim(e.recipe_id)}`);
-    if (e.properties && Object.keys(e.properties).length > 0) {
-      console.log(`  properties: ${chalk.dim(JSON.stringify(e.properties))}`);
+    displayEntity(e);
+
+    // Show edges if available
+    try {
+      const edgeRes = await dataPlane('GET', `/v1/entities/${entityId}/edges`);
+      const edges = edgeRes.data?.edges || edgeRes.data || [];
+      if (edges.length > 0) {
+        console.log(chalk.dim(`\n  Edges (${edges.length}):`));
+        for (const edge of edges) {
+          const dir = edge.direction === 'outgoing' ? '→' : '←';
+          console.log(`    ${dir} ${chalk.cyan(edge.type)} ${chalk.dim(edge.targetEntityId || edge.targetLabel || edge.target || '')}`);
+        }
+      }
+    } catch {
+      // Edge listing may not be available — skip silently
     }
-    if (e.heartbeat_enabled !== undefined) console.log(`  heartbeat: ${chalk.dim(e.heartbeat_enabled)}`);
-    if (e.confidence !== undefined) console.log(`  confidence: ${chalk.dim(e.confidence)}`);
-    if (e.temporal !== undefined) console.log(`  temporal: ${chalk.dim(e.temporal)}`);
   } catch (err) {
     console.error(chalk.red(`Failed: ${err.message}`));
     process.exit(1);
@@ -122,6 +160,19 @@ export async function entitiesUpdateCommand(entityId, options) {
     if (options.confidence !== undefined) body.confidence = parseFloat(options.confidence);
     if (options.temporal !== undefined) body.temporal = options.temporal;
 
+    if (options.context?.length > 0) {
+      body.contexts = options.context.map(entry => {
+        const colonIdx = entry.indexOf(':');
+        if (colonIdx === -1) {
+          return { context_id: entry, relationship: 'ABOUT' };
+        }
+        return {
+          context_id: entry.slice(0, colonIdx),
+          relationship: entry.slice(colonIdx + 1),
+        };
+      });
+    }
+
     await dataPlane('PUT', `/v1/entities/${entityId}`, body);
     console.log(chalk.green(`Updated: ${entityId}`));
   } catch (err) {
@@ -139,3 +190,27 @@ export async function entitiesDeleteCommand(entityId) {
     process.exit(1);
   }
 }
+
+export async function entitiesEdgesCommand(entityId) {
+  try {
+    const res = await dataPlane('GET', `/v1/entities/${entityId}/edges`);
+    const edges = res.data?.edges || res.data || [];
+
+    if (edges.length === 0) {
+      console.log(chalk.yellow('No edges found.'));
+      return;
+    }
+
+    for (const edge of edges) {
+      const dir = edge.direction === 'outgoing' ? '→' : '←';
+      console.log(`  ${dir} ${chalk.cyan(edge.type)} ${chalk.dim(edge.targetEntityId || edge.targetLabel || '')}`);
+      if (edge.properties && Object.keys(edge.properties).length > 0) {
+        console.log(`    ${chalk.dim(JSON.stringify(edge.properties))}`);
+      }
+    }
+    console.log(chalk.dim(`\n${edges.length} edges`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}