sillyspec 3.29.3 → 3.29.5

package/src/taskcard-frontmatter.js

@@ -0,0 +1,57 @@
+/**
+ * taskcard-frontmatter.js — task 卡 frontmatter 单一解析源（2026-09-20-taskcard-yaml-hardgate）
+ *
+ * 背景：坏 YAML 曾被三个消费点各自静默吞——plan-postcheck.js parseTaskContracts 的 catch 返回
+ * 空对象冒充「无契约字段」→ 契约门禁空真过门；verify-probes.js parseTaskAcceptance 的 catch
+ * 返回空数组 → 探针 7 假防御文案；且两侧 frontmatter 提取口径不一致（一侧 \r 容错一侧不容）。
+ * 本模块把「提取 + jsYaml 解析 + 错误定位（文件行:列）」收敛为一处，plan 与 verify 两侧共同消费。
+ *
+ * 防环铁律：本模块除 js-yaml 外零依赖（不 import 仓内任何模块）——plan-postcheck 与
+ * worktree-apply 存在既有依赖边（knowledge patterns），共享逻辑放新模块两侧 import。
+ */
+import jsYaml from 'js-yaml'
+
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/
+
+/**
+ * 提取 task 卡 frontmatter。界定口径与 verify-probes.js parseTaskAcceptance 原实现同款
+ * （首行 --- 起、闭合 --- 行止，\r\n 容错——Windows 编辑器文本模式写卡不炸提取）。
+ * @param {string} content task 卡全文
+ * @returns {{ has: boolean, yamlText: string|null, yamlStartLine: number }}
+ *   yamlStartLine = YAML 内容在文件中的起始行号（1 基）：首行是 ---，YAML 自第 2 行起，恒为 2
+ */
+export function splitFrontmatter(content) {
+  const m = String(content ?? '').match(FRONTMATTER_RE)
+  if (!m) return { has: false, yamlText: null, yamlStartLine: 2 }
+  return { has: true, yamlText: m[1], yamlStartLine: 2 }
+}
+
+/**
+ * 解析 task 卡 frontmatter（单一真相源）。
+ * @param {string} content task 卡全文
+ * @returns {{ ok: boolean, hasFrontmatter: boolean, fm: object|null,
+ *   error: { message: string, line: number, column: number }|null }}
+ *   - 无 frontmatter：{ ok: true, hasFrontmatter: false, fm: null, error: null }——不是错误，
+ *     「无 frontmatter」由各消费方按自身语义处理（plan-postcheck 结构检查另有拦截）
+ *   - jsYaml 抛错：{ ok: false, hasFrontmatter: true, fm: null, error: {...} }。
+ *     error.line = e.mark.line + yamlStartLine：js-yaml mark.line 是 YAML 文本内 0 基行号，
+ *     +2 后即文件 1 基行号（首行 ---，YAML 第 1 行 = 文件第 2 行）；mark 缺席回退 1。
+ *     error.column = e.mark.column + 1（0 基 → 1 基；mark 缺席回退 1）。
+ *     error.message 取异常首行（js-yaml 原始 message 含多行上下文，单行化便于门禁文案）。
+ *   - 合法：{ ok: true, hasFrontmatter: true, fm, error: null }（空文档回退 {}）
+ */
+export function parseTaskFrontmatter(content) {
+  const { has, yamlText, yamlStartLine } = splitFrontmatter(content)
+  if (!has) return { ok: true, hasFrontmatter: false, fm: null, error: null }
+  let fm
+  try {
+    fm = jsYaml.load(yamlText) || {}
+  } catch (e) {
+    const mark = e && e.mark
+    const line = mark && typeof mark.line === 'number' ? mark.line + yamlStartLine : 1
+    const column = mark && typeof mark.column === 'number' ? mark.column + 1 : 1
+    const message = String((e && e.message) || e).split('\n')[0]
+    return { ok: false, hasFrontmatter: true, fm: null, error: { message, line, column } }
+  }
+  return { ok: true, hasFrontmatter: true, fm, error: null }
+}

package/src/verify-postcheck.js

@@ -135,6 +135,44 @@ function extractLintCommand(yamlText) {
   return null
 }
 
