up

src/StellaOps.Vexer.WebService/AGENTS.md

@@ -0,0 +1,25 @@
+# AGENTS
+## Role
+ASP.NET Minimal API surface for Vexer ingest, provider administration, reconciliation, export, and verification flows.
+## Scope
+- Program bootstrap, DI wiring for connectors/normalizers/export/attestation/policy/storage.
+- HTTP endpoints `/vexer/*` 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 `vexer` 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.Vexer.WebService.Tests`.

src/StellaOps.Vexer.WebService/TASKS.md

@@ -0,0 +1,7 @@
+If you are working on this file you need to read docs/ARCHITECTURE_VEXER.md and ./AGENTS.md).
+# TASKS
+| Task | Owner(s) | Depends on | Notes |
+|---|---|---|---|
+|VEXER-WEB-01-001 – Minimal API bootstrap & DI|Team Vexer WebService|VEXER-CORE-01-003, VEXER-STORAGE-01-003|TODO – Scaffold ASP.NET host, register connectors/normalizers via plugin loader, bind policy/storage/attestation services, and expose `/vexer/status`.|
+|VEXER-WEB-01-002 – Ingest & reconcile endpoints|Team Vexer WebService|VEXER-WEB-01-001|TODO – Implement `/vexer/init`, `/vexer/ingest/run`, `/vexer/ingest/resume`, `/vexer/reconcile` with token scope enforcement and structured run telemetry.|
+|VEXER-WEB-01-003 – Export & verify endpoints|Team Vexer WebService|VEXER-WEB-01-001, VEXER-EXPORT-01-001, VEXER-ATTEST-01-001|TODO – Add `/vexer/export`, `/vexer/export/{id}`, `/vexer/export/{id}/download`, `/vexer/verify`, returning artifact + attestation metadata with cache awareness.|