{ "schema": "icu-content-state-contract", "schema_version": "1.0.0", "checkpoint": "ICU-EXPEDITION-008", "revision": "r000072-exp008-content-state-v1", "purpose": "Keep publication maturity, catalog lifecycle, evidence, freshness, rights/reuse, commerce, and interaction state separate. No single badge is a trust score.", "normative_rules": [ "A public page can be published while its subject remains a Future Concept, proposal, interpretation, or untested product.", "Source presence is not verification. Evidence labels describe the kind of support exposed, not a numeric confidence score.", "Freshness is explicit. Do not infer currentness from a file timestamp, release number, HTTP 200, or the word current in an internal pointer.", "Rights/reuse labels describe declared reuse context only; they are not legal conclusions beyond the cited declaration.", "Commerce state is independent of publication and external merchant availability. A public page is never a purchasable ICU offer merely because it exists.", "Domain-specific uncertainty remains visible. The shared layer may summarize it but must not erase specialist qualifiers or limitations." ], "catalog_lifecycle": { "source_contract": "/ICU_STATUS_LIFECYCLE_CONTRACT.json", "optional": true, "meaning": "Production/release lifecycle for an exact ICU catalog entry. It does not describe factual evidence, freshness, or commerce on its own.", "codes": [ "FUTURE_CONCEPT", "IN_DEVELOPMENT", "RELEASED", "AVAILABLE", "PAUSED", "RETIRED" ] }, "dimensions": { "publication_maturity": { "label": "Maturity", "meaning": "What kind of public artifact this page/resource is.", "values": { "SOURCE_RECORD": { "label": "Source record", "meaning": "A preserved catalog/source entry. Public visibility is not editorial validation, release intent, or a commerce promise." }, "PUBLISHED_RESOURCE": { "label": "Published resource", "meaning": "An intentionally public ICU resource. Published does not mean fact-checked, fresh, purchasable, or hands-on tested." }, "MAINTAINED_RESOURCE": { "label": "Maintained resource", "meaning": "A published resource with an explicit review/maintenance contract. This label requires declared review metadata." }, "HISTORICAL_SNAPSHOT": { "label": "Historical snapshot", "meaning": "A retained historical artifact or release snapshot; it is not the active current state." }, "PRIVATE_DRAFT": { "label": "Private draft", "meaning": "Not eligible for normal public discovery. Included in the contract for authoring/validation; not a public badge." } } }, "evidence_state": { "label": "Evidence", "meaning": "What kind of support is declared for the resource or its claims.", "values": { "NOT_DECLARED": { "label": "Evidence not declared", "meaning": "The shared layer does not assert an evidence state. Read the specialist page for any domain-specific notes." }, "SOURCE_PRESERVED": { "label": "Source preserved", "meaning": "The record preserves owner/source material for traceability. Preservation is not independent verification." }, "SOURCE_CONTEXT": { "label": "Sources visible", "meaning": "Source/provenance context is exposed. Source presence alone is not verification." }, "EXTERNAL_RESEARCH": { "label": "External research", "meaning": "Material claims are tied to external research sources. ICU may not have independently reproduced or hands-on tested them." }, "EDITORIAL_SYNTHESIS": { "label": "Editorial synthesis", "meaning": "ICU combines sourced material with interpretation/analysis. Interpretive conclusions remain labeled as interpretation." }, "BOUNDED_TEST": { "label": "Tested in scope", "meaning": "A bounded first-party ICU test/observation is documented with evidence references and limitations. It does not generalize beyond that scope." } } }, "freshness_state": { "label": "Freshness", "meaning": "Whether time-sensitive material has an explicit as-of/review state.", "values": { "NOT_DECLARED": { "label": "Freshness not declared", "meaning": "No shared as-of or review state is asserted." }, "NOT_TIME_SENSITIVE": { "label": "Not time-sensitive", "meaning": "The mapped claim/resource is not presented as depending on a current market, rule, price, stock, or live condition." }, "AS_OF": { "label": "Checked as of", "meaning": "Time-sensitive material has an explicit checked/as-of date. The date is not a guarantee that nothing changed later." }, "REVIEW_SCHEDULED": { "label": "Review scheduled", "meaning": "The resource declares both a checked/as-of date and a future review-due date." }, "NEEDS_REVIEW": { "label": "Review needed", "meaning": "The content owner has explicitly marked this resource for review. This state is not inferred merely from file age." } } }, "rights_reuse_state": { "label": "Rights / reuse", "meaning": "Declared reuse context for the ICU material or referenced media/source material.", "values": { "NOT_DECLARED": { "label": "Reuse not declared", "meaning": "No public reuse permission is asserted by this shared layer." }, "ICU_ORIGINAL_NO_PUBLIC_REUSE_LICENSE": { "label": "ICU-authored · reuse not granted", "meaning": "ICU-authored material is identified, but no general public reuse license is granted by this label." }, "OPEN_REUSE_DECLARED": { "label": "Open reuse declared", "meaning": "A specific open license/reuse declaration is cited. Follow that declaration rather than this badge alone." }, "PUBLIC_DOMAIN_SOURCE_DECLARED": { "label": "Public-domain source declared", "meaning": "A cited source explicitly declares public-domain status for the referenced source material; this does not automatically license ICU-added text, layout, or derivative media." }, "EXTERNAL_REFERENCE_ONLY": { "label": "External reference only", "meaning": "Third-party material is referenced as source/context; no reuse permission is implied." }, "RIGHTS_REVIEW_HOLD": { "label": "Rights review hold", "meaning": "Public treatment/reuse is blocked pending rights review. This is a workflow hold, not a legal conclusion." }, "MIXED": { "label": "Mixed rights context", "meaning": "The resource combines materials with different declared rights/reuse states; item-level labels control." } } }, "commerce_state": { "label": "Commerce", "meaning": "Whether the resource participates in an ICU transaction or only editorial/external paths.", "values": { "NOT_APPLICABLE": { "label": "No commerce role", "meaning": "The mapped resource has no commerce role." }, "NO_PUBLIC_OFFER": { "label": "No public ICU offer", "meaning": "No eligible ICU offer or checkout is attached. Publication/availability of a page does not change this." }, "ORDINARY_EXTERNAL_LINK": { "label": "External merchant link", "meaning": "An ordinary non-ICU merchant destination is present. Price, stock, checkout, returns, and delivery remain the merchant’s responsibility unless separately stated." }, "PUBLIC_OFFER_ELIGIBLE": { "label": "Eligible ICU offer", "meaning": "A specific offer passed ICU public-offer eligibility gates. This state requires evidence in the commerce registry and does not imply direct checkout." }, "DIRECT_CHECKOUT_ACTIVE": { "label": "ICU checkout active", "meaning": "ICU is accepting a transaction for the exact offer and the required customer-policy/delivery gates are active." } } }, "interaction_state": { "label": "Interaction", "meaning": "How the resource behaves as a product surface.", "values": { "STATIC": { "label": "Editorial/static", "meaning": "Primarily a reading/browsing surface." }, "INTERACTIVE": { "label": "Interactive", "meaning": "Contains an interactive tool, game, calculator, or stateful experience." }, "LOCAL_ONLY": { "label": "Local-browser state", "meaning": "Interactive state is stored locally in the browser; it is not a server-backed account or shared verification system." }, "EXPERIMENTAL": { "label": "Experimental", "meaning": "A prototype/experiment surface whose behavior should not be mistaken for a production service or externally validated outcome." } } } }, "presentation": { "required_order": [ "publication_maturity", "catalog_lifecycle", "evidence_state", "freshness_state", "rights_reuse_state", "commerce_state", "interaction_state" ], "color_independent": true, "numeric_trust_scores_prohibited": true, "help_route": "/content-state/", "compact_card_rule": "Show only dimensions that are supported by the card/registry. Unknown dimensions are omitted rather than guessed.", "detail_rule": "Detail pages may show all mapped dimensions and domain-specific notes; specialist uncertainty/limitations remain authoritative." } }