FoodFinder feature: AI-powered food identification for carb entry

Common/Models/BuildDetails.swift

@@ -65,5 +65,20 @@ class BuildDetails {
     var workspaceGitBranch: String? {
         return dict["com-loopkit-LoopWorkspace-git-branch"] as? String
     }
+
+    /// Returns a dictionary of submodule details.
+    /// The keys are the submodule names, and the values are tuples (branch, commitSHA).
+    var submodules: [String: (branch: String, commitSHA: String)] {
+        guard let subs = dict["com-loopkit-Loop-submodules"] as? [String: [String: Any]] else {
+            return [:]
+        }
+        var result = [String: (branch: String, commitSHA: String)]()
+        for (name, info) in subs {
+            let branch = info["branch"] as? String ?? String(localized: "Unknown")
+            let commitSHA = info["commit_sha"] as? String ?? String(localized: "Unknown")
+            result[name] = (branch: branch, commitSHA: commitSHA)
+        }
+        return result
+    }
 }
 

Common/ce.lproj/Intents.strings

@@ -0,0 +1,36 @@
+/* (No Comment) */
+"9KhaIS" = "I've set the preset";
+
+/* (No Comment) */
+"80eo5o" = "Add Carb Entry";
+
+/* (No Comment) */
+"b085BW" = "I wasn't able to set the preset.";
+
+/* (No Comment) */
+"I4OZy8" = "Enable Override Preset";
+
+/* (No Comment) */
+"lYMuWV" = "Override Name";
+
+/* (No Comment) */
+"nDKAmn" = "What's the name of the override you'd like to set?";
+
+/* (No Comment) */
+"OcNxIj" = "Add Carb Entry";
+
+/* (No Comment) */
+"oLQSsJ" = "Enable '${overrideName}' Override Preset";
+
+/* (No Comment) */
+"XNNmtH" = "Enable preset in Loop";
+
+/* (No Comment) */
+"yBzwCL" = "Override Selection";
+
+/* (No Comment) */
+"yc02Yq" = "Add a carb entry to Loop";
+
+/* (No Comment) */
+"ZZ3mtM" = "Enable an override preset in Loop";
+

Common/fr.lproj/Intents.strings

@@ -8,13 +8,13 @@
 "b085BW" = "Je n'ai pas pu définir le préréglage.";
 
 /* (No Comment) */
-"I4OZy8" = "Activer l'ajustement préréglé";
+"I4OZy8" = "Activer la surcharge temporaire";
 
 /* (No Comment) */
 "lYMuWV" = "Nom Ajustement";
 
 /* (No Comment) */
-"nDKAmn" = "Quel est le nom de l'ajustement que vous voulez définir ?";
+"nDKAmn" = "Quel est le nom de l'ajustement que vous voulez définir?";
 
 /* (No Comment) */
 "OcNxIj" = "Ajouter des glucides";

Common/hi.lproj/Intents.strings

@@ -1,24 +1,36 @@
-"80eo5o" = "Add Carb Entry";
-
+/* (No Comment) */
 "9KhaIS" = "I've set the preset";
 
-"I4OZy8" = "Enable Override Preset";
-
-"OcNxIj" = "Add Carb Entry";
-
-"XNNmtH" = "Enable preset in Loop";
-
-"ZZ3mtM" = "Enable an override preset in Loop";
+/* (No Comment) */
+"80eo5o" = "Add Carb Entry";
 
+/* (No Comment) */
 "b085BW" = "I wasn't able to set the preset.";
 
+/* (No Comment) */
+"I4OZy8" = "Enable Override Preset";
+
+/* (No Comment) */
 "lYMuWV" = "Override Name";
 
+/* (No Comment) */
 "nDKAmn" = "What's the name of the override you'd like to set?";
 
+/* (No Comment) */
+"OcNxIj" = "Add Carb Entry";
+
+/* (No Comment) */
 "oLQSsJ" = "Enable '${overrideName}' Override Preset";
 
