@windagency/valora 2.0.1

package/dist/exploration/collaboration-coordinator.js

@@ -0,0 +1,332 @@
+/**
+ * Collaboration Coordinator - Manage shared insights and collaborative decisions
+ *
+ * Enables active collaboration between agents in different worktrees
+ */
+import { getLogger } from '../output/logger.js';
+import { getFileLockManager } from '../utils/file-lock.js';
+import { generateDecisionId, generateInsightId } from '../utils/id-generator.js';
+const logger = getLogger();
+export class CollaborationCoordinator {
+    decisionsPoolPath;
+    explorationId;
+    insightsPoolPath;
+    lockManager = getFileLockManager();
+    constructor(insightsPoolPath, decisionsPoolPath, explorationId) {
+        this.insightsPoolPath = insightsPoolPath;
+        this.decisionsPoolPath = decisionsPoolPath;
+        this.explorationId = explorationId;
+    }
+    /**
+     * Publish an insight to the shared pool
+     */
+    async publishInsight(options) {
+        const insight = {
+            content: options.content,
+            id: generateInsightId(),
+            metadata: options.metadata ?? {},
+            tags: options.tags ?? [],
+            timestamp: new Date().toISOString(),
+            title: options.title,
+            type: options.type,
+            worktree_id: options.worktree_id
+        };
+        // Update insights pool with locking
+        await this.lockManager.updateWithLock(this.insightsPoolPath, options.worktree_id, (pool) => {
+            pool ??= {
+                exploration_id: this.explorationId,
+                insights: [],
+                last_updated: new Date().toISOString(),
+                total_count: 0
+            };
+            pool.insights.push(insight);
+            pool.total_count = pool.insights.length;
+            pool.last_updated = new Date().toISOString();
+            return pool;
+        }, { pretty: true });
+        logger.info(`Insight published: ${insight.title} by ${options.worktree_id}`);
+        return insight;
+    }
+    /**
+     * Get all insights from the pool
+     */
+    async getAllInsights() {
+        const pool = await this.lockManager.readWithLock(this.insightsPoolPath, 'coordinator');
+        if (!pool) {
+            return [];
+        }
+        return pool.insights;
+    }
+    /**
+     * Get insights by type
+     */
+    async getInsightsByType(type) {
+        const allInsights = await this.getAllInsights();
+        return allInsights.filter((insight) => insight.type === type);
+    }
+    /**
+     * Get insights by tags
+     */
+    async getInsightsByTags(tags) {
+        const allInsights = await this.getAllInsights();
+        return allInsights.filter((insight) => tags.some((tag) => insight.tags.includes(tag)));
+    }
+    /**
+     * Get insights from other worktrees (exclude own insights)
+     */
+    async getInsightsFromOthers(worktreeId) {
+        const allInsights = await this.getAllInsights();
+        return allInsights.filter((insight) => insight.worktree_id !== worktreeId);
+    }
+    /**
+     * Get recent insights (last N)
+     */
+    async getRecentInsights(count = 10) {
+        const allInsights = await this.getAllInsights();
+        return allInsights.slice(-count);
+    }
+    /**
+     * Search insights by keyword
+     */
+    async searchInsights(keyword) {
+        const allInsights = await this.getAllInsights();
+        const lowerKeyword = keyword.toLowerCase();
+        return allInsights.filter((insight) => insight.title.toLowerCase().includes(lowerKeyword) ||
+            insight.content.toLowerCase().includes(lowerKeyword) ||
+            insight.tags.some((tag) => tag.toLowerCase().includes(lowerKeyword)));
+    }
+    /**
+     * Propose a decision for collaborative voting
+     */
+    async proposeDecision(options) {
+        const decision = {
+            id: generateDecisionId(),
+            options: options.options.map((opt, index) => ({
+                cons: opt.cons ?? [],
+                description: opt.description,
+                index,
+                label: opt.label,
+                pros: opt.pros ?? []
+            })),
+            rationale: options.rationale,
+            timestamp: new Date().toISOString(),
+            topic: options.topic,
+            votes: {}
+        };
+        // Update decisions pool with locking
+        await this.lockManager.updateWithLock(this.decisionsPoolPath, options.worktree_id, (pool) => {
+            pool ??= {
+                decisions: [],
+                exploration_id: this.explorationId,
+                last_updated: new Date().toISOString(),
+                total_count: 0
+            };
+            pool.decisions.push(decision);
+            pool.total_count = pool.decisions.length;
+            pool.last_updated = new Date().toISOString();
+            return pool;
+        }, { pretty: true });
+        logger.info(`Decision proposed: ${decision.topic} by ${options.worktree_id}`);
+        return decision;
+    }
+    /**
+     * Vote on a decision
+     */
+    async voteOnDecision(options) {
+        const updatedPool = await this.lockManager.updateWithLock(this.decisionsPoolPath, options.worktree_id, (pool) => {
+            // Initialize empty pool if null
+            pool ??= {
+                decisions: [],
+                exploration_id: this.explorationId,
+                last_updated: new Date().toISOString(),
+                total_count: 0
+            };
+            const decision = pool.decisions.find((d) => d.id === options.decision_id);
+            if (!decision) {
+                return pool;
+            }
+            // Record vote
+            decision.votes[options.worktree_id] = options.option_index;
+            // Check if decision is resolved (majority vote)
+            const voteCounts = this.countVotes(decision);
+            const totalVotes = Object.keys(decision.votes).length;
+            const majorityThreshold = Math.ceil(totalVotes / 2);
+            for (const [optionIndex, count] of Object.entries(voteCounts)) {
+                if (count >= majorityThreshold) {
+                    decision.chosen_option = parseInt(optionIndex);
+                    break;
+                }
+            }
+            pool.last_updated = new Date().toISOString();
+            return pool;
+        }, { pretty: true });
+        const decision = updatedPool?.decisions.find((d) => d.id === options.decision_id);
+        if (decision) {
+            logger.info(`Vote recorded: ${options.worktree_id} voted for option ${options.option_index} on ${decision.topic}`);
+        }
+        return decision ?? null;
+    }
+    /**
+     * Get all decisions
+     */
+    async getAllDecisions() {
+        const pool = await this.lockManager.readWithLock(this.decisionsPoolPath, 'coordinator');
+        if (!pool) {
+            return [];
+        }
+        return pool.decisions;
+    }
+    /**
+     * Get pending decisions (not yet resolved)
+     */
+    async getPendingDecisions() {
+        const allDecisions = await this.getAllDecisions();
+        return allDecisions.filter((decision) => decision.chosen_option === undefined);
+    }
+    /**
+     * Get resolved decisions
+     */
+    async getResolvedDecisions() {
+        const allDecisions = await this.getAllDecisions();
+        return allDecisions.filter((decision) => decision.chosen_option !== undefined);
+    }
+    /**
+     * Get decision by ID
+     */
+    async getDecision(decisionId) {
+        const allDecisions = await this.getAllDecisions();
+        return allDecisions.find((d) => d.id === decisionId) ?? null;
+    }
+    /**
+     * Get collaboration statistics
+     */
+    async getStats() {
+        const insights = await this.getAllInsights();
+        const decisions = await this.getAllDecisions();
+        // Count insights by type
+        const insightsByType = {};
+        for (const insight of insights) {
+            insightsByType[insight.type] = (insightsByType[insight.type] ?? 0) + 1;
+        }
+        // Count insights by worktree
+        const insightsByWorktree = {};
+        for (const insight of insights) {
+            insightsByWorktree[insight.worktree_id] = (insightsByWorktree[insight.worktree_id] ?? 0) + 1;
+        }
+        // Count decisions
+        const pendingDecisions = decisions.filter((d) => d.chosen_option === undefined).length;
+        const resolvedDecisions = decisions.filter((d) => d.chosen_option !== undefined).length;
+        // Calculate participation rate (how many worktrees have contributed)
+        const participatingWorktrees = new Set(insights.map((i) => i.worktree_id));
+        const participationRate = participatingWorktrees.size; // Just the count for now
+        return {
+            insights_by_type: insightsByType,
+            insights_by_worktree: insightsByWorktree,
+            participation_rate: participationRate,
+            pending_decisions: pendingDecisions,
+            resolved_decisions: resolvedDecisions,
+            total_decisions: decisions.length,
+            total_insights: insights.length
+        };
+    }
+    /**
+     * Clear all insights (for testing or cleanup)
+     */
+    async clearInsights() {
+        await this.lockManager.writeWithLock(this.insightsPoolPath, {
+            exploration_id: this.explorationId,
+            insights: [],
+            last_updated: new Date().toISOString(),
+            total_count: 0
+        }, 'coordinator', { pretty: true });
+        logger.info('All insights cleared');
+    }
+    /**
+     * Clear all decisions (for testing or cleanup)
+     */
+    async clearDecisions() {
+        await this.lockManager.writeWithLock(this.decisionsPoolPath, {
+            decisions: [],
+            exploration_id: this.explorationId,
+            last_updated: new Date().toISOString(),
+            total_count: 0
+        }, 'coordinator', { pretty: true });
+        logger.info('All decisions cleared');
+    }
+    /**
+     * Export insights to JSON
+     */
+    async exportInsights() {
+        const insights = await this.getAllInsights();
+        return JSON.stringify(insights, null, 2);
+    }
+    /**
+     * Export decisions to JSON
+     */
+    async exportDecisions() {
+        const decisions = await this.getAllDecisions();
+        return JSON.stringify(decisions, null, 2);
+    }
+    /**
+     * Get insights summary (for display)
+     */
+    async getInsightsSummary() {
+        const insights = await this.getAllInsights();
+        const stats = await this.getStats();
+        let summary = `# Insights Summary\n\n`;
+        summary += `Total Insights: ${stats.total_insights}\n\n`;
+        summary += `## By Type\n`;
+        for (const [type, count] of Object.entries(stats.insights_by_type)) {
+            summary += `- ${type}: ${count}\n`;
+        }
+        summary += `\n## By Worktree\n`;
+        for (const [worktreeId, count] of Object.entries(stats.insights_by_worktree)) {
+            summary += `- ${worktreeId}: ${count}\n`;
+        }
+        summary += `\n## Recent Insights (Last 5)\n`;
+        const recent = insights.slice(-5);
+        for (const insight of recent) {
+            summary += `- [${insight.type}] ${insight.title} (${insight.worktree_id})\n`;
+        }
+        return summary;
+    }
+    /**
+     * Get decisions summary (for display)
+     */
+    async getDecisionsSummary() {
+        const decisions = await this.getAllDecisions();
+        const stats = await this.getStats();
+        let summary = `# Decisions Summary\n\n`;
+        summary += `Total Decisions: ${stats.total_decisions}\n`;
+        summary += `Pending: ${stats.pending_decisions}\n`;
+        summary += `Resolved: ${stats.resolved_decisions}\n\n`;
+        summary += `## Pending Decisions\n`;
+        const pending = decisions.filter((d) => d.chosen_option === undefined);
+        for (const decision of pending) {
+            summary += `- ${decision.topic} (${Object.keys(decision.votes).length} votes)\n`;
+        }
+        summary += `\n## Resolved Decisions\n`;
+        const resolved = decisions.filter((d) => d.chosen_option !== undefined);
+        for (const decision of resolved) {
+            const chosenOptionIndex = decision.chosen_option;
+            if (chosenOptionIndex === undefined)
+                continue;
+            const chosenOption = decision.options[chosenOptionIndex];
+            if (!chosenOption)
+                continue;
+            summary += `- ${decision.topic} → ${chosenOption.label}\n`;
+        }
+        return summary;
+    }
+    /**
+     * Count votes for a decision
+     */
+    countVotes(decision) {
+        const counts = {};
+        for (const optionIndex of Object.values(decision.votes)) {
+            counts[optionIndex] = (counts[optionIndex] ?? 0) + 1;
+        }
+        return counts;
+    }
+}
+//# sourceMappingURL=collaboration-coordinator.js.map

