@brainervirus/workit-cli 0.7.1 → 0.8.1

package/README.md

@@ -1,6 +1,10 @@
 # @brainervirus/workit-cli
 
-The workit CLI — an interactive wizard that configures workit for OpenCode and/or Cursor.
+The workit CLI — an interactive Ink wizard that configures workit for OpenCode and/or Cursor, plus an offline installation doctor.
+
+## Requirements
+
+- **Node.js ≥ 22** — the published CLI is a self-contained Node bundle (no Bun runtime). Node 21 and below fail (`ERR_MODULE_NOT_FOUND`/ESM syntax or the `>=22` engine gate).
 
 ## Install
 
@@ -13,10 +17,31 @@ npx @brainervirus/workit-cli init
 ## Usage
 
 ```bash
-workit init
+workit init              # interactive setup wizard
+workit doctor            # offline installation health report
+workit doctor --json     # machine-readable report
+workit                   # help
+```
+
+`workit init` guides you through: platform selection (OpenCode/Cursor), global config (locale, timezone, branch policy), YouTrack, VCS, workspaces (path globs → provider), and project hygiene files. The wizard is a TTY application — `workit init` requires an interactive terminal and prints guidance (exiting nonzero) when stdin is not a TTY.
+
+`workit doctor` checks the offline installation health and exits nonzero when problems are found; `--json` prints the full report as JSON instead of the human-readable table.
+
+## Behavior
+
+- **Safe apply semantics** — a malformed `config.json` is detected before the wizard renders and reported as a friendly blocked output instead of crashing; the same guard runs after the Apply preview.
+- **Stable interaction** — unchanged wizard inputs are no-ops; they settle without React render warnings and never discard draft state.
+- **Clean terminal** — only `warn`/`error` diagnostics print to stderr; routine structured `info` records stay in the JSONL journal. Nonzero failures and human-readable errors remain visible.
+- **Node support** — the packed CLI runs on Node 22+; installation on Node 22.19 emits no engine warning from workit's dependency tree.
+
+## Package scripts
+
+```bash
+bun run build       # bundle dist/index.js (self-contained, Node shebang) + assets
+bun run typecheck   # tsc --noEmit
 ```
 
-Guides you through: platform selection (OpenCode/Cursor), global config (locale, timezone, branch policy), YouTrack, VCS, workspaces (path globs → provider), and project hygiene files.
+The build produces a nonsplitting `dist/index.js` with a portable `#!/usr/bin/env node` shebang and copies the deterministic `assets/` (templates) from core.
 
 ## Docs
 

package/dist/index.js

