todays product advirories implemented

docs-archived/implplan/SPRINT_20260117_021_CLI_taskrunner.md

@@ -0,0 +1,124 @@
+# Sprint 021 - TaskRunner CLI
+
+## Topic & Scope
+- Surface TaskRunner capabilities via CLI
+- Add task execution, monitoring, and artifact management commands
+- Working directory: `src/Cli/`
+- Expected evidence: CLI commands, unit tests
+- Note: From FEATURE_GAPS_REPORT.md Batch 12 (Operations)
+
+## Dependencies & Concurrency
+- No upstream sprint dependencies
+- Can run in parallel with other CLI sprints
+- Depends on TaskRunner service
+
+## Documentation Prerequisites
+- `docs/modules/taskrunner/architecture.md`
+- `docs/FEATURE_GAPS_REPORT.md` (Batch 12)
+- TaskRunner service APIs
+
+## Delivery Tracker
+
+### TRN-001 - Add `stella taskrunner status` command
+Status: DONE
+Dependency: none
+Owners: Developer
+
+Task description:
+- Create TaskRunnerCommandGroup.cs with `status` subcommand
+- Report TaskRunner service health and capacity
+- Include worker pool metrics
+
+Completion criteria:
+- [x] `stella taskrunner status` returns service status
+- [x] Output includes service health (healthy/degraded/unhealthy)
+- [x] Output includes worker count and capacity
+- [x] Output includes queue depth
+- [x] Supports `--format json|table`
+
+### TRN-002 - Add `stella taskrunner tasks list/show` commands
+Status: DONE
+Dependency: TRN-001
+Owners: Developer
+
+Task description:
+- Add `tasks` subcommand group for task inspection
+- List tasks with filtering by status and type
+- Show detailed task information
+
+Completion criteria:
+- [x] `stella taskrunner tasks list` returns task list
+- [x] Supports `--status pending|running|completed|failed` filter
+- [x] Supports `--type <task-type>` filter
+- [x] Supports `--from` and `--to` time range
+- [x] `stella taskrunner tasks show <task-id>` returns task details
+- [x] Details include steps, timing, artifacts
+- [x] Supports `--format json|table`
+
+### TRN-003 - Add `stella taskrunner tasks cancel` command
+Status: DONE
+Dependency: TRN-002
+Owners: Developer
+
+Task description:
+- Add `cancel` subcommand for task cancellation
+- Cancel running or pending tasks
+- Include graceful shutdown option
+
+Completion criteria:
+- [x] `stella taskrunner tasks cancel <task-id>` cancels task
+- [x] Supports `--graceful` for graceful shutdown
+- [x] Supports `--force` for immediate termination
+- [x] Returns cancellation status
+- [x] Only works on running/pending tasks
+
+### TRN-004 - Add `stella taskrunner artifacts list/get` commands
+Status: DONE
+Dependency: none
+Owners: Developer
+
+Task description:
+- Add `artifacts` subcommand group for artifact management
+- List artifacts captured by tasks
+- Download artifacts to local filesystem
+
+Completion criteria:
+- [x] `stella taskrunner artifacts list --task <task-id>` lists artifacts
+- [x] Output includes artifact name, type, size, digest
+- [x] `stella taskrunner artifacts get <artifact-id>` downloads artifact
+- [x] Supports `--output <path>` for download location
+- [x] Verifies artifact digest after download
+- [x] Supports `--format json|table`
+
+### TRN-005 - Add `stella taskrunner logs` command
+Status: DONE
+Dependency: TRN-002
+Owners: Developer
+
+Task description:
+- Add `logs` subcommand for task log retrieval
+- Stream or download task execution logs
+- Filter by step and log level
+
+Completion criteria:
+- [x] `stella taskrunner logs <task-id>` shows task logs
+- [x] Supports `--follow` for streaming
+- [x] Supports `--step <step-name>` filter
+- [x] Supports `--level error|warn|info|debug` filter
+- [x] Supports `--output <path>` for log download
+
+## Execution Log
+| Date (UTC) | Update | Owner |
+| --- | --- | --- |
+| 2026-01-17 | Sprint created from FEATURE_GAPS_REPORT.md Batch 12 | Planning |
+| 2026-01-16 | TRN-001 through TRN-005: Created TaskRunnerCommandGroup.cs | Developer |
+
+## Decisions & Risks
+- Task cancellation may leave resources in inconsistent state
+- Artifact download may be slow for large artifacts
+- Log streaming requires WebSocket or SSE support
+
+## Next Checkpoints
+- Sprint kickoff: TBD
+- Mid-sprint review: TBD
+- Sprint completion: TBD