Skip to content

Sync spec with CLI implementation (v2.8-draft)#33973

Merged
rmarinho merged 1 commit intomaui-devtools-specfrom
spec/sync-with-implementation
Feb 9, 2026
Merged

Sync spec with CLI implementation (v2.8-draft)#33973
rmarinho merged 1 commit intomaui-devtools-specfrom
spec/sync-with-implementation

Conversation

@rmarinho
Copy link
Copy Markdown
Member

@rmarinho rmarinho commented Feb 9, 2026

Summary

Syncs the DevTools spec with the current CLI implementation on maui-client-tool branch.

What changed

New commands documented:

  • apple xcode list — List installed Xcode versions with version, build number, selected status
  • apple xcode select <path> — Switch active Xcode installation
  • android sdk accept-licenses — Accept SDK licenses
  • android avd stop/delete — Stop and delete AVDs
  • android bootstrap/jdk commands in capabilities model

Schema updates:

  • MauiDevice: Added type, state, details fields
  • MauiDevice: Documented Android-specific field semantics (identifier = AVD name for emulators, version = API level, version_name = OS version without prefix, platform_architecture = raw ABI)
  • New XcodeInstallation schema (path, developer_dir, version, build, is_selected)

Spec corrections to match implementation:

  • doctor --platformdoctor --category (matching actual CLI flag)
  • Simulator boot/shutdown/delete use positional <udid> not --udid option
  • Global options: marked --non-interactive, --correlation-id, --offline as vNext (not yet implemented)
  • FR-X13/X14: Updated from vague 'handle multiple Xcode versions' to specific xcode list/xcode select commands (P0)

MVP tracking:

  • Added status column to MVP table showing which features are implemented
  • Moved deploy, config, diagnostic-bundle, telemetry to vNext (not yet implemented)

Version bumped to 2.8-draft.

…, MVP status

- Add apple xcode list/select commands to command hierarchy, table, and capabilities
- Add XcodeInstallation JSON schema (path, developer_dir, version, build, is_selected)
- Update MauiDevice schema: add type, state, details fields
- Document Android-specific field semantics (identifier, version, version_name, etc.)
- Clarify version_name = OS version without platform prefix
- Clarify identifier = AVD name for emulators (not avd: prefixed)
- Update FR-X13/X14 to reflect implemented xcode list/select (P0)
- Mark implemented MVP features with checkboxes
- Move deploy, config, diagnostic-bundle, telemetry to vNext
- Update global options: mark --non-interactive, --correlation-id, --offline as vNext
- Fix doctor --platform to --category to match implementation
- Update simulator commands: boot/shutdown/delete use positional <udid>
- Add accept-licenses, avd stop/delete, bootstrap, jdk commands to capabilities model
- Bump version to 2.8-draft
@rmarinho rmarinho merged commit 9cad814 into maui-devtools-spec Feb 9, 2026
2 of 3 checks passed
@rmarinho rmarinho deleted the spec/sync-with-implementation branch February 9, 2026 16:48
@github-actions github-actions bot locked and limited conversation to collaborators Mar 12, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant