32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# Runtime Observations Query CLI
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## Description
|
|
CLI commands for querying historical runtime observations filtered by symbol name (glob pattern), node hash, container, pod, or namespace with time window filtering. Complements function-map verification for runtime linkage analysis.
|
|
|
|
## Implementation Details
|
|
- **Command Group**: `src/Cli/StellaOps.Cli/Commands/Observations/ObservationsCommandGroup.cs` -- `ObservationsCommandGroup` for runtime observations
|
|
- **Commands**:
|
|
- `stella obs query` -- query runtime observations. Options: `--symbol <glob>`, `--node <hash>`, `--container <name>`, `--pod <name>`, `--namespace <ns>`, `--from <time>`, `--to <time>`, `--format table|json`
|
|
|
|
## E2E Test Plan
|
|
- [ ] Run `stella obs query --symbol "org.example.*"` and verify glob pattern matching
|
|
- [ ] Run with `--container my-app` and verify container filtering
|
|
- [ ] Run with `--from 2024-01-01 --to 2024-12-31` and verify time window filtering
|
|
- [ ] Verify pagination support
|
|
- [ ] Verify `--format json` output
|
|
|
|
## Verification
|
|
|
|
- **Verified**: 2026-02-13T15:30:00Z
|
|
- **Tier 0 (Source)**: pass -- all referenced source files exist on disk
|
|
- **Tier 1 (Build)**: pass -- module builds cleanly, 412 tests pass in StellaOps.Cli.Commands.Tests
|
|
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
|
|
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Commands.Tests/StellaOps.Cli.Commands.Tests.csproj`
|
|
- **Evidence**: `docs/qa/feature-checks/runs/cli/runtime-observations-query-cli/run-001/tier2-integration-check.json`
|