openplanr 2.2639.4 → 2.2640.0

package/lib/host-packages/claude/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/studio.js

@@ -1885,6 +1885,7 @@ ${fence}`;
         if (saving || !available()) return;
         saving = true;
         try {
+          await studio.flush();
           for (const [pinId, category] of Object.entries(outbox)) {
             const body = {
               action: "category",

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

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",

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

@@ -7,16 +7,27 @@ license: MIT
 # Planr Sync
 
 Reconcile local planning artifacts and, when requested, GitHub or Linear state.
-Reason about conflicts in this active session; deterministic mapping and transport
-may use a host connector or the packaged [sync helper](scripts/sync.mjs). The optional
-OpenPlanr CLI is never required by the skill.
+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.
 
 Resolution order:
 
 1. use a host-native GitHub or Linear connector when available;
-2. otherwise use the packaged deterministic helper;
-3. optionally use the equivalent `planr github`, `planr linear`, or `planr sync`
-   terminal utility when the user has installed it.
+2. otherwise, for GitHub, use the packaged deterministic helper;
+3. otherwise, for Linear, use the `planr linear` terminal utility when the user has
+   installed it; `planr github` and `planr sync` are optional equivalents for the rest.
+
+Linear through the CLI:
+
+- the user runs `planr linear init` in a terminal once; it prompts for a personal
+  access token, which the CLI stores;
+- audit with `planr linear sync --dry-run`, which reads Linear without writing;
+- before a real `planr linear sync`, ask how conflicts should resolve and pass
+  `--on-conflict local` or `--on-conflict linear`; without a prompt it favors Linear;
+- `planr 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.
 
 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

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

@@ -7,7 +7,6 @@ import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
 
 const execFileAsync = promisify(execFile);
-const LINEAR_ENDPOINT = 'https://api.linear.app/graphql';
 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;
 const LINEAR_IDENTIFIER = /^[A-Z][A-Z0-9]+-\d+$/u;
 
@@ -102,100 +101,6 @@ export async function executeGitHubOperations(
   return { provider: 'github', applied: true, results };
 }
 
