@wootsup/yt-builder-mcp 1.1.7 → 1.3.0

package/dist/uninstall-skill.js

@@ -0,0 +1,146 @@
+/**
+ * `uninstall-skill` — the inverse of {@link installSkill}.
+ *
+ * Removes the bundled skill directory from the user's agent-skill folder
+ * (`~/.claude/skills/yt-builder-mcp/`, plus the legacy
+ * `~/.claude/skills/yootheme-builder/`) and strips the marker block this
+ * package appended to `~/AGENTS.md`.
+ *
+ * Idempotent + non-destructive to the user's own content: only OUR
+ * `## YT Builder MCP` marker section is removed from AGENTS.md; every
+ * other line the user wrote is preserved verbatim.
+ *
+ * @license MIT
+ */
+import { existsSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { MARKER_LINE } from './install-skill.js';
+/** Skill folder names this package has ever installed (canonical first). */
+const SKILL_DIR_NAMES = ['yt-builder-mcp', 'yootheme-builder'];
+function resolveSkillsDir(opts) {
+    return opts.targetSkillsDir ?? join(homedir(), '.claude', 'skills');
+}
+function resolveAgentsFile(opts) {
+    return opts.targetAgentsFile ?? join(homedir(), 'AGENTS.md');
+}
+/**
+ * True when a skill folder OR an AGENTS.md marker is present — used by
+ * the uninstall CLI to decide whether to surface the "remove skill"
+ * checkbox at all.
+ */
+export function isSkillInstalled(opts = {}) {
+    const skillsDir = resolveSkillsDir(opts);
+    for (const name of SKILL_DIR_NAMES) {
+        if (existsSync(join(skillsDir, name)))
+            return true;
+    }
+    const agentsFile = resolveAgentsFile(opts);
+    if (existsSync(agentsFile)) {
+        try {
+            if (readFileSync(agentsFile, 'utf-8').includes(MARKER_LINE))
+                return true;
+        }
+        catch {
+            // unreadable → treat as not-installed
+        }
+    }
+    return false;
+}
+/**
+ * Strip our `## YT Builder MCP` marker section from an AGENTS.md body.
+ *
+ * The block installSkill writes is:
+ *
+ *   \n\n## YT Builder MCP\n\n<MARKER_LINE>\n<a few prose lines>\n
+ *
+ * It is always appended at EOF. We locate the `## YT Builder MCP`
+ * heading whose following lines contain {@link MARKER_LINE}, then remove
+ * from that heading (collapsing the blank lines that preceded it) up to
+ * the next top-level/section heading (`# ` or `## `) or EOF. Returns the
+ * cleaned body, or `null` when no marker block was found (no-op).
+ */
+export function stripMarkerBlock(body) {
+    if (!body.includes(MARKER_LINE))
+        return null;
+    const lines = body.split('\n');
+    // Find the `## YT Builder MCP` heading that owns the marker line.
+    let headingIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === '## YT Builder MCP') {
+            // Confirm the marker line appears before the next heading.
+            for (let j = i + 1; j < lines.length; j++) {
+                const t = lines[j];
+                if (/^#{1,2}\s/.test(t))
+                    break;
+                if (t.includes(MARKER_LINE)) {
+                    headingIdx = i;
+                    break;
+                }
+            }
+        }
+        if (headingIdx !== -1)
+            break;
+    }
+    // Fallback: marker present but no recognised heading (hand-edited).
+    // Remove just the marker line + its immediate prose paragraph.
+    if (headingIdx === -1) {
+        const filtered = lines.filter((l) => !l.includes(MARKER_LINE));
+        const cleaned = filtered.join('\n');
+        return cleaned === body ? null : cleaned;
+    }
+    // Walk to the end of the block: next `# `/`## ` heading or EOF.
+    let endIdx = lines.length;
+    for (let j = headingIdx + 1; j < lines.length; j++) {
+        if (/^#{1,2}\s/.test(lines[j])) {
+            endIdx = j;
+            break;
+        }
+    }
+    // Collapse trailing blank lines that immediately preceded the heading
+    // so we don't leave a widening gap.
+    let startIdx = headingIdx;
+    while (startIdx > 0 && lines[startIdx - 1].trim() === '') {
+        startIdx--;
+    }
+    const kept = [...lines.slice(0, startIdx), ...lines.slice(endIdx)];
+    let cleaned = kept.join('\n');
+    // Normalise trailing whitespace: collapse 3+ newlines, ensure single
+    // trailing newline when there is content.
+    cleaned = cleaned.replace(/\n{3,}/g, '\n\n').replace(/\n*$/, '');
+    if (cleaned !== '')
+        cleaned += '\n';
+    return cleaned;
+}
+export async function uninstallSkill(options = {}) {
+    const skillsDir = resolveSkillsDir(options);
+    const agentsFile = resolveAgentsFile(options);
+    const skillTargetDir = join(skillsDir, SKILL_DIR_NAMES[0]);
+    // 1. Remove skill directories (canonical + legacy).
+    let skillRemoved = false;
+    for (const name of SKILL_DIR_NAMES) {
+        const dir = join(skillsDir, name);
+        if (existsSync(dir)) {
+            rmSync(dir, { recursive: true, force: true });
+            skillRemoved = true;
+        }
+    }
+    // 2. Strip the marker block from AGENTS.md.
+    let markerRemoved = false;
+    if (existsSync(agentsFile)) {
+        let body = '';
+        try {
+            body = readFileSync(agentsFile, 'utf-8');
+        }
+        catch {
+            body = '';
+        }
+        const cleaned = stripMarkerBlock(body);
+        if (cleaned !== null) {
+            writeFileSync(agentsFile, cleaned, 'utf-8');
+            markerRemoved = true;
+        }
+    }
+    return { skillRemoved, skillTargetDir, markerRemoved, agentsFile };
+}
+//# sourceMappingURL=uninstall-skill.js.map

