codec-cortex 0.3.2__py3-none-any.whl

codec_cortex-0.3.2.dist-info/METADATA

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: codec-cortex
+Version: 0.3.2
+Summary: CODEC-CORTEX CLI — modular deterministic processor for .cortex files
+Author: Fidel Ernesto Lozada A.
+License: MIT
+Project-URL: Homepage, https://github.com/FidelErnesto03/codec-cortex
+Project-URL: Documentation, https://github.com/FidelErnesto03/codec-cortex/blob/main/cli/README.md
+Project-URL: Repository, https://github.com/FidelErnesto03/codec-cortex
+Project-URL: Issues, https://github.com/FidelErnesto03/codec-cortex/issues
+Keywords: cortex,codec,memory,cli,llm,agent,cognitive
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# codec-cortex
+
+> Implementación determinista del codec CODEC-CORTEX v0.3.2. El núcleo v2 soporta CORTEX ⇄ HCORTEX verificable sobre los artefactos canónicos del paquete. CORTEX es el formato denso nativo; HCORTEX es su representación humana reversible.
+
+`codec-cortex` procesa artefactos `.cortex` y `.hcortex.md` sin depender de LLM: parsea a AST, serializa CORTEX, renderiza HCORTEX, ejecuta validaciones VIEW, compara equivalencia y valida roundtrip bidireccional.
+
+> **v0.3.2 — Naming canónico:** los comandos `v2-*` se han renombrado a sus formas canónicas (`roundtrip`, `convert`, `roundtrip-bidir`, `compare`, `verify-view`, `explain-loss`, `canonicalize`, `inspect`). Los nombres `v2-*` se mantienen como alias deprecados y emiten un `WARNING` a stderr al ser invocados. Serán eliminados en v1.0.0.
+
+## Modelo conceptual v0.3.2
+
+| Concepto | Rol | Estado |
+|---|---|---|
+| **CORTEX** | Representación densa nativa. Fuente canónica operacional y base de verificación, reversible por contrato VIEW. | `current` |
+| **HCORTEX / HUMAN-CORTEX** | Representación humana densa y reversible cuando conserva VIEW/trazabilidad equivalente con cobertura válida. | `current` |
+| **VIEW** | Contrato declarativo de correspondencia CORTEX ⇄ HCORTEX. Define render, reversión, campos, preservación y fallback. | `current` |
+| **CORTEX-OUT** | Respuesta conversacional eficiente. No participa en decode/encode/verify/roundtrip. | `specification` |
+
+HCORTEX canónico no es "Markdown bonito". Para declararse canónico debe poder participar en `decode/encode/verify/roundtrip` mediante VIEW o trazabilidad equivalente. Un Markdown sin VIEW/trazabilidad se considera `display-only` y debe reportar `reversible:false`.
+
+## 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.
+
+## Estado de madurez
+
+| Capacidad | Estado | Evidencia principal |
+|---|---|---|
+| CORTEX v2 parser/writer | `current` | `cortex roundtrip` byte-identical |
+| CORTEX → HCORTEX | `current` | genera `skill/hcortex/SKILL.md` byte-identical |
+| HCORTEX → CORTEX | `current` | reconstruye 266/266 entries en `skill/cortex/SKILL.md` |
+| Roundtrip bidireccional | `current` | `cortex roundtrip-bidir` rc=0, 0 diffs en ambos artefactos canónicos |
+| VIEW coverage | `current` | 44/44 VIEW en skill; 10/10 artefactos del corpus migrados a VIEW en v0.3.2 |
+| `cortex canonicalize` (VIEW-aware) | `current` | preserva estructura sin VIEW; canonicalización completa con VIEW (B-01/B-05 fix) |
+| Hash mismatch | `current` para hashes declarados | `E_VIEW_HASH_MISMATCH` si el hash existe y no coincide |
+| `doctor` legacy | `current` | diagnóstico clásico del CLI |
+| `doctor` v2 | `planned` | no existe como comando separado en v0.3.2 |
+| JSON global para comandos legacy soportados | `current` parcial | `--json` donde el comando lo soporta |
+| JSON uniforme para todos los comandos v2 | `planned` | no declarar como actual |
+| MCP server | `future` | no implementado |
+| Runtime de maduración promote/decay | `future` | no implementado |
+
+## Artefactos canónicos
+
+| Ruta | Rol | Métrica verificada |
+|---|---|---|
+| `skill/cortex/SKILL.md` | CORTEX canónico | 43,925 bytes; 14 secciones; 266 entries; 44 VIEW |
+| `skill/hcortex/SKILL.md` | HCORTEX canónico | 47,186 bytes; reversible; roundtrip válido |
+| `benchmarks/v2.0.0/corpus/source/*.cortex` (10) | Corpus migrado a VIEW | 10/10 artefactos con VIEW directives; coverage 100% |
+
+## Instalación
+
+```bash
+pip install -e .
+# o para desarrollo
+pip install -e ".[dev]"
+```
+
+## Comandos principales (nombres canónicos v0.3.2)
+
+```bash
+# Identidad
+cortex --version
+
+# 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
+
+# Pérdida / canonicalización (VIEW-aware desde v0.3.2)
+cortex explain-loss skill/hcortex/SKILL.md
+cortex canonicalize skill/cortex/SKILL.md --out /tmp/canonical.cortex.md
+cortex canonicalize benchmarks/v2.0.0/corpus/source/devops-k8s-rollout.cortex \
+    --out /tmp/canonical.cortex            # WARNING: no VIEW → structure-preserving
+cortex canonicalize skill/cortex/SKILL.md --preserve --out /tmp/preserved.cortex
+```
+
+### Alias deprecados (aún aceptados, removidos en v1.0.0)
+
+| Canonical | Alias deprecado |
+|-----------|------------------|
+| `cortex roundtrip` | `cortex v2-roundtrip` |
+| `cortex convert` | `cortex v2-convert` |
+| `cortex roundtrip-bidir` | `cortex v2-roundtrip-bidir` |
+| `cortex compare` | `cortex v2-compare` |
+| `cortex verify-view` | `cortex v2-verify-view` |
+| `cortex explain-loss` | `cortex v2-explain-loss` |
+| `cortex canonicalize` | `cortex v2-canonicalize` |
+| `cortex inspect` | `cortex v2-inspect` |
+
+## Comandos legacy principales
+
+```bash
+cortex new brain --name my-brain --out brain.cortex
+cortex verify brain.cortex --strict --kind brain
+cortex render brain.cortex --mode edit --out brain.hcortex.edit.md
+cortex compile brain.hcortex.edit.md --out brain.compiled.cortex
+cortex doctor brain.cortex --strict --kind brain
+cortex diff brain.cortex brain.compiled.cortex --profile structural
+```
+
+## JSON
+
+El flag global `--json` existe, pero no todos los comandos v2 emiten JSON uniforme en v0.3.2. No declarar JSON v2 completo como capacidad actual. Los comandos legacy que lo soportan siguen disponibles; algunos comandos aceptan `--format json` local.
+
+## Tests
+
+```bash
+python -m pytest src/tests/ -q
+python -m pytest src/tests/test_v2_3_0_acceptance.py -q
+```
+
+## Documentación
+
+| Documento | Contenido |
+|---|---|
+| `STATUS.md` | Matriz honesta de capacidades actuales, planned y future |
+| `CHANGELOG.md` | Cambios por versión |
+| `VIEW_SCHEMA.md` | Contrato VIEW |
+| `EQUIVALENCE.md` | Niveles byte/AST/semantic/content |
+| `BENCHMARK.md` | Evidencia y comandos reproducibles |
+| `PACKAGING.md` | Reglas de paquete limpio |
+| `ERRORS.md` | Taxonomía de errores v2 |
+| `INFORME_DE_ENTREGA_v2.4.0.md` | Informe de entrega alineado |
+
+## Licencia
+
+MIT. Ver `LICENSE`.
+
+## Autoría
+
+Fidel Ernesto Lozada A. — `SKILL.md` v1.2.0-enterprise-candidate.

