@volter/supercode-orchestrator 0.5.70 → 0.5.72

package/board/cli.mjs

@@ -75,7 +75,7 @@ const SAFE_SESSION = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,199}$/;
 const HELP = `supercode workflow <verb> [--root <home>] [--board <slug>] [--json]
 
 The board's verbs, with their flags:
-  init [--backing sqlite|files|ztrack] [--document <arcs.md>] [--commit] [--manager <address>] [--archive-max-lines N] [--archive-period month]
+  init [--backing sqlite|files|ztrack] [--document <arcs.md>] [--commit] [--manager <address>] [--dispatching on|off] [--archive-max-lines N] [--archive-period month]
   migrate --backing ztrack --document <arcs.md> --status-map <json>
   boards list|create|rm|switch|show|rename|set-default-workdir|export|import
   create <title> [--body | --body-file PATH|-] [--assignee] [--parent]... [--workspace scratch|worktree:<repository>|dir:<repository>] [--branch] [--project]
@@ -414,6 +414,8 @@ export async function runVerb(argv) {
       return 0;
     }
     case 'init': {
+      // a malformed switch is refused before anything is made
+      if (args.dispatching !== undefined && !['on', 'off'].includes(args.dispatching)) throw new Error('--dispatching takes on or off; nothing was made');
       // A board on the ztrack backing is made with what its ztrack.json declares besides its document: `--commit` (the
       // documents live in a git checkout, each write committed and pushed), its manager (`--manager`, else the first one
       // the home's workflow names), whose own writes it does not commit, and the archive's rotation. A board already there
@@ -445,10 +447,13 @@ export async function runVerb(argv) {
         const own = named(fileURLToPath(new URL('../bin/orchestrator.mjs', import.meta.url)));
         writeFileSync(record, `${JSON.stringify({ package: '@volter/supercode-orchestrator', version: own?.version ?? null, entry: own?.entry ?? null, supercode: process.env.SUPERCODE_BIN ? named(process.env.SUPERCODE_BIN) : null })}\n`);
       }
+      // its dispatching switch, set before any owner runs (an install's first start: `init --dispatching off`); while an
+      // owner runs, `workflow dispatching` is its verb
+      const switched = args.dispatching !== undefined ? setDispatching(root, slug, args.dispatching === 'on', 'set at init') : null;
       const backing = made.backing;
       made.close();
       const { profiles } = await laneState(root).catch(() => ({ profiles: [] }));
-      say(args, `${backing === 'sqlite' ? 'Kanban DB' : `Board (${backing} backing)`} ${kept ? 'already' : 'initialized'} at ${boardPath(root, slug)}\n\n${profiles.length ? `Profiles of this home (any can be an --assignee): ${profiles.join(', ')}` : 'No profiles in this home.'}\nThe dispatcher: \`supercode workflow serve\`, or the orchestrator while it serves the home.`, { ok: true, board: slug, path: boardPath(root, slug), backing, kept: Boolean(kept), profiles });
+      say(args, `${backing === 'sqlite' ? 'Kanban DB' : `Board (${backing} backing)`} ${kept ? 'already' : 'initialized'} at ${boardPath(root, slug)}\n\n${profiles.length ? `Profiles of this home (any can be an --assignee): ${profiles.join(', ')}` : 'No profiles in this home.'}\nThe dispatcher: \`supercode workflow serve\`, or the orchestrator while it serves the home.${switched ? `\nBoard ${slug}: dispatching ${switched.on ? 'on' : 'off'} (set at init).` : ''}`, { ok: true, board: slug, path: boardPath(root, slug), backing, kept: Boolean(kept), profiles, ...(switched ? { dispatching: switched } : {}) });
       return 0;
     }
 
