openplanr 2.2641.1 → 3.0.0

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

@@ -7,31 +7,22 @@ license: MIT
 # OpenPlanr Sync
 
 Reconcile local planning artifacts and, when requested, GitHub or Linear state.
-Reason about conflicts in this active session; deterministic mapping and GitHub
-transport may use a host connector or the packaged [sync helper](scripts/sync.mjs).
-Local and GitHub work never require the OpenPlanr CLI.
+Reason about conflicts in this active session. Local and GitHub work never require
+the OpenPlanr CLI.
 
-Resolution order:
+Remote steps run through the host's own connections, as described in
+[tracker connections](references/tracker-connections.md), which also holds the status
+mapping and what to tell the user when a connection is missing:
 
-1. use a host-native GitHub or Linear connector when available;
-2. otherwise, for GitHub, use the packaged deterministic helper;
-3. otherwise, for Linear, use the `openplanr linear` terminal utility when the user has
-   installed it; `openplanr github` and `openplanr sync` are optional equivalents for the rest.
-
-Linear through the CLI:
-
-- the user runs `openplanr linear init` in a terminal once; it prompts for a personal
-  access token, which the CLI stores;
-- audit with `openplanr linear sync --dry-run`, which reads Linear without writing;
-- before a real `openplanr linear sync`, ask how conflicts should resolve and pass
-  `--on-conflict local` or `--on-conflict linear`; without a prompt it favors Linear;
-- `openplanr linear push <artifact-id>` creates or updates Linear issues; preview with
-  `--dry-run`. Quick tasks and backlog items need `linear.standaloneProjectId` in the
-  project config when no terminal prompt is available.
+- GitHub: the host's GitHub connection, or, when the GitHub CLI is signed in, the
+  packaged [sync helper](scripts/sync.mjs), which creates and edits issues through `gh`;
+  close or reopen an issue with `gh issue close` or `gh issue reopen`. `openplanr github`
+  is an optional equivalent; `openplanr sync` only repairs local cross-references.
+- Linear: the host's Linear connection.
 
 Audit is read-only by default. Apply local changes only when the request asks for
 reconciliation, and push remote changes only when the request asks for external
-synchronization. If credentials are unavailable, complete local reconciliation
+synchronization. If a connection is unavailable, complete local reconciliation
 and report only the external step that could not run.
 
 ## Return

package/lib/host-packages/claude/openplanr/skills/sync/references/tracker-connections.md

@@ -0,0 +1,70 @@
+# GitHub and Linear connections
+
+These skills store and read no GitHub or Linear credentials. Remote steps run through a
+connection the host already has; the planning files stay the source of truth.
+
+## Use the host's connection
+
+- **Linear:** the host's Linear connection, whose tools read, create and update issues.
+- **GitHub:** the host's GitHub connection, or the GitHub CLI when
+  `gh auth status --hostname github.com` succeeds.
+
+Never ask the user for a token, read one from the environment or a file, or put one in a
+command, URL or file.
+
+## When a connection is missing
+
+Finish the local work first. Then report the remote step as not run and give the one
+line for the current host:
+
+| Host | Linear | GitHub |
+| --- | --- | --- |
+| Claude Code | Run `/plugin install linear@claude-plugins-official`, then sign in to Linear from `/mcp`. | Install the GitHub CLI (cli.github.com) and run `gh auth login`. |
+| Codex | Run `codex mcp add linear --url https://mcp.linear.app/mcp`, then `codex mcp login linear`. | Install the GitHub plugin from `/plugins`, or run `gh auth login`. |
+| Cursor | Add Linear from the Cursor Marketplace and sign in to Linear. | Install the GitHub CLI (cli.github.com) and run `gh auth login`. |
+
+Ask the user to try again once connected; never retry the remote step on your own.
+
+## Status mapping
+
+| Local status | Linear workflow state | GitHub issue |
+| --- | --- | --- |
+| `planning`, `pending` | Unstarted (for example Todo) | open |
+| `in-progress` | Started (for example In Progress) | open |
+| `done` | Completed (for example Done) | closed |
+| Backlog `open` | Backlog, else Unstarted | open |
+| Backlog `closed` | Completed | closed |
+| Backlog `promoted` | Leave as it is | Leave as it is |
+
+When reading state back, write only a status the item's type allows. A backlog item takes
+`open` or `closed` and keeps `promoted`.
+
+- Linear Completed or Canceled sets `done`, or `closed` for a backlog item. Started sets
+  `in-progress`, and Triage, Backlog or Unstarted sets `planning` for features and stories
+  and `pending` for quick tasks; a backlog item takes `open` from any of these. Epics and
+  task files keep their status.
+- A closed GitHub issue sets `done`, or `closed` for a backlog item. An open issue sets
+  `in-progress` for a `done` item and `open` for a `closed` backlog item; other statuses
+  stay as they are.
+
+## Links
+
+A linked item records its tracker identity in frontmatter. Update a linked item through
+that identity instead of creating another, and record the identity of everything you
+create.
+
+- **GitHub:** each item is one issue, recorded as `githubIssue`.
+- **Linear:** use the shapes the OpenPlanr CLI uses, so its later pushes reuse what you
+  create:
+  - An epic is a Linear project (`linearProjectId`, `linearProjectIdentifier`,
+    `linearProjectUrl`). When its `linearMappingStrategy` is `milestone-of` or `label-on`,
+    it is a milestone in an existing project (`linearMilestoneId`) or a team label
+    (`linearLabelId`) instead, and every issue under it carries that milestone
+    (`linearProjectMilestoneId`) or label (`linearLabelIds`).
+  - A feature, quick task or backlog item is one issue (`linearIssueId`,
+    `linearIssueIdentifier`, `linearIssueUrl`). A story is a sub-issue of its feature's
+    issue (`linearParentIssueId`).
+  - All task files of one feature share one task-list issue: a sub-issue of the feature's
+    issue whose checklist merges every task file, recorded in each task file. Its state is
+    Completed when every task file is `done`, Unstarted when every one is `pending`, and
+    Started otherwise.

