# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-06T14:02:07Z", "synthesisSha256": "9ce4221adf2a069c06bd40188e81f362713833d7e96e1092a0b1140a5be0aaec", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-ACT-004", "registryId": "vr.wm-act-004", "name": "Service Definition", "version": "0.3.0-reviewable-draft", "previousVersions": [ { "version": "0.2.0-legacy", "url": "https://github.com/ver-cy/world-models/blob/feat/mega-model-registry/models/activity-work/K4-service.md" } ], "entryKind": "entity", "family": "World Models", "category": "Activities and processes", "industry": [ "Cross-industry" ], "domain": [ "ACT.SRV" ], "tags": [ "service", "definition", "act.srv" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-act-004-service-definition/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-act-004", "model": { "registry_id": "vr.wm-act-004", "model_id": "WM-ACT-004", "name": "Service Definition", "entry_kind": "entity", "purpose": "Describe a persistent provider-accountable service outcome, intended consumers and qualified contextual bindings.", "scope_statement": "One service definition with stable identity across revisions. It specifies what outcome is intended and the context in which consumers may use it. It is neither an offer nor a request, delivery episode, runtime deployment or assurance evaluator. The generic root supports public, commercial, internal, digital and non-digital services through profiles.", "in_scope": [ "Service identity, classification, outcome scope and provider accountability", "Definition-specific channel, condition, realization, quality and evidence bindings", "Definition revisions, descriptive states, continuity and controlled catalogue projections" ], "out_of_scope": [ "Commercial offer, subscription, entitlement, price, billing and contract lifecycles", "Request intake, eligibility decisions, delivery execution, case resolution and acceptance", "Workflow and organization master lifecycles; endpoint exposure and runtime health", "Measurement creation, SLO evaluation, breach determination and remedy enforcement", "Public-service legal entitlement and sector-specific operational procedures" ], "boundary_notes": [ { "neighbor": "WM-ORG-001", "distinction": "Bind accountable and realization-provider organization identities. Organization creation, ownership and lifecycle remain external.", "source_refs": [ "SRC-001", "SRC-004" ] }, { "neighbor": "WM-ACT-003", "distinction": "Pin a realization workflow definition; do not run workflows or own execution state.", "source_refs": [ "SRC-003" ] }, { "neighbor": "WM-ECO-022", "distinction": "Link subscriptions that cite the service. Entitlement, consumption periods, renewal and billing remain external.", "source_refs": [ "SRC-002", "SRC-003" ] }, { "neighbor": "WM-ACT-021", "distinction": "Link request or case masters by service revision. Intake, resolution, acceptance and closure remain case-owned.", "source_refs": [ "SRC-003", "SRC-006" ] }, { "neighbor": "WM-SFT-016", "distinction": "Bind service scope to SLO policy and evaluation references. Target evaluation, error budgets and breach lifecycle remain SLO-owned.", "source_refs": [ "SRC-003", "SRC-006" ] }, { "neighbor": "WM-MAT-008", "distinction": "Reference quality observations. Observation identity, value, unit, method, uncertainty and time remain observation-owned.", "source_refs": [ "SRC-009", "SRC-007" ] }, { "neighbor": "WM-PER-001", "distinction": "Optional individual provider identity; do not require every provider to be an organization or copy personal records.", "source_refs": [ "SRC-001" ] }, { "neighbor": "WM-ACT-001", "distinction": "Reference required capabilities without claiming they are exercised or currently available.", "source_refs": [ "SRC-003" ] }, { "neighbor": "WM-ECO-006", "distinction": "Reference applicable agreements; contractual obligations, enforceability, credits and remedies remain contract-owned.", "source_refs": [ "SRC-002", "SRC-003" ] }, { "neighbor": "WM-SFT-003", "distinction": "Reference a technical interaction contract only when the service has such an interface; business outcome identity is distinct.", "source_refs": [ "SRC-003", "SRC-005" ] }, { "neighbor": "WM-SFT-018", "distinction": "Reference digital endpoints where applicable; locator assignment, exposure and reachability lifecycle remain endpoint-owned.", "source_refs": [ "SRC-005" ] }, { "neighbor": "WM-POL-018", "distinction": "Public-service specialization requires its own legal and institutional profile; generic service identity does not confer public authority.", "source_refs": [ "SRC-004" ] }, { "neighbor": "Adopting offering master", "distinction": "Pin an external offer identifier and revision. Pricing, sale availability, transaction terms and acceptance are not service-definition lifecycle.", "source_refs": [ "SRC-002" ] }, { "neighbor": "K4 legacy Service card and unreviewed supplement", "distinction": "Reconcile the standing description, but externalize offer terms, requests, delivery episodes, quality observations and breach evaluation. Reject one-request-to-one-delivery cardinality as a generic invariant. Legacy conformance labels and wildcard imports are not inherited.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003", "SRC-004", "SRC-009" ] } ] }, "sources": [ { "id": "SRC-001", "title": "Service", "organization": "Schema.org community", "url": "https://schema.org/Service", "version_or_date": "Development vocabulary accessed 2026-10-06; release pin unresolved", "source_type": "schema", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Service properties: provider, audience, serviceOutput, serviceType, availableChannel, areaServed and offers. Vocabulary alignment, not a mandatory instance schema." }, { "id": "SRC-002", "title": "Offer", "organization": "Schema.org community", "url": "https://schema.org/Offer", "version_or_date": "Development vocabulary accessed 2026-10-06; release pin unresolved", "source_type": "schema", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Offer and itemOffered separate transaction terms from the item or service being offered. No legal enforceability inference." }, { "id": "SRC-003", "title": "Reference Model for Service Oriented Architecture 1.0", "organization": "OASIS", "url": "https://docs.oasis-open.org/soa-rm/v1.0/soa-rm.pdf", "version_or_date": "OASIS Standard, 12 October 2006", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Sections 3.1, 3.2.3 and 3.3: capabilities, expected effects, service descriptions, referenced policies and interaction context. Generalization beyond technical SOA is a proposed design choice." }, { "id": "SRC-004", "title": "Core Public Service Vocabulary Application Profile", "organization": "European Commission SEMIC", "url": "https://semiceu.github.io/CPSV-AP/releases/3.2.0/", "version_or_date": "3.2.0, SEMIC Recommendation, 2024-05-06", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Public Service, Participation and Channel sections support role, scope, requirement and service dependency links. Public-sector profile only; its cardinalities are not universal service rules." }, { "id": "SRC-005", "title": "Data Catalog Vocabulary (DCAT) - Version 3", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/vocab-dcat-3/", "version_or_date": "W3C Recommendation, 22 August 2024, as displayed", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Sections 6.4 and 6.9 distinguish catalog resources, versions and data services with endpoint descriptions. Data-service alignment only." }, { "id": "SRC-006", "title": "Service Standard", "organization": "UK Government Digital Service", "url": "https://www.gov.uk/service-manual/service-standard", "version_or_date": "Living guidance accessed 2026-10-06; immutable edition unresolved", "source_type": "public-authority", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Points 1-5, 9-10 and 14 motivate user needs, inclusive channels, privacy, success criteria and reliability questions. UK public-service guidance, not a global compliance rule." }, { "id": "SRC-007", "title": "PROV-O: The PROV Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "W3C Recommendation, 30 April 2013", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Starting-point and expanded terms support attribution, derivation, revision and qualified provenance. Provenance alone does not establish truth, rights or authority." }, { "id": "SRC-008", "title": "RFC 3339: Date and Time on the Internet: Timestamps", "organization": "Internet Engineering Task Force", "url": "https://www.rfc-editor.org/rfc/rfc3339", "version_or_date": "RFC 3339, July 2002, section 5.6; later updates not exhaustively reviewed", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Section 5.6 supports full timestamps with seconds and UTC or numeric offset. Recurring schedules and jurisdictional calendar arithmetic need separate bindings." }, { "id": "SRC-009", "title": "Semantic Sensor Network Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/vocab-ssn/", "version_or_date": "2017 Recommendation edition, selected SOSA observation terms", "source_type": "ontology", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T14:00:26Z", "relevance": "Observation, feature of interest, result, procedure, phenomenonTime and resultTime inform links to separately mastered observations; no observation engine is implemented." } ], "structure": { "bundles": [ { "id": "bundle-identity", "name": "Identity and classification", "description": "Proposed service-definition context for identity and classification.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-001", "SRC-003", "SRC-004", "SRC-006", "SRC-007" ], "layers": [ { "id": "layer-identity", "name": "Stable service identity", "description": "Context for stable service identity within the service definition boundary.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ], "findings": [ { "id": "finding-identity", "name": "Stable service identity", "description": "A persistent service definition is identified independently of its name, catalogue listing, commercial offer and delivery instances. Provider reassignment requires an explicit continuity decision. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ], "questions": [ { "id": "finding-identity-q01", "text": "Which master namespace and identifier distinguish this service from similarly named services?", "kind": "identity", "answer_data": [ "finding-identity-master-identity" ] }, { "id": "finding-identity-q02", "text": "Which versioned service categories apply without equating the service with a product, activity or endpoint?", "kind": "classification", "answer_data": [ "finding-identity-classifications" ] }, { "id": "finding-identity-q03", "text": "Which identity criteria separate a revision of this service from a new service?", "kind": "definition", "answer_data": [ "finding-identity-identity-criteria" ] }, { "id": "finding-identity-q04", "text": "Which evidence supports each legacy alias or external identity assertion?", "kind": "provenance", "answer_data": [ "finding-identity-alias-evidence" ] } ], "data_elements": [ { "id": "finding-identity-master-identity", "name": "Master identity", "description": "Authoritative service identifier with namespace and master reference.", "value_kind": "identifier", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-identity-classifications", "name": "Classifications", "description": "Scheme URI, code, scheme revision and mapping qualification.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-identity-identity-criteria", "name": "Identity criteria", "description": "Adopter-approved continuity criteria; names and URLs alone are insufficient.", "value_kind": "text", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-identity-alias-evidence", "name": "Alias evidence", "description": "Alias, source namespace, asserted relation, evidence and unresolved collision state.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] } ], "artifacts": [ { "id": "artifact-identity", "name": "Identity and alias register", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-outcome", "name": "Expected outcome and consumer scope", "description": "Context for expected outcome and consumer scope within the service definition boundary.", "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ], "findings": [ { "id": "finding-outcome", "name": "Expected outcome and consumer scope", "description": "The definition expresses a provider-accountable outcome and intended consumers. Desired outcomes, output types and exclusions are distinct; a description is not proof that any instance achieved the outcome. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ], "questions": [ { "id": "finding-outcome-q01", "text": "What consumer need and expected outcome define the service?", "kind": "definition", "answer_data": [ "finding-outcome-outcome-statement" ] }, { "id": "finding-outcome-q02", "text": "Which consumer roles are intended, and how do beneficiary and purchaser differ?", "kind": "relationship", "answer_data": [ "finding-outcome-consumer-roles" ] }, { "id": "finding-outcome-q03", "text": "Which input and output types are described without importing individual delivery records?", "kind": "composition", "answer_data": [ "finding-outcome-input-output-types" ] }, { "id": "finding-outcome-q04", "text": "Which outcomes or use conditions are expressly outside the service promise?", "kind": "constraint", "answer_data": [ "finding-outcome-outcome-exclusions" ] } ], "data_elements": [ { "id": "finding-outcome-outcome-statement", "name": "Outcome statement", "description": "Provider-approved purpose and expected effect, with scope limits.", "value_kind": "text", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] }, { "id": "finding-outcome-consumer-roles", "name": "Consumer roles", "description": "Role categories rather than copied personal master records.", "value_kind": "collection", "cardinality": "1..n", "required": true, "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] }, { "id": "finding-outcome-input-output-types", "name": "Input output types", "description": "Type references and semantic descriptions, including information-only or tangible outputs.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] }, { "id": "finding-outcome-outcome-exclusions", "name": "Outcome exclusions", "description": "Exclusions, assumptions and limitation explanations; not an exclusion decision about a person.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] } ], "artifacts": [ { "id": "artifact-outcome", "name": "Outcome scope statement", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-001", "SRC-003", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-accountability", "name": "Accountability and realization", "description": "Proposed service-definition context for accountability and realization.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-001", "SRC-003", "SRC-004", "SRC-005", "SRC-007" ], "layers": [ { "id": "layer-provider", "name": "Accountable provider and participating roles", "description": "Context for accountable provider and participating roles within the service definition boundary.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ], "findings": [ { "id": "finding-provider", "name": "Accountable provider and participating roles", "description": "The local record binds provider and participant roles to external identities. Accountability, realization, brokerage and catalogue maintenance must not be collapsed into a single owner field. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ], "questions": [ { "id": "finding-provider-q01", "text": "Which party is accountable for this definition and its declared consumer outcome?", "kind": "ownership", "answer_data": [ "finding-provider-accountable-party" ] }, { "id": "finding-provider-q02", "text": "Which parties realize or arrange access to the service without replacing its accountable provider?", "kind": "relationship", "answer_data": [ "finding-provider-participant-bindings" ] }, { "id": "finding-provider-q03", "text": "What evidence authorizes a steward to approve or revise this definition?", "kind": "authority", "answer_data": [ "finding-provider-mandate-reference" ] }, { "id": "finding-provider-q04", "text": "When does each provider-role assignment apply to a definition revision?", "kind": "temporal", "answer_data": [ "finding-provider-role-validity" ] } ], "data_elements": [ { "id": "finding-provider-accountable-party", "name": "Accountable party", "description": "Master party reference and role; use an organization or person binding as appropriate.", "value_kind": "reference", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-provider-participant-bindings", "name": "Participant bindings", "description": "Party reference, role and service-specific responsibility scope.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-provider-mandate-reference", "name": "Mandate reference", "description": "Approval or delegation evidence reference; local assignment alone grants no authority.", "value_kind": "reference", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] }, { "id": "finding-provider-role-validity", "name": "Role validity", "description": "Role binding, effective interval and record time, preserving disputed or unknown values.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] } ], "artifacts": [ { "id": "artifact-provider", "name": "Provider responsibility bindings", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-001", "SRC-004", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-realization", "name": "Capability and dependency references", "description": "Context for capability and dependency references within the service definition boundary.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ], "findings": [ { "id": "finding-realization", "name": "Capability and dependency references", "description": "Describe the realization assumptions through external capability, workflow and related-service references. A dependency edge is a qualified assertion, not a command to execute another service. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ], "questions": [ { "id": "finding-realization-q01", "text": "Which capabilities and workflow definitions may realize the declared outcome?", "kind": "composition", "answer_data": [ "finding-realization-realization-references" ] }, { "id": "finding-realization-q02", "text": "Which related services are required, optional, alternative or merely similar?", "kind": "relationship", "answer_data": [ "finding-realization-dependency-bindings" ] }, { "id": "finding-realization-q03", "text": "Which realization limits make this definition unsuitable for a given context?", "kind": "constraint", "answer_data": [ "finding-realization-realization-limits" ] }, { "id": "finding-realization-q04", "text": "How are unresolved targets, dependency cycles and incompatible revisions reported?", "kind": "validation", "answer_data": [ "finding-realization-reference-check-policy" ] } ], "data_elements": [ { "id": "finding-realization-realization-references", "name": "Realization references", "description": "Target master, identifier, pinned revision, relation type and local purpose.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "finding-realization-dependency-bindings", "name": "Dependency bindings", "description": "Related service revision, dependency qualifier and applicability context.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "finding-realization-realization-limits", "name": "Realization limits", "description": "Descriptive capacity or resource assumptions and external policy references; no live capacity allocation.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "finding-realization-reference-check-policy", "name": "Reference check policy", "description": "Adopter validation policy with unresolved, cyclic and incompatible outcomes; no dependency health inference.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-realization", "name": "Realization reference map", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-access-context", "name": "Access and applicability", "description": "Proposed service-definition context for access and applicability.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-001", "SRC-002", "SRC-003", "SRC-004", "SRC-006" ], "layers": [ { "id": "layer-channels", "name": "Channels and supported context", "description": "Context for channels and supported context within the service definition boundary.", "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ], "findings": [ { "id": "finding-channels", "name": "Channels and supported context", "description": "Describe routes to the service, supported areas, languages and accessibility context. Catalogue visibility, declared hours and actual reachability remain separate facts. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ], "questions": [ { "id": "finding-channels-q01", "text": "Which service areas are supported independently of provider location and user eligibility?", "kind": "spatial", "answer_data": [ "finding-channels-service-area" ] }, { "id": "finding-channels-q02", "text": "Which channel or endpoint references provide a route to this service?", "kind": "access", "answer_data": [ "finding-channels-channel-bindings" ] }, { "id": "finding-channels-q03", "text": "Which language and accessibility provisions or assisted alternatives are declared?", "kind": "requirement", "answer_data": [ "finding-channels-accessibility-context" ] }, { "id": "finding-channels-q04", "text": "Which schedule and validity references qualify the advertised channels?", "kind": "temporal", "answer_data": [ "finding-channels-channel-time-context" ] } ], "data_elements": [ { "id": "finding-channels-service-area", "name": "Service area", "description": "Area identifiers or qualified geometries and exclusions, bound to a definition revision.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ] }, { "id": "finding-channels-channel-bindings", "name": "Channel bindings", "description": "Channel kind, purpose, endpoint or location reference and authoritative contact master.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ] }, { "id": "finding-channels-accessibility-context", "name": "Accessibility context", "description": "Supported languages, assistance references, evidence and explicitly unknown provisions.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ] }, { "id": "finding-channels-channel-time-context", "name": "Channel time context", "description": "External schedule revision, timezone basis, applicability and last reviewed time; no availability guarantee.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ] } ], "artifacts": [ { "id": "artifact-channels", "name": "Channel context sheet", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-001", "SRC-004", "SRC-006" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-terms", "name": "Rule and offering references", "description": "Context for rule and offering references within the service definition boundary.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ], "findings": [ { "id": "finding-terms", "name": "Rule and offering references", "description": "The definition may point to governing conditions and externally mastered offers. Consumer eligibility, transaction terms, entitlement and actual screening decisions retain their own masters. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ], "questions": [ { "id": "finding-terms-q01", "text": "Which rule and evidence-type references describe the conditions for using this service?", "kind": "requirement", "answer_data": [ "finding-terms-condition-references" ] }, { "id": "finding-terms-q02", "text": "Which offer, contract or subscription definitions refer to this service revision?", "kind": "relationship", "answer_data": [ "finding-terms-commercial-references" ] }, { "id": "finding-terms-q03", "text": "Where are exceptions, disputes or requests for human assistance routed?", "kind": "exception", "answer_data": [ "finding-terms-exception-route" ] }, { "id": "finding-terms-q04", "text": "Which source prevails when a catalogue summary conflicts with a governing condition?", "kind": "authority", "answer_data": [ "finding-terms-terms-precedence" ] } ], "data_elements": [ { "id": "finding-terms-condition-references", "name": "Condition references", "description": "Pinned rule and input-evidence-type references with local applicability only.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "finding-terms-commercial-references", "name": "Commercial references", "description": "External identifiers, revisions and relation purpose; no inline billing or entitlement lifecycle.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "finding-terms-exception-route", "name": "Exception route", "description": "Governed case or procedure route, with an unresolved marker where no route is known.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "finding-terms-terms-precedence", "name": "Terms precedence", "description": "Adopter-approved precedence and escalation policy; summary text cannot silently override a referenced master.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] } ], "artifacts": [ { "id": "artifact-terms", "name": "Terms and applicability reference register", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-definition-lifecycle", "name": "Definition lifecycle and continuity", "description": "Proposed service-definition context for definition lifecycle and continuity.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ], "layers": [ { "id": "layer-status", "name": "Definition state and effective time", "description": "Context for definition state and effective time within the service definition boundary.", "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ], "findings": [ { "id": "finding-status", "name": "Definition state and effective time", "description": "Definition lifecycle is local and descriptive: an adopter may distinguish draft, approved, deprecated and retired. These states never imply offer availability, runtime health, legal entitlement or case completion. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ], "questions": [ { "id": "finding-status-q01", "text": "Which definition state and controlled state vocabulary apply to this revision?", "kind": "state", "answer_data": [ "finding-status-definition-state" ] }, { "id": "finding-status-q02", "text": "What are the effective interval and recording time of this definition revision?", "kind": "temporal", "answer_data": [ "finding-status-definition-time" ] }, { "id": "finding-status-q03", "text": "Which approval evidence supports the current definition state?", "kind": "authority", "answer_data": [ "finding-status-state-authority" ] }, { "id": "finding-status-q04", "text": "How is a withdrawn approval or conflicting effective interval made visible?", "kind": "exception", "answer_data": [ "finding-status-state-conflict-policy" ] } ], "data_elements": [ { "id": "finding-status-definition-state", "name": "Definition state", "description": "Profile-defined state code and vocabulary revision; no universal state machine is claimed.", "value_kind": "code", "cardinality": "1", "required": true, "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-status-definition-time", "name": "Definition time", "description": "Effective start/end when known, record timestamp and precision or uncertainty qualifiers.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-status-state-authority", "name": "State authority", "description": "Decision or approval reference; a draft may have no approval and cannot be presented as approved.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-status-state-conflict-policy", "name": "State conflict policy", "description": "Conflict marker, precedence evidence and escalation; no arbitrary latest-write-wins resolution.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ] } ], "artifacts": [ { "id": "artifact-status", "name": "Definition state record", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-004", "SRC-005", "SRC-007", "SRC-008" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-revision", "name": "Revision and retirement continuity", "description": "Context for revision and retirement continuity within the service definition boundary.", "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ], "findings": [ { "id": "finding-revision", "name": "Revision and retirement continuity", "description": "Service revisions preserve a traceable meaning and references. Local retirement withdraws a definition from new local use under policy; it cannot terminate external obligations or erase independently mastered evidence. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ], "questions": [ { "id": "finding-revision-q01", "text": "Which changes require a new immutable revision or a distinct service identity?", "kind": "lifecycle", "answer_data": [ "finding-revision-revision-policy" ] }, { "id": "finding-revision-q02", "text": "Which predecessor or successor service is linked without asserting equivalence?", "kind": "relationship", "answer_data": [ "finding-revision-succession-links" ] }, { "id": "finding-revision-q03", "text": "What impact references and accountable sign-off are needed before retiring the definition?", "kind": "process", "answer_data": [ "finding-revision-retirement-impact" ] }, { "id": "finding-revision-q04", "text": "Which policy governs local history, payload disposal and minimal tombstones after retirement?", "kind": "retention", "answer_data": [ "finding-revision-record-disposition" ] } ], "data_elements": [ { "id": "finding-revision-revision-policy", "name": "Revision policy", "description": "Compatibility rules for outcome, audience, provider and binding changes, with approval reference.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-revision-succession-links", "name": "Succession links", "description": "Typed supersedes, derived-from or replacement links with revision pins and reasons.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-revision-retirement-impact", "name": "Retirement impact", "description": "External consumer, offer and case master references, unresolved impacts and approval evidence; no external transition execution.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] }, { "id": "finding-revision-record-disposition", "name": "Record disposition", "description": "Adopting retention and access policy reference including holds and disposal authority; no blanket perpetual retention.", "value_kind": "reference", "cardinality": "1", "required": true, "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] } ], "artifacts": [ { "id": "artifact-revision", "name": "Revision continuity note", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-assurance", "name": "Quality and evidence bindings", "description": "Proposed service-definition context for quality and evidence bindings.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007", "SRC-009" ], "layers": [ { "id": "layer-quality", "name": "Service quality objective bindings", "description": "Context for service quality objective bindings within the service definition boundary.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ], "findings": [ { "id": "finding-quality", "name": "Service quality objective bindings", "description": "Bind the service revision and consumer context to external quality objectives. Estimates, aspirational targets and contractual commitments need explicit qualification; target evaluation and remedies stay external. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ], "questions": [ { "id": "finding-quality-q01", "text": "Which quality dimensions matter to the intended consumers of this service?", "kind": "quality", "answer_data": [ "finding-quality-quality-concerns" ] }, { "id": "finding-quality-q02", "text": "Which external objective or commitment revisions apply to which service scope?", "kind": "relationship", "answer_data": [ "finding-quality-objective-bindings" ] }, { "id": "finding-quality-q03", "text": "Is each advertised level an estimate, aspiration or authorized commitment?", "kind": "classification", "answer_data": [ "finding-quality-claim-qualification" ] }, { "id": "finding-quality-q04", "text": "Which external evaluation and contract references own breach findings and remedies?", "kind": "constraint", "answer_data": [ "finding-quality-assurance-owners" ] } ], "data_elements": [ { "id": "finding-quality-quality-concerns", "name": "Quality concerns", "description": "Named quality concerns with user-need evidence, distinct from measured values.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] }, { "id": "finding-quality-objective-bindings", "name": "Objective bindings", "description": "SLO or requirement master, revision and applicability scope; no local target calculation.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] }, { "id": "finding-quality-claim-qualification", "name": "Claim qualification", "description": "Qualified claim type and source authority; unknown is distinct from guaranteed.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] }, { "id": "finding-quality-assurance-owners", "name": "Assurance owners", "description": "Evaluator and contract master references; linking a result neither recomputes a breach nor grants compensation.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "artifact-quality", "name": "Quality binding register", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-003", "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-recognition", "name": "Recognition and observation context", "description": "Context for recognition and observation context within the service definition boundary.", "source_refs": [ "SRC-007", "SRC-009" ], "findings": [ { "id": "finding-recognition", "name": "Recognition and observation context", "description": "Recognition uses identity and attributed evidence, not names or marketing alone. Service-level assertions can cite observations while keeping their subject, method, result and time externally mastered. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-007", "SRC-009" ], "questions": [ { "id": "finding-recognition-q01", "text": "Which evidence distinguishes the described service from a similarly named offering or endpoint?", "kind": "evidence", "answer_data": [ "finding-recognition-recognition-evidence" ] }, { "id": "finding-recognition-q02", "text": "Which observation references identify the subject, property, method and relevant time of a quality claim?", "kind": "measurement", "answer_data": [ "finding-recognition-observation-bindings" ] }, { "id": "finding-recognition-q03", "text": "Who asserted each service-specific evidence link and when was it reviewed?", "kind": "provenance", "answer_data": [ "finding-recognition-binding-provenance" ] }, { "id": "finding-recognition-q04", "text": "How are stale, missing or contradictory observations shown without becoming a pass or failure?", "kind": "exception", "answer_data": [ "finding-recognition-evidence-limits" ] } ], "data_elements": [ { "id": "finding-recognition-recognition-evidence", "name": "Recognition evidence", "description": "Evidence master reference, claim addressed, revision and source locator.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-007", "SRC-009" ] }, { "id": "finding-recognition-observation-bindings", "name": "Observation bindings", "description": "Observation identifier and revision with claim applicability; values, units and uncertainty stay in the observation master.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-007", "SRC-009" ] }, { "id": "finding-recognition-binding-provenance", "name": "Binding provenance", "description": "Responsible role reference, assertion time, retrieval time and provenance locator.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-007", "SRC-009" ] }, { "id": "finding-recognition-evidence-limits", "name": "Evidence limits", "description": "Explicit missing, stale, disputed and unverified states for local claims; no automatic performance conclusion.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-007", "SRC-009" ] } ], "artifacts": [ { "id": "artifact-recognition", "name": "Evidence binding index", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-007", "SRC-009" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-governed-description", "name": "Governed description and interoperability", "description": "Proposed service-definition context for governed description and interoperability.", "rationale": "Keeps this concern answerable while retaining referenced records in their authoritative masters.", "source_refs": [ "SRC-001", "SRC-004", "SRC-005", "SRC-006", "SRC-007" ], "layers": [ { "id": "layer-mapping", "name": "Profile mappings and semantic loss", "description": "Context for profile mappings and semantic loss within the service definition boundary.", "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ], "findings": [ { "id": "finding-mapping", "name": "Profile mappings and semantic loss", "description": "Mappings are explicit projections. Generic service, public-service and data-service vocabularies cover different populations; a mapping records unsupported fields and must not assert conformance by resemblance. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ], "questions": [ { "id": "finding-mapping-q01", "text": "Which versioned external vocabulary and target profile are selected for this projection?", "kind": "interoperability", "answer_data": [ "finding-mapping-mapping-profile" ] }, { "id": "finding-mapping-q02", "text": "What evidence justifies using a public-service or data-service specialization here?", "kind": "classification", "answer_data": [ "finding-mapping-specialization-basis" ] }, { "id": "finding-mapping-q03", "text": "Which fields, cardinalities or meanings are lost or transformed in the mapping?", "kind": "validation", "answer_data": [ "finding-mapping-mapping-loss" ] }, { "id": "finding-mapping-q04", "text": "How does a projected catalogue entry retain the master service identity and revision?", "kind": "identity", "answer_data": [ "finding-mapping-projection-identity" ] } ], "data_elements": [ { "id": "finding-mapping-mapping-profile", "name": "Mapping profile", "description": "Vocabulary URI, version, mapping revision and intended population.", "value_kind": "reference", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] }, { "id": "finding-mapping-specialization-basis", "name": "Specialization basis", "description": "Profile-specific classification rationale and authority; no automatic subtype conversion.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] }, { "id": "finding-mapping-mapping-loss", "name": "Mapping loss", "description": "Source/target field paths, conversion qualification and unresolved incompatibilities.", "value_kind": "collection", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] }, { "id": "finding-mapping-projection-identity", "name": "Projection identity", "description": "Master reference, revision, projection identifier and mapping provenance, independent of display URL.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-mapping", "name": "Mapping qualification sheet", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-001", "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-disclosure", "name": "Controlled description views", "description": "Context for controlled description views within the service definition boundary.", "source_refs": [ "SRC-006", "SRC-007" ], "findings": [ { "id": "finding-disclosure", "name": "Controlled description views", "description": "Public and restricted descriptions are purpose-bound projections of the definition. A service catalogue must not silently expose consumer data, internal dependencies, credentials or restricted evidence. This is a proposed local design derived from the cited concerns, not a claim that a source prescribes this exact structure.", "source_refs": [ "SRC-006", "SRC-007" ], "questions": [ { "id": "finding-disclosure-q01", "text": "Which definition fields or linked metadata are sensitive even when the service name is public?", "kind": "privacy", "answer_data": [ "finding-disclosure-sensitivity-map" ] }, { "id": "finding-disclosure-q02", "text": "Which recipient, purpose and authority permit each description view?", "kind": "access", "answer_data": [ "finding-disclosure-view-policy" ] }, { "id": "finding-disclosure-q03", "text": "Which evidence links require redaction or omission before local export?", "kind": "security", "answer_data": [ "finding-disclosure-projection-filter" ] }, { "id": "finding-disclosure-q04", "text": "What review evidence accompanies a published or locally exported description?", "kind": "validation", "answer_data": [ "finding-disclosure-view-review" ] } ], "data_elements": [ { "id": "finding-disclosure-sensitivity-map", "name": "Sensitivity map", "description": "Field and reference sensitivity, including existence leakage and free-text risk.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-006", "SRC-007" ] }, { "id": "finding-disclosure-view-policy", "name": "View policy", "description": "Adopting access policy reference with bundle, layer, finding and artifact scope.", "value_kind": "reference", "cardinality": "1", "required": true, "source_refs": [ "SRC-006", "SRC-007" ] }, { "id": "finding-disclosure-projection-filter", "name": "Projection filter", "description": "Allowlisted fields and unresolved-reference treatment; never copy bearer secrets or privileged endpoint data.", "value_kind": "object", "cardinality": "1", "required": true, "source_refs": [ "SRC-006", "SRC-007" ] }, { "id": "finding-disclosure-view-review", "name": "View review", "description": "Reviewer role, service revision, policy revision, scope and timestamp; export is not service activation.", "value_kind": "object", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-006", "SRC-007" ] } ], "artifacts": [ { "id": "artifact-disclosure", "name": "Description disclosure profile", "description": "A versioned local projection of this finding and its qualified references; foreign master records are not duplicated.", "media_or_form": [ "Structured record", "Human-readable view" ], "serial": true, "identity_strategy": "Use the authoritative master-system artifact ID, then a governed IRI, then a Dimension UUID or ULID. Bind the service ID, definition revision and artifact revision; a timestamp or filename is not identity.", "source_refs": [ "SRC-006", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "function-register-definition", "name": "Register a local draft definition", "description": "Propose a stable definition record after identity and scope checks. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Master namespace and service ID", "Outcome and consumer scope", "Accountable party reference", "Authority evidence" ], "outputs": [ "Local draft revision and unresolved-reference report", "Refusal with missing identity or authority reason" ], "preconditions": [ "No ambiguous alias collision", "Accountable steward authorized for this namespace" ], "effects": [ "Creates only a local draft; it does not list an offer or make a service available" ], "source_refs": [ "SRC-001", "SRC-003", "SRC-007" ] }, { "id": "function-revise-definition", "name": "Revise a local definition", "description": "Apply an authorized change while preserving revision continuity. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Expected base revision", "Proposed field changes", "Rationale and approval reference" ], "outputs": [ "New local revision with diff and lineage", "Refusal on stale base or unresolved material conflict" ], "preconditions": [ "Expected revision matches", "Outcome or provider changes reviewed for identity continuity" ], "effects": [ "Preserves historical meaning subject to retention policy; changes no foreign master" ], "source_refs": [ "SRC-005", "SRC-007" ] }, { "id": "function-bind-reference", "name": "Bind a qualified external reference", "description": "Attach a verified or explicitly unresolved link with local purpose and version. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Service revision", "Target master ID and revision", "Typed relationship and evidence" ], "outputs": [ "Versioned local binding", "Refusal or unresolved-reference status" ], "preconditions": [ "Read and write authority scoped to the service", "Target type and ownership boundary checked" ], "effects": [ "Records a link only; does not execute a workflow, open a case, evaluate a level or create an observation" ], "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] }, { "id": "function-validate-description", "name": "Validate definition coherence", "description": "Perform proposed local completeness and boundary checks, not operational certification. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Definition revision", "Selected profile and relation rules" ], "outputs": [ "Local validation report with gaps, stale links and contradictions", "Indeterminate result where a referenced master cannot be inspected" ], "preconditions": [ "Read authorization", "Pinned validation profile" ], "effects": [ "Reports structure, reference and identity issues only; cannot conclude eligibility, compliance or service health" ], "source_refs": [ "SRC-003", "SRC-005", "SRC-007" ] }, { "id": "function-prepare-view", "name": "Prepare a controlled local description view", "description": "Render an authorized catalogue projection with provenance and semantic loss notes. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Service revision", "Recipient and purpose", "Access and mapping profile revisions" ], "outputs": [ "Local view plus redaction and mapping-loss report", "Refusal when export authority is absent" ], "preconditions": [ "Authorized recipient and purpose", "Sensitive fields and reference-existence leakage reviewed" ], "effects": [ "Produces a local artifact only; remote publication and service activation require separate authority" ], "source_refs": [ "SRC-001", "SRC-005", "SRC-006", "SRC-007" ] }, { "id": "function-retire-definition", "name": "Retire a local definition", "description": "Record an authorized local retirement and successor reference. Proposed operation only; no runtime implementation is claimed.", "inputs": [ "Current revision", "Retirement authority", "Impact reference review", "Retention policy" ], "outputs": [ "Retired local revision or blocked impact report", "Tombstone plan if lawful disposal is separately authorized" ], "preconditions": [ "No unresolved material impact accepted without authorized disposition", "Concurrency and retention holds checked" ], "effects": [ "Marks local use policy; does not terminate contracts, subscriptions, requests or service delivery" ], "source_refs": [ "SRC-005", "SRC-007", "SRC-008" ] } ], "composition": [ { "target": "WM-ORG-001", "relation": "REFERENCE", "purpose": "Bind accountable and realization-provider organization identities. Organization creation, ownership and lifecycle remain external.", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] }, { "target": "WM-ACT-003", "relation": "REFERENCE", "purpose": "Pin a realization workflow definition; do not run workflows or own execution state.", "required": false, "source_refs": [ "SRC-003" ] }, { "target": "WM-ECO-022", "relation": "REFERENCE", "purpose": "Link subscriptions that cite the service. Entitlement, consumption periods, renewal and billing remain external.", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "target": "WM-ACT-021", "relation": "REFERENCE", "purpose": "Link request or case masters by service revision. Intake, resolution, acceptance and closure remain case-owned.", "required": false, "source_refs": [ "SRC-003", "SRC-006" ] }, { "target": "WM-SFT-016", "relation": "REFERENCE", "purpose": "Bind service scope to SLO policy and evaluation references. Target evaluation, error budgets and breach lifecycle remain SLO-owned.", "required": false, "source_refs": [ "SRC-003", "SRC-006" ] }, { "target": "WM-MAT-008", "relation": "REFERENCE", "purpose": "Reference quality observations. Observation identity, value, unit, method, uncertainty and time remain observation-owned.", "required": false, "source_refs": [ "SRC-009", "SRC-007" ] }, { "target": "WM-PER-001", "relation": "REFERENCE", "purpose": "Optional individual provider identity; do not require every provider to be an organization or copy personal records.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "WM-ACT-001", "relation": "REFERENCE", "purpose": "Reference required capabilities without claiming they are exercised or currently available.", "required": false, "source_refs": [ "SRC-003" ] }, { "target": "WM-ECO-006", "relation": "REFERENCE", "purpose": "Reference applicable agreements; contractual obligations, enforceability, credits and remedies remain contract-owned.", "required": false, "source_refs": [ "SRC-002", "SRC-003" ] }, { "target": "WM-SFT-003", "relation": "REFERENCE", "purpose": "Reference a technical interaction contract only when the service has such an interface; business outcome identity is distinct.", "required": false, "source_refs": [ "SRC-003", "SRC-005" ] }, { "target": "WM-SFT-018", "relation": "REFERENCE", "purpose": "Reference digital endpoints where applicable; locator assignment, exposure and reachability lifecycle remain endpoint-owned.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "WM-POL-018", "relation": "ALIGN", "purpose": "Public-service specialization requires its own legal and institutional profile; generic service identity does not confer public authority.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "Adopting offering master", "relation": "REFERENCE", "purpose": "Pin an external offer identifier and revision. Pricing, sale availability, transaction terms and acceptance are not service-definition lifecycle.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "https://schema.org/Service", "relation": "ALIGN", "purpose": "Conceptual service-description projection; no schema conformance claim or required commercial offer.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "https://semiceu.github.io/CPSV-AP/releases/3.2.0/", "relation": "ALIGN", "purpose": "Public-service profile mapping only, with explicit cardinality and authority review.", "required": false, "source_refs": [ "SRC-004" ] }, { "target": "https://www.w3.org/TR/vocab-dcat-3/", "relation": "ALIGN", "purpose": "Data-service projection only where the service actually provides data access or processing; not a universal service type.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "https://www.w3.org/TR/prov-o/", "relation": "ALIGN", "purpose": "Provenance alignment for description and reference revisions, not an authority or truth certificate.", "required": false, "source_refs": [ "SRC-007" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Identify the accountable provider role, definition steward and authoritative service namespace without embedding a company name as model owner.", "Declare adopted profile, identity continuity, approval, access, retention and dispute policies.", "Provide master bindings for parties, offers, workflows, cases, subscriptions, objectives and observations as applicable.", "Specify field cardinalities and nested schemas before operational instance use; required fields in this research are candidate design requirements." ], "namespace_guidance": "Scope service IDs to the authoritative master. Keep definition revision, provider ID, offer ID, endpoint URL and artifact ID separate. Namespace ownership is a generic accountable role.", "registry_links": [ "vr.wm-act-004", "WM-ORG-001", "WM-ACT-003", "WM-ECO-022", "WM-ACT-021", "WM-SFT-016", "WM-MAT-008" ] }, "canon_and_patch": { "canonicalization_rules": [ "Preserve master identifiers, languages, source meaning, explicit unknowns and effective intervals. Do not infer equality from matching labels or endpoints.", "Separate outcome assertions from evidence and from achieved delivery results; external bindings include revision and status." ], "patch_rules": [ "Require expected revision, authorized steward, reason and provenance before local changes. Preserve contested assertions rather than overwriting them silently.", "Provider transfer, audience narrowing or outcome change requires an explicit identity and compatibility review." ], "compatibility_rules": [ "Pin target schema and vocabulary revisions; unresolved wildcard legacy imports remain migration gaps.", "No automatic equivalence among Service, Offer, PublicService and DataService. Preserve mapping losses and external lifecycle ownership." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier in its namespace", "Governed global identifier or IRI", "Dimension-assigned UUID or ULID" ], "timestamp_rule": "Use RFC 3339 timestamps with seconds and an explicit offset or Z. Distinguish effective time, assertion/event time and observation or ingestion time. Preserve unknown precision; date-only facts stay dates. Recurring schedules require separate timezone and calendar rules.", "serial_naming_rule": "Use stable service ID, finding kind and artifact revision; timestamps may label serial views but never establish identity.", "integrity_rule": "Record digest, media type, source locator, revision and responsible role for retained payloads. A digest detects byte changes but proves neither authenticity nor truth. Retention and lawful deletion policy govern payload preservation." }, "policies": [ "This package is a noncanonical reviewable draft. Codex is the sole research provider; Claude and Grok were skipped under the owner waiver. A local no-tools self-audit is not independent external review.", "Do not copy consumer personal data, credentials or restricted operational details into a generic service catalogue. Apply purpose and recipient controls to reference metadata too.", "No catalogue entry, provider binding, capability description or quality link grants authority, assures availability or establishes a completed outcome.", "Dangerous or regulated service domains remain at policy and reference level; specialist adoption review must precede operational use.", "Source and version verification, executable profiles and independent review remain open holds." ], "crud": { "read": [ "Resolve the permitted definition revision and purpose-bound view; show unresolved, stale and disputed references." ], "create": [ "Require a namespace, stable identity, outcome scope, accountable party and local authority; initialize as a draft without asserting foreign service activation." ], "update": [ "Check authority and expected revision, record provenance, and preserve references to the meaning in force at the time of external transactions." ], "delete": [ "Retire local definitions before considering payload deletion. Apply the adopting Dimension retention/disposition policy and legal holds; the authorized records custodian owns execution.", "Keep only lawful minimal tombstones and lineage after scoped disposal. History is not a mandate to retain personal data forever. Never cascade deletion to referenced masters or interpret it as cancellation of obligations." ] }, "roles": [ { "name": "Accountable provider", "responsibilities": [ "Approves the declared outcome and responsibility scope." ] }, { "name": "Definition steward", "responsibilities": [ "Maintains identity, revisions and qualified bindings under delegated authority." ] }, { "name": "Profile reviewer", "responsibilities": [ "Reviews applicability, mapping loss and required instance constraints." ] }, { "name": "Evidence reviewer", "responsibilities": [ "Checks reference provenance and limits without silently recomputing external results." ] }, { "name": "Access and records custodian", "responsibilities": [ "Authorizes views and implements adopted retention and disposal decisions." ] }, { "name": "Consumer representative", "responsibilities": [ "Challenges unclear scope and inaccessible routes without access to unrelated personal records." ] } ], "access": { "default_rule": "Deny mutation and sensitive disclosure unless the adopting policy authorizes the actor, purpose and revision. A public name does not make all related data public.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "A public catalogue may expose a reviewed allowlist while internal dependency and evidence links remain restricted.", "Urgent access exceptions require scoped authority and expiry; they do not authorize unsafe service execution." ], "audit_requirements": [ "Record actor role, purpose, policy revision, object revision, change or disclosure scope and result using the adopting audit master.", "Keep audit references here; the service definition does not implement audit-trail retention or enforcement semantics." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL" ], "read_order": [ "AGENTS.md", "spec.yaml and visible publication holds", "Adopting Dimension policies and pinned profile", "Authorized master references and evidence" ] } }, "coverage": { "claim": "Source-grounded proposed Service Definition structure with stable outcome identity and external operational lifecycles. Separate frozen no-tools self-audit completed. Independent-review, source/version, specialist adoption and executable-profile holds remain; this is a noncanonical reviewable draft.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Persistent definition, namespaced identity and qualified aliases." }, { "dimension": "lifecycle", "status": "covered", "notes": "Definition-only states, revision and retirement; no foreign transitions." }, { "dimension": "relationships", "status": "covered", "notes": "All six outgoing ledger boundaries and additional proposed bindings are explicit." }, { "dimension": "temporal", "status": "covered", "notes": "Effective, assertion and observation times stay distinct; recurring schedules are referenced." }, { "dimension": "provenance", "status": "covered", "notes": "Attribution and versioned evidence links do not certify truth." }, { "dimension": "ownership", "status": "covered", "notes": "Accountability and stewardship roles are separate from provider master ownership." }, { "dimension": "validation", "status": "gap", "notes": "Research schema passes can be checked; executable instance schemas and conformance fixtures remain to be built." }, { "dimension": "access", "status": "covered", "notes": "Purpose-bound views control sensitive fields and reference existence." }, { "dimension": "retention and deletion", "status": "covered", "notes": "Local disposal follows the adopting custodian and holds; foreign records are not deleted." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual mappings only; pinned implementation bindings and loss tests remain incomplete." }, { "dimension": "direct properties", "status": "covered", "notes": "Outcome scope, audiences, classification, context and descriptive state are direct nonphysical properties." }, { "dimension": "physical properties", "status": "not-applicable", "notes": "The definition is abstract; physical output or equipment dimensions belong to linked objects and observations." }, { "dimension": "recognition and observation", "status": "covered", "notes": "Identity-qualified evidence and observation bindings; no observation collection or performance evaluator." }, { "dimension": "capabilities and actions", "status": "covered", "notes": "Realization capabilities are referenced; six proposed local record operations have explicit effects and refusal conditions." }, { "dimension": "regional and sector profiles", "status": "gap", "notes": "Public and data-service examples do not cover every industry, jurisdiction or essential-service obligation." }, { "dimension": "external review", "status": "gap", "notes": "Claude and Grok skipped under waiver; separate local audit cannot replace independent review." }, { "dimension": "source verification", "status": "gap", "notes": "Browser content inspected for nine sources. Direct HTTP checks were not attempted under the owner-reported sandbox block; status, hashes and complete version currency remain unmeasured." } ], "known_omissions": [ "Executable nested schemas, state vocabulary, profile-specific cardinality and reference-resolution fixtures.", "Complete sector coverage, legal applicability, service quality frameworks and specialist accessibility conformance.", "Pinned production mappings, authorized migrations of existing instances and independent external review." ], "conflicts": [], "regional_assumptions": [ "CPSV-AP and UK guidance are bounded public-service examples, not universal obligations.", "OASIS SOA and DCAT provide technical perspectives; offline and internal services do not require digital endpoints or a commercial offer." ], "adversarial_checks": [ "Same label or shared endpoint does not merge two service identities.", "A free internal service can exist without an offer, subscription or request case.", "Several workflows and providers can realize one outcome without transferring accountability.", "A revised or retired definition cannot rewrite a historical contract or close active cases.", "An observed endpoint response, advertisement or linked SLO does not prove consumer outcome success.", "Missing evidence is unknown, not satisfactory performance; evidence retention is policy-bound." ] }, "researchAdjudication": { "providerMode": "single-provider-waiver", "activeProviders": [ "codex" ], "waivedProviders": [ "claude", "grok" ], "providerPolicy": { "contract_version": "1.0.0", "mode": "single-provider-waiver", "effective_at": "2026-09-06T00:00:00Z", "scope": "Canonical single-stream subject-model research after the six-workstream consolidation", "active_providers": [ "codex" ], "waived_providers": [ { "provider": "claude", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "Claude produced no result on prior 1800-second and 900-second attempts and again timed out on bounded 600-second Sonnet and 300-second Haiku passes. The owner prioritized completion over provider availability." }, { "provider": "grok", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "The repository owner authorized completion without Grok when Grok is unavailable, slow or schema-invalid. Grok may still be attempted as a bounded supplemental reviewer, but its failure never blocks a valid Claude plus no-tools result." } ], "review_rule": "Codex may complete source-grounded fallback research after bounded Claude and Grok attempts fail. It requires a separate no-tools adversarial audit and remains reviewable-draft with a visible absence-of-external-review hold.", "supplemental_provider_attempts": [ { "provider": "claude", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." }, { "provider": "grok", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." } ] }, "boundaryDecision": { "entry_kind": "entity", "status": "accepted", "rationale": "The root is one persistent service definition across revisions. The current registry purpose and relationship ledger retain outcome, identity and consumer scope here, while offers, requests, execution, subscriptions, SLO evaluations and observations remain externally mastered. Legacy K4 scope is reconciled rather than inherited wholesale." }, "decisions": [ { "concept": "Definition identity", "disposition": "accepted", "rationale": "A persistent definition can be revised without becoming a request, offer or episode. Names, URLs and shared endpoints cannot establish identity equivalence." }, { "concept": "Registry name and legacy scope", "disposition": "reconciled", "rationale": "Service Definition is the current registry name and governs the slug. Legacy offering and delivery content is traced to external bindings; conformance labels and wildcard imports are not inherited." }, { "concept": "Accountable provider", "disposition": "qualified", "rationale": "Accountability, realization, brokerage and stewardship remain distinct roles. A person or organization binding may supply the required accountable-party reference without forcing one party type on every service." }, { "concept": "Foreign lifecycle ownership", "disposition": "accepted", "rationale": "All six outgoing relation rationales survive in scope, findings, functions and composition. No local operation executes a workflow, renews a subscription, closes a case, evaluates an SLO or creates an observation." }, { "concept": "Offers and request cardinality", "disposition": "legacy invariant rejected", "rationale": "A draft or internal service can lack a commercial offer, subscription or request. The legacy one-request-to-one-delivery relation is not a generic invariant of the definition." }, { "concept": "Channels and applicability", "disposition": "separated", "rationale": "Declared routes, spatial support and schedule references do not prove reachability or eligibility. Conditions are referenced; exceptions route to external case or procedure masters." }, { "concept": "Definition state and external effect", "disposition": "separated", "rationale": "Local definition approval, revision and retirement cannot activate an offer, certify health, cancel a contract or terminate an open case. Effective and recording time remain distinct." }, { "concept": "Intended and measured quality", "disposition": "separated", "rationale": "The result distinguishes outcome scope, estimate, aspiration, commitment and external evidence. Unknown or stale observations are not interpreted as performance success or a breach." }, { "concept": "Physical properties", "disposition": "qualified", "rationale": "The root has nonphysical properties such as scope and context. Tangible outputs remain possible through references; physical measurements belong to their objects and observations." }, { "concept": "Local functions and authority", "disposition": "proposed only", "rationale": "Six functions expose local record effects and preconditions with refusal or indeterminate results. They do not establish runtime implementation, foreign execution or authority by inference." }, { "concept": "Views and record disposal", "disposition": "accepted with adopting policy", "rationale": "Purpose-bound projections restrict sensitive fields and reference existence. Revision continuity is qualified by lawful retention and disposal, without cascading into foreign masters." }, { "concept": "Public and data-service profiles", "disposition": "limited alignment", "rationale": "CPSV-AP and DCAT are bounded specializations. Generic service instances do not inherit public-authority requirements or API assumptions solely through a conceptual mapping." }, { "concept": "Executable conformance", "disposition": "deferred", "rationale": "Research schema validity does not validate real instances. Nested schemas, profile cardinalities, version pins, state vocabularies and reference-resolution fixtures remain incomplete." }, { "concept": "Source verification and independent review", "disposition": "held", "rationale": "Selected browser readings support nine primary sources. Direct HTTP was not attempted under the owner-reported sandbox block. Claude and Grok were skipped; this separate local self-audit cannot be represented as independent review." } ], "publicationHolds": [ "Independent external review is absent. Claude and Grok were skipped with zero attempts under the owner-authorized single-provider waiver; the separate local Codex no-tools self-audit is not a second-provider review.", "Live source and version verification remains incomplete. Nine source documents were accessible through the browser tool for selected-section review, but direct HTTP checks were not attempted under the owner-reported sandbox restriction. Zero HTTP 200 responses were measured; status, response hashes, immutable edition pins, errata and complete currency require coordinator verification.", "Specialist adoption review remains required for sector and jurisdiction rules, accessibility, provider authority, licensing, essential-service continuity, privacy and retention. Public and data-service examples do not establish universal obligations or legal compliance.", "Executable instance schemas, profile cardinalities and state vocabularies, pinned neighbor bindings, tested vocabulary mappings, reference-resolution fixtures and authorized legacy migrations remain incomplete. No runtime, accessibility or standards-conformance certification is claimed.", "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft." ], "deferredResearch": [ "Run the prepared source checker outside the sandbox, then separately verify source versions, errata, claim support and applicability.", "Develop executable profiles and adversarial fixtures for provider transfer, service retirement with active obligations, missing quality evidence and lossy catalogue mappings.", "Restore independent external review and qualified adoption review before any canonical or publishable-draft promotion." ] }, "statistics": { "sources": 9, "bundles": 6, "layers": 12, "findings": 12, "questions": 48, "artifacts": 12, "functions": 6 } }