@dforce2055/dai 0.14.0 → 0.15.1

package/.env.dai.example

@@ -27,6 +27,22 @@ DAI_PM=md
 # rama como producción: no adivina cuál es.
 # DAI_BRANCH_PROD=main
 
+# ── Aviso de release a un canal de equipo (opcional) ─────────────────────────
+# Tercer adaptador de dai, con la misma forma que DAI_PM: una variable elige el canal y el
+# canal trae las suyas. Por default no hay aviso: dai no habla hacia afuera sin pedirlo.
+#   discord | slack | webex | telegram | webhook | none
+# `webhook` es el genérico: manda los campos del release en JSON a cualquier endpoint
+# (Teams, Mattermost, un sistema interno) e incluye además el texto ya armado.
+# DAI_NOTIFY=webex
+
+# El endpoint del canal. ⚠️ ES LA CREDENCIAL: quien lo tiene, puede postear. Nunca lo
+# commitees; dai muestra el host, nunca la URL. Probalo con `dai release notify --test`.
+# DAI_NOTIFY_WEBHOOK=
+
+# Solo para telegram: no tiene webhooks de entrada, así que el endpoint es el bot y hace
+# falta decir a qué chat va el mensaje.
+# DAI_NOTIFY_CHAT_ID=
+
 # ── Backend md (local, offline) ──────────────────────────────────────────────
 # Carpeta donde viven las US como <ID>.md (p. ej. ABC-482.md).
 DAI_MD_US_DIR=.dai/us

package/CHANGELOG.md

