@encore-os/eos-spec 0.3.1

package/dist/commands/delta.js

@@ -0,0 +1,292 @@
+import { readFileSync } from 'node:fs';
+import { loadConfig } from '../lib/config.js';
+import { runScript } from '../lib/exec.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { findSpec } from '../lib/specs.js';
+export function registerDelta(program) {
+    const deltaCmd = program
+        .command('delta')
+        .description('Manage OpenSpec-inspired change delta sections in enhancement specs.');
+    deltaCmd
+        .command('show')
+        .description('Display the Change Delta section from an enhancement spec.')
+        .requiredOption('--spec <id>', 'Enhancement spec id (e.g. CL-15-EN-01)')
+        .option('--format <fmt>', 'Output format: internal (default) or openspec', 'internal')
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd.parent.parent);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const spec = findSpec(repoRoot, options.spec);
+        if (!spec) {
+            emit(global, {
+                ok: false,
+                error: { code: ErrorCode.SPEC_NOT_FOUND, message: `delta show: spec ${options.spec} not found` },
+                data: null,
+                text: `delta show: spec ${options.spec} not found`,
+            });
+        }
+        const content = readFileSync(spec.path, 'utf8');
+        const delta = parseDeltaSection(content);
+        if (!delta) {
+            emit(global, {
+                ok: false,
+                data: { specId: spec.id },
+                text: `delta show: no "## Change Delta" section found in ${spec.id}`,
+            });
+        }
+        if (options.format === 'openspec') {
+            emit(global, {
+                ok: true,
+                data: { specId: spec.id, format: 'openspec', delta },
+                text: formatOpenSpec(spec.id, delta),
+            });
+        }
+        emit(global, {
+            ok: true,
+            data: { specId: spec.id, format: 'internal', delta },
+            text: formatInternal(spec.id, delta),
+        });
+    });
+    deltaCmd
+        .command('validate')
+        .description('Validate the Change Delta section against config rules.')
+        .requiredOption('--spec <id>', 'Enhancement spec id')
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd.parent.parent);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const spec = findSpec(repoRoot, options.spec);
+        if (!spec) {
+            emit(global, {
+                ok: false,
+                error: { code: ErrorCode.SPEC_NOT_FOUND, message: `delta validate: spec ${options.spec} not found` },
+                data: null,
+                text: `delta validate: spec ${options.spec} not found`,
+            });
+        }
+        const content = readFileSync(spec.path, 'utf8');
+        const delta = parseDeltaSection(content);
+        if (!delta) {
+            emit(global, {
+                ok: false,
+                data: { specId: spec.id, issues: ['No "## Change Delta" section found'] },
+                text: `delta validate: no Change Delta section in ${spec.id}`,
+            });
+        }
+        const config = loadConfig(repoRoot, global.config);
+        const issues = validateDelta(delta, config.delta_types);
+        emit(global, {
+            ok: issues.length === 0,
+            data: { specId: spec.id, issues, delta },
+            text: issues.length === 0
+                ? `delta validate: ${spec.id} OK`
+                : `delta validate: ${spec.id} — ${issues.length} issue(s)\n${issues.map((i) => `  - ${i}`).join('\n')}`,
+            exitCode: issues.length === 0 ? 0 : 1,
+        });
+    });
+    deltaCmd
+        .command('diff')
+        .description('Generate a Change Delta matrix from git diff between two refs.')
+        .requiredOption('--spec <id>', 'Spec ID for context')
+        .option('--from <ref>', 'Git ref to diff from (default: HEAD~1)', 'HEAD~1')
+        .option('--to <ref>', 'Git ref to diff to (default: HEAD)', 'HEAD')
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd.parent.parent);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const spec = findSpec(repoRoot, options.spec);
+        if (!spec) {
+            emit(global, {
+                ok: false,
+                error: { code: ErrorCode.SPEC_NOT_FOUND, message: `delta diff: spec ${options.spec} not found` },
+                data: null,
+                text: `delta diff: spec ${options.spec} not found`,
+            });
+        }
+        const diffResult = runScript(['git', 'diff', '--name-status', `${options.from}...${options.to}`], repoRoot);
+        if (diffResult.exitCode !== 0) {
+            emit(global, {
+                ok: false,
+                data: { stderr: diffResult.stderr },
+                text: `delta diff: git diff failed\n${diffResult.stderr}`,
+            });
+        }
+        const matrix = classifyDiffLines(diffResult.stdout, spec.core);
+        emit(global, {
+            ok: true,
+            data: { specId: spec.id, from: options.from, to: options.to, matrix },
+            text: formatDiffMatrix(spec.id, options.from, options.to, matrix),
+        });
+    });
+}
+export function parseDeltaSection(content) {
+    const deltaMatch = /## Change Delta[^\n]*\n([\s\S]*?)(?=\n## |\n---\s*$|$)/.exec(content);
+    if (!deltaMatch)
+        return null;
+    const section = deltaMatch[1];
+    const typeMatch = /\*\*Type:\*\*\s*(.+)/i.exec(section) ?? /Type:\s*\[([xX ])\]\s*(\w+)/i.exec(section);
+    let type = null;
+    if (typeMatch) {
+        const checked = section.match(/\[\s*[xX]\s*\]\s*(\w+)/g);
+        if (checked && checked.length > 0) {
+            type = checked
+                .map((m) => {
+                const w = /\[\s*[xX]\s*\]\s*(\w+)/.exec(m);
+                return w?.[1]?.toLowerCase() ?? '';
+            })
+                .filter(Boolean)
+                .join(', ');
+        }
+    }
+    const rows = [];
+    const tableRegex = /\|\s*([^|]+?)\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|\s*([^|]*?)\s*\|/g;
+    let match;
+    let headerSkipped = false;
+    let separatorSkipped = false;
+    while ((match = tableRegex.exec(section)) !== null) {
+        const col1 = match[1].trim();
+        if (col1 === 'Section' || col1 === '---' || col1.startsWith('-')) {
+            if (!headerSkipped) {
+                headerSkipped = true;
+                continue;
+            }
+            if (!separatorSkipped) {
+                separatorSkipped = true;
+                continue;
+            }
+        }
+        if (col1.startsWith('-'))
+            continue;
+        rows.push({
+            section: col1,
+            adds: match[2].trim(),
+            changes: match[3].trim(),
+            removes: match[4].trim(),
+        });
+    }
+    const backwardMatch = /\*\*Backward compatibility:\*\*\s*(.+)/i.exec(section);
+    const consumersMatch = /\*\*Consumers affected:\*\*\s*(.+)/i.exec(section);
+    return {
+        type,
+        rows,
+        backwardCompatibility: backwardMatch?.[1]?.trim() ?? null,
+        consumersAffected: consumersMatch?.[1]?.trim() ?? null,
+    };
+}
+export function validateDelta(delta, allowedTypes) {
+    const issues = [];
+    if (!delta.type) {
+        issues.push(`No delta type checked (expected one of: ${allowedTypes.join(', ')})`);
+    }
+    else {
+        const types = delta.type.split(',').map((t) => t.trim());
+        for (const t of types) {
+            if (!allowedTypes.includes(t)) {
+                issues.push(`Unknown delta type "${t}" (allowed: ${allowedTypes.join(', ')})`);
+            }
+        }
+    }
+    const hasContent = delta.rows.some((r) => (r.adds && !r.adds.startsWith('_')) ||
+        (r.changes && !r.changes.startsWith('_')) ||
+        (r.removes && !r.removes.startsWith('_')));
+    if (!hasContent) {
+        issues.push('All delta rows are empty or placeholders — at least one row must be filled');
+    }
+    if (delta.type) {
+        const types = delta.type.split(',').map((t) => t.trim());
+        if (types.includes('breaking') || types.includes('deletion')) {
+            if (!delta.backwardCompatibility || delta.backwardCompatibility.toLowerCase().startsWith('yes')) {
+                issues.push('Breaking/deletion delta requires "Backward compatibility: No" with a migration path');
+            }
+        }
+    }
+    return issues;
+}
+function formatInternal(specId, delta) {
+    const lines = [`Change Delta for ${specId}:`, `  Type: ${delta.type ?? '(none)'}`];
+    if (delta.rows.length > 0) {
+        lines.push('  | Section | Adds | Changes | Removes |');
+        lines.push('  |---------|------|---------|---------|');
+        for (const r of delta.rows) {
+            lines.push(`  | ${r.section} | ${r.adds} | ${r.changes} | ${r.removes} |`);
+        }
+    }
+    if (delta.backwardCompatibility)
+        lines.push(`  Backward compatibility: ${delta.backwardCompatibility}`);
+    if (delta.consumersAffected)
+        lines.push(`  Consumers affected: ${delta.consumersAffected}`);
+    return lines.join('\n');
+}
+function formatOpenSpec(specId, delta) {
+    const lines = [`# Change Delta for ${specId} (OpenSpec format)`, ''];
+    const added = delta.rows.filter((r) => r.adds && !r.adds.startsWith('_'));
+    const modified = delta.rows.filter((r) => r.changes && !r.changes.startsWith('_'));
+    const removed = delta.rows.filter((r) => r.removes && !r.removes.startsWith('_'));
+    if (added.length > 0) {
+        lines.push('## ADDED Requirements', '');
+        for (const r of added)
+            lines.push(`### Requirement: ${r.section}`, '', r.adds, '');
+    }
+    if (modified.length > 0) {
+        lines.push('## MODIFIED Requirements', '');
+        for (const r of modified)
+            lines.push(`### Requirement: ${r.section}`, '', r.changes, '');
+    }
+    if (removed.length > 0) {
+        lines.push('## REMOVED Requirements', '');
+        for (const r of removed)
+            lines.push(`### Requirement: ${r.section}`, '', r.removes, '');
+    }
+    return lines.join('\n');
+}
+function classifyDiffLines(diffOutput, _core) {
+    const result = { schema: [], permissions: [], api: [], ui: [] };
+    for (const line of diffOutput.split('\n')) {
+        if (!line.trim())
+            continue;
+        const parts = line.split('\t');
+        if (parts.length < 2)
+            continue;
+        const status = parts[0];
+        const file = parts[parts.length - 1];
+        const label = `${status}\t${file}`;
+        if (file.includes('migration') || file.includes('.sql') || file.endsWith('.schema.ts')) {
+            result.schema.push(label);
+        }
+        else if (file.includes('rls') || file.includes('policy') || file.includes('permission')) {
+            result.permissions.push(label);
+        }
+        else if (file.includes('/api/') || file.includes('edge-function') || file.includes('supabase/functions')) {
+            result.api.push(label);
+        }
+        else if (file.includes('/components/') || file.includes('/pages/') || file.endsWith('.tsx')) {
+            result.ui.push(label);
+        }
+    }
+    return result;
+}
+function formatDiffMatrix(specId, from, to, matrix) {
+    const lines = [`delta diff: ${specId} (${from}...${to})`, ''];
+    const sections = [
+        ['Schema (tables/columns)', matrix.schema],
+        ['Permissions / RLS', matrix.permissions],
+        ['API / events', matrix.api],
+        ['UI surfaces', matrix.ui],
+    ];
+    lines.push('| Section | Adds | Changes | Removes |');
+    lines.push('|---------|------|---------|---------|');
+    for (const [name, files] of sections) {
+        const adds = files.filter((f) => f.startsWith('A')).length;
+        const mods = files.filter((f) => f.startsWith('M')).length;
+        const dels = files.filter((f) => f.startsWith('D')).length;
+        lines.push(`| ${name} | ${adds || '-'} | ${mods || '-'} | ${dels || '-'} |`);
+    }
+    lines.push('', 'Files:');
+    for (const [name, files] of sections) {
+        if (files.length > 0) {
+            lines.push(`  ${name}:`);
+            for (const f of files)
+                lines.push(`    ${f}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=delta.js.map

package/dist/commands/delta.js.map

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

package/dist/commands/freshness.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+/**
+ * `eos-spec freshness` — semantic-precedent embedding freshness gate.
+ *
+ * Recomputes the corpus surface hash from the generated specs/spec-index.json and
+ * compares it to the committed embedding manifest. The committed vectors power the
+ * semantic precedent ranking AND the recall ratchet, so when the corpus drifts the
+ * vectors are stale and must be rebuilt. Exits non-zero on drift (or a missing
+ * manifest/index) so CI / pre-commit can block, with an actionable rebuild hint.
+ *
+ * Generate the (gitignored) spec-index.json first via your repo's spec-index step.
+ */
+export declare function registerFreshness(program: Command): void;

package/dist/commands/freshness.js

@@ -0,0 +1,72 @@
+import { embeddingsSourceFromConfig } from '../lib/embeddings-source.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+const REBUILD_HINT = 'Rebuild the committed embedding vectors for the current corpus (your repo’s build:embeddings step).';
+/**
+ * `eos-spec freshness` — semantic-precedent embedding freshness gate.
+ *
+ * Recomputes the corpus surface hash from the generated specs/spec-index.json and
+ * compares it to the committed embedding manifest. The committed vectors power the
+ * semantic precedent ranking AND the recall ratchet, so when the corpus drifts the
+ * vectors are stale and must be rebuilt. Exits non-zero on drift (or a missing
+ * manifest/index) so CI / pre-commit can block, with an actionable rebuild hint.
+ *
+ * Generate the (gitignored) spec-index.json first via your repo's spec-index step.
+ */
+export function registerFreshness(program) {
+    program
+        .command('freshness')
+        .description('Check the committed semantic-precedent embeddings against the current spec corpus. Exits non-zero when the corpus has drifted (rebuild needed) or the manifest/index is missing. Generate specs/spec-index.json first.')
+        .action(async (_options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const result = embeddingsSourceFromConfig(repoRoot, global.config).checkFreshness();
+        if (result.fresh) {
+            emit(global, {
+                ok: true,
+                data: result,
+                text: `embeddings fresh — corpus surface hash matches the committed manifest (${result.currentHash.slice(0, 12)}…)`,
+            });
+        }
+        // Not fresh: distinguish the failure modes so the message is actionable.
+        if (result.reason === 'index-missing') {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.IO_ERROR,
+                    message: 'freshness: specs/spec-index.json not found — generate the spec index first',
+                },
+                data: result,
+                text: 'freshness: specs/spec-index.json not found — generate the spec index first.',
+            });
+        }
+        if (result.reason === 'manifest-missing') {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.IO_ERROR,
+                    message: `freshness: committed embedding manifest not found. ${REBUILD_HINT}`,
+                },
+                data: result,
+                text: `freshness: committed embedding manifest not found.\n${REBUILD_HINT}`,
+            });
+        }
+        emit(global, {
+            ok: false,
+            error: {
+                code: ErrorCode.VALIDATION_FAILED,
+                message: `freshness: spec corpus drifted from the committed embeddings (current ${result.currentHash.slice(0, 12)}… != committed ${(result.committedHash ?? '').slice(0, 12)}…). ${REBUILD_HINT}`,
+            },
+            data: result,
+            text: [
+                'freshness: spec corpus has drifted from the committed semantic embeddings.',
+                `  current surface hash:   ${result.currentHash}`,
+                `  committed surface hash: ${result.committedHash}`,
+                '',
+                'The semantic precedent ranking + recall ratchet read these vectors, so they are stale.',
+                REBUILD_HINT,
+            ].join('\n'),
+        });
+    });
+}
+//# sourceMappingURL=freshness.js.map

package/dist/commands/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../src/commands/freshness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,YAAY,GAChB,qGAAqG,CAAC;AAExG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CACV,wNAAwN,CACzN;SACA,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,CAAC;QAEpF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,EAAE;gBACX,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,0EAA0E,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;aACpH,CAAC,CAAC;QACL,CAAC;QAED,yEAAyE;QACzE,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE;gBACX,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS,CAAC,QAAQ;oBACxB,OAAO,EAAE,4EAA4E;iBACtF;gBACD,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,6EAA6E;aACpF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE;gBACX,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS,CAAC,QAAQ;oBACxB,OAAO,EAAE,sDAAsD,YAAY,EAAE;iBAC9E;gBACD,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uDAAuD,YAAY,EAAE;aAC5E,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,EAAE;YACX,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS,CAAC,iBAAiB;gBACjC,OAAO,EAAE,yEAAyE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,YAAY,EAAE;aAClM;YACD,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,4EAA4E;gBAC5E,6BAA6B,MAAM,CAAC,WAAW,EAAE;gBACjD,6BAA6B,MAAM,CAAC,aAAa,EAAE;gBACnD,EAAE;gBACF,wFAAwF;gBACxF,YAAY;aACb,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/funnel.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerFunnel(program: Command): void;

package/dist/commands/funnel.js

@@ -0,0 +1,61 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { computeFunnel } from '../lib/funnel.js';
+import { gitMtimes } from '../lib/git-mtime.js';
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { listSpecs } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+const STAGE_ORDER = [
+    'stub',
+    'clarified',
+    'validated',
+    'regulatory_grounded',
+    'reviewed',
+    'compliance_reviewed',
+    'ux_reviewed',
+    'planned',
+    'tasks_generated',
+];
+export function registerFunnel(program) {
+    program
+        .command('funnel')
+        .description('Per-core funnel: stages × AC coverage × stall detection. Derived from artifacts.')
+        .option('--core <core>', 'Limit to one core')
+        .option('--stall-days <n>', 'Stall threshold in days (default 30)', '30')
+        .option('--save', 'Write a dated snapshot to docs/reports/FUNNEL_HEALTH_<date>.md', false)
+        .action(withEventLog('funnel', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const specs = listSpecs(repoRoot, options.core);
+        const mtimeBySpecPath = gitMtimes(repoRoot, specs.map((s) => s.path));
+        const report = computeFunnel({
+            specs,
+            mtimeBySpecPath,
+            stallDays: parseInt(options.stallDays, 10),
+        });
+        const stageLines = STAGE_ORDER.map((s) => `  ${s.padEnd(18)} ${report.byStage[s] ?? 0}`);
+        const text = [
+            `Funnel health (${options.core ?? 'all'}):`,
+            '  Stage              count',
+            '  ────────────────────────',
+            ...stageLines,
+            '',
+            `  with user_stories  : ${report.withStories}`,
+            `  with ACs           : ${report.withACs}`,
+            `  storied-but-no-ACs : ${report.storiedButNoACs}    ← AC-backfill target population`,
+            `  with seed fixtures : ${report.withSeedFixtures}`,
+            `  ACs-but-no-fixture : ${report.acsButNoSeedFixture}    ← seed-fixture target population (generate-seed-fixtures)`,
+            `  stalls (>${options.stallDays}d): ${report.stalls}`,
+        ].join('\n');
+        if (options.save) {
+            const date = new Date().toISOString().slice(0, 10);
+            const dir = join(repoRoot, 'docs/reports');
+            mkdirSync(dir, { recursive: true });
+            const path = join(dir, `FUNNEL_HEALTH_${date}.md`);
+            writeFileSync(path, `# Funnel Health — ${date}\n\n\`\`\`\n${text}\n\`\`\`\n`, 'utf8');
+        }
+        emit(global, { ok: true, data: report, text });
+    }));
+}
+//# sourceMappingURL=funnel.js.map

