helloagents 3.0.32 → 3.0.35

package/scripts/cli-messages.mjs

@@ -65,18 +65,18 @@ function renderInstallMessage(context, mode, state) {
 
   if (install) {
     return msg(
-      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 或 ~init 仅创建/同步知识库；用 ~global 初始化项目级全局模式；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
-      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki or ~init to create or sync the KB only; use ~global to initialize project-level global mode; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
+      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~init 初始化完整项目工作流；未初始化时也可继续用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    宿主级全局部署（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
+      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~init to initialize the full project workflow; uninitialized repos can still use ~command on demand.\n\n  Switch modes:\n    helloagents --global    Host-wide global deployment (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
     )
   }
 
   return msg(
     refresh
       ? `  standby 模式已刷新，CLI 注入与链接已同步最新文件。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`
-      : `  项目可通过 ~wiki 或 ~init 创建/同步知识库；用 ~global 初始化项目级全局模式；未初始化时仅注入轻量规则。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
+      : `  项目可通过 ~init 初始化完整工作流；未初始化时仅注入轻量规则。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
     refresh
       ? `  Standby mode refreshed; injected files and links were synchronized.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`
-      : `  Projects can use ~wiki or ~init to create/sync the KB; use ~global to initialize project-level global mode. Projects that are not initialized get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
+      : `  Projects can use ~init to initialize the full workflow; projects that are not initialized get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
   )
 }
 
@@ -90,7 +90,7 @@ HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
   helloagents-js             ${msg('（受管宿主配置的跨平台稳定入口）', '(cross-platform stable entrypoint for managed host configs)')}
 
 ${msg('模式切换', 'Mode switching')}:
-  helloagents --global     ${msg('项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
+  helloagents --global     ${msg('宿主级全局部署（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Host-wide global deployment (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
   helloagents --standby    ${msg('标准模式（非插件安装，hello-* 不自动触发，默认）', "Standby mode (non-plugin install, hello-* won't auto-trigger, default)")}
 
 ${msg('单 CLI 管理', 'Scoped CLI management')}:

package/scripts/delivery-gate-messages.mjs

@@ -24,10 +24,8 @@ function issueHeading(issue) {
       return '任务缺少可交付元数据'
     case 'missing-contract':
       return '方案包缺少可信的结构化契约'
-    case 'missing-verify-evidence':
-      return '当前工作流缺少最新验证证据'
-    case 'missing-review-evidence':
-      return '当前工作流缺少最新审查证据'
+    case 'missing-qa-review-evidence':
+      return '当前工作流缺少最新 qa-review 证据'
     case 'missing-advisor-evidence':
       return '当前工作流缺少最新 advisor 证据'
     case 'missing-visual-evidence':
@@ -62,6 +60,9 @@ export function buildDeliveryBlockReason(issues, recommendation, gateHint) {
   if (issues.some((issue) => issue.type === 'missing-visual-evidence')) {
     lines.push('视觉验收动作：先写入当前会话 `artifacts/visual.json`，记录 `tooling`、`screensChecked`、`statesChecked`、`status` 和 `summary`，再报告完成。')
   }
+  if (issues.some((issue) => issue.type === 'missing-qa-review-evidence')) {
+    lines.push('质量闭环动作：先完成 `~qa` 或写入当前会话 `artifacts/qa-review.json`，记录结论、问题定位、验证命令与最新结果，再报告完成。')
+  }
   if (gateHint) {
     lines.push(gateHint)
   }

package/scripts/delivery-gate.mjs

@@ -9,10 +9,9 @@ import { fileURLToPath } from 'node:url'
 import { getAdvisorEvidenceStatus } from './advisor-state.mjs'
 import { getCloseoutEvidenceStatus } from './closeout-state.mjs'
 import { getAdvisorRequirement, getVisualValidationRequirement } from './plan-contract.mjs'
+import { getQaReviewEvidenceStatus } from './qa-review-state.mjs'
 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) {
@@ -84,20 +83,12 @@ function collectPlanIssues(planEntries) {
   return issues
 }
 
-function collectEvidenceIssues(issues, verificationStatus, reviewStatus, advisorStatus, visualStatus, closeoutStatus) {
-  if (verificationStatus?.required && verificationStatus.status !== 'valid') {
+function collectEvidenceIssues(issues, qaStatus, advisorStatus, visualStatus, closeoutStatus) {
+  if (qaStatus?.required && qaStatus.status !== 'valid') {
     issues.push({
-      type: 'missing-verify-evidence',
+      type: 'missing-qa-review-evidence',
       planName: 'delivery',
-      details: verificationStatus.details,
-    })
-  }
-
-  if (reviewStatus?.required && reviewStatus.status !== 'valid') {
-    issues.push({
-      type: 'missing-review-evidence',
-      planName: 'delivery',
-      details: reviewStatus.details,
+      details: qaStatus.details,
     })
   }
   if (advisorStatus?.required && advisorStatus.status !== 'valid') {
@@ -124,9 +115,9 @@ function collectEvidenceIssues(issues, verificationStatus, reviewStatus, advisor
   }
 }
 
-function collectGateIssues(planEntries, verificationStatus, reviewStatus, advisorStatus, visualStatus, closeoutStatus) {
+function collectGateIssues(planEntries, qaStatus, advisorStatus, visualStatus, closeoutStatus) {
   const issues = collectPlanIssues(planEntries)
-  collectEvidenceIssues(issues, verificationStatus, reviewStatus, advisorStatus, visualStatus, closeoutStatus)
+  collectEvidenceIssues(issues, qaStatus, advisorStatus, visualStatus, closeoutStatus)
   return issues
 }
 
@@ -143,11 +134,10 @@ export function evaluateDeliveryGate(data = {}) {
   const workflowOptions = { payload: data }
   const snapshot = getWorkflowSnapshot(cwd, workflowOptions)
   const recommendation = getWorkflowRecommendation(cwd, workflowOptions)
-  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',
+  const qaStatus = getQaReviewEvidenceStatus(cwd, {
+    required: deliveryAction?.phase === 'qa' || deliveryAction?.phase === 'consolidate',
     ...workflowOptions,
   })
   if (gatePlans.length === 0) {
@@ -169,8 +159,7 @@ export function evaluateDeliveryGate(data = {}) {
   })
   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)
-    && (!verificationStatus.required || verificationStatus.status === 'valid')
-    && (!reviewStatus.required || reviewStatus.status === 'valid')
+    && (!qaStatus.required || qaStatus.status === 'valid')
     && (!advisorStatus.required || advisorStatus.status === 'valid')
     && (!visualStatus.required || visualStatus.status === 'valid')
   )
@@ -179,7 +168,7 @@ export function evaluateDeliveryGate(data = {}) {
     ...workflowOptions,
   })
 
-  const issues = collectGateIssues(gatePlans, verificationStatus, reviewStatus, advisorStatus, visualStatus, closeoutStatus)
+  const issues = collectGateIssues(gatePlans, qaStatus, advisorStatus, visualStatus, closeoutStatus)
   if (issues.length === 0) {
     return { suppressOutput: true }
   }

package/scripts/guard.mjs

@@ -76,7 +76,7 @@ function buildHighRiskGate(matches, cwd, payload = {}) {
   if (!recommendation) return null
   if (matches.some((match) => match.gate === 'post-verify')) {
     return {
-      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：当前工作流尚未进入 VERIFY / CONSOLIDATE。\n当前工作流：${recommendation.summary}\n处理路径：${recommendation.nextPath}\n${recommendation.guidance}`,
+      reason: `[HelloAGENTS Guard] 已阻止 T3 命令：当前工作流尚未进入 QA / CONSOLIDATE。\n当前工作流：${recommendation.summary}\n处理路径：${recommendation.nextPath}\n${recommendation.guidance}`,
     }
   }
   if (matches.some((match) => match.gate === 'plan-first') && recommendation.nextCommand === 'plan') {

package/scripts/notify-closeout.mjs

@@ -1,15 +1,56 @@
 import { createHash } from 'node:crypto'
 import { closeSync, mkdirSync, openSync, readFileSync, statSync, unlinkSync, writeFileSync } from 'node:fs'
-import { dirname } from 'node:path'
+import { dirname, join } from 'node:path'
+import { homedir } from 'node:os'
 
-import { getRuntimeEvidencePath, readRuntimeEvidence, writeRuntimeEvidence } from './runtime-artifacts.mjs'
-
-export const CODEX_CLOSEOUT_EVIDENCE_FILE = 'codex-native-stop.json'
-export const CODEX_QUICK_NOTIFY_EVIDENCE_FILE = 'codex-quick-notify.json'
-const CODEX_CLOSEOUT_LOCK_FILE = 'codex-native-stop.lock'
+export const CODEX_NOTIFY_STATE_FILE = 'notify-state.json'
+export const CODEX_NOTIFY_LOCK_FILE = 'notify.lock'
 const WEAK_KEY_TTL_MS = 10_000
 const LOCK_STALE_MS = 120_000
 
+function getHomeDir(env = process.env) {
+  return env.HOME || env.USERPROFILE || homedir()
+}
+
+export function getCodexNotifyDir(env = process.env) {
+  return join(getHomeDir(env), '.codex', '.helloagents')
+}
+
+export function getCodexNotifyStatePath(env = process.env) {
+  return join(getCodexNotifyDir(env), CODEX_NOTIFY_STATE_FILE)
+}
+
+export function getCodexNotifyLockPath(env = process.env) {
+  return join(getCodexNotifyDir(env), CODEX_NOTIFY_LOCK_FILE)
+}
+
+function readNotifyState(env = process.env) {
+  try {
+    const value = JSON.parse(readFileSync(getCodexNotifyStatePath(env), 'utf-8'))
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+      return { version: 1, nativeStop: null, quickNotify: null }
+    }
+    return {
+      version: 1,
+      nativeStop: value.nativeStop && typeof value.nativeStop === 'object' ? value.nativeStop : null,
+      quickNotify: value.quickNotify && typeof value.quickNotify === 'object' ? value.quickNotify : null,
+    }
+  } catch {
+    return { version: 1, nativeStop: null, quickNotify: null }
+  }
+}
+
+function writeNotifyState(state, env = process.env) {
+  const filePath = getCodexNotifyStatePath(env)
+  mkdirSync(dirname(filePath), { recursive: true })
+  writeFileSync(filePath, `${JSON.stringify({
+    version: 1,
+    nativeStop: state?.nativeStop || null,
+    quickNotify: state?.quickNotify || null,
+  }, null, 2)}\n`, 'utf-8')
+  return filePath
+}
+
 function getTurnId(payload = {}) {
   return String(payload.turnId || payload.turn_id || payload['turn-id'] || '').trim()
 }
@@ -118,13 +159,10 @@ export function matchesCodexCloseoutEvidence(evidence, snapshot, now = Date.now(
   return intersects(snapshot.weakKeys, weakKeys)
 }
 
-/**
- * Try to claim the current Codex closeout so Stop and native notify handle one turn only once.
- */
 export function beginCodexCloseoutClaim(cwd, { payload = {}, turnState = null, source = '' } = {}) {
   const snapshot = buildCodexCloseoutSnapshot({ payload, turnState })
-  const lockPath = getRuntimeEvidencePath(cwd, CODEX_CLOSEOUT_LOCK_FILE, { payload })
-  const evidencePath = getRuntimeEvidencePath(cwd, CODEX_CLOSEOUT_EVIDENCE_FILE, { payload })
+  const lockPath = getCodexNotifyLockPath()
+  const evidencePath = getCodexNotifyStatePath()
   const now = Date.now()
   const lockPayload = {
     source,
@@ -164,8 +202,8 @@ export function beginCodexCloseoutClaim(cwd, { payload = {}, turnState = null, s
     }
   }
 
-  const evidence = readRuntimeEvidence(cwd, CODEX_CLOSEOUT_EVIDENCE_FILE, { payload })
-  if (matchesCodexCloseoutEvidence(evidence, snapshot, now)) {
+  const notifyState = readNotifyState()
+  if (matchesCodexCloseoutEvidence(notifyState.nativeStop, snapshot, now)) {
     releaseLockFile(lockPath)
     return {
       claimed: false,
@@ -186,15 +224,13 @@ export function beginCodexCloseoutClaim(cwd, { payload = {}, turnState = null, s
   }
 }
 
-/**
- * Persist the handled closeout fingerprint and release the in-flight lock.
- */
 export function finalizeCodexCloseoutClaim(claim, meta = {}) {
   if (!claim?.claimed) return
 
   try {
     if (meta.handled !== false) {
-      writeRuntimeEvidence(claim.cwd, CODEX_CLOSEOUT_EVIDENCE_FILE, {
+      const notifyState = readNotifyState()
+      notifyState.nativeStop = {
         version: 2,
         updatedAt: new Date().toISOString(),
         source: meta.source || claim.source || '',
@@ -205,7 +241,8 @@ export function finalizeCodexCloseoutClaim(claim, meta = {}) {
         messageHash: claim.snapshot.messageHash,
         strongKeys: claim.snapshot.strongKeys,
         weakKeys: claim.snapshot.weakKeys,
-      }, { payload: claim.payload })
+      }
+      writeNotifyState(notifyState)
     }
   } finally {
     releaseLockFile(claim.lockPath)
@@ -214,7 +251,8 @@ export function finalizeCodexCloseoutClaim(claim, meta = {}) {
 
 export function writeCodexQuickNotifyEvidence(cwd, { payload = {}, turnState = null, event = '' } = {}) {
   const snapshot = buildCodexCloseoutSnapshot({ payload, turnState })
-  return writeRuntimeEvidence(cwd, CODEX_QUICK_NOTIFY_EVIDENCE_FILE, {
+  const notifyState = readNotifyState()
+  notifyState.quickNotify = {
     version: 1,
     updatedAt: new Date().toISOString(),
     event,
@@ -223,11 +261,12 @@ export function writeCodexQuickNotifyEvidence(cwd, { payload = {}, turnState = n
     messageHash: snapshot.messageHash,
     strongKeys: snapshot.strongKeys,
     weakKeys: snapshot.weakKeys,
-  }, { payload })
+  }
+  return writeNotifyState(notifyState)
 }
 
 export function hasCodexQuickNotifyEvidence(cwd, { payload = {}, turnState = null } = {}) {
   const snapshot = buildCodexCloseoutSnapshot({ payload, turnState })
-  const evidence = readRuntimeEvidence(cwd, CODEX_QUICK_NOTIFY_EVIDENCE_FILE, { payload })
-  return matchesCodexCloseoutEvidence(evidence, snapshot)
+  const notifyState = readNotifyState()
+  return matchesCodexCloseoutEvidence(notifyState.quickNotify, snapshot)
 }

package/scripts/notify-context.mjs

@@ -11,7 +11,7 @@ import {
 const COMMAND_ALIASES = {
   do: 'build',
   design: 'plan',
-  review: 'verify',
+  review: 'qa',
 };
 
 function buildRuntimeRootBlock(pkgRoot) {
@@ -49,13 +49,13 @@ function buildAliasRouteNote(skillName) {
     return '兼容别名映射：本次按 ~plan 规则执行；方案文件使用 `plan.md`，项目级 UI 契约仍使用 `DESIGN.md`。';
   }
   if (skillName === 'review') {
-    return '兼容别名映射：本次按 ~verify 的审查优先模式执行。';
+    return '兼容别名映射：本次按 ~qa 规则执行；统一走 qa-review 质量闭环。';
   }
   return '';
 }
 
 function buildDelegatedTaskHint() {
-  return '若当前输入明显来自上级代理、控制器或多代理协作上下文，且本次输出会交回上级代理继续汇总、决策或复述，而不是直接交付给最终用户，则按子代理处理：直接完成局部任务并返回结果、证据或阻塞项，不使用 HelloAGENTS 外层输出格式，不写 turn-state，不做面向最终用户的收尾。'
+  return '若当前任务由上级代理、控制器或宿主协作/委派机制创建，或本次输出会交回上级代理继续汇总、决策或复述，而不是直接交付给最终用户，则一律按子代理处理：直接完成局部任务并返回结果、证据或阻塞项；禁止输出 HelloAGENTS 外层格式、`🔄 下一步:`、turn-state 或面向最终用户的收尾。'
 }
 
 export function buildCompactionContext({ payload, pkgRoot, settings, bootstrapFile, host }) {
@@ -137,7 +137,7 @@ export function buildInjectContext({ source, bootstrap, settings, pkgRoot, host,
   if (capabilityHint) context += `\n\n## 当前按需能力\n${capabilityHint}`;
   if (stateSyncHint) context += `\n\n## 状态文件提醒\n${stateSyncHint}`;
   context += settingsBlock;
-  if (source === 'resume' || source === 'compact') {
+  if ((source === 'resume' || source === 'compact') && stateSnapshot.exists) {
     context += `\n\n> ⚠️ 会话已恢复/压缩，请先读取 \`state_path\` 指向的 \`${stateSnapshot.statePath.replace(/\\/g, '/')}\`；先看当前用户消息，如果仍是同一任务，再参考状态文件。`;
   }
   return context;
@@ -165,8 +165,8 @@ export function buildSemanticRouteInstruction(cwd, payload = {}) {
     '请根据用户请求的真实意图选路，不依赖关键词表。',
     buildDelegatedTaskHint(),
     'Delivery Tier: T0=探索/比较；T1=低风险小改动或显式验证；T2=多文件功能/新项目/需要结构化产物；T3=高风险或不可逆操作。',
-    '路由映射：~idea=只读探索，不创建文件；~build=明确实现；~verify=审查/验证；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
-    '若判定为 T3，默认先走 ~plan / ~prd；纯审查/验证请求才优先 ~verify。',
+    '路由映射：~idea=只读探索，不创建文件；~build=明确实现；~qa=统一质量审查/验证/修复/收尾；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
+    '若判定为 T3，默认先走 ~plan / ~prd；纯质量审查、验真或收尾请求才优先 ~qa。',
     `涉及 UI 任务时，设计决策优先级：当前活跃 plan / PRD → ${describeProjectStoreFile(cwd, 'DESIGN.md')} → 已读取的 hello-ui 规则；同时所有 UI 任务都必须满足 UI 质量基线。`,
     projectStorageHint,
     workflowHint ? `项目状态：${workflowHint}` : '',

package/scripts/notify-payload.mjs

@@ -14,6 +14,14 @@ const PAYLOAD_KEY_ALIASES = {
   stop_hook_active: 'stopHookActive',
   'goal-id': 'goalId',
   goal_id: 'goalId',
+  is_subagent: 'isSubagent',
+  sub_agent: 'subagent',
+  parent_agent_id: 'parentAgentId',
+  parent_turn_id: 'parentTurnId',
+  delegated_by_agent_id: 'delegatedByAgentId',
+  agent_id: 'agentId',
+  agent_role: 'agentRole',
+  agent_kind: 'agentKind',
 }
 
 function assignAlias(target, source, sourceKey, targetKey) {

package/scripts/notify-route.mjs

@@ -22,7 +22,7 @@ function shouldBypassRoute(prompt) {
 
 function buildHelpExtraRules(skillName) {
   if (skillName !== 'help') return ''
-  return ' 这是 HelloAGENTS 的帮助命令，不是宿主 CLI 的内置帮助。仅显示 HelloAGENTS 的帮助和当前设置；优先使用当前会话上下文中已注入的“当前用户设置”、配置文件原始 JSON 或此前读取结果摘要，上下文不存在或缺少要展示的配置项时才读取一次 ~/.helloagents/helloagents.json；自动激活技能说明仅在全局模式或已初始化项目时生效。不要调用宿主 CLI 的帮助工具（如 cli_help 或 /help），不要使用子代理，不要读取项目文件；若受工作区限制无法读取配置，必须明确说明并按已知默认值或已注入设置展示。'
+  return ' 这是 HelloAGENTS 的帮助命令，不是宿主 CLI 的内置帮助。仅显示 HelloAGENTS 的帮助和当前设置；优先使用当前会话上下文中已注入的“当前用户设置”、配置文件原始 JSON 或此前读取结果摘要，上下文不存在或缺少要展示的配置项时才读取一次 ~/.helloagents/helloagents.json；自动激活技能说明仅在宿主全局模式或已初始化项目时生效。不要调用宿主 CLI 的帮助工具（如 cli_help 或 /help），不要使用子代理，不要读取项目文件；若受工作区限制无法读取配置，必须明确说明并按已知默认值或已注入设置展示。'
 }
 
 function routeExplicitCommand({

package/scripts/notify-ui.mjs

@@ -4,7 +4,7 @@
  */
 import { platform } from 'node:os';
 import { join } from 'node:path';
-import { existsSync } from 'node:fs';
+import { appendFileSync, existsSync } from 'node:fs';
 import { execFileSync, spawn } from 'node:child_process';
 
 const PLAT = platform();
@@ -19,6 +19,17 @@ const NOTIFY_MESSAGES = {
 
 const WIN_APPID = 'HelloAgents.Notification';
 const DISABLE_OS_NOTIFICATIONS = process.env.HELLOAGENTS_DISABLE_OS_NOTIFICATIONS === '1';
+const TEST_NOTIFY_LOG = String(process.env.HELLOAGENTS_NOTIFY_TEST_LOG || '').trim();
+
+function recordTestTransport(kind, event) {
+  if (!TEST_NOTIFY_LOG) return false;
+  try {
+    appendFileSync(TEST_NOTIFY_LOG, `${kind} ${String(event || '')}\n`, 'utf-8');
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 function escapeToastText(value = '') {
   return String(value)
@@ -100,6 +111,7 @@ function runSoundHelper(pkgRoot, event, mode = 'background') {
 
 export function playSound(pkgRoot, event, options = {}) {
   if (DISABLE_OS_NOTIFICATIONS) return;
+  if (recordTestTransport('sound', event)) return;
   const wav = resolveWav(pkgRoot, event);
   if (!wav) { process.stderr.write('\x07'); return; }
   if (runSoundHelper(pkgRoot, event, options.mode === 'blocking' ? 'blocking' : 'background')) return;
@@ -152,6 +164,7 @@ $toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
 
 export function desktopNotify(pkgRoot, event, extra) {
   if (DISABLE_OS_NOTIFICATIONS) return;
+  if (recordTestTransport('desktop', event)) return;
   const notification = buildDesktopNotificationContent(event, extra);
   try {
     if (PLAT === 'win32') {

package/scripts/notify.mjs

@@ -41,7 +41,7 @@ const EVENT_NAME = {
   UserPromptSubmit: IS_GEMINI ? 'BeforeAgent' : 'UserPromptSubmit',
   PreCompact: IS_GEMINI ? 'BeforeAgent' : 'PreCompact',
 };
-const RALPH_LOOP_ROUTE_COMMANDS = new Set(['verify', 'loop']);
+const RALPH_LOOP_ROUTE_COMMANDS = new Set(['qa', 'loop']);
 const CODEX_HOOKS_FILE = join(homedir(), '.codex', 'hooks.json');
 const GATE_MODULE_LOADERS = {
   'turn-stop-gate': () => import('./turn-stop-gate.mjs'),
@@ -88,6 +88,59 @@ function getSettings() {
   return readSettings(CONFIG_FILE);
 }
 
+function hasTruthyAgentFlag(value) {
+  if (typeof value === 'boolean') return value;
+  const normalized = String(value || '').trim().toLowerCase();
+  return ['1', 'true', 'yes', 'subagent'].includes(normalized);
+}
+
+function hasNonEmptyValue(value) {
+  return String(value || '').trim().length > 0;
+}
+
+function looksLikeCodexDelegatedTurn(payload = {}) {
+  if (!IS_CODEX || !payload || typeof payload !== 'object') return false;
+  const client = String(payload.client || '').trim();
+  const inputMessages = Array.isArray(payload.inputMessages) ? payload.inputMessages : [];
+  return !client && inputMessages.length > 1;
+}
+
+function isSubagentPayload(payload = {}) {
+  if (!payload || typeof payload !== 'object') return false;
+
+  if ([payload.isSubagent, payload.subagent].some(hasTruthyAgentFlag)) {
+    return true;
+  }
+
+  const roleLike = [
+    payload.role,
+    payload.agentRole,
+    payload.agent_role,
+    payload.agentKind,
+    payload.agent_kind,
+    payload.kind,
+  ]
+    .map((value) => String(value || '').trim().toLowerCase())
+    .filter(Boolean);
+
+  if (roleLike.some((value) => ['subagent', 'delegate', 'delegated', 'worker', 'explorer'].includes(value))) {
+    return true;
+  }
+
+  if ([
+    payload.parentAgentId,
+    payload.parent_agent_id,
+    payload.parentTurnId,
+    payload.parent_turn_id,
+    payload.delegatedByAgentId,
+    payload.delegated_by_agent_id,
+  ].some(hasNonEmptyValue)) {
+    return true;
+  }
+
+  return looksLikeCodexDelegatedTurn(payload);
+}
+
 function shouldRunRalphLoop(cwd, turnState, payload = {}) {
   if (!turnState || turnState.kind !== 'complete') return false;
   if (turnState.requiresDeliveryGate) return true;
@@ -230,13 +283,28 @@ async function runRalphLoop(payload, { turnState } = {}) {
     blockEvent: 'verify_gate_blocked',
     exportName: 'evaluateRalphLoop',
     evaluateArgs: [payload, {
-      isSubagent: false,
+      isSubagent: isSubagentPayload(payload),
       isGemini: IS_GEMINI,
       hookEventName: HOST === 'codex' ? 'Stop' : (IS_GEMINI ? 'SessionEnd' : 'Stop'),
     }],
   });
 }
 
+async function runCodexSubagentGate(payload) {
+  if (!IS_CODEX || !isSubagentPayload(payload)) return false;
+  return await runInlineGate({
+    payload,
+    source: 'ralph-loop',
+    blockEvent: 'verify_gate_blocked',
+    exportName: 'evaluateRalphLoop',
+    evaluateArgs: [payload, {
+      isSubagent: true,
+      isGemini: false,
+      hookEventName: 'Stop',
+    }],
+  });
+}
+
 async function runDeliveryGate(payload) {
   return await runInlineGate({
     payload,
@@ -391,7 +459,7 @@ function cmdInject() {
   const cwd = payload.cwd || process.cwd();
   const settings = getSettings();
   const bootstrapFile = resolveBootstrapFile(cwd, settings, HOST);
-  const shouldEnsureProjectLocal = bootstrapFile === 'bootstrap.md' || source === 'resume' || source === 'compact';
+  const shouldEnsureProjectLocal = isProjectRuntimeActive(cwd);
 
   startReplaySession(cwd, {
     host: HOST,
@@ -447,6 +515,11 @@ async function cmdStop() {
   const payload = readPayloadFromStdin();
   const cwd = payload.cwd || process.cwd();
   const turnPayload = attachTurnSession(payload, cwd);
+  if (await runCodexSubagentGate(turnPayload)) return;
+  if (IS_CODEX && isSubagentPayload(turnPayload)) {
+    emptySuppress();
+    return;
+  }
   const turnState = readMainTurnState(cwd, turnPayload);
   const managedCodexStopHook = IS_CODEX && hasManagedCodexStopHook();
   const skipCompleteNotify = managedCodexStopHook && hasCodexQuickNotifyEvidence(cwd, {
@@ -504,7 +577,10 @@ async function cmdCodexNotify() {
     return;
   }
   if (type !== 'agent-turn-complete') return;
-  if (hasManagedCodexStopHook()) {
+  const managedCodexStopHook = hasManagedCodexStopHook();
+  if (managedCodexStopHook && !String(turnPayload.client || '').trim()) return;
+  if (isSubagentPayload(turnPayload)) return;
+  if (managedCodexStopHook) {
     const turnState = readMainTurnState(cwd, turnPayload);
     if (shouldEmitManagedCodexCompleteNotify(cwd, turnState, turnPayload)) {
       notifyByLevel('complete', buildNotifyExtra(data), getSettings(), { mode: 'blocking' });

package/scripts/plan-contract.mjs

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'node:url'
 import { resolveProjectPlanDir } from './project-storage.mjs'
 
 export const PLAN_CONTRACT_FILE_NAME = 'contract.json'
-const VALID_VERIFY_MODES = new Set(['test-first', 'review-first'])
+const VALID_QA_MODES = new Set(['standard', 'deep'])
 const VALID_ADVISOR_SOURCES = new Set(['claude', 'codex', 'gemini'])
 
 function normalizeStringArray(values) {
@@ -14,9 +14,9 @@ function normalizeStringArray(values) {
     .filter(Boolean))]
 }
 
-function normalizeVerifyMode(value) {
+function normalizeQaMode(value) {
   const normalized = typeof value === 'string' ? value.trim().toLowerCase() : ''
-  return VALID_VERIFY_MODES.has(normalized) ? normalized : ''
+  return VALID_QA_MODES.has(normalized) ? normalized : ''
 }
 
 function normalizeUiStyleAdvisorContract(input = {}) {
@@ -88,12 +88,11 @@ export function readPlanContract(planDir) {
 
 export function normalizePlanContract(input = {}) {
   return {
-    version: 1,
+    version: 2,
     source: typeof input.source === 'string' && input.source.trim() ? input.source.trim() : 'manual',
     originCommand: typeof input.originCommand === 'string' ? input.originCommand.trim() : '',
-    verifyMode: normalizeVerifyMode(input.verifyMode),
-    reviewerFocus: normalizeStringArray(input.reviewerFocus),
-    testerFocus: normalizeStringArray(input.testerFocus),
+    qaMode: normalizeQaMode(input.qaMode),
+    qaFocus: normalizeStringArray(input.qaFocus),
     ui: normalizeUiContract(input.ui),
     advisor: normalizeAdvisorContract(input.advisor),
   }
@@ -128,14 +127,11 @@ export function getPlanContractIssues(contract = null) {
   const advisorRequirement = getAdvisorRequirement(normalized)
   const visualValidation = getVisualValidationRequirement(normalized)
   const issues = []
-  if (!normalizeVerifyMode(normalized.verifyMode)) {
-    issues.push('contract.json missing valid verifyMode')
+  if (!normalizeQaMode(normalized.qaMode)) {
+    issues.push('contract.json missing valid qaMode')
   }
-  if (normalizeStringArray(normalized.testerFocus).length === 0) {
-    issues.push('contract.json missing testerFocus')
-  }
-  if (normalizeVerifyMode(normalized.verifyMode) === 'review-first' && normalizeStringArray(normalized.reviewerFocus).length === 0) {
-    issues.push('contract.json missing reviewerFocus for review-first flow')
+  if (normalizeStringArray(normalized.qaFocus).length === 0) {
+    issues.push('contract.json missing qaFocus')
   }
   if (normalized.ui?.required && normalizeStringArray(normalized.ui.sourcePriority).length === 0) {
     issues.push('contract.json missing ui.sourcePriority')