docs consolidation work
This commit is contained in:
@@ -31,6 +31,41 @@ Scheduler detects advisory/VEX deltas, computes impact windows, and orchestrates
|
||||
- SCHED-MODELS-20-001 (policy run DTOs) and related tasks in ../../TASKS.md.
|
||||
- Scheduler observability follow-ups in src/Scheduler/**/TASKS.md.
|
||||
|
||||
## Implementation Status
|
||||
|
||||
### Current Objectives
|
||||
- Maintain deterministic behaviour and offline parity across releases
|
||||
- Keep documentation, telemetry, and runbooks aligned with latest sprint outcomes
|
||||
- Coordinate with Policy Engine for incremental re-evaluation workflows
|
||||
|
||||
### Epic Milestones
|
||||
- Epic 2 – Policy Engine & Editor: incremental policy run orchestration, change streams, explain trace propagation (in progress)
|
||||
- Epic 6 – Vulnerability Explorer: findings updates and remediation triggers integration (in progress)
|
||||
- Epic 9 – Orchestrator Dashboard: job telemetry and control surfaces for UI/CLI (planned)
|
||||
|
||||
### Core Capabilities
|
||||
- Impact cursor maintenance and queue management for re-scan/re-evaluate jobs
|
||||
- Change-stream detection for advisory/VEX/SBOM deltas
|
||||
- Policy-triggered recheck orchestration with runtime hooks
|
||||
- SLA-aware retry logic with deterministic evaluation windows
|
||||
- DSSE-backed completion events for downstream consumers
|
||||
|
||||
### Integration Points
|
||||
- PostgreSQL schema (scheduler) for impact models and job state
|
||||
- Valkey/NATS for queueing with idempotency
|
||||
- Policy Engine, Scanner, Notify for job coordination
|
||||
- Orchestrator for backfills and incident routing
|
||||
|
||||
### Operational Assets
|
||||
- Monitoring: worker-grafana-dashboard.json, worker-prometheus-rules.yaml
|
||||
- Runbooks: operations/worker.md
|
||||
- Observability: metrics, traces, structured logs with correlation IDs
|
||||
|
||||
### Technical Notes
|
||||
- Coordination approach: review AGENTS.md, sync via docs/implplan/SPRINT_*.md
|
||||
- Backlog tracking: SCHED-MODELS-20-001 and related tasks in ../../TASKS.md
|
||||
- Module tasks: src/Scheduler/**/TASKS.md
|
||||
|
||||
## Epic alignment
|
||||
- **Epic 2 – Policy Engine & Editor:** orchestrate incremental re-evaluation and simulation runs when raw facts or policies change.
|
||||
- **Epic 6 – Vulnerability Explorer:** feed triage workflows with up-to-date job status, explain traces, and ledger hooks.
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
# Implementation plan — Scheduler
|
||||
|
||||
## Current objectives
|
||||
- Maintain deterministic behaviour and offline parity across releases.
|
||||
- Keep documentation, telemetry, and runbooks aligned with the latest sprint outcomes.
|
||||
|
||||
## Workstreams
|
||||
- Backlog grooming: reconcile open stories in ../../TASKS.md with this module's roadmap.
|
||||
- Implementation: collaborate with service owners to land feature work defined in SPRINTS/EPIC docs.
|
||||
- Validation: extend tests/fixtures to preserve determinism and provenance requirements.
|
||||
|
||||
## Epic milestones
|
||||
- **Epic 2 – Policy Engine & Editor:** deliver incremental policy run orchestration, change streams, and explain trace propagation.
|
||||
- **Epic 6 – Vulnerability Explorer:** ensure findings updates and remediation triggers integrate with scheduler outputs.
|
||||
- **Epic 9 – Orchestrator Dashboard:** provide job telemetry and control surfaces consumed by the orchestrator UI/CLI.
|
||||
- Track additional work (SCHED-MODELS-20-001, observability follow-ups) in ../../TASKS.md and src/Scheduler/**/TASKS.md.
|
||||
|
||||
## Coordination
|
||||
- Review ./AGENTS.md before picking up new work.
|
||||
- Sync with cross-cutting teams noted in `/docs/implplan/SPRINT_*.md`.
|
||||
- Update this plan whenever scope, dependencies, or guardrails change.
|
||||
Reference in New Issue
Block a user