@cristiancorreau/forge 2.1.0 → 2.3.0

package/dist/lib/generators/claude-code.js

@@ -0,0 +1,140 @@
+const AGENT_TRIGGER = {
+    'orchestrator': ['tareas multi-agente, análisis de >3 archivos, descomposición de features completas', null],
+    'backend-engineer': ['endpoints, middleware, validaciones, lógica de negocio', 'api'],
+    'api-engineer': ['endpoints REST, middleware, validaciones, migraciones de BD', 'api'],
+    'frontend-engineer': ['componentes UI, páginas, estilos, integración con API', 'frontend'],
+    'admin-engineer': ['UI de gestión interna, dashboards de admin', 'admin'],
+    'mobile-engineer': ['pantallas móviles, navegación, stores de estado', 'mobile'],
+    'fullstack-engineer': ['features full-stack end-to-end que abarcan backend y frontend', null],
+    'test-engineer': ['tests unitarios, integración, E2E — nunca código de producción', 'tests'],
+    'docs-writer': ['specs, ADRs, READMEs, documentación — nunca código de producción', 'specs'],
+    'compliance-reviewer': ['revisión de PRs con PII, consentimientos, logs de auditoría', null],
+    'security-auditor': ['auditoría de vulnerabilidades, revisión de dependencias, pentest', null],
+    'migration-specialist': ['migraciones de versión de framework (ej: L6→L13)', 'migrations'],
+    'wp-engineer': ['temas WordPress, FSE, Gutenberg, child themes', 'frontend'],
+    'divi-engineer': ['layouts Divi 5, módulos custom, Divi Builder', 'frontend'],
+    'elementor-engineer': ['templates Elementor Pro, widgets custom', 'frontend'],
+    'scanner-engineer': ['scraping, crawling, extracción estructurada de datos', 'scanner'],
+};
+function buildAgentScopeTable(agents, paths) {
+    const active = agents?.active ?? [];
+    const compliance = agents?.compliance ?? [];
+    const all = [...active, ...compliance];
+    if (all.length === 0)
+        return '';
+    const rows = all.map(agent => {
+        const [trigger, pathKey] = AGENT_TRIGGER[agent] ?? ['implementación', null];
+        const scope = pathKey && paths ? paths[pathKey] : undefined;
+        const scopeStr = scope ? `\`${scope}\`` : '`/`';
+        return `| \`${agent}\` | ${scopeStr} | ${trigger} |`;
+    });
+    return ('## Agentes y su scope\n\n' +
+        '| Agente | Scope | Cuándo usarlo |\n' +
+        '|--------|-------|---------------|\n' +
+        rows.join('\n') + '\n\n' +
+        '> Invocar el agente del scope correcto, no el orchestrator, para tareas acotadas.\n\n');
+}
+function renderPhases(config) {
+    const sprint = config.sprint ?? {};
+    const current = sprint.current ?? 1;
+    const phases = sprint.phases ?? [];
+    if (phases.length === 0) {
+        return `- **Sprint actual:** Sprint ${current}\n- **Completadas:** —\n- **En curso:** —\n- **Pendientes:** —`;
+    }
+    const lines = [`- **Sprint actual:** Sprint ${current}`];
+    for (const phase of phases) {
+        const specs = phase.specs ?? [];
+        const specList = specs.length > 0 ? specs.join(', ') : '—';
+        lines.push(`- **Fase ${phase.id} — ${phase.name}** (${phase.status ?? 'pendiente'}): ${specList}`);
+    }
+    return lines.join('\n');
+}
+function devCommands(language) {
+    switch (language) {
+        case 'typescript': return { dev: 'pnpm dev', test: 'pnpm test', lint: 'pnpm lint', build: 'pnpm build' };
+        case 'python': return { dev: 'uvicorn main:app --reload', test: 'pytest', lint: 'ruff check .', build: '# no aplica' };
+        case 'ruby': return { dev: 'rails server', test: 'bundle exec rspec', lint: 'rubocop', build: '# no aplica' };
+        case 'go': return { dev: 'go run ./cmd/...', test: 'go test ./...', lint: 'golangci-lint run', build: 'go build ./...' };
+        case 'php': return { dev: 'php artisan serve', test: './vendor/bin/pest', lint: 'vendor/bin/phpstan analyse', build: 'composer install --no-dev' };
+        default: return { dev: '# ver documentación', test: '# ver documentación', lint: '# ver documentación', build: '# ver documentación' };
+    }
+}
+export function generateClaudeMd(config) {
+    const proj = config.project;
+    const stack = config.stack ?? {};
+    const agents = config.agents ?? {};
+    const compliance = config.compliance ?? {};
+    const paths = config.paths;
+    const name = proj.name ?? 'Mi Proyecto';
+    const description = proj.description ?? '';
+    const language = proj.language ?? 'typescript';
+    const { dev, test, lint, build } = devCommands(language);
+    const specsPath = paths?.specs ?? 'docs/specs';
+    const progressPath = paths?.progress ?? 'docs/progress.html';
+    const agentScopeSection = buildAgentScopeTable(agents, paths);
+    const complianceSection = compliance.frameworks && compliance.frameworks.length > 0
+        ? `\n## Compliance activo\n\nEste proyecto opera bajo: ${compliance.frameworks.map(f => `**${f.toUpperCase()}**`).join(', ')}\n\nReglas no-negociables:\n- Sin datos personales en logs de stdout\n- Consentimiento explícito antes de cualquier tracker no esencial\n- Logs de auditoría append-only (sin UPDATE/DELETE)\n- Derechos del titular implementados (acceso, rectificación, supresión, portabilidad)\n`
+        : '';
+    return `# CLAUDE.md — ${name}
+
+> Generado por forge. Actualizar project.yaml para cambiar la configuración.
+
+## Misión del proyecto
+
+${description}
+
+## Stack
+
+- **Lenguaje**: ${language}
+- **Backend**: ${stack.backend ?? 'N/A'}
+- **Frontend**: ${stack.frontend ?? 'N/A'}
+- **Base de datos**: ${stack.database ?? 'N/A'}
+- **Testing**: ${(stack.testing ?? []).join(', ')}
+
+${agentScopeSection}## Estructura
+
+\`\`\`
+${proj.slug ?? 'proyecto'}/
+├── CLAUDE.md                    ← Estás acá
+├── AGENTS.md                    ← Convenciones del agent team
+├── project.yaml                 ← Config de forge (fuente de verdad)
+├── .claude/
+│   ├── agents/                  ← Agentes instalados
+│   ├── hooks/                   ← Hooks de guardrail (JS, sin Python)
+│   ├── commands/                ← Slash commands del flujo SDD
+│   └── architecture.rules       ← Convenciones de arquitectura del proyecto
+├── ${specsPath}/                ← Specs de features (requeridas antes de implementar)
+└── ${progressPath}              ← Dashboard de progreso
+\`\`\`
+
+## Cómo trabajar (SDD)
+
+1. **Identificá la spec.** Si no está en \`${specsPath}/\`, pará y pedí que se cree.
+2. **Leé la spec correspondiente.**
+3. **Proponé opciones** para decisiones no cubiertas por la spec.
+4. **Esperá aprobación** antes de generar código.
+5. **Tests** junto con la implementación, no al final.
+6. **Antes de cerrar**: \`${test}\`, \`${lint}\`.
+${complianceSection}
+## Phases activas y estado
+
+${renderPhases(config)}
+
+## Comandos frecuentes
+
+\`\`\`bash
+${dev}     # Desarrollo
+${test}    # Tests
+${lint}    # Lint
+${build}   # Build
+\`\`\`
+
+## Qué NO hacer
+
+- No implementar sin spec en \`${specsPath}/\`
+- No hardcodear tokens, passwords o secrets
+- No commits con \`console.log\` o \`print\` de depuración
+- No hacer force push a main/master
+`;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/lib/generators/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/lib/generators/claude-code.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA4C;IAC7D,cAAc,EAAS,CAAC,oFAAoF,EAAE,IAAI,CAAC;IACnH,kBAAkB,EAAK,CAAC,wDAAwD,EAAE,KAAK,CAAC;IACxF,cAAc,EAAS,CAAC,6DAA6D,EAAE,KAAK,CAAC;IAC7F,mBAAmB,EAAI,CAAC,uDAAuD,EAAE,UAAU,CAAC;IAC5F,gBAAgB,EAAO,CAAC,4CAA4C,EAAE,OAAO,CAAC;IAC9E,iBAAiB,EAAM,CAAC,iDAAiD,EAAE,QAAQ,CAAC;IACpF,oBAAoB,EAAG,CAAC,+DAA+D,EAAE,IAAI,CAAC;IAC9F,eAAe,EAAQ,CAAC,gEAAgE,EAAE,OAAO,CAAC;IAClG,aAAa,EAAU,CAAC,kEAAkE,EAAE,OAAO,CAAC;IACpG,qBAAqB,EAAE,CAAC,6DAA6D,EAAE,IAAI,CAAC;IAC5F,kBAAkB,EAAK,CAAC,kEAAkE,EAAE,IAAI,CAAC;IACjG,sBAAsB,EAAC,CAAC,kDAAkD,EAAE,YAAY,CAAC;IACzF,aAAa,EAAU,CAAC,+CAA+C,EAAE,UAAU,CAAC;IACpF,eAAe,EAAQ,CAAC,8CAA8C,EAAE,UAAU,CAAC;IACnF,oBAAoB,EAAG,CAAC,yCAAyC,EAAE,UAAU,CAAC;IAC9E,kBAAkB,EAAK,CAAC,sDAAsD,EAAE,SAAS,CAAC;CAC3F,CAAC;AAEF,SAAS,oBAAoB,CAAC,MAA6B,EAAE,KAA2B;IACtF,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC;IACvC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC3B,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAE,KAAgC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,OAAO,OAAO,KAAK,QAAQ,QAAQ,MAAM,OAAO,IAAI,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO,CACL,2BAA2B;QAC3B,sCAAsC;QACtC,sCAAsC;QACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM;QACxB,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAmB;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,+BAA+B,OAAO,gEAAgE,CAAC;IAChH,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,IAAI,WAAW,MAAM,QAAQ,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACzG,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QACvH,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC9G,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACzH,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;QACnJ,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IACzI,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC;IAC/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,KAAK,EAAE,KAAK,IAAI,YAAY,CAAC;IAC/C,MAAM,YAAY,GAAG,KAAK,EAAE,QAAQ,IAAI,oBAAoB,CAAC;IAE7D,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE9D,MAAM,iBAAiB,GAAG,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QACjF,CAAC,CAAC,uDAAuD,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uRAAuR;QACnZ,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,iBAAiB,IAAI;;;;;;EAM5B,WAAW;;;;kBAIK,QAAQ;iBACT,KAAK,CAAC,OAAO,IAAI,KAAK;kBACrB,KAAK,CAAC,QAAQ,IAAI,KAAK;uBAClB,KAAK,CAAC,QAAQ,IAAI,KAAK;iBAC7B,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAE/C,iBAAiB;;;EAGjB,IAAI,CAAC,IAAI,IAAI,UAAU;;;;;;;;;MASnB,SAAS;MACT,YAAY;;;;;6CAK2B,SAAS;;;;;4BAK1B,IAAI,SAAS,IAAI;EAC3C,iBAAiB;;;EAGjB,YAAY,CAAC,MAAM,CAAC;;;;;EAKpB,GAAG;EACH,IAAI;EACJ,IAAI;EACJ,KAAK;;;;;iCAK0B,SAAS;;;;CAIzC,CAAC;AACF,CAAC"}

package/dist/lib/generators/codex.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectYaml } from '../yaml.js';
+export declare function generateCodexAgentsMd(config: ProjectYaml): string;
+//# sourceMappingURL=codex.d.ts.map

