108d1c64b3
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Findings Ledger CI / build-test (push) Has been cancelled
Findings Ledger CI / migration-validation (push) Has been cancelled
Scanner Analyzers / Discover Analyzers (push) Has been cancelled
Signals Reachability Scoring & Events / reachability-smoke (push) Has been cancelled
AOC Guard CI / aoc-guard (push) Has been cancelled
Concelier Attestation Tests / attestation-tests (push) Has been cancelled
cryptopro-linux-csp / build-and-test (push) Has been cancelled
Scanner Analyzers / Validate Test Fixtures (push) Has been cancelled
Signals CI & Image / signals-ci (push) Has been cancelled
sm-remote-ci / build-and-test (push) Has been cancelled
Findings Ledger CI / generate-manifest (push) Has been cancelled
AOC Guard CI / aoc-verify (push) Has been cancelled
Scanner Analyzers / Build Analyzers (push) Has been cancelled
Scanner Analyzers / Test Language Analyzers (push) Has been cancelled
Scanner Analyzers / Verify Deterministic Output (push) Has been cancelled
Signals Reachability Scoring & Events / sign-and-upload (push) Has been cancelled
1.8 KiB
1.8 KiB
Excititor Worker Charter
Mission
Run Excititor background jobs (ingestion, linkset extraction, dedup/idempotency enforcement) under the Aggregation-Only Contract; orchestrate Core + Storage without applying consensus or severity.
Scope
- Working directory:
src/Excititor/StellaOps.Excititor.Worker - Job runners, pipelines, scheduling, DI wiring, health checks, telemetry for background tasks.
Required Reading
docs/modules/excititor/architecture.mddocs/modules/excititor/vex_observations.mddocs/ingestion/aggregation-only-contract.mddocs/modules/excititor/implementation_plan.md
Roles
- Backend/worker engineer (.NET 10).
- QA automation (background job + integration tests).
Working Agreements
- Track task status in sprint files; log notable operational decisions in Execution Log.
- Respect tenant isolation on all job inputs/outputs; never process cross-tenant data.
- Idempotent processing only: guard against duplicate bundles and repeated messages.
- Offline-first; no external fetches during jobs.
- Observability: structured logs, counters, and optional OTEL traces behind config flags.
Testing & Determinism
- Provide deterministic job fixtures with seeded clocks/IDs; assert stable ordering of outputs and retries.
- Simulate failure/retry paths; ensure idempotent writes in Storage.
- Keep timestamps UTC ISO-8601; inject clock/GUID providers for tests.
Boundaries
- Delegate domain logic to Core and persistence to Storage.Postgres; avoid embedding policy or UI concerns.
- Configuration via appsettings/environment; no hard-coded secrets.
Ready-to-Start Checklist
- Required docs reviewed.
- Test harness prepared for background jobs (including retry/backoff settings).
- Feature flags defined for new pipelines before enabling in production runs.