mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-18 20:36:04 +00:00
* feat(agent): choose the reasoning effort in the Agent tab; agent processes survive Steam session cleanup; sdkmanager license step tolerates SIGPIPE * docs(agent): on-device build and commit pitfalls for the agent
1.3 KiB
1.3 KiB
Rules
- Comments should be rare, factual, and explain only non-obvious external constraints or business invariants.
Working on the device
dd-lab-buildbuilds only committed work. Checkgit statusandgh api userfor the identity before committing; ifgit config user.nameis empty, use theghlogin's name and noreply email for this repo, never a guess.- Do not commit or start a build in the same step: a build started next to a failed commit fails too. Commit first, check it, then build.
- Uncommitted changes in the tree may not be yours. Read
git diffbefore committing them and tell the user what they do. - If
dd-lab-buildsays "could not read DroidDeck's state", loopback adb is down and$ADB_SERIALis stale. Runadb devices; the port changes whenever wireless debugging is toggled. Ask the user to turn it on rather than retrying. - A build that "did not start" can be adb, not the app. Read
~/.cache/dd-lab-build.jsonand.logfor the real reason; they can be stale from an earlier build, so compare their times withdate. - Run
dd-lab-buildwithrun_in_backgroundand read its output file. A foregroundsleepis blocked; wait with Monitor and an until-loop. - The build restarts DroidDeck and ends your process. A turn that ends this way is not a failure.