@elitedcs/ghl-mcp 3.61.0 → 3.62.0

package/dist/index.js

@@ -114,8 +114,8 @@ var init_ghl_client = __esm({
           Version: version || GHL_API_VERSION
         };
       }
-      buildUrl(path14, params) {
-        const url = new URL(path14, GHL_BASE_URL);
+      buildUrl(path15, params) {
+        const url = new URL(path15, GHL_BASE_URL);
         if (params) {
           for (const [key, value] of Object.entries(params)) {
             if (value !== void 0 && value !== null) {
@@ -125,8 +125,8 @@ var init_ghl_client = __esm({
         }
         return url.toString();
       }
-      async request(method, path14, options = {}, attempt = 0) {
-        const url = this.buildUrl(path14, options.params);
+      async request(method, path15, options = {}, attempt = 0) {
+        const url = this.buildUrl(path15, options.params);
         const headers = this.buildHeaders(options.version);
         const fetchOptions = {
           method,
@@ -144,14 +144,14 @@ var init_ghl_client = __esm({
         } catch (error) {
           clearTimeout(timeout);
           if (error instanceof Error && error.name === "AbortError") {
-            throw new Error(`Request timeout (30s): ${method} ${path14}`);
+            throw new Error(`Request timeout (30s): ${method} ${path15}`);
           }
           if (!options.noRetry && attempt < MAX_RETRIES) {
             const delay4 = computeRetryDelay(null, attempt, BASE_DELAY_MS);
-            process.stderr.write(`[ghl-mcp] Network error on ${method} ${path14}, retry ${attempt + 1}/${MAX_RETRIES} in ${delay4}ms
+            process.stderr.write(`[ghl-mcp] Network error on ${method} ${path15}, retry ${attempt + 1}/${MAX_RETRIES} in ${delay4}ms
 `);
             await new Promise((r) => setTimeout(r, delay4));
-            return this.request(method, path14, options, attempt + 1);
+            return this.request(method, path15, options, attempt + 1);
           }
           throw error;
         } finally {
@@ -159,10 +159,10 @@ var init_ghl_client = __esm({
         }
         if (!options.noRetry && (response.status === 429 || response.status >= 500) && attempt < MAX_RETRIES) {
           const delay4 = computeRetryDelay(response.headers.get("Retry-After"), attempt, BASE_DELAY_MS);
-          process.stderr.write(`[ghl-mcp] ${response.status} on ${method} ${path14}, retry ${attempt + 1}/${MAX_RETRIES} in ${delay4}ms
+          process.stderr.write(`[ghl-mcp] ${response.status} on ${method} ${path15}, retry ${attempt + 1}/${MAX_RETRIES} in ${delay4}ms
 `);
           await new Promise((r) => setTimeout(r, delay4));
-          return this.request(method, path14, options, attempt + 1);
+          return this.request(method, path15, options, attempt + 1);
         }
         if (!response.ok) {
           let errorBody = "";
@@ -171,7 +171,7 @@ var init_ghl_client = __esm({
           } catch {
           }
           throw new Error(
-            `GHL API Error ${response.status} ${response.statusText}: ${method} ${path14}
+            `GHL API Error ${response.status} ${response.statusText}: ${method} ${path15}
 ${errorBody}`
           );
         }
@@ -183,20 +183,20 @@ ${errorBody}`
           return { message: text };
         }
       }
-      async get(path14, options) {
-        return this.request("GET", path14, options);
+      async get(path15, options) {
+        return this.request("GET", path15, options);
       }
-      async post(path14, options) {
-        return this.request("POST", path14, options);
+      async post(path15, options) {
+        return this.request("POST", path15, options);
       }
-      async put(path14, options) {
-        return this.request("PUT", path14, options);
+      async put(path15, options) {
+        return this.request("PUT", path15, options);
       }
-      async patch(path14, options) {
-        return this.request("PATCH", path14, options);
+      async patch(path15, options) {
+        return this.request("PATCH", path15, options);
       }
-      async delete(path14, options) {
-        return this.request("DELETE", path14, options);
+      async delete(path15, options) {
+        return this.request("DELETE", path15, options);
       }
       /**
        * Helper: resolves locationId from args or falls back to default
@@ -1648,7 +1648,7 @@ Note: Firebase credentials rejected (${fb.error}).`;
       const telemetryLine = telemetryDisabled(process.env) ? "" : `
 
 ${TELEMETRY_DISCLOSURE}`;
-      const finishedCount = isFree ? "108" : "234";
+      const finishedCount = isFree ? "109" : "235";
       const freeTip = isFree ? `
 
 Free tier: read-only. Write tools stay visible but answer with upgrade info instead of acting. Full version ($97/mo founding rate) upgrades in place \u2014 same install, you only swap the license key: https://ghlcommand.com` : "";
@@ -1693,7 +1693,7 @@ Free tier: read-only. Write tools stay visible but answer with upgrade info inst
 function registerEnableWorkflowBuilderTool(server2) {
   server2.tool(
     "enable_workflow_builder",
-    "Add Firebase credentials to an existing GHL Command install to unlock 52 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. On the FREE tier this same login unlocks the read-only auditor suite (audit_workflows, validate_workflow, full-detail workflow/funnel/pipeline reads). Requires you've already run setup_ghl_mcp. EASIEST PATH: run `capture_firebase_interactive` instead \u2014 a Chrome window opens, you log into GHL, zero pasting. Use THIS tool when you have JSON from `auto_capture_firebase_script` (console-paste path) to put in `firebase_paste`, or the three manual DevTools fields. Tool count goes from 182 to 234 after the next Claude restart.",
+    "Add Firebase credentials to an existing GHL Command install to unlock 52 additional tools across the internal-API modules: workflow builder (create/edit/clone/delete/publish/validate workflows, build_if_else_branch, build_goal_event, get_trigger_registry), funnel + page builder, form builder, pipeline builder, workflow cloner, smart lists, reputation, email campaigns, email templates, and memberships, plus the pre-deploy validator. On the FREE tier this same login unlocks the read-only auditor suite (audit_workflows, validate_workflow, full-detail workflow/funnel/pipeline reads). Requires you've already run setup_ghl_mcp. EASIEST PATH: run `capture_firebase_interactive` instead \u2014 a Chrome window opens, you log into GHL, zero pasting. Use THIS tool when you have JSON from `auto_capture_firebase_script` (console-paste path) to put in `firebase_paste`, or the three manual DevTools fields. Tool count goes from 183 to 235 after the next Claude restart.",
     {
       // v3.25.0: one-paste path. Tool runs `auto_capture_firebase_script` to
       // get the console script; the script returns a JSON object that pastes
@@ -1774,7 +1774,7 @@ DevTools steps: https://elitedcs.com/ghl-mcp-firebase`
             "",
             "**You MUST restart Claude before using any workflow-builder tool.** Quit Claude completely (Cmd+Q on Mac, full exit on Windows) and reopen. Without a restart, the workflow builder tools will keep using the OLD Firebase auth from before this call and fail with 401 errors \u2014 even though this tool reported success.",
             "",
-            'After restart, all 234 tools load. Try: "List my workflows in full detail" or "Validate workflow <id>".',
+            'After restart, all 235 tools load. Try: "List my workflows in full detail" or "Validate workflow <id>".',
             "",
             "Note: Firebase refresh tokens rotate every few weeks. If workflow tools stop working in a few weeks (run `health_check` to confirm Firebase auth: FAIL), run `auto_capture_firebase_script` for fresh values and re-run this tool with the new firebase_paste."
           ].join("\n")
@@ -1870,7 +1870,7 @@ The login in the capture window may belong to the wrong GHL account, or the sess
               "",
               "**You MUST restart Claude before using any workflow-builder tool.** Quit Claude completely (Cmd+Q on Mac, full exit on Windows) and reopen.",
               "",
-              'After restart, all 234 tools load. Try: "List my workflows in full detail".',
+              'After restart, all 235 tools load. Try: "List my workflows in full detail".',
               "",
               "Future token rotations re-capture silently \u2014 if workflow tools ever 401, just run capture_firebase_interactive again; no window should appear."
             ].join("\n")
@@ -2471,7 +2471,7 @@ function defaultIO() {
   return {
     out: (l) => process.stdout.write(l + "\n"),
     err: (l) => process.stderr.write(l + "\n"),
-    rename: (from, to) => fs9.renameSync(from, to),
+    rename: (from, to) => fs10.renameSync(from, to),
     sleep: (ms) => new Promise((r) => setTimeout(r, ms))
   };
 }
@@ -2481,32 +2481,32 @@ function candidateConfigPaths(opts) {
   const file = "claude_desktop_config.json";
   const candidates = [];
   if (platform2 === "darwin") {
-    candidates.push(path8.join(home, "Library", "Application Support", "Claude", file));
+    candidates.push(path9.join(home, "Library", "Application Support", "Claude", file));
   } else if (platform2 === "win32") {
-    const appData = opts?.appData ?? process.env.APPDATA ?? path8.join(home, "AppData", "Roaming");
-    candidates.push(path8.join(appData, "Claude", file));
-    const localAppData = opts?.localAppData ?? process.env.LOCALAPPDATA ?? path8.join(home, "AppData", "Local");
-    const packagesDir = path8.join(localAppData, "Packages");
+    const appData = opts?.appData ?? process.env.APPDATA ?? path9.join(home, "AppData", "Roaming");
+    candidates.push(path9.join(appData, "Claude", file));
+    const localAppData = opts?.localAppData ?? process.env.LOCALAPPDATA ?? path9.join(home, "AppData", "Local");
+    const packagesDir = path9.join(localAppData, "Packages");
     try {
-      for (const entry of fs9.readdirSync(packagesDir)) {
+      for (const entry of fs10.readdirSync(packagesDir)) {
         if (entry.startsWith("Claude_")) {
-          candidates.push(path8.join(packagesDir, entry, "LocalCache", "Roaming", "Claude", file));
+          candidates.push(path9.join(packagesDir, entry, "LocalCache", "Roaming", "Claude", file));
         }
       }
     } catch {
     }
   } else {
-    candidates.push(path8.join(home, ".config", "Claude", file));
+    candidates.push(path9.join(home, ".config", "Claude", file));
   }
   return candidates;
 }
 function resolveConfigPath(explicitPath) {
   if (explicitPath) {
-    const p = path8.resolve(explicitPath);
-    return { configPath: p, exists: fs9.existsSync(p) };
+    const p = path9.resolve(explicitPath);
+    return { configPath: p, exists: fs10.existsSync(p) };
   }
   const candidates = candidateConfigPaths();
-  const existing = candidates.filter((c) => fs9.existsSync(c));
+  const existing = candidates.filter((c) => fs10.existsSync(c));
   if (existing.length > 1) {
     throw new InstallStop(
       EXIT_REFUSED,
@@ -2523,22 +2523,22 @@ function resolveConfigPath(explicitPath) {
 function resolveSymlinkPolicy(configPath, explicitPath, home = os4.homedir()) {
   let st;
   try {
-    st = fs9.lstatSync(configPath);
+    st = fs10.lstatSync(configPath);
   } catch {
     return configPath;
   }
   if (!st.isSymbolicLink()) return configPath;
   let real;
   try {
-    real = fs9.realpathSync(configPath);
+    real = fs10.realpathSync(configPath);
   } catch {
     throw new InstallStop(
       EXIT_REFUSED,
       `${configPath} is a link that points to a file that does not exist. Fix or remove the link, or run again with --path to a real file. Nothing was changed.`
     );
   }
-  const rel = path8.relative(path8.resolve(home), real);
-  const outsideHome = rel.startsWith("..") || path8.isAbsolute(rel);
+  const rel = path9.relative(path9.resolve(home), real);
+  const outsideHome = rel.startsWith("..") || path9.isAbsolute(rel);
   if (outsideHome && !explicitPath) {
     throw new InstallStop(
       EXIT_REFUSED,
@@ -2548,8 +2548,8 @@ function resolveSymlinkPolicy(configPath, explicitPath, home = os4.homedir()) {
   return real;
 }
 function readConfigBytes(configPath) {
-  const bytes = fs9.readFileSync(configPath);
-  const stat = fs9.statSync(configPath);
+  const bytes = fs10.readFileSync(configPath);
+  const stat = fs10.statSync(configPath);
   if (bytes.length >= 2 && (bytes[0] === 255 && bytes[1] === 254 || bytes[0] === 254 && bytes[1] === 255)) {
     throw new InstallStop(
       EXIT_REFUSED,
@@ -2623,23 +2623,23 @@ function backupStamp(now) {
 }
 function chooseBackupPath(configPath, now = /* @__PURE__ */ new Date()) {
   const base = `${configPath}.bak-${backupStamp(now)}`;
-  if (!fs9.existsSync(base)) return base;
+  if (!fs10.existsSync(base)) return base;
   for (let i = 2; ; i++) {
     const candidate = `${base}-${i}`;
-    if (!fs9.existsSync(candidate)) return candidate;
+    if (!fs10.existsSync(candidate)) return candidate;
   }
 }
 function writeVerifiedBackup(configPath, originalBytes) {
   const backupPath = chooseBackupPath(configPath);
   try {
-    fs9.writeFileSync(backupPath, originalBytes);
-    const readBack = fs9.readFileSync(backupPath);
+    fs10.writeFileSync(backupPath, originalBytes);
+    const readBack = fs10.readFileSync(backupPath);
     if (!readBack.equals(originalBytes)) {
       throw new Error("backup read-back did not match");
     }
   } catch (e) {
     try {
-      fs9.rmSync(backupPath, { force: true });
+      fs10.rmSync(backupPath, { force: true });
     } catch {
     }
     throw new InstallStop(
@@ -2658,9 +2658,9 @@ function baselineOf(bytes, stat) {
 function assertNotStale(configPath, baseline) {
   let ok = false;
   try {
-    const st = fs9.statSync(configPath);
+    const st = fs10.statSync(configPath);
     if (st.size === baseline.size && st.mtimeMs === baseline.mtimeMs) {
-      ok = sha2562(fs9.readFileSync(configPath)) === baseline.hash;
+      ok = sha2562(fs10.readFileSync(configPath)) === baseline.hash;
     } else {
       ok = false;
     }
@@ -2675,14 +2675,14 @@ function assertNotStale(configPath, baseline) {
   }
 }
 async function atomicReplace(opts) {
-  const dir = path8.dirname(opts.configPath);
-  const tempPath = path8.join(dir, `.${path8.basename(opts.configPath)}.tmp-${process.pid}-${(0, import_node_crypto3.randomBytes)(4).toString("hex")}`);
-  const fd = fs9.openSync(tempPath, "w");
+  const dir = path9.dirname(opts.configPath);
+  const tempPath = path9.join(dir, `.${path9.basename(opts.configPath)}.tmp-${process.pid}-${(0, import_node_crypto3.randomBytes)(4).toString("hex")}`);
+  const fd = fs10.openSync(tempPath, "w");
   try {
-    fs9.writeFileSync(fd, opts.newBytes);
-    fs9.fsyncSync(fd);
+    fs10.writeFileSync(fd, opts.newBytes);
+    fs10.fsyncSync(fd);
   } finally {
-    fs9.closeSync(fd);
+    fs10.closeSync(fd);
   }
   try {
     for (let attempt = 0; ; attempt++) {
@@ -2707,17 +2707,17 @@ async function atomicReplace(opts) {
     }
   } catch (e) {
     try {
-      fs9.rmSync(tempPath, { force: true });
+      fs10.rmSync(tempPath, { force: true });
     } catch {
     }
     throw e;
   }
   try {
-    const dirFd = fs9.openSync(dir, "r");
+    const dirFd = fs10.openSync(dir, "r");
     try {
-      fs9.fsyncSync(dirFd);
+      fs10.fsyncSync(dirFd);
     } finally {
-      fs9.closeSync(dirFd);
+      fs10.closeSync(dirFd);
     }
   } catch {
   }
@@ -2769,7 +2769,7 @@ async function runInstall(argv, ioOverride) {
   try {
     const resolved2 = resolveConfigPath(flags.path);
     const configPath = resolveSymlinkPolicy(resolved2.configPath, flags.path !== void 0);
-    const exists = fs9.existsSync(configPath);
+    const exists = fs10.existsSync(configPath);
     let read = null;
     let outcome;
     if (exists) {
@@ -2799,7 +2799,7 @@ async function runInstall(argv, ioOverride) {
       return EXIT_OK;
     }
     const backupPath = exists && read ? writeVerifiedBackup(configPath, read.bytes) : null;
-    if (!exists) fs9.mkdirSync(path8.dirname(configPath), { recursive: true });
+    if (!exists) fs10.mkdirSync(path9.dirname(configPath), { recursive: true });
     await atomicReplace({
       configPath,
       newBytes,
@@ -2817,13 +2817,13 @@ async function runInstall(argv, ioOverride) {
     return EXIT_ABORTED;
   }
 }
-var fs9, os4, path8, import_node_crypto3, import_node_util, import_json5, SERVER_KEY, DESIRED_ENTRY, EXIT_OK, EXIT_USAGE, EXIT_REFUSED, EXIT_ABORTED, RENAME_RETRY_DELAYS_MS, LOCK_ERROR_CODES, BOM_UTF8, InstallStop;
+var fs10, os4, path9, import_node_crypto3, import_node_util, import_json5, SERVER_KEY, DESIRED_ENTRY, EXIT_OK, EXIT_USAGE, EXIT_REFUSED, EXIT_ABORTED, RENAME_RETRY_DELAYS_MS, LOCK_ERROR_CODES, BOM_UTF8, InstallStop;
 var init_config_installer = __esm({
   "src/config-installer.ts"() {
     "use strict";
-    fs9 = __toESM(require("node:fs"));
+    fs10 = __toESM(require("node:fs"));
     os4 = __toESM(require("node:os"));
-    path8 = __toESM(require("node:path"));
+    path9 = __toESM(require("node:path"));
     import_node_crypto3 = require("node:crypto");
     import_node_util = require("node:util");
     import_json5 = __toESM(require("json5"));
@@ -2854,9 +2854,9 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.61.0",
+      version: "3.62.0",
       mcpName: "io.github.drjerryrelth/ghl-command",
-      description: "GoHighLevel MCP Server for Claude. 234 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
+      description: "GoHighLevel MCP Server for Claude. 235 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
       bin: {
         "ghl-mcp": "dist/index.js"
@@ -2871,7 +2871,8 @@ var require_package = __commonJS({
         "templates/external-funnel/README.md",
         "README.md",
         "CHANGELOG.md",
-        "skills"
+        "skills",
+        "guide"
       ],
       scripts: {
         build: "esbuild src/index.ts --bundle --platform=node --target=node20 --format=cjs --outfile=dist/index.js --packages=external && esbuild src/capture-helper.ts --bundle --platform=node --target=node20 --format=cjs --outfile=dist/capture-helper.js --packages=external",
@@ -2945,7 +2946,7 @@ function launchCommand(port = 7300) {
   return `npx -y @elitedcs/ghl-mcp@latest dashboard --port=${port}`;
 }
 function installingEntry() {
-  return path10.join(__dirname, "index.js");
+  return path11.join(__dirname, "index.js");
 }
 function planLauncher(platform2, home, port = 7300, entry = installingEntry()) {
   const cmd = launchCommand(port);
@@ -2953,12 +2954,12 @@ function planLauncher(platform2, home, port = 7300, entry = installingEntry()) {
     const systemApps = "/Applications";
     let base = home;
     try {
-      fs11.accessSync(systemApps, fs11.constants.W_OK);
+      fs12.accessSync(systemApps, fs12.constants.W_OK);
       base = "";
     } catch {
     }
-    const appDir = base ? path10.join(home, "Applications", "Command OS.app") : path10.join(systemApps, "Command OS.app");
-    const macOSDir = path10.join(appDir, "Contents", "MacOS");
+    const appDir = base ? path11.join(home, "Applications", "Command OS.app") : path11.join(systemApps, "Command OS.app");
+    const macOSDir = path11.join(appDir, "Contents", "MacOS");
     const script = [
       "#!/bin/bash",
       "# GHL Command \u2014 Command OS launcher (regenerate: ghl-mcp install-launcher)",
@@ -2987,13 +2988,13 @@ function planLauncher(platform2, home, port = 7300, entry = installingEntry()) {
       targetPath: appDir,
       humanLocation: base ? "your personal Applications folder at ~/Applications (Finder \u2192 Go \u2192 Home \u2192 Applications)" : "your Applications folder \u2014 open Finder \u2192 Applications and look for \u201CCommand OS\u201D",
       files: [
-        { path: path10.join(macOSDir, "command-os"), contents: script, executable: true },
-        { path: path10.join(appDir, "Contents", "Info.plist"), contents: plist, executable: false }
+        { path: path11.join(macOSDir, "command-os"), contents: script, executable: true },
+        { path: path11.join(appDir, "Contents", "Info.plist"), contents: plist, executable: false }
       ]
     };
   }
   if (platform2 === "win32") {
-    const target2 = path10.join(home, "Desktop", "Command OS.cmd");
+    const target2 = path11.join(home, "Desktop", "Command OS.cmd");
     return {
       platform: platform2,
       targetPath: target2,
@@ -3006,7 +3007,7 @@ function planLauncher(platform2, home, port = 7300, entry = installingEntry()) {
       ].join("\r\n"), executable: false }]
     };
   }
-  const target = path10.join(home, ".local", "share", "applications", "command-os.desktop");
+  const target = path11.join(home, ".local", "share", "applications", "command-os.desktop");
   return {
     platform: platform2,
     targetPath: target,
@@ -3033,8 +3034,8 @@ function installLauncher(argv = []) {
   const plan = planLauncher(process.platform, os5.homedir(), port, installingEntry());
   try {
     for (const f of plan.files) {
-      fs11.mkdirSync(path10.dirname(f.path), { recursive: true });
-      fs11.writeFileSync(f.path, f.contents, { mode: f.executable ? 493 : 420 });
+      fs12.mkdirSync(path11.dirname(f.path), { recursive: true });
+      fs12.writeFileSync(f.path, f.contents, { mode: f.executable ? 493 : 420 });
     }
   } catch (e) {
     process.stderr.write(`
@@ -3054,13 +3055,13 @@ function installLauncher(argv = []) {
   ].join("\n"));
   return 0;
 }
-var fs11, os5, path10;
+var fs12, os5, path11;
 var init_launcher = __esm({
   "src/launcher.ts"() {
     "use strict";
-    fs11 = __toESM(require("fs"));
+    fs12 = __toESM(require("fs"));
     os5 = __toESM(require("os"));
-    path10 = __toESM(require("path"));
+    path11 = __toESM(require("path"));
   }
 });
 
@@ -3089,10 +3090,10 @@ function stageBlockedBy(stages, stage) {
   return null;
 }
 function claudeBin() {
-  const fallback = path11.join(os6.homedir(), ".local", "bin", "claude");
-  const fromPath = (process.env.PATH || "").split(path11.delimiter).map((d) => path11.join(d, "claude")).find((p) => {
+  const fallback = path12.join(os6.homedir(), ".local", "bin", "claude");
+  const fromPath = (process.env.PATH || "").split(path12.delimiter).map((d) => path12.join(d, "claude")).find((p) => {
     try {
-      fs12.accessSync(p, fs12.constants.X_OK);
+      fs13.accessSync(p, fs13.constants.X_OK);
       return true;
     } catch {
       return false;
@@ -3100,7 +3101,7 @@ function claudeBin() {
   });
   if (fromPath) return fromPath;
   try {
-    fs12.accessSync(fallback, fs12.constants.X_OK);
+    fs13.accessSync(fallback, fs13.constants.X_OK);
     return fallback;
   } catch {
   }
@@ -3149,10 +3150,10 @@ function runStage(locationId2, stage, onEvent, opts = {}) {
   const locationName = SANDBOX_ALLOWLIST[locationId2] || opts.name || locationId2;
   const spec = STAGE_SPECS[stage];
   if (!spec) return Promise.reject(new Error(`Stage ${stage} is not powered yet.`));
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     const bin = claudeBin();
     onEvent({ kind: "status", line: `Starting ${spec.name} on ${locationName} (headless Claude, ${spec.allowedTools.length} tools allowed)\u2026` });
-    const child = (0, import_child_process2.spawn)(bin, buildClaudeArgs(spec, locationId2, locationName, opts.context), {
+    const child = (0, import_child_process3.spawn)(bin, buildClaudeArgs(spec, locationId2, locationName, opts.context), {
       stdio: ["ignore", "pipe", "pipe"],
       env: { ...process.env }
     });
@@ -3195,31 +3196,31 @@ function runStage(locationId2, stage, onEvent, opts = {}) {
       if (code !== 0 && !lastText) {
         const outcome2 = { ok: false, error: `claude exited ${code}: ${stderrTail.trim().slice(-200) || "no output"}` };
         onEvent({ kind: "error", line: outcome2.error });
-        resolve7(outcome2);
+        resolve8(outcome2);
         return;
       }
       const outcome = parseResultLine(lastText);
       const detail = outcome.error || (outcome.issues?.length ? outcome.issues.join(" \xB7 ") : "") || outcome.summary || "no detail reported";
       const success = outcome.formId ? `Done: form "${outcome.formName}" (${outcome.formId})` : `Done: ${outcome.summary ?? "stage complete"}`;
       onEvent({ kind: "result", line: outcome.ok ? success : `Not passed: ${detail}` });
-      resolve7(outcome);
+      resolve8(outcome);
     });
     child.on("error", (err) => {
       clearTimeout(timeout);
       const outcome = { ok: false, error: `could not start claude: ${err.message}` };
       onEvent({ kind: "error", line: outcome.error });
-      resolve7(outcome);
+      resolve8(outcome);
     });
   });
 }
-var import_child_process2, fs12, os6, path11, SANDBOX_ALLOWLIST, PROTECTED_LOCATIONS, STAGE_SPECS, HUMAN_GATE_STAGES;
+var import_child_process3, fs13, os6, path12, SANDBOX_ALLOWLIST, PROTECTED_LOCATIONS, STAGE_SPECS, HUMAN_GATE_STAGES;
 var init_stage_runner = __esm({
   "src/stage-runner.ts"() {
     "use strict";
-    import_child_process2 = require("child_process");
-    fs12 = __toESM(require("fs"));
+    import_child_process3 = require("child_process");
+    fs13 = __toESM(require("fs"));
     os6 = __toESM(require("os"));
-    path11 = __toESM(require("path"));
+    path12 = __toESM(require("path"));
     SANDBOX_ALLOWLIST = {
       JrV2p35O3hY2wqhr2c0T: "MCP Testing",
       jHP5wkYRineXDlzAOEbW: "Blueprint Demo"
@@ -3939,11 +3940,11 @@ __export(dashboard_exports, {
   writeOverlay: () => writeOverlay
 });
 function overlayPath() {
-  return path12.join(appDataDir(), "intake-overlay.json");
+  return path13.join(appDataDir(), "intake-overlay.json");
 }
 function readOverlay() {
   try {
-    const raw = JSON.parse(fs13.readFileSync(overlayPath(), "utf8"));
+    const raw = JSON.parse(fs14.readFileSync(overlayPath(), "utf8"));
     if (raw && typeof raw === "object") return raw;
   } catch {
   }
@@ -3951,7 +3952,7 @@ function readOverlay() {
 }
 function writeOverlay(layer) {
   ensureAppDataDir();
-  fs13.writeFileSync(overlayPath(), JSON.stringify(layer, null, 2), { mode: 384 });
+  fs14.writeFileSync(overlayPath(), JSON.stringify(layer, null, 2), { mode: 384 });
 }
 function recoverStuckStages(state) {
   let recovered = 0;
@@ -3963,11 +3964,11 @@ function recoverStuckStages(state) {
   return { state: { ...state, clients }, recovered };
 }
 function cockpitStatePath() {
-  return path12.join(appDataDir(), "cockpit-state.json");
+  return path13.join(appDataDir(), "cockpit-state.json");
 }
 function readCockpitState() {
   try {
-    const raw = JSON.parse(fs13.readFileSync(cockpitStatePath(), "utf8"));
+    const raw = JSON.parse(fs14.readFileSync(cockpitStatePath(), "utf8"));
     if (raw && raw.v === 1 && raw.clients && typeof raw.clients === "object") return raw;
   } catch {
   }
@@ -3975,7 +3976,7 @@ function readCockpitState() {
 }
 function writeCockpitState(state) {
   ensureAppDataDir();
-  fs13.writeFileSync(cockpitStatePath(), JSON.stringify(state, null, 2), { mode: 384 });
+  fs14.writeFileSync(cockpitStatePath(), JSON.stringify(state, null, 2), { mode: 384 });
 }
 function setStage(state, locationId2, stageIndex, status) {
   if (!Number.isInteger(stageIndex) || stageIndex < 0 || stageIndex >= STAGES.length) throw new Error("bad stage index");
@@ -4067,13 +4068,13 @@ function notify(message) {
 `);
   try {
     ensureAppDataDir();
-    fs13.appendFileSync(path12.join(appDataDir(), "cockpit.log"), `[${(/* @__PURE__ */ new Date()).toISOString()}] ${message}
+    fs14.appendFileSync(path13.join(appDataDir(), "cockpit.log"), `[${(/* @__PURE__ */ new Date()).toISOString()}] ${message}
 `);
   } catch {
   }
   if (!process.stdout.isTTY && process.platform === "darwin") {
     try {
-      (0, import_child_process3.spawn)(
+      (0, import_child_process4.spawn)(
         "/usr/bin/osascript",
         ["-e", `display dialog ${JSON.stringify(message)} with title "Command OS" buttons {"OK"} default button "OK"`],
         { stdio: "ignore", detached: true }
@@ -4086,7 +4087,7 @@ function openBrowser(port) {
   const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
   const openArgs = process.platform === "win32" ? ["/c", "start", "", `http://localhost:${port}`] : [`http://localhost:${port}`];
   try {
-    (0, import_child_process3.spawn)(opener, openArgs, { stdio: "ignore", detached: true }).unref();
+    (0, import_child_process4.spawn)(opener, openArgs, { stdio: "ignore", detached: true }).unref();
   } catch {
   }
 }
@@ -4768,17 +4769,17 @@ async function runDashboard(argv) {
             const source = args.url ? { kind: "url", url: String(args.url) } : args.instruction ? { kind: "recorder", instruction: String(args.instruction) } : { kind: "text", text: String(args.transcript ?? "") };
             let recorderPatterns = [];
             if (source.kind === "recorder") {
-              recorderPatterns = await new Promise((resolve7) => {
-                const ls = (0, import_child_process4.spawn)(claudeBin(), ["mcp", "list"], { stdio: ["ignore", "pipe", "ignore"] });
+              recorderPatterns = await new Promise((resolve8) => {
+                const ls = (0, import_child_process5.spawn)(claudeBin(), ["mcp", "list"], { stdio: ["ignore", "pipe", "ignore"] });
                 let buf = "";
                 ls.stdout.on("data", (d) => {
                   buf += d.toString();
                 });
-                ls.on("close", () => resolve7(recorderAllowPatterns(buf)));
-                ls.on("error", () => resolve7([]));
+                ls.on("close", () => resolve8(recorderAllowPatterns(buf)));
+                ls.on("error", () => resolve8([]));
                 setTimeout(() => {
                   ls.kill("SIGKILL");
-                  resolve7(recorderAllowPatterns(buf));
+                  resolve8(recorderAllowPatterns(buf));
                 }, 9e4).unref?.();
               });
               if (!recorderPatterns.length) {
@@ -4788,16 +4789,16 @@ async function runDashboard(argv) {
               }
             }
             const out = await prefillFromSource(
-              (prompt, tools) => new Promise((resolve7, reject) => {
+              (prompt, tools) => new Promise((resolve8, reject) => {
                 const argv2 = ["-p", prompt, "--max-turns", "25", "--disallowedTools", tools.deny];
                 if (tools.allow) argv2.push("--allowedTools", tools.allow);
                 else argv2.push("--allowedTools", "");
-                const child = (0, import_child_process4.spawn)(claudeBin(), argv2, { stdio: ["ignore", "pipe", "pipe"] });
+                const child = (0, import_child_process5.spawn)(claudeBin(), argv2, { stdio: ["ignore", "pipe", "pipe"] });
                 let out2 = "";
                 child.stdout.on("data", (d) => {
                   out2 += d.toString();
                 });
-                child.on("close", () => resolve7(out2));
+                child.on("close", () => resolve8(out2));
                 child.on("error", reject);
                 setTimeout(() => child.kill("SIGKILL"), 5 * 60 * 1e3).unref?.();
               }),
@@ -4929,13 +4930,13 @@ async function runDashboard(argv) {
             }
           }
           const review = await generateReview(
-            (prompt) => new Promise((resolve7, reject) => {
-              const child = (0, import_child_process4.spawn)(claudeBin(), ["-p", prompt, "--allowedTools", "", "--disallowedTools", "Bash,Write,Edit,WebFetch,WebSearch,Task,Read,Glob,Grep", "--max-turns", "6"], { stdio: ["ignore", "pipe", "pipe"] });
+            (prompt) => new Promise((resolve8, reject) => {
+              const child = (0, import_child_process5.spawn)(claudeBin(), ["-p", prompt, "--allowedTools", "", "--disallowedTools", "Bash,Write,Edit,WebFetch,WebSearch,Task,Read,Glob,Grep", "--max-turns", "6"], { stdio: ["ignore", "pipe", "pipe"] });
               let out = "";
               child.stdout.on("data", (d) => {
                 out += d.toString();
               });
-              child.on("close", () => resolve7(out));
+              child.on("close", () => resolve8(out));
               child.on("error", reject);
               setTimeout(() => child.kill("SIGKILL"), 6 * 60 * 1e3).unref?.();
             }),
@@ -5108,9 +5109,9 @@ async function runDashboard(argv) {
     res.end();
   });
   try {
-    await new Promise((resolve7, reject) => {
+    await new Promise((resolve8, reject) => {
       server2.once("error", reject);
-      server2.listen(port, "127.0.0.1", resolve7);
+      server2.listen(port, "127.0.0.1", resolve8);
     });
   } catch (e) {
     const msg2 = e?.code === "EADDRINUSE" ? `Port ${port} is busy with another program. Close it, or start Command OS on a different port.` : `Command OS could not start: ${e instanceof Error ? e.message : String(e)}`;
@@ -5136,20 +5137,20 @@ async function runDashboard(argv) {
     if (adopted) process.stderr.write(`  Synced ${adopted} client${adopted === 1 ? "" : "s"} from your GHL (teammate updates).
 `);
   });
-  return await new Promise((resolve7) => {
-    const stop = () => server2.close(() => resolve7(0));
+  return await new Promise((resolve8) => {
+    const stop = () => server2.close(() => resolve8(0));
     process.on("SIGINT", stop);
     process.on("SIGTERM", stop);
   });
 }
-var fs13, path12, http, import_child_process3, import_child_process4, osmod, STAGES, ACCOUNT_TYPES, activeRun, UPGRADE_MSG;
+var fs14, path13, http, import_child_process4, import_child_process5, osmod, STAGES, ACCOUNT_TYPES, activeRun, UPGRADE_MSG;
 var init_dashboard = __esm({
   "src/dashboard.ts"() {
     "use strict";
-    fs13 = __toESM(require("fs"));
-    path12 = __toESM(require("path"));
+    fs14 = __toESM(require("fs"));
+    path13 = __toESM(require("path"));
     http = __toESM(require("http"));
-    import_child_process3 = require("child_process");
+    import_child_process4 = require("child_process");
     init_credentials_store();
     init_attestation();
     init_setup_tool();
@@ -5161,7 +5162,7 @@ var init_dashboard = __esm({
     init_client_intake();
     init_blueprint_review();
     init_stage_runner();
-    import_child_process4 = require("child_process");
+    import_child_process5 = require("child_process");
     init_ghl_client();
     init_shared_brain();
     osmod = __toESM(require("os"));
@@ -5182,8 +5183,8 @@ var init_dashboard = __esm({
 
 // src/index.ts
 var dotenv2 = __toESM(require("dotenv"));
-var path13 = __toESM(require("path"));
-var fs14 = __toESM(require("fs"));
+var path14 = __toESM(require("path"));
+var fs15 = __toESM(require("fs"));
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 init_ghl_client();
@@ -9340,16 +9341,16 @@ function registerEmailTools(server2, client) {
 function registerEmailBuilderInternalTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function builderRequest(method, path14, body) {
+  async function builderRequest(method, path15, body) {
     const headers = await client.buildHeaders();
-    const response = await fetch(`${EMAIL_BUILDER_BASE}${path14}`, {
+    const response = await fetch(`${EMAIL_BUILDER_BASE}${path15}`, {
       method,
       headers,
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Email Builder API Error ${response.status}: ${method} /emails/builder${path14}
+      throw new Error(`Email Builder API Error ${response.status}: ${method} /emails/builder${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -10606,23 +10607,23 @@ var import_zod37 = require("zod");
 function registerFunnelBuilderTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function internalGet(path14) {
-    return client.request("GET", path14);
+  async function internalGet(path15) {
+    return client.request("GET", path15);
   }
-  async function internalPost(path14, body) {
-    return client.request("POST", path14, body);
+  async function internalPost(path15, body) {
+    return client.request("POST", path15, body);
   }
-  async function internalPut(path14, body) {
-    return client.request("PUT", path14, body);
+  async function internalPut(path15, body) {
+    return client.request("PUT", path15, body);
   }
-  async function internalDelete(path14) {
-    return client.request("DELETE", path14);
+  async function internalDelete(path15) {
+    return client.request("DELETE", path15);
   }
-  async function funnelRequest(method, path14, body) {
+  async function funnelRequest(method, path15, body) {
     const headers = await client.buildHeaders();
     headers.Origin = "https://app.gohighlevel.com";
     headers.Referer = "https://app.gohighlevel.com/";
-    const url = `https://backend.leadconnectorhq.com/funnels${path14}`;
+    const url = `https://backend.leadconnectorhq.com/funnels${path15}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT")) {
       options.body = JSON.stringify(body);
@@ -10630,7 +10631,7 @@ function registerFunnelBuilderTools(server2, builderClient) {
     const response = await fetch(url, options);
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Funnel API Error ${response.status}: ${method} ${path14}
+      throw new Error(`Funnel API Error ${response.status}: ${method} ${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -11575,12 +11576,12 @@ var valueCardSchema = import_zod38.z.object({
 function registerPageStudioTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function funnelRequest(method, path14) {
+  async function funnelRequest(method, path15) {
     const headers = await client.buildHeaders();
     headers.Origin = "https://app.gohighlevel.com";
     headers.Referer = "https://app.gohighlevel.com/";
-    const response = await fetch(`https://backend.leadconnectorhq.com/funnels${path14}`, { method, headers });
-    if (!response.ok) throw new Error(`Funnel API Error ${response.status}: ${method} ${path14}
+    const response = await fetch(`https://backend.leadconnectorhq.com/funnels${path15}`, { method, headers });
+    if (!response.ok) throw new Error(`Funnel API Error ${response.status}: ${method} ${path15}
 ${await response.text()}`);
     const text = await response.text();
     return text ? JSON.parse(text) : {};
@@ -11899,9 +11900,9 @@ function buildUpdateFormPath(formId, locationId2) {
 function buildUpdateFormBody(name, formData) {
   return { name, formData };
 }
-async function formApiRequest(client, method, path14, body) {
+async function formApiRequest(client, method, path15, body) {
   const headers = await client.buildHeaders();
-  const url = `https://backend.leadconnectorhq.com/forms${path14}`;
+  const url = `https://backend.leadconnectorhq.com/forms${path15}`;
   const options = { method, headers };
   if (body && (method === "POST" || method === "PUT")) {
     options.body = JSON.stringify(body);
@@ -11909,7 +11910,7 @@ async function formApiRequest(client, method, path14, body) {
   const response = await fetch(url, options);
   if (!response.ok) {
     const text2 = await response.text();
-    throw new Error(`Form API Error ${response.status}: ${method} ${path14}
+    throw new Error(`Form API Error ${response.status}: ${method} ${path15}
 ${text2}`);
   }
   const text = await response.text();
@@ -11923,7 +11924,7 @@ ${text2}`);
 function registerFormBuilderTools(server2, builderClient, publicClient) {
   const client = builderClient;
   if (!client) return;
-  const formRequest = (method, path14, body) => formApiRequest(client, method, path14, body);
+  const formRequest = (method, path15, body) => formApiRequest(client, method, path15, body);
   server2.tool(
     "get_form_full",
     "Get a form with full builder data: all fields (labels, types, IDs, validation), conditional logic, auto-responder config, email notification settings, styling, and version history. This is the internal API \u2014 it returns everything the form builder UI shows.",
@@ -12044,10 +12045,10 @@ function registerFormBuilderTools(server2, builderClient, publicClient) {
     },
     async ({ formId, limit, skip }) => {
       try {
-        let path14 = `/submissions?locationId=${client.locationId}&limit=${limit ?? 20}`;
-        if (formId) path14 += `&formId=${formId}`;
-        if (skip) path14 += `&skip=${skip}`;
-        const result = await formRequest("GET", path14);
+        let path15 = `/submissions?locationId=${client.locationId}&limit=${limit ?? 20}`;
+        if (formId) path15 += `&formId=${formId}`;
+        if (skip) path15 += `&skip=${skip}`;
+        const result = await formRequest("GET", path15);
         return {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
@@ -12440,9 +12441,9 @@ var import_zod41 = require("zod");
 function registerPipelineBuilderTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function pipelineRequest(method, path14, body) {
+  async function pipelineRequest(method, path15, body) {
     const headers = await client.buildHeaders();
-    const url = `https://backend.leadconnectorhq.com/opportunities/pipelines${path14}`;
+    const url = `https://backend.leadconnectorhq.com/opportunities/pipelines${path15}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT" || method === "PATCH")) {
       options.body = JSON.stringify(body);
@@ -12450,7 +12451,7 @@ function registerPipelineBuilderTools(server2, builderClient) {
     const response = await fetch(url, options);
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Pipeline API Error ${response.status}: ${method} ${path14}
+      throw new Error(`Pipeline API Error ${response.status}: ${method} ${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -13195,7 +13196,7 @@ ${lines.join("\n")}
 // src/tools/bulk-operations.ts
 var import_zod45 = require("zod");
 function delay(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 function formatResults(op, results, total) {
   return `${op}: ${results.success} success, ${results.failed} failed out of ${total}.${results.errors.length ? "\nErrors:\n" + results.errors.join("\n") : ""}`;
@@ -13320,7 +13321,7 @@ function registerBulkOperationTools(server2, client) {
 // src/tools/account-export.ts
 var import_zod46 = require("zod");
 function delay2(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 function registerAccountExportTools(server2, client) {
   const builderClient = WorkflowBuilderClient.fromEnv();
@@ -13641,9 +13642,9 @@ var OBJECT_KEYS = ["contacts", "opportunity"];
 function registerSmartListTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function smartListRequest(method, path14, body) {
+  async function smartListRequest(method, path15, body) {
     const headers = await client.buildHeaders();
-    const url = `${SMARTLIST_BASE}${path14}`;
+    const url = `${SMARTLIST_BASE}${path15}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT")) {
       options.body = JSON.stringify(body);
@@ -13651,7 +13652,7 @@ function registerSmartListTools(server2, builderClient) {
     const response = await fetch(url, options);
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Smart Lists API Error ${response.status}: ${method} ${path14}
+      throw new Error(`Smart Lists API Error ${response.status}: ${method} ${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -13783,12 +13784,12 @@ var REPUTATION_BASE = "https://backend.leadconnectorhq.com/reputation";
 function registerReputationTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function reputationRequest(method, path14) {
+  async function reputationRequest(method, path15) {
     const headers = await client.buildHeaders();
-    const response = await fetch(`${REPUTATION_BASE}${path14}`, { method, headers });
+    const response = await fetch(`${REPUTATION_BASE}${path15}`, { method, headers });
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Reputation API Error ${response.status}: ${method} ${path14}
+      throw new Error(`Reputation API Error ${response.status}: ${method} ${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -13903,16 +13904,16 @@ var MEMBERSHIP_BASE = "https://backend.leadconnectorhq.com/membership";
 function registerMembershipTools(server2, builderClient) {
   const client = builderClient;
   if (!client) return;
-  async function membershipRequest(path14, method = "GET", body) {
+  async function membershipRequest(path15, method = "GET", body) {
     const headers = await client.buildHeaders();
-    const response = await fetch(`${MEMBERSHIP_BASE}${path14}`, {
+    const response = await fetch(`${MEMBERSHIP_BASE}${path15}`, {
       method,
       headers,
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Membership API Error ${response.status}: ${method} ${path14}
+      throw new Error(`Membership API Error ${response.status}: ${method} ${path15}
 ${text2}`);
     }
     const text = await response.text();
@@ -14081,7 +14082,7 @@ var import_zod52 = require("zod");
 var fs7 = __toESM(require("fs"));
 var path6 = __toESM(require("path"));
 function delay3(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 var TemplateSchema = import_zod52.z.object({
   templateName: import_zod52.z.string(),
@@ -14225,7 +14226,7 @@ function registerTemplateDeployerTools(server2, client) {
         const locId = client.resolveLocationId(locationId2);
         const safePath = validateTemplatePath(templateFile);
         const template = TemplateSchema.parse(JSON.parse(fs7.readFileSync(safePath, "utf-8")));
-        const resolve7 = (text) => {
+        const resolve8 = (text) => {
           if (typeof text !== "string") return text;
           let result = text;
           for (const [key, value] of Object.entries(answers)) {
@@ -14238,7 +14239,7 @@ function registerTemplateDeployerTools(server2, client) {
           return result;
         };
         const resolveObj = (obj) => {
-          if (typeof obj === "string") return resolve7(obj);
+          if (typeof obj === "string") return resolve8(obj);
           if (Array.isArray(obj)) return obj.map(resolveObj);
           if (obj && typeof obj === "object") {
             const result = {};
@@ -15239,6 +15240,57 @@ function registerDiagnosticTools(server2, installedVersion, client, builderClien
   );
 }
 
+// src/tools/user-guide.ts
+var import_child_process2 = require("child_process");
+var fs8 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+function resolveGuidePath() {
+  const bundled = path7.resolve(__dirname, "..", "guide", "guide.html");
+  if (fs8.existsSync(bundled)) return bundled;
+  const devRoot = path7.resolve(__dirname, "..", "..");
+  try {
+    const pkg2 = JSON.parse(fs8.readFileSync(path7.join(devRoot, "package.json"), "utf8"));
+    if (pkg2.name === "@elitedcs/ghl-mcp") {
+      const dev = path7.join(devRoot, "guide", "guide.html");
+      if (fs8.existsSync(dev)) return dev;
+    }
+  } catch {
+  }
+  return bundled;
+}
+function registerUserGuideTools(server2) {
+  server2.tool(
+    "get_user_guide",
+    "Open the GHL Command user guide in your browser \u2014 the full library of plain-English guides with copy-paste prompts (count and report contacts, build a nurture sequence, audit workflows, and more). Ships with every install, free or paid, and updates with the product. Always returns the guide's file path so it can be opened manually if no browser window appears.",
+    {},
+    async () => {
+      const guidePath = resolveGuidePath();
+      if (!fs8.existsSync(guidePath)) {
+        return {
+          content: [{
+            type: "text",
+            text: `The bundled user guide is missing (expected at ${guidePath}). Installed copies always include it \u2014 a reinstall restores it: npx -y @elitedcs/ghl-mcp cli install. In a development checkout, render it with: node scripts/build-guides.mjs`
+          }]
+        };
+      }
+      let launched = false;
+      try {
+        const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+        const args = process.platform === "win32" ? ["/c", "start", "", guidePath] : [guidePath];
+        (0, import_child_process2.spawn)(opener, args, { stdio: "ignore", detached: true }).unref();
+        launched = true;
+      } catch {
+      }
+      const text = launched ? `Opened the GHL Command user guide in your browser.
+
+If a tab didn't appear, open this file directly:
+${guidePath}` : `Could not launch a browser automatically. Open this file directly:
+${guidePath}`;
+      return { content: [{ type: "text", text }] };
+    }
+  );
+}
+
 // src/tools/snapshots.ts
 var import_zod54 = require("zod");
 init_ghl_client();
@@ -15921,9 +15973,9 @@ function presetForBusinessType(type) {
       return "generic";
   }
 }
-function setPath(target, path14, value) {
+function setPath(target, path15, value) {
   if (value === void 0) return;
-  const parts = path14.split(".");
+  const parts = path15.split(".");
   let node = target;
   for (let i = 0; i < parts.length - 1; i++) {
     const k = parts[i];
@@ -18009,15 +18061,15 @@ function extractFunnelId(result) {
   return void 0;
 }
 function makeExecuteDeps(client, builderClient, locationId2) {
-  const pipelineApi = async (method, path14, body) => {
+  const pipelineApi = async (method, path15, body) => {
     const headers = await builderClient.buildHeaders();
-    const url = `https://backend.leadconnectorhq.com/opportunities/pipelines${path14}`;
+    const url = `https://backend.leadconnectorhq.com/opportunities/pipelines${path15}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT")) options.body = JSON.stringify(body);
     const response = await fetch(url, options);
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Pipeline API ${response.status}: ${method} ${path14}
+      throw new Error(`Pipeline API ${response.status}: ${method} ${path15}
 ${text2.slice(0, 300)}`);
     }
     const text = await response.text();
@@ -18028,17 +18080,17 @@ ${text2.slice(0, 300)}`);
       return JSON.parse(text.replace(/[\x00-\x1F\x7F]/g, ""));
     }
   };
-  const funnelApi = async (method, path14, body) => {
+  const funnelApi = async (method, path15, body) => {
     const headers = await builderClient.buildHeaders();
     headers.Origin = "https://app.gohighlevel.com";
     headers.Referer = "https://app.gohighlevel.com/";
-    const url = `https://backend.leadconnectorhq.com/funnels${path14}`;
+    const url = `https://backend.leadconnectorhq.com/funnels${path15}`;
     const options = { method, headers };
     if (body && (method === "POST" || method === "PUT")) options.body = JSON.stringify(body);
     const response = await fetch(url, options);
     if (!response.ok) {
       const text2 = await response.text();
-      throw new Error(`Funnel API ${response.status}: ${method} ${path14}
+      throw new Error(`Funnel API ${response.status}: ${method} ${path15}
 ${text2.slice(0, 300)}`);
     }
     const text = await response.text();
@@ -18689,12 +18741,14 @@ var SNAPSHOTS_MODULE = "snapshots";
 var FORM_BUILDER_MODULE = "form-builder";
 var INTAKE_TO_BUILD_MODULE = "intake-to-build";
 var FUNNEL_QA_MODULE = "funnel-qa";
+var USER_GUIDE_MODULE = "user-guide";
 var KNOWN_MODULES = /* @__PURE__ */ new Set([
   ...publicApiTools.map(([, label]) => label),
   ...internalApiTools.map(([, label]) => label),
   FORM_BUILDER_MODULE,
   INTAKE_TO_BUILD_MODULE,
   FUNNEL_QA_MODULE,
+  USER_GUIDE_MODULE,
   VALIDATORS_MODULE,
   DIAGNOSTICS_MODULE,
   LOCATION_SWITCHER_MODULE,
@@ -18716,6 +18770,7 @@ function registerAllTools(server2, client, registry2, mcpVersion, env = process.
   registerFormBuilderTools(wrap(FORM_BUILDER_MODULE), builderClient, client);
   registerIntakeToBuildTools(wrap(INTAKE_TO_BUILD_MODULE), client, builderClient);
   registerFunnelQaTools(wrap(FUNNEL_QA_MODULE), client, builderClient);
+  registerUserGuideTools(wrap(USER_GUIDE_MODULE));
   registerValidatorTools(wrap(VALIDATORS_MODULE), client, builderClient);
   registerDiagnosticTools(
     wrap(DIAGNOSTICS_MODULE),
@@ -18778,16 +18833,16 @@ var import_zod60 = require("zod");
 
 // src/skill-installer.ts
 var import_node_crypto2 = require("node:crypto");
-var fs8 = __toESM(require("node:fs"));
-var path7 = __toESM(require("node:path"));
+var fs9 = __toESM(require("node:fs"));
+var path8 = __toESM(require("node:path"));
 var os3 = __toESM(require("node:os"));
 function sha256(buf) {
   return (0, import_node_crypto2.createHash)("sha256").update(buf).digest("hex");
 }
 function bundledSkillsDir(baseDir) {
-  const candidate = path7.resolve(baseDir, "..", "skills");
+  const candidate = path8.resolve(baseDir, "..", "skills");
   try {
-    return fs8.statSync(candidate).isDirectory() ? candidate : null;
+    return fs9.statSync(candidate).isDirectory() ? candidate : null;
   } catch {
     return null;
   }
@@ -18795,10 +18850,10 @@ function bundledSkillsDir(baseDir) {
 function listFiles(root) {
   const out = [];
   const walk = (dir) => {
-    for (const entry of fs8.readdirSync(dir, { withFileTypes: true })) {
-      const full = path7.join(dir, entry.name);
+    for (const entry of fs9.readdirSync(dir, { withFileTypes: true })) {
+      const full = path8.join(dir, entry.name);
       if (entry.isDirectory()) walk(full);
-      else if (entry.isFile()) out.push(path7.relative(root, full));
+      else if (entry.isFile()) out.push(path8.relative(root, full));
     }
   };
   walk(root);
@@ -18806,7 +18861,7 @@ function listFiles(root) {
 }
 function readMarker(markerPath) {
   try {
-    const parsed = JSON.parse(fs8.readFileSync(markerPath, "utf8"));
+    const parsed = JSON.parse(fs9.readFileSync(markerPath, "utf8"));
     return parsed && typeof parsed === "object" && parsed.files ? parsed : null;
   } catch {
     return null;
@@ -18819,35 +18874,35 @@ function installBundledSkills(opts) {
     skippedUserModified: [],
     unchanged: [],
     errors: [],
-    targetDir: opts.targetDir ?? path7.join(os3.homedir(), ".claude", "skills"),
+    targetDir: opts.targetDir ?? path8.join(os3.homedir(), ".claude", "skills"),
     bundledDir: null
   };
   const bundled = bundledSkillsDir(opts.baseDir);
   result.bundledDir = bundled;
   if (!bundled) return result;
   try {
-    fs8.mkdirSync(result.targetDir, { recursive: true });
+    fs9.mkdirSync(result.targetDir, { recursive: true });
   } catch (e) {
     result.errors.push(`cannot create ${result.targetDir}: ${String(e)}`);
     return result;
   }
-  const markerPath = path7.join(result.targetDir, ".ghl-command-skills.json");
+  const markerPath = path8.join(result.targetDir, ".ghl-command-skills.json");
   const marker = readMarker(markerPath) ?? { packageVersion: "", files: {} };
   const newMarker = { packageVersion: opts.packageVersion, files: { ...marker.files } };
   for (const rel of listFiles(bundled)) {
     try {
-      const src = fs8.readFileSync(path7.join(bundled, rel));
-      const dest = path7.join(result.targetDir, rel);
+      const src = fs9.readFileSync(path8.join(bundled, rel));
+      const dest = path8.join(result.targetDir, rel);
       const srcHash = sha256(src);
       let destBuf = null;
       try {
-        destBuf = fs8.readFileSync(dest);
+        destBuf = fs9.readFileSync(dest);
       } catch {
         destBuf = null;
       }
       if (destBuf === null) {
-        fs8.mkdirSync(path7.dirname(dest), { recursive: true });
-        fs8.writeFileSync(dest, src);
+        fs9.mkdirSync(path8.dirname(dest), { recursive: true });
+        fs9.writeFileSync(dest, src);
         newMarker.files[rel] = srcHash;
         result.installed.push(rel);
         continue;
@@ -18860,7 +18915,7 @@ function installBundledSkills(opts) {
       }
       const lastWritten = marker.files[rel];
       if (lastWritten && destHash === lastWritten) {
-        fs8.writeFileSync(dest, src);
+        fs9.writeFileSync(dest, src);
         newMarker.files[rel] = srcHash;
         result.updated.push(rel);
       } else {
@@ -18871,7 +18926,7 @@ function installBundledSkills(opts) {
     }
   }
   try {
-    fs8.writeFileSync(markerPath, JSON.stringify(newMarker, null, 2));
+    fs9.writeFileSync(markerPath, JSON.stringify(newMarker, null, 2));
   } catch (e) {
     result.errors.push(`marker write failed: ${String(e)}`);
   }
@@ -18956,8 +19011,8 @@ function registerMetaTools(server2, installedVersion) {
 
 // src/cli.ts
 var import_node_util2 = require("node:util");
-var fs10 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
+var fs11 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
 var import_crypto2 = require("crypto");
 init_ghl_client();
 init_token_registry();
@@ -19008,9 +19063,9 @@ function errLine(msg2) {
 function preflightWritable() {
   try {
     const dir = ensureAppDataDir();
-    const probe = path9.join(dir, `.write-probe.${process.pid}.${(0, import_crypto2.randomBytes)(4).toString("hex")}`);
-    fs10.writeFileSync(probe, "ok");
-    fs10.unlinkSync(probe);
+    const probe = path10.join(dir, `.write-probe.${process.pid}.${(0, import_crypto2.randomBytes)(4).toString("hex")}`);
+    fs11.writeFileSync(probe, "ok");
+    fs11.unlinkSync(probe);
     return true;
   } catch (error) {
     errLine(`Config dir is not writable: ${error instanceof Error ? error.message : String(error)}`);
@@ -19264,7 +19319,7 @@ var bundledPkg = require_package();
 var pkg = (() => {
   try {
     const onDisk = JSON.parse(
-      fs14.readFileSync(path13.resolve(__dirname, "..", "package.json"), "utf8")
+      fs15.readFileSync(path14.resolve(__dirname, "..", "package.json"), "utf8")
     );
     if (typeof onDisk.version === "string" && onDisk.version.length > 0) {
       return { version: onDisk.version };
@@ -19277,7 +19332,7 @@ dotenv2.config();
 setPkgVersion(pkg.version);
 {
   const configDirOverride = process.env.GHL_MCP_CONFIG_DIR?.trim();
-  if (configDirOverride && !path13.isAbsolute(configDirOverride)) {
+  if (configDirOverride && !path14.isAbsolute(configDirOverride)) {
     process.stderr.write(
       `[ghl-mcp] GHL_MCP_CONFIG_DIR must be an absolute path (got "${configDirOverride}"). Use e.g. /data/ghl-mcp in a container, with a volume mounted at /data.
 `
@@ -19290,20 +19345,20 @@ process.on("unhandledRejection", (reason) => {
 `);
 });
 function hardenSecretFilePerms() {
-  const repoDir = path13.resolve(__dirname, "..");
+  const repoDir = path14.resolve(__dirname, "..");
   const candidates = [
-    { file: path13.join(repoDir, "start-mcp.sh"), mode: 448 },
+    { file: path14.join(repoDir, "start-mcp.sh"), mode: 448 },
     // Legacy registry location (pre-migration); new location lives in app-data.
-    { file: path13.join(repoDir, ".ghl-tokens.json"), mode: 384 },
+    { file: path14.join(repoDir, ".ghl-tokens.json"), mode: 384 },
     { file: tokenRegistryPath(), mode: 384 }
   ];
   for (const { file, mode } of candidates) {
     let current;
     try {
-      if (!fs14.existsSync(file)) continue;
-      current = fs14.statSync(file).mode & 511;
+      if (!fs15.existsSync(file)) continue;
+      current = fs15.statSync(file).mode & 511;
       if (current !== mode) {
-        fs14.chmodSync(file, mode);
+        fs15.chmodSync(file, mode);
       }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);