@swarmclawai/swarmclaw 1.8.13 → 1.9.2

package/README.md

@@ -399,6 +399,25 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.2 Highlights
+
+Bundled competitor-parity release: Hermes-style reasoning hygiene, deterministic delegation routing, Mission Control task workflow polish, OpenClaw export hardening, and Paperclip-style timeout hygiene.
+
+- **Stateful reasoning tag scrubber.** String-streamed `<think>`, `<thinking>`, `<reasoning>`, `<thought>`, and `<REASONING_SCRATCHPAD>` blocks are removed across split deltas and routed into SwarmClaw's thinking stream instead of leaking into visible answers.
+- **Deterministic delegation profiles.** `manage_tasks` now accepts explicit `workType` and `requiredCapabilities` routing hints, returns a stable `routeKey`, and can auto-assign unowned work without a classifier call when the profile is explicit.
+- **Assignment workflow transitions.** Newly assigned backlog/triage/todo tasks move into the `in_progress` workflow lane without changing their runtime status or queueing execution.
+- **Knowledge hygiene pruning.** Archived or superseded knowledge sources can now be pruned after a retention window, with prune actions recorded in the hygiene summary.
+- **Collision-safe exports and timeout hardening.** Portability exports support timestamped attachment filenames, the sandbox browser image build has a configurable timeout, and release notes now carry the macOS quarantine workaround for ad-hoc signed desktop builds.
+
+### v1.9.1 Highlights
+
+Task execution workspace release: the first Paperclip-style work-control slice for task-scoped workspaces, preview handoffs, and liveness evidence.
+
+- **Task-scoped execution workspaces.** Tasks can now provision a deterministic workspace under the SwarmClaw workspace root, preserving source cwd and project context while creating a task-local README for artifacts and handoffs.
+- **Preview and runtime metadata.** Tasks can carry preview links and runtime services, and the task board surfaces those links directly on task cards and sheets.
+- **Liveness snapshots.** Task list/read responses now compute blocked, queued, stale, retrying, ready, and terminal liveness states so operators can see why work is stopped or ready to run.
+- **Browser smoke coverage.** The browser smoke now creates a workspace-backed task and verifies the task board renders the workspace and liveness chips.
+
 ### v1.8.13 Highlights
 
 Task retry and host execute hotfix for issues [#68](https://github.com/swarmclawai/swarmclaw/issues/68) and [#69](https://github.com/swarmclawai/swarmclaw/issues/69).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.8.13",
+  "version": "1.9.2",
   "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",
@@ -84,10 +84,10 @@
     "lint:baseline": "node ./scripts/lint-baseline.mjs check",
     "lint:baseline:update": "node ./scripts/lint-baseline.mjs update",
     "cli": "node ./bin/swarmclaw.js",
-    "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: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/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/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/session-tools/execute.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/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/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/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/scripts/ensure-sandbox-browser-image.mjs

@@ -10,6 +10,7 @@ const args = new Set(process.argv.slice(2))
 const quiet = args.has('--quiet')
 const required = args.has('--required')
 const image = process.env.SWARMCLAW_SANDBOX_BROWSER_IMAGE || 'swarmclaw-sandbox-browser:bookworm-slim'
+const DEFAULT_BUILD_TIMEOUT_MS = 20 * 60 * 1000
 const SOURCE_LABEL = 'swarmclaw.sandboxBrowserSourceHash'
 
 function log(message) {
@@ -29,6 +30,11 @@ function run(command, commandArgs, options = {}) {
   })
 }
 
