@swarmclawai/swarmclaw 1.9.12 → 1.9.14

package/README.md

@@ -399,6 +399,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.14 Highlights
+
+Session context-pack release: SwarmClaw now turns a live chat into a concise handoff packet with session metadata, recent visible turns, linked tasks, attachments, resume handles, and next actions.
+
+- **Context-pack API.** `GET /api/chats/:id/context-pack` returns structured handoff JSON, and `?format=markdown` returns copyable markdown.
+- **Chat header copy action.** Active chats with messages expose a context-pack button for quick handoff to another operator or backend.
+- **CLI access.** `swarmclaw chats context-pack <chatId> --query format=markdown` exposes the same packet for scripts and release automation.
+- **Smoke coverage.** Runtime tests and the browser smoke gate now verify the context-pack route and markdown response.
+
+### v1.9.13 Highlights
+
+Architecture health release: SwarmClaw now turns runtime ownership, dispatch, memory, startup, and quality evidence into a scored operator report.
+
+- **Architecture Health report.** `/api/quality/architecture-health` returns a structured inventory of runtime domains, surfaces, owners, guardrails, tests, score, risks, warnings, and next actions.
+- **Quality Center visibility.** `/quality` now shows a Runtime Ownership Map beside release readiness so operators can inspect dispatch, memory, startup, and quality coverage before shipping.
+- **Release gate integration.** Release readiness includes architecture health when scoring the ship gate report, blocking or warning when ownership evidence is incomplete.
+- **CLI access.** `swarmclaw operations architecture-health` exposes the same report for automation and release scripts.
+
 ### v1.9.12 Highlights
 
 Local file-queue connector release: operators can bridge SwarmClaw to filesystem inbox, outbox, archive, and error folders without a hosted message bus.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.12",
+  "version": "1.9.14",
   "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",
@@ -88,7 +88,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/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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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: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/chats/session-context-pack.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/quality/architecture-health.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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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-pack-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/chats/[id]/context-pack/route.ts

@@ -0,0 +1,43 @@
+import { NextResponse } from 'next/server'
+
+import { buildSessionContextPack, formatSessionContextPackMarkdown } from '@/lib/server/chats/session-context-pack'
+import { notFound } from '@/lib/server/collection-helpers'
+import { getMessages } from '@/lib/server/messages/message-repository'
+import { getSession } from '@/lib/server/sessions/session-repository'
+import { listTasks } from '@/lib/server/tasks/task-repository'
+
+const DEFAULT_RECENT_MESSAGES = 12
+const MAX_RECENT_MESSAGES = 40
+
+function parseMaxRecentMessages(req: Request): number {
+  const url = new URL(req.url)
+  const raw = url.searchParams.get('messages') || url.searchParams.get('maxRecentMessages')
+  const parsed = Number.parseInt(raw || '', 10)
+  if (!Number.isFinite(parsed)) return DEFAULT_RECENT_MESSAGES
+  return Math.max(1, Math.min(MAX_RECENT_MESSAGES, parsed))
+}
+
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const session = getSession(id)
+  if (!session) return notFound()
+
+  const url = new URL(req.url)
+  const format = url.searchParams.get('format')
+  const pack = buildSessionContextPack({
+    session,
+    messages: getMessages(id),
+    tasks: listTasks(),
+    maxRecentMessages: parseMaxRecentMessages(req),
+  })
+
+  if (format === 'markdown') {
+    return new Response(formatSessionContextPackMarkdown(pack), {
+      headers: {
+        'content-type': 'text/markdown; charset=utf-8',
+      },
+    })
+  }
+
+  return NextResponse.json(pack)
+}

package/src/app/api/chats/context-pack-route.test.ts

