OPITA Runtime

🇨🇴 Motor de ejecución gobernada con IA. El runtime que impulsa OPITA OS — SDD workflow, cadena de providers, vault encriptado y ecosistema de plugins curado.

🇺🇸 Governed AI execution runtime. The engine powering OPITA OS — SDD workflow, provider chain, encrypted vault, and curated plugin ecosystem.

---

🇨🇴 ¿Qué es OPITA Runtime?

OPITA Runtime es el núcleo gobernado de ejecución de OPITA OS. Implementa un sistema completo de:

• SDD Workflow: Spec-Driven Development — explora, propone, especifica, diseña, implementa, verifica y archiva cambios de forma gobernada.
• Provider Chain: Cadena de providers con governance (bootstrap → fetch → review → execute → complete), con soporte para múltiples modelos de IA.
• Encrypted Vault: Almacenamiento encriptado AES-256-GCM para secretos y credenciales.
• Plugin Ecosystem: Sistema de extensiones con trust classes, risk tiers y capability contracts.
• Ledger + Journal: Sistema de auditoría inmutable con registros en YAML.
• Stores: 15+ stores gobernados (config, continuity, memory, ledger, threadline, vault, extensions, usage, billing, journal, knowledge, state, working-memory).

Estructura

runtime/
├── conductor/          # Orquestación de slices de continuidad
├── config/             # Configuración YAML-first
├── continuity/         # Handoff engine + threadline engine
├── contracts/          # Contratos canónicos
├── core/               # Lógica central (billing, cost estimation, personas, etc.)
├── gateway/            # Ejecutores (completion, bootstrap, fetch, import, activation)
├── policies/           # Motor de políticas
├── privacy-gateway/    # Gateway de privacidad
├── protocols/          # Protocolos de comunicación
├── recovery/           # Recuperación de estado
├── router/             # Enrutamiento y catálogo
├── shared/             # Utilidades compartidas
├── state/              # Máquina de estados
├── stores/             # 15+ stores gobernados
└── system-base/        # Boundary enforcement + audit hooks

---

🇺🇸 What is OPITA Runtime?

OPITA Runtime is the governed execution core of OPITA OS, implementing:

• SDD Workflow: Spec-Driven Development with full governance chain
• Provider Chain: Multi-model AI provider chain with governance
• Encrypted Vault: AES-256-GCM secret management
• Plugin Ecosystem: Trust-classed, risk-tiered extension system
• Immutable Audit: Ledger + Journal with YAML-based records
• 15+ Governed Stores: Config, continuity, memory, vault, extensions, usage, billing, and more

---

🛠️ Tech Stack

Layer	Technology
Runtime	Node.js ESM (.mjs)
Testing	node:test + node:assert/strict
Config	YAML-first, reversible changes
Rewrite (WIP)	Rust — see rust-runtime/

---

🧪 Tests

npm test

---

📄 License

MIT © 2026 Opita Code

---

Hecho con orgullo colombiano 🇨🇴 · Built with Colombian pride