@bolloon/bolloon-agent 0.1.34 → 0.1.36

package/dist/bootstrap/context-collector.js

@@ -0,0 +1,312 @@
+/**
+ * Bolloon Context Collector — 启动时一次扫描, 收集 5 类项目状态
+ *
+ * 设计原则:
+ * - 每个收集器独立, 失败静默 (返回 null/[] 而非抛错)
+ * - 整体 < 200ms (git log + 文件扫描)
+ * - 结果可缓存 24h (跟类 B 自适应一致)
+ *
+ * 收集维度:
+ * 1. 项目层: projectRoot, projectName, Bolloon.md 全文
+ * 2. git 层: branch, last 5 commits, uncommitted changes count
+ * 3. persona 层: ~/.bolloon/persona.json
+ * 4. judgments 层: 摘要 (total / active / superseded / top values)
+ * 5. skills 层: ~/.bolloon/skills/ + .bolloon/skills/
+ * 6. 环境层: OS / node / llm provider
+ * 7. pending 层: ~/.bolloon/goals/* + src/ 下的 TODO/FIXME
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+// ============================================================
+// 单个收集器: 全部独立, 失败静默
+// ============================================================
+async function safeReadFile(filePath, maxBytes) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (content.length > maxBytes) {
+            return content.substring(0, maxBytes) + '\n... (truncated)';
+        }
+        return content;
+    }
+    catch {
+        return null;
+    }
+}
+async function safeExecFile(cmd, args, cwd) {
+    try {
+        const { stdout } = await execFileAsync(cmd, args, { cwd, timeout: 5000 });
+        return stdout.trim();
+    }
+    catch {
+        return '';
+    }
+}
+async function collectProject(cwd, bolloonMdMaxBytes) {
+    let projectName = path.basename(cwd);
+    try {
+        const pkgRaw = await fs.readFile(path.join(cwd, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(pkgRaw);
+        if (typeof pkg.name === 'string')
+            projectName = pkg.name;
+    }
+    catch { /* ignore */ }
+    const bolloonMd = await safeReadFile(path.join(cwd, 'Bolloon.md'), bolloonMdMaxBytes);
+    return { projectName, bolloonMd };
+}
+async function collectHierarchy(cwd) {
+    // 动态 import 避免循环依赖
+    const { collectHierarchyLayers, mergeHierarchyLayers } = await import('./context-hierarchy.js');
+    try {
+        const layers = await collectHierarchyLayers({ cwd });
+        const merged = mergeHierarchyLayers(layers, { maxChars: DEFAULT_HIERARCHY_MERGED_MAX });
+        return { ...layers, merged };
+    }
+    catch (err) {
+        console.warn('[context-collector] collectHierarchy failed (silent):', err);
+        return { managed: null, user: null, project: null, local: null, merged: '' };
+    }
+}
+const DEFAULT_HIERARCHY_MERGED_MAX = 2000; // 4000 → 2000 (P-Action 4), 跟 context-hierarchy.ts DEFAULT_MERGE_MAX_CHARS 对齐
+async function collectGit(cwd, limit) {
+    const branchOut = await safeExecFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+    if (!branchOut)
+        return null;
+    const logOut = await safeExecFile('git', ['log', '--oneline', `-n`, String(limit)], cwd);
+    const statusOut = await safeExecFile('git', ['status', '--porcelain'], cwd);
+    return {
+        branch: branchOut,
+        lastCommits: logOut ? logOut.split('\n').filter(Boolean) : [],
+        uncommittedChanges: statusOut ? statusOut.split('\n').filter(Boolean).length : 0,
+    };
+}
+async function collectPersona() {
+    const home = process.env.HOME || os.homedir() || '/tmp';
+    const raw = await safeReadFile(path.join(home, '.bolloon', 'persona.json'), 5000);
+    if (!raw)
+        return null;
+    try {
+        const p = JSON.parse(raw);
+        return {
+            name: String(p.name || 'unknown'),
+            description: String(p.description || ''),
+            personality: String(p.personality || ''),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function collectJudgmentsSummary(topN) {
+    // 用动态 import 避免循环依赖
+    const { loadAllJudgments } = await import('../pi-ecosystem-judgment/human-value-store.js');
+    let all = [];
+    try {
+        all = await loadAllJudgments();
+    }
+    catch {
+        return { total: 0, active: 0, superseded: 0, rejected: 0, topValues: [] };
+    }
+    const byStatus = { active: 0, superseded: 0, rejected: 0 };
+    for (const j of all) {
+        const s = (j.status ?? 'active');
+        if (s in byStatus)
+            byStatus[s]++;
+    }
+    // 借用 getRelevantValues 算 top values (已经在 store 里)
+    let topValues = [];
+    try {
+        const { getRelevantValues } = await import('../pi-ecosystem-judgment/human-value-store.js');
+        const values = await getRelevantValues('安全 代码 质量 测试 文档 用户'); // 通用 query
+        topValues = values.slice(0, topN).map((v) => ({
+            category: v.category,
+            value: v.value,
+            weight: v.weight,
+        }));
+    }
+    catch { /* ignore */ }
+    return {
+        total: all.length,
+        active: byStatus.active,
+        superseded: byStatus.superseded,
+        rejected: byStatus.rejected,
+        topValues,
+    };
+}
+async function collectSkills() {
+    const home = process.env.HOME || os.homedir() || '/tmp';
+    const userSkillsDir = path.join(home, '.bolloon', 'skills');
+    const projectSkillsDir = path.join(process.cwd(), '.bolloon', 'skills');
+    const out = [];
+    const seen = new Set();
+    for (const dir of [userSkillsDir, projectSkillsDir]) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const e of entries) {
+                if (!e.isDirectory() || seen.has(e.name))
+                    continue;
+                seen.add(e.name);
+                // 尝试读 SKILL.md 第一行作为描述
+                let description = '';
+                try {
+                    const skillMd = await fs.readFile(path.join(dir, e.name, 'SKILL.md'), 'utf-8');
+                    // 抓第一段非空非 frontmatter
+                    const lines = skillMd.split('\n');
+                    let inFrontmatter = false;
+                    for (const line of lines) {
+                        if (line.trim() === '---') {
+                            inFrontmatter = !inFrontmatter;
+                            continue;
+                        }
+                        if (inFrontmatter)
+                            continue;
+                        if (line.trim() && !line.startsWith('#')) {
+                            description = line.trim().substring(0, 120);
+                            break;
+                        }
+                    }
+                }
+                catch { /* ignore */ }
+                out.push({ name: e.name, description });
+            }
+        }
+        catch { /* dir 不存在正常 */ }
+    }
+    return out;
+}
+function collectEnv() {
+    let llmProvider = 'unknown';
+    try {
+        const home = process.env.HOME || os.homedir() || '/tmp';
+        const cfg = require(path.join(home, '.bolloon', 'llm-config.json'));
+        if (cfg && typeof cfg === 'object' && 'provider' in cfg) {
+            llmProvider = String(cfg.provider);
+        }
+    }
+    catch { /* ignore */ }
+    return {
+        os: `${os.platform()} ${os.release()}`,
+        nodeVersion: process.version,
+        llmProvider,
+    };
+}
+async function collectPending(opts) {
+    const home = process.env.HOME || os.homedir() || '/tmp';
+    const goalsDir = path.join(home, '.bolloon', 'goals');
+    const goals = [];
+    try {
+        const entries = await fs.readdir(goalsDir, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isFile())
+                goals.push(e.name);
+        }
+    }
+    catch { /* dir 不存在 */ }
+    // 扫 TODO/FIXME (限制 20 条避免太长)
+    const todoScanDir = opts.todoScanDir ?? path.join(opts.cwd, 'src');
+    const todos = await scanTodos(todoScanDir, 20);
+    return { goals, todos };
+}
+async function scanTodos(dir, limit) {
+    const out = [];
+    try {
+        await walkDir(dir, async (filePath) => {
+            if (!/\.(ts|js|tsx|jsx)$/.test(filePath))
+                return;
+            // 跳过 dist / node_modules
+            if (filePath.includes('/node_modules/') || filePath.includes('/dist/'))
+                return;
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                const lines = content.split('\n');
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i];
+                    // 匹配 TODO / FIXME / XXX 注释
+                    const m = line.match(/(?:\/\/|\/\*|\*|<!--)\s*(TODO|FIXME|XXX|HACK)[:：]?\s*(.+)/);
+                    if (m) {
+                        out.push({
+                            file: path.relative(dir, filePath),
+                            line: i + 1,
+                            text: m[2].trim().substring(0, 80),
+                        });
+                        if (out.length >= limit)
+                            return;
+                    }
+                }
+            }
+            catch { /* ignore */ }
+        });
+    }
+    catch { /* dir 不存在 */ }
+    return out;
+}
+async function walkDir(dir, cb) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        const full = path.join(dir, e.name);
+        if (e.isDirectory()) {
+            if (e.name === 'node_modules' || e.name === 'dist' || e.name.startsWith('.'))
+                continue;
+            await walkDir(full, cb);
+        }
+        else if (e.isFile()) {
+            await cb(full);
+        }
+    }
+}
+// ============================================================
+// 主入口
+// ============================================================
+export async function collectBolloonContext(opts) {
+    const { cwd, bolloonMdMaxBytes = 2000, gitCommitLimit = 5, topValuesLimit = 10, } = opts;
+    // 并行收集 (除 judgments 因为要动态 import + 依赖其它)
+    const [project, git, persona, skills, env, pending, hierarchy] = await Promise.all([
+        collectProject(cwd, bolloonMdMaxBytes),
+        collectGit(cwd, gitCommitLimit),
+        collectPersona(),
+        collectSkills(),
+        Promise.resolve(collectEnv()),
+        collectPending(opts),
+        collectHierarchy(cwd),
+    ]);
+    // judgments 单独调 (内部 import)
+    const judgmentsSummary = await collectJudgmentsSummary(topValuesLimit);
+    return {
+        projectRoot: cwd,
+        projectName: project.projectName,
+        bolloonMd: project.bolloonMd,
+        hierarchy,
+        git,
+        persona,
+        judgmentsSummary,
+        skills,
+        env,
+        pending,
+        collectedAt: new Date().toISOString(),
+    };
+}
+// ============================================================
+// 24h 缓存 (跟类 B 一致)
+// ============================================================
+let cached = null;
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export async function getCachedBolloonContext(opts, force = false) {
+    if (!force && cached && cached.cwd === opts.cwd && Date.now() - cached.at < CACHE_TTL_MS) {
+        return cached.ctx;
+    }
+    const ctx = await collectBolloonContext(opts);
+    cached = { at: Date.now(), ctx, cwd: opts.cwd };
+    return ctx;
+}
+export function clearBolloonContextCache() {
+    cached = null;
+}

