macro-agent 0.2.4 → 0.2.6

package/dist/task/backend/sudocode/sync-policy.js

@@ -0,0 +1,221 @@
+/**
+ * Sync Policy Engine for Sudocode Integration
+ *
+ * Handles bidirectional sync between tasks and issues based on configurable policies.
+ *
+ * @module task/backend/sudocode/sync-policy
+ * @see s-8472 Pluggable Task Backend Integration with Sudocode
+ * @see i-1udw 7B.3: Implement sync policy engine
+ */
+/**
+ * Default sync policy
+ */
+export const defaultSyncPolicy = {
+    onIssueClosed: "notify_only",
+    onDescriptionChanged: "snapshot",
+    onBlockerChanged: "update_blocked",
+    updateIssueOnStart: true,
+    updateIssueOnComplete: "never",
+};
+// =============================================================================
+// Sync Policy Engine
+// =============================================================================
+/**
+ * SyncPolicyEngine handles bidirectional sync between tasks and issues
+ * based on configurable policies.
+ */
+export class SyncPolicyEngine {
+    policy;
+    backend;
+    callbacks = [];
+    constructor(policy, backend) {
+        this.policy = policy;
+        this.backend = backend;
+    }
+    /**
+     * Subscribe to sync events
+     */
+    onSyncEvent(callback) {
+        this.callbacks.push(callback);
+        return () => {
+            const idx = this.callbacks.indexOf(callback);
+            if (idx >= 0)
+                this.callbacks.splice(idx, 1);
+        };
+    }
+    /**
+     * Emit a sync event to all subscribers
+     */
+    emit(event) {
+        for (const callback of this.callbacks) {
+            try {
+                callback(event);
+            }
+            catch {
+                // Ignore callback errors
+            }
+        }
+    }
+    /**
+     * Handle an issue change event
+     */
+    async handleIssueChange(event) {
+        const boundTasks = this.backend.getTasksByIssue(event.issueId);
+        if (boundTasks.length === 0)
+            return;
+        switch (event.type) {
+            case "deleted":
+                await this.handleIssueDeleted(boundTasks, event);
+                break;
+            case "status_changed":
+                if (event.issue?.status === "closed") {
+                    await this.handleIssueClosed(boundTasks, event);
+                }
+                break;
+            case "blocked":
+                await this.handleBlockerAdded(boundTasks, event);
+                break;
+            case "unblocked":
+                await this.handleBlockerRemoved(boundTasks, event);
+                break;
+            case "updated":
+                await this.handleIssueUpdated(boundTasks, event);
+                break;
+        }
+    }
+    /**
+     * Handle issue closed
+     */
+    async handleIssueClosed(taskIds, event) {
+        for (const taskId of taskIds) {
+            const task = await this.backend.get(taskId);
+            if (!task || task.status === "completed" || task.status === "failed") {
+                continue;
+            }
+            switch (this.policy.onIssueClosed) {
+                case "complete_task":
+                    await this.backend.complete(taskId, {
+                        summary: "Issue closed externally",
+                    });
+                    break;
+                case "fail_task":
+                    await this.backend.fail(taskId, {
+                        code: "ISSUE_CLOSED",
+                        message: "Bound issue was closed externally",
+                    });
+                    break;
+                case "notify_only":
+                    this.emit({
+                        type: "issue_closed",
+                        taskId,
+                        issueId: event.issueId,
+                    });
+                    break;
+            }
+        }
+    }
+    /**
+     * Handle issue deleted - always fails orphaned tasks
+     */
+    async handleIssueDeleted(taskIds, event) {
+        for (const taskId of taskIds) {
+            const task = await this.backend.get(taskId);
+            if (!task || task.status === "completed" || task.status === "failed") {
+                continue;
+            }
+            await this.backend.fail(taskId, {
+                code: "ISSUE_DELETED",
+                message: `Bound issue ${event.issueId} was deleted`,
+            });
+            this.emit({
+                type: "issue_deleted",
+                taskId,
+                issueId: event.issueId,
+            });
+        }
+    }
+    /**
+     * Handle blocker added to issue
+     */
+    async handleBlockerAdded(taskIds, event) {
+        if (this.policy.onBlockerChanged === "update_blocked") {
+            // isBlocked will be recomputed on next get()
+            // Emit notification for bound tasks
+            for (const taskId of taskIds) {
+                this.emit({
+                    type: "blocker_added",
+                    taskId,
+                    issueId: event.issueId,
+                });
+            }
+        }
+        else {
+            // notify_only - just emit events
+            for (const taskId of taskIds) {
+                this.emit({
+                    type: "blocker_added",
+                    taskId,
+                    issueId: event.issueId,
+                });
+            }
+        }
+    }
+    /**
+     * Handle blocker removed from issue
+     */
+    async handleBlockerRemoved(taskIds, event) {
+        // Emit notification for bound tasks
+        for (const taskId of taskIds) {
+            this.emit({
+                type: "blocker_removed",
+                taskId,
+                issueId: event.issueId,
+            });
+        }
+    }
+    /**
+     * Handle issue updated (e.g., description changed)
+     */
+    async handleIssueUpdated(taskIds, event) {
+        // Check if description changed
+        const oldDescription = event.previousIssue?.content;
+        const newDescription = event.issue?.content;
+        if (oldDescription !== newDescription && newDescription !== undefined) {
+            if (this.policy.onDescriptionChanged === "propagate") {
+                // Update task descriptions
+                for (const taskId of taskIds) {
+                    await this.backend.update(taskId, {
+                        description: newDescription,
+                    });
+                }
+            }
+            // Always emit event for tracking
+            for (const taskId of taskIds) {
+                this.emit({
+                    type: "description_changed",
+                    taskId,
+                    issueId: event.issueId,
+                    oldDescription,
+                    newDescription,
+                });
+            }
+        }
+    }
+    /**
+     * Get the current sync policy
+     */
+    getPolicy() {
+        return { ...this.policy };
+    }
+}
+/**
+ * Create a sync policy engine
+ */
+export function createSyncPolicyEngine(policy, backend) {
+    const fullPolicy = {
+        ...defaultSyncPolicy,
+        ...policy,
+    };
+    return new SyncPolicyEngine(fullPolicy, backend);
+}
+//# sourceMappingURL=sync-policy.js.map

