Files
ESP32_Serial_Swiss_Army_Knife/docs/agent/current-state.md
T

3.1 KiB

Current project state

This file is working memory. Update it during active work and before handoff; do not treat it as a permanent design record.

Development state

Based on checked-in source plus README.md and docs/roadmap.md:

  • Hardware characterization, serial service, session broker, USB CDC, Wi-Fi, HTTPS/WebSocket, SSH serial transport, and local display/control are implemented and documented as target-hardware validated.
  • Phase 8A role-based user storage/UART0 administration and Phase 8B role-aware HTTPS/SSH authentication and targeted revocation are documented as target-hardware validated.
  • Phase 8C admin SSH is implemented in source and uses the shared esp_console registry. Target-hardware validation is explicitly pending.
  • Phase 8D web user administration and Phase 8E browser login/session integration are planned, not implemented.
  • Security/production hardening, OTA, BLE evaluation, advanced networking, and optional filesystem features remain future roadmap work.
  • Reserved OTA, coredump, NVS-key, and storage partitions do not imply those runtime features are implemented.

Clearly incomplete or transitional areas

  • Phase 8C hardware-validation matrix remains pending. It includes route separation, shared command serialization, history/completion, prompts, output backpressure, revocation during queued work, deferred SSH lifecycle/reboot actions, and full concurrent transport operation.
  • Current HTTPS has no web-based user administration and gives both roles the same status/terminal routes.
  • Browser authentication still uses HTTP Basic; integrated login/logout sessions are planned.
  • NVS encryption, secure boot/flash encryption review, authentication rate limiting, production certificate/provisioning policy, and OTA are not implemented.

Known inconsistencies

These observations should be checked when touching the relevant area; they are not automatically bugs requiring unrelated cleanup.

  • Some source comments still call shared commands UART0-only or call the current local status/control task read-only.
  • USER_DATABASE_LOAD_EMPTY is only an initialization/failure sentinel at the checked-in revision: every successful user_database_init() path returns STORED or MIGRATED_LEGACY, so main.c's successful "new empty" log branch is unreachable.
  • SSH startup is currently gated on successful web_security initialization even though SSH uses separate host-key material. Needs verification: whether this coupling is intentional recovery policy or an accidental startup dependency.

Items to verify in future work

  • Complete the documented Phase 8C target-hardware validation before marking it complete.
  • Confirm task-local Newlib standard-stream behavior if ESP-IDF/Newlib configuration changes; admin SSH command output relies on dispatcher-task stream redirection.
  • If HTTPD concurrency configuration changes, add locking around the boot-local Basic-authentication cache.

Active Task

No active task recorded.

Handoff template

  • Objective:
  • Relevant files:
  • Findings:
  • Decisions made:
  • Changes completed:
  • Remaining work:
  • Risks / things to remember: