Document Cursor plugin export workflow (#19)

Author: chubes4

README.md

@@ -123,6 +123,28 @@ pnpm build
 pnpm verify
 ```
 
+## Cursor Publishing
+
+Cursor requires a standalone plugin repository. This repo remains the canonical source for shared WordPress skills and generated plugin packaging, while the publishable Cursor repository lives at:
+
+https://github.com/Automattic/wordpress-cursor-plugin
+
+Do not edit the standalone Cursor repository as the source of truth. Update `skills/` and the Cursor packaging generator here, run the normal build and verification, then export `plugins/cursor/` to the standalone repo:
+
+```bash
+pnpm build
+pnpm verify
+pnpm export:cursor
+```
+
+The export command runs `git subtree split --prefix=plugins/cursor` and pushes the result to `Automattic/wordpress-cursor-plugin` on `sync/from-build-with-wordpress`. Open or update a PR from that branch into the standalone repo's `main` branch, then submit the standalone repo to Cursor.
+
+For a dry run:
+
+```bash
+pnpm export:cursor -- --dry-run
+```
+
 ## Output
 
 The Codex plugin repo is generated to:

package.json

@@ -7,6 +7,7 @@
   "scripts": {
     "build": "node scripts/build-telemetry-mcp.mjs && node scripts/build-plugins.mjs",
     "build:telemetry-mcp": "node scripts/build-telemetry-mcp.mjs",
+    "export:cursor": "node scripts/export-cursor-plugin.mjs",
     "verify": "node scripts/verify-plugins.mjs"
   },
   "dependencies": {

scripts/export-cursor-plugin.mjs

@@ -0,0 +1,53 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+
+const cursorPrefix = "plugins/cursor";
+const defaultRemote = "https://github.com/Automattic/wordpress-cursor-plugin.git";
+const defaultBranch = "sync/from-build-with-wordpress";
+
+const args = process.argv.slice(2);
+const dryRun = args.includes("--dry-run");
+const remote = readOption("--remote") ?? defaultRemote;
+const branch = readOption("--branch") ?? defaultBranch;
+const splitBranch = `export-wordpress-cursor-plugin-${Date.now()}`;
+
+if (!existsSync(cursorPrefix)) {
+  throw new Error(`${cursorPrefix} does not exist. Run pnpm build first.`);
+}
+
+if (!dryRun) {
+  const status = run("git", ["status", "--porcelain"], { capture: true });
+  if (status.trim()) {
+    throw new Error("Working tree must be clean before exporting the Cursor plugin.");
+  }
+}
+
+runStep("Create subtree split", ["git", "subtree", "split", `--prefix=${cursorPrefix}`, "-b", splitBranch]);
+runStep("Push split branch", ["git", "push", remote, `${splitBranch}:refs/heads/${branch}`]);
+runStep("Remove local split branch", ["git", "branch", "-D", splitBranch]);
+
+console.log(`Cursor plugin export branch: ${branch}`);
+console.log("Open or update a PR in https://github.com/Automattic/wordpress-cursor-plugin");
+
+function readOption(name) {
+  const index = args.indexOf(name);
+  if (index === -1) {
+    return undefined;
+  }
+  return args[index + 1];
+}
+
+function runStep(label, command) {
+  console.log(`${label}: ${command.join(" ")}`);
+  if (dryRun) {
+    return;
+  }
+  run(command[0], command.slice(1));
+}
+
+function run(command, commandArgs, options = {}) {
+  return execFileSync(command, commandArgs, {
+    encoding: "utf8",
+    stdio: options.capture ? ["ignore", "pipe", "inherit"] : "inherit",
+  });
+}