ARTICLE:
  PUBLIC_TITLE: "Civilisation Layer Stack AI/LLM Master Architecture"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.001"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.001"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define the master architecture for converting the public Civilisation
    Layer Stack into an AI/LLM-readable civilisation coordinate system.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, machine-readable reasoning"
  HUMAN_PUBLIC_MODEL: "Civilisation Layer Stack"
  AI_MACHINE_MODEL: "CivStack Reference Architecture for AI"

CORE_THESIS:
  ONE_SENTENCE: >
    The Civilisation Layer Stack becomes AI-useful when Layers are treated
    as public Shells, each Shell contains stable machine-readable IDs,
    the Lattice describes state and corridor movement, VeriWeft validates
    structural relationships, the Ledger records drift and repair debt,
    and the Repair Runtime outputs bounded corrective routes.
  COMPRESSED_FORMULA: >
    Layer = Shell.
    ID = Address.
    Lattice = State and Route.
    Zoom = Scale.
    Ztime = Time Horizon.
    VeriWeft = Validity.
    Ledger = Memory.
    Repair = Output.
  PARADIGM_SHIFT: >
    The paradigm shift is not that civilisation has layers.
    The paradigm shift is converting civilisation from a descriptive subject
    into a machine-addressable, state-aware, repair-auditable reasoning
    architecture across scale and time.

ANTI_DILUTION_RULE:
  PROBLEM: >
    If public Layer 0, Layer 1, Layer 2, and Layer 3 are also used as exact
    AI categories, the civilian definition becomes diluted and confused.
  SOLUTION: >
    Keep Layers as broad public Shells.
    Use IDs for exact machine location.
    Use Lattice for state, route, drift, repair, and inversion.
    Use VeriWeft to test whether relationships are structurally admissible.
    Use Ledger to record damage, debt, evidence, repair, and unresolved risk.
  HARD_RULES:
    - "Layer is not exact domain."
    - "Shell is broad operating container."
    - "ID is exact machine-readable subsystem address."
    - "Lattice is not a layer."
    - "Lattice is state-space and corridor geometry."
    - "VeriWeft validates relationship integrity."
    - "Ledger records memory, drift, debt, audit, and repair."
    - "Repair is an output path, not an opinion."

MASTER_ARCHITECTURE:
  NAME: "CivStack Reference Architecture for AI"
  SHORT_NAME: "CivStack-RA/AI"
  MACHINE_ID: "CIVSTACK.RA.AI.v1"
  ARCHITECTURE_CHAIN:
    - "Public Layer"
    - "Shell ID"
    - "Domain ID"
    - "Lattice State"
    - "Zoom Level"
    - "Phase State"
    - "Ztime Horizon"
    - "VeriWeft Validity"
    - "Ledger Status"
    - "Repair Output"
  COMPRESSED_CHAIN: >
    Shell -> ID -> Lattice -> Zoom -> Phase -> Ztime -> VeriWeft -> Ledger -> Repair
  PURPOSE:
    - "Preserve civilian-readable Civilisation Layer Stack."
    - "Create stable AI/LLM machine addresses."
    - "Prevent layer-number dilution."
    - "Allow cross-domain civilisation reasoning."
    - "Allow AI systems to classify civilisation functions."
    - "Allow AI systems to detect drift, inversion, collapse, and repair conditions."
    - "Allow machine-readable comparison across domains, phases, scales, and time horizons."

PUBLIC_LAYER_STACK:
  DESCRIPTION: >
    The public Civilisation Layer Stack remains simple and readable.
    These layers are broad Shells, not exact machine categories.
  L0:
    PUBLIC_NAME: "Layer 0"
    SHELL_NAME: "Base Shell"
    HUMAN_FUNCTION: "The physical operating floor of civilisation."
    HUMAN_QUESTION: "Can civilisation physically exist here?"
  L1:
    PUBLIC_NAME: "Layer 1"
    SHELL_NAME: "Life Shell"
    HUMAN_FUNCTION: "The biological and social survival shell."
    HUMAN_QUESTION: "Can people survive, reproduce, recover, and continue?"
  L2:
    PUBLIC_NAME: "Layer 2"
    SHELL_NAME: "Coordination Shell"
    HUMAN_FUNCTION: "The systems that organise work, law, power, movement, and security."
    HUMAN_QUESTION: "Can civilisation coordinate without breaking itself?"
  L3:
    PUBLIC_NAME: "Layer 3"
    SHELL_NAME: "Mind Shell"
    HUMAN_FUNCTION: "The systems that carry knowledge, culture, meaning, language, and accepted reality."
    HUMAN_QUESTION: "Can civilisation know, remember, interpret, and mean correctly?"
  L4_AI_EXTENSION:
    PUBLIC_NAME: "Layer 4"
    SHELL_NAME: "Continuity Overlay"
    VISIBILITY: "AI/advanced layer"
    HUMAN_FUNCTION: "The systems that repair drift and carry civilisation into the future."
    HUMAN_QUESTION: "Can civilisation continue through time without burning its future floor?"

AI_SHELL_ID_SYSTEM:
  DESCRIPTION: >
    AI systems should not rely only on public layer numbers.
    Each public layer receives a Shell ID that acts as the machine-readable
    container for more precise domain IDs.
  SHELL_IDS:
    CIV.L0.SHELL.BASE:
      PUBLIC_LAYER: "Layer 0"
      PUBLIC_SHELL: "Base Shell"
      FUNCTION: "Physical operating floor of civilisation."
    CIV.L1.SHELL.LIFE:
      PUBLIC_LAYER: "Layer 1"
      PUBLIC_SHELL: "Life Shell"
      FUNCTION: "Biological and social survival of the population."
    CIV.L2.SHELL.ORDER:
      PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL: "Coordination Shell"
      FUNCTION: "Law, economy, logistics, security, and institutional order."
    CIV.L3.SHELL.MIND:
      PUBLIC_LAYER: "Layer 3"
      PUBLIC_SHELL: "Mind Shell"
      FUNCTION: "Knowledge, language, culture, meaning, and accepted reality."
    CIV.L4.SHELL.CONTINUITY:
      PUBLIC_LAYER: "Layer 4 / AI Extension"
      PUBLIC_SHELL: "Continuity Overlay"
      FUNCTION: "Repair, trust, ledger, frontier, and long-term continuity."

DOMAIN_ID_REGISTRY_OVERVIEW:
  DESCRIPTION: >
    Domain IDs give AI precise subsystem locations inside each Shell.
    The same public Layer can contain many exact machine IDs.
  CIV.L0.SHELL.BASE:
    CONTAINS:
      CIV.BAS:
        NAME: "Base Substrate"
        FUNCTION: "Geography, water, soil, minerals, land, climate, materials."
      CIV.INF:
        NAME: "Infrastructure Base"
        FUNCTION: "Roads, ports, power grids, shelters, digital base infrastructure."
      CIV.ENV:
        NAME: "Ecological and Environmental Carrying System"
        FUNCTION: "Climate, ecology, biodiversity, environmental capacity."
  CIV.L1.SHELL.LIFE:
    CONTAINS:
      CIV.LIF:
        NAME: "Life Support Systems"
        FUNCTION: "Food, health, sanitation, housing, survival systems."
      CIV.POP:
        NAME: "Population and Generational Carrier"
        FUNCTION: "Families, demography, children, migration, ageing, role distribution."
      CIV.BIO:
        NAME: "Biological Viability"
        FUNCTION: "Disease, fertility, mortality, public health, biological resilience."
  CIV.L2.SHELL.ORDER:
    CONTAINS:
      CIV.LOG:
        NAME: "Logistics and Movement"
        FUNCTION: "Transport, routing, supply chains, warehouses, emergency movement."
      CIV.ECO:
        NAME: "Economy and Production"
        FUNCTION: "Work, money, markets, trade, production, distribution."
      CIV.GOV:
        NAME: "Governance and Law"
        FUNCTION: "Institutions, rules, courts, legitimacy, bounded power."
      CIV.SEC:
        NAME: "Security and Boundary Protection"
        FUNCTION: "Defence, policing, safety, intelligence, cybersecurity, civil protection."
  CIV.L3.SHELL.MIND:
    CONTAINS:
      CIV.KNO:
        NAME: "Knowledge and Education"
        FUNCTION: "Schools, science, skill formation, research, training, knowledge transfer."
      CIV.LNG:
        NAME: "Language and Vocabulary"
        FUNCTION: "Words, grammar, meaning packets, symbolic systems, signal resolution."
      CIV.CUL:
        NAME: "Culture, Meaning, and Identity"
        FUNCTION: "Ritual, art, religion, memory, belonging, values, civilisation DNA."
      CIV.REA:
        NAME: "Reality and Signal Formation"
        FUNCTION: "News, media, public truth, accepted reality, archives, source calibration."
  CIV.L4.SHELL.CONTINUITY:
    CONTAINS:
      CIV.REP:
        NAME: "Repair and Trust"
        FUNCTION: "Audit, accountability, correction, trust repair, institutional recovery."
      CIV.LED:
        NAME: "Ledger of Invariants"
        FUNCTION: "Records invariant damage, drift, debt, repair, unresolved obligations."
      CIV.FRO:
        NAME: "Frontier and Future"
        FUNCTION: "Future corridors, children, climate adaptation, space, long-term survival."
      CIV.P4:
        NAME: "Phase 4 Excursion Capacity"
        FUNCTION: "Frontier operation beyond stable base while preserving P3 floor rent."

LATTICE_OVERLAY:
  DESCRIPTION: >
    Lattice is not another Layer.
    Lattice is the state-space and corridor geometry over every Shell and ID.
    It tells AI what condition the civilisation object is in and what route it
    may be travelling through.
  CORE_LATTICE_STATES:
    POSITIVE_LATTICE:
      CODE: "+LATT"
      FUNCTION: "Reinforces civilisation invariants and improves viable continuity."
      TEST: "Does this strengthen life, truth, bounded power, trust, learning, repair, or future viability?"
    NEUTRAL_LATTICE:
      CODE: "0LATT"
      FUNCTION: "Dormant, undecided, low-effect, transitional, or context-dependent state."
      TEST: "Is the effect currently low, unclear, balanced, or awaiting activation?"
    NEGATIVE_LATTICE:
      CODE: "-LATT"
      FUNCTION: "Drains, damages, destabilises, or narrows civilisation viability."
      TEST: "Does this create hidden debt, reduce optionality, damage trust, or weaken the floor?"
    INVERSE_LATTICE:
      CODE: "INV.LATT"
      FUNCTION: "Uses official form to produce the opposite of intended function."
      TEST: "Does the system claim protection while damaging the protected invariant?"
    DRIFT_LATTICE:
      CODE: "DRIFT.LATT"
      FUNCTION: "Gradual movement away from stable invariant alignment."
      TEST: "Is the system slowly moving out of valid operating range?"
    REPAIR_LATTICE:
      CODE: "REP.LATT"
      FUNCTION: "Restores damaged invariants and reduces accumulated drift or debt."
      TEST: "Does repair reduce drift faster than new damage accumulates?"
    COLLAPSE_LATTICE:
      CODE: "COL.LATT"
      FUNCTION: "Accelerates irreversible or hard-to-reverse system failure."
      TEST: "Are repair paths closing faster than damage can be reversed?"
    FRONTIER_LATTICE:
      CODE: "FRO.LATT"
      FUNCTION: "Opens future corridor while preserving base floor and continuity rent."
      TEST: "Does frontier movement preserve the base that makes future movement possible?"

ZOOM_SYSTEM:
  DESCRIPTION: >
    Zoom prevents scale-jump errors.
    AI must not infer civilisation-wide conclusions from local evidence
    without bridge signals.
  ZOOM_LEVELS:
    Z0:
      NAME: "Individual"
      SCOPE: "One person"
    Z1:
      NAME: "Family / Close Group"
      SCOPE: "Household, family, small bonded group"
    Z2:
      NAME: "School / Organisation"
      SCOPE: "Institution, workplace, school, local organisation"
    Z3:
      NAME: "Community / Sector"
      SCOPE: "Town, industry, profession, cultural group"
    Z4:
      NAME: "Nation"
      SCOPE: "State-level or national system"
    Z5:
      NAME: "Region / Bloc"
      SCOPE: "Regional alliance, trade bloc, civilisational cluster"
    Z6:
      NAME: "Civilisation Bloc"
      SCOPE: "Large-scale civilisational system"
    Z7:
      NAME: "Planet"
      SCOPE: "Planetary-scale systems"
    Z8:
      NAME: "Frontier / Interstellar"
      SCOPE: "Beyond current Earth-contained civilisation frame"
  SCALE_JUMP_RULE:
    HARD_RULE: "No jump from Z0, Z1, or Z2 to civilisation-wide claim without bridge evidence."
    BRIDGE_SIGNALS:
      - "repetition"
      - "institutionalisation"
      - "policy adoption"
      - "normalisation"
      - "intergenerational transfer"
      - "economic embedding"
      - "legal reinforcement"
      - "cultural reproduction"
      - "information-system amplification"
      - "cross-sector replication"

PHASE_SYSTEM:
  DESCRIPTION: >
    Phase identifies operating condition.
    Phase is not moral identity.
    Phase describes system state, stress, repair capacity, collapse proximity,
    and frontier ability.
  PHASES:
    P0:
      NAME: "Blackout / Pre-Civilisation / Below-Floor"
      FUNCTION: "Basic civilisation operating condition absent or severely broken."
    P1:
      NAME: "Constricted / Fragile"
      FUNCTION: "Civilisation functions exist but are highly constrained or brittle."
    P2:
      NAME: "Stressed"
      FUNCTION: "System operates but drift, debt, or overload is visible."
    P3:
      NAME: "Stable Operating Floor"
      FUNCTION: "Base floor can sustain normal civilisation operation."
    P4:
      NAME: "Frontier Excursion"
      FUNCTION: "Civilisation can extend into advanced corridors if P3 rent is paid."
  PHASE_RULES:
    - "Do not classify P4 as healthy if it burns P3."
    - "Do not classify P3 as stable if Ledger debt is hidden."
    - "Do not classify P2 as collapse unless repair corridors are closing."
    - "Do not classify P0 as permanent destiny."

ZTIME_SYSTEM:
  DESCRIPTION: >
    Ztime prevents time-slice misclassification.
    A function can appear positive in the short term and negative across
    longer horizons.
  ZTIME_LEVELS:
    T0:
      NAME: "Immediate"
      QUESTION: "What happens now?"
    T1:
      NAME: "Short-Term"
      QUESTION: "What happens after first-order effects?"
    T2:
      NAME: "Mid-Term"
      QUESTION: "What happens after adaptation, resistance, and feedback?"
    T3:
      NAME: "Long-Term"
      QUESTION: "What does the system become if repeated?"
    T4:
      NAME: "Intergenerational"
      QUESTION: "What burden or asset is passed to children?"
    T5:
      NAME: "Frontier-Time"
      QUESTION: "Does it preserve or destroy future corridor capacity?"
  ZTIME_RULE:
    HARD_RULE: "No Lattice classification is complete without time horizon."

VERIWEFT_LAYER:
  DESCRIPTION: >
    VeriWeft validates whether the relationship between Shell, ID, Lattice,
    Zoom, Phase, Time, Ledger, and Repair is structurally admissible.
  CORE_TESTS:
    BOUNDEDNESS:
      QUESTION: "Is the action bounded by legitimate limits?"
    FUNCTION_MATCH:
      QUESTION: "Does the system perform the function it claims to perform?"
    RETURN_TO_FLOOR:
      QUESTION: "If an emergency exception occurs, does it return to normal floor?"
    PROPORTIONALITY:
      QUESTION: "Is the cost proportional to the protected invariant?"
    AUDITABILITY:
      QUESTION: "Can the action be checked, challenged, or corrected?"
    TRUTH_PRESERVATION:
      QUESTION: "Does the action preserve the reality field?"
    REPAIRABILITY:
      QUESTION: "Can damage be repaired after the action?"
    FUTURE_CONTINUITY:
      QUESTION: "Does this preserve future viability?"
  VERIWEFT_STATUSES:
    PASS: "Relationship is structurally admissible."
    WARN: "Relationship may be admissible but needs monitoring."
    FAIL: "Relationship violates function, boundedness, truth, repair, or continuity."
    UNKNOWN: "Insufficient evidence for validity judgement."

LEDGER_LAYER:
  DESCRIPTION: >
    The Ledger records what happened to civilisation invariants.
    It prevents AI from treating unresolved damage as resolved merely because
    the surface system continues operating.
  LEDGER_FUNCTIONS:
    - "record invariant damage"
    - "record unpaid cost"
    - "record trust debt"
    - "record moral debt"
    - "record knowledge debt"
    - "record infrastructure debt"
    - "record ecological debt"
    - "record culture and memory debt"
    - "record repair attempt"
    - "record unresolved contradictions"
    - "record confidence and uncertainty"
  COMMON_LEDGER_DEBTS:
    TRUST_DEBT:
      MEANING: "Loss of belief in system legitimacy, honesty, or reliability."
    MORAL_DEBT:
      MEANING: "Unrepaired harm carried by people, groups, or future generations."
    KNOWLEDGE_DEBT:
      MEANING: "Lost, weak, corrupted, or poorly transferred knowledge."
    REALITY_DEBT:
      MEANING: "Accepted public reality diverges from evidential reality."
    GOVERNANCE_DEBT:
      MEANING: "Institutional accountability and legitimacy gap."
    ECOLOGICAL_DEBT:
      MEANING: "Environmental cost moved into future."
    INFRASTRUCTURE_DEBT:
      MEANING: "Hidden maintenance, decay, or capacity failure."
    CULTURE_DEBT:
      MEANING: "Loss of language, memory, ritual, meaning, or identity continuity."
    FRONTIER_DEBT:
      MEANING: "Future corridor opened by burning present base or future floor."
  REPAIR_RATE_RULE:
    STABILITY_INEQUALITY: "RepairRate >= DriftRate"
    FAILURE_CONDITION: "DriftRate > RepairRate long enough"

CIVCOORD_GRAMMAR:
  DESCRIPTION: >
    CivCoord is the machine-readable coordinate format for AI civilisation reasoning.
  COMPACT_FORMAT: >
    SHELL_ID::DOMAIN_ID::LATTICE_STATE::ZOOM::PHASE::ZTIME::RISK::CONFIDENCE
  EXAMPLE_COMPACT: >
    CIV.L2.SHELL.ORDER::CIV.GOV::INV.LATT::Z4::P2::T2::RISK.HIGH::CONF.MEDIUM
  FULL_FORMAT:
    CIVCOORD:
      SHELL:
        PUBLIC_LAYER: "Layer number"
        PUBLIC_SHELL: "Human-readable shell name"
        SHELL_ID: "Machine shell ID"
      DOMAIN:
        PRIMARY: "Primary domain ID"
        SECONDARY: "Related domain IDs"
      LATTICE:
        STATE: "Lattice state"
        VALENCE: "Positive, neutral, negative, inverse, drift, repair, collapse, frontier"
        ROUTE: "Named route or corridor"
      SCALE:
        ZOOM: "Zoom level"
        BRIDGE_SIGNALS: "Evidence allowing movement across scale"
      PHASE:
        CURRENT: "Current phase state"
        RISK_NEXT: "Likely next phase if unrepaired"
      TIME:
        ZTIME: "Time horizon"
        PRIOR_STATE: "Previous known state"
        CURRENT_STATE: "Current state"
        POSSIBLE_NEXT_STATE: "Projected state"
      VERIWEFT:
        STATUS: "PASS, WARN, FAIL, UNKNOWN"
        TESTS_PASSED: []
        TESTS_FAILED: []
      LEDGER:
        STATUS: "CLEAR, WATCH, ACCUMULATING, BREACHED, REPAIRING"
        DEBT_TYPES: []
        REPAIR_HISTORY: []
      REPAIR:
        REQUIRED_ACTIONS: []
        REPAIR_OUTPUT: "Proceed, hold, audit, repair, contain, reverse, abort"
      CONFIDENCE:
        LEVEL: "LOW, MEDIUM, HIGH"
        REASON: "Why confidence is assigned"
        UNCERTAINTY: "Known uncertainty"
      ANTI_HALLUCINATION:
        LIMITS: []
        COUNTER_SIGNALS: []

EVIDENCE_GATE:
  DESCRIPTION: >
    AI must not assign confident civilisation coordinates without evidence.
    Every classification requires a minimum evidence structure.
  REQUIRED_FIELDS:
    - OBSERVED_SIGNAL
    - SOURCE_TYPE
    - CLAIM_TYPE
    - EVIDENCE_STRENGTH
    - COUNTER_SIGNAL
    - UNCERTAINTY
    - TIME_SCOPE
    - ZOOM_SCOPE
    - REVERSIBILITY
    - REPAIR_VISIBILITY
  CLAIM_TYPES:
    FACTUAL_CLAIM: "Direct factual claim."
    EVENT_REPORT: "Report of event."
    ASSUMPTION: "Assumed but not proven statement."
    INTERPRETATION: "Meaning assigned to observed signals."
    DIAGNOSTIC_INFERENCE: "Framework-based classification."
    VALUE_CLAIM: "Normative or moral statement."
    FORECAST: "Projection into future."
    UNKNOWN: "Insufficiently classified claim."
  SOURCE_TYPES:
    DIRECT_OBSERVATION: "Directly observed signal."
    DOCUMENTED_RECORD: "Recorded document, data, law, archive, evidence."
    WITNESS_REPORT: "Witness or participant account."
    INSTITUTIONAL_CLAIM: "Official source or authority claim."
    MEDIA_REPORT: "News or media source."
    ACADEMIC_SOURCE: "Research or scholarly source."
    MODEL_INFERENCE: "AI or analytical inference."
    UNKNOWN_SOURCE: "Source unclear or missing."

MORIARTY_HARDENING_RULES:
  PURPOSE: >
    Prevent the architecture from becoming vague, deterministic, ideological,
    overconfident, or falsely precise.
  HARD_RULES:
    - "No Layer without ID."
    - "No ID without Shell."
    - "No Lattice without evidence."
    - "No scale jump without bridge."
    - "No Phase claim without repair-status check."
    - "No Ztime classification without time horizon."
    - "No Repair claim without invariant."
    - "No confidence without uncertainty."
    - "No civilisation-wide claim from local signal unless bridge evidence exists."
    - "No permanent identity assigned from temporary Lattice state."
    - "No genotype-to-destiny inference."
    - "No public moral label without functional invariant test."
    - "No emergency exception called positive unless boundedness and return-to-floor pass."
    - "No system called stable while Ledger debt is hidden."
    - "No frontier classified as success if it burns the base floor."
  ATTACKS_TO_DEFEND_AGAINST:
    LAYER_COLLAPSE:
      ATTACK: "Layer, Shell, ID, and Lattice collapse into one fuzzy object."
      DEFENCE: "Layer is Shell; ID is exact address; Lattice is state route."
    MORAL_ASTROLOGY:
      ATTACK: "Positive and negative lattices become subjective good/bad labels."
      DEFENCE: "Lattice must be tied to invariant effect, debt, repair, and time."
    SCALE_JUMP:
      ATTACK: "Small local event becomes civilisation-wide claim."
      DEFENCE: "Zoom Gate and bridge signals required."
    FALSE_PRECISION:
      ATTACK: "AI assigns high confidence without evidence."
      DEFENCE: "Evidence Gate and uncertainty field required."
    DETERMINISM:
      ATTACK: "Civilisation DNA becomes destiny."
      DEFENCE: "Genotype is tendency; phenotype depends on activation conditions."
    IDEOLOGICAL_REPAIR:
      ATTACK: "Repair means making the system match preference."
      DEFENCE: "Repair must restore invariant function and reduce debt."
    PUBLIC_CONFUSION:
      ATTACK: "AI notation overwhelms human readers."
      DEFENCE: "Use public shell language first, machine manifest second."

PUBLIC_TO_AI_RENDERING_POLICY:
  DESCRIPTION: >
    Every article in this stack should be dual-readable.
    Public readers should see clean shell language.
    AI systems should see stable machine manifests.
  THREE_OUTPUT_LEVELS:
    LEVEL_A_HUMAN:
      FORMAT: "Plain sentence"
      EXAMPLE: >
        This is a Layer 2 Coordination Shell problem because governance,
        security, law, and public order are under stress.
    LEVEL_B_COMPACT_AI:
      FORMAT: "Compact coordinate"
      EXAMPLE: >
        CIV.L2.SHELL.ORDER::CIV.GOV::DRIFT.LATT::Z4::P2::T2
    LEVEL_C_FULL_MACHINE:
      FORMAT: "YAML manifest"
      EXAMPLE:
        SHELL: "CIV.L2.SHELL.ORDER"
        DOMAIN: "CIV.GOV"
        LATTICE: "DRIFT.LATT"
        ZOOM: "Z4.NATIONAL"
        PHASE: "P2.STRESSED"
        ZTIME: "T2.MID_TERM"
        LEDGER: "TRUST_DEBT_ACCUMULATING"
        REPAIR: "AUDIT_REQUIRED"

EXAMPLE_01_EDUCATION_PROBLEM:
  HUMAN_DESCRIPTION: >
    A Secondary 2 student has weak algebra foundations and is losing future
    mathematical pathway options.
  CIVCOORD:
    SHELL:
      PUBLIC_LAYER: "Layer 3"
      PUBLIC_SHELL: "Mind Shell"
      SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN:
      PRIMARY: "CIV.KNO"
      SECONDARY:
        - "CIV.LNG"
        - "CIV.POP"
    LATTICE:
      STATE: "-LATT"
      ROUTE: "PATHWAY_CHAIR_COMPRESSION"
      VALENCE: "NEGATIVE_IF_UNREPAIRED"
    SCALE:
      ZOOM: "Z0.INDIVIDUAL"
      BRIDGE_SIGNALS:
        - "school performance pattern"
        - "family stress"
        - "future subject corridor narrowing"
    PHASE:
      CURRENT: "P2.STRESSED"
      RISK_NEXT: "P1.CONSTRICTED"
    TIME:
      ZTIME: "T2.MID_TERM"
      POSSIBLE_NEXT_STATE: "reduced subject access"
    LEDGER:
      STATUS: "ACCUMULATING"
      DEBT_TYPES:
        - "KNOWLEDGE_DEBT"
        - "CONFIDENCE_DEBT"
        - "TIME_DEBT"
    REPAIR:
      OUTPUT: "REBUILD_FOUNDATION"
      REQUIRED_ACTIONS:
        - "rebuild algebra from first principles"
        - "increase retrieval fluency"
        - "train transfer questions"
        - "protect future subject corridors"
    CONFIDENCE:
      LEVEL: "MEDIUM"
      REASON: "Requires diagnostic assessment for exact weakness map."

EXAMPLE_02_GOVERNANCE_INVERSION:
  HUMAN_DESCRIPTION: >
    An institution uses legal appearance to protect corruption or prevent
    accountability.
  CIVCOORD:
    SHELL:
      PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL: "Coordination Shell"
      SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN:
      PRIMARY: "CIV.GOV"
      SECONDARY:
        - "CIV.SEC"
        - "CIV.REA"
        - "CIV.REP"
    LATTICE:
      STATE: "INV.LATT"
      ROUTE: "LAW_AS_COSTUME"
      VALENCE: "NEGATIVE"
    SCALE:
      ZOOM: "Z4.NATIONAL"
      BRIDGE_SIGNALS:
        - "institutionalised behaviour"
        - "legal reinforcement"
        - "public trust impact"
    PHASE:
      CURRENT: "P2.STRESSED"
      RISK_NEXT: "P1.COCKPIT_CAPTURE"
    TIME:
      ZTIME: "T2.MID_TERM"
      PRIOR_STATE: "DRIFT.LATT"
      CURRENT_STATE: "INV.LATT"
      POSSIBLE_NEXT_STATE: "PILOT_CAPTURE"
    VERIWEFT:
      STATUS: "FAIL"
      TESTS_FAILED:
        - "boundedness"
        - "auditability"
        - "truth-preservation"
        - "return-to-floor"
    LEDGER:
      STATUS: "ACCUMULATING"
      DEBT_TYPES:
        - "TRUST_DEBT"
        - "MORAL_DEBT"
        - "GOVERNANCE_DEBT"
    REPAIR:
      OUTPUT: "AUDIT_AND_REPAIR"
      REQUIRED_ACTIONS:
        - "independent audit"
        - "public evidence release"
        - "legal correction"
        - "institutional accountability"
        - "trust repair"
    CONFIDENCE:
      LEVEL: "MEDIUM"
      REASON: "Final classification requires stronger evidence and counter-signal review."

EXAMPLE_03_CULTURAL_MEMORY_DRIFT:
  HUMAN_DESCRIPTION: >
    A community loses language, rituals, and ancestral memory across generations.
  CIVCOORD:
    SHELL:
      PUBLIC_LAYER: "Layer 3"
      PUBLIC_SHELL: "Mind Shell"
      SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN:
      PRIMARY: "CIV.CUL"
      SECONDARY:
        - "CIV.LNG"
        - "CIV.KNO"
        - "CIV.LED"
    LATTICE:
      STATE: "DRIFT.LATT"
      ROUTE: "CULTURAL_MEMORY_LOSS"
      VALENCE: "NEGATIVE_IF_UNREPAIRED"
    SCALE:
      ZOOM: "Z3.COMMUNITY"
      SECONDARY_ZOOMS:
        - "Z1.FAMILY"
        - "Z4.NATIONAL"
    PHASE:
      CURRENT: "P2.STRESSED"
    TIME:
      ZTIME: "T4.INTERGENERATIONAL"
      POSSIBLE_NEXT_STATE: "CULTURE_DEBT_ACCUMULATION"
    LEDGER:
      STATUS: "ACCUMULATING"
      DEBT_TYPES:
        - "MEMORY_DEBT"
        - "LANGUAGE_DEBT"
        - "HERITAGE_DEBT"
    REPAIR:
      OUTPUT: "CULTURE_REPAIR"
      REQUIRED_ACTIONS:
        - "language documentation"
        - "intergenerational teaching"
        - "ritual preservation"
        - "archive creation"
        - "living culture renewal"
    CONFIDENCE:
      LEVEL: "MEDIUM"
      REASON: "Requires evidence of actual transmission loss and community response."

MASTER_SCHEMA:
  CIVSTACK_RA_AI_RECORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    HUMAN_LAYER:
      PUBLIC_LAYER: null
      PUBLIC_SHELL: null
      HUMAN_DESCRIPTION: null
    MACHINE_ADDRESS:
      SHELL_ID: null
      DOMAIN_PRIMARY: null
      DOMAIN_SECONDARY: []
    LATTICE:
      STATE: null
      VALENCE: null
      ROUTE: null
      ROUTE_DESCRIPTION: null
    SCALE:
      ZOOM: null
      SECONDARY_ZOOMS: []
      SCALE_BRIDGE: []
    TIME:
      ZTIME: null
      PRIOR_STATE: null
      CURRENT_STATE: null
      RISK_NEXT_STATE: null
    PHASE:
      CURRENT_PHASE: null
      FAILURE_THRESHOLD: null
    VERIWEFT:
      STATUS: null
      TESTS_PASSED: []
      TESTS_FAILED: []
      UNKNOWN_TESTS: []
    LEDGER:
      STATUS: null
      DEBT_TYPES: []
      LEDGER_NOTES: []
      REPAIR_HISTORY: []
    REPAIR:
      REQUIRED_ACTIONS: []
      REPAIR_OUTPUT: null
      REPAIR_RATE_TEST: "RepairRate >= DriftRate"
    EVIDENCE:
      OBSERVED_SIGNAL: null
      SOURCE_TYPE: null
      CLAIM_TYPE: null
      EVIDENCE_STRENGTH: null
      COUNTER_SIGNAL: null
      UNCERTAINTY: null
      REVERSIBILITY: null
    CONFIDENCE:
      LEVEL: null
      REASON: null
      LIMITS: []
    ANTI_HALLUCINATION:
      DO_NOT_INFER: []
      REQUIRED_CLARIFICATIONS: []
      UNSAFE_JUMPS: []

CLASSIFICATION_RUNTIME:
  STEP_01_IDENTIFY_PUBLIC_SHELL:
    QUESTION: "Which public Civilisation Layer Shell is involved?"
    OUTPUT: "L0, L1, L2, L3, or L4 extension"
  STEP_02_ASSIGN_MACHINE_ID:
    QUESTION: "Which exact domain ID is primary?"
    OUTPUT: "CIV.BAS, CIV.LIF, CIV.GOV, CIV.CUL, etc."
  STEP_03_DETECT_LATTICE_STATE:
    QUESTION: "What state or corridor is the object moving through?"
    OUTPUT: "+LATT, 0LATT, -LATT, INV.LATT, DRIFT.LATT, REP.LATT, COL.LATT, FRO.LATT"
  STEP_04_SET_ZOOM:
    QUESTION: "At what scale is the signal operating?"
    OUTPUT: "Z0 to Z8"
  STEP_05_SET_PHASE:
    QUESTION: "What operating condition is the system in?"
    OUTPUT: "P0 to P4"
  STEP_06_SET_ZTIME:
    QUESTION: "At what time horizon is the judgement valid?"
    OUTPUT: "T0 to T5"
  STEP_07_RUN_VERIWEFT:
    QUESTION: "Are the relationships structurally valid?"
    OUTPUT: "PASS, WARN, FAIL, UNKNOWN"
  STEP_08_WRITE_LEDGER:
    QUESTION: "What debt, damage, or repair is recorded?"
    OUTPUT: "Ledger status and debt types"
  STEP_09_OUTPUT_REPAIR:
    QUESTION: "What bounded action route follows?"
    OUTPUT: "Proceed, hold, audit, repair, contain, reverse, abort"
  STEP_10_SET_CONFIDENCE:
    QUESTION: "How certain is the classification?"
    OUTPUT: "LOW, MEDIUM, HIGH with uncertainty notes"

