feat: add operations pulse and evidence surfaces

Author: waydelyle

README.md

@@ -399,6 +399,16 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.8.1 Highlights
+
+Operator evidence release: a focused follow-up that makes release and mission review easier to scan.
+
+- **Operations Pulse.** Home and Quality now share a live triage panel that rolls missions, runs, approvals, connector readiness, and budget pressure into one next-action queue.
+- **Run Briefs.** Run detail sheets now open with a deterministic brief: objective, owner, timeline, warnings, usage, and evidence before the raw replay log.
+- **Evidence Shelf.** Runs and missions now expose linked artifacts, task outputs, protocol outputs, mission reports, public share links, and knowledge citations through a shared artifact resolver.
+- **Connector readiness.** Connector cards now show credential, route, pairing, gateway, connection, and doctor hints so setup gaps are visible before a platform bridge is started.
+- **API surface.** Added `GET /api/operations/pulse`, `GET /api/runs/:id/brief`, and `GET /api/artifacts` for external operator dashboards and release tooling.
+
 ### v1.8.0 Highlights
 
 Mission Command release: a bigger operator update that makes autonomous missions easier to launch, inspect, and share.

next.config.ts

@@ -6,9 +6,39 @@ import path from "path";
 import { fileURLToPath } from "url";
 
 const PROJECT_ROOT = path.dirname(fileURLToPath(import.meta.url))
