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

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.3",
   "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": {

package/server/index.js

@@ -31,6 +31,7 @@ function findProjectRoot(startDir) {
   return startDir; // fallback
 }
 
+import { checkWorcaVersion } from './version-check.js';
 import { createInbox } from './webhook-inbox.js';
 
 let projectRoot, worcaDir, settingsPath;
@@ -102,6 +103,18 @@ app.locals.broadcast = broadcast;
 app.locals.scheduleRefresh = scheduleRefresh;
 app.locals.resolveRunProject = resolveRunProject;
 
+// ─── worca-cc version check (non-blocking) ─────────────────────────────
+checkWorcaVersion().then((result) => {
+  app.locals.worcaVersion = result;
+  if (result.ok) {
+    console.log(`[version] ${result.message}`);
+  } else if (result.installed) {
+    console.warn(`[version] ${result.message}`);
+  } else {
+    console.log(`[version] ${result.message}`);
+  }
+});
+
 // ─── inotify budget check (Linux only) ─────────────────────────────────
 if (platform() === 'linux') {
   try {

package/server/version-check.js

@@ -0,0 +1,82 @@
+// server/version-check.js — worca-cc version compatibility check
+import { execFile } from 'node:child_process';
+
+/** Minimum worca-cc version required by this @worca/ui release. */
+export const MIN_WORCA_CC = '0.6.0';
+
+/**
+ * Parse the version string from `worca --version` output.
+ * Expected format: "worca-cc X.Y.Z" or "worca-cc X.Y.Zrc3"
+ * @param {string} output - stdout from `worca --version`
+ * @returns {string|null} version string or null if unparseable
+ */
+export function parseWorcaVersion(output) {
+  const match = output.trim().match(/^worca-cc\s+(\S+)/);
+  return match ? match[1] : null;
+}
+
+/**
+ * Compare two semver-ish versions, ignoring pre-release suffixes.
+ * "0.6.0rc3" satisfies ">= 0.6.0".
+ * @param {string} installed - installed version (e.g. "0.6.0rc3")
+ * @param {string} minimum - minimum required version (e.g. "0.6.0")
+ * @returns {boolean} true if installed >= minimum
+ */
+export function meetsMinimum(installed, minimum) {
+  const parse = (v) =>
+    v.split('.').map((s) => {
+      const n = parseInt(s, 10);
+      return Number.isNaN(n) ? 0 : n;
+    });
+  const inst = parse(installed);
+  const min = parse(minimum);
+  const len = Math.max(inst.length, min.length);
+  for (let i = 0; i < len; i++) {
+    const a = inst[i] || 0;
+    const b = min[i] || 0;
+    if (a > b) return true;
+    if (a < b) return false;
+  }
+  return true; // equal
+}
+
+/**
+ * Run `worca --version` and check compatibility.
+ * @returns {Promise<{ok: boolean, installed: string|null, minimum: string, message: string}>}
+ */
+export async function checkWorcaVersion() {
+  const minimum = MIN_WORCA_CC;
+  try {
+    const output = await new Promise((resolve, reject) => {
+      execFile('worca', ['--version'], { timeout: 5000 }, (err, stdout) => {
+        if (err) return reject(err);
+        resolve(stdout);
+      });
+    });
+    const installed = parseWorcaVersion(output);
+    if (!installed) {
+      return {
+        ok: false,
+        installed: null,
+        minimum,
+        message: `worca CLI not found — install with 'pip install worca-cc'`,
+      };
+    }
+    const ok = meetsMinimum(installed, minimum);
+    return {
+      ok,
+      installed,
+      minimum,
+      message: ok
+        ? `worca-cc ${installed} — compatible`
+        : `WARNING: worca-cc ${installed} found, minimum ${minimum} required — run 'pip install --upgrade worca-cc'`,
+    };
+  } catch {
+    return {
+      ok: false,
+      installed: null,
+      minimum,
+      message: `worca CLI not found — install with 'pip install worca-cc'`,
+    };
+  }
+}