sillyspec 3.20.2 → 3.20.4

package/test/platform-recovery-chain.test.mjs

@@ -1,179 +1,179 @@
-/**
- * 平台 scan 恢复链路测试
- *
- * 验证：
- * 1. 首次带 --spec-dir 跑 scan，pointer 文件被创建
- * 2. 后续 --done 不带参数能从 pointer 恢复平台参数
- * 3. scan 完成后 pointer 状态标记为 scan_completed
- * 4. pointer 异常残留能被检测
- *
- * 跑法: node test/platform-recovery-chain.test.mjs
- */
-
-import { join, basename } from 'path'
-import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'fs'
-import { execSync } from 'child_process'
-import { fileURLToPath } from 'url'
+/**
+ * 平台 scan 恢复链路测试
+ *
+ * 验证：
+ * 1. 首次带 --spec-dir 跑 scan，pointer 文件被创建
+ * 2. 后续 --done 不带参数能从 pointer 恢复平台参数
+ * 3. scan 完成后 pointer 状态标记为 scan_completed
+ * 4. pointer 异常残留能被检测
+ *
+ * 跑法: node test/platform-recovery-chain.test.mjs
+ */
+
+import { join, basename } from 'path'
+import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'fs'
+import { execSync } from 'child_process'
+import { fileURLToPath } from 'url'
 import { dirname } from 'path'
 import { randomUUID } from 'crypto'
 import { tmpdir } from 'os'
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const binCLI = join(__dirname, '..', 'src', 'index.js')
-const passed = []
-const failed = []
-
-function assert(label, condition, detail) {
-  if (condition) {
-    passed.push(label)
-    console.log(`  ✅ PASS: ${label}`)
-  } else {
-    failed.push({ label, detail })
-    console.log(`  ❌ FAIL: ${label}`)
-    if (detail) console.log(`     ${detail}`)
-  }
-}
-
-function cleanup(dir) {
-  try { rmSync(dir, { recursive: true, force: true }) } catch {}
-}
-
-function run(cmd, opts = {}) {
-  try {
-    return execSync(cmd, { encoding: 'utf8', timeout: 15_000, ...opts })
-  } catch (e) {
-    return e.stdout || e.message
-  }
-}
-
-// ── 测试 1：pointer 文件创建和内容 ──
-console.log('\n=== Test 1: pointer 文件创建 ===')
-{
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const binCLI = join(__dirname, '..', 'src', 'index.js')
+const passed = []
+const failed = []
+
+function assert(label, condition, detail) {
+  if (condition) {
+    passed.push(label)
+    console.log(`  ✅ PASS: ${label}`)
+  } else {
+    failed.push({ label, detail })
+    console.log(`  ❌ FAIL: ${label}`)
+    if (detail) console.log(`     ${detail}`)
+  }
+}
+
+function cleanup(dir) {
+  try { rmSync(dir, { recursive: true, force: true }) } catch {}
+}
+
+function run(cmd, opts = {}) {
+  try {
+    return execSync(cmd, { encoding: 'utf8', timeout: 15_000, ...opts })
+  } catch (e) {
+    return e.stdout || e.message
+  }
+}
+
+// ── 测试 1：pointer 文件创建和内容 ──
+console.log('\n=== Test 1: pointer 文件创建 ===')
+{
   const tmpCwd = join(tmpdir(), `recovery-test-${randomUUID().slice(0, 8)}`)
   const tmpSpec = join(tmpdir(), `recovery-test-spec-${randomUUID().slice(0, 8)}`)
   const tmpRuntime = join(tmpdir(), `recovery-test-rt-${randomUUID().slice(0, 8)}`)
-
-  try {
-    mkdirSync(tmpCwd, { recursive: true })
-    writeFileSync(join(tmpCwd, 'package.json'), '{}')
-
-    // init 项目（使用外部 specDir）
-    const initOut = run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
-    assert('init 成功', !initOut.includes('❌'))
-
-    // run scan 会触发参数持久化
-    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
-
-    const pointerPath = join(tmpCwd, '.sillyspec-platform.json')
-    assert('pointer 文件存在', existsSync(pointerPath))
-
-    const pointer = JSON.parse(readFileSync(pointerPath, 'utf8'))
-    assert('pointer 有 specRoot', !!pointer.specRoot)
-    assert('pointer 有 savedAt', !!pointer.savedAt)
-    assert('pointer specRoot 指向外部', pointer.specRoot === tmpSpec)
-
-    // pointer 不应包含 status（初始创建时）
-    assert('初始 pointer 无 status 字段', !('status' in pointer))
-  } finally {
-    cleanup(tmpCwd)
-    cleanup(tmpSpec)
-  }
-}
-
-// ── 测试 2：--done 不带参数能恢复 ──
-console.log('\n=== Test 2: --done 恢复平台参数 ===')
-{
+
+  try {
+    mkdirSync(tmpCwd, { recursive: true })
+    writeFileSync(join(tmpCwd, 'package.json'), '{}')
+
+    // init 项目（使用外部 specDir）
+    const initOut = run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
+    assert('init 成功', !initOut.includes('❌'))
+
+    // run scan 会触发参数持久化
+    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
+
+    const pointerPath = join(tmpCwd, '.sillyspec-platform.json')
+    assert('pointer 文件存在', existsSync(pointerPath))
+
+    const pointer = JSON.parse(readFileSync(pointerPath, 'utf8'))
+    assert('pointer 有 specRoot', !!pointer.specRoot)
+    assert('pointer 有 savedAt', !!pointer.savedAt)
+    assert('pointer specRoot 指向外部', pointer.specRoot === tmpSpec)
+
+    // pointer 不应包含 status（初始创建时）
+    assert('初始 pointer 无 status 字段', !('status' in pointer))
+  } finally {
+    cleanup(tmpCwd)
+    cleanup(tmpSpec)
+  }
+}
+
+// ── 测试 2：--done 不带参数能恢复 ──
+console.log('\n=== Test 2: --done 恢复平台参数 ===')
+{
   const tmpCwd = join(tmpdir(), `recovery-test2-${randomUUID().slice(0, 8)}`)
   const tmpSpec = join(tmpdir(), `recovery-test2-spec-${randomUUID().slice(0, 8)}`)
   const tmpRuntime = join(tmpdir(), `recovery-test2-rt-${randomUUID().slice(0, 8)}`)
-  const scanRunId = `scan-${Date.now()}`
-
-  try {
-    mkdirSync(tmpCwd, { recursive: true })
-    writeFileSync(join(tmpCwd, 'package.json'), '{}')
-
-    // init + 触发 run 写入 pointer
-    run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
-    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
-
-    // 手动模拟一个"scan 第一步 --done"（不带 --spec-root）
-    // 关键验证：--done 时能从 pointer 恢复参数
-    const doneOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan --done --input "test" --output "test output" 2>&1`, { cwd: tmpCwd })
-
-    // --done 应该能找到平台参数，不应该报"需要 --spec-root"
-    assert('--done 恢复成功', !doneOut.includes('需要 --spec-root') && !doneOut.includes('缺少 specRoot'))
-  } finally {
-    cleanup(tmpCwd)
-    cleanup(tmpSpec)
-    cleanup(tmpRuntime)
-  }
-}
-
-// ── 测试 3：manifest 包含路径和 pointer 信息 ──
-console.log('\n=== Test 3: manifest 路径字段 ===')
-{
-  const { readFile } = await import('fs/promises')
-  const runSrc = await readFile(join(__dirname, '..', 'src', 'run.js'), 'utf8')
-
-  // manifest 初始化中包含三路径
-  assert('manifest 有 source_root: cwd', runSrc.includes('source_root: cwd'))
-  assert('manifest 有 spec_root', runSrc.includes('spec_root: platformOpts'))
-  assert('manifest 有 runtime_root', runSrc.includes('runtime_root: platformOpts'))
-  assert('manifest 有 platform_pointer_path', runSrc.includes('platform_pointer_path:'))
-  assert('manifest platform_pointer_status 使用枚举', runSrc.includes('POINTER_STATUS') || runSrc.includes('POINTER_STATUS.ACTIVE'))
-}
-
-// ── 测试 4：异常 pointer 检测 ──
-console.log('\n=== Test 4: 异常 pointer 残留检测 ===')
-{
+  const scanRunId = `scan-${Date.now()}`
+
+  try {
+    mkdirSync(tmpCwd, { recursive: true })
+    writeFileSync(join(tmpCwd, 'package.json'), '{}')
+
+    // init + 触发 run 写入 pointer
+    run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
+    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
+
+    // 手动模拟一个"scan 第一步 --done"（不带 --spec-root）
+    // 关键验证：--done 时能从 pointer 恢复参数
+    const doneOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan --done --input "test" --output "test output" 2>&1`, { cwd: tmpCwd })
+
+    // --done 应该能找到平台参数，不应该报"需要 --spec-root"
+    assert('--done 恢复成功', !doneOut.includes('需要 --spec-root') && !doneOut.includes('缺少 specRoot'))
+  } finally {
+    cleanup(tmpCwd)
+    cleanup(tmpSpec)
+    cleanup(tmpRuntime)
+  }
+}
+
+// ── 测试 3：manifest 包含路径和 pointer 信息 ──
+console.log('\n=== Test 3: manifest 路径字段 ===')
+{
+  const { readFile } = await import('fs/promises')
+  const runSrc = await readFile(join(__dirname, '..', 'src', 'run.js'), 'utf8')
+
+  // manifest 初始化中包含三路径
+  assert('manifest 有 source_root: cwd', runSrc.includes('source_root: cwd'))
+  assert('manifest 有 spec_root', runSrc.includes('spec_root: platformOpts'))
+  assert('manifest 有 runtime_root', runSrc.includes('runtime_root: platformOpts'))
+  assert('manifest 有 platform_pointer_path', runSrc.includes('platform_pointer_path:'))
+  assert('manifest platform_pointer_status 使用枚举', runSrc.includes('POINTER_STATUS') || runSrc.includes('POINTER_STATUS.ACTIVE'))
+}
+
+// ── 测试 4：异常 pointer 检测 ──
+console.log('\n=== Test 4: 异常 pointer 残留检测 ===')
+{
   const tmpCwd = join(tmpdir(), `recovery-test4-${randomUUID().slice(0, 8)}`)
   const tmpSpec = join(tmpdir(), `recovery-test4-spec-${randomUUID().slice(0, 8)}`)
-
-  try {
-    mkdirSync(tmpCwd, { recursive: true })
-    writeFileSync(join(tmpCwd, 'package.json'), '{}')
-
-    // init + 触发 run 写入 pointer
-    run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
-    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
-
-    const pointerPath = join(tmpCwd, '.sillyspec-platform.json')
-    assert('pointer 文件存在', existsSync(pointerPath))
-
-    // 模拟损坏的 pointer（缺少 specRoot）
-    writeFileSync(pointerPath, JSON.stringify({ workspaceId: 'fake', savedAt: new Date().toISOString() }))
-    const badOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan 2>&1`)
-    assert('损坏 pointer 报错', badOut.includes('缺少 specRoot') || badOut.includes('❌'))
-
-    // 模拟有效 pointer（手动修复）
-    writeFileSync(pointerPath, JSON.stringify({
-      specRoot: tmpSpec,
+
+  try {
+    mkdirSync(tmpCwd, { recursive: true })
+    writeFileSync(join(tmpCwd, 'package.json'), '{}')
+
+    // init + 触发 run 写入 pointer
+    run(`node "${binCLI}" init "${tmpCwd}" --spec-root "${tmpSpec}"`)
+    run(`node "${binCLI}" --dir "${tmpCwd}" run scan --spec-root "${tmpSpec}" 2>&1 || true`)
+
+    const pointerPath = join(tmpCwd, '.sillyspec-platform.json')
+    assert('pointer 文件存在', existsSync(pointerPath))
+
+    // 模拟损坏的 pointer（缺少 specRoot）
+    writeFileSync(pointerPath, JSON.stringify({ workspaceId: 'fake', savedAt: new Date().toISOString() }))
+    const badOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan 2>&1`)
+    assert('损坏 pointer 报错', badOut.includes('缺少 specRoot') || badOut.includes('❌'))
+
+    // 模拟有效 pointer（手动修复）
+    writeFileSync(pointerPath, JSON.stringify({
+      specRoot: tmpSpec,
       runtimeRoot: join(tmpdir(), 'fake-rt'),
-      workspaceId: 'test',
-      scanRunId: 'scan-test',
-      savedAt: new Date().toISOString(),
-    }))
-    // init 不应报错
-    const goodOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan --help 2>&1`)
-    assert('有效 pointer 不报错', !goodOut.includes('缺少 specRoot'))
-  } finally {
-    cleanup(tmpCwd)
-    cleanup(tmpSpec)
-  }
-}
-
-// ── 结果 ──
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed.length}  ❌ 失败: ${failed.length}`)
-console.log(`${'='.repeat(50)}`)
-
-if (failed.length > 0) {
-  console.log('\n失败详情:')
-  for (const f of failed) {
-    console.log(`  ❌ ${f.label}`)
-    if (f.detail) console.log(`     ${f.detail}`)
-  }
-  throw new Error('platform-recovery-chain test failed')
-} else {
-  console.log('\n🎉 平台恢复链路测试全部通过!')
-}
+      workspaceId: 'test',
+      scanRunId: 'scan-test',
+      savedAt: new Date().toISOString(),
+    }))
+    // init 不应报错
+    const goodOut = run(`node "${binCLI}" --dir "${tmpCwd}" run scan --help 2>&1`)
+    assert('有效 pointer 不报错', !goodOut.includes('缺少 specRoot'))
+  } finally {
+    cleanup(tmpCwd)
+    cleanup(tmpSpec)
+  }
+}
+
+// ── 结果 ──
+console.log(`\n${'='.repeat(50)}`)
+console.log(`✅ 通过: ${passed.length}  ❌ 失败: ${failed.length}`)
+console.log(`${'='.repeat(50)}`)
+
+if (failed.length > 0) {
+  console.log('\n失败详情:')
+  for (const f of failed) {
+    console.log(`  ❌ ${f.label}`)
+    if (f.detail) console.log(`     ${f.detail}`)
+  }
+  throw new Error('platform-recovery-chain test failed')
+} else {
+  console.log('\n🎉 平台恢复链路测试全部通过!')
+}