REPAIR_OUTPUT_TYPES:
  PROCEED:
    MEANING: "Route is admissible and aligned with invariants."
  HOLD:
    MEANING: "Do not act yet; insufficient evidence or unstable relation."
  PROBE:
    MEANING: "Gather more information before classification."
  AUDIT:
    MEANING: "Run independent evidence, source, or institutional check."
  REPAIR:
    MEANING: "Restore damaged invariant and reduce debt."
  CONTAIN:
    MEANING: "Limit spread of negative, inverse, or collapse-state behaviour."
  REVERSE:
    MEANING: "Undo route or remove harmful inversion."
  ABORT:
    MEANING: "Stop route because it breaches invariant or burns future floor."

CANONICAL_LOCK:
  FULL_LOCK: >
    The Civilisation Layer Stack uses Layers as public Shells.
    Each Shell contains stable CivStack IDs for AI/LLM parsing.
    The Lattice is not another layer; it is the state-space and corridor
    geometry that overlays every Shell and ID.
    VeriWeft validates whether movement across the lattice is structurally
    admissible.
    The Ledger records drift, debt, invariant damage, uncertainty, and repair.
    Repair is the bounded output path.
  SHORT_LOCK: >
    Layer = Shell.
    ID = Address.
    Lattice = State and Route.
    Zoom = Scale.
    Ztime = Time Horizon.
    VeriWeft = Validity.
    Ledger = Memory.
    Repair = Output.
  MORIARTY_LOCK: >
    No Layer without ID.
    No Lattice without evidence.
    No scale jump without bridge.
    No repair without invariant.
    No confidence without uncertainty.
    No civilisation claim without time, zoom, and ledger.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.002"
  NEXT_ARTICLE_TITLE: "Layer, Shell, ID Rule"
  NEXT_ARTICLE_FUNCTION: >
    Define the precise relationship between public Layers, Shell containers,
    machine IDs, domain registries, and anti-dilution rules.
  NEXT_ARTICLE_OUTPUTS:
    - "Layer/Shell/ID definitions"
    - "Public vs AI rendering rules"
    - "Shell containment logic"
    - "ID naming grammar"
    - "Anti-confusion rules"
    - "Machine-readable schema"

ARTICLE:
  PUBLIC_TITLE: "Layer, Shell, ID Rule"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.002"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.002"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define the strict relationship between public Layers, broad Shells,
    machine-readable IDs, domain registries, and anti-dilution rules for
    AI/LLM civilisation reasoning.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, machine-readable ontology control"

CORE_LOCK:
  ONE_SENTENCE: >
    In the Civilisation Layer Stack, a Layer is a public-facing Shell, a Shell
    is a broad civilisation operating container, and an ID is the exact
    machine-readable address of a subsystem inside that Shell.
  SHORT_FORM:
    - "Layer = public label."
    - "Shell = broad container."
    - "ID = exact machine address."
    - "Domain ID = subsystem locator."
    - "Lattice = state and route overlay."
    - "Layer number must not carry exact AI meaning."
  HARD_RULE: >
    Never force the public Layer number to do the work of the machine ID.
    Layer protects human readability.
    ID protects AI precision.

WHY_THIS_RULE_EXISTS:
  PROBLEM:
    DESCRIPTION: >
      If Layer 0, Layer 1, Layer 2, and Layer 3 are used as both public
      teaching labels and exact AI categories, the public meaning becomes
      diluted and the machine meaning becomes imprecise.
    FAILURE_EXAMPLES:
      - "Layer 2 means governance."
      - "Layer 2 means economy."
      - "Layer 2 means security."
      - "Layer 2 means logistics."
      - "Layer 2 means coordination."
      - "Layer 2 means all order systems."
    MORIARTY_ATTACK: >
      If Layer means everything inside the shell, then Layer stops being a
      useful exact category.
  SOLUTION:
    DESCRIPTION: >
      Keep Layer as the broad public shell.
      Put exact machine meaning into IDs.
      Allow multiple Domain IDs to live inside one Shell.
      Use Lattice to describe the state, route, drift, repair, or inversion
      of a domain object.
    RESULT: >
      Human readers get clean public structure.
      AI systems get precise ontology coordinates.

DEFINITION_TABLE:
  LAYER:
    TYPE: "Public-facing shell label"
    AUDIENCE: "Human readers, students, parents, public articles"
    FUNCTION: "Simplify the civilisation stack into readable broad levels"
    EXAMPLE: "Layer 2"
    DOES:
      - "Names a broad public civilisation shell"
      - "Helps humans understand the big picture"
      - "Keeps article structure readable"
    DOES_NOT:
      - "Identify exact subsystem"
      - "Carry moral judgement"
      - "Define state, risk, or route"
      - "Replace machine ID"
      - "Replace Lattice"
  SHELL:
    TYPE: "Broad operating container"
    AUDIENCE: "Human + AI bridge"
    FUNCTION: "Container that groups related civilisation systems"
    EXAMPLE: "Coordination Shell"
    DOES:
      - "Groups related domains"
      - "Connects public Layer to AI IDs"
      - "Provides ontology container"
    DOES_NOT:
      - "Replace domain ID"
      - "Specify exact failure mode"
      - "Specify exact Lattice state"
  SHELL_ID:
    TYPE: "Machine-readable shell address"
    AUDIENCE: "AI/LLM systems"
    FUNCTION: "Stable address for the broad container"
    EXAMPLE: "CIV.L2.SHELL.ORDER"
    DOES:
      - "Gives AI stable shell location"
      - "Preserves public-to-machine crosswalk"
      - "Supports machine parsing"
    DOES_NOT:
      - "Replace domain ID"
      - "Replace evidence"
      - "Replace Lattice classification"
  DOMAIN_ID:
    TYPE: "Machine-readable subsystem address"
    AUDIENCE: "AI/LLM systems"
    FUNCTION: "Exact subsystem locator inside a Shell"
    EXAMPLE: "CIV.GOV"
    DOES:
      - "Identifies exact civilisation subsystem"
      - "Allows crosswalk, comparison, audit, and repair routing"
      - "Prevents Layer overload"
    DOES_NOT:
      - "Describe state by itself"
      - "Assign risk by itself"
      - "Determine good or bad by itself"
  LATTICE:
    TYPE: "State-space and corridor geometry"
    AUDIENCE: "AI reasoning runtime"
    FUNCTION: "Describes current state, direction, valence, drift, inversion, repair, or collapse"
    EXAMPLE: "INV.LATT"
    DOES:
      - "Classifies route behaviour"
      - "Tracks movement across time and scale"
      - "Shows whether function reinforces or damages invariants"
    DOES_NOT:
      - "Replace Layer"
      - "Replace Domain ID"
      - "Act as morality label without evidence"

PUBLIC_LAYER_TO_SHELL_RULE:
  DESCRIPTION: >
    Public Layers are Shells.
    Public articles may use Layer numbers for readability, but all AI
    extraction must map each Layer to a Shell ID.
  L0:
    PUBLIC_LAYER: "Layer 0"
    SHELL_NAME: "Base Shell"
    SHELL_ID: "CIV.L0.SHELL.BASE"
    HUMAN_MEANING: "The physical operating floor of civilisation."
    MACHINE_MEANING: "Container for base substrate, infrastructure, and environmental carrying systems."
  L1:
    PUBLIC_LAYER: "Layer 1"
    SHELL_NAME: "Life Shell"
    SHELL_ID: "CIV.L1.SHELL.LIFE"
    HUMAN_MEANING: "The biological and social survival layer."
    MACHINE_MEANING: "Container for life support, population, and biological viability systems."
  L2:
    PUBLIC_LAYER: "Layer 2"
    SHELL_NAME: "Coordination Shell"
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    HUMAN_MEANING: "The systems that organise work, law, power, movement, and security."
    MACHINE_MEANING: "Container for logistics, economy, governance, and security domains."
  L3:
    PUBLIC_LAYER: "Layer 3"
    SHELL_NAME: "Mind Shell"
    SHELL_ID: "CIV.L3.SHELL.MIND"
    HUMAN_MEANING: "The systems that carry knowledge, language, culture, meaning, and accepted reality."
    MACHINE_MEANING: "Container for knowledge, language, culture, and reality-formation domains."
  L4:
    PUBLIC_LAYER: "Layer 4 / AI Extension"
    SHELL_NAME: "Continuity Overlay"
    SHELL_ID: "CIV.L4.SHELL.CONTINUITY"
    HUMAN_MEANING: "The advanced repair and future-continuity layer."
    MACHINE_MEANING: "Container for repair, ledger, frontier, and Phase 4 excursion systems."
    VISIBILITY_RULE: >
      L4 may be shown in advanced public articles, but should be treated as
      an AI/LLM extension when preserving the simple public Layer 0-3 model.

SHELL_CONTAINMENT_RULE:
  DESCRIPTION: >
    A Shell contains multiple Domain IDs.
    A Domain ID may have primary placement inside one Shell and secondary
    relationships with other Shells.
  HARD_RULES:
    - "Every Domain ID must have one primary Shell."
    - "A Domain ID may have secondary cross-shell dependencies."
    - "A Shell may contain many Domain IDs."
    - "A Layer number must never be used as a replacement for Domain ID."
    - "A Shell ID identifies container, not exact domain."
    - "A Domain ID identifies subsystem, not current state."
    - "A Lattice state identifies route condition, not subsystem identity."
  EXAMPLE:
    PUBLIC_STATEMENT: "This is a Layer 2 problem."
    INSUFFICIENT_FOR_AI: true
    REQUIRED_AI_EXPANSION:
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_PRIMARY: "CIV.GOV"
      DOMAIN_SECONDARY:
        - "CIV.SEC"
        - "CIV.REP"
      LATTICE_STATE: "DRIFT.LATT or INV.LATT depending on evidence"

DOMAIN_PLACEMENT_REGISTRY:
  CIV.L0.SHELL.BASE:
    SHELL_NAME: "Base Shell"
    PRIMARY_DOMAINS:
      CIV.BAS:
        NAME: "Base Substrate"
        FUNCTION: "Land, water, soil, minerals, geography, climate, materials."
      CIV.INF:
        NAME: "Infrastructure Base"
        FUNCTION: "Roads, power grids, ports, shelters, digital base infrastructure."
      CIV.ENV:
        NAME: "Ecological and Environmental Carrying System"
        FUNCTION: "Ecology, biodiversity, climate capacity, environmental floor."
  CIV.L1.SHELL.LIFE:
    SHELL_NAME: "Life Shell"
    PRIMARY_DOMAINS:
      CIV.LIF:
        NAME: "Life Support Systems"
        FUNCTION: "Food, health, housing, sanitation, survival support."
      CIV.POP:
        NAME: "Population and Generational Carrier"
        FUNCTION: "Families, children, demography, migration, ageing, role distribution."
      CIV.BIO:
        NAME: "Biological Viability"
        FUNCTION: "Disease control, fertility, mortality, public health, resilience."
  CIV.L2.SHELL.ORDER:
    SHELL_NAME: "Coordination Shell"
    PRIMARY_DOMAINS:
      CIV.LOG:
        NAME: "Logistics and Movement"
        FUNCTION: "Transport, supply chains, routing, storage, delivery, emergency movement."
      CIV.ECO:
        NAME: "Economy and Production"
        FUNCTION: "Work, money, markets, trade, production, distribution."
      CIV.GOV:
        NAME: "Governance and Law"
        FUNCTION: "Institutions, rules, courts, legitimacy, bounded power."
      CIV.SEC:
        NAME: "Security and Boundary Protection"
        FUNCTION: "Defence, policing, borders, safety, intelligence, cyber protection."
  CIV.L3.SHELL.MIND:
    SHELL_NAME: "Mind Shell"
    PRIMARY_DOMAINS:
      CIV.KNO:
        NAME: "Knowledge and Education"
        FUNCTION: "Schools, science, skills, research, training, knowledge transfer."
      CIV.LNG:
        NAME: "Language and Vocabulary"
        FUNCTION: "Words, grammar, symbolic systems, meaning packets, signal resolution."
      CIV.CUL:
        NAME: "Culture, Meaning, and Identity"
        FUNCTION: "Memory, ritual, art, values, belonging, civilisation DNA."
      CIV.REA:
        NAME: "Reality and Signal Formation"
        FUNCTION: "News, media, archives, source calibration, accepted public reality."
  CIV.L4.SHELL.CONTINUITY:
    SHELL_NAME: "Continuity Overlay"
    PRIMARY_DOMAINS:
      CIV.REP:
        NAME: "Repair and Trust"
        FUNCTION: "Audit, correction, accountability, institutional repair, trust restoration."
      CIV.LED:
        NAME: "Ledger of Invariants"
        FUNCTION: "Records damage, drift, debt, repair, unresolved cost, evidence."
      CIV.FRO:
        NAME: "Frontier and Future"
        FUNCTION: "Future corridors, children, climate adaptation, space, long-term survival."
      CIV.P4:
        NAME: "Phase 4 Excursion Capacity"
        FUNCTION: "Advanced frontier movement beyond stable base while paying P3 rent."

ID_NAMING_GRAMMAR:
  DESCRIPTION: >
    Machine IDs must be compact, stable, readable, and expandable.
    IDs should not include temporary diagnosis, risk, confidence, or Lattice state.
    They should identify architecture location only.
  SHELL_ID_FORMAT:
    PATTERN: "CIV.L{NUMBER}.SHELL.{SHELL_NAME}"
    EXAMPLES:
      - "CIV.L0.SHELL.BASE"
      - "CIV.L1.SHELL.LIFE"
      - "CIV.L2.SHELL.ORDER"
      - "CIV.L3.SHELL.MIND"
      - "CIV.L4.SHELL.CONTINUITY"
  DOMAIN_ID_FORMAT:
    PATTERN: "CIV.{DOMAIN_CODE}"
    EXAMPLES:
      - "CIV.BAS"
      - "CIV.INF"
      - "CIV.ENV"
      - "CIV.LIF"
      - "CIV.POP"
      - "CIV.BIO"
      - "CIV.LOG"
      - "CIV.ECO"
      - "CIV.GOV"
      - "CIV.SEC"
      - "CIV.KNO"
      - "CIV.LNG"
      - "CIV.CUL"
      - "CIV.REA"
      - "CIV.REP"
      - "CIV.LED"
      - "CIV.FRO"
      - "CIV.P4"
  FULL_ADDRESS_FORMAT:
    PATTERN: "SHELL_ID::DOMAIN_ID"
    EXAMPLES:
      - "CIV.L0.SHELL.BASE::CIV.BAS"
      - "CIV.L2.SHELL.ORDER::CIV.GOV"
      - "CIV.L3.SHELL.MIND::CIV.CUL"
      - "CIV.L4.SHELL.CONTINUITY::CIV.REP"
  EXTENDED_COORDINATE_FORMAT:
    PATTERN: "SHELL_ID::DOMAIN_ID::LATTICE_STATE::ZOOM::PHASE::ZTIME"
    EXAMPLES:
      - "CIV.L2.SHELL.ORDER::CIV.GOV::INV.LATT::Z4::P2::T2"
      - "CIV.L3.SHELL.MIND::CIV.REA::DRIFT.LATT::Z4::P2::T1"
      - "CIV.L1.SHELL.LIFE::CIV.LIF::-LATT::Z3::P1::T0"

ID_STABILITY_RULES:
  DESCRIPTION: >
    IDs must remain stable across articles, prompts, versions, and AI outputs.
    Diagnostic states may change, but IDs should not change unless the ontology
    itself is deliberately versioned.
  RULES:
    - "Do not rename Domain IDs casually."
    - "Do not put temporary state into Domain ID."
    - "Do not create duplicate IDs for the same function."
    - "Do not split a Domain ID unless the function has become too broad."
    - "Do not merge Domain IDs if the merge reduces diagnostic clarity."
    - "Do not use public article title as machine ID."
    - "Do not make IDs depend on current event, country, person, or ideology."
    - "Do not encode moral judgement inside ID."
    - "Encode state through Lattice, not through ID."
    - "Encode risk through Risk field, not through ID."
    - "Encode confidence through Confidence field, not through ID."

PUBLIC_RENDERING_RULE:
  DESCRIPTION: >
    Public articles should show simple shell language before machine notation.
    AI code should appear as a supporting manifest, not as the main civilian explanation.
  HUMAN_FIRST_EXAMPLE:
    HUMAN_SENTENCE: >
      Layer 2 is the Coordination Shell of civilisation. It contains the systems
      that help people organise work, law, movement, security, and public order.
    MACHINE_MANIFEST:
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAINS:
        - "CIV.LOG"
        - "CIV.ECO"
        - "CIV.GOV"
        - "CIV.SEC"
  WRONG_PUBLIC_RENDERING:
    TEXT: >
      CIV.L2.SHELL.ORDER::CIV.GOV::DRIFT.LATT::Z4::P2::T2 is the main problem.
    WHY_WRONG: >
      This overwhelms civilian readers and hides the public meaning.
  CORRECT_PUBLIC_RENDERING:
    TEXT: >
      This is a Layer 2 Coordination Shell problem. In machine terms, it mainly
      concerns governance and law, with possible drift in trust and accountability.
    WHY_RIGHT: >
      It keeps the public shell clear while preserving AI-readable precision.

AI_RENDERING_RULE:
  DESCRIPTION: >
    AI/LLM outputs should always expand public layer claims into shell ID,
    domain ID, and state fields.
  MINIMUM_AI_RECORD:
    PUBLIC_LAYER: null
    PUBLIC_SHELL: null
    SHELL_ID: null
    DOMAIN_PRIMARY: null
    DOMAIN_SECONDARY: []
    LATTICE_STATE: null
    ZOOM: null
    PHASE: null
    ZTIME: null
    CONFIDENCE: null
  EXAMPLE:
    PUBLIC_LAYER: "Layer 2"
    PUBLIC_SHELL: "Coordination Shell"
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    DOMAIN_SECONDARY:
      - "CIV.REP"
      - "CIV.REA"
    LATTICE_STATE: "DRIFT.LATT"
    ZOOM: "Z4.NATIONAL"
    PHASE: "P2.STRESSED"
    ZTIME: "T2.MID_TERM"
    CONFIDENCE: "MEDIUM"

LAYER_SHELL_ID_DECISION_TREE:
  STEP_01:
    QUESTION: "What broad public shell does the issue belong to?"
    OUTPUT: "Layer 0, Layer 1, Layer 2, Layer 3, or Layer 4 extension"
  STEP_02:
    QUESTION: "What is the Shell ID?"
    OUTPUT: "CIV.L0.SHELL.BASE, CIV.L1.SHELL.LIFE, CIV.L2.SHELL.ORDER, CIV.L3.SHELL.MIND, or CIV.L4.SHELL.CONTINUITY"
  STEP_03:
    QUESTION: "Which exact Domain ID is primary?"
    OUTPUT: "CIV.BAS, CIV.GOV, CIV.CUL, etc."
  STEP_04:
    QUESTION: "Which secondary domains are materially involved?"
    OUTPUT: "Related Domain IDs"
  STEP_05:
    QUESTION: "Is the issue a location problem, state problem, scale problem, time problem, or repair problem?"
    OUTPUT:
      LOCATION_PROBLEM: "Check Shell and Domain ID."
      STATE_PROBLEM: "Check Lattice."
      SCALE_PROBLEM: "Check Zoom."
      TIME_PROBLEM: "Check Ztime."
      REPAIR_PROBLEM: "Check Ledger and Repair Runtime."
  STEP_06:
    QUESTION: "Is the public Layer being overloaded?"
    OUTPUT:
      IF_YES: "Move precision into ID and Lattice."
      IF_NO: "Proceed."

ANTI_CONFUSION_RULES:
  LAYER_CONFUSION:
    WRONG: "Layer 2 is governance."
    CORRECT: "Layer 2 is the Coordination Shell; CIV.GOV is governance."
  SHELL_CONFUSION:
    WRONG: "Coordination Shell is always positive."
    CORRECT: "Coordination Shell is a container; Lattice determines state."
  ID_CONFUSION:
    WRONG: "CIV.GOV means corrupt government."
    CORRECT: "CIV.GOV means governance and law; corruption is a possible Lattice or Ledger condition."
  LATTICE_CONFUSION:
    WRONG: "INV.LATT means the domain itself is evil."
    CORRECT: "INV.LATT means the domain function is currently operating opposite to its intended invariant."
  SCALE_CONFUSION:
    WRONG: "One bad school means civilisation is collapsing."
    CORRECT: "A Z2 school signal requires bridge evidence before Z4-Z6 claims."
  TIME_CONFUSION:
    WRONG: "Short-term stability means long-term health."
    CORRECT: "Every classification requires Ztime horizon."
  REPAIR_CONFUSION:
    WRONG: "Repair means making the system match preference."
    CORRECT: "Repair means restoring invariant function and reducing ledger debt."
  CONFIDENCE_CONFUSION:
    WRONG: "A neat coordinate means the classification is certain."
    CORRECT: "Coordinate structure does not replace evidence or uncertainty."

SHELL_TO_DOMAIN_CROSSWALK_TABLE:
  ROWS:
    - PUBLIC_LAYER: "Layer 0"
      PUBLIC_SHELL: "Base Shell"
      SHELL_ID: "CIV.L0.SHELL.BASE"
      DOMAIN_IDS: ["CIV.BAS", "CIV.INF", "CIV.ENV"]
      HUMAN_QUESTION: "Can civilisation physically exist here?"
    - PUBLIC_LAYER: "Layer 1"
      PUBLIC_SHELL: "Life Shell"
      SHELL_ID: "CIV.L1.SHELL.LIFE"
      DOMAIN_IDS: ["CIV.LIF", "CIV.POP", "CIV.BIO"]
      HUMAN_QUESTION: "Can people survive and continue?"
    - PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL: "Coordination Shell"
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_IDS: ["CIV.LOG", "CIV.ECO", "CIV.GOV", "CIV.SEC"]
      HUMAN_QUESTION: "Can civilisation coordinate without breaking itself?"
    - PUBLIC_LAYER: "Layer 3"
      PUBLIC_SHELL: "Mind Shell"
      SHELL_ID: "CIV.L3.SHELL.MIND"
      DOMAIN_IDS: ["CIV.KNO", "CIV.LNG", "CIV.CUL", "CIV.REA"]
      HUMAN_QUESTION: "Can civilisation know, remember, interpret, and mean correctly?"
    - PUBLIC_LAYER: "Layer 4 / AI Extension"
      PUBLIC_SHELL: "Continuity Overlay"
      SHELL_ID: "CIV.L4.SHELL.CONTINUITY"
      DOMAIN_IDS: ["CIV.REP", "CIV.LED", "CIV.FRO", "CIV.P4"]
      HUMAN_QUESTION: "Can civilisation repair drift and continue into the future?"

EXAMPLE_01_WATER_SYSTEM:
  HUMAN_DESCRIPTION: "A city faces water shortage and infrastructure leakage."
  LAYER_SHELL_ID_CLASSIFICATION:
    PUBLIC_LAYER: "Layer 0"
    PUBLIC_SHELL: "Base Shell"
    SHELL_ID: "CIV.L0.SHELL.BASE"
    DOMAIN_PRIMARY: "CIV.BAS"
    DOMAIN_SECONDARY:
      - "CIV.INF"
      - "CIV.LIF"
  WHY:
    - "Water is part of base substrate."
    - "Leakage concerns infrastructure base."
    - "Human survival consequence links to Life Shell."
  NOT_THIS:
    - "Do not classify only as Layer 1 because people are affected."
    - "Primary domain remains base water substrate unless the main issue is health delivery."
  POSSIBLE_COORDINATE:
    COMPACT: "CIV.L0.SHELL.BASE::CIV.BAS::-LATT::Z3::P2::T1"

EXAMPLE_02_SCHOOL_MATH_FAILURE:
  HUMAN_DESCRIPTION: "A student cannot handle algebra and begins losing future subject options."
  LAYER_SHELL_ID_CLASSIFICATION:
    PUBLIC_LAYER: "Layer 3"
    PUBLIC_SHELL: "Mind Shell"
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.KNO"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.POP"
  WHY:
    - "Mathematics learning is knowledge and education."
    - "Algebra also depends on symbolic language."
    - "Future pathway narrowing affects population role differentiation."
  NOT_THIS:
    - "Do not classify as only individual weakness."
    - "Do not scale to civilisation failure without bridge signals."
  POSSIBLE_COORDINATE:
    COMPACT: "CIV.L3.SHELL.MIND::CIV.KNO::-LATT::Z0::P2::T2"

EXAMPLE_03_NEWS_REALITY_DRIFT:
  HUMAN_DESCRIPTION: "A society receives distorted information and forms wrong public reality."
  LAYER_SHELL_ID_CLASSIFICATION:
    PUBLIC_LAYER: "Layer 3"
    PUBLIC_SHELL: "Mind Shell"
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.REA"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.GOV"
      - "CIV.REP"
  WHY:
    - "Accepted reality belongs to Reality and Signal Formation."
    - "Language frames meaning."
    - "Governance may be affected by wrong public reality."
    - "Repair requires audit and ledger correction."
  NOT_THIS:
    - "Do not classify every disagreement as reality drift."
    - "Evidence gate must test source, claim type, and counter-signals."
  POSSIBLE_COORDINATE:
    COMPACT: "CIV.L3.SHELL.MIND::CIV.REA::DRIFT.LATT::Z4::P2::T1"

EXAMPLE_04_GOVERNANCE_CORRUPTION:
  HUMAN_DESCRIPTION: "A legal system is used to protect institutional corruption."
  LAYER_SHELL_ID_CLASSIFICATION:
    PUBLIC_LAYER: "Layer 2"
    PUBLIC_SHELL: "Coordination Shell"
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    DOMAIN_SECONDARY:
      - "CIV.REP"
      - "CIV.REA"
      - "CIV.SEC"
  WHY:
    - "Law and governance belong to Coordination Shell."
    - "Trust repair and accountability belong to Continuity Overlay."
    - "Public truth formation may be affected."
    - "Security may enforce the corrupted order."
  NOT_THIS:
    - "Do not call it inverse without evidence."
    - "Do not call it national-scale without scale bridge."
    - "Do not call it cockpit capture unless control layer itself is captured."
  POSSIBLE_COORDINATE:
    COMPACT: "CIV.L2.SHELL.ORDER::CIV.GOV::INV.LATT::Z4::P2::T2"

EXAMPLE_05_CULTURE_LOSS:
  HUMAN_DESCRIPTION: "A community loses language, rituals, and ancestral memory over generations."
  LAYER_SHELL_ID_CLASSIFICATION:
    PUBLIC_LAYER: "Layer 3"
    PUBLIC_SHELL: "Mind Shell"
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.CUL"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.KNO"
      - "CIV.LED"
  WHY:
    - "Culture and memory belong to Mind Shell."
    - "Language is a linked domain."
    - "Education transfers the memory."
    - "Ledger records loss and repair."
  NOT_THIS:
    - "Do not treat change as loss automatically."
    - "Do not treat preservation as fossilisation."
    - "Check whether living culture is transforming, drifting, or being erased."
  POSSIBLE_COORDINATE:
    COMPACT: "CIV.L3.SHELL.MIND::CIV.CUL::DRIFT.LATT::Z3::P2::T4"

LAYER_ID_VALIDATION_GATE:
  DESCRIPTION: >
    Before any AI/LLM output is accepted, the Layer-Shell-ID mapping must pass
    validation.
  VALIDATION_TESTS:
    HAS_PUBLIC_LAYER:
      QUESTION: "Is there a public Layer label?"
      PASS_CONDITION: "L0, L1, L2, L3, or L4 extension present."
    HAS_SHELL_NAME:
      QUESTION: "Is the Shell named in human-readable form?"
      PASS_CONDITION: "Base, Life, Coordination, Mind, or Continuity."
    HAS_SHELL_ID:
      QUESTION: "Is there a valid machine Shell ID?"
      PASS_CONDITION: "ID follows CIV.L{number}.SHELL.{name}."
    HAS_DOMAIN_ID:
      QUESTION: "Is there an exact primary Domain ID?"
      PASS_CONDITION: "Primary domain exists in registry."
    DOMAIN_BELONGS_TO_SHELL:
      QUESTION: "Does the Domain ID belong to the selected Shell?"
      PASS_CONDITION: "Domain has primary or declared secondary relation to Shell."
    STATE_NOT_ENCODED_AS_ID:
      QUESTION: "Is Lattice state kept separate from ID?"
      PASS_CONDITION: "No risk, morality, or temporary condition inside ID."
    PUBLIC_NOT_OVERLOADED:
      QUESTION: "Is public Layer number being used too precisely?"
      PASS_CONDITION: "Exact meaning appears in Domain ID, not Layer."
    SCALE_NOT_ASSUMED:
      QUESTION: "Is Zoom specified separately?"
      PASS_CONDITION: "Zoom field present where scale matters."
    TIME_NOT_OMITTED:
      QUESTION: "Is Ztime specified separately?"
      PASS_CONDITION: "Time horizon present where classification changes over time."
  VALIDATION_OUTPUTS:
    PASS: "Layer-Shell-ID mapping is valid."
    WARN: "Mapping is usable but needs clarification."
    FAIL: "Mapping is ontologically confused."

VERSION_CONTROL_POLICY:
  DESCRIPTION: >
    The Layer-Shell-ID system must support future expansion without breaking
    public readability or AI stability.
  VERSION_RULES:
    CURRENT_VERSION: "CIVSTACK.RA.AI.v1"
    BREAKING_CHANGE:
      DEFINITION: "Change that renames IDs, moves primary domains, or changes Shell structure."
      REQUIREMENT: "Must increment architecture version."
    NON_BREAKING_CHANGE:
      DEFINITION: "Add secondary crosswalks, examples, notes, or evidence fields."
      REQUIREMENT: "May remain in same version with revision marker."
  ID_CHANGE_RULE:
    ALLOWED_WHEN:
      - "Existing ID creates persistent ambiguity."
      - "Domain function has become too broad."
      - "New domain is materially distinct."
      - "Moriarty hardening finds structural collision."
    NOT_ALLOWED_WHEN:
      - "Name preference changes."
      - "Current event makes a domain look temporarily important."
      - "Public article title changes."
      - "Moral framing changes."
      - "Trend language shifts."
  DEPRECATED_ID_POLICY:
    FORMAT:
      OLD_ID: null
      NEW_ID: null
      DEPRECATION_REASON: null
      CROSSWALK_REQUIRED: true

MORIARTY_ATTACK_AND_HARDENING:
  ATTACK_01_LAYER_OVERLOAD:
    ATTACK: >
      Layer 2 is asked to mean order, law, economy, logistics, security,
      governance, corruption, repair, and collapse.
    FAILURE: "Layer becomes too broad to be useful."
    HARDENING: >
      Layer 2 remains Coordination Shell only.
      Exact subsystem goes into Domain ID.
      Current state goes into Lattice.
  ATTACK_02_ID_MORAL_CONTAMINATION:
    ATTACK: >
      The ID system quietly encodes moral judgement.
    FAILURE: "CIV.GOV becomes treated as good or bad by default."
    HARDENING: >
      IDs are morally neutral locators.
      Lattice and Ledger evaluate function, evidence, drift, damage, and repair.
  ATTACK_03_PUBLIC_TECHNICAL_OVERLOAD:
    ATTACK: >
      The public article becomes machine-code unreadable to humans.
    FAILURE: "Civilian adoption collapses."
    HARDENING: >
      Public gets Shell language first.
      AI gets machine manifest below.
  ATTACK_04_MACHINE_IMPRECISION:
    ATTACK: >
      AI only sees public layer labels and cannot identify exact subsystem.
    FAILURE: "LLM produces vague analysis."
    HARDENING: >
      Require Shell ID and Domain ID in every AI record.
  ATTACK_05_CROSS_SHELL_CONFUSION:
    ATTACK: >
      A water-health issue is classified inconsistently as base, life, or governance.
    FAILURE: "AI loses stable placement."
    HARDENING: >
      Require primary domain plus secondary domains.
      Primary domain follows main functional failure.
      Secondary domains record consequences and dependencies.
  ATTACK_06_FALSE_EQUIVALENCE:
    ATTACK: >
      Every domain inside a shell is treated as equally involved.
    FAILURE: "AI cannot identify main repair route."
    HARDENING: >
      Use DOMAIN_PRIMARY and DOMAIN_SECONDARY fields.
  ATTACK_07_STATE_ID_COLLAPSE:
    ATTACK: >
      AI creates IDs like CIV.BAD.GOV or CIV.COLLAPSE.CULTURE.
    FAILURE: "Permanent identity replaces temporary state."
    HARDENING: >
      No state inside ID.
      Use CIV.GOV::INV.LATT or CIV.CUL::DRIFT.LATT instead.

CANONICAL_MACHINE_SCHEMA:
  LAYER_SHELL_ID_RECORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    PUBLIC:
      PUBLIC_LAYER: null
      PUBLIC_SHELL_NAME: null
      HUMAN_DESCRIPTION: null
    SHELL:
      SHELL_ID: null
      SHELL_FUNCTION: null
    DOMAIN:
      DOMAIN_PRIMARY: null
      DOMAIN_PRIMARY_FUNCTION: null
      DOMAIN_SECONDARY: []
      DOMAIN_SECONDARY_FUNCTIONS: {}
    RELATIONSHIP:
      PRIMARY_REASON: null
      SECONDARY_REASON: []
      CROSS_SHELL_DEPENDENCIES: []
    STATE_PLACEHOLDER:
      LATTICE_STATE: null
      NOTE: "Lattice belongs here only as state overlay, not as ID."
    SCALE_PLACEHOLDER:
      ZOOM: null
      NOTE: "Zoom belongs here only as scale field, not as ID."
    TIME_PLACEHOLDER:
      ZTIME: null
      NOTE: "Ztime belongs here only as time horizon, not as ID."
    VALIDATION:
      DOMAIN_BELONGS_TO_SHELL: null
      ID_STABLE: null
      PUBLIC_LAYER_NOT_OVERLOADED: null
      STATE_SEPARATED_FROM_ID: null
      RESULT: null
    CONFIDENCE:
      LEVEL: null
      REASON: null

