@miller-tech/uap 1.0.0

package/dist/coordination/adaptive-patterns.js

@@ -0,0 +1,108 @@
+/**
+ * Adaptive Pattern Engine for UAP
+ *
+ * Tracks pattern outcomes per task category and returns patterns sorted
+ * by historical success rate. Enables the system to learn which patterns
+ * work best for different types of tasks over time.
+ */
+/**
+ * AdaptivePatternEngine learns which patterns work best for different
+ * task categories by tracking success/failure outcomes.
+ */
+export class AdaptivePatternEngine {
+    /**
+     * Map<patternId, Map<taskCategory, PatternOutcome>>
+     * Tracks per-pattern, per-category success rates.
+     */
+    outcomes = new Map();
+    /**
+     * Optional content store: Map<patternId, content>
+     * Populated when outcomes are recorded so getAdaptedPatterns can return content.
+     */
+    patternContent = new Map();
+    /**
+     * Record the outcome of applying a pattern to a task.
+     *
+     * @param patternId - Identifier of the pattern (e.g. "P12")
+     * @param success - Whether the task completed successfully
+     * @param taskCategory - Category of the task (e.g. "security", "refactor")
+     */
+    recordPatternOutcome(patternId, success, taskCategory) {
+        if (!this.outcomes.has(patternId)) {
+            this.outcomes.set(patternId, new Map());
+        }
+        const categoryMap = this.outcomes.get(patternId);
+        if (!categoryMap.has(taskCategory)) {
+            categoryMap.set(taskCategory, { uses: 0, successes: 0 });
+        }
+        const outcome = categoryMap.get(taskCategory);
+        outcome.uses += 1;
+        if (success) {
+            outcome.successes += 1;
+        }
+        // Store a default content string if not already present
+        if (!this.patternContent.has(patternId)) {
+            this.patternContent.set(patternId, patternId);
+        }
+    }
+    /**
+     * Set content for a pattern (optional, for richer results).
+     */
+    setPatternContent(patternId, content) {
+        this.patternContent.set(patternId, content);
+    }
+    /**
+     * Get patterns sorted by success rate for a given task category.
+     *
+     * @param taskCategory - Category to filter by
+     * @param limit - Maximum number of patterns to return (default: 10)
+     * @returns Patterns sorted by success rate descending
+     */
+    getAdaptedPatterns(taskCategory, limit = 10) {
+        const results = [];
+        for (const [patternId, categoryMap] of this.outcomes) {
+            const outcome = categoryMap.get(taskCategory);
+            if (!outcome)
+                continue;
+            const successRate = outcome.uses > 0 ? outcome.successes / outcome.uses : 0;
+            results.push({
+                id: patternId,
+                content: this.patternContent.get(patternId) || patternId,
+                successRate,
+            });
+        }
+        results.sort((a, b) => b.successRate - a.successRate);
+        return results.slice(0, limit);
+    }
+    /**
+     * Get aggregated stats for all tracked patterns across all categories.
+     *
+     * @returns Map of patternId to aggregate stats
+     */
+    getPatternStats() {
+        const stats = {};
+        for (const [patternId, categoryMap] of this.outcomes) {
+            let totalUses = 0;
+            let totalSuccesses = 0;
+            for (const outcome of categoryMap.values()) {
+                totalUses += outcome.uses;
+                totalSuccesses += outcome.successes;
+            }
+            stats[patternId] = {
+                uses: totalUses,
+                successes: totalSuccesses,
+                rate: totalUses > 0 ? totalSuccesses / totalUses : 0,
+            };
+        }
+        return stats;
+    }
+}
+// Singleton
+let instance = null;
+export function getAdaptivePatternEngine() {
+    if (!instance) {
+        instance = new AdaptivePatternEngine();
+    }
+    return instance;
+}
+//# sourceMappingURL=adaptive-patterns.js.map

package/dist/coordination/adaptive-patterns.js.map

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

