@ryanfw/prompt-orchestration-pipeline 0.6.0 → 0.8.0

package/src/ui/client/time-store.js

@@ -0,0 +1,161 @@
+/**
+ * Global time store for efficient timer updates
+ * Provides a single source of truth for time-based updates with dynamic cadence
+ */
+
+// Internal state
+const offset = Date.now() - performance.now();
+let currentNow = Math.floor(performance.now() + offset);
+const listeners = new Set();
+const cadenceHints = new Map();
+let timerId = null;
+let activeIntervalMs = 1000;
+let isBackground = false;
+
+/**
+ * Subscribe to time updates
+ * @param {Function} listener - Callback function called on each tick
+ * @returns {Function} Unsubscribe function
+ */
+function subscribe(listener) {
+  listeners.add(listener);
+
+  // If this is the first listener, start the timer
+  if (listeners.size === 1) {
+    startTimer();
+  }
+
+  // Return unsubscribe function
+  return () => {
+    listeners.delete(listener);
+
+    // If no more listeners, stop the timer
+    if (listeners.size === 0) {
+      stopTimer();
+    }
+  };
+}
+
+/**
+ * Get current time snapshot
+ * @returns {number} Current timestamp in milliseconds
+ */
+function getSnapshot() {
+  return currentNow;
+}
+
+/**
+ * Get server-side snapshot for SSR safety
+ * @returns {number} Current timestamp in milliseconds
+ */
+function getServerSnapshot() {
+  return Date.now();
+}
+
+/**
+ * Add cadence hint for timer frequency
+ * @param {string} id - Unique identifier for the hint
+ * @param {number} ms - Cadence in milliseconds
+ */
+function addCadenceHint(id, ms) {
+  cadenceHints.set(id, ms);
+  recalculateInterval();
+}
+
+/**
+ * Remove cadence hint
+ * @param {string} id - Unique identifier for the hint
+ */
+function removeCadenceHint(id) {
+  cadenceHints.delete(id);
+  recalculateInterval();
+}
+
+/**
+ * Recalculate the active interval based on current hints and visibility state
+ */
+function recalculateInterval() {
+  const minCadence = Math.min(...cadenceHints.values(), 1000);
+  const newIntervalMs = isBackground ? Math.max(minCadence, 60000) : minCadence;
+
+  if (newIntervalMs !== activeIntervalMs) {
+    activeIntervalMs = newIntervalMs;
+
+    // Restart timer if we have listeners
+    if (listeners.size > 0) {
+      stopTimer();
+      startTimer();
+    }
+  }
+}
+
+/**
+ * Start the timer interval with minute boundary alignment for >= 60s cadence
+ */
+function startTimer() {
+  if (timerId !== null) return;
+
+  const tick = () => {
+    currentNow = Math.floor(performance.now() + offset);
+
+    // Notify all listeners
+    listeners.forEach((listener) => {
+      try {
+        listener();
+      } catch (error) {
+        console.error("Error in time store listener:", error);
+      }
+    });
+  };
+
+  // Align to minute boundary for >= 60s cadence
+  if (activeIntervalMs >= 60000) {
+    const now = Date.now();
+    const nextMinuteBoundary = Math.ceil(now / 60000) * 60000;
+    const initialDelay = nextMinuteBoundary - now;
+
+    // Initial delay to align to minute boundary, then regular intervals
+    timerId = setTimeout(() => {
+      tick();
+      timerId = setInterval(tick, 60000);
+    }, initialDelay);
+  } else {
+    // Immediate start for sub-minute cadences
+    timerId = setInterval(tick, activeIntervalMs);
+  }
+}
+/**
+ * Stop the timer interval
+ */
+function stopTimer() {
+  if (timerId !== null) {
+    clearTimeout(timerId);
+    clearInterval(timerId);
+    timerId = null;
+  }
+}
+
+/**
+ * Handle visibility change events
+ */
+function handleVisibilityChange() {
+  const wasBackground = isBackground;
+  isBackground = document.visibilityState === "hidden";
+
+  if (wasBackground !== isBackground) {
+    recalculateInterval();
+  }
+}
+
+// Set up visibility change listener
+if (typeof document !== "undefined") {
+  document.addEventListener("visibilitychange", handleVisibilityChange);
+}
+
+export {
+  subscribe,
+  getSnapshot,
+  getServerSnapshot,
+  addCadenceHint,
+  removeCadenceHint,
+};

