# Excititor VEX Ingest Management CLI

## Module
Cli

## Status
VERIFIED

## Description
Manage Excititor VEX ingest workflows: initialize state with checkpoint resume, pull from providers with time windows and force mode, and run exports.

## Implementation Details
- **Command Handlers**: `src/Cli/StellaOps.Cli/Commands/CommandHandlers.cs` -- Excititor-related handlers
- **VEX Observations Client**: `src/Cli/StellaOps.Cli/Services/VexObservationsClient.cs` / `IVexObservationsClient.cs` -- VEX observations API client
- **Commands**:
  - `stella vex ingest init` -- initialize VEX ingest state
  - `stella vex ingest pull --provider <name> --from <date> --to <date>` -- pull VEX statements from provider
  - `stella vex ingest pull --force` -- force re-pull all statements
  - `stella vex ingest export` -- export ingested VEX data

## E2E Test Plan
- [ ] Run `stella vex ingest init` and verify state initialized
- [ ] Run `stella vex ingest pull --provider osv` and verify VEX statements pulled
- [ ] Run `stella vex ingest pull --from 2024-01-01 --to 2024-12-31` and verify time window filtering
- [ ] Run `stella vex ingest pull --force` and verify force re-pull
- [ ] Run `stella vex ingest export` and verify export execution
- [ ] Verify checkpoint resume works after interrupted pull

## 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, 339 tests pass in StellaOps.Cli.Plugins.Tests
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Plugins.Tests/StellaOps.Cli.Plugins.Tests.csproj`
- **Evidence**: `docs/qa/feature-checks/runs/cli/excititor-vex-ingest-management-cli/run-001/tier2-integration-check.json`