Files
seaweedfs/sw-block/design
pingqiuandClaude Opus 4.6 4c7fbefe25 feat: CP13-8 PASSES — real-workload validation on RF=2 sync_all
CP13-8 scenario results on m01/M02 (25Gbps RoCE):
  fsck_ext4:       CLEAN
  file count:      200 (assert_equal PASS)
  checksum match:  MATCH (assert_contains PASS)
  pgbench TPS:     565.69 (assert_greater PASS)
  auto-failover:   10.0.0.1:18480 → 10.0.0.3:18480

Code changes (tester + scenario):
- volume_server_block.go: readiness state, assignment lifecycle cleanup
- block_heartbeat_loop.go: readiness-aware heartbeat reporting
- store_blockvol.go: readiness tracking
- master_server_handlers_block.go: block API handler updates
- cp13-8-real-workload-validation.yaml: redesigned scenario
  (removed block_promote, use natural auto-failover flow,
  bootstrap write before wait_volume_healthy)
- testrunner/actions/devops.go: scenario action improvements
- replica_read_test.go: component-level replica read test

Phase docs: CP13-7 accepted, CP13-8/8A technical packs updated,
design docs updated for protocol closure evidence.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 14:24:13 -07:00
..

V2 Design

This directory now keeps the current design and process entrypoints for the active V2 line.

Historical planning/review documents were moved to ../docs/archive/design/ to keep this directory smaller and easier to navigate.

Read First

  • v2-protocol-truths.md
  • v2-protocol-claim-and-evidence.md
  • v2-product-completion-overview.md
  • v2-phase-development-plan.md
  • v2-semantic-methodology.zh.md
  • v2-protocol-closure-map.zh.md
  • v2-algorithm-overview.md
  • v2-algorithm-overview.zh.md
  • v2-detailed-algorithm.zh.md

Active Process / Workflow

  • protocol-development-process.md
  • agent_dev_process.md

Active Supporting Design

  • v2-acceptance-criteria.md
  • v2-open-questions.md
  • v2_scenarios.md
  • v2-scenario-sources-from-v1.md
  • v1-v15-v2-comparison.md
  • v2-reuse-replacement-boundary.md
  • wal-replication-v2.md
  • wal-replication-v2-state-machine.md
  • wal-replication-v2-orchestrator.md
  • wal-v2-tiny-prototype.md
  • wal-v1-to-v2-mapping.md
  • v2-dist-fsm.md

Historical / Archived

See ../docs/archive/design/README.md for archived:

  • old roadmaps
  • first-slice planning docs
  • passed readiness/slicing reviews
  • phase-specific design maps for closed phases

Execution Note

  • active development tracking lives under ../.private/phase/
  • current phase contract and slice packages live there rather than in this directory

The original project-level copies under learn/projects/sw-block/design/ remain as shared references for now.