使用 mod 回應事件

on('tool.call', async ($, e, next) => {
  // 在工具執行之前執行
  $.ui.log('Claude is about to use ' + e.tool)
  // 將事件原封不動地傳遞
  return next(e)
})

on('tool.call', async ($, e, next) => {
  // 讓工具執行，並等待其結果
  const result = await next(e)
  // 在工具執行後執行
  $.ui.log(e.tool + ' finished')
  // 將結果原封不動地傳回
  return result
})

on('prompt.submit', async ($, e, next) => {
  // 傳遞事件的副本，其文字已變更
  return next({ ...e, text: e.text.trim() })
})

on('tool.call', { tool: 'Bash' }, async () => {
  // 沒有呼叫 next，所以命令永遠不會執行
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

// 字串符合一個值：僅限 Bash 呼叫
on('tool.call', { tool: 'Bash' }, hook)
// 陣列符合其中任何值：Edit 呼叫和 Write 呼叫
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// 正規表達式按模式符合：一個 MCP 伺服器的每個工具
on('tool.call', { tool: /^mcp__github__/ }, hook)

// matcher 將 hook 限制為 Bash 呼叫，因此 e.command 是 shell 命令
on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // 傳回而不呼叫 next 會回答事件，所以命令永遠不會執行
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // 每個其他命令都會進行權限檢查，然後進行 Bash
  return next(e)
})

on('tool.call', { tool: ['Edit', 'Write'] }, async ($, e, next) => {
  // 等待權限檢查和工具，並保留它們產生的內容
  const result = await next(e)
  // 被拒絕的呼叫會以 { deny } 的形式返回，失敗的呼叫會設定 isError
  const changed = !result.deny && !result.isError
  if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude changed ' + e.file_path)
  // 按原樣傳回結果，以便 Claude 讀取工具傳回的內容
  return result
})

const RISKY = /\brm\s+-rf?\b|\bgit\s+reset\s+--hard\b|\bgit\s+push\b.*--force/

export function register(on) {
  on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
    // 讓每個其他命令通過而不提出問題
    if (!RISKY.test(e.command)) return next(e)
    // 從安全答案開始，因此沒有人回答的問題會拒絕命令
    let answer = 'Refuse'
    try {
      // 工具呼叫在此等待，直到使用者選擇兩個標籤之一
      answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
    } catch {
      // 使用者關閉了問題，或這是一個沒有人可以詢問的 claude -p 執行
    }
    if (answer !== 'Run it') {
      // 回答而不呼叫 next，所以命令不會執行
      return { deny: 'The user declined this command. Ask before trying a different approach.' }
    }
    return next(e)
  })
}

on('prompt.submit', async ($, e, next) => {
  // 將不提及提取要求的提示按原樣傳遞
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // 在 git 存放庫外，命令失敗，因此沒有分支可新增
  if (git.exitCode !== 0) return next(e)
  // 保留較早的 hook 新增的任何內容，並為 Claude 新增一行
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

// function* 使 hook 成為產生器，可以逐段傳遞回應
on('turn.step', async function* ($, e, next) {
  // 傳送請求，在每個片段到達時轉發它，並保留完成的結果
  const result = yield* next(e)
  // 跳過不報告令牌計數的結果
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // 傳回結果不變，以便回合照常繼續
  return result
})

on('classic.Stop', async ($, e, next) => {
  // e 具有設定檔中的 Stop hook 從 stdin 讀取的相同欄位
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // 傳遞事件，以便設定檔中的 Stop hook 仍然執行
  return next(e)
})

// on 傳回註冊，.catch 將處理程式附加到該 hook
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind 是 'throw' 或 'timeout'，說明 guard 如何失敗
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})