git.stella-ops.org/docs-archived/implplan/SPRINT_20260117_021_CLI_taskrunner.md

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:

• stella taskrunner status returns service status
• Output includes service health (healthy/degraded/unhealthy)
• Output includes worker count and capacity
• Output includes queue depth
• 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:

• stella taskrunner tasks list returns task list
• Supports --status pending|running|completed|failed filter
• Supports --type <task-type> filter
• Supports --from and --to time range
• stella taskrunner tasks show <task-id> returns task details
• Details include steps, timing, artifacts
• 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:

• stella taskrunner tasks cancel <task-id> cancels task
• Supports --graceful for graceful shutdown
• Supports --force for immediate termination
• Returns cancellation status
• 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:

• stella taskrunner artifacts list --task <task-id> lists artifacts
• Output includes artifact name, type, size, digest
• stella taskrunner artifacts get <artifact-id> downloads artifact
• Supports --output <path> for download location
• Verifies artifact digest after download
• 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:

• stella taskrunner logs <task-id> shows task logs
• Supports --follow for streaming
• Supports --step <step-name> filter
• Supports --level error|warn|info|debug filter
• 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