@bolloon/bolloon-agent 0.2.1 → 0.2.3

package/scripts/auto-evolve-snapshot.sh

@@ -1,136 +0,0 @@
-#!/bin/bash
-# auto-evolve-snapshot.sh — 阶段 C 护栏 2 + 3
-#
-# 用法 (LLM 改源码前必调):
-#   bash scripts/auto-evolve-snapshot.sh          # 打 baseline tag + 记当前 HEAD
-#   bash scripts/auto-evolve-snapshot.sh apply <patch-id>   # 人类批准后合并 staging → main
-#   bash scripts/auto-evolve-snapshot.sh list      # 列所有 baseline
-#   bash scripts/auto-evolve-snapshot.sh rollback <tag>     # 回滚到指定 baseline
-#
-# 流程:
-#   1. LLM 改之前调 snapshot: 当前 HEAD 打 auto-evolve-baseline-<ts> tag
-#   2. LLM 改 staging/auto-evolve/<patch-id>/  (不进 src/)
-#   3. 护栏 1 (lefthook) 跑 vitest + tsc, 坏就 abort
-#   4. 护栏 4 (reviewer hook) 审 diff, 通过才准 apply
-#   5. 人类调 apply: git apply staging/auto-evolve/<patch-id>/*.patch → src/
-#   6. 出问题: 调 rollback → git reset --hard <tag>
-
-set -euo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-cd "$REPO_ROOT"
-
-STAGING_DIR="staging/auto-evolve"
-TAG_PREFIX="auto-evolve-baseline-"
-
-cmd="${1:-snapshot}"
-patch_id="${2:-}"
-
-case "$cmd" in
-  snapshot)
-    # 护栏 2: 打 baseline tag
-    if ! git diff --quiet HEAD 2>/dev/null; then
-      echo "❌ 有未提交改动. 先 git commit 或 git stash"
-      exit 1
-    fi
-    ts="$(date -u +%Y%m%dT%H%M%SZ)"
-    tag="${TAG_PREFIX}${ts}"
-    git tag -a "$tag" -m "auto-evolve baseline @ ${ts}" HEAD
-    echo "✅ baseline tag: $tag"
-    echo "$tag" > .last-auto-evolve-baseline
-    echo "   回滚命令: bash $0 rollback $tag"
-    ;;
-
-  prepare)
-    # LLM 改之前调: 创建 staging 目录
-    if [ -z "$patch_id" ]; then
-      echo "用法: $0 prepare <patch-id>"
-      exit 1
-    fi
-    mkdir -p "$STAGING_DIR/$patch_id"
-    echo "$patch_id" > "$STAGING_DIR/$patch_id/.patch-id"
-    echo "✅ staging 创建: $STAGING_DIR/$patch_id/"
-    echo "   LLM 改完后把 patch 放这里: $STAGING_DIR/$patch_id/*.patch"
-    ;;
-
-  apply)
-    # 人类批准: 把 staging 的 patch 合并到 src/
-    if [ -z "$patch_id" ]; then
-      echo "用法: $0 apply <patch-id>"
-      exit 1
-    fi
-    patch_dir="$STAGING_DIR/$patch_id"
-    if [ ! -d "$patch_dir" ]; then
-      echo "❌ staging 不存在: $patch_dir"
-      exit 1
-    fi
-    # 必须先 snapshot
-    if [ ! -f .last-auto-evolve-baseline ]; then
-      echo "❌ 没有 baseline. 先跑: $0 snapshot"
-      exit 1
-    fi
-    baseline="$(cat .last-auto-evolve-baseline)"
-
-    # 应用所有 patch
-    applied=0
-    for p in "$patch_dir"/*.patch; do
-      [ -e "$p" ] || continue
-      echo "  applying: $p"
-      if ! git apply --check "$p"; then
-        echo "❌ patch 不可用: $p (可能已应用过)"
-        exit 1
-      fi
-      git apply "$p"
-      applied=$((applied + 1))
-    done
-
-    if [ $applied -eq 0 ]; then
-      echo "❌ staging 里没有 .patch 文件"
-      exit 1
-    fi
-
-    echo "✅ 应用 $applied 个 patch"
-    echo "   建议现在跑: npm test  +  git commit -m 'auto-evolve: $patch_id'"
-    echo "   出问题回滚: $0 rollback $baseline"
-    ;;
-
-  rollback)
-    # 回滚到指定 baseline
-    if [ -z "$patch_id" ]; then
-      echo "用法: $0 rollback <tag>"
-      echo "可用的 baseline:"
-      git tag -l "${TAG_PREFIX}*" | sort -r | head -10
-      exit 1
-    fi
-    if ! git tag -l | grep -qx "$patch_id"; then
-      echo "❌ tag 不存在: $patch_id"
-      exit 1
-    fi
-    echo "⚠️  将回滚到 $patch_id (hard reset, 丢弃之后所有改动)"
-    read -p "确认? [y/N] " -n 1 -r
-    echo
-    if [[ $REPLY =~ ^[Yy]$ ]]; then
-      git reset --hard "$patch_id"
-      echo "✅ 回滚到 $patch_id"
-    else
-      echo "取消"
-    fi
-    ;;
-
-  list)
-    echo "auto-evolve baselines (最近 10):"
-    git tag -l "${TAG_PREFIX}*" | sort -r | head -10 | while read tag; do
-      msg="$(git tag -l --format='%(contents)' "$tag" | head -1)"
-      echo "  $tag — $msg"
-    done
-    if [ -f .last-auto-evolve-baseline ]; then
-      echo ""
-      echo "当前 baseline: $(cat .last-auto-evolve-baseline)"
-    fi
-    ;;
-
-  *)
-    echo "用法: $0 {snapshot|prepare <id>|apply <id>|rollback <tag>|list}"
-    exit 1
-    ;;
-esac

package/scripts/build-cli.js

@@ -1,216 +0,0 @@
-/**
- * CLI 构建脚本
- *
- * 生成 bin/bolloon.js 和 bin/bolloon.cmd 入口文件
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.join(__dirname, '..');
-
-const binDir = path.join(rootDir, 'bin');
-if (!fs.existsSync(binDir)) {
-  fs.mkdirSync(binDir, { recursive: true });
-}
-
-// Windows 批处理入口
-const winContent = `@echo off
-set "BOLLOON_ROOT=%~dp0"
-set "BOLLOON_ROOT=%BOLLOON_ROOT:~0,-1%"
-
-REM 确定入口文件
-set "ENTRY=%BOLLOON_ROOT%\\dist\\index.js"
-if not exist "%ENTRY%" (
-    set "ENTRY=%BOLLOON_ROOT%\\src\\index.ts"
-)
-
-node "%ENTRY%" %*
-`;
-
-fs.writeFileSync(path.join(binDir, 'bolloon.cmd'), winContent);
-
-// Unix/Linux/Mac 入口脚本
-const unixContent = `#!/usr/bin/env node
-const path = require("path");
-const { spawn } = require("child_process");
-const fs = require("fs");
-
-const RESET = "\\x1b[0m";
-const BOLD = "\\x1b[1m";
-const CYAN = "\\x1b[36m";
-const GREEN = "\\x1b[32m";
-const MAGENTA = "\\x1b[35m";
-
-function log(msg, color) {
-  console.log((color || RESET) + msg + RESET);
-}
-
-function printBanner() {
-  console.log("\\n" + CYAN + BOLD + [
-    "   ╔═══════════════════════════════════════════╗",
-    "   ║      🤖 Bolloon Agent                     ║",
-    "   ║      P2P AI Document Processor            ║",
-    "   ╚═══════════════════════════════════════════╝"
-  ].join("\\n") + RESET + "\\n");
-}
-
-function getMainEntry() {
-  const distDir = path.dirname(require.main.filename);
-  const distIndex = path.join(distDir, "index.js");
-  if (fs.existsSync(distIndex)) {
-    return distIndex;
-  }
-  return path.join(process.cwd(), "src", "index.ts");
-}
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  if (args.length === 0) {
-    return { mode: "gui", args: [] };
-  }
-  const first = args[0];
-  switch (first) {
-    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 };
-  }
-}
-
-async function startElectron(additionalArgs) {
-  try {
-    const electron = require("electron");
-    const distDir = path.dirname(require.main.filename);
-    let mainPath = path.join(distDir, "electron.js");
-    if (!fs.existsSync(mainPath)) {
-      mainPath = path.join(process.cwd(), "src", "electron.ts");
-    }
-    log("启动 Electron...", CYAN);
-    const child = spawn(electron, [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));
-  } catch (err) {
-    log("Electron 不可用，切换到 Web 模式...", CYAN);
-    await startWebServer(additionalArgs);
-  }
-}
-
-async function startWebServer(additionalArgs) {
-  const mainPath = getMainEntry();
-  const webArgs = ["--web", ...additionalArgs];
-  log("启动 Web 服务...", CYAN);
-  const child = spawn(process.execPath, [mainPath, ...webArgs], { stdio: "inherit" });
-  child.on("error", (err) => {
-    log("Web 服务启动失败: " + err.message, MAGENTA);
-    process.exit(1);
-  });
-  child.on("exit", (code) => process.exit(code || 0));
-}
-
-async function startCLI(additionalArgs) {
-  const mainPath = getMainEntry();
-  log("启动命令行界面...", CYAN);
-  const child = spawn(process.execPath, [mainPath, ...additionalArgs], { stdio: "inherit" });
-  child.on("error", (err) => {
-    log("CLI 启动失败: " + err.message, MAGENTA);
-    process.exit(1);
-  });
-  child.on("exit", (code) => process.exit(code || 0));
-}
-
-async function main() {
-  const { mode, args } = parseArgs();
-  switch (mode) {
-    case "version":
-      console.log("Bolloon Agent v0.1.1");
-      break;
-    case "help":
-      printBanner();
-      console.log(BOLD + "用法:" + RESET + "  bolloon [选项] [命令] [参数]");
-      console.log(BOLD + "选项:" + RESET + "  --gui, -g           启动图形界面");
-      console.log("         --web, -w           启动 Web UI");
-      console.log("         --cli, -c           启动命令行界面");
-      console.log("         --version, -v       显示版本");
-      console.log("         --help, -h          显示帮助");
-      console.log(BOLD + "示例:" + RESET + "  bolloon              # 启动图形界面");
-      console.log("         bolloon --web        # 启动 Web UI");
-      console.log("         bolloon --read file  # 读取文档");
-      break;
-    case "gui":
-      printBanner();
-      await startElectron(args);
-      break;
-    case "web":
-      printBanner();
-      await startWebServer(args);
-      break;
-    case "cli":
-      await startCLI(args);
-      break;
-    case "passthrough":
-      const mainPath = getMainEntry();
-      const child = spawn(process.execPath, [mainPath, ...args], { stdio: "inherit" });
-      child.on("error", (err) => {
-        log("执行失败: " + err.message, MAGENTA);
-        process.exit(1);
-      });
-      child.on("exit", (code) => process.exit(code || 0));
-      break;
-    default:
-      log("未知模式: " + mode, MAGENTA);
-      printBanner();
-      console.log("输入 --help 查看帮助");
-      process.exit(1);
-  }
-}
-
-main().catch((err) => {
-  console.error("Fatal error:", err);
-  process.exit(1);
-});
-`;
-
-fs.writeFileSync(path.join(binDir, 'bolloon.cjs'), unixContent);
-
-// 确保 bin/bolloon.js 存在（npm link 需要）
-// 优先用符号链接（POSIX），Windows 上若权限不足则退化为复制文件
-const jsSymlink = path.join(binDir, 'bolloon.js');
-if (fs.existsSync(jsSymlink)) fs.unlinkSync(jsSymlink);
-try {
-  fs.symlinkSync('bolloon.cjs', jsSymlink);
-} catch (err) {
-  if (err && err.code === 'EPERM') {
-    fs.copyFileSync(path.join(binDir, 'bolloon.cjs'), jsSymlink);
-    console.warn('  ⚠ symlink 不支持（Windows），已退化为文件复制');
-  } else {
-    throw err;
-  }
-}
-
-console.log("✓ CLI 构建完成");
-console.log("  bin/bolloon.cjs    - CommonJS 入口");
-console.log("  bin/bolloon.js     - 符号链接 -> bolloon.cjs");
-console.log("  bin/bolloon.cmd    - Windows 入口");

package/scripts/detect-schema-changes.sh

@@ -1,48 +0,0 @@
-#!/bin/bash
-# detect-schema-changes.sh — 阶段 C 护栏 6
-#
-# 检查 LLM 改的文件里有没有动 schema (interface / type / enum 声明)
-# 有则强制要求 reviewer 双签 (在 .auto-evolve-review-required 文件)
-#
-# 用法 (在 staging 准备好 patch 后, apply 前):
-#   bash scripts/detect-schema-changes.sh <patch-id>
-
-set -euo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-cd "$REPO_ROOT"
-
-patch_id="${1:-}"
-if [ -z "$patch_id" ]; then
-  echo "用法: $0 <patch-id>"
-  exit 1
-fi
-
-staging_dir="staging/auto-evolve/$patch_id"
-if [ ! -d "$staging_dir" ]; then
-  echo "❌ staging 不存在: $staging_dir"
-  exit 1
-fi
-
-flag="$staging_dir/.schema-changed"
-rm -f "$flag"
-
-found=0
-for patch in "$staging_dir"/*.patch; do
-  [ -e "$patch" ] || continue
-  # 检查 patch 里有没有新增/修改 interface、type、enum 声明
-  if grep -E '^\+.*(interface |type [A-Z][a-zA-Z0-9_]* =|enum [A-Z][a-zA-Z0-9_]*)' "$patch" > /dev/null 2>&1; then
-    found=1
-    echo "⚠️  schema 改动检测到: $patch"
-    grep -E '^\+.*(interface |type [A-Z][a-zA-Z0-9_]* =|enum [A-Z][a-zA-Z0-9_]*)' "$patch" | head -3
-  fi
-done
-
-if [ $found -eq 1 ]; then
-  touch "$flag"
-  echo ""
-  echo "🚨 schema 改动标记: $flag"
-  echo "   护栏 6 触发: apply 时会强制要求双签 reviewer"
-else
-  echo "✅ 无 schema 改动, 走单签"
-fi

package/scripts/lefthook-helper.sh

@@ -1,69 +0,0 @@
-#!/bin/sh
-# 2026-06-17: lefthook helper — agent auto-evolve branch detection
-# 写在独立文件里避免 lefthook 嵌套引号 + Windows bash 解析问题
-# 用法: lefthook.yml 里 run: sh scripts/lefthook-helper.sh <command>
-#   <command> = commit | vitest-full | build-check | tag-baseline
-
-CMD="$1"
-BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo none)
-AUTO_EVOLVE_MSG=$(git log -1 --pretty=%B 2>/dev/null | head -1 | grep -c ^auto-evolve: || echo 0)
-
-is_master_main() {
-  [ "$BRANCH" = "master" ] || [ "$BRANCH" = "main" ]
-}
-
-is_auto_evolve() {
-  if [ "$BOLLOON_AUTO_EVOLVE" = "1" ]; then return 0; fi
-  if [ "$AUTO_EVOLVE_MSG" -gt 0 ] 2>/dev/null; then return 0; fi
-  return 1
-}
-
-case "$CMD" in
-  commit-vitest-bail)
-    if is_auto_evolve; then
-      echo "[skip] vitest-bail (auto-evolve mode, branch=$BRANCH)"
-      exit 0
-    fi
-    npx vitest run --bail=1 --reporter=dot
-    ;;
-  commit-tsc-check)
-    if is_auto_evolve; then
-      echo "[skip] tsc-check (auto-evolve mode, branch=$BRANCH)"
-      exit 0
-    fi
-    npx tsc --noEmit
-    ;;
-  push-vitest-full)
-    if is_master_main; then
-      npx vitest run --reporter=dot
-    else
-      echo "[skip] vitest-full (branch=$BRANCH, not master/main)"
-      exit 0
-    fi
-    ;;
-  push-build-check)
-    if is_master_main; then
-      npm run build:main
-    else
-      echo "[skip] build-check (branch=$BRANCH, not master/main)"
-      exit 0
-    fi
-    ;;
-  push-tag-baseline)
-    if is_master_main; then
-      if git tag -l 'auto-evolve-baseline-*' | grep -q .; then
-        exit 0
-      else
-        echo "[ERROR] push to master/main requires auto-evolve-baseline-* tag. Run: bash scripts/auto-evolve-snapshot.sh"
-        exit 1
-      fi
-    else
-      echo "[skip] tag-baseline (branch=$BRANCH, not master/main)"
-      exit 0
-    fi
-    ;;
-  *)
-    echo "Unknown command: $CMD"
-    exit 1
-    ;;
-esac

package/scripts/postinstall.js

@@ -1,153 +0,0 @@
-/**
- * Postinstall 脚本
- * npm 安装后自动执行
- *
- * 主要任务：
- * 1. 确保 bin 目录存在且可执行
- * 2. 初始化本地配置
- * 3. 检查依赖完整性
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.join(__dirname, '..');
-
-const RESET = '\x1b[0m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
-
-function log(msg, color = RESET) {
-  console.log(color + msg + RESET);
-}
-
-function initUserDirs() {
-  // 创建用户数据目录
-  const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
-  const bolloonDir = path.join(home, '.bolloon');
-
-  const dirs = [
-    bolloonDir,
-    path.join(bolloonDir, 'sessions'),
-    path.join(bolloonDir, 'peer-store'),
-  ];
-
-  for (const dir of dirs) {
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-      log(`  ✓ 创建目录: ${dir}`, GREEN);
-    }
-  }
-
-  // 初始化配置文件
-  const configPath = path.join(bolloonDir, 'config.json');
-  if (!fs.existsSync(configPath)) {
-    const defaultConfig = {
-      version: '0.1.12',
-      initializedAt: new Date().toISOString(),
-      defaults: {
-        port: 54188,
-        theme: 'dark',
-        autoConnect: true,
-      },
-      providers: {
-        minimax: { enabled: false },
-        openai: { enabled: false },
-        anthropic: { enabled: false },
-      }
-    };
-    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
-    log(`  ✓ 创建配置: ${configPath}`, GREEN);
-  }
-
-  return bolloonDir;
-}
-
-function checkNativeDeps() {
-  // 检查必要的原生依赖
-  const nativeDeps = [
-    'libp2p',
-    '@diap/sdk',
-  ];
-
-  let allOk = true;
-
-  for (const dep of nativeDeps) {
-    const depPath = path.join(rootDir, 'node_modules', dep);
-    if (!fs.existsSync(depPath)) {
-      log(`  ⚠ 缺少依赖: ${dep}`, YELLOW);
-      allOk = false;
-    }
-  }
-
-  return allOk;
-}
-
-function setupPlatform() {
-  const platform = process.platform;
-
-  log(`\n  平台: ${platform}`, CYAN);
-
-  if (platform === 'win32') {
-    // Windows: 确保 .cmd 文件存在
-    const binDir = path.join(rootDir, 'bin');
-    const cmdPath = path.join(binDir, 'bolloon.cmd');
-
-    if (fs.existsSync(binDir) && !fs.existsSync(cmdPath)) {
-      const cmdContent = `@echo off
-node "%~dp0..\\dist\\cli.js" %*
-`;
-      fs.writeFileSync(cmdPath, cmdContent);
-      log('  ✓ Windows 入口已创建', GREEN);
-    }
-  } else {
-    // Unix/Linux/Mac: 确保 bin 文件可执行
-    const binDir = path.join(rootDir, 'bin');
-    const binPath = path.join(binDir, 'bolloon.js');
-
-    if (fs.existsSync(binPath)) {
-      try {
-        fs.chmodSync(binPath, 0o755);
-        log('  ✓ bin/bolloon.js 已设为可执行', GREEN);
-      } catch (err) {
-        log(`  ⚠ 无法设置执行权限: ${err.message}`, YELLOW);
-      }
-    }
-  }
-}
-
-function main() {
-  console.log('\n📦 Bolloon 安装后处理...\n');
-
-  try {
-    // 1. 初始化用户目录
-    const bolloonDir = initUserDirs();
-    log(`  ✓ 用户数据目录: ${bolloonDir}`, GREEN);
-
-    // 2. 检查依赖
-    const depsOk = checkNativeDeps();
-    if (!depsOk) {
-      log('\n  ⚠ 部分依赖缺失，建议运行: npm install', YELLOW);
-    }
-
-    // 3. 平台特定设置
-    setupPlatform();
-
-    console.log('\n✅ 安装完成！\n');
-    console.log('  使用方式:');
-    console.log('    bolloon              # 启动 GUI');
-    console.log('    bolloon --web        # 启动 Web UI');
-    console.log('    bolloon --cli        # 命令行模式');
-    console.log('    bolloon --help       # 显示帮助\n');
-    console.log(`  配置文件: ${path.join(bolloonDir, 'config.json')}\n`);
-  } catch (err) {
-    console.error('\n❌ 安装后处理失败:', err.message);
-    console.error('  这通常不影响基本功能，继续安装...\n');
-  }
-}
-
-main();