@swarmclawai/swarmclaw 1.7.0 → 1.7.2

package/src/components/chat/chat-card.tsx

@@ -143,6 +143,11 @@ export function ChatCard({ session, active, onClick }: Props) {
           />
         )}
         <span className="font-display text-[14px] font-600 truncate flex-1 tracking-[-0.01em]">{displayName}</span>
+        {active && (
+          <span className="shrink-0 text-[9px] font-700 uppercase tracking-[0.08em] text-accent-bright bg-accent-bright/15 px-1.5 py-0.5 rounded-[6px]">
+            Selected
+          </span>
+        )}
         {providerLabel && (
           <span className="shrink-0 text-[10px] font-600 uppercase tracking-wider text-text-3/70 bg-white/[0.03] px-2 py-0.5 rounded-[6px]">
             {providerLabel}

package/src/components/home/home-launchpad.tsx

@@ -1,12 +1,7 @@
 'use client'
 
 import { AgentAvatar } from '@/components/agents/agent-avatar'
-import {
-  getLaunchPathCards,
-  type LaunchPathAction,
-  type LaunchPathCardCopy,
-  type LaunchPathId,
-} from '@/lib/home-launchpad'
+import { LaunchActionCard } from '@/components/shared/launch-action-card'
 import type { Agent } from '@/types'
 
 function SnapshotItem({ label, value, hint }: { label: string; value: string; hint: string }) {
@@ -20,58 +15,47 @@ function SnapshotItem({ label, value, hint }: { label: string; value: string; hi
 }
 
 function PathCard({
-  card,
-  onAction,
+  kicker,
+  title,
+  description,
+  primaryLabel,
+  secondaryLabel,
+  onPrimary,
+  onSecondary,
 }: {
-  card: LaunchPathCardCopy
-  onAction: (id: LaunchPathId, action: LaunchPathAction) => void
+  kicker: string
+  title: string
+  description: string
+  primaryLabel: string
+  secondaryLabel: string
+  onPrimary: () => void
+  onSecondary: () => void
 }) {
   return (
     <div className="flex min-h-[220px] flex-col rounded-[18px] border border-white/[0.07] bg-white/[0.03] p-5">
-      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{card.kicker}</div>
-      <div className="mt-3 text-[18px] font-display font-700 tracking-normal text-text">{card.title}</div>
-      <p className="mt-2 flex-1 text-[13px] leading-relaxed text-text-3/72">{card.description}</p>
+      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{kicker}</div>
+      <div className="mt-3 text-[18px] font-display font-700 tracking-normal text-text">{title}</div>
+      <p className="mt-2 flex-1 text-[13px] leading-relaxed text-text-3/72">{description}</p>
       <div className="mt-5 flex flex-wrap gap-2">
         <button
           type="button"
-          onClick={() => onAction(card.id, 'primary')}
+          onClick={onPrimary}
           className="rounded-[10px] bg-accent-bright px-3.5 py-2 text-[12px] font-display font-700 text-black transition-opacity hover:opacity-90"
         >
-          {card.primaryLabel}
+          {primaryLabel}
         </button>
         <button
           type="button"
-          onClick={() => onAction(card.id, 'secondary')}
+          onClick={onSecondary}
           className="rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3.5 py-2 text-[12px] font-display font-700 text-text-2 transition-colors hover:bg-white/[0.08]"
         >
-          {card.secondaryLabel}
+          {secondaryLabel}
         </button>
       </div>
     </div>
   )
 }
 
-function SecondaryAction({
-  label,
-  description,
-  onClick,
-}: {
-  label: string
-  description: string
-  onClick: () => void
-}) {
-  return (
-    <button
-      type="button"
-      onClick={onClick}
-      className="rounded-[12px] border border-white/[0.07] bg-white/[0.025] px-3 py-2 text-left transition-colors hover:bg-white/[0.05]"
-    >
-      <div className="text-[12px] font-display font-700 text-text-2">{label}</div>
-      <div className="mt-0.5 text-[11px] leading-relaxed text-text-3/65">{description}</div>
-    </button>
-  )
-}
-
 type Props = {
   firstAgent: Agent | null
   agentCount: number
@@ -80,8 +64,15 @@ type Props = {
   scheduleCount: number
   connectorCount: number
   todayCost: number
-  onLaunchPathAction: (id: LaunchPathId, action: LaunchPathAction) => void
+  onOpenFirstAgent: () => void
+  onOpenProtocols: () => void
+  onOpenBuilder: () => void
+  onOpenConnectors: () => void
   onOpenUsage: () => void
+  onRunEvalSuite: () => void
+  onReviewApprovals: () => void
+  onInspectFailedRuns: () => void
+  onStartReleaseQaMission: () => void
 }
 
 export function HomeLaunchpad({
@@ -92,11 +83,16 @@ export function HomeLaunchpad({
   scheduleCount,
   connectorCount,
   todayCost,
-  onLaunchPathAction,
+  onOpenFirstAgent,
+  onOpenProtocols,
+  onOpenBuilder,
+  onOpenConnectors,
   onOpenUsage,
+  onRunEvalSuite,
+  onReviewApprovals,
+  onInspectFailedRuns,
+  onStartReleaseQaMission,
 }: Props) {
-  const launchPathCards = getLaunchPathCards({ firstAgentName: firstAgent?.name })
-
   return (
     <div className="max-w-[980px] mx-auto px-6 py-10">
       <div className="rounded-[20px] border border-white/[0.06] bg-white/[0.025] p-6">
@@ -141,37 +137,93 @@ export function HomeLaunchpad({
       </div>
 
       <div className="mt-6 grid gap-3 lg:grid-cols-3">
-        {launchPathCards.map((card) => (
-          <PathCard key={card.id} card={card} onAction={onLaunchPathAction} />
-        ))}
+        <PathCard
+          kicker="Self-hosted assistant"
+          title={firstAgent ? `Work with ${firstAgent.name}` : 'Create the first agent'}
+          description="Open a live agent chat, then add memory, local tools, provider routing, or connector access as the work demands."
+          primaryLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          secondaryLabel="Connect Platform"
+          onPrimary={onOpenFirstAgent}
+          onSecondary={onOpenConnectors}
+        />
+        <PathCard
+          kicker="Visual workflow"
+          title="Shape a reusable run"
+          description="Use protocol templates and the builder to turn review, research, planning, or release checks into durable workflows."
+          primaryLabel="Open Builder"
+          secondaryLabel="Use Templates"
+          onPrimary={onOpenBuilder}
+          onSecondary={onOpenProtocols}
+        />
+        <PathCard
+          kicker="Autonomous mission"
+          title="Run with budgets"
+          description="Start a mission template for release QA, research, support triage, cost audit, or failed-run review with reports and caps."
+          primaryLabel="Open Missions"
+          secondaryLabel="Quality Center"
+          onPrimary={onStartReleaseQaMission}
+          onSecondary={onRunEvalSuite}
+        />
       </div>
 
-      <div className="mt-6 rounded-[16px] border border-white/[0.06] bg-white/[0.02] p-4">
-        <div className="flex flex-col gap-3 md:flex-row md:items-center md:justify-between">
-          <div>
-            <div className="text-[12px] font-display font-700 text-text">Keep the workspace observable</div>
-            <p className="mt-1 text-[12px] leading-relaxed text-text-3/65">
-              Provider spend, connector status, and quality evidence stay nearby after you pick a path.
-            </p>
-          </div>
-          <div className="grid gap-2 sm:grid-cols-3 md:min-w-[520px]">
-            <SecondaryAction
-              label="Usage"
-              description="Cost and provider health"
-              onClick={onOpenUsage}
-            />
-            <SecondaryAction
-              label="Connectors"
-              description="Platform bridges"
-              onClick={() => onLaunchPathAction('assistant', 'secondary')}
-            />
-            <SecondaryAction
-              label="Quality"
-              description="Evals and run review"
-              onClick={() => onLaunchPathAction('mission', 'secondary')}
-            />
-          </div>
-        </div>
+      <div className="mt-6 grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+        <LaunchActionCard
+          title={firstAgent ? 'Open First Agent Chat' : 'Open Agents'}
+          description={firstAgent
+            ? `Jump into ${firstAgent.name} and start using the workspace immediately.`
+            : 'Open the agents workspace to create or tune the first specialist agent.'}
+          actionLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          onClick={onOpenFirstAgent}
+          tone="primary"
+        />
+        <LaunchActionCard
+          title="Start Structured Session"
+          description="Open bounded collaboration runs for planning, review, decision-making, or focused multi-agent work."
+          actionLabel="Open Protocols"
+          onClick={onOpenProtocols}
+        />
+        <LaunchActionCard
+          title="Open Workflow Builder"
+          description="Move straight into reusable orchestration graphs if you want a durable workflow instead of a one-off run."
+          actionLabel="Open Builder"
+          onClick={onOpenBuilder}
+        />
+        <LaunchActionCard
+          title="Connect a Platform"
+          description="Bridge agents into chat surfaces like Discord, Slack, Telegram, and WhatsApp."
+          actionLabel="Open Connectors"
+          onClick={onOpenConnectors}
+        />
+        <LaunchActionCard
+          title="Review Usage"
+          description="Check cost, provider health, and activity so the workspace stays observable from the start."
+          actionLabel="Open Usage"
+          onClick={onOpenUsage}
+        />
+        <LaunchActionCard
+          title="Run Eval Suite"
+          description="Open the Quality Center and run scenario or suite checks against an agent before shipping."
+          actionLabel="Open Eval Lab"
+          onClick={onRunEvalSuite}
+        />
+        <LaunchActionCard
+          title="Review Approvals"
+          description="Clear pending human-loop, tool, connector, skill, agent, and budget requests from one desk."
+          actionLabel="Open Approvals"
+          onClick={onReviewApprovals}
+        />
+        <LaunchActionCard
+          title="Inspect Failed Runs"
+          description="Filter recent run failures and open replay evidence without leaving the operator workflow."
+          actionLabel="Open Run Review"
+          onClick={onInspectFailedRuns}
+        />
+        <LaunchActionCard
+          title="Start Release QA Mission"
+          description="Use a budgeted mission template to collect release readiness evidence and quality notes."
+          actionLabel="Open Missions"
+          onClick={onStartReleaseQaMission}
+        />
       </div>
 
       <div className="mt-8 grid gap-3 md:grid-cols-2 xl:grid-cols-3">

package/src/components/layout/update-banner.tsx

@@ -1,22 +1,49 @@
 'use client'
 
 import { useEffect, useState } from 'react'
+import { safeStorageGet, safeStorageSet } from '@/lib/app/safe-storage'
 
 const CHECK_INTERVAL = 5 * 60_000 // 5 minutes
+const DISMISSED_UPDATE_KEY = 'sc_update_banner_dismissed_target'
 
 type VersionInfo = {
-  localSha: string
-  remoteSha: string
+  source: 'git' | 'package'
+  version: string
+  localSha: string | null
+  localTag: string | null
+  remoteSha: string | null
+  remoteTag: string | null
+  channel: 'stable' | 'main'
   updateAvailable: boolean
   behindBy: number
 }
 
+type UpdateResponse = {
+  success: boolean
+  newSha?: string
+  targetTag?: string | null
+  channel?: 'stable' | 'main'
+  needsRestart?: boolean
+  error?: string
+}
+
 type UpdateState = 'idle' | 'updating' | 'done' | 'error'
 
+function updateTargetKey(version: VersionInfo): string {
+  return version.remoteTag || version.remoteSha || `${version.channel}:${version.behindBy}`
+}
+
+function updateTargetLabel(version: VersionInfo): string {
+  if (version.remoteTag) return version.remoteTag
+  if (version.remoteSha) return `${version.channel === 'stable' ? 'stable release' : 'main'} ${version.remoteSha}`
+  return 'latest release'
+}
+
 export function UpdateBanner() {
   const [version, setVersion] = useState<VersionInfo | null>(null)
   const [updateState, setUpdateState] = useState<UpdateState>('idle')
-  const [dismissed, setDismissed] = useState<string | null>(null)
+  const [dismissed, setDismissed] = useState<string | null>(() => safeStorageGet(DISMISSED_UPDATE_KEY))
+  const [appliedTarget, setAppliedTarget] = useState<string | null>(null)
   const [errorMsg, setErrorMsg] = useState('')
 
   useEffect(() => {
@@ -36,8 +63,9 @@ export function UpdateBanner() {
     setErrorMsg('')
     try {
       const res = await fetch('/api/version/update', { method: 'POST' })
-      const data = await res.json()
+      const data = await res.json() as UpdateResponse
       if (data.success) {
+        setAppliedTarget(data.targetTag || data.newSha || (version ? updateTargetLabel(version) : null))
         setUpdateState('done')
       } else {
         setUpdateState('error')
@@ -50,12 +78,17 @@ export function UpdateBanner() {
   }
 
   const handleDismiss = () => {
-    if (version) setDismissed(version.remoteSha)
+    if (!version) return
+    const target = updateTargetKey(version)
+    setDismissed(target)
+    safeStorageSet(DISMISSED_UPDATE_KEY, target)
   }
 
   // Don't show if no update, or user dismissed this specific remote SHA
   if (!version?.updateAvailable) return null
-  if (dismissed === version.remoteSha && updateState === 'idle') return null
+  if (dismissed === updateTargetKey(version) && updateState === 'idle') return null
+
+  const targetLabel = updateTargetLabel(version)
 
   return (
     <div className="px-4 py-1.5 border-b border-white/[0.04] text-[10px] flex items-center gap-2 shrink-0 bg-accent-bright/[0.04]">
@@ -65,7 +98,8 @@ export function UpdateBanner() {
             <path d="M12 19V5M5 12l7-7 7 7" />
           </svg>
           <span className="text-text-3 flex-1 min-w-0 truncate">
-            <span className="text-accent-bright font-600">{version.behindBy}</span> update{version.behindBy !== 1 ? 's' : ''} available
+            <span className="text-accent-bright font-600">{targetLabel}</span> available
+            {version.behindBy > 0 ? ` - ${version.behindBy} commit${version.behindBy === 1 ? '' : 's'} ahead` : ''}
           </span>
           <button
             onClick={handleUpdate}
@@ -90,7 +124,7 @@ export function UpdateBanner() {
         <>
           <span className="w-3 h-3 border-[1.5px] border-accent-bright/30 border-t-accent-bright rounded-full shrink-0"
             style={{ animation: 'spin 0.8s linear infinite' }} />
-          <span className="text-text-3">Updating...</span>
+          <span className="text-text-3">Updating to {targetLabel}...</span>
         </>
       )}
 
@@ -99,7 +133,7 @@ export function UpdateBanner() {
           <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" className="text-success shrink-0">
             <polyline points="20 6 9 17 4 12" />
           </svg>
-          <span className="text-text-3 flex-1">Updated! Restart to apply.</span>
+          <span className="text-text-3 flex-1">Updated{appliedTarget ? ` to ${appliedTarget}` : ''}. Restart SwarmClaw to apply.</span>
         </>
       )}
 

package/src/lib/home-launchpad.test.ts

@@ -1,12 +1,6 @@
 import assert from 'node:assert/strict'
 import { test } from 'node:test'
-import {
-  DEFAULT_BUILDER_ROUTE,
-  deriveHomeMode,
-  getLaunchPathCards,
-  isSparseWorkspace,
-  resolveLaunchPathHref,
-} from './home-launchpad'
+import { deriveHomeMode, isSparseWorkspace } from './home-launchpad'
 
 test('isSparseWorkspace detects a fresh workspace', () => {
   assert.equal(isSparseWorkspace({
@@ -53,27 +47,3 @@ test('deriveHomeMode falls back to ops for active workspaces', () => {
     todayCost: 0,
   }), 'ops')
 })
-
-test('getLaunchPathCards returns the three first-run paths in order', () => {
-  const cards = getLaunchPathCards({ firstAgentName: 'Ada' })
-  assert.deepEqual(cards.map((card) => card.id), ['assistant', 'workflow', 'mission'])
-  assert.equal(cards[0]?.title, 'Work with Ada')
-  assert.equal(cards[0]?.primaryLabel, 'Open Chat')
-  assert.equal(cards[1]?.primaryLabel, 'Open Builder')
-  assert.equal(cards[2]?.secondaryLabel, 'Quality Center')
-})
-
-test('getLaunchPathCards falls back to agent creation copy when no agent exists', () => {
-  const [assistant] = getLaunchPathCards()
-  assert.equal(assistant?.title, 'Create the first agent')
-  assert.equal(assistant?.primaryLabel, 'Open Agents')
-})
-
-test('resolveLaunchPathHref builds primary and secondary destinations', () => {
-  assert.equal(resolveLaunchPathHref('assistant', 'primary', 'agent one'), '/agents/agent%20one')
-  assert.equal(resolveLaunchPathHref('assistant', 'secondary', 'agent one'), '/connectors')
-  assert.equal(resolveLaunchPathHref('workflow', 'primary'), DEFAULT_BUILDER_ROUTE)
-  assert.equal(resolveLaunchPathHref('workflow', 'secondary'), '/protocols')
-  assert.equal(resolveLaunchPathHref('mission', 'primary'), '/missions')
-  assert.equal(resolveLaunchPathHref('mission', 'secondary'), '/quality')
-})

package/src/lib/home-launchpad.ts

@@ -2,17 +2,6 @@ export const HOME_LAUNCHPAD_AFTER_SETUP_KEY = 'sc_launchpad_after_setup_v1'
 export const DEFAULT_BUILDER_ROUTE = '/protocols/builder/facilitated_discussion'
 
 export type HomeMode = 'launchpad' | 'ops'
-export type LaunchPathId = 'assistant' | 'workflow' | 'mission'
-export type LaunchPathAction = 'primary' | 'secondary'
-
-export interface LaunchPathCardCopy {
-  id: LaunchPathId
-  kicker: string
-  title: string
-  description: string
-  primaryLabel: string
-  secondaryLabel: string
-}
 
 export interface HomeModeInput {
   hasLaunchpadFlag: boolean
@@ -39,50 +28,3 @@ export function deriveHomeMode(input: HomeModeInput): HomeMode {
   if (input.hasLaunchpadFlag) return 'launchpad'
   return isSparseWorkspace(input) ? 'launchpad' : 'ops'
 }
-
-export function getLaunchPathCards(input: { firstAgentName?: string | null } = {}): LaunchPathCardCopy[] {
-  const firstAgentName = input.firstAgentName?.trim() || null
-  return [
-    {
-      id: 'assistant',
-      kicker: 'Assistant',
-      title: firstAgentName ? `Work with ${firstAgentName}` : 'Create the first agent',
-      description: 'Open a live agent chat, then add memory, local tools, provider routing, or connector access as the work demands.',
-      primaryLabel: firstAgentName ? 'Open Chat' : 'Open Agents',
-      secondaryLabel: 'Connect Platform',
-    },
-    {
-      id: 'workflow',
-      kicker: 'Workflow',
-      title: 'Shape a reusable run',
-      description: 'Use protocol templates and the builder to turn review, research, planning, or release checks into durable workflows.',
-      primaryLabel: 'Open Builder',
-      secondaryLabel: 'Use Templates',
-    },
-    {
-      id: 'mission',
-      kicker: 'Mission',
-      title: 'Run with budgets',
-      description: 'Start a mission template for release QA, research, support triage, cost audit, or failed-run review with reports and caps.',
-      primaryLabel: 'Open Missions',
-      secondaryLabel: 'Quality Center',
-    },
-  ]
-}
-
-export function resolveLaunchPathHref(
-  id: LaunchPathId,
-  action: LaunchPathAction,
-  firstAgentId?: string | null,
-): string {
-  if (id === 'assistant') {
-    if (action === 'primary') {
-      return firstAgentId ? `/agents/${encodeURIComponent(firstAgentId)}` : '/agents'
-    }
-    return '/connectors'
-  }
-  if (id === 'workflow') {
-    return action === 'primary' ? DEFAULT_BUILDER_ROUTE : '/protocols'
-  }
-  return action === 'primary' ? '/missions' : '/quality'
-}

package/src/lib/provider-sets.test.ts

@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { GENERIC_CLI_PROVIDER_METADATA } from './providers/cli-provider-metadata'
+import {
+  NATIVE_CAPABILITY_PROVIDER_IDS,
+  NON_LANGGRAPH_PROVIDER_IDS,
+  WORKER_ONLY_PROVIDER_IDS,
+} from './provider-sets'
+
+describe('provider sets', () => {
+  it('routes generic CLI providers through direct provider runtime', () => {
+    for (const provider of GENERIC_CLI_PROVIDER_METADATA) {
+      assert.equal(NON_LANGGRAPH_PROVIDER_IDS.has(provider.id), true, `${provider.id} should bypass LangGraph`)
+      assert.equal(NATIVE_CAPABILITY_PROVIDER_IDS.has(provider.id), true, `${provider.id} should be native-capability`)
+      assert.equal(WORKER_ONLY_PROVIDER_IDS.has(provider.id), true, `${provider.id} should be worker-only`)
+    }
+  })
+})

package/src/lib/provider-sets.ts

@@ -1,14 +1,19 @@
+import { CLI_PROVIDER_METADATA } from '@/lib/providers/cli-provider-metadata'
+
+const CLI_PROVIDER_IDS = CLI_PROVIDER_METADATA.map((provider) => provider.id)
+const DIRECT_CLI_PROVIDER_IDS = CLI_PROVIDER_IDS.filter((providerId) => providerId !== 'goose')
+
 /** CLI providers that use their own tool execution outside the shared tool-runtime path. */
-export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'opencode-web', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli'])
+export const NON_LANGGRAPH_PROVIDER_IDS = new Set([...DIRECT_CLI_PROVIDER_IDS, 'opencode-web'])
 
 /** Providers that manage their own runtime/tool loop even when reached over an API endpoint. */
 export const RUNTIME_MANAGED_PROVIDER_IDS = new Set(['hermes', 'goose'])
 
 /** Providers with native tool/capability support (CLI providers + OpenClaw + Hermes). */
-export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set([...CLI_PROVIDER_IDS, 'openclaw', 'hermes'])
 
 /** Providers that can only act as workers — no coordinator role, no heartbeat, no advanced settings. */
-export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const WORKER_ONLY_PROVIDER_IDS = new Set([...CLI_PROVIDER_IDS, 'openclaw', 'hermes'])
 
 /** CLI providers that support MCP server and skill injection at runtime (via provider-specific config mechanisms). */
 export const MCP_INJECTION_PROVIDER_IDS = new Set(['copilot-cli', 'codex-cli'])

package/src/lib/providers/cli-provider-metadata.test.ts

@@ -0,0 +1,38 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import {
+  BESPOKE_CLI_PROVIDER_METADATA,
+  CLI_PROVIDER_METADATA,
+  CLI_PROVIDER_METADATA_BY_ID,
+  GENERIC_CLI_PROVIDER_METADATA,
+  isCliProviderId,
+} from './cli-provider-metadata'
+import { GENERIC_CLI_BINARIES } from './generic-cli'
+import { CLI_PROVIDER_CAPABILITIES } from './cli-utils'
+
+describe('CLI provider metadata', () => {
+  it('has one unique entry per CLI provider', () => {
+    const ids = CLI_PROVIDER_METADATA.map((provider) => provider.id)
+    assert.equal(new Set(ids).size, ids.length)
+    assert.ok(BESPOKE_CLI_PROVIDER_METADATA.length > 0)
+    assert.equal(GENERIC_CLI_PROVIDER_METADATA.length, 31)
+  })
+
+  it('drives binary and capability maps for every provider', () => {
+    for (const provider of CLI_PROVIDER_METADATA) {
+      assert.equal(CLI_PROVIDER_METADATA_BY_ID[provider.id]?.displayName, provider.displayName)
+      assert.equal(isCliProviderId(provider.id), true)
+      assert.equal(CLI_PROVIDER_CAPABILITIES[provider.id], provider.capability)
+      assert.ok(provider.binaryName.length > 0)
+      assert.ok(provider.defaultModel.length > 0)
+    }
+  })
+
+  it('keeps generic CLI binary mappings sourced from metadata', () => {
+    assert.deepEqual(
+      Object.fromEntries(GENERIC_CLI_PROVIDER_METADATA.map((provider) => [provider.id, provider.binaryName])),
+      GENERIC_CLI_BINARIES,
+    )
+  })
+})