+function readPositiveInteger(value, fallback) {
+  const parsed = Number.parseInt(String(value || ''), 10)
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback
+}
+
 function commandExists(name) {
   const lookup = process.platform === 'win32' ? 'where' : 'which'
   const result = run(lookup, [name])
@@ -56,6 +62,7 @@ function readImageLabel(name, label) {
 }
 
 function buildImage(sourceHash) {
+  const timeoutMs = readPositiveInteger(process.env.SWARMCLAW_SANDBOX_BROWSER_BUILD_TIMEOUT_MS, DEFAULT_BUILD_TIMEOUT_MS)
   log(`Building sandbox browser image ${image}...`)
   const result = spawnSync(
     'docker',
@@ -69,13 +76,16 @@ function buildImage(sourceHash) {
     {
       cwd,
       stdio: 'inherit',
+      timeout: timeoutMs,
     },
   )
   if (result.error || (result.status ?? 1) !== 0) {
+    const timedOut = result.error?.code === 'ETIMEDOUT' || result.signal === 'SIGTERM'
+    const detail = timedOut ? ` Build timed out after ${timeoutMs}ms.` : ''
     if (required) {
-      fail(`Failed to build sandbox browser image ${image}.`, result.status ?? 1)
+      fail(`Failed to build sandbox browser image ${image}.${detail}`, result.status ?? 1)
     }
-    log(`Skipping sandbox browser image after build failure.`)
+    log(`Skipping sandbox browser image after build failure.${detail}`)
     return false
   }
   log(`Sandbox browser image ready: ${image}`)

package/src/app/api/knowledge/hygiene/route.ts

@@ -1,6 +1,7 @@
 import { NextResponse } from 'next/server'
 import {
   getKnowledgeHygieneSummary,
+  pruneArchivedKnowledgeSources,
   runKnowledgeHygieneMaintenance,
 } from '@/lib/server/knowledge-sources'
 
@@ -8,6 +9,23 @@ export async function GET() {
   return NextResponse.json(await getKnowledgeHygieneSummary())
 }
 
-export async function POST() {
+export async function POST(req: Request) {
+  let body: Record<string, unknown> | null = null
+  if ((req.headers.get('content-type') || '').includes('application/json')) {
+    try {
+      const parsed = await req.json()
+      if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) body = parsed as Record<string, unknown>
+    } catch {
+      body = null
+    }
+  }
+
+  if (body?.action === 'prune') {
+    const olderThanDays = typeof body.olderThanDays === 'number' ? body.olderThanDays : null
+    const result = await pruneArchivedKnowledgeSources({ olderThanDays })
+    const summary = await getKnowledgeHygieneSummary()
+    return NextResponse.json({ ...summary, prune: result })
+  }
+
   return NextResponse.json(await runKnowledgeHygieneMaintenance())
 }

package/src/app/api/portability/export/route.test.ts

@@ -0,0 +1,17 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { GET } from './route'
+import { buildPortableExportFilename } from '@/lib/server/portability/export'
+
+describe('GET /api/portability/export', () => {
+  it('returns a collision-resistant attachment filename for downloads', async () => {
+    const response = await GET(new Request('http://local/api/portability/export?download=true'))
+    assert.equal(response.status, 200)
+    assert.equal(response.headers.get('content-type'), 'application/json; charset=utf-8')
+    const disposition = response.headers.get('content-disposition') || ''
+    assert.match(disposition, /^attachment; filename="swarmclaw-export-\d{8}-\d{6}\d{3}Z\.json"$/)
+    const body = await response.json()
+    assert.equal(disposition, `attachment; filename="${buildPortableExportFilename(body)}"`)
+  })
+})

package/src/app/api/portability/export/route.ts

@@ -1,8 +1,17 @@
 import { NextResponse } from 'next/server'
-import { exportConfig } from '@/lib/server/portability/export'
+import { buildPortableExportFilename, exportConfig } from '@/lib/server/portability/export'
 export const dynamic = 'force-dynamic'
 
-export async function GET() {
+export async function GET(req: Request) {
   const manifest = exportConfig()
+  const { searchParams } = new URL(req.url)
+  if (searchParams.get('download') === 'true') {
+    return new NextResponse(JSON.stringify(manifest, null, 2), {
+      headers: {
+        'content-type': 'application/json; charset=utf-8',
+        'content-disposition': `attachment; filename="${buildPortableExportFilename(manifest)}"`,
+      },
+    })
+  }
   return NextResponse.json(manifest)
 }

package/src/app/api/tasks/task-workspace-route.test.ts

@@ -0,0 +1,112 @@
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { after, before, test } from 'node:test'
+
+import type { BoardTask } from '@/types'
+
+const originalEnv = {
+  DATA_DIR: process.env.DATA_DIR,
+  WORKSPACE_DIR: process.env.WORKSPACE_DIR,
+  SWARMCLAW_BUILD_MODE: process.env.SWARMCLAW_BUILD_MODE,
+  SWARMCLAW_DAEMON_AUTOSTART: process.env.SWARMCLAW_DAEMON_AUTOSTART,
+}
+
+let tempDir = ''
+let putTask: typeof import('./[id]/route')['PUT']
+let getTasks: typeof import('./route')['GET']
+let storage: typeof import('@/lib/server/storage')
+
+function routeParams(id: string) {
+  return { params: Promise.resolve({ id }) }
+}
+
+function seedTask(id: string, overrides: Partial<BoardTask> = {}) {
+  const now = Date.now()
+  storage.saveTasks({
+    [id]: {
+      id,
+      title: 'Workspace Task',
+      description: '',
+      status: 'backlog',
+      agentId: 'agent-1',
+      createdAt: now,
+      updatedAt: now,
+      ...overrides,
+    } as BoardTask,
+  })
+}
+
+before(async () => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-task-route-'))
+  process.env.DATA_DIR = path.join(tempDir, 'data')
+  process.env.WORKSPACE_DIR = path.join(tempDir, 'workspace')
+  process.env.SWARMCLAW_BUILD_MODE = '1'
+  process.env.SWARMCLAW_DAEMON_AUTOSTART = '0'
+  storage = await import('@/lib/server/storage')
+  putTask = (await import('./[id]/route')).PUT
+  getTasks = (await import('./route')).GET
+})
+
+after(() => {
+  if (originalEnv.DATA_DIR === undefined) delete process.env.DATA_DIR
+  else process.env.DATA_DIR = originalEnv.DATA_DIR
+  if (originalEnv.WORKSPACE_DIR === undefined) delete process.env.WORKSPACE_DIR
+  else process.env.WORKSPACE_DIR = originalEnv.WORKSPACE_DIR
+  if (originalEnv.SWARMCLAW_BUILD_MODE === undefined) delete process.env.SWARMCLAW_BUILD_MODE
+  else process.env.SWARMCLAW_BUILD_MODE = originalEnv.SWARMCLAW_BUILD_MODE
+  if (originalEnv.SWARMCLAW_DAEMON_AUTOSTART === undefined) delete process.env.SWARMCLAW_DAEMON_AUTOSTART
+  else process.env.SWARMCLAW_DAEMON_AUTOSTART = originalEnv.SWARMCLAW_DAEMON_AUTOSTART
+  fs.rmSync(tempDir, { recursive: true, force: true })
+})
+
+test('PUT /api/tasks/:id provisions an execution workspace and preview links', async () => {
+  seedTask('task-route-workspace', {
+    title: 'Route Workspace',
+    projectId: 'project-route',
+    cwd: '/source/repo',
+  })
+
+  const response = await putTask(new Request('http://local/api/tasks/task-route-workspace', {
+    method: 'PUT',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      provisionWorkspace: true,
+      previewLinks: [{ label: 'Preview', url: 'http://127.0.0.1:3456', port: 3456 }],
+      runtimeServices: [{ name: 'Next dev', status: 'planned', command: 'npm run dev', port: 3456 }],
+    }),
+  }), routeParams('task-route-workspace'))
+
+  assert.equal(response.status, 200)
+  const body = await response.json() as BoardTask
+  assert.equal(body.executionWorkspace?.sourceCwd, '/source/repo')
+  assert.equal(body.previewLinks?.[0]?.url, 'http://127.0.0.1:3456')
+  assert.equal(body.runtimeServices?.[0]?.name, 'Next dev')
+  assert.equal(fs.existsSync(body.executionWorkspace?.path || ''), true)
+})
+
+test('GET /api/tasks returns computed blocked liveness without persisting a task patch', async () => {
+  seedTask('task-blocked', {
+    title: 'Blocked Route Task',
+    status: 'backlog',
+    blockedBy: ['dep-route'],
+  })
+  const tasks = storage.loadTasks()
+  tasks['dep-route'] = {
+    id: 'dep-route',
+    title: 'Dependency',
+    description: '',
+    status: 'running',
+    agentId: 'agent-1',
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+  } as BoardTask
+  storage.saveTasks(tasks)
+
+  const response = await getTasks(new Request('http://local/api/tasks'))
+  assert.equal(response.status, 200)
+  const body = await response.json() as Record<string, BoardTask>
+  assert.equal(body['task-blocked']?.liveness?.state, 'blocked')
+  assert.deepEqual(body['task-blocked']?.liveness?.blockerTaskIds, ['dep-route'])
+})

package/src/components/tasks/task-card.tsx

@@ -1,6 +1,7 @@
 'use client'
 
 import { useState, useCallback, useEffect } from 'react'
+import { Activity, ExternalLink, FolderOpen } from 'lucide-react'
 import { useAppStore } from '@/stores/use-app-store'
 import { useNavigate } from '@/lib/app/navigation'
 import { useUpdateTaskMutation } from '@/features/tasks/queries'
@@ -8,7 +9,7 @@ import { ConfirmDialog } from '@/components/shared/confirm-dialog'
 import { AgentAvatar } from '@/components/agents/agent-avatar'
 import { timeAgo } from '@/lib/time-format'
 import { InfoChip } from '@/components/ui/info-chip'
-import type { Agent, BoardTask, Project } from '@/types'
+import type { Agent, BoardTask, Project, TaskLivenessState } from '@/types'
 
 interface TaskCardProps {
   task: BoardTask
@@ -21,6 +22,22 @@ interface TaskCardProps {
   index?: number
 }
 
+function livenessTone(state: TaskLivenessState | undefined): 'neutral' | 'muted' | 'warning' | 'danger' | 'success' | 'info' | 'purple' | 'accent' {
+  if (state === 'stale' || state === 'retrying') return 'warning'
+  if (state === 'dead_lettered' || state === 'failed') return 'danger'
+  if (state === 'blocked') return 'purple'
+  if (state === 'completed') return 'success'
+  if (state === 'running' || state === 'queued') return 'info'
+  return 'muted'
+}
+
+function livenessLabel(task: BoardTask): string | null {
+  const state = task.liveness?.state
+  if (!state) return null
+  if (state === 'dead_lettered') return 'dead letter'
+  return state.replace(/_/g, ' ')
+}
+
 export function TaskCard({
   task,
   agents,
@@ -71,6 +88,8 @@ export function TaskCard({
   const prio = task.priority && priorityConfig[task.priority]
 
   const isBlocked = Array.isArray(task.blockedBy) && task.blockedBy.length > 0
+  const previewLink = task.previewLinks?.[0] || task.executionWorkspace?.previewLinks?.[0] || null
+  const liveness = livenessLabel(task)
   const isOverdue = task.dueAt
     && task.dueAt < now
     && task.status !== 'completed'
@@ -278,6 +297,35 @@ export function TaskCard({
         </div>
       )}
 
+      {(liveness || task.executionWorkspace || previewLink) && (
+        <div className="flex flex-wrap gap-1.5 mb-3">
+          {liveness && (
+            <InfoChip tone={livenessTone(task.liveness?.state)} title={task.liveness?.reason}>
+              <Activity size={10} />
+              {liveness}
+            </InfoChip>
+          )}
+          {task.executionWorkspace && (
+            <InfoChip tone="accent" title={task.executionWorkspace.path}>
+              <FolderOpen size={10} />
+              workspace
+            </InfoChip>
+          )}
+          {previewLink && (
+            <a
+              href={previewLink.url}
+              target="_blank"
+              rel="noreferrer"
+              onClick={(e) => e.stopPropagation()}
+              className="inline-flex items-center gap-1.5 rounded-[7px] bg-emerald-500/10 px-2 py-1 text-[10px] font-600 text-emerald-300 hover:bg-emerald-500/15"
+            >
+              <ExternalLink size={10} />
+              {previewLink.label || 'Preview'}
+            </a>
+          )}
+        </div>
+      )}
+
       <div className="flex items-center gap-2 flex-wrap">
         {agent && (
           <span className="px-2 py-1 rounded-[6px] bg-accent-soft text-accent-bright text-[11px] font-600">

package/src/components/tasks/task-sheet.tsx

@@ -2,6 +2,7 @@
 
 import { useEffect, useMemo, useRef, useState } from 'react'
 import { useRouter } from 'next/navigation'
+import { Activity, ExternalLink, FolderOpen, PlayCircle } from 'lucide-react'
 import ReactMarkdown from 'react-markdown'
 import remarkGfm from 'remark-gfm'
 import { useAppStore } from '@/stores/use-app-store'
@@ -21,10 +22,11 @@ import { DirBrowser } from '@/components/shared/dir-browser'
 import { SheetFooter } from '@/components/shared/sheet-footer'
 import { inputClass } from '@/components/shared/form-styles'
 import { StructuredSessionLauncher } from '@/components/protocols/structured-session-launcher'
-import type { BoardTask, TaskComment, TaskQualityGateConfig } from '@/types'
+import type { BoardTask, TaskComment, TaskLivenessState, TaskQualityGateConfig } from '@/types'
 import { dedup, errorMessage } from '@/lib/shared-utils'
 import { SectionLabel } from '@/components/shared/section-label'
 import { AgentAvatar } from '@/components/agents/agent-avatar'
+import { InfoChip } from '@/components/ui/info-chip'
 
 function fmtTime(ts: number) {
   const d = new Date(ts)
@@ -44,6 +46,22 @@ function normalizeGateNumber(value: unknown, fallback: number, min: number, max:
   return Math.max(min, Math.min(max, Math.trunc(parsed)))
 }
 
+function livenessTone(state?: TaskLivenessState): 'neutral' | 'muted' | 'warning' | 'danger' | 'success' | 'info' | 'purple' | 'accent' {
+  if (state === 'stale' || state === 'retrying') return 'warning'
+  if (state === 'dead_lettered' || state === 'failed') return 'danger'
+  if (state === 'blocked') return 'purple'
+  if (state === 'completed') return 'success'
+  if (state === 'running' || state === 'queued') return 'info'
+  return 'muted'
+}
+
+function livenessLabel(task: BoardTask): string {
+  const state = task.liveness?.state
+  if (!state) return 'unknown'
+  if (state === 'dead_lettered') return 'dead letter'
+  return state.replace(/_/g, ' ')
+}
+
 export function TaskSheet() {
   const router = useRouter()
   const open = useAppStore((s) => s.taskSheetOpen)
@@ -85,6 +103,8 @@ export function TaskSheet() {
   const [qualityGateRequireVerification, setQualityGateRequireVerification] = useState(false)
   const [qualityGateRequireArtifact, setQualityGateRequireArtifact] = useState(false)
   const [qualityGateRequireReport, setQualityGateRequireReport] = useState(false)
+  const [provisionWorkspace, setProvisionWorkspace] = useState(false)
+  const [workspacePreparing, setWorkspacePreparing] = useState(false)
   const [structuredSessionOpen, setStructuredSessionOpen] = useState(false)
   const formInitRef = useRef<string | null>(null)
 
@@ -139,6 +159,7 @@ export function TaskSheet() {
       setQualityGateRequireVerification(gate?.requireVerification ?? defaultGateRequireVerification)
       setQualityGateRequireArtifact(gate?.requireArtifact ?? defaultGateRequireArtifact)
       setQualityGateRequireReport(gate?.requireReport ?? defaultGateRequireReport)
+      setProvisionWorkspace(false)
       formInitRef.current = initKey
       return
     }
@@ -163,6 +184,7 @@ export function TaskSheet() {
     setQualityGateRequireVerification(defaultGateRequireVerification)
     setQualityGateRequireArtifact(defaultGateRequireArtifact)
     setQualityGateRequireReport(defaultGateRequireReport)
+    setProvisionWorkspace(false)
     formInitRef.current = initKey
   }, [
     activeProjectFilter,
@@ -212,6 +234,7 @@ export function TaskSheet() {
       customFields: Object.keys(customFields).length > 0 ? customFields : undefined,
       priority: priority || undefined,
       qualityGate,
+      provisionWorkspace: !editing && provisionWorkspace ? true : undefined,
     } as Partial<BoardTask> & { title: string; description: string; agentId: string }
     try {
       if (editing) {
@@ -263,6 +286,19 @@ export function TaskSheet() {
     }
   }
 
+  const handlePrepareWorkspace = async () => {
+    if (!editing) return
+    setWorkspacePreparing(true)
+    try {
+      await updateTaskMutation.mutateAsync({ id: editing.id, patch: { provisionWorkspace: true } })
+      setDepError(null)
+    } catch (err: unknown) {
+      setDepError(errorMessage(err))
+    } finally {
+      setWorkspacePreparing(false)
+    }
+  }
+
   const handleUnarchive = async () => {
     if (editing) {
       await updateTaskMutation.mutateAsync({ id: editing.id, patch: { status: 'backlog' } })
@@ -307,6 +343,16 @@ export function TaskSheet() {
 
   const taskAgent = editing ? agents[editing.agentId] : null
   const taskProject = editing?.projectId ? projects[editing.projectId] : null
+  const previewLinks = editing
+    ? (editing.previewLinks && editing.previewLinks.length > 0
+      ? editing.previewLinks
+      : editing.executionWorkspace?.previewLinks || [])
+    : []
+  const runtimeServices = editing
+    ? (editing.runtimeServices && editing.runtimeServices.length > 0
+      ? editing.runtimeServices
+      : editing.executionWorkspace?.runtimeServices || [])
+    : []
 
   /* ───── View-only mode ───── */
   if (viewOnly && editing) {
@@ -385,6 +431,67 @@ export function TaskSheet() {
           </div>
         )}
 
+        <div className="mb-8">
+          <SectionLabel>Execution</SectionLabel>
+          <div className="rounded-[14px] border border-white/[0.06] bg-surface p-4 space-y-3">
+            <div className="flex flex-wrap items-center gap-2">
+              {editing.liveness && (
+                <InfoChip tone={livenessTone(editing.liveness.state)} title={editing.liveness.reason}>
+                  <Activity size={12} />
+                  {livenessLabel(editing)}
+                </InfoChip>
+              )}
+              {editing.executionWorkspace ? (
+                <InfoChip tone="accent" title={editing.executionWorkspace.path}>
+                  <FolderOpen size={12} />
+                  Workspace ready
+                </InfoChip>
+              ) : (
+                <InfoChip tone="muted">
+                  <FolderOpen size={12} />
+                  No workspace
+                </InfoChip>
+              )}
+              {runtimeServices.map((service) => (
+                <InfoChip key={service.id} tone={service.status === 'running' ? 'success' : service.status === 'failed' ? 'danger' : 'neutral'}>
+                  <PlayCircle size={12} />
+                  {service.name}: {service.status}
+                </InfoChip>
+              ))}
+            </div>
+            {editing.executionWorkspace?.path && (
+              <code className="block text-[12px] text-text-3 font-mono break-all">{editing.executionWorkspace.path}</code>
+            )}
+            {previewLinks.length > 0 && (
+              <div className="flex flex-wrap gap-2">
+                {previewLinks.map((link) => (
+                  <a
+                    key={link.id}
+                    href={link.url}
+                    target="_blank"
+                    rel="noreferrer"
+                    className="inline-flex items-center gap-1.5 rounded-[8px] bg-emerald-500/10 px-2.5 py-1.5 text-[12px] font-600 text-emerald-300 hover:bg-emerald-500/15"
+                  >
+                    <ExternalLink size={12} />
+                    {link.label || 'Preview'}
+                  </a>
+                ))}
+              </div>
+            )}
+            {!editing.executionWorkspace && (
+              <button
+                onClick={handlePrepareWorkspace}
+                disabled={workspacePreparing}
+                className="inline-flex items-center gap-2 rounded-[10px] border border-accent-bright/20 bg-accent-bright/10 px-3 py-2 text-[12px] font-600 text-accent-bright hover:bg-accent-bright/14 disabled:opacity-50"
+                style={{ fontFamily: 'inherit' }}
+              >
+                <FolderOpen size={13} />
+                {workspacePreparing ? 'Preparing...' : 'Prepare Workspace'}
+              </button>
+            )}
+          </div>
+        </div>
+
         {/* Tags */}
         {editing.tags && editing.tags.length > 0 && (
           <div className="mb-8">
@@ -809,6 +916,71 @@ export function TaskSheet() {
         />
       </div>
 
+      <div className="mb-8">
+        <SectionLabel>Execution Workspace</SectionLabel>
+        {editing ? (
+          <div className="rounded-[14px] border border-white/[0.06] bg-surface p-4 space-y-3">
+            <div className="flex flex-wrap items-center gap-2">
+              {editing.liveness && (
+                <InfoChip tone={livenessTone(editing.liveness.state)} title={editing.liveness.reason}>
+                  <Activity size={12} />
+                  {livenessLabel(editing)}
+                </InfoChip>
+              )}
+              {editing.executionWorkspace ? (
+                <InfoChip tone="accent" title={editing.executionWorkspace.path}>
+                  <FolderOpen size={12} />
+                  Workspace ready
+                </InfoChip>
+              ) : (
+                <InfoChip tone="muted">
+                  <FolderOpen size={12} />
+                  No workspace
+                </InfoChip>
+              )}
+            </div>
+            {editing.executionWorkspace?.path && (
+              <code className="block text-[12px] text-text-3 font-mono break-all">{editing.executionWorkspace.path}</code>
+            )}
+            {previewLinks.length > 0 && (
+              <div className="flex flex-wrap gap-2">
+                {previewLinks.map((link) => (
+                  <a
+                    key={link.id}
+                    href={link.url}
+                    target="_blank"
+                    rel="noreferrer"
+                    className="inline-flex items-center gap-1.5 rounded-[8px] bg-emerald-500/10 px-2.5 py-1.5 text-[12px] font-600 text-emerald-300 hover:bg-emerald-500/15"
+                  >
+                    <ExternalLink size={12} />
+                    {link.label || 'Preview'}
+                  </a>
+                ))}
+              </div>
+            )}
+            <button
+              onClick={handlePrepareWorkspace}
+              disabled={workspacePreparing}
+              className="inline-flex items-center gap-2 rounded-[10px] border border-accent-bright/20 bg-accent-bright/10 px-3 py-2 text-[12px] font-600 text-accent-bright hover:bg-accent-bright/14 disabled:opacity-50"
+              style={{ fontFamily: 'inherit' }}
+            >
+              <FolderOpen size={13} />
+              {workspacePreparing ? 'Preparing...' : editing.executionWorkspace ? 'Refresh Workspace' : 'Prepare Workspace'}
+            </button>
+          </div>
+        ) : (
+          <label className="flex items-center gap-2 rounded-[14px] border border-white/[0.06] bg-surface px-4 py-3 text-[13px] text-text-2">
+            <input
+              type="checkbox"
+              checked={provisionWorkspace}
+              onChange={(e) => setProvisionWorkspace(e.target.checked)}
+              className="h-4 w-4 rounded border-white/20 accent-accent"
+            />
+            Prepare a task-scoped workspace when this task is created
+          </label>
+        )}
+      </div>
+
       {/* Tags */}
       <div className="mb-8">
         <SectionLabel>Tags <span className="normal-case tracking-normal font-normal text-text-3">(optional)</span></SectionLabel>

package/src/components/ui/info-chip.tsx

@@ -30,11 +30,12 @@ const chipVariants = cva(
 interface InfoChipProps extends VariantProps<typeof chipVariants> {
   children: React.ReactNode
   className?: string
+  title?: string
 }
 
-export function InfoChip({ size, tone, children, className }: InfoChipProps) {
+export function InfoChip({ size, tone, children, className, title }: InfoChipProps) {
   return (
-    <span className={cn(chipVariants({ size, tone }), className)}>
+    <span title={title} className={cn(chipVariants({ size, tone }), className)}>
       {children}
     </span>
   )

package/src/features/tasks/queries.ts

@@ -8,6 +8,7 @@ import {
   updateTask,
   type GitHubIssueImportRequest,
   type GitHubIssueImportResult,
+  type TaskWriteInput,
 } from '@/lib/tasks'
 import type { BoardTask, BoardTaskStatus, TaskComment } from '@/types'
 
@@ -98,7 +99,7 @@ export function useCreateTaskMutation() {
 export function useUpdateTaskMutation() {
   const queryClient = useQueryClient()
   return useMutation({
-    mutationFn: ({ id, patch }: { id: string; patch: Partial<BoardTask> }) => updateTask(id, patch),
+    mutationFn: ({ id, patch }: { id: string; patch: TaskWriteInput }) => updateTask(id, patch),
     onMutate: async ({ id, patch }) => {
       await queryClient.cancelQueries({ queryKey: taskQueryKeys.lists() })
       const snapshots = patchTaskCaches(queryClient, (current, includeArchived) => {