@worca/ui 0.22.0 → 0.24.0

package/app/utils/state-actions.js

@@ -6,26 +6,47 @@ export const STATES = [
   'failed',
   'interrupted',
   'cancelled',
+  'halted',
+  'setup_failed',
+  'unrecoverable',
+  'planning',
+  'integration_testing',
+  'integration_failed',
+  'blocked',
 ];
 
 const ACTION_MATRIX = {
-  stop: { running: true },
-  pause: { running: true },
-  resume: { paused: true, failed: true, interrupted: true },
+  stop: { running: true, planning: true, integration_testing: true },
+  pause: { running: true, planning: true, integration_testing: true },
+  resume: {
+    paused: true,
+    failed: true,
+    interrupted: true,
+    halted: true,
+    integration_failed: true,
+    blocked: true,
+  },
   cancel: {
     pending: true,
     running: true,
     paused: true,
     failed: true,
     interrupted: true,
+    halted: true,
+    setup_failed: true,
+    integration_failed: true,
+    blocked: true,
   },
   archive: {
-    pending: true,
     paused: true,
     completed: true,
     failed: true,
     interrupted: true,
     cancelled: true,
+    halted: true,
+    setup_failed: true,
+    unrecoverable: true,
+    integration_failed: true,
   },
   unarchive: {
     completed: true,
@@ -40,6 +61,11 @@ const ACTION_MATRIX = {
     failed: true,
     interrupted: true,
     cancelled: true,
+    halted: true,
+    setup_failed: true,
+    unrecoverable: true,
+    integration_failed: true,
+    blocked: true,
   },
   learn: {
     paused: true,
@@ -47,6 +73,9 @@ const ACTION_MATRIX = {
     failed: true,
     interrupted: true,
     cancelled: true,
+    halted: true,
+    integration_failed: true,
+    blocked: true,
   },
 };
 

package/app/utils/status-constants.js

@@ -0,0 +1,11 @@
+// AUTO-GENERATED by scripts/build-frontend.js — do not edit.
+// Source: src/worca/state/status.py
+
+export const FLEET_STICKY = Object.freeze(new Set(["halted","paused"]));
+export const FLEET_TERMINAL = Object.freeze(new Set(["completed","failed","halted"]));
+export const WORKSPACE_TERMINAL = Object.freeze(new Set(["completed","failed","halted","integration_failed"]));
+export const PIPELINE_ACTIVE = Object.freeze(new Set(["paused","resuming","running"]));
+export const PIPELINE_TERMINAL = Object.freeze(new Set(["completed","interrupted"]));
+export const PIPELINE_FAILURE = Object.freeze(new Set(["failed","setup_failed","unrecoverable"]));
+export const PIPELINE_ALL_TERMINAL = Object.freeze(new Set(["cancelled","completed","failed","interrupted","setup_failed","unrecoverable"]));
+export const PIPELINE_IN_FLIGHT = Object.freeze(new Set(["resuming","running"]));

package/bin/worca-ui.js

@@ -12,9 +12,9 @@ import {
   writeFileSync,
 } from 'node:fs';
 import { connect, createServer } from 'node:net';
-import { homedir } from 'node:os';
 import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { worcaHome } from '../server/paths.js';
 import {
   readProjects,
   removeProject,
@@ -37,7 +37,7 @@ function findProjectRoot(startDir) {
   return startDir;
 }
 
-const PREFS_DIR = join(homedir(), '.worca');
+const PREFS_DIR = worcaHome();
 const SERVER_SCRIPT = join(__dirname, '..', 'server', 'index.js');
 
 /** Exported for testing */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worca/ui",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Pipeline monitoring UI for worca-cc",
   "license": "MIT",
   "author": "Sinisha Djukic",
@@ -38,6 +38,7 @@
     "app/protocol.js",
     "app/utils/stage-order.js",
     "app/utils/state-actions.js",
+    "app/utils/status-constants.js",
     "scripts/build-frontend.js"
   ],
   "engines": {

package/scripts/build-frontend.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { copyFileSync, mkdirSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { copyFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -41,6 +42,52 @@ async function run() {
     console.log('copied', path.relative(repoRoot, dest));
   }
 
+  // Codegen: derive status-constants.js from the Python enums in
+  // src/worca/state/status.py. Single source of truth — when Python adds a
+  // status, the JS side picks it up at the next build. Shipped in the npm
+  // package via the `files` allowlist in package.json.
+  const utilsDir = path.join(appDir, 'utils');
+  mkdirSync(utilsDir, { recursive: true });
+  const constantsOut = path.join(utilsDir, 'status-constants.js');
+  try {
+    const pyScript =
+      'import json; from worca.state import status as s; ' +
+      'print(json.dumps({' +
+      '"FLEET_STICKY": sorted(s.FLEET_STICKY), ' +
+      '"FLEET_TERMINAL": sorted(s.FLEET_TERMINAL), ' +
+      '"WORKSPACE_TERMINAL": sorted(s.WORKSPACE_TERMINAL), ' +
+      '"PIPELINE_ACTIVE": sorted(s.PIPELINE_ACTIVE), ' +
+      '"PIPELINE_TERMINAL": sorted(s.PIPELINE_TERMINAL), ' +
+      '"PIPELINE_FAILURE": sorted(s.PIPELINE_FAILURE), ' +
+      '"PIPELINE_ALL_TERMINAL": sorted(s.PIPELINE_ALL_TERMINAL), ' +
+      '"PIPELINE_IN_FLIGHT": sorted(s.PIPELINE_IN_FLIGHT)' +
+      '}))';
+    const raw = execFileSync('python3', ['-c', pyScript], {
+      cwd: path.join(repoRoot, '..'),
+      encoding: 'utf8',
+    });
+    const constants = JSON.parse(raw);
+    const lines = [
+      '// AUTO-GENERATED by scripts/build-frontend.js — do not edit.',
+      '// Source: src/worca/state/status.py',
+      '',
+    ];
+    for (const [name, values] of Object.entries(constants)) {
+      lines.push(
+        `export const ${name} = Object.freeze(new Set(${JSON.stringify(values)}));`,
+      );
+    }
+    writeFileSync(constantsOut, `${lines.join('\n')}\n`);
+    console.log('generated', path.relative(repoRoot, constantsOut));
+  } catch (err) {
+    console.error(
+      'status-constants codegen failed (is python3 + worca-cc installed?):',
+      err.message,
+    );
+    process.exitCode = 1;
+    return;
+  }
+
   try {
     const esbuild = await import('esbuild');
     await esbuild.build({

package/server/app.js

@@ -1,6 +1,6 @@
 // server/app.js
 
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawn } from 'node:child_process';
 import { createHmac, randomUUID } from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
@@ -9,9 +9,11 @@ import { fileURLToPath } from 'node:url';
 import express from 'express';
 
 import { dbExists, getIssue, listIssues } from './beads-reader.js';
+import { createFleetRouter } from './fleet-routes.js';
 import { RAW_BODY } from './integrations/index.js';
 import { verify } from './integrations/verify.js';
 import { LaunchLock } from './launch-lock.js';
+import { fleetRunsDir, workspaceRunsDir, workspacesDir } from './paths.js';
 import { createPreferencesRouter } from './preferences-routes.js';
 import { ProcessManager } from './process-manager.js';
 import { scanDirectory } from './project-registry.js';
@@ -26,6 +28,30 @@ import { discoverSubagents } from './subagents-discovery.js';
 import { checkWorcaVersion } from './version-check.js';
 import { getVersionInfo } from './versions.js';
 import { createInbox } from './webhook-inbox.js';
+import { createWorkspaceRouter } from './workspace-routes.js';
+
+// Invokes `worca cleanup --<flag> <id>` as a subprocess and resolves once
+// the cleanup completes. Wired into the fleet/workspace router DELETE
+// ?cleanup=1 path so the UI Cleanup button actually removes the worktrees
+// + manifest dir (without this, the route falls back to a no-op default).
+function runWorcaCleanupSubprocess(flag, id) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(
+      'python3',
+      ['-m', 'worca.cli.main', 'cleanup', flag, id],
+      { stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env } },
+    );
+    let stderr = '';
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on('error', reject);
+    child.on('exit', (code) => {
+      if (code === 0) resolve({});
+      else reject(new Error(`worca cleanup exited ${code}: ${stderr.trim()}`));
+    });
+  });
+}
 
 export function createApp(options = {}) {
   const app = express();
@@ -550,6 +576,138 @@ export function createApp(options = {}) {
         launchLock,
       }),
     );
+    app.use(
+      '/api/fleet-runs',
+      createFleetRouter({
+        fleetRunsDir: fleetRunsDir(),
+        prefsDir,
+        runCleanup: (id) => runWorcaCleanupSubprocess('--fleet-id', id),
+        // Spawn run_fleet.py in a detached subprocess so the route can return
+        // immediately. We pass the pre-generated fleet_id so the in-flight
+        // manifest path matches what the route just wrote.
+        dispatchFleet: async ({ fleet_id, projects, manifest, resume }) => {
+          // Resume path: the /resume route already flipped the manifest to
+          // "running"; run_fleet.py --resume reads the manifest, continues
+          // paused/interrupted children in place and re-dispatches
+          // failed/pending ones. No --projects — the manifest is the source.
+          if (resume) {
+            const child = spawn(
+              'python3',
+              ['-m', 'worca.scripts.run_fleet', '--resume', fleet_id],
+              { detached: true, stdio: 'ignore', env: { ...process.env } },
+            );
+            child.unref();
+            return;
+          }
+          if (!projects || projects.length === 0) return;
+          const args = [
+            '-m',
+            'worca.scripts.run_fleet',
+            '--fleet-id',
+            fleet_id,
+            '--projects',
+            ...projects,
+          ];
+          if (manifest.work_request?.source) {
+            args.push('--source', manifest.work_request.source);
+          } else {
+            args.push('--prompt', manifest.work_request?.description ?? '');
+          }
+          if (manifest.head_template) {
+            args.push('--head-template', manifest.head_template);
+          }
+          if (manifest.base_branch) {
+            args.push('--base', manifest.base_branch);
+          }
+          if (manifest.plan?.path) {
+            args.push('--plan', manifest.plan.path);
+          }
+          for (const p of manifest.guide?.paths || []) {
+            args.push('--guide', p);
+          }
+          if (manifest.max_parallel) {
+            args.push('--max-parallel', String(manifest.max_parallel));
+          }
+          if (manifest.fleet_failure_threshold != null) {
+            args.push(
+              '--fleet-failure-threshold',
+              String(manifest.fleet_failure_threshold),
+            );
+          }
+          const child = spawn('python3', args, {
+            detached: true,
+            stdio: 'ignore',
+            env: { ...process.env },
+          });
+          child.unref();
+        },
+      }),
+    );
+
+    // Workspace routers — both definitions (/api/workspaces) and runs
+    // (/api/workspace-runs). The router factory exposes them as a pair.
+    const workspaceRouters = createWorkspaceRouter({
+      workspaceRunsDir: workspaceRunsDir(),
+      workspacesDir: workspacesDir(),
+      runCleanup: (id) => runWorcaCleanupSubprocess('--workspace-id', id),
+      // Spawn run_workspace.py in a detached subprocess, mirroring the fleet
+      // dispatcher. We pass --workspace-id so the script reuses the manifest
+      // the route just wrote instead of generating a fresh ID (which would
+      // orphan the manifest the UI navigated to).
+      dispatchWorkspace: async ({
+        workspace_id,
+        workspace_root,
+        manifest,
+        resume,
+      }) => {
+        if (resume) {
+          const child = spawn(
+            'python3',
+            [
+              '-m',
+              'worca.scripts.run_workspace',
+              workspace_root,
+              '--resume',
+              workspace_id,
+            ],
+            { detached: true, stdio: 'ignore', env: { ...process.env } },
+          );
+          child.unref();
+          return;
+        }
+        const args = [
+          '-m',
+          'worca.scripts.run_workspace',
+          workspace_root,
+          '--workspace-id',
+          workspace_id,
+        ];
+        if (manifest.work_request?.source) {
+          args.push('--source', manifest.work_request.source);
+        } else {
+          args.push('--prompt', manifest.work_request?.description ?? '');
+        }
+        if (manifest.branch_template) {
+          args.push('--branch', manifest.branch_template);
+        }
+        if (manifest.skip_integration) args.push('--skip-integration');
+        if (manifest.skip_planning) args.push('--skip-planning');
+        if (manifest.max_parallel) {
+          args.push('--max-parallel', String(manifest.max_parallel));
+        }
+        for (const p of manifest.guide?.paths || []) {
+          args.push('--guide', p);
+        }
+        const child = spawn('python3', args, {
+          detached: true,
+          stdio: 'ignore',
+          env: { ...process.env },
+        });
+        child.unref();
+      },
+    });
+    app.use('/api/workspaces', workspaceRouters.workspaces);
+    app.use('/api/workspace-runs', workspaceRouters.workspaceRuns);
   }
 
   // POST /api/integrations/telegram/detect — find chat IDs from recent messages.