fix: narrow client result contracts

[thymikee]

Summary

Narrow Node client result types for closed daemon projections from #1153.

Adds public contracts for wait, prepare, push, and trigger-app-event, wires them into CommandResultMap and MCP output schemas, and tightens JSON payload typing for push/app-event payloads.

Closes #1153

Validation

• pnpm typecheck
• pnpm format
• pnpm exec vitest run src/core/command-descriptor/tests/command-result.test.ts src/mcp/tests/command-tools.test.ts src/tests/client.test.ts src/commands/management/runtime/apps.test.ts src/commands/management/index.test.ts src/core/dispatch-payload.test.ts src/core/tests/dispatch-trigger-app-event.test.ts
• git diff --check

[github-actions]

Size Report

Metric	Base	Current	Diff
JS raw	1.6 MB	1.6 MB	+1.3 kB
JS gzip	507.7 kB	508.1 kB	+386 B
npm tarball	610.1 kB	611.2 kB	+1.0 kB
npm unpacked	2.2 MB	2.2 MB	+3.8 kB

Startup median (7 runs, lower is better):

Scenario	Base	Current	Diff
CLI --version	28.0 ms	27.6 ms	-0.4 ms
CLI --help	56.4 ms	57.9 ms	+1.5 ms

Top changed chunks:

Chunk	Raw diff	Gzip diff
dist/src/registry.js	+26 B	+10 B
dist/src/selector-runtime.js	+3 B	+1 B

[thymikee]

Reviewed the narrowing. The typed spine, MCP schemas, and the JsonObject migration all line up cleanly with the projections — push, trigger-app-event, and the toDaemonWaitData path match field-for-field. Two spots where the new contract under-declares what the daemon actually puts on the wire, plus one minor behavior change:

1. PrepareCommandResult omits fields the projection always emits. prepareIosRunnerResponseData spreads ...result (src/daemon/handlers/session.ts:131), and result: PrepareIosRunnerResult carries runner (required — emitted on every success) plus optional cache / artifact / xctestrunPath / recoveryReason / failureReason. None appear in src/contracts/prepare.ts, so the "compact projection" the docstring describes isn't actually compact — runner leaks untyped on every prepare call. Either narrow the projection to explicitly pick the contract fields (so runtime matches the type), or add the ones that are genuinely public to the contract.

2. WaitCommandResult omits selectorChain. The iOS selector fast-path returns data: payload unstripped (src/daemon/selector-runtime.ts:373-376), so a public wait <selector> on iOS emits selectorChain: [...], which isn't in src/contracts/wait.ts. Note the sibling is fast-path strips it via stripSelectorChain (selector-runtime.ts:349) — the wait path looks like it should too. Stripping it there makes runtime match the new contract and fixes a small internal-field leak in one move.

3. (minor) trigger-app-event payload loses read-time validation. Swapping looseObjectField() → jsonSchemaField<JsonObject>(looseObjectSchema()) in src/commands/management/push.ts keeps the same JSON schema but drops the optionalRecord reader, so a non-object payload is no longer rejected at field-read with Expected payload to be an object. — it's now caught later in assertJsonObject with a different message. Functionally still rejected, just a different stage/wording; flagging in case byte-identical errors matter.

[thymikee]

Reviewed current head b0c06b1 against #1153 and ADR 0008. The PR moves closed result contracts for wait, prepare, push, and trigger-app-event into public contract modules, wires them into CommandResultMap/client methods and MCP output schemas, and keeps the narrowing limited to daemon projections with focused client/schema/runtime tests. CI is green across 21/21 checks. No actionable blockers found.

[thymikee]

New head b940304 arrived after my ready review of b0c06b1, and checks are currently running again. I removed the stale ready-for-human label for now; I will re-review/relabel once the current head is clean.

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-08 16:35 UTC