codec-cortex

Implementación determinista del codec CODEC-CORTEX v0.4.0. Procesador modular de artefactos .cortex y .hcortex.md sin dependencia de LLM: parsea a AST, serializa CORTEX, renderiza HCORTEX, ejecuta validaciones VIEW, compara equivalencia, valida roundtrip bidireccional, deriva documentación e inventaria benchmarks.

Licencia: MPL-2.0. Releases anteriores bajo MIT.

codec-cortex es un procesador determinista de memoria cognitiva para agentes LLM/SLM. Opera sobre archivos .cortex (formato denso nativo) y .hcortex.md (representación humana reversible), sin depender de modelos de lenguaje.

Gate de reversibilidad

reversible:true solo es válido cuando:

1. view_coverage == 100%;
2. no existen errores E_VIEW_* ni E_HCORTEX_*;
3. el modo no es display;
4. el roundtrip canónico aplicable pasa sin pérdida no declarada.

Modelo conceptual

Instalación

pip install codec-cortex
# o para desarrollo
pip install -e ".[dev]"

Comandos principales

# Identidad
cortex --version

# Documentación y benchmark (E3)
cortex docstring canonicalize
cortex docstring --all
cortex benchmark --list

# Inspección y cobertura
cortex inspect skill/cortex/SKILL.md
cortex verify-view skill/cortex/SKILL.md

# Roundtrip CORTEX byte-identical
cortex roundtrip skill/cortex/SKILL.md

# CORTEX → HCORTEX
cortex convert skill/cortex/SKILL.md --from cortex --to hcortex --out /tmp/skill.hcortex.md

# HCORTEX → CORTEX
cortex convert skill/hcortex/SKILL.md --from hcortex --to cortex --out /tmp/skill.cortex.md

# Roundtrip bidireccional
cortex roundtrip-bidir skill/cortex/SKILL.md
cortex roundtrip-bidir skill/hcortex/SKILL.md

# Comparación de equivalencia
cortex compare skill/cortex/SKILL.md /tmp/skill.cortex.md

# Canonicalización
cortex canonicalize skill/cortex/SKILL.md --out /tmp/canonical.cortex.md

# Seguridad y auditoría (E2)
cortex doctor --scan-secrets
cortex audit status
cortex verify --signature skill/cortex/SKILL.md

Estado de madurez

Versiones

• v0.4.0 (actual) — License transition a MPL-2.0. SPDX headers, docs/legal/, trademark policy.
• v0.3.4 — E2: Security & Governance. Secret scanner, mutation gates, audit log, verify --signature.
• v0.3.3 — E1: CI/CD + PyPI. GitHub Actions, ruff 0 errores, publish automático.
• v0.3.2 — Nombres canónicos CLI. VIEW-aware canonicalize, corpus VIEW migration.
• v2.4.0 — Núcleo bidireccional CORTEX ⇄ HCORTEX verificado.

Licencia

MIT — Fidel Ernesto Lozada A.