sillyspec 3.20.1 → 3.20.3

package/test/scan-postcheck.test.mjs

@@ -1,183 +0,0 @@
-/**
- * scan-postcheck.test.mjs — CLI 层 post-check 测试
- */
-
-import { join, resolve, dirname, basename } from 'path'
-import { existsSync, mkdirSync, writeFileSync, rmSync } from 'fs'
-import { fileURLToPath, pathToFileURL } from 'url'
-import { tmpdir } from 'os'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const root = resolve(__dirname, '..')
-
-const { runScanPostCheck } = await import(pathToFileURL(join(root, 'src', 'scan-postcheck.js')).href)
-
-let passed = 0, failed = 0
-
-function assert(cond, msg) {
-  if (cond) { console.log(`  ✅ PASS: ${msg}`); passed++ }
-  else { console.log(`  ❌ FAIL: ${msg}`); failed++ }
-}
-
-function setup(name) {
-  const cwd = join(tmpdir(), `pc-${name}`)
-  mkdirSync(cwd, { recursive: true })
-  return cwd
-}
-function specSetup(name) {
-  const d = join(tmpdir(), `pc-${name}-spec`)
-  mkdirSync(d, { recursive: true })
-  return d
-}
-function clean(...dirs) { for (const d of dirs) try { rmSync(d, { recursive: true, force: true }) } catch {} }
-
-const DOCS = ['ARCHITECTURE.md','CONVENTIONS.md','STRUCTURE.md','INTEGRATIONS.md','TESTING.md','CONCERNS.md','PROJECT.md']
-
-// 写入全部 7 份文档，项目名 = basename(cwd)
-function writeFull(cwd, specDir) {
-  const proj = basename(cwd)
-  for (const d of DOCS) {
-    const p = join(specDir, 'docs', proj, 'scan', d)
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, 'author: bot\ncreated_at: 2026-06-08 10:00:00\n# doc\n')
-  }
-  // knowledge 目录 + INDEX.md（scan 已产出知识）
-  mkdirSync(join(specDir, 'knowledge'), { recursive: true })
-  writeFileSync(join(specDir, 'knowledge', 'INDEX.md'), '# Knowledge Index\n')
-}
-
-// 写入前 N 份文档
-function writeN(cwd, specDir, n) {
-  const proj = basename(cwd)
-  for (let i = 0; i < n; i++) {
-    const p = join(specDir, 'docs', proj, 'scan', DOCS[i])
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, 'author: bot\ncreated_at: 2026-06-08 10:00:00\n# doc\n')
-  }
-}
-
-// ── 1: source_root 有文档 → failed ──
-console.log('\n=== Test 1: source_root 泄漏 → failed_post_check ===')
-{
-  const cwd = setup('t1'), spec = specSetup('t1')
-  const proj = basename(cwd)
-  mkdirSync(join(cwd, '.sillyspec/docs', proj, 'scan'), { recursive: true })
-  writeFileSync(join(cwd, '.sillyspec/docs', proj, 'scan', 'ARCHITECTURE.md'), '# leak')
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'failed_post_check', `状态: ${r.status}`)
-  assert(r.checks.some(c => c.name === 'source_root_docs_leak'), `source_root_docs_leak`)
-  clean(cwd, spec)
-}
-
-// ── 2: spec 无文档 → failed ──
-console.log('\n=== Test 2: spec 无文档 → failed_post_check ===')
-{
-  const cwd = setup('t2'), spec = specSetup('t2')
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'failed_post_check', `状态: ${r.status}`)
-  assert(r.checks.some(c => c.name === 'all_docs_missing'), `all_docs_missing`)
-  clean(cwd, spec)
-}
-
-// ── 3: 缺部分 required 文档 → failed ──
-console.log('\n=== Test 3: 部分缺失 → failed_post_check ===')
-{
-  const cwd = setup('t3'), spec = specSetup('t3')
-  writeN(cwd, spec, 6)
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'failed_post_check', `状态: ${r.status}`)
-  assert(r.checks.some(c => c.name === 'partial_docs_missing'), `partial_docs_missing`)
-  clean(cwd, spec)
-}
-
-// ── 4: local.yaml 命令不存在 → warnings ──
-console.log('\n=== Test 4: local.yaml 命令不存在 → completed_with_warnings ===')
-{
-  const cwd = setup('t4'), spec = specSetup('t4')
-  writeFull(cwd, spec)
-  writeFileSync(join(spec, 'local.yaml'),
-    'project:\n  type: nodejs\ncommands:\n  build: "npm run build"\n  test: "npm run test"\n  lint: "npm run lint"\n')
-  writeFileSync(join(cwd, 'package.json'), '{"name":"t4","scripts":{"start":"node server.js"}}')
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'completed_with_warnings', `状态: ${r.status}`)
-  assert(r.checks.some(c => c.name === 'local_config_invalid'), `local_config_invalid`)
-  clean(cwd, spec)
-}
-
-// ── 5-8: AI 输出错误标记 → warnings ──
-const errorCases = [
-  { id: 'e5', name: 'tool_use_error', output: 'tool_use_error: file not found' },
-  { id: 'e6', name: 'API Error 529', output: 'API Error 529 server overloaded' },
-  { id: 'e7', name: 'rate_limit', output: 'rate limit exhausted' },
-  { id: 'e8', name: 'fallback', output: 'fallback to default, skipped validation' },
-]
-for (const ec of errorCases) {
-  console.log(`\n=== Test: ${ec.name} → completed_with_warnings ===`)
-  const cwd = setup(ec.id), spec = specSetup(ec.id)
-  writeFull(cwd, spec)
-  const r = runScanPostCheck({ cwd, specDir: spec, outputText: ec.output })
-  assert(r.status === 'completed_with_warnings', `${ec.name}: 状态 ${r.status}`)
-  clean(cwd, spec)
-}
-
-// ── 9: 文档缺 header → warnings ──
-console.log('\n=== Test 9: 文档缺 header → completed_with_warnings ===')
-{
-  const cwd = setup('t9'), spec = specSetup('t9')
-  const proj = basename(cwd)
-  for (const d of DOCS) {
-    const p = join(spec, 'docs', proj, 'scan', d)
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, '# no header\n')
-  }
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'completed_with_warnings', `状态: ${r.status}`)
-  assert(r.checks.some(c => c.name === 'docs_missing_header'), `docs_missing_header`)
-  clean(cwd, spec)
-}
-
-// ── 10: 全部通过 → success ──
-console.log('\n=== Test 10: 全部通过 → success ===')
-{
-  const cwd = setup('t10'), spec = specSetup('t10')
-  writeFull(cwd, spec)
-  const r = runScanPostCheck({ cwd, specDir: spec, outputText: 'done' })
-  assert(r.status === 'success', `状态: ${r.status}`)
-  assert(r.checks.length === 0, `checks.length=0`)
-  clean(cwd, spec)
-}
-
-// ── 11: 非平台模式 ──
-console.log('\n=== Test 11: 非平台模式 ===')
-{
-  const cwd = setup('t11')
-  const proj = basename(cwd)
-  for (let i = 0; i < 5; i++) {
-    const p = join(cwd, '.sillyspec', 'docs', proj, 'scan', DOCS[i])
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, 'author: bot\ncreated_at: now\n# doc\n')
-  }
-  const r = runScanPostCheck({ cwd, specDir: null })
-  assert(r.status === 'completed_with_warnings', `非平台: ${r.status}`)
-  assert(!r.checks.some(c => c.name === 'source_root_docs_leak'), `无 source_root_leak`)
-  clean(cwd)
-}
-
-// ── 12: 多问题 failed 优先 ──
-console.log('\n=== Test 12: failed 优先 ===')
-{
-  const cwd = setup('t12'), spec = specSetup('t12')
-  const proj = basename(cwd)
-  mkdirSync(join(cwd, '.sillyspec/docs', proj, 'scan'), { recursive: true })
-  writeFileSync(join(cwd, '.sillyspec/docs', proj, 'scan', 'ARCHITECTURE.md'), '# leak')
-  writeN(cwd, spec, 3)
-  const r = runScanPostCheck({ cwd, specDir: spec })
-  assert(r.status === 'failed_post_check', `failed 优先: ${r.status}`)
-  clean(cwd, spec)
-}
-
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
-console.log(`${'='.repeat(50)}`)
-if (failed > 0) throw new Error(`${failed} test(s) failed`)

