openplanr 2.2641.2 → 3.0.1

package/lib/host-packages/claude/openplanr/runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/16-studio-shell.js

@@ -32,6 +32,34 @@
       /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("rect", { x: "127", y: "71", width: "18", height: "18", rx: "3", fill: "currentColor" })
     ] }) }) });
   }
+  function inlineGap(element) {
+    const view = element?.ownerDocument.defaultView;
+    return view && element ? parseFloat(view.getComputedStyle(element).gap) || 0 : 0;
+  }
+  function measureLeadingFloor(leading) {
+    const view = leading.ownerDocument.defaultView;
+    if (!view) return 128;
+    const leadingControls = [...leading.children].filter(
+      (node) => node instanceof view.HTMLElement && !node.classList.contains("planr-brand") && node.getClientRects().length > 0
+    );
+    const branding = [
+      ...leading.querySelectorAll(".planr-mark,.design-wordmark")
+    ].filter((node) => node.getClientRects().length);
+    const brandGap = inlineGap(leading.querySelector(".planr-brand"));
+    const brandingWidth = branding.reduce(
+      (total, node) => total + node.getBoundingClientRect().width + brandGap,
+      0
+    );
+    const titleBlock = leading.querySelector(".planr-title-block");
+    const badge = titleBlock?.querySelector(".studio-type-badge");
+    const title = titleBlock?.querySelector("strong,.de-title");
+    const titleFloor = Math.max(36, parseFloat(view.getComputedStyle(title ?? leading).fontSize) * 3);
+    const identityFloor = Math.max(
+      128,
+      (badge?.getBoundingClientRect().width || 0) + inlineGap(titleBlock) + titleFloor
+    );
+    return identityFloor + brandingWidth + leadingControls.reduce((total, control) => total + control.getBoundingClientRect().width, 0) + leadingControls.length * inlineGap(leading);
+  }
   function StudioToolbar({
     title,
     titleNode,
@@ -44,38 +72,123 @@
     viewPicker,
     status,
     actions,
+    secondaryActions,
     className = ""
   }) {
-    return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(Tag, { className: `planr-toolbar studio-toolbar ${className}`, "data-studio-react-chrome": "true", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-toolbar-leading design-toolbar-leading", children: [
-        leading,
-        /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "planr-brand", children: [
-          brand && /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(import_jsx_runtime15.Fragment, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(StudioMark, {}),
-            /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "design-wordmark", children: [
-              "Open",
-              /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { children: "Planr" })
+    const toolbar = (0, import_react3.useRef)(null);
+    (0, import_react3.useLayoutEffect)(() => {
+      const element = toolbar.current;
+      const window2 = element?.ownerDocument.defaultView;
+      if (!element || !window2) return;
+      const center = element.querySelector(".studio-toolbar-center");
+      const trailing = element.querySelector(".studio-toolbar-trailing");
+      const leading2 = element.querySelector(".studio-toolbar-leading");
+      const secondary = element.querySelector(".studio-toolbar-secondary");
+      if (!center || !trailing || !leading2) return;
+      const measure = () => {
+        const width = element.getBoundingClientRect().width;
+        if (!width) return;
+        element.dataset.studioDensity = width <= 680 ? "narrow" : "regular";
+        const style = window2.getComputedStyle(element);
+        const available = width - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight);
+        const gap = Math.max(12, parseFloat(style.columnGap) || 0);
+        element.dataset.studioCenter = "true";
+        const centerWidth = center.scrollWidth;
+        element.dataset.studioCenter = String(centerWidth > 0);
+        const controlSelector = 'button,a,summary,input,select,output,[role="status"]';
+        const controls = [
+          ...trailing.querySelectorAll(controlSelector),
+          ...secondary?.querySelectorAll(controlSelector) ?? []
+        ].filter(
+          (control) => control.getClientRects().length && !control.closest('[role="menu"],.studio-tooltip,[role="dialog"]') && (!control.closest("details") || !!control.closest("summary")) && !control.parentElement?.closest(controlSelector)
+        );
+        const actionWidth = controls.reduce((total, control) => {
+          if (secondary?.contains(control) && control.getAttribute("role") === "status") {
+            const range = element.ownerDocument.createRange();
+            range.selectNodeContents(control);
+            const textWidth = range.getBoundingClientRect().width;
+            const controlStyle = window2.getComputedStyle(control);
+            return total + textWidth + (parseFloat(controlStyle.paddingLeft) || 0) + (parseFloat(controlStyle.paddingRight) || 0);
+          }
+          return total + control.getBoundingClientRect().width;
+        }, 0) + Math.max(0, controls.length - 1) * (parseFloat(window2.getComputedStyle(trailing).gap) || 8);
+        const leadingFloor = measureLeadingFloor(leading2);
+        const outerWidth = Math.max(leadingFloor, actionWidth);
+        element.dataset.studioLayout = centerWidth > 0 ? width <= 680 || centerWidth + outerWidth * 2 + gap * 2 > available ? "compact" : "inline" : leadingFloor + actionWidth + gap > available ? "compact" : "inline";
+      };
+      measure();
+      let frame = 0;
+      const scheduleMeasure = () => {
+        if (frame) return;
+        frame = window2.requestAnimationFrame(() => {
+          frame = 0;
+          measure();
+        });
+      };
+      const resize = typeof window2.ResizeObserver === "function" ? new window2.ResizeObserver(scheduleMeasure) : null;
+      for (const node of [element, center, trailing, secondary]) if (node) resize?.observe(node);
+      const mutations = new window2.MutationObserver(scheduleMeasure);
+      mutations.observe(element, {
+        subtree: true,
+        childList: true,
+        characterData: true,
+        attributes: true,
+        attributeFilter: ["hidden"]
+      });
+      window2.addEventListener("resize", scheduleMeasure);
+      let active = true;
+      void element.ownerDocument.fonts?.ready.then(() => {
+        if (active) scheduleMeasure();
+      });
+      return () => {
+        active = false;
+        resize?.disconnect();
+        mutations.disconnect();
+        window2.cancelAnimationFrame(frame);
+        window2.removeEventListener("resize", scheduleMeasure);
+      };
+    }, [Tag]);
+    return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(
+      Tag,
+      {
+        ref: (node) => {
+          toolbar.current = node;
+        },
+        className: `planr-toolbar studio-toolbar ${className}`,
+        "data-studio-react-chrome": "true",
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-toolbar-leading design-toolbar-leading", children: [
+            leading,
+            /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "planr-brand", children: [
+              brand && /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(import_jsx_runtime15.Fragment, { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(StudioMark, {}),
+                /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "design-wordmark", children: [
+                  "Open",
+                  /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { children: "Planr" })
+                ] })
+              ] }),
+              /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-identity", children: [
+                hierarchy.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("nav", { className: "studio-hierarchy", "aria-label": "Project path", children: hierarchy.map((item, index2) => /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { children: [
+                  index2 > 0 && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { "aria-hidden": "true", children: " / " }),
+                  item.href ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("a", { href: item.href, children: item.label }) : item.label
+                ] }, item.href ?? item.label)) }),
+                /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "planr-title-block", children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(StudioBadge, { children: kind === "artifact" ? "Artifact" : kind === "diagram" ? "Diagram" : "Design" }),
+                  titleNode ?? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("strong", { title, children: title })
+                ] }),
+                subtitle && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "studio-subtitle", children: subtitle })
+              ] })
             ] })
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-identity", children: [
-            hierarchy.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("nav", { className: "studio-hierarchy", "aria-label": "Project path", children: hierarchy.map((item, index2) => /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { children: [
-              index2 > 0 && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { "aria-hidden": "true", children: " / " }),
-              item.href ? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("a", { href: item.href, children: item.label }) : item.label
-            ] }, item.href ?? item.label)) }),
-            /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: "planr-title-block", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(StudioBadge, { children: kind === "artifact" ? "Artifact" : kind === "diagram" ? "Diagram" : "Design" }),
-              titleNode ?? /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("strong", { title, children: title })
-            ] }),
-            subtitle && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { className: "studio-subtitle", children: subtitle })
-          ] })
-        ] })
-      ] }),
-      viewPicker,
-      /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-toolbar-trailing design-toolbar-trailing", children: [
-        status,
-        actions
-      ] })
-    ] });
+          /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { className: "studio-toolbar-center", children: viewPicker }),
+          /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "studio-toolbar-trailing design-toolbar-trailing", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { className: "studio-toolbar-status", children: status }),
+            /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { className: "studio-toolbar-actions", children: actions })
+          ] }),
+          secondaryActions && /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { className: "studio-toolbar-secondary", children: secondaryActions })
+        ]
+      }
+    );
   }
   function StudioMenu({
     label,
@@ -86,49 +199,106 @@
     onOpenChange
   }) {
     const trigger = (0, import_react3.useRef)(null);
-    return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(dist_exports5.Root, { modal: false, open, onOpenChange, children: /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: `studio-menu ${className}`, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(dist_exports5.Trigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(StudioButton, { "aria-label": label, title: label, ...triggerAttributes, ref: trigger, children: [
-        label,
-        /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { "aria-hidden": "true", children: "⌄" })
-      ] }) }),
-      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
-        dist_exports5.Content,
-        {
-          className: "studio-menu-content",
-          align: "end",
-          sideOffset: 8,
-          collisionPadding: 8,
-          onCloseAutoFocus: (event) => {
-            event.preventDefault();
-            const content = event.target;
-            const ownerDocument = content?.ownerDocument;
-            const active = ownerDocument?.activeElement;
-            if (active?.isConnected && active !== ownerDocument?.body && active !== ownerDocument?.documentElement && !content?.contains(active))
-              return;
-            if (trigger.current?.isConnected) trigger.current.focus();
-          },
-          children: items.map((item, index2) => /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
-            dist_exports5.Item,
+    const mousePosition = (0, import_react3.useRef)(null);
+    const keyboardPosition = (0, import_react3.useRef)(null);
+    (0, import_react3.useLayoutEffect)(() => {
+      const ownerDocument = trigger.current?.ownerDocument;
+      if (!ownerDocument) return;
+      const move = (event) => {
+        if (event.pointerType !== "mouse") return;
+        const position = { x: event.clientX, y: event.clientY };
+        const previous = keyboardPosition.current;
+        if (previous && (previous.x !== position.x || previous.y !== position.y))
+          keyboardPosition.current = null;
+        mousePosition.current = position;
+      };
+      const down = (event) => {
+        keyboardPosition.current = null;
+        if (event.pointerType === "mouse")
+          mousePosition.current = { x: event.clientX, y: event.clientY };
+      };
+      ownerDocument.addEventListener("pointermove", move, true);
+      ownerDocument.addEventListener("pointerdown", down, true);
+      return () => {
+        ownerDocument.removeEventListener("pointermove", move, true);
+        ownerDocument.removeEventListener("pointerdown", down, true);
+      };
+    }, []);
+    const retainKeyboardFocus = (event) => {
+      const position = keyboardPosition.current;
+      if (event.pointerType === "mouse" && position?.x === event.clientX && position.y === event.clientY)
+        event.preventDefault();
+    };
+    const keyboardInput = () => {
+      keyboardPosition.current = mousePosition.current;
+    };
+    return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+      dist_exports5.Root,
+      {
+        modal: false,
+        open,
+        onOpenChange: (value) => {
+          if (!value) keyboardPosition.current = null;
+          onOpenChange?.(value);
+        },
+        children: /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("span", { className: `studio-menu ${className}`, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(dist_exports5.Trigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(
+            StudioButton,
+            {
+              "aria-label": label,
+              title: label,
+              ...triggerAttributes,
+              ref: trigger,
+              onKeyDownCapture: keyboardInput,
+              children: [
+                label,
+                /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { "aria-hidden": "true", children: "⌄" })
+              ]
+            }
+          ) }),
+          /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+            dist_exports5.Content,
             {
-              asChild: true,
-              disabled: item.disabled,
-              onSelect: item.onSelect,
-              children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
-                "button",
+              className: "studio-menu-content",
+              align: "end",
+              sideOffset: 8,
+              collisionPadding: 8,
+              onKeyDownCapture: keyboardInput,
+              onCloseAutoFocus: (event) => {
+                event.preventDefault();
+                const content = event.target;
+                const ownerDocument = content?.ownerDocument;
+                const active = ownerDocument?.activeElement;
+                if (active?.isConnected && active !== ownerDocument?.body && active !== ownerDocument?.documentElement && !content?.contains(active))
+                  return;
+                if (trigger.current?.isConnected) trigger.current.focus();
+              },
+              children: items.map((item, index2) => /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+                dist_exports5.Item,
                 {
-                  type: "button",
-                  className: `studio-menu-item${index2 > 0 && item.group !== items[index2 - 1].group ? " studio-menu-group-start" : ""}`,
+                  asChild: true,
                   disabled: item.disabled,
-                  ...item.attributes,
-                  children: item.label
-                }
-              )
-            },
-            item.id
-          ))
-        }
-      )
-    ] }) });
+                  onSelect: item.onSelect,
+                  onPointerMove: retainKeyboardFocus,
+                  onPointerLeave: retainKeyboardFocus,
+                  children: /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+                    "button",
+                    {
+                      type: "button",
+                      className: `studio-menu-item${index2 > 0 && item.group !== items[index2 - 1].group ? " studio-menu-group-start" : ""}`,
+                      disabled: item.disabled,
+                      ...item.attributes,
+                      children: item.label
+                    }
+                  )
+                },
+                item.id
+              ))
+            }
+          )
+        ] })
+      }
+    );
   }
   function StudioPanelDialog({
     open,

package/lib/host-packages/claude/openplanr/runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources.json

@@ -2,8 +2,8 @@
   "kind": "openplanr-runtime-asset-sources",
   "schemaVersion": "1.0.0",
   "asset": "studio.js",
-  "bytes": 1136703,
-  "sha256": "24745f5b2327275efa2cb904652c4451b16a6893d4284e375a3ce986d909f49e",
+  "bytes": 1146075,
+  "sha256": "f649b59fe0a31ec9055d6e5bf5b68425c1fe4e996224c35603d84f91021949cf",
   "scopes": [
     {
       "id": "bundle",
@@ -143,8 +143,8 @@
         "packages/design/lib/design/ui/enhancements.mjs",
         "packages/design/lib/design/ui/handoff-center.mjs"
       ],
-      "bytes": 151613,
-      "sha256": "c40392e1328eb17f9d0a778d1f20e44118731d7c6a0a25f0aa731304a86994a0"
+      "bytes": 152776,
+      "sha256": "9e2ac3d6b99028c7335aacf548f9e04fdf709d15f889db3e35bbebc389631000"
     },
     {
       "path": "studio.js.sources/13-studio-shell.js",
@@ -238,8 +238,8 @@
         "packages/artifact/lib/artifact/ui/studio-shell-components.mjs",
         "packages/artifact/lib/artifact/ui/studio-shell-mount-impl.mjs"
       ],
-      "bytes": 19068,
-      "sha256": "a84049d6a41dd3f655e85a4a39e4874a4c7f6f2013ad9d8c192d22a7082bf407"
+      "bytes": 27277,
+      "sha256": "81af29a6a5a15fd4f0ef41fc48e1eca63c30b3745fd1d92830ba83f7cf2ba603"
     },
     {
       "path": "studio.js.sources/17-design-studio.js",

package/lib/host-packages/claude/openplanr/runtime/design/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.10.3",
+  "version": "0.12.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",
@@ -115,6 +115,10 @@
     "./sharing-security-contracts": {
       "types": "./src/sharing-security-contracts.d.mts",
       "import": "./src/sharing-security-contracts.mjs"
+    },
+    "./enterprise-journey-contracts": {
+      "types": "./src/enterprise-journey-contracts.d.mts",
+      "import": "./src/enterprise-journey-contracts.mjs"
     }
   },
   "files": [
@@ -132,7 +136,7 @@
     "test": "node --test ../../tests/protocol/*.test.mjs"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.13.0"
   },
   "repository": {
     "type": "git",

package/lib/host-packages/claude/openplanr/runtime/plan/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.10.3",
+  "version": "0.12.0",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",
@@ -115,6 +115,10 @@
     "./sharing-security-contracts": {
       "types": "./src/sharing-security-contracts.d.mts",
       "import": "./src/sharing-security-contracts.mjs"
+    },
+    "./enterprise-journey-contracts": {
+      "types": "./src/enterprise-journey-contracts.d.mts",
+      "import": "./src/enterprise-journey-contracts.mjs"
     }
   },
   "files": [
@@ -132,7 +136,7 @@
     "test": "node --test ../../tests/protocol/*.test.mjs"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.13.0"
   },
   "repository": {
     "type": "git",

package/lib/host-packages/claude/openplanr/skills/delegate/SKILL.md

@@ -16,7 +16,7 @@ Ordinary implementation remains with `planr-ship`.
 Resolve [runner.mjs](scripts/runner.mjs) from this installed skill. Call it through
 Node as `node <installed-skill>/scripts/runner.mjs <action>`, with one JSON object
 on stdin. Alternatively, include `action` in that object and omit the command-line
-action; conflicting actions are rejected. `probe` discovers Node 20+, Git, installed
+action; conflicting actions are rejected. `probe` discovers Node 22+, Git, installed
 CLIs and optional profiles; an OpenPlanr checkout or public CLI command is not
 needed. Reuse normal signed-in authentication. Preserve selection precedence:
 explicit engine/profile, saved choice, then a sole compatible native choice; ask

package/lib/host-packages/claude/openplanr/skills/delegate/references/capsule-contract.md

@@ -1,6 +1,6 @@
 # Delegation context capsule v1
 
-`context.mjs` is an internal, Node 20+ package resource. It gathers **work context** only. It does not select a profile, grant a writable path, launch an agent, or authorize publication. The orchestrator must show `previewContextCapsule` alongside the selected writable repository, native engine/model selection, configuration trust and known provider or native-managed routing before dispatch.
+`context.mjs` is an internal, Node 22+ package resource. It gathers **work context** only. It does not select a profile, grant a writable path, launch an agent, or authorize publication. The orchestrator must show `previewContextCapsule` alongside the selected writable repository, native engine/model selection, configuration trust and known provider or native-managed routing before dispatch.
 
 ## API
 

package/lib/host-packages/claude/openplanr/skills/delegate/scripts/run-preparation.mjs

@@ -58,7 +58,7 @@ async function inspectWorktreeDependencies(worktreePath) {
 }
 
 export async function probeDelegateHost({ repositoryRoot, env = process.env } = {}) {
-  const nodeReady = Number(process.versions.node.split('.')[0]) >= 20;
+  const nodeReady = Number(process.versions.node.split('.')[0]) >= 22;
   const options = {
     env: { PATH: env.PATH, HOME: env.HOME, USER: env.USER, TMPDIR: env.TMPDIR },
     cwd: repositoryRoot,
@@ -128,7 +128,7 @@ export async function probeDelegateHost({ repositoryRoot, env = process.env } =
   }
   return {
     ready: nodeReady && gitReady,
-    node: { ready: nodeReady, minimumMajor: 20 },
+    node: { ready: nodeReady, minimumMajor: 22 },
     git: { ready: gitReady, ...(gitDiagnostic ? { diagnostic: gitDiagnostic } : {}) },
     repository,
     engines,
@@ -167,7 +167,7 @@ export async function prepareDelegateRun({
   if (!host.ready || !host.repository?.ready)
     throw new DelegateRunError(
       'E_DELEGATE_PREREQUISITE',
-      'Node 20+, Git, and a repository with a commit are required before task collection.',
+      'Node 22+, Git, and a repository with a commit are required before task collection.',
       null,
       host,
     );

package/lib/host-packages/claude/openplanr/skills/design/references/utilities.md

@@ -2,7 +2,7 @@
 
 Run the linked design helper from the skill entrypoint relative to the skill's
 directory. It contains deterministic operations and all required assets. It needs
-Node 20 or later, with no global CLI, provider credentials or runtime downloads.
+Node.js 22.13 or later, with no global CLI, provider credentials or runtime downloads.
 Use `--help` to inspect the installed command interface before writing documents
 or invoking operations; the installed contract is authoritative.
 

package/lib/host-packages/claude/openplanr/skills/design-loop/references/utilities.md

@@ -2,7 +2,7 @@
 
 Run the linked design helper from the skill entrypoint relative to the skill's
 directory. It contains deterministic operations and all required assets. It needs
-Node 20 or later, with no global CLI, provider credentials or runtime downloads.
+Node.js 22.13 or later, with no global CLI, provider credentials or runtime downloads.
 Use `--help` to inspect the installed command interface before writing documents
 or invoking operations; the installed contract is authoritative.
 

package/lib/host-packages/claude/openplanr/skills/design-review/references/utilities.md

@@ -2,7 +2,7 @@
 
 Run the linked design helper from the skill entrypoint relative to the skill's
 directory. It contains deterministic operations and all required assets. It needs
-Node 20 or later, with no global CLI, provider credentials or runtime downloads.
+Node.js 22.13 or later, with no global CLI, provider credentials or runtime downloads.
 Use `--help` to inspect the installed command interface before writing documents
 or invoking operations; the installed contract is authoritative.
 

package/lib/host-packages/claude/openplanr/skills/doctor/SKILL.md

@@ -37,7 +37,10 @@ skill's job, then reporting what actually changed — never what was merely
 attempted.
 
 1. **Decide.** Run `openplanr upgrade status --json` and read `status`. If it is
-   `aligned` or `unknown`, there is nothing to drive — report it and stop.
+   `aligned` or `unknown` with empty `nextSteps`, there is nothing to drive —
+   report it and stop. If it is `agents-behind`, or `aligned` with `nextSteps`,
+   the CLI is already current: run its `nextSteps` commands in order, as step 3
+   describes, without upgrading the CLI.
    Record the reported `installed` versions; that is the before state.
 2. **Own half, prescribe half.** If `status` is `upgrade-available` or
    `incompatible`, confirm with the user (this upgrades the npm CLI), then run

package/lib/host-packages/claude/openplanr/skills/doctor/references/upgrade.md

@@ -52,6 +52,10 @@ Shape (the fields this skill reads):
 - `upgrade-available` or `incompatible` → act. First **record the `installed`
   block as the before state** — the honest diff at the end depends on it. When
   only `nextSteps` is non-empty, skip to step 3.
+- `agents-behind` → the CLI is current and a coding agent's OpenPlanr install
+  needs updating. Record the `installed` block, then skip to step 3.
+- `aligned` with non-empty `nextSteps` → the versions match, but an install needs
+  the `openplanr doctor` commands listed. Skip to step 3.
 
 ## 2. Upgrade the CLI and obtain the next steps
 
@@ -90,6 +94,10 @@ this file.** Other shapes:
   `openplanr upgrade status --json` and use its `nextSteps`.
 - An `openplanr doctor` command: planning that agent's update failed, and `detail`
   says why. Relay it and run `openplanr doctor --json`.
+- An `openplanr doctor --fix` command: a file in that agent's runtime package was
+  changed outside OpenPlanr, and `detail` names it. Run it, show the user the
+  repair preview, and rerun it with `--yes` only after they confirm. The changed
+  files are backed up before they are replaced.
 
 `pluginHalfCommands` repeats the commands for older readers; read `nextSteps`.
 

package/lib/host-packages/claude/openplanr/skills/plan/SKILL.md

@@ -118,8 +118,8 @@ instead of repeating every path in chat.
 - **Checks:** frontmatter, ID and acceptance coverage checks actually performed.
 - **Issues:** unresolved inputs or material assumptions, with their impact and recovery step; omit when empty.
 - **Next:** the exact ready task selector and a copy-ready host-native
-  invocation such as `$planr:ship T-NNN` (Codex/ChatGPT) or
-  `/planr:ship T-NNN` (Claude Code).
+  invocation such as `/planr:ship T-NNN` (Claude Code), `$planr:ship T-NNN`
+  (Codex/ChatGPT) or the `planr-ship` rule (Cursor).
 
 Mention the planning layout or consulted lenses only when they explain a material
 choice. Different summary wording never requires another planning run.