@@ -1538,7 +1543,7 @@ async function answerOne(root, line) {
     const argv = tool ? ['tool'] : Array.isArray(request?.argv) && request.argv.every((arg) => typeof arg === 'string') ? request.argv : null;
     if (request?.v !== 1 || !argv?.length) return { code: 1, stdout: '', stderr: 'supercode workflow: a request names a verb\n' };
     const verb = parse(argv)._[0];
-    if (BOARD_OPERATION_VERBS.has(verb) && verb !== 'dispatching') return { code: 1, stdout: '', stderr: `supercode workflow: ${verb} is run on the board's machine as its own act, not sent to the owner\n` };
+    if (BOARD_OPERATION_VERBS.has(verb)) return { code: 1, stdout: '', stderr: `supercode workflow: ${verb} is run on the board's machine as its own act, not sent to the owner\n` };
     const session = request.session && typeof request.session.id === 'string' && ['claude-code', 'codex'].includes(request.session.harness) ? request.session : null;
     const caller = typeof request.caller === 'string' ? request.caller : session ? `sc:${localMachine()}:${session.harness}:${session.id}` : null;
     const facts = Object.fromEntries(Object.entries(request.facts ?? {}).filter(([key, value]) => CALLER_FACTS.includes(key) && typeof value === 'string'));

package/board/client.mjs

@@ -11,8 +11,8 @@ import { processSession } from './caller-session.mjs';
 /**
  * `supercode workflow <verb>`: the CLI holds nothing. A card verb is sent to the home's board owner (`workflow serve`,
  * @volter/teams/board-owner), which answers it in its own process with the home it holds; the answer is rendered here.
- * The run-on-the-machine verbs (BOARD_OPERATION_VERBS: the owner itself, its init, repair and housekeeping, the
- * dispatching switch and the verbs that hold the call open) and help are acts of their own, run here.
+ * The run-on-the-machine verbs (BOARD_OPERATION_VERBS: the owner itself, its init, repair and housekeeping, and the
+ * verbs that hold the call open) and help are acts of their own, run here.
  */
 export async function runWorkflow(argv) {
   const args = parse(argv);
@@ -21,14 +21,13 @@ export async function runWorkflow(argv) {
   const root = help ? null : homeOf(args);
   if (help || BOARD_OPERATION_VERBS.has(verb)) {
     // The board has one writer. An operation that writes the boards (exclusive, below) takes the home's lock itself
-    // and so is that writer, refusing while an owner holds it; the dispatching switch is the owner's to write while one
-    // runs. The rest only read, or are the owner itself (serve), and run here as their own act.
+    // and so is that writer, refusing while an owner holds it. The rest only read, or are the owner itself (serve), and
+    // run here as their own act.
     const writes = !help && exclusive(verb, args);
     let lock = null;
     if (writes) {
       try { lock = await takeHome(root); }
       catch (error) {
-        if (verb === 'dispatching') return sendToOwner(root, argv, args);
         process.stderr.write(`supercode workflow: ${verb} writes the boards of ${root}, which have a running owner (${error.message}); stop \`supercode workflow serve\` to run it\n`);
         return 1;
       }
@@ -45,7 +44,6 @@ const BOARDS_WRITES = new Set(['create', 'new', 'rm', 'remove', 'delete', 'renam
 function exclusive(verb, args) {
   if (EXCLUSIVE.has(verb)) return true;
   if (verb === 'dispatch') return !args['dry-run'];
-  if (verb === 'dispatching') return ['on', 'off'].includes(args._[1]);
   if (verb === 'boards') return BOARDS_WRITES.has(args._[1] ?? 'list');
   return false;
 }

package/board/fence.mjs

@@ -16,9 +16,6 @@ const epochFile = (root) => join(boardHome(root), 'board.epoch');
 const recorded = (root) => { try { return Number(readFileSync(epochFile(root), 'utf8').trim()) || 0; } catch { return 0; } };
 const storedIn = (db) => { db.exec(STATE); return Number(db.prepare("SELECT value FROM supercode_board_state WHERE key = 'owner_epoch'").get()?.value ?? 0) || 0; };
 
-/** This process's epoch: null outside the owner. */
-export const ownerEpoch = () => mine;
-
 /**
  * Take a new epoch for the home at `root` (the caller holds its lock): one above the home's record and every epoch the
  * boards opened by `boards()` store; recorded, then fenced into each board.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-orchestrator",
-  "version": "0.5.70",
+  "version": "0.5.72",
   "type": "module",
   "description": "The orchestrator runtime over the Volter Harness ontology: one typed operational model whose folder is its serialization, read and written through the harness orchestration doors (docs/ORCHESTRATOR-IR.md)",
   "exports": {
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@volter/supercode-harness-sdk": "^0.3.60",
-    "@volter/teams": "0.2.23",
+    "@volter/teams": "0.2.24",
     "@volter/ztrack": "^2.4.23",
     "yaml": "^2.9.0"
   },