@nac3/forge-cli 0.2.0-alpha.13 → 0.2.0-alpha.15

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/spec.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `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 type { Command } from 'commander';
+export interface SpecOptions {
+    cwd?: string;
+    yes?: boolean;
+}
+export declare function registerSpecCommand(program: Command): void;
+//# sourceMappingURL=spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AA2ND,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB1D"}

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/workflow-coverage.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `yf coverage structural` -- Phase V step 15 acceptance gate.
+ *
+ * Checks that every NAC-3 manifest element is exercised by at
+ * least one e2e test. Required by SQ Sec 14 + PRODUCT_WORKFLOW
+ * step 15 for any block to enter "green" status.
+ *
+ * Strategy:
+ *   1. Read the manifest from src/nac/manifest.ts (parsed
+ *      heuristically for element ids).
+ *   2. Scan tests/ for occurrences of each id (data-nac-id
+ *      assertions, locator strings, etc).
+ *   3. Compute (covered ids) / (total ids) ratio.
+ *   4. Exit 0 iff coverage === 100%; exit 1 otherwise so CI
+ *      can gate on it.
+ *
+ * Pure read-only. Output: counts + missing ids. Optional
+ * --if-failing-exit-1 flag so CI fails the job (default true).
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface CoverageOptions {
+    cwd?: string;
+    ifFailingExit1?: boolean;
+    manifest?: string;
+}
+export declare function runCoverage(opts: CoverageOptions): Promise<void>;
+export declare function registerCoverageCommand(program: Command): void;
+//# sourceMappingURL=workflow-coverage.d.ts.map

package/dist/commands/workflow-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-coverage.d.ts","sourceRoot":"","sources":["../../src/commands/workflow-coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoCD,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDtE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9D"}