Deliver offline generic food search and calibrated augmentation

[syamaner]

Closes #98

Outcome

• ships an offline, hash-verified 2,887-row CoFID 2021 search adapter using the frozen Eval: Generic-food retrieval, closest-match safety and calibration #92 matcher, hard rules, weights, threshold, result limit, aliases and deterministic tie-break
• exposes the production flow at Food logging -> Search Generic Foods, with exact/closest explanations, explicit candidate choice, explicit decline, no-result guidance and shared populated confirmation
• records release, row, matcher, score, material differences, fixed explicit-selection policy and per-nutrient provenance; no automatic acceptance path is introduced
• saves confirmed name aliases atomically and resolves later exact saved-food searches locally before CoFID ranking
• preserves old candidate archives when match metadata is absent and rejects altered selection-policy provenance

Review boundaries

• no provider, OAuth, Drive, personal health data, private account, commercial source, paid service or physical device was accessed
• Eval: Generic-food retrieval, closest-match safety and calibration #92's unavailable untouched personal-case gate remains deferred; this PR makes no personal-case or automatic-acceptance claim
• retrospective re-resolution remains Deliver opt-in retrospective nutrition re-resolution #101

Validation

• swift test --package-path Packages/FoodLedgerKit (86 tests green: presentation 6, domain 17, contract 40, application 16, generic search 7)
• bash Packages/FoodLedgerKit/Scripts/check-boundaries.sh
• full xcodebuild test on iPhone 18 Pro / iOS 27.0 simulator with coverage
• full xcodebuild analyze on the same simulator destination
• frozen Eval: Generic-food retrieval, closest-match safety and calibration #92 evaluation suite and byte-identical corpus/hash checks
• git diff --cached --check, project/Info.plist validation

Evidence

• canonical bundled corpus SHA-256: 2b0fbbade4d405eabcad440cabb1560e9861d9388c5fb4032ef24c81fb45f445
• reviewed head: 82318fe

[codecov]

Codecov Report

❌ Patch coverage is 9.42184% with 423 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...ces/FoodGenericSearch/CoFIDGenericFoodSearch.swift	11.46%	224 Missing ⚠️
...FoodLedgerPresentation/GenericFoodSearchView.swift	0.00%	91 Missing ⚠️
...rces/FoodLedgerApplication/GenericFoodSearch.swift	6.45%	29 Missing ⚠️
...urces/FoodLedgerApplication/FoodConfirmation.swift	0.00%	24 Missing ⚠️
...hReport/FoodLedger/FoodLedgerCompositionRoot.swift	18.18%	18 Missing ⚠️
...t/Sources/FoodLedgerDomain/SupportingRecords.swift	0.00%	13 Missing ⚠️
...t/Sources/FoodLedgerDomain/ValidatedDecoding.swift	0.00%	13 Missing ⚠️
WeeklyHealthReport/Views/WeeklyReportView.swift	38.88%	11 Missing ⚠️

📢 Thoughts on this report? Let us know!