@nac3/forge-cli 0.2.0-alpha.10 → 0.2.0-alpha.11

package/dist/bin/yf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,YAAY,IAAI,OAAO,CAsCtC"}
+{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,wBAAgB,YAAY,IAAI,OAAO,CAyCtC"}

package/dist/bin/yf.js

@@ -35,6 +35,8 @@ import { registerKeysSetupCommand } from '../commands/keys_setup.js';
 import { registerRepoCommand } from '../commands/repo.js';
 import { registerMobileCommand } from '../commands/mobile.js';
 import { registerLogCommand } from '../commands/log.js';
+import { registerTriageCommand } from '../commands/triage.js';
+import { registerDiscoverCommand } from '../commands/discover.js';
 import { VERSION } from '../version.js';
 export function buildProgram() {
     const program = new Command();
@@ -71,6 +73,9 @@ export function buildProgram() {
     registerRepoCommand(program);
     registerMobileCommand(program);
     registerLogCommand(program);
+    /* PRODUCT_WORKFLOW.md commands (Phase I onwards). */
+    registerTriageCommand(program);
+    registerDiscoverCommand(program);
     return program;
 }
 async function main() {

package/dist/bin/yf.js.map

@@ -1 +1 @@
-{"version":3,"file":"yf.js","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yf.js","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,8DAA8D,CAAC;SAC3E,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,6BAA6B,CAAC;SAChE,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC;SACrC,kBAAkB,CAAC,0CAA0C,CAAC,CAAC;IAElE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mEAAmE;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IACxF,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,qDAAqD;IACrD,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,iEAAiE;AACjE,8BAA8B;AAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;OAC3D,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAE7G,IAAI,QAAQ,EAAE,CAAC;IACb,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/discover.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `yf discover` -- Phase I step 3 of PRODUCT_WORKFLOW.md.
+ *
+ * Asks the user what they actually want to build + how they
+ * want to talk to Forge while doing it. Output is a structured
+ * intent object persisted to yujin.forge.json::workflow.intent.
+ *
+ * Questions:
+ *   1. Operation type      (migrate legacy / create new / modify existing)
+ *   2. Target devices       (desktop / mobile / responsive / both native)
+ *   3. Input channel        (chat-text / voice / document-paste)
+ *   4. Project state        (no-code / local-repo / remote-repo / deployed)
+ *   5. Legacy framework     (if migrating) -- text input
+ *   6. Preferred stack      (if creating new) -- text input
+ *   7. Use case             (hobby / POC / internal / commercial)
+ *
+ * Pre-requisite: yf triage must have been run (workflow.tier set).
+ * The triage tier influences which subsequent steps Forge will
+ * recommend after discover completes.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface DiscoverOptions {
+    cwd?: string;
+    yes?: boolean;
+}
+export declare function runDiscover(opts: DiscoverOptions): Promise<void>;
+export declare function registerDiscoverCommand(program: Command): void;
+//# sourceMappingURL=discover.d.ts.map

package/dist/commands/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ItE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc9D"}

package/dist/commands/discover.js

@@ -0,0 +1,178 @@
+/**
+ * `yf discover` -- Phase I step 3 of PRODUCT_WORKFLOW.md.
+ *
+ * Asks the user what they actually want to build + how they
+ * want to talk to Forge while doing it. Output is a structured
+ * intent object persisted to yujin.forge.json::workflow.intent.
+ *
+ * Questions:
+ *   1. Operation type      (migrate legacy / create new / modify existing)
+ *   2. Target devices       (desktop / mobile / responsive / both native)
+ *   3. Input channel        (chat-text / voice / document-paste)
+ *   4. Project state        (no-code / local-repo / remote-repo / deployed)
+ *   5. Legacy framework     (if migrating) -- text input
+ *   6. Preferred stack      (if creating new) -- text input
+ *   7. Use case             (hobby / POC / internal / commercial)
+ *
+ * Pre-requisite: yf triage must have been run (workflow.tier set).
+ * The triage tier influences which subsequent steps Forge will
+ * recommend after discover completes.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, patchWorkflowGroup, } from '../workflow/state.js';
+export async function runDiscover(opts) {
+    header('Yujin Forge -- discover intent');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.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;
+    }
+    if (wf.intent && !opts.yes) {
+        console.log(c.dim('Intent previo: ') + c.brand(wf.intent.operation ?? '?')
+            + c.dim(' / target ') + c.brand(wf.intent.target ?? '?')
+            + c.dim(' / use case ') + c.brand(wf.intent.use_case ?? '?'));
+        console.log(c.dim('Para volver a registrar, corre `yf discover --yes`.'));
+        return;
+    }
+    console.log(c.dim('Tier: ') + c.brand(wf.tier));
+    console.log(c.dim('7 preguntas para registrar QUE estamos construyendo.'));
+    console.log('');
+    /* Operation type first -- conditional questions depend on it. */
+    const opAns = await prompts({
+        type: 'select',
+        name: 'operation',
+        message: 'Tipo de operacion:',
+        choices: [
+            { title: 'Migrar proyecto legacy a NAC-3', value: 'migrate' },
+            { title: 'Crear proyecto NUEVO desde cero', value: 'new' },
+            { title: 'Modificar proyecto existente', value: 'modify' },
+        ],
+    });
+    if (!opAns.operation) {
+        console.log(c.warn('Discover abortado.'));
+        return;
+    }
+    const rest = await prompts([
+        {
+            type: 'select',
+            name: 'target',
+            message: 'Target devices:',
+            choices: [
+                { title: 'Desktop only', value: 'desktop' },
+                { title: 'Mobile only', value: 'mobile' },
+                { title: 'Responsive web (desktop + mobile)', value: 'responsive' },
+                { title: 'Web nativo + Mobile nativo', value: 'web-and-mobile' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'input_channel',
+            message: 'Canal preferido para hablar con Forge:',
+            choices: [
+                { title: 'Chat texto', value: 'chat-text' },
+                { title: 'Voz (push-to-talk)', value: 'voice' },
+                { title: 'Pegar documento (PDF / DOCX / etc)', value: 'document-paste' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'project_state',
+            message: 'Estado actual del proyecto:',
+            choices: [
+                { title: 'Cero codigo', value: 'no-code' },
+                { title: 'Tengo repo local sin push', value: 'local-repo' },
+                { title: 'Repo remoto (GitHub / GitLab / Bitbucket)', value: 'remote-repo' },
+                { title: 'Ya esta deployed en algun lado', value: 'deployed' },
+            ],
+        },
+        {
+            type: opAns.operation === 'migrate' || opAns.operation === 'modify' ? 'text' : null,
+            name: 'legacy_framework',
+            message: 'Framework actual + version (ej: "React 16.14", "Angular 12", "Vue 2", "jQuery"):',
+        },
+        {
+            type: opAns.operation === 'new' ? 'text' : null,
+            name: 'preferred_stack',
+            message: 'Stack preferido (vacio = default Forge: React + Vite + NAC-3 + Expo mobile):',
+            initial: '',
+        },
+        {
+            type: 'select',
+            name: 'use_case',
+            message: 'Caso de uso real:',
+            choices: [
+                { title: 'Hobby / aprender', value: 'hobby' },
+                { title: 'POC / prototype', value: 'poc' },
+                { title: 'Herramienta interna de una empresa', value: 'internal' },
+                { title: 'Producto comercial publico', value: 'commercial' },
+            ],
+        },
+    ]);
+    if (!rest.target || !rest.input_channel || !rest.project_state || !rest.use_case) {
+        console.log(c.warn('Discover abortado (faltan respuestas).'));
+        return;
+    }
+    const intent = {
+        operation: opAns.operation,
+        target: rest.target,
+        input_channel: rest.input_channel,
+        project_state: rest.project_state,
+        legacy_framework: rest.legacy_framework ?? null,
+        preferred_stack: rest.preferred_stack || null,
+        use_case: rest.use_case,
+        decided_at: new Date().toISOString(),
+    };
+    await patchWorkflowGroup(projectRoot, 'intent', intent);
+    console.log('');
+    console.log(c.success('Intent registrado:'));
+    console.log(c.dim('  Operacion:     ') + c.brand(intent.operation));
+    console.log(c.dim('  Target:        ') + c.brand(intent.target));
+    console.log(c.dim('  Canal:         ') + c.brand(intent.input_channel));
+    console.log(c.dim('  Estado:        ') + c.brand(intent.project_state));
+    if (intent.legacy_framework) {
+        console.log(c.dim('  Legacy:        ') + c.brand(intent.legacy_framework));
+    }
+    if (intent.preferred_stack) {
+        console.log(c.dim('  Stack:         ') + c.brand(intent.preferred_stack));
+    }
+    console.log(c.dim('  Caso de uso:   ') + c.brand(intent.use_case));
+    console.log('');
+    /* Next-step hint based on what we now know. */
+    const tier = wf.tier;
+    if (intent.operation === 'migrate' || intent.operation === 'modify') {
+        console.log(c.dim('Siguiente paso: ') + c.code('yf legacy audit')
+            + c.dim(' (escanea el proyecto existente)'));
+    }
+    else if (tier === 'simple') {
+        console.log(c.dim('Siguiente paso: ') + c.code('yf bootstrap')
+            + c.dim(' (scaffolding directo, tier=simple salta clarification)'));
+    }
+    else {
+        console.log(c.dim('Siguiente paso: ') + c.code('yf clarify functional')
+            + c.dim(' (primera ronda de NFR)'));
+    }
+}
+export function registerDiscoverCommand(program) {
+    program
+        .command('discover')
+        .description('Phase I step 3: discover user intent (migrate / new / modify + target + channel).')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--yes', 'overwrite a prior discover decision without prompting')
+        .action(async (opts) => {
+        try {
+            await runDiscover(opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=discover.js.map

package/dist/commands/discover.js.map

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

package/dist/commands/triage.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `yf triage` -- Phase I step 1 of PRODUCT_WORKFLOW.md.
+ *
+ * Asks the user 5 questions, classifies the project into one of
+ * three complexity tiers (Simple / Medium / Full), and persists
+ * the decision to yujin.forge.json::workflow. The result drives
+ * which subsequent phases apply (see PRODUCT_WORKFLOW.md sec 1).
+ *
+ * Questions:
+ *   1. Output type            (landing / blog / CRUD app / SaaS / regulated system)
+ *   2. Volumetria 12m         (numeric: expected concurrent users at 12 months)
+ *   3. Industry context       (general / health / finance / education / government)
+ *   4. Region                 (LATAM / US / EU / global)
+ *   5. Team maintaining        (solo / pair / team)
+ *
+ * Classification rules:
+ *   Simple = output in {landing, blog, demo} OR volumetria < 50 AND
+ *            industry = general AND team = solo
+ *   Full   = industry in {health, finance, government} OR volumetria > 5000
+ *            OR output = regulated_system OR (region = EU AND volumetria > 100)
+ *   Medium = everything else
+ *
+ * User can override the auto-tier in the final confirmation.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface TriageOptions {
+    cwd?: string;
+    yes?: boolean;
+}
+export declare function runTriage(opts: TriageOptions): Promise<void>;
+export declare function registerTriageCommand(program: Command): void;
+//# sourceMappingURL=triage.d.ts.map

package/dist/commands/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/commands/triage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAsED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6HlE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc5D"}

package/dist/commands/triage.js

@@ -0,0 +1,228 @@
+/**
+ * `yf triage` -- Phase I step 1 of PRODUCT_WORKFLOW.md.
+ *
+ * Asks the user 5 questions, classifies the project into one of
+ * three complexity tiers (Simple / Medium / Full), and persists
+ * the decision to yujin.forge.json::workflow. The result drives
+ * which subsequent phases apply (see PRODUCT_WORKFLOW.md sec 1).
+ *
+ * Questions:
+ *   1. Output type            (landing / blog / CRUD app / SaaS / regulated system)
+ *   2. Volumetria 12m         (numeric: expected concurrent users at 12 months)
+ *   3. Industry context       (general / health / finance / education / government)
+ *   4. Region                 (LATAM / US / EU / global)
+ *   5. Team maintaining        (solo / pair / team)
+ *
+ * Classification rules:
+ *   Simple = output in {landing, blog, demo} OR volumetria < 50 AND
+ *            industry = general AND team = solo
+ *   Full   = industry in {health, finance, government} OR volumetria > 5000
+ *            OR output = regulated_system OR (region = EU AND volumetria > 100)
+ *   Medium = everything else
+ *
+ * User can override the auto-tier in the final confirmation.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { writeWorkflow, readWorkflow, } from '../workflow/state.js';
+function classify(a) {
+    const simpleOutputs = ['landing', 'blog'];
+    const regulated = ['health', 'finance', 'government'];
+    if (simpleOutputs.includes(a.output)
+        || (a.volumetria < 50 && a.industry === 'general' && a.team === 'solo')) {
+        return {
+            tier: 'simple',
+            reason: a.output === 'landing' ? 'landing page'
+                : a.output === 'blog' ? 'blog'
+                    : 'small single-user project (< 50 users / 12m, general industry, solo team)',
+        };
+    }
+    if (regulated.includes(a.industry)
+        || a.volumetria > 5000
+        || a.output === 'regulated'
+        || (a.region === 'eu' && a.volumetria > 100)) {
+        const reasons = [];
+        if (regulated.includes(a.industry))
+            reasons.push('regulated industry (' + a.industry + ')');
+        if (a.volumetria > 5000)
+            reasons.push('volumetria > 5000');
+        if (a.output === 'regulated')
+            reasons.push('output = regulated system');
+        if (a.region === 'eu' && a.volumetria > 100)
+            reasons.push('EU + > 100 users (GDPR compliance)');
+        return {
+            tier: 'full',
+            reason: reasons.join(' + '),
+        };
+    }
+    return {
+        tier: 'medium',
+        reason: 'CRUD/SaaS app with moderate volumetria, non-regulated industry',
+    };
+}
+function describeAlcance(tier) {
+    switch (tier) {
+        case 'simple':
+            return [
+                '  Phase I (intake) -> Phase II step 9 (blocks) -> Phase V (build) -> Phase VI (ship)',
+                '  Skips: full clarification rounds, RFP+arch+design docs, approval gate',
+            ].join('\n');
+        case 'medium':
+            return [
+                '  Phase I + Phase II + Phase III (compact) + Phase IV gate + Phase V + Phase VI',
+                '  Light RFP+arch+design; explicit approval before build starts',
+            ].join('\n');
+        case 'full':
+            return [
+                '  ALL 18 steps, all 4 NFR rounds, full RFP+arch+design,',
+                '  hard approval gate, NAC-3 compliance auditing per block',
+            ].join('\n');
+    }
+}
+export async function runTriage(opts) {
+    header('Yujin Forge -- triage');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    const existing = await readWorkflow(projectRoot);
+    if (existing.tier && !opts.yes) {
+        console.log(c.dim('Triage previo: ') + c.brand(existing.tier)
+            + c.dim(' (' + (existing.tier_reason ?? 'no reason') + ')'));
+        console.log(c.dim('Para volver a clasificar, corre `yf triage --yes`.'));
+        return;
+    }
+    console.log(c.dim('5 preguntas para clasificar la complejidad del proyecto.'));
+    console.log(c.dim('La clasificacion determina que fases del workflow se aplican.'));
+    console.log('');
+    const answers = await prompts([
+        {
+            type: 'select',
+            name: 'output',
+            message: 'Tipo de output:',
+            choices: [
+                { title: 'Landing page', value: 'landing' },
+                { title: 'Blog / sitio de contenido', value: 'blog' },
+                { title: 'App CRUD con auth (multi-user)', value: 'crud' },
+                { title: 'SaaS multi-tenant', value: 'saas' },
+                { title: 'Sistema regulado / compliance critica', value: 'regulated' },
+            ],
+        },
+        {
+            type: 'number',
+            name: 'volumetria',
+            message: 'Usuarios concurrentes esperados a 12 meses (entero):',
+            initial: 100,
+            min: 0,
+        },
+        {
+            type: 'select',
+            name: 'industry',
+            message: 'Industria:',
+            choices: [
+                { title: 'General', value: 'general' },
+                { title: 'Salud (HIPAA / privacidad medica)', value: 'health' },
+                { title: 'Finanzas (PCI / regulacion bancaria)', value: 'finance' },
+                { title: 'Educacion', value: 'education' },
+                { title: 'Gobierno / sector publico', value: 'government' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'region',
+            message: 'Region de usuarios:',
+            choices: [
+                { title: 'LATAM', value: 'latam' },
+                { title: 'US', value: 'us' },
+                { title: 'EU (aplican GDPR)', value: 'eu' },
+                { title: 'Global', value: 'global' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'team',
+            message: 'Equipo que mantiene:',
+            choices: [
+                { title: 'Solo (vos)', value: 'solo' },
+                { title: 'En pareja (2)', value: 'pair' },
+                { title: 'Equipo (3 o mas)', value: 'team' },
+            ],
+        },
+    ]);
+    if (!answers.output || answers.volumetria === undefined || !answers.industry
+        || !answers.region || !answers.team) {
+        console.log(c.warn('Triage abortado (faltan respuestas).'));
+        return;
+    }
+    const { tier, reason } = classify(answers);
+    console.log('');
+    console.log(c.brand('Tier propuesto: ') + c.brand(tier.toUpperCase()));
+    console.log(c.dim('  Razon: ') + reason);
+    console.log('');
+    console.log(c.brand('Alcance del workflow para este tier:'));
+    console.log(describeAlcance(tier));
+    console.log('');
+    const confirm = await prompts({
+        type: 'select',
+        name: 'choice',
+        message: 'Confirmar tier?',
+        choices: [
+            { title: 'Confirmar ' + tier, value: 'confirm' },
+            { title: 'Override a SIMPLE (forzar workflow minimo)', value: 'simple' },
+            { title: 'Override a MEDIUM', value: 'medium' },
+            { title: 'Override a FULL (forzar workflow completo)', value: 'full' },
+            { title: 'Cancelar', value: 'cancel' },
+        ],
+    });
+    let finalTier;
+    let finalReason;
+    switch (confirm.choice) {
+        case 'confirm':
+            finalTier = tier;
+            finalReason = reason;
+            break;
+        case 'simple':
+            finalTier = 'simple';
+            finalReason = 'user override after auto: ' + tier;
+            break;
+        case 'medium':
+            finalTier = 'medium';
+            finalReason = 'user override after auto: ' + tier;
+            break;
+        case 'full':
+            finalTier = 'full';
+            finalReason = 'user override after auto: ' + tier;
+            break;
+        default:
+            console.log(c.warn('Triage cancelado.'));
+            return;
+    }
+    await writeWorkflow(projectRoot, {
+        tier: finalTier,
+        tier_reason: finalReason,
+        tier_decided_at: new Date().toISOString(),
+    });
+    console.log('');
+    console.log(c.success('Triage persistido. Tier: ' + c.brand(finalTier)));
+    console.log(c.dim('  Estado guardado en yujin.forge.json'));
+    console.log('');
+    console.log(c.dim('Siguiente paso: ') + c.code('yf discover'));
+}
+export function registerTriageCommand(program) {
+    program
+        .command('triage')
+        .description('Phase I step 1: classify project complexity (Simple / Medium / Full).')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--yes', 'overwrite a prior triage decision without prompting')
+        .action(async (opts) => {
+        try {
+            await runTriage(opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=triage.js.map

package/dist/commands/triage.js.map

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

package/dist/version.d.ts

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export declare const VERSION = "0.2.0-alpha.10";
+export declare const VERSION = "0.2.0-alpha.11";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export const VERSION = '0.2.0-alpha.10';
+export const VERSION = '0.2.0-alpha.11';
 //# sourceMappingURL=version.js.map

package/dist/workflow/state.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Yujin Forge -- Product Workflow state.
+ *
+ * Shared persistence layer for the 18-step methodology defined
+ * in docs/PRODUCT_WORKFLOW.md. State lives in the project's
+ * yujin.forge.json under `workflow.*` so it survives across
+ * sessions + can be inspected + shared via the git repo.
+ *
+ * Every command in the workflow (yf triage, yf discover, yf
+ * clarify, yf spec, yf approve, yf bootstrap, yf block dev, yf
+ * deploy, yf manual, yf metrics, yf iterate) reads + writes
+ * through this module. The chat tool surface (forge_triage,
+ * forge_discover, etc) does the same -- the underlying state
+ * is identical regardless of entry point.
+ *
+ * Schema:
+ *
+ *   workflow: {
+ *     tier: 'simple' | 'medium' | 'full' | null,
+ *     tier_reason: string,
+ *     tier_decided_at: ISO,
+ *
+ *     intent: { ... }                       // Phase I step 3
+ *     legacy_audit: { ... }                 // Phase I step 3.5
+ *     vault_inventory: { ... }              // Phase I step 2 audit
+ *
+ *     clarification: {
+ *       functional:        { done_at, summary, doc_path },   // step 4
+ *       nfr_quantitative:  { done_at, summary, doc_path },   // step 5
+ *       nfr_structural:    { done_at, summary, doc_path },   // step 6
+ *       nfr_governance:    { done_at, summary, doc_path },   // step 7
+ *       nfr_operational:   { done_at, summary, doc_path },   // step 8
+ *       blocks:            { done_at, blocks: [...] },       // step 9
+ *     },
+ *
+ *     specs: {
+ *       rfp:    { done_at, version, doc_path, sha256 },      // step 10
+ *       arch:   { done_at, version, doc_path, sha256 },      // step 11
+ *       design: { done_at, version, doc_path, sha256 },      // step 12
+ *     },
+ *
+ *     approvals: {
+ *       rfp:    { approved_at, version_sha256 },             // step 13
+ *       arch:   { approved_at, version_sha256 },             // step 13
+ *       design: { approved_at, version_sha256 },             // step 13
+ *     },
+ *
+ *     bootstrap: { done_at, stack, ci_set },                 // step 14
+ *
+ *     blocks_progress: [                                     // step 15
+ *       { block_id, status, tests_green_at, deployed_at }
+ *     ],
+ *
+ *     deploy:    { ... }                                     // step 16
+ *     postlaunch:{ ... }                                     // step 17
+ *     iterations:[{ at, type, summary }]                     // step 18
+ *   }
+ *
+ * ASCII-only.
+ */
+export type WorkflowTier = 'simple' | 'medium' | 'full';
+export interface IntentState {
+    operation: 'migrate' | 'new' | 'modify' | null;
+    target: 'desktop' | 'mobile' | 'responsive' | 'web-and-mobile' | null;
+    input_channel: 'chat-text' | 'voice' | 'document-paste' | null;
+    project_state: 'no-code' | 'local-repo' | 'remote-repo' | 'deployed' | null;
+    legacy_framework: string | null;
+    preferred_stack: string | null;
+    use_case: 'hobby' | 'poc' | 'internal' | 'commercial' | null;
+    decided_at: string;
+}
+export interface LegacyAuditState {
+    ran_at: string;
+    framework: string;
+    framework_version: string;
+    total_files: number;
+    tsx_files: number;
+    has_tests: boolean;
+    nac3_readiness: number;
+    tech_debt_signals: string[];
+    deprecated_deps: string[];
+}
+export interface VaultInventoryState {
+    ran_at: string;
+    /** Per family: configured | skipped | unknown.
+     *  Skipped families are flagged as debt for step 16 (deploy). */
+    families: Record<string, 'configured' | 'skipped' | 'unknown'>;
+}
+export interface ClarificationRoundState {
+    done_at: string;
+    summary: string;
+    doc_path?: string;
+}
+export interface BlockPlanItem {
+    id: string;
+    name: string;
+    effort: 'S' | 'M' | 'L' | 'XL';
+    dependencies: string[];
+    mvp: boolean;
+}
+export interface ClarificationState {
+    functional?: ClarificationRoundState;
+    nfr_quantitative?: ClarificationRoundState;
+    nfr_structural?: ClarificationRoundState;
+    nfr_governance?: ClarificationRoundState;
+    nfr_operational?: ClarificationRoundState;
+    blocks?: {
+        done_at: string;
+        blocks: BlockPlanItem[];
+        mvp_path: string[];
+    };
+}
+export interface SpecDocState {
+    done_at: string;
+    version: number;
+    doc_path: string;
+    sha256: string;
+}
+export interface ApprovalState {
+    approved_at: string;
+    version_sha256: string;
+}
+export interface BootstrapState {
+    done_at: string;
+    stack: string;
+    ci_set: boolean;
+}
+export interface BlockProgressState {
+    block_id: string;
+    status: 'pending' | 'in_progress' | 'green' | 'failed';
+    tests_green_at?: string;
+    deployed_at?: string;
+}
+export interface DeployState {
+    done_at: string;
+    pipeline: string;
+    url: string;
+    smoke_at: string;
+}
+export interface PostLaunchState {
+    manual_at: string;
+    dashboards_at: string;
+    feedback_channel: string;
+}
+export interface IterationEntry {
+    at: string;
+    type: 'bug' | 'feature_small' | 'feature_large' | 'nfr_change' | 'pivot';
+    summary: string;
+}
+export interface WorkflowState {
+    tier?: WorkflowTier;
+    tier_reason?: string;
+    tier_decided_at?: string;
+    intent?: IntentState;
+    legacy_audit?: LegacyAuditState;
+    vault_inventory?: VaultInventoryState;
+    clarification?: ClarificationState;
+    specs?: {
+        rfp?: SpecDocState;
+        arch?: SpecDocState;
+        design?: SpecDocState;
+    };
+    approvals?: {
+        rfp?: ApprovalState;
+        arch?: ApprovalState;
+        design?: ApprovalState;
+    };
+    bootstrap?: BootstrapState;
+    blocks_progress?: BlockProgressState[];
+    deploy?: DeployState;
+    postlaunch?: PostLaunchState;
+    iterations?: IterationEntry[];
+}
+interface ProjectConfig {
+    workflow?: WorkflowState;
+    [key: string]: unknown;
+}
+export declare function loadConfig(projectRoot: string): Promise<ProjectConfig>;
+export declare function saveConfig(projectRoot: string, cfg: ProjectConfig): Promise<void>;
+export declare function readWorkflow(projectRoot: string): Promise<WorkflowState>;
+export declare function writeWorkflow(projectRoot: string, patch: Partial<WorkflowState>): Promise<WorkflowState>;
+/** Update a NESTED key under workflow.<group> (clarification,
+ *  specs, approvals, blocks_progress) without overwriting sibling
+ *  keys at the same level. */
+export declare function patchWorkflowGroup<K extends keyof WorkflowState>(projectRoot: string, group: K, patch: Partial<NonNullable<WorkflowState[K]>>): Promise<WorkflowState>;
+/** Append to workflow.iterations[]. Idempotent: callers should
+ *  generate a unique-ish `at` per call so duplicates do not stack. */
+export declare function appendIteration(projectRoot: string, entry: IterationEntry): Promise<WorkflowState>;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/workflow/state.d.ts.map

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

package/dist/workflow/state.js

@@ -0,0 +1,119 @@
+/**
+ * Yujin Forge -- Product Workflow state.
+ *
+ * Shared persistence layer for the 18-step methodology defined
+ * in docs/PRODUCT_WORKFLOW.md. State lives in the project's
+ * yujin.forge.json under `workflow.*` so it survives across
+ * sessions + can be inspected + shared via the git repo.
+ *
+ * Every command in the workflow (yf triage, yf discover, yf
+ * clarify, yf spec, yf approve, yf bootstrap, yf block dev, yf
+ * deploy, yf manual, yf metrics, yf iterate) reads + writes
+ * through this module. The chat tool surface (forge_triage,
+ * forge_discover, etc) does the same -- the underlying state
+ * is identical regardless of entry point.
+ *
+ * Schema:
+ *
+ *   workflow: {
+ *     tier: 'simple' | 'medium' | 'full' | null,
+ *     tier_reason: string,
+ *     tier_decided_at: ISO,
+ *
+ *     intent: { ... }                       // Phase I step 3
+ *     legacy_audit: { ... }                 // Phase I step 3.5
+ *     vault_inventory: { ... }              // Phase I step 2 audit
+ *
+ *     clarification: {
+ *       functional:        { done_at, summary, doc_path },   // step 4
+ *       nfr_quantitative:  { done_at, summary, doc_path },   // step 5
+ *       nfr_structural:    { done_at, summary, doc_path },   // step 6
+ *       nfr_governance:    { done_at, summary, doc_path },   // step 7
+ *       nfr_operational:   { done_at, summary, doc_path },   // step 8
+ *       blocks:            { done_at, blocks: [...] },       // step 9
+ *     },
+ *
+ *     specs: {
+ *       rfp:    { done_at, version, doc_path, sha256 },      // step 10
+ *       arch:   { done_at, version, doc_path, sha256 },      // step 11
+ *       design: { done_at, version, doc_path, sha256 },      // step 12
+ *     },
+ *
+ *     approvals: {
+ *       rfp:    { approved_at, version_sha256 },             // step 13
+ *       arch:   { approved_at, version_sha256 },             // step 13
+ *       design: { approved_at, version_sha256 },             // step 13
+ *     },
+ *
+ *     bootstrap: { done_at, stack, ci_set },                 // step 14
+ *
+ *     blocks_progress: [                                     // step 15
+ *       { block_id, status, tests_green_at, deployed_at }
+ *     ],
+ *
+ *     deploy:    { ... }                                     // step 16
+ *     postlaunch:{ ... }                                     // step 17
+ *     iterations:[{ at, type, summary }]                     // step 18
+ *   }
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+const CONFIG_FILE = 'yujin.forge.json';
+function configPath(projectRoot) {
+    return path.join(projectRoot, CONFIG_FILE);
+}
+export async function loadConfig(projectRoot) {
+    try {
+        const raw = await fs.readFile(configPath(projectRoot), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object')
+            return parsed;
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT'
+            && !(err instanceof SyntaxError)) {
+            throw err;
+        }
+    }
+    return {};
+}
+export async function saveConfig(projectRoot, cfg) {
+    const text = JSON.stringify(cfg, null, 2) + '\n';
+    await fs.writeFile(configPath(projectRoot), text, 'utf-8');
+}
+export async function readWorkflow(projectRoot) {
+    const cfg = await loadConfig(projectRoot);
+    return cfg.workflow ?? {};
+}
+export async function writeWorkflow(projectRoot, patch) {
+    const cfg = await loadConfig(projectRoot);
+    cfg.workflow = { ...(cfg.workflow ?? {}), ...patch };
+    await saveConfig(projectRoot, cfg);
+    return cfg.workflow;
+}
+/** Update a NESTED key under workflow.<group> (clarification,
+ *  specs, approvals, blocks_progress) without overwriting sibling
+ *  keys at the same level. */
+export async function patchWorkflowGroup(projectRoot, group, patch) {
+    const cfg = await loadConfig(projectRoot);
+    const wf = cfg.workflow ?? {};
+    const prev = (wf[group] ?? {});
+    const merged = { ...prev, ...patch };
+    cfg.workflow = { ...wf, [group]: merged };
+    await saveConfig(projectRoot, cfg);
+    return cfg.workflow;
+}
+/** Append to workflow.iterations[]. Idempotent: callers should
+ *  generate a unique-ish `at` per call so duplicates do not stack. */
+export async function appendIteration(projectRoot, entry) {
+    const cfg = await loadConfig(projectRoot);
+    const wf = cfg.workflow ?? {};
+    const list = Array.isArray(wf.iterations) ? wf.iterations : [];
+    list.push(entry);
+    cfg.workflow = { ...wf, iterations: list };
+    await saveConfig(projectRoot, cfg);
+    return cfg.workflow;
+}
+//# sourceMappingURL=state.js.map

package/dist/workflow/state.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "0.2.0-alpha.10",
+  "version": "0.2.0-alpha.11",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",