+/* (No Comment) */
+"XNNmtH" = "Enable preset in Loop";
+
+/* (No Comment) */
 "yBzwCL" = "Override Selection";
 
+/* (No Comment) */
 "yc02Yq" = "Add a carb entry to Loop";
 
+/* (No Comment) */
+"ZZ3mtM" = "Enable an override preset in Loop";
+

Common/hu.lproj/Intents.strings

@@ -0,0 +1,36 @@
+/* (No Comment) */
+"9KhaIS" = "I've set the preset";
+
+/* (No Comment) */
+"80eo5o" = "Add Carb Entry";
+
+/* (No Comment) */
+"b085BW" = "I wasn't able to set the preset.";
+
+/* (No Comment) */
+"I4OZy8" = "Enable Override Preset";
+
+/* (No Comment) */
+"lYMuWV" = "Override Name";
+
+/* (No Comment) */
+"nDKAmn" = "What's the name of the override you'd like to set?";
+
+/* (No Comment) */
+"OcNxIj" = "Add Carb Entry";
+
+/* (No Comment) */
+"oLQSsJ" = "Enable '${overrideName}' Override Preset";
+
+/* (No Comment) */
+"XNNmtH" = "Enable preset in Loop";
+
+/* (No Comment) */
+"yBzwCL" = "Override Selection";
+
+/* (No Comment) */
+"yc02Yq" = "Add a carb entry to Loop";
+
+/* (No Comment) */
+"ZZ3mtM" = "Enable an override preset in Loop";
+

Common/it.lproj/Intents.strings

@@ -1,36 +1,36 @@
 /* (No Comment) */
-"9KhaIS" = "Ho impostato la preimpostazione";
+"9KhaIS" = "Ho impostato il Preset";
 
 /* (No Comment) */
-"80eo5o" = "Agg. Carb. Assunti";
+"80eo5o" = "Aggiungi inserimento carboidrati";
 
 /* (No Comment) */
-"b085BW" = "I wasn't able to set the preset.";
+"b085BW" = "Non sono riuscito a impostare il Preset.";
 
 /* (No Comment) */
-"I4OZy8" = "Abilita Programma Alternativo";
+"I4OZy8" = "Attiva Preset Override";
 
 /* (No Comment) */
-"lYMuWV" = "Nome Programma Alternativo";
+"lYMuWV" = "Nome Override";
 
 /* (No Comment) */
-"nDKAmn" = "Qual'è il nome del programma alternativo che vuoi impostare?";
+"nDKAmn" = "Qual'è il nome dell'Override che vuoi impostare?";
 
 /* (No Comment) */
-"OcNxIj" = "Agg. Carb. Assunti";
+"OcNxIj" = "Aggiungi inserimento carboidrati";
 
 /* (No Comment) */
-"oLQSsJ" = "Abilita '${overrideName}' Programma Alternativo";
+"oLQSsJ" = "Attiva '${OverrideName}' Preset Override";
 
 /* (No Comment) */
-"XNNmtH" = "Enable preset in Loop";
+"XNNmtH" = "Attiva Preset in Loop";
 
 /* (No Comment) */
-"yBzwCL" = "Selezione Programma Alternativo";
+"yBzwCL" = "Selezione Override";
 
 /* (No Comment) */
-"yc02Yq" = "Aggiungi carboidrati a Loop";
+"yc02Yq" = "Aggiungi inserimento carboidrati a Loop";
 
 /* (No Comment) */
-"ZZ3mtM" = "Attiva Programma Alternativo in Loop";
+"ZZ3mtM" = "Attiva un Preset Override in Loop";
 

Common/ro.lproj/Intents.strings

@@ -5,16 +5,16 @@
 "80eo5o" = "Adaugă carbohidrați";
 
 /* (No Comment) */
-"b085BW" = "I wasn't able to set the preset.";
+"b085BW" = "Nu am reușit să setez presetarea.";
 
 /* (No Comment) */
