sillyspec 3.24.8 → 3.25.1

package/src/run/quick-audit.js

@@ -0,0 +1,102 @@
+/**
+ * run/quick-audit.js（W6 Step2 从 run.js 抽出）。
+ *
+ * quick 审计结论打印 + quick 多变更关联选择（自洽，不依赖 run.js 闭包）。
+ * 安全锚：run.js 始终 barrel，本模块函数 run.js import 回来；无 test 直接 import，无需 re-export。
+ *
+ * 路径修正（相对 src/run/）：
+ *   - resolveQuickLinkedChanges 的 quick-recommend.js 动态 import './quick-recommend.js' → '../quick-recommend.js'
+ *   - 原动态 import('child_process') 删除，改顶部静态 execSync
+ *   - parsePorcelainPath 从 ./shared.js 重 import；checkbox 顶部 import
+ */
+import { execSync } from 'node:child_process'
+import { checkbox } from '@inquirer/prompts'
+import { parsePorcelainPath } from './shared.js'
+
+/**
+ * 打印 quick 完成审计结论（按 review.status 输出 SAFE/WARNING/BLOCKED）。
+ */
+export function printQuickAuditReview(review) {
+  if (review.status === 'blocked') {
+    console.error(`\n🚫 quick 变更边界审计 — BLOCKED：`)
+    for (const r of review.reasons) {
+      console.error(`   - ${r}`)
+    }
+    console.error(`\n   quick 已停止：请恢复/拆分这些变更，或重新运行 quick 并显式声明范围。`)
+  } else if (review.status === 'warning') {
+    console.warn(`\n⚠️ quick 变更边界审计 — WARNING：`)
+    for (const r of review.reasons) {
+      console.warn(`   - ${r}`)
+    }
+  } else {
+    console.log(`\n✅ quick 变更边界审计 — SAFE (变更 ${review.changedFiles.length} 个文件)`)
+  }
+}
+
+/**
+ * quick 阶段多变更交互式选择关联变更。
+ * - 0 活跃变更 → []（仅记 QUICKLOG，不关联）
+ * - 1 活跃变更 → 默认关联它（保持现状友好，不弹交互）
+ * - ≥2 活跃变更 + 交互 → checkbox 多选（推荐项默认勾，空选 = 不关联）
+ * - ≥2 活跃变更 + 非交互 → []（不关联）+ 提示用 --change a,b
+ */
+export async function resolveQuickLinkedChanges({ pm, cwd, specDir, quickFiles, taskDescription, nonInteractive }) {
+  let activeChanges = []
+  try {
+    activeChanges = await pm.listChanges(cwd)
+  } catch {
+    activeChanges = []
+  }
+  if (activeChanges.length === 0) return []
+  if (activeChanges.length === 1) return [activeChanges[0]]
+
+  if (nonInteractive || !process.stdin.isTTY) {
+    console.log('💡 非交互环境，已默认不关联变更；如需关联请用 --change a,b')
+    return []
+  }
+
+  // 脏文件（推荐信号之一）
+  let baselineFiles = []
+  try {
+    const gs = execSync('git status --porcelain', { cwd, encoding: 'utf8', timeout: 10000 })
+    baselineFiles = gs.split('\n').filter(Boolean)
+      .map(l => parsePorcelainPath(l))
+      .filter(Boolean)
+      .filter(f => !f.startsWith('.sillyspec/'))
+  } catch {}
+
+  // 推荐打分（脏文件 + 任务描述双信号）
+  let recommendations = []
+  try {
+    // quick-recommend.js 在 src/，本模块在 src/run/ → 退一层（真环依赖，保留动态 import）
+    const { recommendChanges } = await import('../quick-recommend.js')
+    recommendations = recommendChanges({ activeChanges, specDir, baselineFiles, quickFiles, taskDescription })
+  } catch {
+    recommendations = activeChanges.map(name => ({ name, score: 0, reasons: [] }))
+  }
+  const scoreMap = new Map(recommendations.map(r => [r.name, r.score]))
+  const reasonMap = new Map(recommendations.map(r => [r.name, r.reasons]))
+  const recommendedSet = new Set(recommendations.filter(r => r.score > 0).map(r => r.name))
+
+  // 按推荐分降序展示
+  const ordered = [...activeChanges].sort((a, b) =>
+    (scoreMap.get(b) || 0) - (scoreMap.get(a) || 0) || a.localeCompare(b))
+
+  const choices = ordered.map(name => {
+    const reasons = reasonMap.get(name) || []
+    const isRec = recommendedSet.has(name)
+    return {
+      name: `${isRec ? '⭐ ' : '   '}${name}`,
+      value: name,
+      description: reasons.length > 0 ? reasons.join('；') : '无推荐信号',
+      checked: isRec,
+    }
+  })
+
+  console.log('🔗 检测到多个活跃变更，选择本次 quick 关联哪些（可多选；不勾选任何项 = 仅记 QUICKLOG，不关联变更）')
+  if (recommendedSet.size > 0) {
+    console.log('   ⭐ = 基于脏文件/任务描述推荐，已默认勾选')
+  }
+  const selected = await checkbox({ message: '关联变更（空格切换，回车确认）', choices })
+  return selected
+}

