save checkpoint: save features
This commit is contained in:
master
@@ -0,0 +1,35 @@
|
||||
# Doctor AdvisoryAI Integration
|
||||
|
||||
## Module
|
||||
Doctor
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Integration between Doctor diagnostics and AdvisoryAI system to provide deterministic AI-powered diagnosis explanations, with schema-aware context adaptation and a published diagnosis API endpoint.
|
||||
|
||||
## Implementation Details
|
||||
- **AI diagnosis service**: `src/__Libraries/StellaOps.Doctor/AdvisoryAI/IDoctorAIDiagnosisService.cs` and `src/__Libraries/StellaOps.Doctor/AdvisoryAI/DeterministicDoctorAIDiagnosisService.cs`
|
||||
- **Context adapter**: `src/__Libraries/StellaOps.Doctor/AdvisoryAI/DoctorContextAdapter.cs`, `src/__Libraries/StellaOps.Doctor/AdvisoryAI/IDoctorContextAdapter.cs`
|
||||
- **Evidence schema registry**: `src/__Libraries/StellaOps.Doctor/AdvisoryAI/IEvidenceSchemaRegistry.cs`
|
||||
- **AI context models**: `src/__Libraries/StellaOps.Doctor/AdvisoryAI/Models/DoctorAIContext.cs`
|
||||
- **Doctor diagnosis API surface**: `src/Doctor/StellaOps.Doctor.WebService/Endpoints/DoctorEndpoints.cs`, `src/Doctor/StellaOps.Doctor.WebService/Services/DoctorDiagnosisService.cs`, `src/Doctor/StellaOps.Doctor.WebService/Contracts/DoctorModels.cs`, `src/Doctor/StellaOps.Doctor.WebService/Program.cs`
|
||||
- **Verification tests**: `src/Doctor/__Tests/StellaOps.Doctor.WebService.Tests/Services/DoctorDiagnosisServiceTests.cs`, `src/__Libraries/__Tests/StellaOps.Doctor.Tests/AdvisoryAI/DoctorContextAdapterTests.cs`
|
||||
|
||||
## E2E Test Plan
|
||||
- [x] Verify AI diagnosis endpoint accepts doctor health check results.
|
||||
- [x] Test context adapter converts health results to proper AI context.
|
||||
- [x] Verify evidence schema registry returns valid schemas.
|
||||
- [x] Test Doctor diagnosis workflow produces deterministic assessment and remediation output.
|
||||
|
||||
## Verification
|
||||
- Run: `run-003` (2026-02-11).
|
||||
- Tier 0 source verification passed for advisory-ai contracts, diagnosis service wiring, and diagnosis route publication.
|
||||
- Tier 1 build/tests passed for Doctor library and Doctor WebService diagnosis paths.
|
||||
- Tier 2 API verification passed with fresh user-surface evidence:
|
||||
- `GET /healthz` -> `200`
|
||||
- `GET /openapi/v1.json` -> `200` and published `/api/v1/doctor/diagnosis`
|
||||
- `POST /api/v1/doctor/diagnosis` invalid payload -> `400` (`ProblemDetails`)
|
||||
- `POST /api/v1/doctor/diagnosis` valid inline report -> `200` (`DoctorDiagnosisResponse`)
|
||||
- Terminal outcome: `done`.
|
||||
@@ -0,0 +1,27 @@
|
||||
# Doctor Runbook URL Integration
|
||||
|
||||
## Module
|
||||
Doctor
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Extended Doctor diagnostic framework to support runbook URL links in remediation output, making operational runbooks discoverable directly from `stella doctor` CLI and UI results.
|
||||
|
||||
## Implementation Details
|
||||
- **Remediation models**: `src/__Libraries/StellaOps.Doctor/Models/RemediationStep.cs` -- includes runbook URL field
|
||||
- **Doctor models**: `src/Doctor/StellaOps.Doctor.WebService/Contracts/DoctorModels.cs` -- API models with runbook references
|
||||
- **Auto-remediation**: `src/Doctor/__Plugins/StellaOps.Doctor.Plugin.Timestamping/AutoRemediation.cs` -- remediation with linked runbooks
|
||||
- **Source**: SPRINT_20260117_029_DOCS
|
||||
|
||||
## E2E Test Plan
|
||||
- [x] Verify doctor check results include runbook URLs where applicable
|
||||
- [x] Test CLI `stella doctor` output displays remediation payloads and remains contract-compatible after runbook URL projection changes
|
||||
- [x] Verify Doctor API remediation DTOs include runbook URL when present
|
||||
|
||||
## Verification
|
||||
Run: run-002 (2026-02-11)
|
||||
- Tier 1 tests passed for Doctor output formatters and Doctor WebService mapping with runbook URL fixtures.
|
||||
- Tier 2 verification captured fresh CLI interactions and parity evidence confirming runbook URL projection in formatter/API surfaces when the field is provided by checks.
|
||||
- Terminal outcome for this dossier: `done`.
|
||||
@@ -0,0 +1,37 @@
|
||||
# Doctor Scheduled Runs with Alerting and Trend Analysis
|
||||
|
||||
## Module
|
||||
Doctor
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Cron-based scheduled execution of Doctor health checks with configurable schedules, trend data storage for historical analysis, anomaly detection for health metric degradation, and alerting service integration for notifications on health regressions.
|
||||
|
||||
## Implementation Details
|
||||
- **Schedule worker**: `src/Doctor/StellaOps.Doctor.Scheduler/DoctorScheduleWorker.cs` -- background worker for cron-based execution
|
||||
- **Schedule executor**: `src/Doctor/StellaOps.Doctor.Scheduler/Services/ScheduleExecutor.cs` -- executes scheduled doctor runs
|
||||
- **Schedule models**: `src/Doctor/StellaOps.Doctor.Scheduler/Models/DoctorSchedule.cs` -- schedule configuration
|
||||
- **Execution tracking**: `src/Doctor/StellaOps.Doctor.Scheduler/Models/ScheduleExecution.cs` -- execution records
|
||||
- **Trend data**: `src/Doctor/StellaOps.Doctor.Scheduler/Models/TrendDataPoint.cs` -- trend analysis data model
|
||||
- **Alert service**: `src/Doctor/StellaOps.Doctor.Scheduler/Services/IAlertService.cs` -- alerting interface for health regressions
|
||||
- **Schedule repository**: `src/Doctor/StellaOps.Doctor.Scheduler/Services/IScheduleRepository.cs`
|
||||
- **Trend repository**: `src/Doctor/StellaOps.Doctor.Scheduler/Services/ITrendRepository.cs` -- trend data persistence
|
||||
- **Scheduler API endpoints**: `src/Doctor/StellaOps.Doctor.Scheduler/Endpoints/SchedulerEndpoints.cs` -- schedule/trend HTTP surface under `/api/v1/doctor/scheduler/*`
|
||||
- **In-memory scheduler stores**: `src/Doctor/StellaOps.Doctor.Scheduler/Services/InMemoryScheduleRepository.cs`, `src/Doctor/StellaOps.Doctor.Scheduler/Services/InMemoryTrendRepository.cs`
|
||||
- **Options**: `src/Doctor/StellaOps.Doctor.Scheduler/Options/DoctorSchedulerOptions.cs` -- scheduler configuration
|
||||
- **Source**: SPRINT_20260118_020_Doctor_scheduled_runs_trending.md
|
||||
|
||||
## E2E Test Plan
|
||||
- [x] Verify scheduled doctor runs execute at configured intervals
|
||||
- [x] Test trend data accumulation over multiple runs
|
||||
- [x] Verify alert service triggers on health degradation (error-path alerting observed on downstream API unavailability)
|
||||
- [x] Test schedule CRUD operations via repository and runtime API endpoints
|
||||
|
||||
## Verification
|
||||
Run: run-002 (2026-02-11)
|
||||
- Tier 1 build/test passed for `StellaOps.Doctor.Scheduler` and new repository unit coverage (`4/4`).
|
||||
- Tier 2 API probes passed for scheduler CRUD, manual execute, and trend endpoints (`14` successful HTTP transactions; no failed probes).
|
||||
- Terminal outcome for this dossier: `done`.
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
# Doctor YAML Pack Loader and First-Party Packs
|
||||
|
||||
## Module
|
||||
Doctor
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
YAML-based diagnostic pack loader allowing first-party and user-defined diagnostic packs, with a self-service Doctor UI page for running health checks interactively.
|
||||
|
||||
## Implementation Details
|
||||
- **Plugin core**: `src/Doctor/__Plugins/StellaOps.Doctor.Plugins.Core/IDoctorPlugin.cs` -- plugin interface for pack loading
|
||||
- **First-party packs**: 14+ doctor plugins under `src/Doctor/__Plugins/` covering Agent, Attestor, Auth, BinaryAnalysis, Compliance, Crypto, Environment, EvidenceLocker, Notify, Observability, Operations, Policy, Postgres, Release, Scanner, Storage, Timestamping, Vex
|
||||
- **WebService**: `src/Doctor/StellaOps.Doctor.WebService/` -- web service for Doctor UI and API
|
||||
- **Doctor endpoints**: `src/Doctor/StellaOps.Doctor.WebService/Endpoints/DoctorEndpoints.cs` -- API for loading and running packs
|
||||
- **Doctor service options**: `src/Doctor/StellaOps.Doctor.WebService/Options/DoctorServiceOptions.cs` -- configuration including pack paths
|
||||
- **Web UI**: `src/Web/StellaOps.Web/src/app/features/doctor/` -- self-service Doctor UI page
|
||||
- **Source**: SPRINT_20260113_005_DOCTOR
|
||||
|
||||
## E2E Test Plan
|
||||
- [ ] Verify YAML pack loading discovers and registers all first-party packs
|
||||
- [ ] Test custom/user-defined pack loading from configured paths
|
||||
- [ ] Verify Doctor UI page allows interactive check execution
|
||||
- [ ] Test pack results display correctly in UI
|
||||
|
||||
## Verification
|
||||
- Run: docs/qa/feature-checks/runs/doctor/doctor-yaml-pack-loader-and-first-party-packs/run-001/
|
||||
- Date (UTC): 2026-02-11
|
||||
|
||||
Reference in New Issue
Block a user