package/dist/uninstall-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall-skill.js","sourceRoot":"","sources":["../src/uninstall-skill.ts"],"names":[],"mappings":"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"}

package/dist/uninstall.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Uninstall orchestration core — the inverse of the setup wizard.
+ *
+ * `setup` writes the yt-builder-mcp MCP server entry into one or more AI
+ * clients' config files (and optionally installs a skill). `uninstall`
+ * reverses that: it detects which clients currently carry our entry,
+ * removes the chosen ones, and optionally removes the installed skill.
+ *
+ * This module is the pure, testable core: detection + removal across the
+ * client registry, with every side effect injected via {@link
+ * UninstallDeps} so unit tests touch no real disk. The interactive clack
+ * checklist + the CLI flag-parsing live in `setup-cli.ts` and call into
+ * `detectInstalledClients` / `runUninstall` here.
+ *
+ * @license MIT
+ */
+import { type ClientWriter } from './clients/index.js';
+import { isSkillInstalled as defaultIsSkillInstalled, uninstallSkill as defaultUninstallSkill, type UninstallSkillResult } from './uninstall-skill.js';
+/** A client that currently carries a yt-builder-mcp server entry. */
+export interface InstalledClient {
+    readonly id: string;
+    readonly label: string;
+    readonly configPath: string;
+    /** The server keys/names found (e.g. `['yt-builder-mcp']`). */
+    readonly matchedKeys: readonly string[];
+}
+/**
+ * Probe every client in `clients` and return those whose config carries
+ * our server entry. Detection is parallel — the probes are independent
+ * file reads.
+ */
+export declare function detectInstalledClients(clients?: readonly ClientWriter[]): Promise<InstalledClient[]>;
+/** What the caller asked to uninstall. */
+export interface UninstallSelection {
+    /** Client ids to remove our entry from. */
+    readonly clientIds: readonly string[];
+    /** Also remove the installed skill (+ AGENTS.md marker)? */
+    readonly removeSkill: boolean;
+}
+/** Per-client outcome of a removal. */
+export interface ClientUninstallResult {
+    readonly id: string;
+    readonly label: string;
+    readonly configPath: string;
+    /** True when an entry was actually removed (false on no-op or error). */
+    readonly removed: boolean;
+    /** The keys removed (empty on no-op / error). */
+    readonly removedKeys: readonly string[];
+    /** Populated when removal threw. */
+    readonly error?: string;
+}
+export interface UninstallResult {
+    readonly clientResults: readonly ClientUninstallResult[];
+    /** Present only when `removeSkill` was requested. */
+    readonly skillResult?: UninstallSkillResult;
+}
+/** Injectable side effects so tests run without touching disk. */
+export interface UninstallDeps {
+    /** Registry to resolve `clientIds` against. */
+    readonly clients: readonly ClientWriter[];
+    readonly uninstallSkill: typeof defaultUninstallSkill;
+    readonly isSkillInstalled: typeof defaultIsSkillInstalled;
+}
+export declare const DEFAULT_UNINSTALL_DEPS: UninstallDeps;
+/**
+ * Execute an uninstall. Removes our server entry from each selected,
+ * KNOWN client id (unknown ids are silently skipped) and — when
+ * `removeSkill` is set — removes the installed skill. Each client removal
+ * is isolated: a failure on one is captured into its result and does not
+ * abort the others (so a partial uninstall still cleans what it can).
+ */
+export declare function runUninstall(selection: UninstallSelection, deps?: UninstallDeps): Promise<UninstallResult>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EACH,gBAAgB,IAAI,uBAAuB,EAC3C,cAAc,IAAI,qBAAqB,EACvC,KAAK,oBAAoB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,GAAE,SAAS,YAAY,EAAgB,GAC/C,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CACjC;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzD,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC/C;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,uBAAuB,CAAC;CAC7D;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAC9B,SAAS,EAAE,kBAAkB,EAC7B,IAAI,GAAE,aAAsC,GAC7C,OAAO,CAAC,eAAe,CAAC,CAmC1B"}

