Add Open Food Facts product intelligence CLI

[sdhilip200]

Goal

Add a Printing Press CLI for read-only Open Food Facts product, nutrition, ingredient, allergen, and category lookup workflows.

Free source

• Open Food Facts public API and product/search data.
• Core read operations do not require an account.

Agent jobs

• Look up a food product by barcode and return compact source-linked product facts.
• Search products by query, country, category, brand, or nutrition-related filters.
• Compare products by nutrition grade, Nutri-Score, ingredients, allergens, additives, and serving facts.
• Explain ingredient/allergen caveats with source freshness and data-quality warnings.

Proposed command shape

• open-food-facts-pp-cli product <barcode> --agent
• open-food-facts-pp-cli search "protein bar" --country us --agent
• open-food-facts-pp-cli nutrition <barcode> --agent
• open-food-facts-pp-cli allergens <barcode> --agent
• open-food-facts-pp-cli compare <barcode1> <barcode2> --agent
• open-food-facts-pp-cli category "breakfast cereals" --agent
• open-food-facts-pp-cli sources --agent
• open-food-facts-pp-cli doctor --agent

Non-goals

No product edits, no image uploads, no account/session workflows, no bulk harvesting, no medical advice, and no nutrition claims beyond what the source provides.

Implementation path

This is a new CLI candidate, so it should use the canonical Printing Press generation/publish flow, keep manuscripts/proofs, and publish into this repo with the structured publish package shape. It should use cli-printing-press 4.25+.

Acceptance criteria

• Research notes explain API endpoints, User-Agent expectations, rate limits/fair-use posture, freshness, and data-quality caveats.
• CLI exposes a small agent-native command set, not a raw endpoint dump.
• --json / --agent output is stable and compact.
• Skill includes high-signal recipes and clear non-goals.
• Dogfood proves realistic product lookup, search, nutrition/allergen, and compare workflows.
• Local cli-printing-press publish validate --dir ... --json passes before PR.

[sdhilip200]

Claiming this — starting work now. I will use cli-printing-press 4.26.0 and the canonical Printing Press publish flow, then open a PR once local validation passes.