avocavo 1.1.3 → 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

@@ -1,6 +1,6 @@
 # 🥑 Avocavo CLI
 
-> Nutrition analysis made simple. Get accurate USDA nutrition data with secure authentication.
+> Structured nutrition data API with USDA-based calculations where applicable. Consistent nutrition estimates for apps and workflows.
 
 ## 🚀 Quick Start
 
@@ -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
 
@@ -58,7 +58,7 @@ Analyze a single ingredient:
 ```bash
 avocavo ingredient "1 cup brown rice"
 avocavo ingredient "200g chicken breast"
-avocavo ingredient "1 cup rice" -v     # Include USDA verification URL
+avocavo ingredient "1 cup rice" -v     # Include USDA FDC source URL
 ```
 
 ### `avocavo recipe [options]`
@@ -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

@@ -57,7 +57,7 @@ function secureReadFile(filePath) {
 
 program
   .name('avocavo')
-  .description('Avocavo Nutrition API CLI - Fast, accurate nutrition data with USDA verification')
+  .description('Avocavo Nutrition API CLI - Structured nutrition data with USDA-based calculations and ingredient normalization')
   .version(version);
 
 // Global options
@@ -346,7 +346,7 @@ keysCmd
 program
   .command('ingredient <ingredient>')
   .description('Analyze a single ingredient for nutrition data')
-  .option('-v, --verify', 'Include USDA verification URL')
+  .option('-v, --verify', 'Include USDA FDC source URL')
   .option('--verbose', 'Show detailed performance metrics and USDA info')
   .option('--debug', 'Show all available data (same as --json)')
   .option('--timing', 'Show processing time')
@@ -441,7 +441,7 @@ program
   .option('-s, --servings <number>', 'Number of servings', '1')
   .option('-i, --ingredients <ingredients...>', 'Recipe ingredients')
   .option('-f, --file <file>', 'Read ingredients from file (one per line)')
-  .option('-v, --verify', 'Include USDA verification URLs for ingredients')
+  .option('-v, --verify', 'Include USDA FDC source URLs for ingredients')
   .option('--verbose', 'Show detailed performance metrics and USDA info')
   .option('--debug', 'Show all available data (same as --json)')
   .action(async (options) => {
@@ -529,7 +529,7 @@ program
 
             // Clean default: just show count
             const usdaCount = ingredientsWithUSDA.length;
-            console.log(chalk.gray(`🎯 USDA verified: ${usdaCount}/${ingredients.length} ingredients`));
+            console.log(chalk.gray(`🎯 USDA matched: ${usdaCount}/${ingredients.length} ingredients`));
 
             // Detailed USDA info with --verbose or --verify
             if (options.verbose || options.verify) {
@@ -641,7 +641,7 @@ program
         // Show USDA verification details for successful ingredients
         if (result.results.some(item => item.success && item.metadata?.usda_match)) {
           console.log('');
-          console.log(chalk.bold('🔗 USDA Verification:'));
+          console.log(chalk.bold('🔗 USDA Sources:'));
           result.results.forEach(item => {
             if (item.success && item.metadata?.usda_match) {
               const usda = item.metadata.usda_match;
@@ -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>')
@@ -1014,7 +1099,7 @@ Examples:
   $ avocavo keys switch                    # Switch active API key (interactive)
   $ avocavo keys delete                    # Delete API key (interactive)
   $ avocavo ingredient "1 cup rice"        # Analyze single ingredient
-  $ avocavo ingredient "1 cup rice" -v     # Include USDA verification URL
+  $ avocavo ingredient "1 cup rice" -v     # Include USDA FDC source URL
   $ avocavo recipe -i "2 cups flour" "1 cup milk" -s 8  # Analyze recipe
   $ avocavo batch -i "1 cup rice" "2 tbsp oil" "4 oz chicken"  # Batch analysis
   $ avocavo upc "041196912395"             # Search UPC/barcode

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/lib/formatters.js

@@ -148,7 +148,7 @@ function formatUSDAMatch(usda, verificationUrl) {
     lines.push(`  🔗 Verify: ${chalk.underline(verificationUrl)}`);
   }
   
-  return '\n' + chalk.gray('USDA Verification:') + '\n' + lines.join('\n');
+  return '\n' + chalk.gray('USDA Source:') + '\n' + lines.join('\n');
 }
 
 function formatTable(data, options = {}) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "avocavo",
-  "version": "1.1.3",
-  "description": "Avocavo CLI - Nutrition analysis made simple. Get accurate USDA nutrition data with secure authentication.",
+  "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": {
     "avocavo": "bin/avocavo.js"