@pellux/goodvibes-tui 0.18.10 → 0.18.12

package/src/runtime/tasks/index.ts

@@ -1,68 +0,0 @@
-/**
- * Runtime Tasks — barrel exports and factory.
- *
- * Usage:
- * ```ts
- * import { createTaskManager } from './tasks/index.ts';
- *
- * const taskManager = createTaskManager(store, bus, sessionId);
- * const task = taskManager.createTask({ kind: 'exec', title: 'Run lint', owner: 'exec-tool' });
- * taskManager.startTask(task.id);
- * taskManager.completeTask(task.id);
- * ```
- */
-
-// ── Types ────────────────────────────────────────────────────────────────────
-export type {
-  TaskManager,
-  TaskCreateParams,
-  TaskUpdateParams,
-  TaskCancelParams,
-  TaskFailParams,
-} from '@pellux/goodvibes-sdk/platform/runtime/tasks/types';
-
-// ── Lifecycle ─────────────────────────────────────────────────────────────────
-export {
-  canTransition,
-  getValidTransitions,
-  isTerminalStatus,
-} from '@pellux/goodvibes-sdk/platform/runtime/tasks/lifecycle';
-
-// ── Registry ──────────────────────────────────────────────────────────────────
-export { TaskRegistry } from '@pellux/goodvibes-sdk/platform/runtime/tasks/registry';
-
-// ── Manager ───────────────────────────────────────────────────────────────────
-export {
-  UnifiedTaskManager,
-  TaskTransitionError,
-  TaskNotFoundError,
-  TaskNotCancellableError,
-} from '@pellux/goodvibes-sdk/platform/runtime/tasks/manager';
-
-// ── Factory ───────────────────────────────────────────────────────────────────
-import type { RuntimeStore } from '../store/index.ts';
-import type { RuntimeEventBus } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { TaskManager } from '@pellux/goodvibes-sdk/platform/runtime/tasks/types';
-import { UnifiedTaskManager } from '@pellux/goodvibes-sdk/platform/runtime/tasks/manager';
-
-/**
- * Creates a fully initialized UnifiedTaskManager bound to the given
- * Zustand store, RuntimeEventBus, and session identifier.
- *
- * @param store - The runtime Zustand store.
- * @param bus - The RuntimeEventBus for event emission.
- * @param sessionId - Current session identifier (used in emitter context).
- * @returns A TaskManager instance ready for use.
- *
- * @example
- * ```ts
- * const taskManager = createTaskManager(store, bus, sessionId);
- * ```
- */
-export function createTaskManager(
-  store: RuntimeStore,
-  bus: RuntimeEventBus,
-  sessionId: string
-): TaskManager {
-  return new UnifiedTaskManager(store, bus, sessionId);
-}

package/src/runtime/tasks/manager.ts

