sillyspec 3.31.0 → 3.32.0

package/src/decision-distill.js

@@ -195,20 +195,29 @@ export function parseModulePathsSubset(content) {
   let cur = null
   let key = null
   for (const line of content.replace(/\r\n/g, '\n').split('\n')) {
+    // 空行/注释行：保状态（列表块内允许空行与注释穿插）
+    if (line.trim() === '' || line.trim().startsWith('#')) continue
     const mm = line.match(/^  ([a-zA-Z0-9_-]+):$/)
     if (mm) { cur = mm[1]; modules[cur] = { paths: [] }; key = null; continue }
     if (!cur) continue
+    const item = line.match(/^      - (.+)$/)
+    if (item && key) { modules[cur][key].push(item[1].trim().replace(/^['"]|['"]$/g, '')); continue }
     const inline = line.match(/^    (paths|core_files): \[(.*)\]$/)
     if (inline) {
       modules[cur][inline[1]] = inline[2].split(',').map(s => s.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean)
       key = null; continue
     }
-    const block = line.match(/^    (paths|core_files):$/)
+    const block = line.match(/^    (paths|core_files):\s*$/)
     if (block) { key = block[1]; modules[cur][key] = modules[cur][key] || []; continue }
     const doc = line.match(/^    doc: (.+)$/)
     if (doc) { modules[cur].doc = doc[1].trim().replace(/^['"]|['"]$/g, ''); key = null; continue }
-    const item = line.match(/^      - (.+)$/)
-    if (item && key) modules[cur][key].push(item[1].trim().replace(/^['"]|['"]$/g, ''))
+    // 结构守卫（坑 module-map-list-leak，2026-10-06-wallclock-entry 实测发现）：list 收集只在
+    // 「6 缩进项行 / 空行 / 注释」上存活，其余任何行——字段头（字段名开放集不枚举）、顶层段
+    // （span_risk:/blast:）、异缩进项（2 缩进 "- prefixes:"）——终结收集。此前 paths: 块后的
+    // tags/aliases/entrypoints/depends_on 字段项与顶层 blast prefixes 全部漏进 paths（8 项目
+    // map 500 实声明 vs 1375 泄漏项；散文斜杠词 git/DB/JSON 前缀命中 tag 'git' 误路由触达域、
+    // bin 模块双重归属 src/db.js）。
+    key = null
   }
   return modules
 }
@@ -518,17 +527,17 @@ export function distillIntoKnowledge(changeDir, knowledgeRoot, headHash, moduleI
   const waitParts = []
   const distillable = []
   for (const e of selected) {
-    if (e.selected === 'rejected' && (!e.rejectReason || !e.revisitWhen)) {
-      const missing = []
-      if (!e.rejectReason) missing.push('否决理由')
-      if (!e.revisitWhen) missing.push('复潮条件')
-      waitParts.push(`${e.id} 缺${missing.join('、')}`)
-    } else {
-      distillable.push(e)
-    }
+    // 标题必填（2026-09-29-decision-route-vocab：裸号条目检索面不可见——路由词形派生与回显
+    // 排序都吃标题，缺标题=知识入库即隐身）；rejected 缺否决理由/复潮条件 → 不写盘（其余照常）
+    const missing = []
+    if (!e.title) missing.push('标题（## D-xxx@vN 后接短标题——检索词形来源，裸号条目入库即隐身）')
+    if (e.selected === 'rejected' && !e.rejectReason) missing.push('否决理由')
+    if (e.selected === 'rejected' && !e.revisitWhen) missing.push('复潮条件')
+    if (missing.length > 0) waitParts.push(`${e.id} 缺${missing.join('、')}`)
+    else distillable.push(e)
   }
   const needsWait = waitParts.length > 0
-    ? `${waitParts.join('；')}——rejected 条目必填，补齐后重跑提炼`
+    ? `${waitParts.join('；')}——条目必填字段缺失，补齐后重跑提炼`
     : null
   if (distillable.length === 0) return { written: [], skipped: null, needsWait }
 

package/src/design-facts.js

@@ -22,7 +22,7 @@
  *   decision_module_check_skipped（skipped 原因字符串，接线层包 code）。
  */
 import { existsSync, readFileSync, readdirSync } from 'node:fs'
-import { join } from 'node:path'
+import { join, relative } from 'node:path'
 import { parseDecisions } from './decision-distill.js'
 import { parseFileChangeListDetailed } from './change-list.js'
 import { parseDesignCoverageByRepo, parseRepoRegistry } from './stages/plan-postcheck.js'
@@ -295,7 +295,9 @@ export function generateDesignSkeleton({ changeName, decisionsText, author, now
   // P2-e provenance 戳（noai-ir-roadmap §5）：CLI 骨架出品的可审计标记——铁律 8 收窄为
   //「骨架优先，仅手写补文档才手填元数据」的依据（validateMetadata 未来可据此只认 CLI 戳）
   lines.push(`generated_by: sillyspec-design-init`)
-  lines.push('scale: large')
+  // scale 不预填（2026-09-29-brainstorm-exit-thin-default）：此前预填 large 是静默厚默认——
+  // 不主动改就是五阶段；现由 brainstorm Step 8 规模评估按复杂度/上下文轴落值，拿不准默认 small
+  lines.push('scale: ""  # TODO：Step 8 规模评估落值——单上下文可吞吐=small（flow start 收编）；需 Wave 编排/上下文分片/多阶段治理=large（run plan）；拿不准 small')
   lines.push('---')
   lines.push('')
   lines.push(`# 设计文档（Design）— ${change}`)
@@ -339,7 +341,8 @@ export function generateDesignSkeleton({ changeName, decisionsText, author, now
 
   lines.push('## 接口定义')
   lines.push('')
-  lines.push('<!-- TODO（代码类任务必填）：方法签名、数据结构 -->')
+  lines.push('<!-- TODO（代码类任务必填）：方法签名、数据结构。本变更无接口改动时，把下面这行声明粘贴到本节正文（探针矩阵认该声明行，同义式「无接口变更/不涉及接口/零端点」亦可；留在本注释内不生效——2026-10-06-verify-friction-fix）： -->')
+  lines.push('<!-- 本变更接口面：0 端点（无接口变更） -->')
   lines.push('')
 
   lines.push('## 生命周期契约表')
@@ -415,14 +418,47 @@ function stripPathPlaceholders(p) {
  * @param {{ changeDir: string, cwd: string }} opts
  * @returns {{ ok: boolean, errors: Array<{path, message}>, warnings: string[] }}
  */
+/**
+ * 相近既有路径建议（2026-10-07-flow-friction-batch3 task-02）：design 清单幻觉路径的
+ * basename did-you-mean。受控 BFS：跳过 node_modules/.git/dist/build/venv 类重目录与
+ * 隐藏目录，扫描量上限 8000 文件（超限即止——建议是锦上添花不是承诺）；只收 basename
+ * 全等命中，至多 3 条按路径长度升序（最短=最像根级缺前缀的正确答案）。纯读无副作用。
+ * @param {string} root 仓根（或跨仓根）
+ * @param {string} normalized 失效路径（已剥占位符）
+ * @returns {string[]} 仓根相对 posix 路径建议（≤3 条，零命中返回 []）
+ */
+function suggestClosePaths(root, normalized) {
+  const base = normalized.split('/').pop().toLowerCase()
+  if (!base || base.length < 3) return []
+  const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'out', 'venv', '.venv', '__pycache__', '.runtime', 'coverage', 'target', '.sillyspec'])
+  const hits = []
+  let scanned = 0
+  const queue = [root]
+  while (queue.length > 0 && hits.length < 3 && scanned < 8000) {
+    const dir = queue.shift()
+    let entries
+    try { entries = readdirSync(dir, { withFileTypes: true }) } catch { continue }
+    for (const e of entries) {
+      if (e.name.startsWith('.') || SKIP_DIRS.has(e.name)) continue
+      const abs = join(dir, e.name)
+      if (e.isDirectory()) { queue.push(abs); continue }
+      scanned++
+      if (e.name.toLowerCase() === base) {
+        hits.push(relative(root, abs).split('\\').join('/'))
+        if (hits.length >= 3) break
+      }
+    }
+  }
+  return hits.sort((a, b) => a.length - b.length)
+}
+
 export function validateDesignFileList({ changeDir, cwd } = {}) {
   const errors = []
   const warnings = []
   try {
     if (!changeDir || !cwd) {
       return { ok: true, errors, warnings: ['design 清单核验跳过：缺少 changeDir/cwd'] }
-    }
-    const designPath = join(changeDir, 'design.md')
+    }    const designPath = join(changeDir, 'design.md')
     if (!existsSync(designPath)) {
       return { ok: true, errors, warnings: ['design 清单核验跳过：design.md 不存在'] }
     }
@@ -440,9 +476,13 @@ export function validateDesignFileList({ changeDir, cwd } = {}) {
         const normalized = stripPathPlaceholders(rawPath)
         if (!normalized || normalized === '.') continue
         if (!existsSync(join(root, normalized))) {
+          // 相近路径指路（2026-10-07-flow-friction-batch3 task-02）：幻觉路径多为缺目录前缀
+          // （如漏 backend/）或近似书写——basename did-you-mean 把「三轮试错」压成「一眼改对」；
+          // 无相近命中不附建议段（不加噪）
+          const close = suggestClosePaths(root, normalized)
           errors.push({
             path: rawPath,
-            message: `design_file_ref_invalid：文件变更清单条目「${rawPath}」在${repoLabel}（${root}）下不存在且无 NEW: 前缀（幻觉路径/书写错误）——修正路径，或计划新建的文件改为 NEW:${rawPath} 前缀`,
+            message: `design_file_ref_invalid：文件变更清单条目「${rawPath}」在${repoLabel}（${root}）下不存在且无 NEW: 前缀（幻觉路径/书写错误）——修正路径，或计划新建的文件改为 NEW:${rawPath} 前缀${close.length > 0 ? `；相近既有路径：${close.join('、')}` : ''}`,
           })
         }
       }