codec_cortex-0.3.2.dist-info/RECORD

@@ -0,0 +1,81 @@
+codec_cortex-0.3.2.dist-info/licenses/LICENSE,sha256=XH2MkxKGvJ_LcevUWgv7_OSxq37wpijTP-FogFipXCU,1080
+cortex/__init__.py,sha256=1Bs8--g5g1S2qeoIvX6uClpbBQWFAMaCQtdQw-dwPK4,899
+cortex/__main__.py,sha256=xUyHJQ7WGSMVwVG4SwzLyHz29cfLJNBzbPgY_x1QO8s,140
+cortex/_version.py,sha256=7Bzncojp21iM-dWXdN6Fqc8CpgZtvRE0o2j65xrTsR8,528
+cortex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cortex/cli/__init__.py,sha256=tvd7DQfNaSTI3DZ3h6crL-R-KIZIEQ11bmzmMvI66nU,93
+cortex/cli/main.py,sha256=qBuSsVoNgNNYewM_09_T8q9AOJQ0Q7gr8uKhafjU-0Q,28799
+cortex/cli/commands/__init__.py,sha256=SEEf4ZLEoWUWWyfTHJAX5Xa4ioenYNDnqZpU5xaogxw,5689
+cortex/cli/commands/add.py,sha256=UC4Lg_GAupSOPNHNAhsRnCOjSl2B-B6iu95hWfP_Ng8,3118
+cortex/cli/commands/compile.py,sha256=PeiE3F0_kbA-ibC-f2evCAaaNB288eVKMeoM6tWrvs8,1076
+cortex/cli/commands/delete.py,sha256=0zeGt2Ny8ar_ggV3nbMNcJSpU_7iM8QorCDLnYCQd7M,1286
+cortex/cli/commands/diagram.py,sha256=B7gacxogQph9UTgiC3CY1PRJEAnFoQialeoFsNToj_w,4469
+cortex/cli/commands/diff.py,sha256=Wuc6ItkoMTlbfRbRD2n9pJq3uA5JlewDXK7WDS1Xruc,5795
+cortex/cli/commands/doctor.py,sha256=k6biTi5DNwROnulrxhGj3XRWflQLh4V_49xGPn8ZZ90,2833
+cortex/cli/commands/format.py,sha256=ioxiFCZn9O4oifwrzXckBODA-V2zafPfhKa1C8I0w5E,783
+cortex/cli/commands/get.py,sha256=hpHKZPo5y1Gk0NTwfoqzttFt7PNa0edQTJ9qMNY6z1E,1425
+cortex/cli/commands/glossary.py,sha256=cPRwl278gWbveceBcs0DziIFTZK2EwolYzwBB39hXWY,3088
+cortex/cli/commands/list.py,sha256=LmKgvcZBGGiGQ34tfp-GaVhvwHetNHMNRWUaaKZ58mo,1345
+cortex/cli/commands/micro.py,sha256=tRJ0hM0-RUl5ecOjSbGgJrLiWmOWfFYapfbffIJpxk4,2511
+cortex/cli/commands/move.py,sha256=LWB0WT2CF-Lq8C_O76dM9SlQcAsRdiJfo4YNIo0Nn6M,1280
+cortex/cli/commands/new.py,sha256=5xNFj2DyKYNhSLk1fW_AkeZlNq1rovwZZiy4gmIwxac,2614
+cortex/cli/commands/recover.py,sha256=r2aZ6zBIOjdz3bcrEDftXQb-vIw6-WyXCKDq0d15UV4,3716
+cortex/cli/commands/render.py,sha256=OcNIh36Sf0Mau9VoE1cU_7cW9X5HCwve8GCELFxNpcg,3157
+cortex/cli/commands/update.py,sha256=hMia_xx9SgcslvHjM5RQhWVRYnNzP-Cn14lKJK0upns,2423
+cortex/cli/commands/v2_canonicalize.py,sha256=buiFvEB5YrQp3ychLIC4qSdNXt0B-MRXbjSAE6r9hAU,5842
+cortex/cli/commands/v2_compare.py,sha256=BsOagPsppUZWWqd0AlcBQBzy07j-JLDqyHeINv3k1UI,2623
+cortex/cli/commands/v2_convert.py,sha256=Rm92rM5pnU2LIBENOtL3o6VfAovQfqgi33pOInbE6go,7856
+cortex/cli/commands/v2_explain_loss.py,sha256=kiVlL_leO9GZk9u4_vORHHxyy-d_Hdmk5FilAEKt0ic,3521
+cortex/cli/commands/v2_inspect.py,sha256=CI7W5RC8pv837NQhD4uMPoi0Exk6A2MlfUhiiVpn514,4281
+cortex/cli/commands/v2_roundtrip.py,sha256=T6K_fZKylujuM2Lvb2KWCyA43y-LyrkOiwBqf5mCWcQ,4086
+cortex/cli/commands/v2_roundtrip_bidir.py,sha256=EFPQ9lh8xy_-3cSZ75IaDFJjn18juhCrka21jm0mPWg,5051
+cortex/cli/commands/v2_verify_view.py,sha256=PMaYt4iPumOkhCWyKceJ9I6mp07wQp-Ov43V-g5LFMI,2098
+cortex/cli/commands/verify.py,sha256=6szMscLYBgWlmDFl4IsV-RA1C-yK8x0HwJwpOL5QwaA,4250
+cortex/core/__init__.py,sha256=iy6qwId5H9UgPLg1UdaqxkxCR-WxKoUjplNqFHU2KWM,2760
+cortex/core/ast.py,sha256=1m_vXO3C-gx_uOmLinmZH_W6hSb5bFZiylzJGjJCOVs,9523
+cortex/core/compare.py,sha256=eYbO5CMP9Uz1QiTcktONO_TuggeDDv-NkBtAuFHzYn0,7221
+cortex/core/document_kind.py,sha256=pDe9k5zReudIZxOgg9odkSAvzcbfPkMjvXioXW20rE8,22618
+cortex/core/errors.py,sha256=UAdkxPPcyhbS5e5VkTsPNBMbJBLw_FwGF5mG1iyxIN8,13191
+cortex/core/lexer.py,sha256=EfoQGzByljkxa7xYo9N7HM8KQuNQsCW8KIxL7Y9yFE0,8145
+cortex/core/parser.py,sha256=SbMAqua8dC-7s61TqlUFne_qvviL3Tgrhk7tNFgNpds,23866
+cortex/core/validator.py,sha256=6tusJCqKBR66cSc36WTFea2mkRBmgbAt-ynHsK3EtTY,10167
+cortex/core/writer.py,sha256=7DFQa0wauAl3B-5zCMWJ675io3Ke1kPyKqDTprJUsNY,9207
+cortex/crud/__init__.py,sha256=jze-uKxhzZ7G7fdn4SjN79zWiJTh69APgEvvirTAv-8,830
+cortex/crud/mutations.py,sha256=bIToD7eDnvaUlFj_CUC2d-radLwO1pWAzKCAKA39QDU,11240
+cortex/crud/selectors.py,sha256=3LFv4FFy1YeMZ8lY1PYPIxK9aPUedx6VTJlXy94PSu8,2731
+cortex/crud/transactions.py,sha256=j_a43VmRWEYq9VC-HeJwrQDvVCCDviwhEDEZcfjWLVQ,6258
+cortex/glossary/__init__.py,sha256=lz1wLu0jTapR-xiLzAE9LB9P8tkr620WdwIHnV2hF4I,876
+cortex/glossary/contracts.py,sha256=Uh6t1e1Mxia-ZEo6JT5WDN_Y_EsPhcV5ZrbonqJQ6no,1152
+cortex/glossary/minimal.py,sha256=2DcTp_5UgAamUb34Z7XMCv5loCJyU23ZaH8FgZmQET4,5604
+cortex/glossary/model.py,sha256=lW_WmtGG1329NU2jha1QoqepvyNo5qF9Mzn5ZV4199Q,2374
+cortex/glossary/resolver.py,sha256=WHInARfNbNEpnRcSkDKZFW9rWNk8qWkuPFr7aO65lto,2958
+cortex/hcortex/__init__.py,sha256=ns1pnrYqBQ-dLjxU0uIXaVI_fyelmqYZrVEqGDGA-m4,1327
+cortex/hcortex/edit_parser.py,sha256=uyXMYoym8mZxewlu6SEP5jRYAStdZEKWtmrc3ucd7H8,15902
+cortex/hcortex/edit_renderer.py,sha256=AkLuHQYC4AeBopIwF3xN6riBkjcV49sMG8wVKtFXkok,5417
+cortex/hcortex/markdown_model.py,sha256=JLHyN07a5ZOmLsxcSOZagsCJpWsURjRpW2JZdXXZyFc,2759
+cortex/hcortex/profiles.py,sha256=e4ir9O99UThtPThffIP_h68EnE5F0V_iuOtTBfVn4uE,5777
+cortex/hcortex/read_renderer.py,sha256=6usu_ZTp4gS74g9vgNUSCprFo54Vqc1jCndGDiqzmT8,11317
+cortex/hcortex/recovery.py,sha256=huT_EOteDFi_3zOfRglufC3xN-gEHoO2uDDkui9kDPo,29832
+cortex/templates/__init__.py,sha256=D49Z4J-Nvl_o_tPM_z_KvW2m9fRIpHL4jYeSoCBmioo,292
+cortex/templates/brain.py,sha256=Ngs5Aj8Rf3c2LAckJxrN4K9oKGpmaZ-Ou_zZQhkA7jY,3531
+cortex/templates/minimal_glossary.py,sha256=ZeP4GH929_bqoKBVlluAF9Wgv9Ajtz-8HcIETkjsXcY,1564
+cortex/templates/package.py,sha256=g07bX_w1ZLDt7CtvLsYUo6e3w32nYQcCV7QQICmYivE,2861
+cortex/templates/skill.py,sha256=A7w0PK1Bwl2g3opFDnbREQVMdWDRm_LwoipQygXwjuQ,2790
+cortex/v2/__init__.py,sha256=X_F5k1qCigl1tNO7z1BwVD_oCy-hms8A9i4CyIBZDMw,1215
+cortex/v2/diagnostics.py,sha256=K_dFInoAJT3Q27Gorn5oTWlnwMoMceC8SB0TFl-PWAw,2044
+cortex/v2/encoder.py,sha256=3bWh5WI5R4Fxfx0kQpzZ9WoOoNwdLJ-FSd4pKqsQZ9w,38344
+cortex/v2/equivalence.py,sha256=Xjb6LgQvH56Qx-h2TbBI8HILZc05VNNvrtZg3Opnhhk,11948
+cortex/v2/hcortex_parser.py,sha256=aLgjmwuCFLe-nmnjAr1TF1joFOcVRMZixvxUioB_O5E,20336
+cortex/v2/hcortex_renderer.py,sha256=q1Rf1U3veL5ruHkQPz3BVtuNdvVZ80plsPv1mQ4m4s4,16784
+cortex/v2/ir.py,sha256=bCy6a3mbBs2ixwQixGjuEc1i0x0vGLWawTGAC2Pp0jc,8330
+cortex/v2/parser.py,sha256=wQkq7NnBQQDIzgkWxMpn-0GKxEppOPwidDnQOp4VMnY,20075
+cortex/v2/view.py,sha256=Rm9qcEcNDeidWy3Y5CAsSv4dvMrOqvb1Vl3k7WhTetA,15197
+cortex/v2/view_renderer.py,sha256=LQ5IP9b9giYofTL42F4cp6v3uAGvVZWYm0kYeGFw3nA,18553
+cortex/v2/writer.py,sha256=TiEbTfFPwtpFa-jNVbrShviyVvCNAu61baeCCAFnMDM,10913
+codec_cortex-0.3.2.dist-info/METADATA,sha256=rQLFkQ1SE1UxcOEPVbo-3GPx9w5DNdmqSDHwoK9zuI4,8137
+codec_cortex-0.3.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+codec_cortex-0.3.2.dist-info/entry_points.txt,sha256=_Fl_fZk_6jJeX4QXcG1dT4WakyDZVu_G320FkcyQUOI,48
+codec_cortex-0.3.2.dist-info/scm_file_list.json,sha256=Zm6OWQv8RtPgN8c5w4xfa8pzJSYNvNzH976T_BmOpRQ,4411
+codec_cortex-0.3.2.dist-info/scm_version.json,sha256=a54wpletfE6bmUiRUMXsGhr1UwZJYX1Wc2KqMusTe34,160
+codec_cortex-0.3.2.dist-info/top_level.txt,sha256=79LAeTJJ_pMIBy3mkF7uNaN0mdBRt5tGrnne5N_iAio,7
+codec_cortex-0.3.2.dist-info/RECORD,,

