save progress

src/Excititor/StellaOps.Excititor.WebService/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor WebService Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0327-M | DONE | Maintainability audit for Excititor.WebService. |
+| AUDIT-0327-T | DONE | Test coverage audit for Excititor.WebService. |
+| AUDIT-0327-A | TODO | Pending approval (non-test project). |

src/Excititor/StellaOps.Excititor.Worker/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Worker Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0329-M | DONE | Maintainability audit for Excititor.Worker. |
+| AUDIT-0329-T | DONE | Test coverage audit for Excititor.Worker. |
+| AUDIT-0329-A | TODO | Pending approval (non-test project). |

src/Excititor/__Libraries/StellaOps.Excititor.Persistence/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS
+## Role
+PostgreSQL persistence layer for Excititor VEX statements, linksets, providers, and raw documents.
+## Scope
+- Repository implementations for VEX statements, deltas, observations, providers, attestations, raw documents, and connector state.
+- Append-only linkset and checkpoint storage for deterministic replay and reconciliation.
+- Data source configuration and migration resources for the Excititor schema.
+## Participants
+- Excititor WebService and Worker for CRUD and reconciliation operations.
+- Connector ingestion and export flows for raw document storage and provider state.
+- Tests in `../StellaOps.Excititor.Persistence.Tests`.
+## Interfaces & contracts
+- `IVexStatementRepository`, `IVexDeltaRepository`, `IVexRawStore`, `IVexProviderStore`, `IVexObservationStore`, `IVexAttestationStore`, `IVexTimelineEventStore`.
+- `IAppendOnlyLinksetStore`, `IAppendOnlyCheckpointStore`, `IVexConnectorStateRepository`.
+- Database schema and migrations in `Migrations/*.sql`.
+## In/Out of scope
+In: persistence models, SQL schema/migrations, deterministic ordering guarantees.
+Out: connector ingestion logic, policy evaluation, and HTTP workflows.
+## Observability & security expectations
+- Log persistence failures with tenant/source identifiers; do not log raw document payloads.
+## Tests
+- Integration tests live in `../StellaOps.Excititor.Persistence.Tests` and must be deterministic and offline-friendly.
+
+## Required Reading
+- `docs/modules/excititor/architecture.md`
+- `docs/modules/platform/architecture-overview.md`
+
+## Working Agreement
+- 1. Update task status to `DOING`/`DONE` in both correspoding sprint file `/docs/implplan/SPRINT_*.md` and the local `TASKS.md` when you start or finish work.
+- 2. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
+- 3. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
+- 4. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
+- 5. Revert to `TODO` if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.

src/Excititor/__Libraries/StellaOps.Excititor.Persistence/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Persistence Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0323-M | DONE | Maintainability audit for Excititor.Persistence. |
+| AUDIT-0323-T | DONE | Test coverage audit for Excititor.Persistence. |
+| AUDIT-0323-A | TODO | Pending approval (non-test project). |

src/Excititor/__Libraries/StellaOps.Excititor.Policy/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Policy Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0325-M | DONE | Maintainability audit for Excititor.Policy. |
+| AUDIT-0325-T | DONE | Test coverage audit for Excititor.Policy. |
+| AUDIT-0325-A | TODO | Pending approval (non-test project). |

src/Excititor/__Tests/StellaOps.Excititor.Persistence.Tests/AGENTS.md

@@ -0,0 +1,24 @@
+# Excititor Persistence Tests Agent Charter
+
+## Mission
+Validate Excititor PostgreSQL persistence stores and migrations with deterministic fixtures.
+
+## Responsibilities
+- Cover repository CRUD, ordering, and idempotency behavior.
+- Cover migration application and schema invariants.
+- Keep fixtures deterministic (no random/time unless fixed).
+
+## Required Reading
+- docs/modules/excititor/architecture.md
+- docs/modules/platform/architecture-overview.md
+
+## Definition of Done
+- Tests cover success and failure paths for stores and migrations.
+- Fixtures are deterministic and offline-friendly.
+
+## Working Agreement
+- 1. Update task status to DOING/DONE in the sprint file and local TASKS.md.
+- 2. Review this charter and required docs before coding.
+- 3. Keep outputs deterministic (ordering, timestamps, hashes) and offline-friendly.
+- 4. Add tests for negative/error paths.
+- 5. Revert to TODO if paused; capture context in PR notes.

src/Excititor/__Tests/StellaOps.Excititor.Persistence.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Persistence Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0324-M | DONE | Maintainability audit for Excititor.Persistence.Tests. |
+| AUDIT-0324-T | DONE | Test coverage audit for Excititor.Persistence.Tests. |
+| AUDIT-0324-A | DONE | Waived (test project). |

