# StellaOps Authority — DevEx / Platform Workstream

> **Read first:** `AGENTS.md`, `StellaOps.Authority.TODOS.md`, and this file.  
> Keep task status synced in both TODO trackers whenever items move (TODO → DOING → DONE/BLOCKED).

## Scope
- Repository scaffolding, shared configuration plumbing, sample configs, telemetry constants.  
- Provide the baseline everyone else builds on; unblock quickly, announce breaking changes on the shared channel.

## Deliverables & Checklist

| Order | Task ID | Description | Dependencies | Notes |
|-------|---------|-------------|--------------|-------|
| 1 | FND1 | Create `src/StellaOps.Authority` solution layout (Authority host, Plugins.Abstractions, Plugin.Standard stub, Auth libraries). | none | **DONE** – Solution scaffolding live with net10.0 preview defaults + project references. |
| 2 | FND2 | Update repository build props/targets for new projects; ensure analyzers + nullable + treat warnings as errors. | FND1 | **DONE** – Directory.Build props/targets extended; root `StellaOps.sln` added (root build still surfaced existing Feedser compile failures). |
| 3 | FND3 | Extend `StellaOps.Configuration` with `StellaOpsAuthorityOptions`, binder, validation stubs. | FND1 | **DONE** – Options schema + bootstrap helper + unit tests validating binding/normalisation. |
| 4 | FND4 | Publish `etc/authority.yaml.sample` (with plugin toggles) + README mention. | FND3 | **DONE** – Sample config added with env var guidance; README + quickstart updated. |
| 5 | FND5 | Register OTEL resource constants (service.name = `stellaops-authority`, etc.). | FND3 | **DONE** – Authority telemetry constants helper published for shared use. |
| 6 | PLG5 | Define plugin config directory structure (`etc/authority.plugins/*.yaml`), loader helpers, sample files. | FND3 | **DONE** – Schema + loader shipped, standard/ldap samples published. |
| 7 | OPS1 (support) | Pair with DevOps on Dockerfile/compose scaffolding to ensure directories, config names match. | FND4 | **DONE** – Provided distroless Dockerfile/compose guidance in `ops/authority/` for DevOps handoff. |

### Exit Criteria
- `dotnet build` succeeds from repo root with new projects.  
- Configuration sample + docs referenced in README/Authority TODO file.  
- Telemetry/resource constants ready for Authority Core team.  
- Plugin config loader available before Plugin Team begins feature work.

### Risks / Mitigations
- **Risk:** Build props drift. → Run `dotnet format --verify-no-changes` before handoff.  
- **Risk:** Config breaking changes mid-implementation. → Version `StellaOpsAuthorityOptions` and communicate via Slack + TODO updates.

### Coordination
- Daily async update until FND3 complete.  
- Hand off AuthorityOptions schema to all other teams once finalized (tag repository issue).  
- Keep an eye on PR queue—DevEx reviews required for structure/config changes.
