@omercnet/paseo-beads 1.2.1-next.241.1 → 1.2.1

package/OVERVIEW.md

@@ -1,4 +1,4 @@
-Paseo Beads shows a read-only work queue from Beads for each workspace. Active issues are sorted into Ready, In progress, Blocked and Other lanes, with search, filters and a detail view showing description, acceptance criteria, dependencies and dependents. It adds a **Beads** Explorer panel and a Command Center item. It also adds a **Ready beads** sidebar row that counts ready work across the host's workspaces, plus a linkable screen for a single bead.
+Paseo Beads shows a read-only work queue from Beads for each workspace. Active issues are sorted into Ready, In progress, Blocked and Other lanes, with search, filters and a detail view showing description, acceptance criteria, dependencies and dependents. It adds a **Beads** Explorer panel and a Command Center item. On Paseo 0.11 and newer it also adds a **Ready beads** sidebar row that counts ready work across the host's workspaces, plus a linkable screen for a single bead.
 
 The plugin runs the `bd` CLI with `--readonly` in the workspace directory on the daemon host. It never reads or writes Beads storage directly, and it cannot create, edit, close or assign issues.
 
@@ -11,4 +11,4 @@ Limits:
 
 - Shows at most 500 issues per workspace and warns when counts may be incomplete.
 - The **Ready beads** count covers the first 200 workspaces and can lag while the app is in the background.
-- Requires Paseo ^0.11.0.
+- Requires Paseo ^0.9.0, ^0.10.0 or ^0.11.0. The sidebar row and bead screen need 0.11.

package/README.md

@@ -4,7 +4,8 @@ A dependency-aware Beads work queue for every Paseo workspace. Paseo Beads turns
 a read-only delivery view that makes the ready frontier, work in progress, and blockers immediately
 visible.
 
-It adds a workspace-scoped **Beads** Explorer panel and an **Open Beads** Command Center item. It also adds a **Ready beads** sidebar row and a linkable bead screen.
+It adds a workspace-scoped **Beads** Explorer panel and an **Open Beads** Command Center item. On
+Paseo 0.11 and newer it also adds a **Ready beads** sidebar row and a linkable bead screen.
 
 ## Demo
 
@@ -36,7 +37,7 @@ verified the rendered page contained no private organization names.
   layouts.
 - A virtualized issue list, descriptive accessibility labels, and focus restoration when navigating
   between the compact list and detail view.
-- A **Ready beads** sidebar row with the number of ready beads across the
+- On Paseo 0.11 and newer, a **Ready beads** sidebar row with the number of ready beads across the
   host's workspaces. Pressing it opens a popover (a bottom sheet in compact layouts) with the top 10
   ready beads grouped by workspace. Pressing a bead opens its detail view as a screen whose URL
   carries the workspace and bead IDs, so it can be linked and survives a reload.
@@ -81,7 +82,7 @@ still running starts no further workspace reads.
 
 ## Limits
 
-- Paseo `^0.11.0` with plugins enabled is required.
+- Paseo `^0.9.0 || ^0.10.0 || ^0.11.0` with plugins enabled is required.
 - Beads `bd` 1.0 or newer must be available on the Paseo daemon's `PATH`.
 - A Beads project must be initialized in the workspace for issue data to appear.
 - CLI calls time out after 10 seconds and accept at most 8 MiB of output. Unexpected CLI details stay
@@ -95,7 +96,8 @@ still running starts no further workspace reads.
   project, request failures, and missing issue details.
 - This plugin is read-only and workspace-scoped. It uses the `bd` CLI exclusively and does not
   create, edit, close, or assign issues.
-- The **Ready beads** row and the bead screen use the Paseo 0.11 screen and sidebar APIs.
+- The **Ready beads** row and the bead screen need Paseo 0.11. On 0.9 and 0.10 they do not register,
+  and the panel and Command Center items work as before.
 - The **Ready beads** count covers the first 200 workspaces the host lists and, like the panel, the
   first 500 issues of each workspace. It refreshes about every two minutes while the app is in the
   foreground, plus the time a scan takes, and when the popover opens, so it can be older after the
@@ -115,7 +117,7 @@ From npm:
 paseo plugin install npm:@omercnet/paseo-beads
 ```
 
-Update the installed npm package with:
+With Paseo 0.9.0 or 0.10.1, update the installed npm package with:
 
 ```bash
 paseo plugin update paseo-beads
@@ -125,7 +127,8 @@ Paseo shows the installed and proposed revisions and asks for approval before ap
 update. Review the source changes before approving them.
 
 Open a workspace, choose **New tab** in Explorer, then select **Beads**. You can also run **Open
-Beads** from the Command Center while viewing a workspace or one of its agents. Press **Ready beads** in the sidebar for ready work across every workspace on the host.
+Beads** from the Command Center while viewing a workspace or one of its agents. On Paseo 0.11 and
+newer, press **Ready beads** in the sidebar for ready work across every workspace on the host.
 
 ## Develop
 

package/index.client.tsx

@@ -32,20 +32,25 @@ export default function contribute(client: PluginClientContext) {
       openPanel("beads");
     },
   });
-  const removeScreen = client.addScreen({
-    id: BEAD_SCREEN_ID,
-    title: (params) => parseBeadScreenParams(params)?.issueId ?? "Bead",
-    Component: BeadScreen,
-  });
-  const removeReadyBeads = client.addSidebarHeaderItem({
-    id: "ready-beads",
-    title: "Ready beads",
-    Component: ReadyBeadsItem,
-  });
+  // Paseo 0.11 added screens and sidebar header items. 0.9 and 0.10 keep the panel and commands.
+  const removeReadyBeads =
+    typeof client.addScreen === "function" && typeof client.addSidebarHeaderItem === "function"
+      ? [
+          client.addScreen({
+            id: BEAD_SCREEN_ID,
+            title: (params) => parseBeadScreenParams(params)?.issueId ?? "Bead",
+            Component: BeadScreen,
+          }),
+          client.addSidebarHeaderItem({
+            id: "ready-beads",
+            title: "Ready beads",
+            Component: ReadyBeadsItem,
+          }),
+        ]
+      : [];
 
   return () => {
-    removeReadyBeads();
-    removeScreen();
+    for (const remove of removeReadyBeads) remove();
     removeAgentCommand();
     removeWorkspaceCommand();
     removePanel();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-beads",
-  "version": "1.2.1-next.241.1",
+  "version": "1.2.1",
   "type": "module",
   "description": "A dependency-aware Beads work queue for each Paseo workspace.",
   "license": "MIT",
@@ -50,10 +50,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/cli": "0.11.1",
-    "@getpaseo/client": "0.11.1",
-    "@getpaseo/plugin": "0.11.1",
-    "@getpaseo/protocol": "0.11.1",
+    "@getpaseo/cli": "0.11.0-beta.5",
+    "@getpaseo/client": "0.11.0-beta.5",
+    "@getpaseo/plugin": "0.11.0-beta.5",
+    "@getpaseo/protocol": "0.11.0-beta.5",
     "@tanstack/react-query": "^5.102.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.18",

package/paseo-plugin.json

@@ -1,5 +1,5 @@
 {
   "id": "paseo-beads",
   "description": "A dependency-aware Beads work queue for each Paseo workspace.",
-  "requirements": { "paseo": "^0.11.0" }
+  "requirements": { "paseo": "^0.9.0 || ^0.10.0 || ^0.11.0" }
 }