# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-06T22:02:42Z", "synthesisSha256": "651d5cc6271c3eea2c497e25c7950a243647460a442f348b5173c3414b634044", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-OBJ-004", "registryId": "vr.wm-obj-004", "name": "Food Product", "version": "0.3.0-reviewable-draft", "previousVersions": [ { "version": "0.2.0-legacy", "url": "https://github.com/ver-cy/world-models/blob/feat/mega-model-registry/models/matter-artifacts/M4-food-and-drink.md" } ], "entryKind": "entity", "family": "World Models", "category": "Physical world and living systems", "industry": [ "Cross-industry" ], "domain": [ "PHY.OBJ.FOOD" ], "tags": [ "food", "product", "phy.obj.food" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-obj-004-food-product/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-obj-004", "model": { "registry_id": "vr.wm-obj-004", "model_id": "WM-OBJ-004", "name": "Food Product", "entry_kind": "entity", "purpose": "Describe a governed human-food product definition with versioned declarations, evidence and separately scoped lot and safety references.", "scope_statement": "One persistent product-definition entity for food or drink intended for human consumption, including unprocessed harvested food and non-prepacked products. A revision is qualified by market, formulation, packaging and effective context. The root is neither a lot nor an individual pack. It records attributable assertions and unknowns rather than determining whether a particular item is safe to consume.", "in_scope": [ "Qualified product identity, category, market and responsible-role references", "Ingredient, allergen, nutrient, quantity, storage and use declarations with evidence and exceptions", "Recognition observations, external lot and recall applicability links, revision history and permitted projections" ], "out_of_scope": [ "Batch manufacture, genealogy, inventory, custody, shipping and individual physical-item lifecycles", "Recipe execution, food-facility control plans, laboratory operation, medical advice or individual suitability decisions", "Issuing recalls, broadcasting notices, regulatory approval, commercial offers and price or ownership transfer", "Animal feed, plants before harvest and medicinal products; disputed legal categories require profile review" ], "boundary_notes": [ { "neighbor": "WM-OBJ-002 Product Type / Catalog Item", "distinction": "Candidate alignment to generic product-definition identity. This food-specific entity owns declarations and applicability, not a competing generic catalog lifecycle. Neighbor binding requires a pinned revision.", "source_refs": [ "SRC-001", "SRC-003" ] }, { "neighbor": "WM-OBJ-003 Tradable Offer / Commodity view", "distinction": "Legacy M3 inheritance is not carried forward. Price, offer, seller terms and transactions remain external. Food need not be currently offered for sale.", "source_refs": [ "SRC-002", "SRC-003" ] }, { "neighbor": "WM-OBJ-001 Physical Item Instance and external lot master", "distinction": "Packs and lots retain their own identity, dates, observations and custody. Local links bind them to a product revision without copying their operational lifecycle.", "source_refs": [ "SRC-002", "SRC-003", "SRC-007" ] }, { "neighbor": "WM-MAT-001 Chemical Substance and FoodOn", "distinction": "Ingredients can be complex food materials, not only chemical substances. Use the appropriate vocabulary reference; do not force all ingredient entries into a substance class.", "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] }, { "neighbor": "WM-OBJ-005 Medicinal Product", "distinction": "Market-qualified regulatory classification decides borderline products. Ingestion alone does not decide food status; supplements and specialized foods need explicit profile review.", "source_refs": [ "SRC-002", "SRC-006" ] } ] }, "sources": [ { "id": "SRC-001", "title": "Food information to consumers", "organization": "European Union", "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:02011R1169-20250401", "version_or_date": "Regulation (EU) 1169/2011, consolidated 2025-04-01; selected provisions read", "source_type": "legislation", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Articles 8-9, 14-25, 30-36 and 44 and Annex X inform market-qualified declarations, exceptions, nutrient basis and date semantics. EU example, not a worldwide mandatory field list." }, { "id": "SRC-002", "title": "General Food Law", "organization": "European Union", "url": "https://eur-lex.europa.eu/eli/reg/2002/178/oj/eng", "version_or_date": "Regulation (EC) 178/2002, original 2002 text; current consolidation not verified", "source_type": "legislation", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Articles 2, 14 and 17-19 inform food scope, responsibility, traceability and scoped withdrawal/recall references. No present-law completeness claim." }, { "id": "SRC-003", "title": "GTIN Management Standard", "organization": "GS1", "url": "https://ref.gs1.org/standards/gtin-management/1.1.0/", "version_or_date": "Release 1.1, September 2023", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Sections 1 and 2.2-2.3 inform trade-item identifiers and conditional identifier changes. A GTIN is not required for every food and does not identify a production lot or establish safety." }, { "id": "SRC-004", "title": "FoodOn: A farm to fork ontology", "organization": "FoodOn project", "url": "https://foodon.org/", "version_or_date": "Project overview accessed 2026-10-07; ontology release not pinned", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Food vocabulary and facets support optional classification references. The broader ontology includes animal-food roles and processes outside this human-food product boundary." }, { "id": "SRC-005", "title": "INFOODS Food Component Identifiers (Tagnames)", "organization": "Food and Agriculture Organization", "url": "https://www.fao.org/infoods/infoods/standards-guidelines/food-component-identifiers-tagnames/en/", "version_or_date": "Landing page last update 2022-10-20; component tables and release binding not verified", "source_type": "registry", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Component identifiers support vocabulary-qualified nutrition data. The page does not establish interchangeability of component definitions, analytical methods or units." }, { "id": "SRC-006", "title": "Food Allergies", "organization": "U.S. Food and Drug Administration", "url": "https://www.fda.gov/food/nutrition-food-labeling-and-critical-foods/food-allergies", "version_or_date": "Official guidance page accessed 2026-10-07; selected labeling and advisory sections", "source_type": "public-authority", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "US regulatory scope illustrates major allergens and distinguishes mandatory declarations from voluntary cross-contact advisories. No personal dietary suitability conclusion follows." }, { "id": "SRC-007", "title": "PROV-O: The PROV Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "Recommendation 2013-04-30", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Entity, activity, agent, attribution and derivation inform evidence links and revision provenance. These are conceptual alignments, not proof of truth or authority." }, { "id": "SRC-008", "title": "Date and Time on the Internet: Timestamps", "organization": "Internet Engineering Task Force", "url": "https://www.rfc-editor.org/rfc/rfc3339.html", "version_or_date": "RFC 3339, July 2002, section 5.6", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:01:22Z", "relevance": "Timestamp syntax for observed and recorded events. Date-only or month-only food markings preserve their original precision and are not fabricated into timestamp instants." } ], "structure": { "bundles": [ { "id": "definition-bundle", "name": "Definition and applicability", "description": "Establish what the food record identifies and which profile governs its assertions.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003", "SRC-004" ], "layers": [ { "id": "identity-layer", "name": "Product definition identity", "description": "Maintain stable namespace-qualified identity and distinct revisions. GTIN and local catalog codes are optional aliases with explicit issuer and scope.", "source_refs": [ "SRC-002", "SRC-003" ], "findings": [ { "id": "finding-identity", "name": "Product definition identity", "description": "Maintain stable namespace-qualified identity and distinct revisions. GTIN and local catalog codes are optional aliases with explicit issuer and scope.", "source_refs": [ "SRC-002", "SRC-003" ], "questions": [ { "id": "identity-q1", "kind": "identity", "text": "Which master product definition and revision does this food record describe?", "answer_data": [ "master namespace", "product identifier", "revision reference", "resolution status" ] }, { "id": "identity-q2", "kind": "relationship", "text": "Which trade-item codes, markets and package variants map to this definition without identifying a lot or pack?", "answer_data": [ "identifier scheme", "issuer", "code", "market", "package level", "mapping validity" ] }, { "id": "identity-q3", "kind": "exception", "text": "How is identity retained for loose food, missing codes or ambiguous look-alike products?", "answer_data": [ "local identity basis", "ambiguity candidates", "evidence", "unresolved status" ] } ], "data_elements": [ { "id": "identity-data-1", "name": "Assertion payload", "description": "master namespace; product identifier; revision reference; resolution status. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "id": "identity-data-2", "name": "Evidence and applicability", "description": "identifier scheme; issuer; code; market; package level; mapping validity. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "id": "identity-data-3", "name": "Review and unknown state", "description": "local identity basis; ambiguity candidates; evidence; unresolved status. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] } ], "artifacts": [ { "id": "identity-artifact", "name": "Product definition identity record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-002", "SRC-003" ] } ], "inline_only_rationale": null } ] }, { "id": "profile-layer", "name": "Food class and applicable profile", "description": "Record intended human-food role and jurisdictional category with exceptions. Product classes are not the same as food vocabulary concepts or legal permissions.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ], "findings": [ { "id": "finding-profile", "name": "Food class and applicable profile", "description": "Record intended human-food role and jurisdictional category with exceptions. Product classes are not the same as food vocabulary concepts or legal permissions.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ], "questions": [ { "id": "profile-q1", "kind": "classification", "text": "Which food category, physical form and intended human use apply under the selected market profile?", "answer_data": [ "category code and release", "form", "intended use", "jurisdiction", "evidence" ] }, { "id": "profile-q2", "kind": "authority", "text": "Which responsible operator role and reviewer substantiate the selected classification and declarations?", "answer_data": [ "role reference", "mandate scope", "declaration issuer", "review status" ] }, { "id": "profile-q3", "kind": "constraint", "text": "Which profile-specific exceptions or borderline classifications require specialist review before this record can be used?", "answer_data": [ "non-prepacked or specialized-food profile", "exception basis", "unresolved category", "review owner" ] } ], "data_elements": [ { "id": "profile-data-1", "name": "Assertion payload", "description": "category code and release; form; intended use; jurisdiction; evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ] }, { "id": "profile-data-2", "name": "Evidence and applicability", "description": "role reference; mandate scope; declaration issuer; review status. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ] }, { "id": "profile-data-3", "name": "Review and unknown state", "description": "non-prepacked or specialized-food profile; exception basis; unresolved category; review owner. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ] } ], "artifacts": [ { "id": "profile-artifact", "name": "Food class and applicable profile record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "composition-bundle", "name": "Composition and allergens", "description": "Describe declared content and allergen assertions without inferring a complete recipe or safety.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ], "layers": [ { "id": "ingredients-layer", "name": "Declared composition", "description": "Preserve the declared list and its ordering, quantities and qualifications. Do not infer a complete recipe from a label or require an ingredient list when an evidenced exception applies.", "source_refs": [ "SRC-001", "SRC-004" ], "findings": [ { "id": "finding-ingredients", "name": "Declared composition", "description": "Preserve the declared list and its ordering, quantities and qualifications. Do not infer a complete recipe from a label or require an ingredient list when an evidenced exception applies.", "source_refs": [ "SRC-001", "SRC-004" ], "questions": [ { "id": "ingredients-q1", "kind": "composition", "text": "Which ingredient entries, compound components and additive roles are declared for this revision?", "answer_data": [ "ordered text", "ingredient reference", "component hierarchy", "additive role", "source label" ] }, { "id": "ingredients-q2", "kind": "measurement", "text": "What do any ingredient quantities measure and which basis or declaration exception accompanies them?", "answer_data": [ "percentage or quantity", "unit", "input or finished basis", "qualification", "exception evidence" ] }, { "id": "ingredients-q3", "kind": "provenance", "text": "Which formulation and label evidence support this declaration without exposing an unapproved recipe?", "answer_data": [ "formulation reference", "label revision", "issuer", "evidence location", "access classification" ] } ], "data_elements": [ { "id": "ingredients-data-1", "name": "Assertion payload", "description": "ordered text; ingredient reference; component hierarchy; additive role; source label. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] }, { "id": "ingredients-data-2", "name": "Evidence and applicability", "description": "percentage or quantity; unit; input or finished basis; qualification; exception evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] }, { "id": "ingredients-data-3", "name": "Review and unknown state", "description": "formulation reference; label revision; issuer; evidence location; access classification. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] } ], "artifacts": [ { "id": "ingredients-artifact", "name": "Declared composition record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-004" ] } ], "inline_only_rationale": null } ] }, { "id": "allergens-layer", "name": "Allergen and advisory assertions", "description": "Keep intentional-content declarations, cross-contact advisories, absence claims and unknowns distinct. Missing statements are not absence evidence; changes remain revision and market scoped.", "source_refs": [ "SRC-001", "SRC-006" ], "findings": [ { "id": "finding-allergens", "name": "Allergen and advisory assertions", "description": "Keep intentional-content declarations, cross-contact advisories, absence claims and unknowns distinct. Missing statements are not absence evidence; changes remain revision and market scoped.", "source_refs": [ "SRC-001", "SRC-006" ], "questions": [ { "id": "allergens-q1", "kind": "requirement", "text": "Which allergen vocabulary and declaration rules apply to the selected food and market?", "answer_data": [ "profile and effective version", "allergen vocabulary", "mandatory declaration scope", "exception basis" ] }, { "id": "allergens-q2", "kind": "evidence", "text": "Which contains, precautionary or absence statements are actually evidenced and what scope does each claim cover?", "answer_data": [ "statement text and kind", "allergen reference", "formulation", "market", "issuer", "supporting evidence" ] }, { "id": "allergens-q3", "kind": "quality", "text": "How are a missing statement, conflicting label and newer allergen declaration represented without declaring the product safe?", "answer_data": [ "unknown or conflict state", "competing revisions", "observed pack reference", "escalation owner" ] } ], "data_elements": [ { "id": "allergens-data-1", "name": "Assertion payload", "description": "profile and effective version; allergen vocabulary; mandatory declaration scope; exception basis. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006" ] }, { "id": "allergens-data-2", "name": "Evidence and applicability", "description": "statement text and kind; allergen reference; formulation; market; issuer; supporting evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006" ] }, { "id": "allergens-data-3", "name": "Review and unknown state", "description": "unknown or conflict state; competing revisions; observed pack reference; escalation owner. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006" ] } ], "artifacts": [ { "id": "allergens-artifact", "name": "Allergen and advisory assertions record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "nutrition-bundle", "name": "Nutrition and reference basis", "description": "Preserve qualified values and the basis required to interpret them.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ], "layers": [ { "id": "nutrients-layer", "name": "Qualified nutrient values", "description": "Record component, amount, unit, analytical or calculation basis and provenance. Zero, missing, below quantification and calculated estimates remain different values.", "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ], "findings": [ { "id": "finding-nutrients", "name": "Qualified nutrient values", "description": "Record component, amount, unit, analytical or calculation basis and provenance. Zero, missing, below quantification and calculated estimates remain different values.", "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ], "questions": [ { "id": "nutrients-q1", "kind": "measurement", "text": "Which energy and nutrient values are declared with their component definitions and units?", "answer_data": [ "component scheme and version", "value or bound", "unit", "reference basis", "value qualifier" ] }, { "id": "nutrients-q2", "kind": "provenance", "text": "Were the nutrient values measured, calculated or taken from reference data and which evidence supports that method?", "answer_data": [ "method type", "sample or recipe reference", "data source", "date", "uncertainty or unavailable reason" ] }, { "id": "nutrients-q3", "kind": "validation", "text": "Which detection limits, rounding, tolerances and conflicting nutrient values prevent a defensible comparison?", "answer_data": [ "limit and qualifier", "rounding profile", "tolerance basis", "conflicting evidence", "review outcome" ] } ], "data_elements": [ { "id": "nutrients-data-1", "name": "Assertion payload", "description": "component scheme and version; value or bound; unit; reference basis; value qualifier. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ] }, { "id": "nutrients-data-2", "name": "Evidence and applicability", "description": "method type; sample or recipe reference; data source; date; uncertainty or unavailable reason. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ] }, { "id": "nutrients-data-3", "name": "Review and unknown state", "description": "limit and qualifier; rounding profile; tolerance basis; conflicting evidence; review outcome. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ] } ], "artifacts": [ { "id": "nutrients-artifact", "name": "Qualified nutrient values record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "basis-layer", "name": "Serving and preparation basis", "description": "Keep as-sold and as-prepared declarations distinct, including edible portion, serving quantities and reference-intake population. Conversion is conditional on compatible evidence.", "source_refs": [ "SRC-001", "SRC-005" ], "findings": [ { "id": "finding-basis", "name": "Serving and preparation basis", "description": "Keep as-sold and as-prepared declarations distinct, including edible portion, serving quantities and reference-intake population. Conversion is conditional on compatible evidence.", "source_refs": [ "SRC-001", "SRC-005" ], "questions": [ { "id": "basis-q1", "kind": "definition", "text": "Does each nutrient declaration concern food as sold, as prepared or an edible portion under stated preparation assumptions?", "answer_data": [ "preparation state", "edible fraction", "instruction reference", "basis quantity and unit" ] }, { "id": "basis-q2", "kind": "measurement", "text": "Which serving quantity, servings per package and reference-intake basis accompany a per-portion declaration?", "answer_data": [ "serving mass or volume", "household measure equivalence", "servings count qualifier", "population basis" ] }, { "id": "basis-q3", "kind": "constraint", "text": "What prevents conversion between per-mass, per-volume and per-serving values for this product?", "answer_data": [ "missing density or yield", "incompatible units", "unknown preparation loss", "refusal reason" ] } ], "data_elements": [ { "id": "basis-data-1", "name": "Assertion payload", "description": "preparation state; edible fraction; instruction reference; basis quantity and unit. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "basis-data-2", "name": "Evidence and applicability", "description": "serving mass or volume; household measure equivalence; servings count qualifier; population basis. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "basis-data-3", "name": "Review and unknown state", "description": "missing density or yield; incompatible units; unknown preparation loss; refusal reason. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] } ], "artifacts": [ { "id": "basis-artifact", "name": "Serving and preparation basis record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "presentation-bundle", "name": "Quantity and recognition", "description": "Distinguish product declarations from observed pack evidence.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-003", "SRC-006", "SRC-007" ], "layers": [ { "id": "quantity-layer", "name": "Declared quantity and package context", "description": "Declared net quantity is a product assertion; observed fill or package damage belongs to an identified sample or item. Preserve nominal and measured properties separately.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ], "findings": [ { "id": "finding-quantity", "name": "Declared quantity and package context", "description": "Declared net quantity is a product assertion; observed fill or package damage belongs to an identified sample or item. Preserve nominal and measured properties separately.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ], "questions": [ { "id": "quantity-q1", "kind": "measurement", "text": "Which net, drained or count quantity is declared for this package variant and in what units?", "answer_data": [ "quantity kind", "nominal value", "unit", "package variant", "declaration evidence" ] }, { "id": "quantity-q2", "kind": "relationship", "text": "Which package hierarchy and product-change decision link this declaration to its trade-item identifier?", "answer_data": [ "package level", "linked product codes", "quantity revision", "allocation-rule review reference" ] }, { "id": "quantity-q3", "kind": "quality", "text": "Which observed quantity or package condition differs from the declaration and where is its measurement evidence retained?", "answer_data": [ "item or sample reference", "measurement and unit", "method", "conditions", "time", "uncertainty", "external observation link" ] } ], "data_elements": [ { "id": "quantity-data-1", "name": "Assertion payload", "description": "quantity kind; nominal value; unit; package variant; declaration evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ] }, { "id": "quantity-data-2", "name": "Evidence and applicability", "description": "package level; linked product codes; quantity revision; allocation-rule review reference. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ] }, { "id": "quantity-data-3", "name": "Review and unknown state", "description": "item or sample reference; measurement and unit; method; conditions; time; uncertainty; external observation link. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ] } ], "artifacts": [ { "id": "quantity-artifact", "name": "Declared quantity and package context record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "recognition-layer", "name": "Recognition and label observation", "description": "Capture label readings and their source without treating barcode recognition, images or OCR as authentication or proof of the current formulation.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ], "findings": [ { "id": "finding-recognition", "name": "Recognition and label observation", "description": "Capture label readings and their source without treating barcode recognition, images or OCR as authentication or proof of the current formulation.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ], "questions": [ { "id": "recognition-q1", "kind": "evidence", "text": "Which observed label, barcode and package features support the proposed product match?", "answer_data": [ "image or label artifact", "code reading", "observed item reference", "observer", "capture time" ] }, { "id": "recognition-q2", "kind": "validation", "text": "Which market, size, language or formulation differences could make a visually similar package a different product revision?", "answer_data": [ "candidate matches", "distinguishing features", "label language", "revision uncertainty", "reviewer" ] }, { "id": "recognition-q3", "kind": "provenance", "text": "How are transcription errors and unverified observations retained alongside the authoritative declaration?", "answer_data": [ "original artifact", "extraction method", "confidence", "correction link", "assertion status" ] } ], "data_elements": [ { "id": "recognition-data-1", "name": "Assertion payload", "description": "image or label artifact; code reading; observed item reference; observer; capture time. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] }, { "id": "recognition-data-2", "name": "Evidence and applicability", "description": "candidate matches; distinguishing features; label language; revision uncertainty; reviewer. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] }, { "id": "recognition-data-3", "name": "Review and unknown state", "description": "original artifact; extraction method; confidence; correction link; assertion status. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "recognition-artifact", "name": "Recognition and label observation record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "conditions-bundle", "name": "Durability and intended use", "description": "Record condition-dependent declarations without operating on food or determining fitness.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-002", "SRC-006", "SRC-008" ], "layers": [ { "id": "durability-layer", "name": "Date-marking and storage declarations", "description": "Record the meaning and precision of markings and the storage assumptions behind them. Best-before and use-by are not interchangeable. An external lot supplies actual dates; missing history never implies safe condition.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ], "findings": [ { "id": "finding-durability", "name": "Date-marking and storage declarations", "description": "Record the meaning and precision of markings and the storage assumptions behind them. Best-before and use-by are not interchangeable. An external lot supplies actual dates; missing history never implies safe condition.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ], "questions": [ { "id": "durability-q1", "kind": "temporal", "text": "Which durability date type, precision and marking exception apply to this product profile?", "answer_data": [ "date type", "raw marking pattern", "date precision", "jurisdictional meaning", "exception evidence" ] }, { "id": "durability-q2", "kind": "constraint", "text": "Which unopened storage conditions and supporting shelf-life evidence qualify the declaration?", "answer_data": [ "temperature or other conditions with units", "packaging assumption", "validation reference", "evidence limits" ] }, { "id": "durability-q3", "kind": "relationship", "text": "Which lot or item record supplies an actual marked date and storage observation without promoting it to every product instance?", "answer_data": [ "lot or item master reference", "marked date", "observation source", "coverage interval", "unknown history" ] } ], "data_elements": [ { "id": "durability-data-1", "name": "Assertion payload", "description": "date type; raw marking pattern; date precision; jurisdictional meaning; exception evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] }, { "id": "durability-data-2", "name": "Evidence and applicability", "description": "temperature or other conditions with units; packaging assumption; validation reference; evidence limits. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] }, { "id": "durability-data-3", "name": "Review and unknown state", "description": "lot or item master reference; marked date; observation source; coverage interval; unknown history. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] } ], "artifacts": [ { "id": "durability-artifact", "name": "Date-marking and storage declarations record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] } ], "inline_only_rationale": null } ] }, { "id": "use-layer", "name": "Intended use and handling conditions", "description": "Represent evidenced preparation and after-opening instructions as declarations. No generic cooking procedure, automated actuation or personalized suitability is provided.", "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ], "findings": [ { "id": "finding-use", "name": "Intended use and handling conditions", "description": "Represent evidenced preparation and after-opening instructions as declarations. No generic cooking procedure, automated actuation or personalized suitability is provided.", "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ], "questions": [ { "id": "use-q1", "kind": "process", "text": "Which preparation, after-opening and handling instructions are declared for the intended use?", "answer_data": [ "instruction artifact", "language", "preparation state", "opening-dependent duration", "storage conditions" ] }, { "id": "use-q2", "kind": "constraint", "text": "Which intended-consumer restrictions or prerequisites limit the use declaration?", "answer_data": [ "target group", "restriction text", "applicable profile", "evidence", "unresolved condition" ] }, { "id": "use-q3", "kind": "exception", "text": "What happens when opening time, preparation state or required storage history is unknown or contradicted?", "answer_data": [ "unknown input", "contradictory observation", "refusal to infer suitability", "responsible reviewer" ] } ], "data_elements": [ { "id": "use-data-1", "name": "Assertion payload", "description": "instruction artifact; language; preparation state; opening-dependent duration; storage conditions. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ] }, { "id": "use-data-2", "name": "Evidence and applicability", "description": "target group; restriction text; applicable profile; evidence; unresolved condition. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ] }, { "id": "use-data-3", "name": "Review and unknown state", "description": "unknown input; contradictory observation; refusal to infer suitability; responsible reviewer. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ] } ], "artifacts": [ { "id": "use-artifact", "name": "Intended use and handling conditions record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "safety-links-bundle", "name": "Traceability and safety links", "description": "Keep external lot, origin and notice references precisely scoped.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-002", "SRC-006", "SRC-007" ], "layers": [ { "id": "trace-layer", "name": "Lot applicability and origin links", "description": "Carry scoped references to traceability and origin evidence. Origin claims, ingredient origin, manufacturing location and operator address are distinct; this is not a supply-chain ledger.", "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ], "findings": [ { "id": "finding-trace", "name": "Lot applicability and origin links", "description": "Carry scoped references to traceability and origin evidence. Origin claims, ingredient origin, manufacturing location and operator address are distinct; this is not a supply-chain ledger.", "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ], "questions": [ { "id": "trace-q1", "kind": "relationship", "text": "Which external lots are evidenced as instances of this product revision and where is that binding mastered?", "answer_data": [ "lot namespace and code", "product revision", "effective interval", "binding evidence" ] }, { "id": "trace-q2", "kind": "spatial", "text": "Which origin or provenance statements are declared and what exactly do their locations describe?", "answer_data": [ "product or ingredient scope", "location reference", "claim text", "issuer", "uncertainty" ] }, { "id": "trace-q3", "kind": "access", "text": "Which traceability evidence can the authorized reviewer retrieve when a lot binding is missing or disputed?", "answer_data": [ "external trace record", "access purpose", "responsible role", "unresolved link", "escalation path" ] } ], "data_elements": [ { "id": "trace-data-1", "name": "Assertion payload", "description": "lot namespace and code; product revision; effective interval; binding evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ] }, { "id": "trace-data-2", "name": "Evidence and applicability", "description": "product or ingredient scope; location reference; claim text; issuer; uncertainty. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ] }, { "id": "trace-data-3", "name": "Review and unknown state", "description": "external trace record; access purpose; responsible role; unresolved link; escalation path. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ] } ], "artifacts": [ { "id": "trace-artifact", "name": "Lot applicability and origin links record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "notices-layer", "name": "Safety notice applicability", "description": "Link attributed alerts, withdrawals and recalls with population, market and time scope. No notice found is only a search result, not a safe status. Unknown lot scope cannot be silently treated as unaffected.", "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ], "findings": [ { "id": "finding-notices", "name": "Safety notice applicability", "description": "Link attributed alerts, withdrawals and recalls with population, market and time scope. No notice found is only a search result, not a safe status. Unknown lot scope cannot be silently treated as unaffected.", "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ], "questions": [ { "id": "notices-q1", "kind": "state", "text": "Which external safety notices potentially apply to this product, market or linked lot as of the recorded check?", "answer_data": [ "notice authority and identifier", "status", "scope", "checked time", "search coverage" ] }, { "id": "notices-q2", "kind": "decision", "text": "What evidence makes a notice applicable, inapplicable or unresolved for a particular product revision or lot?", "answer_data": [ "scope predicate", "code and date match evidence", "exclusions", "unresolved operands", "assessment reviewer" ] }, { "id": "notices-q3", "kind": "lifecycle", "text": "Which issuer update or closure changes the notice linkage without deleting its history or asserting that every item is safe?", "answer_data": [ "notice revision", "effective time", "supersession or closure evidence", "retained linkage history" ] } ], "data_elements": [ { "id": "notices-data-1", "name": "Assertion payload", "description": "notice authority and identifier; status; scope; checked time; search coverage. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ] }, { "id": "notices-data-2", "name": "Evidence and applicability", "description": "scope predicate; code and date match evidence; exclusions; unresolved operands; assessment reviewer. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ] }, { "id": "notices-data-3", "name": "Review and unknown state", "description": "notice revision; effective time; supersession or closure evidence; retained linkage history. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "notices-artifact", "name": "Safety notice applicability record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-002", "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "assurance-bundle", "name": "Evidence and revision assurance", "description": "Govern evidence, change history and loss-aware projections.", "rationale": "Proposed model organization grounded in the cited concepts; it does not assert that a source prescribes this hierarchy.", "source_refs": [ "SRC-001", "SRC-003", "SRC-006", "SRC-007", "SRC-008" ], "layers": [ { "id": "evidence-layer", "name": "Declaration evidence and claims", "description": "Record label, test and certification references with claim scope and access. A certificate, ontology code or provenance digest does not independently validate a safety, nutrition or marketing claim.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ], "findings": [ { "id": "finding-evidence", "name": "Declaration evidence and claims", "description": "Record label, test and certification references with claim scope and access. A certificate, ontology code or provenance digest does not independently validate a safety, nutrition or marketing claim.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ], "questions": [ { "id": "evidence-q1", "kind": "evidence", "text": "Which source artifacts and review decisions support each nutrition, origin or other declaration claim?", "answer_data": [ "claim identifier", "exact scope", "artifact master reference", "issuer", "review evidence" ] }, { "id": "evidence-q2", "kind": "ownership", "text": "Who stewards the declaration and who controls access to restricted recipes, test reports and rights-bearing evidence?", "answer_data": [ "responsible role references", "mandate", "evidence custodian", "permitted purposes", "rights basis" ] }, { "id": "evidence-q3", "kind": "retention", "text": "Which retention, correction and lawful disposal rules apply to superseded evidence and personal contact details?", "answer_data": [ "policy reference", "hold reason", "retention trigger", "restricted payload", "disposition record" ] } ], "data_elements": [ { "id": "evidence-data-1", "name": "Assertion payload", "description": "claim identifier; exact scope; artifact master reference; issuer; review evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] }, { "id": "evidence-data-2", "name": "Evidence and applicability", "description": "responsible role references; mandate; evidence custodian; permitted purposes; rights basis. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] }, { "id": "evidence-data-3", "name": "Review and unknown state", "description": "policy reference; hold reason; retention trigger; restricted payload; disposition record. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "evidence-artifact", "name": "Declaration evidence and claims record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "revisions-layer", "name": "Revision and projection control", "description": "Separate recorded time, declaration effective time and production applicability. Preserve coexisting market variants. Export requires a pinned mapping and explicit loss report.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ], "findings": [ { "id": "finding-revisions", "name": "Revision and projection control", "description": "Separate recorded time, declaration effective time and production applicability. Preserve coexisting market variants. Export requires a pinned mapping and explicit loss report.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ], "questions": [ { "id": "revisions-q1", "kind": "lifecycle", "text": "Which declaration change supersedes a revision and which existing lots remain bound to the earlier one?", "answer_data": [ "old and new revisions", "effective scope", "formulation-change decision", "lot binding evidence" ] }, { "id": "revisions-q2", "kind": "temporal", "text": "Which event, effective and observation times are known and which date-only values must retain their precision?", "answer_data": [ "time kind", "RFC 3339 timestamp where known", "offset", "date precision", "source", "unknown interval" ] }, { "id": "revisions-q3", "kind": "interoperability", "text": "Which qualifiers would be lost in a consumer or trading-partner projection and when must export be refused?", "answer_data": [ "target profile and mapping version", "omitted qualifiers", "mandatory safety context", "loss report", "refusal reason" ] } ], "data_elements": [ { "id": "revisions-data-1", "name": "Assertion payload", "description": "old and new revisions; effective scope; formulation-change decision; lot binding evidence. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ] }, { "id": "revisions-data-2", "name": "Evidence and applicability", "description": "time kind; RFC 3339 timestamp where known; offset; date precision; source; unknown interval. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ] }, { "id": "revisions-data-3", "name": "Review and unknown state", "description": "target profile and mapping version; omitted qualifiers; mandatory safety context; loss report; refusal reason. Candidate structured group; nested schema and constrained vocabularies are deferred.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ] } ], "artifacts": [ { "id": "revisions-artifact", "name": "Revision and projection control record", "description": "Versioned evidence-backed local assertion record; references source and external master artifacts without replacing them.", "media_or_form": [ "structured record", "human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master-system artifact identifier first; governed persistent IRI second; Dimension-assigned UUID third. Revision and digest are separate from stable identity. Dates and filenames are not identity.", "source_refs": [ "SRC-001", "SRC-003", "SRC-007", "SRC-008" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "resolve-food-reference", "name": "Resolve a product reference", "description": "Proposed operation, not implemented. Resolve exact qualified aliases and product revisions; never merge by name, image or ingredient similarity.", "inputs": [ "master namespace and reference", "market and package scope" ], "outputs": [ "resolved reference or ambiguity report" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Read-only resolution; no identity allocation or merger" ], "source_refs": [ "SRC-003", "SRC-007" ] }, { "id": "record-declaration", "name": "Record an evidenced declaration", "description": "Proposed operation, not implemented. Append a locally reviewed declaration linked to its source; do not change the physical label, recipe or regulatory master.", "inputs": [ "product revision", "declaration artifact and issuer", "market and effective scope" ], "outputs": [ "candidate declaration revision or refusal report" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Append local provenance and review state; unresolved assertions stay unknown" ], "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] }, { "id": "compare-food-revisions", "name": "Compare food declarations", "description": "Proposed operation, not implemented. Compare compatible revisions and expose allergen, basis and identifier-review differences; do not assign a new GTIN or notify external parties.", "inputs": [ "two pinned revisions", "comparison profile" ], "outputs": [ "scoped differences and incompatible fields" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Read-only change assessment; no external state change" ], "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] }, { "id": "project-nutrient-basis", "name": "Project compatible nutrient values", "description": "Proposed operation, not implemented. Calculate a labeled local projection only when basis, units and necessary conversion evidence are explicit; do not turn estimates into laboratory measurements.", "inputs": [ "qualified nutrient assertion", "target quantity and compatible basis", "required density or yield evidence" ], "outputs": [ "derived values with lineage or refusal report" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Create a separate calculated assertion; preserve originals and uncertainty; no medical recommendation" ], "source_refs": [ "SRC-001", "SRC-005", "SRC-007" ] }, { "id": "link-safety-notice", "name": "Link a scoped safety notice", "description": "Proposed operation, not implemented. Record an existing notice and evidence for applicability or unresolved scope; do not issue, close, suppress or broadcast a recall.", "inputs": [ "notice master reference and revision", "product or lot binding", "scope and issuer evidence" ], "outputs": [ "applicable, inapplicable or unresolved linkage" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Append local linkage with check time and coverage limits; no safe-to-consume determination" ], "source_refs": [ "SRC-002", "SRC-006", "SRC-007", "SRC-008" ] }, { "id": "export-food-projection", "name": "Prepare an authorized food projection", "description": "Proposed operation, not implemented. Create a local recipient-scoped export with pinned mapping, freshness and loss report. Refuse omission of required allergen, date or safety context.", "inputs": [ "recipient purpose and authority", "pinned declaration revision", "target mapping and access profile" ], "outputs": [ "local projection and loss report or refusal" ], "preconditions": [ "Verified role, purpose and scope for every accessed record", "Pinned evidence and profile; missing authority or incompatible basis causes refusal", "Mutation requires expected revision and idempotency key; concurrent mismatch causes refusal" ], "effects": [ "Record local projection provenance; no transmission or access expansion" ], "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] } ], "composition": [ { "target": "WM-OBJ-002", "relation": "ALIGN", "purpose": "Candidate generic product-definition alignment; pin neighbor before integration.", "required": false, "source_refs": [ "SRC-003" ] }, { "target": "WM-OBJ-003", "relation": "REFERENCE", "purpose": "Optional market-view link; legacy M3 inheritance rejected because offers and pricing remain separately mastered.", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "target": "WM-OBJ-001", "relation": "REFERENCE", "purpose": "Optional observed or serialized physical pack; its condition, custody and lifecycle are external.", "required": false, "source_refs": [ "SRC-003", "SRC-007" ] }, { "target": "WM-MAT-001", "relation": "REFERENCE", "purpose": "Optional chemical ingredient reference only when suitable; complex food ingredients need other vocabularies.", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "target": "External lot and traceability master", "relation": "REFERENCE", "purpose": "Namespace-qualified lot-to-revision evidence; no generic lot model identifier is invented.", "required": false, "source_refs": [ "SRC-002", "SRC-007" ] }, { "target": "External safety notice master", "relation": "REFERENCE", "purpose": "Issuer-owned notice, scope and revisions; execution and notification remain outside this model.", "required": false, "source_refs": [ "SRC-002", "SRC-006" ] }, { "target": "FoodOn", "relation": "ALIGN", "purpose": "Concept references require ontology release and mapping review; no semantic-equivalence or import claim.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "INFOODS tagnames", "relation": "ALIGN", "purpose": "Nutrient identifiers need a pinned table and component definition; mappings are not implemented.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "PROV-O 2013-04-30", "relation": "ALIGN", "purpose": "Evidence attribution and derivation concepts; no implemented ontology binding.", "required": false, "source_refs": [ "SRC-007" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Role-based product data steward with namespace and mandate; no named commercial owner is prescribed", "Market, language, jurisdiction, category and applicable rule versions", "Evidence access, retention, review, change and emergency-escalation policy", "Pinned external master bindings and controlled vocabulary releases" ], "namespace_guidance": "Use a Dimension-governed food-product namespace. Keep product, revision, lot, item, statement and artifact identifiers distinct. Do not embed dates in stable local IDs.", "registry_links": [ "vr.wm-obj-004", "Candidate WM-OBJ-002 alignment", "Optional WM-OBJ-001 and external lot-master bindings" ] }, "canon_and_patch": { "canonicalization_rules": [ "This research is a noncanonical reviewable draft; schema validity is not food-law or safety approval.", "Preserve original label text, language and source; normalized fields retain conversion and extraction lineage.", "Do not collapse contains, may contain, absence claim, unreported and unknown; preserve unit, basis, market and revision qualifiers." ], "patch_rules": [ "Use expected-revision checks, attributable reason and idempotency key. Never overwrite a conflicting declaration without retaining provenance.", "Formulation changes create scoped revisions and may trigger identifier review; do not rebind existing lots without evidence." ], "compatibility_rules": [ "Identity equivalence and mappings require pinned schemes; wildcard imports are prohibited.", "Changing units, edible basis, allergen classification or profile is not silently backward compatible. Refuse lossy exports of required context." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier with namespace", "Governed global identifier or persistent IRI", "Dimension-assigned UUID or ULID" ], "timestamp_rule": "Known event timestamps use RFC 3339 with seconds and an explicit offset or Z. Keep event time, effective time and observation or ingestion time separate. Date-only and partial-date label markings retain precision; never fabricate midnight instants.", "serial_naming_rule": "Stable artifact identifier plus separate revision counter; filenames are projections and timestamps are metadata.", "integrity_rule": "Record digest and retrieval provenance for retained source bytes where permitted. A digest proves byte continuity only. Do not invent hashes for pages accessed solely through browser extraction." }, "policies": [ "No inference from absent allergen statements, a valid barcode, unexpired date, negative notice search or administrative closure to personal suitability or safe consumption.", "Food-law, specialized-food, supplement and controlled-category questions require qualified market profiles; hazardous subjects stay at policy level.", "No actuation, recall dispatch, label replacement, formulation control or individual medical decision is authorized by these proposed functions.", "Do not use default confidentiality to suppress required food safety disclosures; route to authorized emergency and regulatory processes without claiming this model executes them." ], "crud": { "read": [ "Resolve revision, market, freshness, purpose and access scope before presenting declarations; expose unknown and conflicting assertions." ], "create": [ "Require local identity authority and evidence; create a draft assertion rather than counterfeit an operator declaration." ], "update": [ "Append a version with reviewer, reason, evidence and optimistic concurrency; preserve scoped supersession and existing lot bindings." ], "delete": [ "Retire local assertions with resolvable tombstones under the adopting Dimension retention and deletion policy. Evidence holds constrain disposal; erase restricted payloads when lawfully authorized while keeping minimal permitted provenance.", "Deletion never destroys a referenced lot, item, notice or laboratory master and cannot rescind a recall. Their owning systems execute their own disposition." ] }, "roles": [ { "name": "Product data steward", "responsibilities": [ "Maintain namespace and revision bindings under documented authority." ] }, { "name": "Declaration reviewer", "responsibilities": [ "Check market applicability, label evidence, exceptions and conflicting assertions." ] }, { "name": "Food safety reviewer", "responsibilities": [ "Assess notice linkage and escalate uncertainty through authorized processes; do not infer individual safety." ] }, { "name": "Evidence custodian", "responsibilities": [ "Control rights, retention, integrity and access to supporting artifacts." ] }, { "name": "Consumer-view reader", "responsibilities": [ "Read authorized public declarations with freshness and unresolved-status context." ] } ], "access": { "default_rule": "Deny nonpublic access unless purpose and role grants cover the requested fields. Public label data requires an approved projection; restricted recipes and contacts are not public by association.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "Authorized authority and emergency disclosure routes follow the adopted policy and applicable duties; record basis and scope, never treat this as automatic external-write permission." ], "audit_requirements": [ "Record requester role, purpose, source revision, granted scope, withheld fields and export loss; maintain audit references in the designated audit master." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL", "Owner role", "Evidence and review holds" ], "read_order": [ "AGENTS.md", "spec.yaml", "Dimension authority and market profile", "Pinned external records and source evidence" ] } }, "coverage": { "claim": "Source-grounded proposed structure for one human-food product definition with qualified declarations and external lot, item and safety-notice references. Selected EU and US examples inform the design. A separate frozen local no-tools self-audit found no critical conflict. This remains a noncanonical reviewable draft with independent-review, source/version, specialist-profile and executable-conformance holds.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Product, revision, aliases, lot and item identities are separated." }, { "dimension": "lifecycle", "status": "covered", "notes": "Local declaration revisions and external notice supersession are scoped." }, { "dimension": "relationships", "status": "covered", "notes": "External product, item, ingredient, lot and notice masters remain distinct." }, { "dimension": "temporal", "status": "covered", "notes": "Effective and observed times differ; date marking preserves precision." }, { "dimension": "provenance", "status": "covered", "notes": "Sources, extraction and calculated assertions retain lineage." }, { "dimension": "ownership", "status": "covered", "notes": "Responsibility is role based; physical holding does not grant declaration authority." }, { "dimension": "validation", "status": "gap", "notes": "Research schema validation exists; instance conformance and regulatory acceptance do not." }, { "dimension": "access", "status": "covered", "notes": "Field-sensitive projections preserve safety context and restricted evidence." }, { "dimension": "retention and deletion", "status": "covered", "notes": "Local retirement and payload disposal follow policy without deleting external masters." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual alignments need pinned releases and loss-tested mappings." }, { "dimension": "direct properties", "status": "covered", "notes": "Form, nominal quantity, nutrient basis and observed measurements remain qualified." }, { "dimension": "recognition and observation", "status": "covered", "notes": "OCR, labels and barcodes are evidence with ambiguity, not authentication." }, { "dimension": "capabilities and actions", "status": "covered", "notes": "Six proposed local operations expose refusals and never act on physical food." }, { "dimension": "safety applicability", "status": "covered", "notes": "Product declarations cannot establish item safety; unresolved notice scope remains unresolved." } ], "known_omissions": [ "Current complete jurisdictional law and specialist profiles, including novel foods, supplements, infant food, alcohol and non-prepacked exceptions, are not exhaustively researched.", "Independent external review is absent under the single-provider waiver.", "Direct HTTP verification is not attempted under the owner-reported sandbox block; no HTTP response status is measured. Browser content access is a separate observation.", "Nested instance schemas, enumerations, pinned neighbor bindings, FoodOn and INFOODS release mappings and executable conformance fixtures remain incomplete.", "Facility controls, microbiological criteria, laboratory sampling design, hazard limits, food-contact packaging compliance and actual lot condition are delegated, not certified." ], "conflicts": [], "regional_assumptions": [ "EU 1169/2011 consolidated 2025-04-01 is a selected label-information example; General Food Law is read as an original act, not verified current consolidation.", "FDA allergen information applies in its stated US scope and is not merged with EU allergen categories into a universal mandatory list.", "FoodOn covers a wider food/feed vocabulary than this model. INFOODS identifiers require independent component-definition and release checks." ], "adversarial_checks": [ "Reject a label-free product being classified allergen-free or safe.", "Reject GTIN or visual similarity as proof of lot, formulation or authenticity.", "Reject global lot rebinding after a formulation revision.", "Reject converting mass to volume nutrition without adequate density and basis evidence.", "Reject treating best-before as the same rule as use-by or fabricating timestamps from partial dates.", "Reject a closed recall or incomplete negative search as proof that every item is unaffected.", "Reject automatic ingredient-list or durability requirements without profile-specific exceptions." ] }, "researchAdjudication": { "providerMode": "single-provider-waiver", "activeProviders": [ "codex" ], "waivedProviders": [ "claude", "grok" ], "providerPolicy": { "contract_version": "1.0.0", "mode": "single-provider-waiver", "effective_at": "2026-09-06T00:00:00Z", "scope": "Canonical single-stream subject-model research after the six-workstream consolidation", "active_providers": [ "codex" ], "waived_providers": [ { "provider": "claude", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "Claude produced no result on prior 1800-second and 900-second attempts and again timed out on bounded 600-second Sonnet and 300-second Haiku passes. The owner prioritized completion over provider availability." }, { "provider": "grok", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "The repository owner authorized completion without Grok when Grok is unavailable, slow or schema-invalid. Grok may still be attempted as a bounded supplemental reviewer, but its failure never blocks a valid Claude plus no-tools result." } ], "review_rule": "Codex may complete source-grounded fallback research after bounded Claude and Grok attempts fail. It requires a separate no-tools adversarial audit and remains reviewable-draft with a visible absence-of-external-review hold.", "supplemental_provider_attempts": [ { "provider": "claude", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." }, { "provider": "grok", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." } ] }, "boundaryDecision": { "entry_kind": "entity", "status": "accepted", "rationale": "The root is a persistent governed product-definition entity with revision identity, not an individual pack, lot or food classifier. Legacy M4 explicitly distinguishes product class and batch. Generic catalog, offer, traceability and notice masters stay external; the registry standalone-mm value is not a research subject-kind enum." }, "decisions": [ { "concept": "Definition versus physical population", "disposition": "accepted", "rationale": "The identity finding, quantity observation and lot links consistently separate definition, revision, lot and item. A product declaration cannot establish the actual condition of every instance." }, { "concept": "Legacy M3 inheritance", "disposition": "rejected", "rationale": "The legacy generic-good inheritance is not compatible with silently absorbing offer and price semantics. The draft uses a provisional generic-product alignment and an optional market-view reference." }, { "concept": "Universal identifier and commercial ownership", "disposition": "qualified", "rationale": "Master namespace identity supports loose food and absent GTINs. No named commercial owner is prescribed; a physical holder does not automatically acquire declaration authority." }, { "concept": "Human-food and unprocessed-food boundary", "disposition": "accepted with profile limits", "rationale": "The supplement's broad pre-processing exclusion is corrected. Harvested unprocessed human food remains representable. Borderline medicinal and specialized categories need market review and are not decided by ingestion alone." }, { "concept": "Ingredient and durability cardinality", "disposition": "qualified", "rationale": "The draft rejects universal mandatory lists and date rules inherited from the legacy card. Evidence of an applicable exception is different from missing or unknown information." }, { "concept": "Allergen and suitability inference", "disposition": "separated", "rationale": "Intentional content, precautionary statements, absence claims and unknowns remain distinct. No missing statement, valid identifier or current label becomes a personal suitability guarantee." }, { "concept": "Nutrition basis and measurements", "disposition": "accepted with refusal rules", "rationale": "Component identity, units, method, qualifier and preparation basis are preserved. Derived values remain calculated, and mass-volume or serving conversions require adequate evidence." }, { "concept": "Recognition and observed properties", "disposition": "qualified", "rationale": "Image, OCR and barcode evidence can support a candidate match but not authentication. Nominal quantity and measured observations retain different scopes, with external item or sample identity." }, { "concept": "Durability and after-opening condition", "disposition": "separated", "rationale": "Best-before and use-by meanings are profile dependent and not interchangeable. Actual lot dates and storage history are external evidence; partial dates do not become invented timestamp instants." }, { "concept": "Traceability and recall applicability", "disposition": "accepted as references", "rationale": "Product-to-lot, origin and notice bindings preserve external masters. Incomplete scope produces unresolved applicability. Negative searches and issuer closure cannot certify all instances as safe." }, { "concept": "Operations and disclosure", "disposition": "accepted as proposed only", "rationale": "All six functions are unimplemented local operations with scoped authority and refusal conditions. They do not alter food, assign external identifiers, change labels, execute recalls or transmit messages. Consumer projections must preserve required safety qualifiers." }, { "concept": "Evidence, access and retention", "disposition": "accepted with policy dependency", "rationale": "Source declarations, claims and derived assertions preserve attribution. Restricted payloads may be disposed of under policy while minimal permitted tombstones retain reference continuity; history does not require indefinite personal-data retention." }, { "concept": "Source and conformance coverage", "disposition": "limited", "rationale": "Selected browser readings ground concepts, not exhaustive current legal or technical compliance. The original General Food Law, unpinned vocabularies and failed Codex retrieval remain explicit limits. Optional candidate field groups are not an executable instance schema." }, { "concept": "Independent review and direct HTTP", "disposition": "waived and held", "rationale": "Claude and Grok were skipped with zero attempts. The frozen local self-audit is not an independent provider. Direct HTTP was not attempted under the reported sandbox block, so zero measured successes means no measurements rather than eight failed checks." } ], "publicationHolds": [ "Independent external review is absent. Claude and Grok were skipped with zero attempts under the owner-authorized waiver. The separate local Codex no-tools self-audit is not an independent second-provider review.", "Source and version verification remains incomplete. Eight sources were accessed through selected browser content, but direct HTTP checks were not attempted under the owner-reported sandbox restriction: all statuses are unmeasured. The coordinator checker is prepared. Current General Food Law consolidation, full claim support, rights and FoodOn/INFOODS release pins need verification; Codex Alimentarius full-text reconciliation is deferred.", "Jurisdiction, category, language, exception, allergen, claim, date and specialized-food profiles require qualified review before operational use. No individual suitability, actual item safety, label compliance or regulatory approval is certified.", "Nested instance schemas, controlled vocabularies, pinned neighbor bindings, mapping implementation and adversarial runtime fixtures remain incomplete. All six functions are proposed local operations without implementation or conformance certification.", "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft." ], "deferredResearch": [ "Verify source responses outside the sandbox, current consolidated law, applicable national measures, specialist food profiles and the full international Codex source.", "Pin vocabulary releases and neighbor models, develop nested schemas and test instances covering loose food, exemptions, coexisting formulations, conflicting allergen declarations, partial dates, uncertain storage and incomplete recall scope.", "Restore independent external review before any canonical or publishable-draft promotion." ] }, "statistics": { "sources": 8, "bundles": 7, "layers": 14, "findings": 14, "questions": 42, "artifacts": 14, "functions": 6 } }