# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-21T17:04:49Z", "synthesisSha256": "7767121155b0de4f4e1e519f8ebd2ccc111ae9a302726f90aff59ed1c5910917", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-DAT-014", "registryId": "vr.wm-dat-014", "name": "Dimension and Hierarchy", "version": "1.0.0", "previousVersions": [], "entryKind": "entity", "family": "World Models", "category": "Information and virtual systems", "industry": [ "Cross-industry" ], "domain": [ "INF.DAT.DIM" ], "tags": [ "dimension", "hierarchy", "inf.dat.dim" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-dat-014-dimension-and-hierarchy/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-dat-014", "model": { "registry_id": "vr.wm-dat-014", "model_id": "WM-DAT-014", "name": "Dimension and Hierarchy", "entry_kind": "entity", "purpose": "Describe a reusable analytical dimension and its versioned hierarchy bindings so consumers can select, group and interpret measures without inventing member identity or roll-up semantics.", "scope_statement": "One governed analytical dimension definition is the root. It carries a value-domain binding, contextual roles and zero or more hierarchy-view bindings. Hierarchy views have their own identities and revisions; externally maintained codes remain references. This is a proposed format-neutral metadata contract, not an executable analytics engine.", "in_scope": [ "Dimension identity, semantic concept, representation and analytical grain bindings.", "Member references, local exceptional-value policy, labels and hierarchy occurrences.", "Named hierarchy views, edge meaning, optional levels, roots, topology and contextual selection.", "Effective revisions, provenance, consumer mappings and declared aggregation eligibility.", "Local governance, change evidence, validation requirements and access policy for these metadata records." ], "out_of_scope": [ "Dataset rows, observations, materialized cubes and query execution.", "Metric formulas, units, numerical aggregation algorithms and certification of statistical validity.", "Ownership of external business entities, taxonomies, code lists, geographical boundaries or calendars.", "Physical dimensions, vector-space dimensions and the platform owner-package service named Dimension.", "Runtime authorization, disclosure-control engines, pipeline execution and global audit-trail operations." ], "boundary_notes": [ { "neighbor": "WM-DAT-001 Dataset", "distinction": "Registry parent is a catalog organization lead. A dimension can be reused across datasets, so do not infer exclusive containment or dataset lifecycle inheritance. Store only pinned consumer references.", "source_refs": [ "SRC-001", "SRC-003" ] }, { "neighbor": "WM-DAT-013 Metric Definition", "distinction": "This model records whether a hierarchy is eligible under a referenced measure aggregation contract; formulas and computation belong to the metric master.", "source_refs": [ "SRC-001" ] }, { "neighbor": "WM-DAT-015 Semantic Model", "distinction": "Role-specific dimension bindings are local metadata; semantic joins, query planning and model-wide evaluation remain external.", "source_refs": [ "SRC-001", "SRC-003" ] }, { "neighbor": "WM-DAT-004 Data Schema / Data Contract", "distinction": "Concrete record schemas and physical keys are external bindings; candidate answer fields here are not a complete instance schema.", "source_refs": [ "SRC-005" ] }, { "neighbor": "WM-DAT-006 Data Lineage and WM-DAT-007 Data Quality Evaluation", "distinction": "Carry derivation and validation-report references; do not own pipeline lineage execution or a global quality evaluator.", "source_refs": [ "SRC-004", "SRC-005" ] }, { "neighbor": "External concept and code schemes", "distinction": "Hierarchy occurrence identity differs from referenced code identity. Local aliases and revision pins do not transfer maintenance authority over source codes.", "source_refs": [ "SRC-002", "SRC-003" ] } ] }, "sources": [ { "id": "SRC-001", "title": "The RDF Data Cube Vocabulary", "organization": "W3C", "url": "https://www.w3.org/TR/vocab-data-cube/", "version_or_date": "Recommendation, 16 January 2014", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Sections 5-8 and 11: dimensions, typed or coded values, hierarchy links and integrity. Section 8.4 explicitly leaves aggregation operations unspecified." }, { "id": "SRC-002", "title": "SKOS Simple Knowledge Organization System Reference", "organization": "W3C", "url": "https://www.w3.org/TR/skos-reference/", "version_or_date": "Recommendation, 18 August 2009", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Sections 3-10: concepts, labels, schemes, direct and transitive semantic links, collections and mappings. Cycles can be SKOS-consistent; analytical acyclicity is an adopting-profile rule." }, { "id": "SRC-003", "title": "SDMX Standards Section 2: Information Model", "organization": "SDMX", "url": "https://sdmx.org/wp-content/uploads/SDMX_3-0-0_SECTION_2_FINAL-1_0.pdf", "version_or_date": "Version 3.0, October 2021, public release 1.0", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Sections 3-5 and 8: maintained versioned metadata, representations, hierarchy identity, external code references, multiple parents, roots, optional levels and associations. Selected text reviewed; not a claim about version 3.1 conformance." }, { "id": "SRC-004", "title": "PROV-O: The PROV Ontology", "organization": "W3C", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "Recommendation, 30 April 2013", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Entity, activity, attribution, derivation, revision and invalidation terms support provenance references; they do not establish correctness or permission." }, { "id": "SRC-005", "title": "Shapes Constraint Language (SHACL)", "organization": "W3C", "url": "https://www.w3.org/TR/shacl/", "version_or_date": "Recommendation, 20 July 2017", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Shapes graphs, data graphs and validation reports support explicit profile checks; research node validity does not certify dimension instances." }, { "id": "SRC-006", "title": "RFC 3339: Date and Time on the Internet: Timestamps", "organization": "IETF", "url": "https://www.rfc-editor.org/rfc/rfc3339", "version_or_date": "July 2002; base timestamp profile, update RFC 9557 noted", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Section 5.6 supports seconds and offsets for instant serialization. Calendar periods, interval bounds and temporal join policy require separate local definitions." }, { "id": "SRC-007", "title": "RFC 6902: JavaScript Object Notation (JSON) Patch", "organization": "IETF", "url": "https://www.rfc-editor.org/rfc/rfc6902", "version_or_date": "April 2013", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Operations, test preconditions and failure handling support an optional JSON projection. Domain authorization, atomic storage and hierarchy integrity are additional local requirements." }, { "id": "SRC-008", "title": "SDMX Technical Specifications", "organization": "SDMX", "url": "https://sdmx.org/standards-2/", "version_or_date": "Index consulted 21 October 2026; lists 3.1 release May 2025", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-21T17:02:54Z", "relevance": "Version discovery only: a 3.1 release exists. Linked 3.1 Information Model retrieval failed in the web service; this run pins substantive SDMX claims to the readable 3.0 text." } ], "structure": { "bundles": [ { "id": "b-definition", "name": "Identity and analytical meaning", "description": "Context for identity and analytical meaning.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-001", "SRC-003" ], "layers": [ { "id": "l-identity", "name": "Dimension identity context", "description": "Keep a stable dimension identifier separate from semantic concept, revision and any physical column. A dimension definition can exist before a dataset consumes it.", "source_refs": [ "SRC-001", "SRC-003" ], "findings": [ { "id": "f-identity", "name": "Dimension identity", "description": "Keep a stable dimension identifier separate from semantic concept, revision and any physical column. A dimension definition can exist before a dataset consumes it.", "source_refs": [ "SRC-001", "SRC-003" ], "questions": [ { "id": "f-identity-q01", "text": "Which master identifier and namespace identify this analytical dimension?", "kind": "identity", "answer_data": [ "dimension_id", "namespace", "master_ref" ] }, { "id": "f-identity-q02", "text": "What analytical distinction does the dimension express?", "kind": "definition", "answer_data": [ "concept_ref", "definition", "scope" ] }, { "id": "f-identity-q03", "text": "Which accountable role maintains its definition and approves revisions?", "kind": "ownership", "answer_data": [ "maintainer_role", "approval_policy_ref" ] }, { "id": "f-identity-q04", "text": "Which representation is coded, typed or explicitly mixed under the adopting profile?", "kind": "classification", "answer_data": [ "representation_kind", "profile_ref" ] } ], "data_elements": [ { "id": "f-identity-data-dimension-id", "name": "dimension_id", "description": "Stable identifier in an accountable namespace; never a label or date.", "value_kind": "identifier", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "f-identity-data-concept-ref", "name": "concept_ref", "description": "Semantic concept reference and version when maintained externally.", "value_kind": "reference", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "f-identity-data-representation-profile", "name": "representation_profile", "description": "Coded or typed value constraints, scope and maintainer role.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003" ] } ], "artifacts": [ { "id": "f-identity-artifact", "name": "Dimension identity record", "description": "Versioned local evidence or binding record for dimension identity. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-001", "SRC-003" ] } ], "inline_only_rationale": null } ] }, { "id": "l-usage", "name": "Grain and role bindings context", "description": "A usage binding names a dataset or semantic context, analytical role and expected grain. Reusing a date-like domain for separate roles does not make those roles interchangeable.", "source_refs": [ "SRC-001", "SRC-003" ], "findings": [ { "id": "f-usage", "name": "Grain and role bindings", "description": "A usage binding names a dataset or semantic context, analytical role and expected grain. Reusing a date-like domain for separate roles does not make those roles interchangeable.", "source_refs": [ "SRC-001", "SRC-003" ], "questions": [ { "id": "f-usage-q01", "text": "Which consumer and role use this dimension revision?", "kind": "relationship", "answer_data": [ "consumer_ref", "role_id", "dimension_revision" ] }, { "id": "f-usage-q02", "text": "Which other dimensions jointly define the consumer observation key?", "kind": "composition", "answer_data": [ "key_component_refs", "grain_statement" ] }, { "id": "f-usage-q03", "text": "What prevents a join from multiplying observations through ambiguous member matches?", "kind": "constraint", "answer_data": [ "join_cardinality", "uniqueness_rule", "failure_policy" ] }, { "id": "f-usage-q04", "text": "How is a dimension with no current consumer distinguished from a broken binding?", "kind": "exception", "answer_data": [ "binding_state", "unresolved_refs" ] } ], "data_elements": [ { "id": "f-usage-data-usage-bindings", "name": "usage_bindings", "description": "Consumer revision, role identifier, grain and join-cardinality declaration; no query implementation.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "f-usage-data-grain-statement", "name": "grain_statement", "description": "Meaning of one consumer observation, owned by the referenced consumer contract.", "value_kind": "text", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] } ], "artifacts": [ { "id": "f-usage-artifact", "name": "Grain and role bindings record", "description": "Versioned local evidence or binding record for grain and role bindings. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-001", "SRC-003" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-values", "name": "Values and member references", "description": "Context for values and member references.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003", "SRC-005" ], "layers": [ { "id": "l-members", "name": "Member identity and representation context", "description": "A code is qualified by its source scheme and revision. A member occurrence in a hierarchy also needs a hierarchy-scoped identity. Labels and notation are presentation and exchange values, not sufficient global keys.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ], "findings": [ { "id": "f-members", "name": "Member identity and representation", "description": "A code is qualified by its source scheme and revision. A member occurrence in a hierarchy also needs a hierarchy-scoped identity. Labels and notation are presentation and exchange values, not sufficient global keys.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ], "questions": [ { "id": "f-members-q01", "text": "Which source scheme, revision and member identifier resolve a coded value?", "kind": "identity", "answer_data": [ "scheme_ref", "scheme_revision", "member_id" ] }, { "id": "f-members-q02", "text": "How are typed values normalized without losing their declared datatype?", "kind": "interoperability", "answer_data": [ "datatype_ref", "normalization_profile" ] }, { "id": "f-members-q03", "text": "Where did each label, notation and language tag originate?", "kind": "provenance", "answer_data": [ "label", "language", "notation", "source_ref" ] }, { "id": "f-members-q04", "text": "How are duplicate labels and reused codes distinguished before matching?", "kind": "quality", "answer_data": [ "collision_report", "qualified_identity", "reuse_policy" ] } ], "data_elements": [ { "id": "f-members-data-member-refs", "name": "member_refs", "description": "Qualified source member identities and source revisions; not copies of source entity lifecycles.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ] }, { "id": "f-members-data-typed-domain", "name": "typed_domain", "description": "Datatype, facets and normalization policy for a non-enumerated domain.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ] }, { "id": "f-members-data-label-annotations", "name": "label_annotations", "description": "Language-qualified display labels and notation with attribution.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ] } ], "artifacts": [ { "id": "f-members-artifact", "name": "Member identity and representation record", "description": "Versioned local evidence or binding record for member identity and representation. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003" ] } ], "inline_only_rationale": null } ] }, { "id": "l-exceptions", "name": "Missing and partial domain semantics context", "description": "Missing, unknown, not applicable, suppressed and aggregate-all values require explicit distinct policies when used. Partial domain extracts cannot prove global absence; a synthetic total is not silently inserted as a source member.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ], "findings": [ { "id": "f-exceptions", "name": "Missing and partial domain semantics", "description": "Missing, unknown, not applicable, suppressed and aggregate-all values require explicit distinct policies when used. Partial domain extracts cannot prove global absence; a synthetic total is not silently inserted as a source member.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ], "questions": [ { "id": "f-exceptions-q01", "text": "Which exceptional states are represented and how are they distinguished?", "kind": "exception", "answer_data": [ "exception_code", "meaning", "representation" ] }, { "id": "f-exceptions-q02", "text": "Does a blank or absent value fail the selected consumer key contract?", "kind": "constraint", "answer_data": [ "requiredness", "key_rule", "failure_action" ] }, { "id": "f-exceptions-q03", "text": "Is the supplied member list complete for the claimed scope and revision?", "kind": "quality", "answer_data": [ "completeness_claim", "scope", "source_revision" ] }, { "id": "f-exceptions-q04", "text": "How is a suppressed value prevented from being interpreted as zero or an ordinary member?", "kind": "access", "answer_data": [ "suppression_policy_ref", "display_rule" ] } ], "data_elements": [ { "id": "f-exceptions-data-exception-policy", "name": "exception_policy", "description": "Explicit handling of absent, unknown, not-applicable, suppressed and total values, including inapplicable states.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] }, { "id": "f-exceptions-data-domain-completeness", "name": "domain_completeness", "description": "Full, partial or unknown coverage with the qualified scope of the claim.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] } ], "artifacts": [ { "id": "f-exceptions-artifact", "name": "Missing and partial domain semantics record", "description": "Versioned local evidence or binding record for missing and partial domain semantics. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-hierarchies", "name": "Hierarchy views and topology", "description": "Context for hierarchy views and topology.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ], "layers": [ { "id": "l-graph", "name": "Typed hierarchy edges context", "description": "Give each view and occurrence a stable identity. Declare edge direction, meaning, roots and parent multiplicity. A selected analytical profile may require an acyclic graph; this is stronger than bare SKOS semantics. A flat dimension needs no artificial parent.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ], "findings": [ { "id": "f-graph", "name": "Typed hierarchy edges", "description": "Give each view and occurrence a stable identity. Declare edge direction, meaning, roots and parent multiplicity. A selected analytical profile may require an acyclic graph; this is stronger than bare SKOS semantics. A flat dimension needs no artificial parent.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ], "questions": [ { "id": "f-graph-q01", "text": "Which hierarchy view and occurrence identifiers define this arrangement?", "kind": "composition", "answer_data": [ "hierarchy_id", "hierarchy_revision", "occurrence_id", "member_ref" ] }, { "id": "f-graph-q02", "text": "What does each directed parent-child edge mean in this view?", "kind": "relationship", "answer_data": [ "parent_ref", "child_ref", "edge_semantics" ] }, { "id": "f-graph-q03", "text": "Are multiple parents, disconnected roots or no hierarchy permitted by the selected profile?", "kind": "constraint", "answer_data": [ "parent_policy", "root_policy", "flat_policy" ] }, { "id": "f-graph-q04", "text": "What evidence detects cycles, dangling edges and unintended duplicate occurrences?", "kind": "validation", "answer_data": [ "topology_report_ref", "validation_scope", "profile_revision" ] } ], "data_elements": [ { "id": "f-graph-data-hierarchy-views", "name": "hierarchy_views", "description": "View identity, revision, purpose and external or locally governed authority.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] }, { "id": "f-graph-data-occurrences", "name": "occurrences", "description": "Hierarchy-scoped identity, member reference and explicit directed edges.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] }, { "id": "f-graph-data-topology-profile", "name": "topology_profile", "description": "Allowed roots, multiplicity, cycles and disconnected components; flat mode is explicit.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] } ], "artifacts": [ { "id": "f-graph-artifact", "name": "Typed hierarchy edges record", "description": "Versioned local evidence or binding record for typed hierarchy edges. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-levels", "name": "Levels, paths and ordering context", "description": "Formal levels are optional and differ from graph depth. Views may have skipped levels and uneven paths. Display ordering is not a numerical distance or an additive relationship.", "source_refs": [ "SRC-002", "SRC-003" ], "findings": [ { "id": "f-levels", "name": "Levels, paths and ordering", "description": "Formal levels are optional and differ from graph depth. Views may have skipped levels and uneven paths. Display ordering is not a numerical distance or an additive relationship.", "source_refs": [ "SRC-002", "SRC-003" ], "questions": [ { "id": "f-levels-q01", "text": "Which levels are formal semantic categories and which depths are only derived?", "kind": "classification", "answer_data": [ "level_id", "level_meaning", "formal_flag", "derived_depth" ] }, { "id": "f-levels-q02", "text": "How are skipped levels and leaves at unequal depths represented?", "kind": "composition", "answer_data": [ "path_ref", "level_assignment", "ragged_policy" ] }, { "id": "f-levels-q03", "text": "How does a consumer select a default or alternate hierarchy without changing member identity?", "kind": "process", "answer_data": [ "selection_context", "view_ref", "default_policy" ] }, { "id": "f-levels-q04", "text": "Which ordering rules are presentation-only rather than analytical comparisons?", "kind": "constraint", "answer_data": [ "order_key", "sort_policy", "semantic_order_flag" ] } ], "data_elements": [ { "id": "f-levels-data-levels", "name": "levels", "description": "Optional view-scoped levels and occurrence assignments; no universal balanced-tree assumption.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "id": "f-levels-data-navigation-policy", "name": "navigation_policy", "description": "View selection, path ambiguity and display ordering rules; no runtime traversal engine.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-002", "SRC-003" ] } ], "artifacts": [ { "id": "f-levels-artifact", "name": "Levels, paths and ordering record", "description": "Versioned local evidence or binding record for levels, paths and ordering. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-002", "SRC-003" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-change", "name": "Time and controlled change", "description": "Context for time and controlled change.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006", "SRC-007" ], "layers": [ { "id": "l-validity", "name": "Effective and recorded revisions context", "description": "Maintain revision identity and separate effective applicability from recorded time. A corrected historical assignment need not take effect when it was ingested. Period-valued analytical members remain calendar-qualified values, not fabricated instants.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ], "findings": [ { "id": "f-validity", "name": "Effective and recorded revisions", "description": "Maintain revision identity and separate effective applicability from recorded time. A corrected historical assignment need not take effect when it was ingested. Period-valued analytical members remain calendar-qualified values, not fabricated instants.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ], "questions": [ { "id": "f-validity-q01", "text": "What effective interval and boundary convention qualify this member assignment?", "kind": "temporal", "answer_data": [ "valid_from", "valid_to", "bound_convention", "calendar_ref" ] }, { "id": "f-validity-q02", "text": "When was the assertion recorded and from which source revision?", "kind": "provenance", "answer_data": [ "recorded_at", "source_revision", "source_ref" ] }, { "id": "f-validity-q03", "text": "How are overlapping effective assignments resolved for an as-of request?", "kind": "constraint", "answer_data": [ "overlap_rule", "as_of_policy", "conflict_state" ] }, { "id": "f-validity-q04", "text": "Which calendar, granularity and offset rules distinguish time members from audit instants?", "kind": "interoperability", "answer_data": [ "calendar_ref", "period_granularity", "instant_profile" ] } ], "data_elements": [ { "id": "f-validity-data-effective-assignments", "name": "effective_assignments", "description": "Versioned member or edge assertions with explicit interval semantics; dates retain declared precision.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] }, { "id": "f-validity-data-recorded-at", "name": "recorded_at", "description": "Record time as RFC 3339 with seconds and explicit offset or Z.", "value_kind": "timestamp", "cardinality": "1", "required": true, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] }, { "id": "f-validity-data-temporal-profile", "name": "temporal_profile", "description": "Calendar, as-of basis, overlap and open-bound handling.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] } ], "artifacts": [ { "id": "f-validity-artifact", "name": "Effective and recorded revisions record", "description": "Versioned local evidence or binding record for effective and recorded revisions. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] } ], "inline_only_rationale": null } ] }, { "id": "l-revision", "name": "Revision and migration evidence context", "description": "Changing a label, reparenting a member, splitting a code and replacing a meaning have different compatibility consequences. Supersession preserves a reference trail but does not imply semantic equivalence or indefinite payload retention.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ], "findings": [ { "id": "f-revision", "name": "Revision and migration evidence", "description": "Changing a label, reparenting a member, splitting a code and replacing a meaning have different compatibility consequences. Supersession preserves a reference trail but does not imply semantic equivalence or indefinite payload retention.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ], "questions": [ { "id": "f-revision-q01", "text": "Which state and approval evidence allow this revision to be used?", "kind": "lifecycle", "answer_data": [ "revision_state", "approval_ref", "effective_scope" ] }, { "id": "f-revision-q02", "text": "What semantic change caused the new revision?", "kind": "event", "answer_data": [ "change_kind", "prior_revision", "change_reason" ] }, { "id": "f-revision-q03", "text": "Which consumers need explicit migration after splits, merges or reparenting?", "kind": "interoperability", "answer_data": [ "consumer_refs", "mapping_ref", "impact_assessment" ] }, { "id": "f-revision-q04", "text": "What retention rule permits retirement or payload removal while preserving necessary reference continuity?", "kind": "retention", "answer_data": [ "retention_policy_ref", "disposition_ref", "tombstone_scope" ] } ], "data_elements": [ { "id": "f-revision-data-revision-record", "name": "revision_record", "description": "Revision identifier, predecessor, state, change reason and accountable approval.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] }, { "id": "f-revision-data-migration-bindings", "name": "migration_bindings", "description": "Consumer-specific mapping and impact evidence; no automatic historical restatement.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] } ], "artifacts": [ { "id": "f-revision-artifact", "name": "Revision and migration evidence record", "description": "Versioned local evidence or binding record for revision and migration evidence. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-analysis", "name": "Analytical use and exchange", "description": "Context for analytical use and exchange.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005", "SRC-002", "SRC-008" ], "layers": [ { "id": "l-rollup", "name": "Aggregation eligibility contract context", "description": "A hierarchy supplies navigation and grouping context, not proof that child measures sum to a parent. Record eligibility only against a pinned metric contract and explicit coverage, overlap, allocation and temporal conditions. Unknown eligibility blocks automatic roll-up.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ], "findings": [ { "id": "f-rollup", "name": "Aggregation eligibility contract", "description": "A hierarchy supplies navigation and grouping context, not proof that child measures sum to a parent. Record eligibility only against a pinned metric contract and explicit coverage, overlap, allocation and temporal conditions. Unknown eligibility blocks automatic roll-up.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ], "questions": [ { "id": "f-rollup-q01", "text": "Which metric contract and operator permit aggregation along this particular hierarchy?", "kind": "measurement", "answer_data": [ "metric_ref", "metric_revision", "operator_ref", "eligibility" ] }, { "id": "f-rollup-q02", "text": "What evidence shows complete disjoint coverage or an approved treatment of overlapping members?", "kind": "constraint", "answer_data": [ "coverage_evidence", "overlap_policy", "allocation_ref" ] }, { "id": "f-rollup-q03", "text": "Which non-additive or time-sensitive measure cases forbid a simple sum?", "kind": "exception", "answer_data": [ "restricted_metric_refs", "time_condition", "refusal_reason" ] }, { "id": "f-rollup-q04", "text": "How is repeated ancestry handled so an observation is not counted through multiple paths?", "kind": "validation", "answer_data": [ "deduplication_contract_ref", "path_scope", "test_report_ref" ] } ], "data_elements": [ { "id": "f-rollup-data-aggregation-eligibility", "name": "aggregation_eligibility", "description": "Allowed, forbidden or unknown under a pinned metric and hierarchy revision; default unknown.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] }, { "id": "f-rollup-data-aggregation-conditions", "name": "aggregation_conditions", "description": "Coverage, overlap, allocation, time and duplicate-path conditions with evidence references; formulas stay external.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] } ], "artifacts": [ { "id": "f-rollup-artifact", "name": "Aggregation eligibility contract record", "description": "Versioned local evidence or binding record for aggregation eligibility contract. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-mapping", "name": "Crosswalks and projection limits context", "description": "Crosswalks identify source and target schemes, revisions, direction and relationship strength. A similar label is not identity, and mapping equivalence does not establish aggregate preservation. Every exchange projection names its standard version and known losses.", "source_refs": [ "SRC-002", "SRC-003", "SRC-008" ], "findings": [ { "id": "f-mapping", "name": "Crosswalks and projection limits", "description": "Crosswalks identify source and target schemes, revisions, direction and relationship strength. A similar label is not identity, and mapping equivalence does not establish aggregate preservation. Every exchange projection names its standard version and known losses.", "source_refs": [ "SRC-002", "SRC-003", "SRC-008" ], "questions": [ { "id": "f-mapping-q01", "text": "Which source and target revisions and mapping relation define this crosswalk?", "kind": "interoperability", "answer_data": [ "source_ref", "target_ref", "relation", "mapping_revision" ] }, { "id": "f-mapping-q02", "text": "What evidence supports each match rather than label similarity alone?", "kind": "quality", "answer_data": [ "mapping_evidence", "confidence", "review_state" ] }, { "id": "f-mapping-q03", "text": "Which one-to-many or unmapped members require explicit loss or allocation decisions?", "kind": "exception", "answer_data": [ "unmapped_members", "split_map", "loss_report" ] }, { "id": "f-mapping-q04", "text": "Which target specification version and profile must a projection satisfy?", "kind": "requirement", "answer_data": [ "target_standard", "target_version", "profile_ref", "conformance_report" ] } ], "data_elements": [ { "id": "f-mapping-data-crosswalks", "name": "crosswalks", "description": "Version-qualified directed mappings with unresolved and ambiguous matches preserved.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-008" ] }, { "id": "f-mapping-data-projection-profile", "name": "projection_profile", "description": "Pinned exchange specification, unsupported features and test evidence; SDMX 3.1 support remains unverified.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-008" ] } ], "artifacts": [ { "id": "f-mapping-artifact", "name": "Crosswalks and projection limits record", "description": "Versioned local evidence or binding record for crosswalks and projection limits. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-002", "SRC-003", "SRC-008" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-assurance", "name": "Assurance and accountable use", "description": "Context for assurance and accountable use.", "rationale": "Separate this concern to make dimension metadata decisions inspectable without importing external execution responsibilities.", "source_refs": [ "SRC-004", "SRC-005" ], "layers": [ { "id": "l-validation", "name": "Evidence and validation scope context", "description": "A check result is bound to a dimension revision, profile, evidence snapshot and evaluator reference. Passing structural checks does not prove factual correctness, representative coverage, aggregation safety or privacy. Local functions below are proposed operations, not implementations.", "source_refs": [ "SRC-004", "SRC-005" ], "findings": [ { "id": "f-validation", "name": "Evidence and validation scope", "description": "A check result is bound to a dimension revision, profile, evidence snapshot and evaluator reference. Passing structural checks does not prove factual correctness, representative coverage, aggregation safety or privacy. Local functions below are proposed operations, not implementations.", "source_refs": [ "SRC-004", "SRC-005" ], "questions": [ { "id": "f-validation-q01", "text": "Which pinned shapes or equivalent rules validate this exact revision?", "kind": "validation", "answer_data": [ "rules_ref", "rules_revision", "dimension_digest" ] }, { "id": "f-validation-q02", "text": "Which fixtures expose multi-parent overlap, cycles, ragged paths and code reuse?", "kind": "evidence", "answer_data": [ "fixture_refs", "expected_results", "actual_report_ref" ] }, { "id": "f-validation-q03", "text": "Who produced the report and which source snapshots were examined?", "kind": "provenance", "answer_data": [ "evaluator_ref", "activity_ref", "input_digests" ] }, { "id": "f-validation-q04", "text": "Which failures, warnings and untested cases prevent operational approval?", "kind": "quality", "answer_data": [ "severity", "failure_refs", "untested_scope", "approval_state" ] } ], "data_elements": [ { "id": "f-validation-data-validation-bindings", "name": "validation_bindings", "description": "External report, rule profile, input digest, evaluator, outcome and unresolved findings.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "f-validation-data-source-bindings", "name": "source_bindings", "description": "Evidence location, source version, attribution and retrieval limits.", "value_kind": "collection", "cardinality": "1..n", "required": true, "source_refs": [ "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "f-validation-artifact", "name": "Evidence and validation scope record", "description": "Versioned local evidence or binding record for evidence and validation scope. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-governance", "name": "Authority, access and disclosure context", "description": "Proposed local governance rules assign accountable roles and policy bindings. Member labels, mapping paths and small-group structure can be sensitive. Derived visible views must not reveal restricted members or imply complete coverage after filtering. The cited vocabularies do not grant authority or supply a disclosure-control algorithm.", "source_refs": [ "SRC-004", "SRC-005" ], "findings": [ { "id": "f-governance", "name": "Authority, access and disclosure", "description": "Proposed local governance rules assign accountable roles and policy bindings. Member labels, mapping paths and small-group structure can be sensitive. Derived visible views must not reveal restricted members or imply complete coverage after filtering. The cited vocabularies do not grant authority or supply a disclosure-control algorithm.", "source_refs": [ "SRC-004", "SRC-005" ], "questions": [ { "id": "f-governance-q01", "text": "Which role and policy authorize definition, hierarchy or mapping changes?", "kind": "authority", "answer_data": [ "role_ref", "authority_policy", "approval_ref" ] }, { "id": "f-governance-q02", "text": "Which namespace and revision checks prevent an untrusted import from replacing an approved view?", "kind": "security", "answer_data": [ "import_policy", "namespace_binding", "expected_revision" ] }, { "id": "f-governance-q03", "text": "Which member attributes or relationships need restricted visibility for the stated purpose?", "kind": "privacy", "answer_data": [ "sensitivity_labels", "purpose", "access_policy_ref" ] }, { "id": "f-governance-q04", "text": "How are filtered paths and hidden totals reported without leaking restricted members?", "kind": "access", "answer_data": [ "view_policy", "redaction_marker", "completeness_notice" ] } ], "data_elements": [ { "id": "f-governance-data-governance-bindings", "name": "governance_bindings", "description": "Accountable roles, approval, namespace control and access policy references.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "f-governance-data-disclosure-profile", "name": "disclosure_profile", "description": "Purpose, sensitive member and edge policy, filtered-view semantics and external disclosure-control dependency.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "f-governance-artifact", "name": "Authority, access and disclosure record", "description": "Versioned local evidence or binding record for authority, access and disclosure. External artifacts remain referenced under their own masters.", "media_or_form": [ "Structured record", "Human-readable projection" ], "serial": true, "identity_strategy": "Authoritative master identifier first, then governed IRI, then owner-assigned UUID. Artifact revision and digest qualify content; timestamps and display names are not identity.", "source_refs": [ "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "fn-resolve", "name": "Resolve a dimension binding", "description": "Proposed local operation, not implemented. Resolve qualified identifiers and the requested revision without substituting the latest revision or matching labels alone.", "inputs": [ "dimension reference", "consumer role", "as-of basis" ], "outputs": [ "resolved binding or explicit ambiguous/unresolved result" ], "preconditions": [ "Read permission", "Pinned namespace and revision policy" ], "effects": [ "Return a local resolution record; do not mutate source members." ], "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "fn-propose-view", "name": "Propose a hierarchy revision", "description": "Proposed local operation, not implemented. Prepare a candidate view from authorized member references and explicit topology rules.", "inputs": [ "base revision", "candidate occurrences and edges", "topology profile" ], "outputs": [ "candidate revision", "diff", "unresolved reference list" ], "preconditions": [ "Change proposal authority", "Expected base revision matches" ], "effects": [ "Create a local proposal only; activation requires the accountable approval process." ], "source_refs": [ "SRC-003", "SRC-007" ] }, { "id": "fn-check-profile", "name": "Assess local metadata against a profile", "description": "Proposed local operation, not implemented. Request or bind a check report for a fixed metadata snapshot; no implemented validator or conformance certification is claimed.", "inputs": [ "dimension snapshot", "rule profile", "external evaluator reference" ], "outputs": [ "report binding or unavailable-evaluator refusal" ], "preconditions": [ "Read access to inputs", "Rules and evaluator pinned" ], "effects": [ "Record failures and untested scope; do not change dataset values or external report masters." ], "source_refs": [ "SRC-005", "SRC-004" ] }, { "id": "fn-assess-rollup", "name": "Record roll-up eligibility", "description": "Proposed local operation, not implemented. Evaluate whether supplied evidence supports a declared eligibility decision under a referenced metric contract; never calculate aggregates.", "inputs": [ "hierarchy revision", "metric contract", "coverage and overlap evidence" ], "outputs": [ "allowed, forbidden or unknown eligibility with rationale" ], "preconditions": [ "Metric maintainer supplies aggregation contract", "Accountable reviewer and evidence are identified" ], "effects": [ "Persist a local decision proposal; missing evidence yields unknown and blocks automatic roll-up." ], "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "fn-map", "name": "Propose a versioned crosswalk", "description": "Proposed local operation, not implemented. Record supported mappings and unresolved differences without collapsing identities.", "inputs": [ "source and target revisions", "mapping evidence", "relation type" ], "outputs": [ "crosswalk proposal", "loss and ambiguity report" ], "preconditions": [ "Mapping authority", "Source and target references resolve" ], "effects": [ "Preserve directional and non-equivalent relations; do not rewrite consumer facts." ], "source_refs": [ "SRC-002", "SRC-003" ] }, { "id": "fn-retire", "name": "Propose retirement of a revision", "description": "Proposed local operation, not implemented. Assess consumer references and retention policy before marking a local revision superseded or proposing payload disposition.", "inputs": [ "revision reference", "consumer inventory", "retention and hold policy" ], "outputs": [ "retirement proposal or blocked result", "minimal tombstone plan" ], "preconditions": [ "Authorized steward", "Dependency inventory and preservation holds checked" ], "effects": [ "Record proposed disposition only. External storage owners execute approved deletion; no source code list or observation deletion." ], "source_refs": [ "SRC-004", "SRC-007" ] } ], "composition": [ { "target": "WM-DAT-001", "relation": "REFERENCE", "purpose": "Candidate consumer dataset binding, not containment or inherited lifecycle.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "WM-DAT-013", "relation": "REFERENCE", "purpose": "Candidate metric contract for aggregation eligibility; formulas and computed measures stay external.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "WM-DAT-015", "relation": "REFERENCE", "purpose": "Candidate semantic context and role binding; query execution and joins stay external.", "required": false, "source_refs": [ "SRC-003" ] }, { "target": "WM-DAT-004", "relation": "REFERENCE", "purpose": "Candidate concrete instance-schema binding and projection contract.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "WM-DAT-006", "relation": "REFERENCE", "purpose": "Candidate provenance master binding; record derivation references only.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "WM-DAT-007", "relation": "REFERENCE", "purpose": "Candidate external validation report/evaluator binding, not evaluator ownership.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "SKOS", "relation": "ALIGN", "purpose": "Optional concept and mapping projection; analytical acyclicity requires additional rules.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "SDMX 3.0 Information Model", "relation": "ALIGN", "purpose": "Optional version-pinned hierarchy and representation mapping; 3.1 mapping remains held.", "required": false, "source_refs": [ "SRC-003", "SRC-008" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Name an accountable dimension steward role and adopting governance package.", "Pin namespace, master identifiers and semantic revision policy.", "Bind source schemes, consumer contracts, retention and access profiles without taking over their masters.", "The owner-package service called Dimension is distinct from this analytical dimension subject." ], "namespace_guidance": "Separate model-node IDs, dimension IDs, revision IDs, hierarchy-view IDs, occurrence IDs and source-code IDs. Do not derive identity from labels, paths or dates.", "registry_links": [ "vr.wm-dat-014", "WM-DAT-001", "WM-DAT-013", "WM-DAT-015" ] }, "canon_and_patch": { "canonicalization_rules": [ "Resolve source references using pinned namespace and revision; preserve edge direction and qualified code identities.", "Canonicalization must not turn a partial domain into a complete one, a graph into a tree, or an unknown aggregation decision into allowed." ], "patch_rules": [ "Require expected base revision, authorized role, reason and complete proposed diff. Revalidate changed graph and affected consumer bindings before activation.", "RFC 6902 is an optional JSON binding. Use test guards and an atomic adopting-store transaction; the serialization alone does not supply authority or concurrency safety." ], "compatibility_rules": [ "Label corrections can preserve identity; meaning replacement, splits, merges and temporal reassignment require explicit compatibility review.", "Preserve prior revision references and qualify historical restatement; never silently select a new hierarchy." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier with namespace", "Governed global identifier or IRI", "UUID or ULID assigned by the adopting governance package" ], "timestamp_rule": "Use RFC 3339 with seconds and explicit offset or Z for instants. Distinguish effective event time from observation or ingestion time. Period-valued dimension members retain calendar and granularity, not invented instant precision.", "serial_naming_rule": "Stable artifact identity plus separate revision and optional sequence; dates and display paths cannot be sole identifiers.", "integrity_rule": "Bind digest to exact serialized content, profile and revision. Digests detect byte changes, not truth, authority or semantic equivalence." }, "policies": [ "All rules beyond cited specification semantics are proposed local adoption rules. Evidence citations are alignments, not compliance certification.", "Default unknown for unresolved membership, completeness, temporal overlap and aggregation eligibility.", "Do not infer permissions from ancestry. Filtered hierarchy views need disclosure review and explicit partial-coverage markers.", "Retain only necessary metadata and evidence under a declared schedule; minimal tombstones must also follow that policy." ], "crud": { "read": [ "Resolve qualified identity and requested revision, then apply purpose and view-specific access. Return incompleteness explicitly." ], "create": [ "Create a dimension definition or local view only in an authorized namespace; bind source masters and initial approval state." ], "update": [ "Use guarded revision proposals, provenance and affected-consumer review; never overwrite source code masters or change past facts by implicit rebinding." ], "delete": [ "Retire or supersede local metadata after dependency checks. Apply the adopting retention/disposition policy and preservation holds; retain a minimal lawful tombstone only where permitted. Referenced dataset, code-list and storage owners execute their own deletion processes; this model grants no deletion authority over them." ] }, "roles": [ { "name": "Dimension steward", "responsibilities": [ "Maintain semantic scope, namespaces and revision proposals." ] }, { "name": "Hierarchy curator", "responsibilities": [ "Maintain authorized view edges and temporal assignment evidence." ] }, { "name": "Accountable reviewer", "responsibilities": [ "Approve compatibility, mapping and roll-up eligibility evidence." ] }, { "name": "Consumer integrator", "responsibilities": [ "Pin consumer roles and report projection loss or ambiguous joins." ] }, { "name": "Access custodian", "responsibilities": [ "Bind access, disclosure and retention policies; review sensitive views." ] } ], "access": { "default_rule": "Deny mutation unless an accountable policy authorizes the role; restrict sensitive metadata reads by purpose and scope. No implicit access inheritance through hierarchy edges.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "Approved public metadata views may be readable; redact restricted references and mark filtered completeness without leaking hidden member counts." ], "audit_requirements": [ "Record actor role, purpose, base and target revisions, decision and evidence references in the authorized audit system; this model carries only local change/report bindings." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL" ], "read_order": [ "Read AGENTS.md and visible review holds.", "Read model boundary and pinned adopting governance policies.", "Resolve source/consumer revisions before inspecting questions, artifacts or proposed operations." ] } }, "coverage": { "claim": "Source-grounded proposed metadata contract for one reusable analytical dimension with independently identified, versioned hierarchy views. Selected open specifications support the conceptual structure. Separate local no-tools self-audit completed; independent review, source/version checks, adoption profiles and executable conformance remain held. This is a noncanonical reviewable draft, not an analytics engine or a universal hierarchy specification.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Dimension, revision, view, occurrence and source member identities remain separate." }, { "dimension": "lifecycle", "status": "covered", "notes": "Proposed approval, supersession and retirement states with compatibility review." }, { "dimension": "relationships", "status": "covered", "notes": "Directed contextual edges and optional consumer bindings preserve external masters." }, { "dimension": "temporal", "status": "covered", "notes": "Effective versus recorded time, interval conventions, calendar and as-of scope." }, { "dimension": "provenance", "status": "covered", "notes": "Source and report references qualify evidence without certifying truth." }, { "dimension": "ownership", "status": "covered", "notes": "Accountable roles and source maintenance authority are distinct." }, { "dimension": "validation", "status": "gap", "notes": "Research schema validates; nested instance rules and adversarial executable fixtures remain pending." }, { "dimension": "access", "status": "covered", "notes": "Policy-bound visible views and explicit filtering limitations." }, { "dimension": "retention and deletion", "status": "covered", "notes": "Local disposition and minimal tombstones under external execution authority." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual mappings only; version-specific projection and round trips remain pending." }, { "dimension": "aggregation", "status": "covered", "notes": "Eligibility depends on metric contracts and evidence; no formula ownership." }, { "dimension": "direct properties", "status": "covered", "notes": "Representation, grain binding, topology, levels and temporal policy are abstract metadata." }, { "dimension": "recognition and observation", "status": "covered", "notes": "Qualified identifiers and provenance recognize asserted metadata; labels alone do not." }, { "dimension": "capabilities and actions", "status": "covered", "notes": "Six proposed local operations with preconditions, refusal outputs and bounded effects." }, { "dimension": "physical measurement", "status": "not-applicable", "notes": "The subject is abstract analytical metadata; physical quantities belong to referenced measures." }, { "dimension": "independent review", "status": "gap", "notes": "Local Codex self-audit is separate in phase but not independent external review." } ], "known_omissions": [ "Independent external review is absent under the owner waiver.", "Direct HTTP checks are not attempted because the owner reports sandbox blocking; no response statuses or body hashes were measured.", "Full version and errata review is incomplete; SDMX 3.1 Information Model retrieval failed, and 3.0 conceptual claims must not be promoted to 3.1 conformance.", "Nested instance schemas, exchange round trips and adversarial fixtures are designed but not implemented.", "Domain-specific aggregation operators, allocation formulas, fiscal calendars, geographic boundary histories and privacy controls require qualified profiles.", "Neighbor references are proposed bindings with no guaranteed deployed runtime or pinned neighbor version." ], "conflicts": [], "regional_assumptions": [ "No jurisdiction, fiscal calendar, language, timezone or geographic classifier is universal.", "Local authority, licensing, privacy and retention decisions require the adopting governance profile." ], "adversarial_checks": [ "Same label or reused code across schemes must not collapse member identity.", "A diamond graph must not imply additive totals or count an observation twice.", "A SKOS-consistent cycle may still fail the selected analytical DAG profile.", "A late correction must not silently rewrite an as-of view.", "A filtered hierarchy must not claim full coverage or expose hidden member counts.", "Unknown aggregation eligibility and missing conformance reports block operational claims." ] }, "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": "A governed dimension definition has stable identity across revisions, consumer roles and hierarchy views. It can describe typed values without a classifier and can exist without a consumer or hierarchy. Hierarchy and code masters retain their own identities. The registry standalone-mm value classifies the record plane and does not supply a valid subject-kind enum." }, "decisions": [ { "concept": "Dimension root and independent hierarchy identity", "disposition": "accepted", "rationale": "One dimension definition anchors the questions and proposed operations. Zero or more hierarchy bindings preserve flat dimensions and reusable externally maintained views; external code identity is never transferred to an occurrence." }, { "concept": "Dataset parent as exclusive containment", "disposition": "rejected", "rationale": "The frozen ledger has no relation rows. The registry parent is reconciled as an optional consumer reference because one dimension can serve multiple datasets or exist before any consumer. No dataset lifecycle inheritance is asserted." }, { "concept": "Typed domain versus classifier", "disposition": "accepted", "rationale": "The value representation admits coded and typed domains. Labels, notation, semantic concepts and qualified source identities are distinguished; a list of labels cannot silently become an authoritative member registry." }, { "concept": "Occurrence, topology and level identity", "disposition": "accepted with profile qualification", "rationale": "View-scoped occurrences and explicit edge meanings permit multiple parents and roots. Formal levels differ from graph depth. A flat dimension, skipped levels or ragged paths do not require a manufactured all-member or balanced tree." }, { "concept": "SKOS cycle rejection", "disposition": "qualified", "rationale": "The result explicitly permits the distinction between SKOS consistency and a stricter analytical DAG profile. Acyclicity is never presented as a universal SKOS integrity condition." }, { "concept": "Missing values and partial extracts", "disposition": "accepted", "rationale": "Unknown, absent, suppressed, not-applicable and aggregate-all states require explicit profile semantics. Partial domain evidence cannot establish absence, completeness or numerical zero." }, { "concept": "Automatic additive roll-up", "disposition": "rejected", "rationale": "Hierarchy structure alone cannot prove additive aggregation. Questions require a pinned metric contract, overlap and coverage evidence, temporal constraints and duplicate-path treatment. Missing evidence yields unknown and blocks automatic roll-up; formulas remain external." }, { "concept": "Historical change and temporal precision", "disposition": "accepted", "rationale": "Effective applicability and recorded time are separated, with explicit interval and as-of policy. Dates and calendar periods retain their own precision rather than receiving fabricated instants. Corrections and reparenting do not silently restate consumer facts." }, { "concept": "Mapping equivalence and exchange conformance", "disposition": "qualified and held", "rationale": "Crosswalks preserve direction, source/target revisions, ambiguity and loss. Similar labels or strong concept matches are not asserted to preserve identity or totals. SDMX 3.0 conceptual evidence does not certify SDMX 3.1 projections." }, { "concept": "Proposed function authority", "disposition": "accepted as local proposals only", "rationale": "All six operations declare inputs, role or policy preconditions, bounded effects and refusal or unresolved outputs. Local eligibility review does not calculate measures; report binding does not own an external evaluator; retirement does not delete external source records." }, { "concept": "Governance and source support", "disposition": "qualified", "rationale": "PROV-O and SHACL support evidence and validation representations, not authorization, privacy or retention rules. The result marks governance as proposed local adoption rules and keeps runtime enforcement and disclosure algorithms external." }, { "concept": "Reference continuity and retention", "disposition": "accepted with policy dependency", "rationale": "Supersession and minimal tombstones are subject to explicit retention and preservation holds. The result does not require perpetual sensitive payload retention or imply that deleting a local binding deletes an external dataset or code." }, { "concept": "Filtered views and completeness", "disposition": "accepted with disclosure review", "rationale": "The access rules forbid implicit permissions from ancestry and require partial-view notices without exposing hidden identities or counts. Actual disclosure controls remain an operational-profile dependency." }, { "concept": "Research validity versus instance validity", "disposition": "deferred operational assurance", "rationale": "The 48 questions and candidate answer fields cover the intended decision surface, but grouped objects do not implement nested instance schemas. Adversarial cases are an acceptance design, not executed tests or a conformance result." }, { "concept": "Evidence limits and independence", "disposition": "waived and held", "rationale": "Eight selected readable primary sources support the conceptual draft. No direct HTTP statuses were measured. The linked SDMX 3.1 text was not retrieved. This frozen local self-audit adds no facts and cannot count as independent external provider review." } ], "publicationHolds": [ "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft.", "Live source and version verification remains incomplete. Direct HTTP checks were not attempted under the owner-reported sandbox restriction, so no response statuses or body hashes were measured. Selected web-service content access is recorded separately. SDMX 3.1 Information Model retrieval failed; substantive alignment is pinned to 3.0 and full errata/version review remains open.", "Adopting profiles must resolve authority, source rights, calendars, temporal interval rules, code reuse, metric-specific aggregation and allocation, compatibility, disclosure and retention before operational use. No statistical validity or privacy certification is claimed.", "Nested instance schemas, pinned neighboring-model bindings, topology/temporal fixtures, concrete exchange mappings, round trips and executable conformance remain incomplete. The six local functions and adversarial acceptance cases are proposed designs, not implemented runtime capabilities." ], "deferredResearch": [ "Run the prepared direct-HTTP checker outside the sandbox and complete claim-level, version, errata and licensing review, including the target SDMX version.", "Implement and test nested profiles with flat, multi-root, multi-parent, cyclic, ragged, incomplete, overlapping-time and sensitive filtered-view cases; verify metric-specific roll-up and mapping loss without importing metric execution into this model.", "Pin consumer and neighbor revisions and obtain independent external review before any canonical or publishable-draft promotion." ] }, "statistics": { "sources": 8, "bundles": 6, "layers": 12, "findings": 12, "questions": 48, "artifacts": 12, "functions": 6 } }