helloagents 3.0.12 → 3.0.15-beta.1

package/scripts/cli-runtime-carrier.mjs

@@ -0,0 +1,36 @@
+import { join } from 'node:path'
+
+import { DEFAULTS } from './cli-config.mjs'
+import { safeJson } from './cli-utils.mjs'
+
+const CARRIER_SETTING_KEYS = [
+  'output_language',
+  'output_format',
+  'notify_level',
+  'ralph_loop_enabled',
+  'guard_enabled',
+  'kb_create_mode',
+  'project_store_mode',
+  'commit_attribution',
+]
+
+function pickCarrierSettings(settings) {
+  const merged = { ...DEFAULTS, ...(settings || {}) }
+  return Object.fromEntries(CARRIER_SETTING_KEYS.map((key) => [key, merged[key]]))
+}
+
+export function readCarrierSettings(home) {
+  return pickCarrierSettings(safeJson(join(home, '.helloagents', 'helloagents.json')) || {})
+}
+
+export function buildRuntimeCarrier(bootstrapContent, settings = {}) {
+  const normalized = String(bootstrapContent || '').trim()
+  if (!normalized) return ''
+
+  const carrierSettings = pickCarrierSettings(settings)
+  const snapshot = Object.keys(carrierSettings).length
+    ? `\n\n## 当前用户设置\n\`\`\`json\n${JSON.stringify(carrierSettings, null, 2)}\n\`\`\``
+    : ''
+
+  return `${normalized}${snapshot}\n`
+}

package/scripts/cli-runtime-root.mjs