package/test/scan-workflow-anyfailed-block.test.mjs

@@ -1,52 +0,0 @@
-/**
- * task-07: run.js workflow post_check anyFailed 阻断
- *
- * 覆盖：
- * - AC: workflow post_check anyFailed 时返回 { stageCompleted:false, currentIdx, nextPendingIdx: currentIdx }
- *       （与 task-06 平台模式 scan-postcheck 失败分支 return 结构对齐）
- *
- * 用源码字符串匹配 + 行为模拟。
- */
-import { readFileSync } from 'fs'
-import { join, dirname } from 'path'
-import { fileURLToPath } from 'url'
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const runPath = join(__dirname, '..', 'src', 'run.js')
-const src = readFileSync(runPath, 'utf8')
-
-let passed = 0
-let failed = 0
-function assert (cond, msg) {
-  if (cond) { console.log(`✅ PASS: ${msg}`); passed++ }
-  else { console.error(`❌ FAIL: ${msg}`); failed++ }
-}
-
-console.log('=== workflow post_check anyFailed 阻断 ===')
-
-// 锚点：scan 深度扫描 workflow post_check 段
-const anchor = src.indexOf('if (anyFailed)')
-assert(anchor > 0, '找到 if (anyFailed) 锚点')
-
-// 取该 if 块前后 500 字符（向前找变量声明，向后找 return）
-const tail = src.slice(anchor, anchor + 500)
-
-// 必须有 return { stageCompleted: false ... }
-assert(/return\s*\{\s*stageCompleted:\s*false/.test(tail),
-  'anyFailed 分支含 return { stageCompleted: false }')
-
-// 必须有 nextPendingIdx: currentIdx
-assert(/nextPendingIdx:\s*currentIdx/.test(tail),
-  'anyFailed 分支返回 nextPendingIdx: currentIdx')
-
-// 必须有 currentIdx（保持当前 step 不推进）
-assert(/currentIdx/.test(tail), 'anyFailed 分支保留 currentIdx 字段')
-
-// 必须有 console.log 警告（保留用户可见提示）
-assert(/console\.log/.test(tail) && /存在检查失败项|重试提示/.test(src.slice(anchor - 200, anchor + 300)),
-  'anyFailed 分支保留 console.log 用户提示')
-
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
-console.log(`${'='.repeat(50)}`)
-if (failed > 0) process.exit(1)

package/test/spec-dir.test.mjs

@@ -1,206 +0,0 @@
-/**
- * --spec-dir 功能测试
- * 
- * 测试点：
- * 1. ProgressManager 外部 specDir 路径正确
- * 2. init 外部 specDir 不污染源码
- * 3. 默认模式不受影响
- * 4. 平台模式 prompt 注入（scan/brainstorm/plan/execute/verify/quick）
- * 5. 非 platform 模式占位符替换（无 undefined/null）
- * 6. --spec-dir 与 --spec-root 兼容
- * 7. progress 使用外部 specDir
- */
-
-import { join, resolve, basename, dirname } from 'path'
-import { existsSync, mkdirSync, writeFileSync, rmSync } from 'fs'
-import { fileURLToPath, pathToFileURL } from 'url'
-import { execSync } from 'child_process'
-import { tmpdir } from 'os'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const root = resolve(__dirname, '..')
-const binCLI = join(root, 'bin', 'sillyspec.js')
-
-function imp(path) {
-  return import(pathToFileURL(path).href)
-}
-
-let passed = 0
-let failed = 0
-
-function assert(condition, msg) {
-  if (condition) {
-    console.log(`  ✅ PASS: ${msg}`)
-    passed++
-  } else {
-    console.log(`  ❌ FAIL: ${msg}`)
-    failed++
-  }
-}
-
-function tmpDir(name) {
-  const dir = join(tmpdir(), `spec-dir-test-${name}-${Date.now()}`)
-  mkdirSync(dir, { recursive: true })
-  return dir
-}
-
-function cleanup(dir) {
-  try { rmSync(dir, { recursive: true, force: true }) } catch {}
-}
-
-function run(cmd) {
-  return execSync(cmd, { encoding: 'utf8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] })
-}
-
-// ── Test 1: ProgressManager 外部 specDir ──
-console.log('\n=== Test 1: ProgressManager 外部 specDir ===')
-{
-  const { ProgressManager } = await imp(join(root, 'src', 'progress.js'))
-  const tmp = tmpDir('pm')
-  const specDir = join(tmp, 'external-spec')
-  
-  const pm = new ProgressManager({ specDir })
-  assert(pm._getSpecDir(tmp) === specDir, `_getSpecDir 返回自定义路径`)
-  
-  // 无自定义 specDir 时，resolveSpecDir 会向上查找 .sillyspec 目录
-  // 在测试环境中可能命中上层已有的 .sillyspec，所以只检查返回值是否有效路径
-  const pm2 = new ProgressManager()
-  const resolved = pm2._getSpecDir(tmp)
-  assert(typeof resolved === 'string' && resolved.length > 0 && resolved.endsWith('.sillyspec'),
-    `_getSpecDir 无自定义时返回有效 .sillyspec 路径 (got: ${resolved})`)
-  
-  assert(pm._runtimePath(tmp) === join(specDir, '.runtime'), `_runtimePath 基于 specDir`)
-  assert(pm._changePath(tmp, 'c') === join(specDir, 'changes', 'c'), `_changePath 基于 specDir`)
-  
-  // 外部 specDir 时 _ensureGitignore 应跳过
-  const gitignoreResult = pm._ensureGitignore(tmp)
-  assert(gitignoreResult === undefined, `外部 specDir 时 _ensureGitignore 跳过`)
-  
-  cleanup(tmp)
-}
-
-// ── Test 2: init 外部 specDir 不污染源码 ──
-console.log('\n=== Test 2: init 外部 specDir 不污染源码 ===')
-{
-  const { cmdInit } = await imp(join(root, 'src', 'init.js'))
-  const projectDir = tmpDir('project')
-  const specDir = tmpDir('spec')
-  
-  await cmdInit(projectDir, { specDir })
-  
-  assert(!existsSync(join(projectDir, '.sillyspec')), '源码目录不含 .sillyspec')
-  assert(!existsSync(join(projectDir, '.gitignore')), '外部 specDir 时不创建 .gitignore')
-  assert(existsSync(join(specDir, 'projects')), `specDir/projects 存在`)
-  assert(existsSync(join(specDir, 'docs')), `specDir/docs 存在`)
-  assert(existsSync(join(specDir, '.runtime', 'sillyspec.db')), `specDir/.runtime/sillyspec.db 存在`)
-  assert(existsSync(join(specDir, 'workflows')), `specDir/workflows 存在`)
-  assert(existsSync(join(projectDir, '.claude')), `源码目录 .claude 存在（工具指令）`)
-  
-  cleanup(projectDir)
-  cleanup(specDir)
-}
-
-// ── Test 3: 默认模式不受影响 ──
-console.log('\n=== Test 3: 默认模式不受影响 ===')
-{
-  const { cmdInit } = await imp(join(root, 'src', 'init.js'))
-  const projectDir = tmpDir('default')
-  
-  await cmdInit(projectDir, {})
-  
-  assert(existsSync(join(projectDir, '.sillyspec')), '默认模式创建 .sillyspec 在项目内')
-  assert(existsSync(join(projectDir, '.sillyspec', '.runtime', 'sillyspec.db')), '默认模式 DB 在项目内')
-  assert(existsSync(join(projectDir, '.gitignore')), '默认模式创建 .gitignore')
-  
-  cleanup(projectDir)
-}
-
-// ── Test 4: 平台模式 prompt 注入（多 stage） ──
-console.log('\n=== Test 4: 平台模式 prompt 注入 ===')
-{
-  const projectDir = tmpDir('prompt-p')
-  const specDir = tmpDir('prompt-s')
-  
-  run(`node "${binCLI}" init "${projectDir}" --spec-dir "${specDir}"`)
-  
-  // execute 阶段会自动创建 worktree，在非 git 环境下会失败，跳过
-  const stages = ['scan', 'brainstorm', 'plan', 'verify', 'quick']
-  for (const stage of stages) {
-    const output = run(`node "${binCLI}" --dir "${projectDir}" --spec-dir "${specDir}" run ${stage} --skip-approval`)
-    assert(output.includes('平台模式'), `${stage}: 包含平台模式指令`)
-    assert(output.includes(`规范目录（specDir）: \`${specDir}\``), `${stage}: 包含正确的 specDir 路径`)
-  }
-  
-  // scan 额外检查
-  const scanOutput = run(`node "${binCLI}" --dir "${projectDir}" --spec-dir "${specDir}" run scan`)
-  assert(scanOutput.includes('严禁写入源码目录'), 'scan: 包含严禁写入源码目录')
-  assert(scanOutput.includes('Write 工具失败时，不允许'), 'scan: 包含 Write 工具规则')
-  assert(scanOutput.includes('变更目录'), 'scan: 包含变更目录')
-  
-  cleanup(projectDir)
-  cleanup(specDir)
-}
-
-// ── Test 5: 非 platform 模式占位符替换 ──
-console.log('\n=== Test 5: 非 platform 模式占位符替换 ===')
-{
-  const projectDir = tmpDir('noplatform')
-  
-  run(`node "${binCLI}" init "${projectDir}"`)
-  
-  const output = run(`node "${binCLI}" --dir "${projectDir}" run scan`)
-  
-  assert(!output.includes('平台模式 — 写入路径约束'), '非 platform 模式不含平台指令')
-  assert(!output.includes('{DOCS_ROOT}'), '{DOCS_ROOT} 被正确替换')
-  assert(!output.includes('undefined'), '输出不含 undefined 路径')
-  assert(!output.includes('null/.sillyspec'), '输出不含 null 路径')
-  
-  cleanup(projectDir)
-}
-
-// ── Test 6: --spec-root 兼容 ──
-console.log('\n=== Test 6: --spec-root 兼容 ===')
-{
-  const projectDir = tmpDir('compat-p')
-  const specDir = tmpDir('compat-s')
-  
-  run(`node "${binCLI}" init "${projectDir}" --spec-dir "${specDir}"`)
-  
-  const output = run(`node "${binCLI}" --dir "${projectDir}" run scan --spec-root "${specDir}"`)
-  assert(output.includes('平台模式'), '--spec-root 兼容：仍触发平台模式指令')
-  
-  cleanup(projectDir)
-  cleanup(specDir)
-}
-
-// ── Test 7: progress 使用外部 specDir ──
-console.log('\n=== Test 7: progress 使用外部 specDir ===')
-{
-  const { ProgressManager } = await imp(join(root, 'src', 'progress.js'))
-  const projectDir = tmpDir('progress-p')
-  const specDir = tmpDir('progress-s')
-  
-  const pm = new ProgressManager({ specDir })
-  await pm.init(projectDir)
-  
-  assert(existsSync(join(specDir, '.runtime', 'sillyspec.db')), 'DB 创建在外部 specDir')
-  assert(!existsSync(join(projectDir, '.sillyspec')), '源码目录不含 .sillyspec')
-  
-  await pm.initChange(projectDir, 'test-change')
-  assert(existsSync(join(specDir, 'changes', 'test-change')), 'changes 创建在外部 specDir')
-  
-  const progress = await pm.read(projectDir, 'test-change')
-  assert(progress !== null, '能从外部 specDir 读取 progress')
-  assert(progress.currentChange === 'test-change', `currentChange 正确`)
-  
-  cleanup(projectDir)
-  cleanup(specDir)
-}
-
-// ── 汇总 ──
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
-console.log(`${'='.repeat(50)}`)
-
-if (failed > 0) throw new Error(`${failed} test(s) failed`)

package/test/stage-contract-failed-post-check.test.mjs

@@ -1,102 +0,0 @@
-/**
- * task-07: checkTransition failed_post_check 门控
- *
- * 覆盖：
- * - AC-1: scan → brainstorm (failed_post_check) → allowed=false, reason 含"scan post-check 未通过"
- * - AC-2: scan → scan (重跑修复) → allowed=true
- * - AC-3: scan → doctor/status (辅助阶段) → allowed=true
- * - AC-4: 旧数据无 status 字段 → 行为同旧版（按 allowedFrom）
- * - AC-5: status='completed' 不被拦
- */
-import { checkTransition } from '../src/stage-contract.js'
-
-let passed = 0
-let failed = 0
-function assertEqual (actual, expected, msg) {
-  const ok = actual === expected
-  if (ok) { console.log(`✅ PASS: ${msg}`); passed++ }
-  else { console.error(`❌ FAIL: ${msg}\n   expected: ${JSON.stringify(expected)}\n   actual:   ${JSON.stringify(actual)}`); failed++ }
-}
-function assertMatch (actual, regex, msg) {
-  if (regex.test(actual)) { console.log(`✅ PASS: ${msg}`); passed++ }
-  else { console.error(`❌ FAIL: ${msg}\n   actual: ${JSON.stringify(actual)} 不匹配 ${regex}`); failed++ }
-}
-function assert (cond, msg) {
-  if (cond) { console.log(`✅ PASS: ${msg}`); passed++ }
-  else { console.error(`❌ FAIL: ${msg}`); failed++ }
-}
-
-console.log('=== AC-1: failed_post_check 状态下进 brainstorm/plan/execute 被拦 ===')
-
-// scan → brainstorm, failed_post_check
-{
-  const r = checkTransition('scan', 'brainstorm', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r.allowed, false, "scan→brainstorm failed_post_check: allowed=false")
-  assertMatch(r.reason || '', /scan post-check 未通过/, 'reason 含 "scan post-check 未通过"')
-  assertMatch(r.reason || '', /重跑\s*scan|重跑\s*scan/, 'reason 含 "重跑 scan" 提示')
-}
-
-// scan → plan / execute 同样被拦
-{
-  const r1 = checkTransition('scan', 'plan', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r1.allowed, false, "scan→plan failed_post_check: allowed=false")
-  const r2 = checkTransition('scan', 'execute', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r2.allowed, false, "scan→execute failed_post_check: allowed=false")
-}
-
-console.log('\n=== AC-2: 允许 scan → scan 重跑修复（fromStage===toStage） ===')
-{
-  const r = checkTransition('scan', 'scan', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r.allowed, true, "scan→scan failed_post_check: allowed=true（允许重跑修复）")
-}
-
-console.log('\n=== AC-3: failed_post_check 下辅助阶段（doctor/status）仍可执行 ===')
-{
-  const r1 = checkTransition('scan', 'doctor', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r1.allowed, true, "scan→doctor failed_post_check: allowed=true（辅助阶段）")
-  const r2 = checkTransition('scan', 'status', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r2.allowed, true, "scan→status failed_post_check: allowed=true（辅助阶段）")
-  const r3 = checkTransition('scan', 'quick', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r3.allowed, true, "scan→quick failed_post_check: allowed=true（辅助阶段）")
-  const r4 = checkTransition('scan', 'explore', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r4.allowed, true, "scan→explore failed_post_check: allowed=true（辅助阶段）")
-}
-
-console.log('\n=== AC-4: 旧数据兼容（无 options 或 status 缺失，行为同旧版） ===')
-{
-  // 无 options（旧调用）— scan→brainstorm 按 allowedFrom 规则允许（scan 是辅助阶段，可进主流程）
-  const r1 = checkTransition('scan', 'brainstorm')
-  assertEqual(r1.allowed, true, "scan→brainstorm 无 options: 行为同旧版（allowed=true）")
-
-  // options 提供 fromStageData 但 status 为 undefined
-  const r2 = checkTransition('scan', 'brainstorm', { fromStageData: { /* 无 status */ } })
-  assertEqual(r2.allowed, true, "scan→brainstorm status=undefined: 行为同旧版（allowed=true）")
-
-  // options 为空对象
-  const r3 = checkTransition('scan', 'brainstorm', {})
-  assertEqual(r3.allowed, true, "scan→brainstorm options={}: 行为同旧版（allowed=true）")
-}
-
-console.log('\n=== AC-5: status="completed" 不被门控拦截 ===')
-{
-  const r = checkTransition('scan', 'brainstorm', { fromStageData: { status: 'completed' } })
-  assertEqual(r.allowed, true, "scan→brainstorm status=completed: allowed=true")
-}
-
-console.log('\n=== AC-6: fromStage 非 scan 时门控不触发（门控只针对 scan 源） ===')
-{
-  const r = checkTransition('brainstorm', 'plan', { fromStageData: { status: 'failed_post_check' } })
-  assertEqual(r.allowed, true, "brainstorm→plan failed_post_check: 门控不触发（非 scan 源）")
-}
-
-console.log('\n=== 接口向后兼容：options 第 3 位可选 ===')
-{
-  // 仅 2 参调用（最常见旧用法）
-  const r = checkTransition('brainstorm', 'plan')
-  assert(r && typeof r.allowed === 'boolean', '2 参调用返回 { allowed: boolean }')
-}
-
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
-console.log(`${'='.repeat(50)}`)
-if (failed > 0) process.exit(1)