@worca/ui 0.1.0-rc.1 → 0.1.0-rc.2

package/app/protocol.js

@@ -0,0 +1,93 @@
+/**
+ * Protocol definitions for worca-ui WebSocket communication.
+ */
+
+/** @typedef {'subscribe-run'|'unsubscribe-run'|'subscribe-log'|'unsubscribe-log'|'list-runs'|'get-agent-prompt'|'get-preferences'|'set-preferences'|'stop-run'|'resume-run'|'list-beads-issues'|'start-beads-issue'|'list-beads-counts'|'list-beads-refs'|'list-beads-unlinked'|'run-snapshot'|'run-update'|'runs-list'|'log-line'|'log-bulk'|'preferences'|'run-started'|'run-stopped'|'stage-restarted'|'beads-update'} MessageType */
+
+/** @type {MessageType[]} */
+export const MESSAGE_TYPES = [
+  'subscribe-run',
+  'unsubscribe-run',
+  'subscribe-log',
+  'unsubscribe-log',
+  'list-runs',
+  'get-agent-prompt',
+  'get-preferences',
+  'set-preferences',
+  'stop-run',
+  'resume-run',
+  'list-beads-issues',
+  'start-beads-issue',
+  'list-beads-by-run',
+  'list-beads-counts',
+  'list-beads-refs',
+  'list-beads-unlinked',
+  // Webhook inbox
+  'get-webhook-inbox',
+  'set-webhook-control',
+  'clear-webhook-inbox',
+  // Protocol handshake
+  'hello',
+  'hello-ack',
+  // Parallel pipelines
+  'list-pipelines',
+  'subscribe-pipeline',
+  'unsubscribe-pipeline',
+  'pipeline-status-changed',
+  'pipelines-list',
+  // Server → Client events
+  'run-snapshot',
+  'run-update',
+  'runs-list',
+  'log-line',
+  'log-bulk',
+  'preferences',
+  'run-started',
+  'run-stopped',
+  'stage-restarted',
+  'beads-update',
+  'webhook-inbox-event',
+  'webhook-control-changed',
+  'webhook-inbox-cleared',
+];
+
+export function nextId() {
+  const now = Date.now().toString(36);
+  const rand = Math.random().toString(36).slice(2, 8);
+  return `${now}-${rand}`;
+}
+
+export function makeRequest(type, payload, id = nextId()) {
+  return { id, type, payload };
+}
+
+export function makeOk(req, payload) {
+  return { id: req.id, ok: true, type: req.type, payload };
+}
+
+export function makeError(req, code, message, details) {
+  return {
+    id: req.id,
+    ok: false,
+    type: req.type,
+    error: { code, message, details },
+  };
+}
+
+export function isMessageType(value) {
+  return typeof value === 'string' && MESSAGE_TYPES.includes(value);
+}
+
+function isRecord(value) {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function isRequest(value) {
+  if (!isRecord(value)) return false;
+  return typeof value.id === 'string' && typeof value.type === 'string';
+}
+
+export function decodeRequest(json) {
+  if (!isRequest(json)) throw new Error('Invalid request envelope');
+  return json;
+}

package/app/utils/stage-order.js

@@ -0,0 +1,40 @@
+/**
+ * Canonical pipeline stage order — single source of truth for the UI.
+ * Mirrors stages.py STAGE_ORDER on the Python side.
+ */
+export const STAGE_ORDER = [
+  'preflight',
+  'plan',
+  'plan_review',
+  'coordinate',
+  'implement',
+  'test',
+  'review',
+  'pr',
+  'learn',
+];
+
+/** Stage order with orchestrator prepended (for log display). */
+export const STAGE_ORDER_WITH_ORCHESTRATOR = ['orchestrator', ...STAGE_ORDER];
+
+/**
+ * Sort stage entries by canonical order. Unknown stages sort to the end.
+ */
+export function sortByStageOrder(entries) {
+  return [...entries].sort(([a], [b]) => {
+    const ai = STAGE_ORDER.indexOf(a);
+    const bi = STAGE_ORDER.indexOf(b);
+    return (ai === -1 ? 999 : ai) - (bi === -1 ? 999 : bi);
+  });
+}
+
+/**
+ * Sort stage name strings by canonical order. Unknown stages sort to the end.
+ */
+export function sortStageNames(names) {
+  return [...names].sort((a, b) => {
+    const ai = STAGE_ORDER.indexOf(a);
+    const bi = STAGE_ORDER.indexOf(b);
+    return (ai === -1 ? 999 : ai) - (bi === -1 ? 999 : bi);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worca/ui",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.2",
   "description": "Pipeline monitoring UI for worca-cc",
   "license": "MIT",
   "author": "Sinisha Djukic",
@@ -31,6 +31,8 @@
     "app/main.bundle.js.map",
     "app/styles.css",
     "app/vendor/",
+    "app/protocol.js",
+    "app/utils/stage-order.js",
     "scripts/build-frontend.js"
   ],
   "engines": {