@bolloon/bolloon-agent 0.1.36 → 0.1.37

package/src/bootstrap/project-context.ts

@@ -1,171 +0,0 @@
-/**
- * Project Context Formatter — BolloonContext → system prompt 片段
- *
- * 输出 markdown 文本, 直接拼到 LLM system prompt 头部
- *
- * 字符上限默认 4000 (system prompt 不能太长).
- * 超限时按优先级砍: TODO 列表 → 压缩 Bolloon.md → 砍 judgments top values
- */
-
-import type { BolloonContext } from './context-collector.js';
-
-const DEFAULT_MAX_CHARS = 8000;  // 从 4000 提到 8000, 给 4 级 Bolloon.md 留空间
-const BOLLOON_MD_KEEP = 500;  // 砍到这么长
-
-export function formatContextForSystemPrompt(
-  ctx: BolloonContext,
-  opts: { maxChars?: number } = {}
-): string {
-  const maxChars = opts.maxChars ?? DEFAULT_MAX_CHARS;
-  const lines: string[] = [];
-  lines.push(`# 你的项目上下文 (自动 bootstrap, 时间: ${ctx.collectedAt})`);
-  lines.push('');
-
-  // 1. Bolloon.md 4 级层次 (Claude Code 论文, 严格 1:1)
-  //    managed → user → project → local, 已在 collector 层 merge
-  if (ctx.hierarchy && ctx.hierarchy.merged && ctx.hierarchy.merged.length > 0) {
-    lines.push('## 规则层次 (4 级, Claude Code 论文对齐)');
-    lines.push(ctx.hierarchy.merged);
-    lines.push('');
-  }
-
-  // 1b. 项目名 + Bolloon.md 摘要 (向后兼容, Bolloon.md 也算 project 层之一)
-  lines.push(`## 项目: ${ctx.projectName}`);
-  lines.push(`- 路径: ${ctx.projectRoot}`);
-  if (ctx.bolloonMd) {
-    const mdSummary = firstParagraphs(ctx.bolloonMd, 3);
-    lines.push(`- Bolloon.md 摘要:`);
-    lines.push(mdSummary);
-  } else {
-    lines.push(`- Bolloon.md: (缺失, 建议创建)`);
-  }
-  lines.push('');
-
-  // 2. Git
-  if (ctx.git) {
-    lines.push(`## Git 状态`);
-    lines.push(`- branch: ${ctx.git.branch}`);
-    lines.push(`- 未提交变更: ${ctx.git.uncommittedChanges}`);
-    if (ctx.git.lastCommits.length > 0) {
-      lines.push(`- 最近提交:`);
-      for (const c of ctx.git.lastCommits) {
-        lines.push(`  - ${c}`);
-      }
-    }
-    lines.push('');
-  }
-
-  // 3. Persona
-  if (ctx.persona) {
-    lines.push(`## 用户身份 (persona)`);
-    lines.push(`- 名字: ${ctx.persona.name}`);
-    if (ctx.persona.description) lines.push(`- 描述: ${ctx.persona.description}`);
-    if (ctx.persona.personality) lines.push(`- 性格: ${ctx.persona.personality}`);
-    lines.push('');
-  }
-
-  // 4. Judgments
-  if (ctx.judgmentsSummary.total > 0) {
-    const j = ctx.judgmentsSummary;
-    lines.push(`## 已沉淀的判断力 (${j.total} 条)`);
-    lines.push(`- 活跃: ${j.active}, 已过时: ${j.superseded}, 已拒绝: ${j.rejected}`);
-    if (j.topValues.length > 0) {
-      const topStr = j.topValues.map((v) => `${v.category}/${v.value}`).join(', ');
-      lines.push(`- Top 价值偏好: [${topStr}]`);
-    }
-    lines.push('');
-  }
-
-  // 5. Skills
-  if (ctx.skills.length > 0) {
-    lines.push(`## 工具 + Skills`);
-    lines.push(`- 已注册 skills (${ctx.skills.length}):`);
-    for (const s of ctx.skills) {
-      const desc = s.description ? ` — ${s.description}` : '';
-      lines.push(`  - ${s.name}${desc}`);
-    }
-    lines.push('');
-  }
-
-  // 6. Pending
-  if (ctx.pending.goals.length > 0 || ctx.pending.todos.length > 0) {
-    lines.push(`## 未完成任务`);
-    if (ctx.pending.goals.length > 0) {
-      lines.push(`- ~/.bolloon/goals/: ${ctx.pending.goals.length} 条 (${ctx.pending.goals.slice(0, 3).join(', ')}${ctx.pending.goals.length > 3 ? '...' : ''})`);
-    }
-    if (ctx.pending.todos.length > 0) {
-      lines.push(`- 代码 TODO/FIXME: ${ctx.pending.todos.length} 处`);
-      for (const t of ctx.pending.todos.slice(0, 5)) {
-        lines.push(`  - ${t.file}:${t.line} ${t.text}`);
-      }
-    }
-    lines.push('');
-  }
-
-  // 7. 环境 (放最后, 信息密度低)
-  lines.push(`## 环境`);
-  lines.push(`- ${ctx.env.os}, Node ${ctx.env.nodeVersion}, LLM: ${ctx.env.llmProvider}`);
-
-  // 字符截断
-  let result = lines.join('\n');
-  if (result.length > maxChars) {
-    result = truncateContext(ctx, maxChars);
-  }
-  return result;
-}
-
-/**
- * 超限时按优先级砍: TODO 列表 → 压缩 Bolloon.md → 砍 top values
- */
-function truncateContext(ctx: BolloonContext, maxChars: number): string {
-  // 先砍 TODO 列表 (low value)
-  const todoCapped = ctx.pending.todos.slice(0, 3);
-  const goalsCapped = ctx.pending.goals.slice(0, 2);
-  // 再砍 Bolloon.md
-  const mdCapped = ctx.bolloonMd
-    ? firstParagraphs(ctx.bolloonMd, 1, BOLLOON_MD_KEEP)
-    : null;
-  // 砍 top values
-  const topValuesCapped = ctx.judgmentsSummary.topValues.slice(0, 5);
-
-  const lines: string[] = [];
-  lines.push(`# 你的项目上下文 (自动 bootstrap, 时间: ${ctx.collectedAt}, 截断模式)`);
-  lines.push(`## 项目: ${ctx.projectName}`);
-  if (mdCapped) {
-    lines.push(`- Bolloon.md (压缩): ${mdCapped.split('\n')[0]?.substring(0, 100)}...`);
-  }
-  if (ctx.git) {
-    lines.push(`## Git: ${ctx.git.branch} (未提交: ${ctx.git.uncommittedChanges})`);
-    for (const c of ctx.git.lastCommits.slice(0, 3)) lines.push(`  - ${c}`);
-  }
-  if (ctx.persona) lines.push(`## Persona: ${ctx.persona.name}`);
-  if (ctx.judgmentsSummary.total > 0) {
-    lines.push(`## 判断力: ${ctx.judgmentsSummary.total} 条 (活跃 ${ctx.judgmentsSummary.active})`);
-    if (topValuesCapped.length > 0) {
-      lines.push(`- Top: ${topValuesCapped.map((v) => `${v.category}/${v.value}`).join(', ')}`);
-    }
-  }
-  if (ctx.skills.length > 0) {
-    lines.push(`## Skills (${ctx.skills.length}): ${ctx.skills.map((s) => s.name).join(', ')}`);
-  }
-  if (todoCapped.length > 0) {
-    lines.push(`## TODO (${todoCapped.length}/${ctx.pending.todos.length})`);
-    for (const t of todoCapped) lines.push(`  - ${t.file}:${t.line} ${t.text}`);
-  }
-  if (goalsCapped.length > 0) {
-    lines.push(`## Goals: ${goalsCapped.join(', ')}`);
-  }
-  return lines.join('\n');
-}
-
-/**
- * 取前 N 段非空段落
- */
-function firstParagraphs(text: string, count: number, maxLen?: number): string {
-  const paragraphs = text.split(/\n\s*\n/).filter((p) => p.trim().length > 0);
-  let result = paragraphs.slice(0, count).join('\n\n');
-  if (maxLen && result.length > maxLen) {
-    result = result.substring(0, maxLen) + '...';
-  }
-  return result;
-}