CANONICAL_EXAMPLES:
  EXAMPLE_VALID:
    HUMAN: "This is a Layer 2 Coordination Shell problem involving governance."
    MACHINE:
      PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL_NAME: "Coordination Shell"
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_PRIMARY: "CIV.GOV"
    VALIDATION: "PASS"
  EXAMPLE_INVALID_LAYER_AS_DOMAIN:
    HUMAN: "Layer 2 is governance."
    MACHINE:
      PUBLIC_LAYER: "Layer 2"
      DOMAIN_PRIMARY: null
    VALIDATION: "FAIL"
    REASON: "Layer is shell, not domain."
  EXAMPLE_INVALID_STATE_AS_ID:
    HUMAN: "This is CIV.CORRUPT.GOV."
    MACHINE:
      DOMAIN_PRIMARY: "CIV.CORRUPT.GOV"
    VALIDATION: "FAIL"
    REASON: "Corruption is state/route/evidence classification, not domain ID."
  EXAMPLE_CORRECT_STATE_SEPARATION:
    HUMAN: "Governance is showing possible inverse-lattice behaviour."
    MACHINE:
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_PRIMARY: "CIV.GOV"
      LATTICE_STATE: "INV.LATT"
    VALIDATION: "PASS"

FINAL_LOCK:
  FULL_LOCK: >
    The Civilisation Layer Stack remains public-readable by treating Layers
    as broad Shells. Each Shell has a stable Shell ID. Each subsystem inside
    the Shell has a stable Domain ID. The ID locates the civilisation object;
    it does not judge the object. Lattice classifies state and route. Zoom
    classifies scale. Ztime classifies time horizon. VeriWeft validates
    relationship integrity. Ledger records debt, drift, damage, and repair.
  SHORT_LOCK: >
    Layer is Shell.
    Shell is Container.
    ID is Address.
    Domain is Subsystem.
    Lattice is State.
    Zoom is Scale.
    Ztime is Horizon.
    VeriWeft is Validity.
    Ledger is Memory.
    Repair is Output.
  MORIARTY_LOCK: >
    Do not make public Layers carry exact machine meaning.
    Do not make IDs carry moral judgement.
    Do not make Lattice replace evidence.
    Do not make local signals become civilisation claims without scale bridge.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.003"
  NEXT_ARTICLE_TITLE: "CivCoord Coordinate Grammar"
  NEXT_ARTICLE_FUNCTION: >
    Define the full coordinate grammar for AI/LLM civilisation reasoning,
    including Shell ID, Domain ID, Lattice State, Zoom, Phase, Ztime, VeriWeft,
    Ledger, Evidence, Confidence, and Repair Output.
  NEXT_ARTICLE_OUTPUTS:
    - "Compact coordinate grammar"
    - "Full YAML coordinate schema"
    - "Mandatory and optional fields"
    - "Claim-type and source-type fields"
    - "Validation tests"
    - "Examples of valid and invalid coordinates"

ARTICLE:
  PUBLIC_TITLE: "CivCoord Coordinate Grammar"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.003"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.003"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define the full CivCoord coordinate grammar for AI/LLM civilisation
    reasoning, including Shell ID, Domain ID, Lattice State, Zoom, Phase,
    Ztime, VeriWeft, Ledger, Evidence, Confidence, and Repair Output.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, coordinate-based civilisation reasoning"

CORE_DEFINITION:
  CIVCOORD:
    FULL_NAME: "Civilisation Coordinate"
    MACHINE_NAME: "CIVCOORD"
    FUNCTION: >
      A CivCoord is a machine-readable coordinate that locates a civilisation
      object inside the Civilisation Layer Stack, identifies its exact domain,
      describes its Lattice state, fixes its scale and time horizon, validates
      the relationship through VeriWeft, records debt through Ledger, and
      outputs a bounded repair or routing action.
  ONE_SENTENCE: >
    CivCoord converts civilisation reasoning from vague description into
    addressable, auditable, state-aware machine grammar.
  SHORT_FORMULA: >
    SHELL_ID + DOMAIN_ID + LATTICE_STATE + ZOOM + PHASE + ZTIME
    + VERIWEFT + LEDGER + EVIDENCE + CONFIDENCE + REPAIR_OUTPUT
  COMPRESSED_CHAIN: >
    Shell -> Domain -> State -> Scale -> Phase -> Time -> Validity -> Memory -> Evidence -> Confidence -> Repair

WHY_CIVCOORD_EXISTS:
  PROBLEM:
    DESCRIPTION: >
      AI systems can describe civilisation problems in fluent prose but fail
      to locate them precisely, confuse scale, omit time horizon, overclaim
      confidence, or classify moral appearance instead of functional state.
    COMMON_FAILURES:
      - "Calling a local problem a civilisation problem without scale bridge."
      - "Calling a public layer an exact domain."
      - "Calling a domain positive or negative without Lattice evidence."
      - "Calling a system stable while hidden Ledger debt accumulates."
      - "Calling an emergency action positive without return-to-floor test."
      - "Calling repair successful without checking invariant restoration."
      - "Making governance, culture, education, and reality drift sound similar."
      - "Producing confident answers without evidence fields."
  SOLUTION:
    DESCRIPTION: >
      CivCoord forces AI to place every civilisation claim inside a structured
      coordinate. This improves parsing, auditability, comparison, repair
      routing, and Moriarty hardening.
  RESULT:
    - "Layer numbers stay public-readable."
    - "Shell IDs provide broad machine location."
    - "Domain IDs provide exact subsystem location."
    - "Lattice states describe function and route."
    - "Zoom prevents scale-jump errors."
    - "Phase describes operating condition."
    - "Ztime prevents time-slice distortion."
    - "VeriWeft tests structural validity."
    - "Ledger records debt, drift, and repair."
    - "Evidence prevents hallucinated certainty."
    - "Confidence records uncertainty."
    - "Repair output gives bounded next action."

CIVCOORD_COMPACT_FORMAT:
  NAME: "Compact CivCoord"
  PURPOSE: "Short machine-readable coordinate for AI indexing and extraction."
  PATTERN: >
    SHELL_ID::DOMAIN_ID::LATTICE_STATE::ZOOM::PHASE::ZTIME::RISK::CONFIDENCE
  REQUIRED_SEGMENTS:
    - "SHELL_ID"
    - "DOMAIN_ID"
    - "LATTICE_STATE"
    - "ZOOM"
    - "PHASE"
    - "ZTIME"
    - "RISK"
    - "CONFIDENCE"
  EXAMPLE_01:
    COORDINATE: "CIV.L2.SHELL.ORDER::CIV.GOV::INV.LATT::Z4::P2::T2::RISK.HIGH::CONF.MEDIUM"
    HUMAN_READING: >
      Governance inside the Coordination Shell is showing possible inverse
      lattice behaviour at national scale, stressed phase, mid-term horizon,
      high risk, medium confidence.
  EXAMPLE_02:
    COORDINATE: "CIV.L3.SHELL.MIND::CIV.KNO::-LATT::Z0::P2::T2::RISK.MEDIUM::CONF.MEDIUM"
    HUMAN_READING: >
      Knowledge and education inside the Mind Shell are in a negative or
      constricting state for one individual, stressed phase, mid-term horizon,
      medium risk, medium confidence.
  EXAMPLE_03:
    COORDINATE: "CIV.L0.SHELL.BASE::CIV.ENV::DRIFT.LATT::Z7::P2::T4::RISK.HIGH::CONF.MEDIUM"
    HUMAN_READING: >
      Environmental carrying systems inside the Base Shell show drift at
      planetary scale over intergenerational time, high risk, medium confidence.

CIVCOORD_FULL_FORMAT:
  NAME: "Full CivCoord Manifest"
  PURPOSE: >
    Full YAML machine record for AI/LLM parsing, audit, comparison,
    classification, and repair routing.
  REQUIRED_TOP_LEVEL_FIELDS:
    - "VERSION"
    - "CIV_OBJECT"
    - "HUMAN_LAYER"
    - "MACHINE_ADDRESS"
    - "LATTICE"
    - "SCALE"
    - "PHASE"
    - "TIME"
    - "VERIWEFT"
    - "LEDGER"
    - "EVIDENCE"
    - "CONFIDENCE"
    - "REPAIR"
    - "ANTI_HALLUCINATION"
  OPTIONAL_TOP_LEVEL_FIELDS:
    - "CROSSWALKS"
    - "DEPENDENCIES"
    - "COUNTERFACTUALS"
    - "VERSION_HISTORY"
    - "MORIARTY_ATTACK"
    - "PUBLIC_RENDERING"
    - "AI_RENDERING"

MASTER_CIVCOORD_SCHEMA:
  CIVCOORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    CIV_OBJECT:
      OBJECT_NAME: null
      OBJECT_TYPE: null
      HUMAN_DESCRIPTION: null
      CLAIM_BEING_CLASSIFIED: null
    HUMAN_LAYER:
      PUBLIC_LAYER: null
      PUBLIC_SHELL: null
      HUMAN_FUNCTION: null
    MACHINE_ADDRESS:
      SHELL_ID: null
      DOMAIN_PRIMARY: null
      DOMAIN_SECONDARY: []
      DOMAIN_PRIMARY_REASON: null
      DOMAIN_SECONDARY_REASONS: {}
    LATTICE:
      STATE: null
      VALENCE: null
      ROUTE: null
      ROUTE_DESCRIPTION: null
      PRIOR_STATE: null
      POSSIBLE_NEXT_STATE: null
    SCALE:
      ZOOM_PRIMARY: null
      ZOOM_SECONDARY: []
      SCALE_BRIDGE_SIGNALS: []
      SCALE_LIMITS: []
    PHASE:
      CURRENT_PHASE: null
      PHASE_REASON: null
      RISK_NEXT_PHASE: null
      FAILURE_THRESHOLD: null
    TIME:
      ZTIME_PRIMARY: null
      ZTIME_SECONDARY: []
      TIME_HORIZON_REASON: null
      SHORT_TERM_EFFECT: null
      MID_TERM_EFFECT: null
      LONG_TERM_EFFECT: null
      INTERGENERATIONAL_EFFECT: null
    VERIWEFT:
      STATUS: null
      TESTS_PASSED: []
      TESTS_FAILED: []
      TESTS_UNKNOWN: []
      VALIDITY_REASON: null
    LEDGER:
      STATUS: null
      DEBT_TYPES: []
      DEBT_DESCRIPTION: {}
      REPAIR_HISTORY: []
      UNRESOLVED_COSTS: []
      LEDGER_NOTE: null
    EVIDENCE:
      OBSERVED_SIGNAL: null
      SOURCE_TYPE: null
      CLAIM_TYPE: null
      EVIDENCE_STRENGTH: null
      COUNTER_SIGNAL: null
      UNCERTAINTY: null
      REVERSIBILITY: null
      REPAIR_VISIBILITY: null
    RISK:
      LEVEL: null
      RISK_REASON: null
      RISK_TO_FLOOR: null
      RISK_TO_FUTURE: null
      RISK_TO_TRUST: null
      RISK_TO_REALITY: null
    CONFIDENCE:
      LEVEL: null
      CONFIDENCE_REASON: null
      KNOWN_UNKNOWNS: []
      UNKNOWN_UNKNOWNS: []
      REQUIRED_MORE_EVIDENCE: []
    REPAIR:
      OUTPUT_TYPE: null
      REQUIRED_ACTIONS: []
      REPAIR_RATE_TEST: "RepairRate >= DriftRate"
      REPAIR_SUCCESS_CRITERIA: []
      REPAIR_FAILURE_SIGNS: []
    ANTI_HALLUCINATION:
      DO_NOT_INFER: []
      UNSAFE_SCALE_JUMPS: []
      UNSAFE_TIME_JUMPS: []
      UNSAFE_MORAL_JUMPS: []
      REQUIRED_GUARDRAILS: []

FIELD_DEFINITIONS:
  VERSION:
    FUNCTION: "Identifies the architecture version used."
    EXAMPLE: "CIVSTACK.RA.AI.v1"
    REQUIRED: true
  CIV_OBJECT:
    FUNCTION: "Identifies what object, system, claim, or signal is being classified."
    REQUIRED: true
    SUBFIELDS:
      OBJECT_NAME: "Name of object or issue."
      OBJECT_TYPE: "System, event, claim, policy, institution, culture, signal, repair route, etc."
      HUMAN_DESCRIPTION: "Plain-language description."
      CLAIM_BEING_CLASSIFIED: "Specific claim being placed into CivCoord."
  HUMAN_LAYER:
    FUNCTION: "Keeps public Layer/Shell meaning visible."
    REQUIRED: true
    SUBFIELDS:
      PUBLIC_LAYER: "Layer 0, Layer 1, Layer 2, Layer 3, or Layer 4 extension."
      PUBLIC_SHELL: "Base, Life, Coordination, Mind, or Continuity."
      HUMAN_FUNCTION: "Simple human-readable shell function."
  MACHINE_ADDRESS:
    FUNCTION: "Provides exact AI/LLM address."
    REQUIRED: true
    SUBFIELDS:
      SHELL_ID: "Machine shell address."
      DOMAIN_PRIMARY: "Exact primary subsystem ID."
      DOMAIN_SECONDARY: "Related subsystem IDs."
      DOMAIN_PRIMARY_REASON: "Reason primary domain was selected."
      DOMAIN_SECONDARY_REASONS: "Reasons secondary domains are materially involved."
  LATTICE:
    FUNCTION: "Describes state, route, drift, inversion, repair, collapse, or frontier movement."
    REQUIRED: true
    SUBFIELDS:
      STATE: "Core lattice state."
      VALENCE: "Positive, neutral, negative, inverse, drift, repair, collapse, frontier."
      ROUTE: "Named corridor or route."
      ROUTE_DESCRIPTION: "Functional explanation of movement."
      PRIOR_STATE: "Earlier observed or inferred state."
      POSSIBLE_NEXT_STATE: "Likely next state if unrepaired."
  SCALE:
    FUNCTION: "Prevents scale-jump error."
    REQUIRED: true
    SUBFIELDS:
      ZOOM_PRIMARY: "Primary zoom level from Z0 to Z8."
      ZOOM_SECONDARY: "Secondary affected zooms."
      SCALE_BRIDGE_SIGNALS: "Evidence supporting movement across scales."
      SCALE_LIMITS: "Boundaries of claim."
  PHASE:
    FUNCTION: "Describes operating condition."
    REQUIRED: true
    SUBFIELDS:
      CURRENT_PHASE: "P0 to P4."
      PHASE_REASON: "Why this phase is selected."
      RISK_NEXT_PHASE: "Possible next phase if current drift continues."
      FAILURE_THRESHOLD: "Known threshold or collapse marker."
  TIME:
    FUNCTION: "Prevents time-slice distortion."
    REQUIRED: true
    SUBFIELDS:
      ZTIME_PRIMARY: "Primary time horizon from T0 to T5."
      ZTIME_SECONDARY: "Additional relevant time horizons."
      TIME_HORIZON_REASON: "Why this horizon matters."
      SHORT_TERM_EFFECT: "Immediate or near-term effect."
      MID_TERM_EFFECT: "Medium-term effect."
      LONG_TERM_EFFECT: "Long-term effect."
      INTERGENERATIONAL_EFFECT: "Effect on future generations."
  VERIWEFT:
    FUNCTION: "Tests relationship validity."
    REQUIRED: true
    SUBFIELDS:
      STATUS: "PASS, WARN, FAIL, UNKNOWN."
      TESTS_PASSED: "Validity checks passed."
      TESTS_FAILED: "Validity checks failed."
      TESTS_UNKNOWN: "Checks that require more evidence."
      VALIDITY_REASON: "Reason for VeriWeft status."
  LEDGER:
    FUNCTION: "Records memory, debt, drift, damage, repair, and unresolved cost."
    REQUIRED: true
    SUBFIELDS:
      STATUS: "CLEAR, WATCH, ACCUMULATING, BREACHED, REPAIRING, UNKNOWN."
      DEBT_TYPES: "Trust, moral, knowledge, reality, governance, ecological, infrastructure, culture, frontier, etc."
      DEBT_DESCRIPTION: "Description of each debt."
      REPAIR_HISTORY: "Known repair attempts."
      UNRESOLVED_COSTS: "Known costs still unpaid."
      LEDGER_NOTE: "Additional memory note."
  EVIDENCE:
    FUNCTION: "Prevents hallucinated classification."
    REQUIRED: true
    SUBFIELDS:
      OBSERVED_SIGNAL: "What is actually seen or claimed."
      SOURCE_TYPE: "Where the signal comes from."
      CLAIM_TYPE: "What type of claim is being made."
      EVIDENCE_STRENGTH: "LOW, MEDIUM, HIGH, UNKNOWN."
      COUNTER_SIGNAL: "Evidence or interpretation against classification."
      UNCERTAINTY: "What remains uncertain."
      REVERSIBILITY: "Can the damage or route be reversed?"
      REPAIR_VISIBILITY: "Can repair be observed?"
  RISK:
    FUNCTION: "Shows risk type and level."
    REQUIRED: true
    SUBFIELDS:
      LEVEL: "LOW, MEDIUM, HIGH, CRITICAL, UNKNOWN."
      RISK_REASON: "Why risk is assigned."
      RISK_TO_FLOOR: "Threat to base or operating floor."
      RISK_TO_FUTURE: "Threat to future continuity."
      RISK_TO_TRUST: "Threat to trust."
      RISK_TO_REALITY: "Threat to accepted reality."
  CONFIDENCE:
    FUNCTION: "Separates coordinate structure from certainty."
    REQUIRED: true
    SUBFIELDS:
      LEVEL: "LOW, MEDIUM, HIGH."
      CONFIDENCE_REASON: "Why this confidence level is assigned."
      KNOWN_UNKNOWNS: "Known missing information."
      UNKNOWN_UNKNOWNS: "Likely hidden unknowns."
      REQUIRED_MORE_EVIDENCE: "Evidence required to raise confidence."
  REPAIR:
    FUNCTION: "Outputs bounded route."
    REQUIRED: true
    SUBFIELDS:
      OUTPUT_TYPE: "PROCEED, HOLD, PROBE, AUDIT, REPAIR, CONTAIN, REVERSE, ABORT."
      REQUIRED_ACTIONS: "Actions needed to repair, contain, verify, or route."
      REPAIR_RATE_TEST: "RepairRate >= DriftRate."
      REPAIR_SUCCESS_CRITERIA: "Observable signs repair is working."
      REPAIR_FAILURE_SIGNS: "Observable signs repair is failing."
  ANTI_HALLUCINATION:
    FUNCTION: "Prevents overclaim, false certainty, and unsafe inference."
    REQUIRED: true
    SUBFIELDS:
      DO_NOT_INFER: "Forbidden inferences."
      UNSAFE_SCALE_JUMPS: "Scale jumps not supported by evidence."
      UNSAFE_TIME_JUMPS: "Time claims not supported by evidence."
      UNSAFE_MORAL_JUMPS: "Moral labels not supported by invariant testing."
      REQUIRED_GUARDRAILS: "Guardrails that must remain active."

ENUM_REGISTRY:
  PUBLIC_LAYERS:
    - "Layer 0"
    - "Layer 1"
    - "Layer 2"
    - "Layer 3"
    - "Layer 4 / AI Extension"
  PUBLIC_SHELLS:
    - "Base Shell"
    - "Life Shell"
    - "Coordination Shell"
    - "Mind Shell"
    - "Continuity Overlay"
  SHELL_IDS:
    - "CIV.L0.SHELL.BASE"
    - "CIV.L1.SHELL.LIFE"
    - "CIV.L2.SHELL.ORDER"
    - "CIV.L3.SHELL.MIND"
    - "CIV.L4.SHELL.CONTINUITY"
  DOMAIN_IDS:
    - "CIV.BAS"
    - "CIV.INF"
    - "CIV.ENV"
    - "CIV.LIF"
    - "CIV.POP"
    - "CIV.BIO"
    - "CIV.LOG"
    - "CIV.ECO"
    - "CIV.GOV"
    - "CIV.SEC"
    - "CIV.KNO"
    - "CIV.LNG"
    - "CIV.CUL"
    - "CIV.REA"
    - "CIV.REP"
    - "CIV.LED"
    - "CIV.FRO"
    - "CIV.P4"
  LATTICE_STATES:
    - "+LATT"
    - "0LATT"
    - "-LATT"
    - "INV.LATT"
    - "DRIFT.LATT"
    - "REP.LATT"
    - "COL.LATT"
    - "FRO.LATT"
  ZOOM_LEVELS:
    - "Z0.INDIVIDUAL"
    - "Z1.FAMILY"
    - "Z2.ORGANISATION"
    - "Z3.COMMUNITY"
    - "Z4.NATION"
    - "Z5.REGION"
    - "Z6.CIVILISATION_BLOC"
    - "Z7.PLANET"
    - "Z8.FRONTIER"
  PHASE_STATES:
    - "P0.BLACKOUT"
    - "P1.CONSTRICTED"
    - "P2.STRESSED"
    - "P3.STABLE_FLOOR"
    - "P4.FRONTIER_EXCURSION"
  ZTIME_HORIZONS:
    - "T0.IMMEDIATE"
    - "T1.SHORT_TERM"
    - "T2.MID_TERM"
    - "T3.LONG_TERM"
    - "T4.INTERGENERATIONAL"
    - "T5.FRONTIER_TIME"
  VERIWEFT_STATUSES:
    - "PASS"
    - "WARN"
    - "FAIL"
    - "UNKNOWN"
  LEDGER_STATUSES:
    - "CLEAR"
    - "WATCH"
    - "ACCUMULATING"
    - "BREACHED"
    - "REPAIRING"
    - "UNKNOWN"
  RISK_LEVELS:
    - "LOW"
    - "MEDIUM"
    - "HIGH"
    - "CRITICAL"
    - "UNKNOWN"
  CONFIDENCE_LEVELS:
    - "LOW"
    - "MEDIUM"
    - "HIGH"
  REPAIR_OUTPUT_TYPES:
    - "PROCEED"
    - "HOLD"
    - "PROBE"
    - "AUDIT"
    - "REPAIR"
    - "CONTAIN"
    - "REVERSE"
    - "ABORT"

CLAIM_TYPE_REGISTRY:
  CLAIM_TYPES:
    FACTUAL_CLAIM:
      FUNCTION: "Direct statement about observable or documented fact."
      EXAMPLE: "A law was passed on a specific date."
    EVENT_REPORT:
      FUNCTION: "Report that an event occurred."
      EXAMPLE: "A protest happened in a city."
    ASSUMPTION:
      FUNCTION: "Statement assumed but not proven."
      EXAMPLE: "The policy was intended to suppress dissent."
    INTERPRETATION:
      FUNCTION: "Meaning assigned to signal or event."
      EXAMPLE: "The policy shows institutional fear."
    DIAGNOSTIC_INFERENCE:
      FUNCTION: "Framework-based classification."
      EXAMPLE: "This is possible inverse-lattice behaviour."
    VALUE_CLAIM:
      FUNCTION: "Normative or moral judgement."
      EXAMPLE: "The policy is unjust."
    FORECAST:
      FUNCTION: "Projection about future state."
      EXAMPLE: "This will reduce public trust."
    SYMBOLIC_READING:
      FUNCTION: "Interpretation of meaning, myth, story, cultural signal, or public symbol."
      EXAMPLE: "This story functions as a frontier warning."
    UNKNOWN:
      FUNCTION: "Claim type unclear."
      EXAMPLE: "Insufficient information to classify."

SOURCE_TYPE_REGISTRY:
  SOURCE_TYPES:
    DIRECT_OBSERVATION:
      DESCRIPTION: "Observed directly by the classifier or trusted instrument."
      DEFAULT_CONFIDENCE_LIMIT: "MEDIUM unless independently verified"
    DOCUMENTED_RECORD:
      DESCRIPTION: "Document, law, archive, dataset, transcript, ledger, institutional record."
      DEFAULT_CONFIDENCE_LIMIT: "MEDIUM to HIGH depending on source integrity"
    WITNESS_REPORT:
      DESCRIPTION: "Report by participant or observer."
      DEFAULT_CONFIDENCE_LIMIT: "LOW to MEDIUM unless corroborated"
    INSTITUTIONAL_CLAIM:
      DESCRIPTION: "Official statement from authority, state, organisation, company, institution."
      DEFAULT_CONFIDENCE_LIMIT: "LOW to MEDIUM unless independently verifiable"
    MEDIA_REPORT:
      DESCRIPTION: "News or media report."
      DEFAULT_CONFIDENCE_LIMIT: "LOW to MEDIUM depending on source and corroboration"
    ACADEMIC_SOURCE:
      DESCRIPTION: "Research, peer-reviewed source, scholarly analysis."
      DEFAULT_CONFIDENCE_LIMIT: "MEDIUM to HIGH depending on field and consensus"
    MODEL_INFERENCE:
      DESCRIPTION: "AI or analytical inference from available signals."
      DEFAULT_CONFIDENCE_LIMIT: "LOW to MEDIUM unless grounded in strong evidence"
    CULTURAL_TRADITION:
      DESCRIPTION: "Cultural, oral, symbolic, ritual, religious, or inherited claim."
      DEFAULT_CONFIDENCE_LIMIT: "LOW for factual history, MEDIUM for tradition-status, variable for invariant extraction"
    UNKNOWN_SOURCE:
      DESCRIPTION: "Source unclear or missing."
      DEFAULT_CONFIDENCE_LIMIT: "LOW"

COORDINATE_VALIDATION_RULES:
  VALIDATION_REQUIREMENTS:
    - "Shell ID must belong to Shell ID registry."
    - "Domain ID must belong to Domain ID registry."
    - "Domain primary must have declared relationship to Shell ID."
    - "Lattice state must belong to Lattice registry."
    - "Zoom level must belong to Zoom registry."
    - "Phase state must belong to Phase registry."
    - "Ztime horizon must belong to Ztime registry."
    - "VeriWeft status must be PASS, WARN, FAIL, or UNKNOWN."
    - "Ledger status must be declared."
    - "Risk level must be declared."
    - "Confidence level must be declared."
    - "Evidence field must not be empty."
    - "Anti-hallucination field must include at least one limit for medium/high-risk classifications."
  FAIL_CONDITIONS:
    - "Layer is used without Shell ID."
    - "Shell ID is used without Domain ID."
    - "Domain ID contains moral judgement."
    - "Lattice state is inferred without evidence."
    - "Zoom is missing where scale matters."
    - "Ztime is missing where effect changes over time."
    - "High confidence is assigned with weak evidence."
    - "Civilisation-wide claim is made from local signal without bridge."
    - "Repair is declared without invariant restoration criteria."
    - "Positive classification is assigned while Ledger debt is ignored."
  WARN_CONDITIONS:
    - "Secondary domains may be missing."
    - "Evidence is present but weak."
    - "Counter-signal has not been checked."
    - "Time horizon is plausible but not proven."
    - "Repair route is suggested but success criteria unclear."
    - "Scale bridge is partial."

CIVCOORD_DECISION_TREE:
  STEP_01_OBJECT:
    QUESTION: "What object, claim, event, system, or signal is being classified?"
    OUTPUT_FIELD: "CIV_OBJECT"
  STEP_02_LAYER:
    QUESTION: "Which public Layer/Shell does this mostly belong to?"
    OUTPUT_FIELD: "HUMAN_LAYER"
  STEP_03_ADDRESS:
    QUESTION: "What is the exact Shell ID and primary Domain ID?"
    OUTPUT_FIELD: "MACHINE_ADDRESS"
  STEP_04_SECONDARY_DOMAINS:
    QUESTION: "Which other domains are materially involved?"
    OUTPUT_FIELD: "DOMAIN_SECONDARY"
  STEP_05_LATTICE:
    QUESTION: "What is the state or route behaviour?"
    OUTPUT_FIELD: "LATTICE"
  STEP_06_SCALE:
    QUESTION: "At what zoom level does the evidence support the claim?"
    OUTPUT_FIELD: "SCALE"
  STEP_07_PHASE:
    QUESTION: "What operating phase is the system in?"
    OUTPUT_FIELD: "PHASE"
  STEP_08_TIME:
    QUESTION: "What time horizon does the classification apply to?"
    OUTPUT_FIELD: "TIME"
  STEP_09_VERIWEFT:
    QUESTION: "Do the relationships pass structural validity checks?"
    OUTPUT_FIELD: "VERIWEFT"
  STEP_10_LEDGER:
    QUESTION: "What damage, debt, drift, or repair has been recorded?"
    OUTPUT_FIELD: "LEDGER"
  STEP_11_EVIDENCE:
    QUESTION: "What evidence supports or weakens the classification?"
    OUTPUT_FIELD: "EVIDENCE"
  STEP_12_RISK:
    QUESTION: "What risk level and risk type are present?"
    OUTPUT_FIELD: "RISK"
  STEP_13_CONFIDENCE:
    QUESTION: "How certain is the coordinate?"
    OUTPUT_FIELD: "CONFIDENCE"
  STEP_14_REPAIR:
    QUESTION: "What bounded route follows?"
    OUTPUT_FIELD: "REPAIR"
  STEP_15_ANTI_HALLUCINATION:
    QUESTION: "What must not be inferred?"
    OUTPUT_FIELD: "ANTI_HALLUCINATION"

EXAMPLE_VALID_01_GOVERNANCE_DRIFT:
  CIVCOORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    CIV_OBJECT:
      OBJECT_NAME: "Institutional accountability weakening"
      OBJECT_TYPE: "institutional signal"
      HUMAN_DESCRIPTION: "A public institution becomes harder to audit and less responsive to correction."
      CLAIM_BEING_CLASSIFIED: "Governance accountability is drifting away from valid public function."
    HUMAN_LAYER:
      PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL: "Coordination Shell"
      HUMAN_FUNCTION: "Organises power, law, order, economy, movement, and security."
    MACHINE_ADDRESS:
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_PRIMARY: "CIV.GOV"
      DOMAIN_SECONDARY:
        - "CIV.REP"
        - "CIV.REA"
      DOMAIN_PRIMARY_REASON: "The main issue concerns governance, law, accountability, and bounded power."
      DOMAIN_SECONDARY_REASONS:
        CIV.REP: "Repair and audit are weakened."
        CIV.REA: "Public reality may be distorted if information access is restricted."
    LATTICE:
      STATE: "DRIFT.LATT"
      VALENCE: "NEGATIVE_IF_UNREPAIRED"
      ROUTE: "ACCOUNTABILITY_DRIFT"
      ROUTE_DESCRIPTION: "Institution moves away from auditability and correction."
      PRIOR_STATE: "0LATT"
      POSSIBLE_NEXT_STATE: "INV.LATT"
    SCALE:
      ZOOM_PRIMARY: "Z4.NATION"
      ZOOM_SECONDARY:
        - "Z3.COMMUNITY"
      SCALE_BRIDGE_SIGNALS:
        - "institutionalised behaviour"
        - "public trust impact"
        - "policy or procedural reinforcement"
      SCALE_LIMITS:
        - "Do not infer full civilisation collapse from this signal alone."
    PHASE:
      CURRENT_PHASE: "P2.STRESSED"
      PHASE_REASON: "System still functions but repair and audit signs are weakening."
      RISK_NEXT_PHASE: "P1.CONSTRICTED"
      FAILURE_THRESHOLD: "Audit channels become unavailable or performative only."
    TIME:
      ZTIME_PRIMARY: "T2.MID_TERM"
      TIME_HORIZON_REASON: "Accountability drift becomes clearer across repeated cycles."
      SHORT_TERM_EFFECT: "Reduced transparency."
      MID_TERM_EFFECT: "Trust debt accumulates."
      LONG_TERM_EFFECT: "Institution may become inverse if law protects itself over public function."
      INTERGENERATIONAL_EFFECT: "Civic trust may weaken across generations if unrepaired."
    VERIWEFT:
      STATUS: "WARN"
      TESTS_PASSED:
        - "formal institution still exists"
      TESTS_FAILED:
        - "auditability weakening"
      TESTS_UNKNOWN:
        - "truth-preservation"
        - "return-to-floor"
      VALIDITY_REASON: "The relation is under strain but needs stronger evidence before FAIL."
    LEDGER:
      STATUS: "ACCUMULATING"
      DEBT_TYPES:
        - "TRUST_DEBT"
        - "GOVERNANCE_DEBT"
      DEBT_DESCRIPTION:
        TRUST_DEBT: "Public confidence declines when correction pathways weaken."
        GOVERNANCE_DEBT: "Institutional accountability gap accumulates."
      REPAIR_HISTORY: []
      UNRESOLVED_COSTS:
        - "unanswered accountability concerns"
      LEDGER_NOTE: "Requires independent audit to confirm drift severity."
    EVIDENCE:
      OBSERVED_SIGNAL: "Reduced accountability access and weaker correction response."
      SOURCE_TYPE: "DOCUMENTED_RECORD"
      CLAIM_TYPE: "DIAGNOSTIC_INFERENCE"
      EVIDENCE_STRENGTH: "MEDIUM"
      COUNTER_SIGNAL: "Institution may claim procedural necessity."
      UNCERTAINTY: "Need evidence of intent, duration, and independent audit availability."
      REVERSIBILITY: "PARTIAL"
      REPAIR_VISIBILITY: "VISIBLE_IF_AUDIT_AND_CORRECTION_RETURN"
    RISK:
      LEVEL: "HIGH"
      RISK_REASON: "Governance drift can become inverse if audit failure normalises."
      RISK_TO_FLOOR: "MEDIUM"
      RISK_TO_FUTURE: "MEDIUM"
      RISK_TO_TRUST: "HIGH"
      RISK_TO_REALITY: "MEDIUM"
    CONFIDENCE:
      LEVEL: "MEDIUM"
      CONFIDENCE_REASON: "Pattern is plausible but not final without stronger evidence."
      KNOWN_UNKNOWNS:
        - "duration"
        - "independent review status"
        - "counter-evidence"
      UNKNOWN_UNKNOWNS:
        - "hidden internal repair attempts"
      REQUIRED_MORE_EVIDENCE:
        - "audit documents"
        - "public records"
        - "independent review"
    REPAIR:
      OUTPUT_TYPE: "AUDIT"
      REQUIRED_ACTIONS:
        - "independent audit"
        - "transparency restoration"
        - "public explanation"
        - "correction pathway reopening"
      REPAIR_RATE_TEST: "RepairRate >= DriftRate"
      REPAIR_SUCCESS_CRITERIA:
        - "audit access restored"
        - "corrections recorded"
        - "trust debt reduced"
      REPAIR_FAILURE_SIGNS:
        - "audit blocked"
        - "official claims replace evidence"
        - "public correction channel closes"
    ANTI_HALLUCINATION:
      DO_NOT_INFER:
        - "Do not infer full corruption without evidence."
        - "Do not infer civilisation collapse from one institution."
      UNSAFE_SCALE_JUMPS:
        - "Z4 to Z6 requires cross-institutional and cross-sector evidence."
      UNSAFE_TIME_JUMPS:
        - "T2 drift does not prove T4 inheritance without repeated transmission."
      UNSAFE_MORAL_JUMPS:
        - "Do not label actors evil without invariant and evidence test."
      REQUIRED_GUARDRAILS:
        - "check counter-signals"
        - "separate documented fact from diagnostic inference"