package/dist/bootstrap/context-hierarchy.js

@@ -0,0 +1,218 @@
+/**
+ * Context Hierarchy — 4 级 Bolloon.md 查找 + 合并优先级
+ *
+ * 设计: 严格对齐 Claude Code 论文 4 级层次
+ *   1. Managed  — /etc/bolloon/Bolloon.md        (企业 IT 部署, 系统级)
+ *   2. User     — ~/.bolloon/Bolloon.md          (用户级, 跨项目)
+ *   3. Project  — <cwd>/Bolloon.md 或 .claude/rules/*.md
+ *   4. Local    — <cwd>/CLAUDE.local.md         (个人覆盖, .gitignore)
+ *
+ * 注入约定 (论文):
+ * - 拼到 system prompt 顶部 (作为 user context, 概率性遵守)
+ * - 不混入 user 消息 (避免 prompt injection)
+ * - 截断时反向砍 local → project → user → managed (优先保 managed, 因为是 bolloon 自身约束)
+ *
+ * 兼容:
+ * - 同时识别 Bolloon.md 和 Bolloon.md (论文用前者, bolloon 历史用后者)
+ * - 文件名按优先级: Bolloon.md > Bolloon.md
+ *
+ * 失败静默: 任何 IO 错误 → 返回 null, 不阻塞主流程.
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+export const DEFAULT_PATHS = {
+    managed: '/etc/bolloon/Bolloon.md',
+    user: '', // 用 resolveUserPath 填
+    project: '', // 用 resolveProjectPaths 填
+    projectRulesDir: '',
+    local: '',
+};
+/**
+ * 单层字符上限 (P-Action 4 收紧, 阶段 0 把 4 级层次控制在 ≤ 2KB).
+ * 反向截断策略保证 managed 优先, 单层超限由 truncate() 截断.
+ */
+export const DEFAULT_MAX_CHARS = {
+    managed: 700, // 1500 → 700, 保 bolloon 自身约束
+    user: 500, // 1500 → 500, 跨项目偏好
+    project: 500, // 2500 → 500, 项目规则
+    local: 300, // 1500 → 300, 个人覆盖
+};
+// ============================================================
+// 路径解析
+// ============================================================
+export function resolveUserPath(home) {
+    const h = home ?? process.env.HOME ?? os.homedir() ?? '/tmp';
+    return path.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'),
+    };
+}
+// ============================================================
+// 单层读取 (优先 Bolloon.md, fallback Bolloon.md)
+// ============================================================
+/**
+ * 读 1 个文件路径, 失败/缺失返回 null.
+ * 字符上限由调用方截断 (这里只负责读全文).
+ */
+async function readRuleFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return content.length > 0 ? content : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 读 project 层: 优先 Bolloon.md, fallback Bolloon.md, 最后尝试 .claude/rules/*.md
+ */
+async function readProjectLayer(projectPath, projectRulesDir, maxChars) {
+    // 1. Bolloon.md
+    let content = await readRuleFile(projectPath);
+    if (content)
+        return truncate(content, maxChars);
+    // 2. Bolloon.md (向后兼容)
+    const bolloonMdPath = path.join(path.dirname(projectPath), 'Bolloon.md');
+    content = await readRuleFile(bolloonMdPath);
+    if (content)
+        return truncate(content, maxChars);
+    // 3. .claude/rules/*.md (合并所有)
+    try {
+        const entries = await fs.readdir(projectRulesDir, { withFileTypes: true });
+        const ruleFiles = entries
+            .filter((e) => e.isFile() && e.name.endsWith('.md'))
+            .map((e) => path.join(projectRulesDir, e.name))
+            .sort();
+        if (ruleFiles.length > 0) {
+            const parts = [];
+            let total = 0;
+            for (const f of ruleFiles) {
+                const c = await readRuleFile(f);
+                if (c) {
+                    parts.push(`### ${path.basename(f, '.md')}\n${c}`);
+                    total += c.length;
+                    if (total >= maxChars)
+                        break;
+                }
+            }
+            if (parts.length > 0)
+                return truncate(parts.join('\n\n'), maxChars);
+        }
+    }
+    catch { /* dir 不存在 */ }
+    return null;
+}
+/**
+ * 并行读 4 层, 任何一层失败 = null (不阻塞其他).
+ */
+export async function collectHierarchyLayers(opts) {
+    const limits = { ...DEFAULT_MAX_CHARS, ...(opts.limits?.maxChars ?? {}) };
+    const home = opts.home ?? process.env.HOME ?? os.homedir() ?? '/tmp';
+    const managedPath = opts.limits?.paths?.managed ?? DEFAULT_PATHS.managed;
+    const userPath = opts.limits?.paths?.user ?? resolveUserPath(home);
+    const projectPath = opts.limits?.paths?.project ?? path.join(opts.cwd, 'Bolloon.md');
+    const projectRulesDir = opts.limits?.paths?.projectRulesDir ?? path.join(opts.cwd, '.claude', 'rules');
+    const localPath = opts.limits?.paths?.local ?? path.join(opts.cwd, 'CLAUDE.local.md');
+    const [managed, user, project, local] = await Promise.all([
+        readRuleFile(managedPath).then((c) => c ? truncate(c, limits.managed) : null),
+        readRuleFile(userPath).then((c) => c ? truncate(c, limits.user) : null),
+        readProjectLayer(projectPath, projectRulesDir, limits.project),
+        readRuleFile(localPath).then((c) => c ? truncate(c, limits.local) : null),
+    ]);
+    return { managed, user, project, local };
+}
+/**
+ * 4 级合并总字符上限 (P-Action 4 收紧, ≤ 2KB ≈ 500 tokens).
+ * 反向截断 (local → project → user → managed) 保证 managed 不丢.
+ */
+export const DEFAULT_MERGE_MAX_CHARS = 2000;
+/**
+ * 按 4 级顺序 (managed → user → project → local) 拼接为 markdown 片段.
+ *
+ * 截断策略: 反向砍 (local → project → user → managed), 优先保 managed.
+ * - 总长 < maxChars: 不截断
+ * - 总长 ≥ maxChars: 按 (local, project, user) 顺序逐步砍到 firstParagraphs=1
+ * - 最后只保 managed (bolloon 自身约束不能丢)
+ */
+export function mergeHierarchyLayers(layers, opts = {}) {
+    const maxChars = opts.maxChars ?? DEFAULT_MERGE_MAX_CHARS;
+    const parts = [];
+    const labels = [
+        ['managed', '管理规则 (Managed)'],
+        ['user', '用户规则 (User)'],
+        ['project', '项目规则 (Project)'],
+        ['local', '本地规则 (Local)'],
+    ];
+    for (const [key, label] of labels) {
+        const content = layers[key];
+        if (content) {
+            parts.push(`## ${label}\n\n${content}`);
+        }
+    }
+    if (parts.length === 0)
+        return '';
+    let result = parts.join('\n\n---\n\n');
+    if (result.length <= maxChars)
+        return result;
+    // 超限: 反向砍 (local → project → user), 二级回退到 firstParagraphs=1
+    return truncateMerged(layers, maxChars);
+}
+function truncateMerged(layers, maxChars) {
+    const order = [
+        ['local', '本地规则 (Local)'],
+        ['project', '项目规则 (Project)'],
+        ['user', '用户规则 (User)'],
+        ['managed', '管理规则 (Managed)'],
+    ];
+    const capped = { ...layers };
+    // 反复压缩, 直到总长 ≤ maxChars
+    let depth = 0; // 0=原始, 1=firstParagraphs=1, 2=砍半
+    while (depth < 3) {
+        const parts = [];
+        for (const [key, label] of order) {
+            const c = capped[key];
+            if (!c)
+                continue;
+            let text = c;
+            if (depth === 1)
+                text = firstParagraphs(c, 1);
+            if (depth === 2)
+                text = firstParagraphs(c, 1, Math.floor(maxChars / 4));
+            parts.push(`## ${label}\n\n${text}`);
+        }
+        const joined = parts.reverse().join('\n\n---\n\n'); // 恢复 managed → user → project → local
+        if (joined.length <= maxChars)
+            return joined;
+        depth++;
+    }
+    // 最后保 managed 一行
+    return `## 管理规则 (Managed)\n\n${firstParagraphs(layers.managed ?? '(无)', 1, maxChars - 50)}`;
+}
+// ============================================================
+// 工具
+// ============================================================
+function truncate(s, maxChars) {
+    if (s.length <= maxChars)
+        return s;
+    return s.substring(0, maxChars) + '\n... (truncated)';
+}
+function firstParagraphs(text, count, maxLen) {
+    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;
+}
+// ============================================================
+// 测试钩子
+// ============================================================
+/** 重置模块级状态 (供测试). 当前无状态, 保留为占位. */
+export function _resetHierarchyForTest() {
+    // no-op (collect 是纯函数, 但保留 API 一致)
+}