Files
seaweedfs/sw-block/.private
pingqiuandClaude Opus 4.6 edec7098e8 feat: add V2 protocol simulator and enginev2 sender/session prototype
Adds sw-block/ directory with:

- distsim: protocol correctness simulator (96 tests)
  - cluster model with epoch fencing, barrier semantics, commit modes
  - endpoint identity, control-plane flow, candidate eligibility
  - timeout events, timer races, same-tick ordering
  - session ownership tracking with ID-based stale fencing

- enginev2: standalone V2 sender/session implementation (63 tests)
  - per-replica Sender with identity-preserving reconciliation
  - RecoverySession with FSM phase transitions and session ID
  - execution APIs: BeginConnect, RecordHandshake, BeginCatchUp,
    RecordCatchUpProgress, CompleteSessionByID — all sender-authority-gated
  - recovery outcome branching: zero-gap, catch-up, needs-rebuild
  - assignment-intent orchestration with epoch fencing

- design docs: acceptance criteria, open questions, first-slice spec,
  protocol development process

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 10:38:27 -07:00
..

.private

Private working area for sw-block.

Use this for:

  • phase development notes
  • roadmap/progress tracking
  • draft handoff notes
  • temporary design comparisons
  • prototype scratch work not ready for design/ or prototype/

Recommended layout:

  • .private/phase/: phase-by-phase development notes
  • .private/roadmap/: short-term and medium-term execution notes
  • .private/handoff/: notes for sw, qa, or future sessions

Phase protocol:

  • each phase should normally have:
    • phase-xx.md
    • phase-xx-log.md
    • phase-xx-decisions.md
  • details are defined in .private/phase/README.md

Promotion rules:

  • stable vision/design docs go to ../design/
  • real prototype code stays in ../prototype/
  • .private/ is for working material, not source of truth