@nac3/forge-cli 0.2.0-alpha.3 → 0.2.0-alpha.30

package/dist/commands/approve.js

@@ -0,0 +1,198 @@
+/**
+ * `yf approve <doc...>` -- Phase IV step 13 of PRODUCT_WORKFLOW.md.
+ *
+ * The unbreakable gate. Forge refuses to proceed to Phase V
+ * (build) until the user has explicitly approved the 3 spec
+ * documents (RFP + arch + design) by their current sha256.
+ *
+ * Usage:
+ *   yf approve rfp                       approve one doc
+ *   yf approve rfp arch design          approve all three (batch)
+ *   yf approve --list                   show approval state
+ *   yf approve --revoke <doc>           revoke an approval
+ *
+ * Approval persists workflow.approvals.<doc> = {
+ *   approved_at:    ISO,
+ *   version_sha256: sha of the spec file at approval time
+ * }
+ *
+ * If the doc file changes after approval, Forge detects the sha
+ * mismatch + treats the approval as stale -- user must re-approve.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { createHash } from 'node:crypto';
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, patchWorkflowGroup, } from '../workflow/state.js';
+const ALL_DOCS = ['rfp', 'arch', 'design'];
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf-8').digest('hex');
+}
+async function listState(projectRoot) {
+    const wf = await readWorkflow(projectRoot);
+    console.log(c.brand('Approval state:'));
+    console.log('');
+    for (const k of ALL_DOCS) {
+        const spec = wf.specs?.[k];
+        const apr = wf.approvals?.[k];
+        if (!spec) {
+            console.log('  ' + c.dim(k.padEnd(8)) + c.warn(' -- spec not generated yet'));
+            continue;
+        }
+        if (!apr) {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.warn(' -- NOT approved (' + spec.doc_path + ', v' + spec.version + ')'));
+            continue;
+        }
+        const stale = apr.version_sha256 !== spec.sha256;
+        if (stale) {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.warn(' -- STALE (approved sha != current sha, re-approval needed)'));
+        }
+        else {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.success(' -- approved at ' + apr.approved_at));
+        }
+    }
+    console.log('');
+}
+async function approveOne(projectRoot, kind) {
+    const wf = await readWorkflow(projectRoot);
+    const spec = wf.specs?.[kind];
+    if (!spec) {
+        console.log(c.error('Spec "' + kind + '" no generado todavia. Corre primero ') + c.code('yf spec ' + kind));
+        return false;
+    }
+    /* Re-read the file to ensure the current sha matches what was
+     * stored when the spec ran. If the user edited the file by hand
+     * between spec generation and approve, we want them to know. */
+    const abs = path.join(projectRoot, spec.doc_path);
+    let body;
+    try {
+        body = await fs.readFile(abs, 'utf-8');
+    }
+    catch (err) {
+        console.log(c.error('No se pudo leer ' + spec.doc_path + ': ' + String(err instanceof Error ? err.message : err)));
+        return false;
+    }
+    const currentSha = sha256(body);
+    if (currentSha !== spec.sha256) {
+        console.log(c.warn('  ' + kind + ': el archivo cambio desde la generacion.'));
+        console.log(c.dim('    Stored sha: ' + spec.sha256.slice(0, 16) + '...'));
+        console.log(c.dim('    Current sha: ' + currentSha.slice(0, 16) + '...'));
+        const confirm = await prompts({
+            type: 'select',
+            name: 'choice',
+            message: '  Aprobar la version CURRENT (con tus ediciones)?',
+            choices: [
+                { title: 'Si, aprobar version actual', value: 'yes' },
+                { title: 'No, re-generar antes de aprobar', value: 'regenerate' },
+                { title: 'Cancelar', value: 'cancel' },
+            ],
+        });
+        if (confirm.choice !== 'yes') {
+            if (confirm.choice === 'regenerate') {
+                console.log(c.dim('  Corre: ') + c.code('yf spec ' + kind + ' --yes'));
+            }
+            return false;
+        }
+        /* Update workflow.specs.<kind>.sha256 to match. */
+        await patchWorkflowGroup(projectRoot, 'specs', {
+            [kind]: { ...spec, sha256: currentSha, done_at: new Date().toISOString() },
+        });
+    }
+    await patchWorkflowGroup(projectRoot, 'approvals', {
+        [kind]: {
+            approved_at: new Date().toISOString(),
+            version_sha256: currentSha,
+        },
+    });
+    console.log(c.success('  Aprobado: ') + c.brand(kind));
+    return true;
+}
+async function revokeOne(projectRoot, kind) {
+    const wf = await readWorkflow(projectRoot);
+    if (!wf.approvals?.[kind]) {
+        console.log(c.warn(kind + ' no estaba aprobado.'));
+        return;
+    }
+    /* Patch with explicit removal -- set to undefined. The
+     * patchWorkflowGroup helper preserves siblings; to remove we
+     * overwrite the whole approvals object. */
+    const next = { ...(wf.approvals ?? {}) };
+    delete next[kind];
+    await patchWorkflowGroup(projectRoot, 'approvals', next);
+    console.log(c.success('Revocado: ') + c.brand(kind));
+}
+export async function runApprove(targets, opts) {
+    header('Yujin Forge -- approve');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    if (opts.list) {
+        await listState(projectRoot);
+        return;
+    }
+    if (opts.revoke) {
+        const r = opts.revoke;
+        if (!ALL_DOCS.includes(r)) {
+            console.log(c.error('Doc invalido: ' + r + '. Valid: ' + ALL_DOCS.join(', ')));
+            process.exitCode = 1;
+            return;
+        }
+        await revokeOne(projectRoot, r);
+        return;
+    }
+    if (targets.length === 0) {
+        console.log(c.error('Especifica que aprobar: ') + c.code('yf approve rfp arch design'));
+        console.log(c.dim('o solo uno: ') + c.code('yf approve rfp'));
+        console.log(c.dim('o lista: ') + c.code('yf approve --list'));
+        process.exitCode = 1;
+        return;
+    }
+    let allOk = true;
+    for (const t of targets) {
+        if (!ALL_DOCS.includes(t)) {
+            console.log(c.error('Doc invalido: ' + t + '. Valid: ' + ALL_DOCS.join(', ')));
+            allOk = false;
+            continue;
+        }
+        const ok = await approveOne(projectRoot, t);
+        if (!ok)
+            allOk = false;
+    }
+    console.log('');
+    /* Re-check the entire 3-doc set for status. */
+    const wf = await readWorkflow(projectRoot);
+    const fullApproved = ALL_DOCS.every((k) => {
+        const sp = wf.specs?.[k];
+        const ap = wf.approvals?.[k];
+        return sp && ap && ap.version_sha256 === sp.sha256;
+    });
+    if (fullApproved) {
+        console.log(c.success('Phase IV gate: PASSED. Los 3 docs estan aprobados + sha-locked.'));
+        console.log(c.dim('Siguiente paso: ') + c.code('yf bootstrap'));
+    }
+    else {
+        if (allOk) {
+            console.log(c.warn('Approbations parciales. Para destrabar Phase V hacen falta los 3 docs aprobados.'));
+            console.log(c.dim('Estado: ') + c.code('yf approve --list'));
+        }
+    }
+}
+export function registerApproveCommand(program) {
+    program.command('approve [docs...]')
+        .description('Phase IV step 13: explicit approval gate for RFP + arch + design.')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--list', 'show approval state for the 3 docs')
+        .option('--revoke <doc>', 'revoke approval for a single doc')
+        .action(async (docs, opts) => {
+        try {
+            await runApprove(docs ?? [], opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=approve.js.map

package/dist/commands/approve.js.map

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

package/dist/commands/block.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `yf block <verb> <block_id>` -- Phase V step 15 of
+ * PRODUCT_WORKFLOW.md.
+ *
+ * Drives the iterative build cycle one block at a time. Each
+ * block runs through: pending -> in_progress -> green (tests
+ * verdes + green-gate) -> deployed.
+ *
+ * Verbs:
+ *   yf block list                       show all blocks + status
+ *   yf block start <id>                 mark block in_progress
+ *   yf block green <id>                 mark block tests-green
+ *   yf block deploy <id>                mark block deployed
+ *   yf block fail <id>                  mark block failed (for retry)
+ *
+ * Each transition writes to workflow.blocks_progress[*] and
+ * checks the dependency graph: a block can only enter
+ * in_progress when all its declared dependencies are
+ * "green" or "deployed".
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface BlockOptions {
+    cwd?: string;
+}
+export declare function registerBlockCommand(program: Command): void;
+//# sourceMappingURL=block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/commands/block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkC3D"}

package/dist/commands/block.js

@@ -0,0 +1,189 @@
+/**
+ * `yf block <verb> <block_id>` -- Phase V step 15 of
+ * PRODUCT_WORKFLOW.md.
+ *
+ * Drives the iterative build cycle one block at a time. Each
+ * block runs through: pending -> in_progress -> green (tests
+ * verdes + green-gate) -> deployed.
+ *
+ * Verbs:
+ *   yf block list                       show all blocks + status
+ *   yf block start <id>                 mark block in_progress
+ *   yf block green <id>                 mark block tests-green
+ *   yf block deploy <id>                mark block deployed
+ *   yf block fail <id>                  mark block failed (for retry)
+ *
+ * Each transition writes to workflow.blocks_progress[*] and
+ * checks the dependency graph: a block can only enter
+ * in_progress when all its declared dependencies are
+ * "green" or "deployed".
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, writeWorkflow, } from '../workflow/state.js';
+const STATUS_SYMBOLS = {
+    pending: '[ ]',
+    in_progress: '[~]',
+    green: '[+]',
+    failed: '[!]',
+};
+async function listBlocks(projectRoot) {
+    const wf = await readWorkflow(projectRoot);
+    const blocks = wf.clarification?.blocks?.blocks ?? [];
+    const progress = wf.blocks_progress ?? [];
+    if (blocks.length === 0) {
+        console.log(c.warn('No hay bloques. Corre primero ') + c.code('yf clarify blocks'));
+        return;
+    }
+    console.log(c.brand('Bloques:'));
+    console.log('');
+    for (const b of blocks) {
+        const st = progress.find((p) => p.block_id === b.id)?.status ?? 'pending';
+        const symbol = STATUS_SYMBOLS[st];
+        const dep = b.dependencies.length > 0 ? ' deps: ' + b.dependencies.join(',') : '';
+        const mvp = b.mvp ? ' MVP' : '';
+        const eff = '(' + b.effort + ')';
+        console.log('  ' + c.dim(symbol) + ' ' + c.brand(b.id.padEnd(20)) + c.dim(b.name) + c.dim(' ' + eff) + c.dim(dep) + c.warn(mvp));
+    }
+    console.log('');
+    const summary = {
+        pending: progress.filter((p) => p.status === 'pending').length,
+        in_progress: progress.filter((p) => p.status === 'in_progress').length,
+        green: progress.filter((p) => p.status === 'green').length,
+        failed: progress.filter((p) => p.status === 'failed').length,
+    };
+    console.log(c.dim('Resumen: ')
+        + c.dim(`pending=${summary.pending} `)
+        + c.dim(`in_progress=${summary.in_progress} `)
+        + c.success(`green=${summary.green} `)
+        + c.error(`failed=${summary.failed}`));
+}
+async function patchProgress(projectRoot, blockId, patch) {
+    const wf = await readWorkflow(projectRoot);
+    const blocks = wf.clarification?.blocks?.blocks ?? [];
+    const targetBlock = blocks.find((b) => b.id === blockId);
+    if (!targetBlock) {
+        throw new Error('block id "' + blockId + '" not found in workflow.clarification.blocks');
+    }
+    const progress = [...(wf.blocks_progress ?? [])];
+    const idx = progress.findIndex((p) => p.block_id === blockId);
+    const next = {
+        block_id: blockId,
+        status: 'pending',
+        ...(idx >= 0 ? progress[idx] : {}),
+        ...patch,
+    };
+    if (idx >= 0)
+        progress[idx] = next;
+    else
+        progress.push(next);
+    await writeWorkflow(projectRoot, { blocks_progress: progress });
+}
+async function startBlock(projectRoot, blockId) {
+    const wf = await readWorkflow(projectRoot);
+    const blocks = wf.clarification?.blocks?.blocks ?? [];
+    const target = blocks.find((b) => b.id === blockId);
+    if (!target) {
+        console.log(c.error('block "' + blockId + '" no existe en workflow.clarification.blocks'));
+        process.exitCode = 1;
+        return;
+    }
+    /* Check dependencies. */
+    const progress = wf.blocks_progress ?? [];
+    for (const dep of target.dependencies) {
+        const depProgress = progress.find((p) => p.block_id === dep);
+        if (!depProgress || (depProgress.status !== 'green' && !depProgress.deployed_at)) {
+            console.log(c.error('Dependency "' + dep + '" no esta green todavia.'));
+            console.log(c.dim('Termina ' + dep + ' primero o corre `yf block list`.'));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    await patchProgress(projectRoot, blockId, { status: 'in_progress' });
+    console.log(c.success('Block ') + c.brand(blockId) + c.success(' marcado in_progress.'));
+    console.log(c.dim('Ciclo de bloque: implement -> e2e tests con NAC-3 coverage 100%'));
+    console.log(c.dim('               -> a11y check -> green-gate -> `yf block green ' + blockId + '`'));
+}
+async function greenBlock(projectRoot, blockId) {
+    /* SQ Sec 14 requires that any block transitioning to green has:
+     *  - lint + typecheck green
+     *  - tests green
+     *  - NAC-3 manifest coverage 100%
+     *  - a11y check passed
+     *  We do not run those here -- the user (or CI) just confirms.
+     *  In a follow-up commit we hook this into `yf coverage structural`
+     *  to refuse green if structural coverage < 100%. */
+    await patchProgress(projectRoot, blockId, {
+        status: 'green',
+        tests_green_at: new Date().toISOString(),
+    });
+    console.log(c.success('Block ') + c.brand(blockId) + c.success(' marcado green.'));
+    console.log(c.dim('Siguiente bloque: ') + c.code('yf block list'));
+}
+async function deployBlock(projectRoot, blockId) {
+    const wf = await readWorkflow(projectRoot);
+    const progress = wf.blocks_progress ?? [];
+    const current = progress.find((p) => p.block_id === blockId);
+    if (!current || current.status !== 'green') {
+        console.log(c.error('Block "' + blockId + '" debe estar green antes de deploy.'));
+        process.exitCode = 1;
+        return;
+    }
+    await patchProgress(projectRoot, blockId, { deployed_at: new Date().toISOString() });
+    console.log(c.success('Block ') + c.brand(blockId) + c.success(' marcado deployed.'));
+}
+async function failBlock(projectRoot, blockId) {
+    await patchProgress(projectRoot, blockId, { status: 'failed' });
+    console.log(c.warn('Block ') + c.brand(blockId) + c.warn(' marcado failed. Para reintentar: ')
+        + c.code('yf block start ' + blockId));
+}
+export function registerBlockCommand(program) {
+    const block = program.command('block')
+        .description('Phase V step 15: iterative block-by-block build cycle.');
+    block.command('list')
+        .description('Show all blocks + status.')
+        .option('--cwd <path>', 'project root')
+        .action(async (opts) => {
+        const root = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+        try {
+            await listBlocks(root);
+        }
+        catch (err) {
+            console.error(c.error(String(err instanceof Error ? err.message : err)));
+            process.exitCode = 1;
+        }
+    });
+    for (const verb of ['start', 'green', 'deploy', 'fail']) {
+        block.command(verb + ' <block_id>')
+            .description('Mark block as ' + verb + '.')
+            .option('--cwd <path>', 'project root')
+            .action(async (blockId, opts) => {
+            const root = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+            header('Yujin Forge -- block ' + verb);
+            console.log('');
+            try {
+                switch (verb) {
+                    case 'start':
+                        await startBlock(root, blockId);
+                        break;
+                    case 'green':
+                        await greenBlock(root, blockId);
+                        break;
+                    case 'deploy':
+                        await deployBlock(root, blockId);
+                        break;
+                    case 'fail':
+                        await failBlock(root, blockId);
+                        break;
+                }
+            }
+            catch (err) {
+                console.error(c.error(String(err instanceof Error ? err.message : err)));
+                process.exitCode = 1;
+            }
+        });
+    }
+}
+//# sourceMappingURL=block.js.map

package/dist/commands/block.js.map

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

package/dist/commands/bootstrap.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `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 type { Command } from 'commander';
+export interface BootstrapOptions {
+    cwd?: string;
+    yes?: boolean;
+    stack?: string;
+}
+export declare function runBootstrap(opts: BootstrapOptions): Promise<void>;
+export declare function registerBootstrapCommand(program: Command): void;
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/commands/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6IxE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc/D"}