package/dist/lib/generators/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/lib/generators/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsEjE"}

package/dist/lib/generators/codex.js

@@ -0,0 +1,69 @@
+export function generateCodexAgentsMd(config) {
+    const proj = config.project;
+    const stack = config.stack ?? {};
+    const agents = config.agents ?? {};
+    const name = proj.name ?? 'Mi Proyecto';
+    const language = proj.language ?? 'typescript';
+    const active = agents.active ?? [];
+    const compliance = agents.compliance ?? [];
+    const allAgents = [...active, ...compliance];
+    const agentList = allAgents.map(a => `- \`${a}\``).join('\n') || '- (ninguno declarado)';
+    return `# AGENTS.md — ${name}
+# Generado por forge v2 para Codex CLI
+
+## Proyecto
+
+- **Nombre**: ${name}
+- **Lenguaje**: ${language}
+- **Backend**: ${stack.backend ?? 'N/A'}
+- **Frontend**: ${stack.frontend ?? 'N/A'}
+
+## Agentes disponibles
+
+${agentList}
+
+## Workflow SDD (obligatorio)
+
+1. **SIEMPRE** leer la spec antes de escribir código
+2. Si no hay spec para la tarea: DETENER y pedir que se cree en docs/specs/
+3. Implementar SOLO lo que la spec aprueba
+4. Tests junto con la implementación, nunca al final
+5. Antes de terminar: correr typecheck + lint
+
+## Reglas de producción (BLOQUEADAS)
+
+Los siguientes comandos están PROHIBIDOS sin confirmación explícita del humano:
+
+\`\`\`
+--force-reset    # Borra datos irreversiblemente
+DROP TABLE       # Borra tabla completa
+TRUNCATE         # Vacía tabla
+rm -rf /         # Borra sistema
+git push --force # Sobreescribe historial remoto
+\`\`\`
+
+> Incidente 2026-04-28: --force-reset borró 225 usuarios en producción.
+> Estos comandos están bloqueados por el hook pre-bash-check.
+
+## Branch guard
+
+- Verificar rama: \`git branch --show-current\`
+- NUNCA editar directamente en main/master
+- Excepciones: CLAUDE.md, AGENTS.md, project.yaml, archivos .yaml/.json de configuración
+
+## Autonomy limits
+
+- No hacer deploy a producción sin smoke tests
+- No modificar migraciones de BD existentes
+- No borrar archivos sin verificar que no hay referencias
+
+## Comandos por tipo de tarea
+
+Ver plantillas en \`adapters/codex/commands/\`:
+- \`plan.md\` — crear/revisar spec
+- \`work.md\` — implementar feature
+- \`review.md\` — revisar diff
+- \`ship.md\` — deploy a producción
+`;
+}
+//# sourceMappingURL=codex.js.map

