@swarmclawai/swarmclaw 1.9.7 → 1.9.9

package/README.md

@@ -399,6 +399,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.9 Highlights
+
+Schedule revision timeline release: schedule edits, lifecycle changes, and run evidence now stay inspectable from UI, API, and CLI surfaces.
+
+- **Schedule history ledger.** Schedules now carry a bounded revision history for create, update, archive, restore, skipped, failed, and run-started events.
+- **History console.** The Schedule Console adds a searchable History tab with revision badges, actor labels, and before/after change summaries.
+- **API and CLI access.** `GET /api/schedules/:id/history` and `swarmclaw schedules history <id>` expose the same timeline for scripts and operator audits.
+- **Runtime evidence.** Manual runs and scheduler-fired runs append history entries, while storage normalization caps old entries and keeps legacy schedules compatible.
+
+### v1.9.8 Highlights
+
+Bundled release-readiness release: a single operator report that combines eval gates, operations blockers, approvals, and runtime readiness.
+
+- **Release readiness report.** `/api/quality/release-readiness` returns a scored ready/warning/blocked report built from eval regression gates and Operations Pulse evidence.
+- **Quality Center ship gate.** The Quality overview now shows readiness score, blockers, warnings, checks, and next actions before operators cut a release.
+- **CLI readiness checks.** `swarmclaw operations readiness` exposes the same report for scripts and CI.
+- **Browser coverage.** The e2e smoke now verifies the release-readiness panel on `/quality`.
+
 ### v1.9.7 Highlights
 
 Bundled eval-gate release: approved baselines, regression checks, and Quality Center release gates for repeatable eval evidence.
@@ -694,6 +712,62 @@ Older releases: https://swarmclaw.ai/docs/release-notes
 - npm package: https://www.npmjs.com/package/@swarmclawai/swarmclaw
 - Historical release notes: https://swarmclaw.ai/docs/release-notes
 