@@ -1,415 +0,0 @@
-/**
- * UnifiedTaskManager — central task lifecycle management for all subsystem
- * task kinds (exec, agent, acp, scheduler, daemon, mcp, plugin, integration).
- *
- * Responsibilities:
- * - Create tasks with type-safe params
- * - Enforce lifecycle state machine transitions
- * - Track parent/child relationships
- * - Emit TaskEvents via RuntimeEventBus at each transition
- * - Update RuntimeState.tasks domain via Zustand store
- * - Track per-kind concurrency
- * - Support retry policies
- */
-
-import { createDomainDispatch } from '../store/index.ts';
-import type { RuntimeStore, DomainDispatch } from '../store/index.ts';
-import type { RuntimeEventBus } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { RuntimeTask, TaskKind, TaskLifecycleState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks';
-import type { EmitterContext } from '@pellux/goodvibes-sdk/platform/runtime/emitters/index';
-import type {
-  TaskManager,
-  TaskCreateParams,
-  TaskUpdateParams,
-  TaskCancelParams,
-  TaskFailParams,
-} from '@pellux/goodvibes-sdk/platform/runtime/tasks/types';
-import { TaskRegistry } from '@pellux/goodvibes-sdk/platform/runtime/tasks/registry';
-import { canTransition } from '@pellux/goodvibes-sdk/platform/runtime/tasks/lifecycle';
-import {
-  emitTaskCreated,
-  emitTaskStarted,
-  emitTaskBlocked,
-  emitTaskCompleted,
-  emitTaskFailed,
-  emitTaskCancelled,
-} from '@pellux/goodvibes-sdk/platform/runtime/emitters/tasks';
-
-// ---------------------------------------------------------------------------
-// Error types
-// ---------------------------------------------------------------------------
-
-/** Thrown when a requested task lifecycle transition is not permitted. */
-export class TaskTransitionError extends Error {
-  public readonly taskId: string;
-  public readonly from: TaskLifecycleState;
-  public readonly to: TaskLifecycleState;
-
-  public constructor(
-    taskId: string,
-    from: TaskLifecycleState,
-    to: TaskLifecycleState
-  ) {
-    super(
-      `[TaskManager] Invalid transition ${from} → ${to} for task ${taskId}`
-    );
-    this.name = 'TaskTransitionError';
-    this.taskId = taskId;
-    this.from = from;
-    this.to = to;
-  }
-}
-
-/** Thrown when a task ID cannot be found in the registry. */
-export class TaskNotFoundError extends Error {
-  public readonly taskId: string;
-
-  public constructor(taskId: string) {
-    super(`[TaskManager] Task not found: ${taskId}`);
-    this.name = 'TaskNotFoundError';
-    this.taskId = taskId;
-  }
-}
-
-/** Thrown when cancellation is attempted on a non-cancellable task. */
-export class TaskNotCancellableError extends Error {
-  public readonly taskId: string;
-
-  public constructor(taskId: string) {
-    super(`[TaskManager] Task ${taskId} is not cancellable`);
-    this.name = 'TaskNotCancellableError';
-    this.taskId = taskId;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// UnifiedTaskManager
-// ---------------------------------------------------------------------------
-
-/**
- * UnifiedTaskManager — implements TaskManager using a TaskRegistry for
- * in-memory lookup and a Zustand store + RuntimeEventBus for persistence
- * and event emission.
- */
-export class UnifiedTaskManager implements TaskManager {
-  private readonly _registry = new TaskRegistry();
-  private readonly _store: RuntimeStore;
-  private readonly _dispatch: DomainDispatch;
-  private readonly _bus: RuntimeEventBus;
-  /** Session ID for emitter context. */
-  private readonly _sessionId: string;
-
-  /**
-   * @param store - The Zustand runtime store to dispatch state updates to.
-   * @param bus - The RuntimeEventBus to emit task lifecycle events on.
-   * @param sessionId - The current session identifier for emitter context.
-   */
-  public constructor(
-    store: RuntimeStore,
-    bus: RuntimeEventBus,
-    sessionId: string
-  ) {
-    this._store = store;
-    this._dispatch = createDomainDispatch(store);
-    this._bus = bus;
-    this._sessionId = sessionId;
-  }
-
-  // ── TaskManager interface ────────────────────────────────────────────────
-
-  public createTask(params: TaskCreateParams): RuntimeTask {
-    const now = Date.now();
-    const id = crypto.randomUUID();
-
-    const task: RuntimeTask = {
-      id,
-      kind: params.kind,
-      title: params.title,
-      description: params.description,
-      status: 'queued',
-      owner: params.owner,
-      cancellable: params.cancellable ?? true,
-      parentTaskId: params.parentTaskId,
-      childTaskIds: [],
-      queuedAt: now,
-      retryPolicy: params.retryPolicy,
-      correlationId: params.correlationId,
-      turnId: params.turnId,
-    };
-
-    // Register in local registry
-    this._registry.register(task);
-
-    // If this task has a parent, add to parent's childTaskIds
-    if (params.parentTaskId) {
-      this._patchChildIds(params.parentTaskId, id);
-    }
-
-    // Persist to store
-    this._dispatchCreated(task);
-
-    // Emit event
-    emitTaskCreated(this._bus, this._makeCtx(id), {
-      taskId: id,
-      description: params.title,
-      priority: 0,
-    });
-
-    return task;
-  }
-
-  public startTask(taskId: string): RuntimeTask {
-    const task = this._requireTask(taskId);
-    this._requireTransition(task, 'running');
-
-    const updated = this._applyTransition(task, 'running', {
-      startedAt: Date.now(),
-    });
-
-    emitTaskStarted(this._bus, this._makeCtx(taskId), { taskId });
-    return updated;
-  }
-
-  public blockTask(taskId: string, reason: string): RuntimeTask {
-    const task = this._requireTask(taskId);
-    this._requireTransition(task, 'blocked');
-
-    const updated = this._applyTransition(task, 'blocked', {});
-
-    emitTaskBlocked(this._bus, this._makeCtx(taskId), { taskId, reason });
-    return updated;
-  }
-
-  public completeTask(taskId: string, result?: unknown): RuntimeTask {
-    const task = this._requireTask(taskId);
-    this._requireTransition(task, 'completed');
-
-    const now = Date.now();
-    const durationMs = task.startedAt !== undefined ? now - task.startedAt : 0;
-
-    const updated = this._applyTransition(task, 'completed', {
-      endedAt: now,
-      result,
-    });
-
-    emitTaskCompleted(this._bus, this._makeCtx(taskId), { taskId, durationMs });
-    return updated;
-  }
-
-  public failTask(taskId: string, params: TaskFailParams): RuntimeTask {
-    const task = this._requireTask(taskId);
-    this._requireTransition(task, 'failed');
-
-    const now = Date.now();
-    const durationMs = task.startedAt !== undefined ? now - task.startedAt : 0;
-
-    // Check retry policy
-    if (task.retryPolicy) {
-      const { maxAttempts, currentAttempt, delayMs, backoff } = task.retryPolicy;
-      if (currentAttempt < maxAttempts) {
-        // Increment attempt and re-queue
-        const updatedPolicy = {
-          ...task.retryPolicy,
-          currentAttempt: currentAttempt + 1,
-        };
-        const resolvedDelay =
-          backoff === 'exponential'
-            ? delayMs * Math.pow(2, currentAttempt - 1)
-            : delayMs;
-
-        const requeued = this._applyTransition(task, 'queued', {
-          retryPolicy: updatedPolicy,
-          error: params.error,
-          exitCode: params.exitCode,
-          startedAt: undefined,
-          endedAt: undefined,
-          retryDelayMs: resolvedDelay,
-          retryAt: now + resolvedDelay,
-        });
-
-        // Emit failed event then re-queue semantically
-        emitTaskFailed(this._bus, this._makeCtx(taskId), {
-          taskId,
-          error: `${params.error} (retry ${currentAttempt}/${maxAttempts} in ${resolvedDelay}ms)`,
-          durationMs,
-        });
-
-        return requeued;
-      }
-    }
-
-    // No retry — mark as permanently failed
-    const updated = this._applyTransition(task, 'failed', {
-      endedAt: now,
-      error: params.error,
-      exitCode: params.exitCode,
-    });
-
-    emitTaskFailed(this._bus, this._makeCtx(taskId), {
-      taskId,
-      error: params.error,
-      durationMs,
-    });
-
-    return updated;
-  }
-
-  public cancelTask(taskId: string, params?: TaskCancelParams): RuntimeTask {
-    const task = this._requireTask(taskId);
-
-    if (!task.cancellable) {
-      throw new TaskNotCancellableError(taskId);
-    }
-
-    this._requireTransition(task, 'cancelled');
-
-    const now = Date.now();
-    const updated = this._applyTransition(task, 'cancelled', {
-      endedAt: now,
-    });
-
-    emitTaskCancelled(this._bus, this._makeCtx(taskId), {
-      taskId,
-      reason: params?.reason,
-    });
-
-    return updated;
-  }
-
-  public updateTask(taskId: string, params: TaskUpdateParams): RuntimeTask {
-    const task = this._requireTask(taskId);
-
-    const updated: RuntimeTask = {
-      ...task,
-      ...(params.title !== undefined ? { title: params.title } : {}),
-      ...(params.description !== undefined ? { description: params.description } : {}),
-      ...(params.exitCode !== undefined ? { exitCode: params.exitCode } : {}),
-      ...(params.result !== undefined ? { result: params.result } : {}),
-    };
-
-    this._registry.register(updated);
-    this._syncTaskToStore(updated);
-    return updated;
-  }
-
-  public getTask(taskId: string): RuntimeTask | undefined {
-    return this._registry.get(taskId);
-  }
-
-  public getTasksByKind(kind: TaskKind): RuntimeTask[] {
-    return this._registry.getByKind(kind);
-  }
-
-  public getRunningTasks(): RuntimeTask[] {
-    return this._registry.getRunning();
-  }
-
-  public getRunningCount(kind: TaskKind): number {
-    return this._registry.getByKind(kind).filter((t) => t.status === 'running').length;
-  }
-
-  public getChildTasks(parentTaskId: string): RuntimeTask[] {
-    return this._registry.getChildren(parentTaskId);
-  }
-
-  public getTaskStatus(taskId: string): TaskLifecycleState | undefined {
-    return this._registry.get(taskId)?.status;
-  }
-
-  public retryTask(taskId: string): RuntimeTask {
-    const task = this._requireTask(taskId);
-
-    if (task.status !== 'failed' && task.status !== 'cancelled') {
-      throw new TaskTransitionError(task.id, task.status, 'queued');
-    }
-
-    return this._applyTransition(task, 'queued', {
-      startedAt: undefined,
-      endedAt: undefined,
-      error: undefined,
-      exitCode: undefined,
-      retryAt: undefined,
-      retryDelayMs: undefined,
-      queuedAt: Date.now(),
-    });
-  }
-
-  // ── Private helpers ─────────────────────────────────────────────────────
-
-  /**
-   * Returns a task or throws TaskNotFoundError.
-   */
-  private _requireTask(taskId: string): RuntimeTask {
-    const task = this._registry.get(taskId);
-    if (!task) {
-      throw new TaskNotFoundError(taskId);
-    }
-    return task;
-  }
-
-  /**
-   * Validates a transition is permitted; throws TaskTransitionError otherwise.
-   */
-  private _requireTransition(
-    task: RuntimeTask,
-    to: TaskLifecycleState
-  ): void {
-    if (!canTransition(task.status, to)) {
-      throw new TaskTransitionError(task.id, task.status, to);
-    }
-  }
-
-  /**
-   * Applies a state transition to a task, updates registry and store.
-   */
-  private _applyTransition(
-    task: RuntimeTask,
-    to: TaskLifecycleState,
-    patch: Partial<RuntimeTask>
-  ): RuntimeTask {
-    const updated: RuntimeTask = { ...task, status: to, ...patch };
-    this._registry.register(updated);
-    this._syncTaskToStore(updated);
-    return updated;
-  }
-
-  /**
-   * Adds a child task ID to a parent task's childTaskIds array.
-   */
-  private _patchChildIds(parentId: string, childId: string): void {
-    const parent = this._registry.get(parentId);
-    if (!parent) return;
-    const updated: RuntimeTask = {
-      ...parent,
-      childTaskIds: [...parent.childTaskIds, childId],
-    };
-    this._registry.register(updated);
-    this._syncTaskToStore(updated);
-  }
-
-  /**
-   * Constructs a minimal EmitterContext for a given task.
-   */
-  private _makeCtx(taskId: string): EmitterContext {
-    return {
-      sessionId: this._sessionId,
-      source: 'task-manager',
-      traceId: crypto.randomUUID(),
-      taskId,
-    };
-  }
-
-  /**
-   * Dispatches TASK_CREATED state update to the Zustand store.
-   */
-  private _dispatchCreated(task: RuntimeTask): void {
-    this._dispatch.syncRuntimeTask(task, 'task-manager');
-  }
-
-  /**
-   * Syncs an updated task to the Zustand store, adjusting status index arrays.
-   */
-  private _syncTaskToStore(task: RuntimeTask): void {
-    this._dispatch.syncRuntimeTask(task, 'task-manager');
-  }
-}