sillyspec 3.27.2 → 3.27.5

package/.claude/worktrees/sillyspec-data-model-research/src/git-helper.js

@@ -0,0 +1,150 @@
+/**
+ * 统一公共 git 调用入口（数组形式 execFileSync，不经 shell）。
+ *
+ * 背景：worktree 链路原用 `execSync(\`git ${args}\`)` 字符串拼接（经 shell），
+ * 文件名/路径/用户输入插值进 shell 存在空格拆词 + 命令注入面；
+ * run/shared.js 的 safeGit 已用 execFileSync 数组形式（注释明示避免拆词）。
+ * 本模块把 safeGit 收口为单一实现，并补抛错版 git / 静默版 gitQuiet，
+ * 供 worktree 链与 run 层共用，消除口径分裂。
+ *
+ * 三者统一带 `-c safe.directory=<cwd>` per-command（不污染全局 config）+ `-C cwd` 前缀；
+ * 默认 timeout 5000ms（opts.timeout 可覆盖），默认 trim（opts.trim:false 保留原样输出）。
+ * 数组形式天然规避 shell 拆词，路径含空格 / 元字符安全。
+ * safeGit 额外支持 opts.retryOnTimeout：ETIMEDOUT（机器忙瞬时抖动）时用 2× timeout 重试一次。
+ */
+import { execFileSync } from 'node:child_process'
+
+/**
+ * git C 风格引号路径解码：`\\` `\"` `\n` `\t` 与 `\NNN` 八进制**原始字节**。
+ * 八进制转义的字节需聚合后按 UTF-8 解码（quotepath 关闭前非 ASCII 整段转义、
+ * 关闭后控制字符路径仍会转义），逐字节单独 toString 会拆出 U+FFFD。
+ * @param {string} s 已去外层引号的内容
+ * @returns {string}
+ */
+export function unquoteGitPath(s) {
+  const parts = []
+  let out = ''
+  let bytes = []
+  const flushText = () => {
+    if (bytes.length) {
+      parts.push(Buffer.from(bytes).toString('utf8'))
+      bytes = []
+    }
+  }
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i]
+    if (ch !== '\\') {
+      out += ch
+      continue
+    }
+    const n = s[i + 1]
+    if (n === 'n' || n === 't' || n === '"' || n === '\\') {
+      flushText()
+      out += n === 'n' ? '\n' : n === 't' ? '\t' : n
+      i++
+      continue
+    }
+    const m = /^[0-7]{3}/.exec(s.slice(i + 1, i + 4))
+    if (m) {
+      if (out) {
+        parts.push(out)
+        out = ''
+      }
+      bytes.push(parseInt(m[0], 8))
+      i += 3
+      continue
+    }
+    out += ch // 未知转义保留原样
+  }
+  flushText()
+  if (out) parts.push(out)
+  return parts.join('')
+}
+
+/**
+ * 构造带统一 per-command 配置的 git 参数前缀。
+ * core.quotepath=false：非 ASCII 路径在 porcelain/diff 输出原始 UTF-8 而非 "\346\226\207" 八进制
+ * 转义（中文文件名经 parsePorcelainPath 的 \\(.) 解引会被拆成裸数字拼坏路径）。
+ */
+function buildFullArgs(cwd, args) {
+  return ['-c', `safe.directory=${cwd}`, '-c', 'core.quotepath=false', '-C', cwd, ...args]
+}
+
+// maxBuffer：execFileSync 默认 1MB，untracked 清单/大 diff 超限抛 ENOBUFS——
+// safeGit 吞成 null、调用方 `|| ''` 会把"输出很大"静默变成"输出为空"（补丁漏文件级联）。
+// 32MB 对齐 verify-postcheck 的 diff 读取口径。
+// 256MB（坑 apply-spawnsync-enobufs，2026-08-22 实证：大 diff binary patch 超 32MB 抛
+// ENOBUFS 只能 git merge 绕行）——上限只在真输出那么大时才占用
+const GIT_MAX_BUFFER = 256 * 1024 * 1024
+
+/**
+ * 安全执行 git：失败不抛，返回 { value, error } 结构。
+ * @param {string} cwd
+ * @param {string[]} args
+ * @param {{ trim?: boolean, timeout?: number, retryOnTimeout?: boolean }} [opts]
+ *   - trim:false 保留原样输出（git status --porcelain 首行前导空格
+ *     是状态码的一部分，trim 会削掉致 parsePorcelainPath 丢首字符，坑见 auditQuickCompletion 注释）
+ *   - timeout 默认 5000ms，长操作（大 diff / worktree list）可传更大值
+ *   - retryOnTimeout:true 时，ETIMEDOUT 用 2× timeout 重试一次（默认 false 向后兼容）。
+ *     机器忙时 git 子进程启动慢易瞬时超时；审计锚点 git 调用失败即 blocked 中断 quick，
+ *     重试一次能消化绝大多数瞬时抖动，免去用户手工重跑。权限 / 损坏等非超时错误不重试（救不回）。
+ * @returns {{ value: string|null, error: string|null }}
+ */
+export function safeGit(cwd, args, opts = {}) {
+  const { trim = true, timeout = 5000, retryOnTimeout = false } = opts
+  const fullArgs = buildFullArgs(cwd, args)
+  // 单次尝试：返回 { value, errorObj }（errorObj 为原始 Error 或 null），不在内部格式化 message。
+  // 格式化（取首行）推迟到最终返回，避免重试分支重复格式化，并保留原始 code 供重试判定。
+  const attempt = (t) => {
+    try {
+      let value = execFileSync('git', fullArgs, { encoding: 'utf8', timeout: t, maxBuffer: GIT_MAX_BUFFER, stdio: ['ignore', 'pipe', 'pipe'] })
+      if (trim) value = value.trim()
+      return { value, errorObj: null }
+    } catch (e) {
+      return { value: null, errorObj: e }
+    }
+  }
+  let { value, errorObj } = attempt(timeout)
+  if (errorObj && retryOnTimeout && errorObj.code === 'ETIMEDOUT') {
+    ({ value, errorObj } = attempt(timeout * 2))
+  }
+  return { value, error: errorObj ? errorObj.message.split('\n')[0] : null }
+}
+
+/**
+ * 抛错版 git：失败抛异常，成功返回 trim 后 string（对齐 worktree 本地 git() 语义）。
+ * 调用方自行 catch；不经 shell，参数以数组元素传递。
+ * @param {string} cwd
+ * @param {string[]} args
+ * @param {{ trim?: boolean, timeout?: number, encoding?: string }} [opts]
+ *   - encoding:'buffer' 返回原始 Buffer（git diff --binary 等**二进制输出**专用——
+ *     utf8 解码会破坏 NUL 字节使补丁不可应用；Buffer 输出跳过 trim）
+ * @returns {string|Buffer}
+ */
+export function git(cwd, args, opts = {}) {
+  const { trim = true, timeout = 5000, encoding = 'utf8' } = opts
+  const fullArgs = buildFullArgs(cwd, args)
+  const value = execFileSync('git', fullArgs, { encoding, timeout, maxBuffer: GIT_MAX_BUFFER, stdio: ['ignore', 'pipe', 'pipe'] })
+  if (Buffer.isBuffer(value)) return value
+  return trim ? value.trim() : value
+}
+
+/**
+ * 静默版 git：内部调 git，失败 catch 返回 null（对齐 worktree 本地 gitQuiet() 语义）。
+ * ENOBUFS（输出超 32MB）不是"无输出"，静默成 null 会让调用方把大输出误当空清单——
+ * 至少 stderr 留一行，不与正常空结果同语义。
+ * @param {string} cwd
+ * @param {string[]} args
+ * @param {{ trim?: boolean, timeout?: number }} [opts]
+ * @returns {string|null}
+ */
+export function gitQuiet(cwd, args, opts = {}) {
+  try {
+    return git(cwd, args, opts)
+  } catch (e) {
+    if (e && e.code === 'ENOBUFS') {
+      console.error(`[sillyspec] git 输出超过 32MB 上限被截断：git ${args.join(' ')}`)
+    }
+    return null
+  }
+}