package/dist/coordination/auto-agent.d.ts

@@ -0,0 +1,82 @@
+import { CoordinationService } from './service.js';
+import type { AgentRegistryEntry } from '../types/coordination.js';
+export interface AutoAgentConfig {
+    sessionId?: string;
+    heartbeatIntervalMs?: number;
+    name?: string;
+    capabilities?: string[];
+    worktreeBranch?: string;
+}
+export interface AutoAgentResult {
+    agent: AgentRegistryEntry;
+    service: CoordinationService;
+    cleanup: () => void;
+}
+/**
+ * Manages automatic agent registration and lifecycle.
+ * Registers the agent on initialization and handles heartbeat/exit cleanup.
+ */
+export declare class AutoAgentCoordinator {
+    private service;
+    private agentId;
+    private heartbeatInterval?;
+    private config;
+    private cleanedUp;
+    private exitHandlers;
+    constructor(config: AutoAgentConfig);
+    /**
+     * Register agent and start heartbeat.
+     */
+    start(): Promise<AutoAgentResult>;
+    /**
+     * Start periodic heartbeat.
+     */
+    startHeartbeat(): void;
+    /**
+     * Register cleanup handlers for graceful shutdown.
+     * Uses tracked handlers to prevent listener leaks on repeated start/cleanup cycles.
+     */
+    private registerExitHandlers;
+    /**
+     * Cleanup: stop heartbeat, mark agent as completed, remove exit handlers.
+     * Safe to call multiple times (idempotent).
+     */
+    cleanup(): void;
+    /**
+     * Update agent status.
+     */
+    updateStatus(status: 'active' | 'idle' | 'completed' | 'failed', currentTask?: string): void;
+    /**
+     * Announce work on a resource.
+     */
+    announceWork(resource: string, intentType: 'editing' | 'reviewing' | 'refactoring' | 'testing' | 'documenting', options?: {
+        description?: string;
+        filesAffected?: string[];
+        estimatedMinutes?: number;
+    }): {
+        announcement: import("../types/coordination.js").WorkAnnouncement;
+        overlaps: import("../types/coordination.js").WorkOverlap[];
+        suggestions: import("../types/coordination.js").CollaborationSuggestion[];
+    };
+    /**
+     * Complete work on a resource.
+     */
+    completeWork(resource: string): void;
+    /**
+     * Check for overlaps on a resource.
+     */
+    checkOverlaps(resource: string): import('../types/coordination.js').WorkOverlap[];
+    /**
+     * Get the agent ID.
+     */
+    getAgentId(): string;
+    /**
+     * Get the coordination service.
+     */
+    getService(): CoordinationService;
+}
+/**
+ * Factory function for creating auto agents.
+ */
+export declare function createAutoAgent(config: AutoAgentConfig): AutoAgentCoordinator;
+//# sourceMappingURL=auto-agent.d.ts.map

package/dist/coordination/auto-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-agent.d.ts","sourceRoot":"","sources":["../../src/coordination/auto-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAiD;gBAEzD,MAAM,EAAE,eAAe;IAenC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IA0BvC;;OAEG;IACH,cAAc,IAAI,IAAI;IAetB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;IACH,OAAO,IAAI,IAAI;IAyBf;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5F;;OAEG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,EAC/E,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;IAKR;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,0BAA0B,EAAE,WAAW,EAAE;IAIjF;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,UAAU,IAAI,mBAAmB;CAGlC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB,CAE7E"}

package/dist/coordination/auto-agent.js

