sillyspec 3.26.14 → 3.27.1

package/src/commit-suggest.js

@@ -0,0 +1,202 @@
+/**
+ * commit-suggest.js — `sillyspec commit` 的语义收集 + commit message 建议生成
+ * （2026-08-21 agent-手工产出审计第二批 G1-G3）。
+ *
+ * commit skill 此前让 agent 手工收集语义：取 LAST_COMMIT_TIME、cat 多处 QUICKLOG、
+ * 扫变更目录、按时间戳过滤已勾 task、按路径模式识别来源阶段——进度库/quicklog/
+ * git 全在 CLI 手里，这是「CLI 有数据却让 agent 重新收集」的最典型案例。
+ *
+ * 本模块一条命令产出全部上下文 + conventional commits 建议 message + 可照抄的
+ * git commit 命令。**只建议不执行**（对齐 skill 绝对规则「不要自动提交」——确认权在人）。
+ *
+ * 语义来源（与 skill 手工流程同源）：
+ *   A. QUICKLOG：specBase/quicklog/QUICKLOG-<user>.md + changes/<change>/quicklog/ 下的归属条目，
+ *      条目时间 > 上次 commit 时间者（首次提交全收）
+ *   B. execute 已勾 task：活跃变更 tasks.md 的 [x] 行（tasks.md mtime > 上次 commit 才计入，
+ *      防旧变更全勾 task 永久污染建议）
+ *   C. 阶段产出：changed paths 按路径模式归 scan/brainstorm/plan/execute/archive/knowledge
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs'
+import { join } from 'path'
+import { gitQuiet } from './git-helper.js'
+import { resolveSpecDir } from './run/shared.js'
+
+function listActiveChanges(specBase) {
+  try {
+    return readdirSync(join(specBase, 'changes'), { withFileTypes: true })
+      .filter(e => e.isDirectory() && e.name !== 'archive')
+      .map(e => e.name)
+      .sort()
+  } catch {
+    return []
+  }
+}
+
+/**
+ * 解析 QUICKLOG 文件里的条目（## ql-xxx | time | title + 状态：行）
+ */
+function parseQuicklogEntries(file) {
+  let content
+  try {
+    content = readFileSync(file, 'utf8')
+  } catch {
+    return []
+  }
+  const entries = []
+  const lines = content.split('\n')
+  let cur = null
+  for (const line of lines) {
+    const h = line.match(/^## (ql-\S+) \| ([0-9: -]+?) \| (.*)$/)
+    if (h) {
+      if (cur) entries.push(cur)
+      cur = { qlId: h[1], time: h[2].trim(), title: h[3].trim(), status: '未知' }
+      continue
+    }
+    if (cur) {
+      const s = line.match(/^状态[：:]\s*(\S+)/)
+      if (s) cur.status = s[1]
+    }
+  }
+  if (cur) entries.push(cur)
+  return entries
+}
+
+function classifyStagePath(p) {
+  const posix = p.replace(/\\/g, '/')
+  if (/^\.sillyspec\/docs\/[^/]+\/scan\//.test(posix)) return 'scan'
+  if (/^\.sillyspec\/changes\/archive\//.test(posix)) return 'archive'
+  if (/^\.sillyspec\/changes\/[^/]+\/(proposal|design)\.md/.test(posix)) return 'brainstorm'
+  if (/^\.sillyspec\/changes\/[^/]+\/(tasks|plan)\.md/.test(posix)) return 'plan'
+  if (/^\.sillyspec\/knowledge\//.test(posix)) return 'knowledge'
+  return null
+}
+
+/**
+ * 收集提交上下文并生成建议 message。
+ * @param {{ cwd: string, specDir?: string|null }} opts
+ * @returns {{
+ *   lastCommitTime: string|null, hasChanges: boolean, changedCount: number, stat: string,
+ *   quickEntries: Array<{qlId,time,title,status,file}>, checkedTasks: Array<{change,item}>,
+ *   stageArtifacts: string[], suggestion: {type, subject, body}|null
+ * }}
+ */
+export function collectCommitContext({ cwd, specDir = null }) {
+  const specBase = resolveSpecDir(cwd, { specDir })
+  const lastCommitTime = gitQuiet(cwd, ['log', '-1', '--format=%ci'])
+  const lastCommitKey = lastCommitTime ? lastCommitTime.slice(0, 19) : null
+
+  // -uall：未跟踪目录不折叠（.sillyspec/ 整体未跟踪时默认 porcelain 只给一行 `?? .sillyspec/`，
+  // 路径模式分类会瞎；-uall 逐文件列出，scan/brainstorm/plan 分类才有输入）
+  const porcelain = gitQuiet(cwd, ['status', '--porcelain', '-uall']) || ''
+  const changedLines = porcelain.split('\n').filter(Boolean)
+  const changedPaths = changedLines.map(l => l.slice(3).trim()).filter(Boolean)
+  const untrackedCount = changedLines.filter(l => l.startsWith('??')).length
+  const stat = gitQuiet(cwd, ['diff', 'HEAD', '--stat']) || (changedPaths.length > 0 ? `（${changedPaths.length} 个文件待首提交）` : '')
+
+  // ── 来源 A：QUICKLOG（主 quicklog + 各活跃变更归属 quicklog）──
+  const quickFiles = []
+  try {
+    for (const f of readdirSync(join(specBase, 'quicklog'))) {
+      if (/^QUICKLOG.*\.md$/.test(f)) quickFiles.push(join(specBase, 'quicklog', f))
+    }
+  } catch {}
+  for (const c of listActiveChanges(specBase)) {
+    try {
+      for (const f of readdirSync(join(specBase, 'changes', c, 'quicklog'))) {
+        if (f.endsWith('.md')) quickFiles.push(join(specBase, 'changes', c, 'quicklog', f))
+      }
+    } catch {}
+  }
+  const quickEntries = quickFiles
+    .flatMap(file => parseQuicklogEntries(file).map(e => ({ ...e, file })))
+    .filter(e => !lastCommitKey || e.time > lastCommitKey)
+    .sort((a, b) => (a.time < b.time ? -1 : 1))
+  const doneQuick = quickEntries.filter(e => e.status === '已完成')
+
+  // ── 来源 B：活跃变更已勾 task（tasks.md mtime 晚于上次 commit 才计入）──
+  const lastCommitMs = lastCommitTime ? Date.parse(lastCommitTime) : null
+  const checkedTasks = []
+  for (const c of listActiveChanges(specBase)) {
+    const tasksPath = join(specBase, 'changes', c, 'tasks.md')
+    if (!existsSync(tasksPath)) continue
+    if (lastCommitMs !== null && !Number.isNaN(lastCommitMs)) {
+      try {
+        // epoch 对比（非字符串）：git %ci 带本地时区偏移，Date.parse 归一；字符串对比会因
+        // UTC/本地时差把刚改过的 tasks.md 误判为早于上次 commit 而漏收
+        if (statSync(tasksPath).mtime.getTime() <= lastCommitMs) continue
+      } catch { continue }
+    }
+    for (const line of readFileSync(tasksPath, 'utf8').split('\n')) {
+      const m = line.match(/^[-*]\s*\[[xX]\]\s*(task-\d+)\s*[:：]?\s*(.*)/)
+      if (m) checkedTasks.push({ change: c, item: `${m[1]}: ${m[2].trim()}` })
+    }
+  }
+
+  // ── 来源 C：阶段产出（changed paths 按模式归类去重）──
+  const stageSet = new Set()
+  for (const p of changedPaths) {
+    const stage = classifyStagePath(p)
+    if (stage) stageSet.add(stage)
+  }
+  const stageArtifacts = [...stageSet]
+
+  // ── 建议 message（对齐 commit skill 的 type 表）──
+  let suggestion = null
+  const bodyLines = []
+  const hasQuick = doneQuick.length > 0
+  const hasTasks = checkedTasks.length > 0
+  const hasStages = stageArtifacts.length > 0
+
+  if (hasQuick || hasTasks || hasStages) {
+    let type
+    let subject
+    if (hasTasks && !hasQuick) {
+      type = 'feat'
+      const byChange = new Map()
+      for (const t of checkedTasks) {
+        if (!byChange.has(t.change)) byChange.set(t.change, [])
+        byChange.get(t.change).push(t.item)
+      }
+      const [firstChange, items] = [...byChange][0]
+      subject = `feat: ${firstChange} 完成 task ×${items.length}`
+    } else if (hasQuick && !hasTasks) {
+      type = 'fix'
+      if (doneQuick.length === 1) {
+        subject = `fix: ${doneQuick[0].title}`
+      } else if (doneQuick.length === 2) {
+        subject = `fix: ${doneQuick[0].title}；${doneQuick[1].title}`
+      } else {
+        subject = `fix: quick 修复 ${doneQuick.length} 项`
+      }
+    } else if (hasTasks) {
+      type = 'feat'
+      subject = `feat: 变更交付 + quick 修复 ${doneQuick.length} 项`
+    } else {
+      type = 'fix'
+      subject = `fix: quick 修复 + 阶段产出`
+    }
+    if (doneQuick.length >= 2 || hasTasks || hasStages) {
+      for (const q of doneQuick) bodyLines.push(`- quick ${q.qlId}: ${q.title}`)
+    }
+    for (const t of checkedTasks) bodyLines.push(`- ${t.change} ${t.item}`)
+    for (const s of stageArtifacts) bodyLines.push(`- 阶段产出: ${s}`)
+    if (!hasStages && !hasTasks && doneQuick.length === 1) bodyLines.length = 0
+    suggestion = {
+      type,
+      subject: subject.length > 100 ? subject.slice(0, 100) + '…' : subject,
+      body: bodyLines.length > 0 ? bodyLines.join('\n') : '',
+    }
+  }
+
+  return {
+    lastCommitTime,
+    hasChanges: changedPaths.length > 0,
+    changedCount: changedPaths.length,
+    untrackedCount,
+    stat,
+    quickEntries,
+    checkedTasks,
+    stageArtifacts,
+    suggestion,
+  }
+}

package/src/config-cat.js

@@ -0,0 +1,88 @@
+/**
+ * config-cat.js — local.yaml 实际值读取的权威路径解析器（`sillyspec config cat` 数据源）。
+ *
+ * 背景（2026-08-21 root-local-yaml 治理）：`config schema` 只列键不含值，agent 拿实际配置
+ * 只能翻文件——worktree 内 `.sillyspec/` 是 checkout 副本，gitignored 的 local.yaml 不随
+ * checkout 出现，agent 找不到就漂去项目根乱找甚至乱建。cat 按「文件存在」解析真实路径，
+ * agent 不需要知道文件在哪。
+ *
+ * 候选链（首个「文件存在」者胜）：
+ * 1. specBase（--spec-dir / 平台 pointer / resolveSpecDir 祖先链首个 .sillyspec 目录）——
+ *    resolveSpecDir 按「目录存在」命中，worktree 内会停在副本目录，文件并不在那里；
+ * 2. cwd 祖先链逐级 <dir>/.sillyspec/local.yaml——worktree 副本无此文件会继续向上命中主仓
+ *    （sillyspec worktree 恒挂在 <主仓>/.sillyspec/.runtime/worktrees/ 下，祖先链必达）；
+ * 3. git common-dir 反推主仓根——用户手动 `git worktree add` 到任意位置时的兜底。
+ *
+ * 候选链不含项目根 <dir>/local.yaml——那里从来没有这个文件（hook 同步拦写）。
+ * 纯只读；平台 pointer 异常由调用方吞掉走祖先链（真实 reader 各自 fail-closed，cat 是
+ * 只读便利口，不必加重）。
+ */
+import { existsSync } from 'fs'
+import { join, resolve, dirname } from 'path'
+import { gitQuiet } from './git-helper.js'
+
+/**
+ * 解析真实 local.yaml 路径。
+ * @param {string} dir 起点目录（CLI --dir / cwd）
+ * @param {{ specBase?: string|null }} [opts] specBase = resolvePlatformSpecDir 预解析结果（可 null）
+ * @returns {{ exists: boolean, path: string|null, source: string|null, searched: string[] }}
+ *   searched 为候选链前几个路径（未命中时供人看「找过哪里」，最多 6 条）
+ */
+export function resolveLocalYaml(dir, opts = {}) {
+  const start = resolve(dir || process.cwd())
+  const seen = new Set()
+  const candidates = []
+  const push = (p, source) => {
+    const key = resolve(p)
+    if (seen.has(key)) return
+    seen.add(key)
+    candidates.push({ path: key, source })
+  }
+
+  if (opts.specBase) push(join(opts.specBase, 'local.yaml'), 'spec 根（--spec-dir/平台 pointer/最近 .sillyspec）')
+  for (let d = start; ; d = dirname(d)) {
+    push(join(d, '.sillyspec', 'local.yaml'), 'cwd 祖先链（worktree 内向上命中主仓）')
+    const parent = dirname(d)
+    if (parent === d) break
+  }
+  // git 兜底：linked worktree 内 --git-common-dir 指向主仓共享 .git，dirname 即主仓根
+  const commonDir = gitQuiet(start, ['rev-parse', '--git-common-dir'])
+  if (commonDir) {
+    const mainRoot = dirname(resolve(start, String(commonDir).trim()))
+    push(join(mainRoot, '.sillyspec', 'local.yaml'), 'git common-dir 反推主仓根')
+  }
+
+  const hit = candidates.find(c => existsSync(c.path))
+  return {
+    exists: !!hit,
+    path: hit ? hit.path : null,
+    source: hit ? hit.source : null,
+    searched: candidates.slice(0, 6).map(c => c.path),
+  }
+}
+
+/**
+ * 写侧目标解析（`sillyspec local register-repo` 用）：已存在 local.yaml → 就地更新该文件
+ * （含 worktree → 主仓解析）；全不存在 → 取 specBase（或 cwd 链）候选，但候选落在 worktree
+ * 副本下（<主仓>/.sillyspec/.runtime/worktrees/ 内）时重定向 git common-dir 主仓根——
+ * local.yaml 是 gitignored 不随 worktree checkout，写进副本目录是死配置。
+ *
+ * @param {string} dir 起点目录
+ * @param {{ specBase?: string|null }} [opts]
+ * @returns {{ path: string, existed: boolean }}
+ */
+export function resolveLocalYamlWriteTarget(dir, opts = {}) {
+  const r = resolveLocalYaml(dir, opts)
+  if (r.exists) return { path: r.path, existed: true }
+  const start = resolve(dir || process.cwd())
+  const preferred = opts.specBase ? join(opts.specBase, 'local.yaml') : join(start, '.sillyspec', 'local.yaml')
+  const posix = resolve(preferred).replace(/\\/g, '/')
+  if (posix.includes('/.sillyspec/.runtime/worktrees/')) {
+    const commonDir = gitQuiet(start, ['rev-parse', '--git-common-dir'])
+    if (commonDir) {
+      const mainRoot = dirname(resolve(start, String(commonDir).trim()))
+      return { path: join(mainRoot, '.sillyspec', 'local.yaml'), existed: false }
+    }
+  }
+  return { path: resolve(preferred), existed: false }
+}

package/src/db.js

@@ -105,13 +105,19 @@ export class DB {
       if (!existsSync(p)) return null;
       return statSync(p).size === 0 ? 'empty' : 'ok';
     };
-    // tryOpen: openDatabase(path) + prepare 探测双保险（防打开成功但内容非 SQLite）
+    // tryOpen: openDatabase(path) + prepare 探测双保险（防打开成功但内容非 SQLite）。
+    // 探测前先设 busy_timeout（2026-08-21 审查 BUG-7）：init() 的 applyPragmas 在 _openWithFallback
+    // 之后才跑，探测 SELECT 此前以 busy_timeout=0（SQLite 默认）执行——他者进程 CHECKPOINT 改写
+    // 主库时探测立即 SQLITE_BUSY，3 次重试总窗口仅 350ms，大 WAL 下 checkpoint 秒级 → 健康库
+    // 被误判"损坏"硬抛错。先设 busy_timeout 让探测自身等待锁，重试只剩消化瞬时抖动。
     const tryOpen = (p) => {
       let db;
       try { db = openDatabase(p); }
       catch { return null; }
-      try { db.prepare('SELECT count(*) FROM sqlite_master').get(); return db; }
-      catch { try { db.close(); } catch { /* 关闭失败忽略 */ } return null; }
+      try {
+        db.exec('PRAGMA busy_timeout = 5000');
+        db.prepare('SELECT count(*) FROM sqlite_master').get(); return db;
+      } catch { try { db.close(); } catch { /* 关闭失败忽略 */ } return null; }
     };
 
     // 1. 主库（0 字节=截断信号，必须走回退，故门禁要求 'ok' 有内容）
@@ -144,6 +150,11 @@ export class DB {
             : 'sillyspec.db 损坏';
         console.warn(`⚠️  ${reason}，已从 .bak 备份恢复。`);
         bakDb.close();
+        // 覆盖前救援快照（2026-08-21 审查 BUG-7）：主库有内容但打不开（"损坏"）时，其中可能
+        // 含比 .bak 更新的数据——静默覆盖即静默丢。best-effort 留一份 .corrupt-<ts> 副本供人工恢复。
+        if (primaryRaw === 'ok') {
+          try { copyFileSync(this.dbPath, `${this.dbPath}.corrupt-${Date.now()}`); } catch { /* 救援失败不阻断恢复 */ }
+        }
         // node:sqlite 绑定路径，无 _save：把 .bak 内容 copy 回主库，统一用 dbPath。
         // 体检 BUG-18：主库可能正被其他进程（daemon/另一 CLI）打开——Windows 覆盖他人
         // 打开的文件抛 EPERM/EBUSY，短暂退避重试（持有者通常是瞬时句柄），仍失败 fail-loud