@bolloon/bolloon-agent 0.1.37 → 0.1.39

package/dist/agents/constraint-layer.js

@@ -2,8 +2,7 @@
  * ConstraintLayer - Guardrails for safe autonomous document processing
  * Part of OpenClaw dual-layer architecture (Constraint Layer + Execution Layer)
  */
-import { ToolPermissionContext } from '../constraint-runtime/src/constraint/permission.js';
-import { BudgetTracker } from '../constraint-runtime/src/constraint/budget.js';
+import { ToolPermissionContext, BudgetTracker } from '@bolloon/constraint-runtime';
 /**
  * System prompt for constraint layer
  * Defines boundaries and autonomous permissions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli.js",

package/scripts/auto-evolve-oneshot.sh

@@ -0,0 +1,155 @@
+#!/bin/bash
+# auto-evolve-oneshot.sh — 阶段 D 单次修复 (shell 版)
+#
+# 流程 (全本地, 用 MINIMAX_API_KEY 调 LLM):
+#   1. 跑 vitest, 抓 fail
+#   2. 让 LLM 修 
+#   3. 解析 LLM 输出的 diff, 写到 staging
+#   4. 跑 reviewer (护栏 4)
+#   5. PASS → git apply + commit (护栏 1 拦)
+
+set -uo pipefail  # 不加 -e: vitest 失败要继续
+
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO"
+
+echo "[oneshot] REPO=$REPO"
+
+# 1. 跑 vitest
+npx vitest run --reporter=json --no-color 2>/dev/null > /tmp/vt-out.json
+TOTAL_FAIL=$(python3 -c "
+import json
+d = json.load(open('/tmp/vt-out.json'))
+print(sum(1 for f in d.get('testResults',[]) for a in f.get('assertionResults',[]) if a.get('status')=='failed'))
+")
+echo "[oneshot] vitest failed=$TOTAL_FAIL"
+
+if [ "$TOTAL_FAIL" = "0" ]; then
+  echo "[oneshot] ✅ 全部通过, 不需要修"
+  exit 0
+fi
+
+# 2. 抽 fail 信息
+FAIL_SUMMARY=$(python3 -c "
+import json
+d = json.load(open('/tmp/vt-out.json'))
+for f in d.get('testResults', []):
+    for a in f.get('assertionResults', []):
+        if a.get('status') == 'failed':
+            print('FILE:', f.get('name'))
+            print('TEST:', a.get('fullName') or a.get('title'))
+            print('ERROR:')
+            for m in a.get('failureMessages', [])[:2]:
+                print(m[:600])
+            print('---')
+" | head -60)
+echo "[oneshot] 2. 调 LLM 修..."
+
+# 3. 用 LLM 生成修复
+# prompt: 要 LLM 输出 ```diff ... ``` 块
+# 3. 写 prompt 到文件 (避免 shell 反引号冲突)
+PROMPT_FILE="/tmp/oneshot-prompt.txt"
+cat > "$PROMPT_FILE" <<PROMPT_EOF
+你是一个谨慎的代码修复助手. 你的工作是修复失败的测试.
+
+约束: 改动最小, 不改测试, 不引入 any/unknown/@ts-ignore.
+
+输出格式: 严格只输出一个 \`\`\`diff ... \`\`\` 块, 第一个字符 \`\`\`diff, 最后一个字符 \`\`\`. 中间是 unified diff (--- a/path +++ b/path 风格). 不要在 diff 块外输出任何文字.
+
+FAIL 信息:
+$(cat /tmp/vt-out.json | python3 -c "
+import json
+d = json.load(open('/tmp/vt-out.json'))
+for f in d.get('testResults', []):
+    for a in f.get('assertionResults', []):
+        if a.get('status') == 'failed':
+            print('FILE:', f.get('name'))
+            print('TEST:', a.get('fullName') or a.get('title'))
+            print('ERROR:')
+            for m in a.get('failureMessages', [])[:2]:
+                print(m[:600])
+            print('---')
+" | head -60)
+
+请**只**输出 diff 块:
+PROMPT_EOF
+
+LLM_OUTPUT=$(npx tsx -r dotenv/config -e "
+import { initMinimax } from './src/llm/pi-ai.js';
+import * as fs from 'fs';
+const prompt = fs.readFileSync('$PROMPT_FILE', 'utf-8');
+const client = initMinimax();
+const text = await client.generateText({ messages: [{ role: 'user', content: prompt }], maxTokens: 4096, temperature: 0.2 });
+process.stdout.write(text || '');
+" 2>/tmp/llm-err.log)
+
+if [ -z "$LLM_OUTPUT" ]; then
+  echo "[oneshot] ❌ LLM 没返回"
+  exit 2
+fi
+
+# 4. 解析 diff
+DIFF=$(echo "$LLM_OUTPUT" | python3 -c "
+import sys, re
+text = sys.stdin.read()
+m = re.search(r'\`\`\`diff\s*([\s\S]*?)\`\`\`', text)
+if m:
+    diff = m.group(1).strip()
+    if not diff.endswith('\n'):
+        diff += '\n'
+    print(diff)
+else:
+    sys.exit(1)
+" 2>/dev/null) || {
+  echo "[oneshot] ❌ LLM 输出没 diff 块"
+  echo "--- LLM 原始输出 (前 800) ---"
+  echo "$LLM_OUTPUT" | head -c 800
+  echo ""
+  exit 3
+}
+
+echo "[oneshot] 拿到 diff: $(echo "$DIFF" | wc -l) lines"
+
+# 5. 写 staging
+ID="oneshot-$(date +%s)"
+mkdir -p "staging/auto-evolve/$ID"
+echo "$DIFF" > "staging/auto-evolve/$ID/$ID.patch"
+echo "$ID" > "staging/auto-evolve/$ID/.patch-id"
+echo "[oneshot] patch 写到 staging/auto-evolve/$ID/"
+
+# 6. 跑 reviewer
+echo "[oneshot] 3. 跑 reviewer..."
+npx tsx -r dotenv/config scripts/diff-reviewer.ts "$ID" > /tmp/reviewer.log 2>&1 || true
+VERDICT=$(python3 -c "
+import json
+try:
+    print(json.load(open('staging/auto-evolve/$ID/.review-verdict')).get('verdict','UNKNOWN'))
+except:
+    print('UNKNOWN')
+")
+echo "[oneshot] reviewer verdict: $VERDICT"
+
+# 7. apply + commit
+if [ "$VERDICT" = "PASS" ]; then
+  echo "[oneshot] 4. apply + commit"
+  if git apply --recount --whitespace=fix "staging/auto-evolve/$ID/$ID.patch" 2>/tmp/apply.err; then
+    git add -A
+    git commit -m "auto-evolve: $ID (LLM 修复)"
+    echo "[oneshot] ✅ 提交成功"
+    # 验证
+    npx vitest run --reporter=json --no-color 2>/dev/null > /tmp/vt-after.json
+    AFTER_FAIL=$(python3 -c "
+import json
+print(sum(1 for f in json.load(open('/tmp/vt-after.json')).get('testResults',[]) for a in f.get('assertionResults',[]) if a.get('status')=='failed'))
+")
+    echo "[oneshot] 修复后 fail: $AFTER_FAIL (之前 $TOTAL_FAIL)"
+  else
+    echo "[oneshot] ❌ git apply 失败:"
+    cat /tmp/apply.err
+    exit 4
+  fi
+else
+  echo "[oneshot] ❌ reviewer verdict=$VERDICT, 不 apply"
+  cat /tmp/reviewer.log | head -10
+  exit 5
+fi

package/scripts/auto-evolve-snapshot.sh

@@ -0,0 +1,136 @@
+#!/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

@@ -0,0 +1,216 @@
+/**
+ * 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

@@ -0,0 +1,48 @@
+#!/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