package/dist/lib/generators/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/lib/generators/codex.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAmB;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC;IAEzF,OAAO,iBAAiB,IAAI;;;;;gBAKd,IAAI;kBACF,QAAQ;iBACT,KAAK,CAAC,OAAO,IAAI,KAAK;kBACrB,KAAK,CAAC,QAAQ,IAAI,KAAK;;;;EAIvC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CV,CAAC;AACF,CAAC"}

package/dist/lib/generators/kiro.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectYaml } from '../yaml.js';
+export declare function generateKiroProduct(config: ProjectYaml): string;
+export declare function generateKiroStructure(config: ProjectYaml): string;
+export declare function generateKiroAgents(config: ProjectYaml): string;
+export declare function generateKiroCommands(): string;
+export declare function generateKiroBranchGuardHook(): string;
+//# sourceMappingURL=kiro.d.ts.map

package/dist/lib/generators/kiro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro.d.ts","sourceRoot":"","sources":["../../../src/lib/generators/kiro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsB/D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA+BjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqC9D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAiB7C;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAcpD"}

package/dist/lib/generators/kiro.js

@@ -0,0 +1,134 @@
+function devCommands(language) {
+    switch (language) {
+        case 'typescript': return { dev: 'pnpm dev', test: 'pnpm test', lint: 'pnpm lint' };
+        case 'python': return { dev: 'uvicorn main:app --reload', test: 'pytest', lint: 'ruff check .' };
+        case 'ruby': return { dev: 'rails server', test: 'bundle exec rspec', lint: 'rubocop' };
+        case 'go': return { dev: 'go run ./cmd/...', test: 'go test ./...', lint: 'golangci-lint run' };
+        case 'php': return { dev: 'php artisan serve', test: './vendor/bin/pest', lint: 'phpstan analyse' };
+        default: return { dev: '# ver docs', test: '# ver docs', lint: '# ver docs' };
+    }
+}
+export function generateKiroProduct(config) {
+    const proj = config.project;
+    const stack = config.stack ?? {};
+    return `# ${proj.name ?? 'Proyecto'} — Product Context
+
+## Overview
+
+${proj.description ?? ''}
+
+## Stack
+
+- Language: ${proj.language ?? 'N/A'}
+- Backend: ${stack.backend ?? 'N/A'}
+- Frontend: ${stack.frontend ?? 'N/A'}
+- Database: ${stack.database ?? 'N/A'}
+- ORM: ${stack.orm ?? 'N/A'}
+- Testing: ${(stack.testing ?? []).join(', ') || 'N/A'}
+
+## Status
+
+${proj.status ?? 'active'}
+`;
+}
+export function generateKiroStructure(config) {
+    const lang = config.project.language ?? 'typescript';
+    const { dev, test, lint } = devCommands(lang);
+    return `# Project Structure & Development Workflow
+
+## Forge v2 SDD Workflow
+
+Before every coding session:
+1. Run \`/session-start\` — verify branch, tools, env
+2. Read the spec for your task in \`docs/specs/\`
+3. Use \`/plan\` if no spec exists yet
+4. Use \`/work\` to implement once spec is approved
+5. Use \`/review\` before submitting
+6. Use \`/ship\` for production deploy
+7. Run \`/session-close\` to commit, create PR, write daily note
+
+## Commands
+
+\`\`\`bash
+${dev}   # Development
+${test}  # Tests
+${lint}  # Lint
+\`\`\`
+
+## Rules
+
+- Never implement without an approved spec
+- Never push directly to main/master
+- Never hardcode secrets or API keys
+- Tests alongside implementation, not after
+`;
+}
+export function generateKiroAgents(config) {
+    const agents = config.agents ?? {};
+    const active = agents.active ?? [];
+    const compliance = agents.compliance ?? [];
+    const allAgents = [...active, ...compliance];
+    const agentDescriptions = {
+        'orchestrator': 'Coordinates agents and decomposes complex tasks',
+        'backend-engineer': 'API, database, business logic',
+        'api-engineer': 'REST endpoints, middleware, validation',
+        'frontend-engineer': 'UI components, pages, API integration',
+        'admin-engineer': 'Admin dashboards and management UI',
+        'mobile-engineer': 'Mobile screens, navigation, state',
+        'fullstack-engineer': 'End-to-end full-stack features',
+        'test-engineer': 'Unit, integration, E2E tests (never production code)',
+        'docs-writer': 'Specs, ADRs, READMEs (never production code)',
+        'compliance-reviewer': 'PII handling, consent, audit logs review',
+        'security-auditor': 'Vulnerability auditing, dependency review',
+        'migration-specialist': 'Framework version migrations',
+    };
+    const rows = allAgents
+        .map(a => `| ${a} | ${agentDescriptions[a] ?? 'Specialized agent'} |`)
+        .join('\n');
+    return `# Agent Roster
+
+| Agent | Responsibility |
+|-------|----------------|
+${rows || '| — | No agents declared in project.yaml |'}
+
+## Usage
+
+- Use the specialized agent for each task
+- Use orchestrator only for multi-agent or complex tasks
+- Never ask the orchestrator to do work a specialized agent can handle
+`;
+}
+export function generateKiroCommands() {
+    return `# Forge v2 Commands Reference
+
+| Command | Description |
+|---------|-------------|
+| \`/session-start\` | Start session: verify branch, tools, repo state |
+| \`/plan\` | Create or review specs with Planner-Critic |
+| \`/work\` | Implement an approved spec |
+| \`/review\` | Multi-agent diff review |
+| \`/ship\` | Deploy pipeline: tests → build → Vercel |
+| \`/session-close\` | Close session: commit, PR, daily note |
+
+## Kiro Note
+
+Kiro does not support slash commands natively.
+Use these as prompts or reference them in your workflow.
+`;
+}
+export function generateKiroBranchGuardHook() {
+    return JSON.stringify({
+        name: 'forge-branch-guard',
+        description: 'Warn before editing files on main or master branch',
+        event: 'PreEdit',
+        condition: {
+            type: 'script',
+            script: 'git branch --show-current | grep -qE "^(main|master)$"'
+        },
+        action: {
+            type: 'warn',
+            message: 'You are on main/master. Create a feature branch before editing:\n  git checkout -b feat/description'
+        }
+    }, null, 2);
+}
+//# sourceMappingURL=kiro.js.map