package/lib/host-packages/claude/openplanr/skills/sync/scripts/sync.mjs

@@ -5,7 +5,7 @@ import { access, readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
-import { CLI_COMMAND, PLANNING_FOLDER } from './names.mjs';
+import { PLANNING_FOLDER } from './names.mjs';
 
 const execFileAsync = promisify(execFile);
 const LINEAR_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
@@ -147,7 +147,7 @@ export async function runPortableSync(
   } else if (args.provider === 'linear') {
     throw new IntegrationError(
       'E_SYNC_USAGE',
-      `Linear synchronization runs through a Linear connector or the ${CLI_COMMAND} CLI (${CLI_COMMAND} linear push, ${CLI_COMMAND} linear sync).`,
+      "Linear synchronization runs through the host's Linear connection.",
     );
   } else {
     throw new IntegrationError(

package/lib/host-packages/cursor/openplanr/.openplanr-content.json

@@ -12,11 +12,11 @@
     },
     {
       "path": "manifest.json",
-      "digest": "sha256:dfbaa939fdf6cb8d17633e494f0f15131d1b170d4f5245778025378dd948b7ba"
+      "digest": "sha256:bb99c4e7aca114a4627114d9338303bd1432cad2773ca708b882b77878047598"
     },
     {
       "path": "rules/planr-artifact.mdc",
-      "digest": "sha256:c4994566f9c062b2f8f5b830c269e92f290e15749e61d703ab0eb4aa94ea8053"
+      "digest": "sha256:8c5ef7c58d1823569eac5dd0f0cb17a0f9c4b79455b25b18e402c4fa40f5815b"
     },
     {
       "path": "rules/planr-artifact/references/company-review.md",
@@ -28,7 +28,7 @@
     },
     {
       "path": "rules/planr-artifact/references/diagram-sharing.md",
-      "digest": "sha256:b0cdad978a5ce2a8be27f072361e40cba10eac64d1bed8f224545dd5810c87ea"
+      "digest": "sha256:84c9ba89680dcbacc4f1ad8b871980e7e6ed73fae8d086c0d148c8ce84510f84"
     },
     {
       "path": "rules/planr-browser-qa.mdc",
@@ -40,7 +40,7 @@
     },
     {
       "path": "rules/planr-ceo-review/references/operate-advisor-contract.md",
-      "digest": "sha256:467c4437430f656d37827c9035b7e3dec324735e1c7ac080776141a2e305e534"
+      "digest": "sha256:3153403563d422f395add6a2afd6d249737b8807e4ab31db5b830d82d7814fc5"
     },
     {
       "path": "rules/planr-ceo-review/scripts/validate-note.mjs",
@@ -48,7 +48,7 @@
     },
     {
       "path": "rules/planr-chair-review.mdc",
-      "digest": "sha256:dd7a350d3661b61100996ae2da3395691625fbcb818a67876ab0fcd839fa2b57"
+      "digest": "sha256:520b773b2186b805222ddb05df380eeba875b42e27c68b559096cc84f2951022"
     },
     {
       "path": "rules/planr-chair-review/scripts/validate-note.mjs",
@@ -56,7 +56,7 @@
     },
     {
       "path": "rules/planr-challenger-review.mdc",
-      "digest": "sha256:8b43d08c75dc63821bf4b71a33e42dbd7df38990acc7497635acf57c57fd2e85"
+      "digest": "sha256:3de0431436c1530451210ab59e613c88eefc8ce4cb72cb9b6052b55fcb18ef3c"
     },
     {
       "path": "rules/planr-challenger-review/scripts/validate-note.mjs",
@@ -68,7 +68,7 @@
     },
     {
       "path": "rules/planr-cmo-review/references/operate-advisor-contract.md",
-      "digest": "sha256:467c4437430f656d37827c9035b7e3dec324735e1c7ac080776141a2e305e534"
+      "digest": "sha256:3153403563d422f395add6a2afd6d249737b8807e4ab31db5b830d82d7814fc5"
     },
     {
       "path": "rules/planr-cmo-review/scripts/validate-note.mjs",
@@ -80,7 +80,7 @@
     },
     {
       "path": "rules/planr-coo-review/references/operate-advisor-contract.md",
-      "digest": "sha256:467c4437430f656d37827c9035b7e3dec324735e1c7ac080776141a2e305e534"
+      "digest": "sha256:3153403563d422f395add6a2afd6d249737b8807e4ab31db5b830d82d7814fc5"
     },
     {
       "path": "rules/planr-coo-review/scripts/validate-note.mjs",
@@ -92,7 +92,7 @@
     },
     {
       "path": "rules/planr-cpo-review/references/operate-advisor-contract.md",
-      "digest": "sha256:467c4437430f656d37827c9035b7e3dec324735e1c7ac080776141a2e305e534"
+      "digest": "sha256:3153403563d422f395add6a2afd6d249737b8807e4ab31db5b830d82d7814fc5"
     },
     {
       "path": "rules/planr-cpo-review/scripts/validate-note.mjs",
@@ -104,7 +104,7 @@
     },
     {
       "path": "rules/planr-cto-review/references/operate-advisor-contract.md",
-      "digest": "sha256:467c4437430f656d37827c9035b7e3dec324735e1c7ac080776141a2e305e534"
+      "digest": "sha256:3153403563d422f395add6a2afd6d249737b8807e4ab31db5b830d82d7814fc5"
     },
     {
       "path": "rules/planr-cto-review/scripts/validate-note.mjs",
@@ -116,7 +116,7 @@
     },
     {
       "path": "rules/planr-delegate.mdc",
-      "digest": "sha256:43643a5cd724ef6eb18f6c38ff7ce9ec6931010f6fcfac857366312cdb027e5a"
+      "digest": "sha256:4a44b4094f6ec174abe2eae83b38aeaf1a21c2e626612e557de4be0ddb9c513c"
     },
     {
       "path": "rules/planr-delegate/references/adapter-protocol.md",
@@ -124,7 +124,7 @@
     },
     {
       "path": "rules/planr-delegate/references/capsule-contract.md",
-      "digest": "sha256:12e0f01caa24a22f7c03ae1174d221b259a2fd4763539963db6c8654d63d8b28"
+      "digest": "sha256:22e5daac9ad9cb0951222fef4d0f45ae35de4a6b7ee2b47d660cc6b672188fff"
     },
     {
       "path": "rules/planr-delegate/references/integration-review.md",
@@ -132,7 +132,7 @@
     },
     {
       "path": "rules/planr-delegate/references/operator-guide.md",
-      "digest": "sha256:026655594840b990ba5c840e58056bfc5be35d719d0b7b6f2c5a629d8eda044d"
+      "digest": "sha256:436c12e8ff06e67a529df1aaeb736407d85a63c636260f4a193f458c94fd2ec4"
     },
     {
       "path": "rules/planr-delegate/references/run-handoff.md",
@@ -148,7 +148,7 @@
     },
     {
       "path": "rules/planr-delegate/scripts/adapters/claude.mjs",
-      "digest": "sha256:7f864c25d0d50c6e31d23be4ccbd6f9edb2a601b529a3652abdde28b4c7c6066"
+      "digest": "sha256:98dae19b18c18b372edc77985a889303e595b0fc4556f1f42dcfd69d5f037acc"
     },
     {
       "path": "rules/planr-delegate/scripts/adapters/codex.mjs",
@@ -164,15 +164,19 @@
     },
     {
       "path": "rules/planr-delegate/scripts/adapters/native.mjs",
-      "digest": "sha256:cf4af84cdfcc05d906a51878dfd82e5a0b5e4acd6644bf93ebf708a6dd2f0130"
+      "digest": "sha256:ff2a8c9365264c4065b8be742ba98ba7b5c8269779c66f217140e9fbf6609727"
     },
     {
       "path": "rules/planr-delegate/scripts/backend-diagnostics.mjs",
-      "digest": "sha256:74b327c6de0e581e2b238ea1e7d5f8ddaa15a7091f717b9a4c66192e60e9ef9c"
+      "digest": "sha256:989c307c6a42c19f799b17bbe7067211b5d9435a6ebabd2609d15d312d3d2715"
     },
     {
       "path": "rules/planr-delegate/scripts/context.mjs",
-      "digest": "sha256:a611af4a3542a5cd1c928b2a3a07a80f51598482a3beb5aede3e66ee3a13fb3f"
+      "digest": "sha256:632a59c12d8fc4b6b738279cbee5f8d001e76d9ef379fc065f62031647462d42"
+    },
+    {
+      "path": "rules/planr-delegate/scripts/credentials.mjs",
+      "digest": "sha256:a7b55c9598a8a5301c4e0ff79f3471a587a5f26686c9a7d97fe662ee0babb49d"
     },
     {
       "path": "rules/planr-delegate/scripts/custody.mjs",
@@ -200,7 +204,7 @@
     },
     {
       "path": "rules/planr-delegate/scripts/presentation.mjs",
-      "digest": "sha256:a3aca29d53b365c16dee25df7094f79c93425690b694ef5c2af9586becd60a03"
+      "digest": "sha256:32ca0c561e99bb02dc8f88e0823a0b826a24cd61404b165fe306bbbce9ee99b9"
     },
     {
       "path": "rules/planr-delegate/scripts/profiles.mjs",
@@ -208,7 +212,7 @@
     },
     {
       "path": "rules/planr-delegate/scripts/run-contract.mjs",
-      "digest": "sha256:9118f4701e0e61ab186cba4da2cb97804310c6c314d96066ee9457e35f526252"
+      "digest": "sha256:f87f0bd16249266ef6f044a37db608d852a5d893628de26ab9844dc92df57c46"
     },
     {
       "path": "rules/planr-delegate/scripts/run-execution.mjs",
@@ -224,11 +228,11 @@
     },
     {
       "path": "rules/planr-delegate/scripts/run-preparation.mjs",
-      "digest": "sha256:59a0207b35590c00c7e9906fa9fded89c85b8e8ed28431d07741f874c10e1176"
+      "digest": "sha256:746630b00e1c252cae6dd7e78cde4b2d6c65e75f1ef19a092111e1e4de5152e3"
     },
     {
       "path": "rules/planr-delegate/scripts/run-record.mjs",
-      "digest": "sha256:73eb79f4a2da7d1016356cc7098f36388934a66f4d14e0d8007349d624bb2abf"
+      "digest": "sha256:cbceec29880e4af92fc2dbd692edd10dcd6cb24ab87108b3a492f94797d93473"
     },
     {
       "path": "rules/planr-delegate/scripts/runner.mjs",
@@ -272,7 +276,7 @@
     },
     {
       "path": "rules/planr-design-loop/references/utilities.md",
-      "digest": "sha256:df4414af1974d8268af25cfb33ce27d967e0a7f0ca29e75de82b91f3dacf2543"
+      "digest": "sha256:cedeae549cda5434a768846dc3d83a1baddfa74940276485db6fba1c649301b5"
     },
     {
       "path": "rules/planr-design-loop/schemas/design-document.schema.json",
@@ -328,7 +332,7 @@
     },
     {
       "path": "rules/planr-design-review/references/utilities.md",
-      "digest": "sha256:df4414af1974d8268af25cfb33ce27d967e0a7f0ca29e75de82b91f3dacf2543"
+      "digest": "sha256:cedeae549cda5434a768846dc3d83a1baddfa74940276485db6fba1c649301b5"
     },
     {
       "path": "rules/planr-design-review/schemas/design-document.schema.json",
@@ -384,7 +388,7 @@
     },
     {
       "path": "rules/planr-design/references/utilities.md",
-      "digest": "sha256:df4414af1974d8268af25cfb33ce27d967e0a7f0ca29e75de82b91f3dacf2543"
+      "digest": "sha256:cedeae549cda5434a768846dc3d83a1baddfa74940276485db6fba1c649301b5"
     },
     {
       "path": "rules/planr-design/schemas/design-document.schema.json",
@@ -420,15 +424,15 @@
     },
     {
       "path": "rules/planr-diagram/references/diagram-sharing.md",
-      "digest": "sha256:b0cdad978a5ce2a8be27f072361e40cba10eac64d1bed8f224545dd5810c87ea"
+      "digest": "sha256:84c9ba89680dcbacc4f1ad8b871980e7e6ed73fae8d086c0d148c8ce84510f84"
     },
     {
       "path": "rules/planr-doctor.mdc",
-      "digest": "sha256:d6e90240f79ca233f31cd90ad2ea61ea62d069c523322fa42ffa61d01aeea792"
+      "digest": "sha256:328ce5775b54d9b7f7c23bc6be9082004c3f734f5a78c5522b4feb66b31ce377"
     },
     {
       "path": "rules/planr-doctor/references/upgrade.md",
-      "digest": "sha256:7370954450db1bac591d4f90b58df9022f6edac5b32d05051f93dbd35b0e35b9"
+      "digest": "sha256:b137e82d63ceeecef4e5c1cac72acbaaa2edbc29798214507ab9613d16088fde"
     },
     {
       "path": "rules/planr-investigate.mdc",
@@ -444,7 +448,7 @@
     },
     {
       "path": "rules/planr-operate.mdc",
-      "digest": "sha256:c3c99a3ce9a3b308fc0d27a3a8505864facb52281c19eaf385846b5600ed0f0f"
+      "digest": "sha256:f20cabd0fb42523f1bea8bb9ba21d5982994f345e9a5baf5f033229cc2cbca03"
     },
     {
       "path": "rules/planr-operate/scripts/validate-note.mjs",
@@ -456,7 +460,7 @@
     },
     {
       "path": "rules/planr-plan.mdc",
-      "digest": "sha256:41a1f39eab8d8c4f99de25628a1ed5f1cb42ceae39dacbe4893c6500202b6083"
+      "digest": "sha256:952f63ebe7ad028043e1c25e12737f2e56db6216efa09346fd6bd14f071a5223"
     },
     {
       "path": "rules/planr-plan/references/artifact-contract.md",
@@ -540,7 +544,7 @@
     },
     {
       "path": "rules/planr-sprint.mdc",
-      "digest": "sha256:5029217d0dbf976655ee0a4536a56890fba9ea85e07a5882d755042f23388f5f"
+      "digest": "sha256:d7678d43e82e90cbfdb7089e637a0a0b5059d4bf5619693808571a6c2a566835"
     },
     {
       "path": "rules/planr-sprint/references/refinement-contract.md",
@@ -550,17 +554,29 @@
       "path": "rules/planr-sprint/references/sprint-formats.md",
       "digest": "sha256:547bda354869f1aef26398e77e956f43116305f8dcc0d827dd5fb061ec98504a"
     },
+    {
+      "path": "rules/planr-sprint/references/tracker-connections.md",
+      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
+    },
     {
       "path": "rules/planr-sprint/schemas/refinement.schema.json",
       "digest": "sha256:31494ba4a83f9b7b3aeffc8423135404026ba07c02106be3ba99d6fc75852b12"
     },
     {
       "path": "rules/planr-status.mdc",
-      "digest": "sha256:9a48e72084ab46add12026141ce7cb960ddb1460705558e79c9bf70d51db5108"
+      "digest": "sha256:efc0ae769f57611c39cf4307d721273106a5bc22ca3dcc1e6e07ec9f19e2d508"
+    },
+    {
+      "path": "rules/planr-status/references/tracker-connections.md",
+      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
     },
     {
       "path": "rules/planr-sync.mdc",
-      "digest": "sha256:b53cfbdbff695cd0cfba6028308febbbda1980aba79e6d6cbdc91c82e08e963b"
+      "digest": "sha256:e2e300f5b378a7593c3ed5d133c253d7d3b2a17ad0349133f94a8ba18c4d20b9"
+    },
+    {
+      "path": "rules/planr-sync/references/tracker-connections.md",
+      "digest": "sha256:5f7d7126ca0db062c2b14c8ac35ca9758e44433329da610d7e75ad83b9417707"
     },
     {
       "path": "rules/planr-sync/scripts/names.mjs",
@@ -568,7 +584,7 @@
     },
     {
       "path": "rules/planr-sync/scripts/sync.mjs",
-      "digest": "sha256:37c7caaea892e296aa9329a52f75144355555120d6254e8dd8019d1366907376"
+      "digest": "sha256:7ef90127444f270dc30d119c88a41c898fe7e0b82b1d72d95b1bffc9393a1492"
     },
     {
       "path": "runtime/design/scripts/design-artifact-shell.mjs",
@@ -620,7 +636,7 @@
     },
     {
       "path": "runtime/design/scripts/design-review.mjs",
-      "digest": "sha256:3085283fb94cc2df9bd2630ba9bc0704523efdfda2e0dddb20c1dc5025941140"
+      "digest": "sha256:943d2fc37557f50df80ee00036e3ca844b022b7db373158578a2b3d72373b7a0"
     },
     {
       "path": "runtime/design/scripts/design-runtime-home.mjs",
@@ -636,7 +652,7 @@
     },
     {
       "path": "runtime/design/scripts/design-share.mjs",
-      "digest": "sha256:aaf6ff42d68340a27ded2afff52c65a88e524aa66dc06ec52190fb0b94edec29"
+      "digest": "sha256:76a313211315e67b1fc9a216ce5b4ae415f472a34216a059fdbb4c9870ae9db7"
     },
     {
       "path": "runtime/design/scripts/design-shared-artifact-support-dependencies-design-support-protocol-contracts-3d9b1a86.mjs",
@@ -668,7 +684,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/lib/artifact/ui/studio-shell.css",
-      "digest": "sha256:4449fbe06d25ae0ad9b2faf15a4558f1c6fc8506d357e785dfdbc8befe69df59"
+      "digest": "sha256:61e3736cd81f15162d877bb29481e96538d8a32f19cc4a6718026e549e193c48"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources.json",
@@ -708,11 +724,11 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/package.json",
-      "digest": "sha256:4aff80438f5003c8ee683bb690d2499d3212631741c3cd4d5d519253603b12af"
+      "digest": "sha256:7c884f7d4b1e20ffcfe58514413f1a36e8c00e88866fb07492c912949e87782c"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/enhancements.css",
-      "digest": "sha256:df58a7ee4ffcadac780d3170abbeb00cfecb1f42db692ba62eb6f66a251bd0ea"
+      "digest": "sha256:bdb55a9464e96fba112aad73354d54b6ccb8ac5d9bc100a90b51df4633ff11f7"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/handoff-center.css",
@@ -724,15 +740,15 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/share.js",
-      "digest": "sha256:3be9bf9b8810a1eed5b22f05af33721e6a50d2a814d3d4309d1592b386f80c4f"
+      "digest": "sha256:b388471dccec997c49ce9638ff9a312037d311d63cbe980dceeb9c3c02ca037b"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.css",
-      "digest": "sha256:c9291e20366315b23c73e920ec5426d4c33d0880863d39650d4c535956984b1c"
+      "digest": "sha256:75ca0c3036d5c281e60a4155765ad8c2e9373bd39d34d4facebfe9bf26278c88"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources.json",
-      "digest": "sha256:268b66e770a35e3f5606a4c7b44f6fb6bd5659c15d1813f7421781ef3e9bcf99"
+      "digest": "sha256:f517215a81d763cdc5aa903b0d6b2e679d10dc3592915e4f4c1f7062413cb6d3"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/01-module-runtime.js",
@@ -780,7 +796,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/12-design-review-experience.js",
-      "digest": "sha256:c40392e1328eb17f9d0a778d1f20e44118731d7c6a0a25f0aa731304a86994a0"
+      "digest": "sha256:9e2ac3d6b99028c7335aacf548f9e04fdf709d15f889db3e35bbebc389631000"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/13-studio-shell.js",
@@ -796,7 +812,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/16-studio-shell.js",
-      "digest": "sha256:a84049d6a41dd3f655e85a4a39e4874a4c7f6f2013ad9d8c192d22a7082bf407"
+      "digest": "sha256:5306387b1f59d43e1cd0ed2c471b18b0b35d5cc8c573ffe5439ea9315494c01e"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/design/templates/studio/studio.js.sources/17-design-studio.js",
@@ -804,7 +820,7 @@
     },
     {
       "path": "runtime/design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:ee9f53eadd37089605b4b94c927f3743334cbf147e295eb563aa84fb9b3134af"
+      "digest": "sha256:2ef4fe15be8e2037dda6786e075a02b94b3484f30465aab3565022ff7f0321e4"
     },
     {
       "path": "runtime/design/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -916,7 +932,7 @@
     },
     {
       "path": "runtime/plan/scripts/design.mjs",
-      "digest": "sha256:0a56528539c52e60bef50970bbfb8ccd761d66668ace739bd72b4c95e13cbe4a"
+      "digest": "sha256:d56e399ebb6a522e1b3a1aa82548334fd9137fc6573edfa2989d0dc5d3e3e4ab"
     },
     {
       "path": "runtime/plan/scripts/runtime/notices/THIRD_PARTY_NOTICES.txt",
@@ -924,12 +940,12 @@
     },
     {
       "path": "runtime/plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:ee9f53eadd37089605b4b94c927f3743334cbf147e295eb563aa84fb9b3134af"
+      "digest": "sha256:2ef4fe15be8e2037dda6786e075a02b94b3484f30465aab3565022ff7f0321e4"
     },
     {
       "path": "runtime/plan/scripts/runtime/packages/protocol/schemas/v1.1.0/artifact-review.schema.json",
       "digest": "sha256:b4db7b75b694c2aef2a37be2128e4635302f3473e09236aa1f37a33dcf3590b4"
     }
   ],
-  "contentDigest": "sha256:b178a48f0973780cf2dd0bba6de066aa098aa709b03ad3f9fdbf8ddf37f0f605"
+  "contentDigest": "sha256:35d8b3571f0a3d2e01916e1df450e4961e64c0822e48bfd549f239d64e293e9a"
 }

