@bolloon/bolloon-agent 0.1.40 → 0.1.42

package/dist/bollharness-integration/skill-adapter.js

@@ -88,6 +88,10 @@ function loadAllHarnessSkills() {
  * Base skill class for bollharness-compatible skills
  */
 export class BaseSkill {
+    static llm = null;
+    static setLlm(instance) {
+        BaseSkill.llm = instance;
+    }
     log(message, level = 'info') {
         const prefix = level === 'error' ? '❌' : level === 'warn' ? '⚠️' : 'ℹ️';
         console.log(`${prefix} [${this.name}] ${message}`);
@@ -95,6 +99,33 @@ export class BaseSkill {
     formatOutput(output) {
         return JSON.stringify(output, null, 2);
     }
+    async callLm(system, user) {
+        let llm = BaseSkill.llm;
+        if (!llm) {
+            try {
+                const { getMinimax } = await import('../llm/pi-ai.js');
+                const m = getMinimax();
+                if (m && typeof m.chat === 'function') {
+                    BaseSkill.setLlm(m);
+                    llm = m;
+                }
+            }
+            catch {
+                return this.formatOutput({ warning: 'LLM 未注入', name: this.name });
+            }
+        }
+        if (!llm) {
+            return this.formatOutput({ warning: 'LLM 未注入', name: this.name });
+        }
+        try {
+            const res = await llm.chat([{ role: 'user', content: user }], system);
+            return res.reply || '(空回复)';
+        }
+        catch (err) {
+            this.log(`LLM 调用失败: ${err.message}`, 'error');
+            return this.formatOutput({ error: `LLM 调用失败: ${err.message}` });
+        }
+    }
 }
 /**
  * Architecture Skill - Project architect for architecture decisions
@@ -103,58 +134,12 @@ export class ArchSkill extends BaseSkill {
     name = 'arch';
     description = 'Project architect. Responsible for architecture decisions, scheme comparison, and boundary freezing.';
     async execute(params) {
-        const task = params.task || params.description;
+        const task = (params.task || params.description || params.action || '');
         this.log('Analyzing architecture task');
-        // Extract essence
-        const essence = this.extractEssence(task);
-        // Find tensions
-        const tensions = this.identifyTensions(task);
-        // Compare alternatives
-        const alternatives = this.compareAlternatives(task);
-        // Identify boundaries to freeze
-        const boundaries = this.identifyBoundaries(task);
-        return this.formatOutput({
-            essence,
-            tensions,
-            alternatives,
-            boundaries,
-            recommendation: this.makeRecommendation(task, alternatives),
-        });
-    }
-    extractEssence(task) {
-        // Simplified essence extraction
-        return `The core challenge is: ${task}`;
-    }
-    identifyTensions(task) {
-        return [
-            'Simplicity vs Flexibility',
-            'Performance vs Maintainability',
-            'Coupling vs Cohesion',
-        ];
-    }
-    compareAlternatives(task) {
-        return [
-            {
-                name: 'Option A: Direct Implementation',
-                tradeoffs: ['Fast to implement', 'May not scale'],
-                recommendation: 'Suitable for MVP',
-            },
-            {
-                name: 'Option B: Abstraction Layer',
-                tradeoffs: ['More upfront work', 'Better for extension'],
-                recommendation: 'Suitable for long-term',
-            },
-        ];
-    }
-    identifyBoundaries(task) {
-        return [
-            'API contract boundaries',
-            'Data format boundaries',
-            'Capability boundaries',
-        ];
-    }
-    makeRecommendation(task, alternatives) {
-        return alternatives[1]?.recommendation || 'Consider abstraction layer for long-term maintainability';
+        if (!task) {
+            return this.formatOutput({ warning: '未提供任务', usage: '--harness-skill arch "你的架构任务"' });
+        }
+        return this.callLm('You are a senior software architect. Analyze the task and output structured JSON with fields: essence, tensions, alternatives, boundaries, recommendation.', `Architecture task: ${task}`);
     }
 }
 /**
@@ -221,18 +206,9 @@ export class LeadSkill extends BaseSkill {
             gate_pack: this.getGatePack(),
         });
     }
-    classifyChange(params) {
+    async classifyChange(params) {
         const description = params.description || '';
-        // Simplified classification
-        const isPolicy = description.includes('policy') || description.includes('boundary');
-        const isContract = description.includes('API') || description.includes('contract') || description.includes('schema');
-        const isImplementation = !isPolicy && !isContract;
-        return this.formatOutput({
-            classification: isPolicy ? 'policy' : isContract ? 'contract' : 'implementation',
-            description,
-            minimum_gate_path: isPolicy ? '0→8 (full)' : isContract ? '0→8 (full + consumers)' : '0→7 (fast track eligible)',
-            fast_track_eligible: isImplementation,
-        });
+        return this.callLm('You are a change classifier. Given a description, classify the change as policy, contract, or implementation. Output JSON: { classification, description, minimum_gate_path, fast_track_eligible }.', `Classify this change: ${description}`);
     }
 }
 /**
@@ -242,44 +218,12 @@ export class TaskArchSkill extends BaseSkill {
     name = 'task-arch';
     description = 'Task decomposition. Breaks down PLAN into parallelizable work packages (WP).';
     async execute(params) {
-        const plan = params.plan;
+        const plan = (params.plan || params.task || params.description || params.action || '');
         this.log('Decomposing plan into work packages');
-        // Extract work packages
-        const workPackages = this.extractWorkPackages(plan);
-        // Identify seams
-        const seams = this.identifySeams(workPackages);
-        // Identify integration points
-        const integration = this.identifyIntegration(workPackages);
-        return this.formatOutput({
-            work_packages: workPackages,
-            seams,
-            integration,
-            seam_owners: this.assignSeamOwners(seams),
-        });
-    }
-    extractWorkPackages(plan) {
-        // Simplified WP extraction
-        return [
-            { id: 'WP-1', description: 'Core implementation', files: ['src/agents/*.ts'] },
-            { id: 'WP-2', description: 'Network layer', files: ['src/network/*.ts'] },
-            { id: 'WP-3', description: 'Testing', files: ['src/test/*.ts'] },
-        ];
-    }
-    identifySeams(packages) {
-        return [
-            { from: 'WP-1', to: 'WP-2', interface: 'P2PNetwork interface' },
-            { from: 'WP-1', to: 'WP-3', interface: 'Test fixtures' },
-        ];
-    }
-    identifyIntegration(packages) {
-        return ['Integration test at WP-1/WP-2 boundary'];
-    }
-    assignSeamOwners(seams) {
-        const owners = {};
-        for (const seam of seams) {
-            owners[`${seam.from}/${seam.to}`] = 'integration-owner';
+        if (!plan) {
+            return this.formatOutput({ warning: '未提供 plan', usage: '--harness-skill task-arch "你的开发计划"' });
         }
-        return owners;
+        return this.callLm('You are a task decomposition specialist. Given a plan, break it down into work packages (WP) with seams and integration points. Output JSON: { work_packages, seams, integration }.', `Plan: ${plan}`);
     }
 }
 /**
@@ -398,35 +342,12 @@ export class CrystalLearnSkill extends BaseSkill {
     name = 'crystal-learn';
     description = 'Extracts failure patterns and maintains invariants.';
     async execute(params) {
-        const task = params.task;
-        this.log('Extracting failure patterns');
-        // Identify failure modes
-        const failures = this.identifyFailures(task);
-        // Extract patterns
-        const patterns = this.extractPatterns(failures);
-        // Generate invariants
-        const invariants = this.generateInvariants(patterns);
-        return this.formatOutput({
-            failure_modes: failures,
-            patterns,
-            invariants,
-        });
-    }
-    identifyFailures(task) {
-        return [
-            'Truth source split',
-            'Verification decay',
-            'Orphaned seams',
-        ];
-    }
-    extractPatterns(failures) {
-        return failures.map(f => ({
-            pattern: f,
-            prevention: `Implement guard to prevent ${f}`,
-        }));
-    }
-    generateInvariants(patterns) {
-        return patterns.map(p => `INV: ${p.pattern} must not occur`);
+        const task = (params.task || params.description || params.action || '');
+        this.log('Extracting failure patterns from: ' + (task || '(空)'));
+        if (!task) {
+            return this.formatOutput({ warning: '未提供任务', usage: '--harness-skill crystal-learn "你的任务描述"' });
+        }
+        return this.callLm('You are a failure pattern analyst. Extract failure modes, patterns, and invariants from the task description. Output structured JSON with failure_modes, patterns, invariants.', `Task: ${task}`);
     }
 }
 /**
@@ -482,6 +403,10 @@ export class SkillAdapter {
     getSkill(name) {
         return this.registry.get(name);
     }
+    injectLlm(llm) {
+        BaseSkill.setLlm(llm);
+        this.log('LLM 已注入到所有 BaseSkill');
+    }
     listSkills() {
         return this.registry.list();
     }

package/dist/bootstrap/context-hierarchy.js

@@ -43,13 +43,15 @@ export const DEFAULT_MAX_CHARS = {
 // ============================================================
 export function resolveUserPath(home) {
     const h = home ?? process.env.HOME ?? os.homedir() ?? '/tmp';
-    return path.join(h, '.bolloon', 'Bolloon.md');
+    // 用 path.posix.join — 这些是配置/注入路径,跨平台语义稳定, 便于测试断言 + 注入 system prompt
+    // (Windows 文件系统也接受 '/' 分隔符, 所以 fs.readFile 不受影响)
+    return path.posix.join(h, '.bolloon', 'Bolloon.md');
 }
 export function resolveProjectPaths(cwd) {
     return {
-        project: path.join(cwd, 'Bolloon.md'),
-        projectRulesDir: path.join(cwd, '.claude', 'rules'),
-        local: path.join(cwd, 'CLAUDE.local.md'),
+        project: path.posix.join(cwd, 'Bolloon.md'),
+        projectRulesDir: path.posix.join(cwd, '.claude', 'rules'),
+        local: path.posix.join(cwd, 'CLAUDE.local.md'),
     };
 }
 // ============================================================

package/dist/cli/interface.js

@@ -1,4 +1,5 @@
 import * as readline from 'readline';
+import { spawn } from 'child_process';
 import { documentReader } from '../documents/reader.js';
 import { getMinimax } from '../constraints/index.js';
 import { AgentProtocol } from '../agents/protocol.js';
@@ -63,6 +64,7 @@ export class CLIInterface {
         console.log('  send <peer>     - 向指定节点发送消息');
         console.log('  broadcast       - 广播任务到所有节点');
         console.log('  summary <text>  - 总结文本');
+        console.log('  chat <消息正文>  - 跨机聊天 (commits as messages, wrapper)');
         console.log('  help            - 显示帮助');
         console.log('  exit            - 退出\n');
     }
@@ -89,6 +91,9 @@ export class CLIInterface {
                     case 'summary':
                         await this.handleSummary(args.join(' '));
                         break;
+                    case 'chat':
+                        await this.handleChat(args.join(' '));
+                        break;
                     case 'help':
                         this.showHelp();
                         break;
@@ -172,6 +177,29 @@ export class CLIInterface {
         console.log(result.summary);
         console.log(`\n质量评分: ${(result.qualityScore * 10).toFixed(1)}/10`);
     }
+    handleChat(text) {
+        return new Promise((resolve) => {
+            if (!text) {
+                console.log('请提供聊天内容: chat <消息正文>');
+                resolve();
+                return;
+            }
+            // 委派给 bolloon --chat-send, spawn 子进程, 同步输出
+            const child = spawn('npx', ['tsx', 'src/index.ts', '--chat-send', text], {
+                cwd: process.cwd(),
+                stdio: 'inherit',
+            });
+            child.on('close', (code) => {
+                if (code !== 0)
+                    console.error(`chat 子进程退出码 ${code}`);
+                resolve();
+            });
+            child.on('error', (err) => {
+                console.error('chat 子进程启动失败:', err.message);
+                resolve();
+            });
+        });
+    }
     async shutdown() {
         console.log('\n正在关闭...');
         await p2pNetwork.shutdown();

package/dist/documents/reader.js

@@ -16,6 +16,20 @@ export class DocumentReader {
             case '.yaml':
             case '.yml':
             case '.json':
+            // M3.5 (2026-06-17): agent 自读源码需要 — 之前 .ts 不支持, LLM 拿到空内容
+            //   .ts/.tsx/.js/.jsx 都是纯文本, 直接 readFile
+            case '.ts':
+            case '.tsx':
+            case '.js':
+            case '.jsx':
+            case '.mjs':
+            case '.cjs':
+            case '.py':
+            case '.go':
+            case '.rs':
+            case '.java':
+            case '.sh':
+            case '.bash':
                 text = await fs.readFile(filePath, 'utf-8');
                 break;
             case '.pdf':

package/dist/git-transport/chat-render.js

@@ -0,0 +1,155 @@
+// src/git-transport/chat-render.ts
+// 解析 markdown 消息文件 + 去重 key + 列表/过滤, 纯函数, 不碰 git.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { CHAT_PROTOCOL_VERSION } from './chat-types.js';
+function tryRead(p) {
+    try {
+        return fs.readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+// 极简 frontmatter 解析: 不引 gray-matter 这种依赖
+// 约定: 文件首行是 "---", 之后是 YAML-like 块 (key: value), 直到下一个 "---"
+// 字段值只支持 string / number / 嵌套对象字面量; 对我们够用
+function parseFrontmatter(raw) {
+    if (!raw.startsWith('---'))
+        return { fm: null, body: raw };
+    const lines = raw.split(/\r?\n/);
+    let end = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            end = i;
+            break;
+        }
+    }
+    if (end === -1)
+        return { fm: null, body: raw };
+    const headerLines = lines.slice(1, end);
+    const body = lines.slice(end + 1).join('\n').replace(/^\n+/, '');
+    const fm = { v: CHAT_PROTOCOL_VERSION };
+    let i = 0;
+    while (i < headerLines.length) {
+        const line = headerLines[i];
+        if (!line.trim() || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const m = /^([A-Za-z_][\w]*)\s*:\s*(.*)$/.exec(line);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const key = m[1];
+        let val = m[2].trim();
+        if (val === '') {
+            // 嵌套对象 — 收集到下一个顶级 key 之前
+            const obj = {};
+            i++;
+            while (i < headerLines.length) {
+                const l2 = headerLines[i];
+                if (/^[A-Za-z_][\w]*\s*:/.test(l2))
+                    break;
+                const m2 = /^(\s+)([A-Za-z_][\w]*)\s*:\s*(.*)$/.exec(l2);
+                if (m2) {
+                    obj[m2[2]] = stripQuotes(m2[3].trim());
+                }
+                i++;
+            }
+            val = obj;
+        }
+        else {
+            val = stripQuotes(val);
+            // 数字字面量尽量 parse 成 number, 让 fm.v 严格比较能过
+            if (/^-?\d+(\.\d+)?$/.test(val)) {
+                const n = Number(val);
+                if (!Number.isNaN(n))
+                    val = n;
+            }
+            i++;
+        }
+        fm[key] = val;
+    }
+    // 强校验
+    if (typeof fm.from !== 'string' || typeof fm.fromPk !== 'string' || typeof fm.ts !== 'string') {
+        return { fm: null, body: raw };
+    }
+    if (fm.v !== CHAT_PROTOCOL_VERSION) {
+        return { fm: null, body: raw };
+    }
+    return { fm: fm, body };
+}
+function stripQuotes(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+export function parseMessageFile(filePath, sha) {
+    const raw = tryRead(filePath);
+    if (raw === null)
+        return null;
+    const { fm, body } = parseFrontmatter(raw);
+    if (!fm)
+        return null;
+    return { filePath, frontmatter: fm, body, sha };
+}
+// 列出 .comm/<role>/*.md 下所有消息文件 (角色目录是按字母扫的, 不依赖 git)
+export function listMessageFiles(repoDir) {
+    const comm = path.join(repoDir, '.comm');
+    let entries = [];
+    try {
+        entries = fs.readdirSync(comm, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        if (e.name.startsWith('_'))
+            continue; // _state / _inbox 跳过
+        const roleDir = path.join(comm, e.name);
+        let files = [];
+        try {
+            files = fs.readdirSync(roleDir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith('.md'))
+                continue;
+            out.push(path.join(roleDir, f));
+        }
+    }
+    return out;
+}
+export function listMessages(repoDir, withRole, limit) {
+    const files = listMessageFiles(repoDir);
+    const out = [];
+    for (const f of files) {
+        if (withRole && !f.includes(`${path.sep}.comm${path.sep}${withRole}${path.sep}`))
+            continue;
+        const msg = parseMessageFile(f, '');
+        if (msg)
+            out.push(msg);
+    }
+    out.sort((a, b) => a.frontmatter.ts.localeCompare(b.frontmatter.ts));
+    return typeof limit === 'number' ? out.slice(-limit) : out;
+}
+// 去重 key: (fromPk, ts, contentHash8) — 不论 P2P 还是 git 谁先到都收敛到同一键
+export function dedupeKey(msg) {
+    const h = crypto.createHash('sha256').update(msg.body).digest('hex').slice(0, 8);
+    return `${msg.frontmatter.fromPk}:${msg.frontmatter.ts}:${h}`;
+}
+// 单行展示 — 给 chat-list / chat-watch 输出用
+export function renderOneLine(msg) {
+    const time = msg.frontmatter.ts.replace('T', ' ').replace(/\.\d+Z$/, 'Z').replace('Z', '');
+    const preview = msg.body.split('\n')[0].slice(0, 80);
+    return `[${time} ${msg.frontmatter.from}] ${preview}`;
+}