Expand CLI with site management and realtime stats workflows

Author: vicentereig

docs/000-v1-plan.md

@@ -4,11 +4,11 @@
 Deliver an ergonomic CLI that surfaces Plausible Analytics capabilities to humans and LLMs, while respecting rate limits, juggling multiple accounts, and enabling queued API execution.
 
 ## Current Status — 2025-10-29
-- ✅ Foundations in place: repo scaffolding, account store (file-backed), Plausible client (sites + stats aggregate/timeseries/breakdown + events send), rate limiter scaffold, queue/worker with inspect/drain, CLI surface (`status`, `sites list`, `stats aggregate/timeseries/breakdown`, `events template/send/import`, `accounts` CRUD), docs/LLM artefacts, CI wiring (latest on `main` @ 3a2b77c).
-- ⏳ Features to extend: stats `realtime`, sites CRUD/reset/delete, queue retry/backoff controls, daily budget configurability, secure keyring fallback, telemetry export.
-- 🔬 Test gaps: full CLI integration coverage via `assert_cmd` + JSON snapshots, expanded HTTP mocks (sites CRUD, realtime), backpressure + large import cases, keyring mock coverage.
+- ✅ Foundations in place: repo scaffolding, account store (file-backed), Plausible client (sites list/create/update/reset/delete, stats aggregate/timeseries/breakdown/realtime, events send), rate limiter scaffold, queue/worker with inspect/drain, CLI surface (`status`, `sites list/create/update/reset/delete`, `stats aggregate/timeseries/breakdown/realtime`, `events template/send/import`, `queue inspect/drain`, `accounts` CRUD), docs/LLM artefacts, CI wiring (latest on `main` @ 37774b9).
+- ⏳ Features to extend: queue retry/backoff controls, daily budget configurability, secure keyring fallback, richer telemetry/export surfaces.
+- 🔬 Test gaps: full CLI integration coverage via `assert_cmd` + JSON snapshots, expanded HTTP mocks (sites destructive actions, realtime edge cases), backpressure + large import cases, keyring mock coverage.
 - 🚀 Distribution polish pending: GitHub release workflow, `cargo install` docs, Homebrew tap automation, tagged release + changelog.
-- 🧭 Next sprint focus: persistence polish (daily budget + keyring), extend site/event surface, then harden integration tests before release packaging.
+- 🧭 Next sprint focus: persistence polish (daily budget + keyring), queue resilience, and end-to-end CLI tests before release packaging.
 
 ## Release Scope
 - Sites, Stats, Events API coverage.
@@ -82,8 +82,8 @@ gantt
 - ⏳ Tests: concurrency under load, ensures queue drains, error propagation.
 
 ### 6. CLI Commands & Output
-- ✅ Sites `list`; ⏳ `create/update/reset/delete`.
-- ✅ Stats `aggregate/timeseries/breakdown`; ⏳ `realtime` with shared flags.
+- ✅ Sites `list/create/update/reset/delete`.
+- ✅ Stats `aggregate/timeseries/breakdown/realtime` with shared flags.
 - ✅ Events `template/send/import`.
 - ✅ Queue `inspect/drain`.
 - ✅ Status (reports account, limits, queue stats, API health).

docs/architeture.md

@@ -7,8 +7,8 @@
 - Expose machine-readable JSON outputs and human-readable table narratives.
 
 ## Status Snapshot — 2025-10-29
-- ✅ Implemented: account store (file-backed) with CRUD, Plausible client (sites list, stats aggregate/timeseries/breakdown, events send), rate limiter with hourly ledger, queue + telemetry + inspect/drain snapshotting, CLI commands (`status`, `sites list`, `stats aggregate/timeseries/breakdown`, `events template/send/import`, `accounts` subcommands), documentation set, CI pipeline.
-- ⏳ In progress: extend Plausible client (sites CRUD/reset/delete, stats realtime, advanced events batching), integration tests & CLI snapshots, daily budget overrides, secure keyring/OS credential fallback, queue retry/backoff controls.
+- ✅ Implemented: account store (file-backed) with CRUD, Plausible client (sites list/create/update/reset/delete, stats aggregate/timeseries/breakdown/realtime, events send), rate limiter with hourly ledger, queue + telemetry + inspect/drain snapshotting, CLI commands (`status`, `sites list/create/update/reset/delete`, `stats aggregate/timeseries/breakdown/realtime`, `events template/send/import`, `queue inspect/drain`, `accounts` subcommands), documentation set, CI pipeline.
+- ⏳ In progress: integration tests & CLI snapshots, daily budget overrides, secure keyring/OS credential fallback, queue retry/backoff controls, advanced telemetry export.
 - 🚀 Pending release tasks: distribution automation (GitHub releases, Homebrew tap), versioning, `plausible doctor`, TDD expansion before v1 tag.
 
 ## API Surface Summary
@@ -46,16 +46,16 @@
 
 ### `plausible sites`
 - ✅ `list` – summarizes domains, visibility status, timezone (wired through queue + Plausible client).
-- ⏳ `create` – accept domain, timezone, optional public flag.
-- ⏳ `update` – patch properties via key-value flags.
-- ⏳ `reset` – trigger stats reset with date range confirmation.
-- ⏳ `delete` – queued destructive call requiring confirmation.
+- ✅ `create` – accept domain, timezone, optional public flag.
+- ✅ `update` – patch properties via key-value flags (`--timezone`, `--public`, `--main-site`).
+- ✅ `reset` – trigger stats reset with optional date range confirmation.
+- ✅ `delete` – queued destructive call requiring `--force` or interactive confirmation.
 
 ### `plausible stats`
 - ✅ `aggregate` – returns KPI metrics; supports `--metric` repeatable flags.
 - ✅ `timeseries` – emits chronologically sorted rows; optional `--json` or `--csv`.
 - ✅ `breakdown` – slices by dimensions with pagination; handles `--dimension` values.
-- ⏳ `realtime` – fetch visitors currently on site.
+- ✅ `realtime` – fetch visitors currently on site and prints visitors/pageviews/bounce rate.
 - Shared flags: `--site`, `--period|--date`, `--filters`, `--props`, `--format`.
 
 ### `plausible events`