botrun-horse 1.0.0

package/lib/tools/fs-tools.mjs

@@ -0,0 +1,268 @@
+// lib/tools/fs-tools.mjs — 檔案系統工具定義與執行器
+//
+// 唯讀工具（read_file, list_files, grep_content）— 無副作用，NchcAgent 預設工具集
+// 寫入工具（write_file, edit_file, run_command, create_dir）— 有副作用，NchcCodeAgent 專用
+//
+// 宣告式設計（OCP）：新增工具只需在此檔案加入 schema + executor case
+//   1. 在 BUILT_IN_TOOLS 或 CODING_TOOLS 加入 JSON Schema 宣告
+//   2. 在 executeTool() 或 executeCodeTool() switch 加入對應 case
+
+import { exec } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'node:fs/promises';
+
+// ══════════════════════════════════════════════════════════════════════════
+// 唯讀工具 schema（無副作用）
+// ══════════════════════════════════════════════════════════════════════════
+
+export const BUILT_IN_TOOLS = [
+  {
+    type: 'function',
+    function: {
+      name: 'read_file',
+      description: '讀取指定路徑的檔案內容（支援文字檔、.mjs、.md、.json 等）',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: '檔案絕對路徑或相對於工作目錄的路徑' },
+          max_chars: { type: 'integer', description: '最多讀取字元數（預設 8000）' },
+        },
+        required: ['path'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'list_files',
+      description: '列出目錄中的檔案（支援 glob 模式，如 "lib/**/*.mjs"）',
+      parameters: {
+        type: 'object',
+        properties: {
+          pattern: { type: 'string', description: 'glob 模式，例如 "lib/**/*.mjs"' },
+          base_dir: { type: 'string', description: '搜尋基準目錄（預設工作目錄）' },
+        },
+        required: ['pattern'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'grep_content',
+      description: '在檔案中搜尋關鍵字（回傳含行號的匹配結果）',
+      parameters: {
+        type: 'object',
+        properties: {
+          pattern: { type: 'string', description: '搜尋模式（字串）' },
+          file_path: { type: 'string', description: '要搜尋的檔案路徑' },
+          context_lines: { type: 'integer', description: '匹配行前後各顯示幾行（預設 2）' },
+        },
+        required: ['pattern', 'file_path'],
+      },
+    },
+  },
+];
+
+/**
+ * 執行唯讀工具
+ * @param {string} name - 工具名稱
+ * @param {object} args - 工具參數
+ * @param {string} cwd  - 工作目錄
+ * @returns {Promise<string>}
+ */
+export async function executeTool(name, args, cwd = process.cwd()) {
+  switch (name) {
+    case 'read_file': {
+      const filePath = path.resolve(cwd, args.path);
+      const maxChars = args.max_chars || 8000;
+      try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        const truncated = content.length > maxChars
+          ? content.slice(0, maxChars) + `\n\n...[截斷，共 ${content.length} 字元]`
+          : content;
+        return `# 檔案：${filePath}\n\n${truncated}`;
+      } catch (err) {
+        return `錯誤：無法讀取 ${filePath}：${err.message}`;
+      }
+    }
+    case 'list_files': {
+      const baseDir = path.resolve(cwd, args.base_dir || '.');
+      try {
+        const files = [];
+        for await (const entry of glob(args.pattern, { cwd: baseDir })) files.push(entry);
+        if (files.length === 0) return `找不到符合 "${args.pattern}" 的檔案`;
+        return files.sort().join('\n');
+      } catch (err) {
+        return `錯誤：list_files 失敗：${err.message}`;
+      }
+    }
+    case 'grep_content': {
+      const filePath = path.resolve(cwd, args.file_path);
+      const contextLines = args.context_lines ?? 2;
+      try {
+        const lines = fs.readFileSync(filePath, 'utf8').split('\n');
+        const results = [];
+        for (let i = 0; i < lines.length; i++) {
+          if (lines[i].includes(args.pattern)) {
+            const start = Math.max(0, i - contextLines);
+            const end = Math.min(lines.length - 1, i + contextLines);
+            results.push(
+              lines.slice(start, end + 1).map((l, idx) => `${start + idx + 1}: ${l}`).join('\n')
+            );
+          }
+        }
+        if (results.length === 0) return `找不到 "${args.pattern}"`;
+        return results.join('\n---\n');
+      } catch (err) {
+        return `錯誤：grep_content 失敗：${err.message}`;
+      }
+    }
+    default:
+      return `錯誤：未知工具 "${name}"`;
+  }
+}
+
+// ══════════════════════════════════════════════════════════════════════════
+// 寫入工具 schema（有副作用，NchcCodeAgent 額外工具集）
+// ══════════════════════════════════════════════════════════════════════════
+
+export const CODING_SYSTEM_PROMPT =
+  '你是一個 Agentic Coding 代理（NchcCodeAgent），專精於 Node.js / MJS 程式碼開發。\n' +
+  '可用工具：讀取 / 寫入 / 編輯檔案、執行 shell 指令（測試、git、lint）。\n' +
+  '開發原則：SOLID / DRY / KISS / DDD，所有程式碼和回應一律使用繁體中文（臺灣正體）。\n' +
+  '工作流程：先讀取再修改，先執行測試再確認結果。\n' +
+  '謹慎使用破壞性指令（rm -rf、git reset --hard 等），必要時先確認。';
+
+export const CODING_TOOLS = [
+  {
+    type: 'function',
+    function: {
+      name: 'write_file',
+      description: '建立或覆蓋一個檔案的完整內容。若父目錄不存在，自動建立。',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: '檔案路徑' },
+          content: { type: 'string', description: '要寫入的完整內容' },
+        },
+        required: ['path', 'content'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'edit_file',
+      description:
+        '精確替換檔案中的字串（old_string → new_string）。' +
+        'old_string 必須在檔案中恰好出現一次，否則回傳錯誤。',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: '檔案路徑' },
+          old_string: { type: 'string', description: '要被替換的字串（須唯一）' },
+          new_string: { type: 'string', description: '替換後的字串' },
+        },
+        required: ['path', 'old_string', 'new_string'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'run_command',
+      description: '執行 shell 指令，回傳 stdout / stderr / 退出碼（預設 30s 逾時）。',
+      parameters: {
+        type: 'object',
+        properties: {
+          command: { type: 'string', description: '要執行的完整 shell 指令' },
+          timeout_ms: { type: 'integer', description: '逾時毫秒（預設 30000）' },
+        },
+        required: ['command'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'create_dir',
+      description: '建立目錄（含父目錄，等同 mkdir -p）',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: '要建立的目錄路徑' },
+        },
+        required: ['path'],
+      },
+    },
+  },
+];
+
+export const CODING_TOOL_NAMES = new Set(CODING_TOOLS.map(t => t.function.name));
+
+/**
+ * 執行寫入工具
+ * @param {string}  name   - 工具名稱
+ * @param {object}  args   - 工具參數
+ * @param {string}  cwd    - 工作目錄
+ * @param {boolean} dryRun - true 時不實際寫入/執行
+ * @returns {Promise<string>}
+ */
+export async function executeCodeTool(name, args, cwd = process.cwd(), dryRun = false) {
+  switch (name) {
+    case 'write_file': {
+      const filePath = path.resolve(cwd, args.path);
+      if (dryRun) return `[dry-run] 不寫入：write_file ${filePath}（${args.content.length} 字元）`;
+      try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, args.content, 'utf8');
+        return `已寫入 ${filePath}（${args.content.length} 字元）`;
+      } catch (err) {
+        return `錯誤：write_file 失敗：${err.message}`;
+      }
+    }
+    case 'edit_file': {
+      const filePath = path.resolve(cwd, args.path);
+      if (dryRun) return `[dry-run] 不編輯：edit_file ${filePath}（"${args.old_string.slice(0, 30)}..."）`;
+      try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        const count = content.split(args.old_string).length - 1;
+        if (count === 0) return `錯誤：找不到 old_string，請確認字串完整。\n提示：可用 read_file 先確認內容。`;
+        if (count > 1) return `錯誤：old_string 在檔案中出現 ${count} 次，請提供更多上下文使其唯一。`;
+        fs.writeFileSync(filePath, content.replace(args.old_string, args.new_string), 'utf8');
+        return `已編輯 ${filePath}（${args.old_string.length} → ${args.new_string.length} 字元）`;
+      } catch (err) {
+        return `錯誤：edit_file 失敗：${err.message}`;
+      }
+    }
+    case 'run_command': {
+      if (dryRun) return `[dry-run] 不執行：run_command \`${args.command}\``;
+      const timeout = args.timeout_ms || 30000;
+      return new Promise((resolve) => {
+        exec(args.command, { cwd, timeout, maxBuffer: 1024 * 1024, env: process.env },
+          (err, stdout, stderr) => {
+            const parts = [];
+            if (stdout?.trim()) parts.push(`STDOUT:\n${stdout.trim()}`);
+            if (stderr?.trim()) parts.push(`STDERR:\n${stderr.trim()}`);
+            if (err?.killed) parts.push(`[逾時：${timeout}ms]`);
+            parts.push(`退出碼：${err ? (err.code ?? 1) : 0}`);
+            resolve(parts.join('\n'));
+          });
+      });
+    }
+    case 'create_dir': {
+      const dirPath = path.resolve(cwd, args.path);
+      if (dryRun) return `[dry-run] 不建立：create_dir ${dirPath}`;
+      try {
+        fs.mkdirSync(dirPath, { recursive: true });
+        return `已建立目錄 ${dirPath}`;
+      } catch (err) {
+        return `錯誤：create_dir 失敗：${err.message}`;
+      }
+    }
+    default:
+      return `錯誤：未知的 coding 工具 "${name}"`;
+  }
+}

