hirschauers-protocol-registry-wizard 0.1.0

Textual TUI for designing protocol registry entries with hard guardrails

Protocol Registry Wizard

A Textual TUI for designing protocol registry entries with hard guardrails.

Features

• Capture protocol identity, deployment identity, ABI sources, and subgraph wiring
• Enforce one ABI per one address for live protocol drafts
• Refuse to generate a live draft when address-local ABI coverage is incomplete
• Emit explicit validation logs and a markdown onboarding draft
• Keep metadata-only and live-protocol paths separate

Installation

pip install protocol-registry-wizard

Usage

protocol-wizard

Or run as a module:

python -m protocol_registry

Key Bindings

Binding	Action
Ctrl+Q	Quit
Ctrl+R	Refresh preview
Ctrl+G	Generate draft (JSON + markdown)
Ctrl+S	Scaffold (stub + env snippet + test + promotion patch)

Output

• Drafts: Written to docs/protocol_registry_drafts/
• Scaffolded code: Written to docs/protocol_registry_drafts/generated/

Docker

docker build -t protocol-wizard .
docker run -it -v $(pwd)/output:/app/output protocol-wizard

Development

git clone https://github.com/stratagemresearch/protocol-registry-wizard.git
cd protocol-registry-wizard
uv venv && uv pip install -e .

License

MIT