package/dist/lib/generators/kiro.js.map

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

package/dist/lib/generators/opencode.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectYaml } from '../yaml.js';
+export declare function generateAgentsMd(config: ProjectYaml): string;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/lib/generators/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/lib/generators/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2D9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA4C5D"}

package/dist/lib/generators/opencode.js

@@ -0,0 +1,96 @@
+const AGENT_DESCRIPTIONS = {
+    'orchestrator': 'Coordina agentes y descompone tareas complejas',
+    'backend-engineer': 'API, base de datos, lógica de negocio',
+    'api-engineer': 'Endpoints REST, middleware, validaciones',
+    'frontend-engineer': 'UI, componentes, integración con API',
+    'admin-engineer': 'Interfaces de administración y dashboards',
+    'mobile-engineer': 'Pantallas móviles, navegación, estado',
+    'fullstack-engineer': 'Features full-stack de extremo a extremo',
+    'test-engineer': 'Tests unitarios, integración y E2E',
+    'docs-writer': 'Specs, ADRs, READMEs, documentación',
+    'compliance-reviewer': 'Revisión de PRs con PII y compliance regulatorio',
+    'security-auditor': 'Auditoría de vulnerabilidades y dependencias',
+    'migration-specialist': 'Migraciones de versión de framework',
+    'wp-engineer': 'Temas WordPress, FSE, Gutenberg',
+    'scanner-engineer': 'Scraping, crawling, extracción de datos',
+};
+function guardrailSection() {
+    return `## Guardrails de seguridad
+
+Las siguientes reglas aplican a TODOS los agentes sin excepción:
+
+### Branch guard
+- Verificar siempre la rama antes de hacer cambios: \`git branch --show-current\`
+- **NUNCA** hacer push directo a \`main\` o \`master\`
+- Si estás en main/master, crear una rama antes de cualquier edición: \`git checkout -b fix/descripcion\`
+
+### Debug detection
+- No commitear \`console.log\`, \`print()\`, \`dd()\`, \`var_dump()\`, \`debugger\`, \`binding.pry\`
+- Si los encuentras en código existente, eliminarlos antes de commitear
+
+### Production safety
+- Nunca ejecutar comandos destructivos en producción sin confirmación explícita
+- Comandos bloqueados en producción: \`--force-reset\`, \`DROP TABLE\`, \`TRUNCATE\`, \`rm -rf /\`, \`git push --force\`
+
+### Secrets
+- Nunca hardcodear tokens, passwords o API keys en archivos que van a git
+- Usar variables de entorno o secret managers
+`;
+}
+function commandsSection() {
+    return `## Comandos del flujo SDD
+
+| Comando | Descripción |
+|---------|-------------|
+| \`/session-start\` | Inicia sesión: verifica rama, tools, estado del repo |
+| \`/plan\` | Crea o revisa specs con Planner-Critic |
+| \`/work\` | Implementa una spec aprobada (modo serial en OpenCode) |
+| \`/review\` | Revisión multi-agente del diff actual |
+| \`/ship\` | Pipeline de deploy: tests → typecheck → Vercel |
+| \`/session-close\` | Cierra sesión: commit, PR, daily note |
+
+> **Nota OpenCode**: Los agentes se ejecutan en serie, no en paralelo.
+`;
+}
+export function generateAgentsMd(config) {
+    const proj = config.project;
+    const stack = config.stack ?? {};
+    const agents = config.agents ?? {};
+    const compliance = config.compliance ?? {};
+    const name = proj.name ?? 'Mi Proyecto';
+    const language = proj.language ?? 'typescript';
+    const active = agents.active ?? [];
+    const complianceAgents = agents.compliance ?? [];
+    const profiles = agents.profiles ?? [];
+    const allAgents = [...active, ...complianceAgents];
+    const agentRows = allAgents
+        .map(a => `| \`${a}\` | ${AGENT_DESCRIPTIONS[a] ?? 'Agente especializado'} |`)
+        .join('\n');
+    const complianceSection = compliance.frameworks && compliance.frameworks.length > 0
+        ? `\n## Compliance\n\nMarcos activos: ${compliance.frameworks.map(f => f.toUpperCase()).join(', ')}\n`
+        : '';
+    return `# AGENTS.md — ${name}
+
+> Generado por forge v2. Actualizar project.yaml para cambiar la configuración.
+
+## Proyecto
+
+- **Nombre**: ${name}
+- **Lenguaje**: ${language}
+- **Backend**: ${stack.backend ?? 'N/A'}
+- **Frontend**: ${stack.frontend ?? 'N/A'}
+- **Base de datos**: ${stack.database ?? 'N/A'}
+- **Profiles activos**: ${profiles.join(', ') || '—'}
+
+## Agentes del equipo
+
+| Agente | Descripción |
+|--------|-------------|
+${agentRows || '| — | Sin agentes declarados en project.yaml |'}
+
+> Invocar el agente especializado para cada tarea. Usar orchestrator solo para tareas multi-agente.
+
+${commandsSection()}
+${guardrailSection()}${complianceSection}`;
+}
+//# sourceMappingURL=opencode.js.map

