dowafu 0.1.0 → 0.3.0

package/dist/ticket.js

@@ -3,6 +3,7 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { DispatchError } from "./types.js";
+import { m } from "./messages.js";
 const FORMAT_MARKER = "<!-- format: v1 -->";
 function splitTableRow(line) {
     const trimmed = line.trim().replace(/^\|/, "").replace(/\|$/, "");
@@ -12,15 +13,15 @@ function isSeparatorRow(cells) {
     return cells.length > 0 && cells.every((c) => /^:?-{2,}:?$/.test(c));
 }
 // §4：`_dispatch.md`。model/provider/agent 必填，無預設值；留白或寫 "default" 視為缺失。
-export function parseDispatchTable(markdown) {
+export function parseDispatchTable(markdown, lang) {
     const lines = markdown.split(/\r?\n/);
     const firstNonBlank = lines.find((l) => l.trim().length > 0);
     if (firstNonBlank?.trim() !== FORMAT_MARKER) {
-        throw new DispatchError(`_dispatch.md 首行須為 ${FORMAT_MARKER}，實際為：${firstNonBlank?.trim() ?? "(空白)"}`, 2);
+        throw new DispatchError(m(lang, "formatMarkerMismatch", FORMAT_MARKER, firstNonBlank?.trim() ?? m(lang, "blankPlaceholder")), 2);
     }
     const headerIndex = lines.findIndex((l) => /^\s*\|\s*agent\s*\|/i.test(l));
     if (headerIndex === -1 || !isSeparatorRow(splitTableRow(lines[headerIndex + 1] ?? ""))) {
-        throw new DispatchError("_dispatch.md 找不到派工表（缺 | agent | ... | 表頭或分隔列）", 2);
+        throw new DispatchError(m(lang, "dispatchTableMissingHeader"), 2);
     }
     const headerCells = splitTableRow(lines[headerIndex]).map((c) => c.toLowerCase());
     const rows = [];
@@ -39,15 +40,21 @@ export function parseDispatchTable(markdown) {
         const effort = get("effort");
         const isMissing = (v) => v.length === 0 || v.toLowerCase() === "default";
         if (isMissing(agent) || isMissing(provider) || isMissing(model)) {
-            throw new DispatchError(`_dispatch.md 第 ${i + 1} 行缺 agent/provider/model 必填欄位（留白或寫 "default" 視為缺失）：${line}`, 2);
+            throw new DispatchError(m(lang, "dispatchRowMissingFields", i + 1, line), 2);
         }
         rows.push({ agent, provider, model, effort: effort.length > 0 ? effort : undefined });
     }
     if (rows.length === 0) {
-        throw new DispatchError("_dispatch.md 派工表沒有任何資料列", 2);
+        throw new DispatchError(m(lang, "dispatchTableEmpty"), 2);
     }
     return rows;
 }
+// plan_i18n_v1.2.md §6.2：「讀檔 → 剝 frontmatter → trim」這個片段跨多處共用（原為
+// validate.ts 私有），放這裡不產生循環——audit.ts 已經 import 本檔。
+export function stripFrontmatter(markdown) {
+    const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
+    return (match ? match[1] : markdown).trim();
+}
 // 匯出供 audit.ts 重用（回報模板同樣是 `# 標題` 結構）。
 export function splitTopLevelSections(markdown) {
     const lines = markdown.split(/\r?\n/);
@@ -80,7 +87,7 @@ function parseBulletList(body) {
         .filter((v) => Boolean(v && v.length > 0));
 }
 // §4：`_shared.md`。「待審段落」缺失或空即中止；「前提」缺失為警告（空前提合法）。
-export function parseSharedDoc(markdown) {
+export function parseSharedDoc(markdown, lang) {
     const sections = splitTopLevelSections(markdown);
     const reviewText = sections.get("待審段落") ?? sections.get("Under review");
     if (!reviewText || reviewText.length === 0) {
@@ -91,37 +98,32 @@ export function parseSharedDoc(markdown) {
         if (sections.has("待審段落") || sections.has("Under review")) {
             const stray = [...sections.keys()].filter((k) => k !== "待審段落" && k !== "Under review" && !k.startsWith("前提") && k !== "Premises");
             if (stray.length > 0) {
-                throw new DispatchError(`_shared.md 的「# 待審段落」有標題但內容為空——被後面這些 \`#\` 標題切斷了：` +
-                    `${stray.map((s) => `「# ${s}」`).join("、")}。` +
-                    `工單以 \`#\` 切分區塊，內嵌的規劃書若自帶 \`#\` 標題請降成 \`##\`。` +
-                    `（注意：在「# 待審段落」下面補一行文字雖然能通過檢查，但規劃書本體仍會留在` +
-                    `後面那個區塊裡，spoke 收到的待審段落等於是空的。）`, 2);
+                throw new DispatchError(m(lang, "strayHeadingsCutReviewSection", stray), 2);
             }
         }
-        throw new DispatchError('_shared.md 缺「# 待審段落」（或英文工單的「# Under review」）或內容為空', 2);
+        throw new DispatchError(m(lang, "missingReviewSection"), 2);
     }
     const premisesBody = sections.get("前提（不受審）") ?? sections.get("前提") ?? sections.get("Premises");
     const premises = premisesBody ? parseBulletList(premisesBody) : [];
     return { premises, reviewText };
 }
 // §4：`<agent>.md`。「具體問題」缺失或空即中止；「允許讀取」缺失為警告（空清單合法）。
-export function parseAgentTicket(markdown) {
+export function parseAgentTicket(markdown, lang) {
     const sections = splitTopLevelSections(markdown);
-    // 先中文後英文。命中哪一套就是這份工單的語言——不看內文，只看標記，因為內文可能
-    // 中英混雜（英文規劃書配中文問題是常見寫法），標記則是作者明確選的。
+    // 先中文後英文：命中哪一套只決定用哪一組欄位鍵去讀值——不再代表語言選擇，語言改由
+    // run-level `--lang` 決定（見上方型別註解、plan_i18n_v1.3.md §一之5）。
     const zhQuestions = sections.get("具體問題");
     const enQuestions = sections.get("Questions");
-    const lang = zhQuestions !== undefined ? "zh" : enQuestions !== undefined ? "en" : "zh";
     const questions = zhQuestions ?? enQuestions;
     if (!questions || questions.length === 0) {
-        throw new DispatchError('<agent>.md 缺「# 具體問題」（或英文工單的「# Questions」）或內容為空', 2);
+        throw new DispatchError(m(lang, "missingQuestionsSection"), 2);
     }
     const allowedBody = sections.get("允許讀取") ?? sections.get("Allowed reads");
     const allowedReads = allowedBody ? parseBulletList(allowedBody) : [];
-    return { questions, allowedReads, lang };
+    return { questions, allowedReads };
 }
 // 檔案系統存取層：讀工單目錄、組出完整 Ticket。
-export async function loadTicket(ticketDir) {
+export async function loadTicket(ticketDir, lang) {
     const dispatchPath = path.join(ticketDir, "_dispatch.md");
     const sharedPath = path.join(ticketDir, "_shared.md");
     let dispatchText;
@@ -129,17 +131,17 @@ export async function loadTicket(ticketDir) {
         dispatchText = await readFile(dispatchPath, "utf8");
     }
     catch {
-        throw new DispatchError(`找不到 ${dispatchPath}`, 2);
+        throw new DispatchError(m(lang, "fileNotFound", dispatchPath), 2);
     }
     let sharedText;
     try {
         sharedText = await readFile(sharedPath, "utf8");
     }
     catch {
-        throw new DispatchError(`找不到 ${sharedPath}`, 2);
+        throw new DispatchError(m(lang, "fileNotFound", sharedPath), 2);
     }
-    const rows = parseDispatchTable(dispatchText);
-    const shared = parseSharedDoc(sharedText);
+    const rows = parseDispatchTable(dispatchText, lang);
+    const shared = parseSharedDoc(sharedText, lang);
     const perAgent = new Map();
     for (const row of rows) {
         const agentPath = path.join(ticketDir, `${row.agent}.md`);
@@ -148,9 +150,9 @@ export async function loadTicket(ticketDir) {
             agentText = await readFile(agentPath, "utf8");
         }
         catch {
-            throw new DispatchError(`找不到 ${agentPath}（_dispatch.md 列了 agent "${row.agent}"）`, 2);
+            throw new DispatchError(m(lang, "agentFileNotFound", agentPath, row.agent), 2);
         }
-        perAgent.set(row.agent, parseAgentTicket(agentText));
+        perAgent.set(row.agent, parseAgentTicket(agentText, lang));
     }
     return { ticketDir, rows, shared, perAgent };
 }

package/dist/validate.js

@@ -5,22 +5,20 @@ import fs from "node:fs";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { DispatchError } from "./types.js";
+import { stripFrontmatter } from "./ticket.js";
 import { buildAllowSet } from "./whitelist.js";
+import { m } from "./messages.js";
 function apiKeyEnvFor(provider) {
     return `${provider.toUpperCase()}_API_KEY`;
 }
-function stripFrontmatter(markdown) {
-    const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
-    return (match ? match[1] : markdown).trim();
-}
-async function readAgentBody(agentsDir, agent) {
+async function readAgentBody(agentsDir, agent, lang) {
     const agentDefPath = path.join(agentsDir, `${agent}.md`);
     let text;
     try {
         text = await readFile(agentDefPath, "utf8");
     }
     catch {
-        throw new DispatchError(`找不到 agent 定義檔 ${agentDefPath}（_dispatch.md 列了 "${agent}"）`, 2);
+        throw new DispatchError(m(lang, "agentDefNotFound", agentDefPath, agent), 2);
     }
     return stripFrontmatter(text);
 }
@@ -28,57 +26,60 @@ function isUnderDocsDir(repoRoot, resolved) {
     const docsRoot = path.resolve(repoRoot, "_docs");
     return resolved === docsRoot || resolved.startsWith(docsRoot + path.sep);
 }
-export async function resolveSpokes(ticket, providers, repoRoot, agentsDir = path.join(repoRoot, ".claude", "agents")) {
+export async function resolveSpokes(ticket, providers, repoRoot, 
+// plan_i18n_v1.3.md §一之3 第 3 點：必填、不得有預設值——有預設值的話呼叫端漏傳會
+// 靜默回退成舊來源，連紅字都沒有，等同「傳了但傳的是舊來源」那種型別系統看不見的錯誤。
+lang, agentsDir = path.join(repoRoot, ".claude", "agents")) {
     const resolved = [];
     for (const row of ticket.rows) {
         const providerConfig = providers[row.provider];
         if (!providerConfig) {
-            throw new DispatchError(`_dispatch.md 的 "${row.agent}" 列引用了未定義於 providers.json 的 provider "${row.provider}"`, 2);
+            throw new DispatchError(m(lang, "providerUndefinedInRow", row.agent, row.provider), 2);
         }
         // §18：只檢查本次工單用到的 provider，缺即中止。
         const envName = apiKeyEnvFor(row.provider);
         if (!process.env[envName]) {
-            throw new DispatchError(`缺少環境變數 ${envName}（"${row.agent}" 列需要 provider "${row.provider}"）`, 2);
+            throw new DispatchError(m(lang, "missingEnvVar", envName, row.agent, row.provider), 2);
         }
         // §5：model 須在 providers.json 的 models 白名單內；白名單為空 = 不做型號檢查。
         if (providerConfig.models.length > 0 && !providerConfig.models.includes(row.model)) {
-            throw new DispatchError(`"${row.agent}" 列的 model "${row.model}" 不在 provider "${row.provider}" 的 models 白名單內` +
-                `（允許：${providerConfig.models.join(", ")}）`, 2);
+            throw new DispatchError(m(lang, "modelNotWhitelisted", row.agent, row.model, row.provider, providerConfig.models.join(", ")), 2);
         }
         // §4：effort 填了但不在該 provider 的 allowed 內即中止（含 allowed 為空陣列）。
         if (row.effort !== undefined && !providerConfig.reasoning.allowed.includes(row.effort)) {
-            throw new DispatchError(`"${row.agent}" 列的 effort "${row.effort}" 不在 provider "${row.provider}" 的允許值域內` +
-                `（允許值：${providerConfig.reasoning.allowed.length > 0 ? providerConfig.reasoning.allowed.join(", ") : "（空——尚未驗證，任何值皆拒絕）"}）`, 2);
+            const list = providerConfig.reasoning.allowed.length > 0
+                ? providerConfig.reasoning.allowed.join(", ")
+                : m(lang, "emptyAllowedNote");
+            throw new DispatchError(m(lang, "effortNotAllowed", row.agent, row.effort, row.provider, list), 2);
         }
         // §5：「留白」不再是「不送任何 reasoning 參數」，而是送 reasoning.default。
         // allowed 為空時 default 不存在——該 provider 不可用，即使 effort 留白也中止。
         const effectiveEffort = row.effort ?? providerConfig.reasoning.default;
         if (effectiveEffort === undefined) {
-            throw new DispatchError(`"${row.agent}" 列的 effort 留白，但 provider "${row.provider}" 未設 reasoning.default` +
-                `（allowed 為空 = 尚未驗證，該 provider 不可用）`, 2);
+            throw new DispatchError(m(lang, "effortBlankNoDefault", row.agent, row.provider), 2);
         }
         const agentTicket = ticket.perAgent.get(row.agent);
         if (!agentTicket) {
             // loadTicket() 已保證存在，此處為型別窄化與防禦
-            throw new DispatchError(`內部錯誤：找不到 "${row.agent}" 的工單內容`, 2);
+            throw new DispatchError(m(lang, "internalErrorTicketContentMissing", row.agent), 2);
         }
         // §4「針對 hub 會寫錯」：_docs/ 一律拒絕；允許清單逐一驗證存在，任一不存在即中止並指名。
         const allowedReadsResolved = [];
         for (const rel of agentTicket.allowedReads) {
             const resolvedPath = path.resolve(repoRoot, rel);
             if (isUnderDocsDir(repoRoot, resolvedPath)) {
-                throw new DispatchError(`"${row.agent}" 的允許讀取清單指向 _docs/（spoke 禁區）：${rel}`, 2);
+                throw new DispatchError(m(lang, "allowedReadsUnderDocs", row.agent, rel), 2);
             }
             let real;
             try {
                 real = fs.realpathSync(resolvedPath);
             }
             catch {
-                throw new DispatchError(`"${row.agent}" 的允許讀取清單指向不存在的路徑：${rel}`, 2);
+                throw new DispatchError(m(lang, "allowedReadsPathNotFound", row.agent, rel), 2);
             }
             allowedReadsResolved.push(real);
         }
-        const agentBody = await readAgentBody(agentsDir, row.agent);
+        const agentBody = await readAgentBody(agentsDir, row.agent, lang);
         const sharedPath = path.join(ticket.ticketDir, "_shared.md");
         const ownAgentPath = path.join(ticket.ticketDir, `${row.agent}.md`);
         const allowSet = buildAllowSet([sharedPath, ownAgentPath, ...allowedReadsResolved]);
@@ -93,7 +94,7 @@ export async function resolveSpokes(ticket, providers, repoRoot, agentsDir = pat
             allowSet,
             allowedReadsResolved,
             allowedReadsRelative: agentTicket.allowedReads,
-            lang: agentTicket.lang,
+            lang,
         });
     }
     return resolved;

package/dist/whitelist.js

@@ -35,4 +35,12 @@ export function checkAllowlist(allowSet, requestedPath, repoRoot) {
     return { allowed: false, reason: insideRepo ? "not_in_allowlist" : "outside_repo" };
 }
 // 統一回給 spoke 的訊息：不區分「不存在」與「不在允許範圍」。
-export const ALLOWLIST_REJECT_MESSAGE = "不存在或不在允許範圍";
+//
+// i18n_classification_t2.md §三之2：這則訊息經 executeToolCall 當 resultText 送回對話，
+// 消費者是 spoke 不是人類——歸 C 類，不進 messages.ts，由 spoke.lang 直接選用兩套並存的
+// 雙語常數（同 runner.ts 本地的 200KB 截斷／--max-tool-calls 上限兩則走同一模式）。
+const ALLOWLIST_REJECT_MESSAGE = "不存在或不在允許範圍";
+const ALLOWLIST_REJECT_MESSAGE_EN = "Not found or outside the allowed list";
+export function allowlistRejectMessage(lang) {
+    return lang === "en" ? ALLOWLIST_REJECT_MESSAGE_EN : ALLOWLIST_REJECT_MESSAGE;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dowafu",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "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",
@@ -33,7 +33,8 @@
   "files": [
     "dist",
     "providers.json",
-    "publish"
+    "publish",
+    "README_zh-tw.md"
   ],
   "scripts": {
     "verify:providers": "tsx scripts/verify-providers.ts",