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

package/bin/worca-ui.js

@@ -20,6 +20,11 @@ import {
   writeProject,
 } from '../server/project-registry.js';
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(
+  readFileSync(join(__dirname, '..', 'package.json'), 'utf8'),
+);
+
 function findProjectRoot(startDir) {
   let dir = startDir;
   while (dir !== dirname(dir)) {
@@ -30,12 +35,7 @@ function findProjectRoot(startDir) {
 }
 
 const PREFS_DIR = join(homedir(), '.worca');
-const SERVER_SCRIPT = join(
-  dirname(fileURLToPath(import.meta.url)),
-  '..',
-  'server',
-  'index.js',
-);
+const SERVER_SCRIPT = join(__dirname, '..', 'server', 'index.js');
 
 /** Exported for testing */
 export function parseArgs(argv) {
@@ -44,7 +44,7 @@ export function parseArgs(argv) {
     port: 3400,
     host: '127.0.0.1',
     open: false,
-    global: false,
+    global: true,
     // projects sub-command
     subAction: null, // 'list' | 'add' | 'remove'
     projectPath: null,
@@ -57,7 +57,11 @@ export function parseArgs(argv) {
   };
   for (let i = 2; i < argv.length; i++) {
     const arg = argv[i];
-    if (
+    if (arg === '--version' || arg === '-v') {
+      args.command = 'version';
+    } else if (arg === '--help' || arg === '-h') {
+      args.command = 'help';
+    } else if (
       ['start', 'stop', 'restart', 'status', 'projects', 'migrate'].includes(
         arg,
       )
@@ -86,6 +90,11 @@ export function parseArgs(argv) {
       args.open = true;
     } else if (arg === '--global') {
       args.global = true;
+    } else if (arg === '--project') {
+      args.global = false;
+      if (argv[i + 1] && !argv[i + 1].startsWith('-')) {
+        args.projectPath = argv[++i];
+      }
     } else if (arg === '--scan' && argv[i + 1]) {
       args.scanDir = argv[++i];
     } else if (arg === '--dry-run') {
@@ -488,6 +497,34 @@ function migrateStatus() {
   }
 }
 
+function printHelp() {
+  console.log(`worca-ui v${pkg.version} — Pipeline monitoring UI for worca-cc
+
+Usage: worca-ui <command> [options]
+
+Commands:
+  start                        Start the server (default)
+  stop                         Stop the running server
+  restart                      Restart the server
+  status                       Show server status
+  projects list                List registered projects
+  projects add <path> [--name] Register a project
+  projects remove <name>       Unregister a project
+  migrate --scan <dir>         Scan directory for projects to register
+  migrate --add <path>         Register a single project
+  migrate --status             Show registration health
+
+Options:
+  --port <N>         Server port (default: 3400, env: PORT)
+  --host <addr>      Bind address (default: 127.0.0.1, env: HOST)
+  --global           Multi-project mode (default)
+  --project [path]   Single-project mode, optionally scoped to path
+  --open             Open browser after start
+  --dry-run          Preview migrate --scan without registering
+  -v, --version      Show version
+  -h, --help         Show this help`);
+}
+
 const args = parseArgs(process.argv);
 switch (args.command) {
   case 'start':
@@ -533,8 +570,12 @@ switch (args.command) {
       );
     }
     break;
+  case 'version':
+    console.log(pkg.version);
+    break;
+  case 'help':
+    printHelp();
+    break;
   default:
-    console.log(
-      'Usage: worca-ui [start|stop|restart|status|projects|migrate] [--port N] [--host H] [--open] [--global]',
-    );
+    printHelp();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worca/ui",
-  "version": "0.1.0-rc.3",
+  "version": "0.1.0-rc.5",
   "description": "Pipeline monitoring UI for worca-cc",
   "license": "MIT",
   "author": "Sinisha Djukic",

package/server/index.js

@@ -9,13 +9,14 @@ import { attachWsServer } from './ws.js';
 // Parse argv
 let port = parseInt(process.env.PORT, 10) || 3400;
 let host = process.env.HOST || '127.0.0.1';
-let isGlobal = false;
+let isGlobal = true;
 for (let i = 0; i < process.argv.length; i++) {
   if (process.argv[i] === '--port' && process.argv[i + 1])
     port = parseInt(process.argv[++i], 10);
   if (process.argv[i] === '--host' && process.argv[i + 1])
     host = process.argv[++i];
   if (process.argv[i] === '--global') isGlobal = true;
+  if (process.argv[i] === '--project') isGlobal = false;
 }
 
 // Resolve project root: walk up from cwd until we find .claude/settings.json

package/server/preferences.js

@@ -1,7 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 
-const DEFAULTS = { theme: 'light' };
+const DEFAULTS = { theme: 'light', source_repo: '' };
 
 export function readPreferences(path) {
   try {

package/server/project-routes.js

@@ -16,9 +16,11 @@ import {
   unlinkSync,
   writeFileSync,
 } from 'node:fs';
+import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { Router } from 'express';
 import { dbExists, getIssue, listIssues } from './beads-reader.js';
+import { readPreferences } from './preferences.js';
 import { ProcessManager } from './process-manager.js';
 import {
   readProjects,
@@ -1102,14 +1104,16 @@ export function createProjectScopedRoutes() {
 
   // POST /api/projects/:projectId/worca-setup — install or update worca
   router.post('/worca-setup', (req, res) => {
-    const { settingsPath, projectRoot } = req.project;
+    const { projectRoot } = req.project;
     let source = req.body?.source;
 
-    // Fall back to worca.source_repo from merged settings
-    if (!source && settingsPath) {
+    // Fall back to source_repo from global preferences
+    if (!source) {
       try {
-        const settings = readMergedSettings(settingsPath);
-        source = settings?.worca?.source_repo;
+        const prefs = readPreferences(
+          join(homedir(), '.worca', 'preferences.json'),
+        );
+        source = prefs.source_repo || undefined;
       } catch {
         /* ignore — worca init will use its own resolution chain */
       }