@dforce2055/dai 0.1.0

package/.env.example

@@ -0,0 +1,30 @@
+# dai · configuración del adaptador de PM (copiar a .env y completar).
+# El .env está gitignoreado para no filtrar secretos. Este .example SÍ se versiona.
+# Las variables ya exportadas en la shell/CI ganan sobre el .env.
+
+# ── Backend del tracker ──────────────────────────────────────────────────────
+# md | jira | clickup   (por ahora solo md está implementado)
+DAI_PM=md
+
+# Plantilla del link al ticket (para `dai ls` / stamp). {id} se reemplaza.
+DAI_TRACKER_URL_TEMPLATE=https://jira.miempresa.com/browse/{id}
+
+# ── Backend md (local, offline) ──────────────────────────────────────────────
+# Carpeta donde viven las US como <ID>.md (p. ej. ABC-482.md).
+DAI_MD_US_DIR=.dai/us
+
+# ── Backend jira (REST v3 / Jira Cloud) — activar con DAI_PM=jira ────────────
+# DAI_JIRA_BASE_URL=https://miempresa.atlassian.net
+# DAI_JIRA_EMAIL=usuario@miempresa.com
+# DAI_JIRA_TOKEN=          # ← SECRETO. api_token de id.atlassian.com. Nunca commitear.
+# DAI_JIRA_PROJECT=        # clave del proyecto (ej. PROJ) — solo para `dai publish` (crear issues)
+# DAI_JIRA_ISSUETYPE=Story # tipo de issue a crear (default Story) — solo para `dai publish`
+
+# ── Backend clickup (REST v2) — activar con DAI_PM=clickup ───────────────────
+# DAI_CLICKUP_TOKEN=       # ← SECRETO. token personal scopeado.
+# DAI_CLICKUP_LIST_ID=     # ID de la lista donde crear tareas — solo para `dai publish`
+
+# ── Forge (dai-review: comentar PR/MR) ───────────────────────────────────────
+# Token SCOPEADO del forge para postear comentarios (git usa SSH, no esto).
+# GITHUB_TOKEN=            # ← SECRETO. Scope: repo / pull-requests.
+# GITLAB_TOKEN=            # ← SECRETO. Scope: api (o solo notes).

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+Formato basado en [Keep a Changelog](https://keepachangelog.com/). Versionado semver
+(ver `VERSION`).
+
+## [0.1.0] — 2026-07-06
+
+Primera versión: metodología completa + CLI de trazabilidad, probado end-to-end contra
+ClickUp y Jira Cloud.
+
+### Metodología
+- Manifiesto (constitución: 4 valores + 15 artículos), METODOLOGIA (protocolo invariante
+  + dial de niveles N1/N2/N3), SCRUM-CON-IA (los 10 pasos, con `detalle/`), EJEMPLO
+  end-to-end, glosario, guías por rol (PO/dev/lead), landing autocontenido (`index.html`).
+- 7 ADRs: `ac_hash`, agnóstico del asistente, detección/estampado como comandos,
+  ubicación+schema del `implements.yaml`, superficie de comandos, distribución+licencia,
+  modelo de autenticación.
+
+### Templates y governance
+- `formato-us`, `epica`, `definition-of-ready`, `definition-of-done`, `adr`,
+  `pull-request`, hook `commit-msg`; `branch-naming`, `ci-rules`, `commit-convention`.
+
+### Skills (para Claude y Copilot, generadas por `dai init`)
+- El QUÉ: `doc-to-backlog` (un doc → backlog candidato), `grill-intent` (Gate 0),
+  `grill-epic` (épicas), `grill-user-story` (la US — detecta el tracker del `.env` y publica).
+- El CÓMO: `link-us`, `tdd`, `dai-review`.
+
+### CLI (`dai`, Node, cero dependencias)
+- **Definir el QUÉ:** `publish` (crea la US en el tracker desde un `.md`).
+- **Trazabilidad:** `link-us` (+ `--resync`), `check`, `stamp`, `ls`, `ac-hash`.
+- **PR y cierre:** `pr` (crea la PR precargada), `forge` (comentar/leer PR en GitHub/GitLab),
+  `done` (cierra la US: vuelve a la base, actualiza y borra la branch).
+- **Setup:** `init` (scaffolder interactivo: asistente + tracker + OpenSpec), `install`,
+  `docs`, `doctor`.
+- Adaptador de tracker: `md`, `jira` (ADF, Jira Cloud), `clickup`. Auth por SSH (git) +
+  token scopeado (forge/tracker), nunca contraseñas.
+- **87 tests** (`node --test`), cero dependencias de runtime.
+
+### Distribución y comunidad
+- Licencia **GPLv3**. Publicable en npm (scopeado); `install.sh` como shim de git-clone.
+- `SECURITY.md`, `CODE_OF_CONDUCT.md`, `CONTRIBUTING.md`, `.editorconfig`, `.nvmrc`,
+  `.gitattributes`, templates de PR/issue, CI de GitHub Actions (Node 18/20/22).
+- Tests de las rutas de red (jira/clickup/forge) con `fetch` mockeado. Sin links rotos;
+  `files` de npm sin tests ni secretos.
+
+[0.1.0]: https://github.com/dforce2055/dai/releases/tag/v0.1.0

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,37 @@
+# Código de conducta
+
+## Nuestro compromiso
+
+Como participantes y mantenedores, nos comprometemos a que participar en este
+proyecto sea una experiencia **libre de acoso para todos**, sin importar edad,
+identidad de género, discapacidad, etnia, nivel de experiencia, nacionalidad,
+apariencia, religión u orientación.
+
+## Nuestros estándares
+
+Comportamientos que esperamos:
+
+- Lenguaje acogedor e inclusivo.
+- Respeto por puntos de vista y experiencias distintas.
+- Aceptar la crítica constructiva con gracia.
+- Enfocarse en lo mejor para la comunidad.
+
+Comportamientos inaceptables:
+
+- Lenguaje o imágenes sexualizadas, o atención sexual no deseada.
+- Trolleo, insultos, ataques personales o políticos.
+- Acoso público o privado.
+- Publicar información privada de otros sin permiso.
+
+## Aplicación
+
+Los mantenedores son responsables de aclarar los estándares y de tomar acciones
+correctivas justas ante comportamientos inaceptables, incluyendo editar o eliminar
+contribuciones, y banear temporal o permanentemente a quien los viole.
+
+Para reportar un problema de conducta, escribe a **dperez2055@gmail.com**. Todos los
+reportes se revisan y se manejan con confidencialidad.
+
+## Atribución
+
+Adaptado del [Contributor Covenant](https://www.contributor-covenant.org), v2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contribuir a dai
+
+Gracias por querer mejorar `dai`. Es **software libre (GPLv3)** y la comunidad es
+bienvenida — al contribuir, aceptas que tu aporte se distribuya bajo la misma
+licencia (ver [`LICENSE`](LICENSE)).
+
+`dai` **usa su propia metodología** (dogfooding). Contribuir es una buena forma de
+verla funcionar.
+
+## Setup
+
+Cero dependencias. Solo hace falta **Node ≥ 18**:
+
+```bash
+git clone <tu-fork> dai && cd dai
+npm test        # 48 tests, sin `npm install` (no hay deps)
+```
+
+## Reglas de oro
+
+1. **Cero dependencias de runtime.** El CLI corre en redes cerradas sin `npm install`
+   (ADR-0006). No agregues paquetes a `dependencies`. Si algo parece necesitar una
+   dep, abre un issue a discutir antes.
+2. **Test primero (TDD).** Toda lógica nueva del CLI va con su test en `cli/test/`
+   (`node --test`). La parte pura y determinista es la que se testea; la red (fetch)
+   no se unit-testea, se aísla.
+3. **El contrato no se rompe en silencio.** Cambiar el algoritmo del `ac_hash`, el
+   schema del `implements.yaml` o la superficie de comandos es un cambio **mayor** y
+   necesita un ADR (ver abajo).
+4. **Secretos nunca en el repo.** Tokens solo en `.env` (gitignored) o el secret
+   store del CI. git usa **SSH**, las APIs usan **tokens scopeados** (ADR-0007).
+
+## Flujo (la propia metodología)
+
+1. **Rama** desde `main`: `feature/<slug>` o `fix/<slug>`.
+2. **Implementa con tests.** `npm test` en verde antes de abrir el PR.
+3. **PR** siguiendo [`templates/pull-request.md`](templates/pull-request.md):
+   descripción, testing, y el checklist de Dev + Aprobador.
+4. Un **mantenedor revisa y firma** la aprobación (la IA puede dar el primer pase,
+   pero aprueba una persona — Art. 5 del [manifiesto](docs/MANIFIESTO.md)).
+
+## Decisiones estructurales → ADR
+
+Si tu cambio toca una decisión de fondo (un contrato, un modelo, la distribución),
+escribe un **ADR** con [`templates/adr.md`](templates/adr.md), numerado, en
+[`docs/adr/`](docs/adr/). Los ADR son inmutables: si algo cambia, se escribe uno
+nuevo que supersede al viejo.
+
+## Convención de commits
+
+`tipo(scope): resumen` — `feat` · `fix` · `docs` · `chore` · `refactor` · `test`.
+Ejemplo: `feat(cli): dai stamp reporta el ambiente`. La convención completa (tipos,
+reglas, breaking changes) y un hook `commit-msg` que la valida están en
+[`governance/commit-convention.md`](governance/commit-convention.md).
+
+## Reportar / proponer
+
+- **Bug** → issue con: qué esperabas, qué pasó, cómo reproducir, versión (`dai --version`).
+- **Idea** → issue de discusión antes de un PR grande, para acordar el enfoque.
+
+## Qué hace que un PR entre rápido
+
+- Tests verdes y acotado a una cosa.
+- Sin dependencias nuevas.
+- Si toca comportamiento, el `README`/docs quedan al día.
+- Si toca un contrato, viene con su ADR.