package/dist/uninstall.js

@@ -0,0 +1,82 @@
+/**
+ * Uninstall orchestration core — the inverse of the setup wizard.
+ *
+ * `setup` writes the yt-builder-mcp MCP server entry into one or more AI
+ * clients' config files (and optionally installs a skill). `uninstall`
+ * reverses that: it detects which clients currently carry our entry,
+ * removes the chosen ones, and optionally removes the installed skill.
+ *
+ * This module is the pure, testable core: detection + removal across the
+ * client registry, with every side effect injected via {@link
+ * UninstallDeps} so unit tests touch no real disk. The interactive clack
+ * checklist + the CLI flag-parsing live in `setup-cli.ts` and call into
+ * `detectInstalledClients` / `runUninstall` here.
+ *
+ * @license MIT
+ */
+import { ALL_CLIENTS } from './clients/index.js';
+import { isSkillInstalled as defaultIsSkillInstalled, uninstallSkill as defaultUninstallSkill, } from './uninstall-skill.js';
+/**
+ * Probe every client in `clients` and return those whose config carries
+ * our server entry. Detection is parallel — the probes are independent
+ * file reads.
+ */
+export async function detectInstalledClients(clients = ALL_CLIENTS) {
+    const detections = await Promise.all(clients.map(async (c) => ({ client: c, det: await c.detect() })));
+    return detections
+        .filter((d) => d.det.present)
+        .map((d) => ({
+        id: d.client.id,
+        label: d.client.label,
+        configPath: d.det.configPath,
+        matchedKeys: d.det.matchedKeys,
+    }));
+}
+export const DEFAULT_UNINSTALL_DEPS = {
+    clients: ALL_CLIENTS,
+    uninstallSkill: defaultUninstallSkill,
+    isSkillInstalled: defaultIsSkillInstalled,
+};
+/**
+ * Execute an uninstall. Removes our server entry from each selected,
+ * KNOWN client id (unknown ids are silently skipped) and — when
+ * `removeSkill` is set — removes the installed skill. Each client removal
+ * is isolated: a failure on one is captured into its result and does not
+ * abort the others (so a partial uninstall still cleans what it can).
+ */
+export async function runUninstall(selection, deps = DEFAULT_UNINSTALL_DEPS) {
+    const byId = new Map(deps.clients.map((c) => [c.id, c]));
+    const clientResults = [];
+    for (const id of selection.clientIds) {
+        const client = byId.get(id);
+        if (client === undefined)
+            continue; // unknown id — skip
+        try {
+            const res = await client.remove();
+            clientResults.push({
+                id: client.id,
+                label: client.label,
+                configPath: res.configPath,
+                removed: res.removed,
+                removedKeys: res.removedKeys,
+            });
+        }
+        catch (e) {
+            const error = e instanceof Error ? e.message : String(e);
+            clientResults.push({
+                id: client.id,
+                label: client.label,
+                configPath: client.configPath(),
+                removed: false,
+                removedKeys: [],
+                error,
+            });
+        }
+    }
+    let skillResult;
+    if (selection.removeSkill) {
+        skillResult = await deps.uninstallSkill();
+    }
+    return { clientResults, ...(skillResult !== undefined ? { skillResult } : {}) };
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"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"}

