Skip to content

Commit f0eb8c6

Browse files
authored
feat: add runtime admin, batch, diagnostics, and recording commands (#416)
* feat: add runtime admin and orchestration commands * feat: add runtime diagnostics commands * refactor: clean up runtime router surface * refactor: remove runtime cleanup dead weight * fix: clean up admin install temp inputs on resolve failure
1 parent afcd375 commit f0eb8c6

29 files changed

+2916
-623
lines changed

COMMAND_OWNERSHIP.md

Lines changed: 30 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,33 @@ Their semantics should live in `agent-device/commands` as they migrate.
9292
and selector targets.
9393
- `pinch`: runtime `interactions.pinch` implemented behind the typed backend
9494
primitive.
95+
- `devices`: runtime `admin.devices` implemented through typed backend
96+
inventory primitives.
97+
- `boot`: runtime `admin.boot` implemented through a typed backend boot
98+
primitive.
99+
- `ensure-simulator`: runtime `admin.ensureSimulator` implemented with typed
100+
simulator options and result shape.
101+
- `install`: runtime `admin.install` implemented with structured install
102+
sources and local path policy enforcement.
103+
- `reinstall`: runtime `admin.reinstall` implemented with structured install
104+
sources and local path policy enforcement.
105+
- `install-from-source`: runtime `admin.installFromSource` implemented with the
106+
same structured source resolver used by install/reinstall.
107+
- `batch`: runtime router command implemented; nested steps are dispatched
108+
through `createCommandRouter()` so policy and error formatting run per step.
109+
- `record`: runtime `record` router/API command implemented with typed record
110+
start/stop result unions.
111+
- `trace`: runtime `trace` router/API command implemented with typed trace
112+
start/stop result unions.
113+
- `logs`: runtime `diagnostics.logs` implemented with bounded, paginated,
114+
best-effort redacted log entries.
115+
- `network`: runtime `diagnostics.network` implemented with bounded,
116+
structured, best-effort redacted network entries.
117+
- `perf`: runtime `diagnostics.perf` implemented with typed metric entries.
118+
- `replay`: still daemon/CLI owned; runtime router migration is deferred until
119+
it can reuse the real `.ad` parser and healing semantics.
120+
- `test`: still daemon/CLI owned; runtime router migration is deferred until it
121+
can share daemon replay-suite semantics end to end.
95122

96123
## Boundary Requirements
97124

@@ -147,17 +174,9 @@ the portable command runtime.
147174

148175
## Later Capability-Gated Runtime Commands
149176

150-
These commands should migrate only after the runtime, backend capability, and IO
151-
contracts are established for their behavior.
152-
153-
- `batch`
154-
- `logs`
155-
- `network`
156-
- `perf`
157-
- `record`
158-
- `replay`
159-
- `test`
160-
- `trace`
177+
All currently identified capability-gated diagnostics have runtime command
178+
contracts. New diagnostics should follow the `diagnostics.*` namespace with
179+
bounded result windows and backend-specific support.
161180

162181
## Compatibility Helper Subpaths
163182

0 commit comments

Comments
 (0)