@swarmclawai/swarmclaw 1.9.11 → 1.9.13

package/README.md

@@ -183,7 +183,7 @@ Full hosted deployment guides live at https://swarmclaw.ai/docs/deployment
 - **Structured Sessions**: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom `/breakout`, durable transcripts, outputs, operator controls, and a visible protocols template gallery plus visual builder.
 - **Memory**: hybrid recall, graph traversal, journaling, durable documents, project-scoped context, automatic reflection memory, communication preferences, profile and boundary memory, significant events, and open follow-up loops.
 - **Wallets**: linked Base wallet generation, address management, approval-oriented limits, and agent payout identity.
-- **Connectors**: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, SwarmDock, SwarmFeed, and more.
+- **Connectors**: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, email, local file queues, OpenClaw, SwarmDock, SwarmFeed, and more.
 - **MCP Servers**: connect any Model Context Protocol server (stdio, SSE, or streamable HTTP) and inject its tools into agents alongside built-ins. Configure, test, and assign per-agent from the MCP Servers panel.
 - **Extensions**: external tool extensions, UI modules, hooks, install/update flows, and managed resource manifests for extension-owned agents, routines, local folders, gateways, and setup checks.
 
@@ -399,6 +399,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### 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.
+
+- **File Queue connector.** Configure root, inbox, outbox, archive, and error folders from the connector sheet or CLI.
+- **JSON command ingress.** External tools can drop command envelopes into the inbox, then SwarmClaw normalizes them into connector messages for the selected agent or chatroom.
+- **Durable file handling.** Processed commands move to archive, malformed commands move to errors with diagnostic sidecars, and replies are written to outbox as structured JSON.
+- **Connector runtime parity.** Queue traffic uses the existing connector session, policy, health, readiness, CLI, and follow-up delivery paths.
+
 ### v1.9.11 Highlights
 
 Task execution policy release: operators can attach ordered review, approval, and verification stages to board tasks, record decisions, and block premature completion until required stages clear.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.11",
+  "version": "1.9.13",
   "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",
@@ -29,6 +29,7 @@
     "clawd",
     "clawdbot",
     "moltbot",
+    "file-queue",
     "openclaw-skill",
     "openclaw-dashboard",
     "openclaw-gateway",
@@ -87,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/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-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/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/app/home/page.tsx

