sensorium-mcp 3.1.3-board.3 → 3.1.3-board.5

package/Install-Sensorium.ps1

@@ -117,8 +117,27 @@ Save-Config $Config
 function Stop-SupervisorProcess {
     $procs = Get-Process -Name "sensorium-supervisor" -ErrorAction SilentlyContinue
     if ($procs) {
+        # Keep the original PID set. A name-only lookup after stopping can confuse a
+        # newly launched process with the instance we were asked to stop.
+        $targetPids = @($procs | Select-Object -ExpandProperty Id)
         Write-Host "Stopping background sensorium-supervisor process(es)..."
-        $procs | Stop-Process -Force
+        $procs | Stop-Process -Force -ErrorAction Stop
+
+        # Stop-Process returns once a signal has been sent, not once all image/file
+        # handles are released. Do not attempt an in-place replacement until every
+        # PID we targeted is gone; a continuing process makes the update unsafe.
+        $deadline = (Get-Date).AddSeconds(10)
+        do {
+            $remainingPids = @($targetPids | Where-Object {
+                Get-Process -Id $_ -ErrorAction SilentlyContinue
+            })
+            if ($remainingPids.Count -eq 0) { break }
+            Start-Sleep -Milliseconds 250
+        } while ((Get-Date) -lt $deadline)
+
+        if ($remainingPids.Count -gt 0) {
+            throw "Refusing to update: sensorium-supervisor PID(s) $($remainingPids -join ', ') did not stop within 10 seconds."
+        }
         Write-Host "Process(es) stopped." -ForegroundColor Yellow
     }
 }
@@ -227,7 +246,45 @@ function Save-BinaryMetadata {
         InstalledAt    = (Get-Date).ToString("o")
     }
 
