@miller-tech/uap 1.0.0

package/dist/tasks/coordination.js

@@ -0,0 +1,291 @@
+import { getCapabilityRouter } from '../coordination/capability-router.js';
+import { getPatternRouter } from '../coordination/pattern-router.js';
+import { getAdaptivePatternEngine } from '../coordination/adaptive-patterns.js';
+/**
+ * Coordinates task operations with the agent coordination system.
+ * Handles claiming/releasing tasks, overlap detection, and multi-agent awareness.
+ */
+export class TaskCoordinator {
+    taskService;
+    coordService;
+    agentId;
+    worktreeBranch;
+    constructor(config) {
+        this.taskService = config.taskService;
+        this.coordService = config.coordinationService;
+        this.agentId = config.agentId;
+        this.worktreeBranch = config.worktreeBranch;
+    }
+    /**
+     * Claim a task for this agent.
+     * - Assigns the task to this agent
+     * - Creates worktree branch if needed
+     * - Announces work to coordination system
+     * - Detects overlaps with other agents
+     */
+    async claim(taskId, worktreeBranch) {
+        const task = this.taskService.getWithRelations(taskId);
+        if (!task) {
+            return null;
+        }
+        // Check if already assigned to another agent
+        if (task.assignee && task.assignee !== this.agentId) {
+            throw new Error(`Task already assigned to agent: ${task.assignee}`);
+        }
+        // Check if task is blocked
+        if (task.isBlocked) {
+            throw new Error(`Task is blocked by: ${task.blockedBy.join(', ')}`);
+        }
+        const branch = worktreeBranch || this.worktreeBranch || `feature/task-${taskId}`;
+        // Update task
+        this.taskService.update(taskId, {
+            status: 'in_progress',
+            assignee: this.agentId,
+            worktreeBranch: branch,
+        });
+        // Determine files/resources affected by this task
+        const resource = this.taskToResource(task);
+        // Announce work
+        const { announcement, overlaps, suggestions } = this.coordService.announceWork(this.agentId, resource, 'editing', {
+            description: `Working on task: ${task.title}`,
+            estimatedMinutes: this.estimateMinutes(task),
+        });
+        // Get updated task
+        const updatedTask = this.taskService.getWithRelations(taskId);
+        // Route task through CapabilityRouter to suggest best droid/skill
+        let routing;
+        try {
+            const capRouter = getCapabilityRouter();
+            const routingResult = capRouter.routeTask(updatedTask);
+            if (routingResult.recommendedDroids.length > 0) {
+                routing = {
+                    suggestedDroid: routingResult.recommendedDroids[0],
+                    capabilities: routingResult.matchedCapabilities,
+                    confidence: routingResult.confidence,
+                };
+            }
+        }
+        catch {
+            // CapabilityRouter not configured -- skip
+        }
+        // Match applicable patterns via PatternRouter
+        let patterns;
+        try {
+            const patternRouter = getPatternRouter();
+            const matched = patternRouter.matchPatterns(updatedTask.title);
+            const checklist = patternRouter.getEnforcementChecklist(updatedTask.title);
+            if (matched.length > 0 || checklist.length > 0) {
+                patterns = {
+                    matched: matched.map((p) => `${p.id}: ${p.title}`),
+                    enforcementChecklist: checklist.map((p) => `${p.id}: ${p.title}`),
+                };
+            }
+        }
+        catch {
+            // PatternRouter not configured -- skip
+        }
+        return {
+            task: updatedTask,
+            announcement,
+            overlaps,
+            suggestions,
+            worktreeBranch: branch,
+            routing,
+            patterns,
+        };
+    }
+    /**
+     * Release a task (mark complete, announce completion).
+     */
+    async release(taskId, reason) {
+        const task = this.taskService.get(taskId);
+        if (!task) {
+            return null;
+        }
+        // Close the task
+        const closedTask = this.taskService.close(taskId, reason);
+        if (!closedTask) {
+            return null;
+        }
+        // Complete work announcement
+        const resource = this.taskToResource(task);
+        this.coordService.completeWork(this.agentId, resource);
+        // Broadcast task completion
+        this.coordService.broadcast(this.agentId, 'coordination', {
+            action: 'task_completed',
+            resource: taskId,
+            data: {
+                title: task.title,
+                reason,
+            },
+        });
+        // Record pattern outcomes in AdaptivePatternEngine for learning
+        try {
+            const engine = getAdaptivePatternEngine();
+            const patternRouter = getPatternRouter();
+            const matched = patternRouter.matchPatterns(task.title);
+            const isSuccess = closedTask.status === 'done';
+            const category = task.labels[0] || task.type;
+            for (const pattern of matched) {
+                engine.recordPatternOutcome(String(pattern.id), isSuccess, category);
+            }
+        }
+        catch {
+            // AdaptivePatternEngine not configured -- skip
+        }
+        return {
+            task: closedTask,
+            completedAnnouncements: 1,
+        };
+    }
+    /**
+     * Check for overlaps before working on a task.
+     */
+    checkOverlaps(taskId) {
+        const task = this.taskService.get(taskId);
+        if (!task) {
+            return [];
+        }
+        const resource = this.taskToResource(task);
+        return this.coordService.detectOverlaps(resource, this.agentId);
+    }
+    /**
+     * Find tasks that other agents are working on in the same area.
+     */
+    findRelatedActiveWork(taskId) {
+        const task = this.taskService.get(taskId);
+        if (!task) {
+            return [];
+        }
+        const activeWork = this.coordService.getActiveWork();
+        const results = [];
+        for (const work of activeWork) {
+            if (work.agentId === this.agentId)
+                continue;
+            // Check if this work overlaps with our task
+            const overlaps = this.coordService.detectOverlaps(this.taskToResource(task));
+            for (const overlap of overlaps) {
+                if (overlap.agents.some((a) => a.id === work.agentId)) {
+                    // Find the task this agent is working on
+                    const agentTasks = this.taskService.list({
+                        assignee: work.agentId,
+                        status: 'in_progress',
+                    });
+                    for (const agentTask of agentTasks) {
+                        results.push({
+                            task: agentTask,
+                            agent: work.agentName || work.agentId,
+                            overlap,
+                        });
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Suggest optimal task assignment based on current work distribution.
+     */
+    suggestNextTask() {
+        const readyTasks = this.taskService.ready();
+        if (readyTasks.length === 0) {
+            return null;
+        }
+        // Get currently active work to avoid conflicts
+        const activeWork = this.coordService.getActiveWork();
+        const activeResources = new Set(activeWork.map((w) => w.resource));
+        // Score each task
+        const scored = readyTasks.map((task) => {
+            let score = 0;
+            // Priority score (P0 = 40, P4 = 0)
+            score += (4 - task.priority) * 10;
+            // Prefer tasks without overlaps
+            const resource = this.taskToResource(task);
+            if (!activeResources.has(resource)) {
+                score += 20;
+            }
+            // Prefer tasks with no dependencies (simpler)
+            if (task.blockedBy.length === 0) {
+                score += 5;
+            }
+            // Prefer tasks that unblock others
+            if (task.blocks.length > 0) {
+                score += task.blocks.length * 3;
+            }
+            return { task, score };
+        });
+        // Sort by score descending
+        scored.sort((a, b) => b.score - a.score);
+        return scored[0]?.task || null;
+    }
+    /**
+     * Get merge order suggestions for tasks with overlapping work.
+     */
+    getMergeOrderSuggestion(taskIds) {
+        const tasks = taskIds
+            .map((id) => this.taskService.get(id))
+            .filter((t) => t !== null);
+        if (tasks.length === 0) {
+            return [];
+        }
+        // Order by: P0 first, then by type (bugs before features), then by creation date
+        const typeOrder = {
+            bug: 0,
+            task: 1,
+            chore: 2,
+            feature: 3,
+            story: 4,
+            epic: 5,
+        };
+        tasks.sort((a, b) => {
+            // Priority first
+            if (a.priority !== b.priority) {
+                return a.priority - b.priority;
+            }
+            // Then type
+            const aTypeOrder = typeOrder[a.type] ?? 10;
+            const bTypeOrder = typeOrder[b.type] ?? 10;
+            if (aTypeOrder !== bTypeOrder) {
+                return aTypeOrder - bTypeOrder;
+            }
+            // Then creation date
+            return a.createdAt.localeCompare(b.createdAt);
+        });
+        return tasks.map((t) => t.id);
+    }
+    /**
+     * Convert a task to a resource identifier for the coordination system.
+     */
+    taskToResource(task) {
+        // Use labels to infer affected area, or fall back to task type
+        if (task.labels.length > 0) {
+            return `task:${task.labels[0]}/${task.id}`;
+        }
+        return `task:${task.type}/${task.id}`;
+    }
+    /**
+     * Estimate time to complete a task based on type and complexity.
+     */
+    estimateMinutes(task) {
+        // Base estimate by type
+        const baseMinutes = {
+            bug: 30,
+            task: 60,
+            chore: 45,
+            feature: 120,
+            story: 180,
+            epic: 480,
+        };
+        let estimate = baseMinutes[task.type] || 60;
+        // Adjust by priority (P0 often needs more focus)
+        if (task.priority === 0) {
+            estimate *= 1.5;
+        }
+        // Adjust if it has children (epic/story)
+        if ('children' in task && task.children.length > 0) {
+            estimate += task.children.length * 30;
+        }
+        return Math.round(estimate);
+    }
+}
+//# sourceMappingURL=coordination.js.map

package/dist/tasks/coordination.js.map

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

package/dist/tasks/database.d.ts

@@ -0,0 +1,19 @@
+import Database from 'better-sqlite3';
+export declare class TaskDatabase {
+    private db;
+    private static instance;
+    private constructor();
+    static getInstance(dbPath: string): TaskDatabase;
+    static resetInstance(): void;
+    getDatabase(): Database.Database;
+    private initSchema;
+    /**
+     * Run schema migrations for existing databases.
+     * Each migration is idempotent (checks before altering).
+     */
+    private migrate;
+    close(): void;
+}
+export declare function getDefaultTaskDbPath(): string;
+export declare function getDefaultTaskJSONLPath(): string;
+//# sourceMappingURL=database.d.ts.map

package/dist/tasks/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/tasks/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,OAAO;IAeP,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAOhD,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC,OAAO,CAAC,UAAU;IAqFlB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAmBf,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/tasks/database.js

@@ -0,0 +1,149 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+export class TaskDatabase {
+    db;
+    static instance = null;
+    constructor(dbPath) {
+        const dir = dirname(dbPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        // Enable WAL mode for concurrent multi-agent read/write performance
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('busy_timeout = 10000');
+        this.initSchema();
+        this.migrate();
+    }
+    static getInstance(dbPath) {
+        if (!TaskDatabase.instance) {
+            TaskDatabase.instance = new TaskDatabase(dbPath);
+        }
+        return TaskDatabase.instance;
+    }
+    static resetInstance() {
+        if (TaskDatabase.instance) {
+            TaskDatabase.instance.close();
+            TaskDatabase.instance = null;
+        }
+    }
+    getDatabase() {
+        return this.db;
+    }
+    initSchema() {
+        this.db.exec(`
+      -- Tasks (core)
+      CREATE TABLE IF NOT EXISTS tasks (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL,
+        description TEXT,
+        type TEXT NOT NULL CHECK(type IN ('task', 'bug', 'feature', 'epic', 'chore', 'story')) DEFAULT 'task',
+        status TEXT NOT NULL CHECK(status IN ('open', 'in_progress', 'blocked', 'done', 'wont_do')) DEFAULT 'open',
+        priority INTEGER NOT NULL CHECK(priority BETWEEN 0 AND 4) DEFAULT 2,
+        assignee TEXT,
+        worktree_branch TEXT,
+        labels TEXT,
+        notes TEXT,
+        parent_id TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        due_date TEXT,
+        closed_at TEXT,
+        closed_reason TEXT,
+        FOREIGN KEY (parent_id) REFERENCES tasks(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+      CREATE INDEX IF NOT EXISTS idx_tasks_type ON tasks(type);
+      CREATE INDEX IF NOT EXISTS idx_tasks_priority ON tasks(priority);
+      CREATE INDEX IF NOT EXISTS idx_tasks_assignee ON tasks(assignee);
+      CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_due_date ON tasks(due_date);
+
+      -- Dependencies (DAG edges)
+      CREATE TABLE IF NOT EXISTS task_dependencies (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_task TEXT NOT NULL,
+        to_task TEXT NOT NULL,
+        dep_type TEXT NOT NULL CHECK(dep_type IN ('blocks', 'related', 'discovered_from')),
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (from_task) REFERENCES tasks(id),
+        FOREIGN KEY (to_task) REFERENCES tasks(id),
+        UNIQUE(from_task, to_task)
+      );
+      CREATE INDEX IF NOT EXISTS idx_deps_from ON task_dependencies(from_task);
+      CREATE INDEX IF NOT EXISTS idx_deps_to ON task_dependencies(to_task);
+      CREATE INDEX IF NOT EXISTS idx_deps_type ON task_dependencies(dep_type);
+
+      -- Task history (audit trail)
+      CREATE TABLE IF NOT EXISTS task_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_id TEXT NOT NULL,
+        field TEXT NOT NULL,
+        old_value TEXT,
+        new_value TEXT,
+        changed_by TEXT,
+        changed_at TEXT NOT NULL,
+        FOREIGN KEY (task_id) REFERENCES tasks(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_history_task ON task_history(task_id);
+      CREATE INDEX IF NOT EXISTS idx_history_time ON task_history(changed_at);
+
+      -- Task activity (for coordination integration)
+      CREATE TABLE IF NOT EXISTS task_activity (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        activity TEXT NOT NULL CHECK(activity IN ('claimed', 'released', 'commented', 'updated', 'created', 'closed')),
+        details TEXT,
+        timestamp TEXT NOT NULL,
+        FOREIGN KEY (task_id) REFERENCES tasks(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_activity_task ON task_activity(task_id);
+      CREATE INDEX IF NOT EXISTS idx_activity_agent ON task_activity(agent_id);
+
+      -- Compacted summaries (memory decay)
+      CREATE TABLE IF NOT EXISTS task_summaries (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        original_ids TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        labels TEXT,
+        closed_period TEXT,
+        created_at TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_summaries_period ON task_summaries(closed_period);
+
+    `);
+    }
+    /**
+     * Run schema migrations for existing databases.
+     * Each migration is idempotent (checks before altering).
+     */
+    migrate() {
+        const columns = this.db.pragma('table_info(tasks)');
+        const columnNames = new Set(columns.map((c) => c.name));
+        // v4.9.0: Add due_date column to tasks
+        if (!columnNames.has('due_date')) {
+            this.db.exec('ALTER TABLE tasks ADD COLUMN due_date TEXT');
+            this.db.exec('CREATE INDEX IF NOT EXISTS idx_tasks_due_date ON tasks(due_date)');
+        }
+        // v9.4.0: Add closed_at and closed_reason if missing (older DBs)
+        if (!columnNames.has('closed_at')) {
+            this.db.exec('ALTER TABLE tasks ADD COLUMN closed_at TEXT');
+        }
+        if (!columnNames.has('closed_reason')) {
+            this.db.exec('ALTER TABLE tasks ADD COLUMN closed_reason TEXT');
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+export function getDefaultTaskDbPath() {
+    return './.uap/tasks/tasks.db';
+}
+export function getDefaultTaskJSONLPath() {
+    return './.uap/tasks/tasks.jsonl';
+}
+//# sourceMappingURL=database.js.map

package/dist/tasks/database.js.map

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

package/dist/tasks/decoder-gate.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Decoder-First Gate for UAP Protocol Compliance
+ *
+ * Implements the Decoder-First validation gate (Compliance Deviation #2).
+ * Before any droid/agent executes a task, this gate validates:
+ * 1. Droid metadata schema is valid
+ * 2. Required tools are available
+ * 3. Coordination claims don't conflict
+ * 4. Task instruction passes ambiguity threshold
+ *
+ * This is an explicit pre-execution validator that replaces the
+ * implicit validation previously done via memory checks.
+ */
+export interface DroidMeta {
+    name: string;
+    description: string;
+    model?: string;
+    coordination?: {
+        channels?: string[];
+        claims?: string[];
+    };
+    tools?: string[];
+}
+export interface TaskContext {
+    agentId: string;
+    taskInstruction: string;
+    worktreePath?: string;
+    projectRoot?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    ambiguityCheck?: {
+        score: number;
+        level: string;
+        shouldAsk: boolean;
+        questions: string[];
+    };
+}
+export interface ValidationError {
+    gate: string;
+    message: string;
+    severity: 'error' | 'fatal';
+}
+export interface ValidationWarning {
+    gate: string;
+    message: string;
+    suggestion: string;
+}
+/**
+ * Validate all decoder-first gates before droid execution.
+ * Returns a ValidationResult indicating whether execution should proceed.
+ */
+export declare function validateDecoderFirst(droidName: string, taskContext: TaskContext, options?: {
+    projectRoot?: string;
+    requireWorktree?: boolean;
+    ambiguityThreshold?: number;
+}): Promise<ValidationResult>;
+declare const _default: {
+    validateDecoderFirst: typeof validateDecoderFirst;
+};
+export default _default;
+//# sourceMappingURL=decoder-gate.d.ts.map

package/dist/tasks/decoder-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-gate.d.ts","sourceRoot":"","sources":["../../src/tasks/decoder-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACxB,GACL,OAAO,CAAC,gBAAgB,CAAC,CA8E3B;;;;AAmND,wBAEE"}