Files
seaweedfs/sw-block/design/README.md
T
pingqiuandClaude Opus 4.6 c7eb87c587 feat: Phase 09 — V2 execution primitives and production closure
Engine execution layer for V2 replication protocol:
- RebuildInstaller: full state handoff (dirty map, WAL, superblock, flusher)
- TruncateToLSN: exact safety predicate (checkpointLSN == truncateLSN),
  ErrTruncationUnsafe escalation to NeedsRebuild
- SyncReceiverProgress: unconditional Store for post-rebuild alignment
- V2StatusSnapshot: CommittedLSN = nextLSN-1 for sync_all

V2 bridge real I/O executors:
- TransferFullBase: TCP streaming + RebuildInstaller + second catch-up
- TransferSnapshot: SHA-256 verified streaming to disk
- TruncateWAL: ErrTruncationUnsafe detection + escalation
- StreamWALEntries: rebuild-mode TCP apply

Engine executor interfaces:
- CatchUpIO.TruncateWAL, RebuildIO.TransferFullBase returns achievedLSN
- CatchUpExecutor truncation-only skip, NeedsRebuild escalation
- RebuildExecutor uses achievedLSN for progress tracking

Design docs reorganized: superseded planning docs removed, protocol
truths and closure map added.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 16:25:23 -07:00

52 lines
1.4 KiB
Markdown

# 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-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`
- `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.