codec_cortex-0.3.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codec_cortex-0.3.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cortex = cortex.cli.main:main

codec_cortex-0.3.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fidel Ernesto Lozada A.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codec_cortex-0.3.2.dist-info/scm_file_list.json

@@ -0,0 +1,124 @@
+{
+  "files": [
+    "INFORME_DE_ENTREGA_v2.4.0.md",
+    "README.md",
+    "audit.cortex.md",
+    "LICENSE",
+    "VIEW_SCHEMA.md",
+    "pyproject.toml",
+    "EQUIVALENCE.md",
+    "CHANGELOG.md",
+    "ERRORS.md",
+    "PACKAGING.md",
+    "INFORME_DE_ENTREGA_v0.3.2.md",
+    "BENCHMARK.md",
+    "INFORME_DE_ENTREGA_v2.3.1.md",
+    "STATUS.md",
+    "src/cortex/py.typed",
+    "src/cortex/__init__.py",
+    "src/cortex/__main__.py",
+    "src/cortex/core/validator.py",
+    "src/cortex/core/__init__.py",
+    "src/cortex/core/document_kind.py",
+    "src/cortex/core/parser.py",
+    "src/cortex/core/writer.py",
+    "src/cortex/core/ast.py",
+    "src/cortex/core/lexer.py",
+    "src/cortex/core/compare.py",
+    "src/cortex/core/errors.py",
+    "src/cortex/hcortex/recovery.py",
+    "src/cortex/hcortex/markdown_model.py",
+    "src/cortex/hcortex/edit_parser.py",
+    "src/cortex/hcortex/__init__.py",
+    "src/cortex/hcortex/edit_renderer.py",
+    "src/cortex/hcortex/profiles.py",
+    "src/cortex/hcortex/read_renderer.py",
+    "src/cortex/crud/transactions.py",
+    "src/cortex/crud/selectors.py",
+    "src/cortex/crud/__init__.py",
+    "src/cortex/crud/mutations.py",
+    "src/cortex/glossary/minimal.py",
+    "src/cortex/glossary/model.py",
+    "src/cortex/glossary/resolver.py",
+    "src/cortex/glossary/__init__.py",
+    "src/cortex/glossary/contracts.py",
+    "src/cortex/v2/__init__.py",
+    "src/cortex/v2/hcortex_renderer.py",
+    "src/cortex/v2/view_renderer.py",
+    "src/cortex/v2/parser.py",
+    "src/cortex/v2/diagnostics.py",
+    "src/cortex/v2/view.py",
+    "src/cortex/v2/writer.py",
+    "src/cortex/v2/encoder.py",
+    "src/cortex/v2/hcortex_parser.py",
+    "src/cortex/v2/ir.py",
+    "src/cortex/v2/equivalence.py",
+    "src/cortex/templates/package.py",
+    "src/cortex/templates/__init__.py",
+    "src/cortex/templates/skill.py",
+    "src/cortex/templates/brain.py",
+    "src/cortex/templates/minimal_glossary.py",
+    "src/cortex/cli/__init__.py",
+    "src/cortex/cli/main.py",
+    "src/cortex/cli/commands/verify.py",
+    "src/cortex/cli/commands/__init__.py",
+    "src/cortex/cli/commands/v2_verify_view.py",
+    "src/cortex/cli/commands/v2_explain_loss.py",
+    "src/cortex/cli/commands/get.py",
+    "src/cortex/cli/commands/v2_inspect.py",
+    "src/cortex/cli/commands/recover.py",
+    "src/cortex/cli/commands/diagram.py",
+    "src/cortex/cli/commands/v2_convert.py",
+    "src/cortex/cli/commands/format.py",
+    "src/cortex/cli/commands/add.py",
+    "src/cortex/cli/commands/v2_canonicalize.py",
+    "src/cortex/cli/commands/move.py",
+    "src/cortex/cli/commands/v2_roundtrip_bidir.py",
+    "src/cortex/cli/commands/v2_compare.py",
+    "src/cortex/cli/commands/render.py",
+    "src/cortex/cli/commands/micro.py",
+    "src/cortex/cli/commands/list.py",
+    "src/cortex/cli/commands/new.py",
+    "src/cortex/cli/commands/glossary.py",
+    "src/cortex/cli/commands/update.py",
+    "src/cortex/cli/commands/doctor.py",
+    "src/cortex/cli/commands/compile.py",
+    "src/cortex/cli/commands/delete.py",
+    "src/cortex/cli/commands/diff.py",
+    "src/cortex/cli/commands/v2_roundtrip.py",
+    "src/tests/test_fixtures.py",
+    "src/tests/test_v1_1_6_fixes.py",
+    "src/tests/test_v2_3_0_acceptance.py",
+    "src/tests/__init__.py",
+    "src/tests/test_audit_gates.py",
+    "src/tests/test_v1_1_2_fixes.py",
+    "src/tests/test_v1_1_7_fixes.py",
+    "src/tests/test_acceptance.py",
+    "src/tests/test_v2_2_3_fixes.py",
+    "src/tests/test_v2_roundtrip.py",
+    "src/tests/test_v1_1_5_fixes.py",
+    "src/tests/test_crud.py",
+    "src/tests/test_v1_1_3_fixes.py",
+    "src/tests/conftest.py",
+    "src/tests/test_v1_1_4_fixes.py",
+    "src/tests/test_v2_2_2_fixes.py",
+    "src/tests/test_v1_1_8_fixes.py",
+    "src/tests/test_v2_1_fixes.py",
+    "src/tests/test_errors.py",
+    "src/tests/test_v2_2_1_fixes.py",
+    "src/tests/test_v1_1_9_fixes.py",
+    "src/tests/test_v2_2_view.py",
+    "src/tests/test_reaudit_gates.py",
+    "src/tests/fixtures/SKILL_v2.cortex.md",
+    "src/tests/fixtures/brain.cortex",
+    "src/tests/fixtures/package.cortex",
+    "src/tests/fixtures/SKILL_v2.hcortex.md",
+    "src/tests/fixtures/skill.cortex",
+    "src/tests/invalid/unknown_sigil.cortex",
+    "src/tests/invalid/unbalanced_braces.cortex",
+    "src/tests/invalid/glossary_not_first.cortex",
+    "src/tests/invalid/missing_glossary.cortex",
+    "skill/hcortex/SKILL.md",
+    "skill/cortex/SKILL.md"
+  ]
+}

