@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/commands/bootstrap.js

@@ -0,0 +1,205 @@
+/**
+ * `yf bootstrap` -- Phase V step 14 of PRODUCT_WORKFLOW.md.
+ *
+ * Once Phase IV (approve) passes the three spec gates, this
+ * command initialises the project for the iterative build cycle:
+ *
+ *   * Reads workflow.specs + workflow.clarification.blocks
+ *   * Scaffolds the project shell (delegates to template engine
+ *     if the project is brand-new; no-ops if code already exists)
+ *   * Installs NAC-3 compliance baseline (5 attrs on the shell +
+ *     manifest stub)
+ *   * Sets CI gates (lint + typecheck + tests + visual + a11y +
+ *     NAC-3 manifest check)
+ *   * Sets up test scaffolding per layer (unit / integration /
+ *     e2e / visual / a11y)
+ *   * Sets up observability hooks (logger + optional Sentry)
+ *   * Initialises blocks_progress = [{ block_id, status: pending }]
+ *     for every block in workflow.clarification.blocks
+ *
+ * For alpha.15 the bootstrap is a thin shell -- it sets the
+ * workflow state + writes scaffolding markers + the actual
+ * heavy lifting (templates, CI config generation, observability
+ * wiring) lands incrementally in follow-up commits.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, patchWorkflowGroup, writeWorkflow, } from '../workflow/state.js';
+const DEFAULT_STACK = 'React + Vite + TypeScript + Vitest + Playwright + NAC-3';
+async function ensureGitIgnoreHas(projectRoot, patterns) {
+    const giPath = path.join(projectRoot, '.gitignore');
+    let current = '';
+    try {
+        current = await fs.readFile(giPath, 'utf-8');
+    }
+    catch {
+        current = '';
+    }
+    const lines = new Set(current.split(/\r?\n/));
+    for (const p of patterns)
+        lines.add(p);
+    await fs.writeFile(giPath, [...lines].filter(Boolean).join('\n') + '\n', 'utf-8');
+}
+async function ensureFile(p, contents) {
+    try {
+        await fs.access(p);
+        return false;
+    }
+    catch { /* not present */ }
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, contents, 'utf-8');
+    return true;
+}
+export async function runBootstrap(opts) {
+    header('Yujin Forge -- bootstrap');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    const wf = await readWorkflow(projectRoot);
+    /* Gate: Phase IV must have approved all 3 docs with current
+     * sha256 matching. */
+    const docs = ['rfp', 'arch', 'design'];
+    for (const d of docs) {
+        const sp = wf.specs?.[d];
+        const ap = wf.approvals?.[d];
+        if (!sp || !ap) {
+            console.log(c.error('Phase IV gate no aprobado todavia (' + d + ' falta).'));
+            console.log(c.dim('Corre: ') + c.code('yf approve ' + d));
+            process.exitCode = 1;
+            return;
+        }
+        if (ap.version_sha256 !== sp.sha256) {
+            console.log(c.error('Approval STALE para ' + d + '. Doc cambio desde la aprobacion.'));
+            console.log(c.dim('Re-aprueba: ') + c.code('yf approve ' + d));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    if (wf.bootstrap && !opts.yes) {
+        console.log(c.warn('Bootstrap previo en ' + wf.bootstrap.done_at + '.'));
+        console.log(c.dim('Para volver a correr, ') + c.code('yf bootstrap --yes'));
+        return;
+    }
+    const stack = opts.stack || DEFAULT_STACK;
+    const blocks = wf.clarification?.blocks?.blocks ?? [];
+    if (blocks.length === 0) {
+        console.log(c.error('No hay bloques definidos en workflow.clarification.blocks.'));
+        console.log(c.dim('Corre: ') + c.code('yf clarify blocks'));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(c.dim('Stack:        ') + c.brand(stack));
+    console.log(c.dim('Blocks:       ') + c.brand(String(blocks.length) + ' identificados'));
+    console.log(c.dim('Project root: ') + c.dim(projectRoot));
+    console.log('');
+    /* 1. Ensure a NAC-3 manifest stub exists. */
+    const manifestPath = path.join(projectRoot, 'src', 'nac', 'manifest.ts');
+    const wroteManifest = await ensureFile(manifestPath, [
+        '/**',
+        ' * NAC-3 manifest stub generated by `yf bootstrap`.',
+        ' * Forge populates this as you decorate components per block.',
+        ' */',
+        "import { defineNacManifest } from '@nac3/runtime';",
+        '',
+        'export const manifest = defineNacManifest({',
+        '  app_name: "' + path.basename(projectRoot) + '",',
+        '  version:  "0.0.1",',
+        '  elements: [',
+        '    /* Populated per block. See docs/project_design.md. */',
+        '  ],',
+        '});',
+        '',
+    ].join('\n'));
+    if (wroteManifest)
+        console.log(c.success('  +') + c.dim(' src/nac/manifest.ts'));
+    /* 2. CI workflow stub at .github/workflows/ci.yml if missing. */
+    const ciPath = path.join(projectRoot, '.github', 'workflows', 'ci.yml');
+    const wroteCi = await ensureFile(ciPath, [
+        'name: CI',
+        'on: { push: { branches: [main] }, pull_request: {} }',
+        'jobs:',
+        '  test:',
+        '    runs-on: ubuntu-latest',
+        '    steps:',
+        '      - uses: actions/checkout@v4',
+        '      - uses: actions/setup-node@v4',
+        '        with: { node-version: "20", cache: "npm" }',
+        '      - run: npm ci',
+        '      - run: npx yf doctor --json',
+        '      - run: npm run lint --if-present',
+        '      - run: npm run typecheck --if-present',
+        '      - run: npm test --if-present',
+        '      - run: npx yf coverage structural --if-failing-exit-1',
+        '',
+    ].join('\n'));
+    if (wroteCi)
+        console.log(c.success('  +') + c.dim(' .github/workflows/ci.yml'));
+    /* 3. tests/fresh-user/ scaffold (per SQ Sec 14). */
+    const fuReadme = path.join(projectRoot, 'tests', 'fresh-user', 'README.md');
+    const wroteFu = await ensureFile(fuReadme, [
+        '# tests/fresh-user/',
+        '',
+        'Per Yujin Forge SQ Sec 14, every feature in this project has',
+        'a fresh-user e2e test: clean state -> exercise feature -> assert.',
+        '',
+        'Forge generates one of these per block as part of the',
+        '`yf block dev <block_id>` cycle.',
+        '',
+    ].join('\n'));
+    if (wroteFu)
+        console.log(c.success('  +') + c.dim(' tests/fresh-user/README.md'));
+    /* 4. .gitignore additions. */
+    await ensureGitIgnoreHas(projectRoot, [
+        'node_modules',
+        'dist', 'build', '.next',
+        'coverage', '.cache',
+        '.env', '.env.local',
+        '.yujin-forge',
+        'yujin.forge.cache',
+    ]);
+    console.log(c.success('  +') + c.dim(' .gitignore patterns'));
+    /* 5. Initialise blocks_progress for every block in workflow. */
+    const blocks_progress = blocks.map((b) => ({
+        block_id: b.id,
+        status: 'pending',
+    }));
+    await writeWorkflow(projectRoot, { blocks_progress });
+    console.log(c.success('  +') + c.dim(' blocks_progress[] initialised (' + blocks.length + ' bloques pending)'));
+    /* 6. Persist bootstrap state. */
+    await patchWorkflowGroup(projectRoot, 'bootstrap', {
+        done_at: new Date().toISOString(),
+        stack,
+        ci_set: true,
+    });
+    console.log('');
+    console.log(c.success('Bootstrap completado.'));
+    console.log('');
+    /* Suggest the first MVP block. */
+    const mvp = wf.clarification?.blocks?.mvp_path ?? [];
+    const firstBlock = mvp[0] ?? blocks[0]?.id;
+    if (firstBlock) {
+        console.log(c.dim('Primer bloque sugerido: ') + c.code('yf block dev ' + firstBlock));
+    }
+    else {
+        console.log(c.dim('Siguiente paso: ') + c.code('yf block dev <block_id>'));
+    }
+}
+export function registerBootstrapCommand(program) {
+    program.command('bootstrap')
+        .description('Phase V step 14: initialise project (NAC-3 baseline + CI + tests + observability).')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--yes', 're-run even if bootstrap already done')
+        .option('--stack <name>', 'override the default stack label')
+        .action(async (opts) => {
+        try {
+            await runBootstrap(opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

package/dist/commands/brain.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `yf brain` CLI -- brain tier configuration + introspection
+ * (alpha.51).
+ *
+ * Subcommands:
+ *   yf brain config --show
+ *   yf brain config --eco-provider <p> --eco-model <m>
+ *   yf brain config --frontier-provider <p> --frontier-model <m>
+ *   yf brain config --chat-default-tier <eco|frontier>
+ *   yf brain config --reset
+ *   yf brain tiers           -- list which verb maps to which tier
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export declare function registerBrainCommand(program: Command): void;
+//# sourceMappingURL=brain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/commands/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqI3D"}

package/dist/commands/brain.js

@@ -0,0 +1,129 @@
+import { readBrainConfig, setTierBinding, setChatDefaultTier, resetBrainConfig, ALL_BRAIN_PROVIDERS, vaultSlotForProvider, } from '../core/brain_config.js';
+import { hasKey } from '../core/provider_keys.js';
+import { listMapping, tierStats } from '../nac3/verb_tier_map.js';
+import { setLocalPlanOverride, isPlanSlug, listPlanSlugs, readBudgetStatus, } from '../core/budget.js';
+function isBrainProvider(s) {
+    return ALL_BRAIN_PROVIDERS.includes(s);
+}
+export function registerBrainCommand(program) {
+    const brain = program.command('brain')
+        .description('Brain tier configuration (eco + frontier per-provider routing).');
+    const config = brain.command('config')
+        .description('Read or update brain config (which provider + model serves each tier).')
+        .option('--show', 'Print the active config + key status per tier.')
+        .option('--eco-provider <provider>', 'Provider for the eco tier (e.g. google_ai, anthropic).')
+        .option('--eco-model <model>', 'Model id for the eco tier (e.g. gemini-2.5-flash-lite).')
+        .option('--frontier-provider <provider>', 'Provider for the frontier tier.')
+        .option('--frontier-model <model>', 'Model id for the frontier tier (e.g. claude-opus-4-7).')
+        .option('--chat-default-tier <tier>', 'Default tier when the router cannot infer (eco | frontier).')
+        .option('--plan <slug>', 'Local plan override (' + listPlanSlugs().join(' | ') + '). Use "clear" to remove.')
+        .option('--reset', 'Reset to factory defaults.')
+        .action(async (opts) => {
+        if (opts.reset) {
+            const cfg = await resetBrainConfig();
+            console.log('brain config reset to defaults.');
+            console.log(JSON.stringify(cfg, null, 2));
+            return;
+        }
+        let mutated = false;
+        /* Eco mutations. */
+        if (opts.ecoProvider !== undefined || opts.ecoModel !== undefined) {
+            const cur = await readBrainConfig();
+            const provider = opts.ecoProvider ?? cur.eco.provider;
+            const model = opts.ecoModel ?? cur.eco.model;
+            if (!isBrainProvider(provider)) {
+                throw new Error('--eco-provider must be one of: ' + ALL_BRAIN_PROVIDERS.join(', '));
+            }
+            await setTierBinding('eco', provider, model);
+            mutated = true;
+        }
+        /* Frontier mutations. */
+        if (opts.frontierProvider !== undefined || opts.frontierModel !== undefined) {
+            const cur = await readBrainConfig();
+            const provider = opts.frontierProvider ?? cur.frontier.provider;
+            const model = opts.frontierModel ?? cur.frontier.model;
+            if (!isBrainProvider(provider)) {
+                throw new Error('--frontier-provider must be one of: ' + ALL_BRAIN_PROVIDERS.join(', '));
+            }
+            await setTierBinding('frontier', provider, model);
+            mutated = true;
+        }
+        /* Chat default tier. */
+        if (opts.chatDefaultTier !== undefined) {
+            const t = opts.chatDefaultTier.toLowerCase();
+            if (t !== 'eco' && t !== 'frontier') {
+                throw new Error('--chat-default-tier must be "eco" or "frontier"');
+            }
+            await setChatDefaultTier(t);
+            mutated = true;
+        }
+        /* Local plan override (alpha.55). */
+        if (opts.plan !== undefined) {
+            const p = opts.plan.toLowerCase();
+            if (p === 'clear' || p === 'none' || p === '') {
+                await setLocalPlanOverride(null);
+            }
+            else if (isPlanSlug(p)) {
+                await setLocalPlanOverride(p);
+            }
+            else {
+                throw new Error('--plan must be one of: ' + listPlanSlugs().join(', ') + ' (or "clear" to remove the override)');
+            }
+            mutated = true;
+        }
+        const cfg = await readBrainConfig();
+        if (opts.show || !mutated) {
+            const ecoHasKey = await hasKey(vaultSlotForProvider(cfg.eco.provider));
+            const frontierHasKey = await hasKey(vaultSlotForProvider(cfg.frontier.provider));
+            const budget = await readBudgetStatus();
+            console.log(JSON.stringify({
+                eco: {
+                    ...cfg.eco,
+                    api_key_slot: vaultSlotForProvider(cfg.eco.provider),
+                    api_key_configured: ecoHasKey,
+                },
+                frontier: {
+                    ...cfg.frontier,
+                    api_key_slot: vaultSlotForProvider(cfg.frontier.provider),
+                    api_key_configured: frontierHasKey,
+                },
+                chat_default_tier: cfg.chat_default_tier,
+                provider_options: ALL_BRAIN_PROVIDERS,
+                plan: {
+                    slug: budget.plan,
+                    label: budget.plan_label,
+                    renewal_at: budget.renewal_at,
+                    eco_cap: Number.isFinite(budget.eco.cap) ? budget.eco.cap : null,
+                    frontier_cap: Number.isFinite(budget.frontier.cap) ? budget.frontier.cap : null,
+                },
+                plan_options: listPlanSlugs(),
+            }, null, 2));
+        }
+        else {
+            console.log('brain config updated.');
+        }
+    });
+    brain.command('tiers')
+        .description('List each NAC3 verb + its configured brain tier (Forge-only mapping).')
+        .option('--json', 'Emit JSON instead of human-readable rows.')
+        .action(async (opts) => {
+        const rows = listMapping();
+        if (opts.json) {
+            console.log(JSON.stringify({ stats: tierStats(), verbs: rows }, null, 2));
+            return;
+        }
+        const stats = tierStats();
+        console.log('Tier mapping (' + rows.length + ' verbs):');
+        console.log('  eco:      ' + stats.eco);
+        console.log('  frontier: ' + stats.frontier);
+        console.log('  mixto:    ' + stats.mixto);
+        console.log('  none:     ' + stats.none);
+        console.log('');
+        for (const r of rows) {
+            console.log('  ' + r.tier.padEnd(9) + r.verb_id);
+        }
+    });
+    /* Required so commander does not see config as orphan. */
+    void config;
+}
+//# sourceMappingURL=brain.js.map

package/dist/commands/brain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.js","sourceRoot":"","sources":["../../src/commands/brain.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,eAAe,EAAE,cAAc,EAAE,kBAAkB,EACnD,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,GAE5D,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,oBAAoB,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,GAClE,MAAM,mBAAmB,CAAC;AAE3B,SAAS,eAAe,CAAC,CAAS;IAChC,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;SACnC,WAAW,CAAC,iEAAiE,CAAC,CAAC;IAElF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;SACnC,WAAW,CAAC,wEAAwE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,gDAAgD,CAAC;SAClE,MAAM,CAAC,2BAA2B,EAAE,wDAAwD,CAAC;SAC7F,MAAM,CAAC,qBAAqB,EAAE,yDAAyD,CAAC;SACxF,MAAM,CAAC,gCAAgC,EAAE,iCAAiC,CAAC;SAC3E,MAAM,CAAC,0BAA0B,EAAE,wDAAwD,CAAC;SAC5F,MAAM,CAAC,4BAA4B,EAAE,6DAA6D,CAAC;SACnG,MAAM,CAAC,eAAe,EAAE,uBAAuB,GAAG,aAAa,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,2BAA2B,CAAC;SAC5G,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,IAOd,EAAE,EAAE;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,oBAAoB;QACpB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;YAC7C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,yBAAyB;QACzB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC5E,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAChE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3F,CAAC;YACD,MAAM,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,kBAAkB,CAAC,CAAuB,CAAC,CAAC;YAClD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,qCAAqC;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC9C,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,sCAAsC,CAAC,CAAC;YACnH,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvE,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzB,GAAG,EAAE;oBACH,GAAG,GAAG,CAAC,GAAG;oBACV,YAAY,EAAE,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;oBACpD,kBAAkB,EAAE,SAAS;iBAC9B;gBACD,QAAQ,EAAE;oBACR,GAAG,GAAG,CAAC,QAAQ;oBACf,YAAY,EAAE,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACzD,kBAAkB,EAAE,cAAc;iBACnC;gBACD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;gBACxC,gBAAgB,EAAE,mBAAmB;gBACrC,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,KAAK,EAAE,MAAM,CAAC,UAAU;oBACxB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;oBAChE,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;iBAChF;gBACD,YAAY,EAAE,aAAa,EAAE;aAC9B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;SACnB,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,QAAQ,EAAE,2CAA2C,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,0DAA0D;IAC1D,KAAK,MAAM,CAAC;AACd,CAAC"}

package/dist/commands/chat.d.ts

@@ -11,6 +11,9 @@ export interface ChatOptions {
     voice?: boolean;
     port?: number;
     cwd?: string;
+    /** Open the default browser at the panel URL on startup.
+     *  Default true; flip with `--no-open` for CI / headless. */
+    open?: boolean;
     /** Test mode: start + return without blocking. */
     detach?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsE1D"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;iEAC6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2FD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgF1D"}

package/dist/commands/chat.js

@@ -1,8 +1,108 @@
 import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs';
+import { spawn } from 'node:child_process';
 import { c, header } from '../ui/colors.js';
 import { startChatServer } from '../chat/server.js';
 import { loadLicense, isAuthorized } from '../license/index.js';
 import { inspectRepoState, formatRepoStateWarning } from '../core/repo_state.js';
+/** Best-effort cross-platform "open URL in default browser".
+ *  alpha.36 -- tries Chrome/Edge in --app mode first (no URL bar,
+ *  no tabs, no extensions; standalone window). Falls through to
+ *  the OS default browser if Chrome / Edge are absent. Per Pablo:
+ *  "que abra default en Full Screen headless".
+ *  No throw on failure -- the URL is still printed to stdout. */
+function openInBrowser(url) {
+    const platform = os.platform();
+    const candidates = chromeAppCandidates(platform);
+    /* Try each Chrome / Edge binary in order. First one that spawns
+     * wins; we use `--app=URL` for an app-mode window (chromeless). */
+    for (const candidate of candidates) {
+        const bin = candidate[0];
+        if (!bin)
+            continue;
+        const prefixArgs = candidate.slice(1);
+        if (tryAppMode(bin, prefixArgs, url))
+            return;
+    }
+    /* Fallback: OS default browser (Firefox, Safari, anything). */
+    fallbackOpen(platform, url);
+}
+function chromeAppCandidates(platform) {
+    if (platform === 'win32') {
+        return [
+            ['C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'],
+            ['C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe'],
+            ['C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'],
+            ['C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe'],
+        ];
+    }
+    if (platform === 'darwin') {
+        return [
+            ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'],
+            ['/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge'],
+        ];
+    }
+    /* Linux / BSD -- common $PATH names. spawn() resolves these
+     * against PATH; absence -> ENOENT -> we move on. */
+    return [
+        ['google-chrome'],
+        ['google-chrome-stable'],
+        ['chromium'],
+        ['chromium-browser'],
+        ['microsoft-edge'],
+    ];
+}
+function tryAppMode(bin, prefixArgs, url) {
+    /* Synchronously check the path exists (Windows + macOS) before
+     * spawning, so we don't print spurious 'ENOENT' to stderr. */
+    if (bin.startsWith('/') || bin.includes(':\\')) {
+        try {
+            if (!fs.existsSync(bin))
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        const args = [
+            ...prefixArgs,
+            '--app=' + url,
+            '--no-first-run',
+            '--no-default-browser-check',
+        ];
+        const child = spawn(bin, args, { stdio: 'ignore', detached: true, shell: false });
+        child.on('error', () => { });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function fallbackOpen(platform, url) {
+    let cmd;
+    let args;
+    if (platform === 'win32') {
+        cmd = 'cmd';
+        args = ['/s', '/c', 'start', '""', url];
+    }
+    else if (platform === 'darwin') {
+        cmd = 'open';
+        args = [url];
+    }
+    else {
+        cmd = 'xdg-open';
+        args = [url];
+    }
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true, shell: false });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch { /* swallow */ }
+}
 export function registerChatCommand(program) {
     program
         .command('chat')
@@ -10,6 +110,7 @@ export function registerChatCommand(program) {
         .option('--no-voice', 'disable voice input (the panel ships voice as a stub today either way)')
         .option('-p, --port <port>', 'panel server port', (v) => parseInt(v, 10), 4847)
         .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--no-open', 'do NOT auto-open the panel URL in the default browser (default: open)')
         .action(async (opts) => {
         header('Yujin Forge -- chat');
         console.log('');
@@ -51,7 +152,17 @@ export function registerChatCommand(program) {
             console.log(c.warn(warn));
         }
         console.log('');
-        console.log(c.dim('Open the URL in your browser. Press Ctrl+C to stop.'));
+        /* Auto-open the panel URL in the user's default browser.
+         *  Off-switch: `--no-open`. Commander negates `--no-open`
+         *  to opts.open=false; default is true. */
+        const shouldOpen = opts.open !== false && !opts.detach;
+        if (shouldOpen) {
+            openInBrowser(started.url);
+            console.log(c.dim('Opening the panel in your default browser. Press Ctrl+C to stop.'));
+        }
+        else {
+            console.log(c.dim('Open the URL above in your browser. Press Ctrl+C to stop.'));
+        }
         console.log('');
         if (opts.detach) {
             // Test path: don't block, let the caller close().

package/dist/commands/chat.js.map

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

package/dist/commands/clarify.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `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 type { Command } from 'commander';
+type Round = 'functional' | 'quantitative' | 'structural' | 'governance' | 'operational' | 'blocks';
+export declare function runClarify(round: Round, cwd?: string): Promise<void>;
+export declare function registerClarifyCommand(program: Command): void;
+export {};
+//# sourceMappingURL=clarify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.d.ts","sourceRoot":"","sources":["../../src/commands/clarify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,KAAK,KAAK,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAC5C,YAAY,GAAG,aAAa,GAAG,QAAQ,CAAC;AAonBrD,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC1E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB7D"}