anantham-v2 2.0.0-alpha.1

package/dist/domain/task.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+/**
+ * Durable Task lifecycle status.
+ * PRD Part 1 Section 100, PRD Part 2 Section 34.
+ */
+export const TaskStatusSchema = z.enum([
+    "queued",
+    "available",
+    "claimed",
+    "running",
+    "waiting_approval",
+    "waiting_resource",
+    "blocked",
+    "paused",
+    "review",
+    "verifying",
+    "completed",
+    "failed",
+    "cancelled",
+]);
+/**
+ * Task priority classification.
+ * PRD Part 1 Section 102.
+ */
+export const TaskPrioritySchema = z.enum([
+    "critical",
+    "high",
+    "normal",
+    "low",
+]);
+/**
+ * Durable Task contract.
+ * PRD Part 1 Section 100 (PRD-TASK-001).
+ */
+export const TaskSchema = z.object({
+    id: z.string().min(1),
+    projectId: z.string().min(1),
+    sessionId: z.string().min(1),
+    parentId: z.string().optional(),
+    objective: z.string().min(1),
+    status: TaskStatusSchema,
+    priority: TaskPrioritySchema,
+    agentRole: z.string().optional(),
+    modelProfile: z.string().optional(),
+    keyPoolProfile: z.string().optional(),
+    permissionProfile: z.string().optional(),
+    dependencies: z.array(z.string()),
+    inputArtifacts: z.array(z.string()),
+    outputArtifacts: z.array(z.string()),
+    checkpointId: z.string().optional(),
+    readSet: z.array(z.string()).optional(),
+    writeSet: z.array(z.string()).optional(),
+    createdAt: z.string().min(1),
+    updatedAt: z.string().min(1),
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * Allowed valid task state transitions.
+ * PRD Part 1 Section 101, PRD Part 2 Section 34.
+ */
+const VALID_TRANSITIONS = {
+    queued: ["available", "claimed", "cancelled", "blocked"],
+    available: ["claimed", "queued", "cancelled", "blocked"],
+    claimed: ["running", "queued", "available", "blocked", "cancelled", "completed", "failed"],
+    running: [
+        "waiting_approval",
+        "waiting_resource",
+        "blocked",
+        "paused",
+        "review",
+        "verifying",
+        "completed",
+        "failed",
+        "cancelled",
+        "queued",
+    ],
+    waiting_approval: ["running", "blocked", "cancelled", "failed"],
+    waiting_resource: ["running", "queued", "blocked", "cancelled", "failed"],
+    blocked: ["queued", "available", "claimed", "running", "cancelled"],
+    paused: ["running", "cancelled"],
+    review: ["verifying", "completed", "failed", "running"],
+    verifying: ["completed", "failed", "running"],
+    completed: [], // Terminal
+    failed: ["queued", "available"], // Recoverable retry creates explicit transition
+    cancelled: [], // Terminal
+};
+/**
+ * Validates whether a state transition from `currentStatus` to `nextStatus` is allowed.
+ */
+export function isValidTaskTransition(currentStatus, nextStatus) {
+    if (currentStatus === nextStatus)
+        return true;
+    const allowed = VALID_TRANSITIONS[currentStatus];
+    return allowed ? allowed.includes(nextStatus) : false;
+}
+/**
+ * Asserts that a state transition is valid, throwing an error if invalid.
+ */
+export function assertValidTaskTransition(currentStatus, nextStatus) {
+    if (!isValidTaskTransition(currentStatus, nextStatus)) {
+        throw new Error(`Invalid task state transition from '${currentStatus}' to '${nextStatus}'. ` +
+            `Allowed transitions: [${(VALID_TRANSITIONS[currentStatus] || []).join(", ")}]`);
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/domain/task.js.map

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