peaks-loop 4.0.54 → 4.1.1

package/dist/services/qa/qa-business-review-state.js

@@ -20,11 +20,26 @@ import { isUnsafePathInput } from '../../shared/path-safety.js';
 import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
 /** 6-item business checklist (12 Gaps QA perspective). */
 export const QA_BUSINESS_ITEMS = [
-    { id: 'business-flow', question: '这个功能"用起来"对吗?(业务流程顺不顺,操作路径是否反人类,跟现有系统交互有没有断层)' },
-    { id: 'req-coverage', question: '老板提的需求都覆盖了吗?(大需求点 vs 小需求点,显式需求 vs 隐式需求)' },
-    { id: 'boundary-cases', question: '边界 case 跟业务预期一致吗?(异常输入 / 错误提示用户语言 / 空加载失败状态)' },
-    { id: 'ui-assembly', question: '页面模式 / 关键交互 / 信息密度 跟产品预期一致吗?(装配验收,非视觉设计)' },
-    { id: 'exception-tone', question: '异常态 / 边界态视觉跟产品语调一致吗?(空状态有引导 / 加载态不闪烁 / 失败态有重试入口)' },
+    {
+        id: 'business-flow',
+        question: '这个功能"用起来"对吗?(业务流程顺不顺,操作路径是否反人类,跟现有系统交互有没有断层)'
+    },
+    {
+        id: 'req-coverage',
+        question: '老板提的需求都覆盖了吗?(大需求点 vs 小需求点,显式需求 vs 隐式需求)'
+    },
+    {
+        id: 'boundary-cases',
+        question: '边界 case 跟业务预期一致吗?(异常输入 / 错误提示用户语言 / 空加载失败状态)'
+    },
+    {
+        id: 'ui-assembly',
+        question: '页面模式 / 关键交互 / 信息密度 跟产品预期一致吗?(装配验收,非视觉设计)'
+    },
+    {
+        id: 'exception-tone',
+        question: '异常态 / 边界态视觉跟产品语调一致吗?(空状态有引导 / 加载态不闪烁 / 失败态有重试入口)'
+    },
     { id: 'mergeable', question: '能合入下个小版本吗?(业务风险 / 用户体验风险 / 集成断点)' }
 ];
 export function buildEmptyQaReview(requestId, sessionId, now = new Date()) {

package/dist/services/qa/screenshot-archive-service.js

@@ -92,9 +92,7 @@ export function archiveScreenshots(options) {
             archivedAt: now.toISOString()
         };
     }
-    const targetContentsBefore = existsSync(targetDir)
-        ? readdirSync(targetDir)
-        : [];
+    const targetContentsBefore = existsSync(targetDir) ? readdirSync(targetDir) : [];
     mkdirSync(targetDir, { recursive: true });
     const candidates = listScreenshotFiles(sourceDir, targetDir);
     const moved = [];

package/dist/services/rd/ast-gate.js

@@ -59,13 +59,13 @@ export async function runAstGate(input) {
                     api: name,
                     expectedVersion: depVersion,
                     actualVersion: 'unknown', // could resolve via npm view if needed
-                    severity: 'error',
+                    severity: 'error'
                 });
             }
         }
     }
     return {
         passed: violations.length === 0,
-        violations,
+        violations
     };
 }

package/dist/services/rd/impl.js

@@ -39,7 +39,7 @@ export async function writeImpl(input) {
         inputSig: input.inputSig,
         changedFiles: [...input.changedFiles],
         externalApiCalls: [...input.externalApiCalls],
-        astGateResult: input.astGate,
+        astGateResult: input.astGate
     };
     const sha256 = sha256Of(partial);
     const final = { ...partial, sha256 };

package/dist/services/rd/rd-service.js

@@ -53,7 +53,7 @@ function normalizeGoal(goal) {
     return normalized;
 }
 function isClearLowRiskGoal(goal) {
-    return /^fix\b/i.test(goal) && /\b(typo|spelling|comment|docs?|test|lint|format|copy)\b/i.test(goal);
+    return (/^fix\b/i.test(goal) && /\b(typo|spelling|comment|docs?|test|lint|format|copy)\b/i.test(goal));
 }
 const MIN_SAFE_SWARM_WORKERS = 25;
 const MAX_SAFE_SWARM_WORKERS = 80;
