article:
  id: CA-UI-001
  title: Universal Civilisational Interoperability Protocol
  version: 1.0
  status: canonical
  type: specification
purpose:
  primary: >
    Allow independently developed civilisational theories,
    disciplines, datasets, historical accounts and analytical
    models to become interoperable through Civilisation Atlas.
  not_intended_to:
    - replace specialised disciplines
    - erase disciplinary depth
    - force all theories into one explanation
    - claim one universal theory of civilisation
  intended_to:
    - assign common addresses
    - preserve source-model depth
    - create crosswalks
    - enable machine routing
    - support comparison
    - support synthesis
    - support civilisational diagnosis

Civilisation Atlas ≠ Universal Theory
Civilisation Atlas =
Universal Addressing Layer
+ Interoperability Protocol
+ Knowledge Graph
+ Routing Runtime

Specialised Research → Depth
Civilisation Atlas → Connectivity
CivOS → Operating Mechanics
Control Tower → Routing and Retrieval
StrategizeOS → Cross-Domain Mechanism Transfer

universal_set:
  id: CA-U
  definition: >
    All objects, systems, events, theories, mechanisms,
    environments and relationships materially relevant
    to the formation, operation, transformation, survival
    or failure of civilisation.

CA-U = {
  people,
  populations,
  artefacts,
  technologies,
  institutions,
  infrastructures,
  settlements,
  states,
  economies,
  ecosystems,
  events,
  theories,
  hazards,
  transitions,
  historical civilisations,
  present systems,
  future scenarios
}

principle:
  preserve_depth: true
  require_shared_address: true
  permit_multiple_models: true
  permit_disagreement: true
  require_provenance: true
  require_relationships: true

For every external model M:
retain(M.internal_structure)
assign(M.atlas_address)
map(M.variables → Atlas fields)
map(M.mechanisms → CivOS mechanisms)
map(M.claims → evidence records)
connect(M → related objects)
do_not_flatten(M)

coordinate:
  capability:
    code: S
    question: What can the civilisation reliably do?
  lifecycle:
    code: L
    question: What condition and direction is the system in?
  habitat:
    code: H
    question: Across how many independent environments can it survive?

PrimaryCoordinate = (S, L, H)

coordinate_example:
  object: Modern Human Civilisation
  capability: S4
  lifecycle:
    phase:
      - drift
      - repair
    vector: contested
  habitat: H1

state_vector:
  basefloor_health: B
  ecological_condition: E
  institutional_capacity: I
  control_geometry: G
  information_condition: N
  repair_capacity: R
  dependency_structure: D
  risk_exposure: X
  motion_vector: V

FullCoordinate =
(S, L, H | B, E, I, G, N, R, D, X, V)

civilisation_object:
  id: required
  name: required
  object_type: required
  description: required
  scope:
    spatial: optional
    temporal: optional
    population: optional
    system_level: required
  coordinate:
    primary: optional
    inherited_from: optional
    modifies_coordinate: optional
  mechanisms: []
  dependencies: []
  relationships: []
  transitions: []
  evidence: []
  interpretations: []
  confidence: required

object_types:
  - civilisation
  - society
  - population
  - institution
  - infrastructure
  - technology
  - artefact
  - event
  - environment
  - resource
  - idea
  - theory
  - mechanism
  - hazard
  - transition
  - future_scenario

theory_crosswalk:
  theory_id: required
  original_name: required
  originating_discipline: required
  original_authors: []
  unit_of_analysis: required
  variables: []
  mechanisms: []
  evidence_base: []
  time_horizon: optional
  atlas_mapping:
    capability_relevance: []
    lifecycle_relevance: []
    habitat_relevance: []
    basefloor_relevance: []
    civos_mechanisms: []
    related_objects: []
  preservation_rule:
    retain_original_model: true
    atlas_replacement: false
  limitations: []
  confidence: required

