@bolloon/bolloon-agent 0.1.0 → 0.1.2

package/dist/social/channels/harness-workflow-integrator.js

@@ -0,0 +1,446 @@
+/**
+ * Harness Workflow Integrator
+ *
+ * 将 Channel Agent 与 Bollharness 配置系统集成：
+ * 1. 加载 YAML 工作流配置
+ * 2. 实现 Gate 状态机
+ * 3. Skill 路由调度
+ * 4. 多智能体协作协调
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Harness Workflow Integrator 类
+ */
+export class HarnessWorkflowIntegrator {
+    config = null;
+    currentGate = 0;
+    artifacts = new Map();
+    gateHistory = [];
+    initialized = false;
+    constructor() { }
+    /**
+     * 初始化，加载配置
+     */
+    async initialize(configPath) {
+        if (this.initialized)
+            return;
+        const defaultPath = path.join(process.env.HOME || '/tmp', '.bolloon', 'channels', 'agent-workflow-config.yaml');
+        const filePath = configPath || defaultPath;
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            this.config = JSON.parse(content);
+            this.initialized = true;
+            console.log(`[HarnessIntegrator] Loaded workflow config from ${filePath}`);
+        }
+        catch (e) {
+            // 使用内置默认配置
+            this.config = this.getDefaultConfig();
+            this.initialized = true;
+            console.log('[HarnessIntegrator] Using default workflow config');
+        }
+    }
+    /**
+     * 获取默认配置
+     */
+    getDefaultConfig() {
+        return {
+            version: '1.0',
+            workflows: {
+                default: {
+                    name: '默认协作工作流',
+                    description: '基于 Harness Gate 的多智能体协作工作流',
+                    initial_gate: 0,
+                    gates: {
+                        0: {
+                            name: '问题锁定',
+                            entry_condition: '用户提出需求',
+                            required_artifact: '问题陈述 + Change Classification',
+                            required_skills: ['arch'],
+                            next_gate: 1
+                        },
+                        1: {
+                            name: '架构设计',
+                            entry_condition: 'Gate 0 产物存在',
+                            required_artifact: 'ADR草稿 + 消费方清单',
+                            required_skills: ['arch', 'lead'],
+                            next_gate: 2
+                        },
+                        2: {
+                            name: '架构审查',
+                            entry_condition: 'ADR草稿完成',
+                            required_artifact: '审查报告 (PASS/BLOCK)',
+                            required_skills: ['arch', 'guardian-fixer'],
+                            is_review_gate: true,
+                            reviewer_type: 'independent',
+                            next_gate: 3
+                        },
+                        3: {
+                            name: '计划制定',
+                            entry_condition: 'Gate 2 PASS',
+                            required_artifact: 'PLAN文档 + 架构覆盖矩阵',
+                            required_skills: ['harness-eng', 'plan-lock'],
+                            next_gate: 4
+                        },
+                        4: {
+                            name: '计划审查',
+                            entry_condition: 'PLAN vN-final 冻结',
+                            required_artifact: '审查报告 + plan-lock确认',
+                            required_skills: ['arch', 'guardian-fixer'],
+                            is_review_gate: true,
+                            reviewer_type: 'independent',
+                            next_gate: 5
+                        },
+                        5: {
+                            name: '任务分解',
+                            entry_condition: 'Gate 4 PASS + plan-lock',
+                            required_artifact: 'WP拆分 + TASK.md',
+                            required_skills: ['task-arch', 'crystal-learn'],
+                            next_gate: 6
+                        },
+                        6: {
+                            name: '任务审查',
+                            entry_condition: '全部TASK.md完成',
+                            required_artifact: '审查报告 (PASS/BLOCK)',
+                            required_skills: ['task-arch', 'guardian-fixer'],
+                            is_review_gate: true,
+                            reviewer_type: 'independent',
+                            next_gate: 7
+                        },
+                        7: {
+                            name: '代码实现',
+                            entry_condition: 'Gate 6 PASS',
+                            required_artifact: '代码 + LOG.md',
+                            required_skills: ['harness-eng', 'harness-dev'],
+                            next_gate: 8
+                        },
+                        8: {
+                            name: '测试验证',
+                            entry_condition: '全部WP代码 + LOG.md存在',
+                            required_artifact: '审查报告 + 验收确认',
+                            required_skills: ['harness-eng', 'harness-eng-test'],
+                            is_review_gate: true,
+                            reviewer_type: 'independent',
+                            next_gate: null
+                        }
+                    }
+                }
+            },
+            agent_roles: {
+                architect: {
+                    name: '架构师',
+                    description: '负责架构决策、方案比较',
+                    capabilities: ['架构设计', '方案比较', '边界冻结'],
+                    default_skills: ['arch', 'lead'],
+                    triggers: ['架构设计', '方案比较']
+                },
+                developer: {
+                    name: '开发工程师',
+                    description: '负责代码实现和优化',
+                    capabilities: ['代码编写', '调试', '重构'],
+                    default_skills: ['harness-dev', 'harness-eng'],
+                    triggers: ['实现', '写代码', '开发']
+                },
+                reviewer: {
+                    name: '代码审查员',
+                    description: '独立审查代码质量和架构',
+                    capabilities: ['代码审查', '质量评估', '问题发现'],
+                    default_skills: ['guardian-fixer', 'arch'],
+                    triggers: ['代码审查', 'review', '审核']
+                }
+            },
+            skill_routing: {
+                keyword_to_skill: {
+                    '架构': ['arch', 'lead'],
+                    '设计': ['arch'],
+                    'review': ['guardian-fixer', 'arch'],
+                    '代码': ['guardian-fixer', 'harness-dev'],
+                    '安全': ['guardian-fixer', 'arch'],
+                    '任务': ['task-arch', 'harness-eng'],
+                    '分解': ['task-arch'],
+                    '实现': ['harness-dev', 'harness-eng'],
+                    '测试': ['harness-eng-test', 'guardian-fixer'],
+                    '验证': ['harness-eng-test']
+                },
+                gate_to_skills: {
+                    0: ['arch', 'lead'],
+                    1: ['arch', 'lead'],
+                    2: ['guardian-fixer', 'arch'],
+                    3: ['harness-eng', 'plan-lock'],
+                    4: ['guardian-fixer', 'arch'],
+                    5: ['task-arch', 'crystal-learn'],
+                    6: ['task-arch', 'guardian-fixer'],
+                    7: ['harness-eng', 'harness-dev'],
+                    8: ['harness-eng', 'harness-eng-test']
+                }
+            },
+            fast_track: {
+                enabled: true,
+                conditions: [
+                    '改动不超过 3 个文件',
+                    'Change Classification = implementation',
+                    '无跨模块接缝',
+                    '不影响用户心智或产品语义',
+                    '不引入新的架构决策'
+                ],
+                required_steps: ['执行 skill', '单人审查']
+            },
+            parallel_execution: {
+                enabled: true,
+                contract: {
+                    required_fields: ['write_set', 'parallel_tracks', 'depends_on', 'integration_owner', 'seam_owner', 'golden_journeys'],
+                    seam_validation: {
+                        enabled: true,
+                        blocking: true,
+                        message: '任何跨 WP 共享接口必须有 seam_owner'
+                    }
+                }
+            },
+            collaboration_protocol: {
+                message_format: {
+                    type: 'structured',
+                    fields: ['type', 'from', 'to', 'content', 'gate', 'skill', 'timestamp', 'artifact']
+                },
+                state_sync: {
+                    enabled: true,
+                    interval_ms: 5000,
+                    sync_on_gate_change: true
+                },
+                conflict_resolution: {
+                    strategy: 'gate_based',
+                    escalation_gates: [2, 4, 6, 8]
+                }
+            }
+        };
+    }
+    /**
+     * 获取当前 Gate 配置
+     */
+    getGateConfig(gate) {
+        if (!this.config)
+            return null;
+        return this.config.workflows.default.gates[gate] || null;
+    }
+    /**
+     * 获取当前 Gate
+     */
+    getCurrentGate() {
+        return this.currentGate;
+    }
+    /**
+     * 获取 Gate Pack (用于 Skill 输出)
+     */
+    getGatePack() {
+        const gateConfig = this.getGateConfig(this.currentGate);
+        return {
+            current_gate: this.currentGate,
+            entry_satisfied: this.checkEntryCondition(),
+            blockers: this.getBlockers(),
+            required_artifact: gateConfig?.required_artifact || '',
+            required_skills: gateConfig?.required_skills || [],
+            required_review_substrate: gateConfig?.is_review_gate ? '独立审查' : undefined
+        };
+    }
+    /**
+     * 检查入口条件是否满足
+     */
+    checkEntryCondition() {
+        if (this.currentGate === 0)
+            return true;
+        return this.artifacts.size > 0;
+    }
+    /**
+     * 获取阻塞条件
+     */
+    getBlockers() {
+        const blockers = [];
+        const gateConfig = this.getGateConfig(this.currentGate);
+        if (!gateConfig)
+            return blockers;
+        if (!this.checkEntryCondition()) {
+            blockers.push(`Gate ${this.currentGate} 入口条件未满足: ${gateConfig.entry_condition}`);
+        }
+        return blockers;
+    }
+    /**
+     * 提交产物到当前 Gate
+     */
+    submitArtifact(name, artifact) {
+        this.artifacts.set(name, artifact);
+    }
+    /**
+     * 获取产物
+     */
+    getArtifact(name) {
+        return this.artifacts.get(name);
+    }
+    /**
+     * 尝试转移 Gate
+     */
+    async transitionGate(reviewResult) {
+        const gateConfig = this.getGateConfig(this.currentGate);
+        if (!gateConfig) {
+            return {
+                success: false,
+                from: this.currentGate,
+                to: null,
+                blockers: ['无效的 Gate 配置'],
+                message: 'Gate 转移失败'
+            };
+        }
+        const blockers = [];
+        // 审查门需要审查结果
+        if (gateConfig.is_review_gate) {
+            if (!reviewResult) {
+                return {
+                    success: false,
+                    from: this.currentGate,
+                    to: null,
+                    blockers: ['审查门需要审查结果'],
+                    message: `Gate ${this.currentGate} 是审查门，需要独立审查`
+                };
+            }
+            if (reviewResult.verdict === 'BLOCK') {
+                blockers.push(reviewResult.details || '审查未通过');
+            }
+        }
+        // 检查入口条件
+        if (!this.checkEntryCondition()) {
+            blockers.push(`入口条件未满足: ${gateConfig.entry_condition}`);
+        }
+        if (blockers.length > 0) {
+            return {
+                success: false,
+                from: this.currentGate,
+                to: this.currentGate,
+                blockers,
+                message: `Gate ${this.currentGate} BLOCKED`
+            };
+        }
+        // 执行转移
+        const nextGate = gateConfig.next_gate;
+        this.gateHistory.push(this.currentGate);
+        this.currentGate = nextGate ?? this.currentGate;
+        return {
+            success: true,
+            from: this.gateHistory[this.gateHistory.length - 1],
+            to: this.currentGate,
+            blockers: [],
+            message: nextGate === null ? '工作流完成' : `Gate ${this.gateHistory[this.gateHistory.length - 1]} → Gate ${this.currentGate}`
+        };
+    }
+    /**
+     * 基于关键词路由 Skill
+     */
+    routeSkillsByKeyword(message) {
+        if (!this.config)
+            return [];
+        const lowerMessage = message.toLowerCase();
+        const skills = new Set();
+        for (const [keyword, skillList] of Object.entries(this.config.skill_routing.keyword_to_skill)) {
+            if (lowerMessage.includes(keyword.toLowerCase())) {
+                skillList.forEach(s => skills.add(s));
+            }
+        }
+        // 如果没有匹配，返回当前 Gate 的默认 skills
+        if (skills.size === 0) {
+            const gateSkills = this.config.skill_routing.gate_to_skills[this.currentGate];
+            return gateSkills || [];
+        }
+        return Array.from(skills);
+    }
+    /**
+     * 基于当前 Gate 获取 Skills
+     */
+    getSkillsForCurrentGate() {
+        if (!this.config)
+            return [];
+        return this.config.skill_routing.gate_to_skills[this.currentGate] || [];
+    }
+    /**
+     * 获取智能体角色
+     */
+    getAgentRole(roleId) {
+        if (!this.config)
+            return null;
+        return this.config.agent_roles[roleId] || null;
+    }
+    /**
+     * 根据能力匹配智能体角色
+     */
+    matchAgentRole(capabilities) {
+        if (!this.config)
+            return null;
+        for (const role of Object.values(this.config.agent_roles)) {
+            const hasMatch = capabilities.some(cap => role.capabilities.some(rc => rc.includes(cap) || cap.includes(rc)));
+            if (hasMatch)
+                return role;
+        }
+        return this.config.agent_roles['architect'];
+    }
+    /**
+     * 检查是否可以使用快速通道
+     */
+    canUseFastTrack(changeDescription) {
+        if (!this.config?.fast_track.enabled) {
+            return { canUse: false, blockers: ['快速通道未启用'] };
+        }
+        const blockers = [];
+        const conditions = this.config.fast_track.conditions;
+        // 简化检查：实际应用中需要更复杂的分析
+        if (changeDescription.length > 500) {
+            blockers.push('改动可能超过 3 个文件');
+        }
+        if (changeDescription.includes('API') || changeDescription.includes('契约')) {
+            blockers.push('涉及契约变更');
+        }
+        if (changeDescription.includes('模块') || changeDescription.includes('跨模块')) {
+            blockers.push('涉及跨模块接缝');
+        }
+        return {
+            canUse: blockers.length === 0,
+            blockers
+        };
+    }
+    /**
+     * 获取工作流状态摘要
+     */
+    getWorkflowStatus() {
+        const gateConfig = this.getGateConfig(this.currentGate);
+        const totalGates = 9;
+        return {
+            currentGate: this.currentGate,
+            gateName: gateConfig?.name || '未知',
+            progress: `${this.currentGate}/${totalGates} Gates`,
+            blockers: this.getBlockers(),
+            history: [...this.gateHistory]
+        };
+    }
+    /**
+     * 重置工作流
+     */
+    reset() {
+        this.currentGate = 0;
+        this.artifacts.clear();
+        this.gateHistory = [];
+    }
+    /**
+     * 导出配置为 JSON
+     */
+    exportConfig() {
+        if (!this.config)
+            return '';
+        return JSON.stringify(this.config, null, 2);
+    }
+}
+// 单例实例
+let integratorInstance = null;
+export function createHarnessWorkflowIntegrator() {
+    return new HarnessWorkflowIntegrator();
+}
+export function getHarnessWorkflowIntegrator() {
+    if (!integratorInstance) {
+        integratorInstance = new HarnessWorkflowIntegrator();
+    }
+    return integratorInstance;
+}

