@h-rig/core 0.0.6-alpha.10 → 0.0.6-alpha.103

package/dist/src/rigSelectors.d.ts

@@ -0,0 +1,220 @@
+import type { ArtifactSummary, ApprovalSummary, EngineReadModel, GraphSummary, QueueEntry, RemoteConnectionSummary, RemoteEndpoint, RunId, RunJournalProjection, RunStatus, RunSummary, TaskId, TaskStatus, TaskSummary, UserInputRequestSummary, WorkspaceId, WorkspaceSummary } from "@rig/contracts";
+import type { TaskDependencyProjection } from "./taskGraph";
+export declare function selectWorkspaces(snapshot: EngineReadModel | null): readonly WorkspaceSummary[];
+export declare function selectPrimaryWorkspace(snapshot: EngineReadModel | null): WorkspaceSummary | null;
+export declare function pickDefaultWorkspaceId(snapshot: EngineReadModel | null): WorkspaceId | null;
+export declare function selectWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): WorkspaceSummary | null;
+export declare function selectTask(snapshot: EngineReadModel | null, taskId: TaskId | null): TaskSummary | null;
+export declare function selectTasksByWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): TaskSummary[];
+export declare const selectTasksForWorkspace: typeof selectTasksByWorkspace;
+export declare function selectTasksByStatus(snapshot: EngineReadModel | null, status: TaskStatus): TaskSummary[];
+export type RigTaskSessionProjection = Pick<RunJournalProjection, "record" | "status" | "lastEventAt"> & {
+    readonly taskId?: string | null;
+};
+export interface RigTaskStatusGroupingInput<T extends TaskDependencyProjection = TaskDependencyProjection> {
+    readonly tasks: readonly T[];
+    readonly sessions?: readonly RigTaskSessionProjection[];
+    readonly workspaceId?: string | null;
+}
+export interface RigTaskStatusGroup<T extends TaskDependencyProjection = TaskDependencyProjection> {
+    readonly status: string;
+    readonly tasks: readonly T[];
+}
+export declare function projectTaskStatusForGrouping(status: string | null | undefined): string;
+export declare function projectRunStatusForTaskGrouping(status: RunStatus | null | undefined): string | null;
+export declare function projectTaskStatusWithSessions(task: TaskDependencyProjection, sessionsByTask?: ReadonlyMap<string, RigTaskSessionProjection>): string;
+export declare function selectTasksGroupedByStatus(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): Array<{
+    status: string;
+    tasks: readonly TaskSummary[];
+}>;
+export declare function selectTasksGroupedByStatus<T extends TaskDependencyProjection>(input: RigTaskStatusGroupingInput<T>): Array<RigTaskStatusGroup<T>>;
+export declare function normalizeTaskAssigneeFilter(assignee: string | null | undefined, currentUserLogin?: string | null): string | null;
+export declare function readTaskAssigneeLogins(task: TaskDependencyProjection): readonly string[];
+export declare function taskMatchesAssigneeFilter(task: TaskDependencyProjection, assignee: string | null | undefined, options?: {
+    readonly currentUserLogin?: string | null;
+}): boolean;
+export declare function selectTasksAssignedTo<T extends TaskDependencyProjection>(tasks: readonly T[], assignee: string | null | undefined, options?: {
+    readonly currentUserLogin?: string | null;
+}): T[];
+export declare function selectTasksAssignedToMe<T extends TaskDependencyProjection>(tasks: readonly T[], currentUserLogin: string | null | undefined): T[];
+export declare function selectRun(snapshot: EngineReadModel | null, runId: RunId | null): RunSummary | null;
+export declare function selectRunsByTask(snapshot: EngineReadModel | null, taskId: TaskId | null): RunSummary[];
+export declare const selectRunsForTask: typeof selectRunsByTask;
+export declare function selectRunsForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): RunSummary[];
+export declare function selectAdhocRuns(snapshot: EngineReadModel | null): RunSummary[];
+export declare function selectAdhocRunsForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): RunSummary[];
+export declare function selectGraphsForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): GraphSummary[];
+export declare function selectQueueForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): QueueEntry[];
+export declare function selectPendingApprovals(snapshot: EngineReadModel | null): ApprovalSummary[];
+export declare function selectApprovalsForRun(snapshot: EngineReadModel | null, runId: RunId | null): ApprovalSummary[];
+export declare function selectPendingApprovalsForRun(snapshot: EngineReadModel | null, runId: RunId | null): ApprovalSummary[];
+export declare function selectApprovalsForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): ApprovalSummary[];
+export declare function selectUserInputsForRun(snapshot: EngineReadModel | null, runId: RunId | null): UserInputRequestSummary[];
+export declare function selectPendingUserInputs(snapshot: EngineReadModel | null): UserInputRequestSummary[];
+export declare function selectPendingUserInputsForRun(snapshot: EngineReadModel | null, runId: RunId | null): UserInputRequestSummary[];
+export declare function selectUserInputsForWorkspace(snapshot: EngineReadModel | null, workspaceId: WorkspaceId | null): UserInputRequestSummary[];
+export declare function selectRuntimeForRun(snapshot: EngineReadModel | null, runId: RunId | null): {
+    readonly id: string & import("effect/Brand").Brand<"EngineRuntimeId">;
+    readonly updatedAt: string;
+    readonly status: "starting" | "running" | "interrupted" | "failed" | "prepared" | "exited" | "destroyed";
+    readonly startedAt: string | null;
+    readonly pid: number | null;
+    readonly stateDir: string | null;
+    readonly workspaceId: string & import("effect/Brand").Brand<"WorkspaceId">;
+    readonly workspaceDir: string | null;
+    readonly homeDir: string | null;
+    readonly tmpDir: string | null;
+    readonly cacheDir: string | null;
+    readonly logsDir: string | null;
+    readonly sessionDir: string | null;
+    readonly sessionLogPath: string | null;
+    readonly exitedAt: string | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly adapterKind: string;
+    readonly sandboxMode: "read-only" | "workspace-write" | "danger-full-access";
+    readonly isolationMode: "none" | "env" | "worktree";
+    readonly executionTarget?: "remote" | "local" | undefined;
+    readonly remoteHostId?: string | null | undefined;
+} | null;
+export declare function selectLatestRuntimeForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string & import("effect/Brand").Brand<"EngineRuntimeId">;
+    readonly updatedAt: string;
+    readonly status: "starting" | "running" | "interrupted" | "failed" | "prepared" | "exited" | "destroyed";
+    readonly startedAt: string | null;
+    readonly pid: number | null;
+    readonly stateDir: string | null;
+    readonly workspaceId: string & import("effect/Brand").Brand<"WorkspaceId">;
+    readonly workspaceDir: string | null;
+    readonly homeDir: string | null;
+    readonly tmpDir: string | null;
+    readonly cacheDir: string | null;
+    readonly logsDir: string | null;
+    readonly sessionDir: string | null;
+    readonly sessionLogPath: string | null;
+    readonly exitedAt: string | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly adapterKind: string;
+    readonly sandboxMode: "read-only" | "workspace-write" | "danger-full-access";
+    readonly isolationMode: "none" | "env" | "worktree";
+    readonly executionTarget?: "remote" | "local" | undefined;
+    readonly remoteHostId?: string | null | undefined;
+} | null;
+export declare function selectActionsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ActionId">;
+    readonly title: string;
+    readonly completedAt: string | null;
+    readonly payload: unknown;
+    readonly startedAt: string;
+    readonly state: string;
+    readonly messageId: (string & import("effect/Brand").Brand<"MessageId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly detail: string | null;
+    readonly actionType: string;
+}[];
+export declare function selectApprovalsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly status: "pending" | "resolved";
+    readonly payload: unknown;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly actionId: string | null;
+    readonly resolvedAt: string | null;
+    readonly requestKind: string;
+}[];
+export declare function selectUserInputsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly status: "pending" | "resolved";
+    readonly payload: unknown;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly resolvedAt: string | null;
+}[];
+export declare function selectValidationsForRun(snapshot: EngineReadModel | null, runId: RunId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ValidationResultId">;
+    readonly status: "running" | "pending" | "failed" | "passed" | "skipped";
+    readonly completedAt: string | null;
+    readonly startedAt: string;
+    readonly taskId: (string & import("effect/Brand").Brand<"TaskId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly validatorKey: string;
+    readonly output: unknown;
+}[];
+export declare function selectValidationsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ValidationResultId">;
+    readonly status: "running" | "pending" | "failed" | "passed" | "skipped";
+    readonly completedAt: string | null;
+    readonly startedAt: string;
+    readonly taskId: (string & import("effect/Brand").Brand<"TaskId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly validatorKey: string;
+    readonly output: unknown;
+}[];
+export declare function selectFailedValidations(snapshot: EngineReadModel | null, runId: RunId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ValidationResultId">;
+    readonly status: "running" | "pending" | "failed" | "passed" | "skipped";
+    readonly completedAt: string | null;
+    readonly startedAt: string;
+    readonly taskId: (string & import("effect/Brand").Brand<"TaskId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly validatorKey: string;
+    readonly output: unknown;
+}[];
+export declare function selectReviewsForRun(snapshot: EngineReadModel | null, runId: RunId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ReviewResultId">;
+    readonly createdAt: string;
+    readonly status: "running" | "error" | "rejected" | "pending" | "approved";
+    readonly completedAt: string | null;
+    readonly summary: string | null;
+    readonly provider: string;
+    readonly mode: "required" | "off" | "advisory";
+    readonly taskId: (string & import("effect/Brand").Brand<"TaskId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly output: unknown;
+}[];
+export declare function selectReviewsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string & import("effect/Brand").Brand<"ReviewResultId">;
+    readonly createdAt: string;
+    readonly status: "running" | "error" | "rejected" | "pending" | "approved";
+    readonly completedAt: string | null;
+    readonly summary: string | null;
+    readonly provider: string;
+    readonly mode: "required" | "off" | "advisory";
+    readonly taskId: (string & import("effect/Brand").Brand<"TaskId">) | null;
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly output: unknown;
+}[];
+export declare function selectArtifactsForRun(snapshot: EngineReadModel | null, runId: RunId | null): ArtifactSummary[];
+export declare function selectArtifactsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): ArtifactSummary[];
+export declare function selectPolicyDecisionsForTask(snapshot: EngineReadModel | null, taskId: TaskId | null): {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly decision: "allow" | "block" | "warn";
+    readonly mode: "off" | "enforce" | "observe";
+    readonly runId: string & import("effect/Brand").Brand<"RunId">;
+    readonly actionId: (string & import("effect/Brand").Brand<"ActionId">) | null;
+    readonly reason: string;
+    readonly matchedRules: readonly string[];
+}[];
+export declare function selectRemoteEndpoints(snapshot: EngineReadModel | null): readonly RemoteEndpoint[];
+export declare function selectRemoteConnections(snapshot: EngineReadModel | null): readonly RemoteConnectionSummary[];
+export declare function selectRemoteEndpoint(snapshot: EngineReadModel | null, endpointId: string | null): {
+    readonly id: string & import("effect/Brand").Brand<"RemoteEndpointId">;
+    readonly port: number;
+    readonly host: string;
+    readonly lastConnectedAt: string | null;
+    readonly alias: string;
+    readonly token: string;
+    readonly addedAt: string;
+    readonly tokenConfigured?: boolean | undefined;
+    readonly autoConnect?: boolean | undefined;
+} | null;
+export declare function selectRemoteConnection(snapshot: EngineReadModel | null, endpointId: string | null): {
+    readonly error: string | null;
+    readonly status: "error" | "disconnected" | "connecting" | "authenticating" | "connected" | "reconnecting";
+    readonly endpointId: string & import("effect/Brand").Brand<"RemoteEndpointId">;
+    readonly connectedAt: string | null;
+    readonly tokenExpiresAt: string | null;
+    readonly latencyMs: number | null;
+    readonly subscribedEvents: readonly string[];
+} | null;
+export declare function selectConnectedRemoteCount(snapshot: EngineReadModel | null): number;

package/dist/src/rigSelectors.js

@@ -39,10 +39,40 @@ function projectTaskStatusForGrouping(status) {
     case "in_progress":
     case "under_review":
       return "running";
+    case null:
+    case undefined:
+    case "":
+      return "unknown";
     default:
       return status;
   }
 }
