pi-crew 0.10.6 → 0.11.1

package/package.json

@@ -1,171 +1,172 @@
 {
-  "name": "pi-crew",
-  "version": "0.10.6",
-  "description": "Pi extension for coordinated AI teams, workflows, worktrees, and async task orchestration",
-  "author": "baphuongna",
-  "license": "MIT",
-  "engines": {
-    "node": ">=22.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/baphuongna/pi-crew.git"
-  },
-  "homepage": "https://github.com/baphuongna/pi-crew#readme",
-  "bugs": {
-    "url": "https://github.com/baphuongna/pi-crew/issues"
-  },
-  "type": "module",
-  "bin": {
-    "pi-crew": "install.mjs"
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-coding-agent",
-    "teams",
-    "agents",
-    "multi-agent",
-    "orchestration"
-  ],
-  "files": [
-    "src/",
-    "!src/benchmark",
-    "dist/index.mjs",
-    "index.ts",
-    "install.mjs",
-    "agents/",
-    "teams/",
-    "workflows/",
-    "skills/**",
-    "themes/",
-    "assets/crew-vibes.ttf",
-    "scripts/clean-strip-types.mjs",
-    "scripts/postinstall.mjs",
-    "scripts/install-crew-vibes-font.mjs",
-    "scripts/build-crew-vibes-font.py",
-    "scripts/pty_probe.py",
-    "README.md",
-    "AGENTS.md",
-    "docs/actions-reference.md",
-    "docs/commands-reference.md",
-    "docs/troubleshooting.md",
-    "docs/usage.md",
-    "docs/architecture.md",
-    "docs/dynamic-workflows.md",
-    "docs/runtime-flow.md",
-    "docs/resource-formats.md",
-    "docs/publishing.md",
-    "docs/migration-v0.4-v0.5.md",
-    "tsconfig.json",
-    "schema.json",
-    "types/",
-    "CHANGELOG.md",
-    "LICENSE",
-    "NOTICE.md",
-    "scripts/resource-sampler.mjs",
-    "scripts/analyze-run.mjs"
-  ],
-  "scripts": {
-    "check": "npm run ci",
-    "ci": "npm run check:lockfile-sync && npm run typecheck && npm run lint && npm run format:check && npm run check:conflict-markers && npm run check:decision-drift && npm run check:env-vars && npm run check:event-types && npm run check:lazy-imports && npm run check:wc-gate && npm run check:bundle-staleness && npm run build:bundle && npm run check:bundle-size && npm run test:bundle && npm test && npm pack --dry-run",
-    "ci:fast": "npm run check:lockfile-sync && npm run typecheck && npm run lint && npm run format:check && npm run check:conflict-markers && npm run check:decision-drift && npm run check:env-vars && npm run check:event-types && npm run check:lazy-imports && npm run check:wc-gate && npm run check:bundle-staleness && npm run build:bundle && npm run check:bundle-size && npm run test:bundle && npm run test:critical && npm pack --dry-run",
-    "check:lockfile-sync": "node scripts/check-lockfile-sync.mjs",
-    "check:lazy-imports": "node scripts/check-lazy-imports.mjs",
-    "check:bundle-staleness": "node scripts/check-bundle-staleness.mjs",
-    "check:bundle-size": "node scripts/check-bundle-size.mjs",
-    "check:conflict-markers": "node scripts/check-conflict-markers.mjs",
-    "check:decision-drift": "node scripts/check-decision-drift.mjs",
-    "check:env-vars": "node scripts/check-env-vars.mjs",
-    "check:event-types": "node scripts/check-event-types-registry.mjs",
-    "typecheck": "tsc --noEmit && node --experimental-strip-types -e \"await import('./index.ts'); console.log('strip-types import ok')\"",
-    "lint": "biome check --linter-enabled=true --formatter-enabled=false --max-diagnostics=50 .",
-    "format:check": "biome format .",
-    "test": "npm run test:unit && npm run test:integration",
-    "test:full": "npm run test:unit && npm run test:integration && npm run test:integration:slow",
-    "test:unit": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=180000 --test-force-exit 'test/unit/**/*.test.ts'",
-    "test:critical": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=30000 --test-force-exit test/unit/runtime/broker/crew-broker-handshake.test.ts test/unit/runtime/broker/crew-broker-stale-socket.test.ts test/unit/runtime/broker/crew-broker-feature-flag.test.ts test/unit/runtime/broker/crew-broker-server-gate.test.ts test/unit/runtime/broker/crew-broker-client-fallback.test.ts test/unit/runtime/broker/crew-broker-mailbox-observer.test.ts test/unit/runtime/broker/crew-broker-close-during-reconnect.test.ts test/unit/runtime/broker/crew-broker-steer-dedup.test.ts test/unit/runtime/broker/crew-broker-symlink-steering.test.ts test/unit/ui/keybinding-map.parity.test.ts test/unit/ui/pi-tui-dispatch-probe.test.ts test/unit/utils/session-utils-extract.test.ts test/unit/config/config-schema-sync.test.ts test/unit/runtime/child-pi/child-pi-env-spread.test.ts",
-    "test:watch": "node scripts/test-runner.mjs --watch --test-concurrency=4 --test-timeout=30000 'test/unit/**/*.test.ts'",
-    "test:integration": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=300000 test/integration/*.test.ts",
-    "test:integration:slow": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=600000 test/integration/slow/*.test.ts",
-    "test:system": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=180000 --test-force-exit test/system/*.e2e.test.ts",
-    "test:smoke": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=180000 test/smoke/*.smoke.ts",
-    "test:spike": "node scripts/test-runner.mjs --test-concurrency=2 --test-timeout=120000 --test-force-exit test/runtime/scratchpad/*.test.ts",
-    "test:functional": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=120000 test/functional/pi-crew-functional.test.ts",
-    "test:platform": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=60000 test/platform/*.test.ts",
-    "build:bundle": "node scripts/build-bundle.mjs",
-    "test:bundle": "node --experimental-strip-types --test --test-force-exit test/unit/bundle-load.test.ts",
-    "watch:bundle": "node scripts/watch-bundle.mjs",
-    "build:bundle:once": "node scripts/watch-bundle.mjs --once",
-    "dev": "node scripts/dev-runner.mjs",
-    "postinstall": "node scripts/postinstall.mjs",
-    "install:crew-font": "node scripts/install-crew-vibes-font.mjs",
-    "build:crew-font": "python scripts/build-crew-vibes-font.py",
-    "bench": "node scripts/run-bench.mjs",
-    "bench:check": "node scripts/bench-check.mjs",
-    "test:new": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=30000 'test/unit/**/*.test.ts'",
-    "test:changed": "node scripts/test-changed.mjs",
-    "bench:capture": "node scripts/run-bench.mjs && node -e \"require('node:fs').copyFileSync('test/bench/results.json','test/bench/baseline.json')\"",
-    "profile:startup": "node scripts/profile-startup.mjs",
-    "smoke:pi": "pi install .",
-    "smoke:release": "node scripts/release-smoke.mjs",
-    "prepack": "node scripts/clean-strip-types.mjs",
-    "test:fast": "npm run test:critical && npm run test:bundle",
-    "check:wc-gate": "node scripts/wc-gate.mjs"
-  },
-  "exports": {
-    "./schema.json": "./schema.json",
-    "./workflow": {
-      "types": "./types/dwf.d.ts"
-    }
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ],
-    "skills": [
-      "./skills"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-agent-core": "*",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  },
-  "dependencies": {
-    "@sinclair/typebox": "^0.34.50",
-    "acorn": "^8.17.0",
-    "ajv": "^8.20.0",
-    "cli-highlight": "^2.1.11",
-    "diff": "^5.2.0",
-    "esbuild": "^0.28.1",
-    "jiti": "^2.7.0",
-    "yaml": "^2.9.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.5.3",
-    "@earendil-works/pi-agent-core": "^0.84.0",
-    "@earendil-works/pi-ai": "^0.84.0",
-    "@earendil-works/pi-coding-agent": "^0.84.0",
-    "@earendil-works/pi-tui": "^0.84.0",
-    "@types/node": "^25.9.5",
-    "tsx": "^4.23.0",
-    "typescript": "^7.0.2"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-agent-core": {
-      "optional": true
-    },
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    }
-  },
-  "readmeFilename": "README.md"
+	"name": "pi-crew",
+	"version": "0.11.1",
+	"description": "Pi extension for coordinated AI teams, workflows, worktrees, and async task orchestration",
+	"author": "baphuongna",
+	"license": "MIT",
+	"engines": {
+		"node": ">=22.0.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/baphuongna/pi-crew.git"
+	},
+	"homepage": "https://github.com/baphuongna/pi-crew#readme",
+	"bugs": {
+		"url": "https://github.com/baphuongna/pi-crew/issues"
+	},
+	"type": "module",
+	"bin": {
+		"pi-crew": "install.mjs"
+	},
+	"keywords": [
+		"pi-package",
+		"pi",
+		"pi-coding-agent",
+		"teams",
+		"agents",
+		"multi-agent",
+		"orchestration"
+	],
+	"files": [
+		"src/",
+		"!src/benchmark",
+		"dist/index.mjs",
+		"index.ts",
+		"install.mjs",
+		"agents/",
+		"teams/",
+		"workflows/",
+		"skills/**",
+		"themes/",
+		"assets/crew-vibes.ttf",
+		"scripts/clean-strip-types.mjs",
+		"scripts/postinstall.mjs",
+		"scripts/install-crew-vibes-font.mjs",
+		"scripts/build-crew-vibes-font.py",
+		"scripts/pty_probe.py",
+		"README.md",
+		"AGENTS.md",
+		"docs/actions-reference.md",
+		"docs/commands-reference.md",
+		"docs/troubleshooting.md",
+		"docs/usage.md",
+		"docs/architecture.md",
+		"docs/dynamic-workflows.md",
+		"docs/runtime-flow.md",
+		"docs/resource-formats.md",
+		"docs/publishing.md",
+		"docs/migration-v0.4-v0.5.md",
+		"tsconfig.json",
+		"schema.json",
+		"types/",
+		"CHANGELOG.md",
+		"LICENSE",
+		"NOTICE.md",
+		"scripts/resource-sampler.mjs",
+		"scripts/analyze-run.mjs",
+		"scripts/watch-agent-transcript.mjs"
+	],
+	"scripts": {
+		"check": "npm run ci",
+		"ci": "npm run check:lockfile-sync && npm run typecheck && npm run lint && npm run format:check && npm run check:conflict-markers && npm run check:decision-drift && npm run check:env-vars && npm run check:event-types && npm run check:lazy-imports && npm run check:wc-gate && npm run check:bundle-staleness && npm run build:bundle && npm run check:bundle-size && npm run test:bundle && npm test && npm pack --dry-run",
+		"ci:fast": "npm run check:lockfile-sync && npm run typecheck && npm run lint && npm run format:check && npm run check:conflict-markers && npm run check:decision-drift && npm run check:env-vars && npm run check:event-types && npm run check:lazy-imports && npm run check:wc-gate && npm run check:bundle-staleness && npm run build:bundle && npm run check:bundle-size && npm run test:bundle && npm run test:critical && npm pack --dry-run",
+		"check:lockfile-sync": "node scripts/check-lockfile-sync.mjs",
+		"check:lazy-imports": "node scripts/check-lazy-imports.mjs",
+		"check:bundle-staleness": "node scripts/check-bundle-staleness.mjs",
+		"check:bundle-size": "node scripts/check-bundle-size.mjs",
+		"check:conflict-markers": "node scripts/check-conflict-markers.mjs",
+		"check:decision-drift": "node scripts/check-decision-drift.mjs",
+		"check:env-vars": "node scripts/check-env-vars.mjs",
+		"check:event-types": "node scripts/check-event-types-registry.mjs",
+		"typecheck": "tsc --noEmit && node --experimental-strip-types -e \"await import('./index.ts'); console.log('strip-types import ok')\"",
+		"lint": "biome check --linter-enabled=true --formatter-enabled=false --max-diagnostics=50 .",
+		"format:check": "biome format .",
+		"test": "npm run test:unit && npm run test:integration",
+		"test:full": "npm run test:unit && npm run test:integration && npm run test:integration:slow",
+		"test:unit": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=180000 --test-force-exit 'test/unit/**/*.test.ts'",
+		"test:critical": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=30000 --test-force-exit test/unit/runtime/broker/crew-broker-handshake.test.ts test/unit/runtime/broker/crew-broker-stale-socket.test.ts test/unit/runtime/broker/crew-broker-feature-flag.test.ts test/unit/runtime/broker/crew-broker-server-gate.test.ts test/unit/runtime/broker/crew-broker-client-fallback.test.ts test/unit/runtime/broker/crew-broker-mailbox-observer.test.ts test/unit/runtime/broker/crew-broker-close-during-reconnect.test.ts test/unit/runtime/broker/crew-broker-steer-dedup.test.ts test/unit/runtime/broker/crew-broker-symlink-steering.test.ts test/unit/ui/keybinding-map.parity.test.ts test/unit/ui/pi-tui-dispatch-probe.test.ts test/unit/utils/session-utils-extract.test.ts test/unit/config/config-schema-sync.test.ts test/unit/runtime/child-pi/child-pi-env-spread.test.ts",
+		"test:watch": "node scripts/test-runner.mjs --watch --test-concurrency=4 --test-timeout=30000 'test/unit/**/*.test.ts'",
+		"test:integration": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=300000 test/integration/*.test.ts",
+		"test:integration:slow": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=600000 test/integration/slow/*.test.ts",
+		"test:system": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=180000 --test-force-exit test/system/*.e2e.test.ts",
+		"test:smoke": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=180000 test/smoke/*.smoke.ts",
+		"test:spike": "node scripts/test-runner.mjs --test-concurrency=2 --test-timeout=120000 --test-force-exit test/runtime/scratchpad/*.test.ts",
+		"test:functional": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=120000 test/functional/pi-crew-functional.test.ts",
+		"test:platform": "node scripts/test-runner.mjs --test-concurrency=1 --test-timeout=60000 test/platform/*.test.ts",
+		"build:bundle": "node scripts/build-bundle.mjs",
+		"test:bundle": "node --experimental-strip-types --test --test-force-exit test/unit/bundle-load.test.ts",
+		"watch:bundle": "node scripts/watch-bundle.mjs",
+		"build:bundle:once": "node scripts/watch-bundle.mjs --once",
+		"dev": "node scripts/dev-runner.mjs",
+		"postinstall": "node scripts/postinstall.mjs",
+		"install:crew-font": "node scripts/install-crew-vibes-font.mjs",
+		"build:crew-font": "python scripts/build-crew-vibes-font.py",
+		"bench": "node scripts/run-bench.mjs",
+		"bench:check": "node scripts/bench-check.mjs",
+		"test:new": "node scripts/test-runner.mjs --test-concurrency=4 --test-timeout=30000 'test/unit/**/*.test.ts'",
+		"test:changed": "node scripts/test-changed.mjs",
+		"bench:capture": "node scripts/run-bench.mjs && node -e \"require('node:fs').copyFileSync('test/bench/results.json','test/bench/baseline.json')\"",
+		"profile:startup": "node scripts/profile-startup.mjs",
+		"smoke:pi": "pi install .",
+		"smoke:release": "node scripts/release-smoke.mjs",
+		"prepack": "node scripts/clean-strip-types.mjs",
+		"test:fast": "npm run test:critical && npm run test:bundle",
+		"check:wc-gate": "node scripts/wc-gate.mjs"
+	},
+	"exports": {
+		"./schema.json": "./schema.json",
+		"./workflow": {
+			"types": "./types/dwf.d.ts"
+		}
+	},
+	"pi": {
+		"extensions": [
+			"./index.ts"
+		],
+		"skills": [
+			"./skills"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-agent-core": "*",
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*"
+	},
+	"dependencies": {
+		"@sinclair/typebox": "^0.34.50",
+		"acorn": "^8.17.0",
+		"ajv": "^8.20.0",
+		"cli-highlight": "^2.1.11",
+		"diff": "^5.2.0",
+		"esbuild": "^0.28.1",
+		"jiti": "^2.7.0",
+		"yaml": "^2.9.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.3",
+		"@earendil-works/pi-agent-core": "^0.84.0",
+		"@earendil-works/pi-ai": "^0.84.0",
+		"@earendil-works/pi-coding-agent": "^0.84.0",
+		"@earendil-works/pi-tui": "^0.84.0",
+		"@types/node": "^25.9.5",
+		"tsx": "^4.23.0",
+		"typescript": "^7.0.2"
+	},
+	"peerDependenciesMeta": {
+		"@earendil-works/pi-agent-core": {
+			"optional": true
+		},
+		"@earendil-works/pi-ai": {
+			"optional": true
+		},
+		"@earendil-works/pi-coding-agent": {
+			"optional": true
+		},
+		"@earendil-works/pi-tui": {
+			"optional": true
+		}
+	},
+	"readmeFilename": "README.md"
 }