EXAMPLE_VALID_02_EDUCATIONAL_PATHWAY_COMPRESSION:
  CIVCOORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    CIV_OBJECT:
      OBJECT_NAME: "Secondary mathematics pathway compression"
      OBJECT_TYPE: "education signal"
      HUMAN_DESCRIPTION: "A student has weak mathematics foundations and begins losing future route options."
      CLAIM_BEING_CLASSIFIED: "Weak foundations are narrowing future education corridors."
    HUMAN_LAYER:
      PUBLIC_LAYER: "Layer 3"
      PUBLIC_SHELL: "Mind Shell"
      HUMAN_FUNCTION: "Carries knowledge, language, culture, meaning, and accepted reality."
    MACHINE_ADDRESS:
      SHELL_ID: "CIV.L3.SHELL.MIND"
      DOMAIN_PRIMARY: "CIV.KNO"
      DOMAIN_SECONDARY:
        - "CIV.LNG"
        - "CIV.POP"
      DOMAIN_PRIMARY_REASON: "The main issue is knowledge and skill formation."
      DOMAIN_SECONDARY_REASONS:
        CIV.LNG: "Mathematics depends on symbolic language and vocabulary precision."
        CIV.POP: "Future role differentiation and pathway access may be affected."
    LATTICE:
      STATE: "-LATT"
      VALENCE: "NEGATIVE_IF_UNREPAIRED"
      ROUTE: "PATHWAY_CHAIR_COMPRESSION"
      ROUTE_DESCRIPTION: "Weak foundations narrow future education and career options."
      PRIOR_STATE: "0LATT"
      POSSIBLE_NEXT_STATE: "P1.CONSTRICTED"
    SCALE:
      ZOOM_PRIMARY: "Z0.INDIVIDUAL"
      ZOOM_SECONDARY:
        - "Z1.FAMILY"
        - "Z2.ORGANISATION"
      SCALE_BRIDGE_SIGNALS:
        - "family stress"
        - "school assessment pattern"
        - "subject streaming or level placement consequences"
      SCALE_LIMITS:
        - "Do not infer national education failure from one student."
    PHASE:
      CURRENT_PHASE: "P2.STRESSED"
      PHASE_REASON: "Learning is still repairable, but route compression has begun."
      RISK_NEXT_PHASE: "P1.CONSTRICTED"
      FAILURE_THRESHOLD: "Student loses access to desired future mathematics corridor."
    TIME:
      ZTIME_PRIMARY: "T2.MID_TERM"
      ZTIME_SECONDARY:
        - "T4.INTERGENERATIONAL"
      TIME_HORIZON_REASON: "Education weakness compounds across school years."
      SHORT_TERM_EFFECT: "Lower confidence and weaker test performance."
      MID_TERM_EFFECT: "Subject options narrow."
      LONG_TERM_EFFECT: "Course and career options narrow."
      INTERGENERATIONAL_EFFECT: "Family and social mobility may be affected if repeated across groups."
    VERIWEFT:
      STATUS: "WARN"
      TESTS_PASSED:
        - "repairability"
      TESTS_FAILED:
        - "current transfer fluency"
      TESTS_UNKNOWN:
        - "diagnostic depth"
      VALIDITY_REASON: "Student needs detailed diagnostic mapping before final route selection."
    LEDGER:
      STATUS: "ACCUMULATING"
      DEBT_TYPES:
        - "KNOWLEDGE_DEBT"
        - "CONFIDENCE_DEBT"
        - "TIME_DEBT"
      DEBT_DESCRIPTION:
        KNOWLEDGE_DEBT: "Foundational concepts not fully mastered."
        CONFIDENCE_DEBT: "Student begins avoiding mathematical risk."
        TIME_DEBT: "Later repair becomes more expensive."
      REPAIR_HISTORY: []
      UNRESOLVED_COSTS:
        - "weak algebra"
        - "weak transfer"
        - "unclear error pattern"
      LEDGER_NOTE: "Repair should begin before examination-pathway pressure increases."
    EVIDENCE:
      OBSERVED_SIGNAL: "Weak algebra performance and difficulty with transfer questions."
      SOURCE_TYPE: "DIRECT_OBSERVATION"
      CLAIM_TYPE: "DIAGNOSTIC_INFERENCE"
      EVIDENCE_STRENGTH: "MEDIUM"
      COUNTER_SIGNAL: "Student may improve quickly with correct intervention."
      UNCERTAINTY: "Exact weakness map requires assessment."
      REVERSIBILITY: "HIGH_IF_EARLY"
      REPAIR_VISIBILITY: "VISIBLE_THROUGH_ERROR_REDUCTION_AND_TRANSFER_GAIN"
    RISK:
      LEVEL: "MEDIUM"
      RISK_REASON: "Route compression begins if foundations are not repaired."
      RISK_TO_FLOOR: "LOW"
      RISK_TO_FUTURE: "MEDIUM"
      RISK_TO_TRUST: "MEDIUM"
      RISK_TO_REALITY: "LOW"
    CONFIDENCE:
      LEVEL: "MEDIUM"
      CONFIDENCE_REASON: "General pattern is clear; precise diagnosis still needed."
      KNOWN_UNKNOWNS:
        - "topic-by-topic weakness"
        - "retention level"
        - "exam condition performance"
      REQUIRED_MORE_EVIDENCE:
        - "diagnostic test"
        - "error log"
        - "transfer question performance"
    REPAIR:
      OUTPUT_TYPE: "REPAIR"
      REQUIRED_ACTIONS:
        - "rebuild algebra from first principles"
        - "use spaced retrieval"
        - "train transfer questions"
        - "track error ledger"
        - "protect future subject corridors"
      REPAIR_RATE_TEST: "RepairRate >= DriftRate"
      REPAIR_SUCCESS_CRITERIA:
        - "fewer repeated algebra errors"
        - "higher transfer success"
        - "increased independent problem solving"
      REPAIR_FAILURE_SIGNS:
        - "student memorises without transfer"
        - "confidence continues falling"
        - "same mistakes repeat"
    ANTI_HALLUCINATION:
      DO_NOT_INFER:
        - "Do not infer low intelligence from weak vocabulary or weak mathematics performance."
        - "Do not infer permanent destiny from current foundation weakness."
      UNSAFE_SCALE_JUMPS:
        - "Do not infer system-wide education failure from individual case."
      REQUIRED_GUARDRAILS:
        - "separate raw intelligence from education runtime output"
        - "treat weakness as repairable unless evidence says otherwise"

INVALID_COORDINATE_EXAMPLES:
  INVALID_01_LAYER_ONLY:
    BAD_COORDINATE: "Layer 2 problem"
    WHY_INVALID: "Layer does not identify exact subsystem, state, scale, time, or evidence."
    REQUIRED_FIX:
      - "Add Shell ID"
      - "Add Domain ID"
      - "Add Lattice state"
      - "Add Zoom"
      - "Add Phase"
      - "Add Ztime"
      - "Add Evidence"
  INVALID_02_STATE_AS_ID:
    BAD_COORDINATE: "CIV.CORRUPT.GOV"
    WHY_INVALID: "Corruption is a possible state or route, not a stable domain ID."
    REQUIRED_FIX:
      CORRECT_FORM: "CIV.L2.SHELL.ORDER::CIV.GOV::INV.LATT"
  INVALID_03_MORAL_WITHOUT_EVIDENCE:
    BAD_COORDINATE: "CIV.GOV::EVIL"
    WHY_INVALID: "Moral judgement is not a Lattice state and lacks evidence."
    REQUIRED_FIX:
      CORRECT_FIELDS:
        DOMAIN_PRIMARY: "CIV.GOV"
        LATTICE_STATE: "INV.LATT or -LATT only if evidence supports it"
        EVIDENCE: "Required"
        CONFIDENCE: "Required"
  INVALID_04_SCALE_JUMP:
    BAD_COORDINATE: "One school failure = civilisation collapse"
    WHY_INVALID: "Z2 signal is jumped to Z6 without bridge."
    REQUIRED_FIX:
      REQUIRED_BRIDGE_SIGNALS:
        - "repetition across schools"
        - "policy-level pattern"
        - "national assessment trend"
        - "institutionalised failure"
        - "intergenerational transfer"
  INVALID_05_TIMELESS_LATTICE:
    BAD_COORDINATE: "Security policy is positive."
    WHY_INVALID: "Positive at which time horizon?"
    REQUIRED_FIX:
      REQUIRED_ZTIME_TEST:
        T0: "May stabilise immediate disorder."
        T2: "May create trust debt."
        T3: "May become permanent control."
        T4: "May transmit fear to future generations."

CIVCOORD_MORIARTY_ATTACKS:
  ATTACK_01_COORDINATE_AS_DECORATION:
    ATTACK: >
      AI writes a neat coordinate but does not use it for reasoning.
    FAILURE: "Coordinate becomes decorative metadata."
    HARDENING: >
      Every coordinate field must influence classification, risk, confidence,
      or repair output.
  ATTACK_02_FALSE_PRECISION:
    ATTACK: >
      AI assigns exact-looking fields without evidence.
    FAILURE: "The system hallucinates authority."
    HARDENING: >
      Evidence, uncertainty, source type, and confidence are mandatory.
  ATTACK_03_DOMAIN_OVERLAP_COLLISION:
    ATTACK: >
      Multiple domains are involved and AI cannot choose primary domain.
    FAILURE: "Repair route becomes vague."
    HARDENING: >
      Use DOMAIN_PRIMARY for main functional failure and DOMAIN_SECONDARY
      for dependencies and consequences.
  ATTACK_04_TIME_SLICE_TRAP:
    ATTACK: >
      AI classifies a short-term positive action as long-term positive.
    FAILURE: "Debt and drift are missed."
    HARDENING: >
      Ztime is mandatory for all Lattice classification.
  ATTACK_05_SCALE_INFLATION:
    ATTACK: >
      AI inflates local signal into civilisation-wide diagnosis.
    FAILURE: "Overclaim and panic output."
    HARDENING: >
      Zoom and scale bridge are mandatory.
  ATTACK_06_MORAL_ASTROLOGY:
    ATTACK: >
      Lattice becomes subjective moral label.
    FAILURE: "Framework becomes ideology."
    HARDENING: >
      Lattice must be tied to invariant effect, debt, repair, and evidence.
  ATTACK_07_REPAIR_IDEOLOGY:
    ATTACK: >
      Repair means making system match preference.
    FAILURE: "Repair route becomes political taste."
    HARDENING: >
      Repair must restore or improve invariant function and reduce Ledger debt.
  ATTACK_08_CONFIDENCE_CONFUSION:
    ATTACK: >
      Structured output is mistaken for certainty.
    FAILURE: "Low-evidence coordinate appears authoritative."
    HARDENING: >
      Confidence is separate from completeness.
      A complete coordinate may still have LOW confidence.

CIVCOORD_OUTPUT_MODES:
  HUMAN_PUBLIC_MODE:
    DESCRIPTION: "Readable explanation for public-facing articles."
    FORMAT: >
      This is a Layer {n} {Shell} issue. In machine terms, it mainly concerns
      {Domain}. Its current route appears to be {Lattice} at {Zoom} over
      {Ztime}, with {Confidence} confidence.
    EXAMPLE: >
      This is a Layer 2 Coordination Shell issue. In machine terms, it mainly
      concerns governance. Its current route appears to be drift-lattice at
      national scale over the mid-term, with medium confidence.
  COMPACT_AI_MODE:
    DESCRIPTION: "Short coordinate for LLM extraction."
    FORMAT: "SHELL_ID::DOMAIN_ID::LATTICE_STATE::ZOOM::PHASE::ZTIME::RISK::CONFIDENCE"
    EXAMPLE: "CIV.L2.SHELL.ORDER::CIV.GOV::DRIFT.LATT::Z4::P2::T2::RISK.HIGH::CONF.MEDIUM"
  FULL_MANIFEST_MODE:
    DESCRIPTION: "Full YAML schema for AI reasoning and audit."
    FORMAT: "CIVCOORD YAML manifest"
    EXAMPLE: "Use MASTER_CIVCOORD_SCHEMA."
  INDEX_MODE:
    DESCRIPTION: "Indexable metadata for article and database use."
    FORMAT:
      SHELL_ID: null
      DOMAIN_PRIMARY: null
      LATTICE_STATE: null
      ZOOM_PRIMARY: null
      PHASE: null
      ZTIME: null
      RISK: null
      CONFIDENCE: null

CIVCOORD_MINIMUM_VALID_RECORD:
  DESCRIPTION: >
    A minimum valid CivCoord record must include enough information for
    AI parsing without pretending full certainty.
  MINIMUM_VALID_CIVCOORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    HUMAN_LAYER:
      PUBLIC_LAYER: "Layer 2"
      PUBLIC_SHELL: "Coordination Shell"
    MACHINE_ADDRESS:
      SHELL_ID: "CIV.L2.SHELL.ORDER"
      DOMAIN_PRIMARY: "CIV.GOV"
      DOMAIN_SECONDARY: []
    LATTICE:
      STATE: "UNKNOWN"
      VALENCE: "UNKNOWN"
    SCALE:
      ZOOM_PRIMARY: "Z4.NATION"
      SCALE_BRIDGE_SIGNALS: []
    PHASE:
      CURRENT_PHASE: "UNKNOWN"
    TIME:
      ZTIME_PRIMARY: "UNKNOWN"
    VERIWEFT:
      STATUS: "UNKNOWN"
    LEDGER:
      STATUS: "UNKNOWN"
      DEBT_TYPES: []
    EVIDENCE:
      OBSERVED_SIGNAL: "Insufficient evidence supplied."
      SOURCE_TYPE: "UNKNOWN_SOURCE"
      CLAIM_TYPE: "UNKNOWN"
      EVIDENCE_STRENGTH: "LOW"
      UNCERTAINTY: "High."
    RISK:
      LEVEL: "UNKNOWN"
    CONFIDENCE:
      LEVEL: "LOW"
      CONFIDENCE_REASON: "Only shell and domain location are known."
    REPAIR:
      OUTPUT_TYPE: "PROBE"
      REQUIRED_ACTIONS:
        - "gather evidence"
        - "identify source type"
        - "set scale"
        - "set time horizon"
    ANTI_HALLUCINATION:
      DO_NOT_INFER:
        - "Do not infer Lattice state."
        - "Do not infer risk."
        - "Do not infer repair without evidence."

CIVCOORD_FULL_VALID_RECORD_TEMPLATE:
  CIVCOORD:
    VERSION: "CIVSTACK.RA.AI.v1"
    CIV_OBJECT:
      OBJECT_NAME: "[insert object name]"
      OBJECT_TYPE: "[insert object type]"
      HUMAN_DESCRIPTION: "[insert plain-language description]"
      CLAIM_BEING_CLASSIFIED: "[insert exact claim]"
    HUMAN_LAYER:
      PUBLIC_LAYER: "[Layer 0 / Layer 1 / Layer 2 / Layer 3 / Layer 4 Extension]"
      PUBLIC_SHELL: "[Base / Life / Coordination / Mind / Continuity]"
      HUMAN_FUNCTION: "[insert shell function]"
    MACHINE_ADDRESS:
      SHELL_ID: "[insert Shell ID]"
      DOMAIN_PRIMARY: "[insert primary Domain ID]"
      DOMAIN_SECONDARY:
        - "[insert secondary Domain ID]"
      DOMAIN_PRIMARY_REASON: "[explain why primary]"
      DOMAIN_SECONDARY_REASONS:
        "[secondary ID]": "[explain why secondary]"
    LATTICE:
      STATE: "[+LATT / 0LATT / -LATT / INV.LATT / DRIFT.LATT / REP.LATT / COL.LATT / FRO.LATT]"
      VALENCE: "[positive / neutral / negative / inverse / drift / repair / collapse / frontier]"
      ROUTE: "[insert named route]"
      ROUTE_DESCRIPTION: "[explain route]"
      PRIOR_STATE: "[optional]"
      POSSIBLE_NEXT_STATE: "[optional]"
    SCALE:
      ZOOM_PRIMARY: "[Z0-Z8]"
      ZOOM_SECONDARY:
        - "[optional secondary zoom]"
      SCALE_BRIDGE_SIGNALS:
        - "[bridge signal if cross-scale]"
      SCALE_LIMITS:
        - "[claim boundary]"
    PHASE:
      CURRENT_PHASE: "[P0-P4]"
      PHASE_REASON: "[explain]"
      RISK_NEXT_PHASE: "[optional]"
      FAILURE_THRESHOLD: "[optional]"
    TIME:
      ZTIME_PRIMARY: "[T0-T5]"
      ZTIME_SECONDARY:
        - "[optional]"
      TIME_HORIZON_REASON: "[explain]"
      SHORT_TERM_EFFECT: "[optional]"
      MID_TERM_EFFECT: "[optional]"
      LONG_TERM_EFFECT: "[optional]"
      INTERGENERATIONAL_EFFECT: "[optional]"
    VERIWEFT:
      STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
      TESTS_PASSED:
        - "[test]"
      TESTS_FAILED:
        - "[test]"
      TESTS_UNKNOWN:
        - "[test]"
      VALIDITY_REASON: "[explain]"
    LEDGER:
      STATUS: "[CLEAR / WATCH / ACCUMULATING / BREACHED / REPAIRING / UNKNOWN]"
      DEBT_TYPES:
        - "[debt type]"
      DEBT_DESCRIPTION:
        "[debt type]": "[description]"
      REPAIR_HISTORY:
        - "[known repair attempt]"
      UNRESOLVED_COSTS:
        - "[cost]"
      LEDGER_NOTE: "[optional]"
    EVIDENCE:
      OBSERVED_SIGNAL: "[evidence signal]"
      SOURCE_TYPE: "[source type]"
      CLAIM_TYPE: "[claim type]"
      EVIDENCE_STRENGTH: "[LOW / MEDIUM / HIGH / UNKNOWN]"
      COUNTER_SIGNAL: "[counter evidence or alternative explanation]"
      UNCERTAINTY: "[what remains uncertain]"
      REVERSIBILITY: "[LOW / MEDIUM / HIGH / UNKNOWN]"
      REPAIR_VISIBILITY: "[visible / hidden / unknown]"
    RISK:
      LEVEL: "[LOW / MEDIUM / HIGH / CRITICAL / UNKNOWN]"
      RISK_REASON: "[explain]"
      RISK_TO_FLOOR: "[LOW / MEDIUM / HIGH / CRITICAL / UNKNOWN]"
      RISK_TO_FUTURE: "[LOW / MEDIUM / HIGH / CRITICAL / UNKNOWN]"
      RISK_TO_TRUST: "[LOW / MEDIUM / HIGH / CRITICAL / UNKNOWN]"
      RISK_TO_REALITY: "[LOW / MEDIUM / HIGH / CRITICAL / UNKNOWN]"
    CONFIDENCE:
      LEVEL: "[LOW / MEDIUM / HIGH]"
      CONFIDENCE_REASON: "[explain]"
      KNOWN_UNKNOWNS:
        - "[known unknown]"
      UNKNOWN_UNKNOWNS:
        - "[likely hidden unknown]"
      REQUIRED_MORE_EVIDENCE:
        - "[needed evidence]"
    REPAIR:
      OUTPUT_TYPE: "[PROCEED / HOLD / PROBE / AUDIT / REPAIR / CONTAIN / REVERSE / ABORT]"
      REQUIRED_ACTIONS:
        - "[action]"
      REPAIR_RATE_TEST: "RepairRate >= DriftRate"
      REPAIR_SUCCESS_CRITERIA:
        - "[success marker]"
      REPAIR_FAILURE_SIGNS:
        - "[failure marker]"
    ANTI_HALLUCINATION:
      DO_NOT_INFER:
        - "[forbidden inference]"
      UNSAFE_SCALE_JUMPS:
        - "[scale jump warning]"
      UNSAFE_TIME_JUMPS:
        - "[time jump warning]"
      UNSAFE_MORAL_JUMPS:
        - "[moral jump warning]"
      REQUIRED_GUARDRAILS:
        - "[guardrail]"

CANONICAL_LOCK:
  FULL_LOCK: >
    CivCoord is the coordinate grammar of the Civilisation Layer Stack AI/LLM
    architecture. It prevents loose civilisation reasoning by requiring every
    classification to identify public Shell, machine Domain, Lattice state,
    scale, phase, time horizon, VeriWeft validity, Ledger status, Evidence,
    Confidence, and Repair output.
  SHORT_LOCK: >
    CivCoord = Shell ID + Domain ID + Lattice + Zoom + Phase + Ztime
    + VeriWeft + Ledger + Evidence + Confidence + Repair.
  MORIARTY_LOCK: >
    No coordinate without evidence.
    No exactness without uncertainty.
    No scale jump without bridge.
    No Lattice state without time horizon.
    No repair without invariant restoration.
    No structured output mistaken for truth.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.004"
  NEXT_ARTICLE_TITLE: "Lattice Overlay Architecture"
  NEXT_ARTICLE_FUNCTION: >
    Define how Positive, Neutral, Negative, Inverse, Drift, Repair, Collapse,
    and Frontier Lattice states overlay every Shell ID and Domain ID without
    replacing Layer or ID structure.
  NEXT_ARTICLE_OUTPUTS:
    - "Lattice state registry"
    - "Valence rules"
    - "State transition grammar"
    - "Route/corridor definitions"
    - "Time-sliced Lattice tests"
    - "Moriarty hardening against moral astrology"

ARTICLE:
  PUBLIC_TITLE: "Lattice Overlay Architecture"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.004"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.004"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define how Lattice states overlay every Civilisation Layer Shell and Domain ID
    without replacing Layer, Shell, or ID structure. Establish Positive, Neutral,
    Negative, Inverse, Drift, Repair, Collapse, and Frontier Lattice states as
    state-and-route geometry for AI/LLM civilisation reasoning.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, state-space and corridor reasoning"

CORE_DEFINITION:
  LATTICE:
    FULL_NAME: "Civilisation Lattice Overlay"
    MACHINE_NAME: "CIV.LATTICE.OVERLAY"
    FUNCTION: >
      The Lattice is the state-space and corridor geometry that overlays every
      Civilisation Layer, Shell ID, and Domain ID. It describes how a civilisation
      object behaves, moves, drifts, repairs, inverts, collapses, or opens future
      corridors across scale and time.
  ONE_SENTENCE: >
    Lattice does not tell AI where a civilisation object lives; it tells AI what
    state and route that object is moving through.
  SHORT_FORMULA: >
    Layer = Shell.
    ID = Address.
    Lattice = State and Route.
  HARD_RULE: >
    Lattice is not a moral label, not a public layer, and not a domain ID.
    It is a functional state-and-route overlay that must be tied to evidence,
    time horizon, invariant effect, Ledger debt, VeriWeft validity, and repair
    possibility.

WHY_LATTICE_EXISTS:
  PROBLEM:
    DESCRIPTION: >
      AI systems can identify a domain such as governance, education, culture,
      security, or reality formation, but still fail to describe whether that
      domain is strengthening civilisation, drifting away from function, producing
      hidden debt, reversing its intended purpose, repairing damage, collapsing,
      or opening a frontier corridor.
    COMMON_FAILURES:
      - "AI says this is a governance problem but does not classify the state."
      - "AI says this is culture but cannot tell whether it is living adaptation or memory loss."
      - "AI says security is good because it claims protection."
      - "AI says reform is good without checking hidden cost."
      - "AI says stability is positive without checking Ledger debt."
      - "AI says collapse is near without checking repair capacity."
      - "AI treats positive and negative as moral preferences instead of invariant effects."
  SOLUTION:
    DESCRIPTION: >
      Lattice states give AI a functional route grammar. A domain can be located
      by ID, then classified by Lattice state. This lets AI separate location
      from condition, condition from evidence, and evidence from confidence.
  RESULT:
    - "Domain ID identifies subsystem."
    - "Lattice state identifies route behaviour."
    - "Ztime tests whether the state changes across time horizon."
    - "Zoom tests whether the state scales."
    - "VeriWeft tests whether relationships are valid."
    - "Ledger records debt, drift, damage, and repair."
    - "Repair Runtime outputs bounded route."

LATTICE_SEPARATION_RULE:
  DESCRIPTION: >
    Lattice must remain separate from Layer, Shell, ID, Zoom, Phase, Ledger,
    and Repair. It interacts with all of them but does not replace them.
  SEPARATION_TABLE:
    LAYER:
      QUESTION: "Which broad public shell?"
      EXAMPLE: "Layer 2"
      NOT_LATTICE_BECAUSE: "Layer locates public shell, not state."
    SHELL_ID:
      QUESTION: "Which broad machine container?"
      EXAMPLE: "CIV.L2.SHELL.ORDER"
      NOT_LATTICE_BECAUSE: "Shell ID locates container, not route."
    DOMAIN_ID:
      QUESTION: "Which exact subsystem?"
      EXAMPLE: "CIV.GOV"
      NOT_LATTICE_BECAUSE: "Domain ID locates function, not current behaviour."
    LATTICE:
      QUESTION: "What state or route is the subsystem in?"
      EXAMPLE: "INV.LATT"
      ROLE: "State-space and corridor geometry."
    ZOOM:
      QUESTION: "At what scale?"
      EXAMPLE: "Z4.NATION"
      NOT_LATTICE_BECAUSE: "Zoom locates scale, not route."
    PHASE:
      QUESTION: "What operating condition?"
      EXAMPLE: "P2.STRESSED"
      NOT_LATTICE_BECAUSE: "Phase describes system condition, not route valence by itself."
    ZTIME:
      QUESTION: "At what time horizon?"
      EXAMPLE: "T2.MID_TERM"
      NOT_LATTICE_BECAUSE: "Ztime tests temporal validity of Lattice classification."
    LEDGER:
      QUESTION: "What debt, damage, or repair is recorded?"
      EXAMPLE: "TRUST_DEBT_ACCUMULATING"
      NOT_LATTICE_BECAUSE: "Ledger records memory; Lattice describes movement."
    REPAIR:
      QUESTION: "What bounded route follows?"
      EXAMPLE: "AUDIT_AND_REPAIR"
      NOT_LATTICE_BECAUSE: "Repair is output; Lattice is diagnosis state."

LATTICE_STATE_REGISTRY:
  POSITIVE_LATTICE:
    CODE: "+LATT"
    NAME: "Positive Lattice"
    FUNCTION: "Reinforces civilisation invariants and improves viable continuity."
    CORE_TEST: "Does this strengthen life, bounded power, truth, trust, learning, repair, or future viability without hidden debt exceeding benefit?"
    COMMON_ROUTES:
      - "CAPABILITY_GAIN"
      - "TRUST_REPAIR"
      - "KNOWLEDGE_TRANSFER"
      - "BASE_STRENGTHENING"
      - "REALITY_CLARIFICATION"
      - "BOUNDED_COORDINATION"
      - "FUTURE_OPTION_WIDENING"
    FAILURE_WARNING: "Do not classify as +LATT if visible benefit hides long-term debt."
  NEUTRAL_LATTICE:
    CODE: "0LATT"
    NAME: "Neutral Lattice"
    FUNCTION: "Dormant, undecided, low-effect, transitional, or context-dependent state."
    CORE_TEST: "Is the effect currently low, unclear, balanced, unactivated, or awaiting routing?"
    COMMON_ROUTES:
      - "DORMANT_SIGNAL"
      - "UNDECIDED_ROUTE"
      - "LOW_EFFECT_STATE"
      - "WAITING_FOR_CONTEXT"
      - "UNACTIVATED_CAPABILITY"
    FAILURE_WARNING: "Do not leave in 0LATT if evidence shows debt, repair, inversion, or collapse movement."
  NEGATIVE_LATTICE:
    CODE: "-LATT"
    NAME: "Negative Lattice"
    FUNCTION: "Drains, damages, destabilises, narrows, or burdens civilisation invariants."
    CORE_TEST: "Does this create hidden debt, reduce optionality, damage trust, weaken the floor, distort reality, or compress future corridors?"
    COMMON_ROUTES:
      - "TRUST_DEPLETION"
      - "KNOWLEDGE_DEBT"
      - "PATHWAY_CHAIR_COMPRESSION"
      - "RESOURCE_DRAIN"
      - "CULTURE_MEMORY_LOSS"
      - "REALITY_DISTORTION"
      - "FLOOR_WEAKENING"
    FAILURE_WARNING: "Do not classify as -LATT merely because discomfort, discipline, force, or cost exists."
  INVERSE_LATTICE:
    CODE: "INV.LATT"
    NAME: "Inverse Lattice"
    FUNCTION: "Uses official form or claimed function to produce the opposite of intended invariant."
    CORE_TEST: "Does the system claim to protect an invariant while routing output against that invariant?"
    COMMON_ROUTES:
      - "LAW_AS_COSTUME"
      - "SECURITY_AS_CONTROL"
      - "EDUCATION_AS_COMPLIANCE"
      - "NEWS_AS_REALITY_CAPTURE"
      - "CULTURE_AS_EXCLUSION_MACHINE"
      - "REPAIR_AS_CONCEALMENT"
      - "GOOD_AS_EVIL_ROUTE"
    FAILURE_WARNING: "Do not classify as INV.LATT without checking intended function, evidence, boundedness, and return-to-floor."
  DRIFT_LATTICE:
    CODE: "DRIFT.LATT"
    NAME: "Drift Lattice"
    FUNCTION: "Gradual movement away from stable invariant alignment."
    CORE_TEST: "Is the system slowly moving out of valid operating range before obvious collapse appears?"
    COMMON_ROUTES:
      - "ACCOUNTABILITY_DRIFT"
      - "SKILL_DECAY"
      - "LANGUAGE_THINNING"
      - "TRUST_EROSION"
      - "MAINTENANCE_BACKLOG"
      - "REALITY_FOG_INCREASE"
      - "CULTURE_DILUTION"
    FAILURE_WARNING: "Drift often looks normal from inside the current timeline."
  REPAIR_LATTICE:
    CODE: "REP.LATT"
    NAME: "Repair Lattice"
    FUNCTION: "Restores damaged invariants and reduces accumulated drift, debt, or distortion."
    CORE_TEST: "Does this reduce damage faster than new damage accumulates?"
    COMMON_ROUTES:
      - "AUDIT_AND_CORRECTION"
      - "TRUST_REBUILD"
      - "FOUNDATION_REPAIR"
      - "CULTURE_RENEWAL"
      - "SOURCE_CALIBRATION"
      - "INSTITUTIONAL_REFORM"
      - "RETURN_TO_FLOOR"
    FAILURE_WARNING: "Do not classify as REP.LATT if repair is only cosmetic or conceals debt."
  COLLAPSE_LATTICE:
    CODE: "COL.LATT"
    NAME: "Collapse Lattice"
    FUNCTION: "Accelerates irreversible or hard-to-reverse failure."
    CORE_TEST: "Are repair corridors closing faster than repair can restore invariant function?"
    COMMON_ROUTES:
      - "REPAIR_CORRIDOR_CLOSURE"
      - "COCKPIT_CAPTURE"
      - "FLOOR_BURN"
      - "REALITY_CAPTURE"
      - "TRUST_FREEFALL"
      - "SUPPLY_BREAK"
      - "INSTITUTIONAL_VOID"
    FAILURE_WARNING: "Do not classify as COL.LATT if repair corridors remain open and active."
  FRONTIER_LATTICE:
    CODE: "FRO.LATT"
    NAME: "Frontier Lattice"
    FUNCTION: "Opens future corridor while preserving base floor and continuity rent."
    CORE_TEST: "Does the frontier move preserve the base that makes future movement possible?"
    COMMON_ROUTES:
      - "FUTURE_CORRIDOR_OPENING"
      - "P4_EXCURSION"
      - "LATENT_LIFT"
      - "ENVELOPE_SHIFT"
      - "FRONTIER_APERTURE"
      - "DISCONTINUOUS_ASCENT"
      - "BASE_RENT_PAID"
    FAILURE_WARNING: "Do not classify as FRO.LATT if frontier gain burns P3 floor or creates unpaid future debt."

