Skip to content

[ARCHIVED] CLI Future TODO

Status: Archived (2026-03-28) Feature ideas and analysis items regarding advanced scheduling, watch daemons, and HA entity imports. These concepts have been deemed out-of-scope for the core franklinwh-cloud library and are actively deferred to downstream automation platforms (like Home Assistant or the independent FEM framework). Routine discovery tasks have already been natively implemented in franklinwh-cli discover and accessories.


~~support --info — Account & Site Hierarchy~~ ✅ IMPLEMENTED

Implemented 2026-04-28. See docs/CLI_SUPPORT_INFO.md for the full reference including --diag, --mock, group-aware topology, Feature Flags, System Relays, JSON schema, and API source mapping.


Generic Command Scheduling

Extend --schedule to run any CLI command, not just nettest:

franklinwh-cli support --schedule daily --command "diag"
franklinwh-cli support --schedule "0:30" --command "control --charge"

Event-Driven Watch Daemon

Poll runtimeData, trigger CLI actions on thresholds:

franklinwh-cli watch --rules rules.yml

See design doc: automation_platform_design.md (session artifacts).


HA Entity Import

Import entity schema from FEM or HA for use in rules:

franklinwh-cli watch --import-entities --fem-url http://192.168.0.247:9091
franklinwh-cli watch --import-entities --ha-url ws://homeassistant.local:8123

Cached to ~/.franklinwh/entities.json — portable, editable, offline.


LaunchDaemon / System-Level Scheduling

Current scheduler is user-level (LaunchAgent / user crontab). For always-on operation, support system-level scheduling: - macOS: LaunchDaemon in /Library/LaunchDaemons/ (requires admin) - Linux: System crontab or systemd timer (requires root)


C.A.F.E. / HA YAML Compatibility

Make rules format compatible with C.A.F.E. visual automation editor. See design doc: automation_platform_design.md.