package/src/cli/interface.ts

@@ -1,211 +0,0 @@
-import * as readline from 'readline';
-import { documentReader } from '../documents/reader.js';
-import { getMinimax } from '../constraints/index.js';
-import { AgentProtocol } from '../agents/protocol.js';
-import { p2pNetwork, P2PNode } from '../network/p2p.js';
-
-export class CLIInterface {
-  private agent: AgentProtocol | null = null;
-  private localNode: P2PNode | null = null;
-  private rl: readline.Interface;
-
-  constructor() {
-    this.rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-  }
-
-  async start(): Promise<void> {
-    console.log('\n🤖 AI文档智能体 P2P 网络');
-    console.log('========================\n');
-
-    await this.initP2PNode();
-    await this.initLLM();
-    this.initAgent();
-
-    this.showHelp();
-    await this.runLoop();
-  }
-
-  private async initP2PNode(): Promise<void> {
-    console.log('初始化P2P节点...');
-
-    const bootstrapPeers = process.env.BOOTSTRAP_PEERS?.split(',');
-
-    this.localNode = await p2pNetwork.createNode({ bootstrapPeers });
-
-    console.log(`节点已启动!`);
-    console.log(`Peer ID: ${this.localNode.peerId}`);
-    console.log(`地址: ${this.localNode.multiaddrs.join(', ')}\n`);
-
-    this.syncOfflineMessages();
-  }
-
-  private async initLLM(): Promise<void> {
-    const apiKey = process.env.MINIMAX_API_KEY;
-
-    if (!apiKey) {
-      console.warn('⚠️  MINIMAX_API_KEY 未设置，摘要功能将使用模拟模式');
-      return;
-    }
-
-    getMinimax();
-    console.log('LLM已初始化\n');
-  }
-
-  private initAgent(): void {
-    if (!this.localNode) throw new Error('P2P node not initialized');
-    this.agent = new AgentProtocol(this.localNode.peerId);
-    console.log('Agent协议已初始化\n');
-  }
-
-  private async syncOfflineMessages(): Promise<void> {
-    if (!this.localNode) return;
-
-    const messages = p2pNetwork.getOfflineMessages(this.localNode.peerId);
-    for (const msg of messages) {
-      const messageStr = new TextDecoder().decode(msg);
-      const [type, ...payloadParts] = messageStr.split(':');
-      console.log(`📬 收到离线消息 [${type}]: ${payloadParts.join(':')}`);
-    }
-  }
-
-  private showHelp(): void {
-    console.log('\n可用命令:');
-    console.log('  read <file>     - 读取并处理文档');
-    console.log('  peers           - 显示已连接的对等节点');
-    console.log('  send <peer>     - 向指定节点发送消息');
-    console.log('  broadcast       - 广播任务到所有节点');
-    console.log('  summary <text>  - 总结文本');
-    console.log('  help            - 显示帮助');
-    console.log('  exit            - 退出\n');
-  }
-
-  private async runLoop(): Promise<void> {
-    while (true) {
-      const input = await this.prompt('> ');
-
-      if (!input) continue;
-
-      const [cmd, ...args] = input.trim().split(/\s+/);
-
-      try {
-        switch (cmd.toLowerCase()) {
-          case 'read':
-            await this.handleRead(args[0]);
-            break;
-          case 'peers':
-            this.handlePeers();
-            break;
-          case 'send':
-            await this.handleSend(args[0]);
-            break;
-          case 'broadcast':
-            await this.handleBroadcast();
-            break;
-          case 'summary':
-            await this.handleSummary(args.join(' '));
-            break;
-          case 'help':
-            this.showHelp();
-            break;
-          case 'exit':
-            await this.shutdown();
-            return;
-          default:
-            console.log('未知命令，输入 help 查看可用命令');
-        }
-      } catch (e) {
-        console.error('错误:', e);
-      }
-    }
-  }
-
-  private prompt(question: string): Promise<string> {
-    return new Promise(resolve => {
-      this.rl.question(question, resolve);
-    });
-  }
-
-  private async handleRead(filePath?: string): Promise<void> {
-    if (!filePath) {
-      console.log('请提供文件路径: read <file>');
-      return;
-    }
-
-    console.log(`📄 读取文档: ${filePath}`);
-    const content = await documentReader.read(filePath);
-    console.log(`文档大小: ${content.metadata.size} 字节`);
-    console.log(`内容预览: ${content.text.substring(0, 200)}...\n`);
-
-    const llm = getMinimax();
-    const chunks = documentReader.chunk(content.text);
-    const summaries: string[] = [];
-
-    for (let i = 0; i < chunks.length; i++) {
-      console.log(`处理块 ${i + 1}/${chunks.length}...`);
-      const result = await llm.summarize(chunks[i]);
-      summaries.push(result.summary);
-
-      if (result.qualityScore >= 0.7) {
-        console.log(`  ✅ 质量评分: ${(result.qualityScore * 10).toFixed(1)}/10`);
-      } else {
-        console.log(`  ⚠️ 质量评分: ${(result.qualityScore * 10).toFixed(1)}/10, 需要审核`);
-      }
-    }
-
-    console.log('\n📝 生成的摘要:');
-    console.log(summaries.join('\n\n'));
-  }
-
-  private handlePeers(): void {
-    const peers = p2pNetwork.getPeers();
-    if (peers.length === 0) {
-      console.log('当前无连接的对等节点');
-    } else {
-      console.log('已连接节点:');
-      for (const peer of peers) {
-        console.log(`  - ${peer}`);
-      }
-    }
-  }
-
-  private async handleSend(peerId?: string): Promise<void> {
-    if (!peerId) {
-      console.log('请提供目标节点ID: send <peer-id>');
-      return;
-    }
-
-    const message = await this.prompt('输入消息: ');
-    await p2pNetwork.sendMessage(peerId, 'message', message);
-    console.log('消息已发送');
-  }
-
-  private async handleBroadcast(): Promise<void> {
-    const message = await this.prompt('输入广播消息: ');
-    await p2pNetwork.broadcast('message', message);
-    console.log('广播已发送');
-  }
-
-  private async handleSummary(text: string): Promise<void> {
-    if (!text) {
-      console.log('请提供要总结的文本: summary <text>');
-      return;
-    }
-
-    const llm = getMinimax();
-    const result = await llm.summarize(text);
-
-    console.log('\n📝 摘要结果:');
-    console.log(result.summary);
-    console.log(`\n质量评分: ${(result.qualityScore * 10).toFixed(1)}/10`);
-  }
-
-  private async shutdown(): Promise<void> {
-    console.log('\n正在关闭...');
-    await p2pNetwork.shutdown();
-    this.rl.close();
-    console.log('已退出');
-  }
-}