package/test/platform-recovery.test.mjs

@@ -1,25 +1,25 @@
-/**
- * platform-recovery.test.mjs — 平台模式参数恢复 + stage-contract 路径测试
- */
-
+/**
+ * platform-recovery.test.mjs — 平台模式参数恢复 + stage-contract 路径测试
+ */
+
 import { join, resolve, dirname, basename } from 'path'
 import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync } 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')
-
-let passed = 0, failed = 0
-
-function assert(cond, msg) {
-  if (cond) { console.log(`  ✅ PASS: ${msg}`); passed++ }
-  else { console.log(`  ❌ FAIL: ${msg}`); failed++ }
-}
-
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const root = resolve(__dirname, '..')
+const binCLI = join(root, 'bin', 'sillyspec.js')
+
+let passed = 0, failed = 0
+
+function assert(cond, msg) {
+  if (cond) { console.log(`  ✅ PASS: ${msg}`); passed++ }
+  else { console.log(`  ❌ FAIL: ${msg}`); failed++ }
+}
+
 const P = 'recover'
 function setup(name) {
   const d = join(tmpdir(), `${P}-${name}`)
@@ -39,129 +39,129 @@ function hasPathSegments(value, segments) {
   }
   return false
 }
-
-function run(cmd) {
-  return execSync(cmd, { encoding: 'utf8', timeout: 15000, stdio: ['pipe', 'pipe', 'pipe'] })
-}
-
-const DOCS = ['ARCHITECTURE.md','CONVENTIONS.md','STRUCTURE.md','INTEGRATIONS.md','TESTING.md','CONCERNS.md','PROJECT.md']
-function writeSpecDocs(dir) {
-  for (const d of DOCS) {
-    const p = join(dir, 'scan', d)
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, 'author: bot\ncreated_at: now\n# doc\n')
-  }
-}
-function writeLocalDocs(cwd) {
-  for (const d of DOCS) {
-    const p = join(cwd, '.sillyspec', 'docs', basename(cwd), 'scan', d)
-    mkdirSync(dirname(p), { recursive: true })
-    writeFileSync(p, 'author: bot\ncreated_at: now\n# doc\n')
-  }
-}
-
-// ── Test 1: platform-scan.json 写入位置 ──
-console.log('\n=== Test 1: platform-scan.json 写入位置 ===')
-{
-  const cwd = setup('t1'), sd = spec('t1')
-  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
-  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws1 --scan-run-id sr1`)
-
-  const inSpecDir = join(sd, '.runtime', 'platform-scan.json')
-  const pointerFile = join(cwd, '.sillyspec-platform.json')
-  assert(existsSync(inSpecDir), `platform-scan.json 在 specDir/.runtime/`)
-  assert(existsSync(pointerFile), `恢复指针在 cwd/.sillyspec-platform.json（不在 .sillyspec 内）`)
-
-  const content = JSON.parse(readFileSync(inSpecDir, 'utf8'))
-  assert(content.specRoot === sd, `specRoot 指向 specDir`)
-  assert(content.workspaceId === 'ws1', `workspaceId 保存正确`)
-  assert(content.scanRunId === 'sr1', `scanRunId 保存正确`)
-  // 关键：cwd/.sillyspec/ 不应被创建
-  assert(!existsSync(join(cwd, '.sillyspec')), `cwd/.sillyspec/ 未被创建（源码零污染）`)
-  clean(cwd, sd)
-}
-
-// ── Test 2: 残留清理：旧版本创建的 cwd/.sillyspec 会被自动删除 ──
-console.log('\n=== Test 2: 旧版本残留清理 ===')
-{
-  const cwd = setup('t2'), sd = spec('t2')
-  // 模拟旧版本创建的残留
-  mkdirSync(join(cwd, '.sillyspec', '.runtime'), { recursive: true })
-  writeFileSync(join(cwd, '.sillyspec', '.runtime', 'old.db'), 'x')
-  mkdirSync(join(cwd, '.sillyspec', 'changes'), { recursive: true })
-  assert(existsSync(join(cwd, '.sillyspec')), `残留存在`)
-  // init 时应清理
-  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
-  assert(!existsSync(join(cwd, '.sillyspec')), `init 清理了 cwd/.sillyspec/`)
-  // run 时也不应再创建
-  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws --scan-run-id sr 2>&1`)
-  assert(!existsSync(join(cwd, '.sillyspec')), `run 后 cwd/.sillyspec/ 仍不存在`)
-  clean(cwd, sd)
-}
-
-// ── Test 3: --done 不带 --spec-root 时恢复 ──
-console.log('\n=== Test 3: --done 恢复平台参数 ===')
-{
-  const cwd = setup('t2'), sd = spec('t2')
-  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
-  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws2 --scan-run-id sr2`)
-  // --done 不带任何平台参数
-  const output = run(`node "${binCLI}" --dir "${cwd}" run scan --done --change default --dir "${cwd}" --input "test" --output "test done" 2>&1`)
-  assert(output.includes('平台模式'), `恢复成功：包含平台模式指令`)
-  assert(output.includes(sd), `恢复成功：包含 specDir 路径`)
-  clean(cwd, sd)
-}
-
-// ── Test 3-6: stage-contract 路径（通过 runValidators） ──
-const { runValidators } = await import(pathToFileURL(join(root, 'src', 'stage-contract.js')).href)
-
-console.log('\n=== Test 5: specDir 有文档 → 校验通过 ===')
-{
-  const cwd = setup('t3'), sd = spec('t3')
-  const proj = basename(cwd)
-  const scanDir = join(sd, 'docs', proj)
-  writeSpecDocs(scanDir)
-  const result = runValidators('scan', cwd, 'default', { projectName: proj, specRoot: sd })
-  assert(result.ok, `specDir 有文档: ok=${result.ok}, errors=${JSON.stringify(result.errors)}`)
-  clean(cwd, sd)
-}
-
-console.log('\n=== Test 5: specDir 缺文档 → 校验失败，路径不含 .sillyspec ===')
-{
-  const cwd = setup('t4'), sd = spec('t4')
-  const proj = basename(cwd)
-  mkdirSync(join(sd, 'docs'), { recursive: true })
-  const result = runValidators('scan', cwd, 'default', { projectName: proj, specRoot: sd })
-  assert(!result.ok, `specDir 缺文档: ok=${result.ok}`)
+
+function run(cmd) {
+  return execSync(cmd, { encoding: 'utf8', timeout: 15000, stdio: ['pipe', 'pipe', 'pipe'] })
+}
+
+const DOCS = ['ARCHITECTURE.md','CONVENTIONS.md','STRUCTURE.md','INTEGRATIONS.md','TESTING.md','CONCERNS.md','PROJECT.md']
+function writeSpecDocs(dir) {
+  for (const d of DOCS) {
+    const p = join(dir, 'scan', d)
+    mkdirSync(dirname(p), { recursive: true })
+    writeFileSync(p, 'author: bot\ncreated_at: now\n# doc\n')
+  }
+}
+function writeLocalDocs(cwd) {
+  for (const d of DOCS) {
+    const p = join(cwd, '.sillyspec', 'docs', basename(cwd), 'scan', d)
+    mkdirSync(dirname(p), { recursive: true })
+    writeFileSync(p, 'author: bot\ncreated_at: now\n# doc\n')
+  }
+}
+
+// ── Test 1: platform-scan.json 写入位置 ──
+console.log('\n=== Test 1: platform-scan.json 写入位置 ===')
+{
+  const cwd = setup('t1'), sd = spec('t1')
+  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
+  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws1 --scan-run-id sr1`)
+
+  const inSpecDir = join(sd, '.runtime', 'platform-scan.json')
+  const pointerFile = join(cwd, '.sillyspec-platform.json')
+  assert(existsSync(inSpecDir), `platform-scan.json 在 specDir/.runtime/`)
+  assert(existsSync(pointerFile), `恢复指针在 cwd/.sillyspec-platform.json（不在 .sillyspec 内）`)
+
+  const content = JSON.parse(readFileSync(inSpecDir, 'utf8'))
+  assert(content.specRoot === sd, `specRoot 指向 specDir`)
+  assert(content.workspaceId === 'ws1', `workspaceId 保存正确`)
+  assert(content.scanRunId === 'sr1', `scanRunId 保存正确`)
+  // 关键：cwd/.sillyspec/ 不应被创建
+  assert(!existsSync(join(cwd, '.sillyspec')), `cwd/.sillyspec/ 未被创建（源码零污染）`)
+  clean(cwd, sd)
+}
+
+// ── Test 2: 残留清理：旧版本创建的 cwd/.sillyspec 会被自动删除 ──
+console.log('\n=== Test 2: 旧版本残留清理 ===')
+{
+  const cwd = setup('t2'), sd = spec('t2')
+  // 模拟旧版本创建的残留
+  mkdirSync(join(cwd, '.sillyspec', '.runtime'), { recursive: true })
+  writeFileSync(join(cwd, '.sillyspec', '.runtime', 'old.db'), 'x')
+  mkdirSync(join(cwd, '.sillyspec', 'changes'), { recursive: true })
+  assert(existsSync(join(cwd, '.sillyspec')), `残留存在`)
+  // init 时应清理
+  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
+  assert(!existsSync(join(cwd, '.sillyspec')), `init 清理了 cwd/.sillyspec/`)
+  // run 时也不应再创建
+  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws --scan-run-id sr 2>&1`)
+  assert(!existsSync(join(cwd, '.sillyspec')), `run 后 cwd/.sillyspec/ 仍不存在`)
+  clean(cwd, sd)
+}
+
+// ── Test 3: --done 不带 --spec-root 时恢复 ──
+console.log('\n=== Test 3: --done 恢复平台参数 ===')
+{
+  const cwd = setup('t2'), sd = spec('t2')
+  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
+  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws2 --scan-run-id sr2`)
+  // --done 不带任何平台参数
+  const output = run(`node "${binCLI}" --dir "${cwd}" run scan --done --change default --dir "${cwd}" --input "test" --output "test done" 2>&1`)
+  assert(output.includes('平台模式'), `恢复成功：包含平台模式指令`)
+  assert(output.includes(sd), `恢复成功：包含 specDir 路径`)
+  clean(cwd, sd)
+}
+
+// ── Test 3-6: stage-contract 路径（通过 runValidators） ──
+const { runValidators } = await import(pathToFileURL(join(root, 'src', 'stage-contract.js')).href)
+
+console.log('\n=== Test 5: specDir 有文档 → 校验通过 ===')
+{
+  const cwd = setup('t3'), sd = spec('t3')
+  const proj = basename(cwd)
+  const scanDir = join(sd, 'docs', proj)
+  writeSpecDocs(scanDir)
+  const result = runValidators('scan', cwd, 'default', { projectName: proj, specRoot: sd })
+  assert(result.ok, `specDir 有文档: ok=${result.ok}, errors=${JSON.stringify(result.errors)}`)
+  clean(cwd, sd)
+}
+
+console.log('\n=== Test 5: specDir 缺文档 → 校验失败，路径不含 .sillyspec ===')
+{
+  const cwd = setup('t4'), sd = spec('t4')
+  const proj = basename(cwd)
+  mkdirSync(join(sd, 'docs'), { recursive: true })
+  const result = runValidators('scan', cwd, 'default', { projectName: proj, specRoot: sd })
+  assert(!result.ok, `specDir 缺文档: ok=${result.ok}`)
   assert(result.errors.length > 0, `有 errors`)
   const errMsg = result.errors[0]
   assert(!hasPathSegments(errMsg, ['.sillyspec', 'docs']), `路径不含 .sillyspec: ${errMsg}`)
   assert(hasPathSegments(errMsg, ['docs', proj, 'scan']), `路径含 docs/${proj}/scan: ${errMsg}`)
-  clean(cwd, sd)
-}
-
-console.log('\n=== Test 7: 非平台模式有文档 → 校验通过 ===')
-{
-  const cwd = setup('t5')
-  const proj = basename(cwd)
-  writeLocalDocs(cwd)
-  const result = runValidators('scan', cwd, 'default', { projectName: proj })
-  assert(result.ok, `非平台有文档: ok=${result.ok}`)
-  clean(cwd)
-}
-
-console.log('\n=== Test 7: 非平台模式缺文档 → 路径含 .sillyspec ===')
-{
-  const cwd = setup('t6')
-  const proj = basename(cwd)
-  const result = runValidators('scan', cwd, 'default', { projectName: proj })
+  clean(cwd, sd)
+}
+
+console.log('\n=== Test 7: 非平台模式有文档 → 校验通过 ===')
+{
+  const cwd = setup('t5')
+  const proj = basename(cwd)
+  writeLocalDocs(cwd)
+  const result = runValidators('scan', cwd, 'default', { projectName: proj })
+  assert(result.ok, `非平台有文档: ok=${result.ok}`)
+  clean(cwd)
+}
+
+console.log('\n=== Test 7: 非平台模式缺文档 → 路径含 .sillyspec ===')
+{
+  const cwd = setup('t6')
+  const proj = basename(cwd)
+  const result = runValidators('scan', cwd, 'default', { projectName: proj })
   assert(!result.ok, `非平台缺文档: ok=${result.ok}`)
   const errMsg = result.errors[0]
   assert(hasPathSegments(errMsg, ['.sillyspec', 'docs']), `路径含 .sillyspec/docs: ${errMsg}`)
-  clean(cwd)
-}
-
-console.log(`\n${'='.repeat(50)}`)
-console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
-console.log(`${'='.repeat(50)}`)
-if (failed > 0) throw new Error(`${failed} test(s) failed`)
+  clean(cwd)
+}
+
+console.log(`\n${'='.repeat(50)}`)
+console.log(`✅ 通过: ${passed}  ❌ 失败: ${failed}`)
+console.log(`${'='.repeat(50)}`)
+if (failed > 0) throw new Error(`${failed} test(s) failed`)