@@ -0,0 +1,145 @@
+import { CoordinationService } from './service.js';
+/**
+ * Manages automatic agent registration and lifecycle.
+ * Registers the agent on initialization and handles heartbeat/exit cleanup.
+ */
+export class AutoAgentCoordinator {
+    service;
+    agentId;
+    heartbeatInterval;
+    config;
+    cleanedUp = false;
+    exitHandlers = [];
+    constructor(config) {
+        this.config = {
+            name: config.name || `agent-${Date.now()}`,
+            capabilities: config.capabilities || ['default'],
+            worktreeBranch: config.worktreeBranch,
+            sessionId: config.sessionId,
+            heartbeatIntervalMs: config.heartbeatIntervalMs || 30000,
+        };
+        this.service = new CoordinationService({
+            sessionId: this.config.sessionId,
+            heartbeatIntervalMs: this.config.heartbeatIntervalMs,
+        });
+    }
+    /**
+     * Register agent and start heartbeat.
+     */
+    async start() {
+        const name = this.config.name ?? `agent-${Date.now()}`;
+        // Register agent
+        this.agentId = this.service.register(name, this.config.capabilities, this.config.worktreeBranch ?? undefined);
+        // Update status to active
+        this.service.updateStatus(this.agentId, 'active', undefined);
+        // Start heartbeat
+        this.startHeartbeat();
+        // Register exit handlers
+        this.registerExitHandlers();
+        return {
+            agent: this.service.getAgent(this.agentId),
+            service: this.service,
+            cleanup: () => this.cleanup(),
+        };
+    }
+    /**
+     * Start periodic heartbeat.
+     */
+    startHeartbeat() {
+        // Heartbeat immediately
+        this.service.heartbeat(this.agentId);
+        // Then every interval (unref to prevent blocking process exit)
+        this.heartbeatInterval = setInterval(() => {
+            this.service.heartbeat(this.agentId);
+        }, this.config.heartbeatIntervalMs);
+        // Allow process to exit even if heartbeat is running
+        if (this.heartbeatInterval) {
+            this.heartbeatInterval.unref();
+        }
+    }
+    /**
+     * Register cleanup handlers for graceful shutdown.
+     * Uses tracked handlers to prevent listener leaks on repeated start/cleanup cycles.
+     */
+    registerExitHandlers() {
+        const cleanup = () => {
+            this.cleanup();
+        };
+        // Track handlers so we can remove them on cleanup
+        for (const signal of ['SIGINT', 'SIGTERM', 'exit']) {
+            const handler = cleanup;
+            this.exitHandlers.push({ signal, handler });
+            process.on(signal, handler);
+        }
+    }
+    /**
+     * Cleanup: stop heartbeat, mark agent as completed, remove exit handlers.
+     * Safe to call multiple times (idempotent).
+     */
+    cleanup() {
+        if (this.cleanedUp)
+            return;
+        this.cleanedUp = true;
+        // Stop heartbeat
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+        }
+        // Remove exit handlers to prevent listener leaks
+        for (const { signal, handler } of this.exitHandlers) {
+            process.removeListener(signal, handler);
+        }
+        this.exitHandlers = [];
+        // Mark agent as completed
+        try {
+            this.service.updateStatus(this.agentId, 'completed', undefined);
+        }
+        catch (error) {
+            // Agent may already be deregistered
+            console.warn('Failed to update agent status:', error);
+        }
+    }
+    /**
+     * Update agent status.
+     */
+    updateStatus(status, currentTask) {
+        this.service.updateStatus(this.agentId, status, currentTask ?? undefined);
+    }
+    /**
+     * Announce work on a resource.
+     */
+    announceWork(resource, intentType, options = {}) {
+        return this.service.announceWork(this.agentId, resource, intentType, options);
+    }
+    /**
+     * Complete work on a resource.
+     */
+    completeWork(resource) {
+        this.service.completeWork(this.agentId, resource);
+    }
+    /**
+     * Check for overlaps on a resource.
+     */
+    checkOverlaps(resource) {
+        return this.service.detectOverlaps(resource, this.agentId);
+    }
+    /**
+     * Get the agent ID.
+     */
+    getAgentId() {
+        return this.agentId;
+    }
+    /**
+     * Get the coordination service.
+     */
+    getService() {
+        return this.service;
+    }
+}
+/**
+ * Factory function for creating auto agents.
+ */
+export function createAutoAgent(config) {
+    return new AutoAgentCoordinator(config);
+}
+//# sourceMappingURL=auto-agent.js.map