codec_cortex-0.3.2.dist-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.2",
+  "distance": 0,
+  "node": "g5c75b370509905a226dc45a9d4ba8a5e4aa83e40",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-01"
+}

codec_cortex-0.3.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+cortex

cortex/__init__.py

@@ -0,0 +1,22 @@
+"""CODEC-CORTEX CLI — modular deterministic processor for .cortex files.
+
+This package implements the CODEC-CORTEX specification: a structural,
+LLM-independent CLI that parses, renders, compiles, verifies and mutates
+.cortex files as canonical cognitive memory artefacts.
+
+The package is organized in layers:
+
+- ``core``      : lexer, parser, AST, writer, validator, compare, errors
+- ``glossary``  : $0 local glossary model, resolver, minimal, contracts
+- ``hcortex``   : HCORTEX-READ and HCORTEX-EDIT renderers and parsers
+- ``crud``      : selectors, mutations, atomic transactions
+- ``templates`` : brain, skill, package, minimal glossary factories
+- ``cli``       : argparse-based command-line entry point
+"""
+
+try:
+    from ._version import __version__
+except ImportError:
+    # Fallback for editable/dev installs without _version.py
+    __version__ = "0.0.0.dev0"
+__all__ = ["__version__"]

cortex/__main__.py

@@ -0,0 +1,7 @@
+"""Allow ``python -m cortex`` to invoke the CLI."""
+
+from .cli.main import main
+import sys
+
+if __name__ == "__main__":
+    sys.exit(main())