@@ -0,0 +1,72 @@
+import { mkdtempSync, realpathSync, renameSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+
+import { copyEntries, ensureDir, removeIfExists } from './cli-utils.mjs'
+
+export const RUNTIME_ROOT_ENTRIES = [
+  '.claude-plugin',
+  '.codex-plugin',
+  'assets',
+  'bootstrap-lite.md',
+  'bootstrap.md',
+  'cli.mjs',
+  'gemini-extension.json',
+  'hooks',
+  'install.ps1',
+  'install.sh',
+  'LICENSE.md',
+  'package.json',
+  'README.md',
+  'README_CN.md',
+  'scripts',
+  'skills',
+  'templates',
+]
+
+/** Return the stable per-user runtime copy used by host integrations. */
+export function getStableRuntimeRoot(home) {
+  return join(home, '.helloagents', 'helloagents')
+}
+
+function normalizePath(path) {
+  const resolved = resolve(path)
+  try {
+    return realpathSync(resolved)
+  } catch {
+    return resolved
+  }
+}
+
+function samePath(left, right) {
+  const a = normalizePath(left)
+  const b = normalizePath(right)
+  return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b
+}
+
+/** Sync package runtime files into the stable root without copying repo-only files. */
+export function syncRuntimeRoot(sourceRoot, runtimeRoot) {
+  const source = resolve(sourceRoot)
+  const target = resolve(runtimeRoot)
+  if (samePath(source, target)) {
+    return { synced: false, root: target }
+  }
+
+  const parent = dirname(target)
+  ensureDir(parent)
+  const staging = mkdtempSync(join(parent, '.helloagents-runtime-'))
+
+  try {
+    copyEntries(source, staging, RUNTIME_ROOT_ENTRIES)
+    removeIfExists(target)
+    renameSync(staging, target)
+    return { synced: true, root: target }
+  } catch (error) {
+    removeIfExists(staging)
+    throw error
+  }
+}
+
+/** Remove the stable runtime copy while leaving user settings under ~/.helloagents intact. */
+export function removeRuntimeRoot(runtimeRoot) {
+  removeIfExists(runtimeRoot)
+}

package/scripts/cli-toml.mjs

@@ -164,85 +164,6 @@ export function ensureTopLevelTomlLine(text, key, line) {
   return upsertTopLevelTomlKey(text, key, value);
 }
 
-export function readTomlKeyInSection(text, headerLine, key) {
-  const lines = String(text || '').replace(/\r\n/g, '\n').split('\n');
-  const headerIndex = lines.findIndex((line) => line.trim() === headerLine);
-  if (headerIndex < 0) return '';
-
-  const keyRe = new RegExp(`^\\s*${key}\\s*=.*$`);
-  for (let index = headerIndex + 1; index < lines.length; index += 1) {
-    const line = lines[index];
-    if (isTomlTableHeader(line)) break;
-    if (keyRe.test(line)) return line.trim();
-  }
-  return '';
-}
-
-export function removeTomlKeyInSection(text, headerLine, key) {
-  const lines = String(text || '').replace(/\r\n/g, '\n').split('\n');
-  const headerIndex = lines.findIndex((line) => line.trim() === headerLine);
-  if (headerIndex < 0) return normalizeToml(text);
-
-  const keyRe = new RegExp(`^\\s*${key}\\s*=`);
-  const nextLines = [];
-  let removed = false;
-  for (let index = 0; index < lines.length; index += 1) {
-    const line = lines[index];
-    if (index > headerIndex && isTomlTableHeader(line)) {
-      nextLines.push(...lines.slice(index));
-      break;
-    }
-    if (index > headerIndex && keyRe.test(line)) {
-      removed = true;
-      continue;
-    }
-    nextLines.push(line);
-  }
-
-  if (!removed) return normalizeToml(text);
-  return normalizeToml(nextLines.join('\n'));
-}
-
-export function upsertTomlKeyInSection(text, headerLine, key, value) {
-  const lines = String(text || '').replace(/\r\n/g, '\n').split('\n');
-  const headerIndex = lines.findIndex((line) => line.trim() === headerLine);
-
-  if (headerIndex < 0) {
-    const base = normalizeToml(text).trimEnd();
-    return base
-      ? `${base}\n\n${headerLine}\n${key} = ${value}\n`
-      : `${headerLine}\n${key} = ${value}\n`;
-  }
-
-  let endIndex = headerIndex + 1;
-  while (endIndex < lines.length && !isTomlTableHeader(lines[endIndex])) {
-    endIndex += 1;
-  }
-
-  const keyRe = new RegExp(`^\\s*${key}\\s*=`);
-  let updated = false;
-  for (let index = headerIndex + 1; index < endIndex; index += 1) {
-    if (keyRe.test(lines[index])) {
-      lines[index] = `${key} = ${value}`;
-      updated = true;
-      break;
-    }
-  }
-
-  if (!updated) {
-    lines.splice(endIndex, 0, `${key} = ${value}`);
-  }
-
-  return normalizeToml(lines.join('\n'));
-}
-
-export function ensureTomlKeyInSection(text, headerLine, key, line) {
-  const normalized = String(line || '').trim();
-  if (!normalized) return normalizeToml(text);
-  const value = normalized.slice(normalized.indexOf('=') + 1).trim();
-  return upsertTomlKeyInSection(text, headerLine, key, value);
-}
-
 export function stripTomlSection(text, headerLine) {
   const lines = String(text || '').replace(/\r\n/g, '\n').split('\n');
   const kept = [];

package/scripts/cli-utils.mjs

@@ -130,10 +130,36 @@ export function cleanSettingsHooks(settingsPath, cleanPermissions = false) {
   }
 }
 
-/** Read hooks source file and replace path variable with absolute PKG_ROOT. */
-export function loadHooksWithAbsPath(pkgRoot, hooksFile, pathVar) {
+function rewriteHookCommandToCli(command = '', pathVar = '') {
+  const replacements = new Map([
+    [`node "${pathVar}/scripts/notify.mjs"`, 'helloagents-js notify'],
+    [`node "${pathVar}/scripts/guard.mjs"`, 'helloagents-js guard'],
+    [`node "${pathVar}/scripts/ralph-loop.mjs"`, 'helloagents-js ralph-loop'],
+  ]);
+
+  let next = command;
+  for (const [from, to] of replacements) {
+    next = next.replaceAll(from, to);
+  }
+  return next;
+}
+
+function rewriteHookCommands(value, pathVar) {
+  if (Array.isArray(value)) return value.map((item) => rewriteHookCommands(item, pathVar));
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+      key,
+      key === 'command' && typeof entry === 'string'
+        ? rewriteHookCommandToCli(entry, pathVar)
+        : rewriteHookCommands(entry, pathVar),
+    ]));
+  }
+  return value;
+}
+
+/** Read hooks source file and rewrite standby hooks to the stable CLI entrypoint. */
+export function loadHooksWithCliEntry(pkgRoot, hooksFile, pathVar) {
   const src = safeRead(join(pkgRoot, 'hooks', hooksFile));
   if (!src) return null;
-  const absRoot = pkgRoot.replace(/\\/g, '/');
-  return JSON.parse(src.replace(new RegExp(pathVar.replace(/[{}$]/g, '\\$&'), 'g'), absRoot));
+  return rewriteHookCommands(JSON.parse(src), pathVar);
 }

