@christianmaf80/agentic-workflow 1.41.0-beta.10 → 1.42.0

package/dist/agent/artifacts/11-refinement-capas-constitution/analysis.md

@@ -0,0 +1,24 @@
+# Analysis Report — T11: Refinamiento de Constituciones
+
+## 1. Contexto
+La arquitectura actual modular (`src/extension/modules/*`) requiere reglas estrictas.
+
+## 2. Propuesta de Reglas Constitucionales
+
+### 2.1 Backend Layer (`constitution.backend`)
+1.  **Inheritance**: Extender `AbstractServer` (de `core/backend`).
+2.  **Isolation**: Sin dependencias de `vscode` ni `dom`.
+3.  **Transport Agnostic**.
+
+### 2.2 Background Layer (`constitution.background`)
+1.  **Module Registration**: `App.register`.
+2.  **Messaging Bridge**: `Messaging` (de `core/messaging`) obligatorio.
+3.  **Gateway**: Único punto de acceso a `vscode`.
+
+### 2.3 View Layer (`constitution.view`)
+1.  **Lit Framework**: LitElements obligatorios.
+2.  **Structure**: `index.ts`, `html.ts`, `styles.ts`.
+3.  **No Logic in View**.
+
+## 3. Impacto en Roadmap
+Reset masivo de tareas D1-D6.

package/dist/agent/artifacts/11-refinement-capas-constitution/roadmap-audit.md

@@ -0,0 +1,34 @@
+# Roadmap Audit Report — T11 (Revised)
+
+## Identification
+- id: audit-T11-rev2
+- title: Roadmap vs Current Codebase Audit (Deep Dive)
+- date: 2026-02-15
+- owner: architect-agent
+- related_task: 11
+
+## Purpose
+Determinar con precisión el estado de los entregables del Roadmap frente a la estructura actual del proyecto.
+
+## Context
+El usuario solicitó una re-evaluación profunda. Investigación confirma que la estructura `src/extension/modules` es la única fuente de verdad.
+
+## Findings Details
+
+### 🔴 DOMINIO D1: Setup/Config (Estado Real: NO INICIADO)
+- **T002, T003, T004**: No existen implementaciones funcionales en `modules/setup`.
+
+### 🟡 DOMINIO D3: Backend/Extension Host (Estado Real: PARCIAL)
+- **T010**: No existe session endpoint.
+- **T011**: Bridge básico en `core/messaging`.
+- **T012**: Backend client es un mock.
+
+### 🟡 DOMINIO D2, D4, D6 (Estado Real: PENDIENTE/RESTART)
+- Se ha procedido a resetear el estado de estas tareas en el Roadmap para reflejar la realidad del código.
+
+## Decisions & Recommendations
+1. **Declarar Bancarrota Técnica del Roadmap Antiguo**.
+2. **Re-Planificación Estricta**.
+
+## References
+- `ls src/extension/modules`

package/dist/agent/artifacts/11-refinement-capas-constitution/task.md

