dowafu 0.3.1 → 0.3.2

package/dist/audit.js

@@ -2,6 +2,7 @@
 // finalText 與允許讀取清單，吐結構化稽核結果。「疑似」而非「fail」的界線見 §15 說明——
 // 禁止內容關鍵詞必有誤判，故只標記交 hub 判讀，不得自動刪改 spoke 原文。
 import { splitTopLevelSections } from "./ticket.js";
+import { REPORT_PLACEHOLDERS } from "./prompt.js";
 export const FIXED_CLOSING_LINE = "以上為觀察與問題，採用與否由 hub 與使用者裁決。";
 // 英文工單走英文模板，收尾句與章節名也跟著換。稽核**兩套都認**且不看工單語言——spoke
 // 偶爾會用另一種語言作答，那是產出品質的事，不該讓稽核整份判 fail 而蓋掉真正的訊號。
@@ -16,18 +17,38 @@ function getSection(sections, names) {
     }
     return undefined;
 }
-const SUSPECT_PHRASES = ["應該改成", "建議採用", "嚴重度", "高風險", "應廢止"];
-// plan_i18n_v1.2.md §4.1／i18n_classification_t2.md §五 #8-12：英文回報若只比對中文詞，
-// 稽核會靜默失效——不報錯、不變紅，只是什麼都抓不到。兩套並存同時比對，不隨 lang 切換
-// （spoke 可能用另一種語言作答，稽核本來就不看工單語言）。summary.md 需要分開標示是
-// 哪一套命中，供日後調整這份清單時有資料可依據，故 auditSpoke 分開回傳兩個陣列。
-const SUSPECT_PHRASES_EN = ["should be changed to", "recommend adopting", "severity", "high risk", "should be deprecated"];
 // 抓看起來像相對路徑的引用：至少一層目錄＋副檔名，容許前後有反引號與 :行號。
 // plan_dispatch_v1.12.md §15：字元類須容許中括號，否則 Next.js 動態路由段（[id]、
 // [...slug]、[[...slug]]）會把路徑從中括號後截斷——截斷後的字串當然不在允許清單內，
 // 於是每一條合法引用都被誤判為清單外（首次外部派工實測：三個 spoke 全部誤報）。
 // 比對方式維持精確集合比對不變，只改路徑抽取的容許字元。
 const PATH_REGEX = /`?([\w.\-[\]]+(?:\/[\w.\-[\]]+)+\.[A-Za-z0-9]{1,10})(?::\d+)?`?/g;
+function countOccurrences(text, needle) {
+    let count = 0;
+    let idx = 0;
+    for (;;) {
+        const found = text.indexOf(needle, idx);
+        if (found === -1)
+            return count;
+        count++;
+        idx = found + needle.length;
+    }
+}
+// external-luna-high-r3 的實際形態：spoke 把 `<觀察>` 當成 XML 標籤，自創 `</觀察>` 收尾。
+// 對每個佔位符一併查它的自創收尾標籤形態，不只查模板原樣的開標籤。
+function countTemplatePlaceholders(finalText) {
+    const hits = [];
+    for (const placeholder of REPORT_PLACEHOLDERS) {
+        const openCount = countOccurrences(finalText, placeholder);
+        if (openCount > 0)
+            hits.push({ placeholder, count: openCount });
+        const closingTag = `</${placeholder.slice(1)}`;
+        const closingCount = countOccurrences(finalText, closingTag);
+        if (closingCount > 0)
+            hits.push({ placeholder: closingTag, count: closingCount });
+    }
+    return hits;
+}
 // plan_dispatch_v1.9.md §15：稽核的職責是記錄，不是規範 spoke 的表達結構。原本只認
 // 範本的平鋪編號（"1. "），deepseek 用「## 問題 N」＋「**觀察 N.N**」的巢狀結構時被判成
 // 0 條——而那次是三份回報中最豐富的一份。放寬為多種常見形式皆計入，依序嘗試、採第一個
@@ -56,35 +77,16 @@ function countObservations(observationsBody) {
     }
     return null; // 章節有內容，但沒有一種已知樣式命中——無法辨識，不是沒有
 }
