botrun-horse 2.30.0 → 2.34.0

package/{lib → modules}/doc/pdf2text.mjs

@@ -11,7 +11,7 @@
 
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
-import { toolBin } from '../core/paths.mjs';
+import { toolBin } from '../_core/paths.mjs';
 
 const execFileAsync = promisify(execFile);
 

package/{lib → modules}/doc/split.mjs

@@ -13,7 +13,7 @@ import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { mkdir } from 'node:fs/promises';
 import path from 'node:path';
-import { toolBin } from '../core/paths.mjs';
+import { toolBin } from '../_core/paths.mjs';
 
 const execFileAsync = promisify(execFile);
 

package/{bin/commands/gemini.mjs → modules/gemini/command.mjs}

@@ -1,5 +1,5 @@
 // bin/commands/gemini.mjs — gemini 指令群組（ask）
-import { timer, emitError, readStdin } from '../../lib/core/cli-utils.mjs';
+import { timer, emitError, readStdin } from '../_core/cli-utils.mjs';
 
 export async function cmdGeminiAsk(positionals, flags) {
   const elapsed = timer();
@@ -45,7 +45,7 @@ export async function cmdGeminiAsk(positionals, flags) {
 
   try {
     if (flags['no-stream']) {
-      const { geminiAsk, formatTextOutput, formatJsonOutput } = await import('../../lib/flows/gemini-ask.mjs');
+      const { geminiAsk, formatTextOutput, formatJsonOutput } = await import('../_core/gemini-ask.mjs');
       const result = await geminiAsk(askParams);
       if (format === 'json') {
         process.stdout.write(formatJsonOutput(result, 'gemini-3-flash-preview', elapsed()) + '\n');
@@ -61,7 +61,7 @@ export async function cmdGeminiAsk(positionals, flags) {
         );
       }
     } else {
-      const { geminiAskStream, formatJsonOutput } = await import('../../lib/flows/gemini-ask.mjs');
+      const { geminiAskStream, formatJsonOutput } = await import('../_core/gemini-ask.mjs');
       const stream = geminiAskStream(askParams);
       let fullText = '';
       let meta = null;

package/modules/gemini/index.mjs

@@ -0,0 +1,41 @@
+// modules/gemini/index.mjs — Gemini AI 提問模組自動註冊介面
+// Convention: 每個 modules/<name>/index.mjs 都 export { name, schema, handler }
+
+export const name = 'gemini';
+
+export const schema = {
+  name: 'gemini',
+  description: 'Gemini 3 Flash Preview AI 提問（thinking + grounding + url context）',
+  requires_sqlite: false,
+  subcommands: { ask: '向 Gemini 提問（預設啟用深度思考、搜尋接地、URL 擷取）' },
+  options: {
+    '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
+    '--provider=<名稱>': { type: 'string', default: 'auto', description: 'LLM provider (auto|gemini|gemini-api)' },
+    '--thinking=<等級>': { type: 'string', default: 'MEDIUM', description: '思考等級 (NONE|MINIMAL|LOW|MEDIUM|HIGH)' },
+    '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
+    '--no-grounding': { type: 'boolean', default: false, description: '停用 Google Search 接地' },
+    '--no-url-context': { type: 'boolean', default: false, description: '停用 URL 內容擷取' },
+    '--no-stream': { type: 'boolean', default: false, description: '停用串流（等待完整回應）' },
+    '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
+  },
+  examples: [
+    'bh gemini ask "量子糾纏的原理是什麼？"',
+    'bh gemini ask "2026 台灣經濟預測" --format=json',
+    'echo "解釋 AI" | bh gemini ask',
+  ],
+};
+
+export async function handler(subcommand, positionals, flags) {
+  const { cmdGeminiAsk } = await import('./command.mjs');
+  switch (subcommand) {
+    case 'ask': await cmdGeminiAsk(positionals, flags); break;
+    default:
+      if (!subcommand) {
+        const { showCommandHelp } = await import('../../bin/commands/help.mjs');
+        showCommandHelp('gemini', { gemini: schema });
+      } else {
+        process.stderr.write(`gemini: 未知子指令 ${subcommand}\n`);
+        process.exit(1);
+      }
+  }
+}

package/modules/imagen/command.mjs

@@ -0,0 +1,117 @@
+// modules/imagen/command.mjs — Gemini 繪圖 CLI 指令
+// bh imagen generate|edit|serve
+
+import fs from 'fs';
+import path from 'path';
+import { timer, emitError, readStdin } from '../_core/cli-utils.mjs';
+
+/**
+ * bh imagen generate "prompt" [--model=...] [--size=...] [--aspect=...] [--output=...]
+ */
+export async function cmdImagenGenerate(positionals, flags) {
+  const elapsed = timer();
+  const format = flags.format || 'text';
+
+  // prompt 來源：positional 或 stdin
+  let prompt = positionals.join(' ');
+  if (!prompt) {
+    const stdin = await readStdin();
+    prompt = stdin?.trim();
+  }
+  if (!prompt) {
+    emitError('imagen generate', '請提供繪圖提示。用法: bh imagen generate "一隻貓坐在月亮上"', format);
+    process.exit(1);
+  }
+
+  const { generateImage } = await import('./imagen-client.mjs');
+  const opts = {
+    model: flags.model,
+    size: flags.size,
+    aspect: flags.aspect,
+  };
+
+  process.stderr.write(`繪圖中: ${prompt.slice(0, 50)}${prompt.length > 50 ? '...' : ''}\n`);
+
+  const result = await generateImage(prompt, opts);
+
+  // 決定輸出檔名
+  const output = flags.output || `imagen-${Date.now()}.png`;
+  const outPath = path.resolve(output);
+  fs.writeFileSync(outPath, result.imageBuffer);
+
+  if (format === 'json') {
+    process.stdout.write(JSON.stringify({
+      _meta: { tool: 'bh imagen generate', elapsedMs: elapsed() },
+      prompt,
+      output: outPath,
+      text: result.text,
+      size: result.imageBuffer.length,
+    }, null, 2) + '\n');
+  } else {
+    process.stdout.write(`${outPath}\n`);
+    if (result.text) process.stderr.write(`模型回覆: ${result.text}\n`);
+    process.stderr.write(`已儲存 ${(result.imageBuffer.length / 1024).toFixed(1)} KB (${elapsed()} ms)\n`);
+  }
+}
+
+/**
+ * bh imagen edit <image-path> "prompt" [--model=...] [--size=...] [--output=...]
+ */
+export async function cmdImagenEdit(positionals, flags) {
+  const elapsed = timer();
+  const format = flags.format || 'text';
+
+  const imagePath = positionals[0];
+  const prompt = positionals.slice(1).join(' ');
+
+  if (!imagePath || !prompt) {
+    emitError('imagen edit', '用法: bh imagen edit <圖片路徑> "把背景換成海灘"', format);
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(imagePath)) {
+    emitError('imagen edit', `檔案不存在: ${imagePath}`, format);
+    process.exit(1);
+  }
+
+  const { editImage } = await import('./imagen-client.mjs');
+  const imageBuffer = fs.readFileSync(imagePath);
+  const ext = path.extname(imagePath).toLowerCase();
+  const mimeType = ext === '.jpg' || ext === '.jpeg' ? 'image/jpeg' : 'image/png';
+
+  process.stderr.write(`編輯中: ${path.basename(imagePath)} → ${prompt.slice(0, 50)}...\n`);
+
+  const result = await editImage(imageBuffer, prompt, {
+    model: flags.model,
+    size: flags.size,
+    mimeType,
+  });
+
+  const output = flags.output || `imagen-edit-${Date.now()}.png`;
+  const outPath = path.resolve(output);
+  fs.writeFileSync(outPath, result.imageBuffer);
+
+  if (format === 'json') {
+    process.stdout.write(JSON.stringify({
+      _meta: { tool: 'bh imagen edit', elapsedMs: elapsed() },
+      input: path.resolve(imagePath),
+      prompt,
+      output: outPath,
+      text: result.text,
+      size: result.imageBuffer.length,
+    }, null, 2) + '\n');
+  } else {
+    process.stdout.write(`${outPath}\n`);
+    if (result.text) process.stderr.write(`模型回覆: ${result.text}\n`);
+    process.stderr.write(`已儲存 ${(result.imageBuffer.length / 1024).toFixed(1)} KB (${elapsed()} ms)\n`);
+  }
+}
+
+/**
+ * bh imagen serve [--port=3000]
+ */
+export async function cmdImagenServe(flags) {
+  const port = Number(flags.port) || 3000;
+  const { startServer } = await import('./server.mjs');
+  await startServer({ port });
+}

package/modules/imagen/imagen-client.mjs

@@ -0,0 +1,239 @@
+// modules/imagen/imagen-client.mjs — Gemini 繪圖核心 library
+// 支援：文字生圖、圖片編輯、多輪 session 對話式編輯
+// 模型：gemini-3.1-flash-image-preview（預設）、gemini-3-pro-image-preview（Pro）
+// SDK：@google/genai
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/** 預設模型與設定 */
+const DEFAULTS = {
+  model: 'gemini-3.1-flash-image-preview',
+  size: '1K',           // '512px' | '1K' | '2K' | '4K'
+  aspect: '1:1',       // '1:1' | '16:9' | '9:16' | '3:2' | '4:3' 等
+  mimeType: 'image/png',
+};
+
+/** 合法的解析度 */
+const VALID_SIZES = ['512px', '1K', '2K', '4K'];
+
+/** 合法的長寬比 */
+const VALID_ASPECTS = [
+  '1:1', '1:4', '1:8', '2:3', '3:2', '3:4', '4:1',
+  '4:3', '4:5', '5:4', '8:1', '9:16', '16:9', '21:9',
+];
+
+/**
+ * 建立 GoogleGenAI 實例
+ * @returns {import('@google/genai').GoogleGenAI}
+ */
+function createClient() {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    throw new Error('GEMINI_API_KEY 環境變數未設定。請先設定 API Key。');
+  }
+  // 動態 import 避免頂層載入失敗
+  const { GoogleGenAI } = require('@google/genai');
+  return new GoogleGenAI({ apiKey });
+}
+
+/** lazy import（ESM 動態 import） */
+let _genaiModule = null;
+async function getGenAI() {
+  if (!_genaiModule) {
+    _genaiModule = await import('@google/genai');
+  }
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    throw new Error('GEMINI_API_KEY 環境變數未設定。請先設定 API Key。');
+  }
+  return new _genaiModule.GoogleGenAI({ apiKey });
+}
+
+/**
+ * 從 response 中提取圖片與文字
+ * @param {object} response - generateContent 回應
+ * @returns {{ text: string|null, imageBuffer: Buffer|null, mimeType: string|null }}
+ */
+export function extractResult(response) {
+  let text = null;
+  let imageBuffer = null;
+  let mimeType = null;
+
+  const parts = response?.candidates?.[0]?.content?.parts || [];
+  for (const part of parts) {
+    if (part.thought) continue; // 跳過 thinking 部分
+    if (part.text) {
+      text = (text || '') + part.text;
+    } else if (part.inlineData) {
+      imageBuffer = Buffer.from(part.inlineData.data, 'base64');
+      mimeType = part.inlineData.mimeType || 'image/png';
+    }
+  }
+
+  return { text, imageBuffer, mimeType };
+}
+
+/**
+ * 驗證設定參數
+ * @param {object} opts
+ */
+function validateOpts(opts) {
+  if (opts.size && !VALID_SIZES.includes(opts.size)) {
+    throw new Error(`無效的解析度「${opts.size}」，可用: ${VALID_SIZES.join(', ')}`);
+  }
+  if (opts.aspect && !VALID_ASPECTS.includes(opts.aspect)) {
+    throw new Error(`無效的長寬比「${opts.aspect}」，可用: ${VALID_ASPECTS.join(', ')}`);
+  }
+}
+
+/**
+ * 文字生圖
+ * @param {string} prompt - 繪圖提示（支援繁體中文）
+ * @param {object} [opts] - 選項
+ * @param {string} [opts.model] - 模型 ID
+ * @param {string} [opts.size] - 解析度: '512px' | '1K' | '2K' | '4K'
+ * @param {string} [opts.aspect] - 長寬比: '1:1' | '16:9' 等
+ * @returns {Promise<{ text: string|null, imageBuffer: Buffer, mimeType: string }>}
+ */
+export async function generateImage(prompt, opts = {}) {
+  const model = opts.model || DEFAULTS.model;
+  const size = opts.size || DEFAULTS.size;
+  const aspect = opts.aspect || DEFAULTS.aspect;
+  validateOpts({ size, aspect });
+
+  const ai = await getGenAI();
+
+  const response = await ai.models.generateContent({
+    model,
+    contents: prompt,
+    config: {
+      responseModalities: ['TEXT', 'IMAGE'],
+      imageConfig: {
+        imageSize: size,
+        aspectRatio: aspect,
+      },
+    },
+  });
+
+  const result = extractResult(response);
+  if (!result.imageBuffer) {
+    throw new Error('模型未回傳圖片。可能因安全過濾被拒絕，請調整 prompt。');
+  }
+  return result;
+}
+
+/**
+ * 編輯既有圖片
+ * @param {Buffer|string} image - 圖片 Buffer 或 base64 字串
+ * @param {string} prompt - 編輯指示（支援繁體中文）
+ * @param {object} [opts] - 選項
+ * @param {string} [opts.model] - 模型 ID
+ * @param {string} [opts.size] - 解析度
+ * @param {string} [opts.mimeType] - 輸入圖片 MIME type（預設 image/png）
+ * @returns {Promise<{ text: string|null, imageBuffer: Buffer, mimeType: string }>}
+ */
+export async function editImage(image, prompt, opts = {}) {
+  const model = opts.model || DEFAULTS.model;
+  const size = opts.size || DEFAULTS.size;
+  const inputMime = opts.mimeType || DEFAULTS.mimeType;
+  validateOpts({ size });
+
+  const base64 = Buffer.isBuffer(image) ? image.toString('base64') : image;
+
+  const ai = await getGenAI();
+
+  const response = await ai.models.generateContent({
+    model,
+    contents: [
+      { text: prompt },
+      { inlineData: { mimeType: inputMime, data: base64 } },
+    ],
+    config: {
+      responseModalities: ['TEXT', 'IMAGE'],
+      imageConfig: { imageSize: size },
+    },
+  });
+
+  const result = extractResult(response);
+  if (!result.imageBuffer) {
+    throw new Error('模型未回傳編輯後的圖片。請調整 prompt 或更換圖片。');
+  }
+  return result;
+}
+
+/**
+ * 建立多輪對話式繪圖 session
+ * @param {object} [opts] - 選項
+ * @param {string} [opts.model] - 模型 ID
+ * @param {string} [opts.size] - 預設解析度
+ * @param {string} [opts.aspect] - 預設長寬比
+ * @returns {Promise<ImageSession>}
+ */
+export async function createSession(opts = {}) {
+  const model = opts.model || DEFAULTS.model;
+  const size = opts.size || DEFAULTS.size;
+  const aspect = opts.aspect || DEFAULTS.aspect;
+  validateOpts({ size, aspect });
+
+  const ai = await getGenAI();
+
+  const chat = ai.chats.create({
+    model,
+    config: {
+      responseModalities: ['TEXT', 'IMAGE'],
+      imageConfig: {
+        imageSize: size,
+        aspectRatio: aspect,
+      },
+    },
+  });
+
+  return new ImageSession(chat);
+}
+
+/**
+ * 多輪對話式繪圖 Session
+ * 保留上下文，可反覆修改同一張圖片
+ */
+export class ImageSession {
+  /** @param {object} chat - ai.chats.create() 的回傳 */
+  constructor(chat) {
+    this._chat = chat;
+    this._turnCount = 0;
+  }
+
+  /** 目前的對話輪次 */
+  get turnCount() { return this._turnCount; }
+
+  /**
+   * 傳送訊息（純文字或文字+圖片）
+   * @param {string} prompt - 指示
+   * @param {object} [opts]
+   * @param {Buffer|string} [opts.image] - 附加圖片（Buffer 或 base64）
+   * @param {string} [opts.mimeType] - 圖片 MIME type
+   * @returns {Promise<{ text: string|null, imageBuffer: Buffer|null, mimeType: string|null }>}
+   */
+  async send(prompt, opts = {}) {
+    let message;
+    if (opts.image) {
+      const base64 = Buffer.isBuffer(opts.image) ? opts.image.toString('base64') : opts.image;
+      message = [
+        { text: prompt },
+        { inlineData: { mimeType: opts.mimeType || 'image/png', data: base64 } },
+      ];
+    } else {
+      message = prompt;
+    }
+
+    const response = await this._chat.sendMessage({ message });
+    this._turnCount++;
+    return extractResult(response);
+  }
+}
+
+// 匯出常數供外部使用
+export { DEFAULTS, VALID_SIZES, VALID_ASPECTS };

package/modules/imagen/index.mjs

@@ -0,0 +1,60 @@
+// modules/imagen/index.mjs — Gemini 繪圖模組自動註冊介面
+
+export const name = 'imagen';
+
+export const schema = {
+  name: 'imagen',
+  description: 'Gemini 繪圖（文字生圖、圖片編輯、多輪 session、Hono API）',
+  requires_sqlite: false,
+  subcommands: {
+    generate: '文字生圖（支援繁體中文 prompt）',
+    edit: '編輯既有圖片（傳入圖片 + 指示）',
+    serve: '啟動 Hono API 伺服器',
+  },
+  options: {
+    '--model=<名稱>': { type: 'string', default: 'gemini-3.1-flash-image-preview', description: '模型 ID（gemini-3.1-flash-image-preview | gemini-3-pro-image-preview）' },
+    '--size=<解析度>': { type: 'string', default: '1K', description: '解析度（1K | 2K | 4K | 512px）' },
+    '--aspect=<比例>': { type: 'string', default: '1:1', description: '長寬比（1:1 | 16:9 | 9:16 | 3:2 | 4:3 等）' },
+    '--output=<路徑>': { type: 'string', description: '輸出檔案路徑（預設 imagen-<timestamp>.png）' },
+    '--port=N': { type: 'integer', default: 3000, description: '[serve] API 伺服器 port' },
+    '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
+  },
+  examples: [
+    'bh imagen generate "一隻貓坐在月亮上"',
+    'bh imagen generate "科幻城市" --size=2K --aspect=16:9',
+    'bh imagen generate "logo 設計" --model=gemini-3-pro-image-preview --output=logo.png',
+    'echo "水彩風格的台北101" | bh imagen generate',
+    'bh imagen edit photo.png "把背景換成日落海灘"',
+    'bh imagen edit input.jpg "加上聖誕帽" --output=xmas.png',
+    'bh imagen serve --port=3000',
+    'curl -X POST http://localhost:3000/api/imagen/generate -H "Content-Type: application/json" -d \'{"prompt":"一隻柴犬"}\'  -o dog.png',
+  ],
+};
+
+export async function handler(subcommand, positionals, flags) {
+  switch (subcommand) {
+    case 'generate': {
+      const { cmdImagenGenerate } = await import('./command.mjs');
+      await cmdImagenGenerate(positionals, flags);
+      break;
+    }
+    case 'edit': {
+      const { cmdImagenEdit } = await import('./command.mjs');
+      await cmdImagenEdit(positionals, flags);
+      break;
+    }
+    case 'serve': {
+      const { cmdImagenServe } = await import('./command.mjs');
+      await cmdImagenServe(flags);
+      break;
+    }
+    default:
+      if (!subcommand) {
+        const { showCommandHelp } = await import('../../bin/commands/help.mjs');
+        showCommandHelp('imagen', { imagen: schema });
+      } else {
+        process.stderr.write(`imagen: 未知子指令 ${subcommand}\n`);
+        process.exit(1);
+      }
+  }
+}

package/modules/imagen/server.mjs

@@ -0,0 +1,133 @@
+// modules/imagen/server.mjs — Gemini 繪圖 Hono API
+// POST /api/imagen/generate — 文字生圖
+// POST /api/imagen/edit — 圖片編輯
+// POST /api/imagen/session — 多輪對話式編輯
+// GET  /health — 健康檢查
+
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+
+const app = new Hono();
+app.use('/*', cors());
+
+// 記憶體中的 session 快取（production 可替換為 Redis）
+const sessions = new Map();
+let sessionSeq = 0;
+
+// ===== 健康檢查 =====
+app.get('/health', (c) => c.json({ status: 'ok', module: 'imagen' }));
+
+// ===== 文字生圖 =====
+app.post('/api/imagen/generate', async (c) => {
+  const { prompt, model, size, aspect } = await c.req.json();
+  if (!prompt) return c.json({ error: 'prompt 為必填' }, 400);
+
+  const { generateImage } = await import('./imagen-client.mjs');
+  const result = await generateImage(prompt, { model, size, aspect });
+
+  if (c.req.query('format') === 'json') {
+    return c.json({
+      prompt,
+      text: result.text,
+      image: result.imageBuffer.toString('base64'),
+      mimeType: result.mimeType,
+      size: result.imageBuffer.length,
+    });
+  }
+
+  c.header('Content-Type', result.mimeType || 'image/png');
+  c.header('X-Imagen-Text', encodeURIComponent(result.text || ''));
+  return c.body(result.imageBuffer);
+});
+
+// ===== 圖片編輯 =====
+app.post('/api/imagen/edit', async (c) => {
+  const { prompt, image, model, size, mimeType } = await c.req.json();
+  if (!prompt || !image) return c.json({ error: 'prompt 與 image(base64) 為必填' }, 400);
+
+  const { editImage } = await import('./imagen-client.mjs');
+  const result = await editImage(image, prompt, { model, size, mimeType });
+
+  if (c.req.query('format') === 'json') {
+    return c.json({
+      prompt,
+      text: result.text,
+      image: result.imageBuffer.toString('base64'),
+      mimeType: result.mimeType,
+      size: result.imageBuffer.length,
+    });
+  }
+
+  c.header('Content-Type', result.mimeType || 'image/png');
+  return c.body(result.imageBuffer);
+});
+
+// ===== 多輪 Session 編輯 =====
+app.post('/api/imagen/session', async (c) => {
+  const { sessionId, prompt, image, model, size, aspect, mimeType } = await c.req.json();
+  if (!prompt) return c.json({ error: 'prompt 為必填' }, 400);
+
+  let session;
+  if (sessionId && sessions.has(sessionId)) {
+    session = sessions.get(sessionId);
+  } else {
+    const { createSession } = await import('./imagen-client.mjs');
+    session = await createSession({ model, size, aspect });
+    sessionSeq++;
+    const newId = `s-${sessionSeq}-${Date.now()}`;
+    sessions.set(newId, session);
+    session._id = newId;
+  }
+
+  const sendOpts = {};
+  if (image) {
+    sendOpts.image = image; // base64
+    sendOpts.mimeType = mimeType;
+  }
+
+  const result = await session.send(prompt, sendOpts);
+
+  return c.json({
+    sessionId: session._id,
+    turnCount: session.turnCount,
+    text: result.text,
+    image: result.imageBuffer?.toString('base64') || null,
+    mimeType: result.mimeType,
+  });
+});
+
+// ===== 列出活躍 sessions =====
+app.get('/api/imagen/sessions', (c) => {
+  const list = [];
+  for (const [id, s] of sessions) {
+    list.push({ sessionId: id, turnCount: s.turnCount });
+  }
+  return c.json({ sessions: list });
+});
+
+// ===== 刪除 session =====
+app.delete('/api/imagen/session/:id', (c) => {
+  const id = c.req.param('id');
+  const deleted = sessions.delete(id);
+  return c.json({ deleted, sessionId: id });
+});
+
+export { app };
+
+/**
+ * 啟動 Hono 伺服器
+ * @param {object} opts
+ * @param {number} opts.port
+ */
+export async function startServer({ port = 3000 } = {}) {
+  const { serve } = await import('@hono/node-server');
+  serve({ fetch: app.fetch, port }, (info) => {
+    process.stderr.write(`imagen API 伺服器啟動: http://localhost:${info.port}\n`);
+    process.stderr.write(`\n端點:\n`);
+    process.stderr.write(`  POST /api/imagen/generate   文字生圖\n`);
+    process.stderr.write(`  POST /api/imagen/edit       圖片編輯\n`);
+    process.stderr.write(`  POST /api/imagen/session    多輪 session 編輯\n`);
+    process.stderr.write(`  GET  /api/imagen/sessions   列出活躍 sessions\n`);
+    process.stderr.write(`  GET  /health                健康檢查\n`);
+  });
+}

package/{bin/commands/legal.mjs → modules/legal/command.mjs}

@@ -11,8 +11,8 @@
 //   node --experimental-sqlite bin/bh.mjs legal cache stats [--project=legal-cache]
 //   node --experimental-sqlite bin/bh.mjs legal cache clear [--project=legal-cache]
 
-import { timer, emitError, readStdin } from '../../lib/core/cli-utils.mjs';
-import { projectConfig as resolveConfigPath, dbPath as resolveDbPath } from '../../lib/core/paths.mjs';
+import { timer, emitError, readStdin } from '../_core/cli-utils.mjs';
+import { projectConfig as resolveConfigPath, dbPath as resolveDbPath } from '../_core/paths.mjs';
 import fs from 'fs';
 
 // ── 輔助：載入專案 config.json ──────────────────────────────────────────────
@@ -56,7 +56,7 @@ export async function cmdLegalAsk(positionals, flags) {
   }
 
   try {
-    const { legalAsk, formatLegalResult, formatLegalResultJson } = await import('../../lib/flows/legal-ask.mjs');
+    const { legalAsk, formatLegalResult, formatLegalResultJson } = await import('../_core/legal-ask.mjs');
 
     const result = await legalAsk({
       question: question.trim(),
@@ -94,7 +94,7 @@ export async function cmdLegalCacheList(flags) {
   const limit = flags.limit ? parseInt(flags.limit) : 20;
 
   try {
-    const { AiCache } = await import('../../lib/core/ai-cache.mjs');
+    const { AiCache } = await import('../_core/ai-cache.mjs');
     const dbPath = resolveDbPath(project);
 
     if (!fs.existsSync(dbPath)) {
@@ -137,7 +137,7 @@ export async function cmdLegalCacheStats(flags) {
   const project = flags.project || 'legal-cache';
 
   try {
-    const { AiCache } = await import('../../lib/core/ai-cache.mjs');
+    const { AiCache } = await import('../_core/ai-cache.mjs');
     const dbPath = resolveDbPath(project);
 
     if (!fs.existsSync(dbPath)) {