package/manifest.json

@@ -2,7 +2,7 @@
     "dxt_version": "0.1",
     "name": "@wootsup/yt-builder-mcp",
     "display_name": "YT Builder MCP for YOOtheme Pro (unofficial)",
-    "version": "1.1.6",
+    "version": "1.3.0",
     "description": "Drive your YOOtheme Pro Page Builder programmatically from Claude, Cursor, Codex, Gemini and 5 other MCP-capable AI assistants — read layouts, edit settings, add elements, bind dynamic sources. Works on WordPress and Joomla 5/6. Built for YOOtheme Pro 4.0+. Independent third-party project, not affiliated with YOOtheme GmbH.",
     "long_description": "YT Builder MCP gives AI assistants a typed, scoped, and idempotent surface for your YOOtheme Pro Page Builder, on either WordPress or Joomla 5/6. Tools cover page discovery, layout inspection, element CRUD, source binding, and diagnostics. Bearer auth, optimistic locking via ETag, scope hierarchy (read < write < admin), and structured-error responses keep the agent safe and the workflow correct on first try. Independent third-party project — YOOtheme® is a registered trademark of YOOtheme GmbH (yootheme.com); YT Builder MCP is built by WootsUp (getimo productions) and is not affiliated with, endorsed by, or sponsored by YOOtheme.",
     "icon": "icon.png",
@@ -39,10 +39,10 @@
                 "${__dirname}/dist/index.js"
             ],
             "env": {
-                "YTB_MCP_SITES_FILE": "${user_config.YTB_MCP_SITES_FILE}",
                 "YTB_MCP_SITE_URL": "${user_config.YTB_MCP_SITE_URL}",
-                "YTB_MCP_PLATFORM": "${user_config.YTB_MCP_PLATFORM}",
-                "YTB_MCP_BEARER_TOKEN": "${user_config.YTB_MCP_BEARER_TOKEN}"
+                "YTB_MCP_BEARER_TOKEN": "${user_config.YTB_MCP_BEARER_TOKEN}",
+                "YTB_MCP_PROFILE": "${user_config.YTB_MCP_PROFILE}",
+                "YTB_MCP_SITES_FILE": "${user_config.YTB_MCP_SITES_FILE}"
             }
         }
     },
@@ -60,17 +60,17 @@
             "required": false,
             "sensitive": true
         },