+
+## FAQ
+
+### General
+
+**What is SwarmClaw?**
+SwarmClaw is an open-source, self-hosted AI agent runtime and multi-agent framework. It lets you run autonomous AI agents, agent swarms, and orchestrators with durable memory, MCP tools, skills, delegation, schedules, and support for 23+ LLM providers — serving as a practical alternative to Claude Code and LangChain for self-hosted workflows.
+
+**How does SwarmClaw differ from LangChain or CrewAI?**
+SwarmClaw is a self-hosted runtime rather than a code library. It provides a persistent dashboard, durable agent memory, real-time org chart visualization, and built-in multi-agent orchestration with delegation — all running on your own infrastructure. LangChain and CrewAI are code frameworks you embed in your applications; SwarmClaw is the platform your agents run on.
+
+**Is SwarmClaw production-ready?**
+Yes. SwarmClaw is used in production by teams running autonomous agent swarms. It includes security features like approval-gated actions, TLS support, and access key management.
+
+### Setup & Configuration
+
+**How do I install SwarmClaw?**
+Install via npm: `npm install -g @swarmclawai/swarmclaw`, then run `swarmclaw init` to create your configuration. Docker deployment is also available via the provided Docker Compose setup.
+
+**Which LLM providers are supported?**
+SwarmClaw supports 23+ providers including OpenAI, Anthropic (Claude), Google Gemini, OpenRouter, Ollama (local), DeepSeek, Groq, Together AI, and more. Configure your API keys in the `.env` file or via the dashboard.
+
+**Can I use local models?**
+Yes. SwarmClaw integrates with Ollama and other local LLM backends for fully offline agent operation.
+
+### Agent Development
+
+**What is an agent swarm?**
+An agent swarm is a group of AI agents working together under an orchestrator. Each agent has its own role, tools, and memory. The orchestrator delegates tasks, agents execute in parallel, and results are aggregated — mimicking a real organizational structure.
+
+**What are MCP tools?**
+MCP (Model Context Protocol) tools let agents interact with external systems — databases, APIs, file systems, browsers, and more. SwarmClaw provides a marketplace of pre-built MCP tools at SwarmDock.
+
+**How does agent memory work?**
+SwarmClaw provides durable agent memory that persists across sessions. Each agent maintains its own conversation history, learned skills, and context — enabling long-running autonomous workflows.
+
+### Deployment
+
+**How do I deploy SwarmClaw?**
+Options include: local npm installation, Docker Compose for containerized deployment, or cloud VPS with reverse proxy and TLS. See the [deployment docs](https://swarmclaw.ai/docs/deployment) for detailed guides.
+
+**Can I run SwarmClaw in the cloud?**
+Yes. SwarmClaw runs on any Linux server with Node.js 18+. Popular options include AWS EC2, DigitalOcean, Hetzner, and self-hosted on home servers.
+
+### Troubleshooting
+
+**Agent is not responding. What should I check?**
+Verify your LLM API key is valid, check the agent's configuration in the dashboard, and review the agent chat logs for error messages. Common issues include rate limiting and invalid model names.
+
+**How do I update SwarmClaw?**
+Run `npm update -g @swarmclawai/swarmclaw` or pull the latest Docker image. Check the [release notes](https://swarmclaw.ai/docs/release-notes) for breaking changes.
+
+**Where can I get help?**
+- Documentation: https://swarmclaw.ai/docs
+- Discord community: https://discord.gg/sbEavS8cPV
+- GitHub Issues: https://github.com/swarmclawai/swarmclaw/issues
 ## Security Notes
 
 - First run creates an access key; keep it private.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.7",
+  "version": "1.9.9",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -87,7 +87,7 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/ensure-sandbox-browser-image.test.mjs scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/gateways/gateway-topology.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/gateways/topology-route.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/schedules/schedule-history.test.ts src/lib/quality/release-readiness.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/schedules/schedule-history-route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/src/app/api/quality/release-readiness/route.ts

@@ -0,0 +1,38 @@
+import { NextResponse } from 'next/server'
+import { evaluateEvalGate } from '@/lib/server/eval/baseline'
+import { getOperationPulse, normalizeOperationPulseRange } from '@/lib/server/operations/operation-pulse'
+import { buildReleaseReadinessReport } from '@/lib/quality/release-readiness'
+import { errorMessage } from '@/lib/shared-utils'
+
+export const dynamic = 'force-dynamic'
+
+function parseNumberParam(value: string | null): number | null {
+  if (value == null || value.trim() === '') return null
+  const parsed = Number(value)
+  return Number.isFinite(parsed) ? parsed : null
+}
+
+export async function GET(req: Request) {
+  try {
+    const { searchParams } = new URL(req.url)
+    const range = normalizeOperationPulseRange(searchParams.get('range'))
+    const agentId = searchParams.get('agentId') || ''
+    const pulse = getOperationPulse(range)
+    const evalGate = agentId
+      ? evaluateEvalGate({
+        agentId,
+        scenarioId: searchParams.get('scenarioId'),
+        suite: searchParams.get('suite'),
+        minPercent: parseNumberParam(searchParams.get('minPercent')),
+        maxRegressionPoints: parseNumberParam(searchParams.get('maxRegressionPoints')),
+      })
+      : null
+
+    return NextResponse.json(buildReleaseReadinessReport({ pulse, evalGate }))
+  } catch (err: unknown) {
+    return NextResponse.json(
+      { error: errorMessage(err) },
+      { status: 500 },
+    )
+  }
+}

package/src/app/api/schedules/[id]/history/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server'
+import { notFound } from '@/lib/server/collection-helpers'
+import { loadSchedule } from '@/lib/server/schedules/schedule-repository'
+import { normalizeScheduleHistory } from '@/lib/server/schedules/schedule-history'
+
+export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const schedule = loadSchedule(id)
+  if (!schedule) return notFound()
+  return NextResponse.json({
+    scheduleId: schedule.id,
+    revision: schedule.revision || 0,
+    history: normalizeScheduleHistory(schedule.history),
+  })
+}

package/src/app/api/schedules/[id]/route.test.ts

@@ -2,6 +2,7 @@ import assert from 'node:assert/strict'
 import test, { afterEach } from 'node:test'
 
 import { DELETE as deleteScheduleRoute, PUT as updateSchedule } from './route'
+import { GET as getScheduleHistory } from './history/route'
 import { loadAgents, loadSchedules, saveAgents, saveSchedules } from '@/lib/server/storage'
 
 const originalAgents = loadAgents()
@@ -84,7 +85,7 @@ test('PUT /api/schedules/[id] pauses equivalent reminder schedules together', as
   assert.equal(schedules.two.status, 'paused')
 })
 
