@manehorizons/cadence-core 1.6.1 → 1.8.0

package/dist/services/build-task.js

@@ -0,0 +1,78 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { TaskStatusZ } from '@manehorizons/cadence-types';
+import { recordTaskOutcome, } from '../build/record.js';
+import { LoopViolationError } from '../errors.js';
+import { emitLoopViolation } from '../notify/loop-violation.js';
+import { loadConfig } from '../config/loader.js';
+import { effectiveGateSet } from '../gates/engine.js';
+import { parseDraftMd } from '../parse/draft-parser.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { runPerTaskVerifyGate } from '../gates/per-task-verify.js';
+import { buildBuildContext } from '../gates/build-context.js';
+/**
+ * `cadence build task <id>` — record a task outcome (runs the per-task verifier
+ * gate on DONE). Faithful extraction of the former CLI action body.
+ */
+export async function buildTaskService(repoRoot, args, io) {
+    const statusRaw = args.status ?? 'DONE';
+    const notes = args.notes ?? '';
+    try {
+        const statusParse = TaskStatusZ.safeParse(statusRaw);
+        if (!statusParse.success ||
+            statusParse.data === 'PENDING' ||
+            statusParse.data === 'IN_PROGRESS') {
+            io.err(`Invalid task status: ${statusRaw}. Allowed: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED\n`);
+            return { exitCode: 2 };
+        }
+        const status = statusParse.data;
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        let draft;
+        if (state.activePhase && state.activeDraft) {
+            const draftPath = join(repoRoot, '.cadence', 'phases', state.activePhase, `${state.activeDraft}-DRAFT.md`);
+            if (existsSync(draftPath)) {
+                draft = parseDraftMd(await readFile(draftPath, 'utf8'));
+                const validIds = draft.tasks.map((t) => t.id);
+                if (!validIds.includes(args.taskId)) {
+                    io.err(`build task: unknown task id "${args.taskId}". ` +
+                        `Valid ids in ${state.activeDraft}-DRAFT.md: ${validIds.join(', ') || '(none)'}. ` +
+                        `Nothing recorded.\n`);
+                    return { exitCode: 2 };
+                }
+            }
+        }
+        let perTaskRecord;
+        if (status === 'DONE' && draft) {
+            const cfg = await loadConfig(repoRoot).catch(() => null);
+            const ctx = buildBuildContext({
+                cwd: repoRoot,
+                state,
+                draft,
+                config: cfg,
+                gateSet: effectiveGateSet(state, cfg, draft),
+                taskId: args.taskId,
+                opts: args.allowPerTaskFailure !== undefined
+                    ? { allowPerTaskFailure: args.allowPerTaskFailure }
+                    : {},
+            });
+            const res = await runPerTaskVerifyGate(ctx);
+            if (res.outcome === 'refuse') {
+                return { exitCode: 1 };
+            }
+            perTaskRecord = res.summaryPatch?.perTaskRecord;
+        }
+        await recordTaskOutcome(repoRoot, args.taskId, status, notes, perTaskRecord);
+        io.out(`Recorded ${args.taskId}: ${status}\n`);
+        return { exitCode: 0, data: { taskId: args.taskId, status } };
+    }
+    catch (err) {
+        io.err(`build task failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        if (err instanceof LoopViolationError) {
+            await emitLoopViolation(repoRoot, err, 'build.task');
+        }
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=build-task.js.map

package/dist/services/build-task.js.map

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

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

@@ -0,0 +1,14 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence draft approve <phase> <num>` — run the coherence → soft-cap →
+ * approve → plan-review gate ladder, then transition DRAFT→BUILD. Faithful
+ * extraction of the former CLI action body.
+ */
+export declare function draftApproveService(repoRoot: string, args: {
+    phase: string;
+    num: string;
+    allowAutoComplex?: boolean;
+    approve?: boolean;
+    allowPlanReviewFailure?: boolean;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=draft-approve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-approve.d.ts","sourceRoot":"","sources":["../../src/services/draft-approve.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,EACD,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CA2DxB"}

package/dist/services/draft-approve.js

@@ -0,0 +1,74 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseDraftMd } from '../parse/draft-parser.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { loadConfig } from '../config/loader.js';
+import { effectiveGateSet } from '../gates/engine.js';
+import { buildDraftContext } from '../gates/draft-context.js';
+import { runCoherenceGate, emitCoherenceWarns } from '../gates/coherence.js';
+import { runApproveGate } from '../gates/approve.js';
+import { runPlanReviewGate } from '../gates/plan-review.js';
+/**
+ * `cadence draft approve <phase> <num>` — run the coherence → soft-cap →
+ * approve → plan-review gate ladder, then transition DRAFT→BUILD. Faithful
+ * extraction of the former CLI action body.
+ */
+export async function draftApproveService(repoRoot, args, io) {
+    try {
+        const id = `${args.phase.slice(0, 2)}-${args.num.padStart(2, '0')}`;
+        const path = join(repoRoot, '.cadence', 'phases', args.phase, `${id}-DRAFT.md`);
+        const draft = parseDraftMd(await readFile(path, 'utf8'));
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        const projectMdPath = join(repoRoot, '.cadence', 'PROJECT.md');
+        const projectMd = existsSync(projectMdPath) ? await readFile(projectMdPath, 'utf8') : '';
+        const cfg = await loadConfig(repoRoot).catch(() => null);
+        const gateSet = effectiveGateSet(state, cfg, draft);
+        const ctx = buildDraftContext({
+            cwd: repoRoot, state, draft, config: cfg, gateSet, phase: args.phase, id, projectMd,
+            opts: {
+                ...(args.allowAutoComplex !== undefined ? { allowAutoComplex: args.allowAutoComplex } : {}),
+                ...(args.approve !== undefined ? { approve: args.approve } : {}),
+                ...(args.allowPlanReviewFailure !== undefined ? { allowPlanReviewFailure: args.allowPlanReviewFailure } : {}),
+            },
+        });
+        // Coherence blockers refuse before any state mutation (exit 2).
+        if ((await runCoherenceGate(ctx)).outcome === 'refuse') {
+            return { exitCode: 2 };
+        }
+        // DESIGN.md §4 M2 — soft cap on auto × complex (Phase 21.1).
+        if (gateSet.softCap && !args.allowAutoComplex) {
+            io.err('draft approve refused: auto × complex is soft-capped (DESIGN.md §4 M2). Pass --allow-auto-complex to override, or bump the draft\'s profile to standard/strict.\n');
+            return { exitCode: 1 };
+        }
+        if (gateSet.softCap && args.allowAutoComplex) {
+            io.err('draft approve: --allow-auto-complex set; proceeding past soft cap (auto × complex).\n');
+        }
+        // Manual approve gate (Phase 24.1) then plan-review gate (25.1 / 35.1).
+        if ((await runApproveGate(ctx)).outcome === 'refuse') {
+            return { exitCode: 1 };
+        }
+        if ((await runPlanReviewGate(ctx)).outcome === 'refuse') {
+            return { exitCode: 1 };
+        }
+        // Coherence-warn emission at approve time (before the BUILD transition).
+        await emitCoherenceWarns(ctx, 'coherence.approve');
+        state.activePhase = args.phase;
+        state.activeDraft = id;
+        state.loopPosition = 'BUILD';
+        state.tier = draft.tier;
+        state.draftReadAt = new Date().toISOString();
+        if (!state.openDrafts.some((d) => d.id === id)) {
+            state.openDrafts.push({ id, since: new Date().toISOString() });
+        }
+        await backend.commit(state);
+        io.out(`Approved ${id}; loopPosition=BUILD\n`);
+        return { exitCode: 0, data: { id, loopPosition: 'BUILD' } };
+    }
+    catch (err) {
+        io.err(`draft approve failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=draft-approve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-approve.js","sourceRoot":"","sources":["../../src/services/draft-approve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAMC,EACD,EAAa;IAEb,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,iBAAiB,CAAC;YAC5B,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,SAAS;YACnF,IAAI,EAAE;gBACJ,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3F,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,IAAI,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9G;SACF,CAAC,CAAC;QAEH,gEAAgE;QAChE,IAAI,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzB,CAAC;QACD,6DAA6D;QAC7D,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,EAAE,CAAC,GAAG,CACJ,mKAAmK,CACpK,CAAC;YACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,EAAE,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;QAClG,CAAC;QACD,wEAAwE;QACxE,IAAI,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzB,CAAC;QACD,yEAAyE;QACzE,MAAM,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAEnD,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;QAC/B,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC;QACvB,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;QAC/C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/services/draft-check.d.ts

@@ -0,0 +1,10 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence draft check <path>` — coherence-check a DRAFT.md against state +
+ * PROJECT.md. `path` is resolved against `repoRoot` (absolute paths pass
+ * through). Exit 2 on a blocking issue, matching the CLI.
+ */
+export declare function draftCheckService(repoRoot: string, args: {
+    path: string;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=draft-check.d.ts.map

package/dist/services/draft-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-check.d.ts","sourceRoot":"","sources":["../../src/services/draft-check.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACtB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CA6BxB"}

package/dist/services/draft-check.js

@@ -0,0 +1,47 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parseDraftMd } from '../parse/draft-parser.js';
+import { coherenceCheck } from '../coherence/check.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { loadConfig } from '../config/loader.js';
+import { effectiveGateSet } from '../gates/engine.js';
+import { buildDraftContext } from '../gates/draft-context.js';
+import { emitCoherenceWarns, printAllCoherenceIssues } from '../gates/coherence.js';
+/**
+ * `cadence draft check <path>` — coherence-check a DRAFT.md against state +
+ * PROJECT.md. `path` is resolved against `repoRoot` (absolute paths pass
+ * through). Exit 2 on a blocking issue, matching the CLI.
+ */
+export async function draftCheckService(repoRoot, args, io) {
+    try {
+        const path = resolve(repoRoot, args.path);
+        const draft = parseDraftMd(await readFile(path, 'utf8'));
+        const state = await new SimpleStateBackend(repoRoot).readState();
+        const projectMdPath = join(repoRoot, '.cadence', 'PROJECT.md');
+        const projectMd = existsSync(projectMdPath) ? await readFile(projectMdPath, 'utf8') : '';
+        const issues = coherenceCheck(draft, state, projectMd).issues;
+        if (issues.length === 0) {
+            io.out('coherence: OK\n');
+            return { exitCode: 0, data: { ok: true, issues: [] } };
+        }
+        const blocked = printAllCoherenceIssues(issues, { err: (s) => io.err(s) });
+        // Phase 23.2 — coherence-warn emission (gated on anomaly-notify). Block
+        // issues already printed loudly above; warns still emit even when blocked.
+        if (issues.some((i) => i.severity === 'warn')) {
+            const cfg = await loadConfig(repoRoot).catch(() => null);
+            const ctx = buildDraftContext({
+                cwd: repoRoot, state, draft, config: cfg,
+                gateSet: effectiveGateSet(state, cfg, draft),
+                phase: '', id: '', projectMd, opts: {},
+            });
+            await emitCoherenceWarns(ctx, 'coherence.check');
+        }
+        return { exitCode: blocked ? 2 : 0, data: { ok: !blocked, issues } };
+    }
+    catch (err) {
+        io.err(`draft check failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=draft-check.js.map

package/dist/services/draft-check.js.map

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

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

@@ -0,0 +1,14 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence draft new <phase> <num>` — scaffold a DRAFT.md (IDLE→DRAFT) and,
+ * with `fromRec`, chain-convert the recommendation. Faithful extraction of the
+ * former CLI action body.
+ */
+export declare function draftNewService(repoRoot: string, args: {
+    phase: string;
+    num: string;
+    title?: string;
+    tier?: string;
+    fromRec?: string;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=draft-new.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-new.d.ts","sourceRoot":"","sources":["../../src/services/draft-new.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACrF,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CAqFxB"}

package/dist/services/draft-new.js

@@ -0,0 +1,98 @@
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSpecMd } from '../parse/spec-parser.js';
+import { renderDraftBody, frontmatterStatus } from '../parse/draft-scaffold.js';
+import { SimpleStateBackend } from '../state/simple.js';
+import { readRecommendationLedger } from '../intelligence/store/io.js';
+import { runRecommendationTransition } from '../intelligence/store/recommendations.js';
+/**
+ * `cadence draft new <phase> <num>` — scaffold a DRAFT.md (IDLE→DRAFT) and,
+ * with `fromRec`, chain-convert the recommendation. Faithful extraction of the
+ * former CLI action body.
+ */
+export async function draftNewService(repoRoot, args, io) {
+    const title = args.title ?? 'Untitled';
+    const tier = args.tier ?? 'standard';
+    try {
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        if (state.loopPosition !== 'IDLE') {
+            const hint = state.loopPosition === 'SPEC'
+                ? `Approve or discard the active spec (${state.activeSpec ?? '?'}) first (cadence spec approve …).`
+                : `Settle or discard the active draft (${state.activeDraft ?? '?'}) first.`;
+            io.err(`draft new refused: loopPosition is ${state.loopPosition}, not IDLE. ${hint}\n`);
+            return { exitCode: 1 };
+        }
+        // Slice 34.3 — pre-flight the rec BEFORE any fs writes so we never
+        // scaffold a phase for a missing or unconvertible rec.
+        if (args.fromRec !== undefined) {
+            const recLedger = await readRecommendationLedger(repoRoot);
+            const rec = recLedger.recommendations.find((r) => r.id === args.fromRec);
+            if (!rec) {
+                io.err(`draft new refused: recommendation ${args.fromRec} not found\n`);
+                return { exitCode: 1 };
+            }
+            if (rec.status !== 'candidate' && rec.status !== 'accepted') {
+                io.err(`draft 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}-DRAFT.md`);
+        if (existsSync(path)) {
+            io.err(`DRAFT already exists: ${path}\n`);
+            return { exitCode: 2 };
+        }
+        await mkdir(dir, { recursive: true });
+        const specPath = join(dir, `${id}-SPEC.md`);
+        let body;
+        if (existsSync(specPath)) {
+            const rawSpec = await readFile(specPath, 'utf8');
+            if (frontmatterStatus(rawSpec) === 'APPROVED') {
+                try {
+                    const spec = parseSpecMd(rawSpec);
+                    body = renderDraftBody(args.phase, id, tier, title, spec);
+                    io.out(`draft new: seeded objective + ${spec.acceptanceCriteria.length} AC(s) from approved SPEC ${id}\n`);
+                }
+                catch (err) {
+                    io.err(`draft new: SPEC ${id} APPROVED but unparseable (${err instanceof Error ? err.message : String(err)}) — scaffolding empty\n`);
+                    body = renderDraftBody(args.phase, id, tier, title);
+                }
+            }
+            else {
+                io.err(`draft new: SPEC ${id} present but not APPROVED — scaffolding empty\n`);
+                body = renderDraftBody(args.phase, id, tier, title);
+            }
+        }
+        else {
+            body = renderDraftBody(args.phase, id, tier, title);
+        }
+        await writeFile(path, body);
+        state.activePhase = args.phase;
+        state.activeDraft = id;
+        state.loopPosition = 'DRAFT';
+        if (!state.openDrafts.some((d) => d.id === id)) {
+            state.openDrafts.push({ id, since: new Date().toISOString() });
+        }
+        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(`draft 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(`draft new failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=draft-new.js.map

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

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

package/dist/services/io.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Command-service I/O seam (phase 58).
+ *
+ * The curated CLI commands exposed over MCP (`progress`, `status`, `recommend`,
+ * `draft new/check/approve`, `build task`, `settle`, `spec new/approve`) have
+ * their logic factored into pure `*Service(repoRoot, args, io)` functions. The
+ * CLI action wires `io` to the real process streams and exit code; the MCP tool
+ * handler wires `io` to in-memory buffers and serializes the structured result.
+ *
+ * This keeps a single implementation behind both surfaces — the CLI remains the
+ * rendering layer (byte-identical output), and MCP gets structured `data` plus
+ * the captured human text. No service imports the MCP SDK, so the CLI hot path
+ * never loads it (AC-7).
+ */
+/** A sink for a command's human-facing output, abstracted off `process`. */
+export interface CommandIO {
+    /** stdout-equivalent write (caller includes any trailing newline). */
+    out(s: string): void;
+    /** stderr-equivalent write (caller includes any trailing newline). */
+    err(s: string): void;
+}
+/**
+ * Structured result of a command service.
+ * - `exitCode` mirrors the CLI exit code (0 ok, 1 refusal/error, 2 structural).
+ * - `data` is the machine-readable payload surfaced as MCP `structuredContent`.
+ */
+export interface CommandResult {
+    exitCode: number;
+    data?: unknown;
+}
+/** `CommandIO` bound to the real process streams — used by the CLI actions. */
+export declare function processIO(): CommandIO;
+/** A `CommandIO` that captures into strings — used by the MCP tool handlers. */
+export interface BufferIO extends CommandIO {
+    stdout(): string;
+    stderr(): string;
+}
+export declare function bufferIO(): BufferIO;
+//# sourceMappingURL=io.d.ts.map

package/dist/services/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/services/io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sEAAsE;IACtE,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,IAAI,SAAS,CAKrC;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,MAAM,IAAI,MAAM,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAanC"}

package/dist/services/io.js

@@ -0,0 +1,36 @@
+/**
+ * Command-service I/O seam (phase 58).
+ *
+ * The curated CLI commands exposed over MCP (`progress`, `status`, `recommend`,
+ * `draft new/check/approve`, `build task`, `settle`, `spec new/approve`) have
+ * their logic factored into pure `*Service(repoRoot, args, io)` functions. The
+ * CLI action wires `io` to the real process streams and exit code; the MCP tool
+ * handler wires `io` to in-memory buffers and serializes the structured result.
+ *
+ * This keeps a single implementation behind both surfaces — the CLI remains the
+ * rendering layer (byte-identical output), and MCP gets structured `data` plus
+ * the captured human text. No service imports the MCP SDK, so the CLI hot path
+ * never loads it (AC-7).
+ */
+/** `CommandIO` bound to the real process streams — used by the CLI actions. */
+export function processIO() {
+    return {
+        out: (s) => void process.stdout.write(s),
+        err: (s) => void process.stderr.write(s),
+    };
+}
+export function bufferIO() {
+    let out = '';
+    let err = '';
+    return {
+        out: (s) => {
+            out += s;
+        },
+        err: (s) => {
+            err += s;
+        },
+        stdout: () => out,
+        stderr: () => err,
+    };
+}
+//# sourceMappingURL=io.js.map

package/dist/services/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/services/io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH,+EAA+E;AAC/E,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;KACzC,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,QAAQ;IACtB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACT,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QACD,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACT,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG;QACjB,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG;KAClB,CAAC;AACJ,CAAC"}

package/dist/services/progress.d.ts

@@ -0,0 +1,7 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence progress` — the single recommended next action (read-only).
+ * Returns `data: { command, reason }` for structured consumers.
+ */
+export declare function progressService(repoRoot: string, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/services/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/services/progress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CAYxB"}

package/dist/services/progress.js

@@ -0,0 +1,21 @@
+import { SimpleStateBackend } from '../state/simple.js';
+import { nextAction } from '../progress.js';
+/**
+ * `cadence progress` — the single recommended next action (read-only).
+ * Returns `data: { command, reason }` for structured consumers.
+ */
+export async function progressService(repoRoot, io) {
+    try {
+        const backend = new SimpleStateBackend(repoRoot);
+        const state = await backend.readState();
+        const action = nextAction(state);
+        io.out(`Next: ${action.command}\n`);
+        io.out(`Reason: ${action.reason}\n`);
+        return { exitCode: 0, data: { command: action.command, reason: action.reason } };
+    }
+    catch (err) {
+        io.err(`progress failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/services/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/services/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,EAAa;IAEb,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,EAAE,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;QACpC,EAAE,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/services/recommend.d.ts

@@ -0,0 +1,9 @@
+import type { CommandIO, CommandResult } from './io.js';
+/**
+ * `cadence recommend` — ranked strategic recommendations (read-only).
+ * `json: true` mirrors `--json`. `data` is the recommend report either way.
+ */
+export declare function recommendService(repoRoot: string, args: {
+    json?: boolean;
+}, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=recommend.d.ts.map

package/dist/services/recommend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../src/services/recommend.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACxB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/dist/services/recommend.js

@@ -0,0 +1,23 @@
+import { runRecommend } from '../intelligence/recommend.js';
+import { renderRecommendMd } from '../intelligence/render-recommend.js';
+/**
+ * `cadence recommend` — ranked strategic recommendations (read-only).
+ * `json: true` mirrors `--json`. `data` is the recommend report either way.
+ */
+export async function recommendService(repoRoot, args, io) {
+    try {
+        const report = await runRecommend(repoRoot);
+        if (args.json) {
+            io.out(JSON.stringify(report) + '\n');
+        }
+        else {
+            io.out(renderRecommendMd(report));
+        }
+        return { exitCode: 0, data: report };
+    }
+    catch (err) {
+        io.err(`recommend failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=recommend.js.map

package/dist/services/recommend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.js","sourceRoot":"","sources":["../../src/services/recommend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGxE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,IAAwB,EACxB,EAAa;IAEb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/services/settle.d.ts

@@ -0,0 +1,24 @@
+import type { CommandIO, CommandResult } from './io.js';
+export interface SettleArgs {
+    ac?: string[];
+    auto?: boolean;
+    force?: boolean;
+    allowMissingCoverage?: boolean;
+    deep?: boolean;
+    allowAutoComplex?: boolean;
+    allowStaleDraft?: boolean;
+    allowOpenTasks?: boolean;
+    allowFailingBuild?: boolean;
+    allowVerifierFailure?: boolean;
+    allowCodeReviewFailure?: boolean;
+    allowSecurityAuditFailure?: boolean;
+    allowSkillAuditMiss?: boolean;
+    interactive?: boolean;
+}
+/**
+ * `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 declare function settleService(repoRoot: string, opts: SettleArgs, io: CommandIO): Promise<CommandResult>;
+//# sourceMappingURL=settle.d.ts.map

package/dist/services/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/services/settle.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAaD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC,aAAa,CAAC,CA2TxB"}