stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
7bafcc3eef9ae15d9441641a2ba3ef7ca4e67907
git.stella-ops.org/docs/features/checked/orchestrator/pack-run-bridge.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

3.8 KiB
Raw Blame History

Pack-Run Bridge (TaskRunner Integration)

Module

Orchestrator

Status

VERIFIED

Description

Pack-run integration with Postgres repository, API endpoints, stream coordinator for log/artifact streaming, and domain model.

Implementation Details

  • Modules: src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Core/Domain/, src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/
  • Key Classes:
    • Pack (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Core/Domain/Pack.cs) - pack entity containing a set of jobs to execute as a unit
    • PackRun (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Core/Domain/PackRun.cs) - pack-run entity tracking execution of a pack instance
    • PackRunLog (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Core/Domain/PackRunLog.cs) - log entries for pack-run execution
    • PackRunStreamCoordinator (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Streaming/PackRunStreamCoordinator.cs) - coordinates real-time streaming of pack-run logs and artifacts
    • PackRunEndpoints (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Endpoints/PackRunEndpoints.cs) - REST API for creating, querying, and managing pack runs
    • PackRegistryEndpoints (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Endpoints/PackRegistryEndpoints.cs) - REST API for pack registration and versioning
    • PackRunContracts (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Contracts/PackRunContracts.cs) - API contracts for pack-run operations
    • PackRegistryContracts (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Contracts/PackRegistryContracts.cs) - API contracts for pack registry
    • Run (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Core/Domain/Run.cs) - individual run within a pack execution
    • RunEndpoints (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Endpoints/RunEndpoints.cs) - REST API for run management
    • RunContracts (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.WebService/Contracts/RunContracts.cs) - API contracts for run operations
  • Interfaces: IPackRunRepository (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Infrastructure/Repositories/IPackRunRepository.cs), IPackRegistryRepository (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Infrastructure/Repositories/IPackRegistryRepository.cs), IRunRepository (src/Orchestrator/StellaOps.Orchestrator/StellaOps.Orchestrator.Infrastructure/Repositories/IRunRepository.cs)
  • Source: Feature matrix scan

E2E Test Plan

  • Register a pack via PackRegistryEndpoints with 3 jobs and verify it is persisted with version 1
  • Create a pack run via PackRunEndpoints and verify it starts executing the pack's jobs
  • Subscribe to the pack-run stream via PackRunStreamCoordinator and verify real-time log entries arrive as jobs execute
  • Verify pack-run completion: all 3 jobs complete and the PackRun transitions to Completed
  • Verify pack versioning: update a pack and verify PackRegistryEndpoints creates version 2 while preserving version 1
  • Query PackRunLog entries via the API and verify all log entries are returned in chronological order
  • Fail one job in a pack run and verify the pack run reports partial failure
  • Create multiple pack runs concurrently and verify they execute independently

Verification

  • Verified on 2026-02-13 via run-002.
  • Tier 0: Source files confirmed present on disk.
  • Tier 1: dotnet build passed (0 errors); 1292/1292 tests passed.
  • Tier 2d: docs/qa/feature-checks/runs/orchestrator/pack-run-bridge/run-002/tier2-integration-check.json