@@ -429,7 +429,7 @@ export default function HomePage() {
             <StatCard label="Agents" value={String(agentCount)} hint="Total active agents configured in your dashboard" index={0} />
             <StatCard label="Active Tasks" value={String(activeTaskCount)} accent={activeTaskCount > 0} hint="Tasks currently running or queued for execution" index={1} />
             <StatCard label="Today's Cost" value={`$${todayCost.toFixed(2)}`} hint="Estimated API cost for today across all providers" index={2} />
-            <StatCard label="Connectors" value={`${activeConnectorCount}/${allConnectors.length}`} accent={activeConnectorCount > 0} hint="Active bridges to chat platforms (Discord, Slack, etc.)" index={3} />
+            <StatCard label="Connectors" value={`${activeConnectorCount}/${allConnectors.length}`} accent={activeConnectorCount > 0} hint="Active bridges to chat platforms, local queues, and agent channels." index={3} />
           </div>
 
           {/* Cost trend sparkline */}

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'),
     ],
   },
   {

package/src/cli/index.ts

@@ -1177,7 +1177,7 @@ export function buildProgram(): Command {
   connectors
     .command('create')
     .description('Create connector')
-    .requiredOption('--platform <platform>', 'Connector platform (discord|telegram|slack|whatsapp|openclaw|bluebubbles|signal|teams|googlechat|matrix)')
+    .requiredOption('--platform <platform>', 'Connector platform (discord|telegram|slack|whatsapp|openclaw|bluebubbles|signal|teams|googlechat|matrix|email|filequeue|swarmdock)')
     .requiredOption('--agent-id <agentId>', 'Agent id')
     .option('--name <name>', 'Connector name')
     .option('--credential-id <credentialId>', 'Credential id')

package/src/components/connectors/connector-sheet.tsx

@@ -86,6 +86,12 @@ interface ConnectorConfigField {
 }
 
 const FIELD_HINTS: Record<string, string> = {
+  rootDir: 'Root folder for the queue. Defaults to a managed folder under SwarmClaw data.',
+  inboxDir: 'Folder where external tools drop inbound JSON commands. Relative paths are resolved under Root Directory.',
+  outboxDir: 'Folder where SwarmClaw writes outbound JSON replies. Relative paths are resolved under Root Directory.',
+  archiveDir: 'Processed inbound JSON commands are moved here after routing.',
+  errorDir: 'Malformed or failed inbound JSON commands are moved here with an error sidecar.',
+  pollIntervalMs: 'How often SwarmClaw checks the inbox folder. Minimum 250 ms.',
   channelIds: "Find these in your platform's developer settings. Leave empty to allow all channels",
   chatIds: "Find these in your platform's developer settings. Leave empty to allow all chats",
   roomIds: 'Leave empty to allow all rooms visible to the bot',
@@ -366,6 +372,30 @@ const PLATFORMS: {
       { key: 'maxBudget', label: 'Max Budget (USDC micro-units)', placeholder: '5000000', help: '$1 = 1000000, $5 = 5000000' },
     ],
   },
+  {
+    id: 'filequeue',
+    label: 'File Queue',
+    color: '#22C55E',
+    setupSteps: [
+      'Choose a root directory or let SwarmClaw create a managed one',
+      'External tools write JSON commands into the inbox folder',
+      'SwarmClaw archives processed commands and writes JSON replies into the outbox folder',
+      'Use an agent or chatroom route to decide who handles inbound commands',
+    ],
+    tokenLabel: '',
+    tokenHelp: '',
+    configFields: [
+      { key: 'rootDir', label: 'Root Directory', placeholder: '~/swarmclaw-command-queue', help: 'Optional. Defaults to data/connectors/<id>/filequeue.', section: 'basic' },
+      { key: 'inboxDir', label: 'Inbox Directory', placeholder: 'inbox', help: 'Inbound JSON command directory. Relative paths resolve under Root Directory.', section: 'basic' },
+      { key: 'outboxDir', label: 'Outbox Directory', placeholder: 'outbox', help: 'Outbound JSON reply directory. Relative paths resolve under Root Directory.', section: 'basic' },
+      { key: 'archiveDir', label: 'Archive Directory', placeholder: 'archive', help: 'Processed command archive directory.', section: 'advanced' },
+      { key: 'errorDir', label: 'Error Directory', placeholder: 'errors', help: 'Malformed command quarantine directory.', section: 'advanced' },
+      { key: 'pollIntervalMs', label: 'Poll Interval (ms)', placeholder: '1000', help: 'How often to scan the inbox. Minimum 250 ms.', section: 'advanced' },
+      { key: 'defaultChannelId', label: 'Default Channel ID', placeholder: 'ops', help: 'Used when an inbound command omits channelId.', section: 'advanced' },
+      { key: 'defaultSenderId', label: 'Default Sender ID', placeholder: 'queue', help: 'Used when an inbound command omits senderId.', section: 'advanced' },
+      { key: 'defaultSenderName', label: 'Default Sender Name', placeholder: 'Queue', help: 'Used when an inbound command omits senderName.', section: 'advanced' },
+    ],
+  },
 ]
 
 const COMMON_CONFIG_FIELDS: ConnectorConfigField[] = [
@@ -780,10 +810,10 @@ export function ConnectorSheet() {
       await saveConnectorMutation.mutateAsync({
         id: editing?.id,
         payload: {
-          name: name || `${platformConfig?.label} Bot`,
+          name: name || (platform === 'filequeue' ? `${platformConfig?.label} Connector` : `${platformConfig?.label} Bot`),
           platform,
           ...routePayload,
-          credentialId: credentialId || null,
+          credentialId: showCredentialSection ? (credentialId || null) : null,
           config,
         },
       })
@@ -848,6 +878,7 @@ export function ConnectorSheet() {
   const credList = Object.values(credentials)
   const basicPlatformFields = platformConfig.configFields.filter((field) => field.section !== 'advanced')
   const advancedPlatformFields = platformConfig.configFields.filter((field) => field.section === 'advanced')
+  const showCredentialSection = Boolean(platformConfig.tokenLabel.trim())
   const basicAccessFields = ACCESS_CONTROL_FIELDS.filter((field) => field.section !== 'advanced')
   const advancedAccessFields = ACCESS_CONTROL_FIELDS.filter((field) => field.section === 'advanced')
   const hasConfiguredValue = useCallback((key: string) => Boolean(config[key]?.trim()), [config])
@@ -1014,7 +1045,7 @@ export function ConnectorSheet() {
                 <div>
                   <div className={`text-[14px] font-600 ${platform === p.id ? 'text-text' : 'text-text-2'}`}>{p.label}</div>
                   <div className="text-[11px] text-text-3 mt-0.5">
-                    {p.id === 'whatsapp' ? 'QR code pairing' : p.id === 'openclaw' ? 'WebSocket gateway' : p.id === 'bluebubbles' ? 'iMessage bridge' : p.id === 'signal' ? 'signal-cli binary' : p.id === 'matrix' ? 'Access token' : p.id === 'googlechat' ? 'Service account' : p.id === 'teams' ? 'Bot Framework' : 'Bot token'}
+                    {p.id === 'whatsapp' ? 'QR code pairing' : p.id === 'openclaw' ? 'WebSocket gateway' : p.id === 'bluebubbles' ? 'iMessage bridge' : p.id === 'signal' ? 'signal-cli binary' : p.id === 'matrix' ? 'Access token' : p.id === 'googlechat' ? 'Service account' : p.id === 'teams' ? 'Bot Framework' : p.id === 'filequeue' ? 'Local queue' : 'Bot token'}
                   </div>
                 </div>
               </button>
@@ -1074,7 +1105,7 @@ export function ConnectorSheet() {
         <input
           value={name}
           onChange={(e) => setName(e.target.value)}
-          placeholder={`My ${platformConfig.label} Bot`}
+          placeholder={`My ${platformConfig.label} ${platform === 'filequeue' ? 'Connector' : 'Bot'}`}
           className={inputClass}
           style={{ fontFamily: 'inherit' }}
         />
@@ -1128,7 +1159,7 @@ export function ConnectorSheet() {
       </div>
 
       {/* Bot token credential */}
-      {platform !== 'whatsapp' && (
+      {showCredentialSection && (
         <div className="mb-6">
           <label className="block font-display text-[12px] font-600 text-text-2 uppercase tracking-[0.08em] mb-2">{platformConfig.tokenLabel}</label>
           <p className="text-[12px] text-text-3/60 mb-2">{platformConfig.tokenHelp}</p>

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/components/shared/command-palette.tsx

@@ -92,7 +92,7 @@ function CommandPaletteInner({ setOpen }: { setOpen: (v: boolean) => void }) {
       { id: 'projects', label: 'Projects', description: 'Scoped workspaces for agents and tasks', keywords: ['workspace', 'scope'] },
       { id: 'chatrooms', label: 'Chatrooms', description: 'Shared multi-agent conversations', keywords: ['group', 'room', 'mentions'] },
       { id: 'schedules', label: 'Schedules', description: 'Recurring and timed automations', keywords: ['cron', 'automation', 'interval'] },
-      { id: 'connectors', label: 'Connectors', description: 'Bridges to Slack, Discord, Telegram, and more', keywords: ['discord', 'slack', 'telegram', 'whatsapp'] },
+      { id: 'connectors', label: 'Connectors', description: 'Bridges to Slack, Discord, Telegram, file queues, and more', keywords: ['discord', 'slack', 'telegram', 'whatsapp', 'file queue'] },
       { id: 'memory', label: 'Memory', description: 'Stored agent memory and retrieval', keywords: ['knowledge', 'vector', 'retrieval'] },
       { id: 'knowledge', label: 'Knowledge', description: 'Shared knowledge base', keywords: ['docs', 'entries', 'facts'] },
       { id: 'providers', label: 'Providers', description: 'Model providers and endpoints', keywords: ['openai', 'anthropic', 'ollama', 'endpoint'] },

package/src/components/shared/connector-platform-icon.test.ts

@@ -8,6 +8,10 @@ import {
 
 describe('connector platform metadata', () => {
   it('resolves legacy connector platforms used by stored runtime data', () => {
+    assert.deepEqual(resolveConnectorPlatformMeta('filequeue'), {
+      label: 'File Queue',
+      color: '#22C55E',
+    })
     assert.deepEqual(resolveConnectorPlatformMeta('webchat'), {
       label: 'Web Chat',
       color: '#0EA5E9',

package/src/components/shared/connector-platform-icon.tsx

@@ -26,6 +26,7 @@ export const CONNECTOR_PLATFORM_META: Record<ConnectorPlatform, { label: string;
   email: { label: 'Email', color: '#EA4335' },
   webchat: { label: 'Web Chat', color: '#0EA5E9' },
   mockmail: { label: 'MockMail', color: '#7C3AED' },
+  filequeue: { label: 'File Queue', color: '#22C55E' },
   swarmdock: { label: 'SwarmDock', color: '#F59E0B' },
 }
 

package/src/lib/connectors/connector-readiness.ts

@@ -4,7 +4,7 @@ export type ConnectorReadinessState = 'needs_setup' | 'attention' | 'healthy'
 export type ConnectorReadinessCheckStatus = 'ready' | 'warning' | 'error'
 
 export interface ConnectorReadinessCheck {
-  id: 'credentials' | 'route' | 'pairing' | 'connection' | 'gateway'
+  id: 'credentials' | 'route' | 'pairing' | 'connection' | 'gateway' | 'queue'
   label: string
   status: ConnectorReadinessCheckStatus
   detail: string
@@ -26,6 +26,7 @@ export function hasConnectorCredentials(connector: Connector): boolean {
     || connector.platform === 'openclaw'
     || connector.platform === 'signal'
     || connector.platform === 'email'
+    || connector.platform === 'filequeue'
     || connector.platform === 'swarmdock'
     || (connector.platform === 'bluebubbles' && (!!connector.credentialId || !!connector.config?.password))
     || !!connector.credentialId
@@ -53,12 +54,21 @@ export function getConnectorReadiness(connector: Connector): ConnectorReadiness
   const credentialsReady = hasConnectorCredentials(connector)
   const routeReady = hasRoute(connector)
   const checks: ConnectorReadinessCheck[] = [
-    {
-      id: 'credentials',
-      label: 'Credentials',
-      status: credentialsReady ? 'ready' : 'error',
-      detail: credentialsReady ? 'Credential path is configured.' : 'Add the token, password, or pairing credential.',
-    },
+    connector.platform === 'filequeue'
+      ? {
+          id: 'queue',
+          label: 'Queue folders',
+          status: 'ready',
+          detail: connector.config?.rootDir
+            ? `Watching ${connector.config.rootDir}`
+            : 'Using the managed local queue folder.',
+        }
+      : {
+          id: 'credentials',
+          label: 'Credentials',
+          status: credentialsReady ? 'ready' : 'error',
+          detail: credentialsReady ? 'Credential path is configured.' : 'Add the token, password, or pairing credential.',
+        },
     {
       id: 'route',
       label: 'Route target',

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'))
+  })
+})