@worca/ui 0.27.0 → 0.28.0-rc.1

package/server/known-skills.json

@@ -0,0 +1,31 @@
+[
+  { "name": "batch", "group": "Built-in" },
+  { "name": "claude-api", "group": "Built-in" },
+  { "name": "debug", "group": "Built-in" },
+  { "name": "fewer-permission-prompts", "group": "Built-in" },
+  { "name": "init", "group": "Built-in" },
+  { "name": "loop", "group": "Built-in" },
+  { "name": "review", "group": "Built-in" },
+  { "name": "schedule", "group": "Built-in" },
+  { "name": "security-review", "group": "Built-in" },
+  { "name": "simplify", "group": "Built-in" },
+  { "name": "update-config", "group": "Built-in" },
+  { "name": "hookify:hookify", "group": "Plugin" },
+  { "name": "hookify:configure", "group": "Plugin" },
+  { "name": "hookify:list", "group": "Plugin" },
+  { "name": "hookify:writing-rules", "group": "Plugin" },
+  { "name": "feature-dev:feature-dev", "group": "Plugin" },
+  { "name": "feature-dev:code-reviewer", "group": "Plugin" },
+  { "name": "feature-dev:code-architect", "group": "Plugin" },
+  { "name": "feature-dev:code-explorer", "group": "Plugin" },
+  { "name": "claude-md-management:revise-claude-md", "group": "Plugin" },
+  { "name": "claude-md-management:claude-md-improver", "group": "Plugin" },
+  { "name": "worca-install", "group": "Worca" },
+  { "name": "worca-rc", "group": "Worca" },
+  { "name": "worca-release", "group": "Worca" },
+  { "name": "worca-sync", "group": "Worca" },
+  { "name": "worca-sync-pr", "group": "Worca" },
+  { "name": "worca-sync-commit", "group": "Worca" },
+  { "name": "worca-analyze", "group": "Worca" },
+  { "name": "worca-agent-override", "group": "Worca" }
+]

package/server/known-tools.json

@@ -0,0 +1,18 @@
+[
+  { "name": "Agent", "group": "Core" },
+  { "name": "Bash", "group": "Core" },
+  { "name": "Edit", "group": "Core" },
+  { "name": "Glob", "group": "Core" },
+  { "name": "Grep", "group": "Core" },
+  { "name": "Read", "group": "Core" },
+  { "name": "Write", "group": "Core" },
+  { "name": "Skill", "group": "Core" },
+  { "name": "WebFetch", "group": "Core" },
+  { "name": "WebSearch", "group": "Core" },
+  { "name": "NotebookEdit", "group": "Core" },
+  { "name": "EnterPlanMode", "group": "Mode" },
+  { "name": "EnterWorktree", "group": "Mode" },
+  { "name": "TodoWrite", "group": "Task" },
+  { "name": "TaskCreate", "group": "Task" },
+  { "name": "TaskUpdate", "group": "Task" }
+]

package/server/project-routes.js

@@ -23,7 +23,9 @@ import { actionAllowed } from '../app/utils/state-actions.js';
 import { atomicWriteSync } from './atomic-write.js';
 import { dbExists, getIssue, listIssues } from './beads-reader.js';
 import { dispatchExternal } from './dispatch-external.js';
+import { migrateDispatchGovernance } from './dispatch-migration.js';
 import { ensureWebhookForUi } from './ensure-webhook.js';
+import { getDefaultBranch } from './git-helpers.js';
 import { extractAndStripGlobalKeys } from './global-keys.js';
 import { LaunchLock } from './launch-lock.js';
 import { createModelEnvRouter } from './model-env-routes.js';
