sillyspec 3.32.10 → 3.33.1

package/src/decision-redomain.js

@@ -0,0 +1,148 @@
+/**
+ * decision-redomain.js — 决策条目跨域迁移（2026-10-15-decision-redomain）
+ *
+ * 背景：模块路径 glob 匹配失效（2026-10-15-module-path-glob-match）导致消费仓历史决策
+ * 大量落 decisions/unmapped.md（平台仓 442 条实证）——匹配器修复止增量后，存量需机器
+ * 通道清偿。redomain.js 只管 fr/ 条目；本模块为 decisions/ 面的孪生实现，复用
+ * decision-distill 参数化底座（splitKnowledgeSections/joinKnowledgeFile/syncIndexRoutingLines）。
+ *
+ * 与 FR 版的形态差异：
+ *   - 段头 `## D-xxx@vN 标题`（全局号/局部号双形态混存）——默认 sectionRegex 即此格式；
+ *     id = `<number>@v<version>`（迁域不换号，字段行内「原编号」等机器行随段整体搬）。
+ *   - 跨变更同号合法共存（D 号是变更内局部序号）——冲突键 = id + 变更（目标域已有
+ *     同 id 同变更段 = 迁移语义不明，跳该段并报告，不覆盖）。
+ *   - 路由行形态与 fr 不同（`- <域>|decision|决策 → [decisions/<域>.md]`）——syncIndexRoutingLines
+ *     默认参数即 decisions 面。
+ *
+ * 幂等：重跑同批——源域已无该段 → 0 条（或 anchor/byChange 无命中报错，与 FR 版同款）。
+ */
+import { existsSync, readFileSync, unlinkSync } from 'fs'
+import { join } from 'path'
+import { splitKnowledgeSections, joinKnowledgeFile, syncIndexRoutingLines } from './decision-distill.js'
+import { writeAtomicSync } from './fs-atomic.js'
+
+const DECISION_HEADER_RE = /^## (D-(?:[A-Za-z0-9_\-\u4e00-\u9fff]+-)?\d+)@v(\d+)\s*(.*)$/
+
+/** 目标域文件头（与 decision-distill 落域文件既有头逐字同款——平台真实库实测形态） */
+function newDomainPreamble(domain) {
+  return [
+    `# 决策知识 — ${domain}`,
+    '',
+    '> decision-distill 从变更 decisions.md 幂等提炼（「最近确认」= 归档时 HEAD）。条目字段行为 docs-check 机械解析契约，勿手改。',
+    '',
+  ]
+}
+
+/** 段 → {id, number, version, title, change}（id=number@version 即迁域不换号的身份） */
+function sectionMeta(s) {
+  const m = DECISION_HEADER_RE.exec(s.lines[0] || '')
+  if (!m) return null
+  const id = `${m[1]}@v${m[2]}`
+  const cm = s.lines.find((l) => /^变更[：:]/.test(l)) || s.lines.find((l) => /^来源[：:]/.test(l))
+  const change = cm ? cm.replace(/^(变更|来源)[：:]\s*/, '').trim() || null : null
+  return { id, number: m[1], version: parseInt(m[2], 10), title: (m[3] || '').trim(), change }
+}
+
+function normalizeDomainArg(v) {
+  return String(v ?? '').trim().replace(/^decisions\//i, '').replace(/\.md$/i, '').trim()
+}
+
+/** 干跑预览：列出将迁移条目，不落盘（anchor/byChange 同执行侧过滤） */
+export function planDecisionRedomain({ knowledgeRoot, from, to, anchors = null, byChange = null }) {
+  from = normalizeDomainArg(from)
+  to = normalizeDomainArg(to)
+  if (!from || !to) throw new Error('用法：--from <源域> --to <目标域>（域名可带 decisions/ 前缀与 .md 后缀）')
+  if (from === to) throw new Error('源域与目标域相同')
+  const dir = join(knowledgeRoot, 'decisions')
+  const fromPath = join(dir, `${from}.md`)
+  if (!existsSync(fromPath)) throw new Error(`源域文件不存在：decisions/${from}.md`)
+  const parsed = splitKnowledgeSections(readFileSync(fromPath, 'utf8'))
+  const anchorSet = Array.isArray(anchors) && anchors.length > 0 ? new Set(anchors) : null
+  const entries = []
+  for (const s of parsed.sections) {
+    const meta = sectionMeta(s)
+    if (!meta) continue
+    if (anchorSet && !anchorSet.has(meta.id)) continue
+    if (byChange && meta.change !== byChange) continue
+    entries.push(meta)
+  }
+  if (entries.length === 0) {
+    throw new Error(anchorSet
+      ? `anchor 未命中（${[...anchorSet].join('、')} 不在 decisions/${from}.md）`
+      : byChange ? `「变更：${byChange}」条目在 decisions/${from}.md 无命中` : `decisions/${from}.md 无决策条目段`)
+  }
+  return {
+    entries,
+    targetExists: existsSync(join(dir, `${to}.md`)),
+    sourceWillDelete: parsed.sections.length - entries.length === 0,
+  }
+}
+
+/** 执行迁移（纯文件手术——段字节整体搬运，id/机器行零改写） */
+export function redomainDecisionEntries({ knowledgeRoot, from, to, anchors = null, byChange = null }) {
+  from = normalizeDomainArg(from)
+  to = normalizeDomainArg(to)
+  if (!from || !to) throw new Error('用法：--from <源域> --to <目标域>')
+  if (from === to) throw new Error('源域与目标域相同')
+  const dir = join(knowledgeRoot, 'decisions')
+  const fromPath = join(dir, `${from}.md`)
+  const toPath = join(dir, `${to}.md`)
+  if (!existsSync(fromPath)) throw new Error(`源域文件不存在：decisions/${from}.md`)
+
+  const fromParsed = splitKnowledgeSections(readFileSync(fromPath, 'utf8'))
+  const anchorSet = Array.isArray(anchors) && anchors.length > 0 ? new Set(anchors) : null
+  const targetCreated = !existsSync(toPath)
+  const toParsed = targetCreated
+    ? { preamble: newDomainPreamble(to), sections: [] }
+    : splitKnowledgeSections(readFileSync(toPath, 'utf8'))
+
+  const moving = []
+  const staying = []
+  const skippedConflicts = []
+  const movedKeys = new Set() // 批内双键（id|change）：同批重复段第二条跳过（2026-10-15 平台存量实证幂等残留）
+  for (const s of fromParsed.sections) {
+    const meta = sectionMeta(s)
+    if (!meta) { staying.push(s); continue } // 非条目段（说明/杂项）留守
+    if (anchorSet && !anchorSet.has(meta.id)) { staying.push(s); continue }
+    if (byChange && meta.change !== byChange) { staying.push(s); continue }
+    // 冲突防线：目标域已有同 id + 同变更段（跨变更同号合法共存，双键才冲突）
+    const key = `${meta.id}|${meta.change || ''}`
+    const clash = movedKeys.has(key) || toParsed.sections.some((t) => {
+      const tm = sectionMeta(t)
+      return tm && `${tm.id}|${tm.change || ''}` === key
+    })
+    if (clash) { skippedConflicts.push(meta.id); staying.push(s); continue }
+    movedKeys.add(key)
+    moving.push({ meta, section: s })
+  }
+  if (moving.length === 0 && skippedConflicts.length === 0) {
+    throw new Error(anchorSet
+      ? `anchor 未命中（${[...anchorSet].join('、')} 不在 decisions/${from}.md）`
+      : byChange ? `「变更：${byChange}」条目在 decisions/${from}.md 无命中` : `decisions/${from}.md 无决策条目段`)
+  }
+  if (anchorSet && skippedConflicts.length + moving.length !== anchorSet.size) {
+    const got = new Set([...moving.map((m) => m.meta.id), ...skippedConflicts])
+    const miss = [...anchorSet].filter((a) => !got.has(a))
+    if (miss.length > 0) throw new Error(`anchor 未命中：${miss.join('、')}（不在 decisions/${from}.md）`)
+  }
+
+  toParsed.sections.push(...moving.map((m) => m.section))
+  writeAtomicSync(toPath, joinKnowledgeFile(toParsed.preamble, toParsed.sections))
+  const sourceDeleted = staying.length === 0
+  if (sourceDeleted) unlinkSync(fromPath)
+  else writeAtomicSync(fromPath, joinKnowledgeFile(fromParsed.preamble, staying))
+
+  // INDEX 路由行：decisions 面默认参数（幂等；缺席行补上）
+  const indexPath = join(knowledgeRoot, 'INDEX.md')
+  const before = existsSync(indexPath) ? readFileSync(indexPath, 'utf8') : ''
+  try { syncIndexRoutingLines(knowledgeRoot) } catch { /* INDEX 缺席/同步失败不拦迁移 */ }
+  const after = existsSync(indexPath) ? readFileSync(indexPath, 'utf8') : ''
+
+  return {
+    moved: moving.map((m) => ({ id: m.meta.id, title: m.meta.title })),
+    skippedConflicts,
+    sourceDeleted,
+    targetCreated,
+    indexLineAdded: after !== before,
+  }
+}

package/src/deleted-ledger.js

@@ -14,12 +14,13 @@
  * 坏行容错：单行 JSON 解析失败跳过该行（外部编辑/半写截断不拖垮读取）。
  */
 import { appendFileSync, existsSync, readFileSync } from 'node:fs'
+import { runtimeStatePath } from './runtime-paths.js'
 import { join } from 'node:path'
 
 const LEDGER_FILENAME = 'deleted-changes.jsonl'
 
 function ledgerPath(specDir) {
-  return join(specDir, '.runtime', LEDGER_FILENAME)
+  return runtimeStatePath(join(specDir, '.runtime'), LEDGER_FILENAME)
 }
 
 /**

package/src/design-facts.js

@@ -26,7 +26,7 @@ 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'
-import { parseModuleMapSimple } from './modules.js'
+import { modulePathMatches, parseModuleMapSimple } from './modules.js'
 
 // ---------------------------------------------------------------------------
 // 条目解析（distill parseDecisions 的同源镜像，R-01）
@@ -173,7 +173,7 @@ export function deriveActualModules(filePaths, prefixPairs) {
     const t = String(f || '').replace(/\\/g, '/').replace(/\/+$/, '')
     if (!t) continue
     for (const { id, path: p } of prefixPairs) {
-      if (t === p || t.startsWith(p + '/')) { actual.add(id); break }
+      if (modulePathMatches(t, p)) { actual.add(id); break }
     }
   }
   return actual
@@ -387,7 +387,7 @@ export function generateDesignSkeleton({ changeName, decisionsText, author, now
   lines.push('- [ ] frontmatter 字段齐全（author/created_at/scale）')
   lines.push('- [ ] 引用所有当前版本 D-xxx@vN')
   lines.push('- [ ] 涉及生命周期关键词时含「生命周期契约表」或紧邻豁免短语')
-  lines.push('- [ ] UI 原型分级核对（涉前端文件时变更目录应有 prototype-*.html——新生成（定稿＝与实现同方言的真码产物，手绘仅限粗选）或登记复用（复用须按 prototype-<名称>.html 命名，execute 才注入）或跳过原因记入风险登记）')
+  lines.push('- [ ] UI 原型分级核对（涉前端文件时变更目录应有 prototype-*.html——新生成（定稿＝与实现同方言的真码产物，手绘仅限粗选，输出须带素材来源声明：token 源/组件来源/入口位置）或登记复用（复用须按 prototype-<名称>.html 命名，execute 才注入）或跳过原因记入风险登记；本仓形态未在 local.yaml ui_prototype 登记的，收口前补登记）')
   lines.push('- [ ] 不确定的问题标注「⚠️ 自审存疑」')
   lines.push('')
 

package/src/docs-debt.js

@@ -13,7 +13,7 @@
 import { existsSync, readFileSync, readdirSync, realpathSync } from 'node:fs'
 import { join, relative } from 'node:path'
 import { safeGit } from './git-helper.js'
-import { parseModuleMapSimple } from './modules.js'
+import { modulePathMatches, parseModuleMapSimple } from './modules.js'
 import { runDocsCheck, readDocsCheckConfig, parseDecisionEntries, anchorFilePath } from './docs-check.js'
 import { decisionChangeQualifier } from './knowledge-match.js'
 
@@ -55,9 +55,9 @@ export function matchFilesToModules(changedFiles, moduleIndex, opts = {}) {
 
   for (const f of changedFiles) {
     let matched = null
-    // 一级：paths/core_files 前缀或字面量命中
+    // 一级：paths/core_files 前缀或字面量命中（含 glob 形态——modulePathMatches 统一入口）
     for (const [id, ps] of modulePaths) {
-      if (ps.some(p => p === f || f.startsWith(p.replace(/\/$/, '') + '/') || p.startsWith(f.split('/')[0] + '/') && p === f)) {
+      if (ps.some((p) => modulePathMatches(f, p))) {
         matched = id; break
       }
     }

package/src/doctor-diagnostics.js

@@ -23,6 +23,7 @@
  * writer 落盘到 <authoritySpecDir>/.runtime/。
  */
 import { openDatabase, pluckGet, pluckAll } from './db-engine.js';
+import { runtimeTempPath } from './runtime-paths.js'
 import { safeGit } from './git-helper.js';
 import { createHash } from 'crypto';
 import { existsSync, statSync, readFileSync, readdirSync, mkdirSync, writeFileSync, unlinkSync, rmSync } from 'fs';
@@ -1109,12 +1110,15 @@ export function detectSelfMaintenanceTax(cwd, authoritySpecDir) {
     const warnings = [];
 
     // ① 活跃非零 tally 列示（events:{type:{count,lastAt}}，X-10 结构）
+    // 2026-10-18 布局分层：tally 落 state/；根目录扫描保留旧布局兜底（入口迁移收敛后恒空）
     try {
-      for (const f of readdirSync(runtimeRoot)) {
+      const tallyDirs = [join(runtimeRoot, 'state'), runtimeRoot]
+      for (const tallyDir of tallyDirs) {
+      for (const f of (() => { try { return readdirSync(tallyDir) } catch { return [] } })()) {
         const m = f.match(/^friction-tally-(.+)\.json$/);
         if (!m) continue;
         let tally = null;
-        try { tally = JSON.parse(readFileSync(join(runtimeRoot, f), 'utf8')); } catch { continue; }
+        try { tally = JSON.parse(readFileSync(join(tallyDir, f), 'utf8')); } catch { continue; }
         const events = tally && typeof tally === 'object' && tally.events && typeof tally.events === 'object' && !Array.isArray(tally.events) ? tally.events : {};
         const segs = [];
         let total = 0;
@@ -1131,6 +1135,7 @@ export function detectSelfMaintenanceTax(cwd, authoritySpecDir) {
         findings.push(`活跃摩擦：${m[1]}（${segs.join('、')}${lastAt ? `，最近 ${lastAt}` : ''}）`);
         if (total >= TAX_HEAVY_TOTAL) warnings.push(`税重——评估该机制群简化/退役（对照其 decisions 退役判据）：${m[1]}（活跃 total ${total}）`);
       }
+      }
     } catch { /* runtimeRoot 不可读 → 无活跃数据，不误报 */ }
 
     // ② 台账聚合（近 90 天 top5 + 累计总量）；④ 缺失渲染提示不告警
@@ -1748,7 +1753,7 @@ export function writeDoctorDiagnosis(json, specDir) {
   try {
     const runtimeDir = join(specDir, '.runtime');
     mkdirSync(runtimeDir, { recursive: true });
-    const outPath = join(runtimeDir, 'doctor-diagnosis.json');
+    const outPath = runtimeTempPath(runtimeDir, 'doctor-diagnosis.json');
     writeFileSync(outPath, JSON.stringify(json, null, 2) + '\n');
     return outPath;
   } catch (e) {

package/src/flow-draft.js

@@ -23,6 +23,7 @@ import { wrapSection, verifyMarkers, reanchorText, bodyHash, parseMarkerBlocks }
 // 占位句常量真同源（2026-10-03-fr-skeleton-gate 评审 P3 清偿）：起草端 Then 兜底与骨架判据
 // （fr-index.isThinSkeletonBodies）共用同一字面量——两处独立字符串会被评审实证为「镜像非同源」。
 import { SKELETON_THEN_PLACEHOLDER } from './fr-index.js'
+import { runtimeStatePath } from './runtime-paths.js'
 
 /** 读文件并归一化 CRLF→LF（2026-09-25-feedback-fixes④：Python/编辑器写盘 CRLF 会破坏 
  锚定的槽位识别 regex）。 */
@@ -88,7 +89,7 @@ const QUESTION_REPAIR_SIM_THRESHOLD = 0.5
 
 /** sidecar 台账路径（.runtime 下，verify-draft sidecar 同族；命名空间=文件:段键）。 */
 export function draftLedgerPath(runtimeRoot, changeName) {
-  return join(runtimeRoot, `draft-ledger-${changeName}.json`)
+  return runtimeStatePath(runtimeRoot, `draft-ledger-${changeName}.json`)
 }
 
 const AGENT_SLOT = (n, hint) => `<!--AGENT:槽${n} ${hint}——例外裁决书写面（机器段之外合法） -->`

package/src/flow-parity.js

@@ -19,12 +19,14 @@
  *    命中模块变更索引机械回写（sidecar 优先、幂等）、start 注入面欠账事实行（提示前移）。
  */
 import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs'
+import { modulePathMatches } from './modules.js'
 import { join, relative } from 'node:path'
 import { createHash } from 'node:crypto'
 import { execFileSync } from 'node:child_process'
 import { splitOwnVsForeignDiffFiles, commitAttributionForChange, isForeignByCommit, parseChangeNamesFromSubject } from './foreign-declared.js'
 import { collectModuleMaps, normalizeMapPath } from './module-resolve.js'
 import { computeDocsDebt } from './docs-debt.js'
+import { anchorBackfillCandidate } from './decision-distill.js'
 import { writeAtomicSync } from './fs-atomic.js'
 import { normalizePath } from './change-list.js'
 import { readV2SectionAnswer } from './flow-review.js'
@@ -72,7 +74,7 @@ export function reconcileModuleDocs({ cwd, specBase, ownFiles, committedRaw }) {
         .map((pp) => (map.prefix + normalizeMapPath(pp)).replace(/\/+$/, ''))
         .filter(Boolean)
       if (effs.length === 0) continue
-      const hitFiles = deliverables.filter((f) => effs.some((e) => f === e || f.startsWith(e + '/')))
+      const hitFiles = deliverables.filter((f) => effs.some((e) => modulePathMatches(f, e)))
       if (hitFiles.length === 0) continue
       hits++
       const docRel = entry.doc ? `docs/${map.project}/${String(entry.doc).replace(/^\/+/, '')}` : null
@@ -93,7 +95,7 @@ export function reconcileModuleDocs({ cwd, specBase, ownFiles, committedRaw }) {
       for (const pp of entry.paths || []) allPaths.push((map.prefix + normalizeMapPath(pp)).replace(/\/+$/, ''))
     }
   }
-  const isCovered = (f) => allPaths.some((pp) => pp && (f === pp || f.startsWith(pp + '/')))
+  const isCovered = (f) => allPaths.some((pp) => pp && modulePathMatches(f, pp))
   const uncoveredMap = new Map()
   for (const f of deliverables) {
     if (isCovered(f)) continue
@@ -316,6 +318,11 @@ export function harvestSlot4Decision({ changeDir, change }) {
     answer = readV2SectionAnswer(dText, risksSec.heading, DESIGN_QUESTIONS)
   }
   if (!answer || /^不适用/.test(answer)) return { harvested: false, reason: '槽4 空/不适用' }
+  // 锚点自动回填（2026-10-15-decision-anchor-backfill 收割端）：风险段作答文本恰含一个
+  // 路径 token → 写入 - 锚点：行（源 decisions.md 是真相源，蒸馏自然带上、人可改）；
+  // 0/多候选不写（蒸馏端渲染时还会再兜底一次同款判定）。单一源 anchorBackfillCandidate。
+  const anchorCand = anchorBackfillCandidate(answer)
+  const anchorLine = anchorCand ? [`- 锚点：${anchorCand}`] : []
   const text = [
     '---',
     `author: flow-machine-draft`,
@@ -328,6 +335,7 @@ export function harvestSlot4Decision({ changeDir, change }) {
     `## D-001@v1: 设计期风险与放弃方案（底稿）`,
     `- 类型：process`,
     `- 状态：confirmed`,
+    ...anchorLine,
     // 类型/状态字段（2026-09-26-slot4-distill-fix）：蒸馏链入选要 status∈{confirmed|accepted|rejected}
     // 且 type∈七类白名单，字段解析只认 `- 字段：值` 列表行形态——此前收割条目零字段致永不入选，
     // 「随蒸馏链进 knowledge」断链（thin-agent-tasks 教训留档归档而 knowledge 零落地的实证）。