+/**
+ * lint 失败输出中提及的文件路径提取（lint 归属鉴定·R4-S-F 实证：verify 侧 lint 硬门 7 轮
+ * 全是 HEAD 存量债——快照含基线债文件时恒败，逼 agent 范围外清偿或逃生口）。
+ * 口径：按空白切 token，剥引号/行号尾缀（ruff/eslint 的 path:line:col 形态），保留带路径
+ * 分隔符且以代码扩展名结尾的 token（不带分隔符的普通单词不收，防误报）。去重保序。
+ */
+export function extractLintFailureFiles(output) {
+  if (!output || typeof output !== 'string') return []
+  const LINT_FILE_EXT_RE = /\.(?:js|mjs|cjs|ts|tsx|jsx|vue|svelte|py|pyw|go|rs|java|kt|kts|rb|php|cs|c|h|cpp|cc|hpp|swift|scala|css|scss)$/
+  const seen = new Set()
+  for (const raw of output.split(/\s+/)) {
+    let t = raw.replace(/^["'`(\[]+/, '').replace(/["'`),;]+$/, '')
+    t = t.replace(/:(?:\d+)(?::\d+)*$/, '') // 剥 :line / :line:col
+    if (!LINT_FILE_EXT_RE.test(t)) continue
+    if (!/[\\/]/.test(t)) continue
+    const norm = t.replace(/\\/g, '/').replace(/^\.\//, '')
+    if (norm.length > 1) seen.add(norm)
+  }
+  return [...seen]
+}
+
+/**
+ * lint 失败归属判定（纯函数）：失败输出提及的文件 × 本变更文件集。
+ * - owned：有交集 → 失败可能由本变更引入 → 维持硬拦（保守）。
+ * - pre-existing：零交集 → 全是 HEAD 存量债 → 调用方降档 advisory（债不是本变更的错）。
+ * - unattributable：失败文件提取为空（输出无可识别路径，如纯配置错误）→ 维持硬拦（无法
+ *   排除本变更责任，宁可拦不可漏）。
+ * 匹配宽松双向 endsWith（输出可能是绝对路径/仓相对路径，两侧口径不一定同源）。
+ */
+export function triageLintOwnership({ failureFiles = [], changeFiles = [] } = {}) {
+  const norm = (p) => String(p).replace(/\\/g, '/').replace(/^\.\//, '').toLowerCase()
+  const ffs = (Array.isArray(failureFiles) ? failureFiles : []).map(norm).filter(Boolean)
+  if (ffs.length === 0) return { verdict: 'unattributable', overlap: [] }
+  const cfs = (Array.isArray(changeFiles) ? changeFiles : []).map(norm).filter(Boolean)
+  const overlap = ffs.filter(f => cfs.some(c => c === f || c.endsWith('/' + f) || f.endsWith('/' + c)))
+  return overlap.length > 0 ? { verdict: 'owned', overlap } : { verdict: 'pre-existing', overlap: [] }
+}
+
 /**
  * lint advisory 观察期计数（刀③，2026-09-08）：advisory 失败不阻断，但「观察期后升级硬门」
  * 需要失败率数据支撑（更硬 vs 更吵的决策依据——硬门误伤纯文档/跨平台路径会制造新噪音）。
@@ -226,6 +264,7 @@ export function runVerifyLintCheck({ cwd, specBase, timeoutMs } = {}) {
     outputTail,
     reason: finalReason,
     tally, // { failedRuns, totalRuns } | null——观察期失败率，升级硬门的决策依据
+    failureFiles: status === 'failed' ? extractLintFailureFiles(output) : [], // 归属鉴定输入（全文口径，outputTail 有截断盲区）
   }
 }
 
@@ -266,7 +305,7 @@ export function printVerifyLintCheck(result) {
     console.error(`\n⚠️  Verify lint 实测失败（advisory 档，不阻断本次完成）：\`${result.command}\` — ${result.reason}`)
     console.error('   agent 的 lint 自报告与实测不符时以实测为准；请修复后重跑，避免格式债推迟到 commit 被 pre-commit hook 拦截。')
     if (result.tally) {
-      console.error(`   📊 lint advisory 失败累计 ${result.tally.failedRuns}/${result.tally.totalRuns} 次（数据落 .runtime/verify-lint-tally.json）。`)
+      console.error(`   📊 lint advisory 观察期：实测 ${result.tally.totalRuns} 次中失败 ${result.tally.failedRuns} 次（数据落 .runtime/verify-lint-tally.json）。`)
     }
   }
   if (result.outputTail) {
@@ -1027,6 +1066,22 @@ export function classifyTestFailureArtifact(result) {
  *   - 其余（full / module 无块 / module git 不可用 hitCount=-1）→ 'full'
  * @returns {'skip'|'module-subset'|'module-zero-hit-skip'|'full'}
  */
+/**
+ * 纯超时失败判定（R4 门禁价值考古 2026-09-21：227 跑 106 败里 36 次（34%）是 600s 帽杀的
+ * 纯超时假拦——超时=未完成非测试失败，硬拦只是浪费一轮门禁）。所有失败单元的 reason 都
+ * 含「超时」→ true（调用方降档 advisory）；任一失败单元是真实退出码/挂测 → false（维持硬拦）。
+ * 单元来源：module 模式读 result.modules（失败单元过滤），full 模式整体 reason。跨仓合并结果
+ * 语义同 full（整体 reason 聚合）。
+ */
+export function isTimeoutOnlyTestFailure(testCheck) {
+  if (!testCheck || testCheck.status !== 'failed') return false
+  const units = Array.isArray(testCheck.modules) && testCheck.modules.length > 0
+    ? testCheck.modules.filter(u => u && u.status === 'failed')
+    : [testCheck]
+  if (units.length === 0) return false
+  return units.every(u => /超时/.test(String(u.reason || '')))
+}
+
 export function decideVerifyTestAction({ strategy, modulesPresent, hitCount }) {
   if (strategy === 'skip') return 'skip'
   if (strategy === 'module' && modulesPresent) {
@@ -2034,6 +2089,9 @@ function runModuleSubset({ cwd, specBase, changeName, hits, knownFailures = [],
     // 每模块台账另见 extra.modules[].failure_remaining（带模块归属）
     failureRemaining: perModule.flatMap(r => r.failureRemaining || []),
     failureExempted: perModule.flatMap(r => r.failureExempted || []),
+    // 逐模块结论（isTimeoutOnlyTestFailure 的单元口径；writeRunResult extra 之外再随结果
+    // 返回，调用方可精确分单元判超时/真挂，不依赖聚合 reason 文本）
+    modules: perModule.map(r => ({ name: r.name, status: r.status, reason: r.reason, durationMs: r.durationMs })),
   }
 
   writeRunResult({
@@ -2909,21 +2967,25 @@ export function reconcileTargetFiles({ cwd, specBase = null, changeName = null,
   const decl = collectDeclaredTargetFiles(sb, changeName)
   // —— 跨仓 per-repo 对账（坑 cross-repo-reconcile-blindness，2026-09-15 复盘兑现 D-004 分期：
   // 此前 22 个跨仓文件在归档表全标「计划未动」、跨仓全靠人工到对应仓解释）——advisory 不阻断：
-  // 锚点是各仓 HEAD~1..HEAD 最近提交窗口（多 task 同仓只反映最近一笔，锚点脆弱期会产②类假
-  // 信号），只报告不翻转主仓状态。结果经 crossRepo 字段（gates 渲染明细）与 notes（摘要随
-  // 各状态出口流动）双通道出口。
+  // 锚点档经内核分级（A reviews 锡点区间 > B HEAD~1..HEAD 窗口 > C 未提交窗口，runtimeRoot/
+  // changeName 传参贯通喂 A 档 reviews 解析——评审 G2；锚点脆弱期会产②类假信号），只报告不
+  // 翻转主仓状态。结果经 crossRepo 字段（gates 渲染明细）与 notes（摘要随各状态出口流动）
+  // 双通道出口。
   let crossRepo = []
   if (decl.crossRepoCards.length > 0) {
     try {
-      crossRepo = reconcileCrossRepoDeclarations({ specBase: sb, cwd, declarationsByRepo: decl.crossRepoDeclarations })
+      crossRepo = reconcileCrossRepoDeclarations({ specBase: sb, cwd, declarationsByRepo: decl.crossRepoDeclarations, runtimeRoot: rt, changeName })
     } catch { crossRepo = [] /* 跨仓对账异常不拖垮主仓链（advisory 定位） */ }
     for (const label of decl.crossRepoCards) {
       notes.push(`跨仓 task 卡 ${label} 不进主仓对账（主仓 actual 对不上跨仓声明，D-004）——其声明已转 per-repo 对账（见下方跨仓对账段）`)
     }
     for (const r of crossRepo) {
+      // 锚点档动态化（task-03）：优先内核透传的 anchor.label（A/B/C/degraded 四档人类可读描述）；
+      // 旧形态无 anchor 字段 → 防御性回退原文案（该仓最近提交窗口）
+      const anchorTxt = r.anchor && typeof r.anchor.label === 'string' && r.anchor.label ? r.anchor.label : '该仓最近提交窗口'
       notes.push(r.degradedReason
         ? `跨仓 ${r.repo}：${r.degradedReason}`
-        : `跨仓 ${r.repo} 对账：声明 ${r.declaredCount} / 实测 ${r.actualCount} / 对上 ${r.matched.length} / ②缺 ${r.missing.length} / ③多 ${r.undeclared.length}${r.scaffoldCount > 0 ? `（另有 ${r.scaffoldCount} 脚手架已聚合）` : ''}——advisory（锚点=该仓最近提交窗口）`)
+        : `跨仓 ${r.repo} 对账：声明 ${r.declaredCount} / 实测 ${r.actualCount} / 对上 ${r.matched.length} / ②缺 ${r.missing.length} / ③多 ${r.undeclared.length}${r.scaffoldCount > 0 ? `（另有 ${r.scaffoldCount} 脚手架已聚合）` : ''}——advisory（锚点=${anchorTxt}）`)
     }
   }
   if (decl.cardCount === 0) {

package/src/verify-probes.js

@@ -26,7 +26,6 @@
  */
 import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'fs'
 import { join, dirname, basename, resolve, isAbsolute, relative } from 'path'
-import jsYaml from 'js-yaml'
 import { gitQuiet, unquoteGitPath } from './git-helper.js'
 import { hasUnconfirmedPrefill } from './prefill.js'
 import {
@@ -36,6 +35,7 @@ import { parseFileChangeListDetailed } from './change-list.js'
 import { parseDecisions } from './decision-distill.js'
 import { parseAllowedPaths, parseRepo, parseRepoRegistry } from './stages/plan-postcheck.js'
 import { verifyApiParity, _readWorktreeMeta } from './contract-matrix.js'
+import { parseTaskFrontmatter } from './taskcard-frontmatter.js'
 import { RECEIPT_SOURCE_CROSS_LAYER_RE as RECEIPT_CROSS_LAYER_RE, RECEIPT_SOURCE_UNIT_RE as RECEIPT_UNIT_RE, CLI_SMOKE_SOURCE_MARK as SMOKE_RECEIPT_SOURCE_MARK } from './change-risk-profile.js'
 import { splitOwnVsForeignDiffFiles } from './foreign-declared.js'
 import { resolveSpecDir, resolveRuntimeRoot, detectWorktreeSpecDrift } from './run/shared.js'
@@ -1073,7 +1073,7 @@ function designHasSubmitEndpoint(text) {
 //   sectionHint（命中的接口段头列表，审计注记）。
 // 落盘面（数据通道=落盘即消费，stage-contract 零 import 纪律）：backfillFactsFromMdAndTests
 // 主路径写 facts.apiFace / facts.consumerHints，task-05 validator 经 facts 消费不经函数调用。
-const API_FACE_SECTION_RE = /接口|端点|api|rest/i
+const API_FACE_SECTION_RE = /接口|端点|\bapi\b|\brest\b/i // quick-B 词边界：OpenAPI 标题（api 前邻字母）不再误收进 sectionHint
 const API_FACE_METHOD_RE = /(?:^|[^A-Za-z])(GET|POST|PUT|DELETE|PATCH)(?![A-Za-z])/
 // 路径样式 token：/ 起始、前邻非字母数字（日期 2026/09/17 的 /09 前是数字段不认），
 // 首字符字母数字/_/-/{，后续段字符含 {}/: 模板形态（/orders/{id}、/orders/:id 全串命中）
@@ -1713,26 +1713,34 @@ const PROBE7_NONTESTABLE_RE = /文档|部署|doc|deploy|manual|config/i
 
 /**
  * 解析 task-NN.md frontmatter 的 acceptance（string/array 双形态归一为数组）。
- * 口径锚 src/stages/plan-postcheck.js acceptance best-effort 段（string → 原文单条、array →
- * 逐条）——不 import 它：parseTaskContracts 只返回 provides/expects_from 不含 acceptance。
+ * 解析归一 taskcard-frontmatter.js 单一源（2026-09-20-taskcard-yaml-hardgate：此前坏 YAML
+ * catch 返回 [] 冒充「无 acceptance」，探针 7 渲染假防御文案）——status 三态让调用方区分
+ * 「真无 acceptance」与「frontmatter 非法 YAML」。口径锚 src/stages/plan-postcheck.js
+ * acceptance best-effort 段（string → 原文单条、array → 逐条）。
  * @param {string} content task 卡全文
- * @returns {string[]|null} acceptance 条目数组；null = 无 frontmatter（调用方跳过该卡）；
- *   frontmatter 在场但无 acceptance / 非法 YAML → []（防御行，plan-postcheck 已拦缺失）
+ * @returns {{ status: 'no-frontmatter'|'invalid-yaml'|'ok', acceptance: string[],
+ *   error: {message: string, line: number, column: number}|null }}
+ *   no-frontmatter = 无 frontmatter（调用方跳过该卡）；invalid-yaml = frontmatter 非法 YAML
+ *   （acceptance 不可读，error 带文件 1 基行:列）；ok = 合法解析，acceptance 归一数组
+ *   （frontmatter 在场但无 acceptance → []，此时防御行为真——plan-postcheck 已拦缺失）
  */
 export function parseTaskAcceptance(content) {
-  const fmMatch = String(content || '').match(/^---\r?\n([\s\S]*?)\r?\n---/)
-  if (!fmMatch) return null
-  try {
-    const fmObj = jsYaml.load(fmMatch[1]) || {}
-    if (typeof fmObj.acceptance === 'string') {
-      const t = fmObj.acceptance.trim()
-      return t ? [t] : []
-    }
-    if (Array.isArray(fmObj.acceptance)) {
-      return fmObj.acceptance.filter(x => typeof x === 'string' && x.trim() !== '').map(x => x.trim())
+  const parsed = parseTaskFrontmatter(content)
+  if (!parsed.hasFrontmatter) return { status: 'no-frontmatter', acceptance: [], error: null }
+  if (!parsed.ok) return { status: 'invalid-yaml', acceptance: [], error: parsed.error }
+  const fmObj = parsed.fm || {}
+  if (typeof fmObj.acceptance === 'string') {
+    const t = fmObj.acceptance.trim()
+    return { status: 'ok', acceptance: t ? [t] : [], error: null }
+  }
+  if (Array.isArray(fmObj.acceptance)) {
+    return {
+      status: 'ok',
+      acceptance: fmObj.acceptance.filter(x => typeof x === 'string' && x.trim() !== '').map(x => x.trim()),
+      error: null,
     }
-  } catch { /* frontmatter 非法 YAML → 防御性空（plan-postcheck 侧已拦） */ }
-  return []
+  }
+  return { status: 'ok', acceptance: [], error: null }
 }
 
 /**
@@ -1939,6 +1947,12 @@ function renderProbe7Lines(p7) {
   for (const t of (p7.tasks || [])) {
     L.push('')
     L.push(`**${t.task}**`)
+    if (t.fmError) {
+      // 坏 YAML 如实陈述（2026-09-20-taskcard-yaml-hardgate）：非「无 acceptance」防御——
+      // plan 门禁 0b 硬校验应已拦截；已过 plan 门仍见此行 = 门禁失效信号（可反馈工具缺陷）
+      L.push(`- ⚠️ frontmatter 非法 YAML（${t.task}.md:${t.fmError.line}:${t.fmError.column} ${mdEscapeCell(t.fmError.message, 160)}）——acceptance 不可读，本行非「无 acceptance」防御；plan 门禁 frontmatter 硬校验应已拦截，若已过 plan 门仍见此行即门禁失效信号`)
+      continue
+    }
     if (!Array.isArray(t.acceptance) || t.acceptance.length === 0) {
       L.push('- （卡无 acceptance——防御，plan-postcheck 已拦）')
       continue
@@ -2138,10 +2152,17 @@ export function runVerifyProbes({ cwd, changeName, specDir = null }) {
       try {
         for (const f of readdirSync(tasksDir).filter(n => /^task-\d+\.md$/.test(n)).sort()) {
           const raw = readFileSync(join(tasksDir, f), 'utf8')
-          const acceptance = parseTaskAcceptance(raw)
-          if (acceptance === null) continue // 无 frontmatter → 跳过（plan-postcheck 已拦）
+          // 三态分流（2026-09-20-taskcard-yaml-hardgate）：no-frontmatter 跳卡（原 null 语义）；
+          // invalid-yaml 挂 fmError 进条目——渲染层区分「坏 YAML」与「真无 acceptance」防御行
+          const parsed = parseTaskAcceptance(raw)
+          if (parsed.status === 'no-frontmatter') continue // 无 frontmatter → 跳过（plan-postcheck 已拦）
           const fmId = (raw.match(/^id:\s*(\S+)/m) || [])[1]
-          cards.push({ task: fmId || f.replace(/\.md$/, ''), acceptance, raw })
+          cards.push({
+            task: fmId || f.replace(/\.md$/, ''),
+            acceptance: parsed.acceptance,
+            fmError: parsed.status === 'invalid-yaml' ? parsed.error : null,
+            raw,
+          })
         }
       } catch { /* tasks 目录不可读 → applicable 维持 false */ }
       probe7.applicable = cards.length > 0
@@ -2196,6 +2217,7 @@ export function runVerifyProbes({ cwd, changeName, specDir = null }) {
         probe7.tasks.push({
           task: card.task,
           acceptance: card.acceptance,
+          fmError: card.fmError || null,
           testFiles,
           hints: buildAcceptanceHints(card.acceptance, testFiles, cwd, wtRoot, probe7CrossRoots),
         })
@@ -2568,7 +2590,7 @@ function renderApiCoverageMatrixLines(apiFace) {
   L.push('<!-- 预填说明：端点行由 CLI 机械预填，判定/用例依据 ID/结果/证据由 agent 逐格填写——用例依据 ID 锚点五形态：design接口表#METHOD /path、权限矩阵[角色×动作]、契约表@行标识、DDL@列名、载荷@构造点路径（须真实命中对应表/段，防空指）。 -->')
   L.push('<!-- 文法注释：子行 = 端点行下一行、两空格缩进、以「↳ <消费端>:」前缀书写（消费端细分承接面，不计矩阵行账）；探索行 = 判定 uncovered 且证据列含 [探索] 标记（探索性验证不算覆盖）。 -->')
   if (endpoints.length === 0 && declared === null) {
-    L.push('- 无接口面（design 接口段解析零端点且无「本变更接口面：N 端点」声明行）——本变更若实际触碰接口，先补 design 接口段表格或声明行，再重跑 `verify-probes --init` 刷新本段；判级 critical 的零面拦截归 validator')
+    L.push('- 无接口面（design 接口段解析零端点且无「本变更接口面：N 端点」声明行）——本变更若实际触碰接口，先补 design 接口段表格或声明行，再重跑 `verify-probes --change <变更名> --init --force` 重生成本段（⚠️ 全骨架重生成，手填结论会重置——先备份；quick-B 起 --force 通道存在）；判级 critical 的零面拦截归 validator')
     return L
   }
   if (endpoints.length > 0 && declared !== null && declared !== endpoints.length) {
@@ -2582,7 +2604,7 @@ function renderApiCoverageMatrixLines(apiFace) {
     }
   } else {
     L.push(`| 本变更接口面：${declared} 端点（agent 声明） | <待填：五选一> | <待填：用例 ID> | <待填> | <待填：锚点> |`)
-    L.push('<!-- 解析零行降级（D-005）：接口面以 agent 声明为准（对账分母=声明数）；声明与实际不符时补 design 接口段表格后重跑 --init 刷新本段 -->')
+    L.push('<!-- 解析零行降级（D-005）：接口面以 agent 声明为准（对账分母=声明数）；声明与实际不符时补 design 接口段表格后重跑 --init --force 重生成本段（quick-B：--force 才有刷新通道，手填内容会重置先备份） -->')
   }
   L.push('<!-- advisory 尾注（warning 计算归 validator，本段只留位）：有消费端未填子行的端点将列于此（advisory——消费端归类=design 清单启发式，数据面 facts.consumerHints）；写端点（POST/PUT/DELETE/PATCH）未在权限矩阵段声明的将列于此（advisory——补行或显式豁免「无权限约束」，数据面 facts.apiFace.writeEndpoints；表缺行会让派生框架继承你的洞） -->')
   return L