package/dist/commands/funnel.js.map

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

package/dist/commands/gen-tests.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerGenTests(program: Command): void;

package/dist/commands/gen-tests.js

@@ -0,0 +1,53 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { readFrontmatter, setE2eTests } from '../lib/frontmatter.js';
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { normalizeAcceptanceCriteria } from '../lib/requirements.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { findSpec } from '../lib/specs.js';
+import { classifyLane, generateTestContent, generatedRelPath } from '../lib/test-generator.js';
+export function registerGenTests(program) {
+    program
+        .command('gen-tests')
+        .description('Generate a fixme-gated test skeleton (@verifies-stamped) from a spec’s acceptance_criteria. Dry-run unless --write.')
+        .requiredOption('--spec <id>', 'Spec id, e.g. WEB-05')
+        .option('--write', 'Write the generated file under e2e/generated/', false)
+        .option('--update-frontmatter', 'Also add the generated path to the spec’s e2e_tests:', false)
+        .option('--lane <lane>', 'Override the ui|integration heuristic')
+        .action((options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const spec = findSpec(repoRoot, options.spec);
+        if (!spec)
+            emit(global, { ok: false, data: {}, text: `gen-tests: spec not found: ${options.spec}`, exitCode: 1 });
+        const specText = readFileSync(spec.path, 'utf8');
+        const fm = readFrontmatter(specText);
+        const { acs } = normalizeAcceptanceCriteria(fm.acceptance_criteria);
+        const lane = options.lane === 'ui' || options.lane === 'integration' ? options.lane : classifyLane(acs);
+        const rel = generatedRelPath(spec.id, lane);
+        const content = generateTestContent(spec.id, spec.title ?? spec.id, acs, lane);
+        if (!options.write)
+            emit(global, {
+                ok: true,
+                data: { spec: spec.id, lane, path: rel, acCount: acs.length, dryRun: true },
+                text: `gen-tests: would write ${rel} (lane=${lane}, ${acs.length} AC) — pass --write`,
+            });
+        const abs = join(repoRoot, rel);
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, content);
+        if (options.updateFrontmatter)
+            writeFileSync(spec.path, setE2eTests(specText, rel));
+        emit(global, {
+            ok: true,
+            data: {
+                spec: spec.id,
+                lane,
+                path: rel,
+                acCount: acs.length,
+                frontmatterUpdated: Boolean(options.updateFrontmatter),
+            },
+            text: `gen-tests: wrote ${rel} (lane=${lane}, ${acs.length} AC)${options.updateFrontmatter ? ' + updated e2e_tests' : ''}`,
+        });
+    });
+}
+//# sourceMappingURL=gen-tests.js.map

package/dist/commands/gen-tests.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerInit(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,64 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig } from '../lib/config.js';
+import { runScript } from '../lib/exec.js';
+import { emit, emitContinuing, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+export function registerInit(program) {
+    program
+        .command('init')
+        .description('Verify spec workflow is set up: required directories, scripts, and templates exist.')
+        .action(async (_options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const required = [
+            'specs/SPEC_STATUS_REGISTRY.md',
+            'scripts/audit/audit-spec-completion.js',
+            'scripts/specs/sync-deferred-dashboard.ts',
+            'specs/_templates/SPEC_GUIDE.md',
+            'specs/_templates/TEMPLATE_INDEX.md',
+        ];
+        try {
+            const config = loadConfig(repoRoot, global.config);
+            const templatePaths = flattenTemplatePaths(config.templates);
+            required.push(...templatePaths);
+        }
+        catch {
+            required.push('specs/_templates/SPEC_TEMPLATE.md', 'specs/_templates/SPEC_TEMPLATE_LITE.md', 'specs/_templates/PLAN_TEMPLATE.md', 'specs/_templates/TASKS_TEMPLATE.md');
+        }
+        const unique = [...new Set(required)];
+        const missing = unique.filter((p) => !existsSync(join(repoRoot, p)));
+        if (missing.length === 0) {
+            const git = runScript(['git', 'rev-parse', '--show-toplevel'], repoRoot);
+            if (git.exitCode !== 0) {
+                emit(global, {
+                    ok: false,
+                    data: { reason: 'git not available', missing: [] },
+                    text: 'init: git not available — required for repo-root resolution',
+                });
+            }
+            emit(global, {
+                ok: true,
+                data: { repoRoot, missing: [] },
+                text: `init: spec workflow ready (${repoRoot})`,
+            });
+        }
+        emitContinuing(global, 'init: missing required files:');
+        for (const m of missing)
+            emitContinuing(global, `  - ${m}`);
+        emit(global, { ok: false, data: { repoRoot, missing }, exitCode: 1 });
+    });
+}
+function flattenTemplatePaths(templates) {
+    const paths = [];
+    for (const val of Object.values(templates)) {
+        if (typeof val === 'string') {
+            paths.push(val);
+        }
+        else if (val && typeof val === 'object') {
+            paths.push(...Object.values(val));
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+/** Canonicalize a status value for matching: lowercase and strip everything that is
+ *  not a letter or digit. Makes `--status InProgress`, frontmatter `in_progress`,
+ *  and legacy body prose like `🚧 In Progress (60% Complete)` all comparable. */
+export declare function canonicalStatus(value: string): string;
+/** Prefix match on canonicalized status, both sides normalized. An empty filter
+ *  matches nothing (a typo'd flag must not silently return the whole corpus). */
+export declare function statusMatches(specStatus: string | undefined, filter: string): boolean;
+export declare function registerList(program: Command): void;