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

docs: normalize remaining docs sprint headers and logs

Browse Source
This commit is contained in:
StellaOps Bot
2025-12-05 23:59:04 +00:00
parent bf6ab6ba6f
commit dd4bb50076
4 changed files with 389 additions and 386 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
docs/implplan/SPRINT_0308_0001_0008_docs_tasks_md_viii.md
View File

@@ -1,4 +1,4 @@
# Sprint 0308-0001-0008 · Documentation & Process · Docs Tasks Md.VIII # Sprint 0308 · Documentation & Process · Docs Tasks Md.VIII
## Topic & Scope ## Topic & Scope
- Advance the Docs Tasks ladder (Md.VIII) for the policy stack: promotion, CLI, API, attestations, registry architecture, telemetry, incident/runbook, templates, and AOC guardrails. - Advance the Docs Tasks ladder (Md.VIII) for the policy stack: promotion, CLI, API, attestations, registry architecture, telemetry, incident/runbook, templates, and AOC guardrails.
@@ -45,19 +45,20 @@
## Wave Detail Snapshots ## Wave Detail Snapshots
- None yet. Add summaries per wave if/when staged deliveries are planned. - None yet. Add summaries per wave if/when staged deliveries are planned.
## Interlocks ## Execution Log
- Policy chain blocked on DOCS-POLICY-27-005 and registry schema approvals (Policy Registry Guild); API baseline schema exists (`docs/schemas/api-baseline.schema.json`) but needs registry alignment. | Date (UTC) | Update | Owner |
- Risk chain blocked on risk engine schema/API readiness and UI telemetry assets for explainability; readiness signal expected from PLLG0104. | --- | --- | --- |
| 2025-12-05 | Normalised sprint to standard template; clarified header and moved interlocks into Decisions & Risks; no task status changes. | Project Mgmt |
| 2025-12-05 | DOCS-RISK-66-001..004 and DOCS-RISK-67-001/002 delivered with schema-aligned fixtures and explainability API examples; statuses set to DONE. | Docs Guild |
## Upcoming Checkpoints ## Decisions & Risks
| Date (UTC) | Session | Goal | Owner(s) | - **Risk:** Policy chain (DOCS-POLICY-27-006..014) blocked pending DOCS-POLICY-27-005 outputs and registry schema approvals (`docs/schemas/api-baseline.schema.json` alignment). Mitigation: keep BLOCKED; request registry draft + policy studio sign-off.
| --- | --- | --- | --- | - **Risk:** Need policy studio/editor assets to unblock CLI/API/attestation docs; track via 27-006 dependencies.
| 2025-12-12 | Policy docs sync (tentative) | Confirm delivery dates for 27-006 → 27-010 chain and registry schemas. | Docs Guild · Policy/Registry Guilds | - **Decision:** Risk documentation chain (66-001..67-002) marked complete with deterministic samples; future schema changes require revisiting hashes and fixtures.
| 2025-12-15 | Risk docs readiness check | Validate risk schema/API availability to start 66-001/002 drafting. | Docs Guild · Risk Engine Guild |
## Action Tracker ## Next Checkpoints
| Item | Owner | Due | Status | - 2025-12-12 · Policy docs sync (tentative): confirm delivery dates for 27-006 → 27-010 chain and registry schemas. Owners: Docs Guild · Policy/Registry Guilds.
| --- | --- | --- | --- | - 2025-12-15 · Risk docs readiness check: validate whether further schema/API changes require doc refresh. Owners: Docs Guild · Risk Engine Guild.
| Confirm DOCS-POLICY-27-005 completion signal | Policy Guild | 2025-12-11 | OPEN | | Confirm DOCS-POLICY-27-005 completion signal | Policy Guild | 2025-12-11 | OPEN |
| Publish upstream evidence list in BLOCKED_DEPENDENCY_TREE | Docs Guild | 2025-12-11 | DONE (2025-12-05) | | Publish upstream evidence list in BLOCKED_DEPENDENCY_TREE | Docs Guild | 2025-12-11 | DONE (2025-12-05) |
| Pull registry schema/API baseline alignment for 27-008 | Policy Registry Guild | 2025-12-12 | OPEN | | Pull registry schema/API baseline alignment for 27-008 | Policy Registry Guild | 2025-12-12 | OPEN |

61
docs/implplan/SPRINT_0309_0001_0009_docs_tasks_md_ix.md
View File

