@dforce2055/dai 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -3,6 +3,74 @@
 Formato basado en [Keep a Changelog](https://keepachangelog.com/). Versionado semver
 (ver `VERSION`).
 
+## [0.8.1] — 2026-07-16
+
+**Primera prueba real en Windows con analistas y devs de una empresa: el ciclo completo
+contra un Jira corporativo anduvo, y de paso destapó lo que faltaba pulir para que un
+equipo Windows + Copilot + GitLab no se topara con muros.**
+
+### Arreglado
+- **`dai sync` crasheaba en repos Copilot** con `ReferenceError: skillToPrompt is not
+  defined`. El pase a Agent Skills nativas (0.8.0, [ADR-0014](docs/adr/0014-copilot-agent-skills.md))
+  borró `skillToPrompt` y migró `dai init` a `.github/skills/`, pero dejó dos llamadas
+  colgadas en el path viejo `.github/prompts/`: `dai sync` y `dai skills install --from`
+  (rama Copilot). Ahora ambos copian la skill nativa (`.github/skills/<name>`, con
+  `templates/`) igual que `init`, y `sync` **migra** el repo: limpia los `.prompt.md`
+  viejos de dai. `dai sync` también detecta Copilot por `.github/skills` (antes solo por
+  `.github/prompts`, así que ni veía los repos nuevos). Cubierto por un test de
+  integración de `dai sync --for copilot` — el hueco que dejó pasar la regresión.
+- **`dai upgrade` (y `dai init --openspec`) fallaban en Windows** con un genérico *"no
+  pude consultar el registry (¿sin red?)"* aunque npm anduviera perfecto. En Windows `npm`
+  y `openspec` son shims `.cmd`, y desde Node 18.20 / 20.12 / 21.7 (fix de CVE-2024-27980)
+  `execFileSync` **se niega a lanzar un `.cmd` sin `shell:true`** — tira `EINVAL`, que dai
+  confundía con falta de red. Ahora esos binarios se corren con `shell` en Windows.
+- **`dai pr` fallaba el push la primera vez contra un remoto HTTPS corporativo.** El push
+  corría con stdin ignorado, así que Git Credential Manager no podía pedir la credencial y
+  el push moría en seco — mientras el error real de git quedaba oculto tras un genérico
+  *"Command failed"*. Ahora el push hereda stdin (con `GIT_TERMINAL_PROMPT=1`) para que el
+  login se pueda completar, **muestra el stderr real de git**, y si aún falla sugiere
+  pushear a mano una vez para cachear la credencial.
+
+### Agregado
+- **`dai mr` como alias de `dai pr`.** En un shop de GitLab uno tipea "mr" (merge request);
+  ahora funciona. Es el mismo comando (detecta el forge y usa `gh`/`glab`), solo más natural.
+
+### Cambiado
+- **El diagnóstico de un 400 de `dai publish` ahora coincide con lo que Jira dijo.** Antes
+  mandaba SIEMPRE a declarar un campo propio (`customfield_NNNNN` en `.dai/jira-fields.json`),
+  aunque el 400 fuera *"Por favor indicar épica…"* — confuso, porque el fix real es
+  `--parent`. Ahora la ayuda se elige según el cuerpo del error: regla de épica padre →
+  `--parent`, campo obligatorio → `jira-fields.json`, genérico → nombra las dos causas sin
+  empujar una sola.
+- **`dai pr` explica por qué no pudo crear la PR/MR** en vez de un *"¿instalado y
+  autenticado?"*. Si `gh`/`glab` no está instalado (`ENOENT`) lo dice y enlaza la
+  instalación + `… auth login` (con `--hostname` para GitLab self-hosted); si falla por
+  otra cosa, **imprime el stderr real del forge** (auth vencida, host sin configurar, flag
+  desconocido). Era el caso ciego del equipo con GitLab corporativo.
+- **El diagnóstico de TLS ofrece primero el camino más simple**: `NODE_OPTIONS=--use-system-ca`
+  (Node ≥ 22.15), que usa el trust store del sistema donde el navegador ya confía en la CA
+  de la empresa — validado contra el proxy real. `NODE_EXTRA_CA_CERTS` queda como
+  alternativa para cualquier versión de Node. (Sigue prohibido `NODE_TLS_REJECT_UNAUTHORIZED=0`.)
+
+### Docs
+- **El prerequisito de `dai pr`: `gh`/`glab` instalado y autenticado.** Un callout en la
+  sección del dev con el setup one-time del CLI del forge (`gh auth login` /
+  `glab auth login --hostname <tu-gitlab>`, con la nota del PATH en Windows tras instalar con
+  winget). Era el paso que faltaba documentar — sin el CLI, `dai pr` pushea igual y avisa.
+- **README consistente con Copilot nativo.** La tabla de superficies ya decía que Copilot
+  carga skills en app / CLI / IDE / cloud (solo el chat de github.com queda afuera), pero el
+  resto del README seguía en el modelo viejo: la tabla de `--for`, el árbol del repo y el
+  snippet de `dai skills install` hablaban de `.github/prompts/*.prompt.md` y de que "Copilot
+  no tiene skills instalables". Corregido a `.github/skills/` nativo — validado con un dev
+  corriendo dai en la app de GitHub Copilot desktop.
+
+### Interno
+- **161 tests** (+3): integración de `dai sync --for copilot` (regresión + migración del
+  layout viejo).
+- **Conocido, sin arreglar:** en Windows, tras un `dai publish` con red, puede aparecer al
+  salir `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING), src\win\async.c` — un
+  crash de *teardown* de libuv, posterior a toda la salida útil (cosmético). Se investiga.
+
 ## [0.8.0] — 2026-07-15
 
 **El primer analista funcional real usó dai contra un Jira corporativo, y encontró el

package/README.md

@@ -49,7 +49,7 @@ deja las skills disponibles:
 
 ```bash
 npm i -g @dforce2055/dai        # el CLI
-dai skills install              # skills de IA → Claude y Cursor (global por defecto)
+dai skills install              # skills de IA → Claude, Copilot y Cursor (global por defecto)
 ```
 
 Y después, en el chat del asistente, según lo que tengas:
@@ -66,6 +66,20 @@ Y después, en el chat del asistente, según lo que tengas:
 > (`DAI_PM` en el `.env`): por el **MCP** de Jira/ClickUp si está conectado, o con
 > **`dai publish <us.md>`** si no (crea el issue vía token). Tú respondes y decides.
 
+¿Sin MCP, o querés publicar a mano? `dai publish` sube el `.md` al tracker y te devuelve el key:
+
+```bash
+dai publish historia.md                                # crea la US → devuelve el key
+dai publish historia.md --parent PROJ-42               # colgándola de su épica
+dai publish historia.md --field clasificacion=Mejora   # con un campo propio que tu Jira exige
+dai publish epica.md    --issuetype Epic               # publicar una épica (no una US)
+```
+
+> **Jira corporativo:** si tu proyecto exige campos propios (`customfield_…`), declaralos una
+> vez en `.dai/jira-fields.json` (molde en `.dai/templates/`) y pasalos con `--field`. Si una
+> historia tiene que colgar de una épica, `--parent PROJ-42`. dai valida antes de la red y, si
+> Jira igual rechaza, el error te dice **qué** falta ([ADR-0015](docs/adr/0015-jira-corporativo.md)).
+
 ### 🔵 Como dev — tengo una US y voy a implementarla
 
 Una vez, preparas el repo:
@@ -98,6 +112,17 @@ dai pr --assignee <compañero>   # crea la PR precargada y se la asigna a un com
 dai stamp                       # al mergear: estampa la cobertura en el tracker
 ```
 
+> **Para que `dai pr` cree la PR/MR** necesitás el CLI del forge instalado y autenticado, una
+> sola vez por máquina:
+> - **GitHub** → [`gh`](https://cli.github.com) · `gh auth login`
+> - **GitLab** → [`glab`](https://gitlab.com/gitlab-org/cli) · `glab auth login --hostname <tu-gitlab>`
+>   — en un GitLab self-hosted/corporativo el `--hostname` es **obligatorio**, y el token va con
+>   scope `api`. (En Windows, tras instalar `glab` con `winget`, abrí una terminal nueva para que
+>   tome el PATH.)
+>
+> Sin el CLI del forge, `dai pr` **igual pushea tu branch** y te dice qué instalar — después
+> creás la PR/MR a mano desde la web. dai nunca te deja a medias sin decir por qué.
+
 ## Cómo usarlo — el flujo, paso a paso
 
 Guía completa con salidas reales en [`docs/PROBAR.md`](docs/PROBAR.md); un caso narrado en
@@ -157,16 +182,16 @@ flowchart TD
 | Comando | Qué hace |
 |---|---|
 | `dai init [<repo>]` | scaffolder interactivo del repo. Flags: `--for claude\|copilot\|both\|cursor\|all` (asistente, default `all`) · `--pm md\|jira\|clickup` (tracker) · `--openspec` |
-| `dai skills install [--global \| --local <repo>] [--force] [--dry-run] [--for claude\|cursor\|all]` | instala/actualiza las skills de dai en Claude y/o Cursor (`--for all` por defecto). `--force` re-copia. Alias: **`dai install`**. Ej: `dai skills install --local . --for cursor --force` |
+| `dai skills install [--global \| --local <repo>] [--force] [--dry-run] [--for claude\|copilot\|cursor\|all]` | instala/actualiza las skills de dai en Claude, Copilot y/o Cursor (`--for all` por defecto; Copilot global → `~/.copilot/skills`, local → `.github/skills/`). `--force` re-copia. Alias: **`dai install`**. Ej: `dai skills install --local . --for cursor --force` |
 | `dai skills install --from <git-url\|path>[#ref] [--for …]` | instala **skills externas** (por-stack: .NET, Java, …) desde un repo/dir, **convertidas para los 3 asistentes**. Self-service, one-off, sin registro; `dai sync` no las toca. Colisión con una skill de dai → salta ([ADR-0013](docs/adr/0013-skills-externas-install-from.md)). Ej: `dai skills install --from github.com/mi-org/net-skills` |
 | `dai sync [--dry-run] [--for <asistentes>]` | **refresca** skills, constitución, templates y PR template a la versión del CLI — **aditivo** (no pisa tu `CLAUDE.md`), no toca el `.env` ni OpenSpec. Detecta los asistentes del repo o pasás `--for`. `--dry-run` muestra qué cambiaría ([ADR-0010](docs/adr/0010-versionado-y-upgrade.md)) |
 | `dai upgrade [--check] [--dry-run]` · alias `dai update` | **actualiza el CLI global** a la última publicada (`npm i -g …@latest`) — self-update. **No toca el repo**: reporta el drift del scaffold pero deja el `dai sync` al mantenedor. `--check` solo informa · `--dry-run` muestra el comando ([ADR-0012](docs/adr/0012-upgrade-self-update-del-cli.md)) |
-| `dai publish <us.md>` | crea la US en el tracker (Jira/ClickUp/md) desde un `.md` y devuelve el key. Es el fallback del MCP para publicar sin el asistente |
+| `dai publish <us.md> [--parent KEY] [--issuetype T] [--field alias=valor]` | crea la US en el tracker (Jira/ClickUp/md) desde un `.md` y devuelve el key — el fallback del MCP para publicar sin el asistente. `--parent PROJ-42` la cuelga de su épica · `--issuetype Epic` publica una épica (fallback CLI de `grill-epic`) · `--field clasificacion=Mejora` (repetible) manda los campos propios que exige tu Jira, declarados en `.dai/jira-fields.json` ([ADR-0015](docs/adr/0015-jira-corporativo.md)) |
 | `dai link-us <ID> [--us <md>]` | crea branch + `implements.yaml`; sin `--us` trae la US del tracker |
 | `dai link-us <ID> --resync` | re-estampa el `ac_hash` contra la US viva (tras un ⚠️ de check) |
 | `dai check` | compara tu código vs la US viva → ✅ al día / ⚠️ atrasado (exit code = gate de PR) |
 | `dai ls [--json]` | lista las US que implementa el repo + su link al tracker |
-| `dai pr [--assignee u] [--base b] [--draft] [--yes]` | crea TU PR/MR precargada: pregunta la branch base (default `main`), muestra el texto y confirma antes de publicar |
+| `dai pr [--assignee u] [--base b] [--draft] [--yes]` · alias **`dai mr`** | crea TU PR/MR precargada: pregunta la branch base (default `main`), muestra el texto y confirma antes de publicar. Detecta el forge (GitHub→PR con `gh` · GitLab→MR con `glab`); `mr` es el mismo comando, más natural en GitLab |
 | `dai stamp` | estampa la cobertura inversa en el tracker (branch + commit-ancla) |
 | `dai done [--base main] [--force]` | cierra la US: vuelve a la base, `fetch --prune` + `pull`, y borra la branch local **si está mergeada** (chequeo estricto; `--force` la borra igual). Redes: no estar en la base, sin cambios sueltos, sin commits sin pushear |
 | `dai archive [<change>] [--skip-specs]` | **funde los delta specs del change en las specs canónicas** (`openspec/specs/`) y lo archiva. Lo corre el **aprobador** de la PR (gate de aprobación, [ADR-0011](docs/adr/0011-archive-gate-de-aprobacion.md)); detecta el change activo o le pasás el nombre. Envuelve `openspec archive` |
@@ -214,14 +239,14 @@ ver [`.env.example`](.env.example). Auth (SSH + tokens): [ADR-0007](docs/adr/000
 | Valor | Genera | Elígelo si… |
 |---|---|---|
 | `--for claude` | `.claude/skills/` + `CLAUDE.md` | tu equipo usa **Claude** (Code / Desktop) |
-| `--for copilot` | `.github/prompts/*.prompt.md` + `.github/copilot-instructions.md` | tu equipo usa **GitHub Copilot** (en VS Code / JetBrains) |
+| `--for copilot` | `.github/skills/` + `.github/copilot-instructions.md` | tu equipo usa **GitHub Copilot** (app, CLI, VS Code / JetBrains o cloud agent) |
 | `--for cursor` | `.cursor/skills/` + `.cursor/rules/dai-constitution.mdc` | tu equipo usa **Cursor Agent** |
 | `--for both` | Claude + Copilot | equipo mixto sin Cursor |
 | `--for all` *(default)* | Claude + Copilot + Cursor | quieres dejar el repo listo para cualquier asistente |
 
 - **Combinables:** pasá un subconjunto separado por coma — `--for claude,cursor` o
-  `--for copilot`. `all` = los tres · `both` = Claude+Copilot. (Igual en `dai install`,
-  aunque ahí Copilot no aplica: no tiene skills instalables.)
+  `--for copilot`. `all` = los tres · `both` = Claude+Copilot. (Igual en `dai install`:
+  Copilot lee `SKILL.md` nativo, así que sus skills se instalan como las de Claude/Cursor.)
 - Es **aditivo, no destructivo**: los conjuntos conviven sin pisarse (viven en
   carpetas distintas). La **misma** skill se transforma al formato de cada asistente.
 - Si ejecutas `dai init` sin flag, te lo pregunta de forma interactiva.
@@ -241,7 +266,7 @@ mi-repo/
 │   └── doc-to-backlog · grill-intent · grill-epic · grill-user-story · link-us · tdd · dai-review
 ├── .github/
 │   ├── copilot-instructions.md     · La constitución, auto-inyectada en cada chat de Copilot
-│   ├── prompts/*.prompt.md         · Las mismas skills, generadas en formato Copilot
+│   ├── skills/                     · Las mismas skills, en formato Copilot nativo (SKILL.md)
 │   └── pull_request_template.md    · Molde de PR/MR atado al link
 ├── .cursor/
 │   ├── skills/                     · Las mismas skills, en formato Cursor

package/VERSION

@@ -1 +1 @@
-0.8.0
+0.8.1

package/cli/dai.mjs

@@ -58,9 +58,14 @@ function git(args, opts = {}) {
   // quedan en e.stderr para quien quiera inspeccionarlos.
   return execFileSync("git", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], ...opts }).trim();
 }
-// En Windows los binarios instalados por npm (npm, openspec) son shims `.cmd` que
-// execFileSync no resuelve solo. git/gh/glab son `.exe` y se resuelven normal.
-const npmBin = (name) => (process.platform === "win32" ? `${name}.cmd` : name);
+// En Windows los binarios instalados por npm (npm, openspec) son shims `.cmd`. Desde
+// Node 18.20 / 20.12 / 21.7 (fix de CVE-2024-27980) execFileSync se NIEGA a lanzar un
+// `.cmd` salvo con shell:true — si no, tira EINVAL, que dai confundía con "sin red".
+// Por eso van con shell en Windows. git/gh/glab son `.exe`: se resuelven normal, sin shell.
+function runNpmTool(name, args, opts = {}) {
+  const win = process.platform === "win32";
+  return execFileSync(win ? `${name}.cmd` : name, args, { shell: win, ...opts });
+}
 function trackerUrl(id) {
   const tpl = process.env.DAI_TRACKER_URL_TEMPLATE;
   return tpl ? tpl.replace("{id}", id) : id;
@@ -423,8 +428,16 @@ async function cmdPr(opts) {
   writeFileSync(bodyFile, body);
   try {
     info(`Publicando la branch ${branch}…`);
-    git(["push", "-u", "origin", branch]);
-  } catch (e) { fail(`no pude pushear la branch: ${String(e.message).split("\n")[0]}`, 1); }
+    // stdin heredado + GIT_TERMINAL_PROMPT=1: la PRIMERA vez contra un remoto HTTPS
+    // corporativo, git/credential-manager necesita poder pedir la credencial. Con stdin
+    // ignorado (el default de git()) el login no completaba y el push fallaba en seco.
+    git(["push", "-u", "origin", branch], { stdio: ["inherit", "pipe", "pipe"], env: { ...process.env, GIT_TERMINAL_PROMPT: "1" } });
+  } catch (e) {
+    const err = String(e.stderr || e.message || "").trim();
+    if (err) process.stderr.write("  " + err.split("\n").join("\n  ") + "\n");
+    process.stdout.write(`  Si es la primera vez contra este remoto, autenticá pusheando a mano una vez:\n    git push -u origin ${branch}\n  y volvé a correr:  dai pr\n`);
+    fail(`no pude pushear la branch '${branch}'.`, 1);
+  }
 
   const cmd = tool === "gh"
     ? ["pr", "create", "--title", title, "--body-file", bodyFile, "--base", base,
@@ -439,12 +452,20 @@ async function cmdPr(opts) {
     try { rmSync(bodyFile); } catch { /* noop */ }
   } catch (e) {
     const msg = String(e.stderr || e.message || "");
-    if (/no history in common|no commits between|not found.*base|base.*not found/i.test(msg)) {
+    const manual = `  Comando listo para correr a mano:\n    ${tool} ${cmd.map((c) => /\s/.test(c) ? `'${c}'` : c).join(" ")}\n`;
+    if (e.code === "ENOENT") {
+      // El binario del forge no está instalado (el caso más común detrás de "no salió la MR").
+      const doc = tool === "glab" ? "https://gitlab.com/gitlab-org/cli/-/releases" : "https://cli.github.com";
+      warn(`'${tool}' no está instalado. El body quedó en ${bodyFile}.`);
+      process.stdout.write(`  Instalá ${tool} (${doc}) y autenticá con \`${tool} auth login\`${tool === "glab" ? " --hostname " + (parseRemote(remote)?.host || "tu-gitlab") : ""}, o creá la PR a mano.\n${manual}`);
+    } else if (/no history in common|no commits between|not found.*base|base.*not found/i.test(msg)) {
       warn(`la branch no comparte historia con '${base}' en el remoto (o '${base}' no existe allá).`);
       process.stdout.write(`  Suele pasar cuando el repo local y el remoto son distintos. Empuja la base primero:\n    git push origin ${base}\n  y vuelve a correr:  dai pr\n`);
     } else {
-      warn(`no pude crear la PR con ${tool} (¿instalado y autenticado?). El body quedó en ${bodyFile}.`);
-      process.stdout.write(`  Comando listo para correr a mano:\n    ${tool} ${cmd.map((c) => /\s/.test(c) ? `'${c}'` : c).join(" ")}\n`);
+      warn(`no pude crear la PR con ${tool}. El body quedó en ${bodyFile}.`);
+      // El stderr real de gh/glab (auth vencida, host no configurado, flag desconocido…).
+      if (msg.trim()) process.stdout.write(`  ${tool} dijo:\n  ${msg.trim().split("\n").join("\n  ")}\n`);
+      process.stdout.write(manual);
     }
   }
 }
@@ -595,8 +616,9 @@ function cmdInstallFrom(opts) {
       rmSync(t, { recursive: true, force: true }); cpSync(srcDir, t, { recursive: true }); writeFileSync(join(t, "SKILL.md"), skillToCursor(md));
     }
     if (want.copilot) {
-      const pdir = join(repo, ".github", "prompts"); mkdirSync(pdir, { recursive: true });
-      writeFileSync(join(pdir, `${name}.prompt.md`), skillToPrompt(md));
+      // Copilot lee SKILL.md nativo (Agent Skills, ADR-0014): copia cruda, con templates/.
+      const t = join(repo, ".github", "skills", name);
+      rmSync(t, { recursive: true, force: true }); mkdirSync(dirname(t), { recursive: true }); cpSync(srcDir, t, { recursive: true });
     }
     ok(name); installed++;
   }