@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
+
+test('GET /api/chats/[id]/context-pack returns structured and markdown handoff context', () => {
+  const output = runWithTempDataDir<{
+    status: number
+    markdownStatus: number
+    missingStatus: number
+    schemaVersion: number
+    linkedTaskCount: number
+    recentMessageCount: number
+    markdownContentType: string
+    markdownIncludesTitle: boolean
+    markdownIncludesTask: boolean
+  }>(`
+    const storageMod = await import('./src/lib/server/storage')
+    const repoMod = await import('@/lib/server/messages/message-repository')
+    const routeMod = await import('./src/app/api/chats/[id]/context-pack/route')
+    const storage = storageMod.default || storageMod
+    const repo = repoMod.default || repoMod
+    const route = routeMod.default || routeMod
+
+    const now = Date.now()
+    storage.saveSessions({
+      sess_pack_1: {
+        id: 'sess_pack_1',
+        name: 'Context pack test',
+        cwd: process.env.WORKSPACE_DIR,
+        user: 'tester',
+        provider: 'openai',
+        model: 'gpt-4o-mini',
+        claudeSessionId: null,
+        codexThreadId: 'codex-pack-thread',
+        messages: [],
+        createdAt: now,
+        lastActiveAt: now,
+        runContext: {
+          objective: 'Hand off a release session.',
+          constraints: ['Keep the pack short.'],
+          keyFacts: ['The current tag is local only.'],
+          discoveries: [],
+          failedApproaches: [],
+          currentPlan: ['Run checks'],
+          completedSteps: [],
+          blockers: [],
+          parentContext: null,
+          updatedAt: now,
+          version: 1,
+        },
+      },
+    })
+    storage.saveTasks({
+      task_pack_1: {
+        id: 'task_pack_1',
+        title: 'Verify context pack',
+        description: 'Exercise API route.',
+        status: 'running',
+        sessionId: 'sess_pack_1',
+        agentId: null,
+        createdAt: now,
+        updatedAt: now + 3,
+      },
+    })
+
+    repo.appendMessage('sess_pack_1', { role: 'user', text: 'Prepare handoff.', time: now, attachedFiles: ['/tmp/handoff.md'] })
+    repo.appendMessage('sess_pack_1', { role: 'assistant', text: 'Ready.', time: now + 1 })
+
+    const response = await route.GET(
+      new Request('http://local/api/chats/sess_pack_1/context-pack?messages=1'),
+      { params: Promise.resolve({ id: 'sess_pack_1' }) },
+    )
+    const payload = await response.json()
+
+    const markdownResponse = await route.GET(
+      new Request('http://local/api/chats/sess_pack_1/context-pack?format=markdown'),
+      { params: Promise.resolve({ id: 'sess_pack_1' }) },
+    )
+    const markdown = await markdownResponse.text()
+
+    const missingResponse = await route.GET(
+      new Request('http://local/api/chats/missing/context-pack'),
+      { params: Promise.resolve({ id: 'missing' }) },
+    )
+
+    console.log(JSON.stringify({
+      status: response.status,
+      markdownStatus: markdownResponse.status,
+      missingStatus: missingResponse.status,
+      schemaVersion: payload.schemaVersion,
+      linkedTaskCount: payload.linkedTasks.length,
+      recentMessageCount: payload.recentMessages.length,
+      markdownContentType: markdownResponse.headers.get('content-type') || '',
+      markdownIncludesTitle: markdown.includes('# Session Context Pack: Context pack test'),
+      markdownIncludesTask: markdown.includes('Verify context pack'),
+    }))
+  `, { prefix: 'swarmclaw-context-pack-route-' })
+
+  assert.equal(output.status, 200)
+  assert.equal(output.markdownStatus, 200)
+  assert.equal(output.missingStatus, 404)
+  assert.equal(output.schemaVersion, 1)
+  assert.equal(output.linkedTaskCount, 1)
+  assert.equal(output.recentMessageCount, 1)
+  assert.match(output.markdownContentType, /text\/markdown/)
+  assert.equal(output.markdownIncludesTitle, true)
+  assert.equal(output.markdownIncludesTask, true)
+})

package/src/app/api/quality/architecture-health/route.ts

@@ -0,0 +1,16 @@
+import { NextResponse } from 'next/server'
+import { buildArchitectureHealthReport } from '@/lib/quality/architecture-health'
+import { errorMessage } from '@/lib/shared-utils'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET() {
+  try {
+    return NextResponse.json(buildArchitectureHealthReport())
+  } catch (err: unknown) {
+    return NextResponse.json(
+      { error: errorMessage(err) },
+      { status: 500 },
+    )
+  }
+}

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

