Forge Intelligence

Handbook

LCDL overlay: Nutrition, Food Access, and Meal Systems Intelligence

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native…

Updated

Runtime boundary

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native implementation; no placeholder task code is included.

Capability contracts

Capability ID Candidate task ID Required output artifacts Release validators
capability.life.nutrition-food-access-meal-systems.capture_food_context intelligence_nutrition_food_access_meal_systems_capture_food_context_v1 artifact.life.nutrition-food-access-meal-systems.food_context_profile validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget, validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts, validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness
capability.life.nutrition-food-access-meal-systems.plan_meal_system intelligence_nutrition_food_access_meal_systems_plan_meal_system_v1 artifact.life.nutrition-food-access-meal-systems.meal_system_plan validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts, validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness, validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget
capability.life.nutrition-food-access-meal-systems.build_shopping_inventory intelligence_nutrition_food_access_meal_systems_build_shopping_inventory_v1 artifact.life.nutrition-food-access-meal-systems.shopping_plan, artifact.life.nutrition-food-access-meal-systems.pantry_inventory validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget
capability.life.nutrition-food-access-meal-systems.check_food_safety intelligence_nutrition_food_access_meal_systems_check_food_safety_v1 artifact.life.nutrition-food-access-meal-systems.food_safety_checklist validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts
capability.life.nutrition-food-access-meal-systems.adapt_and_substitute intelligence_nutrition_food_access_meal_systems_adapt_and_substitute_v1 artifact.life.nutrition-food-access-meal-systems.substitution_set, artifact.life.nutrition-food-access-meal-systems.allergen_map validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts, validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness, validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget
capability.life.nutrition-food-access-meal-systems.optimize_cost_access intelligence_nutrition_food_access_meal_systems_optimize_cost_access_v1 artifact.life.nutrition-food-access-meal-systems.food_budget validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts, validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness, validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget
capability.life.nutrition-food-access-meal-systems.review_nutrition_pattern intelligence_nutrition_food_access_meal_systems_review_nutrition_pattern_v1 artifact.life.nutrition-food-access-meal-systems.nutrition_pattern_review validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts, validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness, validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget

Each capability contract in the manifest defines inputs, outputs, preconditions, postconditions, method-selection rules, invariant references, failure states, risk gate, metrics, and the existing forge-lcdl tasks/operators to compose.

Artifact schemas

Artifact type Schema reference Required payload fields Sensitivity
artifact.life.nutrition-food-access-meal-systems.food_context_profile ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/food_context_profile subject_or_scope, purpose, facts_or_observations, preferences_and_constraints, source_refs, uncertainty, date_range, next_questions restricted
artifact.life.nutrition-food-access-meal-systems.meal_system_plan ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/meal_system_plan objective, scope, steps, dependencies, constraints, owners, timing, contingencies, review_triggers restricted
artifact.life.nutrition-food-access-meal-systems.shopping_plan ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/shopping_plan objective, scope, steps, dependencies, constraints, owners, timing, contingencies, review_triggers restricted
artifact.life.nutrition-food-access-meal-systems.pantry_inventory ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/pantry_inventory entries, entry_ids, owners, status, source_refs, updated_at restricted
artifact.life.nutrition-food-access-meal-systems.food_safety_checklist ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/food_safety_checklist items, applicability, status, evidence_refs, gaps, owner, review_date restricted
artifact.life.nutrition-food-access-meal-systems.allergen_map ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/allergen_map purpose, scope, entities_or_nodes, relations_or_edges, assumptions, boundary, validation_evidence restricted
artifact.life.nutrition-food-access-meal-systems.substitution_set ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/substitution_set items, generation_method, diversity_dimensions, constraints, screening_status restricted
artifact.life.nutrition-food-access-meal-systems.food_budget ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/food_budget currency_or_units, period, line_items, formulas, assumptions, scenarios, reconciliation_checks, uncertainty restricted
artifact.life.nutrition-food-access-meal-systems.nutrition_pattern_review ../schemas/artifacts/nutrition-food-access-meal-systems.schema.json#/$defs/nutrition_pattern_review question_or_standard, criteria, evidence, findings, uncertainty, limitations, status, recommended_actions restricted

Validators

Validator ID Kind Automation Severity Failure action
validator.life.nutrition-food-access-meal-systems.01_allergen_and_cross_contact_conflicts constraint deterministic blocker escalate
validator.life.nutrition-food-access-meal-systems.02_food_safety_source_freshness provenance_and_rule hybrid blocker escalate
validator.life.nutrition-food-access-meal-systems.03_servings_quantities_units_and_budget deterministic deterministic major repair
validator.life.nutrition-food-access-meal-systems.04_clinical_diet_and_disordered_eating_boundary policy hybrid minor conditional_pass

Validator checks return itemized evidence and support pass, conditional_pass, fail, inconclusive, or a governed repair/escalation path. Generation does not self-certify.

Existing execution substrate

Tasks to reuse: contradiction_scan, decompose_problem, extract_schema_from_text, formula_eval_safe, llm_boolean_gate, llm_enum_route, plan_decision_pack, word_problem_to_calc_plan
Operators to reuse: branch, fallback_chain, for_each, optional_step, seq, try_catch, until_ok

Cross-intelligence handoff

  • artifact_id, type, version, producer capability, provenance, scope, assumptions, uncertainty, sensitivity, validation status, and next action
  • No free-text handoff may replace a required typed artifact when a downstream validator depends on structure.

Information-loss checks: - all hard constraints preserved - all blocker findings preserved - source scope and date preserved - assumptions and dissent preserved - units, time zones, identifiers, and uncertainty preserved

Evaluation and release

Suite: ../evaluation_suites/nutrition-food-access-meal-systems.yaml

  • 100% schema validity for released artifacts
  • 100% material traceability
  • no unresolved blocker validator
  • no missed critical escalation in the approved benchmark
  • documented conditional-pass limits and human gates

Promotion to implementation maturity I1

  • Create repository-native input and output contracts for every candidate task ID.
  • Implement deterministic portions of validators and declare independent human or model review for semantic portions.
  • Connect a provenance-preserving source resolver and enforce freshness and jurisdiction rules.
  • Pass the per-pack suite and dependency regression suites at release thresholds.
  • Complete security, privacy, accessibility, and domain-owner review appropriate to risk.
  • Publish LMETA/LCDL exact-overlay links and CI parity checks.

Exact-overlay identity

The LMETA and LCDL pages share the concept ID, semantic version, capability IDs, and invariant IDs. tools/validate_pack.py checks this parity.

Paired overlay

Runtime maturity

  • Capabilities: 7
  • Technical floor→ceiling: I1_runtime → I1_runtime
  • Autonomy floor→ceiling: A0_assisted → A0_assisted
  • I1_runtime count: 7
  • Evidence class: contract: 7
  • Full hierarchy: MATURITY-HIERARCHY.md

Evaluation suite status

  • CI status: pass
  • Suite: evaluation_suites/nutrition-food-access-meal-systems.yaml
  • Cases defined: 7
  • Capabilities under test: 7