@@ -1,4 +1,4 @@
# Sprint 0309_0001_0009 · Documentation & Process · Docs Tasks Md IX # Sprint 0309 · Documentation & Process · Docs Tasks Md IX
## Topic & Scope ## Topic & Scope
- Phase Md.IX of the docs ladder, covering risk UI/CLI flows, offline risk bundles, SDK overview/language guides, auth/redaction security docs, and the reachability/signals doc chain (states, callgraphs, runtime facts, weighting, UI overlays, CLI, API). - Phase Md.IX of the docs ladder, covering risk UI/CLI flows, offline risk bundles, SDK overview/language guides, auth/redaction security docs, and the reachability/signals doc chain (states, callgraphs, runtime facts, weighting, UI overlays, CLI, API).
@@ -41,43 +41,34 @@
## Wave Detail Snapshots ## Wave Detail Snapshots
- No additional wave snapshots; Delivery Tracker ordering suffices for this single-wave sprint. - No additional wave snapshots; Delivery Tracker ordering suffices for this single-wave sprint.
## Interlocks ## Execution Log
- Risk chain (DOCS-RISK-67/68) hinges on DOCS-RISK-67-002 and console/CLI asset drops; mirror blockers in `BLOCKED_DEPENDENCY_TREE.md`. | Date (UTC) | Update | Owner |
- Signals chain (DOCS-SIG-26-001..007) depends on schema/asset hand-offs from Signals, UI, and CLI guilds. | --- | --- | --- |
- SDK deliverable requires generator outputs across four languages to avoid drift between guides. | 2025-12-05 | Normalised sprint to standard template; clarified header; moved interlocks into Decisions & Risks; no task status changes. | Project Mgmt |
## Upcoming Checkpoints
| Date (UTC) | Session | Goal | Owner(s) |
| --- | --- | --- | --- |
| 2025-12-08 | Md.VIII → Md.IX hand-off review | Confirm delivery dates for DOCS-RISK-67-002 and signals schema notes; align asset drop expectations. | Docs Guild · Console Guild · Signals Guild |
| 2025-12-12 | Md.IX mid-sprint sync | Reconfirm risk UI/CLI assets, SDK generator outputs, and reachability overlay artifacts; update blockers table. | Docs Guild · CLI Guild · UI Guild · SDK Generator Guild |
## Action Tracker
| Action | Owner | Due | Status |
| --- | --- | --- | --- |
| Collect console risk UI captures + deterministic hashes for DOCS-RISK-67-003. | Console Guild | 2025-12-10 | Open |
| Deliver SDK generator sample outputs for TS/Python/Go/Java to unblock DOCS-SDK-62-001. | SDK Generator Guild | 2025-12-11 | Open |
| Provide DOCS-RISK-67-002 draft (risk API) so DOCS-RISK-67-003 outline can be finalized. | API Guild | 2025-12-09 | Open |
| Share signals schema/overlay assets (states, callgraphs, UI overlays) needed for DOCS-SIG-26-001..005. | Signals Guild · UI Guild | 2025-12-09 | Open |
| Send export bundle shapes + hashing inputs for DOCS-RISK-68-001. | Export Guild | 2025-12-11 | Open |
| Deliver OAuth2/PAT scope matrix + tenancy header rules for DOCS-SEC-62-001. | Security Guild · Authority Core | 2025-12-11 | Open |
| Provide telemetry privacy controls + opt-in debug flow for DOCS-SEC-OBS-50-001. | Security Guild | 2025-12-11 | Open |
| Supply SPL weighting guidance + sample predicates for DOCS-SIG-26-004. | Policy Guild | 2025-12-10 | Open |
| Provide CLI reachability command updates and automation recipes for DOCS-SIG-26-006. | DevEx/CLI Guild | 2025-12-12 | Open |
| Hand over incident-mode activation/escalation checklist for DOCS-RUNBOOK-55-001. | Ops Guild | 2025-12-10 | Open |
| Escalate to Guild leads if any Md.IX inputs miss their due dates (12-09..12) and re-plan dates by 2025-12-13. | Docs Guild | 2025-12-13 | Open |
| Send reminder pings to all Md.IX owning guilds 24h before due dates (start 2025-12-09). | Project Mgmt | 2025-12-09 | Open |
## Decisions & Risks ## Decisions & Risks
### Decisions - **Decision:** Keep Md.IX scope limited to risk/SDK/security/signals doc set; defer new module docs until upstream assets arrive (Docs Guild, due 2025-12-05).
| Decision | Owner(s) | Due | Notes | - **Risk:** DOCS-RISK-67-002 and console assets not yet delivered, blocking DOCS-RISK-67-003/004/68-001/68-002 chain. Mitigation: track in `BLOCKED_DEPENDENCY_TREE.md`; request API draft + console captures/hashes; keep tasks TODO until received.
| --- | --- | --- | --- | - **Risk:** Signals chain (DOCS-SIG-26-001..007) depends on schema/asset hand-offs from Signals, UI, and CLI guilds. Mitigation: maintain Action Tracker reminders; do not start without assets.
| Keep Md.IX scope limited to risk/SDK/security/signals doc set; defer new module docs until upstream assets arrive. | Docs Guild | 2025-12-05 | Prevents churn while asset/schema drops are pending. | - **Risk:** SDK deliverable requires generator outputs across four languages; drift risk if guides proceed without samples. Mitigation: block on generator outputs; cross-check hashes on arrival.
### Risks ## Next Checkpoints
| Risk | Impact | Mitigation | - 2025-12-08 · Md.VIII → Md.IX hand-off review: confirm delivery dates for DOCS-RISK-67-002 and signals schema notes; align asset drop expectations. Owners: Docs Guild · Console Guild · Signals Guild.
| --- | --- | --- | - 2025-12-12 · Md.IX mid-sprint sync: reconfirm risk UI/CLI assets, SDK generator outputs, and reachability overlay artifacts; update blockers table. Owners: Docs Guild · CLI Guild · UI Guild · SDK Generator Guild.
| DOCS-RISK-67-002 and console assets not yet delivered. | Blocks DOCS-RISK-67-003/004/68-001/68-002 chain. | Track in `BLOCKED_DEPENDENCY_TREE.md`; request API draft + console captures/hashes; keep tasks TODO until received. |
## Action Tracker
- Collect console risk UI captures + deterministic hashes for DOCS-RISK-67-003 — Console Guild — Due 2025-12-10 — Open.
- Deliver SDK generator sample outputs for TS/Python/Go/Java to unblock DOCS-SDK-62-001 — SDK Generator Guild — Due 2025-12-11 — Open.
- Provide DOCS-RISK-67-002 draft (risk API) so DOCS-RISK-67-003 outline can be finalized — API Guild — Due 2025-12-09 — Open.
- Share signals schema/overlay assets (states, callgraphs, UI overlays) needed for DOCS-SIG-26-001..005 — Signals Guild · UI Guild — Due 2025-12-09 — Open.
- Send export bundle shapes + hashing inputs for DOCS-RISK-68-001 — Export Guild — Due 2025-12-11 — Open.
- Deliver OAuth2/PAT scope matrix + tenancy header rules for DOCS-SEC-62-001 — Security Guild · Authority Core — Due 2025-12-11 — Open.
- Provide telemetry privacy controls + opt-in debug flow for DOCS-SEC-OBS-50-001 — Security Guild — Due 2025-12-11 — Open.
- Supply SPL weighting guidance + sample predicates for DOCS-SIG-26-004 — Policy Guild — Due 2025-12-10 — Open.
- Provide CLI reachability command updates and automation recipes for DOCS-SIG-26-006 — DevEx/CLI Guild — Due 2025-12-12 — Open.
- Hand over incident-mode activation/escalation checklist for DOCS-RUNBOOK-55-001 — Ops Guild — Due 2025-12-10 — Open.
- Escalate to Guild leads if any Md.IX inputs miss due dates (12-09..12) and re-plan by 2025-12-13 — Docs Guild — Due 2025-12-13 — Open.
- Send reminder pings to all Md.IX owning guilds 24h before due dates (start 2025-12-09) — Project Mgmt — Due 2025-12-09 — Open.
| Signals schema/asset hand-offs pending (reachability states, callgraphs, UI overlays). | Blocks DOCS-SIG-26-001..007 sequence. | Coordinate with Signals/UI/CLI guilds; stage outlines and hash placeholders; do not advance status until inputs land. | | Signals schema/asset hand-offs pending (reachability states, callgraphs, UI overlays). | Blocks DOCS-SIG-26-001..007 sequence. | Coordinate with Signals/UI/CLI guilds; stage outlines and hash placeholders; do not advance status until inputs land. |
| SDK generator outputs not finalized across four languages. | Delays DOCS-SDK-62-001 and downstream language guides. | Ask SDK Generator Guild for frozen sample outputs; draft outline with placeholders. | | SDK generator outputs not finalized across four languages. | Delays DOCS-SDK-62-001 and downstream language guides. | Ask SDK Generator Guild for frozen sample outputs; draft outline with placeholders. |
| Md.IX input due dates (Dec 9–12) slip without re-plan. | Pushes all Md.IX docs; risks missing sprint window. | Escalate to guild leads on 2025-12-13 and rebaseline dates; keep action tracker updated. | | Md.IX input due dates (Dec 9–12) slip without re-plan. | Pushes all Md.IX docs; risks missing sprint window. | Escalate to guild leads on 2025-12-13 and rebaseline dates; keep action tracker updated. |

