Restructure solution layout by module

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

@@ -0,0 +1,25 @@
+# AGENTS
+## Role
+ASP.NET Minimal API surface for Excititor ingest, provider administration, reconciliation, export, and verification flows.
+## Scope
+- Program bootstrap, DI wiring for connectors/normalizers/export/attestation/policy/storage.
+- HTTP endpoints `/excititor/*` with authentication, authorization scopes, request validation, and deterministic responses.
+- Job orchestration bridges for Worker hand-off (when co-hosted) and offline-friendly configuration.
+- Observability (structured logs, metrics, tracing) aligned with StellaOps conventions.
+## Participants
+- StellaOps.Cli sends `excititor` verbs to this service via token-authenticated HTTPS.
+- Worker receives scheduled jobs and uses shared infrastructure via common DI extensions.
+- Authority service provides tokens; WebService enforces scopes before executing operations.
+## Interfaces & contracts
+- DTOs for ingest/export requests, run metadata, provider management.
+- Background job interfaces for ingest/resume/reconcile triggering.
+- Health/status endpoints exposing pull/export history and current policy revision.
+## In/Out of scope
+In: HTTP hosting, request orchestration, DI composition, auth/authorization, logging.
+Out: long-running ingestion loops (Worker), export rendering (Export module), connector implementations.
+## Observability & security expectations
+- Enforce bearer token scopes, enforce audit logging (request/response correlation IDs, provider IDs).
+- Emit structured events for ingest runs, export invocations, attestation references.
+- Provide built-in counters/histograms for latency and throughput.
+## Tests
+- Minimal API contract/unit tests and integration harness will live in `../StellaOps.Excititor.WebService.Tests`.