browser/openspec/changes/implement-server-management-workflows/tasks.md

1. Platform Lifecycle Workflows

• 1.1 Add lifecycle domain, DTO, validator, and conversion contracts for create/start/stop workflow requests and responses.
• 1.2 Implement platform service methods for create/install, start, and stop workflow validation and job dispatch.
• 1.3 Project accepted terminal lifecycle job results onto server instance state.
• 1.4 Add platform HTTP routes and OpenAPI-style comments for create/start/stop lifecycle workflow actions.
• 1.5 Update platform route/protocol/domain documentation for implemented server lifecycle workflows.
• 1.6 Add platform service/API tests for accepted create/start/stop workflows, rejected invalid state/stale config, and lifecycle result state projection.

2. Lifecycle Capabilities and Run Executor

• 2.1 Add process.install to plugin manifest schema, plugin SDK capability types, platform validation allowlists, examples, and fixtures where lifecycle install support is required.
• 2.2 Add run lifecycle executor support for bounded install/start/stop job handling without host paths, raw credentials, or direct sockets.
• 2.3 Add run tests for supported lifecycle jobs, unsupported lifecycle jobs, and smoke capability reporting.
• 2.4 Update run protocol/runtime documentation for lifecycle executor scope.

3. Frontend Server Management

• 3.1 Add frontend API contracts and client methods for run endpoints, jobs, and create/start/stop server lifecycle workflows.
• 3.2 Add frontend server management view contracts and request builders outside page components.
• 3.3 Implement the server management page create form, refresh action, start/stop actions, pending job display, and safe fallback data.
• 3.4 Add frontend tests for API client calls and server management page rendering without unsafe fields.

4. Verification

• 4.1 Run go test ./... from platform/ and record evidence.
• 4.2 Run go test ./... from run/ and record evidence.
• 4.3 Run cd plugins && npm run typecheck && npm run test && npm run validate:manifest and record evidence.
• 4.4 Run cd platform_web && npm run typecheck && npm run test && npm run build and record evidence.
• 4.5 Run browser walkthrough for server management create/start/stop UI at desktop and mobile widths.
• 4.6 Run scripts/check-structure.sh and record evidence.
• 4.7 Run openspec validate implement-server-management-workflows --strict and record evidence.

Evidence

• 2026-07-03: cd platform && go test ./... passed after platform lifecycle service/API implementation.
• 2026-07-03: cd run && go test ./... passed after run lifecycle executor implementation.
• 2026-07-03: cd plugins && npm run typecheck && npm run test && npm run validate:manifest passed after adding process.install.
• 2026-07-03: Frontend API client/contracts, server management view contracts, request builders, page workflow UI, styling, docs, and tests were updated for run endpoints, jobs, create/start/stop workflows, pending job display, and safe fallback data.
• 2026-07-03: cd platform_web && npm run typecheck && npm run test && npm run build passed; Vitest reported 6 files / 14 tests passed and Vite built production assets.
• 2026-07-03: Browser walkthrough via Chrome DevTools at http://127.0.0.1:4173/#/servers passed for desktop create/install, start, stop, no unsafe fields visible, and mobile single-column server workspace.
• 2026-07-03: scripts/check-structure.sh passed.
• 2026-07-03: openspec validate implement-server-management-workflows --strict passed.