36 lines
2.8 KiB
Markdown
36 lines
2.8 KiB
Markdown
# 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.
|