@shawnowen/comet-mcp 2.4.1 → 2.4.2

package/dist/task-thread-canonical.js

@@ -1,116 +0,0 @@
-/**
- * Canonical Task Thread Types & Status Rule Set — Phase A
- *
- * AUTHORITATIVE LOCATION (FR-004): This file is the single source of truth
- * for the Phase A canonical status vocabulary, conflict-resolution precedence,
- * and valid lifecycle transition rules for the Comet browser surface worktree.
- *
- * In Phase B this document MUST link to or be replaced by the canonical rule
- * from equa-taskthreads spec 003 (core API).
- *
- * Spec: specs/041-task-thread-sync/spec.md
- * Plan: specs/041-task-thread-sync/plan.md §Canonical Status Rule Set
- */
-/** Terminal statuses — once set by the lifecycle layer, cannot revert (FR-008) */
-export const TERMINAL_STATUSES = new Set(["Completed", "Aborted", "Archived"]);
-export function isTerminal(status) {
-    return TERMINAL_STATUSES.has(status);
-}
-// ─── State Machine — Valid Transitions (FR-017, FR-019) ──────────────────────
-/**
- * Maps each canonical status to the set of write actions the user may invoke
- * from that state. The extension renders exactly these buttons (FR-017).
- *
- * Action names match the payload `action` field for POST /api/task-threads/:id/transition.
- */
-export const VALID_TRANSITIONS = {
-    Dispatched: ["Start", "Abort"],
-    Running: ["Pause", "Mark Complete", "Abort"],
-    Paused: ["Resume", "Abort"],
-    Completed: ["Archive"],
-    Aborted: ["Archive"],
-    Archived: [], // terminal — no further transitions
-};
-// ─── Canonical Status Resolver (FR-002, FR-006–FR-009) ───────────────────────
-/**
- * Derives exactly one canonical status from the union of underlying layer states.
- *
- * Precedence (FR-006, FR-007):
- *   1. Lifecycle layer (highest authority — Lifecycle wins)
- *   2. Snapshot layer
- *   3. Session manifest layer
- *   4. Archive layer
- *   5. Alert log layer
- *   6. Unknown → Archived (safe display fallback)
- *
- * Terminal states (Completed, Aborted, Archived) are sticky once set by
- * the lifecycle layer (FR-008).
- */
-export function resolveCanonicalStatus(layers) {
-    // 1. Lifecycle layer — highest authority
-    if (layers.lifecycle !== null) {
-        switch (layers.lifecycle) {
-            case "started": return "Running";
-            case "dispatched": return "Dispatched";
-            case "paused": return "Paused";
-            case "completed": return "Completed"; // terminal — sticky
-            case "aborted": return "Aborted"; // terminal — sticky
-        }
-    }
-    // 2. Snapshot layer
-    if (layers.snapshot !== null) {
-        switch (layers.snapshot) {
-            case "success": return "Completed";
-            case "failed":
-            case "abandoned": return "Aborted";
-            case "in-progress": return "Running";
-        }
-    }
-    // 3. Session manifest layer
-    if (layers.sessionManifest !== null) {
-        switch (layers.sessionManifest) {
-            case "active":
-            case "disconnecting": return "Running";
-            case "orphaned": return "Aborted"; // agent dead, no explicit transition
-        }
-    }
-    // 4. Archive layer
-    if (layers.archive !== null) {
-        switch (layers.archive) {
-            case "archived":
-            case "saved": return "Archived";
-        }
-    }
-    // 5. Alert log layer
-    if (layers.alertLog !== null) {
-        if (layers.alertLog === "ORPHAN_DETECTED" || layers.alertLog === "ORPHAN_REAPED") {
-            return "Aborted";
-        }
-        // Other alert types — fallthrough to Archived as safe default
-    }
-    // 6. No layer has a record — safe display fallback
-    return "Archived";
-}
-// ─── Transition Validation (FR-019) ──────────────────────────────────────────
-export class InvalidTransitionError extends Error {
-    fromStatus;
-    action;
-    constructor(fromStatus, action) {
-        super(`Action "${action}" is not valid from status "${fromStatus}". ` +
-            `Valid actions: ${VALID_TRANSITIONS[fromStatus].join(", ") || "none"}.`);
-        this.fromStatus = fromStatus;
-        this.action = action;
-        this.name = "InvalidTransitionError";
-    }
-}
-/**
- * Throws InvalidTransitionError if the action is not valid from the given status.
- * Does NOT perform the transition — call this before executing any write.
- */
-export function assertValidTransition(status, action) {
-    const allowed = VALID_TRANSITIONS[status];
-    if (!allowed.includes(action)) {
-        throw new InvalidTransitionError(status, action);
-    }
-}
-//# sourceMappingURL=task-thread-canonical.js.map