@volter/supercode-orchestrator 0.4.75 → 0.4.76

package/board/engine.mjs

@@ -105,7 +105,7 @@ export function currentRun(db, taskId) {
 export function setRunSession(db, runId, session) {
   const row = one(db, 'SELECT metadata FROM task_runs WHERE id = ?', runId);
   const whole = json(row?.metadata, {}) ?? {};
-  whole.supercode = session;
+  whole.supercode = { ...whole.supercode, ...session };
   run(db, 'UPDATE task_runs SET metadata = ? WHERE id = ?', JSON.stringify(whole), runId);
   return whole;
 }

package/board/store.mjs

@@ -203,6 +203,17 @@ export const actorOf = () => actor;
 export function setActor(address) { actor = address || null; }
 
 export function event(db, taskId, kind, payload = null, runId = null) {
+  // Session observations belong to the run machine. Legacy runs without a machine state retain
+  // their Hermes event stream; a new instance never sends supervision as card notices.
+  if (runId && ['claimed', 'spawned', 'session_started', 'session_resumed', 'session_replaced', 'session_adopted', 'claim_extended'].includes(kind)) {
+    const row = db.prepare('SELECT metadata FROM task_runs WHERE id = ?').get(runId);
+    const meta = json(row?.metadata, {}) ?? {};
+    if (meta.supercode?.state) {
+      meta.events = [...(meta.events ?? []), { kind, payload, by: actor, at: now() }];
+      db.prepare('UPDATE task_runs SET metadata = ? WHERE id = ?').run(JSON.stringify(meta), runId);
+      return 0;
+    }
+  }
   const said = actor && !(payload && 'by' in payload) ? { ...(payload ?? {}), by: actor } : payload;
   const r = db.prepare('INSERT INTO task_events (task_id, run_id, kind, payload, created_at) VALUES (?, ?, ?, ?, ?)')
     .run(taskId, runId, kind, said ? JSON.stringify(said) : null, now());

package/board/workflow.mjs

@@ -5,7 +5,7 @@
 // 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 { readFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { resolve, relative, isAbsolute } from 'node:path';
 import { randomBytes } from 'node:crypto';
 import { actorOf, event as record, json, now } from './store.mjs';
@@ -64,6 +64,7 @@ export function storedAs(workflow, status) {
 
 /** Where a card interrupted in `status` resumes: its `exited` transition's unguarded target (data, not a rule here). */
 export function resumeOf(workflow, status) {
+  if (workflow.statuses[status]?.resume_as) return workflow.statuses[status].resume_as;
   const exited = workflow.statuses[status]?.on?.exited ?? [];
   const fallback = [...exited].reverse().find((t) => !t.guard && t.target && !t.target.includes('{{'));
   return fallback?.target ?? status;
@@ -221,6 +222,8 @@ export function scopeOf(db, board, task, { params, event = {}, extra = {} } = {}
       return lastCommitAt(own ?? arcWs ?? null, task.id);
     },
   };
+  const runMeta = json(currentRun?.metadata, {}) ?? {};
+  for (const e of runMeta.events ?? []) card.last_events[e.kind] = { created_at: e.at, payload: e.payload ?? {} };
   for (const [key, expr] of Object.entries(loaded.get(board.root)?.workflow?.derived ?? {})) card[key] = evaluate(expr, { card, event, params, now: now() });
   return {
     card,
@@ -278,6 +281,7 @@ export function fire(db, board, entry, id, name, { roles = [], payload = {}, ext
   const effects = [];
   const to = take(db, board, entry, task, from, taken, scope, effects);
   settle(db, board, entry, id, effects);
+  projectStatus(db, board, entry, id);
   return { from, to: statusOf(db, cardOf(db, id)), moved: to !== from, effects };
 }
 
@@ -346,7 +350,7 @@ export function settle(db, board, entry, id, effects = []) {
     const scope = scopeOf(db, board, task, { params, extra: { lanes: lanesIn(entry) } });
     let t = (workflow.statuses[from]?.always ?? []).find((x) => holds(x.guard ?? null, scope));
     if (!t) t = dueAfter(db, workflow, task, from, scope);
-    if (!t) return effects;
+    if (!t) { projectStatus(db, board, entry, id); return effects; }
     const to = take(db, board, entry, task, from, t, scope, effects);
     if (to === from) return effects;
   }
@@ -708,6 +712,7 @@ export function runSpec(entry, status) {
   const file = resolve(entry.root, spec.prompt_file);
   const rel = relative(entry.root, file);
   if (rel.startsWith('..') || isAbsolute(rel)) throw new Error('prompt file must live in the orchestration home');
+  if (!existsSync(file) && spec.prompt) return spec; // embedded prompts of the built-in instance
   return { ...spec, prompt: readFileSync(file, 'utf8') };
 }
 
@@ -728,7 +733,7 @@ export function fireRun(db, board, entry, id, name, { roles = [], payload = {},
   const from = meta.supercode?.state ?? machine.initial;
   const scope = scopeOf(db, board, task, { params: entry.params, event: payload, extra: { ...extra, sender: roles, run: { ...row, state: from } } });
   const candidates = [...(machine.states[from]?.on?.[name] ?? []), ...(machine.on?.[name] ?? [])];
-  const t = candidates.find((t) => (!t.by?.length || t.by.some((r) => roles.includes(r))) && holds(t.guard ?? null, scope));
+  const t = candidates.find((t) => (!t.from?.length || t.from.includes(from)) && (!t.by?.length || t.by.some((r) => roles.includes(r))) && holds(t.guard ?? null, scope));
   if (!t) { const error = new Error(`${id}: run event ${name} does not apply`); error.noTransition = true; throw error; }
   for (const v of t.validate ?? []) if (!holds(v.expr, scope)) throw new Error(v.message);
   const to = t.target ? String(templateValue(t.target, scope)) : from;
@@ -746,6 +751,7 @@ export function fireRun(db, board, entry, id, name, { roles = [], payload = {},
     const outcome = (machine.outcomes?.[to] ?? []).find((t) => holds(t.guard ?? null, after));
     if (outcome) take(db, board, entry, cardOf(db, id), statusOf(db, cardOf(db, id)), outcome, after, effects);
   }
+  projectStatus(db, board, entry, id);
   return { from: status, to: statusOf(db, cardOf(db, id)), effects };
 }
 
@@ -762,3 +768,15 @@ function settleRelations(db, board, entry, id, effects) {
     if (name) effects.push(...fire(db, board, entry, id, name, { roles: ['platform'], payload: { on: block.id, reason: answer ? `reply ${answer}` : `${block.id} ${status}` } }).effects);
   }
 }
+
+
+export function projectStatus(db, board, entry, id) {
+  if (!entry.workflow.stored_as?.length) return;
+  const task = cardOf(db, id);
+  const status = statusOf(db, task);
+  const scope = scopeOf(db, board, task, { params: entry.params });
+  const rule = entry.workflow.stored_as.find((r) => holds(r.guard, scope));
+  const stored = rule?.status ?? storedAs(entry.workflow, status);
+  run(db, 'UPDATE tasks SET status = ? WHERE id = ?', stored, id);
+  run(db, 'INSERT INTO supercode_cards (task_id, stage) VALUES (?, ?) ON CONFLICT(task_id) DO UPDATE SET stage = excluded.stage', id, status);
+}

package/package.json

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