first commit

2026-07-11 14:56:10 +08:00
commit 7e05d0a4e7
660 changed files with 78119 additions and 0 deletions
@@ -0,0 +1,43 @@
+## 1. Platform Lifecycle Workflows
+
+- [x] 1.1 Add lifecycle domain, DTO, validator, and conversion contracts for create/start/stop workflow requests and responses.
+- [x] 1.2 Implement platform service methods for create/install, start, and stop workflow validation and job dispatch.
+- [x] 1.3 Project accepted terminal lifecycle job results onto server instance state.
+- [x] 1.4 Add platform HTTP routes and OpenAPI-style comments for create/start/stop lifecycle workflow actions.
+- [x] 1.5 Update platform route/protocol/domain documentation for implemented server lifecycle workflows.
+- [x] 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
+
+- [x] 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.
+- [x] 2.2 Add run lifecycle executor support for bounded install/start/stop job handling without host paths, raw credentials, or direct sockets.
+- [x] 2.3 Add run tests for supported lifecycle jobs, unsupported lifecycle jobs, and smoke capability reporting.
+- [x] 2.4 Update run protocol/runtime documentation for lifecycle executor scope.
+
+## 3. Frontend Server Management
+
+- [x] 3.1 Add frontend API contracts and client methods for run endpoints, jobs, and create/start/stop server lifecycle workflows.
+- [x] 3.2 Add frontend server management view contracts and request builders outside page components.
+- [x] 3.3 Implement the server management page create form, refresh action, start/stop actions, pending job display, and safe fallback data.
+- [x] 3.4 Add frontend tests for API client calls and server management page rendering without unsafe fields.
+
+## 4. Verification
+
+- [x] 4.1 Run `go test ./...` from `platform/` and record evidence.
+- [x] 4.2 Run `go test ./...` from `run/` and record evidence.
+- [x] 4.3 Run `cd plugins && npm run typecheck && npm run test && npm run validate:manifest` and record evidence.
+- [x] 4.4 Run `cd platform_web && npm run typecheck && npm run test && npm run build` and record evidence.
+- [x] 4.5 Run browser walkthrough for server management create/start/stop UI at desktop and mobile widths.
+- [x] 4.6 Run `scripts/check-structure.sh` and record evidence.
+- [x] 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.