context-first-cli 1.8.2 → 2.0.0

package/dist/templates/commands/es/quality/observe.md

@@ -0,0 +1,168 @@
+# Observabilidad de Decisiones
+
+Este comando registra decisiones importantes tomadas durante el desarrollo, creando un registro auditable para explicabilidad y trazabilidad.
+
+## 🎯 Objetivo
+
+Crear un registro estructurado de decisiones técnicas y de producto, garantizando:
+- **Explicabilidad**: Por qué se tomó cada decisión
+- **Trazabilidad**: Qué fuentes (PRD, metaspecs, ADRs) fundamentaron la decisión
+- **Auditoría**: Historial completo de elecciones para revisión futura
+- **Aprendizaje**: Documentación de trade-offs y alternativas consideradas
+
+**IMPORTANTE**: Este comando NO genera decisiones nuevas. Solo REGISTRA decisiones que ya fueron tomadas en el proceso de desarrollo.
+
+## 📋 Requisitos previos
+
+- Haber ejecutado al menos uno de los comandos que generan decisiones:
+  - `/spec` - genera PRD con decisiones de producto
+  - `/plan` - genera plan.md con decisiones técnicas
+  - `/work` - implementación genera decisiones durante el desarrollo
+
+## 🔍 Proceso de Observación
+
+### 1. Identificar Decisiones Relevantes
+
+Analice los archivos de la sesión (`./.sessions/<ISSUE-ID>/`) para identificar decisiones:
+
+**Después de `/spec`** - Decisiones de Producto:
+- Lea `./.sessions/<ISSUE-ID>/prd.md`
+- Identifique decisiones en:
+  - Alcance (qué entra/no entra en la feature)
+  - Personas atendidas (quién es el público objetivo)
+  - Métricas de éxito (cómo medir resultados)
+  - Requisitos no funcionales (performance, accesibilidad)
+  - Restricciones y trade-offs
+
+**Después de `/plan`** - Decisiones Técnicas:
+- Lea `./.sessions/<ISSUE-ID>/plan.md`
+- Identifique decisiones en:
+  - Arquitectura de componentes/módulos
+  - Elección de bibliotecas o herramientas
+  - Patrones de implementación
+  - Estructura de datos
+  - Estrategia de tests
+
+**Durante `/work`** - Decisiones de Implementación:
+- Lea `./.sessions/<ISSUE-ID>/work.md`
+- Identifique decisiones en:
+  - Refactorizaciones realizadas
+  - Cambios de enfoque
+  - Optimizaciones aplicadas
+  - Tratamiento de edge cases
+
+### 2. Documentar Cada Decisión
+
+Para cada decisión identificada, documente:
+
+```markdown
+## Decisión: [Título Claro]
+
+**Contexto**: [¿Por qué necesitamos decidir esto? ¿Cuál es el problema o necesidad?]
+
+**Opciones Consideradas**:
+1. **Opción A**: [Descripción]
+   - Pros: [ventajas]
+   - Contras: [desventajas]
+2. **Opción B**: [Descripción]
+   - Pros: [ventajas]
+   - Contras: [desventajas]
+
+**Decisión**: [Opción elegida]
+
+**Justificación**: [¿Por qué elegimos esta opción? ¿Qué criterios fueron más importantes?]
+
+**Fuentes**:
+- [PRD sección X]
+- [Metaspec Y]
+- [ADR-00Z]
+
+**Trade-offs Aceptados**: [¿Qué desventajas aceptamos conscientemente?]
+
+**Reversibilidad**: Fácil / Media / Difícil
+
+**Fecha**: [fecha de la decisión]
+```
+
+### 3. Crear Registro de Decisiones
+
+Guarde en `./.sessions/<ISSUE-ID>/decisions.md`:
+
+```markdown
+# Registro de Decisiones - [ISSUE-ID]
+
+## Resumen
+[Breve resumen de las principales decisiones tomadas en esta feature]
+
+## Decisiones de Producto
+
+### [Decisión 1]
+[Según plantilla arriba]
+
+### [Decisión 2]
+[Según plantilla arriba]
+
+## Decisiones Técnicas
+
+### [Decisión 3]
+[Según plantilla arriba]
+
+### [Decisión 4]
+[Según plantilla arriba]
+
+## Decisiones de Implementación
+
+### [Decisión 5]
+[Según plantilla arriba]
+
+## Lecciones Aprendidas
+- [Lección 1]
+- [Lección 2]
+
+## Decisiones Pendientes
+- [Decisión que aún necesita ser tomada]
+```
+
+## 📊 Análisis de Impacto
+
+Para decisiones críticas, documente el impacto:
+
+```markdown
+## Análisis de Impacto
+
+**Repositorios Afectados**: [lista]
+
+**Componentes Impactados**: [lista]
+
+**Dependencias Creadas**: [lista]
+
+**Riesgos Introducidos**: [lista]
+
+**Mitigaciones Aplicadas**: [lista]
+```
+
+## 🔄 Revisión de Decisiones
+
+Periódicamente, revise las decisiones tomadas:
+- ¿Siguen teniendo sentido?
+- ¿Los trade-offs se demostraron correctos?
+- ¿Hay aprendizajes para documentar?
+- ¿Alguna decisión necesita ser revertida?
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Resultado
+
+Después de ejecutar este comando, tendrá:
+- Registro completo de decisiones en `./.sessions/<ISSUE-ID>/decisions.md`
+- Trazabilidad de cada elección realizada
+- Documentación para futuras referencias
+- Base para ADRs (si las decisiones son de arquitectura)

