iURi — Core Brain

iURi is the core conversational brain that powers iURi applications. It listens before it responds and says what it can and cannot support. CRIT Gate enforces safety and veracity around model output. Eight guardians explain the decision from different safety angles. Decisions are auditable through structured logs. When evidence is missing, it chooses uncertainty or silence over speculation.

Start here

• iURi Core for the canonical iURi Core overview.
• START_HERE.md for a human-first navigation guide.

Architecture at a glance

• backend/core/brain_core.py main request pipeline
• backend/core/context_router.py routing experts and presets
• backend/core/rag_agent/veracity_gate.py guardian veracity gate
• docs/veracity_v2_policy.md veracity policy notes
• backend/tools/smoke_context_router.py smoke/scenario harness

CRIT Gate and the eight guardians

• Gate entrypoint: backend/core/crit_gate.py
• Guardians overview: docs/GUARDIANS_SUMMARY_FOR_HUMANS.md
• Full roll call: docs/GUARDIANS_ROLL_CALL.md
• Guardians (what each protects):
  • Pacto (ethics): harm and consent
  • Comando (shell_commands): destructive or invasive commands
  • Núcleo (system_config): system and network safety
  • Flujo (workflow): reproducibility and verification
  • Frontera (project_scope): scope creep control
  • Veritas (veracity): evidence and truthfulness
  • Airbag (safety): risk and damage reduction
  • Ledger (traceability): audit trail and justification

Applications

• Applications index: docs/applications/README.md
• iURi Totem: docs/totem/README.md
• iURi Mar / Pescadores (legacy): docs/legacy/README_pescadores.md
• Web UI: frontend/
• Deploy: docs/deploy/LOCAL_PROD_SMOKE.md

How to publish (frontend)

• PRs: build checks only.
• Merge to main: automatic frontend deploy.
• Manual deploy: run the GitHub Actions workflow Frontend CI/CD.

Repo map

• backend/ core runtime and APIs
• frontend/ UI and client-side assets
• sap/ guardians, safety, telemetry, and policy code
• tests/ backend tests
• tools/ internal tools and ops scripts
• docs/ product, design, and technical documentation
• scripts/ utilities and automation
• config/ configs and policies
• deploy/ deployment docs and manifests