-// 找出 targetPath 第一次出現的頂層章節（依文件順序）。用同一個 PATH_REGEX 逐章節重新
-// 抽取比對，而非對章節內文字做 includes 子字串比對，避免相近路徑互相誤判。
-function findSection(sections, targetPath) {
-    for (const [heading, body] of sections) {
-        const pathsInSection = new Set([...body.matchAll(PATH_REGEX)].map((m) => m[1]));
-        if (pathsInSection.has(targetPath))
-            return heading;
-    }
-    return null;
-}
-// 若 citedPath 是某個允許清單項目的路徑後綴（以 "/" 為界，非任意子字串），回傳該項目
-// 原始字串——供讀者判斷是否為縮寫，而非臆測。
-function findSuffixSource(citedPath, allowedRelativePaths) {
-    return allowedRelativePaths.find((allowed) => allowed.length > citedPath.length &&
-        allowed.endsWith(citedPath) &&
-        allowed[allowed.length - citedPath.length - 1] === "/");
-}
-export function auditSpoke(finalText, allowedRelativePaths) {
+// 工單 X1 v1.1 §六（使用者裁示 2026-08-15）：「清單外引用」欄拿掉的是判定，citedPaths 這個
+// 記錄本身保留——它是純資料，不含判斷，供日後「引用 vs 實際讀取」的交叉分析使用。
+export function auditSpoke(finalText) {
     if (!finalText) {
         return {
             finalLinePass: false,
             observationCount: null, // 完全沒有內容可數，不是「數出來是零」
             citedPaths: [],
-            citedPathsOutsideAllowlist: [],
-            citedPathsOutsideAllowlistDetail: [],
             cannotVerifySectionPresent: false,
-            suspectPhrases: [],
-            suspectPhrasesZh: [],
-            suspectPhrasesEn: [],
+            templatePlaceholdersFound: [],
         };
     }
     const lines = finalText.split(/\r?\n/).map((l) => l.trim());
@@ -95,45 +97,12 @@ export function auditSpoke(finalText, allowedRelativePaths) {
     const observationCount = observationsSection !== undefined ? countObservations(observationsSection) : null;
     const cannotVerifySectionPresent = CANNOT_VERIFY_SECTIONS.some((n) => sections.has(n));
     const citedPaths = [...new Set([...finalText.matchAll(PATH_REGEX)].map((m) => m[1]))];
-    const allowedSet = new Set(allowedRelativePaths);
-    // 熱修補（issue_log_v1.1.md）：「無法驗證」章節內的路徑必然在允許清單之外——§16 回報
-    // 模板定義該欄為「需要但讀不到的檔案」，出現清單外路徑是模板要求的正確行為，不是 §15
-    // 要防的「臆測或引用工單原文」。故清單外判定排除只出現在該章節的路徑；citedPaths 本身
-    // 維持完整記錄不變，記錄（§12）與判定（§15）是不同職責。
-    //
-    // 「只出現在」是關鍵字——同一路徑若跨「觀察」與「無法驗證」兩節出現，觀察節那筆仍須被
-    // 抓到（那正是 §15 要防的訊號：先在觀察節臆測引用，再於無法驗證節「自首」寫不在清單內，
-    // 藉此讓臆測那筆連帶被放行）。故須先算出「無法驗證節以外」引用了哪些路徑，只有兩者皆
-    // 不成立（在無法驗證節出現、且未在別處出現）才排除。
-    //
-    // 取捨：spoke 若在「無法驗證」欄裡編造一個不存在、且未在別處引用的路徑，此處抓不到。
-    // 可接受——該欄本來就是列「讀不到的檔案」，單獨出現在那裡不構成 §15 要防的訊號。
-    const cannotVerifySectionText = getSection(sections, CANNOT_VERIFY_SECTIONS) ?? "";
-    const pathsCitedInCannotVerifySection = new Set([...cannotVerifySectionText.matchAll(PATH_REGEX)].map((m) => m[1]));
-    const elsewhereText = [...sections.entries()]
-        .filter(([heading]) => !CANNOT_VERIFY_SECTIONS.includes(heading))
-        .map(([, body]) => body)
-        .join("\n");
-    const pathsCitedElsewhere = new Set([...elsewhereText.matchAll(PATH_REGEX)].map((m) => m[1]));
-    const pathsOnlyInCannotVerify = new Set([...pathsCitedInCannotVerifySection].filter((p) => !pathsCitedElsewhere.has(p)));
-    const citedPathsOutsideAllowlist = citedPaths.filter((p) => !allowedSet.has(p) && !pathsOnlyInCannotVerify.has(p));
-    const suspectPhrasesZh = SUSPECT_PHRASES.filter((phrase) => finalText.includes(phrase));
-    const suspectPhrasesEn = SUSPECT_PHRASES_EN.filter((phrase) => finalText.includes(phrase));
-    const suspectPhrases = [...suspectPhrasesZh, ...suspectPhrasesEn];
-    const citedPathsOutsideAllowlistDetail = citedPathsOutsideAllowlist.map((p) => ({
-        path: p,
-        section: findSection(sections, p),
-        suffixOf: findSuffixSource(p, allowedRelativePaths),
-    }));
+    const templatePlaceholdersFound = countTemplatePlaceholders(finalText);
     return {
         finalLinePass,
         observationCount,
         citedPaths,
-        citedPathsOutsideAllowlist,
-        citedPathsOutsideAllowlistDetail,
         cannotVerifySectionPresent,
-        suspectPhrases,
-        suspectPhrasesZh,
-        suspectPhrasesEn,
+        templatePlaceholdersFound,
     };
 }

package/dist/cli.js

@@ -178,7 +178,13 @@ async function main() {
         exitCode,
     });
     // §10 步驟 7／§11：派工報表
-    const report = buildReport(ticketId, spokes, estimates, allowlistEstimates, options, outDir, { repoRoot, providersSource, gitignoreStatus }, lang);
+    const report = buildReport(ticketId, spokes, estimates, allowlistEstimates, options, outDir, {
+        repoRoot,
+        providersSource,
+        gitignoreStatus,
+        reviewTextChars: ticket.shared.reviewText.length,
+        strayHeadings: ticket.shared.strayHeadings,
+    }, lang);
     log.info(report);
     // 護欄的預告：乾跑不受影響（它不寫任何東西），但先講，免得實跑才發現被擋。
     const outDirDirty = await outDirHasArtifacts(outDir);
@@ -290,10 +296,7 @@ async function main() {
         };
     });
     // §10 步驟 9：確定性稽核