package/.claude/worktrees/sillyspec-data-model-research/src/hooks/claude-pre-tool-use.cjs

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+/**
+ * Claude Code PreToolUse hook 入口
+ *
+ * 从 stdin 读取 JSON，调用 worktree-guard 判断是否拦截。
+ *
+ * Claude Code hooks.json 配置：
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       {
+ *         "matcher": "Edit|Write|MultiEdit|Bash",
+ *         "hooks": [
+ *           {
+ *             "type": "command",
+ *             "command": "node /path/to/sillyspec/src/hooks/claude-pre-tool-use.cjs"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * }
+ */
+
+'use strict'
+
+const path = require('path')
+const fs = require('fs')
+
+// 动态 import ESM 模块
+async function main() {
+  // Claude Code hook 通过 stdin 传入 JSON
+  let input = ''
+  try {
+    input = await readStdin()
+  } catch (e) {
+    // 无法读取 stdin → 放行（安全优先于阻断），但留痕——本 hook 是阶段门禁唯一执行点，
+    // 静默解除全部防护会让故障无从诊断
+    console.error(`[sillyspec-hook] stdin 读取失败（放行）: ${e.message}`)
+    process.exit(0)
+  }
+
+  let parsed
+  try {
+    parsed = JSON.parse(input)
+  } catch (e) {
+    console.error(`[sillyspec-hook] stdin JSON 解析失败（放行）: ${e.message}；input 长度 ${input.length}`)
+    process.exit(0)
+  }
+
+  // 解析 Claude Code hook 输入格式
+  // 格式：{ tool_name: string, tool_input: { ... } }
+  const toolName = parsed.tool_name || parsed.tool || ''
+  const toolInput = parsed.tool_input || {}
+
+  // 转换为 shouldBlock 的输入格式
+  const toolMap = {
+    'Write': 'Write',
+    'Edit': 'Edit',
+    'MultiEdit': 'MultiEdit',
+    'Bash': 'Bash',
+  }
+
+  const mappedTool = toolMap[toolName]
+  if (!mappedTool) {
+    // 不在拦截范围内的工具 → 放行
+    process.exit(0)
+  }
+
+  // 构造 opts
+  const opts = { tool: mappedTool }
+  if (mappedTool === 'Bash') {
+    opts.command = toolInput.command || ''
+  } else {
+    // Write/Edit/MultiEdit
+    const fp = toolInput.file_path || toolInput.filePath
+    if (fp) opts.filePath = fp
+    // MultiEdit 可能有多个文件
+    if (mappedTool === 'MultiEdit') {
+      const fps = toolInput.edits
+        ? toolInput.edits.map(e => e.file_path || e.filePath).filter(Boolean)
+        : []
+      if (fps.length > 0) opts.filePaths = fps
+    }
+  }
+
+  // 加载 worktree-guard（ESM）
+  let shouldBlock
+  try {
+    const mod = await import('./worktree-guard.js')
+    shouldBlock = mod.shouldBlock
+  } catch (e) {
+    // 模块加载失败 → 放行（不因为 hook 出错阻断工作流）
+    // eslint-disable-next-line no-console
+    console.error(`[sillyspec-hook] 模块加载失败: ${e.message}`)
+    process.exit(0)
+  }
+
+  const result = shouldBlock(opts)
+
+  if (result.blocked) {
+    // 输出错误信息（Claude Code 会显示给 agent）
+    // eslint-disable-next-line no-console
+    console.error(`[sillyspec] ❌ ${result.reason || 'blocked by worktree guard'}`)
+    process.exit(2) // exit code 2 = 阻止工具执行
+  }
+
+  // 放行
+  process.exit(0)
+}
+
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    process.stdin.setEncoding('utf8')
+    process.stdin.on('data', chunk => chunks.push(chunk))
+    process.stdin.on('end', () => resolve(chunks.join('')))
+    process.stdin.on('error', reject)
+    // 超时保护（3秒）
+    setTimeout(() => {
+      process.stdin.destroy()
+      resolve('')
+    }, 3000)
+  })
+}
+
+main().catch(e => {
+  console.error(`[sillyspec-hook] 未捕获异常（放行）: ${e && e.message}`)
+  process.exit(0)
+})