Files
git.stella-ops.org/docs/implplan/SPRINT_0161_0001_0001_evidencelocker.md
master e91da22836
Some checks failed
api-governance / spectral-lint (push) Has been cancelled
Docs CI / lint-and-preview (push) Has been cancelled
feat: Add new provenance and crypto registry documentation
- Introduced attestation inventory and subject-rekor mapping files for tracking Docker packages.
- Added a comprehensive crypto registry decision document outlining defaults and required follow-ups.
- Created an offline feeds manifest for bundling air-gap resources.
- Implemented a script to generate and update binary manifests for curated binaries.
- Added a verification script to ensure binary artefacts are located in approved directories.
- Defined new schemas for AdvisoryEvidenceBundle, OrchestratorEnvelope, ScannerReportReadyPayload, and ScannerScanCompletedPayload.
- Established project files for StellaOps.Orchestrator.Schemas and StellaOps.PolicyAuthoritySignals.Contracts.
- Updated vendor manifest to track pinned binaries for integrity.
2025-11-18 23:47:13 +02:00

7.1 KiB

Sprint 0161_0001_0001 · EvidenceLocker

Topic & Scope

  • Advance 160.A EvidenceLocker stream: finalize bundle packaging, replay ingest/retention, CLI/ops readiness, and sovereign crypto routing.
  • Produce ready-to-execute task definitions that unblock downstream ExportCenter/TimelineIndexer once upstream schemas land.
  • Working directory: docs/implplan (coordination for EvidenceLocker; code lives in src/EvidenceLocker & CLI modules tracked elsewhere).

Dependencies & Concurrency

  • Upstream: AdvisoryAI evidence bundle schema + payload notes (Sprint 110.A); Orchestrator/Notifications capsule schemas (Sprint 150.A / 140); Replay Ledger rules in docs/replay/DETERMINISTIC_REPLAY.md; crypto audit docs/security/crypto-routing-audit-2025-11-07.md.
  • Concurrency: runs alongside Sprint 160 coordination; blocks ExportCenter (Sprint 162/163) and TimelineIndexer (Sprint 165) until manifests/envelopes freeze.
  • Ready signals required before DOING: (1) AdvisoryAI schema freeze, (2) Orchestrator envelopes freeze, (3) crypto registry plan approved at 2025-11-18 review.

Documentation Prerequisites

  • docs/modules/evidence-locker/architecture.md
  • docs/modules/evidence-locker/bundle-packaging.md
  • docs/modules/evidence-locker/incident-mode.md
  • docs/replay/DETERMINISTIC_REPLAY.md
  • docs/runbooks/replay_ops.md
  • docs/security/crypto-routing-audit-2025-11-07.md
  • docs/events/orchestrator-scanner-events.md
  • docs/modules/cli/architecture.md

Delivery Tracker

# Task ID Status Key dependency / next step Owners Task Definition
0 ADV-ORCH-SCHEMA-LIB-161 DONE Shared models published with draft evidence bundle schema v0 and orchestrator envelopes; ready for downstream wiring. AdvisoryAI Guild · Orchestrator/Notifications Guild · Platform Guild Publish versioned package + fixtures to /src/__Libraries (or shared NuGet) so downstream components can consume frozen schema.
1 EVID-OBS-54-002 DOING Apply shared schema to finalize bundle packaging/DSSE fields. Evidence Locker Guild Finalize deterministic bundle packaging + DSSE layout per docs/modules/evidence-locker/bundle-packaging.md, including portable/incident modes.
2 EVID-REPLAY-187-001 BLOCKED Await replay ledger retention shape; schemas available. Evidence Locker Guild · Replay Delivery Guild Implement replay bundle ingestion + retention APIs; update storage policy per docs/replay/DETERMINISTIC_REPLAY.md.
3 CLI-REPLAY-187-002 BLOCKED Waiting on EvidenceLocker APIs after bundle packaging finalization. CLI Guild Add CLI scan --record, verify, replay, diff with offline bundle resolution; align golden tests.
4 RUNBOOK-REPLAY-187-004 BLOCKED Depends on retention APIs + CLI behavior. Docs Guild · Ops Guild Publish /docs/runbooks/replay_ops.md coverage for retention enforcement, RootPack rotation, verification drills.
5 CRYPTO-REGISTRY-DECISION-161 DONE Decision recorded in docs/security/crypto-registry-decision-2025-11-18.md; publish contract defaults. Security Guild · Evidence Locker Guild Capture decision from 2025-11-18 review; emit changelog + reference implementation for downstream parity.
6 EVID-CRYPTO-90-001 TODO Apply registry defaults and wire ICryptoProviderRegistry into EvidenceLocker paths. Evidence Locker Guild · Security Guild Route hashing/signing/bundle encryption through ICryptoProviderRegistry/ICryptoHash for sovereign crypto providers.

