@volter/supercode-orchestrator 0.4.43 → 0.4.45

package/board/cli.mjs

@@ -12,7 +12,7 @@ import { read } from '../orchestration.mjs';
 import { holdDispatcherLock } from '../hermes-locks.mjs';
 import { backingOf, boardExists, boardPath, DEFAULT_BOARD, event, json, listBoards, logsDir, now, openBoard, tx } from './store.mjs';
 import * as engine from './engine.mjs';
-import { adoptSession, boardLabel, boardSettings, lanesOf, localMachine, observeFleet, paused, plan, startCard, tick } from './dispatch.mjs';
+import { adoptSession, boardAddress, boardLabel, boardSettings, lanesOf, localMachine, observeFleet, paused, plan, startCard, tick } from './dispatch.mjs';
 import { loadWorkflow, statusOf, useWorkflow, workflowEntry, workflowFor } from './workflow.mjs';
 import { evaluate } from './expr.mjs';
 
@@ -1050,7 +1050,8 @@ function closeSession(board, id) {
   if (!task) throw new Error(`no card ${id}`);
   if (task.status === 'running') throw new Error(`${id} is running; block, complete or reclaim it before closing its session`);
   if (!session?.pane) return null;
-  const r = spawnSync(process.env.SUPERCODE_BIN || 'supercode', ['teams', 'panes', 'close', session.pane, '--machine', session.machine], { cwd: tmpdir(), encoding: 'utf8', timeout: 60_000 });
+  // the board closes its card's pane, whichever session ran `workflow close`
+  const r = spawnSync(process.env.SUPERCODE_BIN || 'supercode', ['teams', 'panes', 'close', session.pane, '--machine', session.machine], { cwd: tmpdir(), encoding: 'utf8', timeout: 60_000, env: { ...process.env, SUPERCODE_CALLER: boardAddress(board.label) } });
   if (r.status !== 0) throw new Error(`closing pane ${session.pane} on ${session.machine}: ${(r.stderr || r.stdout).trim().slice(-300)}`);
   tx(board, (db) => event(db, id, 'session_closed', { session_id: session.session_id, machine: session.machine, pane: session.pane }));
   return session;

package/board/dispatch.mjs

@@ -54,9 +54,11 @@ export function localMachine() {
 /** The supercode command the dispatcher drives. */
 export const supercodeBin = () => process.env.SUPERCODE_BIN || 'supercode';
 
-function sc(args, { input = null, timeout = 120_000 } = {}) {
-  // a neutral directory: `supercode teams …` resolves its entry from a checkout at the cwd
-  const r = spawnSync(supercodeBin(), args, { cwd: tmpdir(), input: input ?? undefined, encoding: 'utf8', timeout, env: process.env, maxBuffer: 512 * 1024 * 1024 });
+function sc(args, { input = null, timeout = 120_000, as = null } = {}) {
+  // a neutral directory: `supercode teams …` resolves its entry from a checkout at the cwd. `as`: the board this
+  // command acts for, so a card's pane is started and closed by its board, whichever session ran the board's verb
+  const env = as ? { ...process.env, SUPERCODE_CALLER: as } : process.env;
+  const r = spawnSync(supercodeBin(), args, { cwd: tmpdir(), input: input ?? undefined, encoding: 'utf8', timeout, env, maxBuffer: 512 * 1024 * 1024 });
   return { code: r.status, stdout: r.stdout ?? '', stderr: (r.stderr ?? '') + (r.error ? r.error.message : '') };
 }
 
@@ -236,7 +238,7 @@ function limitsOf(db, board, entry, task, session) {
   return out;
 }
 
-function stopSession(session) {
+function stopSession(board, session) {
   if (!session) return;
   if (session.surface === 'headless' && pidAlive(session.pid)) {
     // SIGTERM to the worker's process group, then SIGKILL if it is still there after a grace, as Hermes stops its own
@@ -246,7 +248,7 @@ function stopSession(session) {
     if (pidAlive(session.pid)) signal('SIGKILL');
     return;
   }
-  if (session.pane) sc(['teams', 'panes', 'close', session.pane, ...(session.machine ? ['--machine', session.machine] : [])], { timeout: 60_000 });
+  if (session.pane) sc(['teams', 'panes', 'close', session.pane, ...(session.machine ? ['--machine', session.machine] : [])], { timeout: 60_000, as: boardAddress(board.label) });
 }
 
 // ------------------------------------------------------------------ starting, as the workflow's dispatch says
@@ -383,7 +385,9 @@ export function launchRun(board, entry, id, lane, fleet, settings) {
   const surface = lane.surface === 'pane' ? 'pane' : 'headless';
   const scope = tx(board, (db) => scopeOf(db, board, task, { params: entry.params }));
   const where = whereOf(board, task);
-  const prompt = render(spec.prompt, { ...scope, where, context: tx(board, (db) => cardContext(db, id)), doors: doors(entry.workflow, status, spec.role, id, where, surface) });
+  // a subtask's run also sees its arc: the arc's text, tasks and thread (where its owner's rulings are)
+  const arcContext = task.subtask_of ? tx(board, (db) => cardContext(db, task.subtask_of)) : '';
+  const prompt = render(spec.prompt, { ...scope, where, context: tx(board, (db) => cardContext(db, id)), arc_context: arcContext, doors: doors(entry.workflow, status, spec.role, id, where, surface) });
   // the run's session record knows its status, role and slot (a reviewer's slot is never the implementer's)
   const meta = { status, role: spec.role, slot: spec.session };
   return surface === 'pane'
@@ -414,7 +418,7 @@ function closeRequested(board, report) {
   for (const row of rows) {
     const session = json(row.metadata, {})?.supercode;
     if (!session?.pane) continue;
-    try { stopSession(session); } catch (error) { report.undelivered.push([row.task_id, session.address, `closing it: ${String(error.message).slice(-200)}`]); continue; }
+    try { stopSession(board, session); } catch (error) { report.undelivered.push([row.task_id, session.address, `closing it: ${String(error.message).slice(-200)}`]); continue; }
     tx(board, (db) => setRunSession(db, row.id, { ...session, closed_at: now() }));
   }
 }
@@ -468,7 +472,7 @@ export async function sessionEffect(board, e) {
       // the session that sent the event is not closed under its own command: the dispatcher closes it next tick
       const caller = process.env.CLAUDE_CODE_SESSION_ID || process.env.CODEX_THREAD_ID;
       if (caller && caller === session.session_id) { tx(board, (db) => setRunSession(db, row.id, { ...session, close_requested: now() })); return; }
-      stopSession(session);
+      stopSession(board, session);
       tx(board, (db) => setRunSession(db, row.id, { ...session, closed_at: now() }));
       return;
     }
@@ -574,7 +578,7 @@ function launchPane(board, task, runId, lane, fleet, { input = null, slot = 'wor
       if (input) deliverNow(board, prev.address ?? `sc:${prev.machine}:claude-code:${prev.session_id}`, input, `board-run-${task.id}-r${runId}`);
     } else if (prev.resumable !== false) {
       const r = sc([...base, '--key', `board-${task.id}-r${runId}-resume`, '--input',
-        `The board resumed this session after it was lost; you are still on card ${task.id}: ${task.title}. Carry on.`, '--', '--resume', prev.session_id, ...tail], { timeout: 180_000 });
+        `The board resumed this session after it was lost; you are still on card ${task.id}: ${task.title}. Carry on.`, '--', '--resume', prev.session_id, ...tail], { timeout: 180_000, as: boardAddress(board.label) });
       const pane = r.code === 0 ? lastJson(r.stdout)?.pane ?? null : null;
       // a resume the harness refuses (its transcript is gone) ends the pane at once; another machine's launch
       // answers before that shows, so the pane is looked for again a moment later
@@ -584,7 +588,7 @@ function launchPane(board, task, runId, lane, fleet, { input = null, slot = 'wor
   } else if (prev) replaced = { session_id: prev.session_id, why: `the card moved from ${prev.machine} to ${machine}` };
   if (!session) {
     const sid = randomUUID();
-    const r = sc([...base, '--key', `board-${task.id}-r${runId}-${sid.slice(0, 8)}`, '--input', input ?? `Card ${task.id}: ${task.title}`, '--', '--session-id', sid, ...tail], { timeout: 180_000 });
+    const r = sc([...base, '--key', `board-${task.id}-r${runId}-${sid.slice(0, 8)}`, '--input', input ?? `Card ${task.id}: ${task.title}`, '--', '--session-id', sid, ...tail], { timeout: 180_000, as: boardAddress(board.label) });
     if (r.code !== 0) throw new Error(`supercode open --on ${task.machine}: ${(r.stderr || r.stdout).trim().slice(-500)}`);
     session = { surface: 'pane', session_id: sid, machine, pane: lastJson(r.stdout)?.pane ?? null, mode: 'fresh', launched_at: now(), ...(replaced ? { replaces: replaced.session_id } : {}) };
   }

package/board/workflow.mjs

@@ -4,6 +4,7 @@
 // must hold and what happens; this module applies it to the board file and keeps no rule of its own. Its actions are
 // the engine's primitives (the rows Hermes's tables hold); the I/O an action asks for (stopping a worker, closing a
 // pane, sending a session a message, cleaning a workspace) is answered as effects the caller runs after commit.
+import { spawnSync } from 'node:child_process';
 import { event as record, json, now } from './store.mjs';
 import { evaluate, holds, render } from './expr.mjs';
 
@@ -69,11 +70,21 @@ function pattern(p) {
   return text.startsWith('(?i)') ? new RegExp(text.slice(4), 'i') : new RegExp(text);
 }
 
+// the time of the latest commit in a repository checkout, or null when it is none (asked only when an expression does)
+function lastCommitAt(path) {
+  if (!path) return null;
+  const r = spawnSync('git', ['-C', path, 'log', '-1', '--format=%ct', 'HEAD'], { encoding: 'utf8', timeout: 10_000 });
+  const t = Number(r.stdout?.trim());
+  return r.status === 0 && Number.isFinite(t) && t > 0 ? t : null;
+}
+
 /** The scope an expression is evaluated in: the card (with its relations), the event, params, time, extras. */
 export function scopeOf(db, board, task, { params, event = {}, extra = {} } = {}) {
   const status = statusOf(db, task);
-  const parents = all(db, 'SELECT t.id, t.status, t.title FROM tasks t JOIN task_links l ON l.parent_id = t.id WHERE l.child_id = ?', task.id);
-  const children = all(db, 'SELECT t.id, t.status FROM tasks t JOIN task_links l ON l.child_id = t.id WHERE l.parent_id = ?', task.id);
+  // a related card's status is the workflow's, as the card's own is (`stored_as`: what kanban.db holds)
+  const related = 'COALESCE(c.stage, t.status) AS status, t.status AS stored_as';
+  const parents = all(db, `SELECT t.id, ${related}, t.title FROM tasks t JOIN task_links l ON l.parent_id = t.id LEFT JOIN supercode_cards c ON c.task_id = t.id WHERE l.child_id = ?`, task.id);
+  const children = all(db, `SELECT t.id, ${related} FROM tasks t JOIN task_links l ON l.child_id = t.id LEFT JOIN supercode_cards c ON c.task_id = t.id WHERE l.parent_id = ?`, task.id);
   const lastRun = one(db, 'SELECT * FROM task_runs WHERE task_id = ? AND ended_at IS NOT NULL ORDER BY ended_at DESC, id DESC LIMIT 1', task.id);
   const lastCompleted = one(db, "SELECT * FROM task_runs WHERE task_id = ? AND outcome = 'completed' ORDER BY ended_at DESC LIMIT 1", task.id);
   const asked = json(one(db, "SELECT payload FROM task_events WHERE task_id = ? AND kind = 'review_requested' ORDER BY id DESC LIMIT 1", task.id)?.payload, {}) ?? {};
@@ -94,9 +105,9 @@ export function scopeOf(db, board, task, { params, event = {}, extra = {} } = {}
     goal_mode: Boolean(task.goal_mode),
     implementer: asked.implementer ?? task.assignee,
     last_reviewer: changes.reviewer ?? null,
-    arc: task.subtask_of ? one(db, 'SELECT id, status, title, body, assignee FROM tasks WHERE id = ?', task.subtask_of) ?? null : null,
+    arc: task.subtask_of ? one(db, `SELECT t.id, ${related}, t.title, t.body, t.assignee FROM tasks t LEFT JOIN supercode_cards c ON c.task_id = t.id WHERE t.id = ?`, task.subtask_of) ?? null : null,
     // the cards filed as its subtasks (`create --subtask-of`), in the order they were filed
-    subtasks: all(db, 'SELECT t.id, t.status, t.title, t.assignee FROM tasks t JOIN supercode_cards c ON c.task_id = t.id WHERE c.subtask_of = ? ORDER BY t.created_at', task.id),
+    subtasks: all(db, `SELECT t.id, ${related}, t.title, t.assignee FROM tasks t JOIN supercode_cards c ON c.task_id = t.id WHERE c.subtask_of = ? ORDER BY t.created_at`, task.id),
     queue_reason: json(one(db, "SELECT payload FROM task_events WHERE task_id = ? AND kind = 'respawn_guarded' AND created_at >= ? ORDER BY id DESC LIMIT 1",
       task.id, Number(one(db, 'SELECT since FROM supercode_cards WHERE task_id = ?', task.id)?.since ?? 0))?.payload, {})?.reason ?? null,
     last_block_event: one(db, "SELECT kind FROM task_events WHERE task_id = ? AND kind IN ('blocked', 'unblocked') ORDER BY id DESC LIMIT 1", task.id)?.kind ?? null,
@@ -109,6 +120,12 @@ export function scopeOf(db, board, task, { params, event = {}, extra = {} } = {}
     last_events: Object.fromEntries(all(db, 'SELECT e.kind, e.created_at, e.payload FROM task_events e JOIN (SELECT kind, MAX(id) AS id FROM task_events WHERE task_id = ? GROUP BY kind) l ON l.id = e.id', task.id)
       .map((r) => [r.kind, { created_at: r.created_at, payload: json(r.payload, {}) ?? {} }])),
     comments_since: (t) => all(db, 'SELECT author, body, created_at FROM task_comments WHERE task_id = ? AND created_at >= ?', task.id, t),
+    // the latest commit in the card's workspace (a subtask's: its arc's), as epoch seconds; null outside a repository
+    last_commit_at: () => {
+      const own = task.workspace_kind !== 'scratch' ? task.workspace_path : null;
+      const arcWs = !own && task.subtask_of ? one(db, "SELECT workspace_path FROM tasks WHERE id = ? AND workspace_kind != 'scratch'", task.subtask_of)?.workspace_path : null;
+      return lastCommitAt(own ?? arcWs ?? null);
+    },
   };
   return {
     card,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-orchestrator",
-  "version": "0.4.43",
+  "version": "0.4.45",
   "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": {