sscoble/speckl
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Packages Wiki Activity Actions
speckl/docs
History
Scott Scoble 03de892259 docs: comprehensive KRaft protocol reference for speckl#22 
M1.1 research deliverable — detailed reference document covering:

- Complete Raft state machine (TLA+ spec): 10 actions with preconditions
- KRaft state hierarchy: 7 states (Unattached, Prospective, Candidate,
  Follower, Leader, Resigned, Detached) with per-state variables
- Detailed transition table with triggers and preconditions
- Pre-Vote protocol (KIP-996) mechanics and verification targets
- Resignation protocol (graceful leader step-down)
- 6 vanilla Raft invariants (I1-I6) formalized for Z3
- 6 KRaft-specific invariants (K1-K6) including observer consistency
- Snapshot invariants (KIP-630)
- 4 known Raft/KRaft bugs with verification targets
- 7 open verification targets for SpeckDL/Z3
- Producer acks and consumer group semantics (deferred to M1.3)
- Message types and KIP reference table
2026-05-09 21:54:09 -07:00
..
diagrams refactor: rename phases to sequential A→B→C→D 2026-04-28 21:09:42 -07:00
whitepapers feat: whitepaper sections 2-6, README overhaul, SpeckDL spec v0.1, reference agent scaffold 2026-04-28 09:33:48 -07:00
blog-01-spec-code-gap.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
blog-02-designing-speckdl.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
blog-03-compiler-architecture.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
blog-04-embedded-provenance.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
blog-05-consensus-protocols.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
distribution-strategy.md docs: distribution strategy — prioritized roadmap from Show HN to consulting 2026-05-07 21:06:35 -07:00
kraft-protocol-reference.md docs: comprehensive KRaft protocol reference for speckl#22 2026-05-09 21:54:09 -07:00
PROVE-KAFKA-PLAN.md =docs: add issue tracking table (#18-#32), close epic #17 2026-05-09 21:43:18 -07:00
publishing-toolkit.md docs: sync Phase 2 content pipeline — all 5 blog posts + publishing toolkit 2026-05-09 00:11:29 -07:00
show-hn-announcement.md docs: add Show HN announcement post draft 2026-05-06 16:06:46 -07:00
show-hn-comment-playbook.md docs: Show HN comment response playbook — 14 pre-written replies for launch day 2026-05-09 01:08:36 -07:00
show-hn-demo-script.md docs: Show HN demo script — 2-min terminal recording walkthrough for launch day 2026-05-09 07:11:50 -07:00
show-hn-launch-checklist.md docs: Show HN launch day operations checklist — minute-by-minute runbook for May 12-13 2026-05-09 02:09:22 -07:00
speckl-by-example.md docs: Speckl by Example tutorial — guided tour from ToggleSwitch to Raft 2026-05-06 15:07:22 -07:00
strategy.md refactor: rename phases to sequential A→B→C→D 2026-04-28 21:09:42 -07:00
whitepaper-v2.md Whitepaper v2 Section 8: Future Work & Roadmap (~2,900 words) 2026-05-07 01:14:24 -07:00
whitepaper.md Initial commit: Speckl project scaffold 2026-04-28 01:20:22 -07:00