Action Tracker

Action Owner(s) Due Status
Capture AdvisoryAI + orchestrator schema deltas into this sprint and attach sample payloads. Evidence Locker Guild 2025-11-15 BLOCKED (schemas not yet delivered)
Draft Replay Ledger API + CLI notes to unblock EVID-REPLAY-187-001/002. Evidence Locker Guild · Replay Delivery Guild 2025-11-16 BLOCKED (awaiting schema signals)
Validate ICryptoProviderRegistry plan at readiness review. Evidence Locker Guild · Security Guild 2025-11-18 Pending

Interlocks & Readiness Signals

Dependency Impacts Status / Next signal
AdvisoryAI evidence bundle schema & payload notes (Sprint 110.A) EVID-OBS-54-002, EVID-REPLAY-187-001/002 Pending; expected at 2025-11-14 stand-up. Required before DOING.
Orchestrator + Notifications capsule schema (docs/events/orchestrator-scanner-events.md) All tasks Pending; expected 2025-11-15 handoff. Required before DOING.
Sovereign crypto readiness review EVID-CRYPTO-90-001 Scheduled 2025-11-18; blocks sovereign routing.
Replay Ledger spec alignment (docs/replay/DETERMINISTIC_REPLAY.md) EVID-REPLAY-187-001/002, RUNBOOK-REPLAY-187-004 Sections 2,8,9 must be reflected once schemas land.

Decisions & Risks

Item Status / Decision Notes
Schema readiness BLOCKED Waiting on AdvisoryAI + orchestrator envelopes; no DOING until frozen.
Crypto routing approval DONE Defaults recorded in docs/security/crypto-registry-decision-2025-11-18.md; implement in EvidenceLocker/CLI.
Template & filename normalization DONE (2025-11-17) Renamed to SPRINT_0161_0001_0001_evidencelocker.md; structure aligned to sprint template.

Risk table

Risk Severity Mitigation / Owner
AdvisoryAI schema slips past 2025-11-14, delaying DSSE manifest freeze. High AdvisoryAI Guild to provide interim sample payloads; EvidenceLocker to stub adapters.
Orchestrator/Notifications schema handoff misses 2025-11-15. High Escalate to Wave 150/140; keep tasks BLOCKED and schedule daily stand-ups until envelopes land.
Sovereign crypto routing design not ready by 2025-11-18. Medium Security to publish reference implementation; EvidenceLocker to nominate fallback providers.
Replay Ledger alignment drifts from CLI behavior. Medium Sync docs/runbooks with CLI/EvidenceLocker changes once schemas land; add deterministic test cases.

Execution Log

Date (UTC) Update Owner
2025-11-12 Snapshot captured (pre-template) with tasks TODO. Planning
2025-11-17 Normalized sprint to standard template, renamed file, and set all tasks BLOCKED pending schemas/crypto review. Implementer
2025-11-18 Added ADV-ORCH-SCHEMA-LIB-161 and CRYPTO-REGISTRY-DECISION-161 tasks; marked downstream items blocked on them. Project PM
2025-11-18 Set ADV-ORCH-SCHEMA-LIB-161 and CRYPTO-REGISTRY-DECISION-161 to DOING; drafting shared models package and crypto decision record. Implementer
2025-11-18 Shared models updated with draft evidence bundle schema v0; ADV-ORCH-SCHEMA-LIB-161 set to DONE and downstream tasks unblocked. Implementer
2025-11-18 Recorded crypto registry decision in docs/security/crypto-registry-decision-2025-11-18.md; moved CRYPTO-REGISTRY-DECISION-161 to DONE and unblocked EVID-CRYPTO-90-001. Implementer
2025-11-18 Started EVID-OBS-54-002 DOING using shared schema draft. Implementer
2025-11-18 Started EVID-OBS-54-002 with shared schema; replay/CLI remain pending ledger shape. Implementer