@@ -361,7 +363,8 @@ export function createProjectScopedRoutes({
   router.get('/runs', requireWorcaDir, (req, res) => {
     try {
       const runs = discoverRuns(req.project.worcaDir);
-      const response = { ok: true, runs };
+      const default_branch = getDefaultBranch(req.project.projectRoot);
+      const response = { ok: true, runs, default_branch };
       // Include settings so multi-project clients can use loop limits, etc.
       const { settingsPath } = req.project;
       if (settingsPath && existsSync(settingsPath)) {
@@ -515,22 +518,15 @@ export function createProjectScopedRoutes({
         if (!base.worca || typeof base.worca !== 'object') base.worca = {};
         base.worca = deepMerge(base.worca, body.worca);
 
-        if (
-          body.worca.governance &&
-          typeof body.worca.governance === 'object' &&
-          body.worca.governance.subagent_dispatch !== undefined &&
-          base.worca.governance &&
-          typeof base.worca.governance === 'object' &&
-          'dispatch' in base.worca.governance
-        ) {
-          delete base.worca.governance.dispatch;
-        }
         baseChanged = true;
       }
 
       // STEP 1: extract misplaced global keys + inert milestone keys
       const autoMigrated = extractAndStripGlobalKeys(base);
 
+      // STEP 1a: migrate legacy subagent_dispatch → dispatch.subagents (W-054)
+      if (base.worca) migrateDispatchGovernance(base.worca);
+
       // STEP 2: write extracted global keys to ~/.worca/settings.json
       const globalSettingsPath = prefsDir
         ? join(prefsDir, 'settings.json')

package/server/settings-validator.js

@@ -396,19 +396,91 @@ export function validateSettingsPayload(body, options = {}) {
           ) {
             details.push('governance.dispatch must be an object');
           } else {
+            const DISPATCH_SECTIONS = ['tools', 'skills', 'subagents'];
             for (const [key, val] of Object.entries(g.dispatch)) {
-              if (!VALID_AGENTS.includes(key)) {
-                details.push(`Unknown dispatch agent: "${key}"`);
-                continue;
-              }
-              if (!Array.isArray(val)) {
-                details.push(`Dispatch for "${key}" must be an array`);
-                continue;
-              }
-              for (const v of val) {
-                if (typeof v !== 'string') {
-                  details.push(`Dispatch entry for "${key}" must be a string`);
+              if (DISPATCH_SECTIONS.includes(key)) {
+                // W-054 nested shape: dispatch.{tools,skills,subagents}
+                if (
+                  typeof val !== 'object' ||
+                  val === null ||
+                  Array.isArray(val)
+                ) {
+                  details.push(`governance.dispatch.${key} must be an object`);
+                  continue;
+                }
+                for (const tierKey of ['always_disallowed', 'default_denied']) {
+                  if (val[tierKey] === undefined) continue;
+                  if (!Array.isArray(val[tierKey])) {
+                    details.push(
+                      `governance.dispatch.${key}.${tierKey} must be an array`,
+                    );
+                    continue;
+                  }
+                  for (const entry of val[tierKey]) {
+                    if (typeof entry !== 'string') {
+                      details.push(
+                        `governance.dispatch.${key}.${tierKey} entries must be strings`,
+                      );
+                    }
+                  }
+                }
+                if (val.per_agent_allow !== undefined) {
+                  if (
+                    typeof val.per_agent_allow !== 'object' ||
+                    val.per_agent_allow === null ||
+                    Array.isArray(val.per_agent_allow)
+                  ) {
+                    details.push(
+                      `governance.dispatch.${key}.per_agent_allow must be an object`,
+                    );
+                  } else {
+                    for (const [agent, allowList] of Object.entries(
+                      val.per_agent_allow,
+                    )) {
+                      if (
+                        agent !== '_defaults' &&
+                        !VALID_AGENTS.includes(agent) &&
+                        agent !== 'workspace_planner'
+                      ) {
+                        details.push(
+                          `governance.dispatch.${key}.per_agent_allow: unknown agent "${agent}"`,
+                        );
+                        continue;
+                      }
+                      if (!Array.isArray(allowList)) {
+                        details.push(
+                          `governance.dispatch.${key}.per_agent_allow.${agent} must be an array`,
+                        );
+                        continue;
+                      }
+                      for (const entry of allowList) {
+                        if (typeof entry !== 'string') {
+                          details.push(
+                            `governance.dispatch.${key}.per_agent_allow.${agent} entries must be strings`,
+                          );
+                        }
+                      }
+                    }
+                  }
+                }
+              } else if (
+                VALID_AGENTS.includes(key) ||
+                key === 'workspace_planner'
+              ) {
+                // Pre-W-054 legacy flat shape — tolerated for migration.
+                if (!Array.isArray(val)) {
+                  details.push(`Dispatch for "${key}" must be an array`);
+                  continue;
+                }
+                for (const v of val) {
+                  if (typeof v !== 'string') {
+                    details.push(
+                      `Dispatch entry for "${key}" must be a string`,
+                    );
+                  }
                 }
+              } else {
+                details.push(`Unknown dispatch key: "${key}"`);
               }
             }
           }

package/server/watcher.js

@@ -157,6 +157,7 @@ export function discoverRuns(worcaDir) {
               ...status,
               worktree_worca_dir: join(reg.worktree_path, '.worca'),
               is_worktree_run: true,
+              head_branch: reg.branch || null,
               fleet_id: reg.fleet_id || null,
               workspace_id: reg.workspace_id || null,
               group_type: reg.group_type || null,
@@ -311,6 +312,7 @@ export async function discoverRunsAsync(worcaDir) {
         ...status,
         worktree_worca_dir: join(reg.worktree_path, '.worca'),
         is_worktree_run: true,
+        head_branch: reg.branch || null,
         fleet_id: reg.fleet_id || null,
         workspace_id: reg.workspace_id || null,
         group_type: reg.group_type || null,

package/server/worktrees-routes.js

@@ -20,6 +20,7 @@ import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import * as fsp from 'node:fs/promises';
 import { join } from 'node:path';
 import { Router } from 'express';
+import { getDefaultBranch } from './git-helpers.js';
 import { pruneWorktrees, removeWorktree } from './worktree-ops.js';
 
 const CLEANUP_CONCURRENCY = 4;
@@ -362,6 +363,7 @@ async function _listWorktrees(worcaDir) {
     started_at: m.reg.started_at || null,
     status: m.status,
     removable: m.status !== 'running',
+    target_branch: m.reg.target_branch || null,
     fleet_id: m.reg.fleet_id || null,
     workspace_id: m.reg.workspace_id || null,
     group_type: m.reg.group_type || null,
@@ -399,9 +401,11 @@ export function createWorktreesRouter() {
     }
     try {
       const worktrees = await _listWorktrees(worcaDir);
+      const default_branch = getDefaultBranch(req.project?.projectRoot);
       res.json({
         ok: true,
         worktrees,
+        default_branch,
         // Documents the semantics shift in `disk_bytes` (project files only).
         // Clients can render this as a caveat next to disk totals.
         disk_walk_skip_dirs: [...WALK_SKIP_DIRS],