-const RUNTIME_STATE_GLOBS = [
-  'data/**/*',
-  '.tmp-swarmclaw-build/**/*',
+const OUTPUT_TRACE_EXCLUDE_GLOBS = [
+  './.env*',
+  './.git/**/*',
+  './.next/cache/**/*',
+  './.tmp-swarmclaw-build/**/*',
+  './AGENTS.md',
+  './CLAUDE.md',
+  './CONTRIBUTING.md',
+  './Dockerfile',
+  './Dockerfile.*',
+  './README.md',
+  './SWARMDOCK.md',
+  './artifacts/**/*',
+  './components.json',
+  './coverage/**/*',
+  './data/**/*',
+  './daemon.log',
+  './docker-compose.yml',
+  './electron-builder.yml',
+  './electron-dist/**/*',
+  './eslint.config.mjs',
+  './fly.toml',
+  './install.sh',
+  './next.config.ts',
+  './package-lock.json',
+  './postcss.config.mjs',
+  './railway.json',
+  './release/**/*',
+  './render.yaml',
+  './research.md',
+  './swarmclaw-skill.md',
+  './test-results/**/*',
+  './tsconfig.json',
 ]
 
 function getGitSha(): string {
@@ -50,11 +80,11 @@ function getAllowedDevOrigins(): string[] {
 const nextConfig: NextConfig = {
   output: 'standalone',
   outputFileTracingExcludes: {
-    '/*': RUNTIME_STATE_GLOBS,
-    '/api/**': RUNTIME_STATE_GLOBS,
-    instrumentation: RUNTIME_STATE_GLOBS,
-    '/instrumentation': RUNTIME_STATE_GLOBS,
-    'next-server': RUNTIME_STATE_GLOBS,
+    '/*': OUTPUT_TRACE_EXCLUDE_GLOBS,
+    '/api/**': OUTPUT_TRACE_EXCLUDE_GLOBS,
+    instrumentation: OUTPUT_TRACE_EXCLUDE_GLOBS,
+    '/instrumentation': OUTPUT_TRACE_EXCLUDE_GLOBS,
+    'next-server': OUTPUT_TRACE_EXCLUDE_GLOBS,
   },
   turbopack: {
     // Pin workspace root to the project directory so a stale lockfile

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "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/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/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/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/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/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/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/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/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/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/healthz/route.test.ts src/app/api/logs/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/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/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/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/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/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/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/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/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.json

@@ -11,13 +11,15 @@ import { ensureBuildBootstrapPaths } from './build-bootstrap-env.mjs'
 
 const require = createRequire(import.meta.url)
 
-export const DEFAULT_MAX_OLD_SPACE_SIZE_MB = '12288'
+export const DEFAULT_MAX_OLD_SPACE_SIZE_MB = '24576'
 export const MIN_MAX_OLD_SPACE_SIZE_MB = 1024
 export const FALLBACK_MIN_MAX_OLD_SPACE_SIZE_MB = 512
 export const RESERVED_BUILD_MEMORY_MB = 768
-export const MAX_OLD_SPACE_RATIO = 0.75
+export const MAX_OLD_SPACE_RATIO = 0.85
 export const LOW_MEMORY_RATIO = 0.6
 export const BUILD_MAX_OLD_SPACE_SIZE_ENV = 'SWARMCLAW_BUILD_MAX_OLD_SPACE_SIZE_MB'
+export const BUILD_BUNDLER_ENV = 'SWARMCLAW_BUILD_BUNDLER'
+export const DEFAULT_BUILD_BUNDLER = 'turbopack'
 export const CGROUP_MEMORY_LIMIT_PATHS = [
   '/sys/fs/cgroup/memory.max',
   '/sys/fs/cgroup/memory/memory.limit_in_bytes',
@@ -40,6 +42,15 @@ export const REQUIRED_STANDALONE_BROWSER_PACKAGES = [
   'playwright',
   'playwright-core',
 ]
+export const STANDALONE_LOCAL_STATE_ENTRIES = [
+  '.git',
+  '.tmp-swarmclaw-build',
+  'artifacts',
+  'coverage',
+  'data',
+  'release',
+  'test-results',
+]
 
 function parsePositiveInteger(value) {
   const parsed = Number.parseInt(String(value ?? '').trim(), 10)
@@ -133,6 +144,18 @@ export function buildNextBuildEnv(
   }
 }
 
+export function resolveNextBuildBundlerFlag(args = [], env = process.env) {
+  if (args.includes('--webpack') || args.includes('--turbopack')) return null
+
+  const requested = String(env[BUILD_BUNDLER_ENV] || DEFAULT_BUILD_BUNDLER).trim().toLowerCase()
+  if (requested === 'webpack') return '--webpack'
+  if (requested === 'turbopack') return '--turbopack'
+
+  throw new Error(
+    `${BUILD_BUNDLER_ENV} must be "turbopack" or "webpack"; received ${JSON.stringify(requested)}.`,
+  )
+}
+
 export function hasTraceCopyWarning(output = '') {
   return output.includes(TRACE_COPY_WARNING)
 }
@@ -239,14 +262,36 @@ export function repairStandaloneNextMetadata(cwd = process.cwd()) {
   return true
 }
 
+export function pruneStandaloneLocalState(cwd = process.cwd()) {
+  const standaloneDir = path.join(cwd, '.next', 'standalone')
+  if (!fs.existsSync(standaloneDir)) return false
+
+  let pruned = false
+  for (const entry of STANDALONE_LOCAL_STATE_ENTRIES) {
+    const target = path.join(standaloneDir, entry)
+    if (!fs.existsSync(target)) continue
+    fs.rmSync(target, { recursive: true, force: true })
+    pruned = true
+  }
+
+  for (const entry of fs.readdirSync(standaloneDir, { withFileTypes: true })) {
+    if (entry.name !== '.env' && !entry.name.startsWith('.env.')) continue
+    fs.rmSync(path.join(standaloneDir, entry.name), { recursive: entry.isDirectory(), force: true })
+    pruned = true
+  }
+
+  return pruned
+}
+
 export function runNextBuild(
   args = process.argv.slice(2),
   env = process.env,
   cwd = process.cwd(),
   maxOldSpaceSizeMb = resolveNextBuildMaxOldSpaceSizeMb(env),
 ) {
   const nextBin = require.resolve('next/dist/bin/next')
-  return spawnSync(process.execPath, [nextBin, 'build', '--webpack', ...args], {
+  const bundlerFlag = resolveNextBuildBundlerFlag(args, env)
+  return spawnSync(process.execPath, [nextBin, 'build', ...(bundlerFlag ? [bundlerFlag] : []), ...args], {
     stdio: 'pipe',
     encoding: 'utf-8',
     env: buildNextBuildEnv(env, maxOldSpaceSizeMb, cwd),
@@ -277,6 +322,9 @@ function main() {
     if (result.status === 0 && repairStandaloneBrowserMcpRuntime(process.cwd())) {
       console.error('Copied Playwright MCP runtime packages into standalone build output.')
     }
+    if (result.status === 0 && pruneStandaloneLocalState(process.cwd())) {
+      console.error('Pruned local state and release artifacts from standalone build output.')
+    }
     process.exit(result.status)
   }
   if (result.signal) {

scripts/run-next-build.mjs

@@ -6,6 +6,7 @@ import { describe, it } from 'node:test'
 
 import { BUILD_BOOTSTRAP_ROOT_NAME } from './build-bootstrap-env.mjs'
 import {
+  BUILD_BUNDLER_ENV,
   BUILD_MAX_OLD_SPACE_SIZE_ENV,
   DEFAULT_MAX_OLD_SPACE_SIZE_MB,
   NEXT_STANDALONE_METADATA_RELATIVE_DIR,
@@ -15,10 +16,12 @@ import {
   deriveMaxOldSpaceSizeMb,
   hasTraceCopyWarning,
   mergeNodeOptions,
+  pruneStandaloneLocalState,
   repairStandaloneBrowserMcpRuntime,
   readCgroupMemoryLimitBytes,
   repairStandaloneCssTreeData,
   repairStandaloneNextMetadata,
+  resolveNextBuildBundlerFlag,
   resolveNextBuildMaxOldSpaceSizeMb,
 } from './run-next-build.mjs'
 
@@ -47,7 +50,7 @@ describe('run-next-build', () => {
   it('derives a lower heap cap for constrained Docker-style memory limits', () => {
     assert.equal(
       deriveMaxOldSpaceSizeMb(4 * 1024 * 1024 * 1024),
-      '3072',
+      '3328',
     )
     assert.equal(
       deriveMaxOldSpaceSizeMb(2 * 1024 * 1024 * 1024),
@@ -85,12 +88,12 @@ describe('run-next-build', () => {
     assert.equal(
       resolveNextBuildMaxOldSpaceSizeMb(
         {},
-        {
-          readCgroupMemoryLimitBytes: () => 4 * 1024 * 1024 * 1024,
-          totalMem: () => 16 * 1024 * 1024 * 1024,
-        },
-      ),
-      '3072',
+      {
+        readCgroupMemoryLimitBytes: () => 4 * 1024 * 1024 * 1024,
+        totalMem: () => 16 * 1024 * 1024 * 1024,
+      },
+    ),
+      '3328',
     )
   })
 
@@ -112,6 +115,16 @@ describe('run-next-build', () => {
     assert.equal(env.SWARMCLAW_BUILD_MODE, 'custom')
   })
 
+  it('uses Turbopack by default and supports Webpack override', () => {
+    assert.equal(resolveNextBuildBundlerFlag([], {}), '--turbopack')
+    assert.equal(resolveNextBuildBundlerFlag([], { [BUILD_BUNDLER_ENV]: 'webpack' }), '--webpack')
+    assert.equal(resolveNextBuildBundlerFlag(['--webpack'], {}), null)
+    assert.throws(
+      () => resolveNextBuildBundlerFlag([], { [BUILD_BUNDLER_ENV]: 'rspack' }),
+      /SWARMCLAW_BUILD_BUNDLER/,
+    )
+  })
+
   it('detects standalone trace copy warnings in build output', () => {
     assert.equal(hasTraceCopyWarning('all good'), false)
     assert.equal(
@@ -270,4 +283,28 @@ describe('run-next-build', () => {
       fs.rmSync(tempDir, { recursive: true, force: true })
     }
   })
+
+  it('pruneStandaloneLocalState removes local runtime and release output from standalone', () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-standalone-prune-'))
+    try {
+      const standaloneDir = path.join(tempDir, '.next', 'standalone')
+      fs.mkdirSync(path.join(standaloneDir, 'data'), { recursive: true })
+      fs.mkdirSync(path.join(standaloneDir, 'release'), { recursive: true })
+      fs.mkdirSync(path.join(standaloneDir, 'artifacts'), { recursive: true })
+      fs.mkdirSync(path.join(standaloneDir, 'node_modules'), { recursive: true })
+      fs.writeFileSync(path.join(standaloneDir, '.env.local'), 'SECRET=value\n')
+      fs.writeFileSync(path.join(standaloneDir, 'server.js'), 'require("next")\n')
+
+      const pruned = pruneStandaloneLocalState(tempDir)
+      assert.equal(pruned, true)
+      assert.equal(fs.existsSync(path.join(standaloneDir, 'data')), false)
+      assert.equal(fs.existsSync(path.join(standaloneDir, 'release')), false)
+      assert.equal(fs.existsSync(path.join(standaloneDir, 'artifacts')), false)
+      assert.equal(fs.existsSync(path.join(standaloneDir, '.env.local')), false)
+      assert.equal(fs.existsSync(path.join(standaloneDir, 'node_modules')), true)
+      assert.equal(fs.existsSync(path.join(standaloneDir, 'server.js')), true)
+    } finally {
+      fs.rmSync(tempDir, { recursive: true, force: true })
+    }
+  })
 })

scripts/run-next-build.test.mjs

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server'
+import { listEvidenceArtifacts } from '@/lib/server/artifacts/artifact-resolver'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url)
+  const runId = searchParams.get('runId')
+  const missionId = searchParams.get('missionId')
+  const taskId = searchParams.get('taskId')
+  if (!runId && !missionId && !taskId) {
+    return NextResponse.json({ error: 'runId, missionId, or taskId is required' }, { status: 400 })
+  }
+  return NextResponse.json(listEvidenceArtifacts({ runId, missionId, taskId }))
+}

src/app/api/artifacts/route.ts

@@ -48,7 +48,7 @@ async function writeClawHubBundleToWorkspace(bundle: ClawHubSkillBundle): Promis
     .filter((entry): entry is { file: ClawHubSkillBundle['files'][number], path: string } => Boolean(entry.path))
 
   const workspaceSkillsDir = resolveWorkspaceSkillsDir()
-  const targetDir = path.join(workspaceSkillsDir, sanitizeSkillDirName(bundle.slug))
+  const targetDir = path.join(/*turbopackIgnore: true*/ workspaceSkillsDir, sanitizeSkillDirName(bundle.slug))
   const normalizedPaths = stripSharedTopLevelDir(normalizedEntries.map((entry) => entry.path))
 
   await fs.rm(targetDir, { recursive: true, force: true })
@@ -57,12 +57,12 @@ async function writeClawHubBundleToWorkspace(bundle: ClawHubSkillBundle): Promis
   for (let index = 0; index < normalizedEntries.length; index += 1) {
     const relativePath = normalizedPaths[index]
     if (!relativePath) continue
-    const destination = path.join(targetDir, relativePath)
+    const destination = path.join(/*turbopackIgnore: true*/ targetDir, relativePath)
     if (!destination.startsWith(targetDir + path.sep) && destination !== targetDir) {
       throw new Error(`Refusing to write bundle file outside the target directory: ${relativePath}`)
     }
-    await fs.mkdir(path.dirname(destination), { recursive: true })
-    await fs.writeFile(destination, normalizedEntries[index].file.content)
+    await fs.mkdir(/*turbopackIgnore: true*/ path.dirname(destination), { recursive: true })
+    await fs.writeFile(/*turbopackIgnore: true*/ destination, normalizedEntries[index].file.content)
   }
 
   clearDiscoveredSkillsCache()

src/app/api/clawhub/install/route.ts

@@ -9,18 +9,21 @@ export async function GET(req: NextRequest) {
 
   // Resolve ~ to home dir
   const resolved = targetDir.startsWith('~')
-    ? path.join(os.homedir(), targetDir.slice(1))
-    : path.resolve(targetDir)
+    ? path.join(/*turbopackIgnore: true*/ os.homedir(), targetDir.slice(1))
+    : path.resolve(/*turbopackIgnore: true*/ targetDir)
 
   let dirs: Array<{ name: string; path: string }> = []
   try {
-    dirs = fs.readdirSync(resolved)
+    dirs = fs.readdirSync(/*turbopackIgnore: true*/ resolved)
       .filter(d => {
         if (d.startsWith('.')) return false
-        try { return fs.statSync(path.join(resolved, d)).isDirectory() } catch { return false }
+        try {
+          const childPath = path.join(/*turbopackIgnore: true*/ resolved, d)
+          return fs.statSync(/*turbopackIgnore: true*/ childPath).isDirectory()
+        } catch { return false }
       })
       .sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()))
-      .map(d => ({ name: d, path: path.join(resolved, d) }))
+      .map(d => ({ name: d, path: path.join(/*turbopackIgnore: true*/ resolved, d) }))
   } catch {}
 
   const parentPath = resolved === '/' ? null : path.dirname(resolved)