src/Excititor/__Tests/StellaOps.Excititor.Policy.Tests/AGENTS.md

@@ -0,0 +1,23 @@
+# Excititor Policy Tests Agent Charter
+
+## Mission
+Validate Excititor policy binding, normalization, and diagnostics with deterministic fixtures.
+
+## Responsibilities
+- Cover policy binder parsing (JSON/YAML), normalization rules, and diagnostics reporting.
+- Ensure deterministic ordering and reproducible issue reporting.
+
+## Required Reading
+- docs/modules/excititor/architecture.md
+- docs/modules/excititor/trust-lattice.md
+
+## Definition of Done
+- Tests cover success and failure paths for policy provider/binder/diagnostics.
+- Fixtures avoid nondeterministic inputs (time, random) unless explicitly fixed.
+
+## Working Agreement
+- 1. Update task status to DOING/DONE in the sprint file and local TASKS.md.
+- 2. Review this charter and required docs before coding.
+- 3. Keep outputs deterministic (ordering, timestamps, hashes) and offline-friendly.
+- 4. Add tests for negative/error paths.
+- 5. Revert to TODO if paused; capture context in PR notes.

src/Excititor/__Tests/StellaOps.Excititor.Policy.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Policy Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0326-M | DONE | Maintainability audit for Excititor.Policy.Tests. |
+| AUDIT-0326-T | DONE | Test coverage audit for Excititor.Policy.Tests. |
+| AUDIT-0326-A | DONE | Waived (test project). |

src/Excititor/__Tests/StellaOps.Excititor.WebService.Tests/AGENTS.md

@@ -0,0 +1,25 @@
+# Excititor WebService Tests Agent Charter
+
+## Mission
+Validate Excititor WebService APIs, contracts, and telemetry with deterministic fixtures.
+
+## Responsibilities
+- Cover endpoint behavior, RBAC/tenant enforcement, and contract snapshots.
+- Cover airgap import, evidence/attestation endpoints, and graph overlays.
+- Keep tests deterministic and offline-friendly.
+
+## Required Reading
+- docs/modules/excititor/architecture.md
+- docs/modules/excititor/vex_observations.md
+- docs/ingestion/aggregation-only-contract.md
+
+## Definition of Done
+- Tests cover success and failure paths for key endpoints.
+- Fixtures avoid nondeterministic inputs (time, random) unless explicitly fixed.
+
+## Working Agreement
+- 1. Update task status to DOING/DONE in the sprint file and local TASKS.md.
+- 2. Review this charter and required docs before coding.
+- 3. Keep outputs deterministic (ordering, timestamps, hashes) and offline-friendly.
+- 4. Add tests for negative/error paths.
+- 5. Revert to TODO if paused; capture context in PR notes.

src/Excititor/__Tests/StellaOps.Excititor.WebService.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor WebService Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0328-M | DONE | Maintainability audit for Excititor.WebService.Tests. |
+| AUDIT-0328-T | DONE | Test coverage audit for Excititor.WebService.Tests. |
+| AUDIT-0328-A | DONE | Waived (test project). |

src/Excititor/__Tests/StellaOps.Excititor.Worker.Tests/AGENTS.md

@@ -0,0 +1,25 @@
+# Excititor Worker Tests Agent Charter
+
+## Mission
+Validate Excititor Worker orchestration, scheduling, and signature verification with deterministic fixtures.
+
+## Responsibilities
+- Cover worker options validation, retries/backoff, orchestrator client, and provider runner behavior.
+- Cover signature verification and issuer directory trust enrichment paths.
+- Keep fixtures deterministic and offline-friendly.
+
+## Required Reading
+- docs/modules/excititor/architecture.md
+- docs/modules/excititor/vex_observations.md
+- docs/modules/excititor/attestation-plan.md
+
+## Definition of Done
+- Tests cover success and failure paths for worker orchestration and signature verification.
+- Fixtures avoid nondeterministic inputs (time, random) unless explicitly fixed.
+
+## Working Agreement
+- 1. Update task status to DOING/DONE in the sprint file and local TASKS.md.
+- 2. Review this charter and required docs before coding.
+- 3. Keep outputs deterministic (ordering, timestamps, hashes) and offline-friendly.
+- 4. Add tests for negative/error paths.
+- 5. Revert to TODO if paused; capture context in PR notes.

src/Excititor/__Tests/StellaOps.Excititor.Worker.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# Excititor Worker Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0330-M | DONE | Maintainability audit for Excititor.Worker.Tests. |
+| AUDIT-0330-T | DONE | Test coverage audit for Excititor.Worker.Tests. |
+| AUDIT-0330-A | DONE | Waived (test project). |