peeroxide-cli 0.2.0: chat subsystem, init command, dd v2 tree protocol, progress UX

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,42 @@
+## Summary
+
+<!-- 1-3 bullet points: what changed and why -->
+-
+
+<!-- Link related issues: Closes #N, Resolves #N, Fixes #N -->
+
+## Motivation
+
+<!-- Why is this change needed? What problem does it solve? Delete for trivial fixes. -->
+
+## Changes
+
+<!-- For small PRs: prose description is fine.
+     For larger PRs: use a table like the one below. -->
+
+| Crate | Change |
+|-------|--------|
+|       |        |
+
+## Public API Changes
+
+<!-- DELETE this section if no public API surface is affected.
+     If API IS affected, you MUST fill this out. -->
+
+<!-- All changes below are: [ ] Additive only (semver-compatible) / [ ] Breaking (requires maintainer approval) -->
+
+| Crate | Symbol | Change |
+|-------|--------|--------|
+|       |        |        |
+
+## Testing
+
+<!-- How was this verified? Which test suites pass? -->
+
+- [ ] `cargo test --workspace`
+- [ ] `cargo test -p peeroxide-cli --test live_commands -- --ignored`
+- [ ] `cargo clippy --workspace --all-targets -- -D warnings`
+
+## Notes
+
+<!-- Anything reviewers should pay attention to. Migration steps, known limitations, follow-up work. Delete if empty. -->

.gitignore

@@ -1,16 +1,17 @@
 /target/
 tests/node/node_modules/
+.claude
 .sisyphus/
 .vogon_poetry/
 docs/book/
 
+# ignore local MCP config file
+.mcp.json
+
 # Task artifacts — planning docs, Ralph Loop prompts, progress trackers, PR checklists.
 # These should never land in git. If you need to commit one, do it explicitly and it
 # will still be surfaced by the pre-PR artifact scan described in AGENTS.md.
-DOCS_PLAN.md
-RALPH_PROMPT.md
-REFACTOR_PLAN.md
-PR-TODOS.md
 *_PLAN.md
 *_PROMPT.md
 *_TODOS.md
+*_TODO.md

AGENTS.md

@@ -9,9 +9,9 @@ This is the root of the peeroxide workspace — a Rust implementation of the Hyp
 | `peeroxide` | High-level swarm management and topic-based peer discovery | crates.io |
 | `peeroxide-dht` | HyperDHT: Kademlia routing, Noise handshakes, hole-punching, relay | crates.io |
 | `libudx` | UDX reliable UDP transport with BBR congestion control | crates.io |
-| `peeroxide-cli` | CLI toolkit: lookup, announce, ping, cp, deaddrop | binary only |
+| `peeroxide-cli` | CLI toolkit (`peeroxide` binary): lookup, announce, ping, cp, dd, chat, init | crates.io + homebrew tap (`rightbracket/peeroxide`) |
 
-The three library crates are published to crates.io and have external users. `peeroxide-cli` is a consumer of those libraries, not a library itself.
+All four crates are published to crates.io; the `peeroxide` binary is additionally distributed as a prebuilt via the [`rightbracket/peeroxide` homebrew tap](https://github.com/Rightbracket/homebrew-peeroxide).
 
 ## Key Files
 
@@ -77,7 +77,7 @@ If you find yourself needing to change a library signature to satisfy a CLI feat
 "All tests pass" means all three suites:
 
 1. `cargo test --workspace` — unit tests, integration tests, and the Node.js local interop test (`hyperswarm_cross_language_connect`)
-2. `cargo test -p peeroxide-cli --test live_commands -- --ignored` — live public HyperDHT network tests (lookup, announce, cp, deaddrop)
+2. `cargo test -p peeroxide-cli --test live_commands -- --ignored` — live public HyperDHT network tests (lookup, announce, cp, dd)
 
 Do not mark work complete until both suites are green.
 

CONTRIBUTING.md

@@ -8,7 +8,7 @@ This project is a Rust implementation of the Hyperswarm stack, focusing on wire
 | `libudx` | Reliable UDP transport with BBR congestion control | crates.io |
 | `peeroxide-dht` | Kademlia DHT, Noise handshakes, hole-punching, relay | crates.io |
 | `peeroxide` | High-level swarm and topic-based discovery | crates.io |
-| `peeroxide-cli` | CLI toolkit: lookup, announce, ping, cp, deaddrop | crates.io (binary) |
+| `peeroxide-cli` | CLI toolkit: lookup, announce, ping, cp, dd | crates.io (binary) |
 
 ## Development Requirements