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

package/dist/commands/spec.js

@@ -0,0 +1,256 @@
+/**
+ * `yf spec rfp|arch|design` -- Phase III of PRODUCT_WORKFLOW.md
+ * (steps 10, 11, 12).
+ *
+ * Generates the three foundational documents that Phase IV gates
+ * on:
+ *
+ *   yf spec rfp     step 10 -- consolidated RFP / PRD
+ *   yf spec arch    step 11 -- technological architecture
+ *   yf spec design  step 12 -- solution design (per block)
+ *
+ * Each command:
+ *   1. Verifies Phase II is complete (functional + 4 NFR rounds +
+ *      blocks). For RFP, all 6 are required. For arch + design,
+ *      RFP must be done too.
+ *   2. Reads the markdown clarification docs from
+ *      docs/clarification/0X_<round>.md.
+ *   3. Calls Claude with the document-specific generation prompt.
+ *   4. Writes the result to docs/project_<doc>.md.
+ *   5. Persists workflow.specs.<doc> with version, doc_path,
+ *      sha256.
+ *
+ * Per HITO_4_STRATEGIC_ASSETS.md sec 1, the Tier-1 strategic
+ * prompts for these flows are eventually moving server-side to
+ * prompts.yujin.app. Today they live client-side as a stub --
+ * the system prompt is generic; a follow-up commit replaces it
+ * with the curated server-side endpoint when the Yujin server
+ * exposes them.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { c, header } from '../ui/colors.js';
+import { ClaudeClient } from '../chat/claude.js';
+import { readWorkflow, patchWorkflowGroup, } from '../workflow/state.js';
+const DOC_FILENAME = {
+    rfp: 'project_rfp.md',
+    arch: 'project_architecture.md',
+    design: 'project_design.md',
+};
+const DOC_TITLE = {
+    rfp: 'RFP / PRD',
+    arch: 'Architecture',
+    design: 'Solution Design',
+};
+const CLARIFICATION_FILES = [
+    '04_functional.md',
+    '05_quantitative.md',
+    '06_structural.md',
+    '07_governance.md',
+    '08_operational.md',
+    '09_blocks.md',
+];
+async function readAllClarification(projectRoot) {
+    const dir = path.join(projectRoot, 'docs', 'clarification');
+    const parts = [];
+    for (const name of CLARIFICATION_FILES) {
+        try {
+            const text = await fs.readFile(path.join(dir, name), 'utf-8');
+            parts.push('===== ' + name + ' =====\n' + text);
+        }
+        catch { /* skip missing files */ }
+    }
+    return parts.join('\n\n');
+}
+function buildSystemPromptFor(kind) {
+    /* TODO(HITO-4): move these to prompts.yujin.app endpoints. */
+    const common = [
+        'You are Yujin Forge generating a foundational project document.',
+        'Read the supplied clarification rounds + workflow state and emit',
+        'a single, well-structured markdown document.',
+        'Output ASCII-only. Use sections + lists, NOT free prose.',
+        'Do not invent facts not present in the clarification rounds. If',
+        'something is missing, write "TBD: <what the user must define>".',
+    ].join(' ');
+    switch (kind) {
+        case 'rfp':
+            return common + '\n\nDocument type: **RFP / PRD**. Structure:\n'
+                + '1. Vision + objetivo del producto\n'
+                + '2. Personas + user stories\n'
+                + '3. Killer features + MVP slice\n'
+                + '4. Bloques + orden\n'
+                + '5. NFR cuantitativas (volumetria, paralelismo, complejidad)\n'
+                + '6. NFR estructurales (persistencia, middleware, modelo objeto)\n'
+                + '7. NFR de gobernanza (compliance, audit, retention)\n'
+                + '8. NFR de operacion (i18n, a11y, monitoring, costos)\n'
+                + '9. Acceptance criteria por bloque\n';
+        case 'arch':
+            return common + '\n\nDocument type: **Technological architecture**.\n'
+                + 'Structure (driven by NFR decisions from clarification step 5+6+8):\n'
+                + '1. Stack elegido + justificacion\n'
+                + '2. Layering (frontend / backend / data / async)\n'
+                + '3. Topologia de deployment (single instance / multi-region / serverless / edge)\n'
+                + '4. Estrategia async (sync only / queue + workers / event bus / saga)\n'
+                + '5. Persistence model + ERD inicial textual\n'
+                + '6. Middleware stack (concretado del step 6)\n'
+                + '7. Security model (auth, authz, encryption, secrets)\n'
+                + '8. Observability (logs, metrics, traces, alertas del step 8)\n'
+                + '9. Compliance hooks (per step 7 decisions)\n'
+                + '10. Costos esperados (modelado de step 8)\n';
+        case 'design':
+            return common + '\n\nDocument type: **Solution design per block**.\n'
+                + 'For each block in workflow.clarification.blocks, write a section with:\n'
+                + '1. Data model (tables + relaciones + indices)\n'
+                + '2. API contracts (endpoints + payloads + responses + errores)\n'
+                + '3. Screens / pages (wireframes ascii o links a figma)\n'
+                + '4. State machines (si aplica per step 5)\n'
+                + '5. Sequence diagrams (las 2-3 secuencias mas complejas, textuales)\n'
+                + '6. Edge cases identificados + estrategia\n'
+                + '7. Test cases obligatorios (e2e + structural)\n'
+                + '8. NAC-3 attributes (preview del manifest)\n';
+    }
+}
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf-8').digest('hex');
+}
+async function runSpec(kind, opts) {
+    header('Yujin Forge -- spec ' + kind);
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    const wf = await readWorkflow(projectRoot);
+    /* Pre-requisites. */
+    const cl = wf.clarification;
+    if (!cl?.functional || !cl?.nfr_quantitative || !cl?.nfr_structural
+        || !cl?.nfr_governance || !cl?.nfr_operational || !cl?.blocks) {
+        console.log(c.error('Clarification (Phase II) incompleta. Falta al menos una ronda.'));
+        console.log(c.dim('Corre: ') + c.code('yf clarify functional') + c.dim(' ... seguir hasta blocks.'));
+        process.exitCode = 1;
+        return;
+    }
+    if ((kind === 'arch' || kind === 'design') && !wf.specs?.rfp) {
+        console.log(c.error('RFP debe estar generado primero.'));
+        console.log(c.dim('Corre: ') + c.code('yf spec rfp'));
+        process.exitCode = 1;
+        return;
+    }
+    const existing = wf.specs?.[kind];
+    if (existing && !opts.yes) {
+        console.log(c.warn('Ya existe ') + c.brand(DOC_FILENAME[kind])
+            + c.warn(' (version ' + existing.version + ').'));
+        console.log(c.dim('Para regenerar, corre con ') + c.code('--yes'));
+        return;
+    }
+    /* Build the context. */
+    const clarificationDump = await readAllClarification(projectRoot);
+    if (clarificationDump.trim() === '') {
+        console.log(c.error('No se encontraron docs en docs/clarification/. Re-corre las rondas.'));
+        process.exitCode = 1;
+        return;
+    }
+    /* If generating arch or design, also feed the RFP. */
+    let priorDocs = '';
+    if (kind === 'arch' || kind === 'design') {
+        try {
+            const rfpText = await fs.readFile(path.join(projectRoot, 'docs', wf.specs.rfp.doc_path.replace(/^docs\//, '')), 'utf-8');
+            priorDocs += '\n\n===== EXISTING RFP =====\n' + rfpText;
+        }
+        catch { /* may not exist if doc_path was relative differently */ }
+    }
+    if (kind === 'design' && wf.specs?.arch) {
+        try {
+            const archText = await fs.readFile(path.join(projectRoot, 'docs', wf.specs.arch.doc_path.replace(/^docs\//, '')), 'utf-8');
+            priorDocs += '\n\n===== EXISTING ARCHITECTURE =====\n' + archText;
+        }
+        catch { /* skip */ }
+    }
+    const userMessage = [
+        'Project root: ' + projectRoot,
+        'Tier: ' + (wf.tier ?? 'unknown'),
+        'Intent: ' + JSON.stringify(wf.intent ?? {}, null, 2),
+        '',
+        '===== CLARIFICATION ROUNDS =====',
+        clarificationDump,
+        priorDocs,
+        '',
+        'Generate the document now. Output the FULL markdown body only.',
+        'No preamble, no chatter, no closing remarks. Start with the first',
+        'H2 / heading and end with the last content line.',
+    ].join('\n');
+    console.log(c.dim('Llamando Claude para generar ' + DOC_FILENAME[kind] + ' ...'));
+    console.log(c.dim('(prompt strategic asset; en HITO 4 esto se mueve a prompts.yujin.app)'));
+    console.log('');
+    const claude = new ClaudeClient();
+    let body;
+    try {
+        const resp = await claude.chat({
+            system: buildSystemPromptFor(kind),
+            messages: [{ role: 'user', content: userMessage }],
+            maxTokens: 8192,
+        });
+        body = resp.text.trim();
+        if (body === '')
+            throw new Error('Claude returned empty body');
+    }
+    catch (err) {
+        console.error(c.error('Generacion fallo: ') + String(err instanceof Error ? err.message : err));
+        process.exitCode = 1;
+        return;
+    }
+    const docsDir = path.join(projectRoot, 'docs');
+    await fs.mkdir(docsDir, { recursive: true });
+    const filePath = path.join(docsDir, DOC_FILENAME[kind]);
+    const previousVersion = existing?.version ?? 0;
+    const newVersion = previousVersion + 1;
+    const stamp = new Date().toISOString();
+    const header_md = '# ' + DOC_TITLE[kind] + ' -- ' + (wf.intent?.operation ?? 'project') + '\n\n'
+        + '*Version ' + newVersion + ' generated by Yujin Forge on ' + stamp + '.*\n'
+        + '*Tier: ' + wf.tier + '. To re-generate: `yf spec ' + kind + ' --yes`.*\n\n';
+    const full = header_md + body + '\n';
+    await fs.writeFile(filePath, full, 'utf-8');
+    const sha = sha256(full);
+    const relPath = path.relative(projectRoot, filePath);
+    await patchWorkflowGroup(projectRoot, 'specs', {
+        [kind]: {
+            done_at: stamp,
+            version: newVersion,
+            doc_path: relPath,
+            sha256: sha,
+        },
+    });
+    console.log(c.success('Generado: ') + c.brand(relPath) + c.dim(' (' + full.length + ' chars, sha256:' + sha.slice(0, 12) + '...)'));
+    console.log('');
+    switch (kind) {
+        case 'rfp':
+            console.log(c.dim('Siguiente: ') + c.code('yf spec arch'));
+            break;
+        case 'arch':
+            console.log(c.dim('Siguiente: ') + c.code('yf spec design'));
+            break;
+        case 'design':
+            console.log(c.dim('Phase III completa. Siguiente: ') + c.code('yf approve rfp arch design'));
+            break;
+    }
+}
+export function registerSpecCommand(program) {
+    const spec = program.command('spec')
+        .description('Phase III steps 10-12: generate RFP + Architecture + Solution Design.');
+    for (const kind of ['rfp', 'arch', 'design']) {
+        spec.command(kind)
+            .description('Generate the ' + DOC_TITLE[kind] + ' doc into docs/' + DOC_FILENAME[kind])
+            .option('--cwd <path>', 'project root (default: current directory)')
+            .option('--yes', 'overwrite existing version')
+            .action(async (opts) => {
+            try {
+                await runSpec(kind, opts);
+            }
+            catch (err) {
+                console.error(c.error(err instanceof Error ? err.message : String(err)));
+                process.exitCode = 1;
+            }
+        });
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

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

package/dist/commands/support.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf support <verb>` -- inspect the runtime error reports
+ * collected by the panel.
+ *
+ * Subcommands:
+ *   yf support reports [--limit N] [--json]
+ *     -- list the most recent reports.
+ *   yf support reports tail
+ *     -- print only the last entry (handy after a bug).
+ *   yf support reports clear
+ *     -- wipe the JSONL + rotated copy. Asks confirmation.
+ *
+ * Per SQ Sec 15: Pablo never has to open the JSONL with a
+ * text editor or remember its path. `yf support reports tail`
+ * is the new "podes pegarme el log" -- except Forge already
+ * has the log.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export declare function registerSupportCommand(program: Command): void;
+//# sourceMappingURL=support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/commands/support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmGzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD7D"}

package/dist/commands/support.js

@@ -0,0 +1,165 @@
+import prompts from 'prompts';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { c, header } from '../ui/colors.js';
+import { configDir } from '../license/index.js';
+import { readReports } from '../support/reports.js';
+function formatReport(r, indent = '  ') {
+    const lines = [];
+    const levelTag = r.level === 'error' ? c.error('ERR')
+        : r.level === 'warn' ? c.warn('WRN')
+            : c.dim('INF');
+    lines.push(indent + c.dim(r.ts) + ' ' + levelTag + ' '
+        + c.brand(r.source) + ' -- ' + r.message);
+    if (r.url)
+        lines.push(indent + '  ' + c.dim('url:    ') + r.url
+            + (r.line !== undefined ? ':' + r.line : '')
+            + (r.col !== undefined ? ':' + r.col : ''));
+    if (r.view)
+        lines.push(indent + '  ' + c.dim('view:   ') + r.view);
+    if (r.request_trail && r.request_trail.length > 0) {
+        lines.push(indent + '  ' + c.dim('trail:'));
+        for (const t of r.request_trail) {
+            lines.push(indent + '    ' + t.method + ' ' + t.url
+                + (t.status !== undefined ? ' -> ' + t.status : ''));
+        }
+    }
+    if (r.stack) {
+        const stackLines = r.stack.split('\n').slice(0, 5);
+        lines.push(indent + '  ' + c.dim('stack:'));
+        for (const sl of stackLines)
+            lines.push(indent + '    ' + sl);
+    }
+    return lines;
+}
+async function runList(opts) {
+    let reports = await readReports();
+    if (opts.level)
+        reports = reports.filter((r) => r.level === opts.level);
+    if (opts.source)
+        reports = reports.filter((r) => r.source === opts.source);
+    const limit = typeof opts.limit === 'number' && opts.limit > 0 ? opts.limit : 50;
+    const slice = reports.slice(-limit);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(slice, null, 2) + '\n');
+        return;
+    }
+    header('Yujin Forge -- support reports');
+    console.log('');
+    console.log(c.dim('  File: ') + path.join(configDir(), 'support_reports.jsonl'));
+    console.log(c.dim('  Total stored: ') + reports.length
+        + (slice.length < reports.length ? c.dim(' (showing last ' + slice.length + ')') : ''));
+    console.log('');
+    if (slice.length === 0) {
+        console.log(c.dim('  No reports stored yet. The panel writes here when an error fires.'));
+        return;
+    }
+    for (const r of slice) {
+        for (const ln of formatReport(r))
+            console.log(ln);
+        console.log('');
+    }
+}
+async function runTail() {
+    const reports = await readReports();
+    if (reports.length === 0) {
+        console.log(c.dim('No reports stored.'));
+        return;
+    }
+    const last = reports[reports.length - 1];
+    header('Yujin Forge -- last support report');
+    console.log('');
+    for (const ln of formatReport(last))
+        console.log(ln);
+}
+async function runClear(opts) {
+    const file = path.join(configDir(), 'support_reports.jsonl');
+    const rotated = file + '.1';
+    if (!opts.yes) {
+        const r = await prompts({
+            type: 'confirm', name: 'go',
+            message: 'Delete every stored support report? (cannot be undone)',
+            initial: false,
+        });
+        if (!r.go) {
+            console.log(c.dim('Cancelled.'));
+            return;
+        }
+    }
+    for (const p of [file, rotated]) {
+        try {
+            await fs.unlink(p);
+        }
+        catch { /* ok */ }
+    }
+    console.log(c.success('Support reports cleared.'));
+}
+export function registerSupportCommand(program) {
+    const cmd = program.command('support')
+        .description('Inspect the runtime error reports collected from the chat panel.');
+    /* `yf support reports` family. Nesting matches the user mental
+     * model -- `reports` is the noun, `list/tail/clear` are verbs. */
+    const reports = cmd.command('reports')
+        .description('Manage the runtime error reports captured by the chat panel.');
+    reports.command('list', { isDefault: true })
+        .description('List collected support reports (newest last). Default verb when no subcommand given.')
+        .option('--limit <n>', 'max rows to print (default 50)', (v) => parseInt(v, 10))
+        .option('--level <level>', 'filter by level (error | warn | info)')
+        .option('--source <source>', 'filter by source (window.onerror | fetch | unhandled | panel)')
+        .option('--json', 'emit JSON array instead of human-readable rows')
+        .action(async (opts) => {
+        try {
+            await runList(opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    reports.command('tail')
+        .description('Print only the most recent support report.')
+        .action(async () => {
+        try {
+            await runTail();
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    reports.command('clear')
+        .description('Wipe the stored support reports.')
+        .option('--yes', 'skip the confirmation prompt')
+        .action(async (opts) => {
+        try {
+            await runClear(opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    reports.command('sync-github')
+        .description('Group support reports by fingerprint + open/comment GitHub issues. Closes F30.')
+        .option('--repo <slug>', 'owner/repo. Default: inferred from git remote.')
+        .option('--max <n>', 'max fingerprints to push per run (default 10)', (v) => parseInt(v, 10))
+        .option('--dry-run', 'build payloads but do not call gh CLI')
+        .action(async (opts) => {
+        try {
+            const { dispatchSupportReportsToGithub } = await import('../support/github_dispatcher.js');
+            const r = await dispatchSupportReportsToGithub({
+                repo_slug: opts.repo,
+                max_fingerprints_per_run: opts.max,
+                dry_run: opts.dryRun,
+            });
+            console.log(JSON.stringify(r, null, 2));
+            if (!r.ok || r.errors.length > 0)
+                process.exitCode = 1;
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=support.js.map

package/dist/commands/support.js.map

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

package/dist/commands/test_agent.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf test-agent run` -- Agente de Test Etapa 1 local (PND-024).
+ *
+ * Drives a multi-turn conversation against a target Forge chat
+ * server using a profile from the library. Synthetic user is
+ * Gemini Flash Lite by default (BYOK via vault slot google_ai_key).
+ *
+ * Usage:
+ *   yf test-agent list-profiles
+ *   yf test-agent run --profile greenfield-spec-writer \
+ *       --target http://127.0.0.1:8089/api/chat
+ *
+ * Exit codes:
+ *   0 -- profile passed (success criterion met)
+ *   1 -- profile failed (blocker assertion or no success)
+ *   2 -- runner error (missing key, invalid profile, network)
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export declare function registerTestAgentCommand(program: Command): void;
+//# sourceMappingURL=test_agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test_agent.d.ts","sourceRoot":"","sources":["../../src/commands/test_agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgF/D"}

package/dist/commands/test_agent.js

@@ -0,0 +1,100 @@
+import { listProfiles, getProfile } from '../test_agent/profiles.js';
+import { runProfile } from '../test_agent/runner.js';
+import { makeGeminiSyntheticUser } from '../test_agent/gemini_user.js';
+import { makeHttpTarget } from '../test_agent/target_http.js';
+import { c, header } from '../ui/colors.js';
+async function resolveGoogleAiKey(injected) {
+    if (injected && injected.trim().length > 0)
+        return injected.trim();
+    try {
+        const { getKey } = await import('../core/provider_keys.js');
+        const k = await getKey('google_ai_key');
+        if (k && k.trim().length > 0)
+            return k.trim();
+    }
+    catch { /* vault not initialised */ }
+    return process.env['GOOGLE_AI_API_KEY']
+        ?? process.env['GEMINI_API_KEY']
+        ?? null;
+}
+export function registerTestAgentCommand(program) {
+    const root = program
+        .command('test-agent')
+        .description('Agente de Test -- drive multi-turn benchmark conversations.');
+    root
+        .command('list-profiles')
+        .description('List available profiles.')
+        .option('--json', 'emit JSON')
+        .action((opts) => {
+        const profiles = listProfiles();
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(profiles.map((p) => ({
+                slug: p.slug, name: p.name, goal: p.goal,
+            })), null, 2) + '\n');
+            return;
+        }
+        header('Test agent profiles');
+        console.log('');
+        for (const p of profiles) {
+            console.log('  ' + c.success(p.slug) + c.dim(' -- ' + p.name));
+            console.log('    goal: ' + p.goal);
+            console.log('');
+        }
+    });
+    root
+        .command('run')
+        .description('Run a profile against a target chat server.')
+        .requiredOption('--profile <slug>', 'profile slug (see list-profiles)')
+        .requiredOption('--target <url>', 'target /api/chat URL')
+        .option('--max-turns <n>', 'cap turns (default profile.max_turns)')
+        .option('--api-key <key>', 'Gemini API key (overrides vault + env)')
+        .option('--model <id>', 'Gemini model id (default gemini-2.5-flash-lite)')
+        .option('--json', 'emit the report as JSON')
+        .action(async (opts) => {
+        const profile = getProfile(opts.profile);
+        if (!profile) {
+            console.error('test-agent: profile not found: ' + opts.profile);
+            console.error('  available: ' + listProfiles().map((p) => p.slug).join(', '));
+            process.exit(2);
+        }
+        const apiKey = await resolveGoogleAiKey(opts.apiKey);
+        if (!apiKey) {
+            console.error('test-agent: no Gemini API key available.');
+            console.error('  Set via --api-key, $GOOGLE_AI_API_KEY, $GEMINI_API_KEY, or `yf keys setup`.');
+            process.exit(2);
+        }
+        const synthetic = makeGeminiSyntheticUser({
+            apiKey,
+            ...(opts.model ? { model: opts.model } : {}),
+        });
+        const target = makeHttpTarget({ url: opts.target });
+        const maxTurns = opts.maxTurns ? Number(opts.maxTurns) : undefined;
+        const report = await runProfile({
+            profile, synthetic, target,
+            ...(typeof maxTurns === 'number' && !Number.isNaN(maxTurns) ? { max_turns: maxTurns } : {}),
+        });
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        }
+        else {
+            header('Test agent run -- ' + profile.name);
+            console.log('  Status:  ' + (report.status === 'passed' ? c.success(report.status) : c.warn(report.status)));
+            console.log('  Turns:   ' + report.turns_used);
+            console.log('  Passes:  ' + report.passes);
+            console.log('  Failures:' + report.failures);
+            console.log('  Duration:' + report.duration_ms + ' ms');
+            console.log('');
+            for (const t of report.turns) {
+                console.log(c.dim('-- turn ' + t.turn + ' --'));
+                console.log(c.dim('user>') + ' ' + t.user_message);
+                console.log(c.dim('assistant>') + ' ' + t.assistant_reply.slice(0, 600));
+                for (const r of t.assertion_results) {
+                    const mark = r.passed ? c.success('PASS') : c.warn('FAIL');
+                    console.log('  ' + mark + ' ' + r.label + (r.detail ? c.dim(' -- ' + r.detail) : ''));
+                }
+            }
+        }
+        process.exit(report.status === 'passed' ? 0 : 1);
+    });
+}
+//# sourceMappingURL=test_agent.js.map

package/dist/commands/test_agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_agent.js","sourceRoot":"","sources":["../../src/commands/test_agent.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