@@ -3,6 +3,131 @@
 Formato basado en [Keep a Changelog](https://keepachangelog.com/). Versionado semver
 (ver `VERSION`).
 
+## [0.15.1] — 2026-09-10
+
+**Una US puede estar impecable y dai igual no leerla. El molde de trazabilidad pide que la
+metadata viva en una tabla, y cuando la US se escribe a mano en Jira esa tabla es una tabla
+de verdad — que dai no sabía leer. El `spec_version` declarado se perdía en el camino y el
+link quedaba estampado en `pendiente`, con un mensaje que mandaba a agregar una fila que ya
+estaba ahí. Esta versión le enseña a dai a leer y escribir tablas.**
+
+### Corregido
+- **El `spec_version` que la US declaraba y dai no veía.** `adfToMarkdown` no tenía caso
+  para las tablas de Jira Cloud, así que caían al `default` y cada celda terminaba en su
+  propia línea: `spec_version` en una, `v1` en la siguiente. Como el regex que lee la
+  versión no cruza saltos de línea —a propósito, para no capturar un `v2` de veinte líneas
+  más abajo— no encontraba nada, y el link se estampaba en `version: pendiente`. El aviso
+  era el peor de todos: uno que **acusa al usuario** de no haber hecho algo que sí hizo.
+  Ahora una fila de tabla llega como una fila de markdown. El `ac_hash` **no se mueve** —la
+  metadata vive arriba del bloque de criterios—, así que ningún `implements.yaml` ya
+  estampado queda atrasado por este cambio: lo único que cambia es que `pendiente` pasa a
+  ser la versión que la US declara. Es el hermano del #46: aquel era el campo escrito
+  `specversion`, este es el campo escrito en la tabla que el propio molde pide.
+- **La otra mitad del mismo bug: dai tampoco escribía tablas.** `markdownToAdf` mandaba la
+  metadata del molde —y el comentario de cobertura de `dai release stamp`, que también es
+  una tabla— como párrafos con pipes adentro. Ilegibles, y encima invitaban a rehacerlos
+  como tabla de Jira a mano, que es justo lo que del otro lado no se sabía leer. Ahora
+  viajan como nodo `table` y el ida y vuelta de `dai edit-us` no destruye la metadata.
+- **`dai release done` avisaba de un problema inexistente.** Miraba `origin/release/X.Y.Z`,
+  una ref local que sobrevive desactualizada hasta el próximo prune, en vez de preguntarle
+  al remoto. Cuando GitHub ya había borrado la rama al mergear —su comportamiento por
+  default— intentaba borrar algo que no estaba y reportaba un ⚠ sobre un estado que era el
+  correcto. Ahora pregunta con `git ls-remote --heads`, que es autoritativo, limpia la ref
+  fantasma y explica en una línea por qué no hubo nada que borrar. Un aviso falso es caro:
+  enseña a ignorar los avisos.
+
+### Cambiado
+- **`dai release plan --json` expone `counts.stale`, antes `counts.atrasadas`.** Era una
+  clave en español en una salida que lee un script — la única que quedaba — y sigue el
+  glosario que ADR-0008 ya había fijado (*atrasado* → *stale*). Si escribiste algo contra
+  el `--json` de la 0.15.0 (publicada un día antes), es el único nombre que tenés que
+  cambiar.
+
+### Interno
+- **Convención de idioma, ahora escrita.** El repo siempre fue código en inglés y
+  comentarios en español, pero no estaba en ningún lado: al escribir el ciclo de release se
+  rompió sistemáticamente (25% de identificadores en español en lo nuevo, contra ~2%
+  preexistente). Se renombraron 209 identificadores al inglés y la regla quedó como sexta
+  regla de oro en `CONTRIBUTING.md`, con una excepción deliberada: **`autor` se queda**. No
+  es código, es un campo del `implements.yaml` y parte del contrato del método (ADR-0004);
+  renombrarlo sería romper un contrato para ganar consistencia interna.
+- **ADR-0008** documenta el relevamiento que falta para poder ejecutar el i18n.
+- **484 tests** (+9 desde la 0.15.0): las tablas ADF en las dos direcciones —incluido el
+  ida y vuelta markdown → ADF → markdown, que es el que protege la metadata de `dai
+  edit-us`— y la primera cobertura de integración de `dai release done`, que era casi todo
+  efecto y no tenía ninguna: el ciclo completo contra un repo con remoto de verdad, el caso
+  del forge que se adelantó, y las dos negativas a taguear.
+
+## [0.15.0] — 2026-09-09
+
+**Un equipo puede tener el link QUÉ↔CÓMO perfecto y seguir sin poder contestar la pregunta
+que hace el negocio: "¿esto ya está en producción?". La trazabilidad llegaba hasta la PR y
+se cortaba justo ahí. Esta versión agrega el último eslabón — la versión desplegada — y con
+él, el ciclo completo para cortarla, cerrarla y contarla.**
+
+### Agregado
+- **`dai release plan` — el manifiesto de la versión.** Qué User Stories entran entre el
+  último tag y la rama de integración, en qué estado está cada una, y qué entró **sin**
+  declarar US. Resuelve las US leyendo los `implements.yaml` **tal como estaban en cada
+  commit del rango**, no por el nombre de la rama: el link viaja con el código, así que la
+  respuesta sobrevive a que la branch se borre y a que el change se archive — el estado
+  normal del repo cuando llegás a cortar, días después del merge. Es el dato del que
+  dependen los otros cuatro comandos; `--json` es lo que consume la skill.
+- **`dai release cut <X.Y.Z>` — preparar, sin hablar hacia afuera.** Rama de release, número
+  en los archivos que el repo espeja, entrada del CHANGELOG y commit. Ni push, ni tag, ni
+  PR: todo lo que pasa ANTES de la firma humana.
+- **`dai release done <X.Y.Z>` — cerrar, después del merge.** Tag anotado, release note en
+  el forge, back-merge a integración, borrado de la rama de release y aviso al canal. Existe
+  como comando separado porque los dos pasos que más se olvidan cuando la ceremonia se hace
+  a mano viven en esta mitad, la que queda después de la firma. Se llama `done` y no
+  `finish` por lo mismo que `dai done` cierra el trabajo de una branch: mismo verbo, distinto
+  sustantivo.
+- **`dai release stamp <X.Y.Z> --env <ambiente>` — que cada US sepa dónde está.** Deja en
+  cada historia del release un comentario con versión, app, ambiente y fecha, y con eso el
+  funcional lee el ticket en vez de preguntar. Una US federada en varios repos acumula sola
+  su matriz. Es **opcional** y decir que no sale con 0: cuando el comando corre, el tag ya
+  existe y la versión está hecha.
+- **`dai release status`** — dónde estás en el ciclo: versión declarada vs último tag, qué
+  falta promover, si quedó un back-merge pendiente, qué ramas de release sobrevivieron.
+  **`dai release notify --test`** — probar el canal antes de depender de él, porque un
+  webhook no se puede validar sin postear y fingir que sí sería justo lo que dai no hace.
+- **Aviso de release a un canal de equipo** (`DAI_NOTIFY`): discord, slack, webex, telegram
+  o un `webhook` genérico para Teams, Mattermost o un sistema interno. Apagado por default:
+  dai no habla hacia afuera sin que se lo pidan. El endpoint **es la credencial**, así que
+  vive en el `.env.dai` y dai muestra el host, nunca la URL — tampoco en los errores.
+- **Skill `/dai-release`** — conduce el ciclo confirmando paso a paso. No recalcula el
+  manifiesto: lo pide y lo narra. Si su memoria y el CLI se contradicen, gana el CLI.
+- **[Guía de releases](docs/guias/releases.md)** con el *porqué* y
+  **[tutorial del ciclo completo](docs/tutoriales/ciclo-de-release.md)**. Una estrategia de
+  branching que el equipo no entiende se abandona en dos sprints, así que la documentación
+  entra en la misma versión que los comandos, no después.
+
+### Corregido
+- **`dai pr` no podía abrir la PR de una `feature/` en un repo sin User Stories.** Le pasa a
+  cualquier repo de tooling o librería interna que use dai para versionar sin gestionar sus
+  propias historias — a este, sin ir más lejos, donde el mensaje mandaba a renombrar la
+  branch a `chore/`. Lo que distingue un olvido de un repo que no trabaja así es si la
+  branch **nombra un ticket**. El gate de CI no se toca.
+- **Un aviso que aparece siempre no avisa nada.** El manifiesto marcaba cada branch sin US
+  como "entró trabajo sin link", incluso en repos donde ninguna branch va a declarar una
+  jamás. Ahora el hallazgo se reporta solo si el repo trabaja con User Stories — salvo que
+  la branch nombre un ticket, que ahí sí es un olvido.
+- **`dai pr` fallaba al actualizar una PR por un motivo que no era suyo.** `gh pr edit`
+  resuelve por GraphQL y arrastra campos deprecados del servidor, así que devolvía un error
+  sobre *Projects (classic)* cuando lo único que se quería era cambiar el body. Ahora
+  reintenta por REST con la misma autenticación; se intenta callado y solo se reporta si el
+  plan B también falla.
+
+### Interno
+- **475 tests** (+68 desde la 0.14.0): el manifiesto y su resolución por commit, el corte y
+  el cierre, el gate de alcance del estampado y su idempotencia por (app, versión,
+  ambiente), y el adaptador de canal — incluidos tres tests que fallan si el endpoint se
+  filtra en algún mensaje.
+- El adaptador de PM suma `comment(id, markdown)` y `listComments(id)` en los tres backends:
+  sin poder leer sus propios comentarios, dai no puede saber qué ya estampó.
+- Esta versión se cortó con los comandos nuevos, y el dogfooding devolvió tres de las
+  correcciones de arriba.
+
 ## [0.14.0] — 2026-09-08
 
 **`dai pr` proponía mergear a `main` en un repo donde `main` despliega a producción, y el
@@ -918,6 +1043,8 @@ ClickUp y Jira Cloud.
 - Tests de las rutas de red (jira/clickup/forge) con `fetch` mockeado. Sin links rotos;
   `files` de npm sin tests ni secretos.
 
+[0.15.1]: https://github.com/dforce2055/dai/releases/tag/v0.15.1
+[0.15.0]: https://github.com/dforce2055/dai/releases/tag/v0.15.0
 [0.14.0]: https://github.com/dforce2055/dai/releases/tag/v0.14.0
 [0.13.3]: https://github.com/dforce2055/dai/releases/tag/v0.13.3
 [0.13.2]: https://github.com/dforce2055/dai/releases/tag/v0.13.2

package/CONTRIBUTING.md

@@ -41,6 +41,28 @@ git config core.hooksPath .githooks   # valida convención de commits + autoría
    (Cursor, Copilot, Claude, …). Un agente puede ayudarte, pero el cambio lo firmas
    tú: con tu identidad y sin el trailer del agente. Un check de CI lo bloquea en cada
    PR (ver [`governance/human-authorship.md`](governance/human-authorship.md)).
+6. **Código en inglés, comentarios en español.** Los identificadores —variables,
+   funciones, constantes, claves de objeto— van en **inglés**; los comentarios y la
+   documentación, en **español**. Y todo lo que sale por una interfaz de máquina
+   (`--json`, el payload de un webhook, los códigos de estado internos) va en inglés
+   también: es una API, la lee un script, y traducirla después rompe a quien la consume.
+
+   ```js
+   // El endpoint ES la credencial: quien lo tiene, postea.   ← comentario en español
+   export function describeTarget(cfg) {                      ← código en inglés
+     const target = new URL(cfg.endpoint).host;
+   ```
+
+   **La excepción, y es una sola:** los nombres de campo del `implements.yaml` son
+   parte del contrato del método, no del código. `autor:` se llama así en el schema
+   (ADR-0004) y en todos los repos que ya lo usan; renombrarlo sería romper el
+   contrato para ganar consistencia interna, que es el peor cambio posible.
+
+   Lo que **todavía no** cumple esta regla son los **mensajes al usuario**, que hoy son
+   literales en español repartidos por todo el CLI. Eso no es un descuido: es el
+   refactor que [ADR-0008](docs/adr/0008-estrategia-de-i18n.md) tiene planificado como
+   fase 3 (`DAI_LANG` + un catálogo `t(key)` sin dependencias). Mientras tanto, escribí
+   los mensajes en español y **no inventes un mecanismo de traducción propio**.
 
 ## Flujo (la propia metodología)
 

package/README.md

@@ -209,6 +209,7 @@ flowchart TD
 | `dai forge review <ref> --from <review.json>` `[--dry-run\|--yes]` | **review inline**: un resumen + un comentario anclado a cada `archivo:línea`, clasificado low/medium/high. **Valida cada posición contra el diff** (descarta lo que el modelo inventó) antes de postear; sin `--yes` muestra el preview y no postea nada. Modo desatendido: `--min-severity`/`--min-confidence`/`--max-comments`. El review sale con `event: COMMENT`, nunca `APPROVE` ([ADR-0016](docs/adr/0016-review-inline.md)) |
 | `dai forge comment <ref> --body-file <f>` · `dai forge pr <ref>` | comentar / leer una PR/MR (GitHub/GitLab) — el fallback simple, sin anclar |
 | `dai ac-hash <us.md>` | calcula el hash de los criterios de aceptación de una US |
+| `dai release plan` · `cut <X.Y.Z>` · `done <X.Y.Z>` · `stamp <X.Y.Z> --env <amb>` · `status` · `notify --test` | **el ciclo de versión** ([ADR-0019](docs/adr/0019-ciclo-de-version-y-aviso-de-release.md)). `plan` arma el **manifiesto**: qué US entran, cuáles quedaron **atrasadas** y qué se coló **sin US** — más el bump que **propone** (la versión la firma una persona: un cambio de default es minor aunque todo sea `fix:`). `cut` prepara (rama, número, entrada del CHANGELOG con el material para repartir, commit) y **no habla hacia afuera**; `done` cierra tras el merge (tag + release note + back-merge + aviso) — los dos pasos que más se olvidan. `stamp` le avisa a **cada US** en qué versión y ambiente salió: muestra el alcance real, es **idempotente** por (app, versión, ambiente) y **es opcional** (decir que no sale con 0). El tag es la versión; `VERSION`/`package.json` son espejos y puede no haber ninguno. Guía: [releases](docs/guias/releases.md) · Tutorial: [ciclo de release](docs/tutoriales/ciclo-de-release.md) |
 | `dai help [<comando>]` · `dai <comando> --help` | ayuda del CLI. Pedir ayuda **nunca ejecuta el comando**: sale por `stdout` y termina con 0. Valen `--help`, `-h` y `dai <comando> help` — las tres formas, en todos los comandos |
 | `dai doctor` · `dai docs <dest>` · `dai version` | diagnóstico del entorno (incluye **version-drift** del scaffold) · copiar la doc (sin los assets del sitio; los links a las capturas apuntan al sitio publicado) · versión (`dai version` avisa si tu repo quedó atrás) |
 
@@ -243,7 +244,7 @@ flowchart TD
 > en [`skills/`](skills/).
 
 Skills (se invocan en el asistente): `/doc-to-backlog` · `/grill-intent` · `/grill-epic` · `/grill-user-story` · `/link-us` ·
-`/tdd` · `/dai-review`. Config del tracker (`md`\|`jira`\|`clickup`) y tokens: en `.env.dai`
+`/tdd` · `/dai-review` · `/dai-release`. Config del tracker (`md`\|`jira`\|`clickup`) y tokens: en `.env.dai`
 (no versionado; el `.env` del equipo no se toca — [ADR-0017](docs/adr/0017-env-dai.md)) —
 ver [`.env.dai.example`](.env.dai.example). Auth (SSH + tokens): [ADR-0007](docs/adr/0007-modelo-de-autenticacion.md).
 
@@ -279,7 +280,7 @@ mi-repo/
 ├── CLAUDE.md                       · Constitución del proyecto (auto-cargada por Claude)
 ├── .env.dai                        · tu tracker (NO versionado, completa el token) + .env.dai.example (plantilla, sí versionada)
 ├── .claude/skills/                 · Las skills, locales al repo (el equipo las hereda)
-│   └── doc-to-backlog · grill-intent · grill-epic · grill-user-story · link-us · tdd · dai-review
+│   └── doc-to-backlog · grill-intent · grill-epic · grill-user-story · link-us · tdd · dai-review · dai-release
 ├── .github/
 │   ├── copilot-instructions.md     · La constitución, auto-inyectada en cada chat de Copilot
 │   ├── skills/                     · Las mismas skills, en formato Copilot nativo (SKILL.md)

package/VERSION

@@ -1 +1 @@
-0.14.0
+0.15.1