infrastructure/android-fs5
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
android-fs5/NEXT_STEPS.md
T
Jane Alesi ad8c738160 feat(spec): add 003-autonomous-agent-control specification 
Spec for full AI agent mobile control capability:
- Voice call control (dial/answer/hangup/status/list)
- App lifecycle management (install --url, update, permissions, grant, info)
- Device backup & restore (create/list/restore/app/verify, AES-256 encrypt)
- SMS send/delete + wait-reply via KDE Connect
- Audio control (volume/mute/route)
- Contacts management (list/add/export VCF)

56 tasks across 7 phases. TDD: fixtures → RED tests → GREEN impl.
Target: ≥130 BATS tests on completion.

Closes: specs/003-autonomous-agent-control/{spec,plan,tasks}.md
2026-03-02 18:38:35 +01:00

2.2 KiB
Raw Permalink Blame History

Next Session Tasks

Last updated: 2026-03-02 Project: android-fs5 Status: Both specs 001 + 002 complete. 85/85 tests passing.

Priority 0 — Spec 003 Implementation (Next Feature)

  • Start with T001–T004: capture device fixtures (dumpsys telephony, dumpsys package, content providers)
  • T005–T008: create lib/call.sh, lib/backup.sh, lib/contacts.sh, extend lib/adb.sh
  • T009–T015: write BATS tests (RED phase) for all 6 user stories
  • T016–T051: implement P1 (call/app/backup), P2 (sms-send/audio), P3 (contacts)
  • T052–T056: shellcheck, README update, integration auth flow test
  • See full task list: specs/003-autonomous-agent-control/tasks.md

Priority 1 — Spec 002 Completion

  • Create specs/002-remote-control/plan.md — architecture decisions for remote control layer
  • Create specs/002-remote-control/tasks.md — formal task breakdown (T025–T033 retroactively)
  • Update specs/002-remote-control/spec.md Status from Draft → Complete

Priority 2 — Quality & Hardening

  • Run shellcheck fs5 lib/*.sh and fix any warnings
  • Add lib/input.sh shellcheck pass (currently used by remote control commands)
  • Consider adding --dry-run flag to push/pull for safer automation
  • Add ui tap live device integration (currently exits 1 for nonexistent elements only)

Priority 3 — Documentation

  • Update README.md with ui subcommand documentation (added in latest commit)
  • Add usage examples for ocr, sms otp, ui find to README
  • Consider a docs/ directory with architecture diagram (Mermaid)

Priority 4 — Future Features

  • fs5 record — screen recording via scrcpy (--record output.mp4)
  • fs5 sms send — send SMS via KDE Connect CLI
  • fs5 notify — read/dismiss Android notifications via KDE Connect
  • TOTP extraction from authenticator app via OCR + ui find

Notes

  • Device serial: RD51QE202392 (Samsung FS5, configured in .env)
  • KDE Connect must be paired for sms commands to work fully
  • UIAutomator XML fixture at tests/fixtures/ui_dump.xml used for offline ui tests
  • scrcpy 3.3.4 on host; tesseract required for ocr command
Reference in New Issue View Git Blame Copy Permalink