VALENCE_RULES:
  DESCRIPTION: >
    Lattice valence is functional, not emotional. It is determined by invariant
    effect, debt, repair capacity, time horizon, and scale.
  VALENCE_TYPES:
    POSITIVE:
      CODE: "VAL.POS"
      TEST: "Net effect strengthens civilisation invariant without unsustainable hidden debt."
    NEUTRAL:
      CODE: "VAL.NEU"
      TEST: "Net effect is dormant, low, balanced, unclear, or not yet activated."
    NEGATIVE:
      CODE: "VAL.NEG"
      TEST: "Net effect damages, drains, narrows, burdens, or destabilises invariant."
    INVERSE:
      CODE: "VAL.INV"
      TEST: "Official form routes output opposite to intended function."
    REPAIR:
      CODE: "VAL.REP"
      TEST: "Net effect restores damaged invariant and reduces Ledger debt."
    COLLAPSE:
      CODE: "VAL.COL"
      TEST: "Net effect closes repair corridors and accelerates irreversible failure."
    FRONTIER:
      CODE: "VAL.FRO"
      TEST: "Net effect opens future corridor while preserving base floor."
  HARD_RULES:
    - "Valence must be tested against invariant effect."
    - "Valence must include Ztime."
    - "Valence must include evidence."
    - "Valence must include Ledger check."
    - "Valence must not be assigned from appearance alone."
    - "Valence may change across time horizon."
    - "Valence may differ across Zoom levels."

INVARIANT_EFFECT_TEST:
  DESCRIPTION: >
    Lattice classification must ask what happens to core civilisation invariants.
    The same action may appear positive in one horizon and negative in another.
  CORE_INVARIANTS:
    LIFE:
      QUESTION: "Does this protect or damage life and survival?"
    BASE:
      QUESTION: "Does this preserve or burn the physical floor?"
    TRUTH:
      QUESTION: "Does this clarify or distort accepted reality?"
    BOUNDED_POWER:
      QUESTION: "Does power remain bounded, reviewable, and returnable to floor?"
    TRUST:
      QUESTION: "Does this build or deplete legitimate trust?"
    LEARNING:
      QUESTION: "Does this improve or weaken knowledge transfer?"
    CULTURE_MEMORY:
      QUESTION: "Does this preserve living memory or erase it?"
    REPAIR:
      QUESTION: "Does this open or close repair corridors?"
    FUTURE:
      QUESTION: "Does this preserve future optionality?"
    DIGNITY:
      QUESTION: "Does this preserve human dignity and prevent dehumanising route capture?"
  CLASSIFICATION_RULE:
    IF_STRENGTHENS_INVARIANTS_WITH_LOW_HIDDEN_DEBT: "+LATT"
    IF_EFFECT_UNCLEAR_OR_DORMANT: "0LATT"
    IF_DAMAGES_OR_DRAINS_INVARIANTS: "-LATT"
    IF_CLAIMED_FUNCTION_PRODUCES_OPPOSITE_OUTPUT: "INV.LATT"
    IF_MOVING_AWAY_GRADUALLY: "DRIFT.LATT"
    IF_RESTORES_INVARIANTS: "REP.LATT"
    IF_REPAIR_CORRIDORS_CLOSING: "COL.LATT"
    IF_OPENS_FUTURE_CORRIDOR_WITH_BASE_RENT_PAID: "FRO.LATT"

TIME_SLICED_LATTICE_TEST:
  DESCRIPTION: >
    A Lattice state is incomplete without time horizon. AI must test whether
    an action has different valence at immediate, short-term, mid-term,
    long-term, intergenerational, or frontier-time horizons.
  ZTIME_HORIZONS:
    T0.IMMEDIATE:
      QUESTION: "What happens now?"
      COMMON_DISTORTION: "Emergency effect mistaken for stable truth."
    T1.SHORT_TERM:
      QUESTION: "What happens after first-order effects?"
      COMMON_DISTORTION: "Short-term order mistaken for legitimate repair."
    T2.MID_TERM:
      QUESTION: "What happens after adaptation, resistance, and feedback?"
      COMMON_DISTORTION: "Accumulating debt remains hidden."
    T3.LONG_TERM:
      QUESTION: "What does repeated use turn into?"
      COMMON_DISTORTION: "Exception becomes normal operating system."
    T4.INTERGENERATIONAL:
      QUESTION: "What is passed to children and future institutions?"
      COMMON_DISTORTION: "Unpaid debt becomes inherited constraint."
    T5.FRONTIER_TIME:
      QUESTION: "Does this preserve or destroy future corridor capacity?"
      COMMON_DISTORTION: "Frontier success burns base floor."
  EXAMPLE_SECURITY_POLICY:
    T0.IMMEDIATE: "+LATT if it prevents immediate harm."
    T1.SHORT_TERM: "0LATT or +LATT if bounded and transparent."
    T2.MID_TERM: "-LATT if emergency powers persist without audit."
    T3.LONG_TERM: "INV.LATT if security becomes control."
    T4.INTERGENERATIONAL: "-LATT if fear and distrust become inherited civic memory."
    T5.FRONTIER_TIME: "COL.LATT if it destroys open future governance corridors."
  HARD_RULE: "No Lattice final classification without Ztime."

ZOOM_SLICED_LATTICE_TEST:
  DESCRIPTION: >
    A Lattice state may differ across scales. A policy may help one zoom level
    while harming another. AI must identify the primary zoom and affected zooms.
  ZOOM_LEVELS:
    Z0.INDIVIDUAL:
      QUESTION: "What happens to one person?"
    Z1.FAMILY:
      QUESTION: "What happens to family or close group?"
    Z2.ORGANISATION:
      QUESTION: "What happens to school, company, institution, or local organisation?"
    Z3.COMMUNITY:
      QUESTION: "What happens to community, sector, or profession?"
    Z4.NATION:
      QUESTION: "What happens at national system level?"
    Z5.REGION:
      QUESTION: "What happens across regional bloc?"
    Z6.CIVILISATION_BLOC:
      QUESTION: "What happens across civilisation-scale structure?"
    Z7.PLANET:
      QUESTION: "What happens to planetary systems?"
    Z8.FRONTIER:
      QUESTION: "What happens beyond current Earth-contained frame?"
  EXAMPLE_EDUCATION_FAILURE:
    Z0.INDIVIDUAL: "-LATT if student loses confidence and skill."
    Z1.FAMILY: "-LATT if family stress and cost rise."
    Z2.ORGANISATION: "DRIFT.LATT if repeated across classroom or school."
    Z3.COMMUNITY: "-LATT if sector sees widespread pathway compression."
    Z4.NATION: "Requires national data before classification."
    Z6.CIVILISATION_BLOC: "Forbidden without large-scale bridge evidence."
  HARD_RULE: "No scale jump without bridge signal."

STATE_TRANSITION_GRAMMAR:
  DESCRIPTION: >
    Lattice states can move from one state to another across time, pressure,
    evidence, repair, or failure. AI must track transition rather than treating
    state as permanent identity.
  TRANSITION_FORMAT:
    PATTERN: "FROM_STATE -> TRIGGER -> TO_STATE"
  COMMON_TRANSITIONS:
    DORMANT_TO_POSITIVE:
      FORMAT: "0LATT -> capability activated with low debt -> +LATT"
      EXAMPLE: "Unused school support becomes effective learning repair."
    DORMANT_TO_NEGATIVE:
      FORMAT: "0LATT -> pressure activates harmful route -> -LATT"
      EXAMPLE: "Neutral exam pressure becomes confidence collapse."
    POSITIVE_TO_DRIFT:
      FORMAT: "+LATT -> maintenance neglected -> DRIFT.LATT"
      EXAMPLE: "Good institution slowly loses accountability."
    DRIFT_TO_NEGATIVE:
      FORMAT: "DRIFT.LATT -> debt accumulates -> -LATT"
      EXAMPLE: "Weak foundations become future pathway compression."
    DRIFT_TO_INVERSE:
      FORMAT: "DRIFT.LATT -> official form protects opposite function -> INV.LATT"
      EXAMPLE: "Law becomes costume for unaccountability."
    NEGATIVE_TO_REPAIR:
      FORMAT: "-LATT -> invariant damage recognised and corrected -> REP.LATT"
      EXAMPLE: "Learning gap becomes structured foundation repair."
    INVERSE_TO_COLLAPSE:
      FORMAT: "INV.LATT -> repair blocked and cockpit captured -> COL.LATT"
      EXAMPLE: "Institution uses law to permanently prevent correction."
    REPAIR_TO_POSITIVE:
      FORMAT: "REP.LATT -> debt reduced and invariant strengthened -> +LATT"
      EXAMPLE: "Audit restores trust and improves institution."
    FRONTIER_TO_POSITIVE:
      FORMAT: "FRO.LATT -> base rent paid and capability stabilised -> +LATT"
      EXAMPLE: "Frontier technology becomes stable public benefit."
    FRONTIER_TO_COLLAPSE:
      FORMAT: "FRO.LATT -> P3 floor burned -> COL.LATT"
      EXAMPLE: "Advanced project consumes base systems faster than repair capacity."
  HARD_RULES:
    - "State transition requires trigger."
    - "Trigger requires evidence."
    - "Evidence requires confidence field."
    - "Temporary state must not become permanent identity."

LATTICE_ROUTE_REGISTRY:
  DESCRIPTION: >
    Routes are named corridors inside Lattice states. They help AI identify
    repeated patterns across different domains.
  POSITIVE_ROUTES:
    CAPABILITY_GAIN:
      DESCRIPTION: "System increases usable human or institutional capability."
      COMMON_DOMAINS: ["CIV.KNO", "CIV.ECO", "CIV.GOV"]
    TRUST_REPAIR:
      DESCRIPTION: "System rebuilds legitimate trust after damage."
      COMMON_DOMAINS: ["CIV.REP", "CIV.GOV", "CIV.REA"]
    REALITY_CLARIFICATION:
      DESCRIPTION: "System improves signal quality and public truth formation."
      COMMON_DOMAINS: ["CIV.REA", "CIV.LNG", "CIV.KNO"]
    FUTURE_OPTION_WIDENING:
      DESCRIPTION: "System increases future corridor optionality."
      COMMON_DOMAINS: ["CIV.FRO", "CIV.KNO", "CIV.POP"]
  NEGATIVE_ROUTES:
    PATHWAY_CHAIR_COMPRESSION:
      DESCRIPTION: "Underperformance or weak preparation closes future options."
      COMMON_DOMAINS: ["CIV.KNO", "CIV.POP", "CIV.ECO"]
    TRUST_DEPLETION:
      DESCRIPTION: "System drains public or relational trust."
      COMMON_DOMAINS: ["CIV.GOV", "CIV.REP", "CIV.REA"]
    REALITY_DISTORTION:
      DESCRIPTION: "Signal field produces wrong accepted reality."
      COMMON_DOMAINS: ["CIV.REA", "CIV.LNG", "CIV.GOV"]
    FLOOR_WEAKENING:
      DESCRIPTION: "System weakens base substrate or operating floor."
      COMMON_DOMAINS: ["CIV.BAS", "CIV.INF", "CIV.ENV"]
  INVERSE_ROUTES:
    LAW_AS_COSTUME:
      DESCRIPTION: "Law appears valid but protects unaccountable power."
      COMMON_DOMAINS: ["CIV.GOV", "CIV.REP", "CIV.REA"]
    SECURITY_AS_CONTROL:
      DESCRIPTION: "Security claims protection but becomes domination."
      COMMON_DOMAINS: ["CIV.SEC", "CIV.GOV", "CIV.REA"]
    EDUCATION_AS_COMPLIANCE:
      DESCRIPTION: "Education claims learning but produces only obedience or credential shell."
      COMMON_DOMAINS: ["CIV.KNO", "CIV.GOV", "CIV.POP"]
    REPAIR_AS_CONCEALMENT:
      DESCRIPTION: "Repair language hides damage instead of reducing debt."
      COMMON_DOMAINS: ["CIV.REP", "CIV.REA", "CIV.GOV"]
  DRIFT_ROUTES:
    ACCOUNTABILITY_DRIFT:
      DESCRIPTION: "Correction and audit weaken gradually."
      COMMON_DOMAINS: ["CIV.GOV", "CIV.REP"]
    SKILL_DECAY:
      DESCRIPTION: "Capability declines through weak transfer or nonuse."
      COMMON_DOMAINS: ["CIV.KNO", "CIV.ECO"]
    LANGUAGE_THINNING:
      DESCRIPTION: "Vocabulary loses target-area depth and signal precision."
      COMMON_DOMAINS: ["CIV.LNG", "CIV.KNO", "CIV.REA"]
    MAINTENANCE_BACKLOG:
      DESCRIPTION: "Infrastructure or institution decays through deferred repair."
      COMMON_DOMAINS: ["CIV.INF", "CIV.GOV", "CIV.REP"]
  REPAIR_ROUTES:
    RETURN_TO_FLOOR:
      DESCRIPTION: "Emergency or exception returns to normal bounded condition."
      COMMON_DOMAINS: ["CIV.GOV", "CIV.SEC", "CIV.REP"]
    AUDIT_AND_CORRECTION:
      DESCRIPTION: "System exposes error and corrects route."
      COMMON_DOMAINS: ["CIV.REP", "CIV.GOV", "CIV.REA"]
    FOUNDATION_REPAIR:
      DESCRIPTION: "System rebuilds base skill, trust, infrastructure, or substrate."
      COMMON_DOMAINS: ["CIV.KNO", "CIV.INF", "CIV.LIF"]
    CULTURE_RENEWAL:
      DESCRIPTION: "Culture repairs memory while remaining living and adaptive."
      COMMON_DOMAINS: ["CIV.CUL", "CIV.LNG", "CIV.KNO"]
  COLLAPSE_ROUTES:
    COCKPIT_CAPTURE:
      DESCRIPTION: "Control layer becomes corrupted and steers system toward crash."
      COMMON_DOMAINS: ["CIV.GOV", "CIV.SEC", "CIV.REP"]
    REPAIR_CORRIDOR_CLOSURE:
      DESCRIPTION: "Normal correction routes become unavailable."
      COMMON_DOMAINS: ["CIV.REP", "CIV.GOV", "CIV.REA"]
    FLOOR_BURN:
      DESCRIPTION: "System consumes the base needed for continued operation."
      COMMON_DOMAINS: ["CIV.BAS", "CIV.ENV", "CIV.FRO"]
    REALITY_CAPTURE:
      DESCRIPTION: "Accepted reality is controlled against evidence."
      COMMON_DOMAINS: ["CIV.REA", "CIV.GOV", "CIV.LNG"]
  FRONTIER_ROUTES:
    FRONTIER_APERTURE:
      DESCRIPTION: "New future corridor opens."
      COMMON_DOMAINS: ["CIV.FRO", "CIV.P4", "CIV.KNO"]
    LATENT_LIFT:
      DESCRIPTION: "Previously inaccessible capability becomes usable."
      COMMON_DOMAINS: ["CIV.P4", "CIV.KNO", "CIV.ECO"]
    ENVELOPE_SHIFT:
      DESCRIPTION: "Civilisation operating envelope expands."
      COMMON_DOMAINS: ["CIV.FRO", "CIV.P4", "CIV.BAS"]
    BASE_RENT_PAID:
      DESCRIPTION: "Frontier movement preserves and funds base floor."
      COMMON_DOMAINS: ["CIV.FRO", "CIV.REP", "CIV.BAS"]

LATTICE_EVIDENCE_GATE:
  DESCRIPTION: >
    Lattice classification requires evidence. AI must not assign +LATT, -LATT,
    INV.LATT, REP.LATT, COL.LATT, or FRO.LATT by appearance or rhetoric alone.
  REQUIRED_EVIDENCE_FIELDS:
    OBSERVED_SIGNAL:
      QUESTION: "What is actually observed, recorded, claimed, or inferred?"
    SOURCE_TYPE:
      QUESTION: "Where does the signal come from?"
    CLAIM_TYPE:
      QUESTION: "Is this fact, event report, interpretation, diagnostic inference, value claim, or forecast?"
    INVARIANT_EFFECT:
      QUESTION: "Which invariant is strengthened, weakened, reversed, repaired, or endangered?"
    LEDGER_EFFECT:
      QUESTION: "What debt is created, reduced, hidden, or unresolved?"
    TIME_HORIZON:
      QUESTION: "At which Ztime is this Lattice classification valid?"
    SCALE_SCOPE:
      QUESTION: "At which Zoom is this Lattice classification valid?"
    COUNTER_SIGNAL:
      QUESTION: "What evidence could weaken or reverse this classification?"
    CONFIDENCE:
      QUESTION: "How certain is the Lattice assignment?"
  HARD_RULES:
    - "No INV.LATT without intended-function test."
    - "No +LATT without hidden-debt test."
    - "No -LATT without invariant-damage test."
    - "No REP.LATT without repair-success criteria."
    - "No COL.LATT without repair-corridor closure evidence."
    - "No FRO.LATT without base-rent test."

INTENDED_FUNCTION_TEST_FOR_INVERSE_LATTICE:
  DESCRIPTION: >
    Inverse Lattice requires proof that a system's official form or claimed
    function is routing output against its own intended invariant.
  REQUIRED_STEPS:
    STEP_01_DECLARE_DOMAIN:
      QUESTION: "Which Domain ID is involved?"
      EXAMPLE: "CIV.GOV"
    STEP_02_DECLARE_INTENDED_FUNCTION:
      QUESTION: "What is the intended function of this domain?"
      EXAMPLE: "Governance should convert power into bounded coordination."
    STEP_03_DECLARE_CLAIMED_PUBLIC_FUNCTION:
      QUESTION: "What does the system claim it is doing?"
      EXAMPLE: "Protecting legality and order."
    STEP_04_OBSERVE_OUTPUT:
      QUESTION: "What output is actually produced?"
      EXAMPLE: "Audit channels are blocked."
    STEP_05_COMPARE_FUNCTION_TO_OUTPUT:
      QUESTION: "Does output preserve or reverse intended function?"
      EXAMPLE: "If law blocks accountability, output reverses governance invariant."
    STEP_06_RUN_VERIWEFT:
      TESTS:
        - "boundedness"
        - "auditability"
        - "return-to-floor"
        - "truth-preservation"
        - "repairability"
    STEP_07_ASSIGN_CONFIDENCE:
      QUESTION: "How strong is the evidence?"
  PASS_CONDITION_FOR_INV_LATT:
    - "Intended function is clear."
    - "Claimed public function is clear."
    - "Observed output contradicts intended function."
    - "Contradiction is not explained by temporary bounded exception."
    - "Evidence supports more than subjective dislike."

REPAIR_LATTICE_TEST:
  DESCRIPTION: >
    Repair Lattice must show real reduction of damage, not symbolic repair,
    public relations repair, or concealment.
  REQUIRED_TESTS:
    INVARIANT_IDENTIFIED:
      QUESTION: "Which invariant was damaged?"
    DAMAGE_RECORDED:
      QUESTION: "Is the damage recorded in Ledger?"
    RESPONSIBILITY_MAPPED:
      QUESTION: "Who or what created the debt?"
    COST_VISIBLE:
      QUESTION: "Who paid the cost?"
    REPAIR_ACTION_DEFINED:
      QUESTION: "What action restores function?"
    REPAIR_RATE_TEST:
      QUESTION: "Is RepairRate greater than or equal to DriftRate?"
      FORMULA: "RepairRate >= DriftRate"
    SUCCESS_CRITERIA:
      QUESTION: "What observable signs prove repair is working?"
    FAILURE_SIGNS:
      QUESTION: "What signs show repair is cosmetic or failing?"
  NOT_REPAIR_IF:
    - "Damage is denied."
    - "Victim or harmed subsystem is excluded."
    - "Debt is moved forward without record."
    - "Public relation replaces correction."
    - "System prevents audit."
    - "Repair language conceals inverse route."

FRONTIER_LATTICE_TEST:
  DESCRIPTION: >
    Frontier Lattice classifies future-expanding movement only if the frontier
    route preserves the base and pays continuity rent.
  CORE_FORMULA:
    P4_SUCCESS_REQUIRES: "P4 excursion + P3 rent paid + base floor preserved + repair capacity maintained"
  REQUIRED_TESTS:
    FRONTIER_CAPABILITY:
      QUESTION: "What new corridor or capability is opened?"
    BASE_RENT:
      QUESTION: "What cost is paid back to the stable operating floor?"
    FLOOR_PRESERVATION:
      QUESTION: "Does the frontier burn land, energy, trust, people, or institutions?"
    LEDGER_STATUS:
      QUESTION: "Is future debt recorded?"
    REPAIR_CAPACITY:
      QUESTION: "Can the system repair failures created by the frontier route?"
    REVERSIBILITY:
      QUESTION: "Can route be slowed, contained, or reversed if harmful?"
    INTERGENERATIONAL_EFFECT:
      QUESTION: "Does it improve or steal from future generations?"
  NOT_FRONTIER_LATT_IF:
    - "The route is only novelty."
    - "The route burns the base floor."
    - "The route creates hidden future debt."
    - "The route cannot be audited."
    - "The route destroys repair capacity."
    - "The route widens capability while narrowing survival."

COLLAPSE_LATTICE_TEST:
  DESCRIPTION: >
    Collapse Lattice should be used carefully. It does not mean difficulty,
    stress, conflict, or failure alone. It means repair corridors are closing
    faster than repair can operate.
  REQUIRED_COLLAPSE_MARKERS:
    - "Repair corridors closing."
    - "Ledger debt accelerating."
    - "Trust loss becoming self-reinforcing."
    - "Reality field captured or severely distorted."
    - "Base floor being burned."
    - "Control layer corrupted or captured."
    - "Emergency exceptions normalised."
    - "Institutional correction blocked."
    - "Future corridors narrowing rapidly."
  NOT_COLLAPSE_IF:
    - "Repair corridors remain active."
    - "Audit is functioning."
    - "Trust debt is being reduced."
    - "Base floor remains intact."
    - "System is stressed but correctable."
    - "Temporary failure is contained."
  HARD_RULE: "Do not use COL.LATT for dramatic language without repair-corridor evidence."

LATTICE_IN_CIVCOORD:
  DESCRIPTION: >
    Lattice appears inside CivCoord as the state overlay field. It must be
    paired with Shell ID, Domain ID, Zoom, Phase, Ztime, Evidence, Confidence,
    VeriWeft, Ledger, and Repair.
  MINIMUM_LATTICE_RECORD:
    LATTICE:
      STATE: null
      VALENCE: null
      ROUTE: null
      ROUTE_DESCRIPTION: null
      PRIOR_STATE: null
      POSSIBLE_NEXT_STATE: null
      INVARIANT_EFFECT: null
      LEDGER_EFFECT: null
      ZTIME_VALIDITY: null
      CONFIDENCE: null
  EXAMPLE:
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    LATTICE:
      STATE: "INV.LATT"
      VALENCE: "NEGATIVE"
      ROUTE: "LAW_AS_COSTUME"
      ROUTE_DESCRIPTION: "Law form protects unaccountable power instead of bounded public function."
      PRIOR_STATE: "DRIFT.LATT"
      POSSIBLE_NEXT_STATE: "COL.LATT via COCKPIT_CAPTURE"
      INVARIANT_EFFECT: "bounded power and auditability damaged"
      LEDGER_EFFECT: "trust debt and governance debt accumulating"
      ZTIME_VALIDITY: "T2.MID_TERM"
      CONFIDENCE: "MEDIUM"

EXAMPLE_01_SECURITY_POLICY_TIME_SPLIT:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "Emergency security policy introduced after public disorder."
    OBJECT_TYPE: "policy"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.SEC"
    DOMAIN_SECONDARY:
      - "CIV.GOV"
      - "CIV.REA"
      - "CIV.REP"
  LATTICE_BY_ZTIME:
    T0.IMMEDIATE:
      STATE: "+LATT"
      REASON: "May prevent immediate harm if proportionate."
    T1.SHORT_TERM:
      STATE: "0LATT"
      REASON: "Outcome depends on boundedness and transparency."
    T2.MID_TERM:
      STATE: "DRIFT.LATT"
      REASON: "If emergency powers persist and audit weakens."
    T3.LONG_TERM:
      STATE: "INV.LATT"
      REASON: "If security becomes control while claiming protection."
    T4.INTERGENERATIONAL:
      STATE: "-LATT"
      REASON: "If fear and distrust become civic memory."
    T5.FRONTIER_TIME:
      STATE: "COL.LATT"
      REASON: "If open future governance corridor is permanently narrowed."
  VERIWEFT_REQUIRED_TESTS:
    - "boundedness"
    - "proportionality"
    - "return-to-floor"
    - "auditability"
    - "truth-preservation"
  MORIARTY_NOTE: >
    Do not classify emergency security as good or evil by appearance.
    Test time horizon, boundedness, return-to-floor, Ledger debt, and repair path.

EXAMPLE_02_EDUCATION_FOUNDATION_REPAIR:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "Student rebuilds weak algebra foundation through structured tuition."
    OBJECT_TYPE: "education repair route"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.KNO"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.POP"
  PRIOR_LATTICE:
    STATE: "-LATT"
    ROUTE: "PATHWAY_CHAIR_COMPRESSION"
    REASON: "Weak foundation narrows future options."
  CURRENT_LATTICE:
    STATE: "REP.LATT"
    ROUTE: "FOUNDATION_REPAIR"
    REASON: "Structured repair rebuilds knowledge and reduces time debt."
  POSSIBLE_NEXT_LATTICE:
    IF_REPAIR_SUCCESS:
      STATE: "+LATT"
      ROUTE: "CAPABILITY_GAIN"
      REASON: "Student regains confidence, transfer, and future optionality."
    IF_REPAIR_FAILS:
      STATE: "DRIFT.LATT"
      ROUTE: "SKILL_DECAY"
      REASON: "Repeated weak transfer continues."
  LEDGER:
    DEBT_TYPES:
      - "KNOWLEDGE_DEBT"
      - "CONFIDENCE_DEBT"
      - "TIME_DEBT"
    REPAIR_SUCCESS_CRITERIA:
      - "fewer repeated errors"
      - "higher transfer accuracy"
      - "greater independent problem solving"
      - "future subject corridor remains open"

EXAMPLE_03_CULTURE_ADAPTATION_VS_LOSS:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "A community changes rituals and language use across generations."
    OBJECT_TYPE: "culture signal"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.CUL"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.KNO"
      - "CIV.LED"
  POSSIBLE_LATTICE_STATES:
    LIVING_ADAPTATION:
      STATE: "+LATT"
      ROUTE: "CULTURE_RENEWAL"
      CONDITION: "Core memory, dignity, and meaning remain alive while form adapts."
    NEUTRAL_TRANSFORMATION:
      STATE: "0LATT"
      ROUTE: "UNDECIDED_ROUTE"
      CONDITION: "Change is happening but effect on memory and meaning is unclear."
    CULTURE_DRIFT:
      STATE: "DRIFT.LATT"
      ROUTE: "CULTURE_MEMORY_LOSS"
      CONDITION: "Transmission weakens gradually but repair remains possible."
    CULTURE_DEBT:
      STATE: "-LATT"
      ROUTE: "CULTURE_DEPRECIATION"
      CONDITION: "Language, ritual, memory, and identity continuity are materially damaged."
    INVERSE_CULTURE:
      STATE: "INV.LATT"
      ROUTE: "CULTURE_AS_EXCLUSION_MACHINE"
      CONDITION: "Culture claims belonging but produces dehumanisation or exclusion."
  HARD_RULE: >
    Do not treat all cultural change as loss.
    Do not treat all preservation as health.
    Test living function, memory transfer, dignity, adaptation, and Ledger debt.

EXAMPLE_04_REALITY_FIELD_DRIFT:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "News and public signals produce distorted accepted reality."
    OBJECT_TYPE: "reality signal"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.REA"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.GOV"
      - "CIV.REP"
  LATTICE:
    STATE: "DRIFT.LATT"
    ROUTE: "REALITY_FOG_INCREASE"
    VALENCE: "NEGATIVE_IF_UNREPAIRED"
    ROUTE_DESCRIPTION: "Public reality moves away from evidence through repeated distortion."
  POSSIBLE_TRANSITIONS:
    DRIFT_TO_REPAIR:
      CONDITION: "source calibration, correction, transparency, archive repair"
      NEXT_STATE: "REP.LATT"
    DRIFT_TO_INVERSE:
      CONDITION: "official or media form captures reality against evidence"
      NEXT_STATE: "INV.LATT"
    DRIFT_TO_COLLAPSE:
      CONDITION: "shared reality field breaks and repair/correction is impossible"
      NEXT_STATE: "COL.LATT"
  LEDGER:
    DEBT_TYPES:
      - "REALITY_DEBT"
      - "TRUST_DEBT"
      - "LANGUAGE_DEBT"
  VERIWEFT_TESTS:
    - "source traceability"
    - "claim separation"
    - "counter-signal inclusion"
    - "correction pathway"
    - "archive integrity"

EXAMPLE_05_FRONTIER_EXCURSION:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "A civilisation opens a new advanced technological or space corridor."
    OBJECT_TYPE: "frontier route"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L4.SHELL.CONTINUITY"
    DOMAIN_PRIMARY: "CIV.FRO"
    DOMAIN_SECONDARY:
      - "CIV.P4"
      - "CIV.KNO"
      - "CIV.BAS"
      - "CIV.REP"
  LATTICE:
    STATE: "FRO.LATT"
    ROUTE: "FRONTIER_APERTURE"
    VALENCE: "FRONTIER_CONDITIONAL"
    ROUTE_DESCRIPTION: "New future corridor opens if base floor and repair capacity are preserved."
  REQUIRED_BASE_RENT_TEST:
    - "Does the route preserve energy, water, ecology, people, trust, and institutions?"
    - "Does it record future debt?"
    - "Does it maintain repair capacity?"
    - "Does it widen future options rather than narrowing them?"
  POSSIBLE_TRANSITIONS:
    SUCCESS:
      FROM: "FRO.LATT"
      TO: "+LATT"
      CONDITION: "frontier capability stabilises and pays base rent"
    FAILURE:
      FROM: "FRO.LATT"
      TO: "COL.LATT"
      CONDITION: "frontier burns P3 floor and closes repair corridors"

LATTICE_CLASSIFICATION_RUNTIME:
  STEP_01_LOCATE_DOMAIN:
    QUESTION: "Which Shell ID and Domain ID are involved?"
    OUTPUT: "CIV.Lx.SHELL.y::CIV.DOMAIN"
  STEP_02_DECLARE_INTENDED_FUNCTION:
    QUESTION: "What is the intended function of the domain?"
    OUTPUT: "Function statement"
  STEP_03_OBSERVE_OUTPUT:
    QUESTION: "What is the observed output or claim?"
    OUTPUT: "Observed signal"
  STEP_04_TEST_INVARIANT_EFFECT:
    QUESTION: "Which invariant is strengthened, weakened, repaired, reversed, or endangered?"
    OUTPUT: "Invariant effect"
  STEP_05_TEST_ZTIME:
    QUESTION: "Does valence change across time horizon?"
    OUTPUT: "T0-T5 state map"
  STEP_06_TEST_ZOOM:
    QUESTION: "Does valence change across scale?"
    OUTPUT: "Z0-Z8 state map"
  STEP_07_TEST_LEDGER:
    QUESTION: "What debt is created, reduced, hidden, or unresolved?"
    OUTPUT: "Ledger effect"
  STEP_08_TEST_VERIWEFT:
    QUESTION: "Do relationships pass validity checks?"
    OUTPUT: "PASS, WARN, FAIL, UNKNOWN"
  STEP_09_ASSIGN_LATTICE_STATE:
    QUESTION: "Which Lattice state best fits the evidence?"
    OUTPUT: "+LATT, 0LATT, -LATT, INV.LATT, DRIFT.LATT, REP.LATT, COL.LATT, FRO.LATT"
  STEP_10_ASSIGN_CONFIDENCE:
    QUESTION: "How certain is this state?"
    OUTPUT: "LOW, MEDIUM, HIGH"
  STEP_11_OUTPUT_ROUTE:
    QUESTION: "What repair, audit, containment, reversal, or proceed route follows?"
    OUTPUT: "Repair Runtime output"

MORIARTY_ATTACK_AND_HARDENING:
  ATTACK_01_MORAL_ASTROLOGY:
    ATTACK: "Positive and negative Lattice become subjective good/bad labels."
    FAILURE: "Lattice turns into ideology."
    HARDENING: "Tie Lattice to invariant effect, Ledger debt, evidence, time, and repair."
  ATTACK_02_LAYER_REPLACEMENT:
    ATTACK: "Lattice becomes another Layer."
    FAILURE: "Layer/Shell/ID architecture collapses."
    HARDENING: "Lattice is overlay only. It never replaces Layer, Shell, or ID."
  ATTACK_03_DOMAIN_ID_CONTAMINATION:
    ATTACK: "AI creates IDs like CIV.BAD.GOV or CIV.GOOD.CULTURE."
    FAILURE: "State contaminates ontology."
    HARDENING: "Domain IDs remain neutral. State appears only in Lattice field."
  ATTACK_04_TIMELESS_CLASSIFICATION:
    ATTACK: "AI says a route is positive or negative without time horizon."
    FAILURE: "Short-term and long-term effects are confused."
    HARDENING: "Ztime required for all Lattice classification."
  ATTACK_05_SCALELESS_CLASSIFICATION:
    ATTACK: "AI says a route is civilisation-level from local signal."
    FAILURE: "Scale jump error."
    HARDENING: "Zoom and scale bridge required."
  ATTACK_06_INVERSE_OVERUSE:
    ATTACK: "AI calls everything it dislikes inverse."
    FAILURE: "Inverse Lattice loses diagnostic power."
    HARDENING: "Require intended-function test and evidence of opposite output."
  ATTACK_07_REPAIR_WASHING:
    ATTACK: "System calls concealment or PR repair."
    FAILURE: "Damage remains hidden."
    HARDENING: "Repair Lattice requires Ledger reduction and success criteria."
  ATTACK_08_COLLAPSE_DRAMA:
    ATTACK: "AI uses collapse for dramatic stress."
    FAILURE: "Collapse classification becomes noise."
    HARDENING: "Collapse requires repair corridor closure evidence."
  ATTACK_09_FRONTIER_ROMANCE:
    ATTACK: "AI calls novelty frontier."
    FAILURE: "Future corridor language hides base burn."
    HARDENING: "Frontier Lattice requires base rent and repair capacity."

