# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-06T22:49:39Z", "synthesisSha256": "09dd3824159b34f432e01548b96da9367fe24c8669978927f6dbf7025ba5c2df", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-PLC-005", "registryId": "vr.wm-plc-005", "name": "Settlement / Urban Form", "version": "1.0.0", "previousVersions": [ { "version": "0.2.0-legacy", "url": "https://ver.cy/models/world-u4-settlement-and-urban-form/" } ], "entryKind": "entity", "family": "World Models", "category": "Physical world and living systems", "industry": [ "Cross-industry" ], "domain": [ "PHY.PLC.SET" ], "tags": [ "settlement", "urban", "form", "phy.plc.set" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-plc-005-settlement-urban-form/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-plc-005", "model": { "registry_id": "vr.wm-plc-005", "model_id": "WM-PLC-005", "name": "Settlement / Urban Form", "entry_kind": "entity", "purpose": "Describe a settlement and its time-qualified spatial anatomy and urban form without conflating it with an administrative unit or a statistical class.", "scope_statement": "One persistently identified settlement, including a town, village or city and its referenced subdivisions, extent assertions and morphology observations. Urban form is a measured or interpreted view of this entity, not a second root. This proposed research structure supports rural, dispersed and changing forms; it does not require an official city designation or a contiguous built-up polygon.", "in_scope": [ "Qualified settlement identity, names, continuity, steward and source evidence", "Alternative delineations, districts, blocks, constituent references and spatial relations", "Population and built-form measurements, classification assertions, time series, uncertainty and controlled projections" ], "out_of_scope": [ "Administrative authority, cadastral ownership, individual building or network asset masters", "Population microdata, household or resident identity records", "Statutory planning decisions, official boundary changes, funding eligibility determinations and operational infrastructure control" ], "boundary_notes": [ { "neighbor": "WM-PLC-004 Administrative Area", "distinction": "An administrative area and a settlement may overlap or span each other. The candidate CONTAINS edge is only a dated spatial assertion, not identity or universal single-parent containment.", "source_refs": [ "SRC-001", "SRC-003" ] }, { "neighbor": "WM-BLT-008 Site / Campus", "distinction": "A managed site is separately mastered. Candidate containment requires an extent and time test; a site need not be wholly inside a settlement and settlements need not contain a campus.", "source_refs": [ "SRC-002", "SRC-005" ] }, { "neighbor": "WM-BLT-001 Building / Structure; WM-BLT-003 Infrastructure Network; WM-PLC-002 Land Parcel", "distinction": "Reference external assets and parcels. Analytic blocks do not universally tile parcels or imply property ownership, and network service coverage differs from geometric intersection.", "source_refs": [ "SRC-002", "SRC-005" ] }, { "neighbor": "WM-XCT-010 Location Referencing / Address; WM-ACT-016 Observed Phenomenon", "distinction": "Gazetteer or address references identify locations; observations identify measurements. Neither a name string nor an observation replaces the settlement identity.", "source_refs": [ "SRC-004", "SRC-005" ] } ] }, "sources": [ { "id": "SRC-001", "title": "Applying the Degree of Urbanisation", "organization": "OECD", "url": "https://www.oecd.org/en/publications/applying-the-degree-of-urbanisation_4bc1c502-en.html", "version_or_date": "2021-04-28; DOI 10.1787/4bc1c502-en; publication abstract reviewed", "source_type": "public-authority", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Statistical classification complements national definitions; a class is not settlement identity." }, { "id": "SRC-002", "title": "OGC CityGML Part 1: Conceptual Model Standard", "organization": "Open Geospatial Consortium", "url": "https://docs.ogc.org/is/20-010/20-010.html", "version_or_date": "3.0, OGC 20-010, 2021; selected official indexed sections only", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Selected overview supports semantic city objects, geometry, topology and levels of detail; full conformance text retrieval remains unresolved." }, { "id": "SRC-003", "title": "SDG indicator 11.3.1 metadata", "organization": "United Nations Human Settlements Programme", "url": "https://unstats.un.org/sdgs/metadata/files/Metadata-11-03-01.pdf", "version_or_date": "Metadata updated 2025-04-23; selected definitions and limitations reviewed", "source_type": "public-authority", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Urban analysis area, land and population change, and interpretation limits for zero or negative growth." }, { "id": "SRC-004", "title": "GHSL Data Package 2023", "organization": "European Commission Joint Research Centre", "url": "https://publications.jrc.ec.europa.eu/repository/bitstream/JRC133256/JRC133256_01.pdf", "version_or_date": "2023, JRC133256, DOI 10.2760/098587; selected sections 1.3 and 2.1", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Release and epoch distinction, measured versus interpolated or projected built-up surface, spatial resolution and source limitations." }, { "id": "SRC-005", "title": "PROV-O: The PROV Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "W3C Recommendation 2013-04-30; starting-point terms and derivation reviewed", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Entities, activities, attribution and qualified derivation support proposed evidence records, not factual certification." }, { "id": "SRC-006", "title": "Fundamental Principles of Official Statistics: Principle 6", "organization": "United Nations Statistics Division", "url": "https://unstats.un.org/unsd/goodprac/bpaboutpr.asp?RecId=6", "version_or_date": "Undated explanation page; reviewed 2026-10-07; current legal applicability not established", "source_type": "public-authority", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:44Z", "relevance": "Confidentiality and purpose restrictions support restricted statistical inputs and disclosure review for outputs." } ], "structure": { "bundles": [ { "id": "bundle-identity", "name": "Identity and classification", "description": "Persistent place identity and qualified scheme assignments.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-001", "SRC-003", "SRC-005" ], "layers": [ { "id": "layer-identity", "name": "Identity and names", "description": "Settlement identity is stable across names and representations. Unresolved local places may have provisional IDs; matching names or shapes alone never proves equivalence.", "source_refs": [ "SRC-001", "SRC-005" ], "findings": [ { "id": "finding-identity", "name": "Identity and names", "description": "Settlement identity is stable across names and representations. Unresolved local places may have provisional IDs; matching names or shapes alone never proves equivalence.", "source_refs": [ "SRC-001", "SRC-005" ], "questions": [ { "id": "q-identity-master-identity", "text": "Which master namespace and identifier distinguish this settlement from similarly named places?", "kind": "identity", "answer_data": [ "data-identity-master-identity" ] }, { "id": "q-identity-subject-definition", "text": "What inhabited-place concept and inclusion rule define the subject of this record?", "kind": "definition", "answer_data": [ "data-identity-subject-definition" ] }, { "id": "q-identity-name-assertions", "text": "Which sources support each official, local, historical or alternative name?", "kind": "provenance", "answer_data": [ "data-identity-name-assertions" ] }, { "id": "q-identity-stewardship", "text": "Who is accountable for this record and who can resolve disputed identity assertions?", "kind": "ownership", "answer_data": [ "data-identity-stewardship" ] } ], "data_elements": [ { "id": "data-identity-master-identity", "name": "Master identity", "description": "Candidate object fields: namespace; identifier; issuing steward; reconciliation state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-identity-subject-definition", "name": "Subject definition", "description": "Candidate object fields: place concept; inclusion rule; evidence; unknown state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-identity-name-assertions", "name": "Name assertions", "description": "Candidate object fields: name; language; name type; source; applicable period. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-identity-stewardship", "name": "Stewardship", "description": "Candidate object fields: custodian role; mandate reference; dispute route; review date. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-identity", "name": "Identity and names register", "description": "Versioned local evidence index for identity and names. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-001", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-classification", "name": "Classification assertions", "description": "Settlement type is an assertion under a named scheme and version. National legal designation, local terminology and statistical urban-rural classes can coexist without forced equivalence.", "source_refs": [ "SRC-001", "SRC-003" ], "findings": [ { "id": "finding-classification", "name": "Classification assertions", "description": "Settlement type is an assertion under a named scheme and version. National legal designation, local terminology and statistical urban-rural classes can coexist without forced equivalence.", "source_refs": [ "SRC-001", "SRC-003" ], "questions": [ { "id": "q-classification-class-assignment", "text": "Which scheme, version, territorial unit and class does each assignment use?", "kind": "classification", "answer_data": [ "data-classification-class-assignment" ] }, { "id": "q-classification-assignment-status", "text": "Is the assignment official, analytically derived or provisional, and who supports that status?", "kind": "authority", "answer_data": [ "data-classification-assignment-status" ] }, { "id": "q-classification-class-time", "text": "For which reference date and validity interval does the classification apply?", "kind": "temporal", "answer_data": [ "data-classification-class-time" ] }, { "id": "q-classification-class-conflicts", "text": "How are conflicting or unmapped national and statistical classes preserved?", "kind": "exception", "answer_data": [ "data-classification-class-conflicts" ] } ], "data_elements": [ { "id": "data-classification-class-assignment", "name": "Class assignment", "description": "Candidate object fields: scheme URI; version; unit reference; class code. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "data-classification-assignment-status", "name": "Assignment status", "description": "Candidate object fields: status; assigning actor; authority evidence; confidence. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "data-classification-class-time", "name": "Class time", "description": "Candidate object fields: reference date; valid interval; recorded time. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "id": "data-classification-class-conflicts", "name": "Class conflicts", "description": "Candidate object fields: parallel assignments; disputed mapping; loss note; review state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] } ], "artifacts": [ { "id": "artifact-classification", "name": "Classification assertions register", "description": "Versioned local evidence index for classification assertions. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-001", "SRC-003" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-anatomy", "name": "Spatial anatomy", "description": "Alternative extents and optional subdivision schemes.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004", "SRC-005" ], "layers": [ { "id": "layer-extent", "name": "Extent representations", "description": "Preserve alternative observed, estimated, statistical, administrative-reference and planned geometries with explicit purpose. No single footprint is universally the settlement boundary.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ], "findings": [ { "id": "finding-extent", "name": "Extent representations", "description": "Preserve alternative observed, estimated, statistical, administrative-reference and planned geometries with explicit purpose. No single footprint is universally the settlement boundary.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ], "questions": [ { "id": "q-extent-extent-geometry", "text": "Which extent, coordinate reference system, axis order and geometric resolution are being used?", "kind": "spatial", "answer_data": [ "data-extent-extent-geometry" ] }, { "id": "q-extent-delineation", "text": "What delineation rule and source support this extent rather than an administrative or planned boundary?", "kind": "evidence", "answer_data": [ "data-extent-delineation" ] }, { "id": "q-extent-extent-quality", "text": "Which gaps, positional uncertainty, disconnected parts or disputed limits affect the extent?", "kind": "quality", "answer_data": [ "data-extent-extent-quality" ] }, { "id": "q-extent-extent-time", "text": "Which observation epoch, valid interval and publication revision qualify the geometry?", "kind": "temporal", "answer_data": [ "data-extent-extent-time" ] } ], "data_elements": [ { "id": "data-extent-extent-geometry", "name": "Extent geometry", "description": "Candidate object fields: geometry reference; CRS; axis order; resolution; dimensionality. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "data-extent-delineation", "name": "Delineation", "description": "Candidate object fields: extent kind; method; input references; purpose; authority status. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "data-extent-extent-quality", "name": "Extent quality", "description": "Candidate object fields: uncertainty; no-data mask; topology report; disconnected parts; disputes. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] }, { "id": "data-extent-extent-time", "name": "Extent time", "description": "Candidate object fields: observation epoch; valid interval; release; revision; recorded time. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] } ], "artifacts": [ { "id": "artifact-extent", "name": "Extent representations register", "description": "Versioned local evidence index for extent representations. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-subdivision", "name": "District and block schemes", "description": "Administrative districts, analytic neighborhoods and blocks are optional scheme-specific units. Completeness, non-overlap and parcel alignment must be tested rather than assumed.", "source_refs": [ "SRC-002", "SRC-005" ], "findings": [ { "id": "finding-subdivision", "name": "District and block schemes", "description": "Administrative districts, analytic neighborhoods and blocks are optional scheme-specific units. Completeness, non-overlap and parcel alignment must be tested rather than assumed.", "source_refs": [ "SRC-002", "SRC-005" ], "questions": [ { "id": "q-subdivision-subdivision-members", "text": "Which district or block scheme and member references describe the internal anatomy?", "kind": "composition", "answer_data": [ "data-subdivision-subdivision-members" ] }, { "id": "q-subdivision-partition-check", "text": "Does this scheme claim full coverage or a partition, and what gaps or overlaps violate that claim?", "kind": "constraint", "answer_data": [ "data-subdivision-partition-check" ] }, { "id": "q-subdivision-edge-relations", "text": "How are block edges related to streets, natural edges and parcels without asserting automatic alignment?", "kind": "relationship", "answer_data": [ "data-subdivision-edge-relations" ] }, { "id": "q-subdivision-unit-lineage", "text": "What predecessor and successor references explain a redrawn, split or merged subdivision?", "kind": "lifecycle", "answer_data": [ "data-subdivision-unit-lineage" ] } ], "data_elements": [ { "id": "data-subdivision-subdivision-members", "name": "Subdivision members", "description": "Candidate object fields: scheme; unit kind; member references; membership period. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "id": "data-subdivision-partition-check", "name": "Partition check", "description": "Candidate object fields: claimed invariant; tolerance; gaps; overlaps; validation state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "id": "data-subdivision-edge-relations", "name": "Edge relations", "description": "Candidate object fields: edge reference; relation type; method; confidence; exception. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "id": "data-subdivision-unit-lineage", "name": "Unit lineage", "description": "Candidate object fields: previous units; successor units; event evidence; validity; transfer rule. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-subdivision", "name": "District and block schemes register", "description": "Versioned local evidence index for district and block schemes. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-002", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-morphology", "name": "Morphology and density", "description": "Qualified physical and population-derived measurements.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004", "SRC-005", "SRC-006" ], "layers": [ { "id": "layer-built-form", "name": "Built-form properties", "description": "Geometry-derived measures are proposed observations with explicit definitions and support. Building coverage, floor area, height and volume are distinct quantities; one cannot substitute for another.", "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ], "findings": [ { "id": "finding-built-form", "name": "Built-form properties", "description": "Geometry-derived measures are proposed observations with explicit definitions and support. Building coverage, floor area, height and volume are distinct quantities; one cannot substitute for another.", "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ], "questions": [ { "id": "q-built-form-form-value", "text": "Which built-form quantity, unit, formula and spatial support does each value represent?", "kind": "measurement", "answer_data": [ "data-built-form-form-value" ] }, { "id": "q-built-form-form-quality", "text": "Which resolution, level of detail, vertical datum and uncertainty limit the height or volume estimate?", "kind": "quality", "answer_data": [ "data-built-form-form-quality" ] }, { "id": "q-built-form-form-inputs", "text": "Which building or raster inputs, transformations and exclusions produced the measurement?", "kind": "provenance", "answer_data": [ "data-built-form-form-inputs" ] }, { "id": "q-built-form-measure-checks", "text": "What checks prevent footprint coverage, floor area ratio and building volume from being conflated?", "kind": "validation", "answer_data": [ "data-built-form-measure-checks" ] } ], "data_elements": [ { "id": "data-built-form-form-value", "name": "Form value", "description": "Candidate object fields: quantity kind; value; unit; formula; support geometry. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] }, { "id": "data-built-form-form-quality", "name": "Form quality", "description": "Candidate object fields: resolution; level of detail; vertical datum; tolerance; uncertainty. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] }, { "id": "data-built-form-form-inputs", "name": "Form inputs", "description": "Candidate object fields: input versions; transformation; exclusions; observation method. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] }, { "id": "data-built-form-measure-checks", "name": "Measure checks", "description": "Candidate object fields: definition comparison; unit check; denominator check; result. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-built-form", "name": "Built-form properties register", "description": "Versioned local evidence index for built-form properties. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-population-density", "name": "Population and density support", "description": "Density is tied to a population definition, area denominator and reference time. Aggregate population estimates are references; residents and households remain outside this model.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ], "findings": [ { "id": "finding-population-density", "name": "Population and density support", "description": "Density is tied to a population definition, area denominator and reference time. Aggregate population estimates are references; residents and households remain outside this model.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ], "questions": [ { "id": "q-population-density-density-definition", "text": "Which population estimate and area denominator define this density value?", "kind": "measurement", "answer_data": [ "data-population-density-density-definition" ] }, { "id": "q-population-density-density-time", "text": "How are census dates, model epochs and geometry dates aligned or marked incomparable?", "kind": "temporal", "answer_data": [ "data-population-density-density-time" ] }, { "id": "q-population-density-density-quality", "text": "What allocation assumptions, exclusions, uncertainty and no-data coverage affect the population estimate?", "kind": "quality", "answer_data": [ "data-population-density-density-quality" ] }, { "id": "q-population-density-density-release", "text": "What aggregation or suppression review permits release without exposing identifiable residents?", "kind": "privacy", "answer_data": [ "data-population-density-density-release" ] } ], "data_elements": [ { "id": "data-population-density-density-definition", "name": "Density definition", "description": "Candidate object fields: population reference; count concept; area; units; formula; boundary version. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] }, { "id": "data-population-density-density-time", "name": "Density time", "description": "Candidate object fields: population date; geometry date; interpolation rule; mismatch state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] }, { "id": "data-population-density-density-quality", "name": "Density quality", "description": "Candidate object fields: allocation method; uncertainty; exclusions; completeness; no-data state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] }, { "id": "data-population-density-density-release", "name": "Density release", "description": "Candidate object fields: recipient scope; disclosure assessment; suppression rule; approval evidence. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] } ], "artifacts": [ { "id": "artifact-population-density", "name": "Population and density support register", "description": "Versioned local evidence index for population and density support. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-context", "name": "Relations and evidence", "description": "External references and observation provenance.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-002", "SRC-003", "SRC-004", "SRC-005" ], "layers": [ { "id": "layer-relationships", "name": "External spatial and service relations", "description": "Containment, overlap, adjacency and service coverage are typed evidence-bearing relations. Geographic intersection creates neither legal jurisdiction nor asset ownership.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ], "findings": [ { "id": "finding-relationships", "name": "External spatial and service relations", "description": "Containment, overlap, adjacency and service coverage are typed evidence-bearing relations. Geographic intersection creates neither legal jurisdiction nor asset ownership.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ], "questions": [ { "id": "q-relationships-external-links", "text": "Which administrative areas, sites, buildings, parcels and networks are linked by which relation types?", "kind": "relationship", "answer_data": [ "data-relationships-external-links" ] }, { "id": "q-relationships-spatial-test", "text": "What geometries, time interval and tolerance support each asserted containment or overlap?", "kind": "spatial", "answer_data": [ "data-relationships-spatial-test" ] }, { "id": "q-relationships-relation-authority", "text": "What separate evidence supports a service or jurisdiction claim beyond geometric coincidence?", "kind": "authority", "answer_data": [ "data-relationships-relation-authority" ] }, { "id": "q-relationships-neighbor-binding", "text": "Which pinned neighbor binding preserves unresolved or partially overlapping references?", "kind": "interoperability", "answer_data": [ "data-relationships-neighbor-binding" ] } ], "data_elements": [ { "id": "data-relationships-external-links", "name": "External links", "description": "Candidate object fields: target namespace; target ID; relation type; direction; revision. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] }, { "id": "data-relationships-spatial-test", "name": "Spatial test", "description": "Candidate object fields: extent pair; relation predicate; valid interval; tolerance; result. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] }, { "id": "data-relationships-relation-authority", "name": "Relation authority", "description": "Candidate object fields: claim kind; mandate or service evidence; issuer; disputed state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] }, { "id": "data-relationships-neighbor-binding", "name": "Neighbor binding", "description": "Candidate object fields: target model version; resolution state; partial-overlap qualifier; mapping loss. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-relationships", "name": "External spatial and service relations register", "description": "Versioned local evidence index for external spatial and service relations. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-002", "SRC-003", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-observation", "name": "Recognition and observation provenance", "description": "Record the evidence and activity behind each assertion. Raster classification, visual interpretation and official records have different purposes; attribution or a digest does not establish truth.", "source_refs": [ "SRC-004", "SRC-005" ], "findings": [ { "id": "finding-observation", "name": "Recognition and observation provenance", "description": "Record the evidence and activity behind each assertion. Raster classification, visual interpretation and official records have different purposes; attribution or a digest does not establish truth.", "source_refs": [ "SRC-004", "SRC-005" ], "questions": [ { "id": "q-observation-recognition", "text": "Which observations or records support recognizing this place as a settlement?", "kind": "evidence", "answer_data": [ "data-observation-recognition" ] }, { "id": "q-observation-derivation", "text": "Who produced each input and which processing activity generated the derived assertion?", "kind": "provenance", "answer_data": [ "data-observation-derivation" ] }, { "id": "q-observation-evidence-kind", "text": "Is the value observed, estimated, interpolated, extrapolated or a planning scenario?", "kind": "classification", "answer_data": [ "data-observation-evidence-kind" ] }, { "id": "q-observation-observation-quality", "text": "Which validation sample, confidence statement or known bias limits use of the assertion?", "kind": "quality", "answer_data": [ "data-observation-observation-quality" ] } ], "data_elements": [ { "id": "data-observation-recognition", "name": "Recognition", "description": "Candidate object fields: evidence references; observation method; assertion status; alternatives. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "data-observation-derivation", "name": "Derivation", "description": "Candidate object fields: source entity; activity; responsible role; input version; output revision. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "data-observation-evidence-kind", "name": "Evidence kind", "description": "Candidate object fields: evidence kind; model release; epoch; scenario reference. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "id": "data-observation-observation-quality", "name": "Observation quality", "description": "Candidate object fields: validation evidence; bias; confidence; spatial coverage; limitations. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-observation", "name": "Recognition and observation provenance register", "description": "Versioned local evidence index for recognition and observation provenance. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-dynamics", "name": "Change and continuity", "description": "Comparable change and settlement record lifecycle.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-001", "SRC-003", "SRC-004", "SRC-005" ], "layers": [ { "id": "layer-change", "name": "Change and comparability", "description": "Changes require compatible definitions, support and dates. A boundary or method revision is not necessarily physical growth, and a future epoch in an older release is not a new observation.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ], "findings": [ { "id": "finding-change", "name": "Change and comparability", "description": "Changes require compatible definitions, support and dates. A boundary or method revision is not necessarily physical growth, and a future epoch in an older release is not a new observation.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ], "questions": [ { "id": "q-change-change-pair", "text": "Which comparable baseline and follow-up observations define the change interval?", "kind": "temporal", "answer_data": [ "data-change-change-pair" ] }, { "id": "q-change-change-values", "text": "What separate land-area and population changes underlie any reported growth ratio?", "kind": "measurement", "answer_data": [ "data-change-change-values" ] }, { "id": "q-change-change-exceptions", "text": "How are zero denominators, population decline, shrinkage and missing observations represented?", "kind": "exception", "answer_data": [ "data-change-change-exceptions" ] }, { "id": "q-change-comparability", "text": "What evidence separates physical change from a redelineation, input correction or method change?", "kind": "validation", "answer_data": [ "data-change-comparability" ] } ], "data_elements": [ { "id": "data-change-change-pair", "name": "Change pair", "description": "Candidate object fields: baseline revision; follow-up revision; epoch pair; support geometry. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "data-change-change-values", "name": "Change values", "description": "Candidate object fields: land change; population change; individual rates; formula; units; interval. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "data-change-change-exceptions", "name": "Change exceptions", "description": "Candidate object fields: undefined status; negative rate; no-data reason; uncertainty; interpretation note. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "data-change-comparability", "name": "Comparability", "description": "Candidate object fields: method comparison; boundary bridge; reprocessing note; comparable flag. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-change", "name": "Change and comparability register", "description": "Versioned local evidence index for change and comparability. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-continuity", "name": "Lifecycle and record continuity", "description": "Settlement continuity is an evidenced identity decision, separate from geometry revisions, reclassification and administrative mergers. Abandonment or redevelopment claims need provenance and do not authorize disposal of source evidence.", "source_refs": [ "SRC-001", "SRC-005" ], "findings": [ { "id": "finding-continuity", "name": "Lifecycle and record continuity", "description": "Settlement continuity is an evidenced identity decision, separate from geometry revisions, reclassification and administrative mergers. Abandonment or redevelopment claims need provenance and do not authorize disposal of source evidence.", "source_refs": [ "SRC-001", "SRC-005" ], "questions": [ { "id": "q-continuity-record-state", "text": "What current, historical, uncertain or retired record state is supported and by whom?", "kind": "state", "answer_data": [ "data-continuity-record-state" ] }, { "id": "q-continuity-change-event", "text": "Which evidenced event changed the name, extent, status or continuity of the settlement record?", "kind": "event", "answer_data": [ "data-continuity-change-event" ] }, { "id": "q-continuity-identity-continuity", "text": "Does a split or merger create new settlement identities or only new representations?", "kind": "lifecycle", "answer_data": [ "data-continuity-identity-continuity" ] }, { "id": "q-continuity-record-disposition", "text": "Which retention rule and permitted tombstone preserve references after record retirement or payload deletion?", "kind": "retention", "answer_data": [ "data-continuity-record-disposition" ] } ], "data_elements": [ { "id": "data-continuity-record-state", "name": "Record state", "description": "Candidate object fields: state; basis; reviewer; effective period. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-continuity-change-event", "name": "Change event", "description": "Candidate object fields: event type; evidence; occurrence time; recorded time; affected assertions. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-continuity-identity-continuity", "name": "Identity continuity", "description": "Candidate object fields: decision; rationale; predecessors; successors; unresolved aliases. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "data-continuity-record-disposition", "name": "Record disposition", "description": "Candidate object fields: retention schedule; hold; disposal authority; minimal tombstone; retained references. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-005" ] } ], "artifacts": [ { "id": "artifact-continuity", "name": "Lifecycle and record continuity register", "description": "Versioned local evidence index for lifecycle and record continuity. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-001", "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "bundle-governance", "name": "Release and exchange", "description": "Purpose-limited access, accountable release and profile validation.", "rationale": "Authored grouping for this model supported by cited concepts. No source mandates this hierarchy or the proposed operations.", "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ], "layers": [ { "id": "layer-release", "name": "Access and accountable release", "description": "Public source availability is not blanket permission to release joined fine-scale data. Stewardship of a settlement record is distinct from ownership of land or residents.", "source_refs": [ "SRC-005", "SRC-006" ], "findings": [ { "id": "finding-release", "name": "Access and accountable release", "description": "Public source availability is not blanket permission to release joined fine-scale data. Stewardship of a settlement record is distinct from ownership of land or residents.", "source_refs": [ "SRC-005", "SRC-006" ], "questions": [ { "id": "q-release-access-scope", "text": "Which recipients may see each geometry, input, aggregate and artifact under the declared purpose?", "kind": "access", "answer_data": [ "data-release-access-scope" ] }, { "id": "q-release-spatial-protection", "text": "Which sensitive spatial details require restricted views or generalization before export?", "kind": "security", "answer_data": [ "data-release-spatial-protection" ] }, { "id": "q-release-release-accountability", "text": "Which custodian approves licensing, disclosure review and correction requests for this release?", "kind": "ownership", "answer_data": [ "data-release-release-accountability" ] }, { "id": "q-release-release-obligations", "text": "What source terms, attribution and retention obligations accompany the derived dataset?", "kind": "requirement", "answer_data": [ "data-release-release-obligations" ] } ], "data_elements": [ { "id": "data-release-access-scope", "name": "Access scope", "description": "Candidate object fields: recipient role; purpose; artifact scope; policy version. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] }, { "id": "data-release-spatial-protection", "name": "Spatial protection", "description": "Candidate object fields: sensitivity class; generalization rule; withheld detail; review evidence. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] }, { "id": "data-release-release-accountability", "name": "Release accountability", "description": "Candidate object fields: custodian role; license reference; disclosure reviewer; correction route. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] }, { "id": "data-release-release-obligations", "name": "Release obligations", "description": "Candidate object fields: source terms; attribution; redistribution conditions; retention; unresolved restriction. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-005", "SRC-006" ] } ], "artifacts": [ { "id": "artifact-release", "name": "Access and accountable release register", "description": "Versioned local evidence index for access and accountable release. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-005", "SRC-006" ] } ], "inline_only_rationale": null } ] }, { "id": "layer-exchange", "name": "Profiles and exchange validation", "description": "Conceptual alignment does not implement a standard or certify conformance. Export profiles must preserve identity, spatial support, time, evidence kind, uncertainty and access limits.", "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ], "findings": [ { "id": "finding-exchange", "name": "Profiles and exchange validation", "description": "Conceptual alignment does not implement a standard or certify conformance. Export profiles must preserve identity, spatial support, time, evidence kind, uncertainty and access limits.", "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ], "questions": [ { "id": "q-exchange-exchange-profile", "text": "Which versioned target schema and mapping carry the selected settlement projection?", "kind": "interoperability", "answer_data": [ "data-exchange-exchange-profile" ] }, { "id": "q-exchange-exchange-checks", "text": "Which tests detect missing CRS, lost uncertainty, broken references and incompatible time support?", "kind": "validation", "answer_data": [ "data-exchange-exchange-checks" ] }, { "id": "q-exchange-exchange-loss", "text": "Which unmapped concepts or qualifiers require refusal instead of silent loss?", "kind": "constraint", "answer_data": [ "data-exchange-exchange-loss" ] }, { "id": "q-exchange-exchange-process", "text": "How is a recipient-scoped local export reviewed, versioned and traced to its source revisions?", "kind": "process", "answer_data": [ "data-exchange-exchange-process" ] } ], "data_elements": [ { "id": "data-exchange-exchange-profile", "name": "Exchange profile", "description": "Candidate object fields: target schema; version; mapping; field correspondence; profile. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] }, { "id": "data-exchange-exchange-checks", "name": "Exchange checks", "description": "Candidate object fields: test set; reference checks; spatial and temporal checks; results. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] }, { "id": "data-exchange-exchange-loss", "name": "Exchange loss", "description": "Candidate object fields: unmapped concepts; required qualifiers; refusal reason; alternative. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] }, { "id": "data-exchange-exchange-process", "name": "Exchange process", "description": "Candidate object fields: recipient scope; approval; source revisions; export ID; digest; review state. Nested schema and requiredness depend on the adopting profile.", "value_kind": "object", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] } ], "artifacts": [ { "id": "artifact-exchange", "name": "Profiles and exchange validation register", "description": "Versioned local evidence index for profiles and exchange validation. Preserve referenced master records and unresolved assertions.", "media_or_form": [ "structured register", "authorized map or report projection" ], "serial": true, "identity_strategy": "Authoritative master-system identifier plus namespace and revision first; otherwise a stable local UUID with explicit reconciliation state. Opaque settlement key plus artifact type and immutable sequence; names and dates are not sole identity.", "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "resolve-settlement", "name": "Resolve settlement identity", "description": "Proposed operation, not implemented. Compare qualified master IDs and evidenced aliases; return unresolved or ambiguous rather than merge by name or footprint.", "inputs": [ "master reference", "namespace", "alias evidence" ], "outputs": [ "resolution or ambiguity report" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Read-only result; no identity merge" ], "source_refs": [ "SRC-001", "SRC-005" ] }, { "id": "record-extent", "name": "Record a qualified extent", "description": "Proposed operation, not implemented. Append an authorized geometry assertion with purpose, CRS, epoch, method and evidence kind. Do not redraw an official boundary.", "inputs": [ "geometry reference", "CRS and axis order", "epoch and method", "source evidence" ], "outputs": [ "extent revision or refusal report" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Local append with provenance and unresolved quality flags" ], "source_refs": [ "SRC-002", "SRC-004", "SRC-005" ] }, { "id": "assess-subdivision", "name": "Assess subdivision relations", "description": "Proposed operation, not implemented. Evaluate only declared scheme invariants and supplied relation evidence; do not assume complete tiling, parcel alignment or legal containment.", "inputs": [ "scheme version", "unit geometries", "declared invariants and tolerances" ], "outputs": [ "gap, overlap and relation report" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Local assessment artifact; no change to unit masters" ], "source_refs": [ "SRC-002", "SRC-005" ] }, { "id": "derive-indicator", "name": "Derive a qualified indicator", "description": "Proposed operation, not implemented. Use a pinned formula and compatible inputs; report missing support and undefined denominators. Derived estimates do not become official statistics automatically.", "inputs": [ "definition and formula", "input versions", "units and spatial support", "reference epoch" ], "outputs": [ "indicator with uncertainty or refusal report" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Local derived observation with complete lineage" ], "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "compare-epochs", "name": "Compare qualified observations", "description": "Proposed operation, not implemented. Check method, geography and epoch compatibility before computing change. Keep separate component rates; flag zero, negative and undefined ratio cases without ranking them automatically.", "inputs": [ "baseline and follow-up revisions", "comparison profile", "boundary and method bridges" ], "outputs": [ "change assessment or incomparability report" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Local comparison artifact; no automatic reclassification" ], "source_refs": [ "SRC-003", "SRC-004", "SRC-005" ] }, { "id": "prepare-projection", "name": "Prepare an authorized projection", "description": "Proposed operation, not implemented. Apply recipient scope, licensed input terms and disclosure review. Refuse required qualifier loss; generate a local artifact without transmitting or publishing it.", "inputs": [ "recipient and purpose", "source revisions", "mapping version", "release approval" ], "outputs": [ "local projection and loss report or refusal" ], "preconditions": [ "Verified role, purpose and access scope for all inputs", "Pinned source and profile versions; unresolved required evidence causes refusal", "For mutation, expected current revision and idempotency key must match" ], "effects": [ "Local export artifact and access audit only" ], "source_refs": [ "SRC-002", "SRC-005", "SRC-006" ] } ], "composition": [ { "target": "WM-PLC-004", "relation": "REFERENCE", "purpose": "Candidate administrative-area relation only; preserve overlap, multiple areas, time and distinct identity.", "required": false, "source_refs": [ "SRC-001", "SRC-003" ] }, { "target": "WM-BLT-008", "relation": "REFERENCE", "purpose": "Candidate site or campus reference; dated containment must be evidenced and is not mandatory.", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "target": "WM-BLT-001", "relation": "REFERENCE", "purpose": "Building master reference for morphology inputs; do not duplicate building ownership or lifecycle.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "WM-BLT-003", "relation": "REFERENCE", "purpose": "Network master reference; separate topology, spatial intersection and service coverage.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "WM-PLC-002", "relation": "REFERENCE", "purpose": "Parcel master reference; a block is not a cadastral unit or a title assertion.", "required": false, "source_refs": [ "SRC-002", "SRC-005" ] }, { "target": "WM-XCT-010", "relation": "REFERENCE", "purpose": "Address and location reference; place names do not uniquely identify the subject.", "required": false, "source_refs": [ "SRC-005" ] }, { "target": "WM-ACT-016", "relation": "REFERENCE", "purpose": "Observation reference with method, time and uncertainty; settlement is not an observation event.", "required": false, "source_refs": [ "SRC-004", "SRC-005" ] }, { "target": "CityGML 3.0", "relation": "ALIGN", "purpose": "Selected conceptual alignment for city objects and representation detail; no encoding conformance.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "Degree of Urbanisation 2021", "relation": "ALIGN", "purpose": "Versioned classification reference; not a universal legal designation.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "PROV-O 2013-04-30", "relation": "ALIGN", "purpose": "Derivation and attribution mapping proposal only; no implemented RDF conformance.", "required": false, "source_refs": [ "SRC-005" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Accountable settlement data steward and evidenced mandate; never infer land ownership from stewardship", "Namespace, spatial and statistical profiles, source versions and correction authority", "Purpose, recipient access policy, licenses, disclosure review and retention schedule" ], "namespace_guidance": "Use steward-qualified opaque identifiers. Keep settlement IDs distinct from extent versions, classification units and source grid cells.", "registry_links": [ "vr.wm-plc-005", "Pin optional neighbor bindings before integration" ] }, "canon_and_patch": { "canonicalization_rules": [ "Normalize only within a verified namespace; preserve language, aliases and disputed identity claims.", "Preserve competing boundary, class and measurement assertions rather than selecting a universal canonical polygon." ], "patch_rules": [ "Require actor, evidence, expected revision and idempotency key; retain supersession and correction links.", "Dispose of restricted payload under the approved retention rule; do not retain personal data indefinitely as history." ], "compatibility_rules": [ "Version geometry and indicator profiles; reject target mappings that drop required time, evidence kind, uncertainty or access qualifiers." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier with namespace and revision", "Verified external stable URI and version", "Local opaque UUID with reconciliation state" ], "timestamp_rule": "Recording instants use RFC 3339 with seconds and explicit UTC offset. Preserve observation epoch, valid interval, publication and ingestion times separately; retain date-only or year-only precision and unknowns without inventing midnight timestamps.", "serial_naming_rule": "Opaque settlement key plus artifact type and immutable sequence or revision; no resident data in filenames.", "integrity_rule": "Record digest algorithm, input revision and transformation lineage. Hashes establish byte identity only, not geographic accuracy or official authority." }, "policies": [ "Reviewable draft under a single-provider waiver; independent external review remains outstanding.", "No automatic official designation, planning approval, displacement decision, eligibility determination or boundary change.", "Source-specific access and licensing plus statistical disclosure review govern every derived release; public geometry does not authorize release of joined resident information.", "Hazards include stale baselines, ecological inference, false comparability, vulnerable-population exposure and loss of disputed place names. Record uncertainty and preserve correction routes." ], "crud": { "read": [ "Return only the authorized purpose-scoped view, with observation age, uncertainty and source status." ], "create": [ "Require a namespace or explicit provisional local ID, subject definition, steward and evidence status." ], "update": [ "Append supported revisions; distinguish identity decisions, geometry revisions and classification assignments." ], "delete": [ "Apply the retention schedule, lawful holds and approved disposal to each payload and derivative. Keep only a minimal non-identifying tombstone where permitted.", "Retiring the local record neither removes a physical settlement nor changes external official master records." ] }, "roles": [ { "name": "Settlement data steward", "responsibilities": [ "Maintain identity, scope, evidence and correction route" ] }, { "name": "Spatial analyst", "responsibilities": [ "Document geometry methods, uncertainty and relation tests" ] }, { "name": "Statistical reviewer", "responsibilities": [ "Review concepts, denominators, temporal support and comparability" ] }, { "name": "Release and records officer", "responsibilities": [ "Approve access scope, licenses, confidentiality review and retention" ] }, { "name": "Community liaison", "responsibilities": [ "Record disputed names, boundaries and local corrections without exposing residents" ] } ], "access": { "default_rule": "Deny unpublished input and fine-scale evidence access unless role, purpose and scope are authorized. Approved public projections remain bounded by license and disclosure review.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "Emergency or statutory access requires evidenced authority, purpose, scope and review; no blanket bypass." ], "audit_requirements": [ "Record actor, purpose, scope, revisions, release approval and result for reads, exports, corrections and disposal under a minimal-data retention policy." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL" ], "read_order": [ "AGENTS.md and owner access and retention policies", "spec.yaml including review state and publication holds", "Pinned profiles, source revisions and recipient-specific evidence" ] } }, "coverage": { "claim": "Source-grounded proposed structure for one persistent settlement entity and its qualified urban-form observations. Selected primary concepts support the research, and a separate frozen local no-tools self-audit found no critical conflicts. This remains a noncanonical reviewable draft with independent-review, source/version, adopting-profile and executable-conformance holds.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Qualified place IDs, aliases and continuity decisions." }, { "dimension": "lifecycle", "status": "covered", "notes": "State, revision, split, merge, retirement and correction evidence." }, { "dimension": "relationships", "status": "covered", "notes": "Optional external masters with dated spatial and service assertions." }, { "dimension": "temporal", "status": "covered", "notes": "Observation epochs, validity, release and recording times remain distinct." }, { "dimension": "provenance", "status": "covered", "notes": "Input versions, activities, attribution and uncertain evidence kinds." }, { "dimension": "ownership", "status": "covered", "notes": "Accountable stewards are roles, distinct from property owners." }, { "dimension": "validation", "status": "gap", "notes": "Research schema validation does not implement nested instance validation or geographic algorithms." }, { "dimension": "access", "status": "covered", "notes": "Recipient scopes, sensitivity review and restricted statistical inputs." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual mappings need pinned schemas, round-trip and qualifier-loss tests." }, { "dimension": "retention", "status": "covered", "notes": "Disposition rules and minimal tombstones; no perpetual personal-data retention." }, { "dimension": "direct properties", "status": "covered", "notes": "Geometry, built form, height, density and population-derived observations with units and support." }, { "dimension": "recognition and observation", "status": "covered", "notes": "Evidence of habitation, conflicting definitions and measurement uncertainty." }, { "dimension": "capabilities and hazards", "status": "covered", "notes": "Six proposed local operations with refusal results; misleading comparison and disclosure risks." }, { "dimension": "context and evidence", "status": "covered", "notes": "Profiles, licenses, region-specific authority and source limits." } ], "known_omissions": [ "Independent external review is absent under the owner waiver.", "Live direct HTTP, full CityGML text, current versions, licensing and local applicability remain unverified.", "Nested field schemas, executable geospatial routines, statistical thresholds, conformance mappings and adversarial instance fixtures are not implemented.", "Functional urban areas, detailed accessibility, climate, infrastructure performance, informal tenure and statutory planning need separately bounded profiles or linked models." ], "conflicts": [], "regional_assumptions": [ "International statistical methods complement national definitions; no universal urban threshold or legal city status is asserted.", "Global gridded datasets do not establish parcel rights, administrative authority or household-level truth." ], "adversarial_checks": [ "Reject mandatory one-municipality containment, district tiling and parcel alignment.", "Reject classification, name or matching footprint as unique settlement identity.", "Reject future or interpolated epochs as direct observations.", "Reject undefined growth ratios, incompatible denominators and silent mapping loss.", "Reject automatic release of joined fine-scale data or official actions from a proposed operation." ] }, "researchAdjudication": { "providerMode": "single-provider-waiver", "activeProviders": [ "codex" ], "waivedProviders": [ "claude", "grok" ], "providerPolicy": { "contract_version": "1.0.0", "mode": "single-provider-waiver", "effective_at": "2026-09-06T00:00:00Z", "scope": "Canonical single-stream subject-model research after the six-workstream consolidation", "active_providers": [ "codex" ], "waived_providers": [ { "provider": "claude", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "Claude produced no result on prior 1800-second and 900-second attempts and again timed out on bounded 600-second Sonnet and 300-second Haiku passes. The owner prioritized completion over provider availability." }, { "provider": "grok", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "The repository owner authorized completion without Grok when Grok is unavailable, slow or schema-invalid. Grok may still be attempted as a bounded supplemental reviewer, but its failure never blocks a valid Claude plus no-tools result." } ], "review_rule": "Codex may complete source-grounded fallback research after bounded Claude and Grok attempts fail. It requires a separate no-tools adversarial audit and remains reviewable-draft with a visible absence-of-external-review hold.", "supplemental_provider_attempts": [ { "provider": "claude", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." }, { "provider": "grok", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." } ] }, "boundaryDecision": { "entry_kind": "entity", "status": "accepted", "rationale": "The root is a persistently identified settlement. Urban form is its qualified view, with separately identified extents, observations and subdivision references. The legacy aggregate description concerns measured aggregation; registry standalone-mm is not a subject-kind enum." }, "decisions": [ { "concept": "Persistent subject boundary", "disposition": "accepted", "rationale": "Settlement identity is distinct from morphology observations, dataset releases and statistical classes; a combined title does not create two uncontrolled roots." }, { "concept": "Official identity and naming", "disposition": "qualified", "rationale": "Qualified master IDs are preferred, but provisional local IDs and unresolved aliases remain possible. Names, classes and similar footprints cannot prove equivalence." }, { "concept": "Statistical and legal classification", "disposition": "separated", "rationale": "Assignments carry scheme, version, unit, time and authority status. National terminology and statistical classes can coexist without asserting legal equivalence." }, { "concept": "Extent and subdivision invariants", "disposition": "qualified", "rationale": "Alternative extents and optional district or block schemes preserve partial coverage, overlaps and uncertainty. Tiling, contiguity and parcel alignment are not universal requirements." }, { "concept": "Registry containment candidates", "disposition": "qualified", "rationale": "Administrative-area and site references remain optional dated spatial assertions. The result does not infer a single parent, mandatory campus, ownership or jurisdiction from containment." }, { "concept": "Measurements and denominators", "disposition": "accepted", "rationale": "Built-form and density findings preserve quantity definitions, units, support, dates and uncertainty, preventing footprint, floor area, volume and population concepts from being collapsed." }, { "concept": "Observation and estimate status", "disposition": "accepted", "rationale": "The evidence-kind questions explicitly distinguish observed, estimated, interpolated, extrapolated and scenario values. A future epoch in a cited release is not promoted into a new observation." }, { "concept": "Change interpretation", "disposition": "accepted with limits", "rationale": "Component rates and comparability evidence remain separate. Undefined ratios, negative growth, no-data and method or boundary changes cause qualification or refusal rather than unsupported ranking." }, { "concept": "Record continuity and retention", "disposition": "accepted", "rationale": "Identity split or merger decisions require evidence and differ from geometry revisions. Approved disposal and minimal tombstones preserve references without requiring indefinite personal payload retention." }, { "concept": "Proposed operation authority", "disposition": "accepted as unimplemented", "rationale": "All six functions are proposed local operations with role, evidence and revision preconditions. None confers city status, redraws an official boundary, publishes data or changes external masters." }, { "concept": "Release and stewardship", "disposition": "qualified", "rationale": "Custodian roles are distinct from land ownership. License and disclosure review govern joined data and recipient-scoped projections; public source availability does not authorize every derivative release." }, { "concept": "Source coverage and conformance", "disposition": "held", "rationale": "Selected browser-readable evidence and CityGML indexed excerpts support a research proposal, not complete normative verification. Direct HTTP is unattempted and unmeasured; nested schemas and algorithms remain incomplete." }, { "concept": "Independent review", "disposition": "waived and held", "rationale": "This is a separate local Codex self-audit of frozen evidence. Neither Claude nor Grok was attempted or admitted, so provider agreement and independent external review cannot be claimed." } ], "publicationHolds": [ "Independent external review is absent under the owner-authorized single-provider waiver. Claude and Grok were skipped with zero attempts; the separate local Codex no-tools self-audit is not an independent second-provider review.", "Source and version verification remains incomplete. Direct HTTP was not attempted under the owner-reported sandbox block, so all six statuses are unmeasured. Five documents were browser-readable with selected sections reviewed; CityGML has selected official indexed-excerpt support only. The coordinator must run check_sources.py and complete content, current-version and licensing review.", "Adopting profiles require qualified review of national definitions, statistical scope, spatial support, geometry tolerances, disclosure controls, licenses, retention and authority. This draft cannot determine official status, statutory boundaries, funding eligibility or planning approval.", "Nested instance schemas, pinned neighbor bindings, geospatial and indicator algorithms, CityGML/PROV mappings, round-trip conformance and adversarial instance fixtures remain incomplete. No runtime or compliance certification is claimed.", "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft." ], "deferredResearch": [ "Complete full source and current-version verification, including CityGML, licensing and source-specific method limits; restore independent external review before canonical promotion.", "Develop adopting profiles for dispersed or rapidly changing settlements, disputed names, cross-boundary extents and nonmatching subdivision or parcel schemes, with reviewed disclosure and retention rules.", "Implement and test nested schemas and mappings with zero growth, shrinkage, missing data, mixed epochs, changed boundaries, uncertain geometry, projected values and qualifier-loss refusal cases." ] }, "statistics": { "sources": 6, "bundles": 6, "layers": 12, "findings": 12, "questions": 48, "artifacts": 12, "functions": 6 } }