saymrwulf/crisis
1
0
Fork 0
mirror of https://github.com/saymrwulf/crisis.git synced 2026-05-14 20:37:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Crisis BFT consensus protocol — Go PoC, Python recorder, and CrisisViz: a native macOS scrubbable curriculum visualizer (10 chapters, ~18 minutes at 1×, signed-speed slider with reverse playback).
28 commits 1 branch 0 tags 15 MiB
Swift 65.8%
Python 33.6%
Shell 0.6%
Find a file
saymrwulf 2d7466fe93 Add MIT LICENSE; align pyproject.toml accordingly 
The repo had no LICENSE file and pyproject.toml claimed CC-BY-4.0
— a license that isn't designed for code and conflicts with the
project's actual intent of letting people fork, learn from, and
redistribute the implementation. The paper itself remains CC-BY-4.0
as a separately licensed artifact; that fact is now stated in the
LICENSE file and in the parent README.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-14 15:51:19 +02:00
CrisisViz Ch08 erasure shards: migrate to serial timeline + per-cast vaults 2026-05-07 22:30:29 +02:00
src/crisis Masterclass redesign: cast lifelines, narrative invariants, video harness 2026-05-06 19:11:36 +02:00
tests Initial implementation of the Crisis protocol (Richter, 2019) 2026-04-23 13:20:30 +02:00
.gitignore Add macOS .app bundle with native Dock icon and activation policy 2026-04-30 20:21:18 +02:00
Crisis.mirco-richter-2019.pdf Initial implementation of the Crisis protocol (Richter, 2019) 2026-04-23 13:20:30 +02:00
crisis_data.json Add JSON export pipeline + event recorder for visualization 2026-04-30 20:06:21 +02:00
LICENSE Add MIT LICENSE; align pyproject.toml accordingly 2026-05-14 15:51:19 +02:00
pyproject.toml Add MIT LICENSE; align pyproject.toml accordingly 2026-05-14 15:51:19 +02:00
README.md Add README — Crisis PoC + educational visualizer 2026-05-08 16:28:02 +02:00

README.md

crisis

A proof-of-concept and educational artifact for Mirco Richter's Crisis paper — a DAG-based BFT consensus protocol with a data-availability layer.

This repo contains:

  • a small Go PoC of the protocol (src/, tests/),
  • a Python recorder that exports a simulation run to JSON (pyproject.toml),
  • CrisisViz — a native macOS / SwiftUI curriculum visualizer that walks the protocol end to end across ten chapters: cast intro, gossip mechanics, partition, round derivation, virtual voting, leader election, total order, the data-availability problem, erasure-coded recovery, and Byzantine fork detection.

Everything is in extreme slow motion and serialized for didactic clarity. A signed speed slider scrubs the chapter forward and backward at any rate from −16× to +16×; narration in the overlay is bound to whichever beat the playhead is on.

Build:

cd CrisisViz
swift build              # dev binary
./bundle.sh              # produce CrisisViz.app + open
swift run CrisisViz --testbed   # PNG sweep + invariant + MP4 harness

The viewer is the master of time. Pull the slider.