macro-agent 0.2.5 → 0.2.6

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

@@ -0,0 +1,155 @@
+/**
+ * SudocodeTaskBackend Implementation
+ *
+ * Implements TaskBackend using EventStore for local task storage and
+ * SudocodeClient for external issue data and dependency tracking.
+ *
+ * @module task/backend/sudocode/backend
+ * @see s-8472 Pluggable Task Backend Integration with Sudocode
+ * @see i-2gwa 7A.5: Implement SudocodeTaskBackend core
+ */
+import type { EventStore } from "../../../store/event-store.js";
+import type { AgentId, TaskId, AgentHistoryEntry } from "../../../store/types/index.js";
+import type { TaskBackend, ExtendedTask, CreateTaskOptions, UpdateTaskOptions, TaskFilter, TaskOutputs, TaskError, SubtaskStatus, AssignOptions, TaskChangeCallback, Unsubscribe } from "../types.js";
+import type { SudocodeClient } from "./client.js";
+import type { SyncPolicy, SyncEventCallback } from "./sync-policy.js";
+/**
+ * Error thrown by SudocodeTaskBackend operations
+ */
+export declare class SudocodeTaskBackendError extends Error {
+    readonly code: string;
+    readonly taskId?: TaskId | undefined;
+    constructor(message: string, code: string, taskId?: TaskId | undefined);
+}
+/**
+ * SudocodeTaskBackend Configuration
+ */
+export interface SudocodeTaskBackendConfig {
+    /** Path to sudocode project root */
+    projectPath?: string;
+    /** Whether to sync task status with issue status */
+    syncStatus?: boolean;
+    /** Whether to auto-close issues when tasks complete */
+    autoCloseIssues?: boolean;
+    /** Sync policy configuration */
+    syncPolicy?: Partial<SyncPolicy>;
+}
+/**
+ * SudocodeTaskBackend implements TaskBackend using:
+ * - EventStore for local task storage and events
+ * - SudocodeClient for issue data and dependency tracking
+ *
+ * Key features:
+ * - Tasks can be bound to sudocode issues via external_id
+ * - isBlocked computed from sudocode's issue blockers
+ * - listReady uses sudocode's ready issues API
+ * - Status changes can optionally sync to issues
+ */
+export declare class SudocodeTaskBackend implements TaskBackend {
+    private readonly eventStore;
+    private readonly client;
+    private readonly config;
+    private readonly tasksByIssue;
+    private readonly issueByTask;
+    private readonly syncEngine;
+    private issueChangeUnsubscribe?;
+    constructor(eventStore: EventStore, client: SudocodeClient, config?: SudocodeTaskBackendConfig);
+    /**
+     * Rebuild the task-by-issue index from existing tasks
+     */
+    private rebuildIndex;
+    /**
+     * Add a task to the issue index
+     */
+    private addToIndex;
+    /**
+     * Remove a task from the issue index
+     */
+    private removeFromIndex;
+    /**
+     * Get tasks bound to an issue
+     */
+    getTasksByIssue(issueId: string): TaskId[];
+    /**
+     * Get the issue a task is bound to
+     */
+    getIssueForTask(taskId: TaskId): string | undefined;
+    /**
+     * Bind a task to a sudocode issue.
+     * @param taskId Task ID to bind
+     * @param issueId Issue ID to bind to
+     * @throws If task or issue not found
+     */
+    bindToIssue(taskId: TaskId, issueId: string): Promise<void>;
+    /**
+     * Unbind a task from its current issue.
+     * @param taskId Task ID to unbind
+     * @throws If task not found
+     */
+    unbindFromIssue(taskId: TaskId): Promise<void>;
+    /**
+     * Subscribe to sudocode issue changes for status sync
+     */
+    private subscribeToIssueChanges;
+    create(options: CreateTaskOptions): Promise<ExtendedTask>;
+    get(id: TaskId): Promise<ExtendedTask | null>;
+    update(id: TaskId, updates: UpdateTaskOptions): Promise<ExtendedTask>;
+    delete(_id: TaskId): Promise<void>;
+    assign(id: TaskId, agentId: AgentId, options?: AssignOptions): Promise<void>;
+    unassign(id: TaskId): Promise<void>;
+    start(id: TaskId): Promise<void>;
+    complete(id: TaskId, outputs?: TaskOutputs): Promise<void>;
+    fail(id: TaskId, error: TaskError): Promise<void>;
+    list(filter?: TaskFilter): Promise<ExtendedTask[]>;
+    listReady(filter?: TaskFilter): Promise<ExtendedTask[]>;
+    getChildren(parentId: TaskId): Promise<ExtendedTask[]>;
+    getSubtaskStatus(parentId: TaskId): Promise<SubtaskStatus>;
+    createSubtask(parentId: TaskId, options: CreateTaskOptions): Promise<ExtendedTask>;
+    addBlocker(taskId: TaskId, blockerId: TaskId): Promise<void>;
+    removeBlocker(taskId: TaskId, blockerId: TaskId): Promise<void>;
+    getBlockers(taskId: TaskId): Promise<ExtendedTask[]>;
+    getBlocking(taskId: TaskId): Promise<ExtendedTask[]>;
+    getAgentHistory(taskId: TaskId): Promise<AgentHistoryEntry[]>;
+    onTaskChange(callback: TaskChangeCallback): Unsubscribe;
+    onTaskChange(taskId: TaskId, callback: TaskChangeCallback): Unsubscribe;
+    /**
+     * Get the current sync policy
+     */
+    getSyncPolicy(): SyncPolicy;
+    /**
+     * Subscribe to sync events from the policy engine
+     */
+    onSyncEvent(callback: SyncEventCallback): Unsubscribe;
+    /**
+     * Close the backend and release resources
+     */
+    close(): void;
+    /**
+     * Get the external_id from a task (if stored in outputs)
+     */
+    private getTaskExternalId;
+    /**
+     * Convert a Task to ExtendedTask with computed isBlocked field.
+     * Checks both local blockers and sudocode issue blockers.
+     *
+     * For sudocode issue blockers, a blocker is considered resolved if:
+     * 1. The issue itself is closed/completed, OR
+     * 2. Any local task bound to that issue is completed (local takes precedence)
+     */
+    private toExtendedTask;
+    /**
+     * Synchronous version of toExtendedTask that only checks local blockers.
+     * Used in callbacks where async is not possible.
+     * Note: Does not check sudocode issue blockers - only local task blockers.
+     */
+    private toExtendedTaskSync;
+}
+/**
+ * Create a SudocodeTaskBackend instance.
+ *
+ * @param eventStore - EventStore for local task storage
+ * @param client - SudocodeClient for issue access
+ * @param config - Optional configuration
+ */
+export declare function createSudocodeTaskBackend(eventStore: EventStore, client: SudocodeClient, config?: SudocodeTaskBackendConfig): SudocodeTaskBackend;
+//# sourceMappingURL=backend.d.ts.map

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

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