kenaz 0.3.3 → 0.3.5

package/core/.formation/tools/logger.js

@@ -1,273 +0,0 @@
-/**
- * Formation Logger
- * Claude subagent 輸出的 stream-json 格式化
- *
- * 支援的 entry types：
- *   - system:    init, hook 事件
- *   - assistant: agent 的文字輸出和工具呼叫
- *   - user:      tool_use_result、teammate 訊息
- *   - result:    session 結束摘要
- */
-
-const fs = require('fs');
-const path = require('path');
-const { LOG_DIR, getLogDir } = require('./utils');
-
-/**
- * Local wall-clock HH:MM:SS for per-line log prefixes.
- *
- * LOCAL (not UTC) on purpose — TASK_1845: file mtime displays in local time,
- * so the last log line's timestamp must be directly comparable with the file's
- * mtime without timezone arithmetic. The previous UTC prefix
- * (`toISOString().slice(11,19)`) was misread as "agent stalled for 8 hours"
- * in a UTC+8 environment when the file had been written 13 seconds earlier.
- *
- * The `[HH:MM:SS]` shape is unchanged (downstream parsers depend on it). Cross-timezone readers can
- * anchor via the header, which carries both the ISO-8601 `Started:` line and
- * an explicit `Timezone: UTC±HH:MM` line.
- */
-function localHHMMSS() {
-  const d = new Date();
-  const p = (n) => String(n).padStart(2, '0');
-  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
-}
-
-/** UTC offset of this machine as `UTC±HH:MM` (e.g. `UTC+08:00`). */
-function localUtcOffset() {
-  const offMin = -new Date().getTimezoneOffset();
-  const sign = offMin >= 0 ? '+' : '-';
-  const abs = Math.abs(offMin);
-  const p = (n) => String(n).padStart(2, '0');
-  return `UTC${sign}${p(Math.floor(abs / 60))}:${p(abs % 60)}`;
-}
-
-/**
- * 建立 log writer
- * @param {object} opts
- * @param {string} opts.formation
- * @param {string} opts.skill
- * @param {string} opts.sessionId
- * @param {string} [opts.outputPath] - 自訂輸出路徑
- * @param {string} [opts.memberId] - Squad 成員 ID（可選）
- * @param {string} [opts.projectPath] - 專案路徑（多專案支援）
- * @returns {{ stream: WriteStream, path: string, writeHeader: Function, writeFooter: Function }}
- */
-function createLogWriter(opts) {
-  const { formation, skill, sessionId, outputPath, memberId, projectPath } = opts;
-
-  // logs 按 formation 分目錄：logs/unit/, logs/squad/, ...
-  // 多專案：根據 projectPath 決定 log 根目錄
-  const logRoot = projectPath ? getLogDir(projectPath) : LOG_DIR;
-  const formationLogDir = path.join(logRoot, formation || 'misc');
-  if (!fs.existsSync(formationLogDir)) {
-    fs.mkdirSync(formationLogDir, { recursive: true });
-  }
-
-  const suffix = memberId ? `_${memberId}` : '';
-  const logPath = outputPath || path.join(formationLogDir, `${skill}${suffix}_${sessionId}.log`);
-  const stream = fs.createWriteStream(logPath, { flags: 'w' });
-
-  return {
-    stream,
-    path: logPath,
-
-    writeHeader() {
-      stream.write(`Formation: ${formation} | Skill: ${skill}${memberId ? ` | Member: ${memberId}` : ''}\n`);
-      stream.write(`Session: ${sessionId}\n`);
-      stream.write(`Started: ${new Date().toISOString()}\n`);
-      stream.write(`Timezone: ${localUtcOffset()} (per-line [HH:MM:SS] timestamps are local time, directly comparable to file mtime)\n`);
-      stream.write(`${'='.repeat(60)}\n\n`);
-    },
-
-    writeFooter(exitCode) {
-      stream.write(`\n${'='.repeat(60)}\n`);
-      stream.write(`Finished: ${new Date().toISOString()}\n`);
-      stream.write(`Exit Code: ${exitCode}\n`);
-      stream.end();
-    }
-  };
-}
-
-/**
- * 格式化 stream-json 的一條 entry
- * @param {object} entry - JSON parsed entry from claude --output-format stream-json
- * @returns {string|null}
- */
-function formatEntry(entry) {
-  const ts = localHHMMSS();
-  const { type } = entry;
-
-  // ── system events ──
-  if (type === 'system') {
-    return formatSystem(ts, entry);
-  }
-
-  // ── assistant（agent 的輸出和工具呼叫）──
-  if (type === 'assistant' && entry.message?.content) {
-    const parts = [];
-    for (const block of entry.message.content) {
-      if (block.type === 'text' && block.text?.trim()) {
-        const clean = block.text
-          .replace(/^#{1,6}\s+/gm, '')
-          .replace(/\*\*([^*]+)\*\*/g, '$1')
-          .trim();
-        const lines = clean.split('\n').filter(l => l.trim());
-        for (const l of lines) {
-          parts.push(`[${ts}][Agent] ${l.trim()}`);
-        }
-      } else if (block.type === 'tool_use') {
-        parts.push(formatToolUse(ts, block));
-      }
-    }
-    return parts.length ? parts.join('\n') : null;
-  }
-
-  // ── user（tool results、teammate 訊息）──
-  if (type === 'user') {
-    return formatUser(ts, entry);
-  }
-
-  // ── result（session 結束）──
-  if (type === 'result') {
-    return formatResult(ts, entry);
-  }
-
-  return null;
-}
-
-// ─────────────────────────────────────────
-// system events
-// ─────────────────────────────────────────
-
-function formatSystem(ts, entry) {
-  const { subtype } = entry;
-  if (subtype === 'init') {
-    return `[${ts}][SYSTEM][INIT] model=${entry.model || ''} cwd=${entry.cwd || ''}`;
-  }
-  if (subtype === 'hook_started') {
-    return `[${ts}][SYSTEM][HOOK] ${entry.hook_name || ''} started`;
-  }
-  if (subtype === 'hook_response') {
-    const status = entry.outcome === 'error' ? 'FAILED' : 'OK';
-    return `[${ts}][SYSTEM][HOOK] ${entry.hook_name || ''} ${status}`;
-  }
-  return null;
-}
-
-// ─────────────────────────────────────────
-// tool_use formatting（差異 4 修正）
-// ─────────────────────────────────────────
-
-function formatToolUse(ts, block) {
-  const tool = block.name;
-  const input = block.input || {};
-
-  const toolFormatters = {
-    Bash: () => input.description || input.command?.slice(0, 60) || '',
-    Read: () => input.file_path || '',
-    Write: () => input.file_path || '',
-    Edit: () => input.file_path || '',
-    Glob: () => input.pattern || '',
-    Grep: () => input.pattern || '',
-
-    // Agent Teams 工具（與 Sunny format-output.js 對齊）
-    TeamCreate: () => `team="${input.team_name || ''}"`,
-    TeamDelete: () => '',
-    Task: () => {
-      const name = input.name || input.description?.slice(0, 30) || '';
-      const agentType = input.subagent_type || '';
-      return name ? `spawn="${name}" type=${agentType}` : agentType;
-    },
-    SendMessage: () => {
-      const recipient = input.recipient || '';
-      const msgType = input.type || 'message';
-      return `to=${recipient} type=${msgType}`;
-    },
-    TodoWrite: () => '',
-  };
-
-  const detail = (toolFormatters[tool] || (() => ''))();
-  const line = `[${ts}][Agent][${tool}] ${detail}`;
-
-  // SendMessage：附加完整訊息內容（與 Sunny 一致）
-  if (tool === 'SendMessage' && input.content) {
-    const msgLines = input.content.split('\n');
-    const formatted = msgLines.map(ml => `    | ${ml}`).join('\n');
-    return `${line}\n${formatted}`;
-  }
-
-  return line;
-}
-
-// ─────────────────────────────────────────
-// user events（差異 3 修正）
-// ─────────────────────────────────────────
-
-function formatUser(ts, entry) {
-  const parts = [];
-
-  // tool_use_result（teammate spawn 確認等）
-  if (entry.tool_use_result) {
-    const result = entry.tool_use_result;
-    if (result.status === 'teammate_spawned') {
-      parts.push(`[${ts}][SYSTEM][Spawned] Teammate "${result.name || ''}" model=${result.model || ''}`);
-    } else if (result.team_name && result.success !== undefined) {
-      const status = result.success ? 'OK' : 'FAILED';
-      parts.push(`[${ts}][SYSTEM][TeamOp] ${status}: ${result.team_name}`);
-    }
-  }
-
-  // 收到的訊息（來自 teammates 的 SendMessage）
-  if (entry.message?.content) {
-    for (const block of entry.message.content) {
-      if (block.type === 'text' && block.text) {
-        const text = block.text;
-
-        // 嘗試提取 teammate 名稱
-        let teammateName = 'Unknown';
-        const nameMatch = text.match(/(?:from|From)\s+["']?(\w+[-\w]*)["']?/i);
-        if (nameMatch) {
-          teammateName = nameMatch[1];
-        }
-
-        // 判斷是否是 teammate 訊息
-        if (text.includes('Message from') || text.includes('teammate') || text.includes('Teammate')) {
-          parts.push(`[${ts}][Teammate:${teammateName}]`);
-          const msgLines = text.split('\n').filter(l => l.trim());
-          for (const ml of msgLines) {
-            parts.push(`    | ${ml}`);
-          }
-        }
-      }
-    }
-  }
-
-  return parts.length > 0 ? parts.join('\n') : null;
-}
-
-// ─────────────────────────────────────────
-// result（session 結束摘要，加入 token 統計）
-// ─────────────────────────────────────────
-
-function formatResult(ts, entry) {
-  const lines = [];
-  lines.push(`[${ts}][RESULT] ${(entry.subtype || '').toUpperCase()}`);
-  lines.push(`  Duration: ${((entry.duration_ms || 0) / 1000).toFixed(1)}s`);
-  lines.push(`  Cost: $${(entry.total_cost_usd || 0).toFixed(4)}`);
-
-  // Token 統計（與 Sunny 對齊）
-  if (entry.num_turns) {
-    lines.push(`  Turns: ${entry.num_turns}`);
-  }
-
-  if (entry.result) {
-    const clean = entry.result.replace(/\*\*([^*]+)\*\*/g, '$1').trim();
-    const resultLines = clean.split('\n').filter(l => l.trim()).slice(0, 10);
-    for (const rl of resultLines) {
-      lines.push(`  ${rl}`);
-    }
-  }
-  return lines.join('\n');
-}
-
-module.exports = { createLogWriter, formatEntry };

package/core/.formation/tools/memory-loader.js

@@ -1,422 +0,0 @@
-/**
- * Memory Loader for Formation Prompt Builder
- * 從三個記憶系統載入相關經驗，注入到 agent prompt 中
- *
- * 系統：
- *   1. .failure/   — 失敗經驗（YAML，按 category 分目錄）
- *   2. .memory/    — 專案記憶（JSON，含 registry.json 索引）
- *   3. .kenaz/main-memory/ — 主記憶（Markdown，唯讀知識庫）
- *
- * 設計原則：
- *   - 輕量：不跑 Node 子進程，直接讀檔
- *   - 容錯：任何系統不可用時 graceful degradation
- *   - Token 友善：按任務相關度裁剪，控制總 token 預算
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-
-// ─────────────────────────────────────────
-// 配置
-// ─────────────────────────────────────────
-
-const DEFAULT_CONFIG = {
-  // Token 預算（字元數，粗略 1 token ≈ 4 chars）
-  MAX_CHARS: 3000,
-
-  // 各系統最大條目數
-  MAX_FAILURES: 3,
-  MAX_MEMORIES: 5,
-  MAX_MAIN_MEMORY: 3,
-
-  // .failure/ 路徑
-  FAILURE_DIR: path.join(ROOT, '.failure'),
-
-  // .memory/ 路徑
-  MEMORY_DIR: path.join(ROOT, '.memory'),
-  MEMORY_REGISTRY: path.join(ROOT, '.memory', 'registry.json'),
-
-  // .kenaz/main-memory/ 路徑
-  MAIN_MEMORY_DIR: path.join(ROOT, '.kenaz', 'main-memory'),
-  MAIN_MEMORY_REGISTRY: path.join(ROOT, '.kenaz', 'main-memory', 'registry.json'),
-};
-
-// Keep a mutable reference so callers that imported CONFIG still work
-const CONFIG = { ...DEFAULT_CONFIG };
-
-/**
- * Build config paths from a given core root directory.
- * When corePath differs from ROOT, re-points .failure/, .memory/, .kenaz/main-memory/
- * to the core project so sub-projects can load system-level memories.
- */
-function resolveConfig(corePath) {
-  if (!corePath || path.resolve(corePath) === path.resolve(ROOT)) {
-    return DEFAULT_CONFIG;
-  }
-  return {
-    ...DEFAULT_CONFIG,
-    FAILURE_DIR: path.join(corePath, '.failure'),
-    MEMORY_DIR: path.join(corePath, '.memory'),
-    MEMORY_REGISTRY: path.join(corePath, '.memory', 'registry.json'),
-    MAIN_MEMORY_DIR: path.join(corePath, '.kenaz', 'main-memory'),
-    MAIN_MEMORY_REGISTRY: path.join(corePath, '.kenaz', 'main-memory', 'registry.json'),
-  };
-}
-
-// ─────────────────────────────────────────
-// 主入口
-// ─────────────────────────────────────────
-
-/**
- * 載入與任務相關的記憶 context
- * @param {object} opts
- * @param {string} [opts.taskTitle]  - 任務標題
- * @param {string} [opts.role]       - 角色（frontend/backend/developer/...）
- * @param {string[]} [opts.scopePaths] - scope 路徑
- * @param {string[]} [opts.tags]     - 任務標籤
- * @param {string} [opts.priority]   - P0/P1/P2/P3
- * @param {boolean} [opts.skipFailures] - TASK_1998 R2 (+ follow-up
- *   2026-09-22): skip Known Failures (rigor:low prompt diet only — rigor:medium
- *   restores this section).
- * @param {boolean} [opts.skipMemory] - TASK_1998 R2: skip Project Memory
- *   (rigor low/medium prompt diet). Knowledge Base (main-memory) always loads
- *   regardless of either flag — it isn't part of the ritual collapse.
- * @returns {string} 組裝好的記憶 context 區塊（可直接 append 到 prompt）
- */
-function loadMemoryContext(opts = {}) {
-  // Resolve config from corePath (supports sub-projects pointing to core)
-  const cfg = resolveConfig(opts.corePath);
-  const sections = [];
-
-  // TASK_1998 R2 (+ follow-up 2026-09-22): Known Failures and Project Memory
-  // are two of the six ritual sections collapsed into prompt.js's "## Working
-  // contract" for rigor low/medium — but Known Failures is now restored for
-  // rigor:medium (only rigor:low drops it); Project Memory stays dropped for
-  // both. Knowledge Base (step 3, main-memory) is unaffected by either flag.
-  if (!opts.skipFailures) {
-    // 1. .failure/ — 失敗經驗（最高優先）
-    try {
-      const failures = loadFailures(opts, cfg);
-      if (failures.length > 0) {
-        sections.push(formatFailures(failures));
-      }
-    } catch { /* graceful degradation */ }
-  }
-
-  if (!opts.skipMemory) {
-    // 2. .memory/ — 專案記憶
-    try {
-      const memories = loadProjectMemories(opts, cfg);
-      if (memories.length > 0) {
-        sections.push(formatMemories(memories));
-      }
-    } catch { /* graceful degradation */ }
-  }
-
-  // 3. .kenaz/main-memory/ — 主記憶
-  try {
-    const mainMem = loadMainMemory(opts, cfg);
-    if (mainMem.length > 0) {
-      sections.push(formatMainMemory(mainMem));
-    }
-  } catch { /* graceful degradation */ }
-
-  if (sections.length === 0) return '';
-
-  // 組裝 + 裁剪
-  let result = sections.join('\n');
-  if (result.length > cfg.MAX_CHARS) {
-    result = result.slice(0, cfg.MAX_CHARS) + '\n...（記憶已裁剪）';
-  }
-
-  return result;
-}
-
-// ─────────────────────────────────────────
-// .failure/ 載入
-// ─────────────────────────────────────────
-
-// TASK_2371: entries from Heimdall REVERT/guardian health events and entries about
-// removed systems are stale noise in dispatch prompts. Phase 9 / cognitive checkpoint
-// entries describe the phase ritual archived in TASK_2372.
-const STALE_FAILURE_RE = /Heimdall|guardian health|Kuzu|\bNorn\b|thalamus|\breflex\b|Formation squad|\bREVERT\b|Phase 9|[Cc]ognitive checkpoint/;
-
-function loadFailures(opts, cfg = DEFAULT_CONFIG) {
-  const indexPath = path.join(cfg.FAILURE_DIR, 'INDEX.yaml');
-  if (!fs.existsSync(indexPath)) return [];
-
-  // 掃描所有子目錄的 FAIL-*.yaml 和 FAIL-*.md
-  const results = [];
-  const categories = ['agent-execution', 'code-quality', 'architecture', 'pipeline', 'data-integrity'];
-
-  for (const cat of categories) {
-    const catDir = path.join(cfg.FAILURE_DIR, cat);
-    if (!fs.existsSync(catDir)) continue;
-
-    const files = fs.readdirSync(catDir).filter(f => f.startsWith('FAIL-'));
-    for (const file of files) {
-      const filePath = path.join(catDir, file);
-      try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        if (STALE_FAILURE_RE.test(content)) continue;
-        const entry = parseFailureEntry(content, file, cat);
-        if (entry) {
-          entry.seq = Number((file.match(/(\d+)/) || [])[1] || 0);
-          entry.relevance = scoreRelevance(entry, opts);
-          results.push(entry);
-        }
-      } catch { /* skip unreadable files */ }
-    }
-  }
-
-  // Sort by relevance, then filter by task tags/category if provided, cap at MAX_FAILURES
-  results.sort((a, b) => b.relevance - a.relevance);
-  let filtered = results;
-  if (opts.tags && opts.tags.length > 0) {
-    const tagSet = new Set(opts.tags.map(t => t.toLowerCase()));
-    const tagMatches = results.filter(e => tagSet.has(e.category.replace(/-/g, '_')) || e.keywords.some(k => tagSet.has(k)));
-    if (tagMatches.length > 0) filtered = tagMatches;
-  }
-  // TASK_2371: newest first = highest FAIL number (mtime is checkout time in worktrees; relevance only decides which entries survive the tag filter)
-  return filtered.sort((a, b) => b.seq - a.seq).slice(0, cfg.MAX_FAILURES);
-}
-
-/**
- * 解析 .failure/ 條目（支援 YAML 和 Markdown 格式）
- */
-function parseFailureEntry(content, filename, category) {
-  // 提取標題
-  let title = filename;
-  const titleMatch = content.match(/^#\s+\[?(FAIL-\d+)\]?\s*(.*)/m)
-    || content.match(/title:\s*["']?(.+?)["']?\s*$/m);
-  if (titleMatch) {
-    // Markdown header: use [0] stripped; YAML title: use capture group [1]
-    title = titleMatch[0].trim().startsWith('#')
-      ? titleMatch[0].replace(/^#\s+/, '').trim()
-      : (titleMatch[1] || titleMatch[0]).replace(/['"]?/g, '').trim();
-  }
-
-  // 提取 severity
-  let severity = 'medium';
-  const sevMatch = content.match(/severity:\s*["']?(\w+)["']?/i);
-  if (sevMatch) severity = sevMatch[1].toLowerCase();
-
-  // 提取摘要（取前 3 行非空非標題內容）
-  const lines = content.split('\n');
-  const summaryLines = [];
-  let started = false;
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('_meta') || trimmed.startsWith('---') || /^\w+\s*:/.test(trimmed)) {
-      if (started) continue;
-      continue;
-    }
-    started = true;
-    summaryLines.push(trimmed);
-    if (summaryLines.length >= 3) break;
-  }
-
-  return {
-    id: filename.replace(/\.(yaml|md)$/, ''),
-    title,
-    severity,
-    category,
-    summary: summaryLines.join(' ').slice(0, 200),
-    keywords: extractKeywords(content),
-  };
-}
-
-// ─────────────────────────────────────────
-// .memory/ 載入
-// ─────────────────────────────────────────
-
-function loadProjectMemories(opts, cfg = DEFAULT_CONFIG) {
-  if (!fs.existsSync(cfg.MEMORY_REGISTRY)) return [];
-
-  let registry;
-  try {
-    registry = JSON.parse(fs.readFileSync(cfg.MEMORY_REGISTRY, 'utf-8'));
-  } catch { return []; }
-
-  const memories = registry.memories || [];
-  if (memories.length === 0) return [];
-
-  // 評分 + 排序
-  const scored = memories.map(m => ({
-    ...m,
-    relevance: scoreMemoryRelevance(m, opts),
-  }));
-
-  scored.sort((a, b) => {
-    // 先按相關度，再按 importance
-    const relDiff = b.relevance - a.relevance;
-    if (relDiff !== 0) return relDiff;
-    return (b.importance || 0) - (a.importance || 0);
-  });
-
-  // 取前 N 個，importance >= 3 的
-  return scored
-    .filter(m => (m.importance || 0) >= 3)
-    .slice(0, CONFIG.MAX_MEMORIES);
-}
-
-// ─────────────────────────────────────────
-// .kenaz/main-memory/ 載入
-// ─────────────────────────────────────────
-
-function loadMainMemory(opts, cfg = DEFAULT_CONFIG) {
-  if (!fs.existsSync(cfg.MAIN_MEMORY_REGISTRY)) return [];
-
-  let registry;
-  try {
-    registry = JSON.parse(fs.readFileSync(cfg.MAIN_MEMORY_REGISTRY, 'utf-8'));
-  } catch { return []; }
-
-  const entries = registry.entries || registry.memories || [];
-  if (entries.length === 0) return [];
-
-  // 按相關度排序
-  const scored = entries.map(e => ({
-    ...e,
-    relevance: scoreMainMemoryRelevance(e, opts),
-  }));
-
-  scored.sort((a, b) => b.relevance - a.relevance);
-  return scored.slice(0, CONFIG.MAX_MAIN_MEMORY);
-}
-
-// ─────────────────────────────────────────
-// 相關度評分
-// ─────────────────────────────────────────
-
-/**
- * .failure/ 條目相關度評分
- */
-function scoreRelevance(entry, opts) {
-  let score = 0;
-
-  // severity 加分
-  if (entry.severity === 'critical') score += 3;
-  else if (entry.severity === 'high') score += 2;
-  else if (entry.severity === 'medium') score += 1;
-
-  // 關鍵字匹配
-  if (opts.role && entry.keywords.includes(opts.role)) score += 2;
-  if (opts.taskTitle) {
-    const titleLower = opts.taskTitle.toLowerCase();
-    for (const kw of entry.keywords) {
-      if (titleLower.includes(kw)) score += 1;
-    }
-  }
-  if (opts.tags) {
-    for (const tag of opts.tags) {
-      if (entry.keywords.includes(tag.toLowerCase())) score += 1;
-    }
-  }
-
-  // agent-execution 類別對所有 agent 都相關
-  if (entry.category === 'agent-execution') score += 1;
-
-  return score;
-}
-
-/**
- * .memory/ 條目相關度評分
- */
-function scoreMemoryRelevance(entry, opts) {
-  let score = (entry.importance || 0) * 0.5;
-
-  // failure 類型加分（避免重蹈覆轍）
-  if (entry.type === 'failure') score += 2;
-  if (entry.type === 'decision') score += 1;
-
-  // 標題關鍵字匹配
-  if (opts.taskTitle && entry.title) {
-    const titleWords = opts.taskTitle.toLowerCase().split(/\s+/);
-    const entryTitle = entry.title.toLowerCase();
-    for (const w of titleWords) {
-      if (w.length > 2 && entryTitle.includes(w)) score += 1;
-    }
-  }
-
-  return score;
-}
-
-/**
- * .kenaz/main-memory/ 條目相關度評分
- */
-function scoreMainMemoryRelevance(entry, opts) {
-  let score = 1;
-
-  const entryStr = JSON.stringify(entry).toLowerCase();
-
-  if (opts.role && entryStr.includes(opts.role.toLowerCase())) score += 2;
-  if (opts.taskTitle) {
-    const words = opts.taskTitle.toLowerCase().split(/\s+/);
-    for (const w of words) {
-      if (w.length > 2 && entryStr.includes(w)) score += 1;
-    }
-  }
-
-  return score;
-}
-
-// ─────────────────────────────────────────
-// 格式化輸出
-// ─────────────────────────────────────────
-
-function formatFailures(failures) {
-  const lines = ['## Known Failures (避免重蹈覆轍)', ''];
-  for (const f of failures) {
-    const sev = f.severity === 'critical' ? '🔴' : f.severity === 'high' ? '🟠' : '🟡';
-    // Extract first sentence as lesson (ends at . or end of summary)
-    const lessonMatch = f.summary && f.summary.match(/^[^.!?]+[.!?]/);
-    const lesson = lessonMatch ? lessonMatch[0].trim() : f.summary;
-    const lessonPart = lesson ? ' — ' + lesson : '';
-    lines.push(`- ${sev} **${f.title}**${lessonPart}`);
-  }
-  lines.push('');
-  return lines.join('\n');
-}
-
-function formatMemories(memories) {
-  const lines = ['## Project Memory (歷史經驗)', ''];
-  for (const m of memories) {
-    const typeIcon = m.type === 'failure' ? '⚠️' : m.type === 'decision' ? '📌' : m.type === 'pattern' ? '✅' : 'ℹ️';
-    lines.push(`- ${typeIcon} [${m.type}] **${m.title}** (importance: ${m.importance || '?'})`);
-  }
-  lines.push('');
-  return lines.join('\n');
-}
-
-function formatMainMemory(entries) {
-  const lines = ['## Knowledge Base (通用知識)', ''];
-  for (const e of entries) {
-    const title = e.title || e.id || 'Unknown';
-    lines.push(`- 📖 ${title}`);
-    if (e.summary) lines.push(`  ${e.summary}`);
-  }
-  lines.push('');
-  return lines.join('\n');
-}
-
-// ─────────────────────────────────────────
-// 工具函數
-// ─────────────────────────────────────────
-
-/**
- * 從文字中提取關鍵字（小寫化）
- */
-function extractKeywords(text) {
-  const words = text.toLowerCase()
-    .replace(/[^a-z0-9\u4e00-\u9fff\s_-]/g, ' ')
-    .split(/\s+/)
-    .filter(w => w.length > 2);
-
-  // 去重
-  return [...new Set(words)];
-}
-
-module.exports = { loadMemoryContext, loadFailures, CONFIG };