@bolloon/bolloon-agent 0.1.0

package/dist/agents/workflow-engine.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * WorkflowEngine - Execution layer for document processing workflows
+ * Part of OpenClaw dual-layer architecture (Constraint Layer + Execution Layer)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowEngine = void 0;
+const reader_js_1 = require("../documents/reader.js");
+const index_js_1 = require("../constraints/index.js");
+const p2p_js_1 = require("../network/p2p.js");
+const constraint_layer_js_1 = require("./constraint-layer.js");
+/**
+ * WorkflowEngine executes document processing workflows with retry logic and guardrails
+ * Implements the execution layer of the OpenClaw dual-layer architecture
+ */
+class WorkflowEngine {
+    constraintLayer;
+    constructor(constraintLayer) {
+        this.constraintLayer = constraintLayer || new constraint_layer_js_1.ConstraintLayer();
+    }
+    /**
+     * Execute a complete workflow with all steps
+     */
+    async executeWorkflow(steps, initialContext) {
+        const workflow = {
+            id: `wf-${Date.now()}`,
+            steps,
+            status: 'running',
+            results: new Map()
+        };
+        const context = {
+            peers: p2p_js_1.p2pNetwork.getPeers(),
+            logs: [],
+            ...initialContext
+        };
+        for (const step of steps) {
+            const result = await this.executeStep(step, context);
+            workflow.results.set(step.id, result);
+            // Handle blocked or critical failures
+            if (result.status === 'blocked') {
+                this.constraintLayer.log(`Workflow blocked at step ${step.id}`, { guardrailFailed: result.guardrailFailed }, 'blocked');
+                workflow.status = 'failed';
+                return workflow;
+            }
+            if (result.status === 'failed' && step.onFail === 'abort') {
+                workflow.status = 'failed';
+                return workflow;
+            }
+        }
+        workflow.status = 'completed';
+        return workflow;
+    }
+    /**
+     * Execute a single workflow step with retry logic
+     */
+    async executeStep(step, context) {
+        // Pre-execution guardrail check
+        if (step.guardrail) {
+            const guardrailPassed = await this.runGuardrail(step, context, true);
+            if (!guardrailPassed) {
+                this.constraintLayer.log(`Pre-check guardrail failed: ${step.guardrail.name}`, { stepId: step.id }, 'blocked');
+                return { status: 'blocked', guardrailFailed: step.guardrail.name };
+            }
+        }
+        // Execute step with retry logic
+        for (let attempt = 0; attempt <= step.retry.max; attempt++) {
+            try {
+                const result = await this.runStep(step, context);
+                // Post-execution guardrail check (unless explicitly disabled for retries)
+                if (step.guardrailOnRetry !== false && step.guardrail) {
+                    const guardrailPassed = await this.runGuardrail(step, context, false);
+                    if (!guardrailPassed) {
+                        this.constraintLayer.log(`Post-check guardrail failed: ${step.guardrail.name}`, { stepId: step.id }, 'blocked');
+                        return { status: 'blocked', guardrailFailed: step.guardrail.name };
+                    }
+                }
+                return { status: 'success', result };
+            }
+            catch (error) {
+                if (attempt === step.retry.max) {
+                    this.constraintLayer.log(`Step ${step.id} failed after ${attempt + 1} attempts`, { error: String(error) }, 'failed');
+                    return {
+                        status: step.onFail === 'skip' ? 'skipped' : 'failed',
+                        error: String(error)
+                    };
+                }
+                // Exponential backoff
+                const backoffMs = step.retry.backoffMs * Math.pow(2, attempt);
+                this.constraintLayer.log(`Step ${step.id} attempt ${attempt + 1} failed, retrying in ${backoffMs}ms`, {}, 'warn');
+                await this.sleep(backoffMs);
+            }
+        }
+        return { status: 'failed', error: 'Max retries exceeded' };
+    }
+    /**
+     * Run the actual step logic
+     */
+    async runStep(step, context) {
+        switch (step.type) {
+            case 'read': {
+                const path = step.config?.path;
+                if (!path)
+                    throw new Error('Read step requires path config');
+                const content = await reader_js_1.documentReader.read(path);
+                context.document = content;
+                return content;
+            }
+            case 'chunk': {
+                if (!context.document)
+                    throw new Error('No document loaded');
+                const maxSize = step.config?.maxChunkSize || 4000;
+                return reader_js_1.documentReader.chunk(context.document.text, maxSize);
+            }
+            case 'summarize': {
+                if (!context.document)
+                    throw new Error('No document loaded');
+                if (!this.isMinimaxAvailable()) {
+                    throw new Error('Minimax LLM not available');
+                }
+                const llm = (0, index_js_1.getMinimax)();
+                const chunks = reader_js_1.documentReader.chunk(context.document.text, step.config?.maxChunkSize || 4000);
+                const summaries = [];
+                let totalQuality = 0;
+                for (const chunk of chunks) {
+                    const result = await llm.summarize(chunk, step.config?.context);
+                    summaries.push(result.summary);
+                    totalQuality += result.qualityScore;
+                }
+                context.summary = summaries.join('\n\n');
+                context.qualityScore = totalQuality / chunks.length;
+                return { summary: context.summary, qualityScore: context.qualityScore };
+            }
+            case 'improve': {
+                if (!context.document)
+                    throw new Error('No document loaded');
+                if (!this.isMinimaxAvailable()) {
+                    throw new Error('Minimax LLM not available');
+                }
+                const llm = (0, index_js_1.getMinimax)();
+                const improved = await llm.improveContent(context.document.text, step.config?.requirements || '', step.config?.context);
+                context.improved = improved;
+                return { improved };
+            }
+            case 'review': {
+                return {
+                    status: 'reviewed',
+                    qualityScore: context.qualityScore,
+                    hasDocument: !!context.document,
+                    hasSummary: !!context.summary
+                };
+            }
+            case 'send': {
+                const peerId = step.config?.peerId;
+                const message = step.config?.message || context.summary || '';
+                if (!peerId)
+                    throw new Error('Send step requires peerId config');
+                // Check constraint layer for unknown peer
+                const checkResult = await this.constraintLayer.checkGuardrails(context, step);
+                if (!checkResult.passed) {
+                    throw new Error(`Guardrail blocked: ${checkResult.blocked?.name}`);
+                }
+                await p2p_js_1.p2pNetwork.sendMessage(peerId, 'message', message);
+                this.constraintLayer.log(`Sent message to ${peerId}`, { peerId, messageLength: message.length }, 'success');
+                return { sent: true, peerId };
+            }
+            case 'report': {
+                const content = step.config?.content || context.summary || '';
+                await p2p_js_1.p2pNetwork.broadcast('report', content);
+                this.constraintLayer.log('Broadcast report', { contentLength: content.length }, 'success');
+                return { broadcasted: true };
+            }
+            default:
+                throw new Error(`Unknown step type: ${step.type}`);
+        }
+    }
+    /**
+     * Run a guardrail check with error handling
+     */
+    async runGuardrail(step, context, isPreCheck) {
+        if (!step.guardrail)
+            return true;
+        try {
+            return await step.guardrail(context);
+        }
+        catch (error) {
+            this.constraintLayer.log(`Guardrail ${step.guardrail.name} error`, { error: String(error), isPreCheck }, 'failed');
+            return false;
+        }
+    }
+    /**
+     * Check if Minimax LLM is available
+     */
+    isMinimaxAvailable() {
+        try {
+            (0, index_js_1.getMinimax)();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Sleep utility for retry backoff
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get the constraint layer instance
+     */
+    getConstraintLayer() {
+        return this.constraintLayer;
+    }
+    /**
+     * Set a custom constraint layer
+     */
+    setConstraintLayer(layer) {
+        this.constraintLayer = layer;
+    }
+}
+exports.WorkflowEngine = WorkflowEngine;
+//# sourceMappingURL=workflow-engine.js.map

package/dist/agents/workflow-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-engine.js","sourceRoot":"","sources":["../../src/agents/workflow-engine.ts"],"names":[],"mappings":"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"}

package/dist/bollharness-integration/bollharness-integration/context-router-judgment.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Judgment-Aware Context Router
+ *
+ * Extends ContextRouter with judgment lookup and injection capabilities.
+ *
+ * Architecture:
+ * - Path → Fragment Names → Associated Judgments
+ * - Confidence-based filtering
+ * - YAML format for user-language injection
+ *
+ * Integration with existing Bollharness:
+ * - Uses existing ContextRouter.match() for fragment lookup
+ * - Extends with judgment lookup based on fragment context
+ * - Injects at Gate 0, Gate 3, and file-edit time
+ */
+import { type Judgment } from '../pi-ecosystem-judgment/index.js';
+export interface JudgmentInjectOptions {
+    minConfidence: number;
+    maxJudgments: number;
+    format: 'yaml' | 'json' | 'text';
+    includeEvidence: boolean;
+}
+export interface JudgmentContextResult {
+    fragments: string[];
+    judgments: Judgment[];
+    contextYaml: string;
+    confidence: number;
+}
+/**
+ * Get judgments associated with a fragment name
+ */
+export declare function getJudgmentsForFragment(fragmentName: string): Promise<Judgment[]>;
+/**
+ * Get high-confidence judgments for a file path
+ */
+export declare function getJudgmentsForPath(filePath: string, options?: Partial<JudgmentInjectOptions>): Promise<JudgmentContextResult>;
+/**
+ * Get core judgments for session start (high confidence only)
+ */
+export declare function getCoreJudgmentsForSession(minConfidence?: number): Promise<string>;
+/**
+ * Get judgments for a specific context (e.g., "investment", "code-review")
+ */
+export declare function getJudgmentsForContextRequest(context: string, options?: Partial<JudgmentInjectOptions>): Promise<JudgmentContextResult>;
+/**
+ * Generate injection prompt for a file path
+ */
+export declare function generateJudgmentInjection(filePath: string, gate: number, options?: Partial<JudgmentInjectOptions>): Promise<string>;

package/dist/bollharness-integration/bollharness-integration/context-router-judgment.js

@@ -0,0 +1,261 @@
+/**
+ * Judgment-Aware Context Router
+ *
+ * Extends ContextRouter with judgment lookup and injection capabilities.
+ *
+ * Architecture:
+ * - Path → Fragment Names → Associated Judgments
+ * - Confidence-based filtering
+ * - YAML format for user-language injection
+ *
+ * Integration with existing Bollharness:
+ * - Uses existing ContextRouter.match() for fragment lookup
+ * - Extends with judgment lookup based on fragment context
+ * - Injects at Gate 0, Gate 3, and file-edit time
+ */
+import { match as contextMatch, } from './context-router.js';
+import { getCombinedJudgments, getJudgmentsForContext, calculateConfidence, } from '../pi-ecosystem-judgment/index.js';
+const DEFAULT_OPTIONS = {
+    minConfidence: 0.7,
+    maxJudgments: 5,
+    format: 'yaml',
+    includeEvidence: false,
+};
+/**
+ * Get judgments associated with a fragment name
+ */
+export async function getJudgmentsForFragment(fragmentName) {
+    const allJudgments = await getCombinedJudgments();
+    // Map fragment to judgment context categories
+    const fragmentContextMap = {
+        'truth-source-hierarchy': ['truth-source', 'code', 'architecture', 'hierarchy', 'priority'],
+        'general-dev-principles': ['development', 'code-quality', 'best-practice'],
+        'code-quality': ['code-quality', 'readability', 'maintainability'],
+        'bridge-constitution': ['protocol', 'p2p', 'network'],
+        'agent-architecture': ['agent', 'multi-agent', 'collaboration'],
+        'multi-agent-patterns': ['multi-agent', 'delegation', 'coordination'],
+        'testing-patterns': ['testing', 'quality', 'verification'],
+        'decision-tracking': ['decision', 'adr', 'architecture'],
+    };
+    const contexts = fragmentContextMap[fragmentName] || [fragmentName];
+    const relevantJudgments = [];
+    for (const judgment of allJudgments) {
+        if (!judgment.context)
+            continue;
+        const judgmentContexts = judgment.context.toLowerCase().split(/[,\s]+/);
+        for (const ctx of contexts) {
+            if (judgmentContexts.some(jc => jc.includes(ctx.toLowerCase()))) {
+                relevantJudgments.push(judgment);
+                break;
+            }
+        }
+    }
+    return relevantJudgments;
+}
+/**
+ * Get high-confidence judgments for a file path
+ */
+export async function getJudgmentsForPath(filePath, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Get associated fragment names
+    const fragmentNames = contextMatch(filePath);
+    const allFragments = fragmentNames.length > 0 ? fragmentNames : ['general-dev-principles'];
+    // Get judgments for each fragment
+    const allJudgments = [];
+    for (const fragment of allFragments) {
+        const judgments = await getJudgmentsForFragment(fragment);
+        allJudgments.push(...judgments);
+    }
+    // Deduplicate and filter by confidence
+    const seen = new Set();
+    const filteredJudgments = [];
+    for (const j of allJudgments) {
+        if (seen.has(j.id))
+            continue;
+        if (j.confidence < opts.minConfidence)
+            continue;
+        seen.add(j.id);
+        filteredJudgments.push(j);
+    }
+    // Sort by confidence descending
+    filteredJudgments.sort((a, b) => b.confidence - a.confidence);
+    // Limit count
+    const limitedJudgments = filteredJudgments.slice(0, opts.maxJudgments);
+    // Calculate overall confidence
+    const overallConfidence = calculateConfidence(limitedJudgments);
+    // Format as YAML
+    const contextYaml = formatJudgmentsAsYaml(limitedJudgments, opts);
+    return {
+        fragments: allFragments,
+        judgments: limitedJudgments,
+        contextYaml,
+        confidence: overallConfidence,
+    };
+}
+/**
+ * Get core judgments for session start (high confidence only)
+ */
+export async function getCoreJudgmentsForSession(minConfidence = 0.9) {
+    const allJudgments = await getCombinedJudgments();
+    const highConfidence = allJudgments
+        .filter(j => j.confidence >= minConfidence && j.source === 'human')
+        .sort((a, b) => b.confidence - a.confidence)
+        .slice(0, 10);
+    if (highConfidence.length === 0) {
+        return '';
+    }
+    const lines = [
+        `# User Core Values (Confidence >= ${minConfidence})`,
+        `# Injected at session start - these represent fundamental user principles`,
+        '',
+        'core_judgments:',
+    ];
+    for (const j of highConfidence) {
+        lines.push(`  - principle: "${escapeYamlString(j.content)}"`);
+        lines.push(`    type: ${j.type}`);
+        lines.push(`    confidence: ${j.confidence.toFixed(2)}`);
+        if (j.context) {
+            lines.push(`    context: "${j.context}"`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Get judgments for a specific context (e.g., "investment", "code-review")
+ */
+export async function getJudgmentsForContextRequest(context, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const judgments = await getJudgmentsForContext(context);
+    const filtered = judgments
+        .filter(j => j.confidence >= opts.minConfidence)
+        .sort((a, b) => b.confidence - a.confidence)
+        .slice(0, opts.maxJudgments);
+    const overallConfidence = calculateConfidence(filtered);
+    const contextYaml = formatJudgmentsAsYaml(filtered, opts);
+    return {
+        fragments: [],
+        judgments: filtered,
+        contextYaml,
+        confidence: overallConfidence,
+    };
+}
+/**
+ * Format judgments as YAML for injection
+ */
+function formatJudgmentsAsYaml(judgments, opts) {
+    if (judgments.length === 0) {
+        return '';
+    }
+    const lines = [];
+    if (opts.format === 'yaml') {
+        lines.push('# Active Judgments');
+        lines.push('# Based on user history and preferences');
+        lines.push('');
+        lines.push('active_judgments:');
+        for (const j of judgments) {
+            lines.push(`  - principle: "${escapeYamlString(j.content)}"`);
+            lines.push(`    type: ${j.type}`);
+            lines.push(`    confidence: ${j.confidence.toFixed(2)}`);
+            if (j.context) {
+                lines.push(`    context: "${j.context}"`);
+            }
+            if (opts.includeEvidence && j.evidence) {
+                const evidenceStr = formatEvidence(j.evidence);
+                lines.push(`    evidence: ${evidenceStr}`);
+            }
+            lines.push('');
+        }
+    }
+    else if (opts.format === 'json') {
+        const obj = judgments.map(j => ({
+            principle: j.content,
+            type: j.type,
+            confidence: j.confidence,
+            context: j.context,
+            evidence: opts.includeEvidence ? j.evidence : undefined,
+        }));
+        lines.push(JSON.stringify(obj, null, 2));
+    }
+    else {
+        // text format
+        for (const j of judgments) {
+            lines.push(`[${(j.confidence * 100).toFixed(0)}%] ${j.content}`);
+            if (j.context) {
+                lines.push(`  Context: ${j.context}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format evidence for YAML
+ */
+function formatEvidence(evidence) {
+    if (!evidence)
+        return '""';
+    const parts = [];
+    if (evidence.trajectory && evidence.trajectory.length > 0) {
+        const summary = evidence.trajectory
+            .slice(-3)
+            .map(t => `${t.timestamp}: ${t.action}`)
+            .join(' → ');
+        parts.push(`trajectory: "${escapeYamlString(summary)}"`);
+    }
+    if (evidence.preference_pair && evidence.preference_pair.length > 0) {
+        const pp = evidence.preference_pair[0];
+        parts.push(`preference: "chose '${escapeYamlString(pp.chosen)}' over '${escapeYamlString(pp.rejected)}'"`);
+    }
+    if (evidence.correction) {
+        parts.push(`correction: "${escapeYamlString(evidence.correction.corrected)}"`);
+    }
+    return parts.length > 0 ? `"${parts.join('; ')}"` : '""';
+}
+/**
+ * Escape string for YAML
+ */
+function escapeYamlString(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Generate injection prompt for a file path
+ */
+export async function generateJudgmentInjection(filePath, gate, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Gate-specific confidence thresholds
+    const gateConfidence = {
+        0: 0.9, // Session start - only highest confidence
+        1: 0.8, // Architecture design
+        2: 0.75, // Review
+        3: 0.8, // Plan freeze
+        4: 0.75, // Review
+        5: 0.7, // Task architecture
+        6: 0.75, // Review
+        7: 0.7, // Execution
+        8: 0.7, // Test & Integration
+    };
+    const minConfidence = gateConfidence[gate] || opts.minConfidence;
+    const effectiveOptions = { ...opts, minConfidence };
+    if (gate === 0) {
+        // Session start - inject core judgments
+        return await getCoreJudgmentsForSession(minConfidence);
+    }
+    // Other gates - inject path-specific judgments
+    const result = await getJudgmentsForPath(filePath, effectiveOptions);
+    if (result.contextYaml.length === 0) {
+        return '';
+    }
+    const header = gate === 3
+        ? '# Plan Freeze - Decision Principles'
+        : `# Gate ${gate} - Active Judgments`;
+    return `${header}
+# Path: ${filePath}
+# Confidence: ${(result.confidence * 100).toFixed(0)}%
+
+${result.contextYaml}`;
+}

package/dist/bollharness-integration/bollharness-integration/context-router.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Context Router - Port of Bollharness context-fragments to Bolloon
+ *
+ * Implements path-based automatic context injection.
+ * When editing certain files, relevant context fragments are automatically injected.
+ *
+ * Loads fragments from src/bollharness/scripts/context-fragments/
+ */
+export declare const BOLLHARNESS_CONTEXT_DIR: any;
+export declare const FRAGMENTS_DIR: any;
+/**
+ * Context Map - Maps file paths to relevant context fragments
+ * Uses actual fragment filenames from src/bollharness/scripts/context-fragments/
+ */
+export declare const CONTEXT_MAP: Record<string, string[]>;
+/**
+ * Default fragments to inject when no specific match
+ */
+export declare const FALLBACK_FRAGMENTS: string[];
+/**
+ * Load a context fragment by name
+ */
+export declare function loadFragment(name: string): string;
+/**
+ * Match file path to context fragments
+ * Adapted from bollharness's match() function
+ */
+export declare function match(filePath: string): string[];
+/**
+ * Get all fragments for a file
+ */
+export declare function getFragments(filePath: string): string[];
+/**
+ * Load all fragments for a file
+ */
+export declare function loadFragments(filePath: string): string[];
+/**
+ * Context Router class for integration with Bolloon
+ */
+export declare class ContextRouter {
+    private fragmentsDir;
+    private injectedFile;
+    private injectedTTL;
+    constructor(fragmentsDir?: string);
+    /**
+     * Get fragments for a file path
+     */
+    match(filePath: string): string[];
+    /**
+     * Load fragment content
+     */
+    loadFragment(name: string): string;
+    /**
+     * Get all context for a file
+     */
+    getContext(filePath: string): string;
+    /**
+     * Get judgments for a file path (judgment-aware extension)
+     */
+    getJudgmentsForPath(filePath: string, minConfidence?: number): Promise<string>;
+    /**
+     * Get core judgments for session start
+     */
+    getCoreJudgments(minConfidence?: number): Promise<string>;
+    /**
+     * Get judgments for a specific context
+     */
+    getJudgmentsForContext(context: string, minConfidence?: number): Promise<string>;
+    /**
+     * Generate judgment injection for a gate
+     */
+    generateJudgmentInjection(filePath: string, gate: number): Promise<string>;
+    /**
+     * Check if fragment was recently injected
+     */
+    wasRecentlyInjected(fragmentName: string): boolean;
+    /**
+     * Mark fragments as injected
+     */
+    markInjected(fragmentNames: string[]): void;
+}
+/**
+ * Context fragments content
+ * These can be stored in context-fragments/ directory
+ */
+export declare const CONTEXT_FRAGMENTS: {
+    'general-dev-principles': string;
+    'code-quality': string;
+    'agent-architecture': string;
+    'multi-agent-patterns': string;
+    'documentation-standards': string;
+    'decision-tracking': string;
+    'adr-patterns': string;
+    'project-governance': string;
+    'truth-source-hierarchy': string;
+    'testing-patterns': string;
+    'quality-standards': string;
+    'workflow-patterns': string;
+    'orchestration-patterns': string;
+    'document-processing': string;
+    'parser-patterns': string;
+    'p2p-protocols': string;
+    'connection-patterns': string;
+    'constraint-design': string;
+    'validation-patterns': string;
+    'social-protocols': string;
+    'agent-discovery': string;
+    'project-intro': string;
+    'getting-started': string;
+};