paseo-bm 0.3.0-alpha.4 → 0.3.0-alpha.6

package/README.md

@@ -11,7 +11,7 @@
 
 > **Status:** prerelease (`0.3.0-alpha.*`). Command names, flags, exit codes and the `--json` shape are a public contract, but expect rough edges.
 
-## Quick start
+## Install
 
 1. Open the Paseo app so its daemon is running. You need Paseo 0.8.0 or newer with the `paseo` CLI on your PATH, Node 22 or newer, and macOS or Linux.
 2. In a terminal, run the installer and answer its questions:
@@ -24,7 +24,7 @@
 
 > **Run it, don't add it as a dependency.** `paseo-bm` is a command-line tool you run with `npx`. `npm i paseo-bm` only adds a useless dependency to your project.
 
-## Before you install
+## Limitations and warnings
 
 - **Paseo plugins run without a sandbox.** The plugin has the same access to your machine as the Paseo daemon: files, processes, credentials and network.
 - **One consent grants Paseo's agent tools to every agent on this machine**, not only to paseo-bm's roles. Any agent can then create, prompt and stop other agents, and spend money on your model providers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-bm",
-  "version": "0.3.0-alpha.4",
+  "version": "0.3.0-alpha.6",
   "description": "Beads Management for Paseo: installs the paseo-bm plugin and its agent roles",
   "type": "module",
   "license": "MIT",
@@ -12,7 +12,9 @@
   },
   "files": [
     "dist/",
-    "plugin/"
+    "plugin/",
+    "paseo-plugin.json",
+    "!plugin/images/**"
   ],
   "repository": {
     "type": "git",

package/paseo-plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "paseo-bm",
+  "requirements": {
+    "paseo": ">=0.8.0"
+  }
+}

package/plugin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hieu.nt10 (hieunt286)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugin/README.md

@@ -0,0 +1,53 @@
+# paseo-bm-plugin — the paseo-bm payload
+
+This package is the **plugin payload** of [paseo-bm](https://github.com/hieunt286/paseo-bm): the
+screens it contributes to [Paseo](https://paseo.sh) and the instructions its three agent roles run
+on. Loading it gives you **Metric** (what each request did and cost), **Beads** (the workspace's
+beads) and **Setup** (tools, skills and role instructions).
+
+![The Beads screen: totals, progress, filters and the bead list](images/01-beads-screen.jpg)
+
+## Install paseo-bm with `npx paseo-bm`
+
+```bash
+npx paseo-bm
+```
+
+That is the supported install, and it is what you want. The installer copies this payload to a
+stable path, registers it with the Paseo daemon, **registers the three agent roles** `bm-manager`,
+`bm-worker` and `bm-reviewer`, and asks for the consent those roles need.
+
+## Limitations of installing this package directly
+
+You can point Paseo at this payload on its own:
+
+```bash
+# Paseo 0.9 and newer — npm source
+paseo plugin add npm:paseo-bm-plugin@<version>
+
+# Paseo 0.8 — Git source; 0.8 has no npm source type
+paseo plugin add hieunt286/paseo-bm --ref <commit> --path plugin
+```
+
+Either way the plugin **loads and the screens appear, but the three agent roles are missing**,
+because the installer registers them, not the payload. Without those roles the Beads Manager cannot
+create a Worker, so the product does not work end to end. Use `npx paseo-bm` instead.
+
+Everything else worth knowing before you install — what paseo-bm writes on your machine, that Paseo
+plugins run without a sandbox, and that the Worker runs without permission prompts — is in
+[GUIDE.md](https://github.com/hieunt286/paseo-bm/blob/main/GUIDE.md#before-you-install-read-these-warnings).
+
+## Versions
+
+This package always carries the same version as the `paseo-bm` CLI, published from the same commit
+in the same release.
+
+## Documentation
+
+- [Repository and README](https://github.com/hieunt286/paseo-bm#readme)
+- [GUIDE.md](https://github.com/hieunt286/paseo-bm/blob/main/GUIDE.md) — requirements, install options, the screens, commands, exit codes, troubleshooting
+- [Guided tour](https://paseo-bm.erai.pro)
+
+## License
+
+MIT, see [LICENSE](LICENSE).

package/plugin/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "paseo-bm-plugin",
+  "version": "0.3.0-alpha.6",
+  "description": "Beads Management for Paseo — the plugin payload: the Metric, Beads and Setup screens plus the agent role instructions. Install with npx paseo-bm, which also registers the three agent roles.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hieunt286/paseo-bm.git",
+    "directory": "plugin"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "paseo-plugin.json",
+    "index.client.tsx",
+    "index.server.ts",
+    "client/",
+    "server/",
+    "shared/",
+    "roles/",
+    "tsconfig.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "paseo",
+    "paseo-plugin",
+    "beads"
+  ]
+}

package/plugin/shared/version.ts

@@ -3,4 +3,4 @@
 // which the build runs before packing. Design ref: docs/design/paseo-bm.md §2.4.
 
 /** Version of the paseo-bm payload, baked in at build time. */
-export const PLUGIN_VERSION = "0.3.0-alpha.4";
+export const PLUGIN_VERSION = "0.3.0-alpha.6";