package/src/run/scan-profile.js

@@ -0,0 +1,238 @@
+/**
+ * run/scan-profile.js（W6 Step2 从 run.js 抽出）。
+ *
+ * scan profile 数据生成 + quick scan CLI preflight/postcheck（自洽，不依赖 run.js 闭包）。
+ * 安全锚：run.js 始终 barrel，本模块函数 run.js import 回来；无 test 直接 import，无需 re-export。
+ *
+ * 路径修正（相对 src/run/）：
+ *   - executeScanPostcheck 的 scan-postcheck.js 动态 import './scan-postcheck.js' → '../scan-postcheck.js'
+ *   - executeScanPostcheck 原冗余动态 import('fs'/'path'/'child_process') 删除，改顶部静态（execSync 实际未直接用，纯遗留）
+ */
+import { join, basename, extname } from 'node:path'
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'node:fs'
+import { safeGit } from './shared.js'
+
+/**
+ * 估算源码规模（文件数 + 字节数）—— 跨平台 Node 遍历，替代 Unix `find`（原生 Windows 无 find，
+ * 原 find 失效会让所有 Windows 项目永远 fallback 到 standard profile）。
+ * 扩展名与排除目录与原 find 命令逐字一致；maxFiles 封顶避免超大仓库遍历过久
+ * （超限时 fileCount 已远超 quick/standard 阈值，不影响 profile 判定）。
+ */
+export function estimateSourceSize(cwd, maxFiles = 5000) {
+  const sourceExts = new Set(['.js','.ts','.tsx','.py','.java','.go','.rs','.rb','.php','.c','.cpp','.h','.jsx','.vue','.svelte'])
+  const skipDirs = new Set(['node_modules','.git','dist','build','__pycache__','.sillyspec','.claude'])
+  let fileCount = 0
+  let sourceBytes = 0
+  const stack = [cwd]
+  while (stack.length) {
+    const dir = stack.pop()
+    let entries
+    try { entries = readdirSync(dir, { withFileTypes: true }) }
+    catch { continue }
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (!skipDirs.has(e.name)) stack.push(join(dir, e.name))
+      } else if (e.isFile() && sourceExts.has(extname(e.name))) {
+        fileCount++
+        try { sourceBytes += statSync(join(dir, e.name)).size } catch {}
+        if (fileCount >= maxFiles) return { fileCount, sourceBytes }
+      }
+    }
+  }
+  return { fileCount, sourceBytes }
+}
+
+/**
+ * 根据 project 规模计算 scan profile
+ * quick:   fileCount≤30 && sourceBytes≤80KB && projectCount≤3 → 3 步，0 子代理，5 份文档
+ * standard: fileCount≤200 && sourceBytes≤800KB → 压缩步骤，最多 1 子代理
+ * deep:    大项目或 --deep → 完整流程
+ */
+export function computeScanProfile(cwd, platformOpts) {
+  // --deep 标志强制 deep
+  const flags = process.argv.slice(2)
+  if (flags.includes('--deep')) {
+    return { mode: 'deep', reason: '用户指定 --deep', maxAgentCalls: 4, maxDocs: 99 }
+  }
+
+  const specDir = platformOpts?.specRoot || join(cwd, '.sillyspec')
+  const projectsDir = join(specDir, 'projects')
+  let projectCount = 1
+  try {
+    if (existsSync(projectsDir)) {
+      projectCount = readdirSync(projectsDir).filter(f => f.endsWith('.yaml')).length
+    }
+  } catch {}
+
+  // 快速估算源码规模（Node 遍历，跨平台；原 Unix find 在原生 Windows 上失效会永远 fallback standard）
+  let fileCount = 0
+  let sourceBytes = 0
+  try {
+    const est = estimateSourceSize(cwd)
+    fileCount = est.fileCount
+    sourceBytes = est.sourceBytes
+  } catch {
+    // 遍历异常时假设中等规模
+    return { mode: 'standard', reason: '无法估算项目规模', maxAgentCalls: 1, maxDocs: 8 }
+  }
+
+  if (fileCount <= 30 && sourceBytes <= 80_000 && projectCount <= 3) {
+    return { mode: 'quick', reason: `${fileCount} 源文件, ${Math.round(sourceBytes / 1024)}KB`, maxAgentCalls: 0, maxDocs: 5, _fileCount: fileCount, _sourceBytes: sourceBytes, _projectCount: projectCount }
+  }
+  if (fileCount <= 200 && sourceBytes <= 800_000) {
+    return { mode: 'standard', reason: `${fileCount} 源文件, ${Math.round(sourceBytes / 1024)}KB`, maxAgentCalls: 1, maxDocs: 8, _fileCount: fileCount, _sourceBytes: sourceBytes, _projectCount: projectCount }
+  }
+  return { mode: 'deep', reason: `${fileCount} 源文件, ${Math.round(sourceBytes / 1024)}KB`, maxAgentCalls: 4, maxDocs: 99, _fileCount: fileCount, _sourceBytes: sourceBytes, _projectCount: projectCount }
+}
+
+/**
+ * 根据 scanProfile 裁剪步骤
+ * quick:   3 步 — CLI preflight / AI generate / CLI postcheck
+ * standard: 跳过续扫检测(4), 跳过可选步骤(9)
+ */
+export function applyScanProfileSteps(stageData, profile, cwd, platformOpts) {
+  const steps = stageData.steps
+  const mode = profile.mode
+
+  if (mode === 'quick') {
+    const specBase = platformOpts?.specRoot || join(cwd, '.sillyspec')
+    const projectName = basename(cwd)
+    const docsRoot = join(specBase, 'docs', projectName)
+
+    // Step 1: CLI preflight（不调 AI，自动完成）
+    const step1 = {
+      name: '项目概览（自动探测）',
+      status: 'pending',
+      noAI: true,
+      _cliAction: 'scanPreflight',
+      prompt: '',
+      outputHint: 'preflight 结果',
+      optional: false
+    }
+    // Step 2: AI 生成核心文档（唯一 AI roundtrip）
+    const step2 = {
+      name: '生成核心文档',
+      status: 'pending',
+      prompt: `## Quick Scan — 核心文档生成
+
+项目规模较小（quick profile），请一次性生成所有核心文档。
+
+### 操作
+1. 读取项目结构和关键文件（package.json / pyproject.toml / README / 入口文件）
+2. 生成以下 4 份文档并写入 \`{DOCS_ROOT}/scan/\`：
+   - **PROJECT.md** — 项目简介、技术栈、模块划分
+   - **ARCHITECTURE.md** — 架构概览、模块关系、技术决策
+   - **CONVENTIONS.md** — 代码风格、框架隐形规则
+   - **STRUCTURE.md** — 目录树 + 模块说明
+3. 如发现子项目，注册到 \`{PROJECTS_ROOT}/\` 下
+
+每份文档头必须包含 frontmatter：\`author\` 和 \`created_at\`。
+
+### ⛔ 硬约束
+- **严禁使用子代理（Agent/Task 工具）。** 所有文档在一个 turn 内完成。
+- 不要搜索 .sillyspec/ .claude/ .git/ node_modules/ dist/ build/
+- --output 只需要列出生成的文件名，不要写长篇总结
+
+### 输出
+生成的文件列表`,
+      outputHint: '文件列表',
+      optional: false
+    }
+    // Step 3: CLI postcheck（不调 AI，自动完成）
+    const selfCheck = steps.find(s => s.name === '自检和提交') || {
+      name: '自检和提交', status: 'pending', prompt: '', outputHint: '结果', optional: false
+    }
+    const step3 = { ...selfCheck, status: 'pending', noAI: true, _cliAction: 'scanPostcheck', prompt: '' }
+    stageData.steps = [step1, step2, step3]
+    return
+  }
+
+  if (mode === 'standard') {
+    // 跳过 Step 4（断点续扫检测），跳过 Step 9（flows+glossary，可选）
+    const skipNames = ['断点续扫检测', '生成业务流程和术语表（可选）']
+    for (const step of stageData.steps) {
+      if (skipNames.includes(step.name) && step.status === 'pending') {
+        step.status = 'skipped'
+        step.skippedAt = new Date().toLocaleString('zh-CN', { hour12: false })
+      }
+    }
+  }
+}
+
+/**
+ * CLI-only: quick scan preflight
+ * 收集项目快照，打印 summary，不调 AI
+ */
+export async function executeScanPreflight(cwd, platformOpts, scanProfile) {
+  const specBase = platformOpts?.specRoot || join(cwd, '.sillyspec')
+  const projectName = basename(cwd)
+  console.log(`  📁 项目: ${projectName}`)
+  console.log(`  📊 Profile: ${scanProfile.mode} (${scanProfile.reason})`)
+  // 快速列出顶层结构（readdirSync 跨平台，避免 spawn shell + 5 个 grep 进程）
+  try {
+    const skip = new Set(['node_modules', '.git', '.sillyspec', '.claude'])
+    const dirNames = readdirSync(cwd, { withFileTypes: true })
+      .filter(d => d.isDirectory() && !skip.has(d.name) && !d.name.startsWith('.'))
+      .slice(0, 20)
+      .map(d => d.name)
+    if (dirNames.length) {
+      console.log(`  📂 目录: ${dirNames.join(', ')}`)
+    }
+  } catch {}
+  console.log(`  ✅ Preflight 完成，准备生成核心文档\n`)
+}
+
+/**
+ * CLI-only: quick scan postcheck
+ * 执行文件存在性 + manifest 检查，不调 AI
+ */
+export async function executeScanPostcheck(cwd, platformOpts, scanProfile) {
+  // scan-postcheck.js 在 src/，本模块在 src/run/ → 退一层（真环依赖，保留动态 import）
+  const { runScanPostCheck, printScanPostCheckResult } = await import('../scan-postcheck.js')
+  const specDir = platformOpts?.specRoot || null
+  const result = runScanPostCheck({
+    cwd,
+    specDir,
+    scanMeta: {
+      projectListParsed: true,
+      manifestWritten: undefined,
+    },
+  })
+  printScanPostCheckResult(result)
+  // 写 manifest（如果还没写）
+  if (platformOpts?.specRoot) {
+    try {
+      const manifestDir = platformOpts.specRoot
+      let sourceCommit = null
+      let sourceCommitError = null
+      try {
+        const gitResult = safeGit(cwd, ['rev-parse', 'HEAD'])
+        sourceCommit = gitResult.value
+        sourceCommitError = gitResult.error
+      } catch (e) {
+        sourceCommitError = e.message
+      }
+      mkdirSync(manifestDir, { recursive: true })
+      const manifest = {
+        scan_profile: {
+          mode: scanProfile.mode,
+          file_count: scanProfile._fileCount || 0,
+          source_bytes: scanProfile._sourceBytes || 0,
+          project_count: scanProfile._projectCount || 0,
+          reason: scanProfile.reason,
+        },
+        workspace_id: platformOpts.workspaceId || null,
+        scan_run_id: platformOpts.scanRunId || null,
+        source_commit: sourceCommit,
+        source_commit_error: sourceCommit === null ? (sourceCommitError || 'unknown') : undefined,
+        generated_at: new Date().toISOString(),
+        schema_version: 2,
+      }
+      const manifestPath = join(manifestDir, 'manifest.json')
+      writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n')
+      console.log(`  📄 manifest.json 已写入: ${manifestPath}`)
+    } catch (e) {
+      console.warn(`  ⚠️ manifest 写入失败: ${e.message}`)
+    }
+  }
+}