@@ -42763,9 +42763,9 @@ function writeFileExclusive(file, content, mode) {
 
 // packages/workit-core/src/core/setup.ts
 import {
-  chmodSync,
+  copyFileSync as copyFileSync2,
   cpSync as cpSync2,
-  existsSync as existsSync9,
+  existsSync as existsSync8,
   mkdirSync as mkdirSync3,
   mkdtempSync,
   readFileSync as readFileSync8,
@@ -42872,7 +42872,6 @@ var readSetupState = (dir = resolveConfigDir()) => ({
 });
 
 // packages/workit-core/src/core/registration.ts
-import { existsSync as existsSync6 } from "node:fs";
 import path6 from "node:path";
 var isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 var named = (s, name) => s === name || s.startsWith(`${name}@`);
@@ -42880,7 +42879,7 @@ function isWorkitPlugin(value) {
   const s = String(value).replaceAll("\\", "/");
   const url = s.startsWith("file://") || s.startsWith("git+file://");
   const pkgPath = s.includes("/packages/workit-opencode/") || s.includes("/packages/workit-cursor/") || s.includes("/node_modules/@brainervirus/workit-opencode/") || s.includes("/node_modules/@brainervirus/workit-cursor/");
-  return named(s, "workflow-toolkit") || named(s, "workflow-toolkit-opencode") || named(s, "local/workflow-toolkit") || named(s, "@brainervirus/workit-opencode") || named(s, "@brainervirus/workit-cursor") || url && pkgPath || s.startsWith("git+file://") && s.includes("workflow-toolkit");
+  return named(s, "workflow-toolkit") || named(s, "workflow-toolkit-opencode") || named(s, "local/workflow-toolkit") || named(s, "workit") || named(s, "local/workit") || named(s, "@brainervirus/workit-opencode") || named(s, "@brainervirus/workit-cursor") || url && pkgPath || s.startsWith("git+file://") && s.includes("workflow-toolkit");
 }
 function mergeOpenCodePlugins(plugin, pin) {
   const existing = Array.isArray(plugin) ? plugin : typeof plugin === "string" ? [plugin] : [];
@@ -42911,7 +42910,8 @@ function mergeOpenCodeConfig(config, pin) {
 }
 function mergeCursorEnabledPlugins(enabled) {
   const prev = isRecord(enabled) ? { ...enabled } : {};
-  const next = { ...prev, "workflow-toolkit": true };
+  const next = { ...prev, workit: true };
+  delete next["workflow-toolkit"];
   delete next["local/workflow-toolkit"];
   const changed = JSON.stringify(next) !== JSON.stringify(prev) ? ["enabled_plugins"] : [];
   return { config: next, changed };
@@ -42922,10 +42922,12 @@ function mergeCursorPluginDirs(pluginDirs, pluginDir) {
     return path6.dirname(j) === j ? j : j.replace(/[\\/]+$/, "");
   };
   const normalized = strip(pluginDir);
+  const legacy = strip(path6.join(path6.dirname(pluginDir), "workflow-toolkit"));
   const prev = Array.isArray(pluginDirs) ? pluginDirs.map(String) : [];
-  const exists = prev.some((d) => strip(d) === normalized);
-  const next = exists ? prev : [...prev, normalized];
-  const changed = next.length !== prev.length ? ["plugin_dirs"] : [];
+  const kept = prev.filter((d) => strip(d) !== legacy);
+  const exists = kept.some((d) => strip(d) === normalized);
+  const next = exists ? kept : [...kept, normalized];
+  const changed = JSON.stringify(next) !== JSON.stringify(prev) ? ["plugin_dirs"] : [];
   return { config: next, changed };
 }
 function mergeCursorSettings(settings, pluginDir) {
@@ -42952,35 +42954,36 @@ function mergeCursorMcp(mcp, serverName, server) {
   base2.mcpServers = servers;
   return { config: base2, changed };
 }
-function cursorMcpServerEntry(packageDir) {
-  if (existsSync6(path6.join(packageDir, "dist", "mcp-server.js"))) {
-    return {
-      command: "node",
-      args: [path6.join(packageDir, "dist", "mcp-server.js"), "${workspaceFolder}"]
-    };
-  }
+var CURSOR_RUNTIME_PACKAGE = "@brainervirus/workit-cursor@0.8.0";
+function cursorMcpServerEntry(_packageDir) {
+  return {
+    command: "npx",
+    args: ["-y", `--package=${CURSOR_RUNTIME_PACKAGE}`, "workit-cursor-mcp", "${workspaceFolder}"]
+  };
+}
+function cursorHooksEntry(_packageDir) {
   return {
-    command: "bash",
-    args: [path6.join(packageDir, "mcp", "run-server.sh"), "${workspaceFolder}"]
+    command: `npx -y --package=${CURSOR_RUNTIME_PACKAGE} workit-cursor-session-start`,
+    args: []
   };
 }
 
 // packages/workit-core/src/core/doctor.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync7, statSync as statSync2, unlinkSync, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync7, statSync as statSync2, unlinkSync, writeFileSync as writeFileSync4 } from "node:fs";
 import os4 from "node:os";
 import path8 from "node:path";
 
 // packages/workit-core/src/core/support-matrix.ts
 var SUPPORT_MATRIX = {
   bun: "1.3.14",
-  node: { minimum: "20", current: "22" },
+  node: { minimum: "22", current: "22" },
   opencode: { minimum: "1.15.0", current: "1.17.7" },
   os: ["ubuntu-latest", "macos-latest", "windows-latest"]
 };
 
 // packages/workit-core/src/core/skill-manifests.ts
-import { existsSync as existsSync7, readFileSync as readFileSync6, readdirSync as readdirSync2, statSync } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6, readdirSync as readdirSync2, statSync } from "node:fs";
 import path7 from "node:path";
 var CANONICAL_SKILLS = {
   superpowers: [
@@ -43014,7 +43017,7 @@ var CANONICAL_SKILLS = {
     "wk-verify"
   ]
 };
-var skillManifestNames = (root) => existsSync7(root) ? readdirSync2(root).filter((name) => existsSync7(path7.join(root, name, "SKILL.md"))).sort() : [];
+var skillManifestNames = (root) => existsSync6(root) ? readdirSync2(root).filter((name) => existsSync6(path7.join(root, name, "SKILL.md"))).sort() : [];
 var validateSkillManifests = (root, expected, label) => {
   const actual = skillManifestNames(root);
   const missing = expected.filter((name) => !actual.includes(name));
@@ -43050,7 +43053,7 @@ var TOKEN_PLACEHOLDER = "YOUR_TOKEN_HERE";
 var findDevFromCwd = (cwd2) => {
   let dir = path8.resolve(cwd2);
   while (true) {
-    if (existsSync8(path8.join(dir, "packages", "workit-core", "package.json")))
+    if (existsSync7(path8.join(dir, "packages", "workit-core", "package.json")))
       return dir;
     const parent = path8.dirname(dir);
     if (parent === dir)
@@ -43075,7 +43078,7 @@ var resolve = (options) => {
     opencodeConfig: options.opencodeConfig ?? path8.join(home, ".config", "opencode", "opencode.json"),
     cursorSettings: options.cursorSettings ?? path8.join(home, ".cursor", "settings.json"),
     cursorMcp: options.cursorMcp ?? path8.join(home, ".cursor", "mcp.json"),
-    cursorPluginDir: options.cursorPluginDir ?? path8.join(home, ".cursor", "plugins", "local", "workflow-toolkit"),
+    cursorPluginDir: options.cursorPluginDir ?? path8.join(home, ".cursor", "plugins", "local", "workit"),
     env: env3,
     installer: options.installer ?? false
   };
@@ -43136,14 +43139,14 @@ var semverAtLeast = (version, min2) => {
   return true;
 };
 var resolveBun = (env3) => {
-  if (env3.BUN && existsSync8(env3.BUN))
+  if (env3.BUN && existsSync7(env3.BUN))
     return env3.BUN;
   for (const candidate of [
     path8.join(os4.homedir(), ".bun/bin/bun"),
     "/usr/local/bin/bun",
     "/usr/bin/bun"
   ]) {
-    if (existsSync8(candidate))
+    if (existsSync7(candidate))
       return candidate;
   }
   return commandOnPath("bun", env3) ? "bun" : null;
@@ -43253,7 +43256,6 @@ var assetPathsFor = (host, dev) => {
       return [
         path8.join(pkg, "assets", "templates", "spec-template.md"),
         path8.join(pkg, "mcp.json"),
-        path8.join(pkg, "marketplace.json"),
         path8.join(pkg, ".cursor-plugin")
       ];
     case "cli":
@@ -43263,7 +43265,7 @@ var assetPathsFor = (host, dev) => {
 var hostsFor = (host) => host === "cli" ? ["opencode", "cursor", "cli"] : [host];
 var checkAssets = (res) => {
   const dev = res.dev;
-  const missing = dev ? hostsFor(res.host).flatMap((h) => assetPathsFor(h, dev).filter((p) => !existsSync8(p)).map((p) => `${h}: ${p}`)) : [];
+  const missing = dev ? hostsFor(res.host).flatMap((h) => assetPathsFor(h, dev).filter((p) => !existsSync7(p)).map((p) => `${h}: ${p}`)) : [];
   if (res.host === "cursor" || res.host === "cli") {
     const cursorError = validateCursorSkills(res.cursorPluginDir);
     if (cursorError)
@@ -43297,11 +43299,8 @@ var launcherSlotsFor = (host, dev) => {
       return [[path8.join(pkg, "src", "plugin.ts"), path8.join(pkg, "dist", "plugin.js")]];
     case "cursor":
       return [
-        [path8.join(pkg, "dist", "mcp-server.js"), path8.join(pkg, "mcp", "run-server.sh")],
-        [
-          path8.join(pkg, "dist", "cursor-session-start.js"),
-          path8.join(pkg, "hooks", "session-start")
-        ]
+        [path8.join(pkg, "dist", "mcp-server.js")],
+        [path8.join(pkg, "dist", "cursor-session-start.js")]
       ];
     case "cli":
       return [[path8.join(pkg, "src", "index.tsx"), path8.join(pkg, "dist", "index.js")]];
@@ -43320,7 +43319,7 @@ var validNodeEntry = (entry, runtime, env3) => {
   }
 };
 var registeredCursorLauncher = (res) => {
-  if (!existsSync8(res.cursorMcp))
+  if (!existsSync7(res.cursorMcp))
     return "invalid";
   const config = readJson(res.cursorMcp);
   if (!config)
@@ -43334,28 +43333,60 @@ var registeredCursorLauncher = (res) => {
     return "invalid";
   }
   const executable = path8.basename(command).toLowerCase();
+  if (executable === "npx" || executable === "npx.exe" || executable === "npx.cmd") {
+    if (args[0] !== "-y")
+      return "invalid";
+    if (args[1] !== `--package=${CURSOR_RUNTIME_PACKAGE}`)
+      return "invalid";
+    if (args[2] !== "workit-cursor-mcp")
+      return "invalid";
+    return { kind: "npx" };
+  }
   if (executable !== "node" && executable !== "node.exe")
     return "invalid";
   return {
+    kind: "node",
     runtime: command,
     entry: path8.isAbsolute(args[0]) ? args[0] : path8.resolve(path8.dirname(res.cursorMcp), args[0])
   };
 };
+var canonicalCursorHook = cursorHooksEntry("").command;
+var registeredCursorHook = (res) => {
+  const hooksFile = path8.join(res.cursorPluginDir, "hooks", "hooks-cursor.json");
+  if (!existsSync7(hooksFile))
+    return "invalid";
+  const config = readJson(hooksFile);
+  if (!config)
+    return "invalid";
+  const sessionStart = config.hooks?.sessionStart;
+  if (!Array.isArray(sessionStart) || sessionStart.length !== 1)
+    return "invalid";
+  const entry = sessionStart[0];
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+    return "invalid";
+  return typeof entry.command === "string" ? entry.command : "invalid";
+};
 var checkLauncher = (res) => {
   const dev = res.dev;
   const hosts = hostsFor(res.host);
   const registered = hosts.includes("cursor") ? registeredCursorLauncher(res) : null;
-  const runtime = registered && registered !== "invalid" ? registered.runtime : "node";
+  const runtime = registered && registered !== "invalid" && registered.kind === "node" ? registered.runtime : "node";
   const missing = hosts.includes("cursor") ? ["dist/mcp-server.js", "dist/cursor-session-start.js"].map((rel) => path8.join(res.cursorPluginDir, rel)).filter((p) => !validNodeEntry(p, runtime, res.env)).map((p) => `cursor: ${p}`) : [];
   if (hosts.includes("cursor")) {
     if (registered === "invalid") {
       missing.push(`cursor: canonical workit MCP launcher in ${res.cursorMcp}`);
-    } else if (registered && !validNodeEntry(registered.entry, registered.runtime, res.env)) {
+    } else if (registered && registered.kind === "node" && !validNodeEntry(registered.entry, registered.runtime, res.env)) {
       missing.push(`cursor: registered ${registered.entry}`);
     }
+    const hook = registeredCursorHook(res);
+    if (hook === "invalid") {
+      missing.push(`cursor: canonical session-start hook in ${path8.join(res.cursorPluginDir, "hooks", "hooks-cursor.json")}`);
+    } else if (hook !== null && hook !== canonicalCursorHook) {
+      missing.push(`cursor: canonical session-start hook in ${path8.join(res.cursorPluginDir, "hooks", "hooks-cursor.json")} (registered ${hook})`);
+    }
   }
   if (dev) {
-    missing.push(...hosts.filter((h) => h !== "cursor").flatMap((h) => launcherSlotsFor(h, dev).filter((slot) => !slot.some((p) => existsSync8(p))).map((slot) => `${h}: ${slot.join(" or ")}`)));
+    missing.push(...hosts.filter((h) => h !== "cursor").flatMap((h) => launcherSlotsFor(h, dev).filter((slot) => !slot.some((p) => existsSync7(p))).map((slot) => `${h}: ${slot.join(" or ")}`)));
   }
   if (missing.length > 0) {
     return {
@@ -43401,7 +43432,7 @@ var staleEntry = (entry) => {
     return "stale";
   if (entry.startsWith("file:")) {
     const target = entry.replace(/^file:\/\//, "").replace(/^file:/, "");
-    return existsSync8(target) ? "ok" : "missing-file";
+    return existsSync7(target) ? "ok" : "missing-file";
   }
   return "ok";
 };
@@ -43413,7 +43444,7 @@ var checkStalePin = (res) => {
       detail: "opencode pin not inspected on the cursor host"
     };
   }
-  if (!existsSync8(res.opencodeConfig)) {
+  if (!existsSync7(res.opencodeConfig)) {
     return { id: "stale_pin", status: "pass", detail: "no opencode config — not registered" };
   }
   const cfg = readJson(res.opencodeConfig);
@@ -43449,13 +43480,13 @@ var checkDuplicateRegistration = (res) => {
   const problems = [];
   const opencodeHost = res.host !== "cursor";
   const cursorHost = res.host !== "opencode";
-  if (opencodeHost && existsSync8(res.opencodeConfig)) {
+  if (opencodeHost && existsSync7(res.opencodeConfig)) {
     const cfg = readJson(res.opencodeConfig);
     const entries = pluginEntries(cfg);
     if (entries.length > 1)
       problems.push(`opencode registers ${entries.length} workit plugin entries`);
   }
-  if (cursorHost && existsSync8(res.cursorSettings)) {
+  if (cursorHost && existsSync7(res.cursorSettings)) {
     const settings = readJson(res.cursorSettings);
     const enabled = settings?.enabled_plugins;
     if (enabled && typeof enabled === "object") {
@@ -43463,11 +43494,14 @@ var checkDuplicateRegistration = (res) => {
       if (keys2.length > 1)
         problems.push(`cursor enables ${keys2.length} workit plugin identities (${keys2.join(", ")})`);
     }
-    const dirs = Array.isArray(settings?.plugin_dirs) ? settings.plugin_dirs.map(String).filter((d) => isWorkitPlugin(d) || d.includes("workflow-toolkit")) : [];
+    const dirs = Array.isArray(settings?.plugin_dirs) ? settings.plugin_dirs.map(String).filter((d) => {
+      const n = d.replaceAll("\\", "/").replace(/\/+$/, "");
+      return isWorkitPlugin(d) || n.endsWith("local/workit") || n.endsWith("local/workflow-toolkit");
+    }) : [];
     if (dirs.length > 1)
       problems.push(`cursor plugin_dirs has ${dirs.length} workit entries`);
   }
-  if (cursorHost && existsSync8(res.cursorMcp)) {
+  if (cursorHost && existsSync7(res.cursorMcp)) {
     const mcp = readJson(res.cursorMcp);
     const servers = mcp?.mcpServers ?? {};
     if (servers && typeof servers === "object") {
@@ -43490,16 +43524,16 @@ var checkMalformedConfig = (res) => {
   const files = [];
   for (const name of ["config.json", "youtrack.json", "vcs.json", "workspaces.json"]) {
     const p = path8.join(res.configDir, name);
-    if (existsSync8(p))
+    if (existsSync7(p))
       files.push(p);
   }
   const opencodeHost = res.host !== "cursor";
   const cursorHost = res.host !== "opencode";
-  if (opencodeHost && existsSync8(res.opencodeConfig))
+  if (opencodeHost && existsSync7(res.opencodeConfig))
     files.push(res.opencodeConfig);
-  if (cursorHost && existsSync8(res.cursorSettings))
+  if (cursorHost && existsSync7(res.cursorSettings))
     files.push(res.cursorSettings);
-  if (cursorHost && existsSync8(res.cursorMcp))
+  if (cursorHost && existsSync7(res.cursorMcp))
     files.push(res.cursorMcp);
   const bad = files.filter((p) => !parsesAsConfigObject(p));
   if (bad.length === 0)
@@ -43513,7 +43547,7 @@ var checkMalformedConfig = (res) => {
 };
 var checkWorkspaceMismatch = (res) => {
   const file = path8.join(res.configDir, "workspaces.json");
-  if (!existsSync8(file))
+  if (!existsSync7(file))
     return { id: "workspace_mismatch", status: "pass", detail: "no workspaces configured" };
   const ws = readJson(file);
   if (!Array.isArray(ws?.workspaces)) {
@@ -43545,7 +43579,7 @@ var checkCredentialMetadata = (res) => {
   const youtrackJson = readJson(path8.join(res.configDir, "youtrack.json"));
   if (youtrackJson) {
     tokenPaths.push(typeof youtrackJson.tokenFile === "string" ? youtrackJson.tokenFile : path8.join(res.configDir, "youtrack.token"));
-  } else if (existsSync8(path8.join(res.configDir, "youtrack.token"))) {
+  } else if (existsSync7(path8.join(res.configDir, "youtrack.token"))) {
     tokenPaths.push(path8.join(res.configDir, "youtrack.token"));
   }
   const vcsJson = readJson(path8.join(res.configDir, "vcs.json"));
@@ -43554,7 +43588,7 @@ var checkCredentialMetadata = (res) => {
     if (provider && typeof provider === "object") {
       const tf = provider.tokenFile;
       tokenPaths.push(typeof tf === "string" ? tf : path8.join(res.configDir, `${key}.token`));
-    } else if (!vcsJson && existsSync8(path8.join(res.configDir, `${key}.token`))) {
+    } else if (!vcsJson && existsSync7(path8.join(res.configDir, `${key}.token`))) {
       tokenPaths.push(path8.join(res.configDir, `${key}.token`));
     }
   }
@@ -43564,7 +43598,7 @@ var checkCredentialMetadata = (res) => {
   const problems = [];
   for (const raw of tokenPaths) {
     const p = path8.isAbsolute(raw) ? raw : path8.resolve(res.configDir, raw);
-    if (!existsSync8(p)) {
+    if (!existsSync7(p)) {
       problems.push(`${p} is missing`);
       continue;
     }
@@ -43830,7 +43864,7 @@ function buildSetupPreview(values2, opts = {}) {
         path: ytPath,
         value: draft
       });
-      if (existsSync9(tokenPath))
+      if (existsSync8(tokenPath))
         preserved.push(tokenPath);
       else
         mutations.push({
@@ -43869,7 +43903,7 @@ function buildSetupPreview(values2, opts = {}) {
         value: draft
       });
       const activeToken = values2.vcsProvider === "gitlab" ? gitlabToken : githubToken;
-      if (existsSync9(activeToken))
+      if (existsSync8(activeToken))
         preserved.push(activeToken);
       else
         mutations.push({
@@ -43896,7 +43930,7 @@ function buildSetupPreview(values2, opts = {}) {
     if (values2.applyProject) {
       const root = path9.resolve(opts.cwd ?? process.cwd());
       const gitignorePath = path9.join(root, ".gitignore");
-      const existing = existsSync9(gitignorePath) ? readFileSync8(gitignorePath, "utf8") : "";
+      const existing = existsSync8(gitignorePath) ? readFileSync8(gitignorePath, "utf8") : "";
       const existingLines = new Set(existing.split(`
 `).map((l) => l.trim()).filter(Boolean));
       const entries = GITIGNORE_ENTRIES.filter((e) => e.trim() !== "" && !existingLines.has(e.trim()));
@@ -43927,7 +43961,7 @@ var resolveSetupPaths = (options, configDir2) => {
     opencodeConfig: options.opencodeConfig ?? path9.join(home, ".config", "opencode", "opencode.json"),
     cursorSettings: options.cursorSettings ?? path9.join(home, ".cursor", "settings.json"),
     cursorMcp: options.cursorMcp ?? path9.join(home, ".cursor", "mcp.json"),
-    cursorPluginDir: options.cursorPluginDir ?? path9.join(home, ".cursor", "plugins", "local", "workflow-toolkit")
+    cursorPluginDir: options.cursorPluginDir ?? path9.join(home, ".cursor", "plugins", "local", "workit")
   };
 };
 function resolveApply(preview, options) {
@@ -43943,7 +43977,7 @@ var readExisting = (p) => {
   try {
     raw = readFileSync8(p, "utf8");
   } catch {
-    if (existsSync9(p))
+    if (existsSync8(p))
       return { kind: "malformed", error: `${p} is not readable` };
     return { kind: "missing" };
   }
@@ -44117,7 +44151,7 @@ function adapterRoot(platform2, res) {
 var opencodePin = (root) => {
   for (const rel of ["src/plugin.ts", "dist/plugin.js"]) {
     const entry = path9.join(root, rel);
-    if (existsSync9(entry))
+    if (existsSync8(entry))
       return `file://${entry}`;
   }
   return null;
@@ -44165,15 +44199,11 @@ function applyOpenCode(root, res) {
     detail: `pinned ${pin}`
   };
 }
-var cursorMcpManifest = (dir) => JSON.stringify({ mcpServers: { workit: cursorMcpServerEntry(dir) } }, null, 2) + `
-`;
 var samePluginContent = (src, dest, relative = "") => {
   try {
     for (const entry of readdirSync3(src, { withFileTypes: true })) {
       if (entry.name === "node_modules")
         continue;
-      if (relative === "" && entry.name === "mcp.json")
-        continue;
       const source = path9.join(src, entry.name);
       const installed = path9.join(dest, entry.name);
       if (entry.isDirectory()) {
@@ -44184,15 +44214,13 @@ var samePluginContent = (src, dest, relative = "") => {
       }
     }
     for (const entry of readdirSync3(dest, { withFileTypes: true })) {
-      if (existsSync9(path9.join(src, entry.name)))
+      if (existsSync8(path9.join(src, entry.name)))
         continue;
       const rel = path9.join(relative, entry.name);
       if (rel === ".workflow-toolkit-root")
         continue;
       if (relative === "rules" && entry.isFile() && entry.name.endsWith(".mdc"))
         continue;
-      if (relative === "" && entry.name === "mcp.json")
-        continue;
       return false;
     }
     return true;
@@ -44208,7 +44236,7 @@ var preservedCursorRules = (src, dest) => {
     for (const entry of readdirSync3(installedRules, { withFileTypes: true })) {
       if (!entry.isFile() || !entry.name.endsWith(".mdc"))
         continue;
-      if (existsSync9(path9.join(sourceRules, entry.name)))
+      if (existsSync8(path9.join(sourceRules, entry.name)))
         continue;
       preserved.set(entry.name, readFileSync8(path9.join(installedRules, entry.name)));
     }
@@ -44217,10 +44245,10 @@ var preservedCursorRules = (src, dest) => {
 };
 function copyPluginDir(src, dest) {
   const marker = path9.join(dest, ".workflow-toolkit-root");
-  const synced = readFileSafe(marker)?.trim() === src && samePluginContent(src, dest) && readFileSafe(path9.join(dest, "mcp.json")) === cursorMcpManifest(dest);
+  const synced = readFileSafe(marker)?.trim() === src && samePluginContent(src, dest);
   if (synced)
     return "Skipped";
-  const hadDir = existsSync9(dest);
+  const hadDir = existsSync8(dest);
   const rules = preservedCursorRules(src, dest);
   const parent = path9.dirname(dest);
   mkdirSync3(parent, { recursive: true });
@@ -44238,11 +44266,6 @@ function copyPluginDir(src, dest) {
     }
     writeFileSync5(path9.join(stage, ".workflow-toolkit-root"), src + `
 `, "utf8");
-    for (const rel of ["hooks/session-start", "mcp/run-server.sh"]) {
-      try {
-        chmodSync(path9.join(stage, rel), 493);
-      } catch {}
-    }
     if (!samePluginContent(src, stage))
       throw new Error("staged adapter content is incomplete");
     if (hadDir)
@@ -44250,17 +44273,35 @@ function copyPluginDir(src, dest) {
     try {
       renameSync(stage, dest);
     } catch (error) {
-      if (hadDir && !existsSync9(dest))
+      if (hadDir && !existsSync8(dest))
         renameSync(backup, dest);
       throw error;
     }
-    writeFileSync5(path9.join(dest, "mcp.json"), cursorMcpManifest(dest), "utf8");
     rmSync(backup, { recursive: true, force: true });
   } finally {
     rmSync(swap, { recursive: true, force: true });
   }
   return hadDir ? "Configured" : "Installed";
 }
+var removeLegacyCursorDir = (res) => {
+  const legacy = path9.join(res.home, ".cursor", "plugins", "local", "workflow-toolkit");
+  if (legacy === res.cursorPluginDir || !existsSync8(legacy))
+    return;
+  const legacyRules = path9.join(legacy, "rules");
+  if (existsSync8(legacyRules)) {
+    try {
+      mkdirSync3(path9.join(res.cursorPluginDir, "rules"), { recursive: true });
+      for (const entry of readdirSync3(legacyRules, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".mdc"))
+          continue;
+        const target = path9.join(res.cursorPluginDir, "rules", entry.name);
+        if (!existsSync8(target))
+          copyFileSync2(path9.join(legacyRules, entry.name), target);
+      }
+    } catch {}
+  }
+  rmSync(legacy, { recursive: true, force: true });
+};
 function applyCursorSettings(root, res) {
   mkdirSync3(path9.dirname(res.cursorSettings), { recursive: true });
   const settingsExisting = readExisting(res.cursorSettings);
@@ -44318,9 +44359,9 @@ function applyCursorMcp(root, res) {
   };
 }
 function verifyPlatform(platform2, res) {
-  if (platform2 === "opencode" && !existsSync9(res.opencodeConfig))
+  if (platform2 === "opencode" && !existsSync8(res.opencodeConfig))
     return null;
-  if (platform2 === "cursor" && !existsSync9(res.cursorSettings) && !existsSync9(res.cursorMcp)) {
+  if (platform2 === "cursor" && !existsSync8(res.cursorSettings) && !existsSync8(res.cursorMcp)) {
     return null;
   }
   return runDoctor({
@@ -44364,6 +44405,7 @@ function applySetupPreview(preview, options = {}) {
   const res = resolveApply(preview, options);
   const entries = [];
   const rootFor = new Map;
+  let cursorCopyOk = false;
   for (const mutation of preview.mutations) {
     if (mutation.type !== "register-platform" && mutation.type !== "install-adapter") {
       entries.push(applyMutation(mutation));
@@ -44396,7 +44438,9 @@ function applySetupPreview(preview, options = {}) {
     }
     if (mutation.type === "install-adapter") {
       try {
-        entries.push({ platform: platform2, file: mutation.path, status: copyPluginDir(root, mutation.path) });
+        const status = copyPluginDir(root, mutation.path);
+        cursorCopyOk = true;
+        entries.push({ platform: platform2, file: mutation.path, status });
       } catch (error) {
         entries.push({
           platform: platform2,
@@ -44407,10 +44451,15 @@ function applySetupPreview(preview, options = {}) {
       }
     } else if (platform2 === "opencode") {
       entries.push(applyOpenCode(root, res));
+    } else if (!cursorCopyOk) {
+      continue;
     } else {
       entries.push(mutation.path === res.cursorSettings ? applyCursorSettings(root, res) : applyCursorMcp(root, res));
     }
   }
+  if (preview.platforms.includes("cursor") && cursorCopyOk && !entries.some((e) => e.platform === "cursor" && e.status === "Failed")) {
+    removeLegacyCursorDir(res);
+  }
   for (const preserved of preview.preserved) {
     entries.push({
       platform: "core",
@@ -44558,8 +44607,9 @@ function applyWizardBranchPolicy(branchPolicy, workspace_root, env3 = process.en
 }
 
 // packages/workit-cli/src/wizard-state.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import path10 from "node:path";
+import { isDeepStrictEqual as isDeepStrictEqual3 } from "node:util";
 var NEXT = {
   platforms: "locale",
   locale: "timezone",
@@ -44603,7 +44653,7 @@ var PREV = {
   exit: null
 };
 var skipsCustomBranch = (screen, preset) => (screen === "branchAllowed" || screen === "branchProtected") && preset !== "custom";
-var skipsBranchPolicy = (screen) => (screen === "branchPolicy" || screen === "branchPolicyDevelop") && !existsSync10(path10.join(process.env.WORKFLOW_WORKSPACE_ROOT ?? process.cwd(), ".git"));
+var skipsBranchPolicy = (screen) => (screen === "branchPolicy" || screen === "branchPolicyDevelop") && !existsSync9(path10.join(process.env.WORKFLOW_WORKSPACE_ROOT ?? process.cwd(), ".git"));
 function nextScreen(screen, preset) {
   let next = NEXT[screen];
   while (next && (skipsCustomBranch(next, preset) || skipsBranchPolicy(next)))
@@ -44660,6 +44710,9 @@ var decodeBranchPreset = (value, fallback) => value === "gitflow" || value === "
 var decodeVcsProvider = (value, fallback) => value === "gitlab" || value === "github" || value === "skip" ? value : fallback;
 function setTextValue(draft, field, value) {
   const message = field === "locale" ? validateLocale(value) : field === "timezone" ? validateTimezone(value) : field === "branchAllowed" ? parseList(value).length > 0 ? null : "at least one allowed branch pattern is required" : field === "branchProtected" ? parseList(value).length > 0 ? null : "at least one protected branch name is required" : value.trim() === "" ? null : validateBaseUrl(value);
+  if (draft.values[field] === value && (draft.errors[field] ?? undefined) === (message ?? undefined)) {
+    return draft;
+  }
   const errors = { ...draft.errors };
   if (message)
     errors[field] = message;
@@ -44694,24 +44747,24 @@ function reducer3(draft, action) {
     case "set":
       switch (action.field) {
         case "platforms":
+          if (isDeepStrictEqual3(action.value, draft.values.platforms))
+            return draft;
           return { ...draft, values: { ...draft.values, platforms: action.value } };
-        case "branchPreset":
-          return {
-            ...draft,
-            values: {
-              ...draft.values,
-              branchPreset: decodeBranchPreset(action.value, draft.values.branchPreset)
-            }
-          };
-        case "vcsProvider":
-          return {
-            ...draft,
-            values: {
-              ...draft.values,
-              vcsProvider: decodeVcsProvider(action.value, draft.values.vcsProvider)
-            }
-          };
+        case "branchPreset": {
+          const next = decodeBranchPreset(action.value, draft.values.branchPreset);
+          if (next === draft.values.branchPreset)
+            return draft;
+          return { ...draft, values: { ...draft.values, branchPreset: next } };
+        }
+        case "vcsProvider": {
+          const next = decodeVcsProvider(action.value, draft.values.vcsProvider);
+          if (next === draft.values.vcsProvider)
+            return draft;
+          return { ...draft, values: { ...draft.values, vcsProvider: next } };
+        }
         case "applyProject":
+          if (action.value === draft.values.applyProject)
+            return draft;
           return { ...draft, values: { ...draft.values, applyProject: action.value } };
         case "branchPolicyDetected":
           return { ...draft, values: { ...draft.values, branchPolicyDetected: action.value } };
@@ -44732,6 +44785,8 @@ function reducer3(draft, action) {
           const base2 = draft.values.branchPolicy ?? draft.values.branchPolicyDetected;
           if (!base2)
             return draft;
+          if (action.value === base2.integration)
+            return draft;
           return {
             ...draft,
             values: {
@@ -44748,11 +44803,14 @@ function reducer3(draft, action) {
           const base2 = draft.values.branchPolicy ?? draft.values.branchPolicyDetected;
           if (!base2)
             return draft;
+          const next = action.value || undefined;
+          if ((base2.developBranch ?? undefined) === next)
+            return draft;
           return {
             ...draft,
             values: {
               ...draft.values,
-              branchPolicy: { ...base2, developBranch: action.value || undefined }
+              branchPolicy: { ...base2, developBranch: next }
             }
           };
         }
@@ -44874,6 +44932,9 @@ function defaultWorkspaceProvider(vcs) {
 function workspaceDraftText(draft, field, value) {
   const errorKey = field === "name" ? "workspaceName" : "workspaceGlob";
   const message = field === "name" ? value.trim() ? null : "workspace name is required" : value.trim() ? null : "workspace pattern is required";
+  if ((draft.workspaceDraft?.[field] ?? "") === value && (draft.errors[errorKey] ?? undefined) === (message ?? undefined)) {
+    return draft;
+  }
   const errors = { ...draft.errors };
   if (message)
     errors[errorKey] = message;
@@ -46124,8 +46185,12 @@ var createLogger = (options = {}) => {
 // packages/workit-cli/src/index.tsx
 var jsx_dev_runtime2 = __toESM(require_jsx_dev_runtime(), 1);
 var logger = createLogger({
-  stderr: (event) => process.stderr.write(`${JSON.stringify(event)}
-`)
+  stderr: (event) => {
+    if (event.level === "debug" || event.level === "info")
+      return;
+    process.stderr.write(`${JSON.stringify(event)}
+`);
+  }
 });
 var HELP = `workit — workflow rails for agentic coding
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-cli",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "private": false,
   "description": "Workit interactive setup wizard (Ink TUI)",
   "keywords": [
@@ -34,14 +34,14 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@brainervirus/workit-core": "^0.7.1",
-    "@brainervirus/workit-cursor": "^0.7.1",
-    "@brainervirus/workit-opencode": "^0.7.1",
+    "@brainervirus/workit-core": "^0.8.1",
+    "@brainervirus/workit-cursor": "^0.8.1",
+    "@brainervirus/workit-opencode": "^0.8.1",
     "@inkjs/ui": "2.0.0",
     "ink": "7.1.1",
     "react": "19.2.8"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   }
 }