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

docs(ops): Complete operations runbooks for Epic 3500

Browse Source 
Sprint 3500.0004.0004 (Documentation & Handoff) - T2 DONE

Operations Runbooks Added:
- score-replay-runbook.md: Deterministic replay procedures
- proof-verification-runbook.md: DSSE/Merkle verification ops
- airgap-operations-runbook.md: Offline kit management

CLI Reference Docs:
- reachability-cli-reference.md
- score-proofs-cli-reference.md
- unknowns-cli-reference.md

Air-Gap Guides:
- score-proofs-reachability-airgap-runbook.md

Training Materials:
- score-proofs-concept-guide.md

UI API Clients:
- proof.client.ts
- reachability.client.ts
- unknowns.client.ts

All 5 operations runbooks now complete (reachability, unknowns-queue,
score-replay, proof-verification, airgap-operations).
This commit is contained in:
StellaOps Bot
2025-12-20 22:30:02 +02:00
parent 09c7155f1b
commit 4b3db9ca85
13 changed files with 5630 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/implplan/SPRINT_3500_0004_0004_documentation_handoff.md
View File

@@ -42,18 +42,18 @@ Complete API reference documentation for all new endpoints.
**Assignee**: Docs Team
**Story Points**: 5
**Status**: DOING
**Status**: DONE
**Description**:
Create operational runbooks for Score Proofs and Reachability features.
**Acceptance Criteria**:
- [ ] Score replay runbook
- [ ] Proof verification runbook
- [x] Score replay runbook (`docs/operations/score-replay-runbook.md`)
- [x] Proof verification runbook (`docs/operations/proof-verification-runbook.md`)
- [x] Reachability troubleshooting runbook (`docs/operations/reachability-runbook.md`)
- [x] Unknowns queue management runbook (`docs/operations/unknowns-queue-runbook.md`)
- [ ] Air-gap operations runbook
- [x] Escalation procedures (included in both runbooks)
- [x] Air-gap operations runbook (`docs/operations/airgap-operations-runbook.md`)
- [x] Escalation procedures (included in all runbooks)
---
@@ -174,12 +174,12 @@ Complete handoff to operations and support teams.
|---|---------|--------|------------|--------|-----------------|
| 1 | T1 | DONE | — | Agent | API Reference Documentation |
| 2 | T2 | DONE | — | Agent | Operations Runbooks |
| 3 | T3 | DOING | — | Agent | Architecture Documentation |
| 4 | T4 | TODO | — | Docs Team | CLI Reference Guide |
| 5 | T5 | TODO | T1-T4 | Docs Team | Training Materials |
| 6 | T6 | TODO | T1-T5 | Docs Team | Release Notes |
| 7 | T7 | TODO | T1 | Docs Team | OpenAPI Specification Update |
| 8 | T8 | TODO | T1-T7 | Project Mgmt | Handoff Checklist |
| 3 | T3 | DONE | — | Agent | Architecture Documentation |
| 4 | T4 | DONE | — | Agent | CLI Reference Guide |
| 5 | T5 | DOING | T1-T4 | Agent | Training Materials |
| 6 | T6 | TODO | T1-T5 | Agent | Release Notes |
| 7 | T7 | TODO | T1 | Agent | OpenAPI Specification Update |
| 8 | T8 | TODO | T1-T7 | Agent | Handoff Checklist |
---
@@ -188,6 +188,11 @@ Complete handoff to operations and support teams.
| Date (UTC) | Update | Owner |
|------------|--------|-------|
| 2025-12-20 | Sprint file created. | Agent |
| 2025-12-20 | T1 DONE: Created docs/api/score-proofs-reachability-api-reference.md | Agent |
| 2025-12-20 | T2 DONE: Created 4 runbooks (score-proofs, reachability, unknowns, airgap) | Agent |
| 2025-12-20 | T3 DONE: Updated HIGH_LEVEL_ARCHITECTURE.md with sections 4A/4B/4C | Agent |
| 2025-12-20 | T4 DONE: Created 3 CLI references (score-proofs, reachability, unknowns) | Agent |
| 2025-12-20 | T5 DOING: Starting training materials | Agent |
---
@@ -201,4 +206,4 @@ Complete handoff to operations and support teams.
---
**Sprint Status**: TODO (0/8 tasks done)
**Sprint Status**: IN PROGRESS (4/8 tasks done)