@@ -0,0 +1,58 @@
+---
+id: "11"
+title: "refinement-capas-constitution"
+owner: "architect-agent"
+strategy: "long"
+---
+
+# Task: Refinamiento de Constitución de Capas y Roadmap
+
+## Current Phase: phase-6-commit
+
+- [x] Phase 0: Acceptance Criteria
+    - [x] Formular preguntas aclaratorias
+    - [x] Consolidar respuestas del desarrollador
+    - [x] Crear artefactos de tarea y aceptación
+    - [x] Obtener aprobación de criterios de aceptación
+- [x] Phase 1: Research
+    - [x] Auditoría del código actual vs Roadmap
+    - [x] Análisis de las constituciones existentes
+- [x] Phase 2: Analysis
+    - [x] Definir reglas para Backend (AbstractServer, etc.)
+    - [x] Definir reglas para Background (Messaging, App)
+    - [x] Definir reglas para View (Lit, HTML)
+- [x] Phase 3: Planning
+    - [x] Crear Implementation Plan (realizado en Phase 1)
+    - [x] Obtener aprobación del plan
+- [x] Phase 4: Implementation
+    - [x] Actualizar constitution/backend.md
+    - [x] Actualizar constitution/background.md
+    - [x] Actualizar constitution/view.md
+    - [x] Actualizar ROADMAP-BACKLOG.md
+- [x] Phase 5: Verification
+    - [x] Verificar existencia de archivos de constitución
+    - [x] Verificar integridad del Roadmap (Reset realizado)
+
+---
+
+## Task Identification
+- **UUID**: 11
+- **Strategy**: long
+- **Implementation Owner**: architect-agent
+
+---
+
+## Lifecycle History
+| Phase | Action | Agent | Date | Result |
+|-------|--------|-------|------|--------|
+| phase-0-acceptance-criteria | Definition | architect-agent | 2026-02-15T16:22:00Z | YES |
+| phase-1-research | Start | architect-agent | 2026-02-15T16:23:00Z | YES |
+| phase-2-analysis | Analysis | architect-agent | 2026-02-15T16:24:00Z | YES |
+| phase-3-planning | Plan | architect-agent | 2026-02-15T16:25:00Z | YES |
+| phase-4-implementation | Coding | architect-agent | 2026-02-15T16:26:00Z | YES |
+| phase-5-verification | Tests | architect-agent | 2026-02-15T16:28:00Z | YES |
+
+---
+
+## 2. Definición y Alcance (Contrato)
+- **Acceptance Criteria**: `acceptance.md`

package/dist/agent/artifacts/12-npm-workspaces/acceptance.md

