@bolloon/bolloon-agent 0.1.36 → 0.1.38

package/src/index.ts

@@ -1,1724 +0,0 @@
-import {
-  HyperswarmCommunicator,
-  createHyperswarmCommunicator,
-  createTopic,
-  KeyManager,
-  AgentAuthManager,
-  AgentVerificationManager,
-  createVerificationManager,
-  type P2PMessage,
-  type P2PConnection,
-} from '@diap/sdk';
-import { irohTransport } from './network/iroh-transport.js';
-import { HybridMessenger } from './network/hybrid-messenger.js';
-import * as ed25519 from '@noble/ed25519';
-import { sha512 } from '@noble/hashes/sha2.js';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { documentReader } from './documents/reader.js';
-import { initMinimax } from './constraints/index.js';
-import { createAgentSession } from './agents/pi-sdk.js';
-import { createSubAgentManager } from './agents/subagent-manager.js';
-import { getGlobalSharedContext } from './social/global-shared-context.js';
-import { BollharnessIntegration, createBollharnessIntegration } from './bollharness-integration/index.js';
-import * as readline from 'readline';
-// 启动时自动检查更新已禁用 (改用 --update-check / --update-now 显式触发)
-
-
-const RESET = '\x1b[0m';
-const BOLD = '\x1b[1m';
-const DIM = '\x1b[2m';
-const CYAN = '\x1b[36m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const BLUE = '\x1b[34m';
-const MAGENTA = '\x1b[35m';
-const WHITE = '\x1b[37m';
-const GRAY = '\x1b[90m';
-const BG_WHITE = '\x1b[47m';
-const BG_BLUE = '\x1b[44m';
-const BLACK = '\x1b[30m';
-const MOVE_UP = '\x1b[A';
-const CLEAR_LINE = '\x1b[2K';
-const HIDE_CURSOR = '\x1b[?25l';
-const SHOW_CURSOR = '\x1b[?25h';
-
-const s = {
-  banner: () => console.log(`\n${CYAN}${BOLD}
-   ╔═══════════════════════════════════════════╗
-   ║      ${WHITE}🤖 Bolloon ${CYAN}                       ║
-   ║      ${WHITE}P2P AI Document Processor${CYAN}                ║
-   ╚═══════════════════════════════════════════╝${RESET}\n`),
-
-  step: (num: number, total: number, text: string, status?: 'ok' | 'loading' | 'warn' | 'error') => {
-    const check = status === 'ok' ? `${GREEN}✓` :
-                  status === 'loading' ? `${YELLOW}⟳` :
-                  status === 'warn' ? `${YELLOW}⚠` :
-                  status === 'error' ? `${MAGENTA}✗` :
-                  `${CYAN}●`;
-    console.log(`  ${check} ${WHITE}[${num}/${total}]${GRAY} ${text}${RESET}`);
-  },
-
-  success: (text: string) => console.log(`  ${GREEN}✓${RESET} ${text}`),
-  warn: (text: string) => console.log(`  ${YELLOW}⚠${RESET} ${text}`),
-  error: (text: string) => console.log(`  ${MAGENTA}✗${RESET} ${text}`),
-  info: (text: string) => console.log(`  ${CYAN}●${RESET} ${text}`),
-
-  section: (title: string) => {
-    console.log(`\n${BLUE}━━━ ${WHITE}${BOLD}${title}${RESET} ${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}`);
-  },
-
-  divider: () => console.log(`\n${GRAY}${'─'.repeat(50)}${RESET}\n`),
-
-  prompt: (text: string) => console.log(`\n${CYAN}❯ ${WHITE}${text}${RESET}`),
-
-  response: (label: string, content: string) => {
-    console.log(`\n${GREEN}${label}${RESET}\n${content}\n`);
-  },
-
-  agentCard: (agent: { name: string; id: string; status: string; capabilities: string[]; did?: string }) => {
-    const statusColor = agent.status === 'active' ? GREEN :
-                        agent.status === 'idle' ? YELLOW :
-                        agent.status === 'busy' ? MAGENTA : GRAY;
-    console.log(`  ${WHITE}${BOLD}${agent.name}${RESET}`);
-    console.log(`    ${GRAY}ID:${RESET} ${agent.id}`);
-    console.log(`    ${GRAY}状态:${RESET} ${statusColor}${agent.status}${RESET}`);
-    console.log(`    ${GRAY}能力:${RESET} ${agent.capabilities.join(', ')}`);
-    if (agent.did) console.log(`    ${GRAY}DID:${RESET} ${agent.did}`);
-    console.log();
-  },
-
-  Thinking: () => {
-    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-    let i = 0;
-    return setInterval(() => {
-      process.stdout.write(`\r  ${YELLOW}${frames[i++ % frames.length]} 思考中...${RESET}    `);
-    }, 80);
-  },
-
-  clearThinking: (interval: ReturnType<typeof setInterval>) => {
-    clearInterval(interval);
-    process.stdout.write('\r' + ' '.repeat(30) + '\r');
-  },
-
-  dialog: async (title: string, promptText: string): Promise<string> => {
-    return new Promise((resolve) => {
-      const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-      });
-
-      rl.question(`${CYAN}❯ ${RESET}`, (input) => {
-        rl.close();
-        resolve(input.trim());
-      });
-    });
-  }
-};
-
-// @ts-ignore - noble/ed25519 v3 requires sha512 to be set
-(ed25519.hashes as any).sha512 = sha512;
-
-// ---------------------------------------------------------------------------
-// Message envelope
-//   Sender wraps:  DID:<hex_did>|{"id":"...","type":"summarize|improve","documentPath":"...","requirements":"..."}
-//   So receiver can verify identity before dispatching
-// ---------------------------------------------------------------------------
-
-type TaskType = 'summarize' | 'improve';
-
-interface RpcTask {
-  id: string;
-  type: TaskType;
-  documentPath?: string;
-  requirements?: string;
-  from: string;          // DID of sender, extracted from message prefix
-}
-
-// ---------------------------------------------------------------------------
-// Harness loop  ─  poll-free event-driven (Hyperswarm DHT 自动推送)
-// ---------------------------------------------------------------------------
-
-/** 原始 Hyperswarm stream 缓存； HyperswarmCommunicator.sendToConnection 只打日志不写流 */
-const rawStreams = new Map<string, any>();
-
-function sendRawMsg(conn: P2PConnection, text: string): void {
-  const raw = rawStreams.get(conn as any);
-  if (raw && raw.writable) raw.write(Buffer.from(text));
-}
-
-// ---------------------------------------------------------------------------
-// DIAP 身份初始化  ─  KeyManager → DID → DID Builder → IPFS publish
-// ---------------------------------------------------------------------------
-
-function getUserName(): string {
-  const home = process.env.HOME || process.env.USERPROFILE || '';
-  const match = home.match(/\/Users\/(\w+)/);
-  if (match) return match[1];
-  const user = process.env.USERNAME || process.env.USER || 'user';
-  return user.toLowerCase().replace(/[^a-z0-9]/g, '');
-}
-
-async function bootstrapIdentity(): Promise<{ keypair: import('@diap/sdk').KeyPair; did: string; name: string }> {
-  s.step(1, 5, '生成 DIAP 身份', 'loading');
-  const kp = KeyManager.generate();
-  const did = kp.did;
-  const username = getUserName();
-  const suffix = did.split(':').pop()?.substring(0, 4);
-  const name = `blln-${username}-${suffix}`;
-  console.log(`     ${GRAY}DID:${RESET} ${did}`);
-  console.log(`     ${GRAY}名称:${RESET} ${name}`);
-  s.step(1, 5, '生成 DIAP 身份', 'ok');
-  return { keypair: kp, did, name };
-}
-
-function publishDID(name: string, kp: import('@diap/sdk').KeyPair): Promise<{ cid?: string; ipnsName?: string }> {
-  s.step(2, 5, '发布 DID → IPFS (后台)', 'loading');
-
-  return new Promise((resolve) => {
-    const attempt = async () => {
-      let lastLogTime = 0;
-      const retryWithBackoff = async (retries: number): Promise<void> => {
-        try {
-          const auth = await AgentAuthManager.newWithRemoteIpfs('http://127.0.0.1:5001', 'http://127.0.0.1:8080');
-          const result = await auth.registerAgent({ name, services: [] }, kp, '');
-          s.step(2, 5, '发布 DID → IPFS', 'ok');
-          resolve({ cid: result.cid });
-        } catch (e: any) {
-          const now = Date.now();
-          if (now - lastLogTime > 30000) {
-            process.stdout.write(`     ${YELLOW}⏳ IPNS发布中 (失败${retries}次), 后台重试...${RESET}\r`);
-            lastLogTime = now;
-          }
-          if (retries < 10) {
-            setTimeout(() => retryWithBackoff(retries + 1), 60000);
-          } else {
-            process.stdout.write(`     ${YELLOW}⚠ IPNS发布重试结束，本地模式运行${RESET}\n`);
-            resolve({});
-          }
-        }
-      };
-
-      setTimeout(() => retryWithBackoff(1), 100);
-    };
-
-    attempt();
-  });
-}
-
-// ---------------------------------------------------------------------------
-// P2P 节点初始化
-// ---------------------------------------------------------------------------
-
-async function bootstrapP2P(
-  verifier: AgentVerificationManager,
-): Promise<HyperswarmCommunicator> {
-  s.step(3, 5, '启动 P2P 网络', 'loading');
-  const rawSeed = crypto.getRandomValues(new Uint8Array(32));
-  const seed: any = rawSeed;
-  const comm = createHyperswarmCommunicator({ server: true, client: true, autoConnect: true, maxConnections: 50, seed });
-
-  comm.on('connection', (conn: P2PConnection) => {
-    const shortId = conn.publicKey.substring(0, 8);
-    s.info(`🔌 连接: ${shortId}...`);
-    const all: Map<string, P2PConnection> = (comm as any).connections as Map<string, P2PConnection>;
-    for (const [k, v] of all) {
-      if (v.publicKey === conn.publicKey) {
-        rawStreams.set(v['id'], (comm as any)['__pendingStream']);
-        break;
-      }
-    }
-  });
-
-  comm.on('message', async (msg: P2PMessage, conn: P2PConnection) => {
-    const content = new TextDecoder().decode(msg.content);
-    const shortId = conn.publicKey.substring(0, 8);
-    s.prompt(`📩 收到 ${shortId}: ${content.substring(0, 50)}...`);
-    const reply = await dispatchTask(content);
-    sendRawMsg(conn, reply);
-  });
-
-  await comm.start();
-  const topic = createTopic('bolloon-agent-harness') as Buffer;
-  await comm.joinTopic(topic);
-  console.log(`     ${GRAY}主题:${RESET} ${topic.slice(0, 8).toString('hex')}...`);
-  s.step(3, 5, '启动 P2P 网络', 'ok');
-  return comm;
-}
-
-// ---------------------------------------------------------------------------
-// iroh/Hybrid P2P 初始化
-// ---------------------------------------------------------------------------
-
-async function bootstrapIroh(keypair: any, name: string): Promise<void> {
-  s.step(4, 5, '启动 iroh P2P', 'loading');
-
-  try {
-    const node = await irohTransport.start();
-    console.log(`     ${GRAY}iroh:${RESET} ${node.nodeId.substring(0, 16)}...`);
-
-    hybridMessenger = new HybridMessenger({
-      preferIrohForLarge: true,
-      largeThresholdBytes: 64 * 1024,
-      enableRelay: true,
-    });
-
-    hybridMessenger.onMessage('task', async (msg) => {
-      console.log(`[iroh] Task from ${msg.from.substring(0, 12)}...: ${new TextDecoder().decode(msg.payload).substring(0, 50)}...`);
-    });
-
-    hybridMessenger.onMessage('blob', async (msg) => {
-      console.log(`[iroh] Blob from ${msg.from.substring(0, 12)}...: ${msg.payload.length} bytes`);
-    });
-
-    hybridMessenger.onMessage('response', async (msg) => {
-      console.log(`[iroh] Response from ${msg.from.substring(0, 12)}...`);
-    });
-
-    if (agentIdentity) {
-      agentIdentity.irohNodeId = node.nodeId;
-    }
-
-    s.step(4, 5, '启动 iroh P2P', 'ok');
-  } catch (e: any) {
-    s.step(4, 5, '启动 iroh P2P', 'warn');
-    console.log(`     ${YELLOW}iroh 启动失败: ${e.message}${RESET}`);
-    console.log(`     ${GRAY}继续使用 Hyperswarm P2P${RESET}`);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Agent 懒加载
-// ---------------------------------------------------------------------------
-
-let agent: Awaited<ReturnType<typeof createAgentSession>> | null = null;
-let harness: BollharnessIntegration | null = null;
-let hybridMessenger: HybridMessenger | null = null;
-let agentIdentity: {
-  did: string;
-  name: string;
-  publicKey: string;
-  peerId?: string;
-  p2pChannel?: string;
-  cid?: string;
-  ipnsName?: string;
-  irohNodeId?: string;
-} | null = null;
-
-async function getAgent() {
-  if (!agent) {
-    const identityDoc = agentIdentity ? {
-      did: agentIdentity.did,
-      name: agentIdentity.name,
-      publicKey: agentIdentity.publicKey,
-      createdAt: Date.now(),
-      peerId: agentIdentity.peerId,
-      p2pChannel: agentIdentity.p2pChannel,
-      cid: agentIdentity.cid,
-      ipnsName: agentIdentity.ipnsName
-    } : undefined;
-    agent = await createAgentSession({
-      cwd: process.cwd(),
-      peerId: 'harness',
-      identityDoc
-    });
-  }
-  return agent;
-}
-
-// ---------------------------------------------------------------------------
-// Dispatch
-// ---------------------------------------------------------------------------
-
-async function dispatchTask(raw: string): Promise<string> {
-  const body = raw.startsWith('DID:') ? raw.split('|', 1)[1] || '' : raw;
-  const task = safeParse<RpcTask>(body);
-  if (!task) return `ERR|${JSON.stringify({ code: 'bad_format' })}`;
-
-  console.log(`\n📥 [${task.type}]  from=${task.from?.substring(0, 18)}...  id=${task.id}`);
-  try {
-    switch (task.type) {
-      case 'summarize':
-        return await handleSummarize(task);
-      case 'improve':
-        return await handleImprove(task);
-      default:
-        return `ERR|${JSON.stringify({ code: 'unknown', type: task.type })}`;
-    }
-  } catch (e: any) {
-    return `ERR|${JSON.stringify({ code: 'error', msg: e.message })}`;
-  }
-}
-
-async function handleSummarize(task: RpcTask): Promise<string> {
-  if (!task.documentPath) return `ERR|${JSON.stringify({ code: 'no_path' })}`;
-  const a = await getAgent();
-  const { summary, qualityScore } = await a.summarizeDocument(task.documentPath);
-  console.log(`     ✅ 质量=${(qualityScore * 10).toFixed(1)}/10`);
-  return `OK|${JSON.stringify({ id: task.id, type: 'summarize', qualityScore, summary })}`;
-}
-
-async function handleImprove(task: RpcTask): Promise<string> {
-  if (!task.documentPath || !task.requirements) {
-    return `ERR|${JSON.stringify({ code: 'no_path_or_req' })}`;
-  }
-  const a = await getAgent();
-  const res = await a.improveDocument({
-    originalPath: task.documentPath,
-    requirements: task.requirements,
-    context: `来自节点: ${task.from}`,
-  });
-  const ok = res.improved ?? false;
-  console.log(`     ✅ 改进${ok ? '成功' : '失败'}  质量=${(res.qualityScore * 10).toFixed(1)}/10  自动发送=${res.shouldAutoSend}`);
-  return `OK|${JSON.stringify({
-    id: task.id, type: 'improve', improved: ok,
-    qualityScore: res.qualityScore, shouldAutoSend: res.shouldAutoSend,
-    newContent: res.newContent,
-  })}`;
-}
-
-// ---------------------------------------------------------------------------
-// Utils
-// ---------------------------------------------------------------------------
-
-function safeParse<T>(s: string): T | null {
-  try { return JSON.parse(s) as T; } catch { return null; }
-}
-
-function rpcErr(code: string, msg: string): string {
-  return `ERR|${JSON.stringify({ code, msg })}`;
-}
-
-// ---------------------------------------------------------------------------
-// CLI with persistent bottom prompt
-// ---------------------------------------------------------------------------
-
-const SAVE_CURSOR = '\x1b[s';
-const RESTORE_CURSOR = '\x1b[u';
-const MOVE_TO_BOTTOM = '\x1b[999A';
-const HIDE_CURSOR_SEQ = '\x1b[?25l';
-const SHOW_CURSOR_SEQ = '\x1b[?25h';
-const MOVE_UP_1 = '\x1b[1A';
-
-let isRunning = false;
-let currentInput = '';
-let promptVisible = false;
-
-function getTermHeight(): number {
-  return process.stdout.rows || 24;
-}
-
-function moveCursorToBottom(): void {
-  const height = getTermHeight();
-  process.stdout.write(`\x1b[${height};1H`);
-}
-
-function showBottomPrompt(): void {
-  if (!isRunning) return;
-  promptVisible = true;
-  process.stdout.write(SAVE_CURSOR);
-  moveCursorToBottom();
-  process.stdout.write(`${CYAN}❯ ${RESET}${currentInput}${HIDE_CURSOR_SEQ}`);
-  process.stdout.write(RESTORE_CURSOR);
-}
-
-function clearPromptLine(): void {
-  if (!promptVisible) return;
-  process.stdout.write(SAVE_CURSOR);
-  moveCursorToBottom();
-  process.stdout.write(CLEAR_LINE);
-  process.stdout.write(RESTORE_CURSOR);
-  promptVisible = false;
-}
-
-function startCLI(comm: HyperswarmCommunicator): void {
-  isRunning = true;
-  currentInput = '';
-  promptVisible = false;
-
-  try {
-    (process.stdin as any).setRawMode(true);
-  } catch {
-  }
-  readline.emitKeypressEvents(process.stdin);
-
-  process.stdout.write(CLEAR_LINE);
-  showBottomPrompt();
-
-  const promptTimer = setInterval(() => {
-    if (isRunning && promptVisible) {
-      showBottomPrompt();
-    }
-  }, 500);
-
-  const handleInput = (chunk: Buffer, key: { name: string; ctrl: boolean }) => {
-    if (!isRunning) return;
-
-    if (key.ctrl && key.name === 'c') {
-      clearPromptLine();
-      process.stdout.write(`\n${CYAN}👋 再见！${RESET}\n`);
-      try { (process.stdin as any).setRawMode(false); } catch {}
-      clearInterval(promptTimer);
-      process.exit(0);
-      return;
-    }
-
-    if (key.name === 'return') {
-      const trimmed = currentInput.trim();
-      currentInput = '';
-      clearPromptLine();
-
-      if (trimmed) {
-        process.stdout.write('\n');
-        processInput(trimmed, comm).then(() => {
-          if (isRunning) showBottomPrompt();
-        });
-      } else {
-        showBottomPrompt();
-      }
-      return;
-    }
-
-    if (key.name === 'backspace') {
-      if (currentInput.length > 0) {
-        currentInput = currentInput.slice(0, -1);
-        showBottomPrompt();
-      }
-      return;
-    }
-
-    if (key.name === 'escape' || (key.ctrl && key.name === 'u')) {
-      currentInput = '';
-      showBottomPrompt();
-      return;
-    }
-
-    if (key.name === 'tab') {
-      return;
-    }
-
-    if (key.name && key.name.length === 1) {
-      currentInput += chunk.toString();
-      showBottomPrompt();
-    }
-  };
-
-  process.stdin.on('data', handleInput);
-
-  process.on('exit', () => {
-    isRunning = false;
-    process.stdout.write(SHOW_CURSOR_SEQ);
-  });
-}
-
-async function processInput(input: string, comm: HyperswarmCommunicator): Promise<void> {
-  const trimmed = input.trim();
-
-  if (trimmed === '退出' || trimmed === 'exit' || trimmed === 'quit') {
-    clearPromptLine();
-    process.stdout.write(`${CYAN}👋 再见！${RESET}\n`);
-    isRunning = false;
-    process.stdin.destroy();
-    comm.stop();
-    return;
-  }
-
-  if (trimmed.toLowerCase() === 'peers') {
-    const peers = comm.getConnections();
-    process.stdout.write(`${GRAY}已连接节点: ${peers.length}${RESET}\n`);
-    for (const c of peers) {
-      process.stdout.write(`  ${GRAY}·${RESET} ${c.publicKey.substring(0, 16)}...\n`);
-    }
-    return;
-  }
-
-  if (trimmed.toLowerCase() === 'iroh') {
-    const nodeId = irohTransport.getNodeId();
-    const running = irohTransport.isRunning();
-    const peers = irohTransport.getPeers();
-    process.stdout.write(`${GRAY}iroh 状态:${RESET}\n`);
-    process.stdout.write(`  ${GRAY}运行中:${RESET} ${running ? '是' : '否'}\n`);
-    process.stdout.write(`  ${GRAY}Node ID:${RESET} ${nodeId ? nodeId.substring(0, 24) + '...' : 'N/A'}\n`);
-    process.stdout.write(`  ${GRAY}已知节点:${RESET} ${peers.length}\n`);
-    if (hybridMessenger) {
-      process.stdout.write(`  ${GRAY}HybridMessenger:${RESET} 就绪\n`);
-    }
-    return;
-  }
-
-  try {
-    const a = await getAgent();
-    const thinking = setInterval(() => {
-      if (!isRunning) return;
-      process.stdout.write('\r  \x1b[33m⟳\x1b[0m 思考中...    \x1b[?25l');
-    }, 80);
-    const response = await a.prompt(trimmed);
-    clearInterval(thinking);
-    process.stdout.write('\r' + ' '.repeat(30) + '\r');
-    process.stdout.write(`${response}\n`);
-  } catch (e: any) {
-    if (!e.message?.includes('ERR_USE_AFTER_CLOSE') && !e.message?.includes('write after end')) {
-      process.stdout.write(`${MAGENTA}❌ ${e.message}${RESET}\n`);
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Non-Interactive Mode (for AI consumption)
-// ---------------------------------------------------------------------------
-
-interface NonInteractiveResult {
-  success: boolean;
-  response?: string;
-  error?: string;
-  metadata?: {
-    duration?: number;
-    qualityScore?: number;
-    peers?: number;
-    file?: string;
-  };
-}
-
-const AVAILABLE_TOOLS = [
-  { name: 'read_document', description: '读取文档 (txt, md, pdf, docx)', example: '--read <file>' },
-  { name: 'summarize_document', description: '总结文档内容', example: '--summarize <file>' },
-  { name: 'improve_document', description: '改进文档内容', example: '--improve <file> <requirements>' },
-  { name: 'list_peers', description: '列出已连接的对等节点', example: '--peers' },
-  { name: 'send_message', description: '向对等节点发送消息', example: '--send <peerId> <message>' },
-  { name: 'broadcast_message', description: '广播消息到所有节点', example: '--broadcast <message>' },
-  { name: 'get_identity', description: '获取当前智能体身份', example: '--identity' },
-  { name: 'get_operation_logs', description: '获取操作日志', example: '--logs' },
-  { name: 'search_files', description: '搜索文件', example: '--search <keyword>' },
-  { name: 'prompt', description: '通用 AI 对话', example: '--prompt <text>' },
-  { name: 'list_agents', description: '列出所有 SubAgent', example: '--agents' },
-  { name: 'register_agent', description: '注册新 SubAgent', example: '--register-agent <name> [capabilities...]' },
-  { name: 'delegate_task', description: '委派任务给最佳 Agent', example: '--delegate <task> [capabilities...]' },
-  { name: 'global_context', description: '显示全局共享上下文', example: '--context' },
-  { name: 'global_agents', description: '显示全局 Agent 注册表', example: '--global-agents' },
-  { name: 'add_action', description: '添加用户行动到共享上下文', example: '--add-action <content> [importance]' },
-  { name: 'harness_init', description: '初始化 Bollharness 治理框架', example: '--harness-init' },
-  { name: 'harness_gate', description: '显示当前 Gate 状态', example: '--harness-gate' },
-  { name: 'harness_transition', description: '执行 Gate 转移', example: '--harness-transition [PASS|BLOCK]' },
-  { name: 'harness_skill', description: '执行 Harness Skill', example: '--harness-skill <name> [action]' },
-  { name: 'harness_classify', description: '分类变更类型', example: '--harness-classify <description>' },
-  { name: 'harness_context', description: '获取文件上下文', example: '--harness-context <file>' },
-  { name: 'harness_check', description: '执行 Guard 检查', example: '--harness-check <file>' },
-  { name: 'update_check', description: '检查 npm 包更新', example: '--update-check' },
-  { name: 'update_now', description: '立即更新到最新版本', example: '--update-now [package]' },
-];
-
-async function runToolCommand(
-  tool: string,
-  args: string[],
-  outputJson: boolean,
-  comm: HyperswarmCommunicator
-): Promise<void> {
-  const a = await getAgent();
-  const startTime = Date.now();
-  let response: string;
-  let error: string | undefined;
-  let metadata: NonInteractiveResult['metadata'] = {
-    peers: comm?.getConnections().length || 0
-  };
-
-  const toolLabels: Record<string, string> = {
-    'read': '读取文档',
-    'summarize': '总结文档',
-    'improve': '改进文档',
-    'prompt': 'AI 对话',
-    'agents': '列出 Agent',
-    'register-agent': '注册 Agent',
-    'delegate': '委派任务',
-    'context': '全局上下文',
-    'global-agents': 'Agent 注册表',
-    'add-action': '添加行动',
-    'peers': '列出节点',
-    'broadcast': '广播消息',
-    'identity': '显示身份',
-    'logs': '操作日志',
-    'tools': '可用工具'
-  };
-
-  const label = toolLabels[tool] || tool;
-  const thinking = s.Thinking();
-
-  try {
-    switch (tool) {
-      case 'read': {
-        const [filePath] = args;
-        if (!filePath) {
-          response = '错误: 缺少文件路径参数';
-          error = response;
-          break;
-        }
-        const content = await documentReader.read(filePath);
-        response = `${GREEN}📄 ${content.metadata.filename}${RESET}\n${GRAY}大小: ${content.metadata.size} 字节${RESET}\n\n${content.text}`;
-        break;
-      }
-
-      case 'summarize': {
-        const [filePath, ...ctx] = args;
-        if (!filePath) {
-          response = '错误: 缺少文件路径参数';
-          error = response;
-          break;
-        }
-        const result = await a.summarizeDocument(filePath, ctx.join(' '));
-        response = `📝 摘要:\n${result.summary}\n\n质量评分: ${(result.qualityScore * 10).toFixed(1)}/10`;
-        metadata.qualityScore = result.qualityScore;
-        break;
-      }
-
-      case 'improve': {
-        const [filePath, ...req] = args;
-        if (!filePath || req.length === 0) {
-          response = '错误: 缺少文件路径或需求参数';
-          error = response;
-          break;
-        }
-        const result = await a.improveDocument({
-          originalPath: filePath,
-          requirements: req.join(' ')
-        });
-        response = result.newContent || '';
-        if (!result.improved) {
-          response = '错误: 改进失败';
-          error = response;
-        }
-        metadata.qualityScore = result.qualityScore;
-        break;
-      }
-
-      case 'peers': {
-        const peers = comm?.getConnections() || [];
-        if (peers.length === 0) {
-          response = '当前无连接的对等节点';
-        } else {
-          response = `已连接节点 (${peers.length}):\n${peers.map((c: P2PConnection) => `  · ${c.publicKey.substring(0, 16)}...`).join('\n')}`;
-        }
-        break;
-      }
-
-      case 'iroh': {
-        const nodeId = irohTransport.getNodeId();
-        const running = irohTransport.isRunning();
-        const irohPeers = irohTransport.getPeers();
-        const messenger = hybridMessenger ? 'HybridMessenger 就绪' : 'HybridMessenger 未初始化';
-        response = `iroh P2P 状态:
-  运行中: ${running ? '是' : '否'}
-  Node ID: ${nodeId ? nodeId.substring(0, 32) + '...' : 'N/A'}
-  已知节点: ${irohPeers.length}
-  ${messenger}`;
-        break;
-      }
-
-      case 'identity': {
-        const identity = a.getIdentity();
-        response = JSON.stringify(identity, null, 2);
-        break;
-      }
-
-      case 'logs': {
-        const logs = (a as any).getOperationLogs?.() || [];
-        response = logs.length === 0
-          ? '暂无操作日志'
-          : logs.map((l: { timestamp: number; status: string; action: string }) => `[${new Date(l.timestamp).toISOString()}] ${l.status}: ${l.action}`).join('\n');
-        break;
-      }
-
-      case 'search': {
-        const [keyword] = args;
-        if (!keyword) {
-          response = '错误: 缺少搜索关键词';
-          error = response;
-          break;
-        }
-        response = `搜索功能开发中，关键字: ${keyword}`;
-        break;
-      }
-
-      case 'broadcast': {
-        const [message] = args;
-        if (!message) {
-          response = '错误: 缺少广播消息内容';
-          error = response;
-          break;
-        }
-        await a.broadcast(message);
-        response = `广播已发送: ${message.substring(0, 50)}...`;
-        break;
-      }
-
-      case 'send': {
-        const [peerId, ...messageParts] = args;
-        if (!peerId || messageParts.length === 0) {
-          response = '错误: 缺少节点ID或消息内容';
-          error = response;
-          break;
-        }
-        await a.sendMessage(peerId, messageParts.join(' '));
-        response = `消息已发送到 ${peerId.substring(0, 16)}...`;
-        break;
-      }
-
-      case 'prompt': {
-        const [text] = args;
-        if (!text) {
-          response = '错误: 缺少 prompt 文本';
-          error = response;
-          break;
-        }
-        response = await a.prompt(text);
-        break;
-      }
-
-      case 'tools': {
-        response = '🛠️ 可用工具:\n\n' + AVAILABLE_TOOLS.map(t =>
-          `  ${t.name}\n    ${t.description}\n    示例: ${t.example}`
-        ).join('\n\n');
-        break;
-      }
-
-      // ==================== Bollharness Commands ====================
-
-      case 'harness-init': {
-        harness = createBollharnessIntegration();
-        const skills = harness!.listSkills();
-        const harnessSkills = harness!.listHarnessSkills();
-        response = `✅ Bollharness 初始化成功\n\n` +
-          `已加载 Skills: ${skills.length}\n` +
-          `已加载 Harness Skills: ${harnessSkills.length}\n\n` +
-          `Skills:\n${skills.map(s => `  - ${s.name}: ${s.description}`).join('\n')}\n\n` +
-          `Gates: 0-8 (8-Gate 工作流)`;
-        break;
-      }
-
-      case 'harness-gate': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const gate = harness!.getCurrentGate();
-        const gatePack = harness!.getGatePack();
-        const blockers = (gatePack.blockers as string[]) || [];
-        response = `🚪 当前 Gate: ${gate}\n\n` +
-          `Entry: ${gatePack.entry_satisfied ? '✅ 满足' : '❌ 未满足'}\n` +
-          `要求产物: ${gatePack.required_artifact}\n` +
-          `下一步 Skill: ${gatePack.required_next_skill}\n` +
-          `Blockers: ${blockers.length > 0 ? blockers.join(', ') : '无'}`;
-        break;
-      }
-
-      case 'harness-transition': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const [verdict] = args;
-        const result = await harness!.transitionGate(
-          verdict ? { verdict: verdict as 'PASS' | 'BLOCK', details: '' } : undefined
-        );
-        const transitionBlockers = (result.transition as { blockers?: string[] })?.blockers || [];
-        response = `🔄 Gate 转移: ${result.success ? '✅ 成功' : '❌ 失败'}\n` +
-          `Blockers: ${transitionBlockers.length > 0 ? transitionBlockers.join(', ') : '无'}`;
-        break;
-      }
-
-      case 'harness-skill': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const [skillName, action] = args;
-        if (!skillName) {
-          const skills = harness!.listSkills();
-          response = `📋 可用 Skills (${skills.length}):\n\n` +
-            skills.map(s => `  ${s.name}: ${s.description}`).join('\n');
-          break;
-        }
-        const result = await harness!.executeSkill(skillName, { action: action || 'get_gate' });
-        response = `🎯 Skill '${skillName}' 执行结果:\n\n${result.result || result.error}`;
-        break;
-      }
-
-      case 'harness-classify': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const [description] = args;
-        if (!description) {
-          response = '用法: --harness-classify <变更描述>';
-          error = response;
-          break;
-        }
-        const result = harness!.classifyChange(description);
-        response = `📊 变更分类: ${result.classification}\n` +
-          `最小路径: ${result.minimum_gates}\n` +
-          `快速通道: ${result.fast_track ? '✅ 可用' : '❌ 不可用'}`;
-        break;
-      }
-
-      case 'harness-context': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const [filePath] = args;
-        if (!filePath) {
-          response = '用法: --harness-context <文件路径>';
-          error = response;
-          break;
-        }
-        const context = harness!.getContext(filePath);
-        response = `📄 文件: ${filePath}\n\n上下文:\n${context || '无匹配上下文'}`;
-        break;
-      }
-
-      case 'harness-check': {
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const [filePath] = args;
-        if (!filePath) {
-          response = '用法: --harness-check <文件路径>';
-          error = response;
-          break;
-        }
-        const result = await harness!.processFileEdit(filePath);
-        response = `🔍 Guard 检查: ${filePath}\n\n` +
-          `通过: ${result.success ? '✅' : '❌'}\n` +
-          `错误: ${result.errors.length > 0 ? result.errors.join('\n') : '无'}`;
-        break;
-      }
-
-      case 'harness-archive': {
-        const a = await getAgent();
-        const sessionHarness = (a as any).getHarness?.();
-        if (sessionHarness) {
-          (a as any).archiveToHarness?.();
-          response = `📦 Session 已归档到 Pi SDK Harness`;
-        } else {
-          if (!harness) {
-            harness = createBollharnessIntegration();
-          }
-          const logs = (a as any).getOperationLogs?.() || [];
-          const archive = harness.archiveSession(logs);
-          response = `📦 Session 已归档:\n` +
-            `ID: ${archive.id}\n` +
-            `Gate: ${archive.gate}\n` +
-            `动作数: ${archive.actionCount}\n` +
-            `摘要: ${archive.summary}`;
-        }
-        break;
-      }
-
-      case 'harness-sessions': {
-        const a = await getAgent();
-        const sessionHarness = (a as any).getHarness?.();
-        if (sessionHarness) {
-          harness = sessionHarness;
-        }
-        if (!harness) {
-          harness = createBollharnessIntegration();
-        }
-        const archives = harness.getSessionArchives();
-        if (archives.length === 0) {
-          response = '暂无 Session 归档记录';
-          break;
-        }
-        response = `📜 Session 归档记录 (${archives.length}):\n\n`;
-        for (const archive of archives.slice(-10)) {
-          response += `### ${archive.id}\n`;
-          response += `Gate: ${archive.gate} | 动作: ${archive.actionCount}\n`;
-          response += `摘要: ${archive.summary}\n\n`;
-        }
-        break;
-      }
-
-      case 'harness-session-context': {
-        const a = await getAgent();
-        const sessionHarness = (a as any).getHarness?.();
-        if (sessionHarness) {
-          const [sessionId] = args;
-          const context = sessionHarness.getSessionContext(sessionId || undefined);
-          response = `📄 Pi SDK Session 上下文:\n\n${context}`;
-        } else {
-          if (!harness) {
-            harness = createBollharnessIntegration();
-          }
-          const [sessionId] = args;
-          const context = harness.getSessionContext(sessionId || undefined);
-          response = `📄 Session 上下文:\n\n${context}`;
-        }
-        break;
-      }
-
-      case 'agents': {
-        const manager = await createSubAgentManager();
-        const agents = await manager.getAllAgents();
-        if (agents.length === 0) {
-          response = '暂无注册的 SubAgent';
-        } else {
-          response = `📋 已注册 SubAgent (${agents.length}):\n\n`;
-          for (const agent of agents) {
-            response += `  [${agent.status}] ${agent.name} (${agent.id})\n`;
-            response += `    能力: ${agent.capabilities.join(', ')}\n`;
-            response += `    DID: ${agent.did || 'N/A'}\n\n`;
-          }
-        }
-        break;
-      }
-
-      case 'register-agent': {
-        const [name, ...capabilities] = args;
-        if (!name) {
-          response = '用法: --register-agent <name> [capability1] [capability2] ...';
-          error = response;
-          break;
-        }
-        const manager = await createSubAgentManager();
-        const agent = await manager.registerAgent({
-          name,
-          capabilities: capabilities.length > 0 ? capabilities : ['general'],
-          did: `did:local:${Date.now()}`
-        });
-        response = `✅ SubAgent 注册成功:\n  ID: ${agent.id}\n  名称: ${agent.name}\n  能力: ${agent.capabilities.join(', ')}`;
-        break;
-      }
-
-      case 'delegate': {
-        const [taskDesc, ...requiredCaps] = args;
-        if (!taskDesc) {
-          response = '用法: --delegate <任务描述> [能力要求1] [能力要求2] ...';
-          error = response;
-          break;
-        }
-        const manager = await createSubAgentManager();
-        const a = await getAgent();
-        const { task, agent } = await manager.delegateTask(
-          'cli-user',
-          taskDesc,
-          requiredCaps.length > 0 ? requiredCaps : ['general']
-        );
-        if (agent) {
-          response = `✅ 任务已委派:\n  任务ID: ${task.id}\n  执行Agent: ${agent.name} (${agent.id})\n  状态: ${task.status}`;
-        } else {
-          response = `⚠️ 未找到合适的Agent，任务已创建:\n  任务ID: ${task.id}\n  状态: ${task.status}`;
-        }
-        break;
-      }
-
-      case 'context': {
-        const ctx = await getGlobalSharedContext();
-        response = await ctx.getContextSummary();
-        break;
-      }
-
-      case 'global-agents': {
-        const ctx = await getGlobalSharedContext();
-        const agents = await ctx.getAllAgents();
-        if (agents.length === 0) {
-          response = '全局注册表暂无 Agent';
-        } else {
-          response = `🌐 全局 Agent 注册表 (${agents.length}):\n\n`;
-          for (const agent of agents) {
-            response += `  [${agent.status}] ${agent.name || agent.agentId}\n`;
-            response += `    ID: ${agent.agentId}\n`;
-            response += `    DID: ${agent.did || 'N/A'}\n`;
-            response += `    能力: ${agent.capabilities.join(', ')}\n\n`;
-          }
-        }
-        break;
-      }
-
-      case 'add-action': {
-        const [content, importance] = args;
-        if (!content) {
-          response = '用法: --add-action <内容> [重要性(1-10)]';
-          error = response;
-          break;
-        }
-        const ctx = await getGlobalSharedContext();
-        await ctx.addUserAction(content, undefined, undefined, parseInt(importance || '5', 10));
-        response = `✅ 已添加用户行动: ${content.substring(0, 50)}...`;
-break;
-      }
-
-      // ==================== Update Commands ====================
-
-      case 'update-check': {
-        const { checkForUpdates } = await import('./utils/auto-update.js');
-        const info = await checkForUpdates();
-        if (info && info.outdated) {
-          response = `📦 发现更新可用:\n\n` +
-            `当前版本: ${info.version}\n` +
-            `最新版本: ${info.latest}\n\n` +
-            `待更新包:\n${info.packages.map(p => `  - ${p.name}: ${p.current} → ${p.latest}`).join('\n')}\n\n` +
-            `运行 --update-now 进行更新`;
-        } else {
-          response = `✅ 已是最新版本 (${info?.version || 'unknown'})`;
-        }
-        break;
-      }
-
-      case 'update-now': {
-        const { performUpdate } = await import('./utils/auto-update.js');
-        const packages = args.length > 0 ? args : undefined;
-        const result = await performUpdate(packages as string[] | undefined);
-        if (result.success) {
-          response = `✅ 更新成功${result.updatedPackages ? `: ${result.updatedPackages.join(', ')}` : ''}`;
-          if (result.updated) {
-            response += `\n\n${YELLOW}请重新启动应用以使用新版本${RESET}`;
-          }
-        } else {
-          response = `❌ 更新失败: ${result.error}`;
-          error = response;
-        }
-        break;
-      }
-
-      default:
-        response = `错误: 未知工具 "${tool}"`;
-        error = response;
-    }
-  } catch (e: any) {
-    response = `错误: ${e.message}`;
-    error = response;
-  }
-
-  metadata.duration = Date.now() - startTime;
-
-  s.clearThinking(thinking);
-
-  if (outputJson) {
-    const result: NonInteractiveResult = {
-      success: !error,
-      response,
-      error,
-      metadata
-    };
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    if (error) {
-      s.divider();
-      console.log(`${MAGENTA}${error}${RESET}\n`);
-    } else {
-      s.divider();
-      console.log(`${response}\n`);
-    }
-    console.log(`${GRAY}耗时: ${metadata.duration}ms${RESET}`);
-  }
-}
-
-async function runNonInteractive(
-  args: ParsedArgs,
-  comm: HyperswarmCommunicator
-): Promise<void> {
-  const { prompt, json, output, tool, toolArgs } = args;
-
-  if (output) {
-    const originalLog = console.log;
-    let outputBuffer = '';
-    console.log = (...params: any[]) => {
-      outputBuffer += params.join(' ') + '\n';
-    };
-
-    if (tool) {
-      await runToolCommand(tool, toolArgs, false, comm);
-    } else if (prompt) {
-      const a = await getAgent();
-      console.log(await a.prompt(prompt));
-    }
-
-    console.log = originalLog;
-    await fs.writeFile(output, outputBuffer.trim(), 'utf-8');
-    console.log(`✅ 结果已保存到: ${output}`);
-    return;
-  }
-
-  if (tool === 'prompt' && prompt) {
-    // 2026-06-15: --prompt "text" 走直接调 a.prompt(prompt) 路径, 避开 runToolCommand
-    //   (case 'prompt' 内的 [text] = args 从 toolArgs 取值是空数组, 永远报"缺少 prompt 文本"是 CLI bug)
-    const startTime = Date.now();
-    const a = await getAgent();
-    try {
-      const response = await a.prompt(prompt);
-      const elapsed = Date.now() - startTime;
-      if (json) {
-        console.log(JSON.stringify({ success: true, response, elapsedMs: elapsed }, null, 2));
-      } else {
-        console.log(response);
-        console.log(`\n耗时: ${elapsed}ms`);
-      }
-    } catch (e: any) {
-      const error = e?.message || String(e);
-      if (json) {
-        console.log(JSON.stringify({ success: false, error }, null, 2));
-      } else {
-        console.log(`\n错误: ${error}`);
-      }
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (tool) {
-    await runToolCommand(tool, toolArgs, !!json, comm);
-  } else if (prompt) {
-    const startTime = Date.now();
-    const a = await getAgent();
-    let response: string;
-    try {
-      response = await a.prompt(prompt);
-    } catch (e: any) {
-      response = `错误: ${e.message}`;
-    }
-
-    const duration = Date.now() - startTime;
-    const peers = comm?.getConnections().length || 0;
-
-    if (json) {
-      const result: NonInteractiveResult = {
-        success: !response.startsWith('错误:'),
-        response,
-        error: response.startsWith('错误:') ? response : undefined,
-        metadata: { duration, peers }
-      };
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log(response);
-    }
-  }
-}
-
-interface ParsedArgs {
-  prompt?: string;
-  json?: boolean;
-  web?: boolean;
-  help?: boolean;
-  tools?: boolean;
-  read?: boolean;
-  summarize?: boolean;
-  improve?: boolean;
-  peers?: boolean;
-  iroh?: boolean;
-  identity?: boolean;
-  logs?: boolean;
-  broadcast?: boolean;
-  send?: boolean;
-  search?: boolean;
-  model?: string;
-  output?: string;
-  tool?: string;
-  toolArgs: string[];
-  agents?: boolean;
-  registerAgent?: boolean;
-  delegate?: boolean;
-  context?: boolean;
-  globalAgents?: boolean;
-  addAction?: boolean;
-  tui?: boolean;
-  updateCheck?: boolean;
-  updateNow?: boolean;
-}
-
-function parseArgs(): ParsedArgs {
-  const args = process.argv.slice(2);
-  const result: ParsedArgs = { toolArgs: [] };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    switch (arg) {
-      case '--prompt':
-      case '-p':
-        result.prompt = args[++i];
-        result.tool = 'prompt';
-        break;
-      case '--json':
-      case '-j':
-        result.json = true;
-        break;
-      case '--web':
-        result.web = true;
-        break;
-      case '--help':
-      case '-h':
-        result.help = true;
-        break;
-      case '--tools':
-        result.tools = true;
-        result.tool = 'tools';
-        break;
-      case '--read':
-        result.read = true;
-        result.tool = 'read';
-        result.toolArgs = [args[++i]].filter(Boolean);
-        break;
-      case '--summarize':
-        result.summarize = true;
-        result.tool = 'summarize';
-        const summarizeArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          summarizeArgs.push(args[++i]);
-        }
-        result.toolArgs = summarizeArgs;
-        break;
-      case '--improve':
-        result.improve = true;
-        result.tool = 'improve';
-        const improveArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          improveArgs.push(args[++i]);
-        }
-        result.toolArgs = improveArgs;
-        break;
-      case '--peers':
-        result.peers = true;
-        result.tool = 'peers';
-        break;
-      case '--iroh':
-        result.iroh = true;
-        result.tool = 'iroh';
-        break;
-      case '--identity':
-        result.identity = true;
-        result.tool = 'identity';
-        break;
-      case '--logs':
-        result.logs = true;
-        result.tool = 'logs';
-        break;
-      case '--broadcast':
-        result.broadcast = true;
-        result.tool = 'broadcast';
-        result.toolArgs = [args[++i]].filter(Boolean);
-        break;
-      case '--send':
-        result.send = true;
-        result.tool = 'send';
-        const sendArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          sendArgs.push(args[++i]);
-        }
-        result.toolArgs = sendArgs;
-        break;
-      case '--search':
-        result.search = true;
-        result.tool = 'search';
-        result.toolArgs = [args[++i]].filter(Boolean);
-        break;
-      case '--agents':
-        result.agents = true;
-        result.tool = 'agents';
-        break;
-      case '--register-agent':
-        result.registerAgent = true;
-        result.tool = 'register-agent';
-        const regArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          regArgs.push(args[++i]);
-        }
-        result.toolArgs = regArgs;
-        break;
-      case '--delegate':
-        result.delegate = true;
-        result.tool = 'delegate';
-        const delArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          delArgs.push(args[++i]);
-        }
-        result.toolArgs = delArgs;
-        break;
-      case '--context':
-        result.context = true;
-        result.tool = 'context';
-        break;
-      case '--global-agents':
-        result.globalAgents = true;
-        result.tool = 'global-agents';
-        break;
-      case '--add-action':
-        result.addAction = true;
-        result.tool = 'add-action';
-        const actionArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          actionArgs.push(args[++i]);
-        }
-        result.toolArgs = actionArgs;
-        break;
-      case '--harness-init':
-        result.tool = 'harness-init';
-        break;
-      case '--harness-gate':
-        result.tool = 'harness-gate';
-        break;
-      case '--harness-transition':
-        result.tool = 'harness-transition';
-        const transitionArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          transitionArgs.push(args[++i]);
-        }
-        result.toolArgs = transitionArgs;
-        break;
-      case '--harness-skill':
-        result.tool = 'harness-skill';
-        const skillArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          skillArgs.push(args[++i]);
-        }
-        result.toolArgs = skillArgs;
-        break;
-      case '--harness-classify':
-        result.tool = 'harness-classify';
-        const classifyArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          classifyArgs.push(args[++i]);
-        }
-        result.toolArgs = classifyArgs;
-        break;
-      case '--harness-context':
-        result.tool = 'harness-context';
-        const contextArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          contextArgs.push(args[++i]);
-        }
-        result.toolArgs = contextArgs;
-        break;
-      case '--harness-check':
-        result.tool = 'harness-check';
-        const checkArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          checkArgs.push(args[++i]);
-        }
-        result.toolArgs = checkArgs;
-        break;
-      case '--harness-archive':
-        result.tool = 'harness-archive';
-        break;
-      case '--harness-sessions':
-        result.tool = 'harness-sessions';
-        break;
-      case '--harness-session-context':
-        result.tool = 'harness-session-context';
-        const sessionArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          sessionArgs.push(args[++i]);
-        }
-        result.toolArgs = sessionArgs;
-        break;
-      case '--update-check':
-        result.updateCheck = true;
-        result.tool = 'update-check';
-        break;
-      case '--update-now':
-        result.updateNow = true;
-        result.tool = 'update-now';
-        const updateArgs: string[] = [];
-        while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
-          updateArgs.push(args[++i]);
-        }
-        result.toolArgs = updateArgs;
-        break;
-      case '--tui':
-        result.tui = true;
-        break;
-      case '--model':
-        result.model = args[++i];
-        break;
-      case '--output':
-      case '-o':
-        result.output = args[++i];
-        break;
-      case '--':
-        result.toolArgs = args.slice(i + 1);
-        i = args.length;
-        break;
-      default:
-        if (!arg.startsWith('-') && !result.prompt && !result.tool) {
-          result.prompt = arg;
-          result.tool = 'prompt';
-        }
-    }
-  }
-
-  return result;
-}
-
-function printHelp(): void {
-  console.log(`
-🤖 Bolloon Agent - AI 可调用文档处理智能体
-
-用法:
-  npx tsx src/index.ts [选项] [参数]
-
-选项:
-  # 文档处理
-  --read <file>              读取文档 (txt, md, pdf, docx)
-  --summarize <file> [ctx]  总结文档，可选上下文
-  --improve <file> <req>     改进文档，req 为改进要求
-
-  # P2P 网络
-  --peers                    列出已连接的对等节点
-  --broadcast <msg>          广播消息到所有节点
-  --send <peerId> <msg>      向指定节点发送消息
-
-  # 智能体
-  --identity                 显示当前智能体身份
-  --logs                     显示操作日志
-  --search <keyword>         搜索文件
-  --tools                    显示所有可用工具
-
-  # SubAgent 管理
-  --agents                   列出所有 SubAgent
-  --register-agent <name> [cap1] [cap2]...  注册新 SubAgent
-  --delegate <任务描述> [能力要求...]  委派任务给最佳 Agent
-
-  # 全局共享上下文
-  --context                  显示全局共享上下文摘要
-  --global-agents            显示全局 Agent 注册表
-  --add-action <内容> [重要性]  添加用户行动到共享上下文
-
-  # Bollharness 治理框架
-  --harness-init             初始化 Bollharness 治理框架
-  --harness-gate             显示当前 Gate 状态
-  --harness-transition [PASS|BLOCK]  执行 Gate 转移
-  --harness-skill <name> [action]  执行 Harness Skill
-  --harness-classify <描述>  分类变更类型
-  --harness-context <file>   获取文件上下文
-  --harness-check <file>     执行 Guard 检查
-  --harness-archive          归档当前 Session 到 Harness
-  --harness-sessions         列出 Session 归档记录
-  --harness-session-context [id]  获取 Session 上下文
-
-  # 自动更新
-  --update-check             检查 npm 包更新
-  --update-now [pkg]        更新到最新版本
-
-  # AI 对话
-  --prompt, -p <text>        通用 AI 对话（默认）
-  --model <name>             指定使用的模型
-
-  # 输出控制
-  --json, -j                 输出 JSON 格式
-  --output, -o <file>        结果保存到文件
-  --web                      启动 Web UI 模式
-  --help, -h                 显示帮助信息
-
-示例:
-  # 文档处理
-  npx tsx src/index.ts --read 想法.md
-  npx tsx src/index.ts --summarize docs/想法.md
-  npx tsx src/index.ts --improve docs/README.md "让内容更简洁"
-  npx tsx src/index.ts --read 想法.md -o summary.txt
-
-  # P2P 网络
-  npx tsx src/index.ts --peers
-  npx tsx src/index.ts --broadcast "Hello everyone"
-  npx tsx src/index.ts --send QmABC... "私信内容"
-
-  # AI 对话
-  npx tsx src/index.ts --prompt "总结 README.md"
-  npx tsx src/index.ts -p "分析这个项目" -j
-
-  # 交互模式
-  npx tsx src/index.ts
-
-  # Web 模式
-  npx tsx src/index.ts --web
-
-环境变量:
-  MINIMAX_API_KEY       MiniMax API 密钥
-  DEEPSEEK_API_KEY      DeepSeek API 密钥
-  KIMI_API_KEY / MOONSHOT_API_KEY  Kimi/Moonshot API 密钥
-  GLM_API_KEY / ZHIPU_API_KEY      智谱 GLM API 密钥
-  QWEN_API_KEY / DASHSCOPE_API_KEY 通义千问 API 密钥
-  OPENAI_API_KEY        OpenAI API 密钥（Pi SDK）
-  ANTHROPIC_API_KEY     Anthropic API 密钥（Pi SDK）
-  PORT                  Web 服务端口（默认 54188）
-`);
-}
-
-// ---------------------------------------------------------------------------
-// Entry point
-// ---------------------------------------------------------------------------
-
-async function main() {
-  const args = parseArgs();
-
-  if (args.help) {
-    printHelp();
-    process.exit(0);
-  }
-
-  // 自动更新已禁用: 启动时不再自动检查/安装更新.
-  // 想手动检查: bolloon --update-check
-  // 想手动更新: bolloon --update-now [package]
-  // 想完全屏蔽 (CI / sandbox): BOLLOON_SKIP_UPDATE=true
-
-  const mode = args.web ? 'web' : 'cli';
-  const isNonInteractive = !!(args.tool || args.prompt);
-  const isTuiMode = mode === 'cli' && !isNonInteractive && args.tui;
-
-  const originalLog = console.log;
-  const originalInfo = console.info;
-  const originalStdoutWrite = process.stdout.write.bind(process.stdout);
-
-  const isSdkLog = (msg: string): boolean => {
-    return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(msg);
-  };
-
-  if (isTuiMode) {
-    console.log = (...args: any[]) => {
-      const msg = args.join(' ');
-      if (isSdkLog(msg)) return;
-      originalLog.apply(console, args);
-    };
-    console.info = (...args: any[]) => {
-      const msg = args.join(' ');
-      if (isSdkLog(msg)) return;
-      originalInfo.apply(console, args);
-    };
-    process.stdout.write = (chunk: any, ...args: any[]) => {
-      const msg = String(chunk);
-      if (isSdkLog(msg)) return true;
-      return originalStdoutWrite(chunk, ...args);
-    };
-  }
-
-  if (isNonInteractive) {
-    console.error = () => {};
-  }
-
-  s.banner();
-
-  s.section('系统初始化');
-
-  const hasOpenAI = !!process.env.OPENAI_API_KEY;
-  // 2026-06-15: 修复 — 之前 anthropic 401 是因为 shell env 残留的旧 ANTHROPIC_API_KEY 抢了 provider 选择
-  //   用 BOLLOON_LLM_PROVIDER env 显式覆盖, 否则还是按 env hasXxx 顺序自动选
-  const hasAnthropic = !!process.env.ANTHROPIC_API_KEY && !process.env.BOLLOON_LLM_PROVIDER;
-  const hasMinimax = !!process.env.MINIMAX_API_KEY;
-  const hasDeepSeek = !!process.env.DEEPSEEK_API_KEY;
-  const hasKimi = !!(process.env.KIMI_API_KEY || process.env.MOONSHOT_API_KEY);
-  const hasGlm = !!(process.env.GLM_API_KEY || process.env.ZHIPU_API_KEY);
-  const hasQwen = !!(process.env.QWEN_API_KEY || process.env.DASHSCOPE_API_KEY);
-  const hasOpenRouter = !!process.env.OPENROUTER_API_KEY;
-  const hasGemini = !!process.env.GEMINI_API_KEY;
-  const hasOllama = !!process.env.OLLAMA_BASE_URL;
-
-  const llmProvider = hasOpenAI ? 'OpenAI' :
-                      hasAnthropic ? 'Anthropic' :
-                      hasOpenRouter ? 'OpenRouter' :
-                      hasGemini ? 'Gemini' :
-                      hasOllama ? 'Ollama' :
-                      hasMinimax ? 'MiniMax' :
-                      hasDeepSeek ? 'DeepSeek' :
-                      hasKimi ? 'Kimi' :
-                      hasGlm ? 'GLM' :
-                      hasQwen ? 'Qwen' : null;
-
-  if (llmProvider) {
-    s.step(0, 4, `LLM: ${llmProvider}`, 'ok');
-    initMinimax({ provider: llmProvider.toLowerCase() as any });
-  } else {
-    s.step(0, 4, 'LLM: 未配置', 'warn');
-    if (isNonInteractive) {
-      s.warn('未设置任何 LLM API Key，功能受限');
-    }
-  }
-
-  const { keypair, did, name } = await bootstrapIdentity();
-  agentIdentity = { did, name, publicKey: Buffer.from(keypair.publicKey).toString('hex') };
-
-  publishDID(name, keypair).then(({ cid, ipnsName }) => {
-    if (cid) agentIdentity!.cid = cid;
-    if (ipnsName) agentIdentity!.ipnsName = ipnsName;
-  }).catch(() => {});
-
-  const verifier = createVerificationManager();
-  let comm: HyperswarmCommunicator | null = null;
-
-  try {
-    if (mode === 'web') {
-      bootstrapP2P(verifier).then(c => {
-        comm = c;
-        const connections = c.getConnections();
-        if (connections.length > 0) {
-          agentIdentity!.peerId = connections[0].publicKey;
-          agentIdentity!.p2pChannel = 'bolloon-agent-harness';
-        }
-      }).catch(err => {
-        s.warn(`P2P Web 模式启动失败: ${err.message}`);
-      });
-    } else {
-      comm = await bootstrapP2P(verifier);
-      const connections = comm.getConnections();
-      if (connections.length > 0) {
-        agentIdentity.peerId = connections[0].publicKey;
-        agentIdentity.p2pChannel = 'bolloon-agent-harness';
-      }
-    }
-  } catch (err: any) {
-    s.warn(`P2P 初始化失败: ${err.message}`);
-    s.warn('将使用无 P2P 模式运行');
-  }
-
-  await bootstrapIroh(keypair, name);
-
-  // Bolloon Bootstrap: 启动扫描 + Context 收集 + 挂定时任务
-  // 失败静默 (主流程不被阻塞)
-  try {
-    const { bootstrapBolloon } = await import('./pi-ecosystem-judgment/human-value-pipeline.js');
-    s.info('正在 bootstrap bolloon 上下文...');
-    const bs = await bootstrapBolloon({ cwd: process.cwd() });
-    s.info(`Bootstrap 完成 (${bs.durationMs}ms, ${bs.errors.length} 个非致命错误)`);
-  } catch (err: any) {
-    s.warn(`Bootstrap 失败 (非致命, 主流程继续): ${err.message}`);
-  }
-
-  s.divider();
-
-  if (mode === 'web') {
-    const port = parseInt(process.env.PORT || '54188');
-    // 2026-06-16: BOLLOON_DEV_MODE=1 或 selfImprove=true 启动项 → 开发者模式, 启用自迭代 (健康监控+自改总线)
-    // 默认用户模式: 不自迭代, 自改卡片不自动出现, 仍可 POST /api/self-improve/trigger 手动触发
-    const selfImprove = process.env.BOLLOON_DEV_MODE === '1' || process.env.BOLLOON_DEV_MODE === 'true';
-    if (selfImprove) {
-      console.log('[startup] BOLLOON_DEV_MODE=1, 开发者模式: 自迭代已启用');
-    }
-    const { createWebServer, openBrowser } = await import('./web/server.js');
-
-    s.info(`启动 Web 服务端口 ${port}...`);
-    const { port: actualPort } = await createWebServer(port, { selfImprove });
-
-    s.success(`浏览器已打开 → http://localhost:${actualPort}`);
-    openBrowser(`http://localhost:${actualPort}`);
-  } else if (isNonInteractive) {
-    console.log = originalLog;
-    console.info = originalInfo;
-    process.stdout.write = originalStdoutWrite;
-    s.info('执行命令...');
-    console.log();
-    await runNonInteractive(args, comm!);
-    comm?.stop();
-    process.exit(0);
-  } else {
-    s.section('对话模式');
-    console.log(`${GRAY}输入命令即可开始对话，示例:${RESET}\n`);
-    console.log(`  ${CYAN}读取 想法.md${RESET}          ${GRAY}- 读取文档${RESET}`);
-    console.log(`  ${CYAN}总结 文档.md${RESET}           ${GRAY}- 总结文档${RESET}`);
-    console.log(`  ${CYAN}--agents${RESET}               ${GRAY}- 查看 SubAgent${RESET}`);
-    console.log(`  ${CYAN}--context${RESET}              ${GRAY}- 查看全局上下文${RESET}`);
-    console.log(`  ${CYAN}--delegate 任务 coding${RESET}  ${GRAY}- 委派任务${RESET}`);
-    console.log(`  ${CYAN}peers${RESET}                  ${GRAY}- 查看 P2P 节点${RESET}`);
-    console.log(`  ${CYAN}iroh${RESET}                   ${GRAY}- 查看 iroh 状态${RESET}`);
-    console.log(`  ${CYAN}退出${RESET}                   ${GRAY}- 结束对话${RESET}\n`);
-
-    if (!isTuiMode) {
-      console.log = originalLog;
-      console.info = originalInfo;
-      process.stdout.write = originalStdoutWrite;
-    }
-
-    startCLI(comm!);
-  }
-}
-
-main().catch(e => { console.error('Fatal:', e); process.exit(1); });