package/dist/templates/commands/es/warm-up.md

@@ -0,0 +1,78 @@
+# Calentamiento - Carga de Contexto
+
+Este comando prepara el entorno cargando el contexto completo del proyecto y del workspace actual.
+
+## 1. Identificar Workspace Actual
+
+Verifique si está dentro de un workspace creado por `context-cli`:
+
+```bash
+# Verificar si está en un directorio de workspace
+pwd
+# El workspace generalmente está en ~/workspaces/<ISSUE-ID>/
+```
+
+Si no está en un workspace, pregunte al usuario qué workspace usar o si debe crear uno nuevo con `feature:start`.
+
+## 2. Cargar Configuración del Proyecto
+
+Identifique el orchestrator del proyecto:
+
+1. **Busque el archivo `.contextrc.json`** en cualquiera de los repositorios del workspace
+2. Este archivo contiene la URL del repositorio orchestrator
+3. Si el orchestrator aún no está clonado localmente, clónelo
+
+## 3. Cargar Manifiesto del Proyecto
+
+Lea el `context-manifest.json` del orchestrator para entender:
+- Lista completa de repositorios del ecosistema
+- URL del repositorio de MetaSpecs
+- Dependencias entre repositorios
+- Roles de cada repositorio (application, library, service, specs-provider)
+
+## 4. Cargar MetaSpecs
+
+El repositorio de MetaSpecs está definido en `context-manifest.json` (generalmente con `role: "specs-provider"`).
+
+**Lea siempre los archivos de índice primero:**
+
+1. **`README.md`** - Visión general del proyecto y estructura de documentación
+2. **`index.md`** (en la raíz o en subcarpetas) - Índice de especificaciones disponibles
+
+**Use los índices como referencia** para navegar hasta las especificaciones específicas que necesita. No asuma que archivos específicos existen - siempre consulte los índices primero.
+
+## 5. Cargar Sesión Actual (si existe)
+
+Verifique si existe una sesión guardada para este workspace:
+
+```bash
+# Buscar sesión en orchestrator
+ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
+```
+
+Si existe, lea los archivos de sesión para recuperar el contexto de la última ejecución.
+
+## 6. Contexto de los Repositorios
+
+Para cada repositorio presente en el workspace, lea:
+- `README.md` - Propósito y visión general del repositorio
+- Archivo de configuración principal (`package.json`, `pom.xml`, `requirements.txt`, etc.)
+
+## 7. Navegación Inteligente
+
+- **Código**: Use herramientas de búsqueda (glob, grep) para localizar archivos relevantes
+- **Documentación**: Use los índices de MetaSpecs como referencia
+- **Espere Instrucciones**: NO lea otros archivos ahora. Espere el próximo comando.
+
+## 8. Principio Jidoka (Parar al Detectar Problemas)
+
+Si detecta desalineamiento, conflictos o problemas:
+1. 🛑 **PARE** inmediatamente
+2. 📝 **DOCUMENTE** el problema encontrado
+3. 💬 **ALERTE** al usuario antes de proceder
+
+---
+
+**Argumentos proporcionados**: #$ARGUMENTS
+
+**Estado**: Contexto cargado. Esperando próximo comando.

