pi-crew 0.11.0 → 0.11.2

package/docs/README.md

@@ -1,56 +1,67 @@
-# docs/ — documentation index
+# pi-crew docs
 
-pi-crew's documentation. After the v0.9.x reorg the **living/active** docs
-stay at the root of this directory; historical/retired docs live in
-[`archive/`](./archive/). Cluster maps for the code live in
-[`src/runtime/README.md`](../src/runtime/README.md) and
-[`src/state/README.md`](../src/state/README.md).
+Documentation for the pi-crew package (multi-agent team orchestration as a Pi
+extension). The root of `docs/` holds only **living** docs; dated point-in-time
+material (audits, plans, fix specs, roadmaps) is archived under
+[`archive/`](./archive/).
 
-## Living docs (root)
+## Start here
 
 | Doc | Contents |
 |-----|----------|
-| [`usage.md`](./usage.md) | Usage patterns + config examples |
-| [`commands-reference.md`](./commands-reference.md) | Slash commands + `/team-api` |
-| [`actions-reference.md`](./actions-reference.md) | Full tool actions + examples |
+| [`../README.md`](../README.md) | Package README — what pi-crew is, install, quickstart |
+| [`usage.md`](./usage.md) | Config, run modes, slash commands, management actions |
+| [`architecture.md`](./architecture.md) | Layers, state layout, and the run lifecycle (the former `runtime-flow.md` content lives here) |
+| [`troubleshooting.md`](./troubleshooting.md) | Common errors, recovery procedures, error codes (E001–E013) |
+
+## Reference
+
+| Doc | Contents |
+|-----|----------|
+| [`actions-reference.md`](./actions-reference.md) | Every `team` tool action with parameters and examples |
+| [`commands-reference.md`](./commands-reference.md) | Slash commands and `/team-api` |
+| [`hooks-reference.md`](./hooks-reference.md) | The three hook/event subsystems and when to use each |
+| [`role-tools.md`](./role-tools.md) | Role → tool permission matrix. **Generated** from `src/config/role-tools.ts` via `scripts/gen-role-tools-docs.mjs` — regenerate, do not hand-edit |
 | [`resource-formats.md`](./resource-formats.md) | Agent/team/workflow file formats |
-| [`architecture.md`](./architecture.md) | Internal architecture + run flow |
-| [`runtime-flow.md`](./runtime-flow.md) | Runtime execution details |
-| [`dynamic-workflows.md`](./dynamic-workflows.md) | `.dwf.ts` script runtime + trust model |
+| [`trust-model.md`](./trust-model.md) | The authoritative trust model (single source of truth) |
 | [`goals.md`](./goals.md) | Autonomous goal loops (`team action='goal'`) |