package/lib/tools/index.mjs

@@ -0,0 +1,27 @@
+// lib/tools/index.mjs — 工具 schema 聚合器（OCP 擴展點）
+//
+// 新增工具只需：
+//   1. 在 lib/tools/ 建立新的 *-tools.mjs（依工具功能分組）
+//   2. 在此檔案 import 並加入 tools[] 陣列
+//
+// 匯出：
+//   tools          — 所有唯讀工具的 schema 陣列（NchcAgent 預設）
+//   codingTools    — 所有寫入工具的 schema 陣列（NchcCodeAgent 專用）
+//   allTools       — 完整工具集（唯讀 + 寫入）
+//   executeTool    — 唯讀工具執行器
+//   executeCodeTool — 寫入工具執行器
+//   CODING_TOOL_NAMES — 寫入工具名稱集合（Set<string>）
+//   CODING_SYSTEM_PROMPT — NchcCodeAgent 系統提示詞
+
+export {
+  BUILT_IN_TOOLS as tools,
+  CODING_TOOLS as codingTools,
+  CODING_TOOL_NAMES,
+  CODING_SYSTEM_PROMPT,
+  executeTool,
+  executeCodeTool,
+} from './fs-tools.mjs';
+
+// allTools：唯讀 + 寫入（完整工具集）
+import { BUILT_IN_TOOLS, CODING_TOOLS } from './fs-tools.mjs';
+export const allTools = [...BUILT_IN_TOOLS, ...CODING_TOOLS];