-async function linearRequest(query, variables, token, fetchImpl = fetch) {
-  if (!token)
-    throw new IntegrationError('E_LINEAR_CREDENTIAL', 'Linear credentials are unavailable.');
-  let response;
-  let payload;
-  try {
-    response = await fetchImpl(LINEAR_ENDPOINT, {
-      method: 'POST',
-      headers: { authorization: token, 'content-type': 'application/json' },
-      body: JSON.stringify({ query, variables }),
-    });
-    payload = await response.json();
-  } catch (error) {
-    throw new IntegrationError('E_LINEAR_API', 'Linear synchronization transport failed.', {
-      cause: String(error?.message ?? error),
-    });
-  }
-  if (!response.ok || !payload || typeof payload !== 'object' || payload.errors?.length) {
-    throw new IntegrationError('E_LINEAR_API', 'Linear rejected the synchronization request.', {
-      status: response.status,
-      errors: payload?.errors,
-    });
-  }
-  return payload.data;
-}
-
-function requireLinearMutationResult(data, field) {
-  const result = data?.[field];
-  const issue = result?.issue;
-  if (
-    result?.success !== true ||
-    !issue ||
-    typeof issue.id !== 'string' ||
-    typeof issue.identifier !== 'string' ||
-    typeof issue.url !== 'string'
-  ) {
-    throw new IntegrationError(
-      'E_LINEAR_API',
-      `Linear ${field} did not confirm a successful issue mutation.`,
-      {
-        field,
-        success: result?.success ?? null,
-      },
-    );
-  }
-  return issue;
-}
-
-export async function inspectLinear({ token = process.env.PLANR_LINEAR_TOKEN } = {}) {
-  const data = await linearRequest('query OpenPlanrViewer { viewer { id name email } }', {}, token);
-  return { provider: 'linear', viewer: data.viewer };
-}
-
-export async function executeLinearOperations(
-  operations,
-  { token = process.env.PLANR_LINEAR_TOKEN, apply = false } = {},
-) {
-  if (!Array.isArray(operations))
-    throw new IntegrationError('E_SYNC_INPUT', 'Linear operations must be an array.');
-  if (!apply) return { provider: 'linear', applied: false, operations };
-  const results = [];
-  for (const operation of operations) {
-    if (operation.action === 'create' && operation.teamId) {
-      const data = await linearRequest(
-        'mutation OpenPlanrCreate($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id identifier url } } }',
-        {
-          input: { teamId: operation.teamId, title: operation.title, description: operation.body },
-        },
-        token,
-      );
-      results.push({ action: 'create', ...requireLinearMutationResult(data, 'issueCreate') });
-      continue;
-    }
-    if (operation.action === 'update' && isLikelyLinearIssueId(operation.id)) {
-      const data = await linearRequest(
-        'mutation OpenPlanrUpdate($id: String!, $input: IssueUpdateInput!) { issueUpdate(id: $id, input: $input) { success issue { id identifier url } } }',
-        {
-          id: operation.id,
-          input: { title: operation.title, description: operation.body, stateId: operation.state },
-        },
-        token,
-      );
-      results.push({ action: 'update', ...requireLinearMutationResult(data, 'issueUpdate') });
-      continue;
-    }
-    throw new IntegrationError(
-      'E_SYNC_OPERATION',
-      'Unsupported Linear synchronization operation.',
-      { operation },
-    );
-  }
-  return { provider: 'linear', applied: true, results };
-}
-
 async function readJsonInput(value, stdin) {
   if (value) return JSON.parse(await readFile(resolve(value), 'utf8'));
   let bytes = '';
@@ -226,7 +131,7 @@ function parseArgs(argv) {
 
 export async function runPortableSync(
   argv = process.argv.slice(2),
-  { cwd = process.cwd(), env = process.env, stdin = process.stdin, stdout = process.stdout } = {},
+  { cwd = process.cwd(), stdin = process.stdin, stdout = process.stdout } = {},
 ) {
   const args = parseArgs(argv);
   let result;
@@ -238,17 +143,15 @@ export async function runPortableSync(
       cwd,
       apply: args.apply,
     });
-  } else if (args.provider === 'linear' && args.action === 'inspect') {
-    result = await inspectLinear({ token: env.PLANR_LINEAR_TOKEN });
-  } else if (args.provider === 'linear' && args.action === 'sync') {
-    result = await executeLinearOperations(await readJsonInput(args.input, stdin), {
-      token: env.PLANR_LINEAR_TOKEN,
-      apply: args.apply,
-    });
+  } else if (args.provider === 'linear') {
+    throw new IntegrationError(
+      'E_SYNC_USAGE',
+      'Linear synchronization runs through a Linear connector or the planr CLI (planr linear push, planr linear sync).',
+    );
   } else {
     throw new IntegrationError(
       'E_SYNC_USAGE',
-      'Usage: sync.mjs <local|github|linear> <inspect|sync> [--input path] [--apply]',
+      'Usage: sync.mjs <local|github> <inspect|sync> [--input path] [--apply]',
     );
   }
   stdout.write(`${JSON.stringify(result, null, 2)}\n`);

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

@@ -8,7 +8,7 @@
   "files": [
     {
       "path": "manifest.json",
-      "digest": "sha256:b7e3882512c92061168832f7ab3abfc7fece7b9dd3bc1b8deeba395452e37c51"
+      "digest": "sha256:093b371ba4c633cc73d7e465246928be9f445bf0399682712181f6d1f9593684"
     },
     {
       "path": "rules/planr-artifact.mdc",
@@ -242,9 +242,41 @@
       "path": "rules/planr-design-loop/schemas/design-review-handoff.schema.json",
       "digest": "sha256:402b25238f93f8269b98697bf77fa11dda1fd284f44e41d73cdb813f5244a4e0"
     },
+    {
+      "path": "rules/planr-design-loop/scripts/design-artifact-shell.mjs",
+      "digest": "sha256:9245a86f8e3f20f6ec4c705d1364d2d6d3e639b34a7d41162769a0f490dd39df"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-document.mjs",
+      "digest": "sha256:7e15b9f9e9afd29be2a2558fad9e57b5df85e494a586180d5afe23015cdbcfb7"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-entities.mjs",
+      "digest": "sha256:376ec35d0f184deac31b639f2c0918e6b0f165e19984ed1c89ba2cfad6af9b80"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-parse5-parser.mjs",
+      "digest": "sha256:a9bfeecae4d31155a6935455c82ea8348da25f8585216b531d00c6599b8196e4"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-parse5-tokenizer.mjs",
+      "digest": "sha256:f655474fb8d0bed732f01ace5b67102f849b73cb40831a57f1fb7b61180fbde9"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-review-handoff.mjs",
+      "digest": "sha256:1d04e0d821738f3934fb3fbd314b161fb557f4459cf2da2d1921c99d27d7d861"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-sandbox-guards.mjs",
+      "digest": "sha256:dcc7aa1971da47018a198bfe7520c05e3e5ba21fe2d9c8fffcaad882ded5bbbb"
+    },
+    {
+      "path": "rules/planr-design-loop/scripts/design-share.mjs",
+      "digest": "sha256:b10d7ce9cdb3eb48b9aca803e4d2ecc4f8e477e91f4a0c6a3ae17a1f7985aa06"
+    },
     {
       "path": "rules/planr-design-loop/scripts/design.mjs",
-      "digest": "sha256:1fd130d914dd6b84992007fcf300b6083e04ee3983beaf1718cd1866a26b4d7a"
+      "digest": "sha256:ab33412cab749120e07359983f85bcb64038026844c06ff9f464c4f371d6d6ca"
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/notices/entities.txt",
@@ -280,11 +312,11 @@
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/studio.js",
-      "digest": "sha256:8e0ae7d5ddbb058f4b3f7a0876ce8259dd247358c40ce666763e9001b3bc5338"
+      "digest": "sha256:85f8b084457aaa172025fb878b64059782cb976f72451b207c7bc40e8c982bb8"
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:344e2118724b905e310c4919e9515ff326641f84819202921af871388bd7ea53"
+      "digest": "sha256:931a50e413656f4dcd95db2451b5fc63c985b13494b4b01b492d8292529f4fcb"
     },
     {
       "path": "rules/planr-design-loop/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -418,9 +450,41 @@
       "path": "rules/planr-design-review/schemas/design-review-handoff.schema.json",
       "digest": "sha256:402b25238f93f8269b98697bf77fa11dda1fd284f44e41d73cdb813f5244a4e0"
     },
+    {
+      "path": "rules/planr-design-review/scripts/design-artifact-shell.mjs",
+      "digest": "sha256:9245a86f8e3f20f6ec4c705d1364d2d6d3e639b34a7d41162769a0f490dd39df"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-document.mjs",
+      "digest": "sha256:7e15b9f9e9afd29be2a2558fad9e57b5df85e494a586180d5afe23015cdbcfb7"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-entities.mjs",
+      "digest": "sha256:376ec35d0f184deac31b639f2c0918e6b0f165e19984ed1c89ba2cfad6af9b80"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-parse5-parser.mjs",
+      "digest": "sha256:a9bfeecae4d31155a6935455c82ea8348da25f8585216b531d00c6599b8196e4"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-parse5-tokenizer.mjs",
+      "digest": "sha256:f655474fb8d0bed732f01ace5b67102f849b73cb40831a57f1fb7b61180fbde9"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-review-handoff.mjs",
+      "digest": "sha256:1d04e0d821738f3934fb3fbd314b161fb557f4459cf2da2d1921c99d27d7d861"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-sandbox-guards.mjs",
+      "digest": "sha256:dcc7aa1971da47018a198bfe7520c05e3e5ba21fe2d9c8fffcaad882ded5bbbb"
+    },
+    {
+      "path": "rules/planr-design-review/scripts/design-share.mjs",
+      "digest": "sha256:b10d7ce9cdb3eb48b9aca803e4d2ecc4f8e477e91f4a0c6a3ae17a1f7985aa06"
+    },
     {
       "path": "rules/planr-design-review/scripts/design.mjs",
-      "digest": "sha256:1fd130d914dd6b84992007fcf300b6083e04ee3983beaf1718cd1866a26b4d7a"
+      "digest": "sha256:ab33412cab749120e07359983f85bcb64038026844c06ff9f464c4f371d6d6ca"
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/notices/entities.txt",
@@ -456,11 +520,11 @@
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/packages/design/templates/studio/studio.js",
-      "digest": "sha256:8e0ae7d5ddbb058f4b3f7a0876ce8259dd247358c40ce666763e9001b3bc5338"
+      "digest": "sha256:85f8b084457aaa172025fb878b64059782cb976f72451b207c7bc40e8c982bb8"
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:344e2118724b905e310c4919e9515ff326641f84819202921af871388bd7ea53"
+      "digest": "sha256:931a50e413656f4dcd95db2451b5fc63c985b13494b4b01b492d8292529f4fcb"
     },
     {
       "path": "rules/planr-design-review/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -594,9 +658,41 @@
       "path": "rules/planr-design/schemas/design-review-handoff.schema.json",
       "digest": "sha256:402b25238f93f8269b98697bf77fa11dda1fd284f44e41d73cdb813f5244a4e0"
     },
+    {
+      "path": "rules/planr-design/scripts/design-artifact-shell.mjs",
+      "digest": "sha256:9245a86f8e3f20f6ec4c705d1364d2d6d3e639b34a7d41162769a0f490dd39df"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-document.mjs",
+      "digest": "sha256:7e15b9f9e9afd29be2a2558fad9e57b5df85e494a586180d5afe23015cdbcfb7"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-entities.mjs",
+      "digest": "sha256:376ec35d0f184deac31b639f2c0918e6b0f165e19984ed1c89ba2cfad6af9b80"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-parse5-parser.mjs",
+      "digest": "sha256:a9bfeecae4d31155a6935455c82ea8348da25f8585216b531d00c6599b8196e4"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-parse5-tokenizer.mjs",
+      "digest": "sha256:f655474fb8d0bed732f01ace5b67102f849b73cb40831a57f1fb7b61180fbde9"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-review-handoff.mjs",
+      "digest": "sha256:1d04e0d821738f3934fb3fbd314b161fb557f4459cf2da2d1921c99d27d7d861"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-sandbox-guards.mjs",
+      "digest": "sha256:dcc7aa1971da47018a198bfe7520c05e3e5ba21fe2d9c8fffcaad882ded5bbbb"
+    },
+    {
+      "path": "rules/planr-design/scripts/design-share.mjs",
+      "digest": "sha256:b10d7ce9cdb3eb48b9aca803e4d2ecc4f8e477e91f4a0c6a3ae17a1f7985aa06"
+    },
     {
       "path": "rules/planr-design/scripts/design.mjs",
-      "digest": "sha256:1fd130d914dd6b84992007fcf300b6083e04ee3983beaf1718cd1866a26b4d7a"
+      "digest": "sha256:ab33412cab749120e07359983f85bcb64038026844c06ff9f464c4f371d6d6ca"
     },
     {
       "path": "rules/planr-design/scripts/runtime/notices/entities.txt",
@@ -632,11 +728,11 @@
     },
     {
       "path": "rules/planr-design/scripts/runtime/packages/design/templates/studio/studio.js",
-      "digest": "sha256:8e0ae7d5ddbb058f4b3f7a0876ce8259dd247358c40ce666763e9001b3bc5338"
+      "digest": "sha256:85f8b084457aaa172025fb878b64059782cb976f72451b207c7bc40e8c982bb8"
     },
     {
       "path": "rules/planr-design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:344e2118724b905e310c4919e9515ff326641f84819202921af871388bd7ea53"
+      "digest": "sha256:931a50e413656f4dcd95db2451b5fc63c985b13494b4b01b492d8292529f4fcb"
     },
     {
       "path": "rules/planr-design/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -802,9 +898,41 @@
       "path": "rules/planr-plan/schemas/design-review-handoff.schema.json",
       "digest": "sha256:402b25238f93f8269b98697bf77fa11dda1fd284f44e41d73cdb813f5244a4e0"
     },
+    {
+      "path": "rules/planr-plan/scripts/design-artifact-shell.mjs",
+      "digest": "sha256:9245a86f8e3f20f6ec4c705d1364d2d6d3e639b34a7d41162769a0f490dd39df"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-document.mjs",
+      "digest": "sha256:7e15b9f9e9afd29be2a2558fad9e57b5df85e494a586180d5afe23015cdbcfb7"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-entities.mjs",
+      "digest": "sha256:376ec35d0f184deac31b639f2c0918e6b0f165e19984ed1c89ba2cfad6af9b80"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-parse5-parser.mjs",
+      "digest": "sha256:a9bfeecae4d31155a6935455c82ea8348da25f8585216b531d00c6599b8196e4"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-parse5-tokenizer.mjs",
+      "digest": "sha256:f655474fb8d0bed732f01ace5b67102f849b73cb40831a57f1fb7b61180fbde9"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-review-handoff.mjs",
+      "digest": "sha256:1d04e0d821738f3934fb3fbd314b161fb557f4459cf2da2d1921c99d27d7d861"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-sandbox-guards.mjs",
+      "digest": "sha256:dcc7aa1971da47018a198bfe7520c05e3e5ba21fe2d9c8fffcaad882ded5bbbb"
+    },
+    {
+      "path": "rules/planr-plan/scripts/design-share.mjs",
+      "digest": "sha256:b10d7ce9cdb3eb48b9aca803e4d2ecc4f8e477e91f4a0c6a3ae17a1f7985aa06"
+    },
     {
       "path": "rules/planr-plan/scripts/design.mjs",
-      "digest": "sha256:1fd130d914dd6b84992007fcf300b6083e04ee3983beaf1718cd1866a26b4d7a"
+      "digest": "sha256:ab33412cab749120e07359983f85bcb64038026844c06ff9f464c4f371d6d6ca"
     },
     {
       "path": "rules/planr-plan/scripts/planning-ids.mjs",
@@ -844,11 +972,11 @@
     },
     {
       "path": "rules/planr-plan/scripts/runtime/packages/design/templates/studio/studio.js",
-      "digest": "sha256:8e0ae7d5ddbb058f4b3f7a0876ce8259dd247358c40ce666763e9001b3bc5338"
+      "digest": "sha256:85f8b084457aaa172025fb878b64059782cb976f72451b207c7bc40e8c982bb8"
     },
     {
       "path": "rules/planr-plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:344e2118724b905e310c4919e9515ff326641f84819202921af871388bd7ea53"
+      "digest": "sha256:931a50e413656f4dcd95db2451b5fc63c985b13494b4b01b492d8292529f4fcb"
     },
     {
       "path": "rules/planr-plan/scripts/runtime/packages/protocol/registries/artifact-theme.json",
@@ -1004,12 +1132,12 @@
     },
     {
       "path": "rules/planr-sync.mdc",
-      "digest": "sha256:e48f085feb6eddade1ce4ec3c61d46da536780ebfcb2159f9719b6ced6284fcf"
+      "digest": "sha256:81a59f2c726e53d987105982f8aa334a7e34006ad0c6dd6520537e032e9b7e40"
     },
     {
       "path": "rules/planr-sync/scripts/sync.mjs",
-      "digest": "sha256:42fb430add6e96c73a8d1c5ea5df7a6ce0bdffc20b9c375eff9333c6c741b308"
+      "digest": "sha256:005397d703d8df70f346a789d15c665a44329449418b39e807bb0dff927153da"
     }
   ],
-  "contentDigest": "sha256:18ebc9b760500ddf4527f4520a39d867c47f74aa3ba597b49642b37dbd2c880f"
+  "contentDigest": "sha256:7c55cf0211b90504db48631acb137211e170a2d5fad2ec03720cd4fd2898faae"
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "openplanr",
-  "version": "2.2639.4",
+  "version": "2.2640.0",
   "ruleCount": 27,
   "rules": [
     "rules/planr-artifact.mdc",