Skip to content

Verify execution planes + per-plane doctor + DeepWiki-only docs - #19

Open
wlu03 wants to merge 6 commits into
mainfrom
verify-planes
Open

wlu03 wants to merge 6 commits into
mainfrom
verify-planes

Conversation

@wlu03

@wlu03 wlu03 commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Verifies the execution planes, upgrades doctor, and reconciles docs to DeepWiki-only. Carries your docs commits (cf01539 docs-untrack, d5e6ecd DeepWiki link, 35c26df badges) plus:

Plane verification (this session)

  • Local web and local Electron planes run end to end on a fresh machine with no cloud key (headless Chrome / electron . over CDP, DOM grounding). The E2B, Android, and macOS/iOS-VM planes need accounts/devices, so doctor now checks their prerequisites instead.

Changes

  • doctor: per-plane prerequisite checks (E2B key+SDK, local web = node+Chrome, local Electron = node, Android AVD = adb+emulator, Android Redroid = docker, iOS = xcrun+idb+idb_companion, macOS/iOS VM = tart or a remote Mac, macOS-native = host). Chrome/docker/tart were previously unchecked.
  • DeepWiki-only reconciliation: removes the Phase-6 machinery that breaks with docs/ gitignored (the tool-reference sync test, docs_gen.py/gen_docs.py, mkdocs.yml); repoints .devin/wiki.json at code + README.
  • Fix: .env.example advertised a local detector backend that detector.py does not implement (replicate | http only).

Verification

  • pytest -q gives 347 passed; ruff clean.

Left to you (you're editing README concurrently): the README already drops the docs/ links on this branch.

wlu03 added 6 commits July 17, 2026 18:32
Report each plane's requirements explicitly instead of a flat surface-toolchain
list: E2B (key + e2b-desktop), local web (node + Chrome/Chromium), local Electron
(node), Android AVD (adb + emulator), Android Redroid (docker), iOS (xcrun + idb +
idb_companion), the macOS/iOS VM (tart or a remote Mac), and macOS-native (this
host). Chrome and docker/tart were previously unchecked, so `doctor` now tells a
user exactly what to install for their target surface.
Document every execution plane (local web, local Electron, E2B sandbox, Android
AVD/Redroid, iOS, macOS/iOS VM, macOS native): what each runs, the local tools or
cloud key it needs, the config to select it, and its doctor line. The two local
planes are verified end to end (headless Chrome/Electron over CDP, no cloud key).
Linked from the README index, the MkDocs nav, and the DeepWiki config.
Follow-up to cf01539 (stop tracking docs/): remove the Phase-6 machinery that
assumed tracked docs and breaks with docs/ gitignored — the docs/ tool-reference
sync test, its generator (docs_gen.py / gen_docs.py), and mkdocs.yml. Repoint
.devin/wiki.json at code + README (the removed docs/*.md no longer exist for
DeepWiki to read). Also fix .env.example: the detector implements replicate|http
only, not the advertised "local" backend.
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