Local Stack and Runtime Services

Maintain the shared configuration and launch plumbing across Vite/static development, Agent Server, automation, ingress, the published binary, and the all-in-one Docker image.

Workflow

1. Read references/guide.md before changing launchers, runtime service metadata, version pins, Docker composition, auth generation, or process management.
2. Treat config/defaults.json and the injected <RUNTIME_SERVICES> block as authoritative.
3. Preserve coordinated process-tree shutdown and fail fast on missing prerequisites.
4. Keep Agent Server and automation versions compatible and authentication keys correctly scoped.
5. Update documentation and version-drift tests when changing pins or launch commands.
6. Validate each affected launch mode rather than assuming Vite, static, npm, Docker, and Electron behave identically.

Reference

• references/guide.md — Runtime-services schema and prompt plumbing, launcher environment variables, ingress routes, version synchronization, security, Docker build architecture, README synchronization, and spec-tag conventions.