cortex/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.3.2'
+__version_tuple__ = version_tuple = (0, 3, 2)
+
+__commit_id__ = commit_id = 'g5c75b3705'

cortex/cli/__init__.py

@@ -0,0 +1,5 @@
+"""CLI package."""
+
+from .main import build_parser, main
+
+__all__ = ["build_parser", "main"]

cortex/cli/commands/__init__.py

@@ -0,0 +1,150 @@
+"""Shared helpers for CLI command modules."""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Dict, Optional
+
+from ...core.ast import CortexDocument
+from ...core.parser import parse_cortex
+from ...core.errors import CortexError
+from ...core.validator import validate
+
+
+def load_doc(path: str) -> CortexDocument:
+    """Read a .cortex file and parse it into a :class:`CortexDocument`."""
+
+    if not os.path.exists(path):
+        raise CortexError("E013_NOT_FOUND", f"file not found: {path}")
+    with open(path, "r", encoding="utf-8") as f:
+        text = f.read()
+    return parse_cortex(text, path=path)
+
+
+def emit(payload: Dict[str, Any], *, json_mode: bool = False) -> None:
+    """Print a payload as JSON or as plain text.
+
+    ``payload`` must contain ``text`` (str) for plain mode and any
+    JSON-serialisable fields for JSON mode.
+    """
+
+    if json_mode:
+        print(json.dumps(payload, indent=2, ensure_ascii=False, default=str))
+    else:
+        text = payload.get("text", "")
+        if text:
+            print(text)
+
+
+def emit_json(payload: Any) -> None:
+    print(json.dumps(payload, indent=2, ensure_ascii=False, default=str))
+
+
+def post_mutation_gate(
+    doc: CortexDocument,
+    args,
+) -> Optional[Dict[str, Any]]:
+    """Validate ``doc`` after a mutation and return an error payload if blocked.
+
+    v1.1.2: centralised post-mutation validation used by ``add``,
+    ``update``, ``delete`` and ``move``.
+
+    v1.1.3 P0-2/P0-3: errors tagged ``bypassable=False`` (secrets in clear
+    text, critical sigils incomplete) CANNOT be overridden by ``--force``.
+    Only an explicit ``--unsafe-allow-secret-forensics`` flag (for secrets)
+    can bypass the secret check, and there is NO bypass for critical-sigil
+    incompleteness.
+
+    Behaviour:
+      - If ``--no-validate-write`` is set, return None (skip gate) — but
+        only if there are no ``bypassable=False`` errors.
+      - Run ``validate(doc, strict=args.strict_write)``.
+      - If there are error-severity diagnostics:
+          * ``bypassable=False`` errors ALWAYS block (unless the dedicated
+            ``--unsafe-allow-secret-forensics`` flag is set, and only for
+            secret-related codes).
+          * Other errors block unless ``--force`` is set.
+      - Otherwise return None (mutation can proceed to atomic_write).
+    """
+
+    if getattr(args, "no_validate_write", False):
+        # Even with --no-validate-write, bypassable=False errors block
+        strict_write = getattr(args, "strict_write", False)
+        diagnostics = validate(doc, strict=strict_write)
+        non_bypassable = [
+            d for d in diagnostics
+            if d.get("severity") == "error" and d.get("bypassable") is False
+        ]
+        if non_bypassable:
+            # Filter: allow --unsafe-allow-secret-forensics for secret codes
+            unsafe = getattr(args, "unsafe_allow_secret_forensics", False)
+            if unsafe:
+                non_bypassable = [
+                    d for d in non_bypassable
+                    if d.get("code") != "E031_SECRET_NOT_BYPASSABLE"
+                ]
+            if non_bypassable:
+                return {
+                    "ok": False,
+                    "error": {
+                        "code": "E015_ATOMIC_WRITE_FAILED",
+                        "message": (
+                            f"mutation would produce {len(non_bypassable)} "
+                            "non-bypassable error(s); --no-validate-write cannot "
+                            "override security/governance rules"
+                        ),
+                    },
+                    "diagnostics": non_bypassable,
+                }
+        return None
+
+    strict_write = getattr(args, "strict_write", False)
+    diagnostics = validate(doc, strict=strict_write)
+    errors = [d for d in diagnostics if d.get("severity") == "error"]
+    if not errors:
+        return None
+
+    # Split bypassable vs non-bypassable
+    non_bypassable = [d for d in errors if d.get("bypassable") is False]
+    bypassable = [d for d in errors if d.get("bypassable") is not False]
+
+    # Non-bypassable errors always block (except secrets with --unsafe flag)
+    if non_bypassable:
+        unsafe = getattr(args, "unsafe_allow_secret_forensics", False)
+        if unsafe:
+            # Allow bypassing secret errors ONLY with the dedicated flag
+            non_bypassable = [
+                d for d in non_bypassable
+                if d.get("code") != "E031_SECRET_NOT_BYPASSABLE"
+            ]
+        if non_bypassable:
+            return {
+                "ok": False,
+                "error": {
+                    "code": "E015_ATOMIC_WRITE_FAILED",
+                    "message": (
+                        f"mutation would produce {len(non_bypassable)} "
+                        "non-bypassable error(s); --force cannot override "
+                        "security/governance rules (use "
+                        "--unsafe-allow-secret-forensics for forensic "
+                        "recovery of secrets, if absolutely necessary)"
+                    ),
+                },
+                "diagnostics": non_bypassable,
+            }
+
+    # Bypassable errors: block unless --force
+    if bypassable and not getattr(args, "force", False):
+        return {
+            "ok": False,
+            "error": {
+                "code": "E015_ATOMIC_WRITE_FAILED",
+                "message": (
+                    f"mutation would produce {len(bypassable)} validation error(s); "
+                    "use --force to persist anyway, or --no-validate-write to skip"
+                ),
+            },
+            "diagnostics": bypassable,
+        }
+    return None