avocavo 1.1.4 → 1.2.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to the Avocavo CLI will be documented in this file.
 
+## [1.2.1] - 2026-03-31
+
+### ✨ Conversational Text Analysis
+- **NEW**: Added `avocavo analyze <text>` command to seamlessly parse free-form, conversational meal text.
+- **ENHANCED**: Implemented GPT-backed context inference to automatically resolve missing quantities (e.g., "butter" -> "1 pat butter") instead of reverting to 100g defaults.
+- **IMPROVED**: Standardized JSON output structure to match the `/batch` endpoint schema for unified downstream processing.
+
 ## [1.1.1] - 2025-08-21
 
 ### ✨ UPC/Barcode Search Support

package/README.md

@@ -27,7 +27,7 @@ avocavo --help
 - 🥗 **USDA Database** - Access to comprehensive nutrition data
 - 🧮 **Batch Analysis** - Analyze multiple ingredients at once
 - 📊 **Rich Output** - Beautiful tables and JSON formats
-- 🔒 **SSL Security** - All connections use verified HTTPS
+- 🔒 **SSL Security** - All connections use secured HTTPS
 
 ## 📦 Installation
 
@@ -97,7 +97,7 @@ Remove stored credentials.
 
 ## 🔒 Security
 
-- **SSL Verification**: All API calls use verified HTTPS connections
+- **SSL Verification**: All API calls use secured HTTPS connections
 - **Secure Storage**: Credentials stored in system keychain (not plaintext)
 - **OAuth Flow**: Secure browser-based authentication
 - **No Hardcoded Secrets**: All sensitive data handled securely

package/bin/avocavo.js

@@ -663,6 +663,91 @@ program
     }
   });
 
+// Free-text analyze command
+program
+  .command('analyze <text>')
+  .description('Analyze free-form meal text — AI extracts and looks up each ingredient automatically')
+  .option('--verbose', 'Show detailed USDA info for each ingredient')
+  .action(async (text, options) => {
+    try {
+      const api = await getApiClient();
+      const globalOpts = program.opts();
+      const verbose = options.verbose || globalOpts.verbose;
+
+      console.log(chalk.cyan(`🤖 Analyzing: "${text}"...`));
+
+      const result = await api.analyzeText(text, verbose);
+
+      if (program.opts().json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      if (result.success) {
+        // Show what the AI extracted
+        const extracted = result.extracted_ingredients || [];
+        if (extracted.length > 0) {
+          console.log('');
+          console.log(chalk.bold('🔍 Detected ingredients:'));
+          extracted.forEach(ing => console.log(chalk.gray(`   • ${ing}`)));
+        }
+
+        console.log('');
+        console.log(chalk.green(`✅ Analysis complete — ${result.summary.successful}/${result.batch_size || extracted.length} items matched`));
+        console.log('');
+
+        // Results table (same style as batch)
+        const tableData = (result.results || []).map(item => [
+          item.success ? '✅' : '❌',
+          item.ingredient,
+          item.success ? `${item.nutrition.calories}` : 'N/A',
+          item.success ? `${item.nutrition.protein}g` : 'N/A',
+          item.success ? `${item.nutrition.total_fat}g` : 'N/A',
+          item.success ? `${item.nutrition.carbohydrates}g` : 'N/A',
+          item.success ? `${item.nutrition.fiber}g` : 'N/A',
+          item.success ? `${item.nutrition.sodium}mg` : 'N/A'
+        ]);
+
+        if (tableData.length > 0) {
+          console.log(formatTable([
+            ['Status', 'Ingredient', 'Calories', 'Protein', 'Fat', 'Carbs', 'Fiber', 'Sodium'],
+            ...tableData
+          ]));
+        }
+
+        // Total calories summary
+        const totalCal = (result.results || [])
+          .filter(i => i.success)
+          .reduce((sum, i) => sum + (i.nutrition?.calories || 0), 0);
+        if (totalCal > 0) {
+          console.log('');
+          console.log(chalk.bold(`🔥 Total Calories: ${chalk.yellow(totalCal.toFixed(1))} kcal`));
+        }
+
+        // USDA sources (with --verbose)
+        if (verbose) {
+          const withUSDA = (result.results || []).filter(i => i.success && i.metadata?.usda_match);
+          if (withUSDA.length > 0) {
+            console.log('');
+            console.log(chalk.bold('🔗 USDA Sources:'));
+            withUSDA.forEach(item => {
+              const usda = item.metadata.usda_match;
+              console.log(chalk.gray(`  ${item.ingredient} → ${usda.description} (FDC: ${usda.fdc_id})`));
+            });
+          }
+        }
+
+      } else {
+        console.log(chalk.red(`❌ ${result.error || 'Analysis failed'}`));
+        console.log(chalk.cyan('💡 Try rephrasing or use: avocavo batch --ingredients "item1" "item2"'));
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red(`❌ Analyze error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
 // UPC/Barcode search command
 program
   .command('upc <upc>')

package/lib/api.js

@@ -41,6 +41,17 @@ class NutritionAPI {
     }
   }
 
+  async analyzeText(text, verbose = false) {
+    try {
+      const response = await this.client.post(`${this.baseUrl}/api/v2/nutrition/analyze`, {
+        text: text
+      });
+      return response.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
   async analyzeRecipe(ingredients, servings = 1, verbose = false) {
     try {
       const response = await this.client.post(`${this.baseUrl}/api/v2/nutrition/recipe`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avocavo",
-  "version": "1.1.4",
+  "version": "1.2.1",
   "description": "Avocavo CLI - Structured nutrition data API with USDA-based calculations where applicable. Consistent nutrition estimates for apps and workflows. For informational use only. Not affiliated with or endorsed by USDA.",
   "main": "index.js",
   "bin": {