18
docs/implplan/SPRINT_0310_0001_0010_docs_tasks_md_x.md
View File

@@ -1,4 +1,4 @@
# Sprint 0310_0001_0010 · Documentation & Process — Docs Tasks Md.X # Sprint 0310 · Documentation & Process — Docs Tasks Md.X
## Topic & Scope ## Topic & Scope
- Advance the tenth Docs Tasks wave (Md.X) with tenancy, reachability, scanner surface/bench, and VEX consensus documentation ready for downstream consumers. - Advance the tenth Docs Tasks wave (Md.X) with tenancy, reachability, scanner surface/bench, and VEX consensus documentation ready for downstream consumers.
@@ -52,11 +52,17 @@
- Scanner surface/bench: `/docs/modules/scanner/scanner-engine.md` and `/docs/modules/scanner/benchmarks/*.md` — frame sections for Surface.FS/Env/Secrets flow, OS coverage, language lockfiles, stripped/entrytrace/SAST enrichers. - Scanner surface/bench: `/docs/modules/scanner/scanner-engine.md` and `/docs/modules/scanner/benchmarks/*.md` — frame sections for Surface.FS/Env/Secrets flow, OS coverage, language lockfiles, stripped/entrytrace/SAST enrichers.
- Contract testing: `/docs/testing/contract-testing.md` — outline for mock server, replay fixtures, golden files, determinism guardrails. - Contract testing: `/docs/testing/contract-testing.md` — outline for mock server, replay fixtures, golden files, determinism guardrails.
## Interlocks ## Execution Log
- Tenancy docs (DOCS-TEN-47/48/49) require DVDO0110 decisions and downstream CLI/env var confirmations. | Date (UTC) | Update | Owner |
- Reachability migration guide depends on DOCS-SIG-26-007 and notifications hook readiness (058_NOTY0101). | --- | --- | --- |
- Scanner surface/bench docs depend on analyzer outputs (SCSA0301, SCSA0601), replay hooks (RPRC0101), and CLI samples (132_CLCI0110). | 2025-12-05 | Normalised sprint to standard template; clarified header; moved interlocks into Decisions & Risks; no status changes. | Project Mgmt |
- VEX consensus series depends on PLVL0102 schemas, issuer directory inputs, and DevOps rollout plans for signatures/ops.
## Decisions & Risks
- **Risk:** Tenancy docs (DOCS-TEN-47/48/49) require DVDO0110 decisions and CLI/env var confirmations; keep DOING with placeholders until ADR lands.
- **Risk:** Reachability migration guide depends on DOCS-SIG-26-007 and notifications hook readiness (058_NOTY0101); keep coordination with Signals/Notify guilds.
- **Risk:** Scanner surface/bench docs depend on analyzer outputs (SCSA0301, SCSA0601), replay hooks (RPRC0101), and CLI samples (132_CLCI0110); leave DOING skeletons until evidence delivered.
- **Risk:** VEX consensus series depends on PLVL0102 schemas, issuer directory inputs, and DevOps rollout plans for signatures/ops; block finalization on schema snapshots and rollout plan.
- **Decision:** Maintain single-wave execution; task ordering follows Delivery Tracker to preserve dependency chain determinism.
## Upcoming Checkpoints ## Upcoming Checkpoints
- 2025-12-07 15:00 UTC — 20-min skeleton-sync to align outlines and branch contents across guild writers. - 2025-12-07 15:00 UTC — 20-min skeleton-sync to align outlines and branch contents across guild writers.