package/dist/coordination/auto-agent.js.map

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

package/dist/coordination/capability-router.d.ts

@@ -0,0 +1,79 @@
+import type { AgentRegistryEntry } from '../types/coordination.js';
+import type { Task, TaskType } from '../tasks/types.js';
+/**
+ * Agent capability definitions for intelligent task routing.
+ */
+export type AgentCapability = 'typescript' | 'javascript' | 'python' | 'rust' | 'go' | 'cpp' | 'java' | 'cli' | 'frontend' | 'backend' | 'database' | 'security' | 'performance' | 'documentation' | 'testing' | 'devops' | 'infrastructure' | 'code-review' | 'refactoring';
+/**
+ * Droid/skill mapping for capability routing.
+ */
+export interface CapabilityMapping {
+    capability: AgentCapability;
+    droids: string[];
+    skills: string[];
+    filePatterns: string[];
+    taskTypes: TaskType[];
+    priority: number;
+}
+/**
+ * Default capability mappings for UAP droids and skills.
+ */
+export declare const DEFAULT_CAPABILITY_MAPPINGS: CapabilityMapping[];
+export interface RoutingResult {
+    recommendedDroids: string[];
+    recommendedSkills: string[];
+    matchedCapabilities: AgentCapability[];
+    confidence: number;
+    reasoning: string;
+}
+export interface AgentMatch {
+    agent: AgentRegistryEntry;
+    matchedCapabilities: AgentCapability[];
+    score: number;
+}
+/**
+ * Capability-based router for intelligent task and agent routing.
+ */
+export declare class CapabilityRouter {
+    private mappings;
+    constructor(customMappings?: CapabilityMapping[]);
+    /**
+     * Route a task to the best droids/skills based on task content and affected files.
+     */
+    routeTask(task: Task, affectedFiles?: string[]): RoutingResult;
+    /**
+     * Find the best agent for a task based on capabilities.
+     */
+    findBestAgent(task: Task, availableAgents: AgentRegistryEntry[], affectedFiles?: string[]): AgentMatch | null;
+    /**
+     * Route files to appropriate capabilities.
+     */
+    routeFiles(files: string[]): Map<AgentCapability, string[]>;
+    /**
+     * Get recommended parallel review droids for a set of files.
+     */
+    getParallelReviewDroids(files: string[]): string[];
+    /**
+     * Match files against a glob-like pattern.
+     */
+    private matchesPattern;
+    /**
+     * Convert glob pattern to regex.
+     */
+    private patternToRegex;
+    /**
+     * Extract keywords from task for matching.
+     */
+    private extractKeywords;
+    /**
+     * Add or update a capability mapping.
+     */
+    addMapping(mapping: CapabilityMapping): void;
+    /**
+     * Get all registered mappings.
+     */
+    getMappings(): CapabilityMapping[];
+}
+export declare function getCapabilityRouter(): CapabilityRouter;
+export declare function setCapabilityRouter(router: CapabilityRouter): void;
+//# sourceMappingURL=capability-router.d.ts.map

package/dist/coordination/capability-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-router.d.ts","sourceRoot":"","sources":["../../src/coordination/capability-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,eAAe,GACf,SAAS,GACT,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAAiB,EAwG1D,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,eAAe,EAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,mBAAmB,EAAE,eAAe,EAAE,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,cAAc,CAAC,EAAE,iBAAiB,EAAE;IAIhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa;IAqF9D;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,kBAAkB,EAAE,EACrC,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,UAAU,GAAG,IAAI;IA0CpB;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAgB3D;;OAEG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA+BlD;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAS5C;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;CAGnC;AAOD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAElE"}