CLI parity delivery backlog
Status: Initial implementation. Scope is limited to current-provider discovery and console-only campground availability. D01–D13 are tracked TODOs, not queued implementation slices or initial release prerequisites. See specification, inventory and design outline.
Specification work
- [x] T001 Audit the pinned legacy CLI, YAML/environment/state surface and provider/deployment/channel coverage.
- [x] T002 Define requirements and acceptance scenarios, preserving the full historical inventory.
- [x] T022 Separate initial scope from explicitly deferred TODOs; record search-forever direction without settling run-mode design.
- [x] T023 Specify the approved command tree, exact initial option/default/precedence contract, installed-command monitoring/cleanup gates and console-only scope following review. Pushover is explicitly deferred, so initial CLI credential configuration is unnecessary.
Initial implementation backlog
- [x] T003 Create public Click command fixtures for the complete command contract: provider/debug/environment precedence, repeated IDs/date pairs/days, selector precedence, exact metadata lookup, display limits, date/stay matching, output streams and errors; deferred entries need dispositions, not runtime fixtures (FR-001–004/015, SC-001).
- [x] T004 Design typed requests and current-provider exact campground metadata lookup and exhaustive area resolution, extending feature 025 where its limited search contract is insufficient; no site/equipment/permit/history contracts (FR-002–004).
- [x] T005 Extract only shared code needed by this scope; update architecture/import contracts and optional-free regressions without adding deferred-feature abstractions (FR-017–018).
- [x] T006 Add lazy initial commands, compatible current-provider selection, plain Click help/debug/output and truthful capability listing; preserve serve/db (FR-001–003/015).
- [x] T007 Implement complete area/campground target enumeration, paired windows, weekday union and exact-length stays (FR-003–004).
- [x] T008 Verify the actual installed
camplyexecutable outside the checkout from base wheel/sdist-rebuilt wheel, using synthetic upstreams: supplied arguments reach provider requests, stays are printed, matching checks are followed by another cycle, and signal cancellation closes owned resources. Cover no catalog/database/services, preflight and provider failures; internal-only tests do not satisfy this task (SC-002–005). - [x] T009 Implement immediate first check and continued checking after empty/matching responses until cancellation, with existing provider pacing and resource cleanup; verify through public entrypoint tests. Leave the three legacy switches and detailed mode/cron design to D11; no legacy mode restoration (FR-005–006/016).
- [x] T024 Verify console-only output with absent/malformed notification settings and zero notification-service requests, web-user lookup or delivery dispatch; reject
--notifications/test-notificationsand preserve existing web Pushover behavior (FR-010–012). - [x] T020 Publish initial coverage, unsupported/deferred features and safe package setup examples; no deferred flag/YAML/cron examples in initial guidance (SC-001).
- [x] T021 Run relevant quality, installed wheel/sdist, Python 3.11/3.14, docs and existing serve/db/web/worker gates for initial scope (SC-001–006).
- [x] T025 Split CLI commands/groups into focused modules, centralize shared Click options and isolate execution/discovery/output helpers. Preserve lazy loading, option precedence and existing command contracts through the CLI/import and installed-package regressions.
Original broader implementation tasks T010–T012 and T013–T019 are superseded by the TODO registry below. They do not schedule future implementation automatically.
Deferred TODO registry
All entries below are TODOs; do not implement yet.
- [ ] D01 TODO:
list-campsitesand supporting site catalogs. - [ ] D02 TODO: Search by campsite ID and site-to-parent resolution.
- [ ] D03 TODO: All external CLI notifications including Pushover, activation/recipient credentials, full provider parity, adapters and test-notifications. Initial CLI is console-only.
- [ ] D04 TODO: Full campground parity, missing providers/catalogs and broader GoingToCamp deployment mappings.
- [ ] D05 TODO: YAML files, aliases, schema/defaults, environment expansion and precedence.
- [ ] D06 TODO: Permits and non-camping inventory, including legacy ticket/tour/timed-entry variants.
- [ ] D07 TODO: Equipment filtering and equipment lookup/category/length capabilities.
- [ ] D08 TODO: TUI.
- [ ] D09 TODO: Rich-click.
- [ ] D10 TODO: Configure command and legacy
.camplyimport/write behavior. - [ ] D11 TODO: Brainstorm
--continuous/--search-forever/--search-once; intended default is search forever. Flags, cron, stopping behavior, pacing and notification suppression remain open. - [ ] D12 TODO:
--notify-first-tryand legacy notification caps. - [ ] D13 TODO:
--offline-search,--offline-search-path, persistent JSON history/import and cross-process duplicate suppression.
Bring each TODO into scope explicitly before creating detailed implementation tasks or acceptance gates for it.