dd217b4546
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
- Added approvals orchestration with persistence and workflow scaffolding. - Integrated notifications insights and staged resume hooks. - Introduced approval coordinator and policy notification bridge with unit tests. - Added approval decision API with resume requeue and persisted plan snapshots. - Documented the Excitor consensus API beta and provided JSON sample payload. - Created analyzers to flag usage of deprecated merge service APIs. - Implemented logging for artifact uploads and approval decision service. - Added tests for PackRunApprovalDecisionService and related components.
38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
# StellaOps Excititor
|
||
|
||
Excititor converts heterogeneous VEX feeds into raw observations and linksets that honour the Aggregation-Only Contract.
|
||
|
||
## Latest updates (2025-11-05)
|
||
- Link-Not-Merge readiness: release note [Excitor consensus beta](../../updates/2025-11-05-excitor-consensus-beta.md) captures how Excititor feeds power the Excitor consensus beta (sample payload in [consensus JSON](../../vex/consensus-json.md)).
|
||
- README now points policy/UI teams to the upcoming consensus integration work.
|
||
|
||
## Responsibilities
|
||
- Fetch OpenVEX/CSAF/CycloneDX statements via restart-only connectors.
|
||
- Store immutable VEX observations with full provenance.
|
||
- Publish linksets and events that drive policy suppression decisions.
|
||
- Provide deterministic exports for Offline Kit and downstream tooling.
|
||
|
||
## Key components
|
||
- `StellaOps.Excititor.WebService` scheduler/API host.
|
||
- Connector libraries under `StellaOps.Excititor.Connector.*`.
|
||
- Normalization helpers and exporters in `StellaOps.Excititor.*`.
|
||
|
||
## Integrations & dependencies
|
||
- Policy Engine for evidence queries.
|
||
- UI/CLI for conflict visibility and explanation.
|
||
- Notify for VEX-driven alerts.
|
||
|
||
## Operational notes
|
||
- MongoDB for observation storage and job metadata.
|
||
- Offline kit packaging aligned with Concelier merges.
|
||
- Connector-specific runbooks (see `docs/modules/concelier/operations/connectors`).
|
||
|
||
## Backlog references
|
||
- DOCS-LNM-22-006 / DOCS-LNM-22-007 (shared with Concelier).
|
||
- CLI-EXC-25-001..002 follow-up for CLI parity.
|
||
|
||
## Epic alignment
|
||
- **Epic 1 – AOC enforcement:** maintain immutable VEX observations, provenance, and AOC verifier coverage.
|
||
- **Epic 7 – VEX Consensus Lens:** supply trustworthy raw inputs, trust metadata, and consensus hooks for the lens computations.
|
||
- **Epic 8 – Advisory AI:** expose citation-ready VEX payloads for the advisory assistant pipeline.
|