trucontext 0.4.1 → 0.5.1

package/bin/cli.js

@@ -139,10 +139,11 @@ recipes.command('get <recipeId>')
   .description('Get recipe details')
   .action(recipesGetCommand);
 recipes.command('create')
-  .description('Create a recipe')
-  .requiredOption('--id <recipeId>', 'Recipe ID')
-  .requiredOption('--name <name>', 'Recipe name')
-  .requiredOption('--purpose <text>', 'Recipe purpose')
+  .description('Create a custom recipe. --id and --name are always required. Provide the interpretation via --file (JSON) or inline flags.')
+  .requiredOption('--id <recipeId>', 'Recipe ID (e.g., my-health-score)')
+  .requiredOption('--name <name>', 'Recipe display name')
+  .option('--file <path>', 'JSON file containing the interpretation block (the WHY)')
+  .option('--purpose <text>', 'Recipe purpose (inline alternative to --file)')
   .option('--decay-profile <text>', 'Decay profile description')
   .option('--confidence-bias <text>', 'Confidence bias description')
   .action(recipesCreateCommand);

package/package.json

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

package/src/client.js

@@ -1,20 +1,16 @@
 // client.js — HTTP client for both API planes
-// Auto-refreshes JWT, attaches active app header.
+// Auto-refreshes JWT, auto-prefixes appId in data plane paths.
 
 import { ensureFreshToken } from './auth.js';
 import { getActiveApp, DATA_PLANE_URL, CONTROL_PLANE_URL } from './config.js';
 
 async function request(baseUrl, method, path, body, retry = true) {
   const token = await ensureFreshToken();
-  const activeApp = getActiveApp();
 
   const headers = {
     'Authorization': `Bearer ${token}`,
     'Content-Type': 'application/json',
   };
-  if (activeApp) {
-    headers['X-TruContext-App'] = activeApp;
-  }
 
   const ac = new AbortController();
   const timeout = setTimeout(() => ac.abort(), 15000);
@@ -69,7 +65,13 @@ async function handleResponse(res) {
 // --- Public API ---
 
 export function dataPlane(method, path, body) {
-  return request(DATA_PLANE_URL, method, path, body);
+  const appId = getActiveApp();
+  if (!appId) {
+    throw new Error('No active app. Run: trucontext use <app-id>');
+  }
+  // Auto-prefix: /v1/entities → /v1/apps/{appId}/entities
+  const appPath = path.replace(/^\/v1\//, `/v1/apps/${appId}/`);
+  return request(DATA_PLANE_URL, method, appPath, body);
 }
 
 export function controlPlane(method, path, body) {

package/src/commands/recipes.js

@@ -1,3 +1,4 @@
+import { readFileSync } from 'fs';
 import chalk from 'chalk';
 import { controlPlane } from '../client.js';
 import { getActiveApp } from '../config.js';
@@ -107,19 +108,35 @@ export async function recipesCreateCommand(options) {
       console.error(chalk.red('--name is required'));
       process.exit(1);
     }
-    if (!options.purpose) {
-      console.error(chalk.red('--purpose is required'));
-      process.exit(1);
-    }
 
     const body = {
       recipeId: options.id,
       name: options.name,
-      purpose: options.purpose,
     };
 
-    if (options.decayProfile) body.decay_profile = options.decayProfile;
-    if (options.confidenceBias) body.confidence_bias = options.confidenceBias;
+    // --file provides the full interpretation block as JSON
+    if (options.file) {
+      try {
+        const raw = readFileSync(options.file, 'utf8');
+        body.interpretation = JSON.parse(raw);
+        if (!body.interpretation.purpose) {
+          console.error(chalk.red('File must contain a "purpose" field'));
+          process.exit(1);
+        }
+      } catch (e) {
+        console.error(chalk.red(`Failed to read --file: ${e.message}`));
+        process.exit(1);
+      }
+    } else {
+      // Inline flags → build interpretation object
+      if (!options.purpose) {
+        console.error(chalk.red('--purpose is required (or use --file to provide the full interpretation)'));
+        process.exit(1);
+      }
+      body.interpretation = { purpose: options.purpose };
+      if (options.decayProfile) body.interpretation.decay_profile = options.decayProfile;
+      if (options.confidenceBias) body.interpretation.confidence_bias = options.confidenceBias;
+    }
 
     const res = await controlPlane('POST', `/apps/${appId}/recipes`, body);
     const r = res.data || res;