package/src/cli-entry.ts

@@ -1,304 +0,0 @@
-#!/usr/bin/env node
-/**
- * Bolloon CLI 入口
- *
- * 使用方式:
- *   bolloon                    # 启动 GUI（Electron 或 Web）
- *   bolloon --cli              # 启动命令行界面
- *   bolloon --read <file>      # 读取文档
- *   bolloon --summarize <file> # 总结文档
- *   bolloon --web              # 启动 Web UI
- *   bolloon --version          # 显示版本
- */
-
-import { spawn } from 'child_process';
-import * as path from 'path';
-import * as fs from 'fs';
-
-const isWindows = process.platform === 'win32';
-
-// ANSI 颜色
-const RESET = '\x1b[0m';
-const BOLD = '\x1b[1m';
-const CYAN = '\x1b[36m';
-const YELLOW = '\x1b[33m';
-const GREEN = '\x1b[32m';
-const MAGENTA = '\x1b[35m';
-
-// 版本信息
-const VERSION = '0.1.12';
-
-function log(msg: string, color: string = RESET) {
-  console.log(`${color}${msg}${RESET}`);
-}
-
-function printBanner() {
-  console.log(`
-${CYAN}${BOLD}
-   ╔═══════════════════════════════════════════╗
-   ║      🤖 Bolloon Agent ${VERSION}              ║
-   ║      P2P AI Document Processor            ║
-   ╚═══════════════════════════════════════════╝${RESET}
-`);
-}
-
-function printHelp() {
-  console.log(`
-${BOLD}用法:${RESET}
-  bolloon [选项] [命令] [参数]
-
-${BOLD}选项:${RESET}
-  --gui, -g           启动图形界面 (Electron)
-  --web, -w           启动 Web UI (浏览器)
-  --cli, -c           启动命令行界面
-  --version, -v       显示版本信息
-  --help, -h          显示帮助信息
-
-${BOLD}命令:${RESET}
-  bolloon --read <file>           读取文档
-  bolloon --summarize <file>      总结文档
-  bolloon --improve <file> <req>  改进文档
-
-${BOLD}示例:${RESET}
-  bolloon                    # 启动图形界面
-  bolloon --web              # 启动 Web UI
-  bolloon --read 想法.md     # 读取文档
-  bolloon --cli              # 命令行模式
-
-${BOLD}环境变量:${RESET}
-  MINIMAX_API_KEY           MiniMax API 密钥
-  OPENAI_API_KEY            OpenAI API 密钥
-  ANTHROPIC_API_KEY         Anthropic API 密钥
-  PORT                      Web 服务端口 (默认 54188)
-`);
-}
-
-function getDistDir(): string {
-  // 对于打包后的应用，__dirname 是 dist 目录
-  return __dirname;
-}
-
-function getMainScript(): string {
-  const distDir = getDistDir();
-
-  // 检查 dist/index.js 是否存在
-  const indexPath = path.join(distDir, 'index.js');
-  if (fs.existsSync(indexPath)) {
-    return indexPath;
-  }
-
-  // 回退到源目录
-  const srcPath = path.join(process.cwd(), 'src', 'index.ts');
-  if (fs.existsSync(srcPath)) {
-    return path.join(process.cwd(), 'src', 'index.ts');
-  }
-
-  throw new Error('找不到入口脚本，请确保已执行 npm run build');
-}
-
-function getElectronPath(): string {
-  // 获取 electron 可执行文件路径
-  const electronPath = require('electron');
-  return electronPath;
-}
-
-// 解析命令行参数
-function parseArgs(): { mode: string; args: string[] } {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    return { mode: 'gui', args: [] };
-  }
-
-  const mode = args[0];
-
-  // 处理简写选项
-  switch (mode) {
-    case '-v':
-    case '--version':
-      return { mode: 'version', args: [] };
-    case '-h':
-    case '--help':
-      return { mode: 'help', args: [] };
-    case '-g':
-    case '--gui':
-      return { mode: 'gui', args: args.slice(1) };
-    case '-w':
-    case '--web':
-      return { mode: 'web', args: args.slice(1) };
-    case '-c':
-    case '--cli':
-      return { mode: 'cli', args: args.slice(1) };
-    default:
-      // 传递所有参数给主程序
-      return { mode: 'passthrough', args };
-  }
-}
-
-// 执行 Node.js 脚本
-async function runNodeScript(scriptPath: string, additionalArgs: string[]) {
-  return new Promise<void>((resolve, reject) => {
-    const child = spawn(process.execPath, [scriptPath, ...additionalArgs], {
-      stdio: 'inherit',
-      env: { ...process.env }
-    });
-
-    child.on('error', reject);
-    child.on('exit', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`进程退出，代码: ${code}`));
-      }
-    });
-  });
-}
-
-// 启动 Electron
-async function startElectron(additionalArgs: string[]) {
-  const electronPath = getElectronPath();
-  const distDir = getDistDir();
-
-  // 确定主进程入口
-  let mainPath = path.join(distDir, 'electron.js');
-  if (!fs.existsSync(mainPath)) {
-    mainPath = path.join(distDir, '..', 'src', 'electron.js');
-  }
-
-  if (!fs.existsSync(mainPath)) {
-    // 回退到开发模式
-    mainPath = path.join(process.cwd(), 'src', 'electron.ts');
-  }
-
-  log('启动 Electron...', CYAN);
-
-  const child = spawn(electronPath, [mainPath, ...additionalArgs], {
-    stdio: 'inherit',
-    env: { ...process.env, NODE_ENV: 'development' }
-  });
-
-  child.on('error', (err) => {
-    log(`Electron 启动失败: ${err.message}`, MAGENTA);
-    process.exit(1);
-  });
-
-  child.on('exit', (code) => {
-    process.exit(code || 0);
-  });
-}
-
-// 启动 Web 服务
-async function startWebServer(additionalArgs: string[]) {
-  log('启动 Web 服务...', CYAN);
-
-  try {
-    const mainPath = getMainScript();
-    const webArgs = ['--web', ...additionalArgs];
-
-    const child = spawn(process.execPath, [mainPath, ...webArgs], {
-      stdio: 'inherit',
-      env: { ...process.env }
-    });
-
-    child.on('error', (err) => {
-      log(`Web 服务启动失败: ${err.message}`, MAGENTA);
-      process.exit(1);
-    });
-
-    child.on('exit', (code) => {
-      process.exit(code || 0);
-    });
-  } catch (err: any) {
-    log(`启动失败: ${err.message}`, MAGENTA);
-    process.exit(1);
-  }
-}
-
-// 启动 CLI
-async function startCLI(additionalArgs: string[]) {
-  log('启动命令行界面...', CYAN);
-
-  try {
-    const mainPath = getMainScript();
-    const cliArgs = [...additionalArgs];
-
-    const child = spawn(process.execPath, [mainPath, ...cliArgs], {
-      stdio: 'inherit',
-      env: { ...process.env }
-    });
-
-    child.on('error', (err) => {
-      log(`CLI 启动失败: ${err.message}`, MAGENTA);
-      process.exit(1);
-    });
-
-    child.on('exit', (code) => {
-      process.exit(code || 0);
-    });
-  } catch (err: any) {
-    log(`启动失败: ${err.message}`, MAGENTA);
-    process.exit(1);
-  }
-}
-
-// 主入口
-async function main() {
-  const { mode, args } = parseArgs();
-
-  switch (mode) {
-    case 'version':
-      console.log(`Bolloon Agent v${VERSION}`);
-      break;
-
-    case 'help':
-      printHelp();
-      break;
-
-    case 'gui':
-      printBanner();
-      await startElectron(args);
-      break;
-
-    case 'web':
-      printBanner();
-      await startWebServer(args);
-      break;
-
-    case 'cli':
-      await startCLI(args);
-      break;
-
-    case 'passthrough':
-      // 传递所有参数给主程序
-      try {
-        const mainPath = getMainScript();
-        const child = spawn(process.execPath, [mainPath, ...args], {
-          stdio: 'inherit',
-          env: { ...process.env }
-        });
-
-        child.on('error', (err) => {
-          log(`执行失败: ${err.message}`, MAGENTA);
-          process.exit(1);
-        });
-
-        child.on('exit', (code) => {
-          process.exit(code || 0);
-        });
-      } catch (err: any) {
-        log(`执行失败: ${err.message}`, MAGENTA);
-        process.exit(1);
-      }
-      break;
-
-    default:
-      log(`未知模式: ${mode}`, MAGENTA);
-      printHelp();
-      process.exit(1);
-  }
-}
-
-main().catch((err) => {
-  console.error('Fatal error:', err);
-  process.exit(1);
-});

package/src/constraints/index.ts

@@ -1,6 +0,0 @@
-/**
- * Constraints Module
- * Re-exports LLM initialization functions for pi-sdk compatibility
- */
-
-export { initMinimax, getMinimax } from '../llm/pi-ai.js';