version: "1.0"
date_utc: "2025-12-22"
status: "draft-canonical"

principles:
  - "Layer names are literal domains (GOV/SECURITY/TRANSIT/AUDIT)."
  - "Component names are short, concrete metaphors (TRIAGE/PANEL/DETECT/TRAIL)."
  - "Names must be legible to non-specialists (secondary-school educated)."
  - "Legacy names remain supported as aliases during transition."

aliases:
  IF.SEC:
    points_to: "IF.SECURITY"

forbidden:
  - "IG.GUARD"  # typo; use IF.GOV.PANEL / IF.GOV.PANEL.EXTENDED
  - "ig.guard"

names:
  IF.GOV.TRIAGE:
    legacy: ["IF.BIAS", "IF.Bias", "IF.bias", "if.bias"]
    academic: "controversy-weighted risk stratification"
    description: "Preflight risk triage that sizes councils and decides escalation."

  IF.GOV.PANEL:
    legacy: ["IF.GUARD", "IF.Guard", "IF.guard", "if.guard"]
    academic: "multi-agent oversight with structural dissent requirements"
    description: "Council governance protocol (minimum 5 seats including a contrarian)."

  IF.GOV.PANEL.EXTENDED:
    legacy: []
    academic: "extended multi-agent oversight panel"
    description: "Expanded panel up to ~30 seats for higher-stakes decisions."

  IF.GOV.QUESTIONS:
    legacy: ["IF.5W", "IF_5W", "if.5w"]
    academic: "provenance interrogative framework"
    description: "Structured inquiry briefs (who/what/when/where/why/how)."

  IF.GOV.WITNESS:
    legacy: ["IF.WITNESS", "IF.witness", "if.witness"]
    academic: "audit observation and compliance monitoring"
    description: "Independent witness that validates governance and trace discipline."

  IF.SECURITY.DETECT:
    legacy: ["IF.YOLOGUARD", "IF.Yologuard", "IF.yologuard", "if.yologuard"]
    academic: "context-aware secret detection"
    description: "Secret/relationship screening and credential hygiene primitives."

  IF.SECURITY.CHECK:
    legacy: ["IF.ARMOUR", "IF.armour", "if.armour"]
    academic: "epistemic anomaly detection and coherence validation"
    description: "Detective layer for coherence/inconsistency; no actuation authority."

  IF.TRANSIT.HUB:
    legacy: ["IF.BUS", "IF.bus", "if.bus"]
    academic: "privilege-enforced kinetic message router"
    description: "Deterministic actuation + privilege enforcement substrate."

  IF.TRANSIT.MESSAGE:
    legacy: ["IF.PACKET", "IF.packet", "if.packet"]
    academic: "cryptographically signed message protocol"
    description: "Schema-first message envelope with trace IDs and audit metadata."

  IF.TRANSIT.SWARM:
    legacy: ["swarm.s2", "IF.SWARM.s2", "IF.SWARM.S2"]
    academic: "distributed agent coordination"
    description: "Intra-swarm coordination layer over a Redis bus."

  IF.AUDIT.TRAIL:
    legacy: ["IF.TTT"]
    academic: "immutable chain-of-custody logging"
    description: "Trace discipline + signing + verification hooks for disputes."

  IF.AUDIT.PROOF:
    legacy: []
    academic: "portable verification bundle"
    description: "Exportable evidence bundle + manifest + verifier steps."

notes:
  - "IF.TTT remains the philosophical umbrella; use IF.AUDIT.* for concrete artifacts."
  - "Canonical `if://doc/*` handles + legacy aliases: see IF_DOC_HANDLE_REGISTRY.yaml."
  - "Multi-lingual translations: planned; keep canonical IDs stable and translate descriptions."