@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/install-skill.js

@@ -0,0 +1,118 @@
+/**
+ * `install-skill` subcommand for `@wootsup/yt-builder-mcp`.
+ *
+ * Copies the bundled `skills/yt-builder-mcp/` directory into the user's
+ * agent-skill folder (typically `~/.claude/skills/`) and appends a marker
+ * block to `~/AGENTS.md` so other AI clients pick it up automatically.
+ *
+ * Idempotent: re-running overwrites existing skill files and skips the
+ * AGENTS.md append when the marker is already present.
+ *
+ * Mirrors the pattern from `@wootsup/mcp install-skill` so users on both
+ * products get the same workflow.
+ *
+ * @license MIT
+ */
+import { appendFileSync, copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const MARKER_LINE = '<!-- yt-builder-mcp:skill-installed -->';
+const MARKER_BLOCK = `
+
+## YT Builder MCP
+
+${MARKER_LINE}
+The YT Builder MCP skill is installed at \`~/.claude/skills/yt-builder-mcp/\`
+— the universal-marker path recognised by Claude Desktop and other AI
+clients that follow the \`~/AGENTS.md\` discovery protocol.
+
+It documents the 30 MCP tools (29 domain + 1 gateway, 23 entries in
+\`tools/list\`), the 5 canonical workflows (build hero, bind dynamic
+source, clone section, diagnose 401, add custom element), and the
+gateway routing model. Source: https://github.com/wootsup/yt-builder-mcp.
+`;
+function defaultPkgRoot() {
+    // src/install-skill.ts → pkg root is one level up.
+    // When running from dist/install-skill.js the layout is identical
+    // (TypeScript emits `dist/install-skill.js` mirroring `src/`).
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '..');
+}
+function copyDirRecursive(src, dst) {
+    if (!existsSync(dst))
+        mkdirSync(dst, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        const sPath = join(src, entry);
+        const dPath = join(dst, entry);
+        const stat = statSync(sPath);
+        if (stat.isDirectory()) {
+            copyDirRecursive(sPath, dPath);
+        }
+        else {
+            copyFileSync(sPath, dPath);
+        }
+    }
+}
+/**
+ * Locate the bundled `skills/yt-builder-mcp` directory.
+ *
+ * Production layout: the skill folder is bundled INSIDE the npm package
+ * (`packages/mcp/skills/yt-builder-mcp/`), next to `dist/`. The same
+ * layout exists in the source tree (per Design-Doc §13.1) so source-mode
+ * smoke tests and the published tarball use the same single path.
+ *
+ * Earlier drafts walked `../..` up to a monorepo-root `skills/` dir;
+ * that layout was eliminated in Round-1 audit fix C1 because it produced
+ * a tarball without `skills/` (skill-not-found at first run).
+ */
+function findSkillSource(pkgRoot) {
+    return join(pkgRoot, 'skills', 'yt-builder-mcp');
+}
+export async function installSkill(options = {}) {
+    const pkgRoot = options.pkgRoot ?? defaultPkgRoot();
+    const targetSkillsDir = options.targetSkillsDir ?? join(homedir(), '.claude', 'skills');
+    const targetAgentsFile = options.targetAgentsFile ?? join(homedir(), 'AGENTS.md');
+    const srcSkillDir = findSkillSource(pkgRoot);
+    if (!existsSync(srcSkillDir)) {
+        throw new Error(`Bundled skill not found at ${srcSkillDir}. ` +
+            `Is the package installed correctly? (pkgRoot=${pkgRoot})`);
+    }
+    if (!existsSync(targetSkillsDir)) {
+        mkdirSync(targetSkillsDir, { recursive: true });
+    }
+    const skillTargetDir = join(targetSkillsDir, 'yt-builder-mcp');
+    copyDirRecursive(srcSkillDir, skillTargetDir);
+    // 1.0.1 Wave-R: clean up the legacy directory created by pre-1.0.1
+    // installs so the user doesn't end up with two side-by-side skill
+    // copies (`yootheme-builder/` AND `yt-builder-mcp/`) under the same
+    // `~/.claude/skills/` root.
+    const removeLegacy = options.removeLegacyDir ?? true;
+    if (removeLegacy) {
+        const legacyDir = join(targetSkillsDir, 'yootheme-builder');
+        if (existsSync(legacyDir) && legacyDir !== skillTargetDir) {
+            rmSync(legacyDir, { recursive: true, force: true });
+        }
+    }
+    let markerAlreadyPresent = false;
+    if (existsSync(targetAgentsFile)) {
+        const existing = readFileSync(targetAgentsFile, 'utf-8');
+        if (existing.includes(MARKER_LINE)) {
+            markerAlreadyPresent = true;
+        }
+        else {
+            appendFileSync(targetAgentsFile, MARKER_BLOCK);
+        }
+    }
+    else {
+        // Create with a sensible top-line and the marker block (trimmed).
+        writeFileSync(targetAgentsFile, MARKER_BLOCK.trimStart(), 'utf-8');
+    }
+    return {
+        copied: true,
+        markerAlreadyPresent,
+        skillTargetDir,
+        agentsFile: targetAgentsFile,
+    };
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/install-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.js","sourceRoot":"","sources":["../src/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACH,cAAc,EACd,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,aAAa,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAErE,MAAM,YAAY,GAAG;;;;EAInB,WAAW;;;;;;;;;CASZ,CAAC;AA6BF,SAAS,cAAc;IACnB,mDAAmD;IACnD,kEAAkE;IAClE,+DAA+D;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,GAAW;IAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,eAAe,CAAC,OAAe;IACpC,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,UAA+B,EAAE;IAEjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;IACpD,MAAM,eAAe,GACjB,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpE,MAAM,gBAAgB,GAClB,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;IAE7D,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACX,8BAA8B,WAAW,IAAI;YACzC,gDAAgD,OAAO,GAAG,CACjE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAC/D,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE9C,mEAAmE;IACnE,kEAAkE;IAClE,oEAAoE;IACpE,4BAA4B;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACrD,IAAI,YAAY,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;YACxD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IAED,IAAI,oBAAoB,GAAG,KAAK,CAAC;IACjC,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,oBAAoB,GAAG,IAAI,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,cAAc,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,kEAAkE;QAClE,aAAa,CAAC,gBAAgB,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACH,MAAM,EAAE,IAAI;QACZ,oBAAoB;QACpB,cAAc;QACd,UAAU,EAAE,gBAAgB;KAC/B,CAAC;AACN,CAAC"}

package/dist/platform/detect.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Runtime platform detection — F-Platform-Detect-Probe (P0 customer fix).
+ *
+ * The static URL-shape heuristic in `detectPlatformFromUrl()` only works
+ * when the user-supplied base URL already carries `/wp-json/` or
+ * `/api/index.php/` in its path. That is RARELY the case in practice —
+ * the DXT/manifest tells the user to enter the **site origin** (or a
+ * subfolder install like `https://dev.example.com/joomla`), neither of
+ * which contains those markers. The heuristic then silently falls back
+ * to the WordPress default and the Joomla customer experiences a
+ * 24/24 FAIL until they manually set `YTB_MCP_PLATFORM=joomla`.
+ *
+ * This module adds a *runtime probe*: lightweight unauthenticated GETs
+ * against both platforms' `/health` endpoints. Whichever returns a
+ * yt-builder-mcp-shaped response (a JSON body carrying `plugin_version`)
+ * wins. Joomla is probed first because the negative case (probe fails)
+ * is the long-tail and the positive case (probe succeeds) returns fast
+ * — letting the more common WordPress install just fall through to the
+ * second probe without paying for a wasted full timeout.
+ *
+ * The probe is fire-and-forget safe:
+ *   - 3 s `AbortSignal.timeout` per request (so a totally broken host
+ *     blocks ~6 s worst case, not the request's full 15 s default).
+ *   - Non-200 responses are ignored (Joomla on a WP-only install
+ *     answers 404; that's fine).
+ *   - Non-JSON / wrong-shape 200 responses are ignored (a WP frontend
+ *     without the plugin renders the homepage HTML, which `JSON.parse`
+ *     refuses — handled).
+ *   - Any thrown error (DNS, TLS, abort) is swallowed → try next.
+ *
+ * The function returns `null` when BOTH probes fail; the caller then
+ * falls back to the URL-shape heuristic or the wordpress default. We do
+ * NOT throw, because a missing-plugin or wrong-URL diagnosis belongs to
+ * the first real authenticated request — not to silent boot-time probing.
+ *
+ * @license MIT
+ */
+import { type PlatformKind } from './index.js';
+/**
+ * Minimal fetch type so callers (and tests) can inject a stub without
+ * pulling DOM types. Matches the global `fetch` contract we actually use.
+ */
+export type ProbeFetch = (input: string, init?: {
+    signal?: AbortSignal;
+}) => Promise<Response>;
+export interface DetectPlatformAtRuntimeOptions {
+    /** Override the per-probe timeout (ms). Default 3000. */
+    readonly timeoutMs?: number;
+    /** Injectable fetch (tests). Defaults to the global `fetch`. */
+    readonly fetchImpl?: ProbeFetch;
+}
+/**
+ * Probe both platforms' health endpoints and return the first kind that
+ * answers with a yt-builder-mcp-shaped JSON payload. Returns `null`
+ * when neither responds usefully (so the caller can fall through to the
+ * URL-shape heuristic / default).
+ *
+ * NB: `baseUrl` is taken verbatim except for trimming trailing slashes.
+ * If `baseUrl` itself carries a path component (e.g. subfolder install
+ * `https://dev.example.com/joomla`) we preserve it — that path is where
+ * Joomla's `/api/index.php/...` is rooted.
+ */
+export declare function detectPlatformAtRuntime(baseUrl: string, options?: DetectPlatformAtRuntimeOptions): Promise<PlatformKind | null>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/platform/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/platform/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAGH,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAKpB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CACrB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,8BAA8B;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;CACnC;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,8BAAmC,GAC7C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgB9B"}

package/dist/platform/detect.js

@@ -0,0 +1,98 @@
+/**
+ * Runtime platform detection — F-Platform-Detect-Probe (P0 customer fix).
+ *
+ * The static URL-shape heuristic in `detectPlatformFromUrl()` only works
+ * when the user-supplied base URL already carries `/wp-json/` or
+ * `/api/index.php/` in its path. That is RARELY the case in practice —
+ * the DXT/manifest tells the user to enter the **site origin** (or a
+ * subfolder install like `https://dev.example.com/joomla`), neither of
+ * which contains those markers. The heuristic then silently falls back
+ * to the WordPress default and the Joomla customer experiences a
+ * 24/24 FAIL until they manually set `YTB_MCP_PLATFORM=joomla`.
+ *
+ * This module adds a *runtime probe*: lightweight unauthenticated GETs
+ * against both platforms' `/health` endpoints. Whichever returns a
+ * yt-builder-mcp-shaped response (a JSON body carrying `plugin_version`)
+ * wins. Joomla is probed first because the negative case (probe fails)
+ * is the long-tail and the positive case (probe succeeds) returns fast
+ * — letting the more common WordPress install just fall through to the
+ * second probe without paying for a wasted full timeout.
+ *
+ * The probe is fire-and-forget safe:
+ *   - 3 s `AbortSignal.timeout` per request (so a totally broken host
+ *     blocks ~6 s worst case, not the request's full 15 s default).
+ *   - Non-200 responses are ignored (Joomla on a WP-only install
+ *     answers 404; that's fine).
+ *   - Non-JSON / wrong-shape 200 responses are ignored (a WP frontend
+ *     without the plugin renders the homepage HTML, which `JSON.parse`
+ *     refuses — handled).
+ *   - Any thrown error (DNS, TLS, abort) is swallowed → try next.
+ *
+ * The function returns `null` when BOTH probes fail; the caller then
+ * falls back to the URL-shape heuristic or the wordpress default. We do
+ * NOT throw, because a missing-plugin or wrong-URL diagnosis belongs to
+ * the first real authenticated request — not to silent boot-time probing.
+ *
+ * @license MIT
+ */
+import { JOOMLA_REST_NAMESPACE_PATH, WORDPRESS_REST_NAMESPACE_PATH, } from './index.js';
+/** Per-probe HTTP timeout. Keep tight — boot-time UX is on the line. */
+const PROBE_TIMEOUT_MS = 3_000;
+const PROBE_CANDIDATES = [
+    // Joomla first — see module header rationale.
+    { kind: 'joomla', path: `${JOOMLA_REST_NAMESPACE_PATH}/health` },
+    { kind: 'wordpress', path: `${WORDPRESS_REST_NAMESPACE_PATH}/health` },
+];
+/**
+ * Probe both platforms' health endpoints and return the first kind that
+ * answers with a yt-builder-mcp-shaped JSON payload. Returns `null`
+ * when neither responds usefully (so the caller can fall through to the
+ * URL-shape heuristic / default).
+ *
+ * NB: `baseUrl` is taken verbatim except for trimming trailing slashes.
+ * If `baseUrl` itself carries a path component (e.g. subfolder install
+ * `https://dev.example.com/joomla`) we preserve it — that path is where
+ * Joomla's `/api/index.php/...` is rooted.
+ */
+export async function detectPlatformAtRuntime(baseUrl, options = {}) {
+    const timeoutMs = options.timeoutMs ?? PROBE_TIMEOUT_MS;
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== 'function')
+        return null;
+    const trimmed = baseUrl.replace(/\/+$/, '');
+    for (const { kind, path } of PROBE_CANDIDATES) {
+        const matched = await probeOne(trimmed + path, timeoutMs, fetchImpl);
+        if (matched)
+            return kind;
+    }
+    return null;
+}
+async function probeOne(url, timeoutMs, fetchImpl) {
+    try {
+        const signal = AbortSignal.timeout(timeoutMs);
+        const r = await fetchImpl(url, { signal });
+        if (!r.ok)
+            return false;
+        // Some hosts answer JSON with `text/html` Content-Type; don't
+        // rely on the header. Parse defensively.
+        const text = await r.text();
+        let body;
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            return false;
+        }
+        return isYtbHealthShape(body);
+    }
+    catch {
+        return false;
+    }
+}
+/** Recognises a yt-builder-mcp `/health` response. */
+function isYtbHealthShape(body) {
+    return (typeof body === 'object'
+        && body !== null
+        && 'plugin_version' in body);
+}
+//# sourceMappingURL=detect.js.map

package/dist/platform/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/platform/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACH,0BAA0B,EAC1B,6BAA6B,GAEhC,MAAM,YAAY,CAAC;AAEpB,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAuB/B,MAAM,gBAAgB,GAA8B;IAChD,8CAA8C;IAC9C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,0BAA0B,SAAS,EAAE;IAChE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,6BAA6B,SAAS,EAAE;CACzE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,OAAe,EACf,UAA0C,EAAE;IAE5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACxD,MAAM,SAAS,GACX,OAAO,CAAC,SAAS,IAAK,UAAU,CAAC,KAAoB,CAAC;IAC1D,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC1B,OAAO,GAAG,IAAI,EACd,SAAS,EACT,SAAS,CACZ,CAAC;QACF,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,QAAQ,CACnB,GAAW,EACX,SAAiB,EACjB,SAAqB;IAErB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QACxB,8DAA8D;QAC9D,yCAAyC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,sDAAsD;AACtD,SAAS,gBAAgB,CAAC,IAAa;IACnC,OAAO,CACH,OAAO,IAAI,KAAK,QAAQ;WACrB,IAAI,KAAK,IAAI;WACb,gBAAgB,IAAI,IAAI,CAC9B,CAAC;AACN,CAAC"}

package/dist/platform/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Platform abstraction — Wave G.0.
+ *
+ * A `Platform` is the seam between the MCP server and a host CMS. Today
+ * the only concrete impl is `WordPressPlatform`; `joomla` is reserved
+ * as a typed seam-marker so Wave G.4+ can land Joomla without rippling
+ * through every call site.
+ *
+ * Why an interface instead of a tagged union?
+ *   - Each platform owns its REST-namespace path verbatim (WP uses
+ *     `/wp-json/<ns>`, Joomla will use `/index.php?option=com_ajax&…`).
+ *   - Adding a platform = implement the interface + add a `PlatformKind`
+ *     member. No switch statements to update.
+ *
+ * The `RestClient` accepts EITHER a `Platform` OR the legacy
+ * `{baseUrl}` form (which internally builds a `WordPressPlatform`),
+ * so existing callers keep working unchanged.
+ *
+ * @license MIT
+ */
+/** Tagged union of supported host platforms. */
+export type PlatformKind = 'wordpress' | 'joomla';
+/**
+ * A `Platform` describes WHERE and HOW the MCP server reaches the
+ * REST surface of the host CMS.
+ */
+export interface Platform {
+    /** Discriminator for runtime checks. */
+    readonly kind: PlatformKind;
+    /** Origin (scheme + host + optional port). No trailing-slash normalisation here. */
+    readonly baseUrl: string;
+    /** Path prefix appended to baseUrl to form the REST root (must start with `/`). */
+    readonly restNamespacePath: string;
+}
+/** Canonical WordPress REST-namespace path for this plugin. */
+export declare const WORDPRESS_REST_NAMESPACE_PATH = "/wp-json/yt-builder-mcp/v1";
+/**
+ * WordPress platform implementation.
+ *
+ * `restNamespacePath` is fixed to the plugin's namespace; the caller
+ * supplies only the site origin.
+ */
+export declare class WordPressPlatform implements Platform {
+    readonly kind: "wordpress";
+    readonly baseUrl: string;
+    readonly restNamespacePath: string;
+    constructor(baseUrl: string);
+}
+export { JoomlaPlatform, JOOMLA_REST_NAMESPACE_PATH } from './joomla.js';
+/**
+ * Detect which {@link Platform} a base URL targets based on the URL
+ * shape alone (no network call).
+ *
+ *   - pathname starts with `/wp-json/` → `'wordpress'`
+ *   - pathname starts with `/api/index.php/` → `'joomla'`
+ *   - otherwise → `null` (ambiguous — caller may probe `/identity`)
+ *
+ * Round-6 A1 polish: detection switched from `String.includes` to a
+ * proper `URL`-parse + `pathname.startsWith` so query-string payloads
+ * cannot cause mis-detection (e.g. a Joomla site URL like
+ * `https://example.com/?redirect=/wp-json/foo` no longer pretends to
+ * be WordPress). Malformed URLs that the `URL` constructor rejects
+ * gracefully fall back to the legacy substring scan so callers that
+ * accidentally pass a host-only string (e.g. `example.com`) keep
+ * working — they would have already failed the actual network call
+ * with a clearer error before this function was reached in practice.
+ *
+ * Cookbook §3.7.1 — the runtime tie-breaker (when this returns `null`)
+ * is the `/identity` endpoint, which returns
+ * `{ product: 'yt-builder-mcp', platform: 'wordpress'|'joomla', ... }`
+ * on both platforms.
+ */
+export declare function detectPlatformFromUrl(url: string): PlatformKind | null;
+/**
+ * Construct the right {@link Platform} for a base URL.
+ *
+ * When the URL shape gives an unambiguous hint via
+ * {@link detectPlatformFromUrl}, that wins. Otherwise the caller can
+ * pass an explicit `hint` (e.g. from a config flag) or fall back to
+ * the default (`'wordpress'` for back-compat — Joomla support landed
+ * in Wave 7, so existing WordPress installs never need to flag).
+ *
+ * Synchronous variant — kept for back-compat with callers that cannot
+ * (or do not need to) probe over the network. Prefer
+ * {@link platformForUrlAsync} when running in the server boot path:
+ * it adds a runtime probe that disambiguates origin-only / subfolder
+ * URLs (e.g. `https://example.com/joomla`) where the URL shape alone
+ * is silent.
+ */
+export declare function platformForUrl(baseUrl: string, hint?: PlatformKind): Platform;
+/**
+ * Async variant of {@link platformForUrl} that adds a runtime probe
+ * step for URLs the URL-shape heuristic cannot disambiguate.
+ *
+ * Resolution order (first match wins):
+ *   1. Explicit `hint` from `YTB_MCP_PLATFORM` env var → no probe.
+ *   2. URL-shape via {@link detectPlatformFromUrl} (clear `/wp-json/`
+ *      or `/api/index.php/` marker) → no probe.
+ *   3. Runtime probe via `detectPlatformAtRuntime` (the F-Platform-
+ *      Detect-Probe fix — handles subfolder installs like
+ *      `https://dev.example.com/joomla` where steps 1+2 return null).
+ *   4. Final fallback: `'wordpress'` (back-compat).
+ *
+ * The probe step is what unblocks origin-only Joomla customers without
+ * forcing them to manually set `YTB_MCP_PLATFORM=joomla` — the DXT
+ * default of `auto` finally lives up to its name.
+ *
+ * If both probes fail (server unreachable, plugin not installed, etc.)
+ * we fall back to the wordpress default and emit a single stderr note
+ * so the customer at least sees *why* the next authenticated call may
+ * 404; the real diagnosis still belongs to the first authenticated
+ * tool invocation.
+ *
+ * @param opts.probe Optional probe override (tests / DI).
+ * @param opts.logger Optional stderr writer (defaults to `process.stderr.write`).
+ */
+export declare function platformForUrlAsync(baseUrl: string, hint?: PlatformKind, opts?: {
+    readonly probe?: (url: string) => Promise<PlatformKind | null>;
+    readonly logger?: (msg: string) => void;
+}): Promise<Platform>;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACtC;AAED,+DAA+D;AAC/D,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAE1E;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,SAAgB,IAAI,EAAG,WAAW,CAAU;IAC5C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,OAAO,EAAE,MAAM;CAI9B;AAOD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAetE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,YAAY,GACpB,QAAQ,CAMV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,YAAY,EACnB,IAAI,GAAE;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,CACb,GAAG,EAAE,MAAM,KACV,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,GACP,OAAO,CAAC,QAAQ,CAAC,CA0CnB"}

package/dist/platform/index.js

@@ -0,0 +1,176 @@
+/**
+ * Platform abstraction — Wave G.0.
+ *
+ * A `Platform` is the seam between the MCP server and a host CMS. Today
+ * the only concrete impl is `WordPressPlatform`; `joomla` is reserved
+ * as a typed seam-marker so Wave G.4+ can land Joomla without rippling
+ * through every call site.
+ *
+ * Why an interface instead of a tagged union?
+ *   - Each platform owns its REST-namespace path verbatim (WP uses
+ *     `/wp-json/<ns>`, Joomla will use `/index.php?option=com_ajax&…`).
+ *   - Adding a platform = implement the interface + add a `PlatformKind`
+ *     member. No switch statements to update.
+ *
+ * The `RestClient` accepts EITHER a `Platform` OR the legacy
+ * `{baseUrl}` form (which internally builds a `WordPressPlatform`),
+ * so existing callers keep working unchanged.
+ *
+ * @license MIT
+ */
+/** Canonical WordPress REST-namespace path for this plugin. */
+export const WORDPRESS_REST_NAMESPACE_PATH = '/wp-json/yt-builder-mcp/v1';
+/**
+ * WordPress platform implementation.
+ *
+ * `restNamespacePath` is fixed to the plugin's namespace; the caller
+ * supplies only the site origin.
+ */
+export class WordPressPlatform {
+    kind = 'wordpress';
+    baseUrl;
+    restNamespacePath;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+        this.restNamespacePath = WORDPRESS_REST_NAMESPACE_PATH;
+    }
+}
+// Local import keeps the symbol in scope for `platformForUrl` below;
+// the re-export immediately after surfaces it to outside callers so
+// the platform barrel remains the single import point (cookbook
+// Ch1 Finding 2).
+import { JoomlaPlatform } from './joomla.js';
+export { JoomlaPlatform, JOOMLA_REST_NAMESPACE_PATH } from './joomla.js';
+/**
+ * Detect which {@link Platform} a base URL targets based on the URL
+ * shape alone (no network call).
+ *
+ *   - pathname starts with `/wp-json/` → `'wordpress'`
+ *   - pathname starts with `/api/index.php/` → `'joomla'`
+ *   - otherwise → `null` (ambiguous — caller may probe `/identity`)
+ *
+ * Round-6 A1 polish: detection switched from `String.includes` to a
+ * proper `URL`-parse + `pathname.startsWith` so query-string payloads
+ * cannot cause mis-detection (e.g. a Joomla site URL like
+ * `https://example.com/?redirect=/wp-json/foo` no longer pretends to
+ * be WordPress). Malformed URLs that the `URL` constructor rejects
+ * gracefully fall back to the legacy substring scan so callers that
+ * accidentally pass a host-only string (e.g. `example.com`) keep
+ * working — they would have already failed the actual network call
+ * with a clearer error before this function was reached in practice.
+ *
+ * Cookbook §3.7.1 — the runtime tie-breaker (when this returns `null`)
+ * is the `/identity` endpoint, which returns
+ * `{ product: 'yt-builder-mcp', platform: 'wordpress'|'joomla', ... }`
+ * on both platforms.
+ */
+export function detectPlatformFromUrl(url) {
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        // Fallback for inputs the URL constructor rejects (host-only
+        // strings, relative paths). Preserves the legacy substring
+        // behaviour as a defensive net.
+        if (url.includes('/wp-json/'))
+            return 'wordpress';
+        if (url.includes('/api/index.php/'))
+            return 'joomla';
+        return null;
+    }
+    if (pathname.startsWith('/wp-json/'))
+        return 'wordpress';
+    if (pathname.startsWith('/api/index.php/'))
+        return 'joomla';
+    return null;
+}
+/**
+ * Construct the right {@link Platform} for a base URL.
+ *
+ * When the URL shape gives an unambiguous hint via
+ * {@link detectPlatformFromUrl}, that wins. Otherwise the caller can
+ * pass an explicit `hint` (e.g. from a config flag) or fall back to
+ * the default (`'wordpress'` for back-compat — Joomla support landed
+ * in Wave 7, so existing WordPress installs never need to flag).
+ *
+ * Synchronous variant — kept for back-compat with callers that cannot
+ * (or do not need to) probe over the network. Prefer
+ * {@link platformForUrlAsync} when running in the server boot path:
+ * it adds a runtime probe that disambiguates origin-only / subfolder
+ * URLs (e.g. `https://example.com/joomla`) where the URL shape alone
+ * is silent.
+ */
+export function platformForUrl(baseUrl, hint) {
+    const detected = detectPlatformFromUrl(baseUrl);
+    const kind = detected ?? hint ?? 'wordpress';
+    return kind === 'joomla'
+        ? new JoomlaPlatform(baseUrl)
+        : new WordPressPlatform(baseUrl);
+}
+/**
+ * Async variant of {@link platformForUrl} that adds a runtime probe
+ * step for URLs the URL-shape heuristic cannot disambiguate.
+ *
+ * Resolution order (first match wins):
+ *   1. Explicit `hint` from `YTB_MCP_PLATFORM` env var → no probe.
+ *   2. URL-shape via {@link detectPlatformFromUrl} (clear `/wp-json/`
+ *      or `/api/index.php/` marker) → no probe.
+ *   3. Runtime probe via `detectPlatformAtRuntime` (the F-Platform-
+ *      Detect-Probe fix — handles subfolder installs like
+ *      `https://dev.example.com/joomla` where steps 1+2 return null).
+ *   4. Final fallback: `'wordpress'` (back-compat).
+ *
+ * The probe step is what unblocks origin-only Joomla customers without
+ * forcing them to manually set `YTB_MCP_PLATFORM=joomla` — the DXT
+ * default of `auto` finally lives up to its name.
+ *
+ * If both probes fail (server unreachable, plugin not installed, etc.)
+ * we fall back to the wordpress default and emit a single stderr note
+ * so the customer at least sees *why* the next authenticated call may
+ * 404; the real diagnosis still belongs to the first authenticated
+ * tool invocation.
+ *
+ * @param opts.probe Optional probe override (tests / DI).
+ * @param opts.logger Optional stderr writer (defaults to `process.stderr.write`).
+ */
+export async function platformForUrlAsync(baseUrl, hint, opts = {}) {
+    // 1. Explicit hint wins — probe-less, by design (user override).
+    if (hint !== undefined) {
+        return hint === 'joomla'
+            ? new JoomlaPlatform(baseUrl)
+            : new WordPressPlatform(baseUrl);
+    }
+    // 2. Static URL-shape heuristic.
+    const detected = detectPlatformFromUrl(baseUrl);
+    if (detected !== null) {
+        return detected === 'joomla'
+            ? new JoomlaPlatform(baseUrl)
+            : new WordPressPlatform(baseUrl);
+    }
+    // 3. Runtime probe. Lazy-imported so the sync `platformForUrl`
+    //    barrel above stays free of any fetch dependency for callers
+    //    that do not opt-in.
+    const probe = opts.probe
+        ?? (async (url) => {
+            const mod = await import('./detect.js');
+            return mod.detectPlatformAtRuntime(url);
+        });
+    const probed = await probe(baseUrl);
+    if (probed !== null) {
+        return probed === 'joomla'
+            ? new JoomlaPlatform(baseUrl)
+            : new WordPressPlatform(baseUrl);
+    }
+    // 4. Final fallback — emit a single soft note so the user knows
+    //    we tried and that explicit YTB_MCP_PLATFORM may rescue.
+    const logger = opts.logger
+        ?? ((msg) => {
+            process.stderr.write(msg);
+        });
+    logger('[yt-builder-mcp] notice: platform auto-detection probe failed for '
+        + `${baseUrl} — falling back to wordpress. Set YTB_MCP_PLATFORM=joomla `
+        + 'if this is a Joomla install.\n');
+    return new WordPressPlatform(baseUrl);
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

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

package/dist/platform/joomla.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Joomla 5/6 platform implementation — Wave 7 prep.
+ *
+ * Mirrors {@link WordPressPlatform} but targets the Joomla Web Services
+ * API surface registered by `plg_system_ytbmcp` (see
+ * `src/packaging/joomla/extensions/plg_system_ytbmcp/src/Extension/Ytbmcp.php`
+ * — `onBeforeApiRoute()` mounts the routes under
+ * `v1/yt-builder-mcp/...` against `com_ytbmcp`).
+ *
+ * The full request URL composed by {@link RestClient} is:
+ *
+ *     {baseUrl}/api/index.php/v1/yt-builder-mcp/{path}
+ *
+ * — where `{baseUrl}` is the Joomla site origin (e.g. `https://example.com`
+ * or `https://example.com/joomla` for a subfolder install) and `{path}`
+ * is the per-tool REST path (e.g. `/health`, `/pages`, `/etag`).
+ *
+ * Cookbook Ch1 Finding 2: the `PlatformKind` union already declared
+ * `'joomla'` in Wave G.0; this class fills the seam so no tool handler
+ * has to change.
+ *
+ * Cookbook §3.7 (cross-platform parity): the REST byte-shape returned
+ * by every endpoint is identical across platforms — only the route
+ * prefix differs.
+ *
+ * @license MIT
+ */
+import type { Platform } from './index.js';
+/** Canonical Joomla REST namespace prefix for this plugin. */
+export declare const JOOMLA_REST_NAMESPACE_PATH = "/api/index.php/v1/yt-builder-mcp";
+/**
+ * Joomla platform implementation.
+ *
+ * `restNamespacePath` is fixed to the Web Services API mount point that
+ * `plg_system_ytbmcp::onBeforeApiRoute()` registers; the caller supplies
+ * only the site origin.
+ */
+export declare class JoomlaPlatform implements Platform {
+    readonly kind: "joomla";
+    readonly baseUrl: string;
+    readonly restNamespacePath: string;
+    constructor(baseUrl: string);
+}
+//# sourceMappingURL=joomla.d.ts.map

package/dist/platform/joomla.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joomla.d.ts","sourceRoot":"","sources":["../../src/platform/joomla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAE7E;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,OAAO,EAAE,MAAM;CAI9B"}