package/schema.json

@@ -344,6 +344,11 @@
           "minimum": 1,
           "maximum": 50
         },
+        "inlinePanel": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show the inline agent panel above the editor (editor-wrapper agent rows)."
+        },
         "powerbar": {
           "type": "boolean"
         },
@@ -377,6 +382,11 @@
           "type": "boolean",
           "default": true
         },
+        "autoCloseDashboardMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Auto-close delay for the run dashboard once the run reaches a terminal state (ms)."
+        },
         "showModel": {
           "type": "boolean",
           "default": true,

package/scripts/watch-agent-transcript.mjs

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+// Watch a pi session transcript (JSONL stream events) and print one readable
+// line per message — the "session subagent" pane companion for the Agents &
+// Jobs browser (`p` key). Unlike `tail -F` on the raw file, every line here is
+// a formatted summary (role badge + preview), so a tmux/herdr pane shows WHAT
+// the agent is doing, not walls of JSON.
+//
+// Usage: node watch-agent-transcript.mjs <transcript.jsonl>
+import { open as openFile } from "node:fs/promises";
+import { basename } from "node:path";
+
+const path = process.argv[2];
+if (!path) {
+	console.error("usage: node watch-agent-transcript.mjs <transcript.jsonl>");
+	process.exit(1);
+}
+
+const WIDTH = Math.min(200, Number(process.env.COLUMNS || 160) || 160);
+
+function oneLine(text) {
+	return String(text ?? "")
+		.replace(/\s+/g, " ")
+		.trim();
+}
+
+function clip(text, max = WIDTH - 10) {
+	const s = oneLine(text);
+	return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+}
+
+function stamp(iso) {
+	const m = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})/.exec(iso ?? "");
+	return m ? `${m[2]}` : "";
+}
+
+function renderEvent(evt) {
+	if (evt.type === "session") return "── session start ──";
+	if (evt.type === "agent_start") return "── agent start ──";
+	if (evt.type !== "message_end" || !evt.message) return null;
+	const msg = evt.message;
+	const who =
+		msg.role === "assistant" ? "🤖" : msg.role === "user" ? "👤" : msg.role === "toolResult" ? "📤" : (msg.role ?? "?");
+	const parts = Array.isArray(msg.content) ? msg.content : [{ type: "text", text: String(msg.content ?? "") }];
+	const out = [];
+	for (const part of parts) {
+		if (part.type === "thinking") out.push(`💭 ${clip(part.thinking, 120)}`);
+		else if (part.type === "text") out.push(`💬 ${clip(part.text)}`);
+		else if (part.type === "tool_use") {
+			const input = typeof part.input === "object" ? JSON.stringify(part.input) : String(part.input ?? "");
+			out.push(`🔧 ${part.name ?? "tool"} ${clip(input, 100)}`);
+		} else if (part.type === "tool_result") {
+			const content = typeof part.content === "string" ? part.content : JSON.stringify(part.content ?? "");
+			out.push(`📤 ${clip(content, 120)}`);
+		}
+	}
+	if (out.length === 0) return null;
+	return `${stamp(evt.timestamp ?? msg.timestamp) || "        "} ${who} ${out.join(" │ ")}`;
+}
+
+// Clear the pane first — herdr/tmux panes boot via the shell, so the echoed
+// prompt + full node command would otherwise sit above the watcher output.
+process.stdout.write("\x1b[2J\x1b[H");
+console.log(`── watching ${basename(path)} ──`);
+
+let offset = 0;
+let buffer = "";
+const POLL_MS = 400;
+let waitingSince = 0;
+let lastWaitingLog = 0;
+
+function logWaiting(now) {
+	if (!waitingSince) waitingSince = now;
+	if (now - lastWaitingLog >= 2500) {
+		const waitedS = Math.round((now - waitingSince) / 1000);
+		console.log(`… waiting for ${basename(path)} to appear (${waitedS}s)`);
+		lastWaitingLog = now;
+	}
+}
+
+async function pump() {
+	try {
+		const fh = await openFile(path, "r");
+		try {
+			const stat = await fh.stat();
+			if (waitingSince) {
+				console.log(`✓ transcript appeared (waited ${Math.round((Date.now() - waitingSince) / 1000)}s)`);
+				waitingSince = 0;
+			}
+			if (stat.size < offset) offset = 0; // truncated/rotated
+			if (stat.size > offset) {
+				const len = stat.size - offset;
+				const buf = Buffer.alloc(len);
+				await fh.read(buf, 0, len, offset);
+				offset += len;
+				buffer += buf.toString("utf8");
+				const lines = buffer.split("\n");
+				buffer = lines.pop() ?? "";
+				for (const line of lines) {
+					const trimmed = line.trim();
+					if (!trimmed) continue;
+					try {
+						const rendered = renderEvent(JSON.parse(trimmed));
+						if (rendered) console.log(rendered);
+					} catch {
+						console.log(`· ${clip(trimmed)}`);
+					}
+				}
+			}
+		} finally {
+			await fh.close();
+		}
+	} catch {
+		// File not there yet (cold-start window): visible waiting state so the
+		// pane explains itself instead of looking dead.
+		logWaiting(Date.now());
+	}
+}
+
+setInterval(pump, POLL_MS);
+await pump();

