Files
git.stella-ops.org/docs/features/checked/advisoryai/advisoryai-jobengine.md

3.0 KiB

AdvisoryAI Orchestrator (Chat + Workbench + Runs)

Module

AdvisoryAI

Status

VERIFIED

Description

The AdvisoryAI module provides a chat orchestrator with session management, run tracking (with artifacts and events), and tool routing. Backend web service with chat and run endpoints is operational.

Implementation Details

  • Modules: src/AdvisoryAI/StellaOps.AdvisoryAI/, src/AdvisoryAI/StellaOps.AdvisoryAI.WebService/, src/AdvisoryAI/StellaOps.AdvisoryAI.Worker/
  • Key Classes:
    • AdvisoryPipelineOrchestrator (src/AdvisoryAI/StellaOps.AdvisoryAI/Orchestration/AdvisoryPipelineOrchestrator.cs) - main pipeline orchestrator coordinating task plans and execution
    • AdvisoryPipelineExecutor (src/AdvisoryAI/StellaOps.AdvisoryAI/Execution/AdvisoryPipelineExecutor.cs) - executes advisory pipeline stages
    • AdvisoryChatService (src/AdvisoryAI/StellaOps.AdvisoryAI/Chat/Services/AdvisoryChatService.cs) - chat session orchestration service
    • ConversationService (src/AdvisoryAI/StellaOps.AdvisoryAI/Chat/ConversationService.cs) - manages conversation state and context
    • RunService (src/AdvisoryAI/StellaOps.AdvisoryAI/Runs/RunService.cs) - tracks runs with artifacts and events
    • InMemoryRunStore (src/AdvisoryAI/StellaOps.AdvisoryAI/Runs/InMemoryRunStore.cs) - in-memory storage for run data
    • AdvisoryChatIntentRouter (src/AdvisoryAI/StellaOps.AdvisoryAI/Chat/Routing/AdvisoryChatIntentRouter.cs) - routes chat intents to appropriate handlers
    • ChatEndpoints (src/AdvisoryAI/StellaOps.AdvisoryAI.WebService/Endpoints/ChatEndpoints.cs) - REST endpoints for chat operations
    • RunEndpoints (src/AdvisoryAI/StellaOps.AdvisoryAI.WebService/Endpoints/RunEndpoints.cs) - REST endpoints for run tracking
    • AdvisoryTaskWorker (src/AdvisoryAI/StellaOps.AdvisoryAI.Worker/Services/AdvisoryTaskWorker.cs) - background worker processing advisory tasks
  • Interfaces: IAdvisoryPipelineOrchestrator, IRunService, IRunStore
  • Source: Feature matrix scan

E2E Test Plan

  • Submit a chat message via ChatEndpoints and verify AdvisoryChatService processes it with correct conversation context
  • Create a run via RunEndpoints and verify RunService tracks artifacts and events in InMemoryRunStore
  • Verify AdvisoryChatIntentRouter routes different intent types (explain, remediate, policy) to correct handlers
  • Verify AdvisoryPipelineOrchestrator creates and executes task plans with AdvisoryPipelineExecutor
  • Verify AdvisoryTaskWorker picks up queued tasks and processes them to completion
  • Verify conversation context is maintained across multiple messages in the same session via ConversationService

Verification

  • Verified on 2026-02-11 via run-001.
  • Tier 0: docs/qa/feature-checks/runs/advisoryai/advisoryai-jobengine/run-001/tier0-source-check.json
  • Tier 1: docs/qa/feature-checks/runs/advisoryai/advisoryai-jobengine/run-001/tier1-build-check.json
  • Tier 2: docs/qa/feature-checks/runs/advisoryai/advisoryai-jobengine/run-001/tier2-api-check.json