sillyspec 3.24.7 → 3.24.8

package/src/stages/doctor.js

@@ -77,19 +77,19 @@ subs.forEach(s => {
 
 ### 5. 配置文件检查
 \`\`\`bash
-# 检查 local.yaml 和 STACK.md
+# 检查 local.yaml 和 scan 总览文档
 for f in .sillyspec/projects/*.yaml; do
   [ -f "$f" ] || continue
   name=$(grep '^name:' "$f" | head -1 | sed 's/^name:[[:space:]]*//')
   p=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
   [ -z "$p" ] && continue
   local_yaml="$p/.sillyspec/local.yaml"
-  stack_md="$p/.sillyspec/STACK.md"
+  arch_md=".sillyspec/docs/$name/scan/ARCHITECTURE.md"
   [ -f "$local_yaml" ] && echo "✅ local.yaml ($name)" || echo "⚠️ local.yaml ($name) — 不存在"
   if [ -f "$local_yaml" ]; then
     grep -q 'test:' "$local_yaml" && echo "  ✅ test 命令已配置" || echo "  ⚠️ 缺少 test 命令"
   fi
-  [ -f "$stack_md" ] && echo "✅ STACK.md ($name)" || echo "⚠️ STACK.md ($name) — 不存在"
+  [ -f "$arch_md" ] && echo "✅ scan/ARCHITECTURE.md ($name)" || echo "⚠️ scan/ARCHITECTURE.md ($name) — 不存在（运行 sillyspec run scan）"
 done
 \`\`\`
 
@@ -167,7 +167,7 @@ echo "项目目录: $PROJECT_DIR"
 for f in pom.xml build.gradle package.json requirements.txt pyproject.toml go.mod Cargo.toml; do
   [ -f "$PROJECT_DIR/$f" ] && echo "检测到: $f"
 done
-[ -f "$PROJECT_DIR/.sillyspec/STACK.md" ] && cat "$PROJECT_DIR/.sillyspec/STACK.md" | head -30
+cat .sillyspec/docs/*/scan/ARCHITECTURE.md 2>/dev/null | head -30 || echo "（无 scan/ARCHITECTURE.md）"
 \`\`\`
 
 ### 2. 构建工具可用性
@@ -349,7 +349,7 @@ timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ D
 - CLI 未安装 → \`npm install -g sillyspec\`
 - 缺少 local.yaml → \`sillyspec init\` 重新生成，或手动创建
 - local.yaml 缺少 test 命令 → 补充对应命令
-- 缺少 STACK.md → \`sillyspec run scan\` 重新扫描
+- 缺少 scan 文档（ARCHITECTURE.md 等）→ \`sillyspec run scan\` 重新扫描
 - sillyspec.db 状态不一致 → \`sillyspec run <阶段> --reset\` 重置对应阶段
 - 孤儿目录 → 确认后 \`rm -rf .sillyspec/changes/<目录名>\`
 - Maven 私服不可达 → 检查 VPN、settings.xml 配置、私服状态

package/src/stages/execute.js

@@ -115,7 +115,7 @@ const fixedPrefix = [
 2. 读取 design.md（技术方案）
 3. 读取 CONVENTIONS.md、ARCHITECTURE.md
 4. 读取 local.yaml（构建命令）
-5. 加载 CODEBASE-OVERVIEW.md
+5. 加载项目总览 \`.sillyspec/docs/<project>/scan/PROJECT.md\`（如存在）
 
 ### 模块文档加载
 6. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）

package/src/stages/plan.js

@@ -87,12 +87,12 @@ const stepClassify = {
 
 ### 操作
 1. 运行 \`sillyspec progress show\`，确认 currentStage 为 "plan"
-2. 读取 CODEBASE-OVERVIEW.md + 各子项目上下文
+2. 读取项目总览 \`{SPEC_ROOT}/docs/<project>/scan/PROJECT.md\` + 各子项目上下文
 3. 读取 proposal.md、design.md、requirements.md、tasks.md
 4. 如果存在 decisions.md，必须读取并提取所有当前版本 D-xxx@vN 决策 ID
    - 如果发现 priority=P0/P1 且 status=unresolved/blocking 的决策，停止生成计划，要求先回到 brainstorm 的 Design Grill 修正
    - 如果发现 superseded 决策，只引用最新版本，不引用旧版本
-5. 读取 CONVENTIONS.md、ARCHITECTURE.md、STACK.md
+5. 读取 CONVENTIONS.md、ARCHITECTURE.md（技术栈含在 ARCHITECTURE.md）
 6. 读取 local.yaml 获取构建/测试命令
 7. 读取 \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`（不存在则跳过）
    - 根据 design.md 的文件变更清单匹配模块

package/src/stages/propose.js

@@ -27,7 +27,7 @@ export const definition = {
       prompt: `加载所有相关规范和代码库上下文。
 
 ### 操作
-1. 加载 CODEBASE-OVERVIEW.md 和子项目上下文
+1. 加载项目总览 \`.sillyspec/docs/<project>/scan/PROJECT.md\`（如存在）和子项目上下文
 2. 读取最新设计文档、需求文档、代码库约定
 3. 如果是子阶段变更，读取 MASTER.md 和前序阶段设计
 

package/src/stages/status.js

@@ -9,7 +9,7 @@ export const definition = {
       prompt: `收集项目基础信息。
 
 ### 操作
-1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
+1. \`cat .sillyspec/docs/*/scan/PROJECT.md 2>/dev/null | head -20 || echo "未初始化"\`
 2. 获取 project 名
 3. \`ls .sillyspec/docs/<project>/scan/ 2>/dev/null | head -10\`
 4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`

package/src/stages/verify.js

@@ -60,6 +60,8 @@ export const definition = {
 3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
 4. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、lint 命令等）
 5. 加载代码规范：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
+   - 测试现状：\`cat .sillyspec/docs/<project>/scan/TESTING.md 2>/dev/null\`（了解既有测试约定与覆盖范围，验收时对照）
+   - 技术债清单：\`cat .sillyspec/docs/<project>/scan/CONCERNS.md 2>/dev/null\`（🔴/🟡 区域；本次变更若触碰须在 verify-result.md 标注）
 6. 标注每个文件的存在/不存在状态
 
 ### Execute Evidence 传递检查