package/skills/real-test-pi-crew/REPORT-TEMPLATE.md

@@ -37,6 +37,8 @@ This artifact exists so past runs are verifiable (see SKILL.md "Output report").
 | 10a surface E2E | ✅/❌/⏭️ | tmux 3/3 (spawn+self-close / kill-pane→degrade / doctor orphan) + herdr 3/3 — or skip reason per backend (no `$TMUX`/CI/no socket/in tmux for herdr) |
 | 10b live surface run | ✅/❌/⏭️ | `visibleAgents='<set>'`, pane ids+titles during run, `worker.surface_spawned`/`worker.surface_closed` events (+ no `surface.degraded`), panes auto-closed. NOTE: `manifest.surface.panes` is `{}` at run END even on success (released on pane close) — engage-evidence is the EVENTS + `manifest.surface.provider`/`workerPids` |
 | 10c herdr path | ✅/❌/⏭️ | ran in herdr pane / skipped (not in herdr pane) |
+| 12 resource contracts | ✅/❌/⏭️ | 12a contracts `<pass>/<tests>` · 12b agents `<n>` / bad desc `0` / no routing `0` / strict-YAML fails `0` · 12c rendered agent lines `<n>`, all with `useWhen=` (budget-truncated by design) · 12d `<pass>/<tests>` |
+| 13 real-run UI render | ✅/❌/⏭️ | runId `<id>` (real run, NOT fixtures); surfaces rendered: `<list>`; states: running/done/failed/focused/idle/narrow; invariant sweep `undefined` 0 · retired glyph 0 · `->` 0 · wire-format 0 · invented word 0 · bad plural 0; glyph-vs-state: spinner only while running ✅; hint survives @`<min width>` ✅; formats consistent (duration/usage/runId) ✅; catalog regenerated + 1 PNG inspected ✅ |
 | 11 remediation regression | ✅/❌/⏭️ | sub-checks run + evidence: 11a buffered-site census `<n>` files (full test:unit `<pass>/<tests>` if run) · 11b wc-gate max `<n>`/2000 + in `ci` · 11c validator warn `<key>` → severity · 11d slow tier 3 files disjoint · 11e nightly SMOKE not-set · 11f reject format sites · 11g widgetPlacement bottom · 11h twins 3× green · 11i dead-export 0 + MUST_INCLUDE 5 · 11j committed-hash OK |
 
 Legend: ✅ pass with evidence · ❌ fail (root cause below) · ⏭️ skipped (justify why)