package/dist/utils/config.d.ts

@@ -21,6 +21,7 @@ export interface Repository {
 export interface WorkspaceMetadata {
     issueId: string;
     repositories: string[];
+    language?: string;
     createdAt: string;
     lastUpdated: string;
     status: 'active' | 'archived';

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ3F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAgB/H;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQ5F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQpG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7G;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAGpD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ3F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAgB/H;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQ5F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQpG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7G;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAGpD"}

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-first-cli",
-  "version": "1.8.2",
+  "version": "2.0.0",
   "description": "A generic CLI to manage the Context-First development methodology across any project.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/commands/en/engineer/plan.md

@@ -0,0 +1,297 @@
+# Technical Planning
+
+This command creates the detailed technical plan for feature implementation.
+
+## 📋 Prerequisites
+
+- PRD created via `/spec`
+- Initial analysis done via `/start`
+- Files `context.md` and `architecture.md` created and approved
+
+## 📍 IMPORTANT: Understand the Structure
+
+**Workspace**:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/
+├── repo-1/          # worktree (will be used in /work)
+├── repo-2/          # worktree (will be used in /work)
+├── context.md       # context (immutable - READ)
+├── architecture.md  # architecture (immutable - READ)
+└── plan.md          # plan (mutable - CREATE)
+```
+
+**Main repositories** (read-only):
+```
+{base_path}/repo-1/  # main repo (branch main/master)
+{base_path}/repo-2/  # main repo (branch main/master)
+```
+
+**GOLDEN RULE**:
+- ✅ Read `context.md` and `architecture.md` (immutable)
+- ✅ Create `plan.md` in `.sessions/<ISSUE-ID>/`
+- ✅ Read code from main repositories (read-only)
+- ❌ NEVER checkout main repositories
+- ❌ NEVER modify `context.md` or `architecture.md`
+
+## ⚠️ IMPORTANT: Immutable Files
+
+**This command must READ but NOT MODIFY:**
+- ✅ **READ** `.sessions/<ISSUE-ID>/context.md` (immutable)
+- ✅ **READ** `.sessions/<ISSUE-ID>/architecture.md` (immutable)
+- ✅ **CREATE** `.sessions/<ISSUE-ID>/plan.md` (mutable - will be updated during `/work`)
+- ❌ **DO NOT modify `context.md` or `architecture.md`**
+
+## 📚 Load MetaSpecs
+
+**Automatically locate MetaSpecs**:
+1. Read `context-manifest.json` from the orchestrator
+2. Find the repository with `"role": "metaspecs"`
+3. Read `ai.properties.md` to obtain the `base_path`
+4. The metaspecs are located at: `{base_path}/{metaspecs-repo-id}/`
+5. Read the relevant `index.md` files to ensure compliance with:
+   - System architecture
+   - Design and code standards
+   - Folder and file structure
+   - Naming conventions
+
+## 🎯 Objective
+
+Create a detailed technical plan that will guide the implementation, breaking the work into smaller, sequential units.
+
+## 📝 Plan Structure
+
+### 1. Technical Overview
+
+```markdown
+# Technical Plan - [Feature Title]
+
+## Summary
+[Brief technical description of what will be implemented]
+
+## Involved Repositories
+- **<repo-1>**: [Role in this feature]
+- **<repo-2>**: [Role in this feature]
+
+## Technical Approach
+[General implementation strategy]
+```
+
+### 2. Solution Architecture
+
+```markdown
+## Architecture
+
+### Component Diagram
+[Textual description or ASCII art of components and their relationships]
+
+### Data Flow
+1. [Step 1 of the flow]
+2. [Step 2 of the flow]
+3. [Step 3 of the flow]
+
+### Integrations
+- **<repo-1> → <repo-2>**: [How they communicate]
+- **System → External API**: [If any]
+```
+
+### 3. Technical Decisions
+
+```markdown
+## Technical Decisions
+
+### Decision 1: [Title]
+**Context**: [Why we need to decide this]
+**Considered options**:
+- Option A: [Pros and cons]
+- Option B: [Pros and cons]
+**Decision**: [Chosen option]
+**Justification**: [Why we chose this option]
+
+### Decision 2: [Title]
+[Same format as above]
+```
+
+### 4. Implementation Plan
+
+Break down the work into small, sequential units:
+
+```markdown
+## Implementation Plan
+
+### Phase 1: [Phase Name]
+**Objective**: [What will be achieved in this phase]
+**Repositories**: [affected repos]
+
+#### Task 1.1: [Description]
+- **Repo**: <repo-1>
+- **Files**: [files to create/modify]
+- **Description**: [What to do]
+- **Tests**: [Tests to implement]
+- **Estimate**: [estimated time]
+
+#### Task 1.2: [Description]
+- **Repo**: <repo-2>
+- **Files**: [files to create/modify]
+- **Description**: [What to do]
+- **Tests**: [Tests to implement]
+- **Estimate**: [estimated time]
+
+### Phase 2: [Phase Name]
+[Same format as above]
+
+### Phase 3: [Phase Name]
+[Same format as above]
+```
+
+### 5. File Structure
+
+For each repository, define the structure:
+
+```markdown
+## File Structure
+
+### <repo-1>
+```
+src/
+├── components/
+│   ├── NewComponent.tsx (CREATE)
+│   └── ExistingComponent.tsx (MODIFY)
+├── services/
+│   └── NewService.ts (CREATE)
+└── tests/
+    └── NewComponent.test.tsx (CREATE)
+```
+
+### <repo-2>
+```
+src/
+├── controllers/
+│   └── NewController.ts (CREATE)
+└── tests/
+    └── NewController.test.ts (CREATE)
+```
+```
+
+### 6. APIs and Contracts
+
+```markdown
+## APIs and Contracts
+
+### New Endpoints
+
+#### POST /api/resource
+**Request**:
+```json
+{
+  "field1": "string",
+  "field2": "number"
+}
+```
+
+**Response**:
+```json
+{
+  "id": "string",
+  "status": "string"
+}
+```
+
+### Modified Endpoints
+
+#### GET /api/resource/:id
+**Changes**: [What changes]
+**Breaking Change**: Yes / No
+```
+
+### 7. Testing Strategy
+
+```markdown
+## Testing Strategy
+
+### Unit Tests
+- **<repo-1>**: [Components/functions to test]
+- **<repo-2>**: [Components/functions to test]
+
+### Integration Tests
+- **Scenario 1**: [Description and involved repos]
+- **Scenario 2**: [Description and involved repos]
+
+### E2E Tests (if applicable)
+- **Flow 1**: [Description]
+- **Flow 2**: [Description]
+```
+
+### 8. Technical Risks
+
+```markdown
+## Technical Risks
+
+### Risk 1: [Description]
+- **Impact**: High / Medium / Low
+- **Probability**: High / Medium / Low
+- **Mitigation**: [How to mitigate]
+- **Plan B**: [Alternative if it occurs]
+
+### Risk 2: [Description]
+[Same format as above]
+```
+
+### 9. Implementation Checklist
+
+```markdown
+## Implementation Checklist
+
+### Phase 1
+- [ ] Task 1.1
+- [ ] Task 1.2
+- [ ] Phase 1 Tests
+
+### Phase 2
+- [ ] Task 2.1
+- [ ] Task 2.2
+- [ ] Phase 2 Tests
+
+### Phase 3
+- [ ] Task 3.1
+- [ ] Task 3.2
+- [ ] Phase 3 Tests
+
+### Finalization
+- [ ] Documentation updated
+- [ ] Code review
+- [ ] Integration tests
+- [ ] PR created
+```
+
+## 📄 Saving the Plan
+
+Save in `./.sessions/<ISSUE-ID>/plan.md`
+
+## 🔍 Review
+
+Review the plan checking:
+- All tasks are clear and executable
+- Dependencies between tasks are identified
+- Estimates are realistic
+- Risks have been considered
+- Testing strategy is adequate
+
+---
+
+**Provided arguments**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Next Step
+
+After plan approval:
+
+```bash
+/work
+```
+
+This command will start executing the first work unit of the plan.