export interface HookOutput {  // 方言中立的 hook 结果词汇表：两个桥共享的"通用语"，各自再映射到类型化 Decision  exitCode: number | undefined  // 进程退出码；spawn 失败时为 undefined——没有干净退出码就没有可依据的决策  stderr: string  // trim 后的 stderr——exit 2 阻塞时它就是给模型/用户看的 block-reason  stdout: string  // 原样保留的 stdout：干净退出时可能是纯文本（CC 当输出、Codex 当 additionalContext），所以不能只留解析结果  continue?: boolean  // false ⇒ hook 要求停机；与 stopReason 配对，true/缺省 ⇒ 继续  stopReason?: string  // continue:false 时展示给人看的原因  decision?: 'approve' | 'allow' | 'block' | 'deny' | 'ask'  // 归一化后的权限决策：block/deny=禁止、approve/allow=放行、ask=要确认；缺省 ⇒ 由退出码说了算  reason?: string  // 伴随 decision 的解释文本（给模型或用户看）  hookEventName?: string  // hookSpecificOutput 声称的事件名——不匹配时保留记录但丢弃其事件域字段，防串台  additionalContext?: string  // 注入给下一次模型请求的额外上下文（CC additionalContext / Codex 纯 stdout）  systemMessage?: string  // 展示给用户的警告（CC systemMessage）——目前只记日志不上浮  updatedInput?: Record<string, unknown>  // hook 要求的工具入参改写——已解析但不生效，出现时桥会 warn}

const CLAUDE_LITERAL = /^[A-Za-z0-9_|]+$/  // CC 的"字面量判别式"：纯字母数字下划线+竖线 ⇒ 按精确匹配处理，不当正则export function matcherDiagnostic(matcher: string | undefined, mode: MatcherMode): string | undefined {  if (isMatchAll(matcher)) return undefined  // 缺省/空串/'*' 三个哨兵值 = 全匹配，两种方言一致，无需校验  const pattern = matcher as string  // 过了 match-all 守卫后必然是非空字符串  if (mode === 'claude-code' && CLAUDE_LITERAL.test(pattern)) return undefined  // CC 字面量模式天然合法——它根本不是正则  const compiled = compileRegex(pattern)  // 其余情况必须能编译成正则；编不出来返回稳定诊断串（配置期报错用）  return compiled === undefined ? `invalid ${mode} regex matcher ${JSON.stringify(pattern)}` : undefined}export function matchesMatcher(matcher: string | undefined, query: string, mode: MatcherMode): boolean {  if (isMatchAll(matcher)) return true  // match-all 哨兵：缺省/空串/'*' 一律命中  const pattern = matcher as string  // 非空字符串  if (mode === 'claude-code' && CLAUDE_LITERAL.test(pattern)) {    return pattern.split('|').includes(query)  // CC 字面量模式：按 | 拆成候选列表做精确包含——"Bash|Edit" 只命中这两个工具名，不解释任何正则元字符  }  return compileRegex(pattern)?.test(query) ?? false  // 其余情况（CC 非字面量 + Codex 全部）：无锚定正则；编译失败返回 undefined → 按不匹配处理而不是抛异常}

export function parseHookOutput(exitCode: number | undefined, stdout: string, stderr: string, expectedEventName?: string): HookOutput {  const trimmedErr = stderr.trim()  // stderr 先 trim——它将来是 block-reason，空白不该进日志和模型上下文  const trimmedOut = stdout.trim()  // stdout 同样 trim；纯文本场景下首尾空白没有语义  const output: HookOutput = { exitCode, stderr: trimmedErr, stdout: trimmedOut }  // 先落三个"永远可用"的原始字段——即使后面 JSON 解析失败，纯 stdout 也还在  if (exitCode === BLOCKING_EXIT_CODE) {  // exit 2：两种方言共有的阻塞信号    output.decision = 'block'  // 直接置为 block——这是退出码契约里唯一"无条件生效"的决策    if (trimmedErr.length > 0) output.reason = trimmedErr  // stderr 非空时作为原因；为空则不写 reason（调用方有兜底文案）  }  if (exitCode === 0) {  // 结构化 stdout 只在干净退出时才有效——非零退出的 stdout 是错误信息，不是协议数据    if (trimmedOut.startsWith('{')) {  // 只有"看起来像 JSON 对象"才尝试解析——对齐参考引擎：其他 stdout 当纯文本，不当错误      let parsed: Record<string, unknown> | undefined      try {        parsed = obj(JSON.parse(trimmedOut))  // 解析并断言是普通对象（非 null、非数组）；类型不对就按没有结构化输出处理      } catch {        parsed = undefined  // 干净退出但 JSON 坏了 = 宽容降级：不报错，纯 stdout 留给桥自己用（参考引擎就是这么宽容的）      }      if (parsed) applyStructured(output, parsed, expectedEventName)  // 解析成功才折叠结构化字段；expectedEventName 守卫 hookSpecificOutput 串台    }  }  return output  // 函数是"全定义"（total）：任何输入都有确定输出，绝不抛异常——hook 的坏输出不能炸掉宿主 turn}

function applyStructured(output: HookOutput, parsed: Record<string, unknown>, expectedEventName?: string): void {  const cont = bool(parsed, 'continue')  // 读顶层 continue（布尔）；类型不对返回 undefined，不猜  if (cont !== undefined) output.continue = cont  // 有就折叠——false 时桥会映射成停机/拒绝  const stopReason = str(parsed, 'stopReason')  // 顶层 stopReason：continue:false 时的展示原因  if (stopReason !== undefined) output.stopReason = stopReason  const sysMsg = str(parsed, 'systemMessage')  // 顶层 systemMessage：给用户的警告（目前桥只记日志）  if (sysMsg !== undefined) output.systemMessage = sysMsg  const topDecision = topLevelDecisionOf(str(parsed, 'decision'))  // 顶层遗留 decision——只认 approve/block，allow/deny/ask 出现在这里是 schema 非法值  if (topDecision !== undefined) output.decision = topDecision  // 折叠进统一枚举；带外 {"decision":"deny"} 在这里被静默忽略（不能变成真阻塞）  const topReason = str(parsed, 'reason')  // 顶层 reason：伴随 decision 的解释  if (topReason !== undefined) output.reason = topReason  const hso = obj(parsed.hookSpecificOutput)  // hookSpecificOutput：按事件键控的"每事件通道"，permissionDecision/additionalContext/updatedInput 都住这里  if (hso) {    const eventName = str(hso, 'hookEventName')  // 读它声称的事件名——即使不匹配也先记录（日志要能看到坏块声称了什么）    if (eventName !== undefined) output.hookEventName = eventName    if (expectedEventName !== undefined && eventName !== expectedEventName) {      return  // 守卫命中：声称的事件 ≠ 正在触发的事件 ⇒ 丢弃整个事件域字段，但顶层字段和判别式已保留——防串台的核心一行    }    const permission = permissionDecisionOf(str(hso, 'permissionDecision'))  // allow/deny/ask 三值；只认这三个词    if (permission !== undefined) output.decision = permission  // 覆盖前面折叠的顶层 decision——permissionDecision 优先级更高（schema 语义）    const permissionReason = str(hso, 'permissionDecisionReason')  // 伴随权限决策的原因    if (permissionReason !== undefined) output.reason = permissionReason    const addCtx = str(hso, 'additionalContext')  // 注入给模型的额外上下文    if (addCtx !== undefined) output.additionalContext = addCtx    const updated = obj(hso.updatedInput)  // 工具入参改写请求——解析出来但桥不执行（见 CC 桥的 warn）    if (updated !== undefined) output.updatedInput = updated  }}

export async function runHook(bash: ShellExecutor, hook: CommandHook, options: RunHookOptions, now: () => number): Promise<RunHookResult> {  const started = now()  // 记起点——durationMs 要落进 hook/result 审计事件，用注入的时钟而不是 Date.now（可测试）  const timeoutMs = hook.timeoutSec !== undefined ? hook.timeoutSec * 1000 : options.defaultTimeoutMs  // 单条 hook 的秒级超时优先；没配就用桥传入的默认值（参考默认 600s=10 分钟）  const stdin = JSON.stringify(options.payload) + (options.trailingNewline ? '\n' : '')  // payload 序列化进 stdin——CC 要尾换行、Codex 不要，帧格式是方言差异所以由桥决定  const request = {    command: hook.command,  // 配置里的 shell 命令行（CC 已做过 ${CLAUDE_PLUGIN_ROOT} 替换）    timeoutMs,  // 超时交给 shell executor 的进程组取消机制——到点杀整棵进程树，不是只杀父进程    stdin,  // 事件 payload：session_id/cwd/tool_name/... 方言字段由桥构建    signal: options.signal,  // 宿主操作级 AbortSignal——turn 被取消时 hook 跟着死；detached 点传的是 tracker 的 signal    ...options.cwd !== undefined ? { workdir: options.cwd } : {},  // 工作目录 = agent 会话 workspace（不是服务启动目录）——相对路径要指向用户项目    ...options.env !== undefined ? { env: options.env } : {},  // CC 桥注入 CLAUDE_PROJECT_DIR；Codex 不注入任何 hook 环境变量  }  try {    const result = await bash.run(bash.resolve(request))  // resolve() 做凭据清洗（scrub）后执行——hook 进程拿不到宿主环境里的密钥    const exitCode = result.exitCode ?? undefined  // ShellRunResult.exitCode 是 number|null（null=被信号杀死）；协议契约要数字，信号死映射成 undefined    return {      output: parseHookOutput(exitCode, result.stdout.text, result.stderr.text, options.expectedEventName),  // 解码——expectedEventName 守卫在这里生效      durationMs: now() - started,  // 墙钟耗时，落审计事件    }  } catch (error: unknown) {    const message = error instanceof Error ? error.message : String(error)  // executor 只在基础设施故障时 reject（workdir 不可用、shell 缺失）    return {      output: parseHookOutput(undefined, '', message),  // hook 跑不起来 = 非阻塞错误：无退出码、失败信息进 stderr 字段留痕——turn 继续走，绝不抛给调用方      durationMs: now() - started,    }  }}

function rank(decision: HookOutput['decision']): number {  // 把决策映射成"严格度等级"——数字越大越严  switch (decision) {    case 'deny': case 'block': return 3  // block/deny 折叠到同一档：禁止（两种方言的措辞差异在这里抹平）    case 'ask': return 2  // ask：要求人工确认，比放行严、比禁止松    case 'approve': case 'allow': return 1  // approve/allow 同档：放行    default: return 0  // 没表达决策（退出码说了算）——不参与严格度竞争  }}export function mergeHookOutputs(outputs: HookOutput[]): MergedHookOutcome {  let maxRank = 0  // 记录全场最严等级；空列表保持 0 ⇒ decision:'none'，调用方视为"没有 hook 说话"  const reasonsByRank = new Map<number, string[]>()  // 按等级分桶收集 reason——只让"赢的那一档"的理由上浮，低档的反对意见不刷屏  let stop = false  // continue:false 是粘性的：任何一条 hook 要求停机就停  let stopReason: string | undefined  // 取第一条停机 hook 的 stopReason（先到先得）  const additionalContext: string[] = []  // 所有 hook 的 additionalContext，按 hook 顺序累积——上下文只增不减  const systemMessages: string[] = []  // 同理：systemMessage 全量保留  for (const out of outputs) {    const r = rank(out.decision)  // 本条 hook 的严格度    if (r > maxRank) maxRank = r  // 只升不降——最严格者胜的核心一行    if ((r === 3 || r === 2) && out.reason !== undefined && out.reason.length > 0) {      const list = reasonsByRank.get(r) ?? []  // 只有禁止/确认两档的 reason 值得留——放行理由没有信息量      list.push(out.reason)      reasonsByRank.set(r, list)    }    if (out.continue === false && !stop) {  // 粘性停机：第一条 continue:false 生效，后续不再覆盖 stopReason      stop = true      if (out.stopReason !== undefined) stopReason = out.stopReason    }    if (out.additionalContext !== undefined && out.additionalContext.length > 0) {      additionalContext.push(out.additionalContext)  // 上下文全量累积——多条 hook 的补充信息都注入给模型，不互相覆盖    }    if (out.systemMessage !== undefined && out.systemMessage.length > 0) {      systemMessages.push(out.systemMessage)    }  }  const reasons = reasonsByRank.get(maxRank) ?? []  // 只取赢家的理由桶  return {    decision: decisionForRank(maxRank),  // 3→deny、2→ask、1→allow、0→none    ...reasons.length > 0 ? { reason: reasons.join('\n\n') } : {},  // 同档多条理由用空行拼接——模型能看到所有反对意见的完整文本    stop,    ...stopReason !== undefined ? { stopReason } : {},    additionalContext,    systemMessages,  }}

export function appendHookResult(session: Session, record: HookResultRecord): void {  const { output } = record  // 解构解码结果——decision/exitCode/stderrSummary 三个持久化字段都从它派生  const stderrSummary = summarizeStderr(output.stderr, record.stderrSummaryMaxChars)  // stderr 截断：trim、空则 undefined、超长切 maxChars + '…'；上限是桥的配置值（默认 500）  session.append('hook/result', {    turn: record.turn,  // 落在哪个 open turn 里——审计事件必须 turn-enclosed，不能跨 turn 悬挂    point: record.point,  // hook 点：PreToolUse / Stop / ...    handlerId: record.handlerId,  // 与 hook/invoked 配对的稳定 id（claude-code:PreToolUse:3 这种格式）    decision: output.decision ?? (output.continue === false ? 'stop' : 'pass'),  // 决策落盘优先级：显式 decision > continue:false 记为 stop > 其余记 pass——三态审计    ...output.exitCode !== undefined ? { exitCode: output.exitCode } : {},  // spawn 失败（无退出码）时省略该字段，而不是写 null——日志里"没有"和"是0"语义不同    ...stderrSummary !== undefined ? { stderrSummary } : {},  // 空 stderr 不写字段；非空才落截断摘要    durationMs: record.durationMs,  // 墙钟耗时——审计时序，排查慢 hook 用  })}

export function createDetachedRuns(): DetachedRuns {  const inflight = new Set<Promise<unknown>>()  // 在飞注册表：每条 detached 链（hook run + 后续副作用）都登记在这里  const controller = new AbortController()  // 一个 tracker 一个 signal——drain 时触发它，正在跑的 hook 进程被杀而不是等超时（默认要等 10 分钟！）  return {    signal: controller.signal,  // 桥必须把这个 signal 传给 runHook——这是"dispose 能杀死在飞 hook"的接线点    track(run: Promise<unknown>): void {      inflight.add(run)  // 登记整条链：不只是进程退出，还包括 .then 里的 inject/warn 副作用      const settled = (): void => { inflight.delete(run) }  // 结算即出表——长会话不会无限累积已完成的 Promise      void run.then(settled, settled)  // then/reject 都触发清理；注意：吞掉 rejection 只是簿记，真正的 .catch 仍是调用方的责任    },    async drain(): Promise<void> {      controller.abort(new Error('hook bridge disposed'))  // 先杀：abort signal ⇒ shell executor 取消进程组——不等超时      while (inflight.size > 0) {  // 再等：波次式排空——每轮 allSettled 后重查，因为前一波结算期间可能又有新链被 track        await Promise.allSettled([...inflight])      }    },  }}

export function apply(ctx: Context, config: Config): void {  const stderrSummaryMaxChars = config.stderrSummaryMaxChars ?? DEFAULT_STDERR_SUMMARY_MAX_CHARS  // 审计摘要上限，缺省用协议默认 500 字符  assertPositiveInteger('stderrSummaryMaxChars', stderrSummaryMaxChars)  // 先校验再解析配置——坏值不能藏在后面的 early return 里被吞掉  const defaultTimeoutMs = config.defaultTimeoutMs ?? DEFAULT_HOOK_TIMEOUT_MS  // 单 hook 默认超时（参考默认 600s）  let parsed: ClaudeCodeHookConfig = {}  // 解析结果：事件名 → matcher group 列表；加载失败时保持空对象  try {    const raw: unknown = JSON.parse(readFileSync(config.configPath, 'utf8'))  // 进程级一次性读取——相对路径按启动 cwd 解析，一份配置管整个进程    const result = parseClaudeCodeConfig(raw, {      ...config.pluginRoot !== undefined ? { pluginRoot: config.pluginRoot } : {},  // ${CLAUDE_PLUGIN_ROOT} 替换值（插件根目录）      ...config.projectDir !== undefined ? { projectDir: config.projectDir } : {},  // ${CLAUDE_PROJECT_DIR} 替换值（项目根）——解析期就代入命令串    })    parsed = result.config  // 只保留可运行的 command hook    for (const s of result.skipped) {      ctx.logger.warn(`hooks-claude-code: skipping unsupported "${s.type}" hook on ${s.event} (only command hooks run)`)  // prompt/agent/http 等非命令类型：不静默丢弃，逐条 warn——用户能看到自己的 hook 没生效及原因    }  } catch (error: unknown) {    ctx.logger.warn(`hooks-claude-code: could not load hook config "${config.configPath}": ${String(error)} — no hooks registered`)  // 读文件/解析失败 = 降级为"无 hook"，不炸启动——但留一条能定位的 warn    return  }  const detached = createDetachedRuns()  // SessionStart/SubagentStart/Stop 这类发射型点跑在 tracker 里  const subagentChildren = new Map<SubagentRunId, Agent>()  // start 边保留子 agent 引用——stop hook 要在 handle 注销后仍能拿到会话 workspace  ctx.effect(() => () => detached.drain(), 'hooks-claude-code: drain detached hook runs')  // 注册 disposer：fiber dispose 时 abort + 排空所有在飞 hook（见第七节）}

    const groups: MatcherGroup[] = parsed[point] ?? []  // 取该 hook 点的配置组；没配就是空数组，后面循环直接跳过    const outputs: HookOutput[] = []  // 收集每条命中 hook 的解码结果，最后统一合并    const workdir = opts.agent?.session.header.cwd  // 工作目录 = agent 会话 workspace（session/new 时的 cwd）——不是服务启动目录，相对路径才指向用户项目    const projectDir = config.projectDir ?? workdir  // CLAUDE_PROJECT_DIR：显式配置优先；没配就默认成会话 workspace（CC 总是导出这个变量，存量 hook 常引用它）    const hookEnv = projectDir !== undefined ? { CLAUDE_PROJECT_DIR: projectDir } : undefined  // CC 方言专属环境变量——Codex 桥不注入任何 hook env    for (const group of groups) {      if (!matchesMatcher(group.matcher, matchQuery, 'claude-code')) continue  // matcher 过滤：matchQuery 是事件主体（工具名/会话来源）；'claude-code' mode 启用字面量快路径      for (const hook of group.hooks) {        const handlerId = nextHandlerId(point)  // claude-code:PreToolUse:N——invoked/result 配对用的稳定 id        const session = opts.agent?.session  // 有 agent 才有会话可写审计事件        if (session && opts.turn !== undefined) {          appendHookInvoked(session, { turn: opts.turn, point, dialect: 'claude-code', handlerId, ...group.matcher !== undefined ? { matcher: group.matcher } : {} })  // 先落 invoked——执行前就留痕，hook 卡死也能看到"谁被调用了"        }        const { output, durationMs } = await runHook(ctx.shell, hook, {          payload,  // 方言 payload（CC 形状：session_id/transcript_path/cwd/tool_name/...）由调用方构建          defaultTimeoutMs,  // 桥持有的默认超时          ...hookEnv ? { env: hookEnv } : {},  // CLAUDE_PROJECT_DIR          ...workdir !== undefined ? { cwd: workdir } : {},  // 会话 workspace          signal: opts.signal,  // turn 级取消信号；detached 点传的是 tracker signal          trailingNewline: true,  // CC stdin 帧带尾换行——Codex 桥这里是 false，一字节差异          expectedEventName: point,  // hookSpecificOutput 串台守卫：声称其他事件的块被丢弃事件域字段        }, () => performance.now())        outputs.push(output)  // 累积结果        if (output.updatedInput !== undefined) {          ctx.logger.warn(`hooks-claude-code: ${point} hook requested updatedInput, which is not yet honored (ignored)`)  // CC 的入参改写：解析了但不执行——faithful-but-degraded 的典型，warn 让用户知道        }        if (output.systemMessage !== undefined) {          ctx.logger.warn(`hooks-claude-code: ${point} hook emitted a systemMessage, which is not yet surfaced (ignored)`)  // 用户可见警告：同样只记日志不上浮 UI        }        if (session && opts.turn !== undefined) {          appendHookResult(session, { turn: opts.turn, point, handlerId, output, stderrSummaryMaxChars, durationMs })  // 落 result——与 invoked 配对，decision/exitCode/stderrSummary/durationMs 全量审计        }      }    }    return mergeHookOutputs(outputs)  // 最严格者胜合并（第六节）；空列表返回中性结果 decision:'none'

  ctx.on('agent/pre-step', async ({ agent, messages, turn, signal }, next): Promise<PreStepDecision> => {    if (messages.length === 0) return next()  // 没有消息就不触发 UserPromptSubmit——空 prompt 不是 hook 的管辖范围    const content = messages.flatMap(message => message.content)  // 拍平所有消息的内容块，提取文本进 payload    const merged = await runPoint('UserPromptSubmit', '', promptPayload(ctx, agent, content), { agent, turn, signal })  // CC 对 UserPromptSubmit 忽略 matcher（matchQuery=''）    if (merged.decision === 'deny') {      return { kind: 'reject' }  // deny ⇒ 拒绝本步——prompt 被 hook 否决，模型看不到它    }    const downstream = await next()  // 关键：先委托下游监听器——它们仍可能改写或拒绝；hook 的上下文不是否决权    const ours = contextFrom(merged)  // additionalContext → UserMessage（source: plugin/hooks-claude-code）    if (!ours || downstream.kind !== 'enter') return downstream  // 没有上下文、或下游决定不是 enter，都原样透传    return { kind: 'enter', messages: [...downstream.messages, ours] }  // 把 hook 上下文追加到下游消息列表——顺序在下游改写之后，保证基于最终 prompt 注入  })  ctx.on('tools/pre-execute', async (exec, next): Promise<PreToolDecision> => {    const turn = lastTurn(exec.agent)  // 从会话日志找最后一个 turn/start——审计事件要落在正确的 open turn 里    const merged = await runPoint('PreToolUse', exec.name, preToolPayload(ctx, exec), { ...exec.agent ? { agent: exec.agent } : {}, turn, signal: exec.signal })  // matchQuery=工具名：matcher 按工具过滤（Bash|Edit / ^git.* 等）    if (merged.decision === 'deny') return { kind: 'deny', reason: merged.reason ?? 'blocked by PreToolUse hook' }  // deny ⇒ 拒绝执行，reason 给模型看；无 reason 时兜底文案    if (merged.decision === 'ask') return { kind: 'ask', ...merged.reason !== undefined ? { reason: merged.reason } : {} }  // ask ⇒ 转人工确认——CC 桥独有的第二通道（Codex 桥没有这行）    return next()  // allow/none ⇒ 放行，交给下游监听器继续决策链  })

  ctx.on('agent/turn-stopping', async ({ agent, turn, signal }): Promise<void> => {    const merged = await runPoint('Stop', '', stopPayload(ctx, agent), { agent, turn, signal })  // Stop hook：在"即将收尾"的边界上触发，payload 带 stop_hook_active:false（循环守卫位）    if (merged.decision === 'deny') {      const text = merged.reason ?? 'continue: blocked by Stop hook'  // deny ⇒ 不许停；无 reason 时给一条通用 steering 文案      agent.steer(createUserMessage({ content: [{ type: 'text', text }], source: PLUGIN_SOURCE }))  // steer()：注入一条待处理输入——机器观察到 pending input 就会再跑一步，实现"强制继续"    }  })  ctx.on('subagent/start', (info) => {    const child = ctx.get('agents')?.get(info.id)  // start 边是唯一保证能拿到注册表引用的时刻    if (child !== undefined) subagentChildren.set(info.runId, child)  // 存下来——end 时 handle 可能已注销，stop hook 还要用它的 workspace    detached.track(runPoint('SubagentStart', SUBAGENT_TYPE, subagentPayload(ctx, 'SubagentStart', info, child), { ...child ? { agent: child } : {}, signal: detached.signal })      .then((merged) => {        const context = contextFrom(merged)  // SubagentStart 的 additionalContext → 注入子 agent        if (context && child) child.inject(context)  // inject：子 agent 收到一条 plugin-source 的用户消息      })      .catch((error: unknown) => { ctx.logger.warn(`hooks-claude-code: SubagentStart hook failed: ${String(error)}`) }))  // detached.track 吞掉 rejection 只是簿记，真正的 warn 在这里——不 catch 就静默失败  })  ctx.on('subagent/end', (info) => {    const child = subagentChildren.get(info.runId) ?? ctx.get('agents')?.get(info.id)  // 优先用 start 边保留的引用；拿不到再查注册表兜底    subagentChildren.delete(info.runId)  // 用完即删——Map 不泄漏    detached.track(runPoint('SubagentStop', SUBAGENT_TYPE, subagentPayload(ctx, 'SubagentStop', info, child), { ...child ? { agent: child } : {}, signal: detached.signal }))  // SubagentStop 只观察（CC 语义），结果不进任何决策链  })

        const { output, durationMs } = await runHook(ctx.shell, hook, {          payload,  // Codex 方言 payload：snake_case + model + turn_id（见下文）          defaultTimeoutMs,          ...workdir !== undefined ? { cwd: workdir } : {},  // 同样跑在会话 workspace          signal: opts.signal,          trailingNewline: false,  // Codex stdin 帧不带尾换行——与 CC 桥的唯一字节级差异，由方言决定而不是共享库猜          expectedEventName: point,  // 串台守卫两桥一致        }, () => performance.now())        if (opts.plainStdoutAsContext === true && output.exitCode === 0          && output.additionalContext === undefined          && output.stdout.length > 0 && !output.stdout.startsWith('{')) {          output.additionalContext = output.stdout  // Codex 特例：SessionStart/UserPromptSubmit 的纯 stdout（非 JSON）直接当 additionalContext——CC 里这要靠 hookSpecificOutput 显式声明，Codex 是隐式约定        }        outputs.push(output)  // 累积后统一合并

  ctx.on('tools/pre-execute', async (exec, next): Promise<PreToolDecision> => {    const turn = lastTurn(exec.agent)  // 同 CC 桥：审计事件落在正确的 open turn    const merged = await runPoint('PreToolUse', exec.name, preToolPayload(ctx, exec, model), { ...exec.agent ? { agent: exec.agent } : {}, turn, signal: exec.signal })    if (merged.decision === 'deny') return { kind: 'deny', reason: merged.reason ?? 'blocked by PreToolUse hook' }  // Codex 只映射 deny——没有 ask 分支：Codex 参考协议里 pre-tool 只有 block/allow，ask 是 CC 独有语义    return next()  // allow 在 Codex 语义里就是"无意见"（默认放行），所以直接透传下游决策链  })  function preToolPayload(ctx: Context, exec: ToolExecution, model: string): Record<string, unknown> {    // tool_name 用真实工具名（与 matcher 主体一致）——硬编码常量会让配置里的工具 matcher 永远不命中；tool_input 保持 Codex 的 { command } 形状    return { ...turnBase(ctx, exec.agent, 'PreToolUse', model), tool_name: exec.name, tool_input: { command: commandOf(exec.arguments) }, tool_use_id: exec.callId }  // turnBase = base + turn_id；commandOf 从工具参数里抽 command 字段，没有就空串  }

PreToolUse hook 全链路（以 CC 桥为例）

▼

▼

▼

▼

▼

▼

▼

🔹 Codex 桥差异：② 纯正则、④ 无尾换行/无 env、⑦ 只映射 deny（ask 通道不存在）