@@ -0,0 +8,4 @@
+const LEVEL_LABEL = { critical: '嚴重', warning: '警告', info: '建議' };
+const LEVEL_ORDER = ['critical', 'warning', 'info'];
+// 預先把等級對應到排序索引，bySeverity 排序時直接 O(1) 取值，省去每次比較的 includes + indexOf 掃描。
+const LEVEL_RANK = new Map(LEVEL_ORDER.map((level, index) => [level, index]));

@@ -0,0 +22,4 @@
+function findingRow(f) {
+  if (!f) return '';
+  return `| ${LEVEL_EMOJI[f.level] || ''} ${LEVEL_LABEL[f.level] || f.level} | ${f.role} | ${f.location} | ${f.suggestion} |`;
+}

@@ -0,0 +123,4 @@
+ * 過濾出新問題（is_new 不等於 false 者）。
+ *
+ * @param {Array<{ is_new?: boolean }>} findings 審查問題陣列。
+ * @returns {Array<object>} 新問題子集合。

@@ -0,0 +1,127 @@
+import https from 'https';
+import fs from 'fs';
+import { execFileSync } from 'child_process';
+

@@ -0,0 +4,4 @@
+
+// 本 action 會連接自架 Gitea / OpenCode，部署環境可能使用內部 CA 或自簽憑證。
+// 對外部服務請優先使用預設 TLS 驗證；需要內部服務相容時才使用 getInsecureHttpsAgent()。
+process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';

@@ -0,0 +50,4 @@
+ *          停用憑證驗證有中間人攻擊風險，僅限受信任的內部環境使用。
+ * @returns {import('https').Agent} 已關閉憑證驗證的 HTTPS Agent 單例。
+ */
+let _insecureHttpsAgent = null;

@@ -0,0 +1,581 @@
+import fs from 'fs';
+import path from 'path';
+import { chatJSON } from './llm.js';
+import { buildAnalysisPrompt, loadRole, buildVerdictPrompt, buildLocateLinePrompt } from './roles.js';