package/lib/writing/generate.mjs

@@ -0,0 +1,86 @@
+// lib/writing/generate.mjs — 平行生成用例
+// 依照 DAG 依賴順序，平行批次生成 PDF
+// 支援多專案：透過 project 參數決定路徑與 generators
+
+import path from 'path';
+import { renderPdf } from './renderer.mjs';
+import {
+  loadDag, loadState, saveState, initState,
+  markRunning, markDone, markFailed, getReady, formatStatus,
+} from '../core/dag.mjs';
+import * as paths from '../core/paths.mjs';
+
+/**
+ * @param {object} opts
+ * @param {number} [opts.concurrency=10]
+ * @param {number[]|null} [opts.ids]
+ * @param {string} [opts.project='nstc']
+ * @param {object} opts.generators - 公文類型 → 生成函式
+ * @param {object} [opts.overrides] - 按 ID 覆蓋的生成函式
+ * @param {string} [opts.fontPath]
+ * @param {string} [opts.fontName]
+ * @param {string} [opts.author]
+ */
+export async function generateAll({ concurrency = 10, ids = null, project = 'nstc', generators = {}, overrides = {}, fontPath, fontName, author } = {}) {
+  const OUTPUT_DIR = path.join(paths.projectOutput(project), 'pdfs');
+  const { documents } = loadDag(project);
+  let state = loadState(project);
+
+  if (!state) {
+    state = initState(documents);
+    saveState(state, project);
+  }
+
+  const docMap = new Map(documents.map(d => [d.id, d]));
+  const targetIds = ids ? new Set(ids) : new Set(documents.map(d => d.id));
+  const results = { ok: 0, fail: 0 };
+
+  let iterations = 0;
+  const maxIterations = 200; // 防止無限迴圈
+
+  while (iterations++ < maxIterations) {
+    // 找出就緒的任務
+    const ready = getReady(state).filter(t => targetIds.has(t.id));
+    if (ready.length === 0) {
+      const remaining = Object.values(state).filter(t => targetIds.has(t.id) && t.status === 'pending');
+      if (remaining.length === 0) break;
+      // 等待其他依賴完成
+      await new Promise(r => setTimeout(r, 100));
+      continue;
+    }
+
+    // 平行處理一批
+    const batch = ready.slice(0, concurrency);
+    const promises = batch.map(async (task) => {
+      markRunning(state, task.id);
+      saveState(state, project);
+
+      try {
+        const docConfig = docMap.get(task.id);
+        const result = await renderPdf(docConfig, OUTPUT_DIR, { generators, overrides, fontPath, fontName, author });
+        markDone(state, task.id, result.path);
+        results.ok++;
+        return { id: task.id, status: 'ok', path: result.path };
+      } catch (err) {
+        markFailed(state, task.id, err.message);
+        results.fail++;
+        return { id: task.id, status: 'fail', error: err.message };
+      } finally {
+        saveState(state, project);
+      }
+    });
+
+    const batchResults = await Promise.all(promises);
+
+    // 輸出到 stdout (支援 pipe)
+    for (const r of batchResults) {
+      if (r.status === 'ok') {
+        process.stdout.write(`OK\t${r.id}\t${r.path}\n`);
+      } else {
+        process.stderr.write(`FAIL\t${r.id}\t${r.error}\n`);
+      }
+    }
+  }
+
+  return { ...results, status: formatStatus(state) };
+}

