Fase 6 — bucle agéntico: hammer-agent (cliente + translator + orchestrator) y hammer ai

- proto: mover hammerd::proto a hammer-core::proto para que hammerd y hammer-agent
  compartan los tipos del bus sin duplicar.
- hammer-agent (crate nuevo):
  * client: AgentClient síncrono. Handshake hello/welcome; compile/inject/query/init
    bloqueantes con timeout; reader thread interno demultiplexa async events (Modified/
    Crashed) en una cola que el caller drena vía drain_async/next_async.
  * translator: trait IntentTranslator + MockTranslator (HashMap<intent, Swm>) +
    IntentCatalog YAML (swm_inline o swm_path). El traductor LLM real se enchufa
    detrás del mismo trait sin cambios al orquestador.
  * orchestrator: Orchestrator::run(intent) -> Proposal con plan -> schema -> base ->
    try (overlay|prefix) -> apply (config_edit/file_drop con hammer-core::apply,
    source_patch via bus opcional) -> verify (spot-checks) -> propose. Devuelve
    overlay_id (para `hammer commit`) o prefix usado.
- hammer-cli: subcomando `hammer ai <intent> --catalog F [--prefix DIR --base-ref F
  --bus SOCK --state-root DIR]`. Imprime el Proposal y el siguiente paso humano.
- Tests:
  * 10 unit (translator + catalog + orchestrator).
  * 3 e2e del bucle agéntico (intent -> archivos esperados bajo un prefix tmp).
  * 1 e2e del cliente contra un stub bus (handshake + Compile -> BuildReady +
    Modified asíncrono), sin depender de hammerd ni del lab.
- Docs: SDD 08 actualizado con el API del crate; roadmap marca lo cerrado y lo
  pendiente (LLM real, lenguaje de consulta, bucle de auto-reparación con Crashed).

docs/10-roadmap.md

@@ -99,10 +99,32 @@ pre-requisito de validación.
   gating `no_cap`, `Query`, `Modified` fan-out, `Init`→FIFO. Un `Compile` real reusa el
   camino de Fase 0/1 (gated en `HAMMER_NETWORK_TESTS`).
 
-### Fase 6 — Integración de la IA
-- [ ] Cliente de agente; traductor intención NL → `.swm`; bucle plan→build→try→verify→propose.
+### Fase 6 — Integración de la IA  ▶ *en progreso*
+- [x] Crate `hammer-agent` con tres piezas:
+      - `AgentClient`: cliente síncrono del bus (handshake, `compile`/`inject`/`query`/`init`
+        bloqueantes, drenado de eventos asíncronos).
+      - `IntentTranslator` (trait) + `MockTranslator` cargado desde un `IntentCatalog` YAML
+        (intent → `.swm` pre-armado). La integración con un LLM real se enchufa detrás del
+        mismo trait sin tocar el bucle.
+      - `Orchestrator` con `run(intent) → Proposal`: plan → schema → base → try (overlay
+        o prefix) → apply (mutaciones puras + source_patch vía bus opcional) → verify →
+        propose.
+- [x] CLI: `hammer ai <intent> --catalog F [--prefix DIR --base-ref F --bus SOCK]`.
+- [x] Tipos del protocolo del bus movidos a `hammer-core::proto` para que `hammerd` y
+      `hammer-agent` los compartan.
+- [x] Tests:
+      - 10 unit en `hammer-agent` (translator + catalog + orchestrator).
+      - 3 e2e del bucle agéntico (prefix tmp → archivos esperados en disco).
+      - 1 e2e del cliente contra un *stub* del bus (handshake + Compile→BuildReady + Modified
+        asíncrono).
+- [ ] Traductor LLM real (Claude API u otro), opcional vía feature flag o crate aparte.
+- [ ] Lenguaje de consulta del sistema (SDD 08 §6) para que la IA refiera servicios y
+      archivos sin rutas frágiles.
+- [ ] Bucle de auto-reparación (cliente reacciona a `Crashed` con un nuevo plan).
 - **Hecho cuando:** una intención en lenguaje natural produce un cambio probado en overlay,
-  presentado para `commit` humano.
+  presentado para `commit` humano. ✅ Demostrado por `hammer ai` con `MockTranslator`:
+  intent → `.swm` → mutaciones aplicadas → `Proposal` con `overlay_id` + checks. El humano
+  decide `commit`/`discard`. El upgrade a LLM real reusa todo el bucle.
 
 ---