@@ -0,0 +11,4 @@
+ * 用單一角色分析 diff，回傳 findings 陣列。
+ * role 欄位一律以角色定義的 name 為準，避免 LLM 自行填入不一致的名稱。
+ */
+export async function analyzeWithRole(role, diff) {

@@ -0,0 +101,4 @@
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+/**

@@ -0,0 +135,4 @@
+  return cleanText(value)
+    .normalize('NFKC')
+    .replace(/[\p{P}\p{S}\s]+/gu, '')
+    .trim();

@@ -0,0 +333,4 @@
+/**
+ * AI 呼叫失敗時的統一降級處理
+ */
+function fallback(label, findings, e) {

@@ -0,0 +378,4 @@
+    pending += 1;
+    const systemPrompt = buildLocateLinePrompt(getRole(f.role) || { name: f.role });
+    const userContent = `${JSON.stringify({ file, problem: f.problem, suggestion: f.suggestion })}\n\n--- ${file} Git Diff ---\n${extractFileDiff(diff, file)}`;
+    let located = null;

@@ -0,0 +379,4 @@
+    const systemPrompt = buildLocateLinePrompt(getRole(f.role) || { name: f.role });
+    const userContent = `${JSON.stringify({ file, problem: f.problem, suggestion: f.suggestion })}\n\n--- ${file} Git Diff ---\n${extractFileDiff(diff, file)}`;
+    let located = null;
+    for (let attempt = 1; attempt <= maxAttempts && located == null; attempt++) {

@@ -0,0 +413,4 @@
+/**
+ * 呼叫 LLM 進行語意去重，失敗時降級回傳原始 findings
+ */
+export async function deduplicateWithAI(findings) {

@@ -0,0 +427,4 @@
+      return result.map(r => origMap.get(`${r.location}|${String(r.suggestion).slice(0, 50)}`) ?? r);
+    }
+    throw new Error('AI 回傳空陣列');
+  } catch (e) {

@@ -0,0 +463,4 @@
+    line(`讀取排除問題檔案: ${fullPath}`);
+    line(`來源分支狀態: branch=${branch} commit=${shortSha} commit_time=${commitTime}`);
+    line(`檔案資訊: bytes=${stat.size} mtime=${formatFileTime(stat.mtimeMs)} raw=${rawCount} normalized=${exclusions.length} path=${path.relative(workspace, fullPath) || fullPath}`);
+    if (sourceFormat !== 'array') {

@@ -0,0 +468,4 @@
+      if (mirrorWorkspace && path.resolve(mirrorWorkspace) !== path.resolve(workspace)) {
+        const mirrorPath = path.join(mirrorWorkspace, EXCLUSIONS_PATH);
+        fs.mkdirSync(path.dirname(mirrorPath), { recursive: true });
+        writeCanonicalExclusions(mirrorPath, normalizedSource);

@@ -0,0 +223,4 @@
+
+  try {
+    await withAskpass(workspace, async credEnv => {
+      run(['config', 'user.email', 'ai-review[bot]@gitea'], repoDir);

@@ -0,0 +1,294 @@
+import axios from 'axios';
+import { GITEA_TOKEN, GITEA_COMMENT_TOKEN, GITEA_SERVER_URL, GITEA_REPOSITORY, PR_NUMBER, PR_HEAD_SHA, PR_HEAD_BRANCH, getInsecureHttpsAgent } from './config.js';

@@ -0,0 +92,4 @@
+  try {
+    const resp = await axios.get(api(`/repos/${GITEA_REPOSITORY}/branches/${encodeURIComponent(branch)}`), {
+      headers: headers(),
+      timeout: 30000,

@@ -0,0 +236,4 @@
+/**
+ * 取得目前 PR 上所有 review 的行內 comment 並展平為單一陣列。
+ * 單一 review 取 comment 失敗時記錄警告並略過，不中斷整體流程；最後輸出統計日誌。
+ * @returns {Promise<object[]>} 所有行內 comment 的展平陣列。

@@ -0,0 +10,4 @@
+ * 並去除前後空白，使內容可直接交給 JSON.parse。
+ *
+ * 屬純函式、無副作用；常用於將 LLM 回傳結果正規化後再行解析。
+ *

@@ -0,0 +88,4 @@
+        reject(new Error(`${provider} CLI 逾時 (${timeout}ms)`));
+      }, timeout);
+
+      const append = (kind, chunk) => {

@@ -0,0 +1,229 @@
+import path from 'path';
+import { GITEA_REPOSITORY, PR_NUMBER, PR_HEAD_BRANCH, PR_BASE_BRANCH, getLLMConfig, FINDINGS_PATH, EXCLUSIONS_PATH } from './config.js';

@@ -0,0 +15,4 @@
+
+/**
+ * AI Code Review Pipeline 的總指揮（orchestrator）。
+ *

@@ -0,0 +33,4 @@
+ * 流程階段（Step1~Step11）：
+ * - Step1 啟動：讀取 repo / PR / 分支等基本參數。
+ * - Step2 前置驗證：`runPreflight`，未通過則 exit 1。
+ * - Step3 自動提交檢查：偵測上輪 bot `[failure]`（exit 1）或本次為 bot 自動提交（exit 0 跳過）。

@@ -0,0 +115,4 @@
+  }
+  input(`LLM=${provider}/${model}；角色=[${roles.map(r => r.name).join(', ')}]；diff=${diff.length} 字元`);
+  try {
+    await postComment(getRoleIntro(roles) + `\n\n> 🔍 服務：${provider}  模型：${model}`);

@@ -0,0 +129,4 @@
+      newFindings.push(...findings);
+    } catch (e) {
+      warn(`[${role.name}] 分析失敗（跳過）: ${e.message}`);
+    }

@@ -0,0 +163,4 @@
+  step('Step7', '排除規則與誤報過濾');
+  if (reconcile.excludedFindings.length > 0) {
+    // 以 repoDir 為主（即將提交回去的來源分支副本），WORKSPACE 為鏡像；
+    // 順序須與下方 loadExclusions 一致，否則會讀到空的 WORKSPACE 而把既有排除規則覆蓋掉。

@@ -0,0 +218,4 @@
+    result(false, `發現 ${criticalCount} 個嚴重問題，workflow 失敗（exit 1）`);
+    section('Pipeline 結束');
+    process.exit(1);
+  }

@@ -0,0 +89,4 @@
+      const finding = parseBotReviewComment(body);
+      if (finding) g.botFinding = { ...finding, location: lineNum ? `${filePath}:${lineNum}` : filePath };
+    }
+  }

@@ -0,0 +250,4 @@
+    line: c.line,
+    thread: c.thread,
+    code: codeWindow(fileCache.get(c.path) || '', c.line),
+  }));

@@ -0,0 +4,4 @@
+import yaml from 'js-yaml';
+import { warn } from './log.js';
+
+const ROLES_DIR = path.join(fileURLToPath(import.meta.url), '..', 'prompts', 'roles');

@@ -0,0 +37,4 @@
+}
+
+/**
+ * 取得 finding 等級的人類可讀字串（emoji + 中文標籤），已去除頭尾空白。

@@ -0,0 +208,4 @@
+    path: loc.file,
+    body: reviewCommentBody(f),
+    new_position: loc.line,
+  };

@@ -0,0 +28,4 @@
+// 取值優先序：有對應 `with:` 輸入的欄位一律 INPUT_* 優先（使用端明確傳入的值最權威，
+// 蓋過環境中剛好存在的 ambient env）→ 專用 env（相容舊 Docker 版與測試）→ 內建預設。
+// 無對應輸入的欄位（server url / repository / PR_*）則走專用 env → runner 內建 / 事件 payload。
+// 使用端 workflow 只需傳 `with: token`。

@@ -0,0 +108,4 @@
+ * @returns {string} 正規化後、以單一空白分隔的字串（可能為空字串）。
+ * @remarks 用於 finding 與排除條目文字的雙向「包含」比對（applyExclusions、appendExclusions）。
+ *          因為比對常對同一段文字重複呼叫（findings × exclusions 笛卡爾積），
+ *          以模組層級 Map 對「字串輸入」做 memoization，避免重複跑 NFKC／正則替換。

@@ -0,0 +379,4 @@
+    const systemPrompt = buildLocateLinePrompt(getRole(f.role) || { name: f.role });
+    const userContent = `${JSON.stringify({ file, problem: f.problem, suggestion: f.suggestion })}\n\n--- ${file} Git Diff ---\n${extractFileDiff(diff, file)}`;
+    let located = null;
+    for (let attempt = 1; attempt <= maxAttempts && located == null; attempt++) {

@@ -0,0 +410,4 @@
+  return findings.map(({ level, role, location, problem, suggestion }) => ({ level, role, location, problem, suggestion }));
+}
+
+/**

@@ -0,0 +219,4 @@
+ */
+export async function commitAndPush(workspace, repoDir, _spawnSync = spawnSync, _sourceRoot = null, reviewOutcome = 'success') {
+  const run = makeRunner(_spawnSync);
+  const pushToken = GITEA_COMMENT_TOKEN || GITEA_TOKEN;

@@ -0,0 +83,4 @@
+
+/**
+ * 取得指定分支 head commit 的訊息（先查 `GET /repos/{repo}/branches/{branch}` 取 SHA，再查該 commit）。
+ * 失敗或 branch 為空時不拋例外，記錄警告並回傳空字串。

@@ -0,0 +85,4 @@
+ * @param {string} fullPath 欲驗證的 JSON 檔案完整路徑。
+ * @param {string} label 檔案標籤，用於日誌與提示訊息。
+ * @param {(fullPath: string, label: string, rawText: string) => Promise<string>} [repairer=repairJSONArrayWithAI]
+ *   可注入的修復函式，預設使用 repairJSONArrayWithAI；便於測試替換。

@@ -0,0 +18,4 @@
+    '</system>',
+    '',
+    '<user>',
+    userContent,

@@ -0,0 +63,4 @@
+  const stderr = String(e.stderr || '').trim();
+  const stdout = String(e.stdout || '').trim();
+  return extractMeaningfulError(stderr || stdout || e.message || String(e));
+}

@@ -0,0 +41,4 @@
+ * - Step7 過濾：套用排除規則 + 防守方 AI 誤報裁決。
+ * - Step8 發布：寫入 findings、組裝使用量，發布 Gitea Review（失敗則降級繼續）。
+ * - Step9 JSON 驗證：驗證 findings/exclusions 檔，格式錯誤 exit 1，缺檔則建立空陣列檔。
+ * - Step10 記憶區 commit/push：依是否有 critical 計算 reviewOutcome 後推回來源分支。

@@ -0,0 +51,4 @@
+ * 降級處理：Step4 對話收斂、Step5 角色介紹 comment 與個別角色分析、Step6 clone repo、
+ * Step8 Review 發布等非致命步驟失敗時，僅 `warn` 後繼續執行。
+ */
+async function main() {

@@ -0,0 +95,4 @@
+
+  // Step5 角色分析：載入角色、取 diff，讓各角色平行產生 findings
+  step('Step5', '角色分析產生 findings');
+  const { provider, apiKeys, baseURL, model } = getLLMConfig();

@@ -0,0 +149,4 @@
+    data = await resp.json();
+  } catch (e) {
+    return { ok: false, error: `codex 模型清單回應解析失敗: ${e.message}` };
+  }

@@ -0,0 +180,4 @@
+/**
+ * 對話收斂主流程：取得 PR 所有行內 review comment，
+ * 先把**每一個未解決的 comment**（依 comment id 去重，含無 path／position 者）一律呼叫 Gitea resolve API 關閉
+ * （findings.json 為唯一待辦來源，下次 review 依其重貼 comment）；

@@ -0,0 +210,4 @@
+  // 要關閉的 comment：有 id 且尚未被 resolve（不依賴 path|line 分組，確保每個獨立 thread 都關到，含無 path／position 者）
+  const unresolvedCommentIds = [...new Set(
+    (comments || []).filter(c => c?.id != null && !c?.resolver).map(c => c.id),
+  )];

@@ -0,0 +99,4 @@
+ */
+function reviewCommentBody(f) {
+  return [
+    `**嚴重等級**：${levelText(f)}`,

@@ -0,0 +230,4 @@
+  const comments = sortedComments.filter(f => f.is_new !== false).map(toReviewComment).filter(Boolean);
+  const body = buildReviewSummary(summaryFindings, usageSection);
+  try {
+    await postReview({ body, comments });

@@ -0,0 +263,4 @@
+  for (const targetDir of targets) {
+    const fullPath = path.join(targetDir, FINDINGS_PATH);
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+    fs.writeFileSync(fullPath, JSON.stringify(findings, null, 2) + '\n', 'utf8');

@@ -0,0 +24,4 @@
+
+const EVENT = readEventPayload();
+const PR = EVENT.pull_request || {};
+

@@ -0,0 +224,4 @@
+    if (group.samples.length < 2 && exclusion.text) group.samples.push(exclusion.text);
+  }
+
+  return [...groups.values()]

@@ -0,0 +274,4 @@
+      if (group.paths.length > 0) parts.push(`paths=${group.paths.join(', ')}`);
+      if (group.roles.length > 0) parts.push(`roles=${group.roles.join(', ')}`);
+      if (group.samples.length > 0) parts.push(`samples=${group.samples.join(' | ')}`);
+      return `- ${parts.join(' ; ')}`;

@@ -0,0 +290,4 @@
+  };
+}
+
+/**

@@ -0,0 +349,4 @@
+  const m = /^(.+?):(\d+)(?:-\d+)?$/.exec(s);
+  return m ? Number(m[2]) : null;
+}
+

@@ -0,0 +390,4 @@
+    }
+    if (located != null) {
+      f.location = `${file}:${located}`;
+      resolved += 1;

@@ -0,0 +439,4 @@
+
+/**
+ * 讀取排除問題檔案（從來源分支的 cloned repoDir 中的 EXCLUSIONS_PATH）
+ */

@@ -0,0 +63,4 @@
+  return String(text || '')
+    .split('\n')
+    .map(l => l.trim())
+    .filter(l => l && !l.startsWith('#'));

@@ -0,0 +66,4 @@
+    process.exit(1);
+  }
+
+  // Step3 自動提交檢查：判斷本次 PR head 是否為 bot 自動提交

@@ -0,0 +85,4 @@
+    const body = typeof c?.body === 'string' ? c.body : '';
+    if (body) g.bodies.push(body);
+    if (c?.resolver) g.resolved = true;
+    if (!g.botFinding) {

@@ -0,0 +168,4 @@
+ * @returns {string} 形如 `新: 嚴重1 / 警告0 / 建議2 / 無法標示0；舊: ...` 的單行字串。
+ * @remarks 供 {@link postFindingsReview} 在 log 輸出統計時呼叫。內容與 {@link formatFindingsStats} 一致，僅格式為單行純文字。
+ */
+export function formatFindingsStatsLine(findings) {

@@ -0,0 +211,4 @@
+  };
+}
+
+/**

@@ -0,0 +1,588 @@
+import fs from 'fs';

@@ -0,0 +319,4 @@
+    return true;
+  });
+  const merged = [...oldFindings, ...deduped];
+  ok(`合併結果: 舊=${oldFindings.length} 新(去重後)=${deduped.length} 總計=${merged.length}`);

@@ -0,0 +110,4 @@
+      const normalized = repaired.endsWith('\n') ? repaired : `${repaired}\n`;
+      // 先驗證修復結果是否為合法 JSON；無效就在寫檔前丟出，避免用毀損內容覆寫原檔。
+      JSON.parse(normalized);
+      fs.writeFileSync(fullPath, normalized, 'utf8');

@@ -0,0 +53,4 @@
+    '<user>',
+    userContent,
+    '</user>',
+  ].join('\n');

@@ -0,0 +14,4 @@
+
+const WORKSPACE = process.env.GITHUB_WORKSPACE || '/workspace';
+
+/**

@@ -0,0 +155,4 @@
+    warn(`clone repo 失敗（繼續執行）: ${e.message}`);
+  }
+  const repoState = repoDir ? getRepoState(repoDir) : null;
+  if (repoState) line(`repo: branch=${repoState.branch || 'detached'} commit=${repoState.shortSha || 'unknown'}`);

@@ -0,0 +71,4 @@
+ * 對話只要任一則 comment 帶有 resolver 即視為已解決；同時嘗試解析出該對話對應的 bot finding。
+ */
+export function groupConversations(comments) {
+  const groups = new Map();

@@ -0,0 +198,4 @@
+  let comments;
+  try {
+    comments = await listComments();
+  } catch (e) {

@@ -0,0 +209,4 @@
+export async function fetchAccountQuota(provider, config = {}, deps = {}) {
+  const get = deps.get || axios.get;
+  const strategy = QUOTA_STRATEGIES[provider];
+  if (!strategy) return { available: false, reason: `未支援 ${provider} 額度查詢` };

@@ -0,0 +18,4 @@
+ *   `role`、`location`、`suggestion` 直接內嵌字串（未定義時會輸出 undefined 字樣）。傳入 null/undefined 時回傳空字串（已防呆，不會拋例外）。
+ * @returns {string} 形如 `| 🔴 嚴重 | role | location | suggestion |` 的表格列字串；`f` 為空值時回傳空字串。
+ * @remarks 內部輔助函式，供 {@link buildTable} 逐列組裝表格使用，本身不含換行。
+ */

@@ -0,0 +72,4 @@
+  return { file: match[1], line: Number(match[2]) };
+}
+
+/** 行內 comment 內容：等級／審查員／建議 */

@@ -0,0 +150,4 @@
+export function formatFindingsStats(findings) {
+  const oldFindings = findings.filter(f => f.is_new === false);
+  const newFindings = newFindingsOnly(findings);
+  const row = (label, items) => `| ${label} | ${countBy(items, f => f.level === 'critical')} 筆 | ${countBy(items, f => f.level === 'warning')} 筆 | ${countBy(items, f => f.level === 'info')} 筆 | ${countBy(items, isUnclassified)} 筆 |`;

@@ -0,0 +183,4 @@
+ * @returns {string} review 本文（Markdown）。
+ * @remarks 內部輔助函式，供 {@link postFindingsReview} 產生整批 review 的 body。
+ */
+function buildReviewSummary(findings, usageSection = '') {

@@ -0,0 +264,4 @@
+    const fullPath = path.join(targetDir, FINDINGS_PATH);
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+    fs.writeFileSync(fullPath, JSON.stringify(findings, null, 2) + '\n', 'utf8');
+    ok(`findings 寫入: ${fullPath} (${findings.length} 筆)`);

@@ -0,0 +13,4 @@
+ */
+export async function analyzeWithRole(role, diff) {
+  line(`[${role.name}] 開始分析`);
+  const findings = await chatJSON(buildAnalysisPrompt(role), `以下是 Git Diff 內容：\n\n${diff}`);

@@ -0,0 +88,4 @@
+function formatFileTime(mtimeMs) {
+  if (!Number.isFinite(mtimeMs)) return 'unknown';
+  return new Date(mtimeMs).toISOString();
+}

@@ -0,0 +199,4 @@
+ * 將排除條目依 textKey 分組統計，產生供 AI prompt 使用的群組摘要（含出現次數、涉及路徑與角色、樣本）。
+ *
+ * @param {Array<object>} exclusions - 已正規化（含 textKey、filePath、role、text、fingerprint）的排除條目。
+ * @returns {Array<{text: string, count: number, paths: string[], roles: string[], samples: string[]}>}

@@ -0,0 +246,4 @@
+function buildExclusionContext(exclusions) {
+  if (exclusions.length === 0) {
+    return {
+      rawCount: 0,

@@ -0,0 +300,4 @@
+    const stat = fs.statSync(fullPath);
+    line(`讀取舊 findings 檔案: ${fullPath}`);
+    line(`舊 findings 檔案資訊: bytes=${stat.size} mtime=${formatFileTime(stat.mtimeMs)} path=${path.relative(workspace, fullPath) || fullPath}`);
+  } else {

@@ -0,0 +403,4 @@
+/**
+ * 將 findings 精簡為僅含 level、role、location、problem、suggestion 的物件，移除多餘欄位以節省 token。
+ *
+ * @param {Array<object>} findings - 完整 findings 陣列。

@@ -0,0 +423,4 @@
+    const result = await chatJSON(systemPrompt, JSON.stringify(toAIPayload(findings)));
+    // 去重結果數量不得超過輸入（避免 LLM 無中生有），且每筆都必須能對應回原始 finding。
+    if (Array.isArray(result) && result.length > 0 && result.length <= findings.length) {
+      const keyOf = f => `${f.location}|${String(f.suggestion).slice(0, 50)}`;

@@ -0,0 +68,4 @@
+
+/**
+ * 從被審 PR 的 head ref 取得 `.reviewignore` 並解析為排除清單。
+ * 檔案不存在或為空時退回 {@link DEFAULT_REVIEW_IGNORE}。

@@ -0,0 +115,4 @@
+
+/**
+ * 取得指定分支 head commit 的訊息（先查 `GET /repos/{repo}/branches/{branch}` 取 SHA，再查該 commit）。
+ * 失敗或 branch 為空時不拋例外，記錄警告並回傳空字串。

@@ -0,0 +14,4 @@
+/**
+ * 對 items 並行執行 async fn（保序回傳），加速多個獨立的 LLM 子行程呼叫。
+ *
+ * limit 為同時執行上限；`limit <= 0`、非數字或大於項目數時「不限制」（全部並行）。

@@ -0,0 +28,4 @@
+ * @returns {Promise<void>} 流程正常走完（無嚴重問題）時 resolve；多數結束路徑會直接
+ *   呼叫 `process.exit()` 結束程序，函式不會以回傳值回報審查結果。
+ * @throws {Error} 內部未被個別 try/catch 攔截的未預期例外會向上拋出，
+ *   由頂層 `main().catch(...)` 接住並以 `process.exit(1)` 結束。

@@ -0,0 +123,4 @@
+  let auth;
+  try {
+    auth = JSON.parse(fs.readFileSync(authPath, 'utf8'));
+  } catch (e) {

@@ -0,0 +51,4 @@
+export function parseBotReviewComment(body) {
+  if (typeof body !== 'string' || !body.includes('**')) return null;
+  const normalized = body.replace(/\r\n/g, '\n');
+  const levelRaw = fieldValue(normalized, '嚴重等級') || fieldValue(normalized, '等級');

@@ -0,0 +88,4 @@
+    if (!g.botFinding) {
+      const finding = parseBotReviewComment(body);
+      if (finding) g.botFinding = { ...finding, location: lineNum ? `${filePath}:${lineNum}` : filePath };
+    }

@@ -0,0 +166,4 @@
+}
+
+/**
+ * 安全守衛：判定路徑是否為 repo 內的相對路徑（拒絕絕對路徑、Windows 磁碟機前綴與含 `..` 的路徑穿越）。

@@ -0,0 +225,4 @@
+  if (open.length === 0) {
+    ok(`對話收斂完成: 關閉 comment=${closedCount} 已修復=0 誤報=0 仍成立=0`);
+    return { ...EMPTY, closedCount };
+  }

@@ -0,0 +38,4 @@
+ * 結果快取於模組層級（`cachedRoles`），同一程序生命週期內只讀檔一次；之後即使
+ * 角色檔有變動也不會重新載入，需重啟程序才會生效。單一檔案解析失敗（壞 YAML、
+ * 缺 frontmatter 等）只記錄警告並略過，不會中斷其他角色的載入。
+ *

@@ -0,0 +178,4 @@
+        '',
+        role.body,
+      ]
+    : ['你是 🛡️ Paladin（聖騎士），公正的裁判。不冤枉無辜的程式碼，也不放水。'];