Files
seaweedfs/sw-block/design/README.md
T
pingqiuandClaude Opus 4.6 44103a1bd7 feat: Phase 20 acceptance fixes + sw-test-runner suite mode
Acceptance rows closed:
- WriteLBA/SyncCache contract: code comments document write-back vs
  durability fence semantics
- RF=2 stable identity: v2bridge always uses SetReplicaAddrs (preserves
  ServerID); blockcmd dispatcher also fixed to use setupPrimaryReplicationMulti;
  test asserts exact expected ReplicaID="vs-2" (not just non-empty)
- Tests treating WriteLBA as commit: replica_read_test rewritten with
  SyncCache as durability fence
- publish_healthy contract: 3 gate tests with hard assertions including
  gate 3 (PrimaryShipperConnected)
- SetReplicaAddr deprecation warning added
- WALShipper.ReplicaID() getter added for identity verification

Test runner enhancements:
- sw-test-runner suite command: build → deploy → run N scenarios in one
  invocation with --skip-deploy support
- Suite YAML definitions for T6 Stage 0 and Stage 1
- deploy action: kill stale processes, clean dirs, cross-compile, upload
- run-phase20-t6.ps1 PowerShell script (deprecated by suite command)

Engine/runtime fixes:
- Recovery executor nil-safety improvements
- Recovery bundle BuildRecoveryBundle defensive checks
- ShipperGroup MinReplicaFlushedLSNAll surface

Docs: acceptance checklist refined, test matrix updated, T6 runbook,
engine maintainer tutorial, design README updated.

26 files changed, ~1600 insertions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 11:30:54 -07:00

1.9 KiB

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-capability-map.md
  • v2-pure-runtime-rf1-bootstrap.md
  • v2-volumev2-single-node-mvp.md
  • v2-proof-and-retest-pyramid.md
  • v2-protocol-claim-and-evidence.md
  • v2-two-loop-protocol.md
  • v2-automata-ownership-map.md
  • v2-loop1-surface-draft.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

Engine implementation (code maintainers)

  • v2-engine-maintainer-tutorial.md — how to read sw-block/engine/replication, where to add rules, host wiring checklist

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.