theory_crosswalk:
  theory_id: EXT-TAINTER-COMPLEXITY
  original_name: Collapse of Complex Societies
  originating_discipline:
    - archaeology
    - collapse studies
  unit_of_analysis: complex society
  mechanisms:
    - increasing complexity
    - rising maintenance cost
    - diminishing marginal returns
    - institutional burden
  atlas_mapping:
    capability_relevance:
      - complexity accumulation
    lifecycle_relevance:
      - drift
      - descent
      - collapse
    habitat_relevance: []
    basefloor_relevance:
      - energy
      - material throughput
      - institutional maintenance
    civos_mechanisms:
      - production
      - governance
      - resource allocation
      - maintenance
      - repair failure
  preservation_rule:
    retain_original_model: true
    atlas_replacement: false

relationship_types:
  structural:
    - contains
    - part_of
    - depends_on
    - supplies
    - controls
    - governs
  causal:
    - enables
    - constrains
    - accelerates
    - destabilises
    - repairs
    - transforms
  temporal:
    - precedes
    - succeeds
    - emerges_from
    - transitions_into
  analytical:
    - supports
    - contradicts
    - refines
    - overlaps
    - provides_evidence_for
  comparative:
    - resembles
    - differs_from
    - is_variant_of

function ingest(input):
    object = identify_object(input)
    object.id = assign_canonical_id(object)
    object.object_type = classify_type(object)
    object.scope = detect_scope(object)
    if object.is_civilisation_scale:
        object.coordinate.primary =
            estimate_capability(object),
            estimate_lifecycle(object),
            estimate_habitat(object)
    else:
        object.coordinate.inherited_from =
            locate_parent_system(object)
        object.coordinate.modifies_coordinate =
            estimate_coordinate_effect(object)
    object.mechanisms =
        map_to_civos(object)
    object.dependencies =
        detect_dependencies(object)
    object.relationships =
        connect_to_existing_graph(object)
    object.evidence =
        register_sources(input)
    object.confidence =
        calculate_confidence(object)
    validate(object)
    return route_to_control_tower(object)

function answer(question):
    intent = interpret(question)
    relevant_objects =
        search_knowledge_graph(intent)
    coordinates =
        retrieve_coordinates(relevant_objects)
    mechanisms =
        retrieve_civos_mechanisms(relevant_objects)
    theories =
        retrieve_external_crosswalks(relevant_objects)
    evidence =
        retrieve_provenance(relevant_objects)
    conflicts =
        detect_disagreement(evidence, theories)
    return compose(
        coordinate = coordinates,
        mechanisms = mechanisms,
        research_depth = theories,
        evidence = evidence,
        uncertainty = conflicts
    )

External discipline D may contain greater local depth than Atlas A.
Therefore:
A does not compress D into a summary and discard D.
A stores:
- the location of D,
- the objects studied by D,
- the variables measured by D,
- the mechanisms proposed by D,
- the evidence used by D,
- the relationships between D and other fields.

Depth remains distributed.
Connectivity becomes universal.

integration:
  shared_coordinate: required
  shared_object_identity: required
  shared_relationship_language: required
  shared_provenance_format: required
  identical_explanation: not_required
  identical_methodology: not_required
  identical_scale: not_required
  disciplinary_merger: not_required

Historical Evidence
        │
        ▼
Specialised Disciplines
        │
        ▼
Theory and Dataset Crosswalks
        │
        ▼
Universal Civilisation Objects
        │
        ▼
Atlas Coordinate Engine
        │
        ▼
CivOS Mechanism Layer
        │
        ▼
Civilisation Knowledge Graph
        │
        ▼
Control Tower
        │
        ▼
Human and AI Queries

canonical_statement: >
  Civilisation Atlas is a universal civilisational
  interoperability layer. It does not replace specialised
  research or reproduce all disciplinary depth. It provides
  the shared identities, coordinates, relationships,
  provenance rules and routing protocols through which
  independently developed civilisational knowledge can
  become interoperable.

THEY PROVIDE DEPTH.
THE ATLAS PROVIDES ADDRESSING.
CivOS PROVIDES MECHANISMS.
THE CONTROL TOWER PROVIDES ROUTING.
THE KNOWLEDGE GRAPH PROVIDES CONNECTION.
AI PROVIDES DYNAMIC RETRIEVAL AND SYNTHESIS.

protocol_status:
  universal_theory: false
  universal_interoperability_layer: true
  depth_replacement: false
  web_like_architecture: true
  machine_readable: true
  human_navigable: true