-| [`live-mailbox-runtime.md`](./live-mailbox-runtime.md) | Mailbox + live-session runtime |
-| [`troubleshooting.md`](./troubleshooting.md) | Common errors, recovery, error-code reference (E001–E012) |
-| [`publishing.md`](./publishing.md) | Release & publish process |
-| [`migration-v0.4-v0.5.md`](./migration-v0.4-v0.5.md) | Migration guide: v0.4 → v0.5 |
-| [`HARNESS.md`](./HARNESS.md) | Agent-testing harness operating model |
-| [`HARNESS_BACKLOG.md`](./HARNESS_BACKLOG.md) | Harness capability backlog |
-| [`FEATURE_INTAKE.md`](./FEATURE_INTAKE.md) | Feature-intake gate for implementation prompts |
-| [`TEST_MATRIX.md`](./TEST_MATRIX.md) | Behavior→proof mapping (every row needs real evidence) |
-| [`TEST-STRATEGY-2026-07-30.md`](./TEST-STRATEGY-2026-07-30.md) | v0.9.56 test strategy (coverage × test type) |
-| [`COVERAGE-ASSESSMENT-2026-08-01.md`](./COVERAGE-ASSESSMENT-2026-08-01.md) | v0.9.56 coverage assessment + source-reorg history |
-| [`AUDIT-2026-07-30.md`](./AUDIT-2026-07-30.md) | v0.9.56 comprehensive audit (6 parallel streams) |
-| [`REMEDIATION-PLAN-2026-07-30.md`](./REMEDIATION-PLAN-2026-07-30.md) | v0.9.56 remediation plan |
-| [`refactor-plan.md`](./refactor-plan.md) | Maintainability refactor plan (phased, v0.9.68) |
-| [`refactor-plan.review.md`](./refactor-plan.review.md) | Verification sweep 3 (vòng 4) audit trail — 3 large-file baselines CONFIRMED, 6 corrections, Phase 4 reframe |
-
-## Subdirectories
+| [`dynamic-workflows.md`](./dynamic-workflows.md) | `.dwf.ts` script workflows and their trust model |
+| [`live-mailbox-runtime.md`](./live-mailbox-runtime.md) | Mailbox files and the live-session runtime direction |
+| [`UI-DESIGN-SYSTEM.md`](./UI-DESIGN-SYSTEM.md) | RAIL design contract for TUI surfaces (primitive source: `src/ui/rail.ts`) |
+| [`publishing.md`](./publishing.md) | npm release and publish process |
+| [`failure-mode-inventory.md`](./failure-mode-inventory.md) | Failure modes mapped to their handlers; gaps are declared, not hidden |
+| [`TEST_MATRIX.md`](./TEST_MATRIX.md) | Behavior → proof mapping; every row needs real evidence |
+| [`HARNESS.md`](./HARNESS.md) | Development-harness operating model for building pi-crew itself |
+| [`HARNESS_BACKLOG.md`](./HARNESS_BACKLOG.md) | Harness capability backlog (HB-xxx items) |
+| [`FEATURE_INTAKE.md`](./FEATURE_INTAKE.md) | Intake gate every implementation prompt must pass |
+
+## Records
+
+Historical and supporting material lives in subdirectories. These are records,
+not living specs — verify against code before relying on them.
 
 | Subdir | Contents |
 |--------|----------|
-| [`archive/`](./archive/) | Historical/retired docs (flat; ~59 files — audits, research, superseded plans) |
-| [`bugs/`](./bugs/) | Bug write-ups + security audit/issues |
-| [`decisions/`](./decisions/) | Architecture decision records (ADRs, numbered) |
-| [`distillation/`](./distillation/) | Distilled pattern/skill references |
-| [`fixes/`](./fixes/) | Bug-fix reports |
-| [`migration/`](./migration/) | Migration guides (e.g. atomic-write v2) |
-| [`patterns/`](./patterns/) | Reusable pattern references |
-| [`perf/`](./perf/) | Performance audits, sprint reports, optimization plans |
-| [`product/`](./product/) | Product-domain docs |
-| [`skills/`](./skills/) | pi-crew skills reference |
-| [`stories/`](./stories/) | Story-sized work packets |
-| [`superpowers/`](./superpowers/) | Fallow-patterns adoption plans |
-| [`templates/`](./templates/) | Decision / story / validation-report templates |
-
-See also the top-level [README.md](../README.md) and the source cluster maps
-([`src/runtime/README.md`](../src/runtime/README.md),
-[`src/state/README.md`](../src/state/README.md)).
+| [`decisions/`](./decisions/) | Architecture decision records (ADRs); index in its README |
+| [`design/`](./design/) | Design and implementation-plan docs for features in flight (subagent-v2, inline agent panel, work-item splits) |
+| [`bugs/`](./bugs/) | Bug write-ups plus security audits/issues |
+| [`fixes/`](./fixes/) | Per-bug fix reports: root cause, evidence, applied layers |
+| [`perf/`](./perf/) | Performance baselines, bench reports, optimization plans, sprint reports |
+| [`archive/`](./archive/) | Dated point-in-time docs (audits, plans, fix specs, roadmaps) kept for history |
+| [`ui-samples/`](./ui-samples/) | TUI surface catalog: captures rendered by the real render functions, PNGs, and generator scripts |
+| [`real-test/`](./real-test/) | Real-binary test session reports and probe logs |
+| [`evidence/`](./evidence/) | Raw evidence logs captured for work items (e.g., RED demos) |
+| [`migration/`](./migration/) | Migration guides (e.g., atomic-write v2) |
+| [`patterns/`](./patterns/) | Distilled reusable patterns (command → agent → skill tiers) |
+| [`product/`](./product/) | Product-domain docs: team-run lifecycle, team-tool API, state contracts |
+| [`skills/`](./skills/) | Skill chains and effectiveness reference |
+| [`stories/`](./stories/) | Story-sized work packets with status |
+| [`superpowers/`](./superpowers/) | Adopted workflow plans (`plans/`) and specs (`specs/`) |
+| [`templates/`](./templates/) | Templates: `decision.md`, `story.md`, `validation-report.md` |
+| [`distillation/`](./distillation/) | Distillations of external skill libraries into pi-crew patterns |
+
+## See also
+
+- [Package README](../README.md) and [CHANGELOG](../CHANGELOG.md)
+- Source cluster maps: [`src/runtime/README.md`](../src/runtime/README.md),
+  [`src/state/README.md`](../src/state/README.md)