@@ -1,6 +1,7 @@
 import { NextResponse } from 'next/server'
 import { evaluateEvalGate } from '@/lib/server/eval/baseline'
 import { getOperationPulse, normalizeOperationPulseRange } from '@/lib/server/operations/operation-pulse'
+import { buildArchitectureHealthReport } from '@/lib/quality/architecture-health'
 import { buildReleaseReadinessReport } from '@/lib/quality/release-readiness'
 import { errorMessage } from '@/lib/shared-utils'
 
@@ -28,7 +29,11 @@ export async function GET(req: Request) {
       })
       : null
 
-    return NextResponse.json(buildReleaseReadinessReport({ pulse, evalGate }))
+    return NextResponse.json(buildReleaseReadinessReport({
+      pulse,
+      evalGate,
+      architectureHealth: buildArchitectureHealthReport(),
+    }))
   } catch (err: unknown) {
     return NextResponse.json(
       { error: errorMessage(err) },

package/src/cli/index.js

@@ -211,6 +211,7 @@ const COMMAND_GROUPS = [
     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)'),
+      cmd('architecture-health', 'GET', '/quality/architecture-health', 'Get architecture health inventory and drift report'),
     ],
   },
   {
@@ -626,6 +627,7 @@ const COMMAND_GROUPS = [
       cmd('clear-undo', 'POST', '/chats/:id/clear/undo', 'Restore a cleared chat via its undoToken', { expectsJsonBody: true }),
       cmd('compact', 'POST', '/chats/:id/compact', 'Summarize and compact chat history (accepts optional keepLastN)', { expectsJsonBody: true }),
       cmd('context-status', 'GET', '/chats/:id/context-status', 'Report token usage and context-window status for a chat'),
+      cmd('context-pack', 'GET', '/chats/:id/context-pack', 'Get a copyable session context pack for handoff'),
       cmd('browser-status', 'GET', '/chats/:id/browser', 'Check browser status'),
       cmd('browser-close', 'DELETE', '/chats/:id/browser', 'Close browser'),
       cmd('mailbox', 'GET', '/chats/:id/mailbox', 'List chat mailbox envelopes'),

package/src/cli/spec.js

@@ -458,6 +458,7 @@ const COMMAND_GROUPS = {
       'clear-undo': { description: 'Restore a cleared chat via its undoToken', method: 'POST', path: '/chats/:id/clear/undo', params: ['id'] },
       compact: { description: 'Summarize and compact chat history', method: 'POST', path: '/chats/:id/compact', params: ['id'] },
       'context-status': { description: 'Report token usage and context-window status', method: 'GET', path: '/chats/:id/context-status', params: ['id'] },
+      'context-pack': { description: 'Get a copyable session context pack for handoff', method: 'GET', path: '/chats/:id/context-pack', params: ['id'] },
       mailbox: { description: 'List mailbox envelopes for a chat', method: 'GET', path: '/chats/:id/mailbox', params: ['id'] },
       'mailbox-action': { description: 'Send/ack/clear mailbox envelopes', method: 'POST', path: '/chats/:id/mailbox', params: ['id'] },
       queue: { description: 'List queued follow-up turns for a chat', method: 'GET', path: '/chats/:id/queue', params: ['id'] },

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

@@ -1,7 +1,7 @@
 'use client'
 
 import { useEffect, useState, useMemo, useRef, type ReactNode } from 'react'
-import { Plus } from 'lucide-react'
+import { ClipboardList, Plus } from 'lucide-react'
 import type { Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
 import { useChatStore } from '@/stores/use-chat-store'
@@ -108,6 +108,8 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
   const connectorMeta = connector ? resolveConnectorPlatformMeta(connector.platform) : null
   const connectorPresence = connector?.presence
   const [copied, setCopied] = useState(false)
+  const [contextPackCopied, setContextPackCopied] = useState(false)
+  const [contextPackLoading, setContextPackLoading] = useState(false)
   const [sourceDropdownOpen, setSourceDropdownOpen] = useState(false)
   const sourceDropdownRef = useRef<HTMLDivElement>(null)
   const [renaming, setRenaming] = useState(false)
@@ -220,6 +222,22 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
     })
   }
 
+  const handleCopyContextPack = async () => {
+    if (contextPackLoading) return
+    setContextPackLoading(true)
+    try {
+      const markdown = await api<string>('GET', `/chats/${session.id}/context-pack?format=markdown`)
+      const copiedPack = await copyTextToClipboard(markdown)
+      if (!copiedPack) return
+      setContextPackCopied(true)
+      setTimeout(() => setContextPackCopied(false), 2000)
+    } catch {
+      // Best-effort clipboard helper; the route remains available from the CLI.
+    } finally {
+      setContextPackLoading(false)
+    }
+  }
+
   const handleDismissResumeHandle = async (e: React.MouseEvent) => {
     e.stopPropagation()
     try {
@@ -302,10 +320,11 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
     }
   }, [session.name, loadConnectors])
 
