feat(cli/logs): TDD tests + implementation verified; docs: README and Epic E final update

Author: iOS E2E Implementation

crates/aether-cli/README.md

@@ -0,0 +1,28 @@
+# Aether CLI
+
+## `aether logs`
+
+Stream application logs from the control-plane.
+
+Flags:
+- --app <name> (default: $AETHER_DEFAULT_APP or "sample-app")
+- --follow (keep connection and auto-reconnect)
+- --since <duration|RFC3339>
+- --container <name>
+- --format json|text (default: text)
+- --color (optional colorization)
+
+Environment overrides:
+- AETHER_API_BASE: control-plane base URL (e.g., http://localhost:8080)
+- AETHER_LOGS_FOLLOW=1: default follow behavior
+- AETHER_LOGS_FORMAT=json|text: default format
+- AETHER_LOGS_CONTAINER: default container
+- AETHER_LOGS_SINCE: default since filter
+- AETHER_LOGS_TAIL: tail lines (default 100)
+- AETHER_LOGS_MAX_RECONNECTS: cap reconnect attempts
+- AETHER_LOGS_MOCK=1: mock output without network (used in tests/CI)
+
+Examples:
+- aether logs --app demo --follow
+- AETHER_LOGS_FORMAT=json aether logs --app demo
+- AETHER_LOGS_MOCK=1 aether logs --app demo --format text

docs/issues/17-epic-E-cli-logs.md

@@ -6,7 +6,7 @@ Summary
 Expose aether logs command consuming the new logs API with common UX flags.
 
 Tasks
- - [ ] E1 Implement `aether logs`
+ - [x] E1 Implement `aether logs`
   - Flags: --app, --follow, --since, --container, --format=json|text
   - Graceful reconnect; colorize by pod/container (optional)
   - [x] Unit + integration tests (mock server) — TDD tests written and passing
@@ -15,9 +15,16 @@ Dependencies
 - Epic A endpoint in control-plane
 
 
-Status Update — 2025-10-14
+Status Update — 2025-10-14 (Final)
 
-- TDD tests for `aether logs` written and passing: help/flags, mock text/json, follow/reconnect, container/since flags.
+- Implemented `aether logs` with flags: --app, --follow, --since, --container, --format=json|text, and optional --color.
+- Graceful reconnect loop with backoff; mock mode via env for CI (no network).
+- TDD tests green: help/flags, mock text/json, follow/reconnect, container/since flags.
+- Added CLI README documenting flags and env overrides.
+
+Quick try
+- AETHER_LOGS_MOCK=1 aether logs --app demo --format text
+- AETHER_API_BASE=http://localhost:8080 aether logs --app demo --follow --since 5m
 
 DoD
 - CLI command functional; documented in --help and README