@swarmclawai/swarmclaw 1.9.3 → 1.9.5

package/README.md

@@ -399,19 +399,39 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.5 Highlights
+
+Bundled portability release: project-scoped workspace bundles, safer v2 imports, and preserved internal relationships for reusable teams.
+
+- **Project bundle export.** `/api/portability/export?projectId=...` now emits a scoped workspace template with the selected project, active agents, pinned skills, schedules, chatrooms, connectors, MCP servers, and goals.
+- **Downloadable project templates.** Project exports include a `scope` block and use readable `swarmclaw-project-...json` filenames for portable team handoff.
+- **v2 import preservation.** The import route now validates and preserves v2 resources instead of dropping connectors, chatrooms, MCP servers, projects, goals, extensions, or scope metadata.
+- **Reference remapping.** Imports now remap project, skill, MCP server, schedule, chatroom, connector, and goal relationships so restored bundles remain internally linked.
+- **Credential-safe bundles.** Connector credentials, MCP env values, and sensitive config keys stay scrubbed while non-secret setup hints are retained.
+
+### v1.9.4 Highlights
+
+Bundled runtime-environment release: gateway execution visibility, task context handoff, and operator triage in one release cycle.
+
+- **OpenClaw environments.** Gateway topology now calls `environments.list`, stores available environment counts, exposes `/api/gateways/:id/environments`, and adds CLI commands for list/status checks.
+- **Provider dashboard visibility.** The Providers screen now shows fleet-wide and per-gateway execution environment availability alongside nodes, sessions, presence, and pairings.
+- **Task context packets.** Prepared task workspaces now write `context.json` with task, preview, runtime, blocker, tag, and upstream-result context for external workers.
+- **Runtime env handoff.** Workspaces now include `.env.swarmclaw` plus SwarmClaw, portable task/workspace, and `AGENT_HOME` env hints without embedding secrets.
+- **Operations Pulse triage.** Gateway actions now surface zero-available-environment states as high-priority operator work.
+
 ### v1.9.3 Highlights
 
-Bundled extension-orchestration release: Paperclip-style managed plugin resources, Hermes-style gateway/setup declarations, and safer local folder access in one release cycle.
+Bundled extension-orchestration release: managed plugin resources, gateway/setup declarations, and safer local folder access in one release cycle.
 
-- **Managed extension resources.** Extensions can now declare provisionable agents, schedules/routines, local folders, gateway platforms, and setup checks through `managedResources` or Paperclip-compatible top-level aliases.
+- **Managed extension resources.** Extensions can now declare provisionable agents, schedules/routines, local folders, gateway platforms, and setup checks through `managedResources` or top-level manifest aliases.
 - **Deterministic reconciliation.** `/api/extensions/managed-resources` can preview and reconcile extension-owned agents and routines with stable IDs and `managedByExtension` markers.
 - **Trusted local folders.** Extension-declared local folders support root-bounded inspection and recursive listing with traversal and symlink-escape protection.
 - **Operator UI.** The Extensions screen now shows managed-resource badges and a Managed tab with totals plus per-extension reconcile controls.
-- **Extension authoring spec.** `extension_creator` now documents managed resources, gateway declarations, setup checks, and Paperclip-compatible manifest aliases.
+- **Extension authoring spec.** `extension_creator` now documents managed resources, gateway declarations, setup checks, and manifest aliases.
 
 ### 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.
+Bundled runtime-polish release: reasoning hygiene, deterministic delegation routing, task workflow polish, OpenClaw export hardening, and 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.
@@ -421,7 +441,7 @@ Bundled competitor-parity release: Hermes-style reasoning hygiene, deterministic
 
 ### 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 execution workspace release: 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.

package/package.json

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

@@ -0,0 +1,16 @@
+import { NextResponse } from 'next/server'
+
+import { notFound } from '@/lib/server/collection-helpers'
+import { getOpenClawGatewayEnvironmentStatus } from '@/lib/server/gateways/gateway-topology'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(
+  _req: Request,
+  { params }: { params: Promise<{ id: string; environmentId: string }> },
+) {
+  const { id, environmentId } = await params
+  const snapshot = await getOpenClawGatewayEnvironmentStatus(id, decodeURIComponent(environmentId))
+  if (!snapshot) return notFound()
+  return NextResponse.json(snapshot, { status: snapshot.errors.length > 0 ? 502 : 200 })
+}

package/src/app/api/gateways/[id]/environments/route.ts

@@ -0,0 +1,13 @@
+import { NextResponse } from 'next/server'
+
+import { notFound } from '@/lib/server/collection-helpers'
+import { listOpenClawGatewayEnvironments } from '@/lib/server/gateways/gateway-topology'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const snapshot = await listOpenClawGatewayEnvironments(id)
+  if (!snapshot) return notFound()
+  return NextResponse.json(snapshot)
+}

package/src/app/api/gateways/topology-route.test.ts

@@ -18,6 +18,36 @@ test('gateway topology route returns 404 for unknown profiles', () => {
   assert.equal(output.body.error, 'Not found')
 })
 
