Skip to content

Commit 6569c31

Browse files
thymikeeclaude
andcommitted
docs(command-surface): state config defaults precisely and align fold hinge-angle wording
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
1 parent 249467d commit 6569c31

3 files changed

Lines changed: 3 additions & 3 deletions

File tree

‎docs/agents/cli-flags.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Pass a flag only through layers that consume it:
4040
- If the first positional selects an action, declare `flagsByAction` on the CLI schema.
4141
Map each action to the options it reads. Derive `allowedFlags` from that table.
4242
From caller-supplied keys, the parser rejects typed options that the action never reads.
43-
Config, env, and remote-config defaults do not become a request.
43+
Options the selected action ignores stay out of its request, even when config, env, or remote-config defaults set them. Thus, `AGENT_DEVICE_FPS=30` never breaks `record stop`.
4444
Exclude options that every action reads from the table.
4545
The parser rejects only options in rows. If it rejected `--json`, it would reject the command.
4646
- Keep command-specific usage/flag metadata with the command family metadata that owns the command.

‎packages/command-surface/src/system/index.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -296,7 +296,7 @@ const foldGuidance = {
296296
permissions: 'Device Hub and host Accessibility permission are not required.',
297297
} as const;
298298

299-
const foldCommandDescription = `Fold or unfold a foldable iPhone simulator (iPhone Duo) or a foldable Android emulator into the closed, half-open, or open pose. iOS sends a ${foldGuidance.hingeEvent}, then reads the hinge angle back inside the simulator to confirm it, and can follow timestamped angle keyframes; Android sets the emulator console posture, then confirms the device state the guest commits and reports the hinge angle the AVD profile defines for that posture, and dismisses the lock screen a fold to the cover display can raise. On iOS a pose change moves the app to a different panel with a different point size; on Android a fold to or from closed moves the app between the cover and inner displays, and any pose change can reshape the app window, whose size the next snapshot reports. Either way every ref and coordinate from before it is stale: re-snapshot after this command. Taps, long presses, and scrolling target the app window on its current panel in closed, half-open, and open poses. Simulator and emulator only; iOS requires the iOS simulator SDK; ${foldGuidance.permissions} An iOS simulator in a scoped simulator set folds the same way as one in the default set.`;
299+
const foldCommandDescription = `Fold or unfold a foldable iPhone simulator (iPhone Duo) or a foldable Android emulator into the closed, half-open, or open pose. iOS sends a ${foldGuidance.hingeEvent}, then reads the hinge angle back inside the simulator to confirm it, and can follow timestamped angle keyframes; Android sets the emulator console posture, then confirms the device state the guest commits and reports the angle read from the hinge sensor, which can differ from the AVD profile's per-posture angles, and dismisses the lock screen a fold to the cover display can raise. On iOS a pose change moves the app to a different panel with a different point size; on Android a fold to or from closed moves the app between the cover and inner displays, and any pose change can reshape the app window, whose size the next snapshot reports. Either way every ref and coordinate from before it is stale: re-snapshot after this command. Taps, long presses, and scrolling target the app window on its current panel in closed, half-open, and open poses. Simulator and emulator only; iOS requires the iOS simulator SDK; ${foldGuidance.permissions} An iOS simulator in a scoped simulator set folds the same way as one in the default set.`;
300300

301301
const appSwitcherCommandDescription =
302302
'Open the device app switcher to inspect or change foreground apps. This changes the visible system UI and may move focus away from the current app.';

‎website/docs/docs/commands.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ Fold a foldable device:
137137
- iOS needs an Xcode with the iOS simulator SDK and foldable HID support (verified on Xcode 27.1); Device Hub and Accessibility permission aren't required. The first fold builds a helper cached under `~/.agent-device/fold-helper`, which also reads the hinge back. Build and dispatch failures report `fold-helper-build-failed` or `fold-hid-dispatch-failed`; readback outcomes are listed below.
138138
- `COMMAND_FAILED` with `reason: fold-pose-unverified` means the hinge reports another pose; `fold-pose-unsettled` means it reached `half-open` but never came to rest; `fold-pose-dispatched-unverified` means the pose was sent but the first hinge-angle read returned no sample, so check the lit panel with a screenshot; `hingeReadFailure` holds the read's own failure.
139139
- `UNSUPPORTED_OPERATION` covers single-panel devices (`single-panel-device` on Android). Physical devices are refused. An iOS simulator in a scoped `--ios-simulator-device-set` folds the same way as one in the default set.
140-
- On Android, `fold` confirms the pose from the device state the emulator commits and reports `hingeAngleDegrees` as the hinge sensor reads it: the angle the AVD profile defines for the posture, such as 0°, 90°, and 180° on the Pixel folds or 15°, 90°, and 165° on the generic 7.6in Foldable. It also dismisses the lock screen that folding to the cover display can raise. For panels, poses, and timings, see `agent-device help foldable`.
140+
- On Android, `fold` confirms the pose from the device state the emulator commits and reports `hingeAngleDegrees` as the hinge sensor reads it. That reading can differ from the AVD profile's per-posture angles, such as 0°, 90°, and 180° on the Pixel folds or 15°, 90°, and 165° on the generic 7.6in Foldable. It also dismisses the lock screen that folding to the cover display can raise. For panels, poses, and timings, see `agent-device help foldable`.
141141

142142
Simulate an incoming call or SMS:
143143

0 commit comments

Comments
 (0)