horcon 0.8.2a1__tar.gz

horcon-0.8.2a1/.gitignore

@@ -0,0 +1,20 @@
+# Generado con asistencia de IA (Claude Code, 2026-09-17); revisado por: pendiente
+.env
+.env.*
+!.env.ejemplo
+tmp/runs/
+tmp/site-src/
+tmp/site/
+tmp/local-dist/
+tmp/local-venv/
+tmp/horcon-local-integration-*/
+tmp/keyring-*/
+tmp/kill-switch/
+tmp/KILL
+__pycache__/
+*.pyc
+.pytest_cache/
+dist/
+*.egg-info/
+.venv/
+src/horcon/_templates/

horcon-0.8.2a1/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Kasai Labs
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

horcon-0.8.2a1/NOTICE

@@ -0,0 +1,20 @@
+Horcón
+Copyright 2026 Kasai Labs
+
+This product includes software developed at Kasai Labs
+(https://codeberg.org/kasailabs).
+
+"Horcón" es un nombre en verificación de marca (DEC-06, ver
+`governance/expedientes/rec-a1db170841cf48eb/DOSSIER.md` §5, §6 y
+`governance/decisions/ADR-001-alcance-y-sustitucion-de-aula.md`). Esta
+verificación no está resuelta: ninguna búsqueda de anterioridades en IMPI,
+EUIPO o USPTO se ha ejecutado. No usar "Horcón" en publicidad de terceros
+hasta que DEC-06 se cierre con receipt humano.
+
+El inventario de componentes de terceros (imágenes de contenedor, paquetes
+Python de los extras `agents`/`memory`/`observability`, y sus licencias) está
+pendiente. `asilo-core` y `milpa-sdk` declaran Apache-2.0 en su propio README;
+Horcón los referencia como dependencias opcionales (extras), nunca los
+redistribuye como código propio. Este NOTICE se actualiza cuando exista
+`docs/legal/DEPENDENCIES-LICENSES.md` generado desde un SBOM (DEC-23, Q-08 del
+expediente).

horcon-0.8.2a1/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.5
+Name: horcon
+Version: 0.8.2a1
+Summary: Horcón: framework que genera y valida sistemas multiagente deterministas. Perfil MILPA: library.
+Project-URL: Homepage, https://codeberg.org/kasailabs/horcon
+Project-URL: Documentation, https://codeberg.org/kasailabs/horcon/src/branch/main/docs/INDEX.md
+Project-URL: Repository, https://codeberg.org/kasailabs/horcon
+Project-URL: Changelog, https://codeberg.org/kasailabs/horcon/src/branch/main/CHANGELOG.md
+Project-URL: Issues, https://codeberg.org/kasailabs/horcon/issues
+Author: Kasai Labs
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: agent-system,governance,human-in-the-loop,multi-agent,policy-engine,scaffold
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: cryptography>=42.0
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: api
+Requires-Dist: fastapi<1,>=0.115; extra == 'api'
+Requires-Dist: httpx>=0.27; extra == 'api'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'api'
+Provides-Extra: asilo
+Requires-Dist: asilo-core<0.2,>=0.1.0a1; extra == 'asilo'
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material==9.7.7; extra == 'docs'
+Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
+Provides-Extra: milpa
+Requires-Dist: milpa-sdk<0.2,>=0.1.0a1; extra == 'milpa'
+Provides-Extra: runtime
+Requires-Dist: httpx>=0.27; extra == 'runtime'
+Description-Content-Type: text/markdown
+
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-22); revisado por: pendiente -->
+# Horcón
+
+**Un modelo de lenguaje no debe decidir solo sobre las cosas que importan. Horcón monta, alrededor
+de él, un despacho con reglas fijas y una persona que firma antes de que algo salga.**
+
+## La analogía
+
+Piensa en un despacho de traducción. Un traductor junior propone una versión; un traductor senior
+la revisa; una recepcionista con una lista fija de reglas ("¿el cliente pagó?", "¿el documento
+está completo?") decide si pasa al siguiente paso; y si el documento es un contrato importante,
+alguien con firma lo revisa antes de entregarlo. Nadie espera que el traductor junior sea infalible
+— el despacho está diseñado para que un error suyo no llegue solo al cliente.
+
+Horcón es ese despacho, hecho de código: el traductor junior es un **especialista** (un modelo de
+lenguaje con una ficha que dice qué puede y qué no puede hacer), la recepcionista es la **aduana**
+(reglas deterministas, no otro modelo opinando), y la firma final es una **persona identificable**,
+nunca automática cuando el riesgo es alto.
+
+## Para quién es
+
+- **Si no programas:** una consola con pantallas y botones (proyectos → equipo → encargos). No
+  necesitas escribir un comando. Empieza en [Parte 0 · Empieza aquí](docs/00-inicio-rapido/README.md).
+- **Si programas poco:** una terminal con comandos que se copian y pegan, y archivos de texto que
+  se leen sin herramientas especiales. Sigue por [Parte III · Hacer](docs/03-operacion/README.md).
+- **Si vas a auditar:** cada decisión queda en un expediente con firmas encadenadas
+  (`receipts.jsonl`) y cada regla tiene su contrato técnico y su prueba. Empieza en
+  [Parte IV · Referencia](docs/04-contratos/README.md).
+
+## Instalación
+
+Requiere Python 3.11 o mayor. Horcón todavía no está publicado en PyPI (ver "Estado de madurez"
+abajo); mientras tanto, se instala desde el propio repositorio:
+
+```bash
+git clone https://codeberg.org/kasailabs/horcon.git
+cd horcon
+python3 -m venv .venv
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m horcon doctor
+```
+
+### Integración local de ASILO y MILPA
+
+Antes de publicar cualquiera de los tres paquetes, puedes construir los artefactos locales e
+instalarlos en una venv limpia con la prueba de aceptación incluida:
+
+```bash
+scripts/instalar-local.sh --recreate
+```
+
+El instalador construye wheel y sdist de `asilo-core`, `milpa-sdk` y `horcon`; instala los tres
+wheels desde `horcon/tmp/local-dist` con `--no-index`; resuelve únicamente dependencias de
+terceros; y ejecuta `init`, `validate`, `agent add`, `doctor`, el loader real de MILPA y
+`asilo.enforce_schema` sobre un proyecto generado. La venv queda en `horcon/tmp/local-venv` y el
+proyecto de integración se conserva en `horcon/tmp/horcon-local-integration-*` si hay un error. No llama
+a PyPI para los paquetes del ecosistema ni publica nada. En Windows usa
+`scripts/instalar-local.ps1 --recreate`.
+
+The canonical installer options are `--recreate` and `--skip-acceptance`; the previous Spanish
+spellings remain accepted as hidden compatibility aliases.
+
+For simultaneous development of all three repositories, use `--editable --recreate`. This creates
+`horcon/tmp/editable-venv` and installs `asilo-core`, `milpa-sdk`, and `horcon` with `pip install -e`:
+
+```bash
+scripts/instalar-local.sh --editable --recreate
+```
+
+Changes made in any of the three source repositories are then used immediately by that venv. Use
+the default command without `--editable` before publishing to verify the packaged artifacts.
+
+El comando falla a propósito si MILPA no puede leer el manifest generado: ese resultado es un
+bloqueo de compatibilidad que hay que resolver antes de publicar, no una razón para continuar con
+`--skip-acceptance`. Esta última opción sólo sirve para inspeccionar los artefactos y la instalación
+cuando se está trabajando en ese bloqueo.
+
+## Un ejemplo mínimo, ejecutado de verdad
+
+Esta es la salida real de dos comandos, copiada de una corrida el 22 de septiembre de 2026 contra
+la versión 0.8.0 (sin editar, salvo acortar la ruta a `mi-proyecto`):
+
+```text
+$ horcon init mi-proyecto --project-name mi-proyecto --toca-salud no --toca-crisis no --toca-menores no
+init escrito: mi-proyecto (perfil P2, 63 archivos)
+template_digest=328fb598287d2f935b2fc549ce10a0f19dea6b19e87599ca16b8b4075515ca10
+generation-receipt.json=mi-proyecto/generation-receipt.json
+validación estructural: no es evidencia de comportamiento
+
+$ horcon doctor
+milpa: implementado
+asilo: stub
+docker: implementado
+python: 3.14.5
+proveedor de modelos: no configurado (HORCON_MODEL_BASE_URL no, HORCON_MODEL_API_KEY ausente, HORCON_MODEL_NAME no)
+{"python": "3.14.5", "milpa": "implementado", "asilo": "stub", "docker": "implementado", "proveedor": "no configurado"}
+```
+
+Las tres preguntas `--toca-salud/--toca-crisis/--toca-menores` son obligatorias: `init` se niega
+antes de escribir nada si falta alguna (decisión H-1 del fundador, `DECISIONES-CERRADAS.md`). La
+última línea de `init` se imprime siempre: que la estructura generada esté bien no dice nada de
+cómo se comporta un especialista dentro de ella.
+
+El tutorial completo — crear dos especialistas, darlos de alta con firma, pedir un encargo, pasarlo
+por la aduana y cerrarlo — está en
+[`docs/00-inicio-rapido/03-tu-primer-proyecto.md`](docs/00-inicio-rapido/03-tu-primer-proyecto.md):
+quince minutos, reejecutado de verdad el 22 de septiembre de 2026, con la salida real de cada paso.
+
+## Qué hace hoy
+
+- Genera un proyecto multiagente completo (`horcon init`) a partir de una plantilla versionada,
+  con manifiestos, políticas, máquina de estados y expediente de gobernanza.
+- Da de alta especialistas con firma (`agent register`), corre encargos en **simulación**
+  determinista sin red (`run --provider fake`), y también contra un proveedor de modelos real bajo
+  interfaz compatible con OpenAI (`run --provider openai_compatible`, con dos consentimientos
+  explícitos y tope de gasto).
+- Hace pasar cada propuesta por una aduana de doce políticas con reglas fijas (`gate`), nunca por
+  otro modelo opinando.
+- Firma decisiones con Ed25519 en una cadena de hashes append-only (`receipt`, `adr sign`), con una
+  escalera de custodia de la llave (`keys init --custody`) de nivel gratis (archivo sin cifrar)
+  hasta nivel que aísla al asistente de código de la llave (usuario aparte del sistema).
+- Trae un botón de paro con receipt firmado (`kill`/`resume`), un contador de gasto encadenado
+  (`charge`), una consola web para quien no programa, y un exportador de trazas a OTLP/HTTP sin
+  datos personales.
+
+## Qué NO hace hoy
+
+La lista completa, honesta y con lo que falta por decisión pendiente está en
+[`docs/03-operacion/10-que-no-esta-implementado.md`](docs/03-operacion/10-que-no-esta-implementado.md).
+En resumen:
+
+- **Ninguna corrida con un proveedor de modelos real está registrada todavía** en este repositorio;
+  todo lo verificado en la suite de pruebas usa `--provider fake`.
+- **No limpia datos personales.** Los detecta con tres expresiones regulares (correo, CURP,
+  teléfono) y los manda a revisión humana; no los redacta ni los borra.
+- **No orquesta con CrewAI ni LangGraph.** Hay un adaptador de CrewAI que construye Agentes y
+  Tareas, pero nunca llama `kickoff()`; el orquestador de equipo (`team run`) es código propio,
+  no un framework de terceros envuelto.
+- **No es una frontera de seguridad completa.** Qué protege la aduana, qué protege el padrón, qué
+  protege la custodia de la llave, y qué no protege ninguna de las tres, está explicado en llano en
+  [`docs/04-contratos/11-fronteras-de-confianza.md`](docs/04-contratos/11-fronteras-de-confianza.md).
+- **No declara conformidad con ningún estándar** ni se llama a sí mismo "seguro" o "certificado":
+  ver [`docs/01-manifiesto/03-que-no-hace.md`](docs/01-manifiesto/03-que-no-hace.md).
+
+## Estado de madurez
+
+Versión 0.8.0. **Integrado en local y operable en simulación** (proveedor `fake`): 480 pruebas
+en verde, `validate`, `audit-docs` y `docs build` limpios, cadena completa de comandos ejercitada a
+mano. **Ninguna corrida con un proveedor de modelos real está registrada** en este repositorio;
+nada aquí afirma que el sistema cumpla un estándar, sea seguro o esté certificado. Detalle completo
+por versión en [`CHANGELOG.md`](CHANGELOG.md).
+
+## Licencia
+
+Apache License 2.0 ([`LICENSE`](LICENSE)). "Horcón" es un nombre en verificación de marca, sin
+búsqueda de anterioridades resuelta todavía ([`NOTICE`](NOTICE)).
+
+## Enlaces
+
+| Qué | Dónde |
+|---|---|
+| Documentación (el libro completo) | [`docs/INDEX.md`](docs/INDEX.md) |
+| Código fuente | https://codeberg.org/kasailabs/horcon |
+| Registro de cambios | [`CHANGELOG.md`](CHANGELOG.md) |
+| Incidencias | https://codeberg.org/kasailabs/horcon/issues |
+| Contrato para agentes de código | [`AGENTS.md`](AGENTS.md) |
+| Gobernanza y decisiones firmadas (ADR) | [`governance/README.md`](governance/README.md) |
+
+Perfil MILPA `library` ([`.milpa-manifest.json`](.milpa-manifest.json)).

horcon-0.8.2a1/README.md

@@ -0,0 +1,169 @@
+<!-- Generado con asistencia de IA (Claude Code, 2026-09-22); revisado por: pendiente -->
+# Horcón
+
+**Un modelo de lenguaje no debe decidir solo sobre las cosas que importan. Horcón monta, alrededor
+de él, un despacho con reglas fijas y una persona que firma antes de que algo salga.**
+
+## La analogía
+
+Piensa en un despacho de traducción. Un traductor junior propone una versión; un traductor senior
+la revisa; una recepcionista con una lista fija de reglas ("¿el cliente pagó?", "¿el documento
+está completo?") decide si pasa al siguiente paso; y si el documento es un contrato importante,
+alguien con firma lo revisa antes de entregarlo. Nadie espera que el traductor junior sea infalible
+— el despacho está diseñado para que un error suyo no llegue solo al cliente.
+
+Horcón es ese despacho, hecho de código: el traductor junior es un **especialista** (un modelo de
+lenguaje con una ficha que dice qué puede y qué no puede hacer), la recepcionista es la **aduana**
+(reglas deterministas, no otro modelo opinando), y la firma final es una **persona identificable**,
+nunca automática cuando el riesgo es alto.
+
+## Para quién es
+
+- **Si no programas:** una consola con pantallas y botones (proyectos → equipo → encargos). No
+  necesitas escribir un comando. Empieza en [Parte 0 · Empieza aquí](docs/00-inicio-rapido/README.md).
+- **Si programas poco:** una terminal con comandos que se copian y pegan, y archivos de texto que
+  se leen sin herramientas especiales. Sigue por [Parte III · Hacer](docs/03-operacion/README.md).
+- **Si vas a auditar:** cada decisión queda en un expediente con firmas encadenadas
+  (`receipts.jsonl`) y cada regla tiene su contrato técnico y su prueba. Empieza en
+  [Parte IV · Referencia](docs/04-contratos/README.md).
+
+## Instalación
+
+Requiere Python 3.11 o mayor. Horcón todavía no está publicado en PyPI (ver "Estado de madurez"
+abajo); mientras tanto, se instala desde el propio repositorio:
+
+```bash
+git clone https://codeberg.org/kasailabs/horcon.git
+cd horcon
+python3 -m venv .venv
+.venv/bin/python -m pip install -e .
+.venv/bin/python -m horcon doctor
+```
+
+### Integración local de ASILO y MILPA
+
+Antes de publicar cualquiera de los tres paquetes, puedes construir los artefactos locales e
+instalarlos en una venv limpia con la prueba de aceptación incluida:
+
+```bash
+scripts/instalar-local.sh --recreate
+```
+
+El instalador construye wheel y sdist de `asilo-core`, `milpa-sdk` y `horcon`; instala los tres
+wheels desde `horcon/tmp/local-dist` con `--no-index`; resuelve únicamente dependencias de
+terceros; y ejecuta `init`, `validate`, `agent add`, `doctor`, el loader real de MILPA y
+`asilo.enforce_schema` sobre un proyecto generado. La venv queda en `horcon/tmp/local-venv` y el
+proyecto de integración se conserva en `horcon/tmp/horcon-local-integration-*` si hay un error. No llama
+a PyPI para los paquetes del ecosistema ni publica nada. En Windows usa
+`scripts/instalar-local.ps1 --recreate`.
+
+The canonical installer options are `--recreate` and `--skip-acceptance`; the previous Spanish
+spellings remain accepted as hidden compatibility aliases.
+
+For simultaneous development of all three repositories, use `--editable --recreate`. This creates
+`horcon/tmp/editable-venv` and installs `asilo-core`, `milpa-sdk`, and `horcon` with `pip install -e`:
+
+```bash
+scripts/instalar-local.sh --editable --recreate
+```
+
+Changes made in any of the three source repositories are then used immediately by that venv. Use
+the default command without `--editable` before publishing to verify the packaged artifacts.
+
+El comando falla a propósito si MILPA no puede leer el manifest generado: ese resultado es un
+bloqueo de compatibilidad que hay que resolver antes de publicar, no una razón para continuar con
+`--skip-acceptance`. Esta última opción sólo sirve para inspeccionar los artefactos y la instalación
+cuando se está trabajando en ese bloqueo.
+
+## Un ejemplo mínimo, ejecutado de verdad
+
+Esta es la salida real de dos comandos, copiada de una corrida el 22 de septiembre de 2026 contra
+la versión 0.8.0 (sin editar, salvo acortar la ruta a `mi-proyecto`):
+
+```text
+$ horcon init mi-proyecto --project-name mi-proyecto --toca-salud no --toca-crisis no --toca-menores no
+init escrito: mi-proyecto (perfil P2, 63 archivos)
+template_digest=328fb598287d2f935b2fc549ce10a0f19dea6b19e87599ca16b8b4075515ca10
+generation-receipt.json=mi-proyecto/generation-receipt.json
+validación estructural: no es evidencia de comportamiento
+
+$ horcon doctor
+milpa: implementado
+asilo: stub
+docker: implementado
+python: 3.14.5
+proveedor de modelos: no configurado (HORCON_MODEL_BASE_URL no, HORCON_MODEL_API_KEY ausente, HORCON_MODEL_NAME no)
+{"python": "3.14.5", "milpa": "implementado", "asilo": "stub", "docker": "implementado", "proveedor": "no configurado"}
+```
+
+Las tres preguntas `--toca-salud/--toca-crisis/--toca-menores` son obligatorias: `init` se niega
+antes de escribir nada si falta alguna (decisión H-1 del fundador, `DECISIONES-CERRADAS.md`). La
+última línea de `init` se imprime siempre: que la estructura generada esté bien no dice nada de
+cómo se comporta un especialista dentro de ella.
+
+El tutorial completo — crear dos especialistas, darlos de alta con firma, pedir un encargo, pasarlo
+por la aduana y cerrarlo — está en
+[`docs/00-inicio-rapido/03-tu-primer-proyecto.md`](docs/00-inicio-rapido/03-tu-primer-proyecto.md):
+quince minutos, reejecutado de verdad el 22 de septiembre de 2026, con la salida real de cada paso.
+
+## Qué hace hoy
+
+- Genera un proyecto multiagente completo (`horcon init`) a partir de una plantilla versionada,
+  con manifiestos, políticas, máquina de estados y expediente de gobernanza.
+- Da de alta especialistas con firma (`agent register`), corre encargos en **simulación**
+  determinista sin red (`run --provider fake`), y también contra un proveedor de modelos real bajo
+  interfaz compatible con OpenAI (`run --provider openai_compatible`, con dos consentimientos
+  explícitos y tope de gasto).
+- Hace pasar cada propuesta por una aduana de doce políticas con reglas fijas (`gate`), nunca por
+  otro modelo opinando.
+- Firma decisiones con Ed25519 en una cadena de hashes append-only (`receipt`, `adr sign`), con una
+  escalera de custodia de la llave (`keys init --custody`) de nivel gratis (archivo sin cifrar)
+  hasta nivel que aísla al asistente de código de la llave (usuario aparte del sistema).
+- Trae un botón de paro con receipt firmado (`kill`/`resume`), un contador de gasto encadenado
+  (`charge`), una consola web para quien no programa, y un exportador de trazas a OTLP/HTTP sin
+  datos personales.
+
+## Qué NO hace hoy
+
+La lista completa, honesta y con lo que falta por decisión pendiente está en
+[`docs/03-operacion/10-que-no-esta-implementado.md`](docs/03-operacion/10-que-no-esta-implementado.md).
+En resumen:
+
+- **Ninguna corrida con un proveedor de modelos real está registrada todavía** en este repositorio;
+  todo lo verificado en la suite de pruebas usa `--provider fake`.
+- **No limpia datos personales.** Los detecta con tres expresiones regulares (correo, CURP,
+  teléfono) y los manda a revisión humana; no los redacta ni los borra.
+- **No orquesta con CrewAI ni LangGraph.** Hay un adaptador de CrewAI que construye Agentes y
+  Tareas, pero nunca llama `kickoff()`; el orquestador de equipo (`team run`) es código propio,
+  no un framework de terceros envuelto.
+- **No es una frontera de seguridad completa.** Qué protege la aduana, qué protege el padrón, qué
+  protege la custodia de la llave, y qué no protege ninguna de las tres, está explicado en llano en
+  [`docs/04-contratos/11-fronteras-de-confianza.md`](docs/04-contratos/11-fronteras-de-confianza.md).
+- **No declara conformidad con ningún estándar** ni se llama a sí mismo "seguro" o "certificado":
+  ver [`docs/01-manifiesto/03-que-no-hace.md`](docs/01-manifiesto/03-que-no-hace.md).
+
+## Estado de madurez
+
+Versión 0.8.0. **Integrado en local y operable en simulación** (proveedor `fake`): 480 pruebas
+en verde, `validate`, `audit-docs` y `docs build` limpios, cadena completa de comandos ejercitada a
+mano. **Ninguna corrida con un proveedor de modelos real está registrada** en este repositorio;
+nada aquí afirma que el sistema cumpla un estándar, sea seguro o esté certificado. Detalle completo
+por versión en [`CHANGELOG.md`](CHANGELOG.md).
+
+## Licencia
+
+Apache License 2.0 ([`LICENSE`](LICENSE)). "Horcón" es un nombre en verificación de marca, sin
+búsqueda de anterioridades resuelta todavía ([`NOTICE`](NOTICE)).
+
+## Enlaces
+
+| Qué | Dónde |
+|---|---|
+| Documentación (el libro completo) | [`docs/INDEX.md`](docs/INDEX.md) |
+| Código fuente | https://codeberg.org/kasailabs/horcon |
+| Registro de cambios | [`CHANGELOG.md`](CHANGELOG.md) |
+| Incidencias | https://codeberg.org/kasailabs/horcon/issues |
+| Contrato para agentes de código | [`AGENTS.md`](AGENTS.md) |
+| Gobernanza y decisiones firmadas (ADR) | [`governance/README.md`](governance/README.md) |
+
+Perfil MILPA `library` ([`.milpa-manifest.json`](.milpa-manifest.json)).