@dforce2055/dai 0.9.0 → 0.10.0

package/docs/tutoriales/token-clickup.md

@@ -0,0 +1,73 @@
+# Cómo obtener el token de API de ClickUp
+
+Guía paso a paso para generar tu **token de API personal de ClickUp**, necesario para que
+`dai` (o cualquier script) se autentique contra la REST API de **ClickUp** cuando el tracker
+del repo es ClickUp (`DAI_PM=clickup`).
+
+> **¿Por qué un token y no la contraseña?** ClickUp no permite autenticar la API con la
+> contraseña de la cuenta (menos aún con SSO / verificación en dos pasos). El **token
+> personal** cumple ese rol: es una credencial que representa a tu usuario y que tratas
+> **igual que una contraseña**. Empieza siempre con `pk_`.
+
+**Atajo:** si quieres saltar los pasos 1 y 2, entra directo a
+👉 **https://app.clickup.com/settings/apps** (te lleva al paso 3).
+
+---
+
+## Paso 1 — Abre la configuración de tu cuenta
+
+En ClickUp, haz clic en tu **avatar** (arriba a la derecha) y elige **Settings**
+(Configuración).
+
+![Menú del avatar → Settings](/tutoriales/clickup-1-settings.png)
+
+---
+
+## Paso 2 — Ve a "API de ClickUp"
+
+En la barra lateral de configuración, bajo tu cuenta, entra a la sección **API de ClickUp**.
+Ahí, arriba de todo, verás el bloque **API Token**.
+
+![Barra lateral de Settings → Apps](/tutoriales/clickup-2-api.png)
+
+---
+
+## Paso 3 — Genera o copia el token
+
+En **API Token**:
+
+- Si es la primera vez, haz clic en **Generate** para crearlo.
+- Si ya tenías uno, aparece oculto con un botón **Copy** (y un **Regenerate** al lado).
+
+El token empieza con `pk_` (ej. `pk_1234567_ABCDEFG…`). Haz clic en **Copy** para copiarlo.
+
+![Bloque API Token → Generate / Copy](/tutoriales/clickup-3-generate-copy.png)
+
+---
+
+## Paso 4 — Guárdalo en tu `.env.dai`
+
+Pega el token en el `.env.dai` del repo (que **no se versiona**; el `.env` del equipo no se
+toca — [ADR-0017](../adr/0017-env-dai.md)), en la variable que espera dai:
+
+```bash
+DAI_PM=clickup
+DAI_CLICKUP_TOKEN=pk_...        # ← tu token, solo el token (sin comillas ni comentarios al lado)
+# DAI_CLICKUP_LIST_ID=          # solo hace falta para `dai publish` (crear tareas)
+```
+
+Verifica con `dai doctor` → debería decir **"token de ClickUp presente"**.
+
+---
+
+## Reglas de seguridad (importante)
+
+- 🔒 **Trátalo como una contraseña.** Nunca lo pegues en el código, en un commit, en un chat
+  ni en el `implements.yaml`. Solo va en `.env.dai` (no versionado).
+- ♻️ **No vence por sí solo** (a diferencia de Jira): queda válido hasta que lo **regeneres**.
+  Regenerar crea uno nuevo e **invalida el anterior al instante** — así lo rotas y así cortas
+  el acceso de uno filtrado.
+- 👤 **Es personal:** representa a tu usuario, con tus permisos. Cada dev usa el suyo, nunca
+  uno compartido.
+- 🧯 **Si se filtra**, entra a la misma pantalla (paso 3) y haz **Regenerate** de inmediato;
+  el viejo deja de funcionar y actualizas el `.env.dai` con el nuevo.

package/docs/tutoriales/token-jira.md