-    const audits = new Map(results.map((r) => {
-        const spoke = spokes.find((sp) => sp.agent === r.agent);
-        return [r.agent, auditSpoke(r.finalText, spoke.allowedReadsRelative)];
-    }));
+    const audits = new Map(results.map((r) => [r.agent, auditSpoke(r.finalText)]));
     // plan_dispatch_v2.0.md §15（一）：tool 呼叫是執行資料不是文字，獨立於 auditSpoke 之外判定。
     const toolCallAudits = new Map(results.map((r) => {
         const spoke = spokes.find((sp) => sp.agent === r.agent);

package/dist/doctor.js

@@ -13,6 +13,7 @@ import path from "node:path";
 import { resolveDispatchHome } from "./dispatch-home.js";
 import { SECRET_ENV_VARS } from "./secret-env.js";
 import { PROVIDERS_FORMAT_VERSION } from "./providers.js";
+import { lensClosingLineStatus } from "./report.js";
 import { m } from "./messages.js";
 const DEFAULT_PROBE = {
     fileExists: (p) => {
@@ -31,13 +32,15 @@ const DEFAULT_PROBE = {
             return null;
         }
     },
+    readFile: (p) => {
+        try {
+            return fs.readFileSync(p, "utf8");
+        }
+        catch {
+            return null;
+        }
+    },
 };
-// 項四〈lens 定義〉：`.claude/agents/` 底下所有 hole-finder 開頭的檔，**含無後綴的
-// `hole-finder.md`**——語言包確實出貨那一支，而 CLI 不限定 agent 名（validate.ts 只看
-// `.claude/agents/<agent>.md` 在不在），所以它是可派的。漏算它會讓 doctor 報的支數
-// 與使用者 `ls` 看到的對不上，而這支指令的用途正是「回報你手上實際有什麼」。
-// `explore-haiku.md` 不算：它不是 hole-finder lens，沒有固定收尾句。
-const HOLE_FINDER_LENS_PATTERN = /^hole-finder(-.+)?\.md$/;
 function buildConfigDirValue(lang, env, dispatchHome) {
     if (dispatchHome === null)
         return m(lang, "doctorConfigDirUnresolved");
@@ -62,17 +65,37 @@ function buildModelListValue(lang, providers) {
         .join(joiner);
     return m(lang, "doctorModelListValue", PROVIDERS_FORMAT_VERSION, items);
 }
+// 工單 X1 v1.1 §三：doctor 不再只認 `hole-finder` 這個名字——只裝 translation-* 一類 lens
+// 的專案先前會被回報 0 個，使用者會誤以為裝錯了。改列出 `.claude/agents/` 底下所有 `.md`，
+// 並依「檔案內文最後一句是不是固定收尾句」分成兩組（判定沿用 report.ts 的
+// lensClosingLineStatus，不在此重寫）。沒有收尾句不是錯誤——`explore-haiku.md` 就是這種。
 function buildLensValue(lang, probe, cwd) {
     const lensDir = path.join(cwd, ".claude", "agents");
     const entries = probe.readDir(lensDir);
     if (entries === null)
         return m(lang, "doctorLensDirMissingValue", lensDir);
     const joiner = lang === "zh" ? "、" : ", ";
-    const lenses = entries
-        .filter((f) => HOLE_FINDER_LENS_PATTERN.test(f))
-        .map((f) => f.slice(0, -".md".length))
-        .sort();
-    return m(lang, "doctorLensFoundValue", lensDir, lenses.length, lenses.join(joiner));
+    const mdFiles = entries.filter((f) => f.endsWith(".md"));
+    const withClosing = [];
+    const withoutClosing = [];
+    for (const file of mdFiles) {
+        const name = file.slice(0, -".md".length);
+        const content = probe.readFile(path.join(lensDir, file));
+        // 讀不到內容（不存在於這一刻、權限不足…）不得讓整支 doctor 失敗——歸入無收尾句一組。
+        // 取捨：輸出上這與「確實沒有收尾句」分不出來，讀者看到的都是「無收尾句」；工單允許
+        // 「無法判定」或「無收尾句」二選一，這裡選後者，不是宣稱「照實說」出兩者的差異。
+        const status = content !== null ? lensClosingLineStatus(content) : "none";
+        (status === "none" ? withoutClosing : withClosing).push(name);
+    }
+    // 熱修補（2026-08-15）：對「去掉 .md 的名字」排序，不是對檔名排序——'-'(45) < '.'(46)，
+    // 對檔名排序會讓無後綴的 hole-finder.md 排到 hole-finder-cost.md 之後，看起來像被降級。
+    withClosing.sort();
+    withoutClosing.sort();
+    const noClosingSuffix = withoutClosing.length > 0
+        ? m(lang, "doctorLensNoClosingSuffix", withoutClosing.length, withoutClosing.join(joiner))
+        : "";
+    const closingNames = withClosing.length > 0 ? withClosing.join(joiner) : m(lang, "noneLabel");
+    return m(lang, "doctorLensFoundValue", lensDir, mdFiles.length, withClosing.length, closingNames, noClosingSuffix);
 }
 export function buildDoctorReport(lang, cmd, providers, env = process.env, homedir = os.homedir, probe = DEFAULT_PROBE, cwd = process.cwd()) {
     const dispatchHome = resolveDispatchHome(env, homedir);

package/dist/json-output.js

@@ -50,17 +50,15 @@ export function buildJsonSpoke(result, audit, toolCallAudit) {
             ? {
                 closingLine: audit.finalLinePass,
                 observationCount: audit.observationCount, // number | null 原樣保留，不得降級為 0
-                pathsOutsideAllowlist: audit.citedPathsOutsideAllowlist,
                 hasUnverifiableSection: audit.cannotVerifySectionPresent,
-                suspectMatches: audit.suspectPhrases,
+                templatePlaceholdersFound: audit.templatePlaceholdersFound,
                 zeroSourceRead: toolCallAudit?.zeroSourceRead ?? false,
             }
             : {
                 closingLine: false,
                 observationCount: null,
-                pathsOutsideAllowlist: [],
                 hasUnverifiableSection: false,
-                suspectMatches: [],
+                templatePlaceholdersFound: [],
                 zeroSourceRead: toolCallAudit?.zeroSourceRead ?? false,
             },
     };

package/dist/messages.js

@@ -132,19 +132,15 @@ const MESSAGES = {
         budgetTriggerLabel: (trigger) => ({ total: "總量", reasoning: "推理累積", reasoning_round: "推理單輪尖峰" })[trigger],
         anomalySpikeFlag: () => "⚠ 異常尖峰・",
         noneLabel: () => "無",
-        outsideAllowlistSection: (section) => `「${section}」節`,
-        outsideAllowlistNoSection: () => "章節外",
-        outsideAllowlistSuffixNote: (suffixOf) => `；疑似 ${suffixOf} 的縮寫`,
-        outsideAllowlistEntry: (path, detail) => `${path}（${detail}）`,
         unknownUsageKeysWarning: (provider, keys) => `⚠ 未知 usage 欄位：${provider} ${keys}`,
         zeroSourceReadWarning: (n) => `⚠ 零原始碼讀取（允許 ${n} 檔）`,
         toolCallStats: (total, allowed, rejected) => `工具呼叫:${total}（允許 ${allowed}／拒絕 ${rejected}）`,
         closingLineCell: (passFail) => `收尾句:${passFail}`,
         observationCountCell: (display) => `觀察:${display}`,
         cannotCountObservations: () => "無法計數",
-        outsideAllowlistCell: (detail) => `清單外引用:${detail}`,
         cannotVerifySectionCell: (passFail) => `無法驗證欄:${passFail}`,
-        suspectPhrasesCell: (detail) => `疑似禁止內容:${detail}`,
+        templatePlaceholderEntry: (placeholder, count) => `${placeholder}×${count}`,
+        templatePlaceholdersCell: (detail) => `佔位符:${detail}`,
         auditUnavailable: () => "(無法稽核)",
         summaryHeader: (ticketId) => `# dispatch summary — ${ticketId}
 
@@ -152,6 +148,10 @@ const MESSAGES = {
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`,
         providersBundled: (formatVersion) => `出貨（formatVersion ${formatVersion}）`,
         providersExplicit: (path, formatVersion) => `外部檔 ${path}（formatVersion ${formatVersion}）`,
+        strayHeadingsWarning: (reviewChars, strayNames) => `  ⚠ _shared.md 的「# 待審段落」只有 ${reviewChars} 字，另有 ${strayNames.length} 個頂層章節：` +
+            `${strayNames.map((s) => `「# ${s}」`).join("、")}` +
+            `——待審段落可能被它們切斷了。工單以 \`#\` 切分區塊，內嵌文件若自帶 \`#\` 標題請降成 \`##\`，` +
+            `或用 \`\`\` 圍籬包起來。確認過是刻意的就忽略本行`,
         gitignoreNotIgnored: (outDir) => `  ⚠ 輸出目錄 ${outDir} 未被輸出目錄所在的 git repo 忽略`,
         gitignoreUnknown: (outDir) => `  ℹ 無法判定輸出目錄 ${outDir} 是否被 .gitignore 涵蓋（非 git repo 或 git 不可用）`,
         aboutToDispatch: (ticketId) => `即將派工 ${ticketId}：`,
@@ -199,7 +199,8 @@ const MESSAGES = {
         doctorModelListValue: (formatVersion, items) => `providers.json formatVersion ${formatVersion}：${items}`,
         doctorModelListLoadFailedValue: (reason) => `無法載入：${reason}`,
         doctorLensLine: (value) => `  lens 定義   ${value}`,
-        doctorLensFoundValue: (dirPath, count, names) => `${dirPath} 找到 ${count} 支：${names}`,
+        doctorLensFoundValue: (dirPath, total, closingCount, closingNames, noClosingSuffix) => `${dirPath} 找到 ${total} 個定義檔，其中 ${closingCount} 個具備固定收尾句：\n${" ".repeat(14)}${closingNames}${noClosingSuffix}`,
+        doctorLensNoClosingSuffix: (count, names) => `\n${" ".repeat(14)}（另 ${count} 個無收尾句：${names}）`,
         doctorLensDirMissingValue: (dirPath) => `目錄不存在：${dirPath}`,
         doctorFooter: () => "本指令不呼叫任何 API，不會花錢。缺的項目怎麼補，見 README 的〈API keys〉一節。",
     },
@@ -319,19 +320,15 @@ const MESSAGES = {
         budgetTriggerLabel: (trigger) => ({ total: "total", reasoning: "cumulative reasoning", reasoning_round: "single-round reasoning spike" })[trigger],
         anomalySpikeFlag: () => "⚠ anomalous spike - ",
         noneLabel: () => "none",
-        outsideAllowlistSection: (section) => `the "${section}" section`,
-        outsideAllowlistNoSection: () => "outside any section",
-        outsideAllowlistSuffixNote: (suffixOf) => `; possibly an abbreviation of ${suffixOf}`,
-        outsideAllowlistEntry: (path, detail) => `${path} (${detail})`,
         unknownUsageKeysWarning: (provider, keys) => `⚠ Unknown usage field(s): ${provider} ${keys}`,
         zeroSourceReadWarning: (n) => `⚠ Zero source reads (allowed ${n} file(s))`,
         toolCallStats: (total, allowed, rejected) => `Tool calls:${total} (allowed ${allowed} / rejected ${rejected})`,
         closingLineCell: (passFail) => `Closing line:${passFail}`,
         observationCountCell: (display) => `Observations:${display}`,
         cannotCountObservations: () => "uncountable",
-        outsideAllowlistCell: (detail) => `Citations outside allowlist:${detail}`,
         cannotVerifySectionCell: (passFail) => `Cannot-verify section:${passFail}`,
-        suspectPhrasesCell: (detail) => `Suspect phrases:${detail}`,
+        templatePlaceholderEntry: (placeholder, count) => `${placeholder}×${count}`,
+        templatePlaceholdersCell: (detail) => `Template placeholders:${detail}`,
         auditUnavailable: () => "(audit unavailable)",
         summaryHeader: (ticketId) => `# dispatch summary — ${ticketId}
 
@@ -339,6 +336,10 @@ const MESSAGES = {
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`,
         providersBundled: (formatVersion) => `bundled (formatVersion ${formatVersion})`,
         providersExplicit: (path, formatVersion) => `external file ${path} (formatVersion ${formatVersion})`,
+        strayHeadingsWarning: (reviewChars, strayNames) => `  ⚠ _shared.md's "# Under review" holds only ${reviewChars} characters, and ${strayNames.length} other ` +
+            `top-level heading(s) follow: ${strayNames.map((s) => `"# ${s}"`).join(", ")} — the section under review ` +
+            `may have been cut off by them. The ticket splits into sections by \`#\`; if an embedded document has its ` +
+            `own \`#\` headings, demote them to \`##\` or wrap the block in \`\`\` fences. Ignore this line if it is intended`,
         gitignoreNotIgnored: (outDir) => `  ⚠ Output directory ${outDir} is not ignored by the git repo it lives in`,
         gitignoreUnknown: (outDir) => `  ℹ Cannot determine whether output directory ${outDir} is covered by .gitignore (not a git repo, or git unavailable)`,
         aboutToDispatch: (ticketId) => `About to dispatch ${ticketId}:`,
@@ -386,7 +387,8 @@ const MESSAGES = {
         doctorModelListValue: (formatVersion, items) => `providers.json formatVersion ${formatVersion}: ${items}`,
         doctorModelListLoadFailedValue: (reason) => `failed to load: ${reason}`,
         doctorLensLine: (value) => `  Lens defs    ${value}`,
-        doctorLensFoundValue: (dirPath, count, names) => `${dirPath} holds ${count}: ${names}`,
+        doctorLensFoundValue: (dirPath, total, closingCount, closingNames, noClosingSuffix) => `${dirPath} holds ${total} definition file(s), ${closingCount} with a fixed closing line:\n${" ".repeat(15)}${closingNames}${noClosingSuffix}`,
+        doctorLensNoClosingSuffix: (count, names) => `\n${" ".repeat(15)}(${count} more without a closing line: ${names})`,
         doctorLensDirMissingValue: (dirPath) => `directory not found: ${dirPath}`,
         doctorFooter: () => 'This command calls no API and costs nothing. To fill in what is missing, see "API keys" in the README.',
     },

package/dist/output.js

@@ -114,28 +114,12 @@ function formatStatusCell(r, lang) {
     const flag = r.budgetTrigger === "reasoning_round" ? m(lang, "anomalySpikeFlag") : "";
     return `${r.status}（${flag}${label}）`;
 }
-// plan_dispatch_v2.0.md §15（二）：清單外引用附出現章節與疑似縮寫來源，讓讀者不必自己去猜
-// （issue_log_v2.0.md 2026-08-07：曾有 hub 因為裸字串誤判成稽核器的 bug，推錯了方向）。
-function formatOutsideAllowlistCell(detail, lang) {
-    if (detail.length === 0)
+// 工單 X1 v1.1 §二：模板佔位符若被留在回報裡，列出是哪幾個、各幾次；沒有命中維持既有
+// 風格印「無」。
+function formatPlaceholdersCell(hits, lang) {
+    if (hits.length === 0)
         return m(lang, "noneLabel");
-    return detail
-        .map((d) => {
-        const sectionPart = d.section ? m(lang, "outsideAllowlistSection", d.section) : m(lang, "outsideAllowlistNoSection");
-        const suffixPart = d.suffixOf ? m(lang, "outsideAllowlistSuffixNote", d.suffixOf) : "";
-        return m(lang, "outsideAllowlistEntry", d.path, `${sectionPart}${suffixPart}`);
-    })
-        .join(",");
-}
-// plan_i18n_v1.2.md §4.1：SUSPECT_PHRASES 中英兩套並存比對，summary.md 分開標示是哪一套
-// 命中——日後調整這份清單時才有資料可依據，不必再猜一次。
-function formatSuspectPhrasesDetail(a, lang) {
-    const parts = [];
-    if (a.suspectPhrasesZh.length > 0)
-        parts.push(`zh:${a.suspectPhrasesZh.join(",")}`);
-    if (a.suspectPhrasesEn.length > 0)
-        parts.push(`en:${a.suspectPhrasesEn.join(",")}`);
-    return parts.length > 0 ? parts.join(" / ") : m(lang, "noneLabel");
+    return hits.map((h) => m(lang, "templatePlaceholderEntry", h.placeholder, h.count)).join(", ");
 }
 export function buildSummaryMarkdown(ticketId, results, audits, toolCallAudits, lang) {
     const rows = results.map((r) => {
@@ -157,7 +141,7 @@ export function buildSummaryMarkdown(ticketId, results, audits, toolCallAudits,
         if (a) {
             cells.push(m(lang, "closingLineCell", a.finalLinePass ? "pass" : "fail"), 
             // v1.9 §15：null（數不出來）與 0（明確為零）須可區分，不得混印
-            m(lang, "observationCountCell", a.observationCount !== null ? String(a.observationCount) : m(lang, "cannotCountObservations")), m(lang, "outsideAllowlistCell", formatOutsideAllowlistCell(a.citedPathsOutsideAllowlistDetail, lang)), m(lang, "cannotVerifySectionCell", a.cannotVerifySectionPresent ? "pass" : "fail"), m(lang, "suspectPhrasesCell", formatSuspectPhrasesDetail(a, lang)));
+            m(lang, "observationCountCell", a.observationCount !== null ? String(a.observationCount) : m(lang, "cannotCountObservations")), m(lang, "cannotVerifySectionCell", a.cannotVerifySectionPresent ? "pass" : "fail"), m(lang, "templatePlaceholdersCell", formatPlaceholdersCell(a.templatePlaceholdersFound, lang)));
         }
         const auditCell = cells.length > 0 ? cells.join(" / ") : m(lang, "auditUnavailable");
         // plan_fixes_v1.0.md §4：無價目資料須與「估出來是 $0」區分，不能印成空白或 0——

package/dist/prompt.js

@@ -32,6 +32,19 @@ const REPORT_TEMPLATE = `# 觀察
 - <需要但讀不到的檔案，或清單不足之處>；沒有則寫「無」
 
 以上為觀察與問題，採用與否由 hub 與使用者裁決。`;
+// 工單 X1 v1.1 §二：模板要求 spoke 填空，卻沒有檢查空有沒有被填——四格產物實測中過招
+// （`<觀察>` 字面留在回報裡）。清單從這裡匯出，audit.ts 不得重打一份字串，否則模板改了
+// 檢查就會跟著失效。
+export const REPORT_PLACEHOLDERS = [
+    "<觀察>",
+    "<檔案:行號 或 明確推理>",
+    "<引用檔案時，逐字複製該處的一行原文；依據為推理時寫「推理」>",
+    "<需要但讀不到的檔案，或清單不足之處>",
+    "<observation>",
+    "<file:line, or explicit reasoning>",
+    '<when citing a file, copy that one line verbatim; write "reasoning" when the evidence is reasoning>',
+    "<files you needed but could not read, or gaps in the list>",
+];
 // plan_dispatch_v2.1.md §8（二）：工具說明只提「工單」，從未說允許清單的程式碼也要讀——
 // 零讀取的第二個成因（issue_log_v2.0.md 2026-08-07「provider 端完整 log」）。
 const TOOL_NOTE = "你有一個工具 `read_file(path)`。工單與允許讀取的程式碼檔案都不在本 prompt 中，\n須自行讀取；未讀過的檔案不得出現在「依據」中。";
@@ -70,6 +83,8 @@ function buildStep3(allowedReadsRelative, lang) {
 //
 // 但工單目錄**不保證位於 repoRoot 內**——cli.ts 明文「工單目錄仍相對 cwd 解析，不要求位於
 // repoRoot 內」。在外時轉相對會得到 ../.. 這種更難讀、也更容易被誤用的字串，故維持絕對。
+// export：稽核端（cli.ts → auditSpoke）要組出「spoke 實際會看到的那兩個工單檔路徑」，
+// 必須與這裡給 spoke 的字串同源，否則豁免會對不上（issue_log_v2.7.md 2026-08-14）。
 function displayTicketDir(ticketDir, repoRoot) {
     if (!repoRoot)
         return ticketDir;

package/dist/report.js

@@ -33,7 +33,9 @@ function formatGitignoreWarning(status, outDir, lang) {
 // （同既有 gitignore 警告），讓 lens 檔案本身的收尾句指示（如「回報最後一行固定為：...」）
 // 在真正付費呼叫之前先被人看到有沒有漂移。agentBody 已在 resolveSpokes 剝過 frontmatter，
 // 這裡再跑一次 stripFrontmatter 是冪等的（不再以 --- 開頭，regex 不命中），不需重讀檔。
-function lensClosingLineStatus(agentBody) {
+// 工單 X1 v1.1 §三：doctor.ts 的 lens 偵測要判定同一件事（檔案內文最後一句是不是固定收尾句），
+// 匯出供其重用，不得在 doctor.ts 重寫一份判定。
+export function lensClosingLineStatus(agentBody) {
     const lines = stripFrontmatter(agentBody).split(/\r?\n/).map((l) => l.trim());
     const lastNonEmpty = [...lines].reverse().find((l) => l.length > 0) ?? "";
     if (lastNonEmpty.includes(FIXED_CLOSING_LINE))
@@ -148,6 +150,11 @@ export function buildReport(ticketId, spokes, estimates, allowlistEstimates, cli
     }
     const allowedCount = spokes.reduce((s, spoke) => s + spoke.allowedReadsResolved.length, 0);
     lines.push(m(lang, "allowedReadsSummary", allowedCount, outDir));
+    // 2026-08-15：待審段落疑似被切斷的警告，排在 gitignore 警告之前——後者關係到產物落在哪，
+    // 前者關係到這次派工有沒有意義（付全額、審半份）。
+    if (meta.strayHeadings.length > 0) {
+        lines.push(m(lang, "strayHeadingsWarning", meta.reviewTextChars, meta.strayHeadings));
+    }
     const gitignoreWarning = formatGitignoreWarning(meta.gitignoreStatus, outDir, lang);
     if (gitignoreWarning)
         lines.push(gitignoreWarning);

package/dist/ticket.js

@@ -63,18 +63,42 @@ export function stripFrontmatter(markdown) {
     const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
     return (match ? match[1] : markdown).trim();
 }
+// 工單 X1 v1.1 §一：圍籬內的行一律不視為標題比對對象，避免內嵌規劃書的 code block
+// 挾帶行首 `#` 把待審段落（或回報稽核）切斷。
+function matchFence(line) {
+    const match = line.match(/^\s*(`{3,}|~{3,})/);
+    if (!match)
+        return null;
+    return { char: match[1][0], len: match[1].length };
+}
 // 匯出供 audit.ts 重用（回報模板同樣是 `# 標題` 結構）。
 export function splitTopLevelSections(markdown) {
     const lines = markdown.split(/\r?\n/);
     const sections = new Map();
     let currentHeading = null;
     let buffer = [];
+    let openFence = null;
     const flush = () => {
         if (currentHeading !== null) {
             sections.set(currentHeading, buffer.join("\n").trim());
         }
     };
     for (const line of lines) {
+        const fence = matchFence(line);
+        if (openFence) {
+            if (fence && fence.char === openFence.char && fence.len >= openFence.len) {
+                openFence = null;
+            }
+            if (currentHeading !== null)
+                buffer.push(line);
+            continue;
+        }
+        if (fence) {
+            openFence = fence;
+            if (currentHeading !== null)
+                buffer.push(line);
+            continue;
+        }
         const match = line.match(/^#\s+(.+?)\s*$/);
         if (match) {
             flush();
@@ -94,6 +118,12 @@ function parseBulletList(body) {
         .map((l) => l.match(/^-\s+(.+)$/)?.[1]?.trim())
         .filter((v) => Boolean(v && v.length > 0));
 }
+// `_shared.md` 裡「前提／待審段落」以外的頂層章節。判準與下方中止路徑共用同一份
+// ——2026-08-15 的清查證實它可靠：tmp/dispatch 底下 21 份真實工單，12 份中招全中、
+// 9 份正常零誤報。
+function findStrayHeadings(sections) {
+    return [...sections.keys()].filter((k) => k !== "待審段落" && k !== "Under review" && !k.startsWith("前提") && k !== "Premises");
+}
 // §4：`_shared.md`。「待審段落」缺失或空即中止；「前提」缺失為警告（空前提合法）。
 export function parseSharedDoc(markdown, lang) {
     const sections = splitTopLevelSections(markdown);
@@ -104,7 +134,7 @@ export function parseSharedDoc(markdown, lang) {
         // 原訊息「缺或內容為空」會讓人先去查自己有沒有寫，方向就錯了。標題存在卻空白時，
         // 直接指名是誰切斷了它。
         if (sections.has("待審段落") || sections.has("Under review")) {
-            const stray = [...sections.keys()].filter((k) => k !== "待審段落" && k !== "Under review" && !k.startsWith("前提") && k !== "Premises");
+            const stray = findStrayHeadings(sections);
             if (stray.length > 0) {
                 throw new DispatchError(m(lang, "strayHeadingsCutReviewSection", stray), 2);
             }
@@ -113,7 +143,13 @@ export function parseSharedDoc(markdown, lang) {
     }
     const premisesBody = sections.get("前提（不受審）") ?? sections.get("前提") ?? sections.get("Premises");
     const premises = premisesBody ? parseBulletList(premisesBody) : [];
-    return { premises, reviewText };
+    // 2026-08-15：**上面那道防護只擋得住「整段被切光」。** 切在段落中間時 reviewText 非空，
+    // 先前一路靜默放行——tmp/dispatch 的 12 份 i18n 翻譯審查工單就是這樣派出去的，
+    // 待審段落最短只剩 25 字元（引言句），中文原文全被切走，而允許清單裡只有英文譯文，
+    // spoke 手上沒有可比對的原文。$0.1780、12 次派工、結論全部無效，稽核六格沒有一格會說。
+    // 這裡只記錄，警告由 report.ts 在付費前的報表印出——非空時無法斷定是不是刻意的，
+    // 中止會擋掉合法用法。
+    return { premises, reviewText, strayHeadings: findStrayHeadings(sections) };
 }
 // §4：`<agent>.md`。「具體問題」缺失或空即中止；「允許讀取」缺失為警告（空清單合法）。
 export function parseAgentTicket(markdown, lang) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dowafu",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Send a section of your design doc to external LLMs for review. They read only the files you whitelist, and nothing is billed until you confirm.",
   "keywords": [
     "llm",