package/lib/writing/generators/nstc-generators.mjs

@@ -0,0 +1,279 @@
+// lib/writing/generators/nstc-generators.mjs — 國科會各類公文內容生成策略
+// Strategy pattern: 每種公文類型一個生成函式
+
+import {
+  pick, randInt, padZero, genDocNum, genDate, genBudget,
+  SCHOOLS, PIS, DEPTS, TOPICS, VENDORS, CHIEFS, MEETING_PLACES,
+} from '../../../projects/nstc/data/fake-data.mjs';
+import {
+  drawHeader, drawField, drawSection, drawNumberedText, drawParagraph, drawSignature,
+} from '../layouts/nstc-layout.mjs';
+
+// ===== 函 =====
+export function generate_函(doc, meta) {
+  const docNum = genDocNum('函', meta.id);
+  const date = genDate();
+  const school = pick(SCHOOLS);
+  const pi = pick(PIS);
+  const topic = pick(TOPICS);
+  const dept = pick(DEPTS);
+  const budget = genBudget();
+
+  drawHeader(doc, '國家科學及技術委員會 函');
+  let y = 160;
+
+  y = drawField(doc, '受文者：', school, y);
+  y = drawField(doc, '發文日期：', date, y);
+  y = drawField(doc, '發文字號：', docNum, y);
+  y = drawField(doc, '速別：', pick(['最速件', '速件', '普通件']), y);
+  y = drawField(doc, '密等及解密條件或保密期限：', '普通', y);
+  y = drawField(doc, '附件：', meta.attachment || '如說明三', y);
+  y += 10;
+
+  y = drawField(doc, '主旨：', meta.subject || `有關貴校${pi}教授申請本會${meta.title}案，復如說明，請查照。`, y, true);
+  y += 5;
+
+  y = drawSection(doc, '說明：', y);
+  y = drawNumberedText(doc, '一、', `依據本會${dept}${date}審查會議決議辦理。`, y);
+  y = drawNumberedText(doc, '二、', meta.desc2 || `旨揭計畫「${topic}」（計畫編號：NSTC ${114}-${randInt(2100, 2900)}-${pick(['E', 'H', 'M', 'B', 'I'])}-${padZero(randInt(1, 200), 3)}-${padZero(randInt(1, 99))}），經本會審查通過，核定補助經費${budget}，執行期限自114年8月1日起至115年7月31日止。`, y);
+  y = drawNumberedText(doc, '三、', meta.desc3 || '檢附計畫經費核定清單乙份，請依「國家科學及技術委員會補助專題研究計畫經費處理原則」相關規定辦理核撥及執行事宜。', y);
+  y = drawNumberedText(doc, '四、', meta.desc4 || '計畫主持人應依核定計畫內容執行，如需變更，應依規定程序報本會核准。', y);
+  y += 15;
+
+  y = drawField(doc, '正本：', school, y);
+  y = drawField(doc, '副本：', `${school}研究發展處、${dept}`, y);
+  y += 30;
+
+  drawSignature(doc, y);
+}
+
+// ===== 令 =====
+export function generate_令(doc, meta) {
+  const docNum = genDocNum('令', meta.id);
+  const date = genDate();
+
+  drawHeader(doc, '國家科學及技術委員會 令');
+  let y = 160;
+
+  y = drawField(doc, '發文日期：', date, y);
+  y = drawField(doc, '發文字號：', docNum, y);
+  y += 10;
+
+  if (meta.title.includes('派令') || meta.title.includes('任命')) {
+    y = drawSection(doc, '茲派（令）', y);
+    y += 5;
+    const person = pick(CHIEFS);
+    const position = meta.title.includes('主任委員') ? '主任委員' :
+                     meta.title.includes('副主任委員') ? '副主任委員' : '處長';
+    y = drawParagraph(doc, `茲派${person}為本會${position}，應即到職。`, y);
+    y += 10;
+    y = drawParagraph(doc, '此令。', y);
+  } else if (meta.title.includes('修正')) {
+    y = drawField(doc, '主旨：', `修正「${meta.title.replace('修正令', '')}」部分規定，並自即日生效。`, y, true);
+    y += 5;
+    y = drawSection(doc, '依據：', y);
+    y = drawParagraph(doc, '科學技術基本法第六條及國家科學及技術委員會組織法第二條規定。', y);
+    y += 5;
+    y = drawSection(doc, '公告事項：', y);
+    y = drawNumberedText(doc, '一、', `修正「${meta.title.replace('修正令', '')}」第三條、第五條、第十二條及第十五條條文。`, y);
+    y = drawNumberedText(doc, '二、', '修正條文如附件。', y);
+    y = drawNumberedText(doc, '三、', '本令自發布日施行。', y);
+  } else {
+    y = drawField(doc, '主旨：', `${meta.title}，自即日生效。`, y, true);
+    y += 5;
+    y = drawSection(doc, '說明：', y);
+    y = drawNumberedText(doc, '一、', '依據國家科學及技術委員會組織法相關規定辦理。', y);
+    y = drawNumberedText(doc, '二、', '詳如附件。', y);
+  }
+
+  y += 30;
+  drawSignature(doc, y);
+}
+
+// ===== 公告 =====
+export function generate_公告(doc, meta) {
+  const docNum = genDocNum('公告', meta.id);
+  const date = genDate();
+
+  drawHeader(doc, '國家科學及技術委員會 公告');
+  let y = 160;
+
+  y = drawField(doc, '發文日期：', date, y);
+  y = drawField(doc, '發文字號：', docNum, y);
+  y = drawField(doc, '附件：', meta.attachment || '如公告事項', y);
+  y += 10;
+
+  y = drawField(doc, '主旨：', `公告${meta.title}相關事項。`, y, true);
+  y += 5;
+
+  y = drawSection(doc, '依據：', y);
+  y = drawParagraph(doc, '國家科學及技術委員會補助專題研究計畫作業要點第四點規定。', y);
+  y += 5;
+
+  y = drawSection(doc, '公告事項：', y);
+  if (meta.title.includes('徵求') || meta.title.includes('申請')) {
+    y = drawNumberedText(doc, '一、', '申請資格：凡國內公私立大專校院及學術研究機構之專任教學或研究人員，具有博士學位者，均得向本會提出申請。', y);
+    y = drawNumberedText(doc, '二、', `申請期限：自即日起至114年${randInt(5, 10)}月${randInt(1, 28)}日止，逾期不予受理。`, y);
+    y = drawNumberedText(doc, '三、', '申請方式：請至本會學術研發服務網（https://wsts.nstc.gov.tw）線上提出申請，並由申請機構統一彙送。', y);
+    y = drawNumberedText(doc, '四、', '補助項目及額度：依本會相關補助作業要點規定辦理。', y);
+    y = drawNumberedText(doc, '五、', '聯絡方式：請洽本會承辦人員（電話：02-2737-7992）。', y);
+  } else if (meta.title.includes('招標') || meta.title.includes('決標')) {
+    y = drawNumberedText(doc, '一、', `案號：NSTC-${114}${padZero(randInt(1, 12))}-${padZero(randInt(1, 50), 3)}`, y);
+    y = drawNumberedText(doc, '二、', `標案名稱：${meta.title}`, y);
+    y = drawNumberedText(doc, '三、', meta.title.includes('決標') ?
+      `決標金額：新臺幣${randInt(100, 5000)}萬元整` :
+      `預算金額：新臺幣${randInt(100, 5000)}萬元整`, y);
+    y = drawNumberedText(doc, '四、', meta.title.includes('決標') ?
+      `得標廠商：${pick(VENDORS)}` :
+      `投標截止日期：114年${randInt(3, 11)}月${randInt(1, 28)}日下午5時`, y);
+  } else if (meta.title.includes('甄選')) {
+    y = drawNumberedText(doc, '一、', `甄選職缺：本會${pick(DEPTS)}研究員${randInt(1, 3)}名。`, y);
+    y = drawNumberedText(doc, '二、', '資格條件：具有相關領域博士學位，並具二年以上相關工作經驗者。', y);
+    y = drawNumberedText(doc, '三、', `報名期限：自即日起至114年${randInt(3, 11)}月${randInt(1, 28)}日止。`, y);
+    y = drawNumberedText(doc, '四、', '報名方式：請至本會人事室網站下載報名表，填妥後連同相關證件影本寄送本會人事室。', y);
+  } else {
+    y = drawNumberedText(doc, '一、', `本公告事項自114年${randInt(1, 12)}月${randInt(1, 28)}日生效。`, y);
+    y = drawNumberedText(doc, '二、', '相關細節請參閱附件說明。', y);
+    y = drawNumberedText(doc, '三、', '如有疑義，請洽本會綜合規劃處（電話：02-2737-7590）。', y);
+  }
+
+  y += 30;
+  drawSignature(doc, y);
+}
+
+// ===== 書函 =====
+export function generate_書函(doc, meta) {
+  const docNum = genDocNum('書函', meta.id);
+  const date = genDate();
+  const school = pick(SCHOOLS);
+
+  drawHeader(doc, '國家科學及技術委員會 書函');
+  let y = 160;
+
+  y = drawField(doc, '受文者：', school, y);
+  y = drawField(doc, '發文日期：', date, y);
+  y = drawField(doc, '發文字號：', docNum, y);
+  y = drawField(doc, '速別：', '普通件', y);
+  y = drawField(doc, '密等及解密條件或保密期限：', '普通', y);
+  y = drawField(doc, '附件：', '無', y);
+  y += 10;
+
+  y = drawField(doc, '主旨：', `有關${meta.title}事宜，請查照配合辦理。`, y, true);
+  y += 5;
+
+  y = drawSection(doc, '說明：', y);
+  y = drawNumberedText(doc, '一、', '依據本會114年度施政計畫辦理。', y);
+  y = drawNumberedText(doc, '二、', '為辦理旨揭事項，請貴校（機構）依規定期限配合辦理相關作業。', y);
+  y = drawNumberedText(doc, '三、', '如有疑義，請逕洽本會承辦人員。', y);
+  y += 15;
+
+  y = drawField(doc, '正本：', '各公私立大專校院', y);
+  y = drawField(doc, '副本：', '本會相關處室', y);
+  y += 30;
+
+  drawSignature(doc, y);
+}
+
+// ===== 開會通知單 =====
+export function generate_開會通知單(doc, meta) {
+  const docNum = genDocNum('開會通知單', meta.id);
+  const date = genDate();
+  const meetMonth = randInt(3, 12);
+  const meetDay = randInt(1, 28);
+  const meetHour = pick([9, 10, 14, 15]);
+  const place = pick(MEETING_PLACES);
+
+  drawHeader(doc, '國家科學及技術委員會 開會通知單');
+  let y = 160;
+
+  y = drawField(doc, '發文日期：', date, y);
+  y = drawField(doc, '發文字號：', docNum, y);
+  y = drawField(doc, '速別：', '速件', y);
+  y += 15;
+
+  y = drawField(doc, '會議名稱：', meta.title, y);
+  y = drawField(doc, '開會時間：', `114年${meetMonth}月${meetDay}日（${pick(['星期一', '星期二', '星期三', '星期四', '星期五'])}）${meetHour < 12 ? '上' : '下'}午${meetHour > 12 ? meetHour - 12 : meetHour}時${pick(['00', '30'])}分`, y);
+  y = drawField(doc, '開會地點：', place, y);
+  y = drawField(doc, '主持人：', `${pick(CHIEFS)}　${pick(['主任委員', '副主任委員', '處長'])}`, y);
+  y = drawField(doc, '聯絡人及電話：', `${pick(PIS)}（02-2737-${randInt(7000, 7999)}）`, y);
+  y += 15;
+
+  y = drawSection(doc, '開會事由：', y);
+  y = drawParagraph(doc, `為辦理${meta.title}相關事宜，召開本次會議研商。`, y);
+  y += 10;
+
+  y = drawSection(doc, '討論事項：', y);
+  y = drawNumberedText(doc, '一、', '前次會議決議事項辦理情形報告。', y);
+  y = drawNumberedText(doc, '二、', `${meta.title}相關議題討論。`, y);
+  y = drawNumberedText(doc, '三、', '臨時動議。', y);
+  y += 10;
+
+  y = drawSection(doc, '出（列）席者：', y);
+  y = drawParagraph(doc, '詳如附件出席名單。', y);
+  y += 10;
+
+  y = drawSection(doc, '備註：', y);
+  y = drawNumberedText(doc, '一、', '請準時出席，如不克出席，請於會前指派代理人參加並告知聯絡人。', y);
+  y = drawNumberedText(doc, '二、', '開會當日請攜帶本通知單以利換證入場。', y);
+  y += 30;
+
+  drawSignature(doc, y);
+}
+
+// ===== 簽 =====
+export function generate_簽(doc, meta) {
+  const date = genDate();
+  const dept = pick(DEPTS);
+
+  drawHeader(doc, '簽');
+  let y = 145;
+
+  doc.font('SongBold').fontSize(12);
+  doc.text(`主管：　　　　　　　　會辦：　　　　　　　　承辦單位：${dept}`, 60, y);
+  y += 35;
+
+  y = drawField(doc, '簽於：', date, y);
+  y += 10;
+
+  y = drawField(doc, '主旨：', `為辦理${meta.title}案，擬具處理意見，簽請核示。`, y, true);
+  y += 5;
+
+  y = drawSection(doc, '說明：', y);
+  y = drawNumberedText(doc, '一、', '依據本會業務需要及相關規定辦理。', y);
+  y = drawNumberedText(doc, '二、', `案經${dept}研議，擬具處理意見如擬辦事項。`, y);
+  y += 5;
+
+  y = drawSection(doc, '擬辦：', y);
+  y = drawNumberedText(doc, '一、', `擬請核准辦理${meta.title}，並依規定程序簽報。`, y);
+  y = drawNumberedText(doc, '二、', '奉核後，由承辦單位依權責辦理後續事宜。', y);
+  y += 15;
+
+  doc.font('Song').fontSize(11);
+  y = drawField(doc, '承辦人：', pick(PIS), y);
+  y = drawField(doc, '單位主管：', '', y);
+  y = drawField(doc, '核稿：', '', y);
+}
+
+import {
+  generate_top5_核定通知, generate_top5_申請公告,
+  generate_top5_開會通知, generate_top5_修正令, generate_top5_簽呈,
+} from './nstc-top5.mjs';
+
+// 通用 Registry（按公文類型）
+export const GENERATORS = {
+  '函': generate_函,
+  '令': generate_令,
+  '公告': generate_公告,
+  '書函': generate_書函,
+  '開會通知單': generate_開會通知單,
+  '簽': generate_簽,
+};
+
+// Top5 特殊覆蓋（按文件 ID，多頁高擬真版本）
+export const TOP5_OVERRIDES = {
+  1: generate_top5_核定通知,
+  34: generate_top5_申請公告,
+  41: generate_top5_開會通知,
+  31: generate_top5_修正令,
+  51: generate_top5_簽呈,
+};