pantheon-opencode 1.5.0-beta.10 → 1.5.0-beta.11

package/CHANGELOG.md

@@ -18,6 +18,34 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## ✅ Closed Issues
 
+## [v1.5.0-beta.11] - 2026-09-14
+
+<!-- Add new changes here. Running `node scripts/versioning.mjs apply` will
+     move this section to a versioned entry and reset the template below. -->
+
+## 🆕 What's New
+
+- **Glyphs da FSM real no painel Delegations:** cada estado do BackgroundJobBoard
+  tem agora um glifo Unicode geométrico próprio — `⠋` running (spinner 1s),
+  `⟳` retry, `⚠` stale/startup, `✓` completed, `✕` error, `−` cancelled. Forma e
+  cor são canais independentes: as linhas seguem legíveis sem cor e sem Nerd Font.
+- **Prefixo `nat:` / `pan:` documentado:** `docs/INSTALLATION.md` passa a
+  descrever os prefixos curtos das linhas nativas (`nat:<agent>`) e do board
+  (`pan:<alias>`) e o par de glyphs ◇/◆.
+- **`scripts/dev-tui.sh` (dev local sem publish):** instala, builda e registra o
+  caminho absoluto do repo em `.opencode/tui.json` (gitignored) com hint de
+  restart — sem tocar `opencode.json` e sem publicar.
+- **104 testes TUI delegations:** `tests/pantheon/tui-delegations.test.ts` com
+  104/104 passando, cobrindo glifos/marker/tone dos estados reais da FSM.
+
+## 🐞 Fixed
+
+- **Doctor F.2 (`hasUsableScripts`):** a resolução do diretório code-mode agora
+  exige um `.py`/`.sh` regular (paridade com `_has_usable_scripts` do MCP), então
+  um overlay de projeto vazio não mascara mais uma instalação que traz scripts.
+- **`publish:next` órfão removido:** nenhum workflow usava o script (o release
+  publica via `--tag beta`); removido do `package.json` para eliminar o dist-tag
+  `next` obsoleto da linha de publicação.
 ## [v1.5.0-beta.10] - 2026-09-14
 
 &lt;!-- Add new changes here. Running `node scripts/versioning.mjs apply` will

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.5.0-beta.10",
+  "version": "1.5.0-beta.11",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "type": "module",
   "publishConfig": {
@@ -31,7 +31,6 @@
     "release:dry-run": "node scripts/versioning.mjs status && node scripts/release-notes.mjs && node scripts/package-evidence.mjs",
     "package:evidence": "node scripts/package-evidence.mjs",
     "package:validate": "node scripts/validate-package.mjs",
-    "publish:next": "npm publish --tag next --access public",
     "lint": "biome ci .",
     "typecheck": "tsc --noEmit",
     "audit": "npm audit --audit-level=high",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon",
   "publisher": "ils15",
-  "version": "1.5.0-beta.10",
+  "version": "1.5.0-beta.11",
   "displayName": "Pantheon",
   "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 21 skills, and OpenCode support.",
   "agents": "./src/agents",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.backends._legacy:_Backend"
 
 [project]
 name = "pantheon"
-version = "1.5.0-beta.10"
+version = "1.5.0-beta.11"
 description = "Multi-agent orchestration framework"
 requires-python = ">=3.11"
 dependencies = []

package/scripts/dev-tui.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# dev-tui.sh — load the Pantheon TUI from the repo (src/plugins/tui) WITHOUT publishing.
+#
+# Flow: build the bundle → register the repo's absolute path in
+# .opencode/tui.json (read by the OpenCode TUI loader) → restart hint.
+# It deliberately does NOT touch opencode.json: that file is packaged and
+# merged into user configs by the installer, so a repo-relative path would
+# leak into third-party installs and break the CI package gates.
+#
+# Usage: scripts/dev-tui.sh [--test]
+#   --test   also run the full repo test suite (npm run test:all) after build.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TUI_DIR="$ROOT/src/plugins/tui"
+TUI_JSON="$ROOT/.opencode/tui.json"
+
+command -v npm >/dev/null 2>&1 || { echo "error: npm not found in PATH" >&2; exit 1; }
+[ -d "$TUI_DIR" ] || { echo "error: TUI source not found: $TUI_DIR" >&2; exit 1; }
+
+echo "==> TUI dev source: $TUI_DIR"
+
+# 1. Install pinned deps + build dist/tui.js (dist/tui.tsx is copied by build).
+echo "==> Installing TUI dev dependencies (npm ci)"
+npm ci --prefix "$TUI_DIR" --ignore-scripts --no-audit --no-fund
+
+echo "==> Building TUI plugin"
+npm run build --prefix "$TUI_DIR"
+
+# 2. Optional: full suite to match the CI gate before opening a PR.
+if [[ "${1:-}" == "--test" ]]; then
+  echo "==> Running full test suite (npm run test:all)"
+  npm run test:all
+fi
+
+# 3. Register the repo path in the project tui.json (absolute, gitignored).
+#    Reuses the installer's registerPlugin so the array is merged, not clobbered.
+echo "==> Registering repo TUI path in $TUI_JSON"
+ROOT="$ROOT" TUI_JSON="$TUI_JSON" TUI_DIR="$TUI_DIR" node --input-type=module <<'NODE'
+const { registerPlugin } = await import(`${process.env.ROOT}/scripts/install/plugin.mjs`)
+const result = registerPlugin(process.env.TUI_JSON, process.env.TUI_DIR)
+console.log(`${result}: ${process.env.TUI_DIR}`)
+NODE
+
+# 4. Restart hint + dev-mode caveat.
+echo "==> Done. Restart OpenCode to load the rebuilt TUI plugin."
+echo "    Dev mode caveat: do NOT run 'init' in this repo while iterating — it"
+echo "    removes repo path refs as stale. If you do, re-run scripts/dev-tui.sh."

package/scripts/doctor.mjs

@@ -23,7 +23,7 @@
 
 import { spawn as spawnAsync, spawnSync } from 'node:child_process'
 import { createHash } from 'node:crypto'
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from 'node:fs'
+import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { basename, dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -959,6 +959,35 @@ function checkVenvLayer(args) {
 // Check F.2: Code-Mode Scripts Directory
 // ---------------------------------------------------------------------------
 
+/**
+ * Return whether *dir* contains an executable code-mode target.
+ *
+ * Mirrors `_has_usable_scripts` in `scripts/code_mode_server.py`: a directory
+ * is only a valid resolver candidate when it is a real (non-symlink) directory
+ * containing a regular `.py`/`.sh` direct child. This prevents an empty project
+ * overlay from masking a lower-priority installation that actually ships
+ * scripts. Keep both implementations in sync (see tests/test_doctor_layers.mjs).
+ */
+function hasUsableScripts(dir) {
+  try {
+    if (!existsSync(dir)) return false
+    const stat = lstatSync(dir)
+    if (stat.isSymbolicLink() || !stat.isDirectory()) return false
+    return readdirSync(dir).some((name) => {
+      if (name.startsWith('.')) return false
+      const lower = name.toLowerCase()
+      if (!lower.endsWith('.py') && !lower.endsWith('.sh')) return false
+      try {
+        return statSync(join(dir, name)).isFile()
+      } catch {
+        return false
+      }
+    })
+  } catch {
+    return false
+  }
+}
+
 /**
  * Verify the code-mode scripts directory exists for the resolved runtime
  * root (project → <target>/.opencode, otherwise the global config dir).
@@ -977,7 +1006,7 @@ export function checkCodeModeDir(args) {
   // install (.opencode present) gets its runtime dir created when missing.
   // Only targets with no project layout fall back to the global config dir.
   const codeModeDir =
-    projectCandidates.find((candidate) => existsSync(candidate)) ??
+    projectCandidates.find(hasUsableScripts) ??
     (existsSync(join(target, '.opencode'))
       ? projectCandidates[0]
       : join(resolveOpenCodeConfigDir(env), '.pantheon', 'code-mode'))
@@ -1003,7 +1032,7 @@ export function resolveCodeModeDir(args) {
     join(target, '.opencode', '.pantheon', 'code-mode'),
     join(target, '.pantheon', 'code-mode'),
   ]
-  const projectDir = projectCandidates.find((candidate) => existsSync(candidate))
+  const projectDir = projectCandidates.find(hasUsableScripts)
   if (projectDir) return projectDir
   return join(resolveOpenCodeConfigDir(env), '.pantheon', 'code-mode')
 }

package/src/plugins/tui/dist/tui.d.ts

@@ -116,6 +116,27 @@ declare function delegationActivityLabel(entry: DelegationEntry): string;
 /** Return a deterministic spinner frame. The View ticks this every 1000ms
  *  (not 140ms — the fast tick flickered without adding information). */
 declare function delegationSpinnerFrame(now: number): string;
+/** Every state the row knows how to draw: the real BackgroundJobBoard FSM
+ *  (src/pantheon/background-job-board.ts) plus the TUI display-only states
+ *  (`retry`, `stale-running`). Fase 1 deliberately omits speculative
+ *  blocked/paused/scheduled/skipped. There is no `pending` display state: a
+ *  pre-dispatch tool part maps to `running` in {@link reduceDelegationToolPart}. */
+type DelegationDisplayState = DelegationEntry['state'];
+/** Static glyph per display state. `running` shows its base spinner frame;
+ *  callers that animate must prefer {@link delegationStateMarker}. Unicode
+ *  geometric shapes only (no Nerd Font) — shape is an independent channel
+ *  from color, so rows stay legible without color. */
+declare const DELEGATION_STATE_GLYPHS: Readonly<Record<DelegationDisplayState, string>>;
+declare function delegationStateGlyph(state: DelegationDisplayState): string;
+/** Row marker (`<glyph> `) — the state channel. `running` animates through
+ *  {@link delegationSpinnerFrame} for the given tick; every other state is
+ *  static. Pure. */
+declare function delegationStateMarker(state: DelegationDisplayState, now?: number): string;
+/** Semantic tone mapped to the TUI theme at the row ({@link DelegationRow}).
+ *  Kept separate + pure so the color channel is testable without booting the
+ *  renderer. */
+type DelegationStateTone = 'warning' | 'error' | 'success' | 'muted';
+declare function delegationStateTone(state: DelegationDisplayState): DelegationStateTone;
 type ToolActivity = {
   tool: string;
   summary: string;
@@ -413,5 +434,5 @@ declare const plugin: TuiPluginModule & {
   setup: () => Promise<void>;
 };
 //#endregion
-export { ChildDelegationLike, DELEGATION_DESCRIPTION_MAX, DELEGATION_ELAPSED_WIDTH, DelegationActivity, DelegationEntry, DelegationToolPart, IDLE_SILENCE_MS, LiveDelegationEntry, LiveDelegationStore, ParsedDelegationToolPart, STALE_RUNNING_THRESHOLD_MS, ToolActivity, TuiSessionSources, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, countDelegationSources, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationIcon, delegationSpinnerFrame, delegationTag, extractToolActivity, fmtElapsed, formatDelegationElapsed, formatDelegationHeader, formatDelegationIdentity, formatDelegationRow, formatPanelLogLine, isValidSessionId, latestToolActivityFor, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, splitDelegationList, toDelegationEntry, trackToolActivity, truncateDelegationDescription, tuiLogPath, visibleDelegationList };
+export { ChildDelegationLike, DELEGATION_DESCRIPTION_MAX, DELEGATION_ELAPSED_WIDTH, DELEGATION_STATE_GLYPHS, DelegationActivity, DelegationDisplayState, DelegationEntry, DelegationStateTone, DelegationToolPart, IDLE_SILENCE_MS, LiveDelegationEntry, LiveDelegationStore, ParsedDelegationToolPart, STALE_RUNNING_THRESHOLD_MS, ToolActivity, TuiSessionSources, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, countDelegationSources, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationIcon, delegationSpinnerFrame, delegationStateGlyph, delegationStateMarker, delegationStateTone, delegationTag, extractToolActivity, fmtElapsed, formatDelegationElapsed, formatDelegationHeader, formatDelegationIdentity, formatDelegationRow, formatPanelLogLine, isValidSessionId, latestToolActivityFor, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, splitDelegationList, toDelegationEntry, trackToolActivity, truncateDelegationDescription, tuiLogPath, visibleDelegationList };
 //# sourceMappingURL=tui.d.ts.map

package/src/plugins/tui/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;KAu7BY;;EAEV;;EAEA;;;;EAIA;;EAEA;EACA;;EAUA;;EAEA;EACA;EACA;;EAEA;;;;EAQA;;;;;;;;;;;iBAsBc,wBACd,aACA,oBACA,qBACC;;;;;;iBAkHmB,sBAAsB,cAAc,QAAQ;;;;;;;;iBAwC5C,yBAAyB,eAAe,QAAQ;;;;;;;;iBAWtD,sBACd;EAAS;EAAoB;eAC7B;;;;;;iBAYc,YAAY;;;iBAMZ,WAAW;;;;iBAOX,yBAAyB,GAAG,iBAAiB,GAAG;;;;;iBAahD,oBACd,cAAc,mBACd,oBACA,cACA;EACG,QAAQ;EAAmB,QAAQ;EAAmB,UAAU;;;;;iBAqBrD,sBACd,cAAc,mBACd,sBACA,cACA,4BACC;;cAMU;;;;cAKA;;;;;;;;;iBAUG,mBACd,OAAO,iBACP,aACA,uBACC;;;iBAWa,WAAW;;;;iBAeX,kBAAkB,OAAO,iBAAiB;;;KAQ9C;iBAQI,mBAAmB,OAAO,kBAAkB;iBAc5C,wBAAwB,OAAO;;;iBAsB/B,uBAAuB;KAY3B;EACV;EACA;EACA;;;;;iBA0Bc,oBACd;EACE;EACA;EACA;EACA;IAAU;IAAiB,QAAQ;;GAErC;EACG;EAAmB,UAAU;;;iBAYlB,kBACd,KAAK,YAAY,eACjB,mBACA,UAAU;;iBAWI,sBACd,KAAK,YAAY,eACjB,+BACA,cACA,iBACC;;;;;;;iBAca,4BACd,mBAAmB,mBACnB,eAAe,wBACd;;KAqFS;EACV;EACA;EACA;EACA;EACA;EACA;IACE;IACA,QAAQ;IACR;IACA;IACA;MAAS;MAAgB;;;;;KAKjB;;EAEV;;EAEA;;EAEA;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA;;;KAIU;EACV;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;iBAec,wBACd,MAAM,oBACN,eACC;;;iBAgGa,yBACd,KAAK,YAAY,sBACjB,MAAM,oBACN;;;iBAiGc,sBACd,KAAK,YAAY,sBACjB;;;;;;;;;iBAoBc,2BACd;EAAqB;EAAa;iBAClC,YAAY,uDACX;;;;;iBA6Ba,sBACd,KAAK,YAAY,sBACjB,gBAAgB,sBAChB;;;iBAWc,kBAAkB,MAAM,sBAAsB;;;;;;iBAqB9C,uBACd,eAAe,uBACf,aAAa,oBACZ;;;;;;;;;iBA8Da,iBAAiB,cAAc;;;;KAOnC;;EAEV;EACA;;IAEE;MAAU;;;IAEV;MAAU;QAAY;QAAe,SAAS;;;;;;;;;;iBASlC,wBAAwB,SAAS;;;;;;;;iBAmBjC,gBAAgB;EAAgB;IAAQ;;;;;;;iBASxC,kBAAkB;EAAkC;IAAQ;;;;KAKhE;;EAEV;;EAEA;;;EAGA;;;EAGA;EACA;IACE;IACA;;;;;;;iBAQY,mBAAmB;;;;;;;;;;;;;iBAkBnB,cAAc,OAAO;;;;;iBAQrB,eAAe,OAAO;;;;iBAOtB,yBAAyB,OAAO;;;cAQnC;;;;iBAoBG,8BACd,cACA;;;;cAUW;iBAEG,wBACd,OAAO,iBACP,aACA;;;iBASc,oBAAoB,OAAO,iBAAiB;;;;iBAY5C,uBAAuB,kBAAkB;;;;iBAazC,uBAAuB,kBAAkB;EACvD;EACA;EACA;;;;;iBAUc,mBACd,kBACA,kBACA,gBACA,YACA;;;;;;;;;;;;;;;;;;iBAsBc,4BACd,mBAAmB,mCACnB,aAAa,mBACb,eACC;;;;;;iBA4Ca,4BACd;EAAS,YAAY,cAAc,SAAS;eAC5C;;;;;KA4MU;EACV,KAAK,YAAY;;EAEjB;;EAEA;;cAsgBI,QAAQ;EAAoB;EAAY,aAAa"}
+{"version":3,"file":"tui.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;KAu7BY;;EAEV;;EAEA;;;;EAIA;;EAEA;EACA;;EAUA;;EAEA;EACA;EACA;;EAEA;;;;EAQA;;;;;;;;;;;iBAsBc,wBACd,aACA,oBACA,qBACC;;;;;;iBAkHmB,sBAAsB,cAAc,QAAQ;;;;;;;;iBAwC5C,yBAAyB,eAAe,QAAQ;;;;;;;;iBAWtD,sBACd;EAAS;EAAoB;eAC7B;;;;;;iBAYc,YAAY;;;iBAMZ,WAAW;;;;iBAOX,yBAAyB,GAAG,iBAAiB,GAAG;;;;;iBAahD,oBACd,cAAc,mBACd,oBACA,cACA;EACG,QAAQ;EAAmB,QAAQ;EAAmB,UAAU;;;;;iBAqBrD,sBACd,cAAc,mBACd,sBACA,cACA,4BACC;;cAMU;;;;cAKA;;;;;;;;;iBAUG,mBACd,OAAO,iBACP,aACA,uBACC;;;iBAWa,WAAW;;;;iBAeX,kBAAkB,OAAO,iBAAiB;;;KAQ9C;iBAQI,mBAAmB,OAAO,kBAAkB;iBAc5C,wBAAwB,OAAO;;;iBAsB/B,uBAAuB;;;;;;KAU3B,yBAAyB;;;;;cAMxB,yBAAyB,SAAS,OAAO;iBAWtC,qBAAqB,OAAO;;;;iBAO5B,sBAAsB,OAAO,wBAAwB;;;;KAQzD;iBAEI,oBAAoB,OAAO,yBAAyB;KAwBxD;EACV;EACA;EACA;;;;;iBA0Bc,oBACd;EACE;EACA;EACA;EACA;IAAU;IAAiB,QAAQ;;GAErC;EACG;EAAmB,UAAU;;;iBAYlB,kBACd,KAAK,YAAY,eACjB,mBACA,UAAU;;iBAWI,sBACd,KAAK,YAAY,eACjB,+BACA,cACA,iBACC;;;;;;;iBAca,4BACd,mBAAmB,mBACnB,eAAe,wBACd;;KAqFS;EACV;EACA;EACA;EACA;EACA;EACA;IACE;IACA,QAAQ;IACR;IACA;IACA;MAAS;MAAgB;;;;;KAKjB;;EAEV;;EAEA;;EAEA;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA;;;KAIU;EACV;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;iBAec,wBACd,MAAM,oBACN,eACC;;;iBAgGa,yBACd,KAAK,YAAY,sBACjB,MAAM,oBACN;;;iBAiGc,sBACd,KAAK,YAAY,sBACjB;;;;;;;;;iBAoBc,2BACd;EAAqB;EAAa;iBAClC,YAAY,uDACX;;;;;iBA6Ba,sBACd,KAAK,YAAY,sBACjB,gBAAgB,sBAChB;;;iBAWc,kBAAkB,MAAM,sBAAsB;;;;;;iBAqB9C,uBACd,eAAe,uBACf,aAAa,oBACZ;;;;;;;;;iBA8Da,iBAAiB,cAAc;;;;KAOnC;;EAEV;EACA;;IAEE;MAAU;;;IAEV;MAAU;QAAY;QAAe,SAAS;;;;;;;;;;iBASlC,wBAAwB,SAAS;;;;;;;;iBAmBjC,gBAAgB;EAAgB;IAAQ;;;;;;;iBASxC,kBAAkB;EAAkC;IAAQ;;;;KAKhE;;EAEV;;EAEA;;;EAGA;;;EAGA;EACA;IACE;IACA;;;;;;;iBAQY,mBAAmB;;;;;;;;;;;;;iBAkBnB,cAAc,OAAO;;;;;iBAQrB,eAAe,OAAO;;;;iBAOtB,yBAAyB,OAAO;;;cAQnC;;;;iBAoBG,8BACd,cACA;;;;cAUW;iBAEG,wBACd,OAAO,iBACP,aACA;;;iBASc,oBAAoB,OAAO,iBAAiB;;;;iBAY5C,uBAAuB,kBAAkB;;;;iBAazC,uBAAuB,kBAAkB;EACvD;EACA;EACA;;;;;iBAUc,mBACd,kBACA,kBACA,gBACA,YACA;;;;;;;;;;;;;;;;;;iBAsBc,4BACd,mBAAmB,mCACnB,aAAa,mBACb,eACC;;;;;;iBA4Ca,4BACd;EAAS,YAAY,cAAc,SAAS;eAC5C;;;;;KA4LU;EACV,KAAK,YAAY;;EAEjB;;EAEA;;cAsgBI,QAAQ;EAAoB;EAAY,aAAa"}

package/src/plugins/tui/dist/tui.js

@@ -164,7 +164,7 @@ async function detectVersion(api) {
 			if (ver) return ver;
 		}
 	} catch {}
-	return "1.5.0-beta.10";
+	return "1.5.0-beta.11";
 }
 /**
 * usage-bar — AI subscription usage gauge for the opencode TUI.
@@ -977,6 +977,49 @@ function delegationSpinnerFrame(now) {
 	const index = Math.floor(Math.max(0, now) / 1e3) % DELEGATION_SPINNER_FRAMES.length;
 	return DELEGATION_SPINNER_FRAMES[index] ?? DELEGATION_SPINNER_FRAMES[0];
 }
+/** Every state the row knows how to draw: the real BackgroundJobBoard FSM
+*  (src/pantheon/background-job-board.ts) plus the TUI display-only states
+*  (`retry`, `stale-running`). Fase 1 deliberately omits speculative
+*  blocked/paused/scheduled/skipped. There is no `pending` display state: a
+*  pre-dispatch tool part maps to `running` in {@link reduceDelegationToolPart}. */
+/** Static glyph per display state. `running` shows its base spinner frame;
+*  callers that animate must prefer {@link delegationStateMarker}. Unicode
+*  geometric shapes only (no Nerd Font) — shape is an independent channel
+*  from color, so rows stay legible without color. */
+const DELEGATION_STATE_GLYPHS = {
+	running: "⠋",
+	retry: "⟳",
+	"stale-running": "⚠",
+	completed: "✓",
+	error: "✕",
+	cancelled: "−",
+	startup_failed: "⚠",
+	startup_unknown: "⚠"
+};
+function delegationStateGlyph(state) {
+	return DELEGATION_STATE_GLYPHS[state];
+}
+/** Row marker (`<glyph> `) — the state channel. `running` animates through
+*  {@link delegationSpinnerFrame} for the given tick; every other state is
+*  static. Pure. */
+function delegationStateMarker(state, now = Date.now()) {
+	return `${state === "running" ? delegationSpinnerFrame(now) : delegationStateGlyph(state)} `;
+}
+/** Semantic tone mapped to the TUI theme at the row ({@link DelegationRow}).
+*  Kept separate + pure so the color channel is testable without booting the
+*  renderer. */
+function delegationStateTone(state) {
+	switch (state) {
+		case "running":
+		case "retry":
+		case "startup_unknown": return "warning";
+		case "stale-running":
+		case "error":
+		case "startup_failed": return "error";
+		case "completed": return "success";
+		case "cancelled": return "muted";
+	}
+}
 /** Bounded tracker: child session id → latest running tool call. */
 const latestToolActivity = /* @__PURE__ */ new Map();
 const MAX_TOOL_ACTIVITY_ENTRIES = 200;
@@ -1603,25 +1646,14 @@ function DelegationRow(props) {
 	const theme = () => props.api.theme.current;
 	const color = createMemo(() => {
 		const t = theme();
-		switch (props.job.state) {
-			case "running": return t.warning;
-			case "retry": return t.warning;
-			case "stale-running": return t.error;
-			case "completed": return t.success;
+		switch (delegationStateTone(props.job.state)) {
+			case "warning": return t.warning;
 			case "error": return t.error;
+			case "success": return t.success;
 			default: return t.textMuted;
 		}
 	});
-	const marker = createMemo(() => {
-		if (props.job.state === "running") return `${delegationSpinnerFrame(props.animationNow)} `;
-		if (props.job.state === "retry") return "⟳ ";
-		if (props.job.state === "stale-running") return "⚠ ";
-		switch (props.job.state) {
-			case "completed": return "✓ ";
-			case "error": return "✕ ";
-			default: return "○ ";
-		}
-	});
+	const marker = createMemo(() => delegationStateMarker(props.job.state, props.animationNow));
 	const tagColor = createMemo(() => props.job.source === "children-only" ? theme().info : color());
 	const description = createMemo(() => truncateDelegationDescription(props.job.description));
 	const elapsed = createMemo(() => formatDelegationElapsed(props.job, props.now));
@@ -2141,6 +2173,6 @@ const plugin = {
 	setup: async () => {}
 };
 //#endregion
-export { DELEGATION_DESCRIPTION_MAX, DELEGATION_ELAPSED_WIDTH, IDLE_SILENCE_MS, STALE_RUNNING_THRESHOLD_MS, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, countDelegationSources, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationIcon, delegationSpinnerFrame, delegationTag, extractToolActivity, fmtElapsed, formatDelegationElapsed, formatDelegationHeader, formatDelegationIdentity, formatDelegationRow, formatPanelLogLine, isValidSessionId, latestToolActivityFor, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, splitDelegationList, toDelegationEntry, trackToolActivity, truncateDelegationDescription, tuiLogPath, visibleDelegationList };
+export { DELEGATION_DESCRIPTION_MAX, DELEGATION_ELAPSED_WIDTH, DELEGATION_STATE_GLYPHS, IDLE_SILENCE_MS, STALE_RUNNING_THRESHOLD_MS, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, countDelegationSources, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationIcon, delegationSpinnerFrame, delegationStateGlyph, delegationStateMarker, delegationStateTone, delegationTag, extractToolActivity, fmtElapsed, formatDelegationElapsed, formatDelegationHeader, formatDelegationIdentity, formatDelegationRow, formatPanelLogLine, isValidSessionId, latestToolActivityFor, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, splitDelegationList, toDelegationEntry, trackToolActivity, truncateDelegationDescription, tuiLogPath, visibleDelegationList };
 
 //# sourceMappingURL=tui.js.map

package/src/plugins/tui/dist/tui.tsx

@@ -1354,6 +1354,62 @@ export function delegationSpinnerFrame(now: number): string {
   return DELEGATION_SPINNER_FRAMES[index] ?? DELEGATION_SPINNER_FRAMES[0]
 }
 
+/** Every state the row knows how to draw: the real BackgroundJobBoard FSM
+ *  (src/pantheon/background-job-board.ts) plus the TUI display-only states
+ *  (`retry`, `stale-running`). Fase 1 deliberately omits speculative
+ *  blocked/paused/scheduled/skipped. There is no `pending` display state: a
+ *  pre-dispatch tool part maps to `running` in {@link reduceDelegationToolPart}. */
+export type DelegationDisplayState = DelegationEntry['state']
+
+/** Static glyph per display state. `running` shows its base spinner frame;
+ *  callers that animate must prefer {@link delegationStateMarker}. Unicode
+ *  geometric shapes only (no Nerd Font) — shape is an independent channel
+ *  from color, so rows stay legible without color. */
+export const DELEGATION_STATE_GLYPHS: Readonly<Record<DelegationDisplayState, string>> = {
+  running: '\u280b', // ⠋ base frame of the animated spinner
+  retry: '\u27f3', // ⟳ retrying
+  'stale-running': '\u26a0', // ⚠ stale (display-only alert)
+  completed: '\u2713', // ✓
+  error: '\u2715', // ✕
+  cancelled: '\u2212', // − minus: stopped, distinct from error's ✕
+  startup_failed: '\u26a0', // ⚠ boot failed
+  startup_unknown: '\u26a0', // ⚠ boot outcome unknown
+}
+
+export function delegationStateGlyph(state: DelegationDisplayState): string {
+  return DELEGATION_STATE_GLYPHS[state]
+}
+
+/** Row marker (`<glyph> `) — the state channel. `running` animates through
+ *  {@link delegationSpinnerFrame} for the given tick; every other state is
+ *  static. Pure. */
+export function delegationStateMarker(state: DelegationDisplayState, now = Date.now()): string {
+  const glyph = state === 'running' ? delegationSpinnerFrame(now) : delegationStateGlyph(state)
+  return `${glyph} `
+}
+
+/** Semantic tone mapped to the TUI theme at the row ({@link DelegationRow}).
+ *  Kept separate + pure so the color channel is testable without booting the
+ *  renderer. */
+export type DelegationStateTone = 'warning' | 'error' | 'success' | 'muted'
+
+export function delegationStateTone(state: DelegationDisplayState): DelegationStateTone {
+  switch (state) {
+    case 'running':
+    case 'retry':
+    case 'startup_unknown':
+      return 'warning'
+    case 'stale-running':
+    case 'error':
+    case 'startup_failed':
+      return 'error'
+    case 'completed':
+      return 'success'
+    case 'cancelled':
+      return 'muted'
+  }
+}
+
 /* ─── Live tool activity per child session (beta.6) ────────────────────────
  *  The delegation panel's activity line ("↳ bash npm test") — what the agent
  *  is doing RIGHT NOW. Sourced from message.part.updated tool parts: every
@@ -2351,35 +2407,19 @@ function DelegationRow(props: {
 
   const color = createMemo(() => {
     const t = theme()
-    switch (props.job.state) {
-      case 'running':
-        return t.warning
-      case 'retry':
+    switch (delegationStateTone(props.job.state)) {
+      case 'warning':
         return t.warning
-      case 'stale-running':
-        return t.error // warning color for stale delegations
-      case 'completed':
-        return t.success
       case 'error':
         return t.error
+      case 'success':
+        return t.success
       default:
-        return t.textMuted // cancelled
+        return t.textMuted // muted (cancelled)
     }
   })
 
-  const marker = createMemo(() => {
-    if (props.job.state === 'running') return `${delegationSpinnerFrame(props.animationNow)} `
-    if (props.job.state === 'retry') return '\u27f3 ' // ⟳ retrying
-    if (props.job.state === 'stale-running') return '\u26a0 ' // warning triangle
-    switch (props.job.state) {
-      case 'completed':
-        return '\u2713 '
-      case 'error':
-        return '\u2715 '
-      default:
-        return '\u25cb '
-    }
-  })
+  const marker = createMemo(() => delegationStateMarker(props.job.state, props.animationNow))
 
   // Two visual channels split native task() from pantheon_delegate: the tag
   // prefix (`nat:`/`pan:`, via delegationTag) and the glyph color — info

package/src/plugins/tui/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pantheon-tui",
-  "version": "1.5.0-beta.10",
+  "version": "1.5.0-beta.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pantheon-tui",
-      "version": "1.5.0-beta.10",
+      "version": "1.5.0-beta.11",
       "license": "MIT",
       "dependencies": {
         "@opencode-ai/plugin": ">=1.14.0",

package/src/plugins/tui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon-tui",
   "type": "module",
-  "version": "1.5.0-beta.10",
+  "version": "1.5.0-beta.11",
   "description": "Pantheon TUI plugin — sidebar (version, preset, sessions, real-time delegations) + AI subscription usage gauges incl. OpenCode Go/Zen dollar limits (vendored, MIT)",
   "license": "MIT",
   "exports": {

package/src/plugins/tui/src/index.tsx

@@ -1354,6 +1354,62 @@ export function delegationSpinnerFrame(now: number): string {
   return DELEGATION_SPINNER_FRAMES[index] ?? DELEGATION_SPINNER_FRAMES[0]
 }
 
+/** Every state the row knows how to draw: the real BackgroundJobBoard FSM
+ *  (src/pantheon/background-job-board.ts) plus the TUI display-only states
+ *  (`retry`, `stale-running`). Fase 1 deliberately omits speculative
+ *  blocked/paused/scheduled/skipped. There is no `pending` display state: a
+ *  pre-dispatch tool part maps to `running` in {@link reduceDelegationToolPart}. */
+export type DelegationDisplayState = DelegationEntry['state']
+
+/** Static glyph per display state. `running` shows its base spinner frame;
+ *  callers that animate must prefer {@link delegationStateMarker}. Unicode
+ *  geometric shapes only (no Nerd Font) — shape is an independent channel
+ *  from color, so rows stay legible without color. */
+export const DELEGATION_STATE_GLYPHS: Readonly<Record<DelegationDisplayState, string>> = {
+  running: '\u280b', // ⠋ base frame of the animated spinner
+  retry: '\u27f3', // ⟳ retrying
+  'stale-running': '\u26a0', // ⚠ stale (display-only alert)
+  completed: '\u2713', // ✓
+  error: '\u2715', // ✕
+  cancelled: '\u2212', // − minus: stopped, distinct from error's ✕
+  startup_failed: '\u26a0', // ⚠ boot failed
+  startup_unknown: '\u26a0', // ⚠ boot outcome unknown
+}
+
+export function delegationStateGlyph(state: DelegationDisplayState): string {
+  return DELEGATION_STATE_GLYPHS[state]
+}
+
+/** Row marker (`<glyph> `) — the state channel. `running` animates through
+ *  {@link delegationSpinnerFrame} for the given tick; every other state is
+ *  static. Pure. */
+export function delegationStateMarker(state: DelegationDisplayState, now = Date.now()): string {
+  const glyph = state === 'running' ? delegationSpinnerFrame(now) : delegationStateGlyph(state)
+  return `${glyph} `
+}
+
+/** Semantic tone mapped to the TUI theme at the row ({@link DelegationRow}).
+ *  Kept separate + pure so the color channel is testable without booting the
+ *  renderer. */
+export type DelegationStateTone = 'warning' | 'error' | 'success' | 'muted'
+
+export function delegationStateTone(state: DelegationDisplayState): DelegationStateTone {
+  switch (state) {
+    case 'running':
+    case 'retry':
+    case 'startup_unknown':
+      return 'warning'
+    case 'stale-running':
+    case 'error':
+    case 'startup_failed':
+      return 'error'
+    case 'completed':
+      return 'success'
+    case 'cancelled':
+      return 'muted'
+  }
+}
+
 /* ─── Live tool activity per child session (beta.6) ────────────────────────
  *  The delegation panel's activity line ("↳ bash npm test") — what the agent
  *  is doing RIGHT NOW. Sourced from message.part.updated tool parts: every
@@ -2351,35 +2407,19 @@ function DelegationRow(props: {
 
   const color = createMemo(() => {
     const t = theme()
-    switch (props.job.state) {
-      case 'running':
-        return t.warning
-      case 'retry':
+    switch (delegationStateTone(props.job.state)) {
+      case 'warning':
         return t.warning
-      case 'stale-running':
-        return t.error // warning color for stale delegations
-      case 'completed':
-        return t.success
       case 'error':
         return t.error
+      case 'success':
+        return t.success
       default:
-        return t.textMuted // cancelled
+        return t.textMuted // muted (cancelled)
     }
   })
 
-  const marker = createMemo(() => {
-    if (props.job.state === 'running') return `${delegationSpinnerFrame(props.animationNow)} `
-    if (props.job.state === 'retry') return '\u27f3 ' // ⟳ retrying
-    if (props.job.state === 'stale-running') return '\u26a0 ' // warning triangle
-    switch (props.job.state) {
-      case 'completed':
-        return '\u2713 '
-      case 'error':
-        return '\u2715 '
-      default:
-        return '\u25cb '
-    }
-  })
+  const marker = createMemo(() => delegationStateMarker(props.job.state, props.animationNow))
 
   // Two visual channels split native task() from pantheon_delegate: the tag
   // prefix (`nat:`/`pan:`, via delegationTag) and the glyph color — info