cgcardona / muse public
feat main

feat: comprehensive docs, scaffold plugin, and muse domains dashboard (#20)

Architecture docs: - Update docs/architecture/muse-vcs.md to v1.0 covering all four supercharge phases with the full protocol stack, algorithm selection table, CRDT primitive reference, and CLI command map

New guides: - docs/guide/plugin-authoring-guide.md — complete walkthrough for building a new domain plugin from Phase 1 through Phase 4, with tested code examples for every method, schema declaration, OT merge, CRDT implementation, and verification checklist - docs/guide/crdt-reference.md — deep-dive CRDT primer covering the three lattice laws, all six primitives with full API reference and concurrency examples, composition patterns, and when not to use CRDTs

Scaffold plugin: - muse/plugins/scaffold/plugin.py — fully typed, mypy-strict, Phase 1–4 capable copy-paste domain template; every method is documented with contract, args, and returns; TODO markers guide exactly what to fill in - muse/plugins/scaffold/__init__.py — package init with usage instructions

muse domains command: - muse/cli/commands/domains.py — domain plugin dashboard listing all registered domains, their Phase 1–4 capability levels, schema details, and active repo marker; --new <name> scaffolds a new plugin directory; --json emits machine-readable output for scripting - Registered scaffold plugin in registry.py so it appears in the dashboard

Tour de Force update: - docs/demo/tour-de-force-script.md — adds Acts 6–9 covering Typed Delta Algebra, Domain Schema & diff algorithms, OT merge, and CRDT semantics; new CRDT live examples, ORSet semantics demo, and updated YouTube chapter markers; original 41 steps unchanged

All: mypy clean, typing audit 0 violations, 691 tests green.

Co-authored-by: Gabriel Cardona <gabriel@tellurstori.com>

G Gabriel Cardona <cgcardona@gmail.com> · 2d ago Mar 18, 2026 · 1e566283 · parent 4e224376
← Older Oldest commit on main
All commits
Newer → Latest commit on main

Comments

0

No comments yet. Be the first to start the discussion.