-        "YTB_MCP_PLATFORM": {
+        "YTB_MCP_PROFILE": {
             "type": "string",
-            "title": "Platform (one site, optional)",
-            "description": "Leave this on 'auto'. The server detects WordPress or Joomla by itself. Only set 'wordpress' or 'joomla' if your host blocks the automatic check.",
+            "title": "Profile name (Optional for Single Site Configuration)",
+            "description": "Optional label for this site profile. Defaults to 'default'. With a Sites file, it selects which configured site is active; switch any time via yootheme_builder_use_site.",
             "required": false,
-            "default": "auto"
+            "default": "default"
         },
         "YTB_MCP_SITES_FILE": {
             "type": "string",
-            "title": "Sites file (connect many sites, advanced)",
-            "description": "Only for managing several sites from one install (agencies). Path to a sites.json, e.g. /Users/you/.config/yt-builder-mcp/sites.json. Create and fill it with: npx -y @wootsup/yt-builder-mcp add-site (do not hand-edit). When set, the three single-site fields above are ignored. Most people leave this empty.",
+            "title": "Sites file (for Multi-Site Configurations)",
+            "description": "Only for managing several sites from one install (agencies). Path to a sites.json, e.g. /Users/you/.config/yt-builder-mcp/sites.json. Create and fill it with: npx -y @wootsup/yt-builder-mcp add-site (do not hand-edit). When set, the single-site YTB_MCP_SITE_URL + token fields above are ignored. Most people leave this empty.",
             "required": false
         }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@wootsup/yt-builder-mcp",
-    "version": "1.1.7",
+    "version": "1.3.0",
     "type": "module",
     "description": "YT Builder MCP — drive your page builder from Claude, Cursor, Codex, Gemini and 5 other MCP-capable AI assistants. Built for YOOtheme Pro 4.0+. Independent third-party project, not affiliated with YOOtheme GmbH.",
     "license": "MIT",
@@ -48,8 +48,8 @@
         "node": ">=18.17.0"
     },
     "scripts": {
+        "prepublishOnly": "node -e \"if (process.env.RELEASE_PHP_PUBLISH !== '1') { console.error('Manual npm publish is no longer supported. Use: php scripts/release.php release yt-builder-mcp <bump> followed by php scripts/release.php push-tag yt-builder-mcp <version>, which triggers the GitHub Actions publish workflow (.github/workflows/yt-builder-mcp-publish.yml). Set RELEASE_PHP_PUBLISH=1 only if you know you are running from that workflow.'); process.exit(1); }\"",
         "build": "tsc",
-        "prepublishOnly": "npm run build",
         "dev": "tsc --watch",
         "test": "vitest run",
         "test:watch": "vitest",
@@ -57,10 +57,13 @@
         "test:grep-gate": "vitest run tests/auth/secrets-grep-gate.test.ts",
         "typecheck": "tsc --noEmit",
         "lint": "eslint src --max-warnings=0",
+        "bump": "node ./scripts/bump-version.mjs",
         "setup": "node ./bin/yt-builder-mcp.js setup",
         "install-skill": "node ./bin/yt-builder-mcp.js install-skill",
         "build:dxt": "node ./scripts/build-dxt.js",
-        "extract-tools": "node ./scripts/extract-tools.mjs"
+        "extract-tools": "node ./scripts/extract-tools.mjs",
+        "export:catalog": "node ./scripts/export-catalog.mjs",
+        "sync:catalog": "node ./scripts/sync-catalog.mjs"
     },
     "dependencies": {
         "@getimo/mcp-toolkit": "^1.1.1",
@@ -76,6 +79,7 @@
         "@typescript-eslint/eslint-plugin": "^8.0.0",
         "@typescript-eslint/parser": "^8.0.0",
         "@vitest/coverage-v8": "^1.4.0",
+        "esbuild": "^0.21.5",
         "eslint": "^9.0.0",
         "typescript": "^5.4.0",
         "typescript-eslint": "^8.0.0",