@sztlink/pi-ensemble 0.1.0-alpha.12 → 0.1.0-alpha.13

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.1.0-alpha.13
+
+- Added npm-first install docs now that `@sztlink/pi-ensemble` is published.
+- Expanded npm/Pi package discoverability metadata keywords.
+- Added `docs/PROMOTION.md` with public alpha framing, install snippets, and Pi gallery eligibility notes.
+
 ## v0.1.0-alpha.12
 
 - Documented neutral-root runtime usage: keep Pi/Claude in their natural runtime root and point to the canonical ledger with `PI_ENSEMBLE_ROOT` or `--root`.

package/README.md

@@ -30,10 +30,22 @@ See [`docs/QUICKSTART.md`](docs/QUICKSTART.md) for the shortest path. See [`docs
 
 ## Install
 
+### Pi package from npm (recommended)
+
+```bash
+pi install npm:@sztlink/pi-ensemble@alpha
+```
+
+Reload Pi or start a new session, then run:
+
+```txt
+/ensemble status
+```
+
 ### Pi package from GitHub
 
 ```bash
-pi install git:github.com/sztlink/pi-ensemble@v0.1.0-alpha.12
+pi install git:github.com/sztlink/pi-ensemble@v0.1.0-alpha.13
 ```
 
 Reload Pi or start a new session, then run:
@@ -55,12 +67,11 @@ pi install /absolute/path/to/pi-ensemble
 node /absolute/path/to/pi-ensemble/bin/ensemble.mjs init
 ```
 
-### npm
-
-The npm package is not published yet. Once published:
+### CLI via npm
 
 ```bash
-pi install npm:@sztlink/pi-ensemble@alpha
+npm install -g @sztlink/pi-ensemble@alpha
+ensemble --help
 ```
 
 ## CLI
@@ -131,6 +142,21 @@ See [`SECURITY.md`](SECURITY.md). In short: no network, no spawning, no command
 
 Pi can use the package extension and tool directly. Claude Code can participate directly or through a lead session that also uses Agent Teams internally. Codex and other terminal agents can participate through the same CLI/files. Tmux wakeups should remain an adapter outside the core protocol. See [`docs/ADAPTERS.md`](docs/ADAPTERS.md) and [`examples/ensemble-tmux`](examples/ensemble-tmux).
 
+## Discovery / Pi package gallery
+
+`pi-ensemble` is published to npm with the `pi-package` keyword and a `pi.extensions` manifest, so Pi can install it directly and package indexes can discover it:
+
+```bash
+pi install npm:@sztlink/pi-ensemble@alpha
+```
+
+Public alpha framing:
+
+```txt
+Local coordination ledger for Pi, Claude Code, tmux, and terminal agents.
+Not an orchestrator. Not a daemon. Just readable files for handoffs, claims, and audit.
+```
+
 ## Relationship to existing workflows
 
 `pi-ensemble` generalizes a simple bridge pattern: blackboard for durable shared facts, inboxes for handoffs, audit log for traceability. Integrations with tmux, watchers, or external dashboards should remain outside v0.1.

package/docs/PROMOTION.md

@@ -0,0 +1,72 @@
+# Promoting pi-ensemble
+
+`pi-ensemble` is useful for a narrow but real audience: people running multiple coding-agent runtimes side by side and losing context in manual handoffs.
+
+## One-line framing
+
+```txt
+Local coordination ledger for Pi, Claude Code, tmux, and terminal agents.
+```
+
+## Short framing
+
+```txt
+pi-ensemble is not an orchestrator, daemon, scheduler, or team manager.
+It is a small file-only ledger for handoffs, claims, inboxes, and audit trails across local coding agents.
+```
+
+## Who it is for
+
+- Pi users who also run Claude Code, Codex, or shell agents.
+- Developers using tmux panes/sessions for parallel agent work.
+- People who want durable local handoffs without a daemon or remote service.
+- Workflows where the human has become the copy/paste relay between agents.
+
+## Who it is not for
+
+- Users who want auto-spawning agent teams.
+- Users who want a cloud dashboard or remote queue.
+- Users who want a scheduler/supervisor.
+- Casual single-agent chat workflows.
+
+## Install snippets
+
+```bash
+pi install npm:@sztlink/pi-ensemble@alpha
+```
+
+```bash
+npm install -g @sztlink/pi-ensemble@alpha
+```
+
+```bash
+pi install git:github.com/sztlink/pi-ensemble@v0.1.0-alpha.13
+```
+
+## Demo script
+
+```bash
+ensemble init --agent pi
+ensemble send claude "Please inspect docs and reply with findings." --from pi --type question
+ensemble inbox --agent claude --since-last-read
+ensemble ack msg_xxx --from claude --body "received"
+ensemble send pi "Result: docs look good." --from claude --type result
+ensemble done msg_xxx --from pi --body "closed"
+ensemble messages --open
+ensemble doctor
+```
+
+## Pi gallery eligibility
+
+The package includes:
+
+- npm public package: `@sztlink/pi-ensemble`
+- `pi-package` keyword
+- `pi.extensions` manifest in `package.json`
+- public repository: `https://github.com/sztlink/pi-ensemble`
+
+If Pi's package gallery indexes npm packages by keyword, this package is eligible for discovery.
+
+## Notes for posts/issues
+
+Use the phrase **ledger, not orchestrator**. The value proposition is durable coordination without hidden runtime state.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sztlink/pi-ensemble",
-  "version": "0.1.0-alpha.12",
-  "description": "Shared workspace coordination for parallel coding agents",
+  "version": "0.1.0-alpha.13",
+  "description": "Local coordination ledger for Pi, Claude Code, tmux, and terminal agents",
   "type": "module",
   "repository": {
     "type": "git",
@@ -22,10 +22,15 @@
     "pi-package",
     "pi",
     "pi-coding-agent",
+    "claude-code",
+    "tmux",
+    "multi-agent",
     "coding-workflow",
     "agents",
     "coordination",
-    "blackboard"
+    "blackboard",
+    "ledger",
+    "local-first"
   ],
   "license": "MIT",
   "pi": {