trucontext 0.7.1 → 0.8.1

package/bin/cli.js

@@ -19,6 +19,8 @@ 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';
+import { usageCommand, usageHistoryCommand, plansCommand } from '../src/commands/billing.js';
 
 program
   .name('trucontext')
@@ -133,9 +135,6 @@ entities.command('edges <entityId>')
   .description('List edges for an entity')
   .action(entitiesEdgesCommand);
 
-// Root Nodes
-registerRootsCommand(program);
-
 // Recipes
 const recipes = program.command('recipes').description('Manage recipes').action(function() { this.help(); });
 recipes.command('list')
@@ -181,4 +180,22 @@ const docs = program.command('docs').description('Browse API documentation').act
 docs.command('list').description('List all doc sections').action(docsListCommand);
 docs.command('show <slug>').description('Show a specific doc section').action(docsShowCommand);
 
+// Billing & Usage
+const billing = program.command('billing').description('View usage and billing').action(function() { this.help(); });
+billing.command('usage')
+  .description('View current usage metrics')
+  .option('-p, --period <period>', 'Period: current, today, week, month, year', 'current')
+  .action(usageCommand);
+billing.command('history')
+  .description('View usage history with time series data')
+  .option('-p, --period <period>', 'Period: today, week, month, 6months, year, ytd', 'month')
+  .action(usageHistoryCommand);
+billing.command('plans')
+  .description('View available plans')
+  .action(plansCommand);
+
+// Root nodes + Curiosity (registered as subcommand groups)
+registerRootsCommand(program);
+registerCuriosityCommand(program);
+
 program.parse();

package/package.json

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

package/src/commands/billing.js

@@ -0,0 +1,134 @@
+// billing.js — Usage and billing commands
+//
+// View API call counts, token usage, storage, and processing time.
+// Data is tracked per-app per-period (daily/monthly).
+
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+function requireApp() {
+  const appId = getActiveApp();
+  if (!appId) {
+    console.error(chalk.red('No active app. Run: trucontext use <app>'));
+    process.exit(1);
+  }
+  return appId;
+}
+
+function formatNumber(n) {
+  if (n === null || n === undefined) return '0';
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`;
+  return String(n);
+}
+
+function formatBytes(bytes) {
+  if (!bytes) return '0 B';
+  if (bytes >= 1_073_741_824) return `${(bytes / 1_073_741_824).toFixed(1)} GB`;
+  if (bytes >= 1_048_576) return `${(bytes / 1_048_576).toFixed(1)} MB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${bytes} B`;
+}
+
+function formatMs(ms) {
+  if (!ms) return '0.0 min';
+  if (ms >= 60_000) return `${(ms / 60_000).toFixed(1)} min`;
+  return `${(ms / 1000).toFixed(1)} sec`;
+}
+
+export async function usageCommand(options) {
+  try {
+    const appId = requireApp();
+    const period = options.period || 'current';
+    const res = await controlPlane('GET', `/billing/usage/${appId}?period=${period}`);
+    const usage = res.data?.data || res.data || {};
+
+    if (!usage || (!usage.apiCalls && !usage.llmInputTokens && !usage.processingMs)) {
+      console.log(chalk.yellow('No usage data available.'));
+      return;
+    }
+
+    console.log(chalk.bold('Usage Summary') + chalk.dim(` — ${period}`));
+    console.log();
+    console.log(`  API Calls:    ${chalk.bold(formatNumber(usage.apiCalls || 0))}${usage.limits?.apiCalls ? chalk.dim(` of ${formatNumber(usage.limits.apiCalls)}`) : ''}`);
+    console.log(`  Tokens:       ${chalk.bold(formatNumber((usage.llmInputTokens || 0) + (usage.llmOutputTokens || 0)))}${usage.limits?.llmTokens ? chalk.dim(` of ${formatNumber(usage.limits.llmTokens)}`) : ''}`);
+    console.log(`    Input:      ${chalk.dim(formatNumber(usage.llmInputTokens || 0))}`);
+    console.log(`    Output:     ${chalk.dim(formatNumber(usage.llmOutputTokens || 0))}`);
+    console.log(`  Compute Units: ${chalk.bold(formatNumber(usage.computeUnits || 0))}`);
+    console.log(`  Storage:      ${chalk.bold(formatBytes(usage.storageBytes || 0))}${usage.limits?.storageGb ? chalk.dim(` of ${usage.limits.storageGb} GB`) : ''}`);
+    console.log(`  Processing:   ${chalk.bold(formatMs(usage.processingMs || 0))}${usage.limits?.processingMinutes ? chalk.dim(` of ${usage.limits.processingMinutes} min`) : ''}`);
+
+    if (usage.planTier) {
+      console.log();
+      console.log(`  Plan:         ${chalk.cyan(usage.planTier)}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function usageHistoryCommand(options) {
+  try {
+    const appId = requireApp();
+    const period = options.period || 'month';
+    const res = await controlPlane('GET', `/billing/usage/${appId}/history?period=${period}&sources=true`);
+    const historyData = res.data?.data || res.data || {};
+    const history = historyData.history || [];
+
+    if (history.length === 0) {
+      console.log(chalk.yellow(`No usage history for period: ${period}`));
+      return;
+    }
+
+    console.log(chalk.bold(`Usage History`) + chalk.dim(` — ${period} (${history.length} entries)`));
+    console.log();
+    console.log(chalk.dim('  Date              API Calls   Tokens      Source'));
+    console.log(chalk.dim('  ────              ─────────   ──────      ──────'));
+
+    for (const entry of history) {
+      const date = entry.date || entry.period || '—';
+      const calls = formatNumber(entry.apiCalls || 0);
+      const tokens = formatNumber((entry.inputTokens || 0) + (entry.outputTokens || 0));
+      const source = entry.source || '—';
+      console.log(`  ${date.padEnd(18)} ${calls.padEnd(12)} ${tokens.padEnd(12)} ${chalk.dim(source)}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function plansCommand() {
+  try {
+    const res = await controlPlane('GET', '/billing/plans');
+    const plansData = res.data?.data || res.data || {};
+    const plans = plansData.plans || [];
+
+    if (plans.length === 0) {
+      console.log(chalk.yellow('No plans available.'));
+      return;
+    }
+
+    console.log(chalk.bold('Available Plans'));
+    console.log();
+
+    for (const plan of plans) {
+      const current = plan.current ? chalk.green(' (current)') : '';
+      console.log(`  ${chalk.bold(plan.name || plan.tier)}${current}`);
+      if (plan.price) console.log(`    Price: ${plan.price}`);
+      if (plan.description) console.log(`    ${chalk.dim(plan.description)}`);
+      if (plan.limits) {
+        const limits = plan.limits;
+        if (limits.apiCalls) console.log(`    API Calls: ${formatNumber(limits.apiCalls)}/mo`);
+        if (limits.tokens) console.log(`    Tokens: ${formatNumber(limits.tokens)}/mo`);
+        if (limits.storageBytes) console.log(`    Storage: ${formatBytes(limits.storageBytes)}`);
+      }
+      console.log();
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

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