package/dist/task/backend/sudocode/sync-policy.js.map

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

package/dist/task/backend/sudocode/tools.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Sudocode Task Tool Provider
+ *
+ * Provides MCP tools for task operations using SudocodeTaskBackend.
+ * Supports native sudocode tools, mapped task tools, or both.
+ *
+ * @module task/backend/sudocode/tools
+ * @see s-8472 Pluggable Task Backend Integration with Sudocode
+ * @see i-185b 7B.4: Implement SudocodeTaskToolProvider
+ */
+import type { AgentId } from "../../../store/types/index.js";
+import type { TaskToolProvider, MCPToolDefinition } from "../types.js";
+import type { SudocodeTaskBackend } from "./backend.js";
+import type { SudocodeClient } from "./client.js";
+/**
+ * Tool mode for SudocodeTaskToolProvider
+ *
+ * - `native`: Expose sudocode's native issue tools (default)
+ * - `mapped`: Expose generic task tools that map to backend operations
+ * - `both`: Expose both native and mapped tools
+ */
+export type TaskToolMode = "native" | "mapped" | "both";
+/**
+ * Context needed for tool execution
+ */
+export interface SudocodeToolContext {
+    /** The agent making the tool call */
+    agent_id: AgentId;
+}
+/**
+ * Factory function type for getting context
+ */
+export type GetSudocodeToolContext = () => SudocodeToolContext;
+/**
+ * Configuration for SudocodeTaskToolProvider
+ */
+export interface SudocodeTaskToolProviderConfig {
+    /** Tool mode (default: 'native') */
+    mode?: TaskToolMode;
+}
+/**
+ * SudocodeTaskToolProvider
+ *
+ * Provides MCP tools for sudocode-backed task operations.
+ * Supports multiple modes:
+ * - `native`: Exposes sudocode's native issue tools (upsert_issue, show_issue, etc.)
+ * - `mapped`: Exposes generic task tools that map to backend operations
+ * - `both`: Exposes all tools from both modes
+ */
+export declare class SudocodeTaskToolProvider implements TaskToolProvider {
+    private readonly backend;
+    private readonly client;
+    private readonly getContext;
+    private readonly mode;
+    constructor(backend: SudocodeTaskBackend, client: SudocodeClient, getContext: GetSudocodeToolContext, config?: SudocodeTaskToolProviderConfig);
+    /**
+     * Get the MCP tools based on the configured mode
+     */
+    getTools(): MCPToolDefinition[];
+    /**
+     * Get tools that should be excluded when this provider is active
+     */
+    getExcludedTools(): string[];
+    private getNativeTools;
+    private upsertIssueTool;
+    private showIssueTool;
+    private listIssuesTool;
+    private readyTool;
+    private linkTool;
+    private addFeedbackTool;
+    private getMappedTools;
+    private createTaskTool;
+    private getTaskTool;
+    private listTasksTool;
+    private listReadyTasksTool;
+    private getTaskBlockersTool;
+    private updateTaskStatusTool;
+    private addBlockerTool;
+    private removeBlockerTool;
+    private assignTaskTool;
+    private completeTaskTool;
+}
+/**
+ * Create a SudocodeTaskToolProvider
+ */
+export declare function createSudocodeTaskToolProvider(backend: SudocodeTaskBackend, client: SudocodeClient, getContext: GetSudocodeToolContext, config?: SudocodeTaskToolProviderConfig): SudocodeTaskToolProvider;
+//# sourceMappingURL=tools.d.ts.map

package/dist/task/backend/sudocode/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/task/backend/sudocode/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAMrE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,oCAAoC;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAgCD;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAI7D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAGjB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,sBAAsB,EACnD,MAAM,CAAC,EAAE,8BAA8B;IAKzC;;OAEG;IACH,QAAQ,IAAI,iBAAiB,EAAE;IAU/B;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAgB5B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IA2EvB,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,cAAc;IAkDtB,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,QAAQ;IAuDhB,OAAO,CAAC,eAAe;IAkEvB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,aAAa;IAgErB,OAAO,CAAC,kBAAkB;IA4C1B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,gBAAgB;CAyCzB;AAMD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,sBAAsB,EAClC,MAAM,CAAC,EAAE,8BAA8B,GACtC,wBAAwB,CAE1B"}