@h-rig/core 0.0.6-alpha.9 → 0.0.6-alpha.91

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;

package/dist/src/taskGraphLayout.d.ts

@@ -0,0 +1,60 @@
+import type { EngineReadModel, TaskSummary } from "@rig/contracts";
+export type TaskGraphLane = Readonly<{
+    key: string;
+    label: string;
+    rowIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: string;
+    taskCount: number;
+}>;
+export type TaskGraphStage = Readonly<{
+    index: number;
+    label: string;
+    x: number;
+    width: number;
+}>;
+export type TaskGraphNode = Readonly<{
+    id: string;
+    task: TaskSummary;
+    rowKey: string;
+    rowLabel: string;
+    rowIndex: number;
+    stage: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: string;
+    taskCode: string | null;
+    strippedTitle: string;
+    depsIn: number;
+    depsOut: number;
+    runCount: number;
+    hasApprovals: boolean;
+    hasPendingUserInput: boolean;
+    hasRejectedReview: boolean;
+    hasFailedValidations: boolean;
+    artifactCount: number;
+}>;
+export type TaskGraphEdge = Readonly<{
+    id: string;
+    sourceId: string;
+    targetId: string;
+    color: string;
+    kind: "blocking" | "parent-child";
+}>;
+export type TaskGraphLayout = Readonly<{
+    lanes: readonly TaskGraphLane[];
+    stages: readonly TaskGraphStage[];
+    nodes: readonly TaskGraphNode[];
+    edges: readonly TaskGraphEdge[];
+    totalWidth: number;
+    totalHeight: number;
+    taskCount: number;
+}>;
+export declare function buildTaskGraphLayout(snapshot: EngineReadModel | null, tasks: readonly TaskSummary[], options?: {
+    showParentChild?: boolean;
+}): TaskGraphLayout;

package/dist/src/taskGraphLayout.js

@@ -39,14 +39,33 @@ function stripTaskCode(label) {
 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 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 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))

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@h-rig/core",
-  "version": "0.0.6-alpha.9",
+  "version": "0.0.6-alpha.91",
   "type": "module",
-  "description": "Rig package",
+  "description": "Config and plugin composition library for Rig's OMP extension ecosystem; not a product host/runtime.",
   "license": "UNLICENSED",
   "files": [
     "dist",
@@ -10,19 +10,12 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     },
     "./load-config": {
+      "types": "./dist/src/load-config.d.ts",
       "import": "./dist/src/load-config.js"
-    },
-    "./engineReadModelReducer": {
-      "import": "./dist/src/engineReadModelReducer.js"
-    },
-    "./rigSelectors": {
-      "import": "./dist/src/rigSelectors.js"
-    },
-    "./taskGraph": {
-      "import": "./dist/src/taskGraph.js"
     }
   },
   "engines": {
@@ -30,8 +23,9 @@
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.9",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.91",
     "effect": "4.0.0-beta.78"
   }
 }