stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

qa(advisoryai): verify codex companion and sync FLOW/task state

Browse Source
This commit is contained in:
master
2026-02-11 14:05:06 +02:00
parent 4e5300660d
commit d2aca4c9d3
29 changed files with 2523 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
docs/features/checked/advisoryai/ai-codex-zastava-companion.md Normal file
View File

@@ -0,0 +1,34 @@
# AI Codex / Zastava Companion
## Module
AdvisoryAI
## Status
VERIFIED
## Description
Companion explanation feature that combines AdvisoryAI evidence-grounded explanations with runtime signals (for example Zastava observer signals) and exposes an API endpoint for companion explain generation.
## Implementation Details
- **Companion Service**: `src/AdvisoryAI/StellaOps.AdvisoryAI/Explanation/CodexZastavaCompanionService.cs`
- `ICodexCompanionService` contract and deterministic `CodexZastavaCompanionService` implementation.
- Normalizes and deduplicates runtime signals, computes deterministic companion hash, and returns companion summary/highlights.
- **Web Endpoint Registration**: `src/AdvisoryAI/StellaOps.AdvisoryAI.WebService/Program.cs`
- Registers `ICodexCompanionService` and maps `POST /v1/advisory-ai/companion/explain`.
- **API Contracts**: `src/AdvisoryAI/StellaOps.AdvisoryAI.WebService/Contracts/CompanionExplainContracts.cs`
- `CompanionExplainRequest`, `CompanionExplainResponse`, runtime-signal request/response contracts, and domain mapping.
- **Behavioral Tests**:
- `src/AdvisoryAI/__Tests/StellaOps.AdvisoryAI.Companion.Tests/CodexZastavaCompanionServiceTests.cs`
- `src/AdvisoryAI/__Tests/StellaOps.AdvisoryAI.Companion.Tests/CompanionExplainEndpointTests.cs`
## E2E Test Plan
- [ ] Submit companion explain request without scopes and verify the endpoint returns `403`.
- [ ] Submit companion explain request with `advisory:companion` scope and verify mapped request + companion response payload.
- [ ] Submit companion explain request where companion service rejects input and verify endpoint returns `400`.
- [ ] Verify deterministic companion hash for permuted/deduplicated runtime signal inputs.
## Verification
- Verified on 2026-02-11 via `run-002`.
- Tier 0: `docs/qa/feature-checks/runs/advisoryai/ai-codex-zastava-companion/run-002/tier0-source-check.json`
- Tier 1: `docs/qa/feature-checks/runs/advisoryai/ai-codex-zastava-companion/run-002/tier1-build-check.json`
- Tier 2: `docs/qa/feature-checks/runs/advisoryai/ai-codex-zastava-companion/run-002/tier2-integration-check.json`

22
docs/features/unchecked/advisoryai/ai-codex-zastava-companion.md
View File

@@ -1,22 +0,0 @@
# AI Codex / Zastava Companion
## Status
NOT_FOUND
## Description
The advisory AI module exists with policy studio and LatticeRuleGenerator, but the specific "AI Codex" or "Zastava Companion" branding/feature set described in the advisory is not found.
## Why Not Implemented
- The specific "AI Codex" or "Zastava Companion" branding is not found, but substantial AI infrastructure exists:
- `src/AdvisoryAI/` provides evidence-anchored explanation generation with `EvidenceAnchoredExplanationGenerator`, `ExplanationPromptTemplates`, replay golden tests, and a web service (`AdvisoryAI.WebService/Program.cs`)
- `src/Zastava/StellaOps.Zastava.Observer/` exists as a runtime observer module
- The Web UI has Ask Stella components under `src/Web/.../shared/components/ai/`
- The "AI Codex" concept (a comprehensive AI assistant branded as "Zastava Companion") appears to be a product vision not yet realized as a unified feature, though its constituent parts (AI explanations, policy studio, LatticeRuleGenerator) exist separately
## Source
- Feature matrix scan
## Notes
- Module: AdvisoryAI
- Modules referenced: `src/AdvisoryAI`, `src/Zastava/`
- Related: `src/AdvisoryAI/StellaOps.AdvisoryAI/Explanation/` (explanation generation), `src/Zastava/` (observer)