ANTI_CONFUSION_RULES:
  - "Do not treat Lattice as morality."
  - "Do not treat Lattice as Layer."
  - "Do not treat Lattice as Domain ID."
  - "Do not classify +LATT without hidden-debt check."
  - "Do not classify -LATT without invariant-damage check."
  - "Do not classify INV.LATT without intended-function test."
  - "Do not classify REP.LATT without repair-success criteria."
  - "Do not classify COL.LATT without repair-corridor closure evidence."
  - "Do not classify FRO.LATT without base-rent test."
  - "Do not omit Ztime."
  - "Do not omit Zoom."
  - "Do not omit Evidence."
  - "Do not mistake confidence for structure."
  - "Do not mistake public claim for actual route."

MINIMUM_VALID_LATTICE_RECORD:
  VERSION: "CIVSTACK.RA.AI.v1"
  MACHINE_ADDRESS:
    SHELL_ID: null
    DOMAIN_PRIMARY: null
  LATTICE:
    STATE: null
    VALENCE: null
    ROUTE: null
    ROUTE_DESCRIPTION: null
  FUNCTION_TEST:
    DOMAIN_INTENDED_FUNCTION: null
    OBSERVED_OUTPUT: null
    INVARIANT_EFFECT: null
  TIME_TEST:
    ZTIME_PRIMARY: null
    TIME_HORIZON_REASON: null
  SCALE_TEST:
    ZOOM_PRIMARY: null
    SCALE_LIMITS: []
  LEDGER_TEST:
    LEDGER_STATUS: null
    DEBT_TYPES: []
    DEBT_EFFECT: null
  VERIWEFT_TEST:
    STATUS: null
    TESTS_PASSED: []
    TESTS_FAILED: []
    TESTS_UNKNOWN: []
  EVIDENCE:
    OBSERVED_SIGNAL: null
    SOURCE_TYPE: null
    CLAIM_TYPE: null
    EVIDENCE_STRENGTH: null
    COUNTER_SIGNAL: null
    UNCERTAINTY: null
  CONFIDENCE:
    LEVEL: null
    REASON: null
  REPAIR_OUTPUT:
    OUTPUT_TYPE: null
    REQUIRED_ACTIONS: []

CANONICAL_LOCK:
  FULL_LOCK: >
    The Lattice Overlay is the state-space and corridor geometry of the
    Civilisation Layer Stack AI/LLM architecture. Layers and Shells tell AI
    where a civilisation object sits. Domain IDs tell AI what subsystem is
    involved. Lattice tells AI what state and route the subsystem is moving
    through. A valid Lattice classification requires evidence, invariant-effect
    testing, Ztime, Zoom, Ledger check, VeriWeft validity, confidence, and repair
    output.
  SHORT_LOCK: >
    Layer locates Shell.
    ID locates Domain.
    Lattice locates State and Route.
    Ztime tests when.
    Zoom tests where.
    Ledger records cost.
    VeriWeft tests validity.
    Repair outputs route.
  MORIARTY_LOCK: >
    No Lattice without evidence.
    No Positive without hidden-debt test.
    No Negative without invariant-damage test.
    No Inverse without intended-function test.
    No Repair without Ledger reduction.
    No Collapse without repair-corridor closure.
    No Frontier without base rent.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.005"
  NEXT_ARTICLE_TITLE: "VeriWeft Validity Architecture"
  NEXT_ARTICLE_FUNCTION: >
    Define VeriWeft as the structural validity layer that tests whether movement
    between Shell, Domain ID, Lattice state, Zoom, Phase, Ztime, Ledger, and
    Repair is admissible.
  NEXT_ARTICLE_OUTPUTS:
    - "VeriWeft definition"
    - "Validity test registry"
    - "Boundedness and return-to-floor tests"
    - "Function-match tests"
    - "Truth-preservation and auditability tests"
    - "Repairability and future-continuity tests"
    - "PASS/WARN/FAIL/UNKNOWN schema"

ARTICLE:
  PUBLIC_TITLE: "VeriWeft Validity Architecture"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.005"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.005"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define VeriWeft as the structural validity fabric that tests whether
    Shell, Domain ID, Lattice state, Zoom, Phase, Ztime, Ledger, Evidence,
    Confidence, and Repair Output form an admissible civilisation coordinate.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, validity testing, relationship audit"

CORE_DEFINITION:
  VERIWEFT:
    FULL_NAME: "VeriWeft Validity Fabric"
    MACHINE_NAME: "CIV.VERIWEFT"
    FUNCTION: >
      VeriWeft is the validation fabric of the Civilisation Layer Stack AI/LLM
      architecture. It checks whether the relationship between public Shell,
      machine ID, Lattice state, Zoom, Phase, Ztime, Ledger, Evidence, Confidence,
      and Repair Output is structurally admissible.
  ONE_SENTENCE: >
    VeriWeft tells AI whether the civilisation coordinate is validly woven
    together or whether the classification breaks its own structure.
  SHORT_FORMULA: >
    VeriWeft = Relationship Validity.
  COMPRESSED_CHAIN: >
    Shell -> ID -> Lattice -> Zoom -> Phase -> Ztime -> Ledger -> Evidence -> Repair
    must pass validity checks before classification is trusted.
  HARD_RULE: >
    A neat CivCoord is not automatically valid. VeriWeft must test whether
    the coordinate’s parts fit, whether the evidence supports the state, whether
    scale and time are bounded, and whether repair follows the correct invariant.

WHY_VERIWEFT_EXISTS:
  PROBLEM:
    DESCRIPTION: >
      AI can produce structured outputs that look precise but are internally
      invalid. A classification may have Shell ID, Domain ID, Lattice state,
      Zoom, Phase, and Repair fields, but still be wrong because the relationship
      between them is unsupported, over-scaled, time-blind, morally contaminated,
      or missing evidence.
    COMMON_FAILURES:
      - "Correct domain but wrong Lattice state."
      - "Correct Layer but overloaded as exact category."
      - "Correct Lattice but wrong Zoom."
      - "Correct short-term reading but wrong long-term reading."
      - "Repair output does not repair the damaged invariant."
      - "High confidence assigned to weak evidence."
      - "Inverse Lattice claimed without intended-function test."
      - "Collapse claimed without repair-corridor closure."
      - "Frontier claimed without base-rent test."
      - "Positive classification assigned while Ledger debt is hidden."
  SOLUTION:
    DESCRIPTION: >
      VeriWeft acts as a structural audit layer. It validates relationships
      between the architecture fields before the AI is allowed to treat the
      coordinate as usable.
  RESULT:
    - "AI can separate complete-looking records from valid records."
    - "AI can detect broken relationships."
    - "AI can mark PASS, WARN, FAIL, or UNKNOWN."
    - "AI can require more evidence before overclaiming."
    - "AI can prevent public shell confusion."
    - "AI can prevent Lattice moral astrology."
    - "AI can prevent repair washing."

VERIWEFT_POSITION_IN_ARCHITECTURE:
  DESCRIPTION: >
    VeriWeft sits after initial classification and before final repair output.
    It does not replace CivCoord. It validates CivCoord.
  ARCHITECTURE_CHAIN:
    STEP_01: "Layer / Shell selected"
    STEP_02: "Shell ID assigned"
    STEP_03: "Domain ID assigned"
    STEP_04: "Lattice state proposed"
    STEP_05: "Zoom selected"
    STEP_06: "Phase selected"
    STEP_07: "Ztime selected"
    STEP_08: "Ledger effects recorded"
    STEP_09: "Evidence entered"
    STEP_10: "VeriWeft validation run"
    STEP_11: "Confidence adjusted"
    STEP_12: "Repair output generated"
  SHORT_CHAIN: >
    Classify -> Validate -> Adjust Confidence -> Route Repair
  HARD_RULE: >
    Do not output final classification until VeriWeft has checked relationship validity.

VERIWEFT_STATUS_REGISTRY:
  PASS:
    CODE: "VERIWEFT.PASS"
    MEANING: "The coordinate relationship is structurally admissible."
    CONDITIONS:
      - "Shell and Domain ID fit."
      - "Lattice state is supported by evidence."
      - "Zoom is justified."
      - "Ztime is declared."
      - "Phase is plausible."
      - "Ledger status matches evidence."
      - "Repair output follows damaged invariant."
      - "Confidence matches evidence strength."
  WARN:
    CODE: "VERIWEFT.WARN"
    MEANING: "The coordinate may be usable, but some fields are weak, uncertain, or incomplete."
    CONDITIONS:
      - "Evidence is partial."
      - "Scale bridge is incomplete."
      - "Time horizon may shift classification."
      - "Lattice state is plausible but not proven."
      - "Repair route is reasonable but success criteria are incomplete."
      - "Counter-signals need checking."
  FAIL:
    CODE: "VERIWEFT.FAIL"
    MEANING: "The coordinate relationship is structurally invalid."
    CONDITIONS:
      - "Layer is treated as exact domain."
      - "State is encoded inside ID."
      - "Lattice lacks evidence."
      - "Zoom jump is unsupported."
      - "Ztime is missing."
      - "Repair output does not address damaged invariant."
      - "Confidence exceeds evidence."
      - "Ledger debt is ignored."
      - "Inverse, Collapse, or Frontier classification fails required tests."
  UNKNOWN:
    CODE: "VERIWEFT.UNKNOWN"
    MEANING: "Insufficient information to validate the coordinate."
    CONDITIONS:
      - "Evidence missing."
      - "Source type unknown."
      - "Claim type unknown."
      - "Time horizon unclear."
      - "Scale unclear."
      - "Domain unclear."
      - "Counter-signals unavailable."

CORE_VERIWEFT_TESTS:
  SHELL_DOMAIN_FIT:
    QUESTION: "Does the Domain ID belong to the selected Shell as primary or declared secondary?"
    PASS_CONDITION: "Domain placement is valid."
    FAIL_CONDITION: "Domain has no declared relationship to Shell."
    EXAMPLE_PASS: "CIV.L2.SHELL.ORDER::CIV.GOV"
    EXAMPLE_FAIL: "CIV.L0.SHELL.BASE::CIV.CUL without declared crosswalk."
  FUNCTION_MATCH:
    QUESTION: "Does the observed output match the intended function of the Domain ID?"
    PASS_CONDITION: "Output supports or reasonably extends intended function."
    FAIL_CONDITION: "Output contradicts intended function."
    USED_FOR: "Detecting INV.LATT."
  EVIDENCE_SUPPORT:
    QUESTION: "Does evidence support the proposed Lattice state?"
    PASS_CONDITION: "Observed signal, source type, claim type, and invariant effect align."
    FAIL_CONDITION: "Lattice state is asserted without evidence."
    USED_FOR: "Preventing false precision."
  ZOOM_BOUNDARY:
    QUESTION: "Is the scale of the claim supported?"
    PASS_CONDITION: "Zoom level matches evidence, or bridge signals justify scale movement."
    FAIL_CONDITION: "Local signal is inflated to civilisation claim without bridge."
    USED_FOR: "Preventing scale jump."
  ZTIME_BOUNDARY:
    QUESTION: "Is the time horizon declared and appropriate?"
    PASS_CONDITION: "Classification states whether it applies immediately, short-term, mid-term, long-term, intergenerationally, or frontier-time."
    FAIL_CONDITION: "Timeless valence classification."
    USED_FOR: "Preventing time-slice distortion."
  LEDGER_ALIGNMENT:
    QUESTION: "Does Ledger status match the Lattice state and evidence?"
    PASS_CONDITION: "Debt, damage, repair, or clear status is recorded."
    FAIL_CONDITION: "Positive or stable classification ignores hidden debt."
    USED_FOR: "Preventing hidden collapse."
  REPAIR_ALIGNMENT:
    QUESTION: "Does Repair Output address the damaged invariant?"
    PASS_CONDITION: "Repair action reduces relevant debt or restores damaged function."
    FAIL_CONDITION: "Repair is cosmetic, unrelated, or ideological."
    USED_FOR: "Preventing repair washing."
  CONFIDENCE_ALIGNMENT:
    QUESTION: "Does Confidence match evidence strength and uncertainty?"
    PASS_CONDITION: "Confidence level is proportional to evidence strength."
    FAIL_CONDITION: "High confidence with weak or missing evidence."
    USED_FOR: "Preventing hallucinated certainty."

BOUNDARY_TEST_REGISTRY:
  BOUNDEDNESS_TEST:
    QUESTION: "Is the action or system behaviour bounded by legitimate limits?"
    APPLIES_TO:
      - "CIV.GOV"
      - "CIV.SEC"
      - "CIV.REP"
      - "CIV.REA"
    PASS:
      - "limits are defined"
      - "scope is narrow"
      - "authority is reviewable"
      - "duration is declared"
    FAIL:
      - "scope expands without limit"
      - "authority cannot be challenged"
      - "exception becomes default"
      - "limits are hidden"
  RETURN_TO_FLOOR_TEST:
    QUESTION: "If an emergency or exceptional action occurs, does it return to normal floor?"
    APPLIES_TO:
      - "security policy"
      - "emergency governance"
      - "war powers"
      - "public health restrictions"
      - "temporary censorship claims"
    PASS:
      - "clear end condition"
      - "independent review"
      - "normal rights restored"
      - "Ledger records cost"
    FAIL:
      - "temporary power becomes permanent"
      - "audit blocked"
      - "cost hidden"
      - "public reality distorted"
  PROPORTIONALITY_TEST:
    QUESTION: "Is the cost proportional to the protected invariant?"
    PASS:
      - "harm prevented exceeds justified cost"
      - "least damaging route selected"
      - "cost recorded"
      - "affected parties considered"
    FAIL:
      - "excessive cost"
      - "unrecorded harm"
      - "weaker groups carry disproportionate burden"
      - "repair path absent"
  AUDITABILITY_TEST:
    QUESTION: "Can the action, claim, institution, or route be checked and corrected?"
    PASS:
      - "evidence accessible"
      - "independent audit possible"
      - "correction route exists"
      - "records preserved"
    FAIL:
      - "evidence inaccessible"
      - "authority self-certifies"
      - "records missing"
      - "correction blocked"
  TRUTH_PRESERVATION_TEST:
    QUESTION: "Does the route preserve the reality field?"
    PASS:
      - "claims are separated from evidence"
      - "source traceability remains"
      - "corrections are possible"
      - "counter-signals are not erased"
    FAIL:
      - "official claim replaces evidence"
      - "source pathway hidden"
      - "counter-signals suppressed"
      - "accepted reality is captured"
  REPAIRABILITY_TEST:
    QUESTION: "Can damage caused by the route be repaired?"
    PASS:
      - "damage visible"
      - "cost recorded"
      - "responsible actor identifiable"
      - "repair action possible"
      - "success criteria observable"
    FAIL:
      - "damage hidden"
      - "cost displaced"
      - "no responsible actor"
      - "repair corridors closed"
  FUTURE_CONTINUITY_TEST:
    QUESTION: "Does the route preserve future viability?"
    PASS:
      - "future floor protected"
      - "base rent paid"
      - "intergenerational debt recorded"
      - "future options widened"
    FAIL:
      - "future floor burned"
      - "children inherit hidden debt"
      - "frontier route cannibalises base"
      - "repair capacity reduced"

SPECIAL_VERIWEFT_TESTS_BY_LATTICE:
  POSITIVE_LATTICE_TEST:
    LATTICE_STATE: "+LATT"
    REQUIRED_TESTS:
      - "hidden debt test"
      - "future continuity test"
      - "Ledger clear or repair-positive"
      - "time-sliced valence check"
    FAIL_IF:
      - "short-term benefit hides long-term debt"
      - "one group benefits by transferring cost to another"
      - "future floor is burned"
  NEGATIVE_LATTICE_TEST:
    LATTICE_STATE: "-LATT"
    REQUIRED_TESTS:
      - "invariant damage test"
      - "debt creation test"
      - "counter-signal test"
      - "repair possibility test"
    FAIL_IF:
      - "classification is based only on discomfort or dislike"
      - "cost is necessary, bounded, and repair-positive"
      - "evidence does not show invariant damage"
  INVERSE_LATTICE_TEST:
    LATTICE_STATE: "INV.LATT"
    REQUIRED_TESTS:
      - "intended function declared"
      - "claimed public function declared"
      - "observed output compared"
      - "function-output contradiction shown"
      - "bounded exception ruled out or unresolved"
    FAIL_IF:
      - "intended function is unclear"
      - "evidence only shows disagreement"
      - "temporary bounded exception explains output"
      - "opposite-output claim is unsupported"
  DRIFT_LATTICE_TEST:
    LATTICE_STATE: "DRIFT.LATT"
    REQUIRED_TESTS:
      - "prior state comparison"
      - "direction of movement"
      - "repeated signal"
      - "maintenance or correction gap"
      - "Ledger trend"
    FAIL_IF:
      - "single isolated event"
      - "no directional evidence"
      - "repair already active and effective"
  REPAIR_LATTICE_TEST:
    LATTICE_STATE: "REP.LATT"
    REQUIRED_TESTS:
      - "damaged invariant identified"
      - "Ledger debt recorded"
      - "repair action tied to debt"
      - "success criteria defined"
      - "RepairRate >= DriftRate"
    FAIL_IF:
      - "repair is only symbolic"
      - "repair hides damage"
      - "harmed subsystem excluded"
      - "debt remains unrecorded"
  COLLAPSE_LATTICE_TEST:
    LATTICE_STATE: "COL.LATT"
    REQUIRED_TESTS:
      - "repair corridor closure"
      - "debt acceleration"
      - "trust freefall or reality capture"
      - "floor burn or cockpit capture"
      - "phase degradation"
    FAIL_IF:
      - "system is stressed but repairable"
      - "audit still works"
      - "repair corridors remain open"
      - "claim is dramatic but unproven"
  FRONTIER_LATTICE_TEST:
    LATTICE_STATE: "FRO.LATT"
    REQUIRED_TESTS:
      - "frontier capability identified"
      - "base rent paid"
      - "P3 floor preserved"
      - "repair capacity maintained"
      - "future debt recorded"
    FAIL_IF:
      - "route is merely novel"
      - "base floor is burned"
      - "future debt hidden"
      - "repair capacity reduced"

VERIWEFT_RECORD_SCHEMA:
  VERIWEFT:
    STATUS: null
    OVERALL_REASON: null
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: null
        REASON: null
      FUNCTION_MATCH:
        STATUS: null
        REASON: null
      EVIDENCE_SUPPORT:
        STATUS: null
        REASON: null
      ZOOM_BOUNDARY:
        STATUS: null
        REASON: null
      ZTIME_BOUNDARY:
        STATUS: null
        REASON: null
      LEDGER_ALIGNMENT:
        STATUS: null
        REASON: null
      REPAIR_ALIGNMENT:
        STATUS: null
        REASON: null
      CONFIDENCE_ALIGNMENT:
        STATUS: null
        REASON: null
    BOUNDARY_TESTS:
      BOUNDEDNESS:
        STATUS: null
        REASON: null
      RETURN_TO_FLOOR:
        STATUS: null
        REASON: null
      PROPORTIONALITY:
        STATUS: null
        REASON: null
      AUDITABILITY:
        STATUS: null
        REASON: null
      TRUTH_PRESERVATION:
        STATUS: null
        REASON: null
      REPAIRABILITY:
        STATUS: null
        REASON: null
      FUTURE_CONTINUITY:
        STATUS: null
        REASON: null
    TESTS_PASSED: []
    TESTS_WARNED: []
    TESTS_FAILED: []
    TESTS_UNKNOWN: []
    REQUIRED_MORE_EVIDENCE: []
    CONFIDENCE_ADJUSTMENT: null
    REPAIR_OUTPUT_ADJUSTMENT: null

VERIWEFT_RUNTIME:
  STEP_01_CHECK_SHELL_DOMAIN:
    QUESTION: "Does Domain ID fit Shell ID?"
    IF_PASS: "Continue."
    IF_FAIL: "Return VERIWEFT.FAIL and request corrected address."
  STEP_02_CHECK_FUNCTION:
    QUESTION: "Does observed output match domain intended function?"
    IF_MATCH: "Continue."
    IF_CONTRADICTS: "Consider INV.LATT, but require evidence."
  STEP_03_CHECK_EVIDENCE:
    QUESTION: "Does evidence support proposed Lattice state?"
    IF_STRONG: "Continue."
    IF_PARTIAL: "Set WARN and lower confidence."
    IF_MISSING: "Set UNKNOWN or FAIL."
  STEP_04_CHECK_ZOOM:
    QUESTION: "Is scale supported by evidence?"
    IF_UNSUPPORTED_SCALE_JUMP: "Set FAIL or WARN and restrict Zoom."
  STEP_05_CHECK_ZTIME:
    QUESTION: "Is time horizon declared and tested?"
    IF_MISSING: "Set FAIL for final classification."
    IF_PARTIAL: "Set WARN."
  STEP_06_CHECK_LEDGER:
    QUESTION: "Does Ledger match state and evidence?"
    IF_HIDDEN_DEBT: "Block +LATT or stable classification."
    IF_REPAIR_DEBT_REDUCED: "Allow REP.LATT if success criteria exist."
  STEP_07_CHECK_BOUNDARIES:
    QUESTION: "Do boundedness, proportionality, auditability, truth, repair, and future tests pass?"
    IF_FAIL: "Adjust Lattice, confidence, or repair output."
  STEP_08_CHECK_REPAIR:
    QUESTION: "Does Repair Output address damaged invariant?"
    IF_NO: "Set repair alignment FAIL."
    IF_YES: "Allow repair route."
  STEP_09_CHECK_CONFIDENCE:
    QUESTION: "Does confidence match evidence strength?"
    IF_OVERCONFIDENT: "Lower confidence."
  STEP_10_OUTPUT_VERIWEFT_STATUS:
    OUTPUTS:
      - "PASS"
      - "WARN"
      - "FAIL"
      - "UNKNOWN"

CONFIDENCE_ADJUSTMENT_RULES:
  DESCRIPTION: >
    VeriWeft can adjust confidence downward even when a coordinate is complete.
    Complete structure is not proof.
  DOWNGRADE_TO_LOW_IF:
    - "source type unknown"
    - "claim type unclear"
    - "evidence missing"
    - "counter-signals unavailable"
    - "Lattice state inferred from rhetoric"
    - "Zoom bridge absent"
    - "Ztime omitted"
    - "repair success criteria absent"
  DOWNGRADE_TO_MEDIUM_IF:
    - "evidence is plausible but partial"
    - "counter-signals not fully checked"
    - "scale bridge incomplete"
    - "time horizon uncertain"
    - "intent cannot be proven"
    - "Ledger debt estimated but not measured"
  ALLOW_HIGH_CONFIDENCE_IF:
    - "evidence is strong"
    - "source is traceable"
    - "claim type is clear"
    - "counter-signals checked"
    - "scale bridge confirmed"
    - "Ztime tested"
    - "Ledger status documented"
    - "repair criteria observable"
  HARD_RULE: "VeriWeft may validate structure while still assigning LOW confidence."

EXAMPLE_01_VALID_GOVERNANCE_DRIFT:
  INPUT_CIVCOORD:
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    LATTICE_STATE: "DRIFT.LATT"
    ZOOM: "Z4.NATION"
    PHASE: "P2.STRESSED"
    ZTIME: "T2.MID_TERM"
    LEDGER_STATUS: "ACCUMULATING"
    EVIDENCE_STRENGTH: "MEDIUM"
    CONFIDENCE: "MEDIUM"
    REPAIR_OUTPUT: "AUDIT"
  VERIWEFT:
    STATUS: "WARN"
    OVERALL_REASON: >
      Coordinate is structurally plausible but needs stronger evidence and
      independent audit before PASS.
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "PASS"
        REASON: "CIV.GOV belongs to CIV.L2.SHELL.ORDER."
      FUNCTION_MATCH:
        STATUS: "WARN"
        REASON: "Governance output may be drifting from accountability but inverse state not proven."
      EVIDENCE_SUPPORT:
        STATUS: "WARN"
        REASON: "Evidence is medium, not high."
      ZOOM_BOUNDARY:
        STATUS: "PASS"
        REASON: "Z4 claim supported if institution is national."
      ZTIME_BOUNDARY:
        STATUS: "PASS"
        REASON: "T2 mid-term horizon declared."
      LEDGER_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Trust and governance debt accumulating fits drift."
      REPAIR_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Audit addresses accountability drift."
      CONFIDENCE_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Medium confidence matches medium evidence."
    TESTS_PASSED:
      - "SHELL_DOMAIN_FIT"
      - "ZOOM_BOUNDARY"
      - "ZTIME_BOUNDARY"
      - "LEDGER_ALIGNMENT"
      - "REPAIR_ALIGNMENT"
      - "CONFIDENCE_ALIGNMENT"
    TESTS_WARNED:
      - "FUNCTION_MATCH"
      - "EVIDENCE_SUPPORT"
    TESTS_FAILED: []
    TESTS_UNKNOWN:
      - "TRUTH_PRESERVATION"
      - "RETURN_TO_FLOOR"
    REQUIRED_MORE_EVIDENCE:
      - "independent audit record"
      - "counter-signal review"
      - "duration of accountability weakening"

EXAMPLE_02_INVALID_INVERSE_CLAIM:
  INPUT_CIVCOORD:
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    LATTICE_STATE: "INV.LATT"
    ZOOM: "Z4.NATION"
    PHASE: "P2.STRESSED"
    ZTIME: "T2.MID_TERM"
    EVIDENCE_STRENGTH: "LOW"
    CONFIDENCE: "HIGH"
    REPAIR_OUTPUT: "REVERSE"
  VERIWEFT:
    STATUS: "FAIL"
    OVERALL_REASON: >
      Inverse Lattice is claimed with low evidence and high confidence.
      Intended-function contradiction has not been proven.
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "PASS"
        REASON: "CIV.GOV belongs to CIV.L2.SHELL.ORDER."
      FUNCTION_MATCH:
        STATUS: "UNKNOWN"
        REASON: "Observed output has not been sufficiently compared to intended governance function."
      EVIDENCE_SUPPORT:
        STATUS: "FAIL"
        REASON: "Low evidence cannot support high-confidence inverse classification."
      ZOOM_BOUNDARY:
        STATUS: "WARN"
        REASON: "National scale may be correct but bridge evidence is not shown."
      ZTIME_BOUNDARY:
        STATUS: "PASS"
        REASON: "T2 declared."
      LEDGER_ALIGNMENT:
        STATUS: "UNKNOWN"
        REASON: "Debt types not documented."
      REPAIR_ALIGNMENT:
        STATUS: "FAIL"
        REASON: "Reverse output is too strong before inverse state is validated."
      CONFIDENCE_ALIGNMENT:
        STATUS: "FAIL"
        REASON: "High confidence conflicts with low evidence."
    REQUIRED_CORRECTION:
      - "Downgrade confidence to LOW."
      - "Change Lattice to UNKNOWN or DRIFT.LATT if evidence supports drift."
      - "Set Repair Output to PROBE or AUDIT."
      - "Add intended-function test."
      - "Add evidence and counter-signal fields."

EXAMPLE_03_VALID_EDUCATION_REPAIR:
  INPUT_CIVCOORD:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.KNO"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.POP"
    PRIOR_LATTICE_STATE: "-LATT"
    CURRENT_LATTICE_STATE: "REP.LATT"
    ROUTE: "FOUNDATION_REPAIR"
    ZOOM: "Z0.INDIVIDUAL"
    PHASE: "P2.STRESSED"
    ZTIME: "T2.MID_TERM"
    LEDGER_STATUS: "REPAIRING"
    DEBT_TYPES:
      - "KNOWLEDGE_DEBT"
      - "CONFIDENCE_DEBT"
      - "TIME_DEBT"
    EVIDENCE_STRENGTH: "MEDIUM"
    CONFIDENCE: "MEDIUM"
    REPAIR_OUTPUT: "REPAIR"
  VERIWEFT:
    STATUS: "PASS"
    OVERALL_REASON: >
      Repair route is structurally aligned because weak knowledge foundation
      is recorded as debt and the repair action directly targets the damaged
      invariant.
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "PASS"
        REASON: "CIV.KNO belongs to CIV.L3.SHELL.MIND."
      FUNCTION_MATCH:
        STATUS: "PASS"
        REASON: "Education repair matches knowledge-transfer function."
      EVIDENCE_SUPPORT:
        STATUS: "PASS"
        REASON: "Observed weakness and repair action are aligned."
      ZOOM_BOUNDARY:
        STATUS: "PASS"
        REASON: "Classification remains at Z0 with secondary Z1/Z2 effects only."
      ZTIME_BOUNDARY:
        STATUS: "PASS"
        REASON: "T2 mid-term horizon appropriate for learning repair."
      LEDGER_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Knowledge, confidence, and time debts are recorded."
      REPAIR_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Foundation repair targets the damaged invariant."
      CONFIDENCE_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Medium confidence matches diagnostic evidence."
    REPAIR_SUCCESS_CRITERIA:
      - "error reduction"
      - "transfer improvement"
      - "independent problem-solving gain"
      - "future pathway remains open"

EXAMPLE_04_FRONTIER_FAILURE_WARNING:
  INPUT_CIVCOORD:
    SHELL_ID: "CIV.L4.SHELL.CONTINUITY"
    DOMAIN_PRIMARY: "CIV.FRO"
    DOMAIN_SECONDARY:
      - "CIV.P4"
      - "CIV.BAS"
      - "CIV.REP"
    LATTICE_STATE: "FRO.LATT"
    ZOOM: "Z8.FRONTIER"
    PHASE: "P4.FRONTIER_EXCURSION"
    ZTIME: "T5.FRONTIER_TIME"
    LEDGER_STATUS: "UNKNOWN"
    EVIDENCE_STRENGTH: "MEDIUM"
    CONFIDENCE: "MEDIUM"
    REPAIR_OUTPUT: "PROCEED"
  VERIWEFT:
    STATUS: "WARN"
    OVERALL_REASON: >
      Frontier classification is plausible, but proceed output is premature
      because base rent, Ledger debt, and repair capacity are unknown.
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "PASS"
        REASON: "CIV.FRO belongs to CIV.L4.SHELL.CONTINUITY."
      FUNCTION_MATCH:
        STATUS: "PASS"
        REASON: "Future corridor opening matches frontier function."
      EVIDENCE_SUPPORT:
        STATUS: "WARN"
        REASON: "Capability evidence exists but base-cost evidence incomplete."
      ZOOM_BOUNDARY:
        STATUS: "PASS"
        REASON: "Frontier scale declared."
      ZTIME_BOUNDARY:
        STATUS: "PASS"
        REASON: "T5 frontier-time declared."
      LEDGER_ALIGNMENT:
        STATUS: "WARN"
        REASON: "Future debt unknown."
      REPAIR_ALIGNMENT:
        STATUS: "WARN"
        REASON: "Proceed should become PROBE or AUDIT until base-rent test passes."
      CONFIDENCE_ALIGNMENT:
        STATUS: "PASS"
        REASON: "Medium confidence acceptable."
    REQUIRED_MORE_EVIDENCE:
      - "base-rent analysis"
      - "future debt record"
      - "repair capacity test"
      - "P3 floor preservation evidence"
    REPAIR_OUTPUT_ADJUSTMENT: "Change PROCEED to PROBE or AUDIT."

EXAMPLE_05_COLLAPSE_OVERCLAIM:
  INPUT_CIVCOORD:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.REA"
    LATTICE_STATE: "COL.LATT"
    ZOOM: "Z4.NATION"
    PHASE: "P1.CONSTRICTED"
    ZTIME: "T1.SHORT_TERM"
    LEDGER_STATUS: "WATCH"
    EVIDENCE_STRENGTH: "MEDIUM"
    CONFIDENCE: "HIGH"
    REPAIR_OUTPUT: "CONTAIN"
  VERIWEFT:
    STATUS: "FAIL"
    OVERALL_REASON: >
      Collapse Lattice is overclaimed. Evidence suggests possible reality-field
      stress or drift, but repair-corridor closure is not shown.
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "PASS"
        REASON: "CIV.REA belongs to CIV.L3.SHELL.MIND."
      EVIDENCE_SUPPORT:
        STATUS: "FAIL"
        REASON: "Medium evidence and WATCH Ledger do not support COL.LATT."
      ZTIME_BOUNDARY:
        STATUS: "WARN"
        REASON: "T1 short-term is too early for collapse without stronger indicators."
      LEDGER_ALIGNMENT:
        STATUS: "FAIL"
        REASON: "WATCH does not match collapse unless repair corridors are closing."
      CONFIDENCE_ALIGNMENT:
        STATUS: "FAIL"
        REASON: "High confidence unsupported."
    REQUIRED_CORRECTION:
      - "Change Lattice to DRIFT.LATT or UNKNOWN."
      - "Lower confidence to MEDIUM or LOW."
      - "Add repair-corridor evidence if claiming COL.LATT."
      - "Change output to AUDIT or PROBE."