package/lib/host-packages/cursor/openplanr/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "openplanr",
-  "version": "2.2641.1",
+  "version": "3.0.0",
   "ruleCount": 28,
   "rules": [
     "rules/planr-artifact.mdc",

package/lib/host-packages/cursor/openplanr/rules/planr-artifact/references/diagram-sharing.md

@@ -13,7 +13,7 @@ review. Preview the exact diagram title, source revision, elements, connections,
 destination and retention before creating it. Use `--yes` only when the user has
 already authorized that publication. The stable URL and generated access token
 are separate; copy the token through the local studio's **Share diagram** dialog,
-never into a URL, prompt, ordinary output or repository file. Owner credentials
+never into a URL, prompt, ordinary output or repository file. Owner keys
 are saved privately outside the project. The review remains available until the
 owner revokes or deletes it and works while the local studio is stopped.
 

package/lib/host-packages/cursor/openplanr/rules/planr-artifact.mdc

@@ -29,7 +29,7 @@ relaunch the active coding agent from inside this skill.
    preserve existing guidance and never invent requirements. Render and inspect
    the updated context before sharing. For a design document this creates a permanent encrypted
    design review with a stable URL and a separately entered generated access
-   token. Owner credentials save privately outside the project; copy the reviewer
+   token. Owner keys save privately outside the project; copy the reviewer
    token through the studio's Share dialog, never put it in a URL or ordinary
    command output. Publish an explicitly requested update with
    `openplanr artifact publish <design-document.json>`; synchronize reviewer feedback
@@ -66,7 +66,7 @@ separate permissions and storage from encrypted token shares.
 
 Lead with what was opened, shared, imported or exported and the confirmed revision
 or session. Link the actual review URL or exported file; never print capability
-tokens or private owner credentials. Distinguish successful service operations
+tokens or private owner keys. Distinguish successful service operations
 from preparation and browser verification from validation alone. For partial or
 blocked work, name the remaining step and exact retry or recovery action, retaining
 the useful local result. Keep detailed diagnostics in their existing records;

package/lib/host-packages/cursor/openplanr/rules/planr-ceo-review/references/operate-advisor-contract.md

@@ -1,8 +1,8 @@
 # Shared Operate advisor contract
 
-This contract supplies the common context method and output shape for the five executive advisor
-skills. The invoking skill supplies the lens, review questions, useful sources, and decision
-standard. Follow both.
+This contract supplies the common context method and output shape for the executive advisor
+skills (CEO, CTO, CPO, CMO, and COO). The invoking skill supplies the lens, review questions,
+useful sources, and decision standard. Follow both.
 
 ## Outcome
 
@@ -21,7 +21,28 @@ not the whole context boundary. Inspect relevant original repository and Git sou
 drawing conclusions. If an input is unavailable, report the exact problem and continue when the
 remaining context still supports a useful note.
 
-Write the review only to `<output-path>`.
+Write the review only to `<output-path>`. Writes follow the host's normal permission rules; this
+skill pre-approves nothing.
+
+### Running without `planr-operate`
+
+When no `<output-path>` was supplied, this lens creates the cycle itself, in the layout
+`planr-operate` uses, under the repository root:
+
+```text
+.planr/operate/<YYYY-MM-DD>-<subject-slug>/
+  cycle.md          the request wording, the effective scope, and a one-lens roster
+  brief.md          compact orientation for this lens only, including what was searched for and not found
+  <lens>.md         this note: ceo.md, cto.md, cpo.md, cmo.md, or coo.md
+  board-report.md   an unsynthesized lens summary
+```
+
+Take the subject, window, and requested decision from the request. Use the first unused directory
+name; append `-02`, `-03`, and so on when the base name exists. In `board-report.md`, use the
+`planr-operate` report sections, mark this lens `reported` and every other lens `omitted by scope`
+under Review coverage, and write `No decision-ready proposal was established.` and
+`No proposed actions.` unless this note states a directly supported proposal. Write nothing outside
+that cycle directory. The dashboard lists a cycle only when `board-report.md` exists.
 
 ## Grounding
 

package/lib/host-packages/cursor/openplanr/rules/planr-chair-review.mdc

@@ -16,7 +16,12 @@ and its decision impact; continue when the remaining notes still support useful
 selected roster from the scope or brief and label an intentionally unselected lens `omitted by
 scope`; do not turn that omission into an issue or decision-changing gap.
 
-Write only `<output-path>`.
+Write only `<output-path>`. Writes follow the host's normal permission rules; this skill
+pre-approves nothing.
+
+Invoked without `<cycle-dir>`, offer the most recent cycle under `.planr/operate/` that holds
+advisor notes and use its `chair.md` as the output path. When there is none, say so and point to
+`planr-operate`; never create an empty cycle.
 
 ## Synthesis standard
 

package/lib/host-packages/cursor/openplanr/rules/planr-challenger-review.mdc

@@ -16,7 +16,12 @@ Use `<cycle-dir>`, `<brief-path>`, `<output-path>`, and `<scope>`. Inspect the a
 is `omitted by scope`, not unavailable, and creates no gap by itself. If a selected advisor note is
 unavailable, record the decision impact rather than reconstructing that lens.
 
-Write only `<output-path>`.
+Write only `<output-path>`. Writes follow the host's normal permission rules; this skill
+pre-approves nothing.
+
+Invoked without `<cycle-dir>`, offer the most recent cycle under `.planr/operate/` that holds
+advisor notes and use its `challenger.md` as the output path. When there is none, say so and point
+to `planr-operate`; never create an empty cycle.
 
 ## Material exceptions