-"I4OZy8" = "Enable Override Preset";
+"I4OZy8" = "Activare modificarea personalizată presetată";
 
 /* (No Comment) */
-"lYMuWV" = "Override Name";
+"lYMuWV" = "Denumirea modificării personalizate";
 
 /* (No Comment) */
-"nDKAmn" = "What's the name of the override you'd like to set?";
+"nDKAmn" = "Cum se numește modificarea pe care doriți să o setați?";
 
 /* (No Comment) */
 "OcNxIj" = "Adaugă carbohidrați";
@@ -23,14 +23,14 @@
 "oLQSsJ" = "Enable '${overrideName}' Override Preset";
 
 /* (No Comment) */
-"XNNmtH" = "Enable preset in Loop";
+"XNNmtH" = "Activați presetarea în buclă";
 
 /* (No Comment) */
-"yBzwCL" = "Override Selection";
+"yBzwCL" = "Selecție modificare personalizată";
 
 /* (No Comment) */
 "yc02Yq" = "Adaugă carbohidrați în Loop";
 
 /* (No Comment) */
-"ZZ3mtM" = "Enable an override preset in Loop";
+"ZZ3mtM" = "Activați o modificare personalizată presetată în Buclă";
 

Common/uk.lproj/Intents.strings

@@ -0,0 +1,36 @@
+/* (No Comment) */
+"9KhaIS" = "I've set the preset";
+
+/* (No Comment) */
+"80eo5o" = "Add Carb Entry";
+
+/* (No Comment) */
+"b085BW" = "I wasn't able to set the preset.";
+
+/* (No Comment) */
+"I4OZy8" = "Enable Override Preset";
+
+/* (No Comment) */
+"lYMuWV" = "Override Name";
+
+/* (No Comment) */
+"nDKAmn" = "What's the name of the override you'd like to set?";
+
+/* (No Comment) */
+"OcNxIj" = "Add Carb Entry";
+
+/* (No Comment) */
+"oLQSsJ" = "Enable '${overrideName}' Override Preset";
+
+/* (No Comment) */
+"XNNmtH" = "Enable preset in Loop";
+
+/* (No Comment) */
+"yBzwCL" = "Override Selection";
+
+/* (No Comment) */
+"yc02Yq" = "Add a carb entry to Loop";
+
+/* (No Comment) */
+"ZZ3mtM" = "Enable an override preset in Loop";
+

Common/zh-Hans.lproj/Intents.strings

@@ -2,7 +2,7 @@
 "9KhaIS" = "I've set the preset";
 
 /* (No Comment) */
-"80eo5o" = "添加碳水化合物";
+"80eo5o" = "添加碳水摄入";
 
 /* (No Comment) */
 "b085BW" = "I wasn't able to set the preset.";
@@ -17,7 +17,7 @@
 "nDKAmn" = "What's the name of the override you'd like to set?";
 
 /* (No Comment) */
-"OcNxIj" = "添加碳水化合物";
+"OcNxIj" = "添加碳水摄入";
 
 /* (No Comment) */
 "oLQSsJ" = "Enable '${overrideName}' Override Preset";

Documentation/FoodFinder/FoodFinder_README.md