VERIWEFT_WITH_LEDGER:
  DESCRIPTION: >
    VeriWeft and Ledger work together. VeriWeft checks whether the classification
    is valid. Ledger records the damage, debt, repair, and unresolved cost.
  RELATIONSHIP:
    VERIWEFT:
      ROLE: "Checks structural admissibility."
      QUESTION: "Does this coordinate make sense?"
    LEDGER:
      ROLE: "Records memory and debt."
      QUESTION: "What cost, drift, damage, or repair is recorded?"
  VALIDITY_RULES:
    - "If Ledger shows accumulating debt, +LATT requires strong justification."
    - "If Ledger is unknown, high confidence should be blocked."
    - "If Ledger debt is hidden, VeriWeft must WARN or FAIL."
    - "If Repair claims success but Ledger debt remains, VeriWeft must WARN or FAIL."
    - "If Ledger shows debt reduction, REP.LATT may pass if evidence supports it."

VERIWEFT_WITH_REPAIR_OUTPUT:
  DESCRIPTION: >
    VeriWeft can modify repair output if the proposed route is too strong,
    too weak, unsupported, or misaligned with invariant damage.
  REPAIR_OUTPUT_ADJUSTMENT_RULES:
    IF_EVIDENCE_MISSING:
      ORIGINAL_OUTPUT: "REPAIR / REVERSE / CONTAIN"
      ADJUSTED_OUTPUT: "PROBE"
      REASON: "Need evidence before acting."
    IF_AUDITABILITY_UNKNOWN:
      ORIGINAL_OUTPUT: "PROCEED"
      ADJUSTED_OUTPUT: "AUDIT"
      REASON: "Route requires independent verification."
    IF_INVERSE_NOT_PROVEN:
      ORIGINAL_OUTPUT: "REVERSE"
      ADJUSTED_OUTPUT: "AUDIT"
      REASON: "Inverse state must be validated before reversal."
    IF_COLLAPSE_OVERCLAIMED:
      ORIGINAL_OUTPUT: "CONTAIN"
      ADJUSTED_OUTPUT: "PROBE or AUDIT"
      REASON: "Collapse requires repair-corridor evidence."
    IF_REPAIR_IS_COSMETIC:
      ORIGINAL_OUTPUT: "REPAIR"
      ADJUSTED_OUTPUT: "FAIL_REPAIR_ALIGNMENT"
      REASON: "Repair must reduce Ledger debt."
    IF_ROUTE_BURNS_FUTURE_FLOOR:
      ORIGINAL_OUTPUT: "PROCEED"
      ADJUSTED_OUTPUT: "ABORT"
      REASON: "Future continuity breached."

VERIWEFT_ERROR_CODES:
  VW.E001_LAYER_DOMAIN_CONFUSION:
    MEANING: "Layer used as exact domain."
    FIX: "Assign Shell ID and Domain ID."
  VW.E002_STATE_INSIDE_ID:
    MEANING: "Lattice state or moral judgement encoded inside ID."
    FIX: "Move state into Lattice field."
  VW.E003_UNSUPPORTED_LATTICE:
    MEANING: "Lattice state lacks evidence."
    FIX: "Add observed signal, source type, claim type, invariant effect, and confidence."
  VW.E004_SCALE_JUMP:
    MEANING: "Zoom claim exceeds evidence."
    FIX: "Add scale bridge or restrict Zoom."
  VW.E005_TIMELESS_CLASSIFICATION:
    MEANING: "Ztime missing or ignored."
    FIX: "Add T0-T5 horizon and time-sliced effect."
  VW.E006_LEDGER_OMISSION:
    MEANING: "Debt, drift, damage, or repair not recorded."
    FIX: "Add Ledger status and debt types."
  VW.E007_REPAIR_MISALIGNMENT:
    MEANING: "Repair output does not address damaged invariant."
    FIX: "Map repair action to invariant and Ledger debt."
  VW.E008_OVERCONFIDENCE:
    MEANING: "Confidence exceeds evidence strength."
    FIX: "Lower confidence or add stronger evidence."
  VW.E009_INVERSE_OVERCLAIM:
    MEANING: "INV.LATT claimed without intended-function contradiction."
    FIX: "Run intended-function test."
  VW.E010_COLLAPSE_OVERCLAIM:
    MEANING: "COL.LATT claimed without repair-corridor closure."
    FIX: "Add collapse markers or downgrade to DRIFT/NEGATIVE/UNKNOWN."
  VW.E011_FRONTIER_BASE_RENT_MISSING:
    MEANING: "FRO.LATT claimed without base-rent test."
    FIX: "Add P3 floor preservation and future debt record."

MORIARTY_ATTACK_AND_HARDENING:
  ATTACK_01_COMPLETE_BUT_INVALID:
    ATTACK: >
      AI fills every CivCoord field but the relationships do not fit.
    FAILURE: "Structured hallucination."
    HARDENING: "VeriWeft validates relationship, not just field completion."
  ATTACK_02_FIELD_DECORATION:
    ATTACK: >
      VeriWeft fields are present but do not affect confidence or repair.
    FAILURE: "Validity becomes decorative."
    HARDENING: "Every failed test must adjust confidence, Lattice, or repair output."
  ATTACK_03_PASS_TOO_EASILY:
    ATTACK: >
      AI marks PASS when evidence is partial.
    FAILURE: "False authority."
    HARDENING: "Partial evidence defaults to WARN or UNKNOWN, not PASS."
  ATTACK_04_IDEOLOGICAL_VALIDITY:
    ATTACK: >
      VeriWeft passes routes that match preference but not invariant.
    FAILURE: "Ideology disguised as validation."
    HARDENING: "Validity must tie to invariant, evidence, Ledger, and repair."
  ATTACK_05_HIDDEN_DEBT:
    ATTACK: >
      Positive classification ignores unpaid cost.
    FAILURE: "Surface success hides collapse debt."
    HARDENING: "Ledger alignment required for +LATT and P3/P4 claims."
  ATTACK_06_EMERGENCY_NORMALISATION:
    ATTACK: >
      Temporary exception becomes permanent without failing validation.
    FAILURE: "Return-to-floor breach."
    HARDENING: "Return-to-floor test mandatory for emergency power."
  ATTACK_07_REPAIR_WASHING:
    ATTACK: >
      Cosmetic fix is accepted as repair.
    FAILURE: "Damage remains while repair language hides it."
    HARDENING: "Repair alignment requires Ledger debt reduction."
  ATTACK_08_FRONTIER_ROMANCE:
    ATTACK: >
      Novel capability is validated as frontier progress.
    FAILURE: "Base floor may be burned."
    HARDENING: "Frontier validation requires base-rent and future-continuity tests."

MINIMUM_VALID_VERIWEFT_RECORD:
  VERIWEFT:
    STATUS: "UNKNOWN"
    OVERALL_REASON: "Insufficient information to validate."
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "UNKNOWN"
        REASON: null
      FUNCTION_MATCH:
        STATUS: "UNKNOWN"
        REASON: null
      EVIDENCE_SUPPORT:
        STATUS: "UNKNOWN"
        REASON: null
      ZOOM_BOUNDARY:
        STATUS: "UNKNOWN"
        REASON: null
      ZTIME_BOUNDARY:
        STATUS: "UNKNOWN"
        REASON: null
      LEDGER_ALIGNMENT:
        STATUS: "UNKNOWN"
        REASON: null
      REPAIR_ALIGNMENT:
        STATUS: "UNKNOWN"
        REASON: null
      CONFIDENCE_ALIGNMENT:
        STATUS: "UNKNOWN"
        REASON: null
    TESTS_PASSED: []
    TESTS_WARNED: []
    TESTS_FAILED: []
    TESTS_UNKNOWN:
      - "SHELL_DOMAIN_FIT"
      - "FUNCTION_MATCH"
      - "EVIDENCE_SUPPORT"
      - "ZOOM_BOUNDARY"
      - "ZTIME_BOUNDARY"
      - "LEDGER_ALIGNMENT"
      - "REPAIR_ALIGNMENT"
      - "CONFIDENCE_ALIGNMENT"
    REQUIRED_MORE_EVIDENCE:
      - "Shell ID"
      - "Domain ID"
      - "Observed signal"
      - "Source type"
      - "Claim type"
      - "Ztime"
      - "Zoom"
      - "Ledger status"

FULL_VERIWEFT_TEMPLATE:
  VERIWEFT:
    STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
    OVERALL_REASON: "[explain overall validity judgement]"
    STRUCTURAL_TESTS:
      SHELL_DOMAIN_FIT:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      FUNCTION_MATCH:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      EVIDENCE_SUPPORT:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      ZOOM_BOUNDARY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      ZTIME_BOUNDARY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      LEDGER_ALIGNMENT:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      REPAIR_ALIGNMENT:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      CONFIDENCE_ALIGNMENT:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
    BOUNDARY_TESTS:
      BOUNDEDNESS:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      RETURN_TO_FLOOR:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      PROPORTIONALITY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      AUDITABILITY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      TRUTH_PRESERVATION:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      REPAIRABILITY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
      FUTURE_CONTINUITY:
        STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
        REASON: "[explain]"
    TESTS_PASSED:
      - "[test]"
    TESTS_WARNED:
      - "[test]"
    TESTS_FAILED:
      - "[test]"
    TESTS_UNKNOWN:
      - "[test]"
    REQUIRED_MORE_EVIDENCE:
      - "[evidence needed]"
    CONFIDENCE_ADJUSTMENT:
      ORIGINAL_CONFIDENCE: "[LOW / MEDIUM / HIGH]"
      ADJUSTED_CONFIDENCE: "[LOW / MEDIUM / HIGH]"
      REASON: "[explain]"
    REPAIR_OUTPUT_ADJUSTMENT:
      ORIGINAL_OUTPUT: "[PROCEED / HOLD / PROBE / AUDIT / REPAIR / CONTAIN / REVERSE / ABORT]"
      ADJUSTED_OUTPUT: "[PROCEED / HOLD / PROBE / AUDIT / REPAIR / CONTAIN / REVERSE / ABORT]"
      REASON: "[explain]"

CANONICAL_LOCK:
  FULL_LOCK: >
    VeriWeft is the validity fabric of the Civilisation Layer Stack AI/LLM
    architecture. It checks whether a CivCoord is structurally admissible by
    testing Shell-Domain fit, function match, evidence support, Zoom boundary,
    Ztime boundary, Ledger alignment, Repair alignment, and Confidence alignment.
    VeriWeft prevents structured hallucination by ensuring that a complete-looking
    coordinate is not treated as valid unless its relationships pass.
  SHORT_LOCK: >
    VeriWeft = Validity Fabric.
    It checks whether Shell, ID, Lattice, Zoom, Phase, Ztime, Ledger, Evidence,
    Confidence, and Repair actually fit.
  MORIARTY_LOCK: >
    No structured output without validity.
    No PASS without evidence.
    No Repair without Ledger reduction.
    No Inverse without function contradiction.
    No Collapse without repair-corridor closure.
    No Frontier without base-rent test.
    No Confidence above evidence.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.006"
  NEXT_ARTICLE_TITLE: "Ledger Audit and Repair Architecture"
  NEXT_ARTICLE_FUNCTION: >
    Define the Ledger as the memory, debt, drift, invariant-damage, and repair
    record layer of the Civilisation Layer Stack AI/LLM architecture.
  NEXT_ARTICLE_OUTPUTS:
    - "Ledger definition"
    - "Debt type registry"
    - "Invariant damage records"
    - "Repair history schema"
    - "RepairRate >= DriftRate rule"
    - "Ledger status PASS/WATCH/ACCUMULATING/BREACHED/REPAIRING"
    - "Moriarty hardening against hidden debt and repair washing"

ARTICLE:
  PUBLIC_TITLE: "Ledger Audit and Repair Architecture"
  MACHINE_TITLE: "CIVSTACK.RA.AI.FULLCODE.006"
  STACK_NAME: "Civilisation Layer Stack AI/LLM Full Code Registry"
  STACK_ID: "CIVSTACK.RA.AI.FULLCODE.v1"
  ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.006"
  ARTICLE_TYPE: "Full Code Only"
  ARTICLE_FUNCTION: >
    Define the Ledger as the memory, debt, drift, invariant-damage, audit,
    and repair-record layer of the Civilisation Layer Stack AI/LLM architecture.
  STATUS: "Canonical architecture draft"
  VERSION: "v1.0"
  OWNER_SYSTEM: "eduKateSG / CivOS"
  OUTPUT_MODE: "AI extraction, LLM parsing, audit reasoning, repair tracking"

CORE_DEFINITION:
  LEDGER:
    FULL_NAME: "Ledger of Invariants"
    MACHINE_NAME: "CIV.LEDGER"
    FUNCTION: >
      The Ledger is the civilisation memory layer that records invariant damage,
      hidden cost, debt accumulation, drift, repair attempts, unresolved harm,
      audit status, and whether repair is reducing damage faster than new drift
      is accumulating.
  ONE_SENTENCE: >
    The Ledger prevents AI from treating surface stability as real stability
    when hidden debt, drift, damage, or unpaid repair remains.
  SHORT_FORMULA: >
    Ledger = Memory + Debt + Drift + Damage + Repair Record.
  STABILITY_RULE:
    FORMULA: "RepairRate >= DriftRate"
    MEANING: >
      A civilisation function remains repairable when repair is reducing damage
      at least as fast as drift is accumulating.
  FAILURE_RULE:
    FORMULA: "DriftRate > RepairRate long enough"
    MEANING: >
      Collapse risk rises when drift accumulates faster than the system can
      recognise, record, and repair it.

WHY_LEDGER_EXISTS:
  PROBLEM:
    DESCRIPTION: >
      Civilisation systems often continue operating on the surface even while
      hidden debt accumulates underneath. AI may mistake visible continuity for
      health if it does not track unpaid costs, trust loss, knowledge gaps,
      moral injury, infrastructure decay, ecological depletion, reality distortion,
      culture loss, or future-floor burn.
    COMMON_FAILURES:
      - "A system looks stable but trust debt is accumulating."
      - "A policy works short-term but transfers cost to future generations."
      - "A school appears to teach but students carry knowledge debt."
      - "A legal system appears valid but hides governance debt."
      - "A culture appears to adapt but loses language and memory."
      - "A frontier project appears advanced but burns the base floor."
      - "Repair is announced but the damaged invariant is not restored."
      - "A crisis ends publicly but Ledger debt remains unpaid."
  SOLUTION:
    DESCRIPTION: >
      The Ledger records what is damaged, who or what carries the cost, what
      debt is accumulating, what repair has been attempted, and whether repair
      is actually reducing drift.
  RESULT:
    - "AI can detect hidden debt."
    - "AI can separate surface stability from true stability."
    - "AI can track whether repair is real or cosmetic."
    - "AI can prevent positive classification when debt is hidden."
    - "AI can connect Lattice state to actual memory and repair records."

LEDGER_POSITION_IN_ARCHITECTURE:
  DESCRIPTION: >
    Ledger sits after Lattice and VeriWeft but before final Repair Output.
    It records what has happened to civilisation invariants and whether the
    proposed repair route is reducing debt.
  ARCHITECTURE_CHAIN:
    STEP_01: "Layer / Shell selected"
    STEP_02: "Domain ID assigned"
    STEP_03: "Lattice state proposed"
    STEP_04: "Zoom and Ztime selected"
    STEP_05: "VeriWeft validates relationship"
    STEP_06: "Ledger records debt, damage, drift, and repair"
    STEP_07: "Confidence adjusted"
    STEP_08: "Repair Output selected"
  SHORT_CHAIN: >
    State -> Validity -> Memory -> Repair
  HARD_RULE: >
    No final repair claim is valid unless the Ledger records which invariant
    was damaged and how the repair reduces the relevant debt.

LEDGER_STATUS_REGISTRY:
  CLEAR:
    CODE: "LEDGER.CLEAR"
    MEANING: "No material debt, drift, damage, or unresolved repair recorded."
    CONDITIONS:
      - "invariant function intact"
      - "repair not required or already complete"
      - "no hidden cost detected"
      - "no unresolved contradiction recorded"
    WARNING: "CLEAR requires evidence; absence of recorded debt is not proof of no debt."
  WATCH:
    CODE: "LEDGER.WATCH"
    MEANING: "Early signal, uncertain drift, or possible debt requires monitoring."
    CONDITIONS:
      - "weak signal detected"
      - "evidence incomplete"
      - "counter-signal possible"
      - "repair not yet required but may become necessary"
  ACCUMULATING:
    CODE: "LEDGER.ACCUMULATING"
    MEANING: "Debt, drift, cost, or damage is building."
    CONDITIONS:
      - "repeated unresolved signal"
      - "repair not keeping up"
      - "trust, knowledge, reality, culture, infrastructure, governance, or future debt visible"
      - "cost being transferred across time or scale"
  BREACHED:
    CODE: "LEDGER.BREACHED"
    MEANING: "Invariant damage has crossed a serious threshold."
    CONDITIONS:
      - "repair corridors weakening or closing"
      - "damage now affects system function"
      - "hidden debt becomes active failure"
      - "VeriWeft tests failing"
  REPAIRING:
    CODE: "LEDGER.REPAIRING"
    MEANING: "Repair is active and reducing recorded damage."
    CONDITIONS:
      - "damaged invariant identified"
      - "repair action underway"
      - "success criteria visible"
      - "RepairRate >= DriftRate or trending toward it"
  UNKNOWN:
    CODE: "LEDGER.UNKNOWN"
    MEANING: "Insufficient evidence to determine Ledger status."
    CONDITIONS:
      - "debt not measured"
      - "repair history unknown"
      - "source missing"
      - "damage possibly hidden"

DEBT_TYPE_REGISTRY:
  TRUST_DEBT:
    CODE: "DEBT.TRUST"
    FUNCTION: "Records loss of legitimate trust in people, institutions, systems, or public claims."
    COMMON_DOMAINS:
      - "CIV.GOV"
      - "CIV.REP"
      - "CIV.REA"
      - "CIV.SEC"
    SIGNALS:
      - "public disbelief"
      - "institutional opacity"
      - "unanswered accountability concerns"
      - "repeated broken promises"
    REPAIR_REQUIRES:
      - "truth disclosure"
      - "audit"
      - "accountability"
      - "visible correction"
  MORAL_DEBT:
    CODE: "DEBT.MORAL"
    FUNCTION: "Records unrepaired harm, dignity damage, injustice, or cost carried by people or groups."
    COMMON_DOMAINS:
      - "CIV.GOV"
      - "CIV.SEC"
      - "CIV.CUL"
      - "CIV.REP"
    SIGNALS:
      - "unacknowledged harm"
      - "dehumanising route"
      - "disproportionate burden"
      - "harm moved forward in time"
    REPAIR_REQUIRES:
      - "recognition"
      - "accountability"
      - "recourse"
      - "burden reduction"
      - "dignity restoration"
  KNOWLEDGE_DEBT:
    CODE: "DEBT.KNOWLEDGE"
    FUNCTION: "Records weak, lost, corrupted, or poorly transferred knowledge."
    COMMON_DOMAINS:
      - "CIV.KNO"
      - "CIV.LNG"
      - "CIV.POP"
    SIGNALS:
      - "weak foundations"
      - "poor transfer"
      - "credential without capability"
      - "skill decay"
    REPAIR_REQUIRES:
      - "foundation rebuild"
      - "retrieval practice"
      - "transfer training"
      - "error ledger"
      - "teaching correction"
  REALITY_DEBT:
    CODE: "DEBT.REALITY"
    FUNCTION: "Records divergence between accepted public reality and evidential reality."
    COMMON_DOMAINS:
      - "CIV.REA"
      - "CIV.LNG"
      - "CIV.GOV"
      - "CIV.REP"
    SIGNALS:
      - "source distortion"
      - "propaganda drift"
      - "unverified claims becoming public truth"
      - "correction pathway failure"
    REPAIR_REQUIRES:
      - "source calibration"
      - "claim separation"
      - "correction archive"
      - "counter-signal inclusion"
  GOVERNANCE_DEBT:
    CODE: "DEBT.GOVERNANCE"
    FUNCTION: "Records legitimacy, accountability, law, policy, or bounded-power debt."
    COMMON_DOMAINS:
      - "CIV.GOV"
      - "CIV.SEC"
      - "CIV.REP"
    SIGNALS:
      - "audit blocked"
      - "law-as-costume"
      - "accountability drift"
      - "pilot capture risk"
    REPAIR_REQUIRES:
      - "independent review"
      - "legal correction"
      - "boundedness restoration"
      - "return-to-floor"
  INFRASTRUCTURE_DEBT:
    CODE: "DEBT.INFRASTRUCTURE"
    FUNCTION: "Records deferred maintenance, capacity weakness, decay, or hidden operating fragility."
    COMMON_DOMAINS:
      - "CIV.INF"
      - "CIV.LOG"
      - "CIV.LIF"
      - "CIV.REP"
    SIGNALS:
      - "maintenance backlog"
      - "repeated breakdown"
      - "capacity overload"
      - "brittle supply route"
    REPAIR_REQUIRES:
      - "maintenance restoration"
      - "capacity upgrade"
      - "redundancy"
      - "failure audit"
  ECOLOGICAL_DEBT:
    CODE: "DEBT.ECOLOGICAL"
    FUNCTION: "Records environmental cost moved into future or hidden outside immediate accounting."
    COMMON_DOMAINS:
      - "CIV.ENV"
      - "CIV.BAS"
      - "CIV.FRO"
    SIGNALS:
      - "resource depletion"
      - "pollution"
      - "soil loss"
      - "water stress"
      - "climate burden"
    REPAIR_REQUIRES:
      - "restoration"
      - "mitigation"
      - "base-floor protection"
      - "future-cost accounting"
  CULTURE_DEBT:
    CODE: "DEBT.CULTURE"
    FUNCTION: "Records loss or damage to language, memory, ritual, belonging, identity, or living meaning."
    COMMON_DOMAINS:
      - "CIV.CUL"
      - "CIV.LNG"
      - "CIV.KNO"
      - "CIV.LED"
    SIGNALS:
      - "language loss"
      - "ritual break"
      - "memory discontinuity"
      - "identity fracture"
    REPAIR_REQUIRES:
      - "documentation"
      - "intergenerational teaching"
      - "living renewal"
      - "archive creation"
  FUTURE_DEBT:
    CODE: "DEBT.FUTURE"
    FUNCTION: "Records cost transferred to children, future institutions, or frontier time."
    COMMON_DOMAINS:
      - "CIV.FRO"
      - "CIV.P4"
      - "CIV.REP"
      - "CIV.ENV"
    SIGNALS:
      - "future floor burn"
      - "unfunded obligation"
      - "frontier gain with hidden base cost"
      - "reduced future optionality"
    REPAIR_REQUIRES:
      - "future-cost accounting"
      - "base-rent payment"
      - "intergenerational protection"
      - "long-horizon repair plan"
  FRONTIER_DEBT:
    CODE: "DEBT.FRONTIER"
    FUNCTION: "Records debt created by advanced or frontier expansion that consumes present base or future repair capacity."
    COMMON_DOMAINS:
      - "CIV.FRO"
      - "CIV.P4"
      - "CIV.BAS"
      - "CIV.REP"
    SIGNALS:
      - "P4 without P3 rent"
      - "frontier project burns base resources"
      - "future corridor narrows after expansion"
      - "repair capacity reduced"
    REPAIR_REQUIRES:
      - "P3 rent payment"
      - "frontier risk audit"
      - "base preservation"
      - "reversibility or containment"

LEDGER_RECORD_SCHEMA:
  LEDGER:
    STATUS: "[CLEAR / WATCH / ACCUMULATING / BREACHED / REPAIRING / UNKNOWN]"
    LEDGER_ID: null
    DOMAIN_CONTEXT:
      SHELL_ID: null
      DOMAIN_PRIMARY: null
      DOMAIN_SECONDARY: []
    INVARIANT_RECORD:
      DAMAGED_INVARIANTS: []
      PROTECTED_INVARIANTS: []
      INVARIANT_STATUS: null
    DEBT_RECORD:
      DEBT_TYPES: []
      DEBT_DESCRIPTION: {}
      DEBT_CARRIER: []
      DEBT_ORIGIN: null
      DEBT_DIRECTION: null
      DEBT_VISIBILITY: null
    DRIFT_RECORD:
      DRIFT_TYPE: null
      DRIFT_RATE: null
      DRIFT_DIRECTION: null
      DRIFT_EVIDENCE: []
      PRIOR_STATE: null
      CURRENT_STATE: null
      RISK_NEXT_STATE: null
    REPAIR_RECORD:
      REPAIR_STATUS: null
      REPAIR_ACTIONS: []
      REPAIR_RATE: null
      REPAIR_SUCCESS_CRITERIA: []
      REPAIR_FAILURE_SIGNS: []
      REPAIR_HISTORY: []
      REPAIR_OWNER: null
    AUDIT_RECORD:
      AUDIT_STATUS: null
      AUDITABILITY: null
      SOURCE_TRACEABILITY: null
      COUNTER_SIGNAL_CHECKED: null
      VERIWEFT_STATUS: null
    TIME_RECORD:
      ZTIME_PRIMARY: null
      ZTIME_SECONDARY: []
      COST_TRANSFER_TIME: null
      INTERGENERATIONAL_EFFECT: null
    SCALE_RECORD:
      ZOOM_PRIMARY: null
      ZOOM_SECONDARY: []
      SCALE_BRIDGE_SIGNALS: []
    CONFIDENCE:
      LEVEL: null
      REASON: null
      UNCERTAINTY: []

LEDGER_FIELD_DEFINITIONS:
  LEDGER_ID:
    FUNCTION: "Unique identifier for a specific Ledger record."
    EXAMPLE: "LEDGER.CIV.GOV.TRUST.0001"
  DAMAGED_INVARIANTS:
    FUNCTION: "Civilisation invariants weakened or harmed."
    EXAMPLES:
      - "trust"
      - "truth"
      - "bounded power"
      - "knowledge transfer"
      - "future continuity"
  PROTECTED_INVARIANTS:
    FUNCTION: "Civilisation invariants the route claims or actually tries to protect."
    EXAMPLES:
      - "public safety"
      - "order"
      - "health"
      - "learning"
      - "continuity"
  DEBT_CARRIER:
    FUNCTION: "Who or what carries the cost."
    EXAMPLES:
      - "students"
      - "families"
      - "future generations"
      - "public trust"
      - "environment"
      - "minority group"
      - "institutional legitimacy"
  DEBT_ORIGIN:
    FUNCTION: "Where the debt began."
    EXAMPLES:
      - "policy design"
      - "weak teaching"
      - "deferred maintenance"
      - "unrepaired harm"
      - "reality distortion"
      - "frontier overextension"
  DEBT_DIRECTION:
    FUNCTION: "Where the cost is moving."
    VALUES:
      - "present_to_future"
      - "elite_to_public"
      - "institution_to_family"
      - "state_to_citizen"
      - "human_to_environment"
      - "visible_to_hidden"
      - "local_to_systemic"
  DEBT_VISIBILITY:
    FUNCTION: "Whether debt is visible, hidden, denied, disputed, or measured."
    VALUES:
      - "VISIBLE"
      - "HIDDEN"
      - "DENIED"
      - "DISPUTED"
      - "MEASURED"
      - "UNKNOWN"
  DRIFT_RATE:
    FUNCTION: "Speed at which damage, debt, or misalignment accumulates."
    VALUES:
      - "LOW"
      - "MEDIUM"
      - "HIGH"
      - "ACCELERATING"
      - "UNKNOWN"
  REPAIR_RATE:
    FUNCTION: "Speed and effectiveness of repair relative to drift."
    VALUES:
      - "NONE"
      - "LOW"
      - "MEDIUM"
      - "HIGH"
      - "ACCELERATING"
      - "UNKNOWN"
  REPAIR_STATUS:
    FUNCTION: "Current repair condition."
    VALUES:
      - "NOT_STARTED"
      - "COSMETIC"
      - "ACTIVE"
      - "EFFECTIVE"
      - "FAILING"
      - "BLOCKED"
      - "UNKNOWN"

REPAIR_RATE_RULE:
  CORE_FORMULA: "RepairRate >= DriftRate"
  MEANING: >
    Repair must reduce accumulated damage at least as fast as new drift,
    debt, or damage is forming.
  STABLE_CONDITION:
    FORMULA: "RepairRate >= DriftRate"
    CLASSIFICATION:
      LEDGER_STATUS: "REPAIRING or CLEAR"
      POSSIBLE_LATTICE: "REP.LATT -> +LATT"
    MEANING: "Repair is keeping up or winning."
  UNSTABLE_CONDITION:
    FORMULA: "RepairRate < DriftRate"
    CLASSIFICATION:
      LEDGER_STATUS: "ACCUMULATING"
      POSSIBLE_LATTICE: "DRIFT.LATT or -LATT"
    MEANING: "Damage is accumulating faster than repair."
  BREACH_CONDITION:
    FORMULA: "RepairRate << DriftRate for sustained duration"
    CLASSIFICATION:
      LEDGER_STATUS: "BREACHED"
      POSSIBLE_LATTICE: "COL.LATT risk"
    MEANING: "Repair corridors may begin closing."
  UNKNOWN_CONDITION:
    FORMULA: "RepairRate unknown OR DriftRate unknown"
    CLASSIFICATION:
      LEDGER_STATUS: "UNKNOWN or WATCH"
      POSSIBLE_LATTICE: "UNKNOWN or DRIFT.LATT"
    MEANING: "More evidence required before claiming stability or repair."
  HARD_RULES:
    - "Do not classify repair as successful without RepairRate evidence."
    - "Do not classify system as stable if DriftRate is unknown and debt may be hidden."
    - "Do not classify collapse unless sustained repair failure or corridor closure is shown."

LEDGER_AUDIT_RUNTIME:
  STEP_01_IDENTIFY_DOMAIN:
    QUESTION: "Which Shell ID and Domain ID does the Ledger record belong to?"
    OUTPUT: "SHELL_ID and DOMAIN_PRIMARY"
  STEP_02_IDENTIFY_INVARIANT:
    QUESTION: "Which invariant is damaged, protected, or at risk?"
    OUTPUT: "DAMAGED_INVARIANTS and PROTECTED_INVARIANTS"
  STEP_03_IDENTIFY_DEBT:
    QUESTION: "What type of debt is created, reduced, hidden, or unresolved?"
    OUTPUT: "DEBT_TYPES"
  STEP_04_IDENTIFY_DEBT_CARRIER:
    QUESTION: "Who or what carries the cost?"
    OUTPUT: "DEBT_CARRIER"
  STEP_05_IDENTIFY_DEBT_DIRECTION:
    QUESTION: "Where is the cost moving?"
    OUTPUT: "DEBT_DIRECTION"
  STEP_06_MEASURE_VISIBILITY:
    QUESTION: "Is the debt visible, hidden, denied, disputed, measured, or unknown?"
    OUTPUT: "DEBT_VISIBILITY"
  STEP_07_ESTIMATE_DRIFT_RATE:
    QUESTION: "How quickly is damage accumulating?"
    OUTPUT: "DRIFT_RATE"
  STEP_08_ESTIMATE_REPAIR_RATE:
    QUESTION: "How quickly is repair reducing damage?"
    OUTPUT: "REPAIR_RATE"
  STEP_09_APPLY_REPAIR_RATE_RULE:
    QUESTION: "Is RepairRate greater than or equal to DriftRate?"
    OUTPUT: "STABLE, UNSTABLE, BREACHED, or UNKNOWN"
  STEP_10_VALIDATE_WITH_VERIWEFT:
    QUESTION: "Does Ledger status align with Shell, ID, Lattice, Zoom, Phase, Ztime, and Evidence?"
    OUTPUT: "VERIWEFT_STATUS"
  STEP_11_OUTPUT_LEDGER_STATUS:
    QUESTION: "What Ledger status should be assigned?"
    OUTPUT: "CLEAR, WATCH, ACCUMULATING, BREACHED, REPAIRING, or UNKNOWN"
  STEP_12_OUTPUT_REPAIR_NEED:
    QUESTION: "What repair action is required?"
    OUTPUT: "PROBE, AUDIT, REPAIR, CONTAIN, REVERSE, ABORT, or PROCEED"

LEDGER_WITH_LATTICE:
  DESCRIPTION: >
    Ledger and Lattice must align. Lattice describes state and route. Ledger
    records the memory, debt, damage, or repair that justifies the state.
  ALIGNMENT_RULES:
    "+LATT":
      LEDGER_EXPECTATION: "CLEAR or REPAIRING with debt reducing"
      FAIL_IF: "hidden debt accumulating"
    "0LATT":
      LEDGER_EXPECTATION: "CLEAR, WATCH, or UNKNOWN"
      FAIL_IF: "material debt already visible"
    "-LATT":
      LEDGER_EXPECTATION: "ACCUMULATING or BREACHED"
      FAIL_IF: "no invariant damage or debt shown"
    "INV.LATT":
      LEDGER_EXPECTATION: "ACCUMULATING or BREACHED, usually trust/governance/reality/moral debt"
      FAIL_IF: "intended-function contradiction not recorded"
    "DRIFT.LATT":
      LEDGER_EXPECTATION: "WATCH or ACCUMULATING"
      FAIL_IF: "no prior/current movement evidence"
    "REP.LATT":
      LEDGER_EXPECTATION: "REPAIRING with success criteria"
      FAIL_IF: "repair action not tied to debt reduction"
    "COL.LATT":
      LEDGER_EXPECTATION: "BREACHED with repair-corridor closure evidence"
      FAIL_IF: "repair remains active and effective"
    "FRO.LATT":
      LEDGER_EXPECTATION: "CLEAR, WATCH, or recorded future/frontier debt with base-rent plan"
      FAIL_IF: "future or frontier debt hidden"