@@ -0,0 +1,74 @@
+# Cómo obtener el token de API de Jira (Atlassian)
+
+Guía paso a paso para generar un **token de API de Atlassian**, necesario para que `dai`
+(o cualquier script) se autentique contra la REST API de **Jira Cloud** cuando el tracker
+del repo es Jira (`DAI_PM=jira`).
+
+> **¿Por qué un token y no la contraseña?** Jira Cloud no permite autenticar la API con la
+> contraseña de la cuenta (menos aún con SSO / verificación en dos pasos). El token cumple
+> ese rol: es una credencial revocable, con vencimiento, que tratas **igual que una
+> contraseña**.
+
+**Atajo:** si quieres saltar los pasos 1 y 2, entra directo a
+👉 **https://id.atlassian.com/manage-profile/security/api-tokens** (te lleva al paso 3).
+
+---
+
+## Paso 1 — Abre la configuración de tu cuenta
+
+En Jira, haz clic en tu **avatar** (arriba a la derecha) y elige **Configuración de la cuenta**.
+
+![Menú del avatar → Configuración de la cuenta](/tutoriales/jira-1-avatar.png)
+
+---
+
+## Paso 2 — Ve a Seguridad → Tokens de API
+
+En la barra superior, entra a la pestaña **Seguridad**. Baja hasta la sección
+**Tokens de API** y haz clic en **Crear y gestionar tokens de API**.
+
+![Pestaña Seguridad → Crear y gestionar tokens de API](/tutoriales/jira-2-seguridad-tokens.png)
+
+---
+
+## Paso 3 — Crea el token
+
+Haz clic en **Crear token de API** (el botón simple, no el de "con alcances").
+Acceso directo => https://id.atlassian.com/manage-profile/security/api-tokens
+
+![Botón Crear token de API](/tutoriales/jira-3-crear-token.png)
+
+---
+
+## Paso 4 — Nombre y vencimiento
+
+- **Name:** un nombre que describa para qué es (ej. `dai-frontend`, `dai-backend`).
+- **Caduca el:** una fecha de vencimiento. Por seguridad, Atlassian **no permite más de un
+  año**. Pon la fecha máxima si no quieres renovarlo seguido, o una más corta para rotarlo
+  antes.
+
+Haz clic en **Crear**.
+
+![Formulario: Name + fecha de caducidad](/tutoriales/jira-4-nombre-vencimiento.png)
+
+---
+
+## Paso 5 — Cópialo AHORA (no se recupera después)
+
+Atlassian te muestra el token **una sola vez**. Haz clic en **Copiar** y guárdalo en un
+lugar seguro. **Si cierras esta ventana sin copiarlo, no hay forma de recuperarlo** —
+tendrías que crear uno nuevo.
+
+![Ventana Copia tu token de API](/tutoriales/jira-5-copiar.png)
+
+---
+
+## Reglas de seguridad (importante)
+
+- 🔒 **Trátalo como una contraseña.** Nunca lo pegues en el código, en un commit, en un chat
+  ni en el `implements.yaml`. Solo va en `.env.dai`, que **no se versiona** (el `.env` del
+  equipo no se toca; ver [ADR-0017](../adr/0017-env-dai.md)).
+- ♻️ **Rótalo** periódicamente y **revoca** los que no uses (misma pantalla del paso 3, columna
+  *Acción → Revocar*).
+- ⏱️ **Vencimiento:** el token deja de funcionar en la fecha que pusiste; anota cuándo renovarlo.
+- 🧯 **Si se filtra**, revócalo de inmediato y crea uno nuevo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dforce2055/dai",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "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/",
@@ -32,7 +32,7 @@
     "skills",
     "manifest.yaml",
     "install.sh",
-    ".env.example",
+    ".env.dai.example",
     "VERSION",
     "LICENSE",
     "README.md",
@@ -43,7 +43,13 @@
   ],
   "scripts": {
     "test": "node --test cli/test/*.test.mjs",
-    "prepublishOnly": "npm test"
+    "prepublishOnly": "npm test",
+    "docs:dev": "vitepress dev",
+    "docs:build": "vitepress build",
+    "docs:preview": "vitepress preview"
+  },
+  "devDependencies": {
+    "vitepress": "^1.6.3"
   },
   "engines": {
     "node": ">=18"