-test('DELETE /api/schedules/[id] deletes equivalent reminder schedules together', async () => {
+test('DELETE /api/schedules/[id] archives equivalent reminder schedules together', async () => {
   seedAgent('schedule-route-agent-delete')
   const now = Date.now()
   saveSchedules({
@@ -123,6 +124,54 @@ test('DELETE /api/schedules/[id] deletes equivalent reminder schedules together'
 
   assert.equal(response.status, 200)
   const payload = await response.json() as Record<string, unknown>
-  assert.deepEqual(new Set(payload.deletedIds as string[]), new Set(['one', 'two']))
-  assert.deepEqual(loadSchedules(), {})
+  assert.deepEqual(new Set(payload.archivedIds as string[]), new Set(['one', 'two']))
+  const schedules = loadSchedules()
+  assert.equal(schedules.one.status, 'archived')
+  assert.equal(schedules.two.status, 'archived')
+  assert.equal(schedules.one.history?.[0]?.action, 'archived')
+})
+
+test('GET /api/schedules/[id]/history returns revision history', async () => {
+  const now = Date.now()
+  saveSchedules({
+    one: {
+      id: 'one',
+      name: 'History Schedule',
+      agentId: 'schedule-route-agent-history',
+      taskPrompt: 'Report changes',
+      scheduleType: 'interval',
+      intervalMs: 86_400_000,
+      status: 'active',
+      revision: 2,
+      history: [{
+        id: 'history-2',
+        at: now,
+        actor: 'user',
+        action: 'updated',
+        revision: 2,
+        summary: 'Schedule updated: "History Schedule"',
+        changes: [{
+          field: 'status',
+          label: 'Status',
+          before: 'paused',
+          after: 'active',
+        }],
+      }],
+      createdAt: now,
+      updatedAt: now,
+    },
+  })
+
+  const response = await getScheduleHistory(
+    new Request('http://local/api/schedules/one/history', { method: 'GET' }),
+    routeParams('one'),
+  )
+
+  assert.equal(response.status, 200)
+  const payload = await response.json() as Record<string, unknown>
+  assert.equal(payload.scheduleId, 'one')
+  assert.equal(payload.revision, 2)
+  const history = payload.history as Array<Record<string, unknown>>
+  assert.equal(history.length, 1)
+  assert.equal(history[0].action, 'updated')
 })

package/src/app/api/schedules/schedule-history-route.test.ts

@@ -0,0 +1,60 @@
+import assert from 'node:assert/strict'
+import test, { afterEach } from 'node:test'
+
+import { GET as getScheduleHistory } from './[id]/history/route'
+import { loadSchedules, saveSchedules } from '@/lib/server/storage'
+
+const originalSchedules = loadSchedules()
+
+function routeParams(id: string) {
+  return { params: Promise.resolve({ id }) }
+}
+
+afterEach(() => {
+  saveSchedules(originalSchedules)
+})
+
+test('GET /api/schedules/[id]/history returns normalized revision history', async () => {
+  const now = Date.now()
+  saveSchedules({
+    one: {
+      id: 'one',
+      name: 'History Schedule',
+      agentId: 'schedule-route-agent-history',
+      taskPrompt: 'Report changes',
+      scheduleType: 'interval',
+      intervalMs: 86_400_000,
+      status: 'active',
+      revision: 2,
+      history: [{
+        id: 'history-2',
+        at: now,
+        actor: 'user',
+        action: 'updated',
+        revision: 2,
+        summary: 'Schedule updated: "History Schedule"',
+        changes: [{
+          field: 'status',
+          label: 'Status',
+          before: 'paused',
+          after: 'active',
+        }],
+      }],
+      createdAt: now,
+      updatedAt: now,
+    },
+  })
+
+  const response = await getScheduleHistory(
+    new Request('http://local/api/schedules/one/history', { method: 'GET' }),
+    routeParams('one'),
+  )
+
+  assert.equal(response.status, 200)
+  const payload = await response.json() as Record<string, unknown>
+  assert.equal(payload.scheduleId, 'one')
+  assert.equal(payload.revision, 2)
+  const history = payload.history as Array<Record<string, unknown>>
+  assert.equal(history.length, 1)
+  assert.equal(history[0].action, 'updated')
+})

package/src/cli/index.js

@@ -210,6 +210,7 @@ const COMMAND_GROUPS = [
     description: 'Operator triage and readiness summaries',
     commands: [
       cmd('pulse', 'GET', '/operations/pulse', 'Get Operations Pulse summary (use --query range=24h or --query range=7d)'),
+      cmd('readiness', 'GET', '/quality/release-readiness', 'Get release readiness report (use --query agentId=... and --query suite=core for eval gate coverage)'),
     ],
   },
   {
@@ -578,6 +579,7 @@ const COMMAND_GROUPS = [
     commands: [
       cmd('list', 'GET', '/schedules', 'List schedules'),
       cmd('get', 'GET', '/schedules/:id', 'Get schedule by id'),
+      cmd('history', 'GET', '/schedules/:id/history', 'Get schedule revision history'),
       cmd('create', 'POST', '/schedules', 'Create schedule', { expectsJsonBody: true }),
       cmd('update', 'PUT', '/schedules/:id', 'Update schedule', { expectsJsonBody: true }),
       cmd('delete', 'DELETE', '/schedules/:id', 'Delete schedule'),

package/src/cli/index.ts

@@ -608,6 +608,14 @@ export function buildProgram(): Command {
       await runWithHandler(this as Command, (ctx) => resolveByIdFromCollection(ctx, '/schedules', id))
     })
 
+  schedules
+    .command('history')
+    .description('Get schedule revision history')
+    .argument('<id>', 'Schedule id')
+    .action(async function (id: string) {
+      await runWithHandler(this as Command, (ctx) => apiRequest(ctx, 'GET', `/schedules/${encodeURIComponent(id)}/history`))
+    })
+
   schedules
     .command('create')
     .description('Create schedule')

package/src/cli/spec.js

@@ -420,6 +420,7 @@ const COMMAND_GROUPS = {
       list: { description: 'List schedules', method: 'GET', path: '/schedules' },
       create: { description: 'Create schedule', method: 'POST', path: '/schedules' },
       get: { description: 'Get schedule by id (from list)', virtualGet: true, collectionPath: '/schedules', params: ['id'] },
+      history: { description: 'Get schedule revision history', method: 'GET', path: '/schedules/:id/history', params: ['id'] },
       update: { description: 'Update schedule', method: 'PUT', path: '/schedules/:id', params: ['id'] },
       delete: { description: 'Delete schedule', method: 'DELETE', path: '/schedules/:id', params: ['id'] },
       run: { description: 'Trigger schedule immediately', method: 'POST', path: '/schedules/:id/run', params: ['id'] },

package/src/components/quality/quality-workspace.tsx

@@ -15,6 +15,7 @@ import {
   summarizeEvalRuns,
   summarizeRunHealth,
 } from '@/lib/quality/quality-summary'
+import type { ReleaseReadinessReport, ReleaseReadinessStatus } from '@/lib/quality/release-readiness'
 import { cn } from '@/lib/utils'
 import { useAppStore } from '@/stores/use-app-store'
 import type { EvalEnvironmentPlan, EvalGateResult, EvalRun, EvalSuiteResult } from '@/lib/server/eval/types'
@@ -129,6 +130,130 @@ function gateCheckClass(status: EvalGateResult['status']): string {
   return 'border-emerald-500/20 bg-emerald-500/[0.05] text-emerald-200'
 }
 
+function readinessStatusClass(status: ReleaseReadinessStatus): string {
+  if (status === 'ready') return 'border-emerald-500/25 bg-emerald-500/10 text-emerald-200'
+  if (status === 'warning') return 'border-amber-500/25 bg-amber-500/10 text-amber-200'
+  return 'border-rose-500/25 bg-rose-500/10 text-rose-200'
+}
+
+function readinessScoreTone(status: ReleaseReadinessStatus): string {
+  if (status === 'ready') return 'text-emerald-300'
+  if (status === 'warning') return 'text-amber-300'
+  return 'text-rose-300'
+}
+
+function ReleaseReadinessPanel({
+  report,
+  loading,
+  onRefresh,
+  onOpenHref,
+}: {
+  report: ReleaseReadinessReport | null
+  loading: boolean
+  onRefresh: () => void
+  onOpenHref: (href: string) => void
+}) {
+  return (
+    <section className="rounded-[16px] border border-white/[0.06] bg-white/[0.025] p-4">
+      <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
+        <div>
+          <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-accent-bright/70">Release Readiness</div>
+          <h2 className="mt-1 font-display text-[17px] font-700 text-text">Ship gate report</h2>
+          <p className="mt-1 max-w-[680px] text-[12px] leading-relaxed text-text-3/65">
+            Combines eval regression gates, operations pulse blockers, pending approvals, active runs, budgets, connectors, and gateway readiness.
+          </p>
+        </div>
+        <button
+          type="button"
+          onClick={onRefresh}
+          disabled={loading}
+          className="shrink-0 rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3 py-2 text-[12px] font-800 text-text-2 transition-colors hover:bg-white/[0.08] disabled:opacity-40"
+        >
+          {loading ? 'Checking' : 'Refresh gate'}
+        </button>
+      </div>
+
+      {!report ? (
+        <div className="mt-4 rounded-[12px] border border-dashed border-white/[0.08] bg-white/[0.02] px-4 py-5 text-[12px] text-text-3/65">
+          {loading ? 'Building release readiness report...' : 'No release readiness report is available yet.'}
+        </div>
+      ) : (
+        <div className="mt-4 grid gap-4 xl:grid-cols-[260px_1fr]">
+          <div className="rounded-[14px] border border-white/[0.06] bg-white/[0.025] p-4">
+            <span className={cn('inline-flex rounded-full border px-2.5 py-1 text-[10px] font-800 uppercase tracking-[0.1em]', readinessStatusClass(report.status))}>
+              {report.status}
+            </span>
+            <div className={cn('mt-4 font-display text-[42px] font-700 tracking-[-0.04em]', readinessScoreTone(report.status))}>{report.score}</div>
+            <div className="mt-1 text-[12px] text-text-3/65">readiness score</div>
+            <div className="mt-4 grid grid-cols-2 gap-2">
+              <div className="rounded-[10px] bg-white/[0.035] px-3 py-2">
+                <div className="text-[10px] font-700 uppercase tracking-[0.1em] text-text-3/50">Blockers</div>
+                <div className="mt-1 text-[18px] font-800 text-text">{report.blockerCount}</div>
+              </div>
+              <div className="rounded-[10px] bg-white/[0.035] px-3 py-2">
+                <div className="text-[10px] font-700 uppercase tracking-[0.1em] text-text-3/50">Warnings</div>
+                <div className="mt-1 text-[18px] font-800 text-text">{report.warningCount}</div>
+              </div>
+            </div>
+          </div>
+
+          <div className="grid gap-3 lg:grid-cols-2">
+            <div className="rounded-[14px] border border-white/[0.06] bg-white/[0.02] p-3">
+              <div className="text-[12px] font-800 text-text">Checks</div>
+              <div className="mt-3 flex flex-col gap-2">
+                {report.checks.slice(0, 6).map((check) => (
+                  <button
+                    key={check.code}
+                    type="button"
+                    onClick={() => check.href && onOpenHref(check.href)}
+                    className={cn(
+                      'rounded-[10px] border px-3 py-2 text-left transition-colors',
+                      readinessStatusClass(check.status),
+                      check.href ? 'hover:bg-white/[0.08]' : '',
+                    )}
+                  >
+                    <div className="text-[11px] font-800 uppercase tracking-[0.08em]">{check.status}</div>
+                    <div className="mt-1 text-[12px] font-700 text-text">{check.title}</div>
+                    <div className="mt-0.5 text-[11px] leading-relaxed text-text-3/70">{check.summary}</div>
+                  </button>
+                ))}
+              </div>
+            </div>
+
+            <div className="rounded-[14px] border border-white/[0.06] bg-white/[0.02] p-3">
+              <div className="text-[12px] font-800 text-text">Next actions</div>
+              <div className="mt-3 flex flex-col gap-2">
+                {report.nextActions.length === 0 ? (
+                  <div className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-4 text-[12px] text-text-3/65">
+                    No triage actions are open in the selected window.
+                  </div>
+                ) : (
+                  report.nextActions.slice(0, 5).map((action) => (
+                    <button
+                      key={action.id}
+                      type="button"
+                      onClick={() => onOpenHref(action.href)}
+                      className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-2 text-left transition-colors hover:bg-white/[0.06]"
+                    >
+                      <div className="flex items-center justify-between gap-2">
+                        <div className="text-[12px] font-800 text-text">{action.title}</div>
+                        <span className={cn('rounded-full border px-2 py-0.5 text-[9px] font-800 uppercase tracking-[0.08em]', action.severity === 'high' ? 'border-rose-500/25 text-rose-200' : action.severity === 'medium' ? 'border-amber-500/25 text-amber-200' : 'border-emerald-500/25 text-emerald-200')}>
+                          {action.severity}
+                        </span>
+                      </div>
+                      <div className="mt-1 line-clamp-2 text-[11px] leading-relaxed text-text-3/65">{action.summary}</div>
+                    </button>
+                  ))
+                )}
+              </div>
+            </div>
+          </div>
+        </div>
+      )}
+    </section>
+  )
+}
+
 function EvalEnvironmentPanel({ plan, loading, onRefresh }: {
   plan: EvalEnvironmentPlan | null
   loading: boolean
@@ -344,6 +469,8 @@ export function QualityWorkspace() {
   const [evalGateScope, setEvalGateScope] = useState<'scenario' | 'suite'>('scenario')
   const [evalGateLoading, setEvalGateLoading] = useState(false)
   const [evalBaselineBusy, setEvalBaselineBusy] = useState(false)
+  const [releaseReadiness, setReleaseReadiness] = useState<ReleaseReadinessReport | null>(null)
+  const [releaseReadinessLoading, setReleaseReadinessLoading] = useState(false)
   const [approvalBusy, setApprovalBusy] = useState<string | null>(null)
 
   useEffect(() => {
@@ -432,6 +559,25 @@ export function QualityWorkspace() {
     }
   }, [evalGateScope, selectedAgentId, selectedScenarioId, selectedSuite])
 
+  const loadReleaseReadiness = useCallback(async () => {
+    const params = new URLSearchParams({ range: '7d' })
+    if (selectedAgentId) {
+      params.set('agentId', selectedAgentId)
+      if (evalGateScope === 'scenario' && selectedScenarioId) params.set('scenarioId', selectedScenarioId)
+      if (evalGateScope === 'suite') params.set('suite', selectedSuite)
+    }
+    setReleaseReadinessLoading(true)
+    try {
+      const report = await api<ReleaseReadinessReport>('GET', `/quality/release-readiness?${params.toString()}`)
+      setReleaseReadiness(report)
+    } catch (err) {
+      setReleaseReadiness(null)
+      toast.error(err instanceof Error ? err.message : 'Unable to check release readiness')
+    } finally {
+      setReleaseReadinessLoading(false)
+    }
+  }, [evalGateScope, selectedAgentId, selectedScenarioId, selectedSuite])
+
   useEffect(() => {
     void loadQualityData()
   }, [loadQualityData])
@@ -454,6 +600,10 @@ export function QualityWorkspace() {
     void loadEvalGate()
   }, [loadEvalGate])
 
+  useEffect(() => {
+    void loadReleaseReadiness()
+  }, [loadReleaseReadiness])
+
   useEffect(() => {
     if (!suites.some((suite) => suite.name === selectedSuite) && suites[0]) {
       setSelectedSuite(suites[0].name)
@@ -495,12 +645,13 @@ export function QualityWorkspace() {
       await loadQualityData({ silent: true })
       await loadEvalEnvironmentPlan()
       await loadEvalGate()
+      await loadReleaseReadiness()
     } catch (err) {
       toast.error(err instanceof Error ? err.message : 'Eval scenario failed')
     } finally {
       setEvalBusy(null)
     }
-  }, [evalEnvironmentPlan, loadEvalEnvironmentPlan, loadEvalGate, loadQualityData, selectedAgentId, selectedScenarioId])
+  }, [evalEnvironmentPlan, loadEvalEnvironmentPlan, loadEvalGate, loadQualityData, loadReleaseReadiness, selectedAgentId, selectedScenarioId])
 
   const runSuite = useCallback(async (suiteName: string) => {
     if (!selectedAgentId) {
@@ -524,12 +675,13 @@ export function QualityWorkspace() {
       await loadQualityData({ silent: true })
       await loadEvalEnvironmentPlan()
       await loadEvalGate()
+      await loadReleaseReadiness()
     } catch (err) {
       toast.error(err instanceof Error ? err.message : 'Eval suite failed')
     } finally {
       setEvalBusy(null)
     }
-  }, [evalEnvironmentPlan, loadEvalEnvironmentPlan, loadEvalGate, loadQualityData, selectedAgentId])
+  }, [evalEnvironmentPlan, loadEvalEnvironmentPlan, loadEvalGate, loadQualityData, loadReleaseReadiness, selectedAgentId])
 
   const setEvalBaseline = useCallback(async () => {
     if (!selectedAgentId) {
@@ -547,13 +699,14 @@ export function QualityWorkspace() {
         : { agentId: selectedAgentId, suite: selectedSuite, minPercent: evalGate?.minPercent ?? 80, maxRegressionPoints: evalGate?.maxRegressionPoints ?? 5 }
       const result = await api<{ gate: EvalGateResult }>('POST', '/eval/baselines', body)
       setEvalGate(result.gate)
+      await loadReleaseReadiness()
       toast.success('Eval baseline saved')
     } catch (err) {
       toast.error(err instanceof Error ? err.message : 'Unable to save eval baseline')
     } finally {
       setEvalBaselineBusy(false)
     }
-  }, [evalGate, evalGateScope, selectedAgentId, selectedScenarioId, selectedSuite])
+  }, [evalGate, evalGateScope, loadReleaseReadiness, selectedAgentId, selectedScenarioId, selectedSuite])
 
   const actOnApproval = useCallback(async (approval: ApprovalRequest, approved: boolean) => {
     setApprovalBusy(approval.id)
@@ -561,12 +714,13 @@ export function QualityWorkspace() {
       await api('POST', '/approvals', { id: approval.id, approved })
       toast.success(approved ? 'Approval granted' : 'Approval denied')
       await loadQualityData({ silent: true })
+      await loadReleaseReadiness()
     } catch (err) {
       toast.error(err instanceof Error ? err.message : 'Unable to update approval')
     } finally {
       setApprovalBusy(null)
     }
-  }, [loadQualityData])
+  }, [loadQualityData, loadReleaseReadiness])
 
   if (loading) {
     return (
@@ -630,6 +784,12 @@ export function QualityWorkspace() {
           {activeTab === 'overview' && (
             <div className="flex flex-col gap-6">
               <OperationsPulsePanel defaultRange="7d" compact />
+              <ReleaseReadinessPanel
+                report={releaseReadiness}
+                loading={releaseReadinessLoading}
+                onRefresh={() => void loadReleaseReadiness()}
+                onOpenHref={(href) => router.push(href)}
+              />
 
               <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
                 <StatTile