-  // Context bar shows for memories, source filter, task links, resume handles, browser
+  // Context bar shows for handoff packs, memories, source filter, task links, resume handles, browser
+  const hasContextPack = messageCount > 0
   const hasMemoryLink = !!(agent && getEnabledToolIds(session).includes('memory'))
   const hasSourceFilter = !!hasMultipleSources
-  const hasContextBar = !!(hasMemoryLink || hasSourceFilter || linkedTask || resumeHandle || browserActive)
+  const hasContextBar = !!(hasContextPack || hasMemoryLink || hasSourceFilter || linkedTask || resumeHandle || browserActive)
 
   return (
     <>
@@ -523,6 +542,20 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
       {hasContextBar && (
         <div className="border-t border-white/[0.05] bg-black/[0.08] px-4 py-2">
         <div className="flex items-center gap-1.5 flex-wrap">
+          {hasContextPack && (
+            <Tip label="Copy session context pack">
+            <button
+              type="button"
+              onClick={handleCopyContextPack}
+              disabled={contextPackLoading}
+              aria-label="Copy session context pack"
+              className="flex min-w-[122px] items-center justify-center gap-1 px-2.5 py-1 rounded-[8px] bg-white/[0.03] hover:bg-white/[0.06] disabled:opacity-70 disabled:cursor-wait transition-colors cursor-pointer text-[10px] font-600 text-text-3/60 hover:text-text-2 shrink-0"
+            >
+              <ClipboardList className="h-3 w-3 shrink-0" aria-hidden="true" strokeWidth={2.2} />
+              <span>{contextPackLoading ? 'Packing' : contextPackCopied ? 'Copied' : 'Context pack'}</span>
+            </button>
+            </Tip>
+          )}
           {hasMemoryLink && (
             <Tip label="View agent memories">
             <button

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

@@ -15,6 +15,7 @@ import {
   summarizeEvalRuns,
   summarizeRunHealth,
 } from '@/lib/quality/quality-summary'
+import type { ArchitectureHealthReport, ArchitectureHealthStatus } from '@/lib/quality/architecture-health'
 import type { ReleaseReadinessReport, ReleaseReadinessStatus } from '@/lib/quality/release-readiness'
 import { cn } from '@/lib/utils'
 import { useAppStore } from '@/stores/use-app-store'
@@ -142,6 +143,18 @@ function readinessScoreTone(status: ReleaseReadinessStatus): string {
   return 'text-rose-300'
 }
 
+function architectureStatusClass(status: ArchitectureHealthStatus): string {
+  if (status === 'healthy') return 'border-emerald-500/25 bg-emerald-500/10 text-emerald-200'
+  if (status === 'watch') 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 architectureScoreTone(status: ArchitectureHealthStatus): string {
+  if (status === 'healthy') return 'text-emerald-300'
+  if (status === 'watch') return 'text-amber-300'
+  return 'text-rose-300'
+}
+
 function ReleaseReadinessPanel({
   report,
   loading,
@@ -254,6 +267,118 @@ function ReleaseReadinessPanel({
   )
 }
 
+function ArchitectureHealthPanel({
+  report,
+  loading,
+  onRefresh,
+  onOpenHref,
+}: {
+  report: ArchitectureHealthReport | 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">Architecture Health</div>
+          <h2 className="mt-1 font-display text-[17px] font-700 text-text">Runtime ownership map</h2>
+          <p className="mt-1 max-w-[680px] text-[12px] leading-relaxed text-text-3/65">
+            Inventories dispatch, memory, startup, and quality surfaces with owners, guardrails, and test evidence.
+          </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 map'}
+        </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 architecture health report...' : 'No architecture health 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]', architectureStatusClass(report.status))}>
+              {report.status}
+            </span>
+            <div className={cn('mt-4 font-display text-[42px] font-700 tracking-[-0.04em]', architectureScoreTone(report.status))}>{report.score}</div>
+            <div className="mt-1 text-[12px] text-text-3/65">health 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">Surfaces</div>
+                <div className="mt-1 text-[18px] font-800 text-text">{report.surfaceCount}</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">Guardrails</div>
+                <div className="mt-1 text-[18px] font-800 text-text">{report.guardrailCount}</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">Domains</div>
+              <div className="mt-3 grid gap-2">
+                {report.domains.map((domain) => (
+                  <div key={domain.id} className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-2">
+                    <div className="flex items-center justify-between gap-2">
+                      <div className="text-[12px] font-800 text-text">{domain.title}</div>
+                      <span className={cn('rounded-full border px-2 py-0.5 text-[9px] font-800 uppercase tracking-[0.08em]', architectureStatusClass(domain.status))}>
+                        {domain.status}
+                      </span>
+                    </div>
+                    <div className="mt-1 text-[11px] leading-relaxed text-text-3/65">{domain.surfaces.length} surfaces, {domain.testPaths.length} evidence paths</div>
+                  </div>
+                ))}
+              </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">Checks</div>
+              <div className="mt-3 flex flex-col gap-2">
+                {report.nextActions.length === 0 ? (
+                  report.checks.filter((check) => check.status === 'healthy').slice(0, 4).map((check) => (
+                    <button
+                      key={check.code}
+                      type="button"
+                      onClick={() => check.href && onOpenHref(check.href)}
+                      className="rounded-[10px] border border-emerald-500/20 bg-emerald-500/[0.05] px-3 py-2 text-left text-emerald-200 transition-colors hover:bg-emerald-500/[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>
+                  ))
+                ) : (
+                  report.nextActions.slice(0, 5).map((action) => (
+                    <button
+                      key={action.id}
+                      type="button"
+                      onClick={() => onOpenHref(action.href)}
+                      className={cn('rounded-[10px] border px-3 py-2 text-left transition-colors hover:bg-white/[0.08]', architectureStatusClass(action.severity))}
+                    >
+                      <div className="text-[11px] font-800 uppercase tracking-[0.08em]">{action.severity}</div>
+                      <div className="mt-1 text-[12px] font-700 text-text">{action.title}</div>
+                      <div className="mt-0.5 text-[11px] leading-relaxed text-text-3/70">{action.summary}</div>
+                    </button>
+                  ))
+                )}
+              </div>
+            </div>
+          </div>
+        </div>
+      )}
+    </section>
+  )
+}
+
 function EvalEnvironmentPanel({ plan, loading, onRefresh }: {
   plan: EvalEnvironmentPlan | null
   loading: boolean
@@ -471,6 +596,8 @@ export function QualityWorkspace() {
   const [evalBaselineBusy, setEvalBaselineBusy] = useState(false)
   const [releaseReadiness, setReleaseReadiness] = useState<ReleaseReadinessReport | null>(null)
   const [releaseReadinessLoading, setReleaseReadinessLoading] = useState(false)
+  const [architectureHealth, setArchitectureHealth] = useState<ArchitectureHealthReport | null>(null)
+  const [architectureHealthLoading, setArchitectureHealthLoading] = useState(false)
   const [approvalBusy, setApprovalBusy] = useState<string | null>(null)
 
   useEffect(() => {
@@ -578,10 +705,27 @@ export function QualityWorkspace() {
     }
   }, [evalGateScope, selectedAgentId, selectedScenarioId, selectedSuite])
 
+  const loadArchitectureHealth = useCallback(async () => {
+    setArchitectureHealthLoading(true)
+    try {
+      const report = await api<ArchitectureHealthReport>('GET', '/quality/architecture-health')
+      setArchitectureHealth(report)
+    } catch (err) {
+      setArchitectureHealth(null)
+      toast.error(err instanceof Error ? err.message : 'Unable to check architecture health')
+    } finally {
+      setArchitectureHealthLoading(false)
+    }
+  }, [])
+
   useEffect(() => {
     void loadQualityData()
   }, [loadQualityData])
 
+  useEffect(() => {
+    void loadArchitectureHealth()
+  }, [loadArchitectureHealth])
+
   useWs('runs', () => { void loadQualityData({ silent: true }) }, 5000)
 
   useEffect(() => {
@@ -746,7 +890,11 @@ export function QualityWorkspace() {
               {refreshing && <span className="text-[11px] text-text-3/60">Refreshing...</span>}
               <button
                 type="button"
-                onClick={() => void loadQualityData({ silent: true })}
+                onClick={() => {
+                  void loadQualityData({ silent: true })
+                  void loadArchitectureHealth()
+                  void loadReleaseReadiness()
+                }}
                 className="inline-flex items-center gap-2 rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3 py-2 text-[12px] font-700 text-text-2 transition-colors hover:bg-white/[0.08]"
               >
                 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round">
@@ -790,6 +938,12 @@ export function QualityWorkspace() {
                 onRefresh={() => void loadReleaseReadiness()}
                 onOpenHref={(href) => router.push(href)}
               />
+              <ArchitectureHealthPanel
+                report={architectureHealth}
+                loading={architectureHealthLoading}
+                onRefresh={() => void loadArchitectureHealth()}
+                onOpenHref={(href) => router.push(href)}
+              />
 
               <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
                 <StatTile

package/src/lib/quality/architecture-health.test.ts

@@ -0,0 +1,79 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import {
+  buildArchitectureHealthReport,
+  DEFAULT_ARCHITECTURE_HEALTH_INVENTORY,
+} from './architecture-health'
+
+describe('architecture health report', () => {
+  it('summarizes the default runtime architecture inventory', () => {
+    const report = buildArchitectureHealthReport({
+      generatedAt: 100_000,
+    })
+
+    assert.equal(report.generatedAt, 100_000)
+    assert.equal(report.status, 'healthy')
+    assert.equal(report.score, 100)
+    assert.equal(report.domainCount, DEFAULT_ARCHITECTURE_HEALTH_INVENTORY.length)
+    assert.ok(report.surfaceCount >= 10)
+    assert.ok(report.guardrailCount >= 8)
+    assert.ok(report.checks.some((check) => check.code === 'dispatch_guardrail_coverage'))
+    assert.ok(report.checks.some((check) => check.code === 'memory_authority'))
+    assert.ok(report.checks.some((check) => check.code === 'startup_surface_inventory'))
+  })
+
+  it('warns when a domain has an unguarded surface', () => {
+    const report = buildArchitectureHealthReport({
+      generatedAt: 100_000,
+      inventory: [{
+        id: 'dispatch',
+        title: 'Dispatch',
+        summary: 'Test dispatch surface',
+        owner: 'runtime',
+        surfaces: [{
+          id: 'direct',
+          title: 'Direct run',
+          kind: 'dispatch',
+          path: 'src/lib/server/test.ts',
+          description: 'A dispatch path without a guardrail.',
+          guardrails: [],
+          evidence: ['No policy attached'],
+        }],
+        testPaths: ['src/lib/server/test.test.ts'],
+      }],
+    })
+
+    assert.equal(report.status, 'watch')
+    assert.ok(report.score < 100)
+    assert.equal(report.warningCount, 1)
+    assert.ok(report.checks.some((check) => check.code === 'dispatch_unguarded_surface'))
+  })
+
+  it('marks missing test coverage as an architecture risk', () => {
+    const report = buildArchitectureHealthReport({
+      generatedAt: 100_000,
+      inventory: [{
+        id: 'startup',
+        title: 'Startup',
+        summary: 'Startup entry points',
+        owner: 'runtime',
+        surfaces: [{
+          id: 'cli',
+          title: 'CLI',
+          kind: 'startup',
+          path: 'src/cli/index.js',
+          description: 'CLI startup surface.',
+          guardrails: ['route coverage'],
+          evidence: ['CLI starts the server'],
+        }],
+        testPaths: [],
+      }],
+    })
+
+    assert.equal(report.status, 'risk')
+    assert.ok(report.score <= 70)
+    assert.equal(report.riskCount, 1)
+    assert.ok(report.checks.some((check) => check.code === 'startup_missing_tests'))
+  })
+})