31
docs/implplan/SPRINT_0311_0001_0001_docs_tasks_md_xi.md
View File

@@ -1,4 +1,4 @@
# Sprint 0311_0001_0001 · Documentation & Process · Docs Tasks Md.XI # Sprint 0311 · Documentation & Process · Docs Tasks Md.XI
## Topic & Scope ## Topic & Scope
- Phase Md.XI of the docs ladder covering Vuln Explorer + Findings Ledger: overview, console, API, CLI, ledger, policy, VEX, advisories, SBOM, observability, security, ops, and install guides. - Phase Md.XI of the docs ladder covering Vuln Explorer + Findings Ledger: overview, console, API, CLI, ledger, policy, VEX, advisories, SBOM, observability, security, ops, and install guides.
@@ -43,21 +43,26 @@
## Wave Detail Snapshots ## Wave Detail Snapshots
- Wave 1: Tasks 1–13 targeting offline-ready guides, API/CLI references, and ops runbooks for Vuln Explorer/Findings Ledger. - Wave 1: Tasks 1–13 targeting offline-ready guides, API/CLI references, and ops runbooks for Vuln Explorer/Findings Ledger.
## Interlocks ## Execution Log
- UI/CLI asset drops required for console + CLI guides. | Date (UTC) | Update | Owner |
- Policy and DevOps rollout notes needed before publishing determinations and telemetry content. | --- | --- | --- |
- Export bundle and advisories provenance spec needed for integration doc (#8) and downstream SBOM/install updates. | 2025-12-05 | Normalised sprint to standard template; clarified header; moved interlocks into Decisions & Risks; no status changes. | Project Mgmt |
## Upcoming Checkpoints ## Decisions & Risks
| Date (UTC) | Session | Goal | Owner(s) | - **Risk:** UI/CLI asset drops required for console and CLI guides (#2–#4); keep TODO until assets with hashes arrive.
| --- | --- | --- | --- | - **Risk:** Policy and DevOps rollout notes needed before publishing determinations and telemetry content (#6, #10); block until signals/simulation semantics and SLOs are provided.
| 2025-12-09 | Vuln Explorer asset drop | Deliver console screenshots, API examples, and CLI snippets for tasks #2–#4. | Vuln Explorer Guild · Docs Guild | - **Risk:** Export bundle and advisories provenance spec needed for integration doc (#8) and downstream SBOM/install updates; wait for specs before progressing.
| 2025-12-16 | Policy/DevOps sync | Confirm signals/simulation semantics and telemetry SLOs for tasks #6 and #10. | Policy Guild · DevOps Guild · Docs Guild | - **Decision:** Single-wave execution; tasks follow Delivery Tracker dependency order to keep Vuln Explorer/Findings Ledger chain coherent.
| 2025-12-20 | Publication gate | Final content review and hash manifest check before shipping Md.XI set. | Docs Guild |
## Next Checkpoints
- 2025-12-09 · Vuln Explorer asset drop: deliver console screenshots, API examples, and CLI snippets for tasks #2–#4. Owners: Vuln Explorer Guild · Docs Guild.
- 2025-12-16 · Policy/DevOps sync: confirm signals/simulation semantics and telemetry SLOs for tasks #6 and #10. Owners: Policy Guild · DevOps Guild · Docs Guild.
- 2025-12-20 · Publication gate: final content review and hash manifest check before shipping Md.XI set. Owner: Docs Guild.
## Action Tracker ## Action Tracker
| Action | Owner | Due | Status | - Collect console screenshots + CLI snippets with hashes for DOCS-VULN-29-002/003/004 — Vuln Explorer Guild — Due 2025-12-09 — Open.
| --- | --- | --- | --- | - Provide signals/simulation semantics + telemetry SLOs for DOCS-VULN-29-006/010 — Policy Guild · DevOps Guild — Due 2025-12-16 — Open.
- Deliver export bundle/advisory provenance spec for DOCS-VULN-29-008 — Concelier Guild — Due 2025-12-18 — Open.
| Collect GRAP0101 contract snapshot for Vuln Explorer overview. | Docs Guild | 2025-12-08 | In Progress | | Collect GRAP0101 contract snapshot for Vuln Explorer overview. | Docs Guild | 2025-12-08 | In Progress |
| Request export bundle spec + provenance notes for advisories integration. | Concelier Guild | 2025-12-12 | In Progress | | Request export bundle spec + provenance notes for advisories integration. | Concelier Guild | 2025-12-12 | In Progress |
| Prepare hash manifest template for screenshots/payloads under `docs/assets/vuln-explorer/`. | Docs Guild | 2025-12-10 | DONE | | Prepare hash manifest template for screenshots/payloads under `docs/assets/vuln-explorer/`. | Docs Guild | 2025-12-10 | DONE |