package/docs/architecture.md

@@ -2,8 +2,6 @@
 
 `pi-crew` is a Pi package for coordinated multi-agent work. It is intentionally durable-first: every run is represented on disk, every task has a state record, and child workers stream progress into JSONL/status files so foreground sessions, background jobs, dashboards, and later restarts all read the same source of truth.
 
-**Current version:** v0.10.3 — 100+ rounds of code review hardening (see [CHANGELOG.md](../CHANGELOG.md)).
-
 ## Layers
 
 ```text
@@ -24,39 +22,95 @@ State layer (project root resolves to <crewRoot>:
   <crewRoot>/artifacts/{runId}/...
 ```
 
-## Run flow
+## Runtime flow
+
+The former `docs/runtime-flow.md` was folded into this section; the standalone
+file is being retired.
+
+### Run lifecycle
+
+```text
+team tool (action=run) or /team-run
+  └─ handleTeamTool → team-tool/run.ts
+       ├─ discover agents/teams/workflows; validate refs
+       ├─ create run manifest, tasks.json, goal artifact
+       └─ foreground (default, session-bound) or async (background)?
+            ├─ foreground: startForegroundRun() schedules executeTeamRun()
+            └─ async: spawnBackgroundTeamRun()
+                 ├─ node --import jiti-register.mjs background-runner.ts (detached)
+                 ├─ fail-fast when jiti is missing
+                 └─ background-runner: append async.started, write async.pid
+                    startup marker, re-discover resources, executeTeamRun()
+
+executeTeamRun()
+  ├─ mark run.running; materialize queued/running agent records lazily
+  ├─ build task-graph index
+  ├─ while queued tasks remain:
+  │    ├─ snapshot task graph; resolveBatchConcurrency() (hard-capped)
+  │    ├─ getReadyTasks() → run the ready batch concurrently
+  │    │    └─ runTeamTask():
+  │    │         prepare workspace/worktree, render prompt + dependency
+  │    │         context, choose model candidates from Pi config, spawn the
+  │    │         child pi process, parse its JSONL stdout/stderr, persist
+  │    │         agent status/events/output, write result/log/transcript
+  │    │         artifacts
+  │    ├─ merge task updates monotonically
+  │    ├─ optional adaptive plan injection
+  │    └─ persist tasks/agents/progress + batch artifact
+  └─ policy closeout → run.completed | run.failed | run.blocked | run.cancelled
+```
+
+Run/task states: `queued` / `planning` / `running` → `completed` / `failed` /
+`blocked` / `cancelled`; tasks additionally use `skipped`. Terminal states are
+monotonic — parallel merges must not regress them (see
+[Team runner](#team-runner)).
+
+Action routing (`status`, `cancel`, `resume`, `forget`, `doctor`, …) is
+documented in [actions-reference.md](actions-reference.md).
+
+### Key files in the run path
 
 ```text
-user/team tool
-  │
-  ▼
-handleTeamTool(action=run)
-  ├─ discover agents/teams/workflows
-  ├─ validate team/workflow refs
-  ├─ create run manifest + task graph
-  ├─ write goal artifact
-  └─ choose foreground/session-bound or async/background mode
-        │
-        ├─ foreground: startForegroundRun() schedules executeTeamRun()
-        │
-        └─ async: spawnBackgroundTeamRun()
-              ├─ node --import jiti-register.mjs background-runner.ts
-              ├─ background-runner writes async.started + async.pid marker
-              └─ executeTeamRun()
-                    ├─ resolve ready task batch
-                    ├─ resolveBatchConcurrency() with hard cap
-                    ├─ runTeamTask() per task
-                    │    ├─ build prompt + dependency context
-                    │    ├─ choose configured Pi model candidates
-                    │    ├─ spawn child `pi` worker
-                    │    ├─ observe JSONL/stdout progress
-                    │    ├─ persist agent status/events/output
-                    │    └─ write result/log/transcript artifacts
-                    ├─ merge task updates monotonically
-                    ├─ write progress artifacts
-                    └─ synthesize policy closeout
+src/extension/register.ts              Pi extension entry/wiring
+src/extension/team-tool/run.ts         run creation; foreground/async split
+src/runtime/background-runner.ts       detached async entrypoint
+src/runtime/async-runner.ts            background spawn command/options
+src/runtime/team-runner.ts             workflow/task-graph scheduler
+src/runtime/task-runner.ts             single task execution (+ task-runner/)
+src/runtime/child-pi/child-pi.ts       child Pi process + output observer
+src/runtime/model/model-fallback.ts    configured model candidates/routing
+src/runtime/scheduling/concurrency.ts  batch concurrency decisions
+src/runtime/process-status.ts          pid/liveness/stale detection
+src/state/stores/state-store.ts        manifest/tasks persistence
+src/state/event-log/event-log.ts       JSONL run events
+src/runtime/crew-agent-records.ts      aggregate + per-agent status files
 ```
 
+### Runtime env vars
+
+The complete registry is `src/config/env-vars.ts` — the CI gate
+(`scripts/check-env-vars.mjs`) fails on any raw `PI_CREW_*` / `PI_TEAMS_*`
+read outside it, and mirror-pair resolution (`PI_CREW_*` ↔ `PI_TEAMS_*`)
+lives there. The ones most likely to be set by hand:
+
+| Env | Effect |
+|---|---|
+| `PI_CREW_EXECUTE_WORKERS=0` | Disable real workers; use scaffold behavior (`PI_TEAMS_EXECUTE_WORKERS=0` legacy alias). |
+| `PI_CREW_DEPTH` / `PI_CREW_MAX_DEPTH` | Subagent recursion guard (`PI_TEAMS_*` legacy aliases). |
+| `PI_TEAMS_HOME` | Override user config/state home (tests). |
+| `PI_TEAMS_PI_BIN` | Override the child `pi` executable. |
+| `PI_CREW_ASYNC_EARLY_EXIT_GUARD=0` | Disable the async-run early-exit guard. |
+| `PI_TEAMS_MOCK_CHILD_PI` / `PI_CREW_MOCK_LIVE_SESSION` | Test hooks for mocked worker execution. |
+| `PI_CREW_MAX_WORKERS` | Cap concurrent workers (default `max(2, cpus−2)`). |
+| `PI_TEAMS_CHILD_RESPONSE_TIMEOUT_MS` | Child Pi response timeout. |
+
+### Debugging a run
+
+- `background.log` — early import/spawn errors of async runs.
+- `events.jsonl` — run event chronology; `agents/{taskId}/status.json` — per-agent model/progress/tool status.
+- `artifacts/{runId}/transcripts/{taskId}.jsonl` — raw child Pi transcript.
+- `team action='status' runId=…` — canonical state + stale async detection; `/team-dashboard` for a UI overview.
+
 ## Extension layer
 
 `src/extension/register.ts` wires the package into Pi:
@@ -169,7 +223,7 @@ Foreground runs are session-bound and should be interrupted on session shutdown
 
 Key config sections:
 
-- `runtime`: `auto`, `child-process`, `scaffold`, experimental `live-session`.
+- `runtime`: `auto` (default; resolves to `child-process` unless config/env requests otherwise), `child-process`, `scaffold` (explicit dry-run, no child workers), experimental `live-session`.
 - `limits`: concurrency/task/depth safety controls.
 - `ui`: widget/dashboard/powerbar/model-token display settings.
 - `observability`: in-memory metrics, heartbeat watcher interval, metric file retention.
@@ -179,4 +233,4 @@ Key config sections:
 - `agents`: builtin overrides for models/fallbacks/tools.
 - `autonomous`: policy injection/profile for proactive team delegation.
 
-See `usage.md`, `resource-formats.md`, `runtime-flow.md`, and `live-mailbox-runtime.md` for operational details.
+See `usage.md`, `resource-formats.md`, and `live-mailbox-runtime.md` for operational details.

package/docs/commands-reference.md

@@ -14,26 +14,29 @@ Slash commands are manual actions triggered from the Pi chat. Autonomous tool us
 | `/team-resume <runId>` | Resume a stopped run |
 | `/team-retry <runId>` | Retry a failed run |
 | `/team-result <runId>` | Show a task result artifact |
-| `/team-respond <taskId> <message>` | Respond to a waiting worker task |
-| `/team-follow-up [options]` | Manage follow-up notifications |
+| `/team-respond <runId> <taskId\|--all> <message>` | Respond to a waiting worker task |
+| `/team-follow-up <runId> <taskId> <prompt>` | Send a follow-up prompt to a task |
 | `/team-events <runId>` | View the event log |
 | `/team-artifacts <runId>` | View artifacts |
 | `/team-transcript <runId>` | Open the transcript viewer |
 | `/team-worktrees <runId>` | View worktree metadata |
-| `/team-cleanup <runId>` | Remove worktrees (interactive menu: `/team-cleanup-menu`) |
 | `/team-forget <runId>` | Fully delete a run |
 | `/team-prune` | Delete multiple old runs |
-| `/team-invalidate [scope]` | Invalidate caches |
+| `/team-invalidate <runId>` | Invalidate the snapshot cache for a run |
 | `/team-export <runId>` | Export a run bundle |
 | `/team-import <path>` | Import a run bundle |
 | `/team-imports` | List imported bundles |
 | `/team-api <runId> <op>` | State API interop |
 | `/team-metrics [filter]` | View metrics |
+| `/schedules [log <jobId-or-name>]` | List scheduled jobs (`log` tails the latest run output) |
 | `/team-manager` | Interactive helper |
+| `/team-cleanup-menu` | Alias for `/team-manager` (interactive menu) |
 | `/team-dashboard` | Live dashboard overlay |
 | `/team-init [options]` | Initialize the project layout |
 | `/team-config [options]` | View or update config |
 | `/team-settings <subcmd>` | Manage config keys |
+| `/skill-list [--json]` | List builtin skill templates |
+| `/skill-create <template-id> [--var key=value] [--project]` | Create a skill from a builtin template |
 | `/team-autonomy <subcmd>` | Manage delegation |
 | `/team-validate` | Validate resources |
 | `/team-help` | Help text |
@@ -43,7 +46,8 @@ Slash commands are manual actions triggered from the Pi chat. Autonomous tool us
 | **`/workflows`** | **v0.9.0** List static + dynamic workflows (`.dwf.ts`) |
 | `/crew-view <runId> <taskId>` | Open an agent's live full-screen transcript view (thin alias for the inline-panel pane wiring; never switches sessions) |
 | `/crew-back` | Close the agent transcript view and return to the main conversation |
-| `/team-vibes [on\|off\|speed on\|off\|capacity on\|off]` | Toggle crew-vibes speed + context meters (on/off, speed, capacity) |
+| `/team-vibes [on\|off]` | Toggle the provider-quota status |
+| `/crew-brief [on\|off\|status]` | Toggle brief mode for crew `team`/`agent` tool output |
 
 **Removed (v0.10.1 docs hygiene):** `/team-orchestrate`, `/team-schedule`,
 `/team-scheduled`, `/team-search`, `/team-graph` — phantom entries; none of

package/docs/troubleshooting.md

@@ -1,6 +1,6 @@
 # Troubleshooting
 
-Common problems and their fixes. If you hit an error code (E001–E012), see the
+Common problems and their fixes. If you hit an error code (E001–E013), see the
 [Error codes](#error-codes) table below.
 
 ## Quick health check
@@ -130,7 +130,7 @@ team action='status' details=false   # compact: status, progress, goal, issues o
 
 ## Error codes
 
-pi-crew uses a structured error taxonomy (E001–E012). Each error renders its
+pi-crew uses a structured error taxonomy (E001–E013). Each error renders its
 code + a help hint inline. Common ones:
 
 | Code | Name | Meaning | First check |
@@ -147,6 +147,7 @@ code + a help hint inline. Common ones:
 | E010 | EventLogLockTimeout | event log locked under contention | transient; retry, or lower concurrency |
 | E011 | DepthLimitExceeded | crew nesting too deep | raise `crew.maxDepth` or flatten the call |
 | E012 | RunStale | run reconciled as stale | see "Stale async process" above |
+| E013 | ModelOutOfScope | requested model not in pi's `enabledModels` allowlist | pick a model listed in `enabledModels` (settings.json) or disable `reliability.scopeModels` |
 
 ## Still stuck
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-crew",
-	"version": "0.11.0",
+	"version": "0.11.2",
 	"description": "Pi extension for coordinated AI teams, workflows, worktrees, and async task orchestration",
 	"author": "baphuongna",
 	"license": "MIT",
@@ -53,10 +53,8 @@
 		"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/",

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,
@@ -509,6 +519,35 @@
           "minimum": 1,
           "maximum": 90,
           "default": 7
+        },
+        "webhook": {
+          "type": "object",
+          "additionalProperties": false,
+          "sensitive": true,
+          "description": "US-030: opt-in outbound webhook on run terminal transitions (completed/failed/cancelled). SENSITIVE — user config only; a project-level webhook URL would let an untrusted repo exfiltrate run metadata. Disabled by default (no URL = zero network calls).",
+          "properties": {
+            "url": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^https?://",
+              "description": "Target URL. Must be http(s); localhost/127.0.0.0-8/[::1]/169.254.0.0-16/fe80::-10 targets are refused unless allowLocalhost is true."
+            },
+            "enabled": {
+              "type": "boolean",
+              "description": "Master switch. Defaults to true when url is set; false disables (zero network)."
+            },
+            "secret": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Shared secret — sets x-pi-crew-signature: sha256=<hmac-sha256(body, secret)> on every POST."
+            },
+            "allowLocalhost": {
+              "type": "boolean",
+              "description": "Explicit SSRF-guard bypass for loopback/link-local targets (e.g. a local test receiver). Default false.",
+              "default": false
+            }
+          },
+          "required": ["url"]
         }
       }
     },

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)