mirror of
https://github.com/seaweedfs/seaweedfs.git
synced 2026-08-01 21:06:33 +00:00
pingqiuandClaude Opus 4.6
c7eb87c587
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>
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.mdv2-product-completion-overview.mdv2-phase-development-plan.mdv2-semantic-methodology.zh.mdv2-protocol-closure-map.zh.mdv2-algorithm-overview.mdv2-algorithm-overview.zh.mdv2-detailed-algorithm.zh.md
Active Process / Workflow
protocol-development-process.mdagent_dev_process.md
Active Supporting Design
v2-acceptance-criteria.mdv2-open-questions.mdv2_scenarios.mdv2-scenario-sources-from-v1.mdv1-v15-v2-comparison.mdwal-replication-v2.mdwal-replication-v2-state-machine.mdwal-replication-v2-orchestrator.mdwal-v2-tiny-prototype.mdwal-v1-to-v2-mapping.mdv2-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.