package/dist/lib/generators/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/lib/generators/opencode.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAA2B;IACjD,cAAc,EAAU,gDAAgD;IACxE,kBAAkB,EAAM,uCAAuC;IAC/D,cAAc,EAAU,0CAA0C;IAClE,mBAAmB,EAAK,sCAAsC;IAC9D,gBAAgB,EAAQ,2CAA2C;IACnE,iBAAiB,EAAO,uCAAuC;IAC/D,oBAAoB,EAAI,0CAA0C;IAClE,eAAe,EAAS,oCAAoC;IAC5D,aAAa,EAAW,qCAAqC;IAC7D,qBAAqB,EAAG,kDAAkD;IAC1E,kBAAkB,EAAM,8CAA8C;IACtE,sBAAsB,EAAE,qCAAqC;IAC7D,aAAa,EAAW,iCAAiC;IACzD,kBAAkB,EAAM,yCAAyC;CAClE,CAAC;AAEF,SAAS,gBAAgB;IACvB,OAAO;;;;;;;;;;;;;;;;;;;;CAoBR,CAAC;AACF,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;;;;;;;;;;;;CAYR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,SAAS;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,kBAAkB,CAAC,CAAC,CAAC,IAAI,sBAAsB,IAAI,CAAC;SAC7E,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,iBAAiB,GAAG,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QACjF,CAAC,CAAC,sCAAsC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACtG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,iBAAiB,IAAI;;;;;;gBAMd,IAAI;kBACF,QAAQ;iBACT,KAAK,CAAC,OAAO,IAAI,KAAK;kBACrB,KAAK,CAAC,QAAQ,IAAI,KAAK;uBAClB,KAAK,CAAC,QAAQ,IAAI,KAAK;0BACpB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG;;;;;;EAMlD,SAAS,IAAI,gDAAgD;;;;EAI7D,eAAe,EAAE;EACjB,gBAAgB,EAAE,GAAG,iBAAiB,EAAE,CAAC;AAC3C,CAAC"}

package/dist/lib/wizard.d.ts

@@ -0,0 +1,17 @@
+export interface WizardResult {
+    name: string;
+    slug: string;
+    description: string;
+    language: string;
+    mode: 'startup' | 'standard' | 'enterprise';
+    backend?: string;
+    frontend?: string;
+    database?: string;
+    orm?: string;
+    packageManager?: string;
+    testing?: string[];
+    profiles?: string[];
+    runtime: string;
+}
+export declare function runWizard(): Promise<WizardResult | null>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/lib/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/lib/wizard.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAwGD,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8F9D"}