@@ -70,35 +70,71 @@ function resolveWorkerTarget(maxWorkers) {
     return { workerTarget: maxWorkers, blockedReasons: [] };
 }
 function resolveArtifactWorkspacePath(request) {
-    return request.artifactWorkspacePath ?? (request.workspace ? getLocalArtifactPath(request.workspace) : undefined);
+    return (request.artifactWorkspacePath ??
+        (request.workspace ? getLocalArtifactPath(request.workspace) : undefined));
 }
 function hasPlannerArtifactWorkspace(request, artifactWorkspacePath) {
-    return !!request.workspace && !!artifactWorkspacePath && hasValidArtifactWorkspace(request.workspace, artifactWorkspacePath);
+    return (!!request.workspace &&
+        !!artifactWorkspacePath &&
+        hasValidArtifactWorkspace(request.workspace, artifactWorkspacePath));
 }
 function buildTaskIds(workerTarget) {
     const fixed = [
-        'rd-discovery-1', 'rd-discovery-2', 'rd-discovery-3', 'rd-discovery-4', 'rd-discovery-5', 'rd-discovery-6', 'rd-discovery-7', 'rd-discovery-8',
-        'rd-planning-1', 'rd-planning-2', 'rd-planning-3', 'rd-planning-4', 'rd-planning-5', 'rd-planning-6', 'rd-planning-7', 'rd-planning-8',
-        'rd-test-1', 'rd-test-2', 'rd-test-3',
-        'peaks-qa-1', 'peaks-qa-2', 'peaks-qa-3', 'peaks-qa-4',
-        'rd-reducer-1',
+        'rd-discovery-1',
+        'rd-discovery-2',
+        'rd-discovery-3',
+        'rd-discovery-4',
+        'rd-discovery-5',
+        'rd-discovery-6',
+        'rd-discovery-7',
+        'rd-discovery-8',
+        'rd-planning-1',
+        'rd-planning-2',
+        'rd-planning-3',
+        'rd-planning-4',
+        'rd-planning-5',
+        'rd-planning-6',
+        'rd-planning-7',
+        'rd-planning-8',
+        'rd-test-1',
+        'rd-test-2',
+        'rd-test-3',
+        'peaks-qa-1',
+        'peaks-qa-2',
+        'peaks-qa-3',
+        'peaks-qa-4',
+        'rd-reducer-1'
     ];
     const implementationCount = Math.max(workerTarget - fixed.length, 1);
     const implementation = Array.from({ length: implementationCount }, (_, index) => `rd-impl-${String(index + 1).padStart(RD_TASK_ID_PAD_WIDTH, '0')}`);
-    return [...fixed.slice(0, RD_FIXED_TASK_BOUNDARY), ...implementation, ...fixed.slice(RD_FIXED_TASK_BOUNDARY)];
+    return [
+        ...fixed.slice(0, RD_FIXED_TASK_BOUNDARY),
+        ...implementation,
+        ...fixed.slice(RD_FIXED_TASK_BOUNDARY)
+    ];
 }
 function isInsidePath(childPath, parentPath) {
     const relativePath = relative(parentPath, childPath);
     return relativePath === '' || (!relativePath.startsWith('..') && !isAbsolute(relativePath));
 }
 function isSafeRepoRelativePath(candidate) {
-    if (!candidate || candidate.includes('\\') || candidate.startsWith('/') || /^[A-Za-z]:/.test(candidate) || candidate.includes(':') || isAbsolute(candidate)) {
+    if (!candidate ||
+        candidate.includes('\\') ||
+        candidate.startsWith('/') ||
+        /^[A-Za-z]:/.test(candidate) ||
+        candidate.includes(':') ||
+        isAbsolute(candidate)) {
         return false;
     }
-    return candidate.split('/').every((segment) => segment.length > 0 && segment !== '.' && segment !== '..');
+    return candidate
+        .split('/')
+        .every((segment) => segment.length > 0 && segment !== '.' && segment !== '..');
 }
 function extractCandidatePath(line) {
-    const trimmed = line.trim().replace(/^[-*+]\s+/, '').trim();
+    const trimmed = line
+        .trim()
+        .replace(/^[-*+]\s+/, '')
+        .trim();
     const codeSpan = trimmed.match(/^`([^`]+)`(?:\s|$)/);
     const firstToken = trimmed.split(/\s+/)[0];
     const candidate = codeSpan === null ? firstToken : codeSpan[1];
@@ -126,7 +162,9 @@ function selectConcreteTargetArea(targetAreas, index) {
     return targetAreas[index % targetAreas.length];
 }
 function getTaskModelRole(wave) {
-    return wave === 'implementation candidates' || wave === 'unit-test execution' ? 'execution' : 'strongest';
+    return wave === 'implementation candidates' || wave === 'unit-test execution'
+        ? 'execution'
+        : 'strongest';
 }
 function getTaskModelId(modelRole, executionModelId, strongestModelId) {
     return modelRole === 'execution' ? executionModelId : strongestModelId;
@@ -139,11 +177,16 @@ function readArtifactFile(rootPath, artifactWorkspacePath, artifact) {
         const rootRealPath = stableRealPath(rootPath);
         const rdRootPath = resolve(rootPath, '..');
         const sessionRootPath = resolve(rdRootPath, '..');
-        if (lstatSync(sessionRootPath).isSymbolicLink() || lstatSync(rdRootPath).isSymbolicLink() || lstatSync(rootPath).isSymbolicLink() || !isInsidePath(rootRealPath, artifactWorkspaceRealPath)) {
+        if (lstatSync(sessionRootPath).isSymbolicLink() ||
+            lstatSync(rdRootPath).isSymbolicLink() ||
+            lstatSync(rootPath).isSymbolicLink() ||
+            !isInsidePath(rootRealPath, artifactWorkspaceRealPath)) {
             return null;
         }
         const artifactStat = lstatSync(artifactPath);
-        if (artifactStat.isSymbolicLink() || !artifactStat.isFile() || artifactStat.size > MAX_ARTIFACT_BYTES) {
+        if (artifactStat.isSymbolicLink() ||
+            !artifactStat.isFile() ||
+            artifactStat.size > MAX_ARTIFACT_BYTES) {
             return null;
         }
         if (!isInsidePath(stableRealPath(artifactPath), rootRealPath)) {
@@ -153,7 +196,12 @@ function readArtifactFile(rootPath, artifactWorkspacePath, artifact) {
         try {
             const openedStat = fstatSync(fd);
             const currentStat = statSync(artifactPath);
-            if (!openedStat.isFile() || openedStat.size > MAX_ARTIFACT_BYTES || openedStat.dev !== artifactStat.dev || openedStat.ino !== artifactStat.ino || openedStat.dev !== currentStat.dev || openedStat.ino !== currentStat.ino) {
+            if (!openedStat.isFile() ||
+                openedStat.size > MAX_ARTIFACT_BYTES ||
+                openedStat.dev !== artifactStat.dev ||
+                openedStat.ino !== artifactStat.ino ||
+                openedStat.dev !== currentStat.dev ||
+                openedStat.ino !== currentStat.ino) {
                 return null;
             }
             const buffer = Buffer.alloc(MAX_ARTIFACT_BYTES + 1);
@@ -171,7 +219,8 @@ function readArtifactFile(rootPath, artifactWorkspacePath, artifact) {
             closeSync(fd);
         }
     }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+    catch {
+        // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
         return null;
     }
 }
@@ -188,7 +237,9 @@ function resolveExecutionModelId() {
     }
 }
 function getConcreteTargetAreas(request, artifactWorkspacePath, hasApprovedTechArtifacts) {
-    if (!artifactWorkspacePath || !hasApprovedTechArtifacts || !hasPlannerArtifactWorkspace(request, artifactWorkspacePath)) {
+    if (!artifactWorkspacePath ||
+        !hasApprovedTechArtifacts ||
+        !hasPlannerArtifactWorkspace(request, artifactWorkspacePath)) {
         return [];
     }
     // Slice 2026-06-29-change-id-root-removal: read path now resolves via
@@ -213,15 +264,16 @@ function buildStandardsOverlay(request) {
     if (!request.projectRoot) {
         return {};
     }
-    const check = resolveRdStartupStandardsCheck({ projectRoot: request.projectRoot, strict: request.strictStandards === true });
+    const check = resolveRdStartupStandardsCheck({
+        projectRoot: request.projectRoot,
+        strict: request.strictStandards === true
+    });
     // Slice 2026-06-16-peaks-rd-no-gates — Repair cycle 1:
     // thread BOTH diagnostic and errorCode so strict-mode callers still
     // surface `EPEAKS_NO_STANDARDS`. The pre-fix version early-returned
     // on `diagnostic !== null` and dropped `errorCode` (QA#4 AC3 violation).
     const overlay = { standardsGates: check.gates };
-    const withDiagnostic = check.diagnostic !== null
-        ? { ...overlay, standardsDiagnostic: check.diagnostic }
-        : overlay;
+    const withDiagnostic = check.diagnostic !== null ? { ...overlay, standardsDiagnostic: check.diagnostic } : overlay;
     return check.errorCode !== null
         ? { ...withDiagnostic, standardsErrorCode: check.errorCode }
         : withDiagnostic;
@@ -241,7 +293,7 @@ function buildPlan(request, standardsOverlay) {
     const techStatus = getTechStatus({
         sessionId: request.sessionId,
         ...(artifactWorkspacePath ? { artifactWorkspacePath } : {}),
-        ...(request.workspace ? { workspace: request.workspace } : {}),
+        ...(request.workspace ? { workspace: request.workspace } : {})
     });
     const requiresTechApproval = request.requiresTechApproval ?? !isClearLowRiskGoal(goal);
     const techGateSkipped = !requiresTechApproval;
@@ -259,15 +311,17 @@ function buildPlan(request, standardsOverlay) {
                 taskGraph: 'rd/swarm/task-graph.json',
                 waveManifests: [],
                 workerBriefs: [],
-                reducerReport: 'rd/swarm/reducer-report.md',
+                reducerReport: 'rd/swarm/reducer-report.md'
             },
             gateStatus: withStandardsOverlay({
                 techApprovalRequired: requiresTechApproval,
                 techStatus: techStatus.status,
-                ...(techGateSkipped ? { skipReason: 'tech-gate-skipped-clear-implementation-path' } : {}),
+                ...(techGateSkipped
+                    ? { skipReason: 'tech-gate-skipped-clear-implementation-path' }
+                    : {})
             }, standardsOverlay),
             blockedReasons,
-            nextActions: [],
+            nextActions: []
         };
     }
     if (requiresTechApproval && techStatus.status !== 'approved') {
@@ -284,14 +338,16 @@ function buildPlan(request, standardsOverlay) {
                 taskGraph: 'rd/swarm/task-graph.json',
                 waveManifests: [],
                 workerBriefs: [],
-                reducerReport: 'rd/swarm/reducer-report.md',
+                reducerReport: 'rd/swarm/reducer-report.md'
             },
             gateStatus: withStandardsOverlay({
                 techApprovalRequired: true,
-                techStatus: techStatus.status,
+                techStatus: techStatus.status
             }, standardsOverlay),
             blockedReasons: ['tech-approval-required', ...blockedReasons],
-            nextActions: ['Run peaks tech plan --dry-run and approve the tech plan before running peaks swarm plan.'],
+            nextActions: [
+                'Run peaks tech plan --dry-run and approve the tech plan before running peaks swarm plan.'
+            ]
         };
     }
     if (blockedReasons.includes('worker-count-below-target')) {
@@ -308,15 +364,19 @@ function buildPlan(request, standardsOverlay) {
                 taskGraph: 'rd/swarm/task-graph.json',
                 waveManifests: [],
                 workerBriefs: [],
-                reducerReport: 'rd/swarm/reducer-report.md',
+                reducerReport: 'rd/swarm/reducer-report.md'
             },
             gateStatus: withStandardsOverlay({
                 techApprovalRequired: requiresTechApproval,
                 techStatus: techStatus.status,
-                ...(techGateSkipped ? { skipReason: 'tech-gate-skipped-clear-implementation-path' } : {}),
+                ...(techGateSkipped
+                    ? { skipReason: 'tech-gate-skipped-clear-implementation-path' }
+                    : {})
             }, standardsOverlay),
             blockedReasons,
-            nextActions: ['Lower max-workers to match the current change scope or accept the capped target.'],
+            nextActions: [
+                'Lower max-workers to match the current change scope or accept the capped target.'
+            ]
         };
     }
     const taskIds = buildTaskIds(workerTarget);
@@ -333,7 +393,7 @@ function buildPlan(request, standardsOverlay) {
         { name: 'implementation candidates', taskIds: [...implementationTaskIds] },
         { name: 'unit-test execution', taskIds: [...unitTestTaskIds] },
         { name: 'quality gates', taskIds: [...qualityTaskIds] },
-        { name: 'reducer', taskIds: [...reducerTaskIds] },
+        { name: 'reducer', taskIds: [...reducerTaskIds] }
     ];
     const waveDependencies = {
         discovery: [],
@@ -341,10 +401,20 @@ function buildPlan(request, standardsOverlay) {
         'implementation candidates': planningTaskIds,
         'unit-test execution': implementationTaskIds,
         'quality gates': unitTestTaskIds,
-        reducer: qualityTaskIds,
+        reducer: qualityTaskIds
     };
     const tasks = taskIds.map((taskId, index) => {
-        const wave = index < RD_DISCOVERY_PLANNING_WAVE_SIZE ? 'discovery' : index < RD_IMPLEMENTATION_BAND_START ? 'planning' : index < taskIds.length - RD_DISCOVERY_PLANNING_WAVE_SIZE ? 'implementation candidates' : index < taskIds.length - RD_QUALITY_GATE_BAND_SIZE ? 'unit-test execution' : index < taskIds.length - 1 ? 'quality gates' : 'reducer';
+        const wave = index < RD_DISCOVERY_PLANNING_WAVE_SIZE
+            ? 'discovery'
+            : index < RD_IMPLEMENTATION_BAND_START
+                ? 'planning'
+                : index < taskIds.length - RD_DISCOVERY_PLANNING_WAVE_SIZE
+                    ? 'implementation candidates'
+                    : index < taskIds.length - RD_QUALITY_GATE_BAND_SIZE
+                        ? 'unit-test execution'
+                        : index < taskIds.length - 1
+                            ? 'quality gates'
+                            : 'reducer';
         const briefPath = `rd/swarm/workers/${taskId}/brief.md`;
         const implementationIndex = index - RD_IMPLEMENTATION_BAND_START;
         const targetArea = wave === 'implementation candidates' && hasConcreteTargetAreas(concreteTargetAreas)
@@ -371,14 +441,14 @@ function buildPlan(request, standardsOverlay) {
                         ? `${taskId}-test-command-result.md`
                         : wave === 'quality gates'
                             ? `${taskId}-qa-review.md`
-                            : `${taskId}.md`,
+                            : `${taskId}.md`
         };
     });
     const conflictGroups = waves.map((wave) => ({
         groupId: `group-${wave.name.replace(/\s+/g, '-')}`,
         ownedPaths: wave.taskIds.map((taskId) => `rd/swarm/workers/${taskId}/brief.md`),
         parallelismPolicy: wave.taskIds.length > 1 ? 'parallel' : 'sequential',
-        reason: `${wave.name} work is isolated by worker output path`,
+        reason: `${wave.name} work is isolated by worker output path`
     }));
     return {
         sessionId: request.sessionId,
@@ -393,15 +463,19 @@ function buildPlan(request, standardsOverlay) {
             taskGraph: 'rd/swarm/task-graph.json',
             waveManifests: waves.map((_wave, index) => `rd/swarm/waves/wave-${index + 1}-${_wave.name}.json`),
             workerBriefs: tasks.map((task) => task.outputs[0]),
-            reducerReport: 'rd/swarm/reducer-report.md',
+            reducerReport: 'rd/swarm/reducer-report.md'
         },
         gateStatus: withStandardsOverlay({
             techApprovalRequired: requiresTechApproval,
             techStatus: techStatus.status,
-            ...(techGateSkipped ? { skipReason: 'tech-gate-skipped-clear-implementation-path' } : {}),
+            ...(techGateSkipped
+                ? { skipReason: 'tech-gate-skipped-clear-implementation-path' }
+                : {})
         }, standardsOverlay),
         blockedReasons,
-        nextActions: blockedReasons.length > 0 ? ['Lower max-workers to match the current change scope or accept the capped target.'] : [],
+        nextActions: blockedReasons.length > 0
+            ? ['Lower max-workers to match the current change scope or accept the capped target.']
+            : []
     };
 }
 export function createRdSwarmPlan(request) {
@@ -425,7 +499,7 @@ export function createRdSwarmPlan(request) {
             outputs: result.outputs,
             gateStatus: result.gateStatus,
             blockedReasons: result.blockedReasons,
-            nextActions: [...WORKSPACE_UNAVAILABLE_NEXT_ACTIONS],
+            nextActions: [...WORKSPACE_UNAVAILABLE_NEXT_ACTIONS]
         };
     }
     const blockedReason = result.blockedReasons[0];
@@ -443,11 +517,11 @@ export function createRdSwarmPlan(request) {
             outputs: result.outputs,
             gateStatus: result.gateStatus,
             blockedReasons: result.blockedReasons,
-            nextActions: result.nextActions,
+            nextActions: result.nextActions
         };
     }
     return {
         available: true,
-        ...result,
+        ...result
     };
 }

package/dist/services/rd/reviewer-dispatch-policy.js

@@ -84,7 +84,7 @@ export const RD_REVIEW_REQUEST_TYPES = [
     'refactor',
     'config',
     'docs',
-    'chore',
+    'chore'
 ];
 /**
  * The 3-sub-agent fanout triggered at the end of RD implementation
@@ -95,7 +95,7 @@ export const RD_REVIEW_REQUEST_TYPES = [
 export const RD_FANOUT_REVIEWERS = [
     'code-reviewer',
     'qa-test-cases-writer',
-    'karpathy-reviewer',
+    'karpathy-reviewer'
 ];
 /**
  * Reviewer roles removed from the v2.11.x 5-way fanout. Exposed as a
@@ -110,10 +110,7 @@ export const RD_FANOUT_REVIEWERS = [
  * Use `isDeprecatedReviewer(name)` (not direct array membership) so
  * future deprecations can use the same predicate without churn.
  */
-export const RD_DEPRECATED_REVIEWERS = [
-    'security-reviewer',
-    'perf-baseline-reviewer',
-];
+export const RD_DEPRECATED_REVIEWERS = ['security-reviewer', 'perf-baseline-reviewer'];
 /** Subset of request types that fire the 3-way fanout. */
 export const RD_FANOUT_REQUEST_TYPES = ['feat', 'bugfix', 'refactor'];
 /**
@@ -128,7 +125,7 @@ export function shouldDispatchKarpathy(type) {
  * True iff the request type triggers the 3-way review fanout.
  */
 export function isFanoutTriggerType(type) {
-    return (type === 'feat' || type === 'bugfix' || type === 'refactor');
+    return type === 'feat' || type === 'bugfix' || type === 'refactor';
 }
 /**
  * Returns the ordered list of reviewer roles to dispatch for this

package/dist/services/rd/standards-diagnostic.js

@@ -43,7 +43,10 @@ import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 /** Stable exit code surfaced to the CLI when `--strict-standards` is set. */
 export const EPEAKS_NO_STANDARDS = 'EPEAKS_NO_STANDARDS';
-export const RD_STANDARDS_REQUIRED_SUBDIRS = ['common', 'typescript'];
+export const RD_STANDARDS_REQUIRED_SUBDIRS = [
+    'common',
+    'typescript'
+];
 /**
  * Pure detection: scan `<projectRoot>/.claude/rules/{common,typescript}/`
  * for at least one `.md` rule file per subdir. Empty subdirs and missing

package/dist/services/rd/strategy.js

@@ -23,7 +23,7 @@ export async function writeStrategy(input) {
         rootCauseAnalysis: input.rootCauseAnalysis,
         impactSurface: input.impactSurface,
         designRationale: input.designRationale,
-        ...(input.askUserQuestion ? { askUserQuestion: input.askUserQuestion } : {}),
+        ...(input.askUserQuestion ? { askUserQuestion: input.askUserQuestion } : {})
     };
     const sha256 = sha256Of(partial);
     const final = { ...partial, sha256 };
@@ -42,10 +42,17 @@ export async function writeStrategy(input) {
         ``,
         `## Design Rationale`,
         input.designRationale,
-        ...(input.askUserQuestion ? [``, `## Decision Needed`, `**${input.askUserQuestion.question}**`, ...input.askUserQuestion.options.map((o) => `- ${o}`)] : []),
+        ...(input.askUserQuestion
+            ? [
+                ``,
+                `## Decision Needed`,
+                `**${input.askUserQuestion.question}**`,
+                ...input.askUserQuestion.options.map((o) => `- ${o}`)
+            ]
+            : []),
         ``,
         `---`,
-        `STRAT.sig: ${sha256}`,
+        `STRAT.sig: ${sha256}`
     ].join('\n');
     const tmp = `${input.out}.tmp`;
     try {

package/dist/services/rd/tactical-stage.js

@@ -41,7 +41,7 @@ export async function runTacticalStage(input) {
     const astGate = await runAstGate({
         project: input.project,
         changedFiles: input.changedFiles,
-        context: input.context,
+        context: input.context
     });
     // H8 chain enforcement: inputSig must equal STRAT.sig for this project.
     // Runs AFTER AST gate so existing AST-gate error semantics are preserved.
@@ -57,6 +57,6 @@ export async function runTacticalStage(input) {
         inputSig: input.inputSig,
         changedFiles: input.changedFiles,
         externalApiCalls: [], // v1: AST gate emits violations; future slice maps to calls
-        astGate,
+        astGate
     });
 }

