@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

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":"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"}

package/dist/commands/chat.d.ts

@@ -16,6 +16,16 @@ export interface ChatOptions {
     open?: boolean;
     /** Test mode: start + return without blocking. */
     detach?: boolean;
+    /** LLM provider for chat turns. Default 'anthropic-api' (Console
+     *  billing via the Anthropic HTTP SDK). Set 'claude-code-cli' to
+     *  route every turn through a `claude -p` subprocess instead,
+     *  which bills against the Claude Code subscription instead of
+     *  Console. */
+    provider?: 'anthropic-api' | 'claude-code-cli';
+    /** When --provider=claude-code-cli, additional directories the
+     *  subprocess may read/write in (passed as --add-dir to claude).
+     *  Comma-separated. */
+    providerAddDirs?: string;
 }
 export declare function registerChatCommand(program: Command): void;
 //# sourceMappingURL=chat.d.ts.map

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;AASzC,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;AAgCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgF1D"}
+{"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;AAWzC,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;IACjB;;;;mBAIe;IACf,QAAQ,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAC/C;;2BAEuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2FD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuL1D"}