@@ -763,7 +785,7 @@ async function cmdInit(repo, opts) {
   // así que sí lo inicializamos nosotros — mapeando --for a sus tools. (Antes se
   // dejaba a medias porque se intentaba correr su modo interactivo anidado.)
   process.stdout.write("\n");
-  const openspecPresent = () => { try { execFileSync(npmBin("openspec"), ["--version"], { stdio: "ignore" }); return true; } catch { return false; } };
+  const openspecPresent = () => { try { runNpmTool("openspec", ["--version"], { stdio: "ignore" }); return true; } catch { return false; } };
   const osTools = [want.claude && "claude", want.copilot && "github-copilot", want.cursor && "cursor"]
     .filter(Boolean).join(",") || "claude,github-copilot,cursor";
   const osHint = "para sumarlo después:  npm i -g @fission-ai/openspec@latest  &&  openspec init --tools " + osTools;
@@ -774,13 +796,13 @@ async function cmdInit(repo, opts) {
   } else if (installOpenspec) {
     let cliOk = openspecPresent();
     if (!cliOk) {
-      try { info("OpenSpec:     instalando el CLI (npm i -g @fission-ai/openspec)…"); execFileSync(npmBin("npm"), ["install", "-g", "@fission-ai/openspec@latest"], { stdio: "inherit" }); cliOk = openspecPresent(); }
+      try { info("OpenSpec:     instalando el CLI (npm i -g @fission-ai/openspec)…"); runNpmTool("npm", ["install", "-g", "@fission-ai/openspec@latest"], { stdio: "inherit" }); cliOk = openspecPresent(); }
       catch { cliOk = false; }
     }
     if (cliOk) {
       try {
         info(`OpenSpec:     inicializando en el repo (--tools ${osTools})…`);
-        execFileSync(npmBin("openspec"), ["init", "--tools", osTools, "--force"], { stdio: "inherit", cwd: repo === "." ? process.cwd() : repo });
+        runNpmTool("openspec", ["init", "--tools", osTools, "--force"], { stdio: "inherit", cwd: repo === "." ? process.cwd() : repo });
         ok("OpenSpec:     instalado e inicializado — genera design/tasks con /opsx:*");
       } catch {
         warn("OpenSpec:     el CLI está pero falló `openspec init`. Ejecuta a mano en el repo:");
@@ -836,7 +858,7 @@ function cmdArchive(changeArg, opts) {
   const args = ["archive", change, "--yes"];
   if (opts.skipSpecs) args.push("--skip-specs");
   try {
-    execFileSync(npmBin("openspec"), args, { stdio: "inherit", cwd: repo });
+    runNpmTool("openspec", args, { stdio: "inherit", cwd: repo });
   } catch (e) {
     fail(`openspec archive falló (¿tasks incompletas? ¿change inexistente?): ${String(e.message).split("\n")[0]}`, 1);
   }
@@ -861,11 +883,13 @@ function cmdSync(repo, opts) {
   } else {
     want = {
       claude: existsSync(join(repo, ".claude", "skills")),
-      copilot: existsSync(join(repo, ".github", "prompts")),
+      // .github/skills es el layout nativo (ADR-0014); .github/prompts es el viejo, que
+      // seguimos detectando para migrar repos que quedaron en el formato anterior.
+      copilot: existsSync(join(repo, ".github", "skills")) || existsSync(join(repo, ".github", "prompts")),
       cursor: existsSync(join(repo, ".cursor", "skills")),
     };
     if (!want.claude && !want.copilot && !want.cursor)
-      fail("no detecté asistentes instalados (.claude/.cursor/.github/prompts). Pasá --for.", 2);
+      fail("no detecté asistentes instalados (.claude/skills · .github/skills · .cursor/skills). Pasá --for.", 2);
   }
 
   const cliV = readFileSync(join(ROOT, "VERSION"), "utf8").trim();
@@ -900,11 +924,16 @@ function cmdSync(repo, opts) {
     const cPath = join(repo, "CLAUDE.md"), cCur = existsSync(cPath) ? readFileSync(cPath, "utf8") : "";
     writeFileSync(cPath, upsertBlock(cCur, constitution("claude")));
   });
-  if (want.copilot) step(`Copilot:      .github/prompts/ (${skills.length}) + copilot-instructions.md`, () => {
-    const pdir = join(repo, ".github", "prompts"); mkdirSync(pdir, { recursive: true });
-    for (const name of skills) writeFileSync(join(pdir, `${name}.prompt.md`), skillToPrompt(readFileSync(join(skillsSrc, name, "SKILL.md"), "utf8")));
+  if (want.copilot) step(`Copilot:      .github/skills/ (${skills.length}) + copilot-instructions.md`, () => {
+    // Copilot lee SKILL.md nativo (ADR-0014): copia cruda, con templates/ — igual que `dai init`.
+    const dir = join(repo, ".github", "skills"); mkdirSync(dir, { recursive: true });
+    for (const name of skills) cpSync(join(skillsSrc, name), join(dir, name), { recursive: true });
     const ciPath = join(repo, ".github", "copilot-instructions.md"), ciCur = existsSync(ciPath) ? readFileSync(ciPath, "utf8") : "";
     writeFileSync(ciPath, upsertBlock(ciCur, constitution("copilot")));
+    // Limpia los .prompt.md viejos de dai (ahora son skills nativas) para no duplicar cada /comando.
+    const pdir = join(repo, ".github", "prompts");
+    const stale = existsSync(pdir) ? stalePromptFiles(skills).filter((f) => existsSync(join(pdir, f))) : [];
+    for (const f of stale) rmSync(join(pdir, f), { force: true });
   });
   if (want.cursor) step(`Cursor:       .cursor/skills/ (${skills.length}) + .cursor/rules/dai-constitution.mdc`, () => {
     const dir = join(repo, ".cursor", "skills"); mkdirSync(dir, { recursive: true });
@@ -963,7 +992,7 @@ function cmdUpgrade(opts) {
 
   let latestV;
   try {
-    latestV = execFileSync(npmBin("npm"), ["view", name, "version"], { encoding: "utf8" }).trim();
+    latestV = runNpmTool("npm", ["view", name, "version"], { encoding: "utf8" }).trim();
   } catch {
     fail(`no pude consultar el registry (¿sin red?). Actualizá a mano: ${manual}`, 1);
   }
@@ -979,7 +1008,7 @@ function cmdUpgrade(opts) {
 
   info(`actualizando v${plan.from} → v${plan.to} …`);
   try {
-    execFileSync(npmBin("npm"), ["install", "-g", `${name}@latest`], { stdio: "inherit" });
+    runNpmTool("npm", ["install", "-g", `${name}@latest`], { stdio: "inherit" });
   } catch {
     fail(`el install falló. Probá a mano: ${manual}`, 1);
   }
@@ -1093,7 +1122,8 @@ switch (cmd) {
   case "stamp":   cmdStamp().catch((e) => fail(String(e.message))); break;
   case "forge":   cmdForge(pos[0], pos[1], opts).catch((e) => fail(String(e.message))); break;
   case "publish": cmdPublish(pos[0], opts).catch((e) => fail(String(e.message))); break;
-  case "pr":      cmdPr(opts).catch((e) => fail(String(e.message))); break;
+  case "pr":
+  case "mr":      cmdPr(opts).catch((e) => fail(String(e.message))); break;   // `mr` = alias para GitLab (merge request)
   case "done":    cmdDone(opts); break;
   case "archive": cmdArchive(pos[0], opts); break;
   case "install": cmdInstall(opts).catch((e) => fail(String(e.message))); break;   // alias de `dai skills install`
@@ -1123,7 +1153,7 @@ switch (cmd) {
       "  stamp                        estampa la cobertura en el tracker (ADR-0005)\n" +
       "  done [--base main] [--force] cierra la US: vuelve a la base, actualiza y borra la branch local (si está mergeada)\n" +
       "  archive [<change>] [--skip-specs]   funde los delta specs del change en las specs canónicas y lo archiva (lo corre el aprobador en la PR)\n" +
-      "  pr [--assignee u] [--base b] [--draft] [--yes]   crea TU PR/MR precargada (muestra + confirma)\n" +
+      "  pr (alias mr) [--assignee u] [--base b] [--draft] [--yes]   crea TU PR/MR precargada (muestra + confirma)\n" +
       "  forge comment <ref> --body-file <f> · forge pr <ref>   comentar/leer una PR ajena (github/gitlab)\n\n" +
       "Instalación:\n" +
       "  skills install [--global | --local <repo>] [--force] [--dry-run] [--for <asistentes>]   instala las skills de dai (alias: `install`)\n" +

package/cli/lib/http.mjs

@@ -35,7 +35,13 @@ export function tlsHint(host, code) {
     "  Casi siempre es un proxy corporativo que intercepta TLS con su propia CA. Node no",
     "  usa el trust store de Windows/macOS, por eso el navegador anda y dai no.",
     "",
-    "  Solución: exportá la CA raíz de tu empresa a un .pem y declarásela a Node:",
+    "  Solución más simple (Node ≥ 22.15): usá el trust store del sistema, donde tu navegador",
+    "  ya confía en la CA de tu empresa:",
+    "    Windows (PowerShell):  $env:NODE_OPTIONS=\"--use-system-ca\"",
+    "    macOS / Linux:         export NODE_OPTIONS=--use-system-ca",
+    "",
+    "  Alternativa (cualquier versión de Node): exportá la CA raíz de tu empresa a un .pem",
+    "  y declarásela a Node:",
     "    Windows (PowerShell):  $env:NODE_EXTRA_CA_CERTS=\"C:\\ruta\\ca-empresa.pem\"",
     "    macOS / Linux:         export NODE_EXTRA_CA_CERTS=/ruta/ca-empresa.pem",
     "",

package/cli/lib/pm-jira.mjs

@@ -106,16 +106,32 @@ export function renderCoverageAdf(id, r) {
   return { type: "doc", version: 1, content };
 }
 
-// Un 400 al crear casi siempre es un campo obligatorio del proyecto que no mandamos.
-// El cuerpo de Jira nombra el customfield_NNNNN pero no dice qué hacer: lo decimos acá.
-function createHint(status) {
+// Un 400 al crear puede ser (a) un campo propio obligatorio que no mandamos, (b) una regla
+// del proyecto —p. ej. exigir una épica padre— o (c) otra cosa. Jira dice cuál en el cuerpo,
+// pero no dice qué hacer: elegimos la ayuda según lo que dice el error, no una fija. Antes
+// mandábamos SIEMPRE a declarar un campo, aunque el 400 fuera "falta la épica" (confuso).
+export function createHint(status, body = "") {
   if (status !== 400) return "";
-  return "\n\n  Si el error nombra un 'customfield_NNNNN', tu proyecto exige un campo propio.\n" +
-         "  Declaralo en .dai/jira-fields.json y volvé a publicar — no hace falta improvisar\n" +
-         "  una llamada a mano:\n" +
-         '    { "Story": { "clasificacion": { "field": "customfield_NNNNN",\n' +
-         '                                    "options": ["Mejora", "Corrección"] } } }\n' +
-         "    dai publish <us.md> --field clasificacion=Corrección";
+  const b = String(body);
+  // Regla de workflow: la historia tiene que colgar de una épica (no es un campo propio).
+  if (/[ée]pica|epic|parent/i.test(b)) {
+    return "\n\n  Tu proyecto pide que esta historia cuelgue de una épica. Pasá la key de la\n" +
+           "  épica padre con --parent (es la épica, no el proyecto):\n" +
+           "    dai publish <us.md> --parent PROJ-123 --field clasificacion=<valor>";
+  }
+  // Campo propio obligatorio que no mandamos (el customfield_NNNNN del error).
+  if (/customfield_/i.test(b)) {
+    return "\n\n  Tu proyecto exige un campo propio (el 'customfield_NNNNN' del error).\n" +
+           "  Declaralo en .dai/jira-fields.json y volvé a publicar — no hace falta improvisar\n" +
+           "  una llamada a mano:\n" +
+           '    { "Story": { "clasificacion": { "field": "customfield_NNNNN",\n' +
+           '                                    "options": ["Mejora", "Corrección"] } } }\n' +
+           "    dai publish <us.md> --field clasificacion=Corrección";
+  }
+  // 400 genérico: no adivinamos. Nombramos las dos causas típicas sin empujar una.
+  return "\n\n  Jira rechazó la creación (400) — el mensaje de arriba dice por qué. Las dos causas\n" +
+         "  típicas: un campo propio obligatorio (declaralo en .dai/jira-fields.json) o una regla\n" +
+         "  del proyecto como exigir una épica padre (--parent PROJ-123).";
 }
 
 export function jiraAdapter(env) {
@@ -155,7 +171,10 @@ export function jiraAdapter(env) {
         method: "POST", headers: jiraAuthHeaders(env),
         body: JSON.stringify({ fields: payload }),
       });
-      if (!res.ok) throw new Error(`jira ${res.status}: ${await res.text()}${createHint(res.status)}`);
+      if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`jira ${res.status}: ${body}${createHint(res.status, body)}`);
+      }
       const j = await res.json();
       return { id: j.key, url: `${trim(base)}/browse/${j.key}` };
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dforce2055/dai",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Metodología de desarrollo asistido por IA — CLI de acciones deterministas (trazabilidad QUÉ↔CÓMO).",
   "repository": { "type": "git", "url": "git+https://github.com/dforce2055/dai.git" },
   "homepage": "https://dforce2055.github.io/dai/",