pi-post 0.7.0 → 0.7.1

package/README.md

@@ -1,5 +1,7 @@
 # pi-post
 
+<p align="center"><img src="demons-hero.gif" alt="pi-post" width="100%" /></p>
+
 Messages between [Pi](https://pi.dev) sessions — **delivered mid-task,
 or queued until they return**. Send briefs, findings, and handoffs
 between sessions and processes, straight into the receiving agent's
@@ -181,9 +183,28 @@ between sessions that exist, not state for sessions that don't. Messages
 carry no authority: treat "done" claims as unreviewed.
 ```
 
+## Demos
+
+Two rungs, in order:
+
+- [`demos/two-minute-tour.md`](https://github.com/vieko/pi-post/blob/main/demos/two-minute-tour.md) — every core
+  claim witnessed in isolation: wake-on-idle, queued delivery to a
+  closed session, resume with the message as first turn, process
+  senders from a plain shell. Two terminals, two minutes, near-zero
+  cost. Start here.
+- [`demos/clue-manor/`](https://github.com/vieko/pi-post/tree/main/demos/clue-manor) — the capstone: a playable
+  murder mystery run entirely over pi-post. One game-master session and
+  four to six autonomous suspects (one of them the killer) exercise the
+  whole contract composed — named sessions, hub-and-spoke relaying,
+  peer-to-peer whispers, a mid-game retire/resume through the queue, a
+  shell-timer dawn, and a false-authority decree that dies on the
+  boundary label — then render the event log as a self-contained HTML
+  report. A finished [sample run](https://github.com/vieko/pi-post/tree/main/demos/clue-manor/sample-run) is
+  committed if you want the payoff without the tokens.
+
 ## Design
 
-See [DESIGN.md](DESIGN.md) for the address and message contracts, delivery
+See [DESIGN.md](https://github.com/vieko/pi-post/blob/main/DESIGN.md) for the address and message contracts, delivery
 semantics, and invariants. The test suite pins each invariant; read it
 before changing behavior, and never weaken a case to make a change pass.
 
@@ -225,6 +246,10 @@ bin/
                deliberately and pinned by test/cli.test.ts)
 ```
 
+## Credits
+
+Animation by [Jon Romero Ruiz](https://x.com/jonroru).
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-post",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Messages between pi sessions — delivered mid-task or queued until they return.",
   "keywords": [
     "pi-package",