-    $metadata | ConvertTo-Json | Set-Content -LiteralPath $MetadataPath -Encoding ASCII
+    # Do not write metadata in place: a failure halfway through a write would make a
+    # good binary look stale on the next run. The temp name is unique so concurrent
+    # or previously interrupted installs cannot collide with it.
+    $metadataTempPath = "$MetadataPath.tmp.$PID.$([guid]::NewGuid().ToString('N'))"
+    try {
+        $metadata | ConvertTo-Json | Set-Content -LiteralPath $metadataTempPath -Encoding ASCII
+        Move-FileWithRetry -Source $metadataTempPath -Destination $MetadataPath -Operation "update release metadata"
+    }
+    finally {
+        if (Test-Path -LiteralPath $metadataTempPath) {
+            Remove-Item -LiteralPath $metadataTempPath -Force -ErrorAction SilentlyContinue
+        }
+    }
+}
+
+function Move-FileWithRetry {
+    param(
+        [string]$Source,
+        [string]$Destination,
+        [string]$Operation = "replace file",
+        [int]$MaxAttempts = 20,
+        [int]$RetryDelayMs = 1500
+    )
+
+    for ($attempt = 1; $attempt -le $MaxAttempts; $attempt++) {
+        try {
+            Move-Item -LiteralPath $Source -Destination $Destination -Force -ErrorAction Stop
+            return
+        }
+        catch {
+            if ($attempt -eq $MaxAttempts) {
+                throw "Failed to $Operation at $Destination after $MaxAttempts attempts (~$([math]::Round($MaxAttempts * $RetryDelayMs / 1000))s). Original error: $_"
+            }
+            if ($attempt % 4 -eq 0) {
+                Write-Host "  ... waiting to $Operation (attempt $attempt/$MaxAttempts)..." -ForegroundColor Yellow
+            }
+            Start-Sleep -Milliseconds $RetryDelayMs
+        }
+    }
 }
 
 function Get-BinaryAsset {
@@ -244,7 +301,13 @@ function Get-BinaryAsset {
     $headers = Get-GithubAuthHeaders -Accept "application/octet-stream"
     Write-Host "Downloading $($AssetInfo.AssetName) ..."
 
-    $tmpFile = "$Destination.tmp"
+    $operationId = "$PID.$([guid]::NewGuid().ToString('N'))"
+    $tmpFile = "$Destination.tmp.$operationId"
+    $backupPath = "$Destination.bak.$operationId"
+    $metadataBackupPath = "$MetadataPath.bak.$operationId"
+    $hadBinary = Test-Path -LiteralPath $Destination
+    $hadMetadata = Test-Path -LiteralPath $MetadataPath
+    $swapped = $false
     try {
         Invoke-WebRequest -Uri $downloadUrl -Headers $headers -OutFile $tmpFile -UseBasicParsing -ErrorAction Stop
     }
@@ -256,15 +319,74 @@ function Get-BinaryAsset {
         throw "Download failed: $_"
     }
 
-    # Atomic replace
-    if (Test-Path $Destination) {
-        $backupPath = "$Destination.bak"
-        Copy-Item $Destination $backupPath -Force
+    try {
+        # Preserve both halves of the installed state. If anything after the
+        # executable swap fails (notably metadata persistence), restore the pair.
+        if ($hadBinary) { Copy-Item -LiteralPath $Destination -Destination $backupPath -Force -ErrorAction Stop }
+        if ($hadMetadata) { Copy-Item -LiteralPath $MetadataPath -Destination $metadataBackupPath -Force -ErrorAction Stop }
+
+        # The old exe can still be locked for a while after Stop-Process — AV/EDR
+        # may retain its image-section handle during a post-exit scan.
+        Move-FileWithRetry -Source $tmpFile -Destination $Destination -Operation "replace supervisor binary"
+        $swapped = $true
+
+        try {
+            Unblock-File -Path $Destination -ErrorAction Stop
+        }
+        catch {
+            Write-Host "[WARN] Could not unblock ${Destination}: $($_.Exception.Message)" -ForegroundColor Yellow
+        }
+
+        Save-BinaryMetadata -MetadataPath $MetadataPath -AssetInfo $AssetInfo
+        Write-Host "Binary placed at: $Destination" -ForegroundColor Green
+    }
+    catch {
+        $updateError = $_
+        if ($swapped) {
+            Write-Host "[WARN] Update failed after binary replacement; restoring the previous binary and metadata..." -ForegroundColor Yellow
+            $restoreErrors = @()
+            try {
+                if ($hadBinary) {
+                    $restoreFile = "$Destination.restore.$operationId"
+                    Copy-Item -LiteralPath $backupPath -Destination $restoreFile -Force -ErrorAction Stop
+                    Move-FileWithRetry -Source $restoreFile -Destination $Destination -Operation "restore previous supervisor binary"
+                }
+                elseif (Test-Path -LiteralPath $Destination) {
+                    Remove-Item -LiteralPath $Destination -Force -ErrorAction Stop
+                }
+            }
+            catch { $restoreErrors += "binary: $($_.Exception.Message)" }
+
+            try {
+                if ($hadMetadata) {
+                    # Stage the backup under a unique name, then use the same
+                    # retrying replacement path as the binary. Copy-Item directly
+                    # to $MetadataPath could leave metadata restoration vulnerable
+                    # to a locked destination and bypass the retry policy.
+                    $metadataRestoreFile = "$MetadataPath.restore.$operationId"
+                    Copy-Item -LiteralPath $metadataBackupPath -Destination $metadataRestoreFile -Force -ErrorAction Stop
+                    Move-FileWithRetry -Source $metadataRestoreFile -Destination $MetadataPath -Operation "restore previous release metadata"
+                }
+                elseif (Test-Path -LiteralPath $MetadataPath) {
+                    Remove-Item -LiteralPath $MetadataPath -Force -ErrorAction Stop
+                }
+            }
+            catch { $restoreErrors += "metadata: $($_.Exception.Message)" }
+
+            if ($restoreErrors.Count -gt 0) {
+                throw "Update failed and recovery was incomplete ($($restoreErrors -join '; ')). Original error: $($updateError.Exception.Message)"
+            }
+            throw "Update failed after replacement; the previous binary and metadata were restored. Original error: $($updateError.Exception.Message)"
+        }
+        throw
+    }
+    finally {
+        foreach ($path in @($tmpFile, $backupPath, $metadataBackupPath, "$Destination.restore.$operationId", "$MetadataPath.restore.$operationId")) {
+            if (Test-Path -LiteralPath $path) {
+                Remove-Item -LiteralPath $path -Force -ErrorAction SilentlyContinue
+            }
+        }
     }
-    Move-Item $tmpFile $Destination -Force
-    Unblock-File -Path $Destination -ErrorAction SilentlyContinue
-    Save-BinaryMetadata -MetadataPath $MetadataPath -AssetInfo $AssetInfo
-    Write-Host "Binary placed at: $Destination" -ForegroundColor Green
 }
 
 function Install-StartupLauncher {
@@ -439,7 +561,7 @@ function Sync-ReleaseBinary {
     Write-Host "Fetching release via SecureVault (profile: $SecureVaultProfile)..."
     securevault run pwsh -NoProfile -File "`"$PSCommandPath`"" -SyncReleaseOnly --profile $SecureVaultProfile
     if ($LASTEXITCODE -ne 0) {
-        throw "SecureVault-driven release sync failed (exit $LASTEXITCODE). Ensure profile '$SecureVaultProfile' maps a GitHub PAT to env var SENSORIUM_GH_TOKEN."
+        throw "SecureVault-driven release sync failed (exit $LASTEXITCODE). See the error above for the actual cause (e.g. a locked binary, network failure, or a missing GitHub PAT for profile '$SecureVaultProfile' -> `$env:SENSORIUM_GH_TOKEN)."
     }
 }
 
@@ -451,47 +573,76 @@ if ($SyncReleaseOnly) {
 }
 
 # ── Main ─────────────────────────────────────────────────────────────────────
-$alreadyExists = Test-Path $Binary
+# Serialize only full installer invocations for this Windows user. The
+# SecureVault child above deliberately returns before this point, so it can do
+# the authenticated release sync without waiting on (and deadlocking with) its
+# parent installer process.
+$currentUserSid = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+$installMutexName = "Local\SensoriumSupervisor.Install.$($currentUserSid -replace '[^A-Za-z0-9_.-]', '_')"
+$installMutex = [System.Threading.Mutex]::new($false, $installMutexName)
+$mutexHeld = $false
+
+try {
+    try {
+        $mutexHeld = $installMutex.WaitOne([TimeSpan]::FromMinutes(5))
+    }
+    catch [System.Threading.AbandonedMutexException] {
+        # The prior installer died without releasing the mutex; Windows has given
+        # us ownership, so continue while making that state visible to the user.
+        $mutexHeld = $true
+        Write-Host "[WARN] Recovered an abandoned installer mutex; continuing." -ForegroundColor Yellow
+    }
 
-Write-Host ""
-if ($alreadyExists) {
-    Write-Host "=== Sensorium Supervisor UPDATE ===" -ForegroundColor Cyan
-}
-else {
-    Write-Host "=== Sensorium Supervisor INSTALL ===" -ForegroundColor Cyan
-}
-Write-Host "SecureVault profile: $(if ([string]::IsNullOrWhiteSpace($SecureVaultProfile)) { '<disabled>' } else { $SecureVaultProfile })"
-Write-Host "Watcher mode: $UpdateMode"
-Write-Host "MCP start command: $EffectiveMCPStartCommand"
-Write-Host "MCP runtime isolation: $(if ($IsolateMcpRuntime) { 'ENABLED' } else { 'disabled (legacy npx)' })"
-Write-Host "Binary     : $Binary"
-Write-Host ""
-
-# Step 1 — stop existing instance
-if ($alreadyExists) {
-    Stop-SupervisorProcess
-}
+    if (-not $mutexHeld) {
+        throw "Another Sensorium install/update is still running for this user. Timed out waiting for it to finish."
+    }
 
-# Step 2 — ensure bin dir exists
-New-Item -ItemType Directory -Path $BinDir -Force | Out-Null
+    $alreadyExists = Test-Path $Binary
 
-# Step 3 — fetch release metadata and download only when needed
-Sync-ReleaseBinary
+    Write-Host ""
+    if ($alreadyExists) {
+        Write-Host "=== Sensorium Supervisor UPDATE ===" -ForegroundColor Cyan
+    }
+    else {
+        Write-Host "=== Sensorium Supervisor INSTALL ===" -ForegroundColor Cyan
+    }
+    Write-Host "SecureVault profile: $(if ([string]::IsNullOrWhiteSpace($SecureVaultProfile)) { '<disabled>' } else { $SecureVaultProfile })"
+    Write-Host "Watcher mode: $UpdateMode"
+    Write-Host "MCP start command: $EffectiveMCPStartCommand"
+    Write-Host "MCP runtime isolation: $(if ($IsolateMcpRuntime) { 'ENABLED' } else { 'disabled (legacy npx)' })"
+    Write-Host "Binary     : $Binary"
+    Write-Host ""
 
-# Step 3b — prepare the isolated MCP runtime area (opt-in): a private npm cache +
-# repo-independent cwd. The `npx ...@latest` command is unchanged (auto-update
-# preserved). On any failure this disables the isolation env in Start-Supervisor,
-# so the install degrades safely to legacy behaviour.
-if ($IsolateMcpRuntime) {
-    if (-not (Initialize-IsolatedMcpRuntime)) {
-        $IsolateMcpRuntime = $false
-        Write-Host "[WARN] Isolation disabled for this run — using the shared npm cache / inherited cwd." -ForegroundColor Yellow
+    # Step 1 — stop existing instance
+    if ($alreadyExists) {
+        Stop-SupervisorProcess
     }
-}
 
-# Step 4 — install launcher and start
-Install-StartupLauncher
-Start-Supervisor
+    # Step 2 — ensure bin dir exists
+    New-Item -ItemType Directory -Path $BinDir -Force | Out-Null
+
+    # Step 3 — fetch release metadata and download only when needed
+    Sync-ReleaseBinary
 
-# Step 5 — verify
-Show-Status
+    # Step 3b — prepare the isolated MCP runtime area (opt-in): a private npm cache +
+    # repo-independent cwd. The `npx ...@latest` command is unchanged (auto-update
+    # preserved). On any failure this disables the isolation env in Start-Supervisor,
+    # so the install degrades safely to legacy behaviour.
+    if ($IsolateMcpRuntime) {
+        if (-not (Initialize-IsolatedMcpRuntime)) {
+            $IsolateMcpRuntime = $false
+            Write-Host "[WARN] Isolation disabled for this run — using the shared npm cache / inherited cwd." -ForegroundColor Yellow
+        }
+    }
+
+    # Step 4 — install launcher and start
+    Install-StartupLauncher
+    Start-Supervisor
+
+    # Step 5 — verify
+    Show-Status
+}
+finally {
+    if ($mutexHeld) { $installMutex.ReleaseMutex() }
+    if ($installMutex) { $installMutex.Dispose() }
+}

package/dist/board/components/Card.js

@@ -6,6 +6,7 @@
 
 import StatusChip from "./StatusChip.js";
 import PriorityChip from "./PriorityChip.js";
+import { providerLabel, retryLabel } from "./rateLimit.js";
 
 export default {
   name: "Card",
@@ -21,7 +22,11 @@ export default {
       const mins = Math.max(0, Math.round((Date.now() - new Date(props.card.startedAt)) / 60000));
       return mins >= 60 ? Math.floor(mins / 60) + "h " + (mins % 60) + "m" : mins + "m";
     }
-    return { emit, elapsed };
+    function rlText() {
+      const p = providerLabel(props.card);
+      return (p ? p + " · " : "") + retryLabel(props.card);
+    }
+    return { emit, elapsed, rlText };
   },
   template: `
     <article class="card" role="listitem" tabindex="0"
@@ -29,6 +34,10 @@ export default {
       @keydown.enter="emit('open', card)">
       <h3 class="card__title">{{ card.title }}</h3>
       <p v-if="card.description" class="card__desc">{{ card.description }}</p>
+      <div v-if="card.status === 'rate_limited'" class="card__rl">
+        <svg viewBox="0 0 12 12" width="11" height="11" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" aria-hidden="true"><circle cx="6" cy="6" r="4.6"></circle><path d="M6 3.6V6l1.8 1.2"></path></svg>
+        <span>rate limited · {{ rlText() }}</span>
+      </div>
       <div class="card__foot">
         <PriorityChip :priority="card.priority" />
         <span class="chip chip--muted">{{ card.type }}</span>

package/dist/board/components/Combobox.js

@@ -0,0 +1,78 @@
+/**
+ * Combobox — ✅ EDITABLE. Editable dropdown: free-text input + curated
+ * suggestions (optionally grouped). Pure: modelValue in, update:modelValue out.
+ * `groups`: [{ label|null, options: string[] }] — label null renders flat.
+ * The user may pick a suggestion OR type any value.
+ */
+
+import { computed, onMounted, onUnmounted, ref } from "../vendor/vue.esm-browser.js";
+
+export default {
+  name: "Combobox",
+  props: {
+    modelValue: { type: String, default: "" },
+    groups: { type: Array, default: () => [] },
+    placeholder: { type: String, default: "" },
+  },
+  emits: ["update:modelValue"],
+  setup(props, { emit }) {
+    const open = ref(false);
+    const rootEl = ref(null);
+    const filtered = computed(() => {
+      const q = (props.modelValue || "").trim().toLowerCase();
+      const out = [];
+      for (const g of props.groups) {
+        const opts = q ? g.options.filter((o) => o.toLowerCase().includes(q)) : g.options;
+        if (opts.length) out.push({ label: g.label || null, options: opts });
+      }
+      return out;
+    });
+    function onInput(e) {
+      emit("update:modelValue", e.target.value);
+      open.value = true;
+    }
+    function pick(o) {
+      emit("update:modelValue", o);
+      open.value = false;
+    }
+    function onDoc(e) {
+      if (rootEl.value && !rootEl.value.contains(e.target)) open.value = false;
+    }
+    function onKey(e) {
+      if (e.key === "Escape") open.value = false;
+    }
+    onMounted(() => {
+      document.addEventListener("click", onDoc, true);
+      document.addEventListener("keydown", onKey);
+    });
+    onUnmounted(() => {
+      document.removeEventListener("click", onDoc, true);
+      document.removeEventListener("keydown", onKey);
+    });
+    return { open, rootEl, filtered, onInput, pick };
+  },
+  template: `
+    <div class="dropdown combobox" ref="rootEl">
+      <div class="combobox__wrap">
+        <input class="input combobox__input" :value="modelValue" :placeholder="placeholder"
+          role="combobox" :aria-expanded="open" aria-autocomplete="list"
+          @input="onInput" @focus="open = true" />
+        <button type="button" class="combobox__toggle" :class="{ 'is-open': open }"
+          aria-label="Show suggestions" tabindex="-1" @click="open = !open">▾</button>
+      </div>
+      <ul v-if="open && filtered.length" class="dropdown__menu" role="listbox">
+        <template v-for="g in filtered" :key="g.label || '_'">
+          <li v-if="g.label" class="combobox__group" role="presentation">{{ g.label }}</li>
+          <li v-for="o in g.options" :key="o">
+            <button type="button" class="dropdown__opt" role="option"
+              :aria-selected="o === modelValue" :class="{ 'is-selected': o === modelValue }"
+              @click="pick(o)">
+              <span class="dropdown__optlabel">{{ o }}</span>
+              <span v-if="o === modelValue" class="dropdown__check">✓</span>
+            </button>
+          </li>
+        </template>
+      </ul>
+    </div>
+  `,
+};

package/dist/board/components/CommentComposer.js

@@ -6,6 +6,9 @@ import { ref } from "../vendor/vue.esm-browser.js";
 
 export default {
   name: "CommentComposer",
+  props: {
+    busy: { type: Boolean, default: false },
+  },
   emits: ["submit"],
   setup(props, { emit }) {
     const text = ref("");
@@ -20,7 +23,7 @@ export default {
   template: `
     <form class="composer" @submit.prevent="send">
       <textarea class="input input--area" v-model="text" rows="2" placeholder="Add a comment…"></textarea>
-      <button class="btn btn--primary" type="submit" :disabled="!text.trim()">Comment</button>
+      <button class="btn btn--primary" type="submit" :disabled="!text.trim() || busy">{{ busy ? 'Sending…' : 'Comment' }}</button>
     </form>
   `,
 };

package/dist/board/components/Lane.js

@@ -4,6 +4,7 @@
  */
 
 import Card from "./Card.js";
+import { computed } from "../vendor/vue.esm-browser.js";
 
 export default {
   name: "Lane",
@@ -16,13 +17,17 @@ export default {
   },
   emits: ["open"],
   setup(props, { emit }) {
-    return { emit };
+    const rateLimited = computed(() => props.cards.filter((c) => c.status === "rate_limited").length);
+    return { emit, rateLimited };
   },
   template: `
     <section class="lane" :class="'lane--' + status" role="listitem">
       <header class="lane__head">
         <span class="lane__dot"></span>
         <h2 class="lane__title">{{ title }}</h2>
+        <span v-if="rateLimited" class="lane__rl" :title="rateLimited + ' card(s) waiting on a provider rate limit'">
+          <svg viewBox="0 0 12 12" width="10" height="10" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" aria-hidden="true"><circle cx="6" cy="6" r="4.6"></circle><path d="M6 3.6V6l1.8 1.2"></path></svg>{{ rateLimited }}
+        </span>
         <span class="lane__count">{{ cards.length }}</span>
       </header>
       <div class="lane__body">

package/dist/board/components/StateBanner.js

@@ -7,6 +7,7 @@ export default {
   props: {
     loading: { type: Boolean, default: false },
     error: { type: [String, null], default: null },
+    retryable: { type: Boolean, default: true },
   },
   emits: ["retry"],
   setup(props, { emit }) {
@@ -14,9 +15,10 @@ export default {
   },
   template: `
     <div v-if="error" class="notice notice--error">
-      <span>{{ error }}</span>
-      <button class="btn btn--ghost btn--sm" type="button" @click="emit('retry')">Retry</button>
+      <svg viewBox="0 0 16 16" width="15" height="15" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" aria-hidden="true" style="flex:none"><circle cx="8" cy="8" r="6.2"></circle><path d="M8 4.8V8.6M8 11.2v.1"></path></svg>
+      <span class="notice__msg">{{ error }}</span>
+      <button v-if="retryable" class="btn btn--ghost btn--sm" type="button" @click="emit('retry')">Retry</button>
     </div>
-    <div v-else-if="loading" class="notice notice--info">Loading…</div>
+    <div v-else-if="loading" class="notice notice--info"><span class="spinner" aria-hidden="true"></span>Loading…</div>
   `,
 };

package/dist/board/components/StatusChip.js

@@ -9,6 +9,7 @@ const LABELS = {
   decision_needed: "Decision needed",
   blocked: "Blocked",
   done: "Done",
+  rate_limited: "Rate limited",
 };
 
 export default {

package/dist/board/components/rateLimit.js

@@ -0,0 +1,19 @@
+/**
+ * rate_limited helpers — ✅ EDITABLE. Shared by Card tile, Lane badge and the
+ * card detail notice. Pure functions: card in, display strings out.
+ */
+
+export const PROVIDER_LABELS = { claude: "Claude", copilot: "Copilot" };
+
+/** Live countdown text derived from retryAt (null = unknown reset window). */
+export function retryLabel(card, now = Date.now()) {
+  if (!card.retryAt) return "retrying when limit resets";
+  const mins = Math.ceil((new Date(card.retryAt).getTime() - now) / 60000);
+  if (mins <= 0) return "retrying\u2026";
+  if (mins >= 60) return `retry in ~${Math.floor(mins / 60)}h ${mins % 60}m`;
+  return `retry in ~${mins}m`;
+}
+
+export function providerLabel(card) {
+  return PROVIDER_LABELS[card.rateLimitProvider] || "";
+}

package/dist/board/mock/fixtures.js

@@ -12,6 +12,8 @@
 const T0 = "2026-08-08T09:00:00.000Z";
 const T1 = "2026-08-08T12:30:00.000Z";
 const T2 = "2026-08-08T14:05:00.000Z";
+/** rate_limited demo: auto-retry ~30 minutes from page load. */
+const RETRY_AT = new Date(Date.now() + 30 * 60000).toISOString();
 
 /** @param {Partial<import('../api/contract.js').BoardCard>} o */
 function card(o) {
@@ -31,6 +33,8 @@ function card(o) {
     nextSpawnAt: null,
     workerThreadId: null,
     blockedReason: null,
+    rateLimitProvider: null,
+    retryAt: null,
     archivedAt: null,
     createdAt: T0,
     updatedAt: T0,
@@ -135,6 +139,36 @@ export const fixtures = {
       archivedAt: T1,
       profile: {},
     }),
+    card({
+      cardId: 8,
+      title: "Refactor comment threading into a tree view",
+      description: "Worker paused mid-run: Claude usage limit reached. Auto-retries when the window resets.",
+      acceptance: "Nested replies render as a collapsible tree; existing flat view unaffected.",
+      type: "feature",
+      laneThreadId: 101,
+      priority: 1,
+      status: "rate_limited",
+      workerThreadId: 9902,
+      startedAt: T1,
+      rateLimitProvider: "claude",
+      retryAt: RETRY_AT,
+      profile: { agentType: "claude", createBranch: true, runTests: true },
+    }),
+    card({
+      cardId: 9,
+      title: "Generate API usage examples for the docs site",
+      description: "Copilot credits exhausted for this billing window; card is parked until they replenish.",
+      acceptance: "Each public endpoint has a runnable example snippet.",
+      type: "chore",
+      laneThreadId: 202,
+      priority: 0,
+      status: "rate_limited",
+      workerThreadId: 9903,
+      startedAt: T2,
+      rateLimitProvider: "copilot",
+      retryAt: null,
+      profile: { agentType: "copilot" },
+    }),
   ],
 
   /** Keyed by cardId. */