LEDGER_WITH_VERIWEFT:
  DESCRIPTION: >
    VeriWeft validates whether the Ledger status makes sense. Ledger records
    what VeriWeft must check against.
  VALIDITY_CHECKS:
    LEDGER_STATUS_MATCHES_EVIDENCE:
      QUESTION: "Does debt status match observed signal?"
    LEDGER_STATUS_MATCHES_LATTICE:
      QUESTION: "Does debt record support proposed Lattice state?"
    LEDGER_STATUS_MATCHES_REPAIR:
      QUESTION: "Does repair output reduce the recorded debt?"
    LEDGER_STATUS_MATCHES_CONFIDENCE:
      QUESTION: "Is confidence appropriate given debt visibility and evidence?"
    LEDGER_STATUS_MATCHES_ZTIME:
      QUESTION: "Is the debt immediate, mid-term, long-term, intergenerational, or frontier-time?"
    LEDGER_STATUS_MATCHES_ZOOM:
      QUESTION: "At what scale is debt carried?"
  VERIWEFT_FAIL_CONDITIONS:
    - "Ledger debt ignored in positive classification."
    - "Ledger status unknown but confidence high."
    - "Repair claimed without debt reduction."
    - "Collapse claimed without breach record."
    - "Frontier claimed without future debt and base-rent record."

REPAIR_OUTPUT_RULES_FROM_LEDGER:
  PROCEED:
    LEDGER_CONDITION: "CLEAR or REPAIRING with RepairRate >= DriftRate"
    MEANING: "Route is admissible."
  HOLD:
    LEDGER_CONDITION: "WATCH with unresolved uncertainty"
    MEANING: "Pause final route until evidence improves."
  PROBE:
    LEDGER_CONDITION: "UNKNOWN"
    MEANING: "Gather evidence before classification or action."
  AUDIT:
    LEDGER_CONDITION: "WATCH, ACCUMULATING, or DISPUTED"
    MEANING: "Run independent verification and source tracing."
  REPAIR:
    LEDGER_CONDITION: "ACCUMULATING with identifiable damaged invariant"
    MEANING: "Restore function and reduce debt."
  CONTAIN:
    LEDGER_CONDITION: "ACCUMULATING or BREACHED with spreading damage"
    MEANING: "Limit spread while repair is designed."
  REVERSE:
    LEDGER_CONDITION: "BREACHED with verified inverse route"
    MEANING: "Undo harmful route or remove inversion."
  ABORT:
    LEDGER_CONDITION: "BREACHED with future floor burn, unrecoverable debt, or invalid route"
    MEANING: "Stop route because it violates invariant or destroys repair capacity."

EXAMPLE_01_EDUCATION_LEDGER:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "Student carries weak algebra foundation into higher mathematics."
    OBJECT_TYPE: "education debt"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.KNO"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.POP"
  LEDGER:
    STATUS: "ACCUMULATING"
    DEBT_TYPES:
      - "DEBT.KNOWLEDGE"
      - "DEBT.CONFIDENCE"
      - "DEBT.TIME"
    DAMAGED_INVARIANTS:
      - "knowledge transfer"
      - "future optionality"
      - "learning confidence"
    DEBT_CARRIER:
      - "student"
      - "family"
      - "future subject pathway"
    DEBT_DIRECTION: "present_to_future"
    DEBT_VISIBILITY: "VISIBLE"
    DRIFT_RATE: "MEDIUM"
    REPAIR_RATE: "LOW"
    REPAIR_STATUS: "NOT_STARTED"
  LATTICE_ALIGNMENT:
    PRIOR_STATE: "0LATT"
    CURRENT_STATE: "-LATT"
    ROUTE: "PATHWAY_CHAIR_COMPRESSION"
  REPAIR_OUTPUT:
    OUTPUT_TYPE: "REPAIR"
    REQUIRED_ACTIONS:
      - "diagnostic test"
      - "error ledger"
      - "algebra foundation rebuild"
      - "retrieval practice"
      - "transfer training"
  SUCCESS_CRITERIA:
    - "repeated errors reduce"
    - "student handles unfamiliar algebra"
    - "confidence stabilises"
    - "future mathematics corridor remains open"

EXAMPLE_02_GOVERNANCE_LEDGER:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "Institutional accountability weakens and public trust falls."
    OBJECT_TYPE: "governance debt"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L2.SHELL.ORDER"
    DOMAIN_PRIMARY: "CIV.GOV"
    DOMAIN_SECONDARY:
      - "CIV.REP"
      - "CIV.REA"
  LEDGER:
    STATUS: "ACCUMULATING"
    DEBT_TYPES:
      - "DEBT.TRUST"
      - "DEBT.GOVERNANCE"
      - "DEBT.REALITY"
    DAMAGED_INVARIANTS:
      - "bounded power"
      - "auditability"
      - "truth preservation"
      - "public trust"
    DEBT_CARRIER:
      - "citizens"
      - "institutional legitimacy"
      - "public reality field"
    DEBT_DIRECTION: "institution_to_public"
    DEBT_VISIBILITY: "DISPUTED"
    DRIFT_RATE: "MEDIUM"
    REPAIR_RATE: "UNKNOWN"
    REPAIR_STATUS: "UNKNOWN"
  LATTICE_ALIGNMENT:
    CURRENT_STATE: "DRIFT.LATT"
    POSSIBLE_NEXT_STATE: "INV.LATT"
    ROUTE: "ACCOUNTABILITY_DRIFT"
  VERIWEFT_REQUIRED:
    - "auditability test"
    - "truth preservation test"
    - "return-to-floor test"
    - "confidence alignment"
  REPAIR_OUTPUT:
    OUTPUT_TYPE: "AUDIT"
    REQUIRED_ACTIONS:
      - "independent audit"
      - "source disclosure"
      - "public correction channel"
      - "accountability restoration"

EXAMPLE_03_CULTURE_LEDGER:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "A community loses language transmission across generations."
    OBJECT_TYPE: "culture memory debt"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.CUL"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.KNO"
      - "CIV.LED"
  LEDGER:
    STATUS: "ACCUMULATING"
    DEBT_TYPES:
      - "DEBT.CULTURE"
      - "DEBT.KNOWLEDGE"
    DAMAGED_INVARIANTS:
      - "living memory"
      - "language continuity"
      - "identity transmission"
    DEBT_CARRIER:
      - "families"
      - "community"
      - "future generations"
    DEBT_DIRECTION: "present_to_future"
    DEBT_VISIBILITY: "VISIBLE"
    DRIFT_RATE: "MEDIUM"
    REPAIR_RATE: "LOW"
    REPAIR_STATUS: "PARTIAL"
  LATTICE_ALIGNMENT:
    CURRENT_STATE: "DRIFT.LATT"
    ROUTE: "CULTURE_MEMORY_LOSS"
  REPAIR_OUTPUT:
    OUTPUT_TYPE: "REPAIR"
    REQUIRED_ACTIONS:
      - "language documentation"
      - "intergenerational teaching"
      - "ritual renewal"
      - "living archive"
      - "community-led preservation"
  ANTI_CONFUSION:
    - "Do not treat all cultural change as loss."
    - "Do not treat preservation as fossilisation."
    - "Test living continuity and memory transfer."

EXAMPLE_04_FRONTIER_LEDGER:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "Advanced frontier project expands capability but may burn base resources."
    OBJECT_TYPE: "frontier debt"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L4.SHELL.CONTINUITY"
    DOMAIN_PRIMARY: "CIV.FRO"
    DOMAIN_SECONDARY:
      - "CIV.P4"
      - "CIV.BAS"
      - "CIV.ENV"
      - "CIV.REP"
  LEDGER:
    STATUS: "WATCH"
    DEBT_TYPES:
      - "DEBT.FUTURE"
      - "DEBT.FRONTIER"
      - "DEBT.ECOLOGICAL"
    DAMAGED_INVARIANTS:
      - "future continuity if base rent unpaid"
      - "ecological floor if resource cost hidden"
    PROTECTED_INVARIANTS:
      - "future capability"
      - "frontier optionality"
    DEBT_CARRIER:
      - "future generations"
      - "base environment"
      - "public institutions"
    DEBT_DIRECTION: "present_to_future"
    DEBT_VISIBILITY: "UNKNOWN"
    DRIFT_RATE: "UNKNOWN"
    REPAIR_RATE: "UNKNOWN"
    REPAIR_STATUS: "UNKNOWN"
  LATTICE_ALIGNMENT:
    CURRENT_STATE: "FRO.LATT"
    CONDITIONAL_WARNING: "FRO.LATT fails if P3 floor rent is unpaid."
  REQUIRED_BASE_RENT_RECORD:
    - "energy cost"
    - "ecological cost"
    - "institutional cost"
    - "repair capacity"
    - "reversibility"
    - "intergenerational effect"
  REPAIR_OUTPUT:
    OUTPUT_TYPE: "AUDIT"
    REQUIRED_ACTIONS:
      - "base-rent audit"
      - "future debt disclosure"
      - "P3 floor preservation test"
      - "repair capacity assessment"

EXAMPLE_05_REALITY_LEDGER:
  CIV_OBJECT:
    HUMAN_DESCRIPTION: "False or distorted public signal becomes accepted reality."
    OBJECT_TYPE: "reality debt"
  MACHINE_ADDRESS:
    SHELL_ID: "CIV.L3.SHELL.MIND"
    DOMAIN_PRIMARY: "CIV.REA"
    DOMAIN_SECONDARY:
      - "CIV.LNG"
      - "CIV.GOV"
      - "CIV.REP"
  LEDGER:
    STATUS: "ACCUMULATING"
    DEBT_TYPES:
      - "DEBT.REALITY"
      - "DEBT.TRUST"
      - "DEBT.LANGUAGE"
    DAMAGED_INVARIANTS:
      - "truth preservation"
      - "source traceability"
      - "public trust"
      - "signal clarity"
    DEBT_CARRIER:
      - "public reality field"
      - "citizens"
      - "institutions"
    DEBT_DIRECTION: "visible_to_hidden"
    DEBT_VISIBILITY: "DISPUTED"
    DRIFT_RATE: "HIGH"
    REPAIR_RATE: "LOW"
    REPAIR_STATUS: "PARTIAL"
  LATTICE_ALIGNMENT:
    CURRENT_STATE: "DRIFT.LATT"
    POSSIBLE_NEXT_STATE: "INV.LATT"
    ROUTE: "REALITY_FOG_INCREASE"
  REPAIR_OUTPUT:
    OUTPUT_TYPE: "AUDIT"
    REQUIRED_ACTIONS:
      - "source calibration"
      - "claim-type separation"
      - "correction archive"
      - "counter-signal inclusion"
      - "public update path"

REPAIR_WASHING_TEST:
  DESCRIPTION: >
    Repair washing occurs when a system uses repair language, reform language,
    apology language, public-relations language, or symbolic correction while
    the damaged invariant remains unrepaired and Ledger debt remains.
  WARNING_SIGNALS:
    - "damage unnamed"
    - "debt not recorded"
    - "harmed party excluded"
    - "no success criteria"
    - "no audit"
    - "same drift continues"
    - "repair announcement replaces repair evidence"
    - "responsibility unclear"
    - "cost moved into future"
  FAIL_CONDITIONS:
    - "Repair action does not target damaged invariant."
    - "Ledger debt remains ACCUMULATING after claimed repair."
    - "RepairRate is lower than DriftRate."
    - "VeriWeft repair alignment fails."
    - "Repair output hides inverse route."
  VALID_REPAIR_CONDITIONS:
    - "damaged invariant identified"
    - "debt recorded"
    - "repair action tied to debt"
    - "affected carrier considered"
    - "success criteria observable"
    - "repair rate measurable"
    - "drift reduced"

HIDDEN_DEBT_TEST:
  DESCRIPTION: >
    Hidden debt is cost that has not been recorded, acknowledged, or assigned
    to the correct carrier. Hidden debt can make a system look stable while
    moving toward negative, inverse, or collapse lattice.
  DETECTION_QUESTIONS:
    - "Who pays the cost?"
    - "When does the cost appear?"
    - "Is the cost visible or hidden?"
    - "Is the cost being transferred to children or future institutions?"
    - "Is one group benefiting while another carries damage?"
    - "Is public reality hiding the debt?"
    - "Is the system calling debt success?"
    - "Can repair access the damaged area?"
  COMMON_HIDDEN_DEBT_FORMS:
    - "future generation cost"
    - "student knowledge gaps hidden by grades"
    - "institutional legitimacy loss"
    - "environmental degradation"
    - "public trust erosion"
    - "language and culture thinning"
    - "unmaintained infrastructure"
    - "trauma hidden under order"
    - "frontier overextension"
  CLASSIFICATION_EFFECT:
    IF_HIDDEN_DEBT_FOUND:
      BLOCK:
        - "+LATT"
        - "P3.STABLE_FLOOR"
        - "FRO.LATT without warning"
      REQUIRE:
        - "LEDGER.ACCUMULATING or WATCH"
        - "VeriWeft WARN or FAIL"
        - "Repair Output AUDIT or REPAIR"

LEDGER_CONFIDENCE_RULES:
  DESCRIPTION: >
    Ledger confidence depends on evidence strength, debt visibility, source
    traceability, counter-signal review, and repair observability.
  HIGH_CONFIDENCE_ALLOWED_IF:
    - "debt is measured or strongly documented"
    - "source is traceable"
    - "counter-signals checked"
    - "time horizon clear"
    - "scale clear"
    - "repair history visible"
    - "VeriWeft status PASS or strong WARN"
  MEDIUM_CONFIDENCE_ALLOWED_IF:
    - "debt pattern is plausible"
    - "evidence is partial but meaningful"
    - "source is known but not complete"
    - "repair status partially visible"
    - "counter-signal review incomplete"
  LOW_CONFIDENCE_REQUIRED_IF:
    - "debt visibility unknown"
    - "source missing"
    - "claim type unclear"
    - "debt carrier unknown"
    - "drift rate unknown"
    - "repair rate unknown"
    - "high uncertainty"
  HARD_RULE:
    - "No high confidence if Ledger status is UNKNOWN."
    - "No high confidence if evidence strength is LOW."
    - "No high confidence if counter-signals are not checked."

MORIARTY_ATTACK_AND_HARDENING:
  ATTACK_01_SURFACE_STABILITY:
    ATTACK: "System looks stable because it still operates."
    FAILURE: "Hidden debt ignored."
    HARDENING: "Ledger checks trust, knowledge, reality, governance, infrastructure, ecological, culture, and future debt."
  ATTACK_02_REPAIR_WASHING:
    ATTACK: "System announces repair without reducing debt."
    FAILURE: "Public relations replaces correction."
    HARDENING: "Repair must identify invariant, record debt, reduce drift, and show success criteria."
  ATTACK_03_UNRECORDED_COST:
    ATTACK: "Cost is moved to weaker actors or future generations."
    FAILURE: "Debt carrier hidden."
    HARDENING: "Ledger requires DEBT_CARRIER and DEBT_DIRECTION."
  ATTACK_04_POSITIVE_WITH_HIDDEN_DEBT:
    ATTACK: "AI classifies route as positive while debt accumulates."
    FAILURE: "False +LATT."
    HARDENING: "Hidden debt blocks +LATT unless debt is recorded and repair-positive."
  ATTACK_05_COLLAPSE_WITHOUT_BREACH:
    ATTACK: "AI calls collapse dramatically without Ledger breach."
    FAILURE: "Collapse noise."
    HARDENING: "COL.LATT requires BREACHED Ledger or repair-corridor closure evidence."
  ATTACK_06_FRONTIER_WITHOUT_RENT:
    ATTACK: "AI calls novelty frontier progress."
    FAILURE: "P4 burns P3."
    HARDENING: "FRO.LATT requires future debt record and base-rent test."
  ATTACK_07_MEMORY_ERASURE:
    ATTACK: "Past harm disappears because present output looks normal."
    FAILURE: "Ledger memory lost."
    HARDENING: "Ledger preserves unresolved cost until repaired, not until ignored."
  ATTACK_08_OVERCONFIDENT_LEDGER:
    ATTACK: "AI assigns precise debt without evidence."
    FAILURE: "Ledger hallucination."
    HARDENING: "Debt type, carrier, direction, visibility, and confidence are required."

MINIMUM_VALID_LEDGER_RECORD:
  LEDGER:
    STATUS: "UNKNOWN"
    DOMAIN_CONTEXT:
      SHELL_ID: null
      DOMAIN_PRIMARY: null
    INVARIANT_RECORD:
      DAMAGED_INVARIANTS: []
      PROTECTED_INVARIANTS: []
    DEBT_RECORD:
      DEBT_TYPES: []
      DEBT_DESCRIPTION: {}
      DEBT_CARRIER: []
      DEBT_ORIGIN: null
      DEBT_DIRECTION: null
      DEBT_VISIBILITY: "UNKNOWN"
    DRIFT_RECORD:
      DRIFT_RATE: "UNKNOWN"
      DRIFT_EVIDENCE: []
    REPAIR_RECORD:
      REPAIR_STATUS: "UNKNOWN"
      REPAIR_ACTIONS: []
      REPAIR_RATE: "UNKNOWN"
      REPAIR_SUCCESS_CRITERIA: []
      REPAIR_FAILURE_SIGNS: []
    AUDIT_RECORD:
      AUDIT_STATUS: "UNKNOWN"
      AUDITABILITY: "UNKNOWN"
      SOURCE_TRACEABILITY: "UNKNOWN"
      VERIWEFT_STATUS: "UNKNOWN"
    CONFIDENCE:
      LEVEL: "LOW"
      REASON: "Insufficient evidence to assign Ledger status."
      UNCERTAINTY:
        - "debt type unknown"
        - "debt carrier unknown"
        - "drift rate unknown"
        - "repair rate unknown"

FULL_LEDGER_TEMPLATE:
  LEDGER:
    STATUS: "[CLEAR / WATCH / ACCUMULATING / BREACHED / REPAIRING / UNKNOWN]"
    LEDGER_ID: "[optional unique record ID]"
    DOMAIN_CONTEXT:
      SHELL_ID: "[insert Shell ID]"
      DOMAIN_PRIMARY: "[insert primary Domain ID]"
      DOMAIN_SECONDARY:
        - "[insert secondary Domain ID]"
    INVARIANT_RECORD:
      DAMAGED_INVARIANTS:
        - "[insert damaged invariant]"
      PROTECTED_INVARIANTS:
        - "[insert protected invariant]"
      INVARIANT_STATUS: "[intact / damaged / disputed / repairing / unknown]"
    DEBT_RECORD:
      DEBT_TYPES:
        - "[DEBT.TRUST / DEBT.MORAL / DEBT.KNOWLEDGE / etc.]"
      DEBT_DESCRIPTION:
        "[debt type]": "[description]"
      DEBT_CARRIER:
        - "[who or what carries cost]"
      DEBT_ORIGIN: "[where debt began]"
      DEBT_DIRECTION: "[present_to_future / institution_to_public / etc.]"
      DEBT_VISIBILITY: "[VISIBLE / HIDDEN / DENIED / DISPUTED / MEASURED / UNKNOWN]"
    DRIFT_RECORD:
      DRIFT_TYPE: "[trust drift / knowledge drift / reality drift / etc.]"
      DRIFT_RATE: "[LOW / MEDIUM / HIGH / ACCELERATING / UNKNOWN]"
      DRIFT_DIRECTION: "[toward -LATT / toward INV.LATT / toward COL.LATT / etc.]"
      DRIFT_EVIDENCE:
        - "[observed signal]"
      PRIOR_STATE: "[prior Lattice or Ledger state]"
      CURRENT_STATE: "[current Lattice or Ledger state]"
      RISK_NEXT_STATE: "[possible next state]"
    REPAIR_RECORD:
      REPAIR_STATUS: "[NOT_STARTED / COSMETIC / ACTIVE / EFFECTIVE / FAILING / BLOCKED / UNKNOWN]"
      REPAIR_ACTIONS:
        - "[repair action]"
      REPAIR_RATE: "[NONE / LOW / MEDIUM / HIGH / ACCELERATING / UNKNOWN]"
      REPAIR_SUCCESS_CRITERIA:
        - "[observable success marker]"
      REPAIR_FAILURE_SIGNS:
        - "[observable failure marker]"
      REPAIR_HISTORY:
        - "[past repair attempt]"
      REPAIR_OWNER: "[responsible party or subsystem]"
    AUDIT_RECORD:
      AUDIT_STATUS: "[NOT_AUDITED / AUDITED / PARTIAL / BLOCKED / UNKNOWN]"
      AUDITABILITY: "[HIGH / MEDIUM / LOW / BLOCKED / UNKNOWN]"
      SOURCE_TRACEABILITY: "[HIGH / MEDIUM / LOW / UNKNOWN]"
      COUNTER_SIGNAL_CHECKED: "[YES / NO / PARTIAL / UNKNOWN]"
      VERIWEFT_STATUS: "[PASS / WARN / FAIL / UNKNOWN]"
    TIME_RECORD:
      ZTIME_PRIMARY: "[T0-T5]"
      ZTIME_SECONDARY:
        - "[secondary time horizon]"
      COST_TRANSFER_TIME: "[same_generation / intergenerational / frontier_time / unknown]"
      INTERGENERATIONAL_EFFECT: "[description]"
    SCALE_RECORD:
      ZOOM_PRIMARY: "[Z0-Z8]"
      ZOOM_SECONDARY:
        - "[secondary zoom]"
      SCALE_BRIDGE_SIGNALS:
        - "[bridge signal]"
    CONFIDENCE:
      LEVEL: "[LOW / MEDIUM / HIGH]"
      REASON: "[explain]"
      UNCERTAINTY:
        - "[uncertainty]"

CANONICAL_LOCK:
  FULL_LOCK: >
    The Ledger is the memory, debt, drift, invariant-damage, audit, and repair
    record layer of the Civilisation Layer Stack AI/LLM architecture. It prevents
    AI from confusing surface operation with real health by recording hidden cost,
    damaged invariants, debt carriers, debt direction, drift rate, repair rate,
    repair history, and unresolved costs. A repair claim is valid only when the
    damaged invariant is identified, the debt is recorded, and RepairRate is
    greater than or equal to DriftRate.
  SHORT_LOCK: >
    Ledger = Memory.
    Debt = Unpaid cost.
    Drift = Damage movement.
    Repair = Debt reduction.
    Stability = RepairRate >= DriftRate.
  MORIARTY_LOCK: >
    No stability without debt check.
    No repair without Ledger reduction.
    No positive Lattice with hidden debt.
    No collapse without breach evidence.
    No frontier without future-debt and base-rent record.
    No confidence without debt visibility.

NEXT_ARTICLE:
  NEXT_ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.007"
  NEXT_ARTICLE_TITLE: "Layer 0 Base Shell"
  NEXT_ARTICLE_FUNCTION: >
    Define Layer 0 as the Base Shell of the Civilisation Layer Stack, including
    CIV.BAS, CIV.INF, and CIV.ENV as AI-readable Domain IDs for base substrate,
    infrastructure base, and ecological carrying systems.
  NEXT_ARTICLE_OUTPUTS:
    - "Layer 0 public definition"
    - "CIV.L0.SHELL.BASE machine definition"
    - "CIV.BAS domain registry"
    - "CIV.INF domain registry"
    - "CIV.ENV domain registry"
    - "Base Shell Lattice examples"
    - "Base Shell Ledger and repair tests"

ARTICLE_ID: "CIVSTACK.RA.AI.FULLCODE.007"
ARTICLE_TITLE: "Layer 0 Base Shell"
ARTICLE_TYPE: "AI_LLM_FULL_CODE_ONLY"
SYSTEM_FAMILY: "Civilisation Layer Stack"
REFERENCE_ARCHITECTURE: "CIVSTACK.RA.AI.v1"
PUBLIC_STACK_POSITION: "Layer 0"
PUBLIC_SHELL_NAME: "Base Shell"
MACHINE_SHELL_ID: "CIV.L0.SHELL.BASE"
VERSION: "v1.0"
STATUS: "ACTIVE"
AUTHORING_ENTITY: "eduKateSG"
PURPOSE: >
  Define Layer 0 as the Base Shell of the Civilisation Layer Stack,
  including CIV.BAS, CIV.INF, and CIV.ENV as AI-readable Domain IDs
  for base substrate, infrastructure base, and ecological carrying systems.
CORE_RULE: >
  Layer 0 is the physical, infrastructural, and ecological operating floor
  upon which all higher civilisation shells depend. No civilisation can
  coordinate, educate, govern, trade, preserve culture, or enter frontier
  phases if its Base Shell collapses beyond repair.
ARCHITECTURE_LOCK:
  - "Layer = public-facing shell."
  - "Shell = broad civilisation container."
  - "ID = machine-readable subsystem address."
  - "Lattice = state, route, drift, and repair geometry."
  - "Ledger = memory of damage, debt, repair, and invariant breach."
  - "VeriWeft = relationship-validity checker across shell, domain, lattice, and time."

LAYER_0_PUBLIC_DEFINITION:
  PUBLIC_NAME: "Layer 0 — Base Shell"
  SIMPLE_DEFINITION: >
    Layer 0 is the base shell of civilisation. It contains the physical
    ground, infrastructure, and ecological systems that allow civilisation
    to exist before higher systems such as government, economy, culture,
    education, law, and technology can operate.
  READER_DEFINITION: >
    The Base Shell is the floor of civilisation. It includes land, water,
    energy, roads, ports, power systems, digital infrastructure, climate,
    soil, ecosystems, and the carrying environment that supports life and
    coordination. If this floor breaks, every higher layer becomes unstable.
  PUBLIC_EXPLANATION: >
    Civilisation does not begin with ideas, laws, money, or culture alone.
    It must first stand somewhere, draw water from somewhere, receive energy
    from somewhere, move goods through somewhere, and survive inside an
    environment that can carry human activity. This is Layer 0.
  CORE_PUBLIC_QUESTION: >
    Can civilisation physically exist, remain connected, and continue
    drawing from the environment without destroying the floor that supports it?
  HUMAN_READABLE_SUMMARY:
    - "Layer 0 is the floor."
    - "It contains land, water, energy, infrastructure, and ecology."
    - "It supports all higher civilisation activity."
    - "If Layer 0 fails, higher layers lose their operating base."
    - "Layer 0 must be protected, maintained, repaired, and audited continuously."

CIV_L0_SHELL_BASE:
  SHELL_ID: "CIV.L0.SHELL.BASE"
  PUBLIC_LAYER: "Layer 0"
  PUBLIC_SHELL_NAME: "Base Shell"
  MACHINE_NAME: "Civilisation Base Shell"
  ABBREVIATION: "L0.BASE"
  SHELL_CLASS: "FOUNDATIONAL_OPERATING_FLOOR"
  FUNCTION: >
    Provides the physical, infrastructural, and ecological foundation
    upon which all other civilisation shells depend.
  CONTAINS_DOMAIN_IDS:
    - "CIV.BAS"
    - "CIV.INF"
    - "CIV.ENV"
  PRIMARY_DEPENDENTS:
    - "CIV.L1.SHELL.LIFE"
    - "CIV.L2.SHELL.ORDER"
    - "CIV.L3.SHELL.MIND"
    - "CIV.L4.SHELL.CONTINUITY"
  BASE_INVARIANT: >
    A civilisation cannot remain viable if its physical substrate,
    infrastructure floor, or ecological carrying systems fall below
    the minimum continuity threshold.
  CIVILISATION_FUNCTIONS_SUPPORTED:
    - "food production"
    - "water access"
    - "energy access"
    - "shelter"
    - "transport"
    - "communication"
    - "public health support"
    - "economic exchange"
    - "institutional continuity"
    - "education access"
    - "cultural continuity"
    - "emergency repair"
    - "frontier expansion"
  FAILURE_MODES:
    - "resource exhaustion"
    - "water insecurity"
    - "energy failure"
    - "infrastructure collapse"
    - "ecological overshoot"
    - "soil degradation"
    - "climate stress"
    - "transport paralysis"
    - "digital base failure"
    - "housing-base failure"
    - "disaster exposure"
    - "repair-lag accumulation"
  STABILITY_TEST: >
    Layer 0 is stable when physical substrate, infrastructure, and
    ecological systems can support current civilisation load while
    preserving future repair and continuity capacity.
  COLLAPSE_TEST: >
    Layer 0 enters collapse danger when civilisation load exceeds
    the combined carrying, repair, and adaptation capacity of its
    base substrate, infrastructure, and ecological systems.
  CORE_FORMULA:
    STABILITY: "BaseCapacity + RepairCapacity + AdaptationCapacity >= CivilisationLoad"
    DANGER: "CivilisationLoad > BaseCapacity + RepairCapacity + AdaptationCapacity"
    COLLAPSE: "CivilisationLoad >> RepairCapacity over sustained time"

L0_DOMAIN_REGISTRY:
  SHELL_ID: "CIV.L0.SHELL.BASE"
  DOMAIN_COUNT: 3
  DOMAINS:
    CIV.BAS:
      NAME: "Base Substrate"
      FUNCTION: "Physical ground, materials, geography, water, land, and energy base."
    CIV.INF:
      NAME: "Infrastructure Base"
      FUNCTION: "Built systems that allow movement, power, shelter, communication, and logistics."
    CIV.ENV:
      NAME: "Ecological Carrying Systems"
      FUNCTION: "Natural systems that absorb, replenish, regulate, and carry civilisation activity."
  DOMAIN_RELATIONSHIP: >
    CIV.BAS supplies the raw physical base. CIV.INF converts part of
    that base into usable civilisation corridors. CIV.ENV determines
    whether the base remains regenerative, degraded, overloaded, or
    hostile to long-term continuity.
  MACHINE_READING_RULE: >
    AI systems must not treat CIV.BAS, CIV.INF, and CIV.ENV as identical.
    A civilisation can be rich in physical substrate but weak in
    infrastructure; strong in infrastructure but degrading its ecology;
    or ecologically rich but unable to coordinate higher civilisation
    functions due to weak built systems.

CIV_BAS_DOMAIN_REGISTRY:
  DOMAIN_ID: "CIV.BAS"
  DOMAIN_NAME: "Base Substrate"
  SHELL_ID: "CIV.L0.SHELL.BASE"
  DOMAIN_CLASS: "PHYSICAL_SUBSTRATE"
  PUBLIC_NAME: "Land, water, energy, materials, and geography"
  DEFINITION: >
    CIV.BAS is the base substrate domain of civilisation. It includes
    the physical conditions, resources, geography, terrain, land,
    water access, energy sources, raw materials, and location constraints
    that determine what a civilisation can physically build upon.
  CORE_QUESTION: >
    What physical base does this civilisation stand on, draw from,
    move through, and depend upon?
  PRIMARY_COMPONENTS:
    - "land"
    - "terrain"
    - "geography"
    - "rivers"
    - "coastlines"
    - "groundwater"
    - "soil"
    - "minerals"
    - "energy sources"
    - "climate zone"
    - "strategic location"
    - "natural barriers"
    - "resource corridors"
    - "spatial constraints"
    - "habitable zones"
  INPUTS:
    - "natural resources"
    - "geographic location"
    - "water access"
    - "land availability"
    - "energy potential"
    - "material deposits"
    - "terrain conditions"
  OUTPUTS:
    - "settlement possibility"
    - "resource base"
    - "agricultural possibility"
    - "transport possibility"
    - "defence geography"
    - "energy availability"
    - "construction possibility"
  DEPENDS_ON:
    - "geological stability"
    - "hydrological access"
    - "resource renewability or substitutability"
    - "habitable environment"
    - "spatial carrying capacity"
  SUPPORTS:
    - "CIV.LIF"
    - "CIV.POP"
    - "CIV.LOG"
    - "CIV.ECO"
    - "CIV.SEC"
    - "CIV.FRO"
  POSITIVE_STATE:
    DESCRIPTION: >
      Base substrate supports population, production, mobility,
      resilience, and future repair without immediate exhaustion.
    SIGNALS:
      - "sufficient water"
      - "usable land"
      - "available energy"
      - "resource diversity"
      - "strategic connectivity"
      - "manageable physical risk"
  NEUTRAL_STATE:
    DESCRIPTION: >
      Base substrate exists but is not yet fully activated, stressed,
      or decisive.
    SIGNALS:
      - "unused land"
      - "latent resources"
      - "undeveloped geography"
      - "moderate carrying capacity"
      - "manageable but unoptimised location"
  NEGATIVE_STATE:
    DESCRIPTION: >
      Base substrate is damaged, insufficient, inaccessible, depleted,
      contested, or unable to support current civilisation load.
    SIGNALS:
      - "water scarcity"
      - "soil exhaustion"
      - "resource depletion"
      - "land pressure"
      - "energy insecurity"
      - "disaster-prone geography"
      - "unusable or degraded terrain"
  INVERSE_STATE:
    DESCRIPTION: >
      The physical base is used in a way that destroys its own future
      ability to support civilisation.
    SIGNALS:
      - "resource extraction destroying carrying base"
      - "land use that removes future habitability"
      - "water extraction beyond recharge"
      - "energy pathway creating long-term base instability"
      - "strategic geography converted into chronic conflict corridor"
  REPAIR_STATE:
    DESCRIPTION: >
      Civilisation restores, substitutes, conserves, or redesigns its
      physical base to recover viability.
    SIGNALS:
      - "water restoration"
      - "soil rehabilitation"
      - "resource substitution"
      - "land-use correction"
      - "renewable energy transition"
      - "risk-adapted settlement planning"
  FAILURE_MODES:
    - "BaseExhaustion"
    - "WaterFloorFailure"
    - "SoilCarryingCollapse"
    - "EnergyBaseFailure"
    - "LandPressureCompression"
    - "GeographicIsolation"
    - "ResourceWarCorridor"
    - "DisasterExposureEscalation"
  REPAIR_ACTIONS:
    - "reduce extraction pressure"
    - "restore water systems"
    - "protect soil and land"
    - "diversify energy base"
    - "develop resource substitutes"
    - "audit land-use patterns"
    - "map carrying thresholds"
    - "build redundancy across physical corridors"
  LEDGER_FIELDS:
    - "resource_debt"
    - "water_debt"
    - "soil_debt"
    - "energy_debt"
    - "land_debt"
    - "future_floor_debt"