@bolloon/bolloon-agent 0.1.35 → 0.1.37

package/dist/bollharness/src/scripts/guard-feedback.js

@@ -1,192 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-import { match, loadFragment, FALLBACK_FRAGMENTS } from "./context_router";
-import { readAllSignals, runGuards, writeSessionSignal } from "./guard_router";
-const INJECTED_TTL = 3600;
-const INJECTED_FILE = path.join(process.cwd(), ".boll", "guard", "injected.json");
-const METRICS_DIR = path.join(process.cwd(), ".boll", "metrics");
-const METRICS_FILE = path.join(METRICS_DIR, "guard-events.jsonl");
-function emitMetric(event, data = {}) {
-    try {
-        if (!fs.existsSync(METRICS_DIR)) {
-            fs.mkdirSync(METRICS_DIR, { recursive: true });
-        }
-        const record = {
-            ts: new Date().toISOString(),
-            session_pid: process.ppid,
-            event,
-            ...data,
-        };
-        fs.appendFileSync(METRICS_FILE, JSON.stringify(record) + "\n", "utf-8");
-    }
-    catch { }
-}
-function readInjected() {
-    if (!fs.existsSync(INJECTED_FILE))
-        return new Set();
-    try {
-        const data = JSON.parse(fs.readFileSync(INJECTED_FILE, "utf-8"));
-        if (Date.now() / 1000 - data.timestamp > INJECTED_TTL)
-            return new Set();
-        return new Set(data.fragments || []);
-    }
-    catch {
-        return new Set();
-    }
-}
-function writeInjected(fragments) {
-    const guardDir = path.join(process.cwd(), ".boll", "guard");
-    if (!fs.existsSync(guardDir)) {
-        fs.mkdirSync(guardDir, { recursive: true });
-    }
-    const data = { timestamp: Date.now() / 1000, fragments: Array.from(fragments).sort() };
-    fs.writeFileSync(INJECTED_FILE, JSON.stringify(data, null, 2), "utf-8");
-}
-function getFilePath() {
-    if (process.argv.includes("--dry-run")) {
-        const idx = process.argv.indexOf("--dry-run");
-        if (idx + 1 < process.argv.length) {
-            return process.argv[idx + 1];
-        }
-        return null;
-    }
-    try {
-        const input = JSON.parse(fs.readFileSync(0, "utf-8"));
-        return input.tool_input?.file_path ?? input.tool_input?.path ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function makeRelative(filePath, repoRoot) {
-    try {
-        const resolved = path.resolve(filePath);
-        return path.relative(repoRoot, resolved);
-    }
-    catch {
-        return null;
-    }
-}
-function appendFindings(outputParts, findings) {
-    outputParts.push("\n\n## Guard Findings\n");
-    for (const raw of findings) {
-        const f = raw;
-        const blockingTag = f.blocking ? " [blocking]" : "";
-        const skills = f.required_skills.join(", ");
-        const skillsLine = skills ? `\n  required_skills: ${skills}` : "";
-        outputParts.push(`- ${f.severity}${blockingTag} ${f.category}: ${f.message}${skillsLine}`);
-    }
-}
-const REPO_ROOT = process.cwd();
-const checksDir = path.join(REPO_ROOT, "src", "scripts", "checks");
-export async function main() {
-    const startMs = Date.now();
-    const checkOnly = process.argv.includes("--check-only");
-    const once = process.argv.includes("--once");
-    const dryRun = process.argv.includes("--dry-run");
-    emitMetric("hook_trigger", {
-        mode: checkOnly ? "check_only" : "post_tool_use",
-        once,
-        dry_run: dryRun,
-    });
-    if (once) {
-        const guardDir = path.join(process.cwd(), ".boll", "guard");
-        const sessionFile = path.join(guardDir, `once-${process.pid}.flag`);
-        if (fs.existsSync(sessionFile)) {
-            try {
-                const ts = parseFloat(fs.readFileSync(sessionFile, "utf-8").trim());
-                if (Date.now() / 1000 - ts < 3600) {
-                    process.exit(0);
-                }
-            }
-            catch { }
-        }
-        if (!fs.existsSync(guardDir)) {
-            fs.mkdirSync(guardDir, { recursive: true });
-        }
-        fs.writeFileSync(sessionFile, String(Date.now() / 1000), "utf-8");
-    }
-    const outputParts = [];
-    if (checkOnly) {
-        const signal = readAllSignals(process.pid);
-        const findings = signal.findings;
-        if (findings.length) {
-            appendFindings(outputParts, findings);
-            process.stderr.write(outputParts.join("\n") + "\n");
-            emitMetric("check_only_findings", {
-                findings_count: findings.length,
-                elapsed_ms: Date.now() - startMs,
-            });
-            process.exit(0);
-        }
-        process.exit(0);
-    }
-    let filePath = getFilePath();
-    if (!filePath)
-        process.exit(0);
-    filePath = makeRelative(filePath, REPO_ROOT);
-    if (!filePath) {
-        emitMetric("path_rejected", { reason: "outside_repo_or_unresolvable" });
-        process.exit(0);
-    }
-    const alreadyInjected = readInjected();
-    let fragments = match(filePath);
-    if (!fragments.length) {
-        fragments = Array.isArray(FALLBACK_FRAGMENTS) ? FALLBACK_FRAGMENTS : [FALLBACK_FRAGMENTS];
-    }
-    const newFragments = fragments.filter(f => !alreadyInjected.has(f));
-    const contentParts = [];
-    for (const name of newFragments) {
-        const text = loadFragment(name);
-        if (text)
-            contentParts.push(text);
-    }
-    if (newFragments.length) {
-        const totalBytes = contentParts.reduce((sum, p) => sum + Buffer.byteLength(p, "utf-8"), 0);
-        emitMetric("fragment_inject", {
-            file_path: filePath,
-            fragments: newFragments,
-            count: newFragments.length,
-            bytes: totalBytes,
-            est_tokens: Math.ceil(totalBytes / 4),
-        });
-    }
-    if (contentParts.length) {
-        outputParts.push("## Context\n");
-        outputParts.push(contentParts.join("\n\n---\n\n"));
-        newFragments.forEach(f => alreadyInjected.add(f));
-        writeInjected(alreadyInjected);
-    }
-    const findings = await runGuards(filePath, checksDir);
-    if (findings.length) {
-        const blockingCount = findings.filter(f => f.blocking).length;
-        const categories = {};
-        const severities = {};
-        for (const f of findings) {
-            categories[f.category] = (categories[f.category] || 0) + 1;
-            severities[f.severity] = (severities[f.severity] || 0) + 1;
-        }
-        emitMetric("guard_findings", {
-            file_path: filePath,
-            findings_count: findings.length,
-            blocking_count: blockingCount,
-            categories,
-            severities,
-        });
-        writeSessionSignal(findings);
-        appendFindings(outputParts, findings);
-    }
-    emitMetric("hook_done", {
-        file_path: filePath,
-        had_output: outputParts.length > 0,
-        elapsed_ms: Date.now() - startMs,
-    });
-    if (outputParts.length) {
-        process.stderr.write(outputParts.join("\n") + "\n");
-        process.exit(2);
-    }
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/guard_router.js

@@ -1,158 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-export const GUARD_MAP = {
-    "bridge_agent/": ["check_bridge_deps"],
-    "backend/product/bridge/": ["check_bridge_deps"],
-    "mcp-server/": ["check_mcp_parity"],
-    "mcp-server-node/": ["check_mcp_parity"],
-    "docs/issues/": ["check_issue_closure"],
-    "backend/product/routes/": ["check_doc_freshness"],
-    "docs/ROADMAP.md": ["check_doc_freshness"],
-    "CLAUDE.md": ["check_doc_freshness"],
-    "docs/magic/": ["check_doc_freshness"],
-    ".boll/rules/backend-routes.md": ["check_doc_freshness"],
-    ".boll/settings.json": ["check_hook_installed"],
-    ".githooks/": ["check_hook_installed"],
-    "scripts/context_router.ts": ["check_fragment_integrity"],
-    "scripts/context-fragments/": ["check_fragment_integrity"],
-};
-export const DEFAULT_GUARDS = [];
-export const CATEGORY_TO_SKILLS = {
-    closure_semantics: ["lead", "boll-ops"],
-    contract_drift: ["boll-dev", "boll-eng-test"],
-    bridge_boundary: ["boll-bridge", "boll-ops"],
-    policy_freeze: ["lead", "arch", "plan-lock"],
-    doc_integrity: ["boll-ops"],
-    version_drift: ["boll-ops"],
-    artifact_linkage: ["lead"],
-    governance_bootstrap: ["boll-ops"],
-};
-const SESSION_TTL_SECONDS = 3600;
-export function route(filePath) {
-    const matched = [];
-    const sortedPatterns = Object.keys(GUARD_MAP).sort((a, b) => b.length - a.length);
-    for (const pattern of sortedPatterns) {
-        if (filePath.startsWith(pattern) || filePath === pattern.replace(/\/$/, "")) {
-            matched.push(...GUARD_MAP[pattern]);
-        }
-    }
-    if (matched.length === 0) {
-        return [...DEFAULT_GUARDS];
-    }
-    return [...new Set(matched)];
-}
-export async function runGuards(filePath, checksDir) {
-    const guardNames = route(filePath);
-    const findings = [];
-    for (const name of guardNames) {
-        try {
-            const checkModule = await import(path.join(checksDir, `${name}.js`));
-            if (!checkModule.run) {
-                findings.push({
-                    severity: "P1",
-                    message: `${name} has no run() function`,
-                    file: `scripts/checks/${name}.ts`,
-                    blocking: false,
-                    category: "governance_bootstrap",
-                    problem_class: "unknown",
-                    required_skills: [],
-                    required_reads: [],
-                });
-                continue;
-            }
-            const result = checkModule.run(checksDir, { mode: "full" });
-            if (Array.isArray(result)) {
-                findings.push(...result);
-            }
-            else {
-                findings.push(result);
-            }
-        }
-        catch (exc) {
-            findings.push({
-                severity: "P0",
-                message: `Failed to import guard ${name}: ${exc}`,
-                file: `scripts/checks/${name}.ts`,
-                blocking: true,
-                category: "governance_bootstrap",
-                problem_class: "unknown",
-                required_skills: [],
-                required_reads: [],
-            });
-        }
-    }
-    return findings;
-}
-function getGuardDir() {
-    return path.join(process.cwd(), ".boll", "guard");
-}
-export function writeSessionSignal(findings) {
-    const guardDir = getGuardDir();
-    if (!fs.existsSync(guardDir)) {
-        fs.mkdirSync(guardDir, { recursive: true });
-    }
-    const pid = process.pid;
-    const target = path.join(guardDir, `session-${pid}.json`);
-    const tmp = path.join(guardDir, `session-${pid}.tmp`);
-    const data = {
-        pid,
-        timestamp: Date.now() / 1000,
-        findings,
-    };
-    fs.writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
-    fs.renameSync(tmp, target);
-    return target;
-}
-export function readAllSignals(pid) {
-    const guardDir = getGuardDir();
-    if (!fs.existsSync(guardDir)) {
-        return { severity: null, blocking: false, required_skills: [], findings: [] };
-    }
-    const severityOrder = { P0: 0, P1: 1, P2: 2 };
-    const now = Date.now() / 1000;
-    const allFindings = [];
-    let maxSeverity = null;
-    let blocking = false;
-    const skills = new Set();
-    let paths;
-    if (pid !== undefined) {
-        paths = [path.join(guardDir, `session-${pid}.json`)];
-    }
-    else {
-        paths = fs.readdirSync(guardDir)
-            .filter(f => f.startsWith("session-") && f.endsWith(".json"))
-            .map(f => path.join(guardDir, f));
-    }
-    for (const p of paths) {
-        if (!fs.existsSync(p))
-            continue;
-        try {
-            const data = JSON.parse(fs.readFileSync(p, "utf-8"));
-            const ts = data.timestamp;
-            if (now - ts > SESSION_TTL_SECONDS) {
-                try {
-                    fs.unlinkSync(p);
-                }
-                catch { }
-                continue;
-            }
-            for (const f of data.findings) {
-                allFindings.push(f);
-                const sev = f.severity;
-                if (maxSeverity === null || severityOrder[sev] < severityOrder[maxSeverity]) {
-                    maxSeverity = sev;
-                }
-                if (f.blocking)
-                    blocking = true;
-                f.required_skills.forEach(s => skills.add(s));
-            }
-        }
-        catch { }
-    }
-    return {
-        severity: maxSeverity,
-        blocking,
-        required_skills: Array.from(skills).sort(),
-        findings: allFindings,
-    };
-}

package/dist/bollharness/src/scripts/hooks/_hook_output.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-process.stdout.write(`\n\n## Bollharness Context\n\n` +
-    `bollharness is an AI Agent Session Governance Framework.\n\n` +
-    `For more information, see CLAUDE.md in the project root.\n`);
-process.exit(0);
-export {};

package/dist/bollharness/src/scripts/hooks/auto-python3.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/deploy-progress-on-session-end.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/failure-analyzer.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/gate-judgment-inject.js

@@ -1,92 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-const REPO_ROOT = process.cwd();
-function getCurrentGate() {
-    const envGate = process.env.BOLL_GATE_TO;
-    if (envGate) {
-        return parseInt(envGate, 10);
-    }
-    try {
-        const gateFile = path.join(REPO_ROOT, ".boll", "gate", "current");
-        if (fs.existsSync(gateFile)) {
-            const content = fs.readFileSync(gateFile, "utf-8").trim();
-            const state = JSON.parse(content);
-            return state.current_gate;
-        }
-    }
-    catch { }
-    const envGateFinal = process.env.BOLL_GATE;
-    if (envGateFinal) {
-        return parseInt(envGateFinal, 10);
-    }
-    return 0;
-}
-async function getCoreJudgments() {
-    try {
-        const judgmentPath = path.join(REPO_ROOT, "src", "bollharness-integration", "context-router-judgment.js");
-        if (!fs.existsSync(judgmentPath)) {
-            return "";
-        }
-        const { getCoreJudgmentsForSession } = await import(judgmentPath);
-        return await getCoreJudgmentsForSession(0.9);
-    }
-    catch (e) {
-        console.error("[Gate Judgment] Failed to load core judgments:", e);
-        return "";
-    }
-}
-async function getGateJudgments(gate) {
-    try {
-        const judgmentPath = path.join(REPO_ROOT, "src", "bollharness-integration", "context-router-judgment.js");
-        if (!fs.existsSync(judgmentPath)) {
-            return "";
-        }
-        const { generateJudgmentInjection } = await import(judgmentPath);
-        return await generateJudgmentInjection(".", gate);
-    }
-    catch (e) {
-        console.error("[Gate Judgment] Failed to load gate judgments:", e);
-        return "";
-    }
-}
-async function getContextChainInjection(gate) {
-    try {
-        const chainPath = path.join(REPO_ROOT, "src", "bollharness-integration", "context-chain-router.js");
-        if (!fs.existsSync(chainPath)) {
-            return "";
-        }
-        const { generateContextChainInjection } = await import(chainPath);
-        return await generateContextChainInjection(gate);
-    }
-    catch (e) {
-        console.error("[Gate Judgment] Failed to load context chains:", e);
-        return "";
-    }
-}
-export async function main() {
-    const gate = getCurrentGate();
-    const INJECT_GATES = [0, 3];
-    if (!INJECT_GATES.includes(gate)) {
-        process.exit(0);
-    }
-    const judgments = gate === 0
-        ? await getCoreJudgments()
-        : await getGateJudgments(gate);
-    const chains = await getContextChainInjection(gate);
-    if (judgments || chains) {
-        process.stdout.write("\n");
-        if (judgments) {
-            process.stdout.write(judgments + "\n\n");
-        }
-        if (chains) {
-            process.stdout.write(chains + "\n");
-        }
-    }
-    process.exit(0);
-}
-if (require.main === module) {
-    main().catch((e) => {
-        console.error("[Gate Judgment] Error:", e);
-        process.exit(1);
-    });
-}

package/dist/bollharness/src/scripts/hooks/gate-transition-judgment.js

@@ -1,63 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-const REPO_ROOT = process.cwd();
-async function getGateJudgments(gate, filePath = ".") {
-    try {
-        const judgmentPath = path.join(REPO_ROOT, "src", "bollharness-integration", "context-router-judgment.js");
-        if (!fs.existsSync(judgmentPath)) {
-            return "";
-        }
-        const { generateJudgmentInjection } = await import(judgmentPath);
-        return await generateJudgmentInjection(filePath, gate);
-    }
-    catch (e) {
-        console.error("[Gate Transition Judgment] Failed to load judgments:", e);
-        return "";
-    }
-}
-async function getContextChainInjection(gate) {
-    try {
-        const chainPath = path.join(REPO_ROOT, "src", "bollharness-integration", "context-chain-router.js");
-        if (!fs.existsSync(chainPath)) {
-            return "";
-        }
-        const { generateContextChainInjection } = await import(chainPath);
-        return await generateContextChainInjection(gate);
-    }
-    catch (e) {
-        console.error("[Gate Transition Judgment] Failed to load context chains:", e);
-        return "";
-    }
-}
-export async function main() {
-    const args = process.argv.slice(2);
-    const envGate = process.env.BOLL_GATE_TO;
-    const gate = args[0]
-        ? parseInt(args[0], 10)
-        : envGate
-            ? parseInt(envGate, 10)
-            : 0;
-    const filePath = args[1] || ".";
-    const INJECT_GATES = [0, 3];
-    if (!INJECT_GATES.includes(gate)) {
-        process.exit(0);
-    }
-    const judgments = await getGateJudgments(gate, filePath);
-    const chains = await getContextChainInjection(gate);
-    if (judgments || chains) {
-        process.stdout.write("\n");
-        if (judgments) {
-            process.stdout.write(judgments + "\n\n");
-        }
-        if (chains) {
-            process.stdout.write(chains + "\n");
-        }
-    }
-    process.exit(0);
-}
-if (require.main === module) {
-    main().catch((e) => {
-        console.error("[Gate Transition Judgment] Error:", e);
-        process.exit(1);
-    });
-}

package/dist/bollharness/src/scripts/hooks/inbox-ack.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/inbox-inject-on-start.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/inbox-validate.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/inbox-write-ledger.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/initializer-agent.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/loop-detection.js

@@ -1,73 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-const LOOP_THRESHOLD = 5;
-const STATE_DIR = ".boll/guard";
-const STATE_FILE_PREFIX = "loop-";
-const TTL_SECONDS = 3600;
-function getStateFile() {
-    const pid = process.ppid;
-    return path.join(STATE_DIR, `${STATE_FILE_PREFIX}${pid}.json`);
-}
-function loadState() {
-    const stateFile = getStateFile();
-    if (!fs.existsSync(stateFile))
-        return {};
-    try {
-        const data = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
-        if (Date.now() / 1000 - data._ts > TTL_SECONDS) {
-            return {};
-        }
-        return data;
-    }
-    catch (exc) {
-        process.stderr.write(`[loop-detection] corrupt state ${stateFile}: ${exc}; resetting\n`);
-        try {
-            fs.unlinkSync(stateFile);
-        }
-        catch { }
-        return {};
-    }
-}
-function saveState(state) {
-    try {
-        if (!fs.existsSync(STATE_DIR)) {
-            fs.mkdirSync(STATE_DIR, { recursive: true });
-        }
-        state._ts = Date.now() / 1000;
-        fs.writeFileSync(getStateFile(), JSON.stringify(state), "utf-8");
-    }
-    catch (exc) {
-        process.stderr.write(`[loop-detection] save_state OSError: ${exc}; counter not persisted\n`);
-    }
-}
-export function postToolUseInject(message) {
-    process.stdout.write(`\n\n## Loop Detection\n\n${message}\n`);
-}
-export function main() {
-    let event;
-    try {
-        event = JSON.parse(fs.readFileSync(0, "utf-8") || "{}");
-    }
-    catch {
-        return;
-    }
-    const toolName = event.tool_name || "";
-    const toolInput = event.tool_input || {};
-    if (!["Write", "Edit"].includes(toolName))
-        return;
-    const filePath = toolInput.file_path || "";
-    if (!filePath)
-        return;
-    const state = loadState();
-    const counts = state.counts || {};
-    counts[filePath] = (counts[filePath] || 0) + 1;
-    state.counts = counts;
-    saveState(state);
-    const count = counts[filePath];
-    if (count >= LOOP_THRESHOLD) {
-        postToolUseInject(`[LoopDetection] 你已经编辑 ${filePath} ${count} 次了。考虑换一个方法或退一步重新思考整体方案。[来源: LangChain LoopDetection middleware]`);
-    }
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/owner-guard.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/precompact.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}

package/dist/bollharness/src/scripts/hooks/review-agent-gatekeeper.js

@@ -1,6 +0,0 @@
-export function main() {
-    process.exit(0);
-}
-if (require.main === module) {
-    main();
-}