package/scripts/closeout-state.mjs

@@ -1,11 +1,18 @@
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
-import { join } from 'node:path'
-import { captureWorkspaceFingerprint } from './verify-state.mjs'
 import { appendReplayEvent } from './replay-state.mjs'
-
-export const CLOSEOUT_EVIDENCE_FILE_NAME = '.ralph-closeout.json'
-const CLOSEOUT_EVIDENCE_MAX_AGE_MS = 30 * 60 * 1000
+import {
+  captureWorkspaceFingerprint,
+  clearRuntimeEvidence,
+  getRuntimeEvidencePath,
+  getRuntimeEvidenceRelativePath,
+  readRuntimeEvidence,
+  validateEvidenceFingerprint,
+  validateEvidenceTimestamp,
+  writeRuntimeEvidence,
+} from './runtime-artifacts.mjs'
+
+export const CLOSEOUT_EVIDENCE_FILE_NAME = 'closeout.json'
 const ALLOWED_STATUSES = new Set(['PASS', 'BLOCKED'])
 
 function normalizeEntry(entry = {}) {
@@ -15,20 +22,16 @@ function normalizeEntry(entry = {}) {
   }
 }
 
-export function getCloseoutEvidencePath(cwd) {
-  return join(cwd, '.helloagents', CLOSEOUT_EVIDENCE_FILE_NAME)
+export function getCloseoutEvidencePath(cwd, options = {}) {
+  return getRuntimeEvidencePath(cwd, CLOSEOUT_EVIDENCE_FILE_NAME, options)
 }
 
-export function readCloseoutEvidence(cwd) {
-  try {
-    return JSON.parse(readFileSync(getCloseoutEvidencePath(cwd), 'utf-8'))
-  } catch {
-    return null
-  }
+export function readCloseoutEvidence(cwd, options = {}) {
+  return readRuntimeEvidence(cwd, CLOSEOUT_EVIDENCE_FILE_NAME, options)
 }
 
-export function clearCloseoutEvidence(cwd) {
-  rmSync(getCloseoutEvidencePath(cwd), { force: true })
+export function clearCloseoutEvidence(cwd, options = {}) {
+  clearRuntimeEvidence(cwd, CLOSEOUT_EVIDENCE_FILE_NAME, options)
 }
 
 export function normalizeCloseoutEvidence(input = {}) {
@@ -40,8 +43,7 @@ export function normalizeCloseoutEvidence(input = {}) {
   }
 }
 
-export function writeCloseoutEvidence(cwd, input = {}) {
-  mkdirSync(join(cwd, '.helloagents'), { recursive: true })
+export function writeCloseoutEvidence(cwd, input = {}, options = {}) {
   const normalized = normalizeCloseoutEvidence(input)
   const payload = {
     updatedAt: new Date().toISOString(),
@@ -51,51 +53,35 @@ export function writeCloseoutEvidence(cwd, input = {}) {
     deliveryChecklist: normalized.deliveryChecklist,
     fingerprint: captureWorkspaceFingerprint(cwd),
   }
-  writeFileSync(getCloseoutEvidencePath(cwd), `${JSON.stringify(payload, null, 2)}\n`, 'utf-8')
+  writeRuntimeEvidence(cwd, CLOSEOUT_EVIDENCE_FILE_NAME, payload, options)
   appendReplayEvent(cwd, {
     event: 'closeout_evidence_written',
     source: normalized.source || 'manual',
     skillName: normalized.originCommand,
+    payload: options.payload || {},
     details: {
       requirementsCoverage: normalized.requirementsCoverage,
       deliveryChecklist: normalized.deliveryChecklist,
     },
-    artifacts: ['.helloagents/.ralph-closeout.json'],
+    artifacts: [getRuntimeEvidenceRelativePath(cwd, CLOSEOUT_EVIDENCE_FILE_NAME, options)],
   })
   return payload
 }
 
-function readRequiredCloseoutEvidence(cwd) {
-  const evidence = readCloseoutEvidence(cwd)
+function readRequiredCloseoutEvidence(cwd, options = {}) {
+  const evidence = readCloseoutEvidence(cwd, options)
   if (evidence) return { evidence }
   return {
     error: {
       required: true,
       status: 'missing',
-      details: ['missing closeout evidence for requirements coverage and delivery checklist'],
+      details: ['缺少需求覆盖和交付清单的收尾证据'],
     },
   }
 }
 
 function validateCloseoutTimestamp(evidence, now) {
-  const updatedAt = Date.parse(evidence.updatedAt || '')
-  if (!Number.isFinite(updatedAt)) {
-    return {
-      required: true,
-      status: 'invalid',
-      evidence,
-      details: ['closeout evidence timestamp is invalid'],
-    }
-  }
-  if (now - updatedAt > CLOSEOUT_EVIDENCE_MAX_AGE_MS) {
-    return {
-      required: true,
-      status: 'stale-time',
-      evidence,
-      details: ['closeout evidence is older than 30 minutes'],
-    }
-  }
-  return null
+  return validateEvidenceTimestamp(evidence, now, '收尾证据')
 }
 
 function validateCloseoutEntries(evidence) {
@@ -112,7 +98,7 @@ function validateCloseoutEntries(evidence) {
       required: true,
       status: 'invalid',
       evidence,
-      details: ['closeout evidence must record requirements coverage and delivery checklist with explicit PASS/BLOCKED status plus summary'],
+      details: ['收尾证据必须记录需求覆盖和交付清单，并包含明确的 PASS/BLOCKED 状态和 summary'],
     }
   }
   if (requirementsCoverage.status !== 'PASS') {
@@ -120,7 +106,7 @@ function validateCloseoutEntries(evidence) {
       required: true,
       status: 'blocked',
       evidence,
-      details: ['requirements coverage is not marked as PASS in the latest closeout evidence'],
+      details: ['最新收尾证据中的需求覆盖未标记为 PASS'],
     }
   }
   if (deliveryChecklist.status !== 'PASS') {
@@ -128,7 +114,7 @@ function validateCloseoutEntries(evidence) {
       required: true,
       status: 'blocked',
       evidence,
-      details: ['delivery checklist is not marked as PASS in the latest closeout evidence'],
+      details: ['最新收尾证据中的交付清单未标记为 PASS'],
     }
   }
   return {
@@ -138,23 +124,10 @@ function validateCloseoutEntries(evidence) {
 }
 
 function validateCloseoutFingerprint(cwd, evidence) {
-  const currentFingerprint = captureWorkspaceFingerprint(cwd)
-  if (
-    currentFingerprint.available
-    && evidence.fingerprint?.available
-    && currentFingerprint.combined !== evidence.fingerprint.combined
-  ) {
-    return {
-      required: true,
-      status: 'stale-diff',
-      evidence,
-      details: ['workspace diff changed after the last successful closeout evidence'],
-    }
-  }
-  return null
+  return validateEvidenceFingerprint(cwd, evidence, '成功收尾证据')
 }
 
-export function getCloseoutEvidenceStatus(cwd, { required = false, now = Date.now() } = {}) {
+export function getCloseoutEvidenceStatus(cwd, { required = false, now = Date.now(), ...options } = {}) {
   if (!required) {
     return {
       required: false,
@@ -162,7 +135,7 @@ export function getCloseoutEvidenceStatus(cwd, { required = false, now = Date.no
     }
   }
 
-  const requiredEvidence = readRequiredCloseoutEvidence(cwd)
+  const requiredEvidence = readRequiredCloseoutEvidence(cwd, options)
   if (requiredEvidence.error) return requiredEvidence.error
 
   const { evidence } = requiredEvidence
@@ -200,10 +173,10 @@ function main() {
 
   const input = readStdinJson()
   const cwd = input.cwd || process.cwd()
-  const payload = writeCloseoutEvidence(cwd, input)
+  const payload = writeCloseoutEvidence(cwd, input, { payload: input })
   process.stdout.write(JSON.stringify({
     suppressOutput: true,
-    path: getCloseoutEvidencePath(cwd),
+    path: getCloseoutEvidencePath(cwd, { payload: input }),
     payload,
   }))
 }

package/scripts/delivery-gate-messages.mjs

@@ -0,0 +1,70 @@
+export function buildUnderSpecifiedDetails(entry) {
+  return entry.taskSummary.underSpecifiedItems
+    .slice(0, 3)
+    .map((item) => {
+      const missing = []
+      if (item.files.length === 0) missing.push('缺少涉及文件')
+      if (!item.acceptance) missing.push('缺少完成标准')
+      if (!item.validation) missing.push('缺少验证方式')
+      return `${item.text}（${missing.join('、')}）`
+    })
+}
+
+function issueHeading(issue) {
+  switch (issue.type) {
+    case 'missing-files':
+      return '方案包缺少必需文件'
+    case 'template-placeholders':
+      return '方案包仍包含模板占位内容'
+    case 'missing-task-checklist':
+      return '方案包没有可执行任务'
+    case 'unfinished-tasks':
+      return '方案包仍有未完成任务'
+    case 'under-specified-tasks':
+      return '任务缺少可交付元数据'
+    case 'missing-contract':
+      return '方案包缺少可信的结构化契约'
+    case 'missing-verify-evidence':
+      return '当前工作流缺少最新验证证据'
+    case 'missing-review-evidence':
+      return '当前工作流缺少最新审查证据'
+    case 'missing-advisor-evidence':
+      return '当前工作流缺少最新 advisor 证据'
+    case 'missing-visual-evidence':
+      return '当前工作流缺少最新视觉验收证据'
+    case 'missing-closeout-evidence':
+      return '当前工作流缺少最新收尾证据'
+    default:
+      return '方案包尚未达到交付条件'
+  }
+}
+
+export function buildDeliveryBlockReason(issues, recommendation, gateHint) {
+  const lines = ['[Delivery Gate] 当前工作流尚未闭合，暂不能交付：']
+
+  for (const issue of issues) {
+    lines.push(`- ${issue.planName}: ${issueHeading(issue)}`)
+    for (const detail of issue.details) {
+      lines.push(`  - ${detail}`)
+    }
+    if (issue.extraCount) {
+      lines.push(`  - 另有 ${issue.extraCount} 项`)
+    }
+  }
+
+  lines.push('')
+  if (recommendation?.nextPath) {
+    lines.push(`建议路径：${recommendation.nextPath}`)
+  }
+  if (issues.some((issue) => issue.type === 'missing-closeout-evidence')) {
+    lines.push('下一步收尾：先写入当前会话 `artifacts/closeout.json`，记录 `requirementsCoverage` 和 `deliveryChecklist`，再报告完成。')
+  }
+  if (issues.some((issue) => issue.type === 'missing-visual-evidence')) {
+    lines.push('下一步视觉验收：先写入当前会话 `artifacts/visual.json`，记录 `tooling`、`screensChecked`、`statesChecked`、`status` 和 `summary`，再报告完成。')
+  }
+  if (gateHint) {
+    lines.push(gateHint)
+  }
+  lines.push('暂不要报告完成。先完成剩余任务、明确关闭任务，或修复方案包，使其成为可信的交付记录。')
+  return lines.join('\n')
+}

package/scripts/delivery-gate.mjs

@@ -12,24 +12,13 @@ import { getVisualEvidenceStatus } from './visual-state.mjs'
 import { buildDeliveryGateHint, getDeliveryAction, getWorkflowRecommendation, getWorkflowSnapshot } from './workflow-state.mjs'
 import { getReviewEvidenceStatus } from './review-state.mjs'
 import { getVerifyEvidenceStatus } from './verify-state.mjs'
+import { buildDeliveryBlockReason, buildUnderSpecifiedDetails } from './delivery-gate-messages.mjs'
 
 function selectGatePlans(snapshot) {
   if (snapshot.activePlans.length > 0) return snapshot.activePlans
   return snapshot.plans
 }
 
-function buildUnderSpecifiedDetails(entry) {
-  return entry.taskSummary.underSpecifiedItems
-    .slice(0, 3)
-    .map((item) => {
-      const missing = []
-      if (item.files.length === 0) missing.push('missing files')
-      if (!item.acceptance) missing.push('missing acceptance')
-      if (!item.validation) missing.push('missing validation')
-      return `${item.text} (${missing.join(', ')})`
-    })
-}
-
 function collectTaskMetadataIssues(entry, issues) {
   if (entry.taskSummary.underSpecifiedCount === 0) return
   issues.push({
@@ -48,7 +37,7 @@ function collectPlanIssues(planEntries) {
       issues.push({
         type: 'missing-files',
         planName: entry.planName,
-        details: entry.missingFiles.map((file) => `missing ${file}`),
+        details: entry.missingFiles.map((file) => `缺少 ${file}`),
       })
     }
 
@@ -64,7 +53,7 @@ function collectPlanIssues(planEntries) {
       issues.push({
         type: 'missing-task-checklist',
         planName: entry.planName,
-        details: ['tasks.md does not contain any checklist items'],
+        details: ['tasks.md 没有可执行检查项'],
       })
       continue
     }
@@ -140,65 +129,6 @@ function collectGateIssues(planEntries, verificationStatus, reviewStatus, adviso
   return issues
 }
 
-function issueHeading(issue) {
-  switch (issue.type) {
-    case 'missing-files':
-      return 'active plan package is missing required artifacts'
-    case 'template-placeholders':
-      return 'active plan package still contains template placeholders'
-    case 'missing-task-checklist':
-      return 'active plan package has no executable tasks'
-    case 'unfinished-tasks':
-      return 'active plan package still has unfinished tasks'
-    case 'under-specified-tasks':
-      return 'active plan package has under-specified task metadata'
-    case 'missing-contract':
-      return 'active plan package is missing a trustworthy structured contract'
-    case 'missing-verify-evidence':
-      return 'current workflow is missing fresh verification evidence'
-    case 'missing-review-evidence':
-      return 'current workflow is missing fresh review evidence'
-    case 'missing-advisor-evidence':
-      return 'current workflow is missing fresh advisor evidence'
-    case 'missing-visual-evidence':
-      return 'current workflow is missing fresh visual validation evidence'
-    case 'missing-closeout-evidence':
-      return 'current workflow is missing fresh closeout evidence'
-    default:
-      return 'active plan package is not ready for delivery'
-  }
-}
-
-function buildBlockReason(issues, recommendation, gateHint) {
-  const lines = ['[Delivery Gate] Delivery is blocked because the current workflow state is not closed yet:']
-
-  for (const issue of issues) {
-    lines.push(`- ${issue.planName}: ${issueHeading(issue)}`)
-    for (const detail of issue.details) {
-      lines.push(`  - ${detail}`)
-    }
-    if (issue.extraCount) {
-      lines.push(`  - ...and ${issue.extraCount} more`)
-    }
-  }
-
-  lines.push('')
-  if (recommendation?.nextPath) {
-    lines.push(`Recommended path: ${recommendation.nextPath}`)
-  }
-  if (issues.some((issue) => issue.type === 'missing-closeout-evidence')) {
-    lines.push('Next closeout step: write `.helloagents/.ralph-closeout.json` with `requirementsCoverage` and `deliveryChecklist` before reporting completion.')
-  }
-  if (issues.some((issue) => issue.type === 'missing-visual-evidence')) {
-    lines.push('Next visual step: write `.helloagents/.ralph-visual.json` with `tooling`, `screensChecked`, `statesChecked`, `status`, and `summary` before reporting completion.')
-  }
-  if (gateHint) {
-    lines.push(gateHint)
-  }
-  lines.push('Do not report completion yet. First finish or explicitly close the remaining tasks, or repair the active plan package so it becomes a trustworthy delivery record.')
-  return lines.join('\n')
-}
-
 function main() {
   let data = {}
   try {
@@ -208,11 +138,12 @@ function main() {
   const workflowOptions = { payload: data }
   const snapshot = getWorkflowSnapshot(cwd, workflowOptions)
   const recommendation = getWorkflowRecommendation(cwd, workflowOptions)
-  const verificationStatus = getVerifyEvidenceStatus(cwd)
+  const verificationStatus = getVerifyEvidenceStatus(cwd, workflowOptions)
   const deliveryAction = getDeliveryAction(cwd, workflowOptions)
   const gatePlans = selectGatePlans(snapshot)
   const reviewStatus = getReviewEvidenceStatus(cwd, {
     required: deliveryAction?.phase === 'verify' && deliveryAction?.mode === 'review-first',
+    ...workflowOptions,
   })
   if (gatePlans.length === 0) {
     process.stdout.write(JSON.stringify({ suppressOutput: true }))
@@ -223,12 +154,14 @@ function main() {
   const advisorStatus = getAdvisorEvidenceStatus(cwd, {
     required: advisorRequirements.some((entry) => entry.required),
     focus: advisorRequirements.flatMap((entry) => entry.focus || []),
+    ...workflowOptions,
   })
   const visualRequirements = gatePlans.map((entry) => getVisualValidationRequirement(entry.contract))
   const visualStatus = getVisualEvidenceStatus(cwd, {
     required: visualRequirements.some((entry) => entry.required),
     screens: visualRequirements.flatMap((entry) => entry.screens || []),
     states: visualRequirements.flatMap((entry) => entry.states || []),
+    ...workflowOptions,
   })
   const closeoutRequired = (
     gatePlans.every((entry) => entry.missingFiles.length === 0 && entry.templateIssues.length === 0 && entry.taskSummary.total > 0 && entry.taskSummary.open === 0 && entry.taskSummary.underSpecifiedCount === 0)
@@ -239,6 +172,7 @@ function main() {
   )
   const closeoutStatus = getCloseoutEvidenceStatus(cwd, {
     required: closeoutRequired,
+    ...workflowOptions,
   })
 
   const issues = collectGateIssues(gatePlans, verificationStatus, reviewStatus, advisorStatus, visualStatus, closeoutStatus)
@@ -249,7 +183,7 @@ function main() {
 
   process.stdout.write(JSON.stringify({
     decision: 'block',
-    reason: buildBlockReason(issues, recommendation, buildDeliveryGateHint(cwd, workflowOptions)),
+    reason: buildDeliveryBlockReason(issues, recommendation, buildDeliveryGateHint(cwd, workflowOptions)),
     suppressOutput: true,
   }))
 }