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)."
  - "Deprecated aliases are intentionally omitted from public docs to avoid lexicon drift."

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:
    academic: "controversy-weighted risk stratification"
    description: "Preflight risk triage that sizes councils and decides escalation."

  IF.GOV.PANEL:
    academic: "multi-agent oversight with structural dissent requirements"
    description: "Council governance protocol (minimum 5 seats including a contrarian)."

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

  IF.GOV.QUESTIONS:
    academic: "provenance interrogative framework"
    description: "Structured inquiry briefs (who/what/when/where/why/how)."

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

  IF.SECURITY.DETECT:
    academic: "context-aware secret detection"
    description: "Secret/relationship screening and credential hygiene primitives."

  IF.SECURITY.CHECK:
    academic: "epistemic anomaly detection and coherence validation"
    description: "Detective layer for coherence/inconsistency; no actuation authority."

  IF.TRANSIT.HUB:
    academic: "privilege-enforced kinetic message router"
    description: "Deterministic actuation + privilege enforcement substrate."

  IF.TRANSIT.MESSAGE:
    academic: "cryptographically signed message protocol"
    description: "Schema-first message envelope with trace IDs and audit metadata."

  IF.TRANSIT.SWARM:
    academic: "distributed agent coordination"
    description: "Intra-swarm coordination layer over a Redis bus."

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

  IF.AUDIT.PROOF:
    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: see IF_DOC_HANDLE_REGISTRY.yaml."
  - "Multi-lingual translations: planned; keep canonical IDs stable and translate descriptions."