feat(host-agent): make execution history authoritative

2026-07-15 11:46:27 +08:00
parent ccde30e378
commit 77d4813bb2
46 changed files with 890 additions and 3132 deletions
@@ -0,0 +1,33 @@
+## ADDED Requirements
+
+### Requirement: Runtime is not exposed as a standalone REST service or web console
+The repository SHALL not ship a standalone Runtime REST application, its
+unauthenticated web console, or JSON console routes. The shared Runtime and
+storage packages SHALL remain reusable execution libraries for the Host Agent
+and other in-process callers.
+
+#### Scenario: An operator needs to inspect a Host-executed task
+- **WHEN** an operator needs task evidence for a Host Agent execution
+- **THEN** the operator uses the authenticated Host Agent console rather than
+  starting or querying a separate Runtime service
+
+#### Scenario: A package uses shared Runtime execution
+- **WHEN** the Host Agent or another in-process caller creates a
+  `TaskRunner`
+- **THEN** it continues to use the shared Runtime and storage packages without
+  importing a REST or UI adapter
+
+### Requirement: Host Agent does not supervise a retired Runtime service
+The Host Agent SHALL not expose Runtime-supervision configuration or spawn a
+Runtime REST subprocess. It MAY continue to optionally supervise Appium.
+
+#### Scenario: Host Agent dependency supervision is enabled
+- **WHEN** `HOST_AGENT_DEPENDENCY_SUPERVISOR_ENABLED=true` and Appium
+  supervision is enabled
+- **THEN** the Host Agent probes and supervises Appium only
+
+#### Scenario: A removed Runtime-supervision variable is configured
+- **WHEN** a Host Agent configuration includes a removed
+  `HOST_AGENT_RUNTIME_*` variable
+- **THEN** startup fails with a message directing the operator to the Host
+  Agent console and Appium-only supervision