sillyspec 3.24.7 → 3.25.0

package/src/scan-postcheck.js

@@ -7,17 +7,9 @@
 
 import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync } from 'fs'
 import { join, basename } from 'path'
-import { SCAN_STATUS, CHECK_SEVERITY } from './constants.js'
+import { SCAN_STATUS, CHECK_SEVERITY, SCAN_REQUIRED_DOCS } from './constants.js'
 
-const REQUIRED_SCAN_DOCS = [
-  'ARCHITECTURE.md',
-  'CONVENTIONS.md',
-  'STRUCTURE.md',
-  'INTEGRATIONS.md',
-  'TESTING.md',
-  'CONCERNS.md',
-  'PROJECT.md',
-]
+const REQUIRED_SCAN_DOCS = SCAN_REQUIRED_DOCS
 
 /**
  * @param {object} opts

package/src/stage-contract.js

@@ -9,6 +9,7 @@ import { existsSync, readdirSync, readFileSync } from 'fs'
 import { join, basename } from 'path'
 import { execFileSync } from 'child_process'
 import { detectChangeRisk, checkIntegrationEvidence } from './change-risk-profile.js'
+import { SCAN_REQUIRED_DOCS, AUXILIARY_STAGES } from './constants.js'
 
 /**
  * 校验结果
@@ -215,15 +216,7 @@ function validateScanOutputs(cwd, changeName, context = {}) {
     ? join(specBase, 'docs', projectName, 'scan')
     : join(specBase, 'docs', 'scan')
 
-  const requiredDocs = [
-    'ARCHITECTURE.md',
-    'CONVENTIONS.md',
-    'STRUCTURE.md',
-    'INTEGRATIONS.md',
-    'TESTING.md',
-    'CONCERNS.md',
-    'PROJECT.md',
-  ]
+  const requiredDocs = SCAN_REQUIRED_DOCS
 
   const errors = []
   const warnings = []
@@ -698,10 +691,8 @@ function validateExecuteOutputs(cwd, changeName, context = {}) {
  */
 const mainFlowStages = ['brainstorm', 'plan', 'execute', 'verify']
 
-/**
- * 辅助阶段（可独立运行，无严格转换顺序）
- */
-const auxiliaryStages = ['scan', 'quick', 'explore', 'archive', 'status', 'doctor']
+// 辅助阶段（可独立运行，无严格转换顺序）定义在 constants.js 的 AUXILIARY_STAGES，
+// 与 stages/index.js 共用单一真相源，避免两处逐字重复分叉。
 
 /**
  * @type {Object<string, StageContract>}
@@ -812,7 +803,7 @@ export function checkTransition(fromStage, toStage, options = {}) {
   }
 
   // 辅助阶段随时可执行（archive 除外：从主流程进入 archive 需要校验）
-  if (auxiliaryStages.includes(toStage) && toStage !== 'archive') {
+  if (AUXILIARY_STAGES.includes(toStage) && toStage !== 'archive') {
     return { allowed: true }
   }
 
@@ -838,14 +829,14 @@ export function checkTransition(fromStage, toStage, options = {}) {
       return { allowed: true }
     }
     // 独立运行 archive（无前置）也允许
-    if (!fromStage || auxiliaryStages.includes(fromStage)) {
+    if (!fromStage || AUXILIARY_STAGES.includes(fromStage)) {
       return { allowed: true }
     }
     return { allowed: false, reason: 'archive 的前置阶段是 verify，不能从 ' + fromStage + ' 跳转' }
   }
 
   // 从辅助阶段进入主流程：允许
-  if (auxiliaryStages.includes(fromStage)) {
+  if (AUXILIARY_STAGES.includes(fromStage)) {
     return { allowed: true }
   }
 
@@ -899,4 +890,4 @@ export function runValidators(stageName, cwd, changeName, context = {}) {
 /**
  * 获取所有主流程阶段
  */
-export { mainFlowStages, auxiliaryStages }
+export { mainFlowStages, AUXILIARY_STAGES as auxiliaryStages }

package/src/stages/brainstorm-auto.js

@@ -25,7 +25,7 @@ export const definition = {
 3. **检查变更名称**：如果当前变更名是自动生成的（如 \`2026-06-02-new-change-a3f2b7c1\`），直接重命名为有意义名称，然后运行 \`sillyspec change-rename <旧名> <新名>\`
 
 ### 加载上下文
-4. 读取 CODEBASE-OVERVIEW.md + 共享规范 + 子项目上下文
+4. 读取项目总览 \`.sillyspec/docs/<project>/scan/PROJECT.md\`（如存在）+ 共享规范 + 子项目上下文
 5. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
 6. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`
 7. 棕地项目：读取 scan 下的 STRUCTURE.md、CONVENTIONS.md、ARCHITECTURE.md