package/dist/exploration/collaboration-coordinator.js.map

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

package/dist/exploration/container-manager.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Container Manager - Docker container lifecycle management
+ *
+ * Handles creating, monitoring, and destroying Docker containers for explorations
+ */
+import type { ContainerStats } from '../types/exploration.types.js';
+export interface ContainerConfig {
+    command?: string[];
+    container_name: string;
+    cpu_limit: string;
+    environment: Record<string, string>;
+    image: string;
+    memory_limit: string;
+    port?: number;
+    shared_volume_path: string;
+    worktree_path: string;
+}
+export interface ContainerInfo {
+    container_id: string;
+    container_name: string;
+    exit_code?: number;
+    finished_at?: string;
+    started_at?: string;
+    status: 'created' | 'dead' | 'exited' | 'paused' | 'running';
+}
+export declare class ContainerManager {
+    private containers;
+    constructor();
+    /**
+     * Create and start a container
+     */
+    createContainer(config: ContainerConfig): Promise<string>;
+    /**
+     * Create multiple containers in parallel
+     */
+    createMultipleContainers(configs: ContainerConfig[]): Promise<string[]>;
+    /**
+     * Stop a container
+     */
+    stopContainer(containerName: string, timeout?: number): Promise<void>;
+    /**
+     * Stop multiple containers in parallel
+     */
+    stopMultipleContainers(containerNames: string[], timeout?: number): Promise<void>;
+    /**
+     * Remove a container
+     */
+    removeContainer(containerName: string, force?: boolean): Promise<void>;
+    /**
+     * Remove multiple containers in parallel
+     */
+    removeMultipleContainers(containerNames: string[], force?: boolean): Promise<void>;
+    /**
+     * Get container status
+     */
+    getContainerStatus(containerName: string): Promise<ContainerInfo>;
+    /**
+     * Get container statistics
+     */
+    getContainerStats(containerName: string, worktreeIndex: number): Promise<ContainerStats>;
+    /**
+     * Get statistics for multiple containers
+     */
+    getMultipleContainerStats(containerNames: string[], worktreeIndices: number[]): Promise<ContainerStats[]>;
+    /**
+     * Get container logs
+     */
+    getContainerLogs(containerName: string, tail?: number): Promise<string>;
+    /**
+     * Execute a command in a running container
+     */
+    execInContainer(containerName: string, command: string[]): Promise<{
+        stderr: string;
+        stdout: string;
+    }>;
+    /**
+     * Check if a container exists
+     */
+    containerExists(containerName: string): Promise<boolean>;
+    /**
+     * Wait for container to exit
+     */
+    waitForContainer(containerName: string, timeout?: number): Promise<number>;
+    /**
+     * Pull Docker image if not present
+     */
+    pullImageIfNeeded(image: string): Promise<boolean>;
+    /**
+     * Pause a container
+     */
+    pauseContainer(containerName: string): Promise<void>;
+    /**
+     * Unpause a container
+     */
+    unpauseContainer(containerName: string): Promise<void>;
+    /**
+     * Kill a container (force stop)
+     */
+    killContainer(containerName: string, signal?: string): Promise<void>;
+    /**
+     * Get all tracked containers
+     */
+    getTrackedContainers(): ContainerInfo[];
+    /**
+     * Clear tracking for a container
+     */
+    untrackContainer(containerName: string): void;
+    /**
+     * Clear all tracking
+     */
+    clearTracking(): void;
+    /**
+     * Parse memory string (e.g., "256MiB", "2GiB") to MB
+     */
+    private parseMemoryString;
+    /**
+     * Calculate uptime in seconds
+     */
+    private calculateUptime;
+}
+//# sourceMappingURL=container-manager.d.ts.map

package/dist/exploration/container-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-manager.d.ts","sourceRoot":"","sources":["../../src/exploration/container-manager.ts"],"names":[],"mappings":"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"}