stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 1 Releases Wiki Activity

feat: Add new projects to solution and implement contract testing documentation

Browse Source 
- Added "StellaOps.Policy.Engine", "StellaOps.Cartographer", and "StellaOps.SbomService" projects to the StellaOps solution.
- Created AGENTS.md to outline the Contract Testing Guild Charter, detailing mission, scope, and definition of done.
- Established TASKS.md for the Contract Testing Task Board, outlining tasks for Sprint 62 and Sprint 63 related to mock servers and replay testing.
This commit is contained in:
master
2025-10-27 07:57:55 +02:00
parent 935ec9aa25
commit 2b7b88ca77
355 changed files with 17276 additions and 1160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
test/contract/AGENTS.md Normal file
View File

@@ -0,0 +1,15 @@
# Contract Testing Guild Charter
## Mission
Guarantee runtime adherence to OpenAPI specifications through mock servers, replay suites, and golden example validation.
## Scope
- Generate mock servers from aggregate OAS and maintain operation examples.
- Run replay tests against staging environments to detect schema drift.
- Manage golden fixtures used for SDK examples and documentation.
- Provide tooling for PR-level contract verification.
## Definition of Done
- Mock server and replay suites run in CI gating merges.
- Golden examples kept in sync with docs and SDK snippets.
- Regression catches contract drift before release.

13
test/contract/TASKS.md Normal file
View File

@@ -0,0 +1,13 @@
# Contract Testing Task Board — Epic 17: SDKs & OpenAPI Docs
## Sprint 62 – Mock Server & Fixtures
| ID | Status | Owner(s) | Depends on | Description | Exit Criteria |
|----|--------|----------|------------|-------------|---------------|
| CONTR-62-001 | TODO | Contract Testing Guild | OAS-61-002 | Generate mock server configuration from aggregate spec; seed golden request/response fixtures. | Mock server runs locally; fixtures stored under version control; integration docs updated. |
| CONTR-62-002 | TODO | Contract Testing Guild | CONTR-62-001 | Integrate mock server tests into PR CI ensuring each operation has example coverage. | CI job added; failing on missing examples; results visible in PR checks. |
## Sprint 63 – Replay & Drift Detection
| ID | Status | Owner(s) | Depends on | Description | Exit Criteria |
|----|--------|----------|------------|-------------|---------------|
| CONTR-63-001 | TODO | Contract Testing Guild, Platform Guild | CONTR-62-002 | Build replay harness capturing staging traffic and validating against spec; enforce zero drift. | Replay suite runs nightly; failures create alerts; documentation updated. |
| CONTR-63-002 | TODO | Contract Testing Guild, Observability Guild | CONTR-63-001 | Emit metrics/logs for contract test coverage and failures. | Metrics visible in dashboards; alerts configured. |