Files
SeedPass/docs/dev_control_center.md
T

123 lines
4.7 KiB
Markdown

# SeedPass Dev Control Center
Last updated: 2026-03-02
Branch baseline: `beta`
This is the single source-of-truth document to decide what to work on next.
## 1) Current Health Gate
Run before starting any new slice:
```bash
git pull --rebase origin beta
PATH=".venv/bin:$PATH" scripts/run_ci_tests.sh
```
Latest verification in this session:
- `origin/beta` matched local `beta` (no new remote commits to pull).
- `scripts/run_ci_tests.sh`: PASS
- determinism gate: PASS
- full suite: `979 passed, 16 skipped`
- coverage: `85.65%`
## 2) Canonical Status Sources
Use these docs as inputs, but treat this file as the decision layer:
- TUI v2 plan: `docs/tui_v2_plan.md`
- TUI parity backlog: `docs/tui_v2_parity_backlog.md`
- TUI parity checklist: `docs/tui_v2_parity_checklist.md`
- TUI legacy parity matrix: `docs/tui_v2_legacy_parity_matrix.md`
- Cutover memo: `docs/tui_v2_cutover_decision.md`
- Security readiness: `docs/security_readiness_checklist.md`
- Supply-chain integrity: `docs/supply_chain_release_integrity.md`
- QA roadmap: `docs/agent_testing_roadmap.md`
- Agent TUI testing: `docs/ai_agent_tui_testing.md`
- KB scale validation: `docs/kb_scale_validation.md`
- Beta hardening report: `docs/beta_hardening_2026-03-02.md`
## 3) What Is Still Open
### Parity / Product
- TUI v2 legacy parity closure is now documented as complete:
- `docs/tui_v2_parity_checklist.md` (“Full legacy workflow coverage: Yes”)
- bug-bash evidence reports:
- `artifacts/agent_tui_test/20260302T135526Z/report.json`
- `artifacts/agent_tui2_test/20260302T135526Z/report.json`
### Security Readiness
- `docs/security_readiness_checklist.md` still marks:
- #4 Backup/restore integrity: **In Progress**
- #5 Nostr sync security/resilience: **In Progress**
- #7 Testing gates/quality thresholds: **In Progress**
- #8 Supply chain/release integrity: **In Progress**
- #9 Operational runbooks: **Not Started**
- #10 External audit/rollout: **Not Started**
### Supply Chain Specific
- `docs/supply_chain_release_integrity.md` remaining work:
- execute at least one tagged production release through integrity workflow and record evidence
- resolve/document exception `GHSA-wj6h-64fc-37mp`
- enforce release protection rules
- add/validate maintainer verification runbook
## 4) Recommended Next Steps (Priority Order)
1. Update cutover memo to reflect current reality and remaining concrete blockers.
2. Advance Nostr resilience validation with optional real-relay soak lane after deterministic suites.
3. Finish supply-chain readiness evidence and release-protection policy.
## 5) Next Slice Definition (Recommended Immediate Work)
### Slice A: “Post-Parity Cutover Readiness”
Deliverables:
- Keep parity docs in sync with shipped behavior and evidence.
- Raise test gates/coverage thresholds for the TUI v2 critical path.
- Capture remaining cutover blockers as explicit release criteria.
Exit criteria:
- Matrix exists, reviewed, and linked from this document.
- New tests pass in CI-equivalent run.
- Remaining parity gaps are explicit and severity-ranked.
Progress update (2026-03-02):
- Matrix added: `docs/tui_v2_legacy_parity_matrix.md`
- Managed-account session parity landed in TUI v2:
- `managed-load (optional: entry_id)`
- `managed-exit`
- service wrappers and tests added
- Nostr maintenance parity landed in TUI v2:
- `nostr-reset-sync-state`
- `nostr-fresh-namespace`
- service wrappers and tests added
- Nostr pubkey utility parity landed in TUI v2:
- `npub` (alias: `nostr-pubkey`)
- displays active profile npub (+ QR payload) in sensitive panel
- tests added for success and validation paths
- Full legacy workflow coverage closed with bug-bash evidence:
- `python scripts/ai_tui2_agent_test.py --scenario extended --verbose` => PASS
- `python scripts/ai_tui_agent_test.py --scenario extended --verbose` => PASS
- Coverage gates strengthened for TUI v2 critical path:
- `scripts/run_ci_tests.sh` now enables critical coverage gate by default.
- `scripts/check_critical_coverage.py` default thresholds now include `src/seedpass/core/api.py=85`.
- new focused gate `scripts/tui2_coverage_gate.sh` enforces:
- `src/seedpass/tui_v2/app.py >= 78%`
- `src/seedpass/core/api.py >= 85%`
- Nostr deterministic resilience suite expanded:
- new tests in `src/tests/test_nostr_resilience_failure_modes.py` cover:
- no encrypted data sync attempt
- publish-without-event fallback error handling
- preservation of relay-provided publish errors
- snapshot-missing warning path
- snapshot-fetch exception warning path
## 6) Working Rule
When priorities conflict:
1. Keep CI green.
2. Close user-visible parity gaps.
3. Raise security/testing gates.
4. Then optimize docs and process.