@@ -0,0 +1,78 @@
+🏛️ **architect-agent**: Acceptance criteria para la tarea T012 — npm-workspaces.
+
+# Acceptance Criteria — 12-npm-workspaces
+
+## 1. Definición Consolidada
+Migrar el proyecto actual a npm workspaces convirtiendo los módulos `app`, `core` y `cli` en packages npm privados e independientes. Cada package tendrá su propio `package.json` con sus dependencias específicas. El proyecto root coordinará los workspaces y ofrecerá un build unificado. La estructura de extensión VSCode debe mantenerse funcional.
+
+## 2. Respuestas a Preguntas de Clarificación
+
+| # | Pregunta (formulada por architect) | Respuesta (del desarrollador) |
+|---|-----------------------------------|-------------------------------|
+| 1 | ¿Qué elementos deben convertirse en packages npm independientes? | `src/extension/modules/*` (app, core) + `src/cli` |
+| 2 | ¿Qué convención de nombres usar para los packages? | `@agentic-workflow/app`, `@agentic-workflow/core`, `@agentic-workflow/cli` |
+| 3 | ¿Packages públicos o privados? | Private (solo para uso interno del workspace) |
+| 4 | ¿Cómo gestionar dependencias compartidas? | Cada package define sus propias dependencias |
+| 5 | ¿Cómo deben funcionar los scripts de build? | Build unificado desde root |
+
+---
+
+## 3. Criterios de Aceptación Verificables
+
+1. **Alcance**:
+   - `src/extension/modules/app` → package `@agentic-workflow/app`
+   - `src/extension/modules/core` → package `@agentic-workflow/core`
+   - `src/cli` → package `@agentic-workflow/cli`
+   - Root `package.json` configura `workspaces`
+
+2. **Entradas / Datos**:
+   - Código fuente actual en `src/extension/modules/app`, `src/extension/modules/core`, `src/cli`
+   - `package.json` root actual con todas las dependencias centralizadas
+   - `tsconfig.json` actual
+
+3. **Salidas / Resultado esperado**:
+   - Cada package tiene su propio `package.json` con `"private": true`
+   - Root `package.json` incluye campo `"workspaces"` apuntando a los packages
+   - Dependencias distribuidas correctamente en cada package
+   - Build unificado funcional desde root (`npm run compile` / `npm run build`)
+   - La extensión VSCode sigue compilando y ejecutándose correctamente
+
+4. **Restricciones**:
+   - Packages privados (no publicables)
+   - Cada package gestiona sus propias dependencias (sin hoisting forzado)
+   - La estructura de carpetas existente se mantiene (no mover archivos de sitio)
+   - Compatibilidad con el build de extensión VSCode
+
+5. **Criterio de aceptación (Done)**:
+   > **Gate principal**: La tarea se da por terminada si los tests e2e siguen funcionando exactamente igual que antes de la migración.
+   - [ ] **Tests e2e pasan idénticamente** (`npm run test:e2e`) — criterio bloqueante
+   - [ ] `npm install` desde root instala todas las dependencias de todos los workspaces
+   - [ ] `npm run compile` desde root compila exitosamente todos los workspaces
+   - [ ] Cada package tiene `package.json` válido con `"private": true`
+   - [ ] Root `package.json` contiene campo `"workspaces"` correctamente configurado
+   - [ ] Las dependencias inter-package se resuelven vía workspace (ej: `"@agentic-workflow/core": "workspace:*"`)
+   - [ ] La extensión VSCode se ejecuta correctamente tras la migración
+
+---
+
+## Aprobación (Gate 0)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: "2026-02-16T07:32:24+01:00"
+    comments: "Tests e2e como gate principal bloqueante"
+```
+
+---
+
+## Historial de validaciones (Phase 0)
+```yaml
+history:
+  - phase: "phase-0-acceptance-criteria"
+    action: "created"
+    validated_by: "architect-agent"
+    timestamp: "2026-02-16T07:29:25+01:00"
+    notes: "Acceptance criteria definidos con 5 preguntas respondidas"
+```

package/dist/agent/artifacts/12-npm-workspaces/analysis.md

@@ -0,0 +1,179 @@
+🏛️ **architect-agent**: Análisis técnico para T012 — Migración a npm workspaces.
+
+---
+artifact: analysis
+phase: phase-2-analysis
+owner: architect-agent
+status: draft
+related_task: 12-npm-workspaces
+---
+
+# Analysis — 12-npm-workspaces
+
+## 1. Resumen ejecutivo
+
+**Problema**
+El proyecto es un monolito TypeScript donde todas las dependencias están centralizadas en un único `package.json` y los módulos se comunican mediante rutas relativas. Esto impide el aislamiento de dependencias y dificulta la escalabilidad.
+
+**Objetivo**
+Convertir `app`, `core` y `cli` en packages npm privados dentro de un monorepo con npm workspaces.
+
+**Criterio de éxito**
+Los tests e2e deben seguir pasando idénticamente tras la migración.
+
+---
+
+## 2. Estado del proyecto (As-Is)
+
+- **Estructura relevante**
+  - `src/extension/modules/app/` — módulo App (hereda de core)
+  - `src/extension/modules/core/` — módulo Core (base classes, logger, messaging, view)
+  - `src/cli/` — CLI con 3 comandos (init, create, mcp)
+  - `src/infrastructure/` — utilidades de migración y mapping
+  - `src/runtime/` — MCP server runtime
+
+- **Componentes existentes**
+  - **app**: depende de core (4 imports directos con rutas relativas `../core/`)
+  - **core**: autónomo, sin dependencias a otros módulos internos
+  - **cli**: depende de infrastructure y runtime (rutas `../../infrastructure/`, `../../runtime/`)
+
+- **Nucleo / capas base**
+  - `tsconfig.json` único con `rootDir: ./src`, `outDir: ./dist`
+  - `tsconfig.build.json` excluye `src/extension/**` (solo compila cli/runtime/infra)
+  - Build: `tsc -p ./` para extensión, `tsc -p tsconfig.build.json` para npm package
+
+- **Limitaciones detectadas**
+  - `cli` importa `infrastructure` y `runtime` que NO serán workspaces — rutas relativas deben mantenerse o necesitan otro enfoque
+  - `extension.ts` vive fuera de modules y es el entry point de VSCode
+  - El output `dist/extension/extension.js` debe mantenerse para que VSCode funcione
+
+---
+
+## 3. Cobertura de Acceptance Criteria
+
+### AC-1: Tests e2e pasan idénticamente
+- **Interpretación**: `npm run test:e2e` (Playwright) debe producir el mismo resultado antes y después
+- **Verificación**: Ejecutar `npx playwright test` antes y después de la migración
+- **Riesgos**: Si la ruta de resolución de módulos cambia, la extensión podría no compilar
+
+### AC-2: `npm install` instala todos los workspaces
+- **Interpretación**: Un solo `npm install` en root resuelve deps de app, core y cli
+- **Verificación**: `npm install && npm ls --ws`
+- **Riesgos**: Versiones conflictivas de la misma dependencia entre packages
+
+### AC-3: `npm run compile` compila todos los workspaces
+- **Interpretación**: El comando root debe compilar TypeScript de todos los packages
+- **Verificación**: `npm run compile` debe exit 0
+- **Riesgos**: `tsconfig.json` actual asume `rootDir: ./src` — necesita ajuste
+
+### AC-4: Cada package tiene `package.json` con `"private": true`
+- **Interpretación**: Crear 3 package.json independientes
+- **Verificación**: Verificar existencia y contenido de cada archivo
+- **Riesgos**: Bajo
+
+### AC-5: Root `package.json` contiene `"workspaces"`
+- **Interpretación**: Configurar el campo `workspaces` apuntando a los 3 packages
+- **Verificación**: Verificar campo en package.json
+- **Riesgos**: Bajo
+
+### AC-6: Dependencias inter-package vía `workspace:*`
+- **Interpretación**: app debe declarar `"@agentic-workflow/core": "workspace:*"` en sus deps
+- **Verificación**: `npm ls @agentic-workflow/core`
+- **Riesgos**: Las rutas relativas de import en TypeScript deben cambiar de `../core/` a `@agentic-workflow/core`
+
+### AC-7: Extensión VSCode funciona tras migración
+- **Interpretación**: `npm run compile` + F5 Launch Extension funciona
+- **Verificación**: Tests e2e (gate principal)
+- **Riesgos**: El entry point `dist/extension/extension.js` debe seguir existiendo en la misma ruta
+
+---
+
+## 4. Research técnico — Alternativas
+
+- **Alternativa A: npm workspaces sin TypeScript project references**
+  - Cada package tiene `package.json` pero comparten un `tsconfig.json` root
+  - Los imports cambian de rutas relativas a package names (`@agentic-workflow/core`)
+  - TypeScript resuelve vía `node_modules` symlinks creados por npm workspaces
+  - Ventajas: Más simple, menos configuración TypeScript
+  - Inconvenientes: Sin compilación incremental, un tsconfig
+
+- **Alternativa B: npm workspaces + TypeScript project references**
+  - Cada package tiene `package.json` Y `tsconfig.json` propio con `composite: true`
+  - Root tsconfig usa `references` para compilar en orden
+  - Ventajas: Compilación incremental, mejor aislamiento de tipos
+  - Inconvenientes: Mayor complejidad de configuración, cada package necesita `declaration: true`
+
+**Decisión recomendada**: **Alternativa A** (npm workspaces sin TS project references), por minimizar cambios y riesgos. La Alternativa B se puede adoptar incrementalmente después.
+
+---
+
+## 5. Agentes participantes
+
+- **🏛️ architect-agent**
+  - Diseño de la estructura de workspaces
+  - Configuración de package.json files
+  - Actualización de tsconfig
+  - Actualización de import paths
+
+- **🛡️ qa-agent**
+  - Verificación de tests e2e
+  - Validación de que compile funciona
+
+**Handoffs**
+- architect implementa → qa verifica con tests e2e
+
+**Componentes necesarios**
+- **Crear**: 3 `package.json` (app, core, cli)
+- **Modificar**: Root `package.json`, `tsconfig.json`, imports en app (de relativo a package name)
+- **Eliminar**: Ninguno
+
+**Demo**: No aplica.
+
+---
+
+## 6. Impacto de la tarea
+
+- **Arquitectura**: Se añaden 3 packages internos al monorepo. No cambia la estructura de carpetas.
+- **APIs / contratos**: Los exports de cada package se definen en su `package.json`. Las interfaces TS no cambian.
+- **Compatibilidad**: Los imports cambian de `../core/` a `@agentic-workflow/core`. Es un breaking change interno pero no afecta APIs externas.
+- **Testing**: Los tests e2e son el gate. Los unit tests de app necesitarán ajustar imports.
+
+---
+
+## 7. Riesgos y mitigaciones
+
+| Riesgo | Impacto | Mitigación |
+|--------|---------|------------|
+| `cli` importa `infrastructure` y `runtime` con rutas relativas — no son workspaces | Medio | Mantener rutas relativas en cli (no cambiar lo que no es workspace) |
+| `tsconfig.json` rootDir/outDir debe ajustarse para workspaces | Alto | Mantener tsconfig root, los packages heredan o aplican paths |
+| Ruta `dist/extension/extension.js` debe existir para VSCode | Alto | Asegurar que compile produce output en la misma ubicación |
+| Symlinks de npm workspaces pueden causar issues en VSCode bundling | Medio | Verificar con test e2e completo |
+
+---
+
+## 8. Preguntas abiertas
+Ninguna tras Fase 0.
+
+---
+
+## 9. TODO Backlog
+
+**Referencia**: `.agent/todo/`
+**Estado actual**: No existe directorio todo
+**Items relevantes para esta tarea**: Ninguno
+**Impacto en el análisis**: Sin impacto
+
+---
+
+## 10. Aprobación
+Este análisis **requiere aprobación explícita del desarrollador**.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: "2026-02-16T07:39:57+01:00"
+    comments: null
+```
+
+> Sin aprobación, esta fase **NO puede darse por completada** ni avanzar a Phase 3.

package/dist/agent/artifacts/12-npm-workspaces/plan.md

@@ -0,0 +1,237 @@
+🏛️ **architect-agent**: Plan de implementación para T012 — Migración a npm workspaces.
+
+---
+artifact: plan
+phase: phase-3-planning
+owner: architect-agent
+status: draft
+related_task: 12-npm-workspaces
+---
+
+# Implementation Plan — 12-npm-workspaces
+
+## 1. Resumen del plan
+- **Contexto**: Convertir los módulos app, core y cli en packages npm privados dentro de un monorepo con npm workspaces.
+- **Resultado esperado**: Proyecto configurado como npm workspaces con 3 packages independientes, build unificado funcional y tests e2e pasando.
+- **Alcance**:
+  - **Incluye**: Crear 3 `package.json`, configurar workspaces en root, actualizar imports de app→core a package name, ajustar tsconfig
+  - **Excluye**: TypeScript project references (se puede adoptar después), cambio de rutas en cli (mantiene relativas a infrastructure/runtime)
+
+---
+
+## 2. Inputs contractuales
+- **Task**: `.agent/artifacts/12-npm-workspaces/task.md`
+- **Analysis**: `.agent/artifacts/12-npm-workspaces/analysis.md`
+- **Acceptance Criteria**: AC-1 a AC-7 (tests e2e como gate principal)
+
+```yaml
+plan:
+  workflows:
+    - domain: extension-modules
+      action: refactor
+      workflow: tasklifecycle-long
+
+  dispatch:
+    - domain: core-package
+      action: create
+      workflow: tasklifecycle-long
+    - domain: app-package
+      action: refactor
+      workflow: tasklifecycle-long
+    - domain: cli-package
+      action: create
+      workflow: tasklifecycle-long
+    - domain: root-config
+      action: refactor
+      workflow: tasklifecycle-long
+```
+
+---
+
+## 3. Desglose de implementación (pasos)
+
+### Paso 1: Crear `package.json` para `@agentic-workflow/core`
+- **Descripción**: Crear `src/extension/modules/core/package.json` con nombre `@agentic-workflow/core`, `private: true`, y las dependencias que usa core (`vscode` como peer, `@fastify/cors`, `fastify` si aplica)
+- **Dependencias**: Ninguna
+- **Entregables**: `src/extension/modules/core/package.json`
+- **Agente responsable**: architect-agent
+
+### Paso 2: Crear `package.json` para `@agentic-workflow/app`
+- **Descripción**: Crear `src/extension/modules/app/package.json` con nombre `@agentic-workflow/app`, `private: true`, dependencia a `@agentic-workflow/core` via `workspace:*`, y sus propias deps
+- **Dependencias**: Paso 1 (core package existe)
+- **Entregables**: `src/extension/modules/app/package.json`
+- **Agente responsable**: architect-agent
+
+### Paso 3: Crear `package.json` para `@agentic-workflow/cli`
+- **Descripción**: Crear `src/cli/package.json` con nombre `@agentic-workflow/cli`, `private: true`, y sus dependencias de CLI (`commander`, `@clack/prompts`)
+- **Dependencias**: Ninguna
+- **Entregables**: `src/cli/package.json`
+- **Agente responsable**: architect-agent
+
+### Paso 4: Configurar workspaces en root `package.json`
+- **Descripción**: Añadir campo `"workspaces"` al root `package.json` apuntando a los 3 packages. Mover dependencias exclusivas de cada package a sus respectivos `package.json`
+- **Dependencias**: Pasos 1-3
+- **Entregables**: Root `package.json` actualizado
+- **Agente responsable**: architect-agent
+
+### Paso 5: Actualizar imports en `app` (de relativos a package name)
+- **Descripción**: Cambiar todos los imports de `../core/...` y `../../core/...` en app a `@agentic-workflow/core`. Archivos afectados:
+  - `app/index.ts`: `'../core/index.js'` → `'@agentic-workflow/core'`
+  - `app/backend/index.ts`: `'../../core/backend/index.js'` → `'@agentic-workflow/core/backend'` o `'@agentic-workflow/core'`
+  - `app/background/index.ts`: `'../../core/index.js'` → `'@agentic-workflow/core'`
+  - `app/view/index.ts`: `'../../core/view/index.js'` → `'@agentic-workflow/core'`
+  - `app/test/unit/background.test.ts`: imports de core → package name
+- **Dependencias**: Paso 4
+- **Entregables**: Imports actualizados en 5 archivos
+- **Agente responsable**: architect-agent
+
+### Paso 6: Configurar exports en core `package.json`
+- **Descripción**: Definir `"exports"` en core package.json para exponer los submodules necesarios (backend, view, messaging, etc.) via subpath exports
+- **Dependencias**: Paso 5 (saber qué subpaths se necesitan)
+- **Entregables**: `src/extension/modules/core/package.json` con exports map
+- **Agente responsable**: architect-agent
+
+### Paso 7: Ejecutar `npm install` y verificar symlinks
+- **Descripción**: Ejecutar `npm install` desde root para que npm cree los symlinks de workspace. Verificar que `node_modules/@agentic-workflow/core` y `@agentic-workflow/app` existen
+- **Dependencias**: Paso 6
+- **Entregables**: `npm install` exitoso
+- **Agente responsable**: architect-agent
+
+### Paso 8: Verificar compilación
+- **Descripción**: Ejecutar `npm run compile` y solucionar errores TypeScript si los hay
+- **Dependencias**: Paso 7
+- **Entregables**: Build exitoso
+- **Agente responsable**: architect-agent
+
+### Paso 9: Ejecutar tests e2e
+- **Descripción**: Ejecutar `npm run test:e2e` (Playwright) y verificar que pasan
+- **Dependencias**: Paso 8
+- **Entregables**: Tests e2e passing
+- **Agente responsable**: qa-agent
+
+---
+
+## 4. Asignación de responsabilidades (Agentes)
+
+- **🏛️ architect-agent**
+  - Crear package.json files (Pasos 1-4)
+  - Actualizar imports y exports (Pasos 5-6)
+  - Configurar y verificar build (Pasos 7-8)
+
+- **🛡️ qa-agent**
+  - Ejecutar y verificar tests e2e (Paso 9)
+  - Validar todos los AC
+
+**Handoffs**
+- architect-agent → qa-agent: al completar Paso 8 (build exitoso)
+
+**Componentes**
+- **Crear**: 3 `package.json` (core, app, cli) — herramienta: editor de archivos
+- **Modificar**: Root `package.json`, imports en app (5 archivos) — herramienta: editor de archivos
+- **Eliminar**: Ninguno
+
+**Demo**: No aplica.
+
+---
+
+## 5. Estrategia de testing y validación
+
+- **E2E (Gate principal)**
+  - Comando: `npx playwright test`
+  - Cobertura: Extensión VSCode se activa, módulos se registran, UI funciona
+  - Trazabilidad: AC-1
+
+- **Unit tests**
+  - Comando: `npm run test:unit`
+  - Cobertura: `background.test.ts` — verificar que imports de core funcionan con package name
+  - Trazabilidad: AC-3, AC-6
+
+- **Build verification**
+  - Comando: `npm run compile`
+  - Cobertura: TypeScript compila sin errores
+  - Trazabilidad: AC-3
+
+- **Workspace verification**
+  - Comando: `npm ls --ws`
+  - Cobertura: Todos los workspaces resueltos correctamente
+  - Trazabilidad: AC-2, AC-5
+
+**Trazabilidad AC → Tests**:
+| AC | Test |
+|----|------|
+| AC-1: Tests e2e pasan | `npx playwright test` |
+| AC-2: npm install funciona | `npm install && npm ls --ws` |
+| AC-3: compile funciona | `npm run compile` |
+| AC-4: package.json con private | Verificación manual de archivos |
+| AC-5: workspaces configurado | `cat package.json \| grep workspaces` |
+| AC-6: deps via workspace:* | `npm ls @agentic-workflow/core` |
+| AC-7: VSCode funciona | `npx playwright test` (e2e) |
+
+---
+
+## 6. Plan de demo
+No aplica (cambio de infraestructura sin impacto visible en UI).
+
+---
+
+## 7. Estimaciones y pesos de implementación
+
+| Paso | Esfuerzo | Notas |
+|------|----------|-------|
+| 1-3: Crear package.json | Bajo | Archivos nuevos simples |
+| 4: Configurar root workspaces | Bajo | Un campo en package.json |
+| 5: Actualizar imports | Medio | 5 archivos, requiere cuidado |
+| 6: Configurar exports | Medio | Subpath exports pueden ser complejos |
+| 7: npm install | Bajo | Verificación |
+| 8: Verificar compilación | Medio | Posibles errores de resolución |
+| 9: Tests e2e | Bajo | Ejecución y validación |
+
+**Suposiciones**: La estructura de carpetas no cambia. Los outputs de compilación deben mantenerse en las mismas rutas.
+
+---
+
+## 8. Puntos críticos y resolución
+
+- **Punto crítico 1: Resolución de módulos TypeScript**
+  - Riesgo: TypeScript puede no resolver `@agentic-workflow/core` sin TS project references
+  - Impacto: Alto — build falla
+  - Estrategia: npm workspaces crea symlinks en `node_modules/`, TypeScript con `moduleResolution: NodeNext` los resuelve. Si falla, añadir `paths` en tsconfig.
+
+- **Punto crítico 2: Output path de extensión VSCode**
+  - Riesgo: El `dist/extension/extension.js` podría generarse en otra ruta
+  - Impacto: Alto — extensión no arranca
+  - Estrategia: Mantener `rootDir: ./src` y `outDir: ./dist` en el tsconfig root. No crear tsconfig por package.
+
+- **Punto crítico 3: Imports de subpaths en core**
+  - Riesgo: app importa de `core/backend/index.js` directamente — requiere subpath exports
+  - Impacto: Medio — imports específicos fallan
+  - Estrategia: Configurar `"exports"` en core package.json para cada subpath usado, o consolidar re-exports en core/index.ts.
+
+---
+
+## 9. Dependencias y compatibilidad
+- **Dependencias internas**: app → core (workspace:*), cli → infrastructure/runtime (rutas relativas, sin cambio)
+- **Dependencias externas**: npm 9+, Node 20+, TypeScript 5.9.3 — todas compatibles
+- **Restricciones arquitectónicas**: Entry point VSCode (`main` en root package.json) debe apuntar a `./dist/extension/extension.js`
+
+---
+
+## 10. Criterios de finalización
+- [ ] `npm install` exitoso desde root
+- [ ] `npm run compile` exitoso
+- [ ] `npx playwright test` pasa idénticamente
+- [ ] 3 package.json creados con `"private": true`
+- [ ] Root package.json tiene `"workspaces"` configurado
+- [ ] Imports de app→core usan `@agentic-workflow/core`
+
+---
+
+## 11. Aprobación del desarrollador (OBLIGATORIA)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: "2026-02-16T07:42:30+01:00"
+    comments: null
+```