# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-06T21:53:50Z", "synthesisSha256": "b8ccd3082097bdc7917ede6f5adeedfa86970457fdbbb50495e135457c6eb9e1", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-OBJ-003", "registryId": "vr.wm-obj-003", "name": "Tradable Offer / Commodity view", "version": "0.3.0", "previousVersions": [ { "version": "0.2.0-legacy", "url": "https://github.com/ver-cy/world-models/blob/feat/mega-model-registry/models/matter-artifacts/M3-tradable-good.md" } ], "entryKind": "pattern", "family": "World Models", "category": "Physical world and living systems", "industry": [ "Cross-industry" ], "domain": [ "PHY.OBJ.TYPE" ], "tags": [ "tradable", "offer", "commodity", "view", "phy.obj.type" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-obj-003-tradable-offer-commodity-view/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-obj-003", "model": { "registry_id": "vr.wm-obj-003", "model_id": "WM-OBJ-003", "name": "Tradable Offer / Commodity view", "entry_kind": "pattern", "purpose": "Describe a governed market-facing view of an identified good, preserving product, item, lot and commercial-offer masters.", "scope_statement": "A format-neutral projection pattern for goods in a market context. Each materialization binds a subject reference and revision, catalogue steward, channel or audience, market, language and view revision. It holds selected assertions and provenance, not a new product class, stock ledger or executable offer. Commodity means a good viewed for exchange here, not a financial derivative or a universal fungibility assertion.", "in_scope": [ "View identity, market context, subject and variant bindings, scheme-qualified identifiers and category assertions", "Projected pack and measure descriptions, recognition evidence, offer and availability references, restricted-use and traceability flags", "Materialization provenance, freshness, conflict handling, audience filtering and local revision retirement" ], "out_of_scope": [ "Creating product types, assigning global identifiers, owning individual physical items, production lots or inventory", "Authoring commercial quotes, prices, acceptance, reservations, orders, settlements, title transfer or exchange trading", "Initiating or lifting recalls, certifying authenticity, deciding customs classification, regulated-item clearance or safety", "Detailed service, digital entitlement and financial commodity profiles; runtime mappings and universal compliance engines" ], "boundary_notes": [ { "neighbor": "WM-OBJ-002 Product Type / Catalog Item", "distinction": "Owns reusable product and variant definitions. This pattern carries a revision-pinned subject binding and selected projections only; the legacy M3 product-class root is reconciled to that separate master.", "source_refs": [ "SRC-001", "SRC-003" ] }, { "neighbor": "WM-OBJ-001 Physical Item Instance", "distinction": "Owns serial instance identity, actual condition and physical history. A class-level declaration cannot be promoted into a measured property of every instance.", "source_refs": [ "SRC-001", "SRC-004" ] }, { "neighbor": "WM-ECO-021 Offer / Quote", "distinction": "Owns commercial terms and proposal lifecycle. Its incoming registry parent candidate is not accepted as inheritance: use optional offer references; a market view can exist without a live offer.", "source_refs": [ "SRC-002", "SRC-006" ] }, { "neighbor": "WM-MAT-004 Material Batch / Lot and WM-OBJ-020 Inventory Stock Position", "distinction": "Own lot membership, production history and stock position respectively. Traceability and availability references remain time-qualified external evidence, never local stock or batch lifecycle.", "source_refs": [ "SRC-004" ] }, { "neighbor": "WM-MAT-001 Chemical Substance and WM-XCT-001 Ownership / Stewardship", "distinction": "Composition or hazard details and rights remain externally mastered. A catalogue steward, seller and title holder can differ; a listing is not proof of ownership or permission to trade.", "source_refs": [ "SRC-001", "SRC-005" ] }, { "neighbor": "Legacy M3 Tradable Good", "distinction": "Catalogue, identification and pack concerns survive as view projections. Mandatory packaging, universal classification, batch creation and automatic food or medicine inheritance are not carried forward. Specialized restrictions require separate profiles.", "source_refs": [ "SRC-001", "SRC-003", "SRC-004" ] } ] }, "sources": [ { "id": "SRC-001", "title": "Product", "organization": "Schema.org", "url": "https://schema.org/Product", "version_or_date": "Development page accessed 2026-10-07; release not pinned", "source_type": "schema", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Product properties, identifiers, variants and the offers link inform the distinction between item description and commercial proposal." }, { "id": "SRC-002", "title": "offers", "organization": "Schema.org", "url": "https://schema.org/offers", "version_or_date": "Development page accessed 2026-10-07; release not pinned", "source_type": "schema", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Links the offered subject to a separate Offer or Demand; businessFunction qualifies the proposed exchange." }, { "id": "SRC-003", "title": "GTIN Management Standard", "organization": "GS1", "url": "https://ref.gs1.org/standards/gtin-management/", "version_or_date": "Release 1.1, ratified September 2023, retrieved PDF", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Sections 1, 2.1, 2.3 and 2.8 inform trade-item identity, variants, declared content and pack changes. Excludes identification of non-new trade items." }, { "id": "SRC-004", "title": "EPCIS Standard", "organization": "GS1", "url": "https://ref.gs1.org/standards/epcis/2.0.1/", "version_or_date": "URL names 2.0.1 but returned PDF identifies Release 2.0, June 2022; discrepancy unresolved", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Visibility events, eventTime and recordTime support external traceability references and separate observation times. No claim of EPCIS 2.0.1 conformance." }, { "id": "SRC-005", "title": "PROV-O: The PROV Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "W3C Recommendation, 30 April 2013", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Derivation, attribution and revision relations inform provenance of materialized market views; provenance does not establish truth or authority." }, { "id": "SRC-006", "title": "GS1 Web Vocabulary", "organization": "GS1", "url": "https://ref.gs1.org/voc/Product", "version_or_date": "Dynamic vocabulary landing page accessed 2026-10-07; term release unresolved", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Landing text distinguishes product information, product offers and linked resources. Only that overview is admitted; dynamic Product properties were not rendered." }, { "id": "SRC-007", "title": "How GPC works", "organization": "GS1", "url": "https://www.gs1.org/standards/gpc/how-gpc-works", "version_or_date": "Official indexed page accessed 2026-10-07; classification release unresolved", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Official indexed overview supports classification by product brick and attributes; neither concrete code assignments nor code crosswalks were verified." }, { "id": "SRC-008", "title": "Recommendation No. 20: Codes for Units of Measure used in International Trade", "organization": "United Nations Economic Commission for Europe", "url": "https://unece.org/DAM/cefact/recommendations/rec20/rec20_rev5E.pdf", "version_or_date": "Historical revision 5, ECE/TRADE/C/CEFACT/2008/6; current code list not verified", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T21:52:27Z", "relevance": "Indexed official historical text supports coded trade quantities including length, mass, volume and count. No current unit code or conversion table is asserted." } ], "structure": { "bundles": [ { "id": "b-binding", "name": "Subject and market binding", "description": "A view selects a subject without creating its master identity.", "rationale": "Product and offer vocabularies distinguish the item from its exchange context; the projection root is a local design decision.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ], "layers": [ { "id": "l-subject", "name": "Subject binding context", "description": "Proposed view key and typed subject reference distinguish product class, variant, individual and lot selection. A new view revision does not create a new product.", "source_refs": [ "SRC-001", "SRC-005" ], "findings": [ { "id": "f-subject", "name": "Subject binding", "description": "Proposed view key and typed subject reference distinguish product class, variant, individual and lot selection. A new view revision does not create a new product.", "source_refs": [ "SRC-001", "SRC-005" ], "questions": [ { "id": "q-subject-1", "text": "Which master subject and revision does this market view describe?", "kind": "identity", "answer_data": [ "subject_kind", "master_namespace", "subject_id", "subject_revision" ] }, { "id": "q-subject-2", "text": "What distinguishes this materialized view from another view of the same subject?", "kind": "definition", "answer_data": [ "view_id", "steward_ref", "market", "channel", "language", "view_revision" ] }, { "id": "q-subject-3", "text": "Which missing or conflicting subject bindings prevent a trustworthy projection?", "kind": "exception", "answer_data": [ "unresolved_reference", "conflicting_identifiers", "resolution_state" ] } ], "data_elements": [ { "id": "d-subject-subject", "name": "Subject", "description": "Typed authoritative subject identifier and immutable revision or as-of pin; mandatory before a usable projection.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "d-subject-view-key", "name": "View Key", "description": "View identifier, governing Dimension, steward reference, market, audience, locale and revision.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] } ], "artifacts": [ { "id": "a-subject", "name": "Subject binding manifest", "description": "Versioned evidence for subject binding. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-001", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-market", "name": "Market context context", "description": "Proposed context records where and for whom a view is intended, with external seller authority evidence. Market scope does not establish legal permission.", "source_refs": [ "SRC-002", "SRC-005" ], "findings": [ { "id": "f-market", "name": "Market context", "description": "Proposed context records where and for whom a view is intended, with external seller authority evidence. Market scope does not establish legal permission.", "source_refs": [ "SRC-002", "SRC-005" ], "questions": [ { "id": "q-market-1", "text": "Which market, channel and language qualify the displayed assertions?", "kind": "spatial", "answer_data": [ "market_scope", "channel", "locale", "effective_period" ] }, { "id": "q-market-2", "text": "Who stewards this view and what external authority supports acting for the seller?", "kind": "authority", "answer_data": [ "steward_ref", "seller_ref", "authority_evidence_ref", "scope", "expiry" ] }, { "id": "q-market-3", "text": "Which audience restrictions change the content visible in this market view?", "kind": "access", "answer_data": [ "audience_ref", "field_policy_ref", "redaction_basis", "policy_version" ] } ], "data_elements": [ { "id": "d-market-context", "name": "Context", "description": "Market, channel, language and validity interval; unknown market is explicit.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "id": "d-market-authority", "name": "Authority", "description": "External delegation and stewardship evidence; no inferred title or selling right.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] } ], "artifacts": [ { "id": "a-market", "name": "Market and audience profile", "description": "Versioned evidence for market context. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-002", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-description", "name": "Description and recognition", "description": "Represent selected product descriptions as attributed assertions.", "rationale": "Item properties and categories support discovery; identification evidence must remain distinct from marketing and proof of authenticity.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ], "layers": [ { "id": "l-description", "name": "Description and variant projection context", "description": "Project names, variant dimensions and declared characteristics with their master revision. Physical measures belong to identified subjects; the view itself has no mass or dimensions.", "source_refs": [ "SRC-001", "SRC-003" ], "findings": [ { "id": "f-description", "name": "Description and variant projection", "description": "Project names, variant dimensions and declared characteristics with their master revision. Physical measures belong to identified subjects; the view itself has no mass or dimensions.", "source_refs": [ "SRC-001", "SRC-003" ], "questions": [ { "id": "q-description-1", "text": "Which name and descriptive attributes are selected from which product revision?", "kind": "provenance", "answer_data": [ "attribute_path", "value", "language", "source_revision", "claim_status" ] }, { "id": "q-description-2", "text": "Which declared dimensions distinguish this variant and which values remain unknown?", "kind": "classification", "answer_data": [ "base_product_ref", "variant_ref", "dimension", "value", "unknown_reason" ] }, { "id": "q-description-3", "text": "Which claimed capability or intended use is only declared and which has supporting evidence?", "kind": "evidence", "answer_data": [ "capability_claim", "intended_use", "evidence_ref", "evidence_scope", "assessment_state" ] } ], "data_elements": [ { "id": "d-description-attributes", "name": "Attributes", "description": "Selected attribute assertions with original values and source field paths.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "d-description-variant", "name": "Variant", "description": "External variant identity with declared distinguishing dimensions; no local variant master.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] } ], "artifacts": [ { "id": "a-description", "name": "Attributed description extract", "description": "Versioned evidence for description and variant projection. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-001", "SRC-003" ] } ], "inline_only_rationale": null } ] }, { "id": "l-recognition", "name": "Recognition and classification context", "description": "Labels, images and scanned identifiers are fallible recognition evidence. Scheme-qualified categories aid discovery but do not establish equivalence, customs treatment or authenticity.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ], "findings": [ { "id": "f-recognition", "name": "Recognition and classification", "description": "Labels, images and scanned identifiers are fallible recognition evidence. Scheme-qualified categories aid discovery but do not establish equivalence, customs treatment or authenticity.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ], "questions": [ { "id": "q-recognition-1", "text": "Which label, image or scan supports the candidate match to the subject?", "kind": "evidence", "answer_data": [ "observation_ref", "method", "observed_at", "candidate_subjects", "match_confidence" ] }, { "id": "q-recognition-2", "text": "Which classification scheme, edition and code qualify the market category?", "kind": "classification", "answer_data": [ "scheme_uri", "scheme_version", "code", "assigned_by_ref", "validity" ] }, { "id": "q-recognition-3", "text": "How is a lookalike, ambiguous scan or disputed category prevented from becoming a confirmed match?", "kind": "quality", "answer_data": [ "ambiguity_reason", "contrary_evidence", "review_state", "decision_ref" ] } ], "data_elements": [ { "id": "d-recognition-recognition", "name": "Recognition", "description": "Candidate matches and observation references; a barcode match is not an authenticity certificate.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] }, { "id": "d-recognition-categories", "name": "Categories", "description": "External classification assignments with edition and attribution; no assumed exact crosswalk.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "a-recognition", "name": "Recognition and category assessment", "description": "Versioned evidence for recognition and classification. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-001", "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-trade-unit", "name": "Trade unit projection", "description": "Carry scheme-scoped identifiers and packaging quantities as references and assertions.", "rationale": "Trade-item change rules and quantity vocabularies inform a projection without granting identifier issuance authority.", "source_refs": [ "SRC-003", "SRC-008" ], "layers": [ { "id": "l-identifiers", "name": "Identifier assertions context", "description": "Preserve strings, issuer namespaces and level scope. A seller SKU, trade-item identifier and serial number are distinct; validation of syntax is not validation of issuer rights.", "source_refs": [ "SRC-001", "SRC-003" ], "findings": [ { "id": "f-identifiers", "name": "Identifier assertions", "description": "Preserve strings, issuer namespaces and level scope. A seller SKU, trade-item identifier and serial number are distinct; validation of syntax is not validation of issuer rights.", "source_refs": [ "SRC-001", "SRC-003" ], "questions": [ { "id": "q-identifiers-1", "text": "Which identifier scheme and issuer name the subject at the selected trade level?", "kind": "identity", "answer_data": [ "scheme", "issuer_ref", "identifier_string", "trade_level", "assignment_ref" ] }, { "id": "q-identifiers-2", "text": "What evidence distinguishes identifier syntax checks from authoritative assignment verification?", "kind": "validation", "answer_data": [ "check_type", "check_result", "verification_source", "checked_at", "unverified_reason" ] }, { "id": "q-identifiers-3", "text": "Which external identity decision applies after a pack or declared-content change?", "kind": "lifecycle", "answer_data": [ "change_ref", "old_identifier", "new_identifier", "decision_ref", "applicable_rule_version" ] } ], "data_elements": [ { "id": "d-identifiers-identifiers", "name": "Identifiers", "description": "Scheme-qualified strings with issuer, level and assignment evidence; retain leading zeroes.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "d-identifiers-change-review", "name": "Change Review", "description": "External identity decision; non-new items require their own approved policy outside the admitted management rule scope.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] } ], "artifacts": [ { "id": "a-identifiers", "name": "Identifier binding register", "description": "Versioned evidence for identifier assertions. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-001", "SRC-003" ] } ], "inline_only_rationale": null } ] }, { "id": "l-quantities", "name": "Packaging and quantity basis context", "description": "Project optional pack relationships and nominal quantities separately from observed measures. Proposed checks reject cycles and undocumented conversions; bulk or unpackaged goods need no fictional packaging hierarchy.", "source_refs": [ "SRC-003", "SRC-008" ], "findings": [ { "id": "f-quantities", "name": "Packaging and quantity basis", "description": "Project optional pack relationships and nominal quantities separately from observed measures. Proposed checks reject cycles and undocumented conversions; bulk or unpackaged goods need no fictional packaging hierarchy.", "source_refs": [ "SRC-003", "SRC-008" ], "questions": [ { "id": "q-quantities-1", "text": "Which packaging level and contained-subject quantities are declared for this view?", "kind": "composition", "answer_data": [ "pack_ref", "contained_subject_ref", "count", "fixed_or_variable", "source_revision" ] }, { "id": "q-quantities-2", "text": "What quantity, unit scheme and measurement basis qualify the displayed content?", "kind": "measurement", "answer_data": [ "quantity", "unit_code", "scheme_version", "net_or_gross", "nominal_or_observed", "method", "conditions", "uncertainty", "observed_at" ] }, { "id": "q-quantities-3", "text": "What evidence supports converting between sale, count, mass and volume units?", "kind": "constraint", "answer_data": [ "conversion_basis", "factor", "conditions", "tolerance", "authority_ref", "unsupported_conversion" ] } ], "data_elements": [ { "id": "d-quantities-pack-links", "name": "Pack Links", "description": "Projected containment edges with subject revisions and fixed or variable count; absent when inapplicable.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-008" ] }, { "id": "d-quantities-measure", "name": "Measure", "description": "Quantity, unit scheme/version, nominal or observed basis, method, conditions, tolerance, uncertainty and provenance when applicable.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-003", "SRC-008" ] } ], "artifacts": [ { "id": "a-quantities", "name": "Trade unit and measure sheet", "description": "Versioned evidence for packaging and quantity basis. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-003", "SRC-008" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-exchange", "name": "Exchange references and constraints", "description": "Expose exchange context without owning commercial proposals or operational eligibility decisions.", "rationale": "Offer links describe a relationship to transactions, while local policy controls whether evidence is sufficient to display a view.", "source_refs": [ "SRC-002", "SRC-006", "SRC-005" ], "layers": [ { "id": "l-offers", "name": "Offer and availability references context", "description": "Optional offer links retain counterpart identity and as-of time. Any price or availability display is an attributed external snapshot with basis and expiry, never a local quote or reservation.", "source_refs": [ "SRC-002", "SRC-004" ], "findings": [ { "id": "f-offers", "name": "Offer and availability references", "description": "Optional offer links retain counterpart identity and as-of time. Any price or availability display is an attributed external snapshot with basis and expiry, never a local quote or reservation.", "source_refs": [ "SRC-002", "SRC-004" ], "questions": [ { "id": "q-offers-1", "text": "Which external offers reference this subject and what exchange purpose do they declare?", "kind": "relationship", "answer_data": [ "offer_ref", "offer_revision", "subject_match", "business_function" ] }, { "id": "q-offers-2", "text": "How fresh is the linked availability or price assertion at the selected market scope?", "kind": "temporal", "answer_data": [ "snapshot_ref", "observed_at", "valid_until", "market", "price_currency", "quantity_basis", "freshness_state" ] }, { "id": "q-offers-3", "text": "What is shown when an offer expires, stock evidence is missing or sources disagree?", "kind": "state", "answer_data": [ "conflict_refs", "unknown_state", "display_policy", "last_checked_at" ] } ], "data_elements": [ { "id": "d-offers-offer-links", "name": "Offer Links", "description": "External offer references and matching subjects, with no local proposal lifecycle.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-004" ] }, { "id": "d-offers-snapshot", "name": "Snapshot", "description": "External stock or offer assertion with scope, temporal validity, currency and basis where relevant.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-004" ] } ], "artifacts": [ { "id": "a-offers", "name": "Exchange reference snapshot", "description": "Versioned evidence for offer and availability references. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-002", "SRC-004" ] } ], "inline_only_rationale": null } ] }, { "id": "l-restrictions", "name": "Restriction and disclosure context context", "description": "Proposed policy-level controls separate unknown eligibility, restrictions and approved disclosure. Regulated goods require specialist profile review; local display suppression neither enforces a trade ban nor certifies safety.", "source_refs": [ "SRC-005", "SRC-006" ], "findings": [ { "id": "f-restrictions", "name": "Restriction and disclosure context", "description": "Proposed policy-level controls separate unknown eligibility, restrictions and approved disclosure. Regulated goods require specialist profile review; local display suppression neither enforces a trade ban nor certifies safety.", "source_refs": [ "SRC-005", "SRC-006" ], "questions": [ { "id": "q-restrictions-1", "text": "Which external restriction or disclosure profile applies to this subject and market?", "kind": "requirement", "answer_data": [ "policy_ref", "jurisdiction", "subject_scope", "validity", "review_state" ] }, { "id": "q-restrictions-2", "text": "Which unresolved safety, rights or restriction evidence requires suppression or review?", "kind": "security", "answer_data": [ "evidence_refs", "risk_state", "local_display_decision", "authorized_reviewer_ref" ] }, { "id": "q-restrictions-3", "text": "What evidence and authority would permit changing a local restriction flag?", "kind": "decision", "answer_data": [ "prior_flag", "decision_ref", "authority_scope", "new_flag", "reason", "effective_at" ] } ], "data_elements": [ { "id": "d-restrictions-restriction-links", "name": "Restriction Links", "description": "External policy, recall or rights references with subject and market scope; no operational dangerous-item instructions.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] }, { "id": "d-restrictions-display-state", "name": "Display State", "description": "Local unknown, pending-review, suppressed or approved-for-profile state; approval is bounded and is not legal clearance.", "value_kind": "code", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] } ], "artifacts": [ { "id": "a-restrictions", "name": "Restriction review record", "description": "Versioned evidence for restriction and disclosure context. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-005", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-continuity", "name": "Traceability and view continuity", "description": "Keep external events separate from the lifecycle of this projection.", "rationale": "Traceability timing and derivation relations support reproducible references and explicit freshness without owning lot events.", "source_refs": [ "SRC-004", "SRC-005" ], "layers": [ { "id": "l-traceability", "name": "Lot and event references context", "description": "Optional lot or instance filters select bounded populations. Event assertions retain their source and subject scope; absence of an event is not proof of absence of recall or risk.", "source_refs": [ "SRC-004" ], "findings": [ { "id": "f-traceability", "name": "Lot and event references", "description": "Optional lot or instance filters select bounded populations. Event assertions retain their source and subject scope; absence of an event is not proof of absence of recall or risk.", "source_refs": [ "SRC-004" ], "questions": [ { "id": "q-traceability-1", "text": "Which external lot or instance selection bounds the displayed traceability information?", "kind": "relationship", "answer_data": [ "lot_ref", "instance_ref", "selection_rule", "subject_match", "population_scope" ] }, { "id": "q-traceability-2", "text": "Which event time, record time and ingestion time qualify a traceability assertion?", "kind": "temporal", "answer_data": [ "event_ref", "event_time", "record_time", "ingestion_time", "time_precision" ] }, { "id": "q-traceability-3", "text": "How are corrected or contradictory event references represented without overwriting source history?", "kind": "event", "answer_data": [ "original_event_ref", "correction_ref", "conflict_state", "source_revision" ] } ], "data_elements": [ { "id": "d-traceability-population", "name": "Population", "description": "External lot or serial selection with scoped identity; a bare lot string is insufficient.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-004" ] }, { "id": "d-traceability-events", "name": "Events", "description": "External event references, source versions and temporal qualification; operational processing remains external.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004" ] } ], "artifacts": [ { "id": "a-traceability", "name": "Traceability reference index", "description": "Versioned evidence for lot and event references. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-004" ] } ], "inline_only_rationale": null } ] }, { "id": "l-revision", "name": "View revision and retirement context", "description": "Proposed view lifecycle has draft, reviewed, active, stale, suppressed and retired states. These states describe presentation fitness only, not product discontinuation, offer acceptance or recall release.", "source_refs": [ "SRC-005" ], "findings": [ { "id": "f-revision", "name": "View revision and retirement", "description": "Proposed view lifecycle has draft, reviewed, active, stale, suppressed and retired states. These states describe presentation fitness only, not product discontinuation, offer acceptance or recall release.", "source_refs": [ "SRC-005" ], "questions": [ { "id": "q-revision-1", "text": "Which source or policy revision triggered this view revision and who approved it?", "kind": "lifecycle", "answer_data": [ "prior_view_revision", "input_changes", "policy_revision", "reviewer_ref", "decision_ref" ] }, { "id": "q-revision-2", "text": "When must this view be marked stale or rebuilt after an upstream change?", "kind": "process", "answer_data": [ "dependency_ref", "freshness_policy", "invalidation_reason", "rebuild_request_ref" ] }, { "id": "q-revision-3", "text": "What retention basis permits retiring or erasing this view while preserving necessary references?", "kind": "retention", "answer_data": [ "retention_policy_ref", "hold_ref", "disposition_authority", "tombstone_fields", "payload_erasure_scope" ] } ], "data_elements": [ { "id": "d-revision-revision-state", "name": "Revision State", "description": "View revision, predecessor, state, change reason and scoped review decision.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005" ] }, { "id": "d-revision-retention", "name": "Retention", "description": "Dimension policy and disposition authority for local payloads and minimal lawful tombstones.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005" ] } ], "artifacts": [ { "id": "a-revision", "name": "View revision ledger", "description": "Versioned evidence for view revision and retirement. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-assurance", "name": "Evidence and governed exchange", "description": "Preserve derivation and loss during audience-specific projection.", "rationale": "Provenance vocabulary supports attribution; verification, permissions and conformance gates are explicit local design requirements.", "source_refs": [ "SRC-005", "SRC-006" ], "layers": [ { "id": "l-provenance", "name": "Assertion provenance and conflict context", "description": "Proposed assertion records distinguish source quotation, transformation, observation and inference. Competing claims remain visible to authorized reviewers; the chosen display value retains its selection rationale.", "source_refs": [ "SRC-005" ], "findings": [ { "id": "f-provenance", "name": "Assertion provenance and conflict", "description": "Proposed assertion records distinguish source quotation, transformation, observation and inference. Competing claims remain visible to authorized reviewers; the chosen display value retains its selection rationale.", "source_refs": [ "SRC-005" ], "questions": [ { "id": "q-provenance-1", "text": "Which source fields and transformations produced each displayed assertion?", "kind": "provenance", "answer_data": [ "source_ref", "source_revision", "field_path", "transformation_ref", "input_digest", "assertion_type" ] }, { "id": "q-provenance-2", "text": "How are conflicting claims selected, withheld or preserved as unknown?", "kind": "quality", "answer_data": [ "competing_assertions", "selection_policy", "decision_ref", "unresolved_reason" ] }, { "id": "q-provenance-3", "text": "Which evidence is sufficient for a reviewer to reproduce the view without exposing restricted content?", "kind": "evidence", "answer_data": [ "input_manifest", "mapping_version", "digest", "access_grant_ref", "redacted_fields" ] } ], "data_elements": [ { "id": "d-provenance-lineage", "name": "Lineage", "description": "Per-assertion source paths, derivation steps, times and attribution.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005" ] }, { "id": "d-provenance-conflicts", "name": "Conflicts", "description": "Alternative assertions, uncertainty and selection decisions; no silent overwrite.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005" ] } ], "artifacts": [ { "id": "a-provenance", "name": "Assertion lineage manifest", "description": "Versioned evidence for assertion provenance and conflict. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-exchange-profile", "name": "Disclosure and mapping profile context", "description": "Proposed exports bind recipient, purpose and mapping version. Redactions and unsupported fields remain explicit; a successful serialization is not conformance certification or permission to publish.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ], "findings": [ { "id": "f-exchange-profile", "name": "Disclosure and mapping profile", "description": "Proposed exports bind recipient, purpose and mapping version. Redactions and unsupported fields remain explicit; a successful serialization is not conformance certification or permission to publish.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ], "questions": [ { "id": "q-exchange-profile-1", "text": "Which recipient and purpose authorize this export at each content scope?", "kind": "privacy", "answer_data": [ "recipient_ref", "purpose", "grant_ref", "bundle_layer_finding_artifact_scope", "expiry" ] }, { "id": "q-exchange-profile-2", "text": "What mapping version and losses qualify an external catalogue representation?", "kind": "interoperability", "answer_data": [ "target_schema", "target_version", "mapping_ref", "unsupported_fields", "loss_report" ] }, { "id": "q-exchange-profile-3", "text": "Which validation failures prevent local export preparation or require review?", "kind": "validation", "answer_data": [ "unresolved_refs", "stale_inputs", "permission_failures", "semantic_errors", "review_decision" ] } ], "data_elements": [ { "id": "d-exchange-profile-disclosure", "name": "Disclosure", "description": "Recipient, purpose, scope, grant evidence, expiry and redaction record.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ] }, { "id": "d-exchange-profile-mapping", "name": "Mapping", "description": "Pinned mapping and validation report; no claim of implemented standards conformance.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ] } ], "artifacts": [ { "id": "a-exchange-profile", "name": "Recipient projection manifest", "description": "Versioned evidence for disclosure and mapping profile. Preserve originating master references, claim status, author, effective time and ingestion time; omit unauthorized payloads.", "media_or_form": [ "Structured assertion record", "Human-readable evidence extract" ], "serial": true, "identity_strategy": "Authoritative master-system identifier first; governed IRI second; Dimension UUID or ULID fallback. Separate stable artifact identity from revision and content digest; no date-only names.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "fn-bind", "name": "Bind a view subject", "description": "Proposed local operation binding one market context to existing master revisions. Unimplemented research proposal.", "inputs": [ "subject_ref", "context", "authority_evidence", "expected_revision" ], "outputs": [ "new_view_revision or binding rejection" ], "preconditions": [ "Subject kind and revision resolve; namespace and steward authority are known", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Creates a local draft binding; does not create or re-identify the product" ], "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "fn-project", "name": "Build an attributed projection", "description": "Proposed local operation selecting and deriving approved description and trade-unit fields. Unimplemented research proposal.", "inputs": [ "pinned_source_assertions", "mapping_profile", "view_revision" ], "outputs": [ "projection and lineage or unresolved-input report" ], "preconditions": [ "All selected sources are accessible; transformation and measure bases are explicit", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Writes a new local projection revision; records unknowns and rejects unsupported unit conversions" ], "source_refs": [ "SRC-001", "SRC-003", "SRC-005", "SRC-008" ] }, { "id": "fn-check", "name": "Check view coherence", "description": "Proposed local semantic check for references, scope, identifier levels, units, pack cycles and evidence freshness. Unimplemented research proposal.", "inputs": [ "view_revision", "profile_rules", "external_evidence_refs" ], "outputs": [ "coherence report with failures and unknowns" ], "preconditions": [ "Pinned rule and mapping versions available; report distinguishes syntax from issuer verification", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Records local check results without verifying authenticity, assigning identifiers or certifying compliance" ], "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "fn-refresh", "name": "Reconcile changed source references", "description": "Proposed local operation comparing an upstream revision or correction with the pinned projection. Unimplemented research proposal.", "inputs": [ "change_notice_ref", "old_view_revision", "freshness_policy" ], "outputs": [ "stale or suppressed view revision and review request" ], "preconditions": [ "Source identity and scope match; expected revision prevents concurrent overwrite", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Marks affected local assertions stale or conflicted; does not change source offers, lots, stock or recall decisions" ], "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "fn-prepare-export", "name": "Prepare recipient projection", "description": "Proposed local operation assembling an audience-scoped draft export. Unimplemented research proposal.", "inputs": [ "view_revision", "recipient_ref", "purpose", "grant_ref", "mapping_version" ], "outputs": [ "local draft export with loss report or denial" ], "preconditions": [ "Grant covers every included scope; restrictions and freshness pass adopted policy", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Creates local artifact only; no syndication, external publication or recipient transmission" ], "source_refs": [ "SRC-001", "SRC-002", "SRC-005", "SRC-006" ] }, { "id": "fn-retire", "name": "Retire a view revision", "description": "Proposed local operation recording supersession and a disposition request. Unimplemented research proposal.", "inputs": [ "view_ref", "successor_ref", "retention_policy", "authority_ref" ], "outputs": [ "retirement record or retention-hold refusal" ], "preconditions": [ "Authority and dependent references checked; legal or policy holds resolved before payload erasure", "Actor permission, current revision and idempotency key checked before local mutation" ], "effects": [ "Retires local view with minimal lawful tombstone; payload erasure is delegated to Dimension storage policy and never deletes external masters" ], "source_refs": [ "SRC-005" ] } ], "composition": [ { "target": "WM-OBJ-002", "relation": "REFERENCE", "purpose": "Default class or variant subject master. Required when subject_kind is product-type; other permitted subject kinds use their corresponding master.", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "target": "WM-OBJ-001", "relation": "REFERENCE", "purpose": "Conditional individual subject and observed-condition evidence; no physical lifecycle ownership.", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] }, { "target": "WM-MAT-004", "relation": "REFERENCE", "purpose": "Conditional lot subject or population selection; production and recall event processing remain external.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "WM-ECO-021", "relation": "REFERENCE", "purpose": "Optional commercial proposal references; reject incoming parent candidate as semantic inheritance or mandatory offer containment.", "required": false, "source_refs": [ "SRC-002", "SRC-006" ] }, { "target": "WM-OBJ-020", "relation": "REFERENCE", "purpose": "Optional time-qualified availability evidence; do not derive a stock ledger or reserve quantities.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "WM-MAT-001", "relation": "REFERENCE", "purpose": "Optional composition and hazard disclosure references, kept at policy level in this view.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "WM-XCT-001", "relation": "REFERENCE", "purpose": "Stewardship, title and delegation evidence remain externally governed; the view cannot grant ownership.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "GS1 GTIN and GPC", "relation": "ALIGN", "purpose": "Scheme and edition-qualified identifier and category bindings, not issuance, classification authority or tested conformance.", "required": false, "source_refs": [ "SRC-003", "SRC-007" ] }, { "target": "UNECE Recommendation 20", "relation": "ALIGN", "purpose": "Candidate unit-code alignment; current lists and conversions require separate verification.", "required": false, "source_refs": [ "SRC-008" ] }, { "target": "Schema.org and GS1 Web Vocabulary", "relation": "ALIGN", "purpose": "Conceptual product and offer-link projection only; no operational mapping asserted.", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-006" ] }, { "target": "EPCIS and PROV-O", "relation": "ALIGN", "purpose": "External visibility-event and provenance references; no event repository implementation.", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Adopting Dimension identifies a role-based catalogue steward, governing namespace and subject master bindings.", "Pin market, channel, locale, audience, retention, disclosure and restricted-goods review policies.", "Define approved source, mapping and validation versions, authority evidence and escalation roles.", "A usable view must resolve exactly one primary subject binding; optional composition entries do not make the binding optional." ], "namespace_guidance": "Use a governed view namespace with stable IDs for views, assertions and artifacts; retain issuer namespaces for external identities. Never derive identity from a date, display label or seller name alone.", "registry_links": [ "vr.wm-obj-003", "WM-OBJ-002", "WM-OBJ-001", "WM-ECO-021" ] }, "canon_and_patch": { "canonicalization_rules": [ "Canonicalize local view keys and explicit null/unknown states while preserving original identifier strings, source values and unit schemes.", "Keep independent source assertions and their revisions; no cross-source merge on labels or shared category codes alone." ], "patch_rules": [ "Require expected revision, actor authority, evidence and reason; issue a new revision and retain lawful provenance.", "Upstream identity changes need a binding review; never silently rewrite a reference to a different trade item." ], "compatibility_rules": [ "Breaking changes to subject kinds, quantity semantics, authority or mapping rules require a new profile version and migration review.", "Export loss and unsupported fields must be reported; identical serialization shapes do not establish semantic equivalence." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier", "Governed global identifier or IRI", "UUID or ULID assigned by adopting Dimension" ], "timestamp_rule": "Use RFC 3339 with seconds and explicit offset or Z for instants. Distinguish source event time, record time, observation and ingestion time. Preserve date-only or uncertain source precision without inventing midnight.", "serial_naming_rule": "Use stable artifact ID plus separate revision token; dates are metadata, never sole identity.", "integrity_rule": "Hash exact retained bytes, record media type and source revision, and bind approved redactions to their derivation. A digest does not prove truth, authenticity or access authority." }, "policies": [ "All operational rules here are proposed Vercy governance design, not obligations asserted by the cited vocabularies.", "Keep claims, observed facts, derived values and unknowns distinct; unknown safety or permission never becomes approval.", "Controlled or hazardous subject profiles remain policy-level references and require qualified review; no acquisition, handling or evasion procedures.", "Supplier declarations and nominal pack values cannot substitute for instance measurements or legal origin evidence.", "Do not import universal packaging, classification or batch ownership from legacy M3; do not extend GTIN management rules to non-new items.", "Provider waiver and source, profile and conformance holds remain visible; no canonical completeness claim." ], "crud": { "read": [ "Resolve pinned references under recipient scope and report stale or unavailable sources explicitly." ], "create": [ "Create only authorized local view drafts with a typed primary subject and market context; no external master creation." ], "update": [ "Revision and permission checks precede change; preserve source provenance and scoped uncertainty." ], "delete": [ "Retire or supersede the local projection under an explicit retention and deletion policy; resolve holds and dependencies before payload erasure.", "Dimension storage governance executes authorized deletion; keep only lawful minimal tombstones and never delete referenced product, offer, lot, rights or event masters." ] }, "roles": [ { "name": "Catalogue steward", "responsibilities": [ "Own local view policy, subject selection and revision review without claiming title to goods." ] }, { "name": "Source custodian", "responsibilities": [ "Supply and correct externally mastered assertions within their authority." ] }, { "name": "Profile reviewer", "responsibilities": [ "Review market applicability, unit and identity exceptions, restrictions and disputed mappings." ] }, { "name": "Authorized consumer", "responsibilities": [ "Read only granted audience projections and report stale or conflicting evidence." ] }, { "name": "Automation operator", "responsibilities": [ "Prepare local artifacts within policy, reject unresolved authority and record idempotent outcomes." ] } ], "access": { "default_rule": "Deny by default until adopting-Dimension grants specify recipient, purpose, expiry and content scope; public source URLs do not authorize payload redistribution.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "Public catalogue extracts require an explicit publication grant; confidential supplier, lot and authority evidence can remain redacted.", "Emergency or mandatory disclosures require an externally evidenced authority and scoped review; this pattern does not create an exception." ], "audit_requirements": [ "Record actor, purpose, grant, source revision, view revision, scope, redactions and result in an external audit system.", "Keep minimal lawful access evidence; the view stores audit references rather than an audit-service implementation." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL" ], "read_order": [ "AGENTS.md and adopting Dimension authority policies", "Specification boundary, source holds and pinned master references", "Requested view findings and relevant evidence before mutation" ] } }, "coverage": { "claim": "Source-grounded proposed pattern for a governed market-facing view of identified goods, preserving external product, item, lot, stock and commercial-offer masters. A separate frozen local no-tools self-audit found no critical conflicts. This is a noncanonical reviewable draft under the single-provider waiver, with source/version, adoption-profile and executable-conformance holds.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Typed subject binding and distinct view key; external item identities remain mastered elsewhere." }, { "dimension": "lifecycle", "status": "covered", "notes": "View state and revision retirement differ from product and offer lifecycles." }, { "dimension": "relationships", "status": "covered", "notes": "Class, instance, lot, quote, stock and stewardship references preserve ownership boundaries." }, { "dimension": "temporal", "status": "covered", "notes": "Effective intervals, event, observation, record and ingestion times are distinct." }, { "dimension": "provenance", "status": "covered", "notes": "Per-assertion derivation and contrary claims retained under policy." }, { "dimension": "ownership", "status": "covered", "notes": "Catalogue stewardship, seller authority and title are separate roles and evidence." }, { "dimension": "validation", "status": "gap", "notes": "Research schema checks pass separately; instance schemas and executable mapping fixtures remain to be built." }, { "dimension": "access", "status": "covered", "notes": "Recipient, purpose and four content scopes govern local projections." }, { "dimension": "retention and deletion", "status": "covered", "notes": "View retirement and lawful erasure delegated to Dimension storage governance." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual vocabulary alignments only; no executable conformance or exact crosswalks." }, { "dimension": "direct properties", "status": "covered", "notes": "View context is local; physical and commercial properties are qualified projections." }, { "dimension": "recognition and observation", "status": "covered", "notes": "Label and scan evidence remain candidates with scope and uncertainty." }, { "dimension": "capabilities and actions", "status": "covered", "notes": "Declared product capability differs from six proposed local view operations." }, { "dimension": "source verification", "status": "gap", "notes": "Selected browser evidence is available; direct HTTP not attempted and source edition gaps remain." }, { "dimension": "regional applicability", "status": "gap", "notes": "Local legal, origin, safety, licensing and restricted-item profiles require qualified adoption review." } ], "known_omissions": [ "Independent external review is absent; the later local self-audit cannot replace it.", "Browser access is partial: source 006 is a dynamic landing overview and 007-008 have indexed evidence only; direct HTTP checks are unattempted under the reported sandbox block.", "EPCIS URL/document edition mismatch, current unit list, GPC edition, vocabulary release and non-new item identification policy remain unresolved.", "Concrete instance schemas, profile fixtures, executable mappings, specialized service/digital entitlement profiles and legal eligibility decisions are not supplied." ], "conflicts": [], "regional_assumptions": [ "No jurisdiction is presumed; vocabulary fields are not a universal law of sale, origin, safety or customs classification.", "Bulk, variable measure, refurbished, multipack and sector-specific goods require an adopting profile; no mandatory packaging or global equivalence rule." ], "adversarial_checks": [ "A listing with a valid-looking barcode must not be treated as authentic or legally sellable.", "Two offers and two market views of one product must not create four new product masters.", "A nominal pack quantity cannot establish actual lot stock or mass-to-volume conversion.", "An absent recall event or expired availability assertion must remain unknown under the profile.", "A revoked grant blocks export preparation even when the underlying source is public.", "An old view can remain reproducible only within retention and erasure constraints; provenance is not perpetual payload retention." ] }, "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": "pattern", "status": "accepted", "rationale": "The registry view-candidate is a record-plane classification, not a research-schema subject kind. A projection pattern best preserves the market aspect without creating another product master. Each materialization has a view identity and revision, while its class, variant, instance or lot identity remains externally governed. Persistent view records do not turn the pattern into an independent good or commercial proposal." }, "decisions": [ { "concept": "Projection pattern root", "disposition": "accepted", "rationale": "The subject and market findings bind a view to an existing master and context. The local revision lifecycle applies only to presentation fitness, preserving the distinction between a reusable pattern and its materialized records." }, { "concept": "Legacy M3 product class and batch ownership", "disposition": "reconciled", "rationale": "Catalogue concerns survive as selected assertions. Product definitions, individual items and production populations are delegated to their respective masters. Mandatory packaging and classification, operational identifier verification and batch release are not inherited from untrusted legacy material." }, { "concept": "Incoming Offer / Quote parent candidate", "disposition": "rejected as inheritance", "rationale": "WM-ECO-021 names this record as a parent in the registry, while the relation ledger has no direct rows. The frozen result explicitly uses optional offer references. Market views may exist without an offer; commercial proposal identity and lifecycle remain outside the pattern." }, { "concept": "Conditional subject dependencies", "disposition": "accepted with profile hold", "rationale": "Composition entries are individually optional because subject kind selects the appropriate master. The Dimension service rule separately requires exactly one primary subject binding. Candidate data elements remain optional research shapes, so an executable schema enforcing that rule is deferred rather than implied." }, { "concept": "Declared product properties and recognition", "disposition": "qualified", "rationale": "Description and recognition questions distinguish a source declaration, nominal type attribute, actual observation and candidate match. No barcode, image, label, category or marketing capability becomes proof of authenticity, identity equivalence or an instance measurement." }, { "concept": "Identifier and unit scope", "disposition": "accepted with limits", "rationale": "Issuer namespaces, level scope and identifier strings are retained. The non-new item exception is explicit, and conversions require their own evidence. Historical unit-code alignment does not establish a current code list, mass-to-volume conversion or identifier issuance authority." }, { "concept": "Offers, stock and restrictions", "disposition": "separated", "rationale": "Offer and availability content is a referenced external snapshot with time, market and quantity basis. Restriction flags govern local display only. A valid-looking listing, absent recall event or local profile approval cannot grant trading rights, reserve inventory or certify safety." }, { "concept": "Traceability and corrections", "disposition": "accepted as references", "rationale": "The traceability finding retains scoped lot or instance references and external event corrections with distinct time semantics. Neither the finding nor refresh function owns a lot lifecycle, event repository or recall process." }, { "concept": "Six proposed functions", "disposition": "accepted as local proposals", "rationale": "Binding, projection, coherence checking, source reconciliation, export preparation and retirement have stated permissions, revision checks and refusal outcomes. They create local records or requests only and do not issue identifiers, transact, syndicate or certify conformance." }, { "concept": "Access, lineage and retention", "disposition": "accepted with governance dependency", "rationale": "Recipient scope, purpose and grants constrain projected evidence. Provenance does not establish truth or perpetual retention. Retirement preserves only lawful minimal references, while Dimension storage governance executes authorized payload erasure without changing external masters." }, { "concept": "Evidence completeness and version discrepancy", "disposition": "held", "rationale": "The source review admits selected browser content, a partial vocabulary overview and two official indexed excerpts. The EPCIS URL and document versions differ. No direct HTTP checks were attempted, so zero counted successes means unmeasured status rather than eight failed requests or verified live sources." }, { "concept": "Operational profile and conformance", "disposition": "deferred", "rationale": "The frozen structure is a research proposal rather than nested instance schemas or executable mappings. Bulk, variable measure, used goods, specialist restrictions, licensing and regional applicability require qualified profile work and adversarial fixtures before operational adoption." }, { "concept": "Provider independence", "disposition": "waived and held", "rationale": "Claude and Grok were skipped with zero attempts under the owner override. This distinct no-tools semantic phase is a local Codex self-audit, not an independent provider result; no provider agreement or independent review can be claimed." } ], "publicationHolds": [ "Independent external review is absent under the owner-authorized single-provider waiver. Claude and Grok were skipped with zero attempts; the separate local Codex no-tools self-audit is not a second-provider review.", "Source and version verification remains incomplete. Direct HTTP checks were not attempted under the owner-reported sandbox restriction; all statuses are unmeasured. Six source URLs returned browser content, including one partial dynamic overview; two sources have official indexed evidence only. The EPCIS 2.0.1 URL returned a PDF labelled 2.0. Current unit and category editions and vocabulary release pins remain unresolved. Run the prepared coordinator checker and review content/version evidence before closing this hold.", "Qualified adoption profiles must resolve market and jurisdiction applicability, authority, licensing, origin and safety evidence, controlled-item policy, non-new item identity, bulk and variable quantities and disclosure/retention rules. No legal permission, safety certification or universal commodity fungibility is asserted.", "Nested instance schemas, conditional master bindings, executable mappings, acceptance fixtures and standards conformance remain incomplete. The six functions are unimplemented local design proposals; no runtime, trading or external publication capability is delivered.", "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft." ], "deferredResearch": [ "Resolve all source retrieval and edition gaps, including the EPCIS URL/document mismatch, dynamic vocabulary terms, classification edition and current unit lists.", "Develop qualified profiles and executable fixtures for missing subjects, conflicting identifiers, used goods, bulk and variable measures, pack cycles, expired offers, disputed recalls, revoked grants and lawful erasure.", "Restore independent external review before promotion toward a canonical or publishable draft." ] }, "statistics": { "sources": 8, "bundles": 6, "layers": 12, "findings": 12, "questions": 36, "artifacts": 12, "functions": 6 } }