@@ -0,0 +1,99 @@
+# FoodFinder for Loop
+
+FoodFinder adds AI-powered food identification and nutrition lookup to Loop's carb entry workflow. It supports barcode scanning (via OpenFoodFacts), AI camera analysis, voice search, and text-based food search — all integrated with a minimal footprint into Loop's existing codebase.
+
+## Features
+
+- **Barcode Scanner** — Scan product barcodes to look up nutrition data from OpenFoodFacts
+- **AI Camera Analysis** — Take a photo of food and get AI-powered carb estimates (supports Claude, OpenAI, Google Gemini, and custom BYO providers)
+- **Voice Search** — Speak a food name to search for nutrition information
+- **Text Search** — Type a food name for quick lookup
+- **Favorite Food Thumbnails** — Saved favorites display thumbnail images for easy identification
+- **Configurable AI Providers** — Choose between multiple AI backends or bring your own API endpoint
+
+## Architecture
+
+FoodFinder follows the **minimal footprint principle**: all feature logic lives in dedicated `FoodFinder/` subdirectories, with fewer than 30 lines added to existing Loop files.
+
+### Directory Structure
+
+```
+Loop/Loop/
+├── Views/FoodFinder/           (11 files — all UI components)
+├── Models/FoodFinder/          (3 files — data models)
+├── Services/FoodFinder/        (13 files — API clients, scanning, AI)
+├── View Models/FoodFinder/     (2 files — state management)
+├── Resources/FoodFinder/       (1 file — feature flags + settings keys)
+└── Documentation/FoodFinder/   (this file)
+
+Loop/LoopTests/FoodFinder/      (3 files — unit tests)
+```
+
+### Integration Touchpoints
+
+Only 3 existing Loop files are modified, totaling ~29 lines:
+
+| File | Lines Added | Purpose |
+|------|-------------|---------|
+| `CarbEntryView.swift` | ~9 | Inserts `FoodFinder_EntryPoint` view |
+| `SettingsView.swift` | ~16 | Adds FoodFinder Settings navigation link |
+| `FavoriteFoodDetailView.swift` | ~4 | Adds thumbnail display for favorites |
+
+### Key Files
+
+| File | Role |
+|------|------|
+| `FoodFinder_FeatureFlags.swift` | Central on/off toggle and all UserDefaults keys |
+| `FoodFinder_EntryPoint.swift` | Self-contained carb entry UI (search, scan, results) |
+| `FoodFinder_SearchViewModel.swift` | All search/scan/AI state management |
+| `FoodFinder_SettingsView.swift` | AI provider configuration screen |
+
+## Enabling/Disabling
+
+FoodFinder is controlled by a single toggle in `FoodFinder_FeatureFlags.swift`:
+
+```swift
+FoodFinder_FeatureFlags.isEnabled  // returns Bool
+```
+
+When disabled, all FoodFinder UI is hidden and no FoodFinder code executes. The feature can be toggled via the `foodSearchEnabled` UserDefaults key.
+
+## AI Provider Configuration
+
+FoodFinder supports multiple AI providers for food photo analysis:
+
+1. **Claude** (Anthropic) — Requires API key
+2. **OpenAI** (GPT-4 Vision) — Requires API key
+3. **Google Gemini** — Requires API key
+4. **BYO (Bring Your Own)** — Custom endpoint URL + API key
+
+Providers are configured in Settings > FoodFinder Settings. API keys are stored in UserDefaults with `foodFinder_` prefixed keys.
+
+## Portability
+
+FoodFinder is designed for easy adoption into other Loop forks (Trio, IAPS, Tidepool Loop):
+
+- **No LoopKit submodule changes** — All code lives under the Loop/ submodule
+- **Self-contained feature flag** — Single file controls enable/disable
+- **Prefixed naming** — All files use `FoodFinder_` prefix to avoid naming conflicts
+- **Minimal touchpoints** — Only 3 files need small modifications in the host app
+- **Script-installable** — The `FoodFinder/` directories can be copied and the 3 touchpoints applied programmatically
+
+## Dependencies
+
+FoodFinder uses only Apple frameworks available on iOS:
+
+- `Vision` — Barcode detection
+- `AVFoundation` — Camera access for scanning and AI analysis
+- `Speech` — Voice search recognition
+- `SwiftUI` / `UIKit` — User interface
+
+No third-party dependencies are required.
+
+## Testing
+
+Unit tests are located in `LoopTests/FoodFinder/`:
+
+- `FoodFinder_OpenFoodFactsTests.swift` — API response parsing tests
+- `FoodFinder_BarcodeScannerTests.swift` — Barcode detection tests
+- `FoodFinder_VoiceSearchTests.swift` — Voice recognition tests