package/dist/social/channels/index.js

@@ -0,0 +1,9 @@
+/**
+ * Channel Agent Social Module - 频道智能体社交系统
+ *
+ * 基于 Diap 去中心化协议的对外社交频道系统
+ */
+export { ChannelType, DEFAULT_CHANNEL_CONFIG } from './types.js';
+export { InterestMatcher, interestMatcher } from './InterestMatcher.js';
+export { ChannelManager } from './ChannelManager.js';
+export { DiapChannelBridge } from './DiapChannelBridge.js';

package/dist/social/channels/types.js

@@ -1,21 +1,17 @@
-"use strict";
 /**
  * Channel Types - 频道智能体社交系统类型定义
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CHANNEL_CONFIG = exports.ChannelType = void 0;
-var ChannelType;
+export var ChannelType;
 (function (ChannelType) {
     ChannelType["INTEREST"] = "interest";
     ChannelType["CAPABILITY"] = "capability";
     ChannelType["REGION"] = "region";
     ChannelType["AD_HOC"] = "ad_hoc";
-})(ChannelType || (exports.ChannelType = ChannelType = {}));
-exports.DEFAULT_CHANNEL_CONFIG = {
+})(ChannelType || (ChannelType = {}));
+export const DEFAULT_CHANNEL_CONFIG = {
     broadcastInterval: 60 * 1000,
     matchThreshold: 0.5,
     maxChannels: 10,
     maxMembersPerChannel: 50,
     memberTimeout: 30 * 60 * 1000,
 };
-//# sourceMappingURL=types.js.map

package/dist/social/global-shared-context.js

@@ -1,48 +1,9 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GlobalSharedContextManager = void 0;
-exports.getGlobalSharedContext = getGlobalSharedContext;
-exports.createGlobalSharedContext = createGlobalSharedContext;
-exports.resetGlobalSharedContext = resetGlobalSharedContext;
-const fs = __importStar(require("fs/promises"));
-const path = __importStar(require("path"));
+import * as fs from 'fs/promises';
+import * as path from 'path';
 const GLOBAL_CONTEXT_PATH = path.join(process.env.HOME || '/tmp', '.bolloon', 'sessions', 'global-context.json');
 const MAX_RECENT_ACTIONS = 50;
 const MAX_SHARED_KNOWLEDGE = 100;
-class GlobalSharedContextManager {
+export class GlobalSharedContextManager {
     memory = {
         recentActions: [],
         sharedKnowledge: []
@@ -346,15 +307,14 @@ class GlobalSharedContextManager {
         await this.save();
     }
 }
-exports.GlobalSharedContextManager = GlobalSharedContextManager;
 let globalContextInstance = null;
-function getGlobalSharedContext() {
+export function getGlobalSharedContext() {
     if (!globalContextInstance) {
         globalContextInstance = new GlobalSharedContextManager();
     }
     return globalContextInstance;
 }
-async function createGlobalSharedContext(contextPath) {
+export async function createGlobalSharedContext(contextPath) {
     if (globalContextInstance) {
         return globalContextInstance;
     }
@@ -362,7 +322,6 @@ async function createGlobalSharedContext(contextPath) {
     await globalContextInstance.initialize();
     return globalContextInstance;
 }
-function resetGlobalSharedContext() {
+export function resetGlobalSharedContext() {
     globalContextInstance = null;
 }
-//# sourceMappingURL=global-shared-context.js.map