+function projectRunStatusForTaskGrouping(status) {
+  switch (status) {
+    case "created":
+    case "queued":
+    case "preparing":
+      return "queued";
+    case "running":
+    case "waiting-approval":
+    case "waiting-user-input":
+    case "paused":
+    case "validating":
+    case "reviewing":
+    case "closing-out":
+      return "running";
+    case "needs-attention":
+      return "blocked";
+    case "failed":
+    case "stopped":
+      return "ready";
+    case "completed":
+      return "completed";
+    case null:
+    case undefined:
+      return null;
+  }
+}
 var STATUS_PRIORITY = [
   "running",
   "blocked",
@@ -54,11 +84,31 @@ var STATUS_PRIORITY = [
   "cancelled",
   "completed"
 ];
-function selectTasksGroupedByStatus(snapshot, workspaceId) {
-  const tasks = selectTasksByWorkspace(snapshot, workspaceId);
+function taskIdFromSession(session) {
+  return session.taskId ?? session.record.taskId ?? null;
+}
+function latestSessionByTask(sessions) {
+  const byTask = new Map;
+  for (const session of sessions) {
+    const taskId = taskIdFromSession(session);
+    if (!taskId)
+      continue;
+    const existing = byTask.get(taskId);
+    if (!existing || (session.lastEventAt ?? "").localeCompare(existing.lastEventAt ?? "") >= 0) {
+      byTask.set(taskId, session);
+    }
+  }
+  return byTask;
+}
+function projectTaskStatusWithSessions(task, sessionsByTask = new Map) {
+  const sessionStatus = projectRunStatusForTaskGrouping(sessionsByTask.get(task.id)?.status);
+  return sessionStatus ?? projectTaskStatusForGrouping(task.status);
+}
+function groupTasksByProjectedStatus(tasks, sessions = []) {
+  const sessionsByTask = latestSessionByTask(sessions);
   const byStatus = new Map;
   for (const task of tasks) {
-    const projectedStatus = projectTaskStatusForGrouping(task.status);
+    const projectedStatus = projectTaskStatusWithSessions(task, sessionsByTask);
     const group = byStatus.get(projectedStatus);
     if (group) {
       group.push(task);
@@ -82,6 +132,69 @@ function selectTasksGroupedByStatus(snapshot, workspaceId) {
   }
   return result;
 }
+function isProjectionGroupingInput(value) {
+  return Boolean(value && typeof value === "object" && !("snapshotSequence" in value) && Array.isArray(value.tasks));
+}
+function selectTasksGroupedByStatus(input, workspaceId) {
+  if (isProjectionGroupingInput(input)) {
+    const filteredTasks = input.workspaceId ? input.tasks.filter((task) => {
+      const workspaceTask = task;
+      return workspaceTask.workspaceId === input.workspaceId;
+    }) : input.tasks;
+    return groupTasksByProjectedStatus(filteredTasks, input.sessions);
+  }
+  const tasks = selectTasksByWorkspace(input, workspaceId ?? null);
+  return groupTasksByProjectedStatus(tasks, []);
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeLogin(value) {
+  return value.trim().replace(/^@+/, "").toLowerCase();
+}
+function assigneeLoginsFromValue(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.flatMap((entry) => {
+    if (typeof entry === "string" && entry.trim())
+      return [normalizeLogin(entry)];
+    if (isObjectRecord(entry) && typeof entry.login === "string" && entry.login.trim()) {
+      return [normalizeLogin(entry.login)];
+    }
+    return [];
+  });
+}
+function normalizeTaskAssigneeFilter(assignee, currentUserLogin) {
+  const trimmed = assignee?.trim();
+  if (!trimmed)
+    return null;
+  if (trimmed === "@me" || trimmed.toLowerCase() === "me") {
+    return currentUserLogin?.trim() ? normalizeLogin(currentUserLogin) : null;
+  }
+  return normalizeLogin(trimmed);
+}
+function readTaskAssigneeLogins(task) {
+  const taskRecord = task;
+  const metadata = isObjectRecord(task.metadata) ? task.metadata : null;
+  const raw = isObjectRecord(metadata?.raw) ? metadata.raw : null;
+  return Array.from(new Set([
+    ...assigneeLoginsFromValue(taskRecord.assignees),
+    ...assigneeLoginsFromValue(metadata?.assignees),
+    ...assigneeLoginsFromValue(raw?.assignees)
+  ]));
+}
+function taskMatchesAssigneeFilter(task, assignee, options = {}) {
+  const normalized = normalizeTaskAssigneeFilter(assignee, options.currentUserLogin);
+  if (!normalized)
+    return false;
+  return readTaskAssigneeLogins(task).includes(normalized);
+}
+function selectTasksAssignedTo(tasks, assignee, options = {}) {
+  return tasks.filter((task) => taskMatchesAssigneeFilter(task, assignee, options));
+}
+function selectTasksAssignedToMe(tasks, currentUserLogin) {
+  return selectTasksAssignedTo(tasks, "@me", currentUserLogin === undefined ? {} : { currentUserLogin });
+}
 function selectRun(snapshot, runId) {
   if (!runId)
     return null;
@@ -247,6 +360,7 @@ function selectConnectedRemoteCount(snapshot) {
   return selectRemoteConnections(snapshot).filter((connection) => connection.status === "connected").length;
 }
 export {
+  taskMatchesAssigneeFilter,
   selectWorkspaces,
   selectWorkspace,
   selectValidationsForTask,
@@ -258,6 +372,8 @@ export {
   selectTasksForWorkspace,
   selectTasksByWorkspace,
   selectTasksByStatus,
+  selectTasksAssignedToMe,
+  selectTasksAssignedTo,
   selectTask,
   selectRuntimeForRun,
   selectRunsForWorkspace,
@@ -289,5 +405,10 @@ export {
   selectAdhocRunsForWorkspace,
   selectAdhocRuns,
   selectActionsForTask,
-  pickDefaultWorkspaceId
+  readTaskAssigneeLogins,
+  projectTaskStatusWithSessions,
+  projectTaskStatusForGrouping,
+  projectRunStatusForTaskGrouping,
+  pickDefaultWorkspaceId,
+  normalizeTaskAssigneeFilter
 };

package/dist/src/taskGraph.d.ts

@@ -0,0 +1,41 @@
+import type { TaskSummary } from "@rig/contracts";
+export type TaskDependencyProjection = Pick<TaskSummary, "id" | "status" | "priority" | "metadata"> & Partial<Pick<TaskSummary, "externalId" | "sourceIssueId" | "dependencies" | "parentChildDeps" | "createdAt" | "updatedAt">> & {
+    readonly title?: string | null;
+};
+export type TaskDependencyBadgeKind = "blocked" | "ready" | "dependency";
+export interface TaskDependencyBadge {
+    readonly kind: TaskDependencyBadgeKind;
+    readonly label: string;
+    readonly description: string;
+    readonly count?: number;
+    readonly taskIds?: readonly string[];
+}
+export interface TaskDependencyBadgeSummary {
+    readonly taskId: string;
+    readonly blockingDepth: number;
+    readonly dependencyIds: readonly string[];
+    readonly unresolvedDependencyRefs: readonly string[];
+    readonly blockedBy: readonly string[];
+    readonly blocks: readonly string[];
+    readonly blocked: boolean;
+    readonly ready: boolean;
+    readonly dependencyCount: number;
+    readonly dependentCount: number;
+    readonly badges: readonly TaskDependencyBadge[];
+}
+export declare function readTaskMetadataStringList(task: TaskDependencyProjection, key: "dependencies" | "parentChildDeps" | "labels"): string[];
+export declare function readTaskDependencyRefs(task: TaskDependencyProjection): string[];
+export declare function readTaskSourceIssueId(task: TaskDependencyProjection): string | null;
+export declare function resolveTaskReference(ref: string, tasksById: ReadonlyMap<string, TaskDependencyProjection>, taskIdByExternalRef: ReadonlyMap<string, string>, taskIdBySourceIssueId: ReadonlyMap<string, string>): string | null;
+export declare function buildTaskReferenceIndex<T extends TaskDependencyProjection>(tasks: readonly T[]): {
+    readonly tasksById: Map<string, T>;
+    readonly taskIdByExternalRef: Map<string, string>;
+    readonly taskIdBySourceIssueId: Map<string, string>;
+};
+export declare function computeTaskBlockingDepths<T extends TaskDependencyProjection>(tasks: readonly T[]): Map<string, number>;
+export declare function isTaskTerminalStatus(status: string | null | undefined): boolean;
+export declare function computeTaskDependencyBadges(tasks: readonly TaskDependencyProjection[]): Map<string, TaskDependencyBadgeSummary>;
+export declare function selectNextReadyTaskByPriority<T extends TaskDependencyProjection>(tasks: readonly T[], options?: {
+    readonly excludeTaskIds?: Iterable<string>;
+    readonly filter?: (task: T) => boolean;
+}): T | null;

package/dist/src/taskGraph.js

@@ -3,14 +3,42 @@
 function isObjectRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function readStringList(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.length > 0) : [];
+}
+function unique(values) {
+  return Array.from(new Set(values));
+}
 function readTaskMetadataStringList(task, key) {
+  const taskRecord = task;
+  const topLevel = readStringList(taskRecord[key]);
+  if (topLevel.length > 0)
+    return topLevel;
   const metadata = isObjectRecord(task.metadata) ? task.metadata : null;
-  const value = metadata?.[key];
-  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.length > 0) : [];
+  const metadataList = readStringList(metadata?.[key]);
+  if (metadataList.length > 0)
+    return metadataList;
+  if (key === "dependencies") {
+    return readStringList(metadata?.deps);
+  }
+  return [];
+}
+function readTaskDependencyRefs(task) {
+  return unique([
+    ...readTaskMetadataStringList(task, "dependencies"),
+    ...readTaskMetadataStringList(task, "parentChildDeps")
+  ]);
 }
 function readTaskSourceIssueId(task) {
+  if (typeof task.sourceIssueId === "string" && task.sourceIssueId.length > 0) {
+    return task.sourceIssueId;
+  }
   const metadata = isObjectRecord(task.metadata) ? task.metadata : null;
-  return typeof metadata?.sourceIssueId === "string" && metadata.sourceIssueId.length > 0 ? metadata.sourceIssueId : null;
+  if (typeof metadata?.sourceIssueId === "string" && metadata.sourceIssueId.length > 0) {
+    return metadata.sourceIssueId;
+  }
+  const rigMetadata = isObjectRecord(metadata?._rig) ? metadata._rig : null;
+  return typeof rigMetadata?.sourceIssueId === "string" && rigMetadata.sourceIssueId.length > 0 ? rigMetadata.sourceIssueId : null;
 }
 function resolveTaskReference(ref, tasksById, taskIdByExternalRef, taskIdBySourceIssueId) {
   if (tasksById.has(ref))
@@ -40,11 +68,7 @@ function computeTaskBlockingDepths(tasks) {
     if (!task)
       return 0;
     stack.add(taskId);
-    const refs = [
-      ...readTaskMetadataStringList(task, "dependencies"),
-      ...readTaskMetadataStringList(task, "parentChildDeps")
-    ];
-    const blockers = refs.map((ref) => resolveTaskReference(ref, tasksById, taskIdByExternalRef, taskIdBySourceIssueId)).filter((ref) => ref !== null && ref !== taskId);
+    const blockers = readTaskDependencyRefs(task).map((ref) => resolveTaskReference(ref, tasksById, taskIdByExternalRef, taskIdBySourceIssueId)).filter((ref) => ref !== null && ref !== taskId);
     const depth = blockers.length === 0 ? 0 : Math.max(...blockers.map((blockerId) => visit(blockerId, stack) + 1));
     stack.delete(taskId);
     memo.set(taskId, depth);
@@ -55,10 +79,142 @@ function computeTaskBlockingDepths(tasks) {
   }
   return memo;
 }
+function isTaskTerminalStatus(status) {
+  switch (status) {
+    case "closed":
+    case "completed":
+    case "done":
+    case "cancelled":
+    case "canceled":
+      return true;
+    default:
+      return false;
+  }
+}
+function isTaskBlockedStatus(status) {
+  return status === "blocked";
+}
+function isTaskRunnableStatus(status) {
+  if (status === null || status === undefined || status === "")
+    return true;
+  if (isTaskTerminalStatus(status) || isTaskBlockedStatus(status))
+    return false;
+  switch (status) {
+    case "ready":
+    case "open":
+    case "failed":
+      return true;
+    default:
+      return false;
+  }
+}
+function priorityValue(task) {
+  return typeof task.priority === "number" && Number.isFinite(task.priority) ? task.priority : Number.MAX_SAFE_INTEGER;
+}
+function computeTaskDependencyBadges(tasks) {
+  const index = buildTaskReferenceIndex(tasks);
+  const blockingDepths = computeTaskBlockingDepths(tasks);
+  const dependencyIdsByTask = new Map;
+  const unresolvedRefsByTask = new Map;
+  const blocksByTask = new Map;
+  for (const task of tasks) {
+    const dependencyIds = [];
+    const unresolvedRefs = [];
+    for (const ref of readTaskDependencyRefs(task)) {
+      const dependencyId = resolveTaskReference(ref, index.tasksById, index.taskIdByExternalRef, index.taskIdBySourceIssueId);
+      if (dependencyId && dependencyId !== task.id) {
+        dependencyIds.push(dependencyId);
+        const blocks = blocksByTask.get(dependencyId);
+        if (blocks) {
+          blocks.push(task.id);
+        } else {
+          blocksByTask.set(dependencyId, [task.id]);
+        }
+      } else {
+        unresolvedRefs.push(ref);
+      }
+    }
+    dependencyIdsByTask.set(task.id, unique(dependencyIds));
+    unresolvedRefsByTask.set(task.id, unique(unresolvedRefs));
+  }
+  const summaries = new Map;
+  for (const task of tasks) {
+    const dependencyIds = dependencyIdsByTask.get(task.id) ?? [];
+    const unresolvedDependencyRefs = unresolvedRefsByTask.get(task.id) ?? [];
+    const blockedBy = dependencyIds.filter((dependencyId) => {
+      const dependency = index.tasksById.get(dependencyId);
+      return dependency ? !isTaskTerminalStatus(dependency.status) : false;
+    });
+    const blocks = unique(blocksByTask.get(task.id) ?? []);
+    const blocked = isTaskBlockedStatus(task.status) || blockedBy.length > 0;
+    const ready = isTaskRunnableStatus(task.status) && !blocked;
+    const badges = [];
+    if (blocked) {
+      badges.push({
+        kind: "blocked",
+        label: blockedBy.length > 0 ? `blocked \xD7${blockedBy.length}` : "blocked",
+        description: blockedBy.length > 0 ? `Waiting on ${blockedBy.join(", ")}.` : "Task source marks this task blocked.",
+        ...blockedBy.length > 0 ? { count: blockedBy.length } : {},
+        taskIds: blockedBy
+      });
+    } else if (ready) {
+      badges.push({
+        kind: "ready",
+        label: "ready",
+        description: "No open dependencies block this task."
+      });
+    }
+    if (dependencyIds.length > 0 || blocks.length > 0 || unresolvedDependencyRefs.length > 0) {
+      badges.push({
+        kind: "dependency",
+        label: `deps ${dependencyIds.length}/${blocks.length}`,
+        description: [
+          dependencyIds.length > 0 ? `Depends on ${dependencyIds.join(", ")}.` : null,
+          blocks.length > 0 ? `Blocks ${blocks.join(", ")}.` : null,
+          unresolvedDependencyRefs.length > 0 ? `Unresolved refs: ${unresolvedDependencyRefs.join(", ")}.` : null
+        ].filter((part) => part !== null).join(" "),
+        count: dependencyIds.length + blocks.length,
+        taskIds: unique([...dependencyIds, ...blocks])
+      });
+    }
+    summaries.set(task.id, {
+      taskId: task.id,
+      blockingDepth: blockingDepths.get(task.id) ?? 0,
+      dependencyIds,
+      unresolvedDependencyRefs,
+      blockedBy,
+      blocks,
+      blocked,
+      ready,
+      dependencyCount: dependencyIds.length,
+      dependentCount: blocks.length,
+      badges
+    });
+  }
+  return summaries;
+}
+function selectNextReadyTaskByPriority(tasks, options = {}) {
+  const excluded = new Set(options.excludeTaskIds ?? []);
+  const badges = computeTaskDependencyBadges(tasks);
+  const candidates = tasks.filter((task) => !excluded.has(task.id)).filter((task) => options.filter?.(task) ?? true).filter((task) => badges.get(task.id)?.ready === true).toSorted((left, right) => {
+    const priorityDelta = priorityValue(left) - priorityValue(right);
+    if (priorityDelta !== 0)
+      return priorityDelta;
+    const createdDelta = (left.createdAt ?? "").localeCompare(right.createdAt ?? "");
+    if (createdDelta !== 0)
+      return createdDelta;
+    return left.id.localeCompare(right.id);
+  });
+  return candidates[0] ?? null;
+}
 export {
+  selectNextReadyTaskByPriority,
   resolveTaskReference,
   readTaskSourceIssueId,
   readTaskMetadataStringList,
+  readTaskDependencyRefs,
+  isTaskTerminalStatus,
+  computeTaskDependencyBadges,
   computeTaskBlockingDepths,
   buildTaskReferenceIndex
 };

package/dist/src/taskGraphCodes.d.ts

@@ -0,0 +1,3 @@
+export declare function extractTaskCode(title: string): string | null;
+export declare function extractTaskGroupKey(title: string): string | null;
+export declare function stripTaskCode(label: string): string;