+test('gateway environments route returns 404 for unknown profiles', () => {
+  const output = runWithTempDataDir<{ status: number; body: { error: string } }>(`
+    const routeMod = await import('./src/app/api/gateways/[id]/environments/route')
+    const route = routeMod.default || routeMod
+    const response = await route.GET(
+      new Request('http://local/api/gateways/missing/environments'),
+      { params: Promise.resolve({ id: 'missing' }) },
+    )
+    console.log(JSON.stringify({ status: response.status, body: await response.json() }))
+  `, { prefix: 'swarmclaw-gateway-environments-route-test-' })
+
+  assert.equal(output.status, 404)
+  assert.equal(output.body.error, 'Not found')
+})
+
+test('gateway environment status route returns 404 for unknown profiles', () => {
+  const output = runWithTempDataDir<{ status: number; body: { error: string } }>(`
+    const routeMod = await import('./src/app/api/gateways/[id]/environments/[environmentId]/route')
+    const route = routeMod.default || routeMod
+    const response = await route.GET(
+      new Request('http://local/api/gateways/missing/environments/gateway'),
+      { params: Promise.resolve({ id: 'missing', environmentId: 'gateway' }) },
+    )
+    console.log(JSON.stringify({ status: response.status, body: await response.json() }))
+  `, { prefix: 'swarmclaw-gateway-environment-status-route-test-' })
+
+  assert.equal(output.status, 404)
+  assert.equal(output.body.error, 'Not found')
+})
+
 test('gateway fleet route reports empty totals when no OpenClaw profiles exist', () => {
   const output = runWithTempDataDir<{
     status: number

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

@@ -3,6 +3,7 @@ import { describe, it } from 'node:test'
 
 import { GET } from './route'
 import { buildPortableExportFilename } from '@/lib/server/portability/export'
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
 
 describe('GET /api/portability/export', () => {
   it('returns a collision-resistant attachment filename for downloads', async () => {
@@ -14,4 +15,228 @@ describe('GET /api/portability/export', () => {
     const body = await response.json()
     assert.equal(disposition, `attachment; filename="${buildPortableExportFilename(body)}"`)
   })
+
+  it('exports a scoped project bundle with scrubbed integrations', () => {
+    const output = runWithTempDataDir<{
+      status: number
+      disposition: string
+      scopeKind: string
+      projectNames: string[]
+      agentNames: string[]
+      skillNames: string[]
+      scheduleNames: string[]
+      chatroomNames: string[]
+      connectorNames: string[]
+      mcpServerNames: string[]
+      connectorConfig: Record<string, string>
+      connectorEnabled: boolean
+      missingStatus: number
+      missingError: string
+    }>(`
+      const storageMod = await import('./src/lib/server/storage')
+      const agentRepoMod = await import('./src/lib/server/agents/agent-repository')
+      const skillRepoMod = await import('./src/lib/server/skills/skill-repository')
+      const scheduleRepoMod = await import('./src/lib/server/schedules/schedule-repository')
+      const chatroomRepoMod = await import('./src/lib/server/chatrooms/chatroom-repository')
+      const connectorRepoMod = await import('./src/lib/server/connectors/connector-repository')
+      const routeMod = await import('./src/app/api/portability/export/route')
+      const storage = storageMod.default || storageMod
+      const agentRepo = agentRepoMod.default || agentRepoMod
+      const skillRepo = skillRepoMod.default || skillRepoMod
+      const scheduleRepo = scheduleRepoMod.default || scheduleRepoMod
+      const chatroomRepo = chatroomRepoMod.default || chatroomRepoMod
+      const connectorRepo = connectorRepoMod.default || connectorRepoMod
+      const route = routeMod.default || routeMod
+      const { saveProjects, saveMcpServers } = storage
+      const { saveAgents } = agentRepo
+      const { saveSkills } = skillRepo
+      const { saveSchedules } = scheduleRepo
+      const { upsertChatroom } = chatroomRepo
+      const { upsertConnector } = connectorRepo
+      const now = 1780000000000
+
+      saveProjects({
+        'project-a': {
+          id: 'project-a',
+          name: 'Launch Room',
+          description: 'Shipping workspace',
+          color: '#5b8def',
+          objective: 'Ship the next release',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'project-b': {
+          id: 'project-b',
+          name: 'Backlog',
+          description: 'Separate workspace',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveSkills({
+        'skill-a': {
+          id: 'skill-a',
+          name: 'Release Notes',
+          filename: 'release-notes.md',
+          content: 'Summarize shipped changes',
+          projectId: 'project-a',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'global-skill': {
+          id: 'global-skill',
+          name: 'Risk Scan',
+          filename: 'risk-scan.md',
+          content: 'Find release risks',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'skill-b': {
+          id: 'skill-b',
+          name: 'Backlog Grooming',
+          filename: 'backlog-grooming.md',
+          content: 'Sort the backlog',
+          projectId: 'project-b',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveMcpServers({
+        'mcp-a': {
+          id: 'mcp-a',
+          name: 'Local Tools',
+          transport: 'stdio',
+          command: 'node',
+          args: ['tool.js'],
+          env: { API_TOKEN: 'secret-token' },
+          createdAt: now,
+          updatedAt: now,
+        },
+        'mcp-b': {
+          id: 'mcp-b',
+          name: 'Backlog Tools',
+          transport: 'stdio',
+          command: 'node',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveAgents({
+        'agent-a': {
+          id: 'agent-a',
+          name: 'Release Lead',
+          description: 'Owns launch execution',
+          systemPrompt: 'Ship safely',
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          projectId: 'project-a',
+          skillIds: ['skill-a', 'global-skill'],
+          mcpServerIds: ['mcp-a'],
+          createdAt: now,
+          updatedAt: now,
+        },
+        'agent-b': {
+          id: 'agent-b',
+          name: 'Backlog Lead',
+          description: 'Owns backlog',
+          systemPrompt: 'Plan later',
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          projectId: 'project-b',
+          skillIds: ['skill-b'],
+          mcpServerIds: ['mcp-b'],
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveSchedules({
+        'schedule-a': {
+          id: 'schedule-a',
+          name: 'Daily Launch Check',
+          agentId: 'agent-a',
+          projectId: 'project-a',
+          taskPrompt: 'Check release readiness',
+          scheduleType: 'interval',
+          intervalMs: 60000,
+          status: 'active',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'schedule-b': {
+          id: 'schedule-b',
+          name: 'Backlog Check',
+          agentId: 'agent-b',
+          projectId: 'project-b',
+          taskPrompt: 'Review backlog',
+          scheduleType: 'interval',
+          intervalMs: 60000,
+          status: 'active',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      upsertChatroom('room-a', {
+        id: 'room-a',
+        name: 'Launch Room Chat',
+        agentIds: ['agent-a'],
+        messages: [],
+        chatMode: 'parallel',
+        temporary: false,
+        createdAt: now,
+        updatedAt: now,
+      })
+      upsertConnector('connector-a', {
+        id: 'connector-a',
+        name: 'Launch Slack',
+        platform: 'slack',
+        agentId: 'agent-a',
+        chatroomId: 'room-a',
+        credentialId: 'credential-a',
+        config: { channel: 'launch', botToken: 'secret-token' },
+        isEnabled: true,
+        status: 'running',
+        createdAt: now,
+        updatedAt: now,
+      })
+
+      const response = await route.GET(new Request('http://local/api/portability/export?projectId=project-a&download=true'))
+      const body = await response.json()
+      const missingResponse = await route.GET(new Request('http://local/api/portability/export?projectId=missing-project'))
+      const missingPayload = await missingResponse.json()
+      console.log(JSON.stringify({
+        status: response.status,
+        disposition: response.headers.get('content-disposition') || '',
+        scopeKind: body.scope?.kind || null,
+        projectNames: (body.projects || []).map((project) => project.name),
+        agentNames: body.agents.map((agent) => agent.name),
+        skillNames: body.skills.map((skill) => skill.name).sort(),
+        scheduleNames: body.schedules.map((schedule) => schedule.name),
+        chatroomNames: (body.chatrooms || []).map((chatroom) => chatroom.name),
+        connectorNames: (body.connectors || []).map((connector) => connector.name),
+        mcpServerNames: (body.mcpServers || []).map((server) => server.name),
+        connectorConfig: body.connectors?.[0]?.config || {},
+        connectorEnabled: body.connectors?.[0]?.isEnabled ?? null,
+        missingStatus: missingResponse.status,
+        missingError: missingPayload.error,
+      }))
+    `)
+
+    assert.equal(output.status, 200)
+    assert.match(output.disposition, /^attachment; filename="swarmclaw-project-launch-room-\d{8}-\d{6}\d{3}Z\.json"$/)
+    assert.equal(output.scopeKind, 'project')
+    assert.deepEqual(output.projectNames, ['Launch Room'])
+    assert.deepEqual(output.agentNames, ['Release Lead'])
+    assert.deepEqual(output.skillNames, ['Release Notes', 'Risk Scan'])
+    assert.deepEqual(output.scheduleNames, ['Daily Launch Check'])
+    assert.deepEqual(output.chatroomNames, ['Launch Room Chat'])
+    assert.deepEqual(output.connectorNames, ['Launch Slack'])
+    assert.deepEqual(output.mcpServerNames, ['Local Tools'])
+    assert.deepEqual(output.connectorConfig, { channel: 'launch' })
+    assert.equal(output.connectorEnabled, false)
+    assert.equal(output.missingStatus, 404)
+    assert.equal(output.missingError, 'Project not found: missing-project')
+  })
 })

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

@@ -3,15 +3,24 @@ import { buildPortableExportFilename, exportConfig } from '@/lib/server/portabil
 export const dynamic = 'force-dynamic'
 
 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)}"`,
-      },
-    })
+  const projectId = searchParams.get('projectId')?.trim() || null
+  try {
+    const manifest = exportConfig({ projectId })
+    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)
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Failed to export manifest'
+    if (message.startsWith('Project not found: ')) {
+      return NextResponse.json({ error: message }, { status: 404 })
+    }
+    return NextResponse.json({ error: message }, { status: 500 })
   }
-  return NextResponse.json(manifest)
 }