package/dist/services/rd/types.js

@@ -13,10 +13,12 @@ export const StrategyOutputSchema = z.object({
     rootCauseAnalysis: z.string(),
     impactSurface: z.array(z.string()),
     designRationale: z.string(),
-    askUserQuestion: z.object({
+    askUserQuestion: z
+        .object({
         question: z.string(),
-        options: z.array(z.string()),
-    }).optional(),
+        options: z.array(z.string())
+    })
+        .optional()
 });
 export const AstViolationSchema = z.object({
     file: z.string(),
@@ -24,17 +26,17 @@ export const AstViolationSchema = z.object({
     api: z.string(),
     expectedVersion: z.string(),
     actualVersion: z.string(),
-    severity: z.enum(['error', 'warning']),
+    severity: z.enum(['error', 'warning'])
 });
 export const AstGateResultSchema = z.object({
     passed: z.boolean(),
-    violations: z.array(AstViolationSchema),
+    violations: z.array(AstViolationSchema)
 });
 export const ExternalApiCallSchema = z.object({
     file: z.string(),
     line: z.number().int(),
     api: z.string(),
-    version: z.string(),
+    version: z.string()
 });
 export const ImplOutputSchema = z.object({
     version: z.literal('1.0'),
@@ -43,5 +45,5 @@ export const ImplOutputSchema = z.object({
     inputSig: z.string().regex(/^[a-f0-9]{64}$/), // STRAT.sig
     changedFiles: z.array(z.string()),
     externalApiCalls: z.array(ExternalApiCallSchema),
-    astGateResult: AstGateResultSchema,
+    astGateResult: AstGateResultSchema
 });

package/dist/services/rd-swarm/rd-swarm-service.d.ts

@@ -1,5 +1,7 @@
 import type { WorkspaceConfig } from '../config/config-types.js';
 import { type BoundaryError } from '../openspec/artifact-boundary.js';
+import type { RdTaskGraph } from './rd-swarm-types.js';
+export type { RdConflictGroup, RdTask, RdTaskGraph, RdWaveName } from './rd-swarm-types.js';
 export type RdSwarmPlanRequest = {
     skill: 'rd' | string;
     changeId: string;
@@ -11,50 +13,5 @@ export type RdSwarmPlanRequest = {
     requiresTechApproval?: boolean;
     workspace?: WorkspaceConfig;
 };
-export type RdWaveName = 'discovery' | 'planning' | 'implementation candidates' | 'quality gates' | 'reducer';
-export type RdTask = {
-    taskId: string;
-    wave: RdWaveName;
-    workerKind: string;
-    purpose: string;
-    inputs: string[];
-    outputs: [string, ...string[]];
-    dependsOn: string[];
-    conflictGroup: string;
-    targetArea: string;
-    expectedEvidence: string;
-};
-export type RdConflictGroup = {
-    groupId: string;
-    ownedPaths: string[];
-    parallelismPolicy: 'parallel' | 'sequential';
-    reason: string;
-};
-export type RdTaskGraph = {
-    changeId: string;
-    goal: string;
-    available: boolean;
-    workerTarget: number;
-    waves: Array<{
-        name: RdWaveName;
-        taskIds: string[];
-    }>;
-    tasks: RdTask[];
-    conflictGroups: RdConflictGroup[];
-    artifactRoot: string;
-    outputs: {
-        taskGraph: string;
-        waveManifests: string[];
-        workerBriefs: string[];
-        reducerReport: string;
-    };
-    gateStatus: {
-        techApprovalRequired: boolean;
-        techStatus: string;
-        skipReason?: string;
-    };
-    blockedReasons: string[];
-    nextActions: string[];
-};
 export declare function planRdSwarmGraph(input: RdSwarmPlanRequest): RdTaskGraph;
 export type { BoundaryError };