git.stella-ops.org/docs/features/checked/cli/excititor-vex-ingest-management-cli.md

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