@nac3/forge-cli 0.2.0-alpha.2 → 0.2.0-alpha.20

package/dist/commands/clarify.js

@@ -0,0 +1,671 @@
+/**
+ * `yf clarify <round>` -- Phase II of PRODUCT_WORKFLOW.md
+ * (steps 4 through 9).
+ *
+ * Six rounds of structured clarification:
+ *
+ *   functional      step 4: user stories, MVP slice, personas
+ *   quantitative    step 5: volumetria, paralelismo, complejidad
+ *   structural      step 6: persistencia, middleware, lifecycle, workers
+ *   governance      step 7: compliance, audit, retention, RBAC, DR
+ *   operational     step 8: i18n, a11y, cost, monitoring, SLA
+ *   blocks          step 9: descompose system + dep graph + MVP path
+ *
+ * Each round writes a markdown doc to
+ * docs/clarification/0X_<round>.md inside the user's project,
+ * and a structured summary to workflow.clarification.<round>.
+ *
+ * The 6 rounds run in order. Forge refuses to run round N+1
+ * until round N is complete. Skip is allowed only when triage
+ * tier === simple AND the round is not blocks (which everyone
+ * needs).
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, patchWorkflowGroup, } from '../workflow/state.js';
+const ROUND_NUMBER = {
+    functional: '04',
+    quantitative: '05',
+    structural: '06',
+    governance: '07',
+    operational: '08',
+    blocks: '09',
+};
+const ROUND_STATE_KEY = {
+    functional: 'functional',
+    quantitative: 'nfr_quantitative',
+    structural: 'nfr_structural',
+    governance: 'nfr_governance',
+    operational: 'nfr_operational',
+    blocks: 'blocks',
+};
+const PRE_REQ = {
+    functional: null,
+    quantitative: 'functional',
+    structural: 'quantitative',
+    governance: 'structural',
+    operational: 'governance',
+    blocks: 'operational',
+};
+async function ensureClarificationDir(projectRoot) {
+    const dir = path.join(projectRoot, 'docs', 'clarification');
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+async function writeRoundDoc(projectRoot, round, title, bodyMd) {
+    const dir = await ensureClarificationDir(projectRoot);
+    const filename = ROUND_NUMBER[round] + '_' + round + '.md';
+    const fullPath = path.join(dir, filename);
+    const stamp = new Date().toISOString();
+    const md = `# ${title}\n\n*Generated by \`yf clarify ${round}\` on ${stamp}.*\n\n${bodyMd}\n`;
+    await fs.writeFile(fullPath, md, 'utf-8');
+    return path.relative(projectRoot, fullPath);
+}
+/* =========================================================================
+ * Round 4 -- functional
+ * ========================================================================= */
+async function runFunctional(projectRoot) {
+    console.log(c.dim('Ronda 4/6 -- relevamiento funcional. ~10 preguntas.'));
+    console.log('');
+    const a = await prompts([
+        { type: 'text', name: 'vision', message: 'En 1-2 frases: cual es la vision del producto?' },
+        { type: 'text', name: 'pain_solved', message: 'Que dolor concreto resuelve hoy?' },
+        { type: 'text', name: 'personas', message: 'Quien lo usa? (separados por coma; ej: "PM, dev junior, ops")' },
+        { type: 'text', name: 'flagship_features', message: 'Top 3 killer features (separadas por coma):' },
+        { type: 'text', name: 'mvp_slice', message: 'El slice mas chico que justifica un launch (1 frase):' },
+        { type: 'text', name: 'success_metrics', message: 'Que metric mide exito? (ej: "DAU > 100", "checkout > 80%")' },
+        { type: 'text', name: 'out_of_scope', message: 'Cosas explicitamente fuera de scope (separadas por coma):' },
+        { type: 'select', name: 'launch_horizon', message: 'Horizonte de lanzamiento:',
+            choices: [
+                { title: 'Esta semana', value: 'this_week' },
+                { title: 'Este mes', value: 'this_month' },
+                { title: 'Este trimestre', value: 'quarter' },
+                { title: 'No urgente', value: 'no_rush' },
+            ],
+        },
+        { type: 'select', name: 'comparable_product', message: 'Producto comparable que ya conoces:',
+            choices: [
+                { title: 'Otro SaaS similar (decime cual)', value: 'saas' },
+                { title: 'Una herramienta interna', value: 'internal' },
+                { title: 'No hay comparable directo', value: 'novel' },
+            ],
+        },
+        { type: 'text', name: 'comparable_name', message: 'Nombre del comparable (vacio si "novel"):', initial: '' },
+    ]);
+    if (!a.vision) {
+        console.log(c.warn('Cancelado.'));
+        return;
+    }
+    const bodyMd = [
+        '## Vision', a.vision, '',
+        '## Pain solved', a.pain_solved, '',
+        '## Personas', a.personas.split(',').map((p) => '- ' + p.trim()).join('\n'), '',
+        '## Killer features', a.flagship_features.split(',').map((f) => '- ' + f.trim()).join('\n'), '',
+        '## MVP slice', a.mvp_slice, '',
+        '## Success metrics', a.success_metrics, '',
+        '## Out of scope', a.out_of_scope ? a.out_of_scope.split(',').map((o) => '- ' + o.trim()).join('\n') : '_none declared_', '',
+        '## Launch horizon', '- ' + a.launch_horizon, '',
+        '## Comparable product', '- type: ' + a.comparable_product, '- name: ' + (a.comparable_name || '(none)'), '',
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'functional', 'Functional Clarification (step 4)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        functional: {
+            done_at: new Date().toISOString(),
+            summary: a.vision,
+            doc_path: docPath,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round functional persistido: ') + c.brand(docPath));
+    console.log(c.dim('Siguiente paso: ') + c.code('yf clarify quantitative'));
+}
+/* =========================================================================
+ * Round 5 -- quantitative NFR
+ * ========================================================================= */
+async function runQuantitative(projectRoot) {
+    console.log(c.dim('Ronda 5/6 -- NFR cuantitativas. Estas respuestas DIRECTAMENTE'));
+    console.log(c.dim('disparan decisiones de arquitectura.'));
+    console.log('');
+    const a = await prompts([
+        { type: 'number', name: 'users_launch', message: 'Usuarios concurrentes esperados AL lanzamiento:', initial: 10, min: 0 },
+        { type: 'number', name: 'users_12m', message: 'Usuarios concurrentes esperados a 12 meses:', initial: 100, min: 0 },
+        { type: 'number', name: 'rps_peak', message: 'Requests/segundo en pico esperado:', initial: 5, min: 0 },
+        { type: 'select', name: 'data_volume', message: 'Volumen de datos (tabla mas grande):',
+            choices: [
+                { title: '< 100k filas', value: 'small' },
+                { title: '100k a 10M filas', value: 'medium' },
+                { title: '10M a 1B filas', value: 'large' },
+                { title: '> 1B filas', value: 'huge' },
+            ],
+        },
+        { type: 'select', name: 'data_growth', message: 'Crecimiento esperado:',
+            choices: [
+                { title: 'Lineal y modesto (< 1 GB/mes)', value: 'slow' },
+                { title: 'Moderado (1-50 GB/mes)', value: 'medium' },
+                { title: 'Rapido (> 50 GB/mes)', value: 'fast' },
+            ],
+        },
+        { type: 'select', name: 'sync_async', message: 'Operaciones predominantes:',
+            choices: [
+                { title: 'Sincronicas (responder al request)', value: 'sync' },
+                { title: 'Asincronicas / background', value: 'async' },
+                { title: 'Mix balanceado', value: 'mixed' },
+            ],
+        },
+        { type: 'select', name: 'realtime', message: 'Necesidad de tiempo real:',
+            choices: [
+                { title: 'No, request-response basta', value: 'none' },
+                { title: 'Notificaciones push esporadicas', value: 'push' },
+                { title: 'Chat / colab en vivo (websockets)', value: 'websocket' },
+                { title: 'Streaming continuo (audio/video)', value: 'stream' },
+            ],
+        },
+        { type: 'select', name: 'batch', message: 'Batch / procesos nocturnos:',
+            choices: [
+                { title: 'Ninguno', value: 'none' },
+                { title: 'ETL ocasional', value: 'occasional' },
+                { title: 'Nightly heavy (>1h)', value: 'heavy' },
+            ],
+        },
+        { type: 'number', name: 'process_steps', message: 'Flujo de negocio mas largo: cuantos pasos tiene?', initial: 3, min: 1 },
+        { type: 'number', name: 'process_decisions', message: 'Cuantas decisiones / ramificaciones tiene?', initial: 1, min: 0 },
+        { type: 'number', name: 'process_actors', message: 'Cuantos actores intervienen?', initial: 1, min: 1 },
+    ]);
+    if (a.users_launch === undefined) {
+        console.log(c.warn('Cancelado.'));
+        return;
+    }
+    /* Derive arch decisions per PRODUCT_WORKFLOW sec 5 table. */
+    const decisions = [];
+    if (a.process_steps > 5 && a.process_decisions >= 2) {
+        decisions.push('**Workflow engine RECOMENDADO** -- proceso con > 5 pasos + ramificaciones. Sugerencia: temporal / inngest / xstate.');
+    }
+    if (a.process_actors >= 3) {
+        decisions.push('**Object lifecycle states explicito** -- multiples actores tocando entidades. Sugerencia: state machine + audit log.');
+    }
+    if (a.batch !== 'none' || a.realtime === 'stream') {
+        decisions.push('**Workers async** -- presencia de batch o streaming. Sugerencia: bull / sidekiq / temporal.');
+    }
+    if (a.batch === 'heavy' || a.batch === 'occasional') {
+        decisions.push('**Cron jobs** -- batch nocturno. Sugerencia: cron + idempotent jobs.');
+    }
+    if (a.realtime === 'websocket' || a.realtime === 'stream') {
+        decisions.push('**Real-time delivery** -- websockets/SSE/pusher.');
+    }
+    const bodyMd = [
+        '## Volumetria',
+        '- Usuarios concurrentes lanzamiento: ' + a.users_launch,
+        '- Usuarios concurrentes 12m: ' + a.users_12m,
+        '- Pico RPS: ' + a.rps_peak,
+        '- Volumen de datos: ' + a.data_volume,
+        '- Crecimiento: ' + a.data_growth,
+        '',
+        '## Paralelismo',
+        '- Predominantes: ' + a.sync_async,
+        '- Real-time: ' + a.realtime,
+        '- Batch: ' + a.batch,
+        '',
+        '## Complejidad de procesos',
+        '- Pasos del flujo mas largo: ' + a.process_steps,
+        '- Decisiones / ramificaciones: ' + a.process_decisions,
+        '- Actores: ' + a.process_actors,
+        '',
+        '## Decisiones derivadas (proponer al usuario)',
+        decisions.length > 0 ? decisions.map((d) => '- ' + d).join('\n') : '_ninguna especifica disparada por la volumetria_',
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'quantitative', 'NFR Cuantitativas (step 5)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        nfr_quantitative: {
+            done_at: new Date().toISOString(),
+            summary: `${a.users_12m} users / ${a.rps_peak} rps / ${a.realtime} / ${a.batch}`,
+            doc_path: docPath,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round quantitative persistido: ') + c.brand(docPath));
+    if (decisions.length > 0) {
+        console.log('');
+        console.log(c.warn('Decisiones arch derivadas:'));
+        for (const d of decisions)
+            console.log('  - ' + d.replace(/\*\*/g, ''));
+    }
+    console.log('');
+    console.log(c.dim('Siguiente paso: ') + c.code('yf clarify structural'));
+}
+/* =========================================================================
+ * Round 6 -- structural NFR
+ * ========================================================================= */
+async function runStructural(projectRoot) {
+    console.log(c.dim('Ronda 6/6 -- NFR estructurales (persistencia + middleware + lifecycle).'));
+    console.log('');
+    const a = await prompts([
+        { type: 'select', name: 'persistence', message: 'Modelo de persistencia primario:',
+            choices: [
+                { title: 'SQL (relacional, ACID)', value: 'sql' },
+                { title: 'NoSQL (document, eventual)', value: 'nosql' },
+                { title: 'Hibrido SQL + NoSQL', value: 'hybrid' },
+                { title: 'File storage (no DB)', value: 'files' },
+                { title: 'In-memory only', value: 'memory' },
+            ],
+        },
+        { type: 'select', name: 'orm', message: 'Capa de acceso a la DB:',
+            choices: [
+                { title: 'ORM estricto (Prisma / Drizzle / TypeORM)', value: 'orm' },
+                { title: 'Query builder (Kysely / Knex)', value: 'query_builder' },
+                { title: 'SQL crudo / driver directo', value: 'raw_sql' },
+                { title: 'No aplica', value: 'none' },
+            ],
+        },
+        { type: 'select', name: 'consistency', message: 'Modelo de consistencia:',
+            choices: [
+                { title: 'ACID estricto', value: 'acid' },
+                { title: 'Eventual consistency aceptada', value: 'eventual' },
+                { title: 'No aplica (no hay BD)', value: 'none' },
+            ],
+        },
+        { type: 'multiselect', name: 'middleware', message: 'Middleware central (multiselect con espacio):',
+            choices: [
+                { title: 'auth (JWT / session)', value: 'auth' },
+                { title: 'logging estructurado', value: 'logging' },
+                { title: 'rate limiting', value: 'rate_limit' },
+                { title: 'caching layer', value: 'cache' },
+                { title: 'CORS', value: 'cors' },
+                { title: 'i18n', value: 'i18n' },
+                { title: 'request validation (zod)', value: 'validation' },
+            ],
+            hint: '- Space to select, Enter to submit',
+        },
+        { type: 'select', name: 'cache', message: 'Estrategia de cache:',
+            choices: [
+                { title: 'Sin cache', value: 'none' },
+                { title: 'In-memory (LRU local)', value: 'memory' },
+                { title: 'Redis', value: 'redis' },
+                { title: 'Edge / CDN', value: 'edge' },
+            ],
+        },
+        { type: 'select', name: 'queue', message: 'Cola de mensajes:',
+            choices: [
+                { title: 'Sin cola', value: 'none' },
+                { title: 'Redis (BullMQ)', value: 'redis' },
+                { title: 'AWS SQS', value: 'sqs' },
+                { title: 'RabbitMQ', value: 'rabbit' },
+                { title: 'NATS', value: 'nats' },
+            ],
+        },
+        { type: 'select', name: 'file_storage', message: 'Almacenamiento de archivos:',
+            choices: [
+                { title: 'No aplica', value: 'none' },
+                { title: 'S3-compatible (R2 / S3 / GCS)', value: 's3' },
+                { title: 'Local filesystem', value: 'local' },
+                { title: 'Hibrido', value: 'hybrid' },
+            ],
+        },
+    ]);
+    if (!a.persistence) {
+        console.log(c.warn('Cancelado.'));
+        return;
+    }
+    const bodyMd = [
+        '## Persistencia',
+        '- Modelo: ' + a.persistence,
+        '- Capa: ' + a.orm,
+        '- Consistencia: ' + a.consistency,
+        '',
+        '## Middleware central',
+        Array.isArray(a.middleware) && a.middleware.length > 0
+            ? a.middleware.map((m) => '- ' + m).join('\n')
+            : '_ninguno seleccionado_',
+        '',
+        '## Cache + colas + storage',
+        '- Cache strategy: ' + a.cache,
+        '- Queue: ' + a.queue,
+        '- File storage: ' + a.file_storage,
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'structural', 'NFR Estructurales (step 6)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        nfr_structural: {
+            done_at: new Date().toISOString(),
+            summary: `${a.persistence} / ${a.orm} / ${a.cache} cache / ${a.queue} queue`,
+            doc_path: docPath,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round structural persistido: ') + c.brand(docPath));
+    console.log(c.dim('Siguiente paso: ') + c.code('yf clarify governance'));
+}
+/* =========================================================================
+ * Round 7 -- governance NFR
+ * ========================================================================= */
+async function runGovernance(projectRoot) {
+    console.log(c.dim('Ronda 7 -- NFR de gobernanza (compliance + auditoria + retencion).'));
+    console.log('');
+    const a = await prompts([
+        { type: 'multiselect', name: 'compliance', message: 'Compliance que aplica (multiselect):',
+            choices: [
+                { title: 'GDPR (EU users)', value: 'gdpr' },
+                { title: 'HIPAA (US health)', value: 'hipaa' },
+                { title: 'PCI-DSS (card payments)', value: 'pci' },
+                { title: 'SOC 2 (B2B SaaS)', value: 'soc2' },
+                { title: 'LGPD (Brasil)', value: 'lgpd' },
+                { title: 'Ninguna por ahora', value: 'none' },
+            ],
+        },
+        { type: 'select', name: 'audit_level', message: 'Nivel de auditoria:',
+            choices: [
+                { title: 'Logs basicos (errores + access)', value: 'basic' },
+                { title: 'Append-only audit log de toda operacion sensible', value: 'append' },
+                { title: 'Audit log + signed entries', value: 'signed' },
+            ],
+        },
+        { type: 'text', name: 'retention_default', message: 'Retencion default de datos del usuario (ej: "1 year", "7 years", "forever"):' },
+        { type: 'select', name: 'rbac', message: 'Modelo de roles + permisos:',
+            choices: [
+                { title: 'Single-user (no roles)', value: 'single' },
+                { title: 'Single-tenant + roles', value: 'single_rbac' },
+                { title: 'Multi-tenant B2B + RBAC', value: 'multi_rbac' },
+            ],
+        },
+        { type: 'select', name: 'backup', message: 'Frecuencia de backups:',
+            choices: [
+                { title: 'Sin backup automatico', value: 'none' },
+                { title: 'Daily', value: 'daily' },
+                { title: 'Hourly + daily', value: 'hourly' },
+                { title: 'Continuous (PITR)', value: 'continuous' },
+            ],
+        },
+        { type: 'text', name: 'rto_rpo', message: 'RTO / RPO target (ej: "RTO 4h / RPO 1h", o "no aplica"):', initial: 'no aplica' },
+        { type: 'confirm', name: 'pii_redact', message: 'Hay PII en logs/transcripts que hay que redactar automatico?', initial: false },
+        { type: 'confirm', name: 'encrypt_at_rest', message: 'Encryption at rest obligatorio?', initial: true },
+    ]);
+    if (!a.compliance) {
+        console.log(c.warn('Cancelado.'));
+        return;
+    }
+    const decisions = [];
+    if (Array.isArray(a.compliance) && a.compliance.some((c) => ['gdpr', 'hipaa', 'soc2', 'lgpd'].includes(c))) {
+        decisions.push('Audit log estructural REQUERIDO (append-only + immutable storage)');
+    }
+    if (Array.isArray(a.compliance) && (a.compliance.includes('gdpr') || a.compliance.includes('lgpd'))) {
+        decisions.push('PII redaction automatica en logs + chat (regex middleware)');
+        decisions.push('Right to erasure endpoint (DELETE /user/me) + workflow');
+    }
+    if (a.rbac === 'multi_rbac') {
+        decisions.push('Multi-tenancy: tenant_id en cada fila + RLS / app-level isolation');
+    }
+    if (a.backup !== 'none') {
+        decisions.push('Backup automatico ' + a.backup + ' + cross-region');
+    }
+    const bodyMd = [
+        '## Compliance',
+        Array.isArray(a.compliance) && a.compliance.length > 0
+            ? a.compliance.map((c) => '- ' + c).join('\n')
+            : '- none',
+        '',
+        '## Audit + retention',
+        '- Nivel: ' + a.audit_level,
+        '- Retencion default: ' + a.retention_default,
+        '',
+        '## Acceso + multi-tenancy',
+        '- RBAC: ' + a.rbac,
+        '',
+        '## Backup + DR',
+        '- Frecuencia: ' + a.backup,
+        '- RTO/RPO: ' + a.rto_rpo,
+        '',
+        '## Seguridad',
+        '- PII redaction: ' + (a.pii_redact ? 'si' : 'no'),
+        '- Encryption at rest: ' + (a.encrypt_at_rest ? 'si' : 'no'),
+        '',
+        '## Decisiones derivadas',
+        decisions.length > 0 ? decisions.map((d) => '- ' + d).join('\n') : '_ninguna disparada_',
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'governance', 'NFR Gobernanza (step 7)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        nfr_governance: {
+            done_at: new Date().toISOString(),
+            summary: `compliance: ${(Array.isArray(a.compliance) ? a.compliance.join(',') : 'none')} / rbac: ${a.rbac} / backup: ${a.backup}`,
+            doc_path: docPath,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round governance persistido: ') + c.brand(docPath));
+    console.log(c.dim('Siguiente paso: ') + c.code('yf clarify operational'));
+}
+/* =========================================================================
+ * Round 8 -- operational NFR
+ * ========================================================================= */
+async function runOperational(projectRoot) {
+    console.log(c.dim('Ronda 8 -- NFR operacionales (i18n + a11y + costos + monitoring + SLA).'));
+    console.log('');
+    const a = await prompts([
+        { type: 'multiselect', name: 'locales', message: 'Locales a soportar al lanzamiento (multiselect):',
+            choices: [
+                { title: 'Espanol', value: 'es' }, { title: 'English', value: 'en' },
+                { title: 'Portugues', value: 'pt' }, { title: 'Francais', value: 'fr' },
+                { title: 'Italiano', value: 'it' }, { title: 'Deutsch', value: 'de' },
+                { title: 'Japones', value: 'ja' }, { title: 'Chino', value: 'zh' },
+                { title: 'Hindi', value: 'hi' }, { title: 'Arabe (RTL)', value: 'ar' },
+            ],
+        },
+        { type: 'select', name: 'a11y', message: 'Nivel de accesibilidad target:',
+            choices: [
+                { title: 'WCAG AA (recomendado)', value: 'aa' },
+                { title: 'WCAG AAA (estricto)', value: 'aaa' },
+                { title: 'ADIP completo (voz + STT + TTS para usuarios)', value: 'adip' },
+                { title: 'No es prioridad ahora', value: 'none' },
+            ],
+        },
+        { type: 'number', name: 'budget_monthly', message: 'Presupuesto mensual estimado (USD, hosting + APIs):', initial: 50, min: 0 },
+        { type: 'multiselect', name: 'monitoring', message: 'Stack de monitoring:',
+            choices: [
+                { title: 'Sentry (errors)', value: 'sentry' },
+                { title: 'Datadog (full)', value: 'datadog' },
+                { title: 'PostHog (product analytics)', value: 'posthog' },
+                { title: 'Grafana + Prometheus', value: 'grafana' },
+                { title: 'Solo logs aplicacion', value: 'logs' },
+            ],
+        },
+        { type: 'select', name: 'alerts', message: 'Alertas:',
+            choices: [
+                { title: 'Slack channel', value: 'slack' },
+                { title: 'PagerDuty', value: 'pagerduty' },
+                { title: 'Email', value: 'email' },
+                { title: 'Ninguna por ahora', value: 'none' },
+            ],
+        },
+        { type: 'select', name: 'sla', message: 'SLA target:',
+            choices: [
+                { title: 'Best effort (no SLA)', value: 'best_effort' },
+                { title: '99% uptime (8h downtime/mes)', value: '99' },
+                { title: '99.9% (43m downtime/mes)', value: '99.9' },
+                { title: '99.99% (4m downtime/mes)', value: '99.99' },
+            ],
+        },
+        { type: 'select', name: 'support_hours', message: 'Horario de soporte:',
+            choices: [
+                { title: '24/7', value: '24_7' },
+                { title: 'Business hours del usuario', value: 'business' },
+                { title: 'Best effort', value: 'best_effort' },
+            ],
+        },
+    ]);
+    if (!a.a11y) {
+        console.log(c.warn('Cancelado.'));
+        return;
+    }
+    const decisions = [];
+    if (Array.isArray(a.locales) && a.locales.length >= 2) {
+        decisions.push('i18n infra completa (catalog + per-locale routing)');
+    }
+    if (Array.isArray(a.locales) && a.locales.includes('ar')) {
+        decisions.push('RTL support (I18nManager.forceRTL + bidi-safe CSS)');
+    }
+    if (a.budget_monthly < 100 && (a.sla === '99.9' || a.sla === '99.99')) {
+        decisions.push('CONFLICTO: SLA estricto incompatible con presupuesto bajo. Sugerencia: edge caching + model routing barato.');
+    }
+    const bodyMd = [
+        '## Locales + accesibilidad',
+        '- Locales: ' + (Array.isArray(a.locales) ? a.locales.join(', ') : '(ninguno)'),
+        '- A11y target: ' + a.a11y,
+        '',
+        '## Costos + monitoring',
+        '- Presupuesto mensual: USD ' + a.budget_monthly,
+        '- Monitoring: ' + (Array.isArray(a.monitoring) ? a.monitoring.join(', ') : '(ninguno)'),
+        '- Alertas: ' + a.alerts,
+        '',
+        '## SLA + soporte',
+        '- SLA: ' + a.sla,
+        '- Soporte: ' + a.support_hours,
+        '',
+        '## Decisiones derivadas',
+        decisions.length > 0 ? decisions.map((d) => '- ' + d).join('\n') : '_ninguna disparada_',
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'operational', 'NFR Operacionales (step 8)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        nfr_operational: {
+            done_at: new Date().toISOString(),
+            summary: `${(Array.isArray(a.locales) ? a.locales.length : 0)} locales / a11y: ${a.a11y} / SLA: ${a.sla} / budget: $${a.budget_monthly}`,
+            doc_path: docPath,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round operational persistido: ') + c.brand(docPath));
+    console.log(c.dim('Siguiente paso: ') + c.code('yf clarify blocks'));
+}
+/* =========================================================================
+ * Round 9 -- blocks plan
+ * ========================================================================= */
+async function runBlocks(projectRoot) {
+    console.log(c.dim('Ronda 9 -- descompose el sistema en bloques + dependencias.'));
+    console.log(c.dim('Ingresa los bloques uno por uno. Vacio para terminar.'));
+    console.log('');
+    const blocks = [];
+    while (true) {
+        const a = await prompts([
+            { type: 'text', name: 'name', message: `Bloque ${blocks.length + 1} -- nombre (vacio para terminar):` },
+        ]);
+        if (!a.name || a.name.trim() === '')
+            break;
+        const rest = await prompts([
+            { type: 'select', name: 'effort', message: 'Esfuerzo:',
+                choices: [
+                    { title: 'S (< 1 dia Sumi)', value: 'S' },
+                    { title: 'M (1-2 dias)', value: 'M' },
+                    { title: 'L (1 semana)', value: 'L' },
+                    { title: 'XL (>= 2 semanas)', value: 'XL' },
+                ],
+            },
+            { type: 'text', name: 'dependencies', message: 'Dependencias (ids de bloques anteriores, separados por coma, vacio = ninguna):' },
+            { type: 'confirm', name: 'mvp', message: 'Este bloque forma parte del MVP?', initial: false },
+        ]);
+        const id = a.name.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
+        blocks.push({
+            id,
+            name: a.name,
+            effort: rest.effort,
+            dependencies: rest.dependencies ? rest.dependencies.split(',').map((s) => s.trim()).filter(Boolean) : [],
+            mvp: !!rest.mvp,
+        });
+        console.log(c.success('  +') + c.dim(' ' + id + ' (' + rest.effort + ')'));
+    }
+    if (blocks.length === 0) {
+        console.log(c.warn('Cancelado (cero bloques).'));
+        return;
+    }
+    /* MVP path = blocks marked mvp, in dependency order. */
+    const mvpBlocks = blocks.filter((b) => b.mvp).map((b) => b.id);
+    const bodyMd = [
+        '## Bloques identificados (' + blocks.length + ')',
+        '',
+        '| id | nombre | esfuerzo | deps | mvp |',
+        '|----|--------|----------|------|-----|',
+        ...blocks.map((b) => `| \`${b.id}\` | ${b.name} | ${b.effort} | ${b.dependencies.join(', ') || '-'} | ${b.mvp ? '✔' : ''} |`),
+        '',
+        '## MVP path',
+        mvpBlocks.length > 0 ? mvpBlocks.map((id) => '- ' + id).join('\n') : '_ningun bloque marcado MVP_',
+        '',
+        '## Orden de construccion sugerido',
+        '_Resolve via topological sort once Forge implements the planner_',
+    ].join('\n');
+    const docPath = await writeRoundDoc(projectRoot, 'blocks', 'Bloques prioritarios (step 9)', bodyMd);
+    await patchWorkflowGroup(projectRoot, 'clarification', {
+        blocks: {
+            done_at: new Date().toISOString(),
+            blocks,
+            mvp_path: mvpBlocks,
+        },
+    });
+    console.log('');
+    console.log(c.success('Round blocks persistido: ') + c.brand(docPath));
+    console.log(c.dim('  ' + blocks.length + ' bloques / ' + mvpBlocks.length + ' en MVP.'));
+    console.log('');
+    console.log(c.dim('Phase II completa. Siguiente paso: ') + c.code('yf spec rfp'));
+}
+/* =========================================================================
+ * Dispatcher
+ * ========================================================================= */
+export async function runClarify(round, cwd) {
+    header('Yujin Forge -- clarify ' + round);
+    console.log('');
+    const projectRoot = cwd ? path.resolve(cwd) : process.cwd();
+    const wf = await readWorkflow(projectRoot);
+    if (!wf.tier) {
+        console.log(c.error('No hay triage previo. Corre primero ') + c.code('yf triage'));
+        process.exitCode = 1;
+        return;
+    }
+    const pre = PRE_REQ[round];
+    if (pre) {
+        const preDone = wf.clarification?.[ROUND_STATE_KEY[pre]];
+        if (!preDone) {
+            console.log(c.error('Pre-requisito faltante: ronda "' + pre + '" no esta completa.'));
+            console.log(c.dim('Corre primero: ') + c.code('yf clarify ' + pre));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    switch (round) {
+        case 'functional':
+            await runFunctional(projectRoot);
+            break;
+        case 'quantitative':
+            await runQuantitative(projectRoot);
+            break;
+        case 'structural':
+            await runStructural(projectRoot);
+            break;
+        case 'governance':
+            await runGovernance(projectRoot);
+            break;
+        case 'operational':
+            await runOperational(projectRoot);
+            break;
+        case 'blocks':
+            await runBlocks(projectRoot);
+            break;
+    }
+}
+export function registerClarifyCommand(program) {
+    const clarify = program.command('clarify')
+        .description('Phase II steps 4-9: 6 structured clarification rounds.');
+    const rounds = ['functional', 'quantitative', 'structural', 'governance', 'operational', 'blocks'];
+    for (const r of rounds) {
+        clarify.command(r)
+            .description('Ronda ' + ROUND_NUMBER[r] + ': ' + r)
+            .option('--cwd <path>', 'project root (default: current directory)')
+            .action(async (opts) => {
+            try {
+                await runClarify(r, opts.cwd);
+            }
+            catch (err) {
+                console.error(c.error(err instanceof Error ? err.message : String(err)));
+                process.exitCode = 1;
+            }
+        });
+    }
+}
+//# sourceMappingURL=clarify.js.map