Skip to content

MM-010 add layered live doctor diagnostics - #9

Draft
himattm wants to merge 1 commit into
agent/mm-008-report-device-identityfrom
agent/mm-010-live-doctor
Draft

MM-010 add layered live doctor diagnostics#9
himattm wants to merge 1 commit into
agent/mm-008-report-device-identityfrom
agent/mm-010-live-doctor

Conversation

@himattm

@himattm himattm commented Jul 17, 2026

Copy link
Copy Markdown
Owner

What changed

Add read-only doctor --live diagnostics that verify the selected device identity, expected foreground package, and one minimal normalized layout capture. Failures are separated into repository/config, device, app mismatch, analytics permission, and general capture layers, each with targeted remediation and optional verbose subprocess detail.

Why

Plain doctor could pass installation and graph checks while the wrong app was foreground or Android CLI could not capture under current filesystem permissions.

Impact

Developers can distinguish the failing layer before attempting navigation, while plain doctor remains a non-capturing configuration check.

Validation

  • Healthy live probe
  • No-device live probe
  • Wrong-app probe that stops before layout
  • Restricted analytics probe with concise and verbose variants
  • All existing doctor contracts
  • Live API 36 GetGoing probe: correct package and 56 layout elements
  • Full workspace tests, Clippy, formatting, and binary build

Stack

Depends on #8; base branch: agent/mm-008-report-device-identity.

Reproduction: plain doctor could pass installation and graph checks even though the foreground app was wrong or Android CLI could not capture under the active filesystem permissions.

Add doctor --live to verify the selected device identity, expected foreground package, and one minimal normalized layout capture. Stop at the failing layer and emit distinct device, app mismatch, analytics spool, or capture diagnostics with concise remediation and optional verbose subprocess detail.

Verified with healthy, no-device, wrong-app, restricted-analytics, and verbose contracts; all existing doctor tests; a live API 36 GetGoing probe with 56 elements; cargo test --workspace; Clippy with warnings denied; formatting checks; and the minimap binary build.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant