@manehorizons/cadence-core 1.6.1 → 1.8.0

package/dist/services/settle.js

@@ -0,0 +1,366 @@
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { TaskStatusZ } from '@manehorizons/cadence-types';
+import { parseDraftMd } from '../parse/draft-parser.js';
+import { renderSummaryMd } from '../parse/summary-writer.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { atomicWriteJSON, atomicWriteText } from '../state/atomic-write.js';
+import { LoopViolationError } from '../errors.js';
+import { deriveAcResults } from '../status.js';
+import { loadConfig } from '../config/loader.js';
+import { effectiveGateSet } from '../gates/engine.js';
+import { selectVerifier } from '../verify/factory.js';
+import { scanTestCoverage } from '../verify/coverage.js';
+import { resolveEffectiveProvider, MOCK_FALLBACK_BANNER, } from '../verify/verifier-factory.js';
+import { runSettleGates } from '../gates/registry.js';
+import { runSkillAuditCheck } from '../checks/skill-audit.js';
+import { ScriptedPrompter, StdinPrompter } from '../verify/prompter.js';
+import { selectNotifier } from '../notify/factory.js';
+import { collectAnomalies } from '../notify/collect.js';
+import { emitLoopViolation } from '../notify/loop-violation.js';
+import { selectCodeReviewVerifier } from '../verify/code-review-factory.js';
+import { emitCodeReviewHigh, emitCodeReviewUnconverged } from '../notify/code-review.js';
+import { emitSkillAuditMiss } from '../notify/skill-audit.js';
+import { selectSecurityAuditVerifier } from '../verify/security-audit-factory.js';
+function parseAcArg(arg) {
+    const eqIdx = arg.indexOf('=');
+    if (eqIdx === -1)
+        throw new Error(`bad --ac syntax: ${arg}`);
+    const id = arg.slice(0, eqIdx);
+    const rest = arg.slice(eqIdx + 1);
+    const colonIdx = rest.indexOf(':');
+    const verdict = colonIdx === -1 ? rest : rest.slice(0, colonIdx);
+    const note = colonIdx === -1 ? undefined : rest.slice(colonIdx + 1).trim();
+    return { id, pass: verdict === 'pass', ...(note ? { note } : {}) };
+}
+/**
+ * `cadence settle run` — close the loop: run the settle gate stack, write
+ * SUMMARY.{json,md}, and return to IDLE. Faithful extraction of the former CLI
+ * action body (process streams + exit code routed through `io`/the result).
+ */
+export async function settleService(repoRoot, opts, io) {
+    const cwd = repoRoot;
+    try {
+        const backend = new SimpleStateBackend(cwd);
+        const state = await backend.readState();
+        if (state.loopPosition !== 'BUILD' || !state.activeDraft || !state.activePhase) {
+            throw new LoopViolationError('settle run requires loopPosition=BUILD with an active draft', { expected: 'BUILD', actual: state.loopPosition });
+        }
+        const draftPath = join(cwd, '.cadence/phases', state.activePhase, `${state.activeDraft}-DRAFT.md`);
+        const draft = parseDraftMd(await readFile(draftPath, 'utf8'));
+        const progPath = join(cwd, '.cadence/phases', state.activePhase, `${state.activeDraft}-PROGRESS.json`);
+        const progress = existsSync(progPath)
+            ? JSON.parse(await readFile(progPath, 'utf8'))
+            : { draftId: state.activeDraft, tasks: {} };
+        const explicit = (opts.ac ?? []).map(parseAcArg);
+        const explicitIds = new Set(explicit.map((a) => a.id));
+        let cadenceConfig = null;
+        try {
+            cadenceConfig = await loadConfig(cwd);
+        }
+        catch {
+            cadenceConfig = null;
+        }
+        const gateSet = effectiveGateSet(state, cadenceConfig, draft);
+        if (opts.deep &&
+            resolveEffectiveProvider(cadenceConfig?.verifier).provider === 'mock') {
+            io.err(MOCK_FALLBACK_BANNER + '\n');
+        }
+        // DESIGN.md §4 M2 — soft cap on auto × complex.
+        if (gateSet.softCap && !opts.allowAutoComplex) {
+            io.err('settle run refused: auto × complex is soft-capped (DESIGN.md §4 M2). Pass --allow-auto-complex to override.\n');
+            return { exitCode: 1 };
+        }
+        if (gateSet.softCap && opts.allowAutoComplex) {
+            io.err('settle: --allow-auto-complex set; proceeding past soft cap (auto × complex).\n');
+        }
+        const touchedFiles = Array.from(new Set(draft.tasks.flatMap((t) => t.files)));
+        let coverageMemo;
+        let draftMtimeMemo;
+        let deepVerifierMemo;
+        let codeReviewVerifierMemo;
+        let securityAuditVerifierMemo;
+        let diffMemo;
+        const codeReviewSidecarPath = join(cwd, '.cadence/phases', state.activePhase, `${state.activeDraft}-CODE-REVIEW.json`);
+        const ctx = {
+            cwd,
+            state,
+            draft,
+            progress,
+            config: cadenceConfig,
+            gateSet,
+            opts: {
+                ...(opts.force !== undefined ? { force: opts.force } : {}),
+                ...(opts.auto !== undefined ? { auto: opts.auto } : {}),
+                ...(opts.deep !== undefined ? { deep: opts.deep } : {}),
+                ...(opts.allowMissingCoverage !== undefined ? { allowMissingCoverage: opts.allowMissingCoverage } : {}),
+                ...(opts.allowVerifierFailure !== undefined ? { allowVerifierFailure: opts.allowVerifierFailure } : {}),
+                ...(opts.allowStaleDraft !== undefined ? { allowStaleDraft: opts.allowStaleDraft } : {}),
+                ...(opts.allowOpenTasks !== undefined ? { allowOpenTasks: opts.allowOpenTasks } : {}),
+                ...(opts.allowFailingBuild !== undefined ? { allowFailingBuild: opts.allowFailingBuild } : {}),
+                ...(opts.interactive !== undefined ? { interactive: opts.interactive } : {}),
+                ...(opts.allowCodeReviewFailure !== undefined ? { allowCodeReviewFailure: opts.allowCodeReviewFailure } : {}),
+                ...(opts.allowSecurityAuditFailure !== undefined ? { allowSecurityAuditFailure: opts.allowSecurityAuditFailure } : {}),
+                ...(opts.allowSkillAuditMiss !== undefined ? { allowSkillAuditMiss: opts.allowSkillAuditMiss } : {}),
+            },
+            explicitIds,
+            touchedFiles,
+            coverage: () => {
+                if (!coverageMemo) {
+                    const globs = cadenceConfig?.verification?.testGlobs;
+                    coverageMemo = scanTestCoverage(cwd, globs ? { globs } : {});
+                }
+                return coverageMemo;
+            },
+            draftMtimeMs: () => {
+                if (!draftMtimeMemo) {
+                    draftMtimeMemo = stat(draftPath)
+                        .then((s) => s.mtime.getTime())
+                        .catch(() => null);
+                }
+                return draftMtimeMemo;
+            },
+            diff: () => {
+                if (diffMemo === undefined) {
+                    diffMemo = collectDiffForCodeReview(cwd, touchedFiles);
+                }
+                return diffMemo;
+            },
+            verifiers: {
+                deep: {
+                    verify: (input) => {
+                        if (!deepVerifierMemo) {
+                            deepVerifierMemo = selectVerifier(cadenceConfig);
+                        }
+                        return deepVerifierMemo.verify(input);
+                    },
+                },
+                codeReview: {
+                    verify: (input) => {
+                        if (!codeReviewVerifierMemo) {
+                            codeReviewVerifierMemo = selectCodeReviewVerifier(cadenceConfig);
+                        }
+                        return codeReviewVerifierMemo.verify(input);
+                    },
+                },
+                securityAudit: {
+                    verify: (input) => {
+                        if (!securityAuditVerifierMemo) {
+                            securityAuditVerifierMemo = selectSecurityAuditVerifier(cadenceConfig);
+                        }
+                        return securityAuditVerifierMemo.verify(input);
+                    },
+                },
+            },
+            emit: {
+                anomalies: async (events) => {
+                    void events;
+                },
+                codeReviewHigh: (findings, info) => emitCodeReviewHigh(selectNotifier(cadenceConfig), findings, info),
+                codeReviewUnconverged: (info) => emitCodeReviewUnconverged(selectNotifier(cadenceConfig), info),
+                skillAuditMiss: (payload) => emitSkillAuditMiss(selectNotifier(cadenceConfig), payload),
+            },
+            runner: {
+                test: async () => {
+                    const command = cadenceConfig?.verification?.testCommand;
+                    if (!command)
+                        return { ran: false, ok: true };
+                    try {
+                        execSync(command, { cwd, stdio: 'ignore' });
+                        return { ran: true, ok: true, exitCode: 0, command };
+                    }
+                    catch (e) {
+                        const status = e.status;
+                        const exitCode = typeof status === 'number' ? status : 1;
+                        return { ran: true, ok: false, exitCode, command };
+                    }
+                },
+            },
+            prompter: {
+                create: () => {
+                    const scripted = process.env.CADENCE_PROMPTER_SCRIPT;
+                    if (scripted !== undefined) {
+                        const answers = scripted.split('\n').filter((s) => s.length > 0 || s === '');
+                        return new ScriptedPrompter(answers);
+                    }
+                    return new StdinPrompter();
+                },
+            },
+            codeReviewSidecar: {
+                read: async () => {
+                    if (!existsSync(codeReviewSidecarPath)) {
+                        return { attemptsSoFar: 0, history: [] };
+                    }
+                    try {
+                        const prior = JSON.parse(await readFile(codeReviewSidecarPath, 'utf8'));
+                        return {
+                            attemptsSoFar: typeof prior.attempts === 'number' ? prior.attempts : 0,
+                            history: Array.isArray(prior.history) ? prior.history : [],
+                        };
+                    }
+                    catch {
+                        return { attemptsSoFar: 0, history: [] };
+                    }
+                },
+                write: (text) => atomicWriteText(codeReviewSidecarPath, text),
+            },
+            io: { err: (s) => io.err(s) },
+        };
+        const { acc, refused } = await runSettleGates(ctx);
+        if (refused) {
+            return { exitCode: 1 };
+        }
+        const coverageBypassed = acc.flags.coverageBypassed === true;
+        const interactiveRequested = opts.interactive === true ||
+            (opts.interactive !== false && gateSet.gates.includes('interactive-verdict'));
+        const interactiveVerify = acc.interactiveVerify;
+        const deepVerify = acc.deepVerify;
+        const verifierFailure = acc.flags.verifierFailure;
+        const codeReviewFindings = acc.codeReview;
+        const securityAuditFindings = acc.securityAudit;
+        const interactiveIds = new Set(interactiveVerify ? Object.keys(interactiveVerify) : []);
+        const userVerdictedIds = new Set([...explicitIds, ...interactiveIds]);
+        let acResults = [...explicit];
+        if (interactiveVerify) {
+            for (const [id, v] of Object.entries(interactiveVerify)) {
+                if (explicitIds.has(id))
+                    continue;
+                acResults.push({
+                    id,
+                    pass: v.verdict === 'pass',
+                    ...(v.note ? { note: v.note } : {}),
+                });
+            }
+        }
+        if (opts.auto || interactiveRequested) {
+            const derived = deriveAcResults(draft, progress);
+            const offenders = derived.filter((d) => d.verdict !== 'pass' && !userVerdictedIds.has(d.id));
+            if (offenders.length > 0 && !opts.force) {
+                for (const o of offenders) {
+                    const tasks = o.blockers.length > 0 ? ` (tasks: ${o.blockers.join(', ')})` : '';
+                    io.err(`auto: ${o.id} ${o.verdict}${tasks}\n`);
+                }
+                io.err('settle run --auto refused: complete the blocking tasks or rerun with --force.\n');
+                return { exitCode: 1 };
+            }
+            const merged = [...acResults];
+            for (const d of derived) {
+                if (userVerdictedIds.has(d.id))
+                    continue;
+                if (d.verdict === 'pass') {
+                    merged.push({ id: d.id, pass: true });
+                }
+                else if (d.verdict === 'blocked') {
+                    merged.push({ id: d.id, pass: false, note: `auto: ${d.blockers.join(', ')} blocked` });
+                }
+                else if (d.verdict === 'needs-context') {
+                    merged.push({ id: d.id, pass: false, note: `auto: ${d.blockers.join(', ')} needs context` });
+                }
+                else {
+                    merged.push({
+                        id: d.id,
+                        pass: false,
+                        note: d.blockers.length > 0 ? `auto: ${d.blockers.join(', ')} incomplete` : 'auto: no linked tasks',
+                    });
+                }
+            }
+            acResults = merged;
+        }
+        if (gateSet.gates.includes('anomaly-notify')) {
+            const anomalies = collectAnomalies({
+                draft,
+                progress,
+                coverageBypassed,
+                force: opts.force === true,
+                root: cwd,
+                ...(deepVerify ? { deepVerify } : {}),
+                ...(interactiveVerify ? { interactiveVerify } : {}),
+                ...(verifierFailure ? { verifierFailure } : {}),
+            });
+            if (anomalies.length > 0) {
+                const notifier = selectNotifier(cadenceConfig);
+                try {
+                    await notifier.notify(anomalies);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    io.err(`notify: ${notifier.name} transport failed — ${msg} (continuing)\n`);
+                }
+            }
+        }
+        {
+            const res = await runSkillAuditCheck(ctx);
+            if (res.outcome === 'refuse') {
+                return { exitCode: 1 };
+            }
+            state.skillAudit.required = res.effectiveRequired;
+        }
+        const summary = {
+            schemaVersion: 1,
+            draftId: state.activeDraft,
+            completedAt: new Date().toISOString(),
+            acResults,
+            taskResults: draft.tasks.map((t) => ({
+                id: t.id,
+                status: (TaskStatusZ.safeParse(progress.tasks[t.id]?.status).success
+                    ? progress.tasks[t.id].status
+                    : 'BLOCKED'),
+                notes: progress.tasks[t.id]?.notes ?? '',
+            })),
+            decisions: [],
+            deferred: [],
+            skillAudit: state.skillAudit,
+            ...(deepVerify ? { deepVerify } : {}),
+            ...(interactiveVerify ? { interactiveVerify } : {}),
+            ...(codeReviewFindings ? { codeReview: codeReviewFindings } : {}),
+            ...(securityAuditFindings ? { securityAudit: securityAuditFindings } : {}),
+        };
+        const summaryBase = join(cwd, '.cadence/phases', state.activePhase, `${state.activeDraft}-SUMMARY`);
+        await atomicWriteJSON(`${summaryBase}.json`, summary);
+        await atomicWriteText(`${summaryBase}.md`, renderSummaryMd(summary));
+        const draftId = state.activeDraft;
+        state.openDrafts = state.openDrafts.filter((d) => d.id !== draftId);
+        state.activeDraft = null;
+        state.activeTask = null;
+        state.loopPosition = 'IDLE';
+        state.tier = null;
+        await backend.commit(state);
+        io.out(`Settled ${draftId}\n`);
+        return { exitCode: 0, data: { settled: draftId, acResults } };
+    }
+    catch (err) {
+        io.err(`settle run failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        if (err instanceof LoopViolationError) {
+            await emitLoopViolation(cwd, err, 'settle.run');
+        }
+        return { exitCode: 1 };
+    }
+}
+/**
+ * `git diff --no-color HEAD -- <files>` via execSync. Returns empty
+ * string on any error (non-git workdir, no diff, exec failure).
+ */
+function collectDiffForCodeReview(cwd, files) {
+    if (files.length === 0)
+        return '';
+    try {
+        const args = ['diff', '--no-color', 'HEAD', '--', ...files];
+        return execSync(`git ${args.map(shellQuote).join(' ')}`, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            maxBuffer: 16 * 1024 * 1024,
+        });
+    }
+    catch {
+        return '';
+    }
+}
+function shellQuote(arg) {
+    if (/^[A-Za-z0-9._/=:@+-]+$/.test(arg))
+        return arg;
+    return `"${arg.replace(/(["\\$`])/g, '\\$1')}"`;
+}
+//# sourceMappingURL=settle.js.map

package/dist/services/settle.js.map

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

package/dist/services/spec-approve.d.ts

@@ -0,0 +1,11 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence spec approve <phase> <num>` — run the convergent spec-review gate;
+ * on pass mark APPROVED and leave the spec stage (SPEC→IDLE).
+ */
+export declare function specApproveService(repoRoot: string, args: {
+    phase: string;
+    num: string;
+    allowSpecReviewFailure?: boolean;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=spec-approve.d.ts.map

package/dist/services/spec-approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-approve.d.ts","sourceRoot":"","sources":["../../src/services/spec-approve.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAE,EACtE,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CAiIxB"}

package/dist/services/spec-approve.js

@@ -0,0 +1,133 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSpecMd } from '../parse/spec-parser.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { atomicWriteText } from '../state/atomic-write.js';
+import { loadConfig } from '../config/loader.js';
+import { selectNotifier } from '../notify/factory.js';
+import { selectSpecReviewVerifier } from '../verify/spec-review-factory.js';
+import { nextConvergence } from '../verify/converge.js';
+import { emitSpecReviewUnconverged } from '../notify/spec-review.js';
+/**
+ * `cadence spec approve <phase> <num>` — run the convergent spec-review gate;
+ * on pass mark APPROVED and leave the spec stage (SPEC→IDLE).
+ */
+export async function specApproveService(repoRoot, args, io) {
+    try {
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        const padded = args.num.padStart(2, '0');
+        const id = `${args.phase.slice(0, 2)}-${padded}`;
+        if (state.loopPosition !== 'SPEC') {
+            io.err(`spec approve refused: loopPosition is ${state.loopPosition}, not SPEC.\n`);
+            return { exitCode: 1 };
+        }
+        const specPath = join(repoRoot, '.cadence', 'phases', args.phase, `${id}-SPEC.md`);
+        if (!existsSync(specPath)) {
+            io.err(`spec approve refused: ${specPath} not found.\n`);
+            return { exitCode: 1 };
+        }
+        const rawSpec = await readFile(specPath, 'utf8');
+        const spec = parseSpecMd(rawSpec);
+        const cfg = await loadConfig(repoRoot).catch(() => null);
+        const verifier = selectSpecReviewVerifier(cfg);
+        const sidecarPath = join(repoRoot, '.cadence', 'phases', args.phase, `${id}-SPEC-REVIEW.json`);
+        let attemptsSoFar = 0;
+        let history = [];
+        if (existsSync(sidecarPath)) {
+            try {
+                const prior = JSON.parse(await readFile(sidecarPath, 'utf8'));
+                if (typeof prior.attempts === 'number')
+                    attemptsSoFar = prior.attempts;
+                if (Array.isArray(prior.history))
+                    history = prior.history;
+            }
+            catch {
+                /* corrupt/legacy → fresh */
+            }
+        }
+        const res = await verifier.verify({ spec });
+        const maxAttempts = cfg?.convergence?.maxAttempts ?? 3;
+        const nv = nextConvergence(res.pass, attemptsSoFar, maxAttempts);
+        const now = new Date().toISOString();
+        const bypassed = !res.pass && args.allowSpecReviewFailure === true;
+        history.push({
+            at: now,
+            pass: res.pass,
+            findingsCount: res.findings.length,
+            provider: res.provider,
+            ...(res.model ? { model: res.model } : {}),
+            verdict: nv.verdict,
+            ...(bypassed ? { bypassed: true } : {}),
+        });
+        await atomicWriteText(sidecarPath, JSON.stringify({
+            specId: id,
+            converged: res.pass,
+            attempts: nv.verdict === 'pass' ? attemptsSoFar : nv.attempt,
+            maxAttempts,
+            history,
+            pass: res.pass,
+            provider: res.provider,
+            ...(res.model ? { model: res.model } : {}),
+            findings: res.findings.length,
+            at: now,
+        }, null, 2) + '\n');
+        if (!res.pass) {
+            for (const f of res.findings) {
+                io.err(`spec-review: ${f.severity} — ${f.message}\n`);
+                if (f.suggestedEdit) {
+                    io.err(`  ↳ suggested: ${f.suggestedEdit}\n`);
+                }
+            }
+            if (args.allowSpecReviewFailure) {
+                if (nv.verdict === 'escalate') {
+                    await emitSpecReviewUnconverged(selectNotifier(cfg), {
+                        specId: id,
+                        attempts: nv.attempt,
+                        maxAttempts,
+                        findings: res.findings.length,
+                        provider: res.provider,
+                        ...(res.model ? { model: res.model } : {}),
+                        bypassed: true,
+                    });
+                }
+                io.err(`spec-review: --allow-spec-review-failure set; proceeding past ` +
+                    `${res.findings.length} finding(s).\n`);
+                // fall through to APPROVED + IDLE.
+            }
+            else if (nv.verdict === 'reloop') {
+                io.err(`spec-review: attempt ${nv.attempt}/${maxAttempts} did not pass — ` +
+                    `fix the SPEC and re-run \`cadence spec approve\`, ` +
+                    `or pass --allow-spec-review-failure to proceed anyway.\n`);
+                return { exitCode: 1 };
+            }
+            else {
+                await emitSpecReviewUnconverged(selectNotifier(cfg), {
+                    specId: id,
+                    attempts: nv.attempt,
+                    maxAttempts,
+                    findings: res.findings.length,
+                    provider: res.provider,
+                    ...(res.model ? { model: res.model } : {}),
+                });
+                io.err(`spec approve refused: spec-review did NOT converge after ` +
+                    `${maxAttempts} attempts — a human decision is required. ` +
+                    `Re-scope the spec, or pass --allow-spec-review-failure to proceed anyway.\n`);
+                return { exitCode: 1 };
+            }
+        }
+        // Converged (or bypassed): mark APPROVED, leave the spec stage.
+        await atomicWriteText(specPath, rawSpec.replace(/^status: PENDING$/m, 'status: APPROVED'));
+        state.loopPosition = 'IDLE';
+        state.activeSpec = null;
+        await backend.commit(state);
+        io.out(`Approved spec ${id}; loopPosition=IDLE\n`);
+        return { exitCode: 0, data: { id, approved: true, converged: res.pass, bypassed } };
+    }
+    catch (err) {
+        io.err(`spec approve failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=spec-approve.js.map

package/dist/services/spec-approve.js.map

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

package/dist/services/spec-new.d.ts

@@ -0,0 +1,9 @@
+import type { CommandIO, CommandResult } from './io.js';
+/** `cadence spec new <phase> <num>` — scaffold a SPEC.md (IDLE→SPEC). */
+export declare function specNewService(repoRoot: string, args: {
+    phase: string;
+    num: string;
+    title?: string;
+    fromRec?: string;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=spec-new.d.ts.map

package/dist/services/spec-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-new.d.ts","sourceRoot":"","sources":["../../src/services/spec-new.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,yEAAyE;AACzE,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CA2DxB"}

package/dist/services/spec-new.js

@@ -0,0 +1,62 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { SimpleStateBackend } from '../state/simple.js';
+import { readRecommendationLedger } from '../intelligence/store/io.js';
+import { runRecommendationTransition } from '../intelligence/store/recommendations.js';
+/** `cadence spec new <phase> <num>` — scaffold a SPEC.md (IDLE→SPEC). */
+export async function specNewService(repoRoot, args, io) {
+    const title = args.title ?? 'Untitled';
+    try {
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        if (state.loopPosition !== 'IDLE') {
+            io.err(`spec new refused: loopPosition is ${state.loopPosition}, not IDLE. ` +
+                `Approve/settle/discard the active unit first.\n`);
+            return { exitCode: 1 };
+        }
+        if (args.fromRec !== undefined) {
+            const recLedger = await readRecommendationLedger(repoRoot);
+            const rec = recLedger.recommendations.find((r) => r.id === args.fromRec);
+            if (!rec) {
+                io.err(`spec new refused: recommendation ${args.fromRec} not found\n`);
+                return { exitCode: 1 };
+            }
+            if (rec.status !== 'candidate' && rec.status !== 'accepted') {
+                io.err(`spec new refused: cannot convert recommendation in status ${rec.status}\n`);
+                return { exitCode: 1 };
+            }
+        }
+        const dir = join(repoRoot, '.cadence', 'phases', args.phase);
+        const padded = args.num.padStart(2, '0');
+        const id = `${args.phase.slice(0, 2)}-${padded}`;
+        const path = join(dir, `${id}-SPEC.md`);
+        if (existsSync(path)) {
+            io.err(`SPEC already exists: ${path}\n`);
+            return { exitCode: 2 };
+        }
+        await mkdir(dir, { recursive: true });
+        const body = `---\nphase: ${args.phase}\nid: ${id}\nstatus: PENDING\n---\n\n# ${id} — ${title}\n\n## Objective\n\n_(one sentence)_\n\n## Acceptance Criteria\n\n### AC-1: _(name)_\nGiven _(precondition)_\nWhen _(action)_\nThen _(outcome)_\n\n## Constraints\n\n- _(constraint)_\n\n## Open Questions\n\n- _(question)_\n`;
+        await writeFile(path, body);
+        state.activePhase = args.phase;
+        state.activeSpec = id;
+        state.loopPosition = 'SPEC';
+        await backend.commit(state);
+        io.out(`Created ${path}\n`);
+        if (args.fromRec !== undefined) {
+            const convertRes = await runRecommendationTransition(repoRoot, args.fromRec, 'convert', args.phase);
+            if (!convertRes.ok) {
+                io.err(`spec new: scaffold succeeded but convert failed: ${convertRes.error}. ` +
+                    `Run \`cadence recommendation convert ${args.fromRec} --to-phase ${args.phase}\` to retry.\n`);
+                return { exitCode: 1, data: { path, id, converted: false } };
+            }
+            io.out(`recommendation ${args.fromRec} → converted (to ${args.phase})\n`);
+        }
+        return { exitCode: 0, data: { path, id, converted: args.fromRec !== undefined } };
+    }
+    catch (err) {
+        io.err(`spec new failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=spec-new.js.map

package/dist/services/spec-new.js.map

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