package/src/ui/config-bridge.js

@@ -2,6 +2,12 @@
  * Universal configuration bridge for UI helpers.
  * Works in both browser and Node environments.
  */
+import {
+  TaskState,
+  JobStatus,
+  JobLocation,
+  deriveJobStatusFromTasks,
+} from "../config/statuses.js";
 
 /**
  * Global constants and contracts for project data display system
@@ -18,19 +24,24 @@ export const Constants = {
    * Valid task states
    * @type {string[]}
    */
-  TASK_STATES: ["pending", "running", "done", "failed"],
+  TASK_STATES: Object.values(TaskState),
 
   /**
    * Valid job locations
    * @type {string[]}
    */
-  JOB_LOCATIONS: ["current", "complete"],
+  JOB_LOCATIONS: Object.values(JobLocation),
 
   /**
    * Status sort order (descending priority)
    * @type {string[]}
    */
-  STATUS_ORDER: ["running", "failed", "pending", "complete"],
+  STATUS_ORDER: [
+    JobStatus.RUNNING,
+    JobStatus.FAILED,
+    JobStatus.PENDING,
+    JobStatus.COMPLETE,
+  ],
 
   /**
    * File size limits for reading
@@ -104,27 +115,7 @@ export function getStatusPriority(status) {
  * @returns {string} Job status
  */
 export function determineJobStatus(tasks = {}) {
-  const taskEntries = Object.entries(tasks);
-
-  if (taskEntries.length === 0) {
-    return "pending";
-  }
-
-  const taskStates = taskEntries.map(([_, task]) => task.state);
-
-  if (taskStates.includes("failed")) {
-    return "failed";
-  }
-
-  if (taskStates.includes("running")) {
-    return "running";
-  }
-
-  if (taskStates.every((state) => state === "done")) {
-    return "complete";
-  }
-
-  return "pending";
+  return deriveJobStatusFromTasks(Object.values(tasks));
 }
 
 /**

package/src/ui/config-bridge.node.js

@@ -7,6 +7,12 @@
 import path from "node:path";
 import { promises as fs } from "node:fs";
 import { fileURLToPath } from "node:url";
+import {
+  TaskState,
+  JobStatus,
+  JobLocation,
+  deriveJobStatusFromTasks,
+} from "../config/statuses.js";
 
 /**
  * Global constants and contracts for project data display system
@@ -23,19 +29,24 @@ export const Constants = {
    * Valid task states
    * @type {string[]}
    */
-  TASK_STATES: ["pending", "running", "done", "failed"],
+  TASK_STATES: Object.values(TaskState),
 
   /**
    * Valid job locations
    * @type {string[]}
    */
-  JOB_LOCATIONS: ["current", "complete"],
+  JOB_LOCATIONS: Object.values(JobLocation),
 
   /**
    * Status sort order (descending priority)
    * @type {string[]}
    */
-  STATUS_ORDER: ["running", "failed", "pending", "complete"],
+  STATUS_ORDER: [
+    JobStatus.RUNNING,
+    JobStatus.FAILED,
+    JobStatus.PENDING,
+    JobStatus.COMPLETE,
+  ],
 
   /**
    * File size limits for reading
@@ -240,27 +251,7 @@ export function getStatusPriority(status) {
  * @returns {string} Job status
  */
 export function determineJobStatus(tasks = {}) {
-  const taskEntries = Object.entries(tasks);
-
-  if (taskEntries.length === 0) {
-    return "pending";
-  }
-
-  const taskStates = taskEntries.map(([_, task]) => task.state);
-
-  if (taskStates.includes("failed")) {
-    return "failed";
-  }
-
-  if (taskStates.includes("running")) {
-    return "running";
-  }
-
-  if (taskStates.every((state) => state === "done")) {
-    return "complete";
-  }
-
-  return "pending";
+  return deriveJobStatusFromTasks(Object.values(tasks));
 }
 
 // Export helper to resolve paths lazily for server use