trucontext 0.5.0 → 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.5.0",
+  "version": "0.5.1",
   "description": "TruContext CLI — contextual memory for AI applications",
   "type": "module",
   "bin": {

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;