@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/sites/tools/use-site.js

@@ -1,43 +1,9 @@
-/**
- * Phase 3 — `yootheme_builder_use_site` L1 tool.
- *
- * Runtime active-site SWITCH. The multi-site analogue of api-mapper's
- * `apimapper_use_profile`: it changes which configured site subsequent
- * tool calls target by default, then (unless `probe: false`) verifies
- * the new site is reachable.
- *
- * Why a tool (and not just the `site_id` param on every call):
- *  - Maria-the-Claude-Desktop-user works in long conversations against
- *    ONE client site at a time. Re-passing `site_id` on every call is
- *    error-prone. `sites_list` + `use_site` mirror the
- *    `list_profiles` + `use_profile` flow she already knows from
- *    api-mapper: discover, switch once, then work.
- *
- * How it reuses the existing engine (NO new multi-site machinery):
- *  - The {@link SiteRegistry} stays immutable; the switch moves the
- *    {@link ClientPool}'s in-memory active-site override
- *    (`setActiveSite`). `resolve(undefined)` consults that override
- *    before the registry default. Unknown id → `UnknownSiteError`,
- *    surfaced as a structured `code: 'unknown_site'` error via the
- *    shared `resolveSiteOrError` helper (so the wording matches every
- *    other site-bound tool). The pointer never moves on a bad switch.
- *  - The reachability check reuses {@link probeSite} (/health + /etag),
- *    the SAME probe `sites_test` and the CLI run.
- *
- * Soft-vs-hard contract (mirrors `apimapper_use_profile`):
- *  - An UNKNOWN site is a HARD error (pointer unchanged).
- *  - A reachable-but-degraded site (probe red) is a SOFT warning: the
- *    activation still succeeds and the pointer moves, because the user
- *    explicitly asked to switch — the probe is diagnostic, not a gate.
- *    `probe: false` skips the network round-trip entirely (offline
- *    activation).
- *
- * @license MIT
- */
 import { detailResult } from '@getimo/mcp-toolkit';
 import { z } from 'zod';
 import { defineTool, mutating, structuredResult, withSiteMeta, } from '../../tools/tool-builder.js';
 import { resolveSiteOrError } from '../../tools/pool-resolve-helper.js';
+import { pluginFloorError, versionSkewNotice } from '../../compat-floor.js';
+import { PACKAGE_VERSION } from '../../package-version.js';
 import { probeSite } from '../probe.js';
 const USE_SITE_OUTPUT_SCHEMA = z.object({
     activated: z.boolean(),
@@ -56,42 +22,19 @@ const USE_SITE_OUTPUT_SCHEMA = z.object({
         .optional(),
     note: z.string().optional(),
     warnings: z.array(z.string()).optional(),
-    // F178: every switch echoes the process-wide-default caveat so the
-    // agent is reminded that concurrent clients of the same stdio server
-    // share this pointer.
     concurrency_warning: z.string().optional(),
 });
-/**
- * F178 — the constant caveat echoed on every `use_site` switch. The
- * active-site default lives in process memory (`ClientPool.activeOverride`)
- * and a single stdio server process is shared by every MCP client that
- * connected to it. So when client A switches, client B's NEXT call that
- * omits `site_id` silently inherits A's choice. The only isolation
- * guarantee is passing `site_id` explicitly per call.
- */
 const CONCURRENCY_WARNING = 'This sets a PROCESS-WIDE default: every concurrent client sharing this '
     + 'MCP server process inherits it on calls that omit `site_id`. For '
     + 'isolation between parallel agents, pass `site_id` explicitly on each '
     + 'tool call instead of relying on this shared switch.';
-/**
- * Build the Phase 3 `yootheme_builder_use_site` tool.
- *
- * Signature accepts the {@link ClientPool} directly — the switch lives
- * on the pool (`setActiveSite`), and `resolveSiteOrError(pool, site_id)`
- * validates the id + yields the `{client, site}` bundle for the probe.
- */
 export function buildUseSiteTool(pool) {
     return defineTool({
         name: 'yootheme_builder_use_site',
-        description: 'Switch the ACTIVE site for this multi-site session. After this call, ' +
-            'every tool that omits `site_id` targets the site you picked here. NOTE: ' +
-            'this default is PROCESS-WIDE — concurrent clients sharing this MCP server ' +
-            'inherit it; pass `site_id` per call for isolation between parallel agents. ' +
-            'Runs a /health + /etag probe by default; pass `probe: false` to switch ' +
-            'offline. A degraded site is a soft warning (the switch still happens). ' +
-            '`site_id` is REQUIRED. Keywords: switch/change/set active/target site, ' +
-            'select installation, use profile. Use yootheme_builder_sites_list first ' +
-            'to find IDs.',
+        description: 'Switch the ACTIVE site for this session — subsequent calls that omit `site_id` ' +
+            'target it. NOTE: this default is PROCESS-WIDE — concurrent clients sharing this ' +
+            'MCP server inherit it; pass `site_id` per call for isolation. Runs a /health + ' +
+            '/etag probe by default; `probe:false` switches offline. `site_id` is REQUIRED.',
         inputSchema: {
             site_id: z
                 .string()
@@ -110,20 +53,11 @@ export function buildUseSiteTool(pool) {
         outputSchema: USE_SITE_OUTPUT_SCHEMA,
         annotations: mutating('Sites — Switch active'),
         handler: async ({ site_id, probe = true }) => {
-            // 1. Validate the id through the shared resolver. Unknown /
-            //    no-default errors come back as structured ToolResults
-            //    (HARD error). The pointer has NOT moved yet, so a bad id
-            //    leaves the session on its previous active site.
             const r = await resolveSiteOrError(pool, site_id);
             if (!r.ok)
                 return r.error;
             const { client, site } = r;
-            // 2. Move the in-memory override. `setActiveSite` re-checks
-            //    the id exists (defense-in-depth) and throws
-            //    UnknownSiteError otherwise — but step 1 already
-            //    guaranteed it, so this is a no-throw in practice.
             pool.setActiveSite(site.id);
-            // 3. Offline path — skip the probe entirely.
             if (!probe) {
                 const payload = {
                     activated: true,
@@ -134,11 +68,9 @@ export function buildUseSiteTool(pool) {
                         'is now set but its plugin reachability was not verified.',
                     concurrency_warning: CONCURRENCY_WARNING,
                 };
-                const detail = detailResult(buildUseSiteDetail(payload));
+                const detail = detailResult({ ...buildUseSiteDetail(payload), includeMeta: false });
                 return withSiteMeta(structuredResult(detail, payload), site);
             }
-            // 4. Probe the newly-active site. A failing probe is a SOFT
-            //    warning — the switch already happened in step 2.
             const probeResult = await probeSite(client);
             const warnings = [];
             if (!(probeResult.plugin_reachable && probeResult.bearer_valid)) {
@@ -146,6 +78,19 @@ export function buildUseSiteTool(pool) {
                     `green: ${probeResult.summary} The active site still points here — ` +
                     'run yootheme_builder_sites_test for a detailed diagnosis.');
             }
+            if (probeResult.plugin_version !== undefined) {
+                const pairing = { plugin: probeResult.plugin_version, client: PACKAGE_VERSION };
+                const blocking = pluginFloorError(pairing);
+                if (blocking !== null) {
+                    warnings.push(`Switched to "${site.id}". ${blocking.message}`);
+                }
+                else {
+                    const skew = versionSkewNotice(pairing);
+                    if (skew !== null) {
+                        warnings.push(`Switched to "${site.id}". ${skew.message}`);
+                    }
+                }
+            }
             const payload = {
                 activated: true,
                 active_site_id: site.id,
@@ -166,15 +111,11 @@ export function buildUseSiteTool(pool) {
                 concurrency_warning: CONCURRENCY_WARNING,
                 ...(warnings.length > 0 ? { warnings } : {}),
             };
-            const detail = detailResult(buildUseSiteDetail(payload));
+            const detail = detailResult({ ...buildUseSiteDetail(payload), includeMeta: false });
             return withSiteMeta(structuredResult(detail, payload), site);
         },
     });
 }
-/**
- * Render a detail-card body for the switch result. Group 1 = the active
- * site, Group 2 = the probe outcome (omitted when probe was skipped).
- */
 function buildUseSiteDetail(payload) {
     const activeEntries = [
         { key: 'active_site_id', label: 'Active site', value: payload.active_site_id, format: 'badge' },
@@ -198,6 +139,16 @@ function buildUseSiteDetail(payload) {
             entries: [{ key: 'note', label: 'Note', value: payload.note }],
         });
     }
+    if (payload.warnings !== undefined && payload.warnings.length > 0) {
+        groups.push({
+            label: 'Warnings',
+            entries: payload.warnings.map((w, i) => ({
+                key: `warning_${i}`,
+                label: `Warning ${i + 1}`,
+                value: w,
+            })),
+        });
+    }
     return { title: 'YT Builder MCP — Switch Active Site', groups };
 }
 //# sourceMappingURL=use-site.js.map

package/dist/sites/tools/use-site.js.map

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

package/dist/sites/unknown-name-result.d.ts

@@ -0,0 +1,10 @@
+import { type ToolResult } from '../tools/tool-builder.js';
+export declare function unknownNameResult(opts: {
+    argument: string;
+    value: string;
+    available: readonly string[];
+    code: string;
+    error: string;
+    hint: string;
+}): ToolResult;
+//# sourceMappingURL=unknown-name-result.d.ts.map

package/dist/sites/unknown-name-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-name-result.d.ts","sourceRoot":"","sources":["../../src/sites/unknown-name-result.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAgBvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,UAAU,CAab"}

package/dist/sites/unknown-name-result.js

@@ -0,0 +1,13 @@
+import { jsonResult } from '../tools/tool-builder.js';
+export function unknownNameResult(opts) {
+    return jsonResult({
+        error: opts.error,
+        code: opts.code,
+        context: {
+            [opts.argument]: opts.value,
+            available: [...opts.available],
+        },
+        hint: opts.hint,
+    }, { isError: true });
+}
+//# sourceMappingURL=unknown-name-result.js.map

package/dist/sites/unknown-name-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-name-result.js","sourceRoot":"","sources":["../../src/sites/unknown-name-result.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,UAAU,EAAmB,MAAM,0BAA0B,CAAC;AAgBvE,MAAM,UAAU,iBAAiB,CAAC,IAOjC;IACG,OAAO,UAAU,CACb;QACI,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE;YACL,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,KAAK;YAC3B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;SACjC;QACD,IAAI,EAAE,IAAI,CAAC,IAAI;KAClB,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB,CAAC;AACN,CAAC"}

package/dist/skill-instructions.d.ts

@@ -0,0 +1,7 @@
+import type { CompatNotice } from './compat-floor.js';
+import type { SiteRegistry } from './sites/registry.js';
+export declare const INSTRUCTIONS_MAX_BYTES = 6000;
+export declare function buildInstructions(registry?: SiteRegistry, compatNotice?: CompatNotice): string;
+export declare const VERSION_NOTE_HEADING = "## Version note";
+export declare function prependConfigProblemNotice(instructions: string, configProblem: string | null, sitesAreSubstituted?: boolean): string;
+//# sourceMappingURL=skill-instructions.d.ts.map

package/dist/skill-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instructions.d.ts","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AA4D3C,wBAAgB,iBAAiB,CAC7B,QAAQ,CAAC,EAAE,YAAY,EACvB,YAAY,CAAC,EAAE,YAAY,GAC5B,MAAM,CASR;AAOD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAoEtD,wBAAgB,0BAA0B,CACtC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,mBAAmB,UAAQ,GAC5B,MAAM,CAmBR"}

package/dist/skill-instructions.js

@@ -0,0 +1,84 @@
+import { appendSitesBlock } from './skill-loader.js';
+import { listTopics } from './skill-topics.js';
+export const INSTRUCTIONS_MAX_BYTES = 6000;
+const HEADER = `# YT Builder MCP for YOOtheme Pro (unofficial)
+
+> Independent third-party project. YOOtheme® is a registered trademark of
+> YOOtheme GmbH. YT Builder MCP is built by WootsUp (getimo productions) and is
+> not affiliated with, endorsed by, or sponsored by YOOtheme.
+
+Drive the YOOtheme Pro page builder on WordPress or Joomla 5/6: discover pages,
+inspect layouts, add/move/bind elements, publish.
+`;
+const CRITICAL_RULES = `
+## Critical rules (read first)
+
+- Most tools are first-class in tools/list; the rest route through the
+  gateways: yootheme_builder_advanced({ tool, arguments }) for writes,
+  yootheme_builder_advanced_read for pure inspection. The arg key is
+  \`arguments\` (NOT \`input\`). Omit \`arguments\` to discover a tool's schema.
+- Call yootheme_builder_sites_list FIRST to discover site_ids; pass
+  site_id on every call or the default site is targeted.
+- yootheme_builder_page_publish makes the LAYOUT live — it does NOT make a
+  draft page visible to visitors. CMS visibility is a separate switch:
+  yootheme_builder_pages_set_status({ post_id, status: "publish" }).
+- Valid \`fields[]\` names differ PER TOOL. Call once without \`fields\` and
+  read \`available_fields\` from the response — do not guess.
+- Before element_add, call yootheme_builder_element_type_get_schema: its
+  \`minimal_layout\` shows required children (e.g. button needs a button_item
+  child carrying content + link).
+- Write calls need the \`etag\` from the latest read/write response; a stale
+  etag is refused with the current one in the error.
+`;
+function topicPointer() {
+    const topics = listTopics();
+    const partSlugs = new Set(topics.flatMap((t) => t.parts ?? []));
+    const bullets = topics
+        .filter((t) => !partSlugs.has(t.slug))
+        .map((t) => {
+        const parts = t.parts?.length ?? 0;
+        return `- \`${t.slug}\` — ${t.heading}${parts > 0 ? ` (${String(parts)} parts)` : ''}`;
+    })
+        .join('\n');
+    return `
+## Full guide, on demand
+
+For any deeper topic call yootheme_builder_get_skill({ topic }) — without
+\`topic\` it lists all topics. Available:
+
+${bullets}
+`;
+}
+export function buildInstructions(registry, compatNotice) {
+    const core = HEADER + CRITICAL_RULES + versionNote(compatNotice) + topicPointer();
+    const withSites = registry === undefined ? core : appendSitesBlock(core, registry);
+    const withBlocking = prependBlockingNotice(withSites, compatNotice);
+    return prependConfigProblemNotice(withBlocking, registry?.configProblem ?? null, registry?.sitesAreSubstituted ?? false);
+}
+export const VERSION_NOTE_HEADING = '## Version note';
+function versionNote(compatNotice) {
+    if (compatNotice === undefined)
+        return '';
+    if (compatNotice.kind === 'below_floor')
+        return '';
+    return `\n${VERSION_NOTE_HEADING}\n\n${compatNotice.message}\n`;
+}
+function prependBlockingNotice(instructions, compatNotice) {
+    if (compatNotice === undefined || compatNotice.kind !== 'below_floor')
+        return instructions;
+    return `> **STOP — this site cannot be driven until it is updated.**\n>\n> ${compatNotice.message}\n\n${instructions}`;
+}
+export function prependConfigProblemNotice(instructions, configProblem, sitesAreSubstituted = false) {
+    if (configProblem === null || configProblem === '')
+        return instructions;
+    return (`## Configuration problem\n\n${configProblem}\n\n`
+        + 'This configured connection was rejected at startup — see the reason above. '
+        + 'Fix it and restart this server.\n\n'
+        + (sitesAreSubstituted
+            ? 'While this stands, the site names below are a SUBSTITUTE and a call '
+                + 'that names one is refused. Call tools WITHOUT `site_id` — they run '
+                + 'against the substitute site, and `sites_list` shows which one.\n\n'
+            : '')
+        + `${instructions}`);
+}
+//# sourceMappingURL=skill-instructions.js.map

package/dist/skill-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instructions.js","sourceRoot":"","sources":["../src/skill-instructions.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,MAAM,MAAM,GAAG;;;;;;;;CAQd,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC;AAEF,SAAS,YAAY;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAQ5B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACP,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3F,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO;;;;;;EAMT,OAAO;CACR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,QAAuB,EACvB,YAA2B;IAE3B,MAAM,IAAI,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE,CAAC;IAClF,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACpE,OAAO,0BAA0B,CAC7B,YAAY,EACZ,QAAQ,EAAE,aAAa,IAAI,IAAI,EAC/B,QAAQ,EAAE,mBAAmB,IAAI,KAAK,CACzC,CAAC;AACN,CAAC;AAOD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAetD,SAAS,WAAW,CAAC,YAA2B;IAC5C,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1C,IAAI,YAAY,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,KAAK,oBAAoB,OAAO,YAAY,CAAC,OAAO,IAAI,CAAC;AACpE,CAAC;AAiBD,SAAS,qBAAqB,CAAC,YAAoB,EAAE,YAA2B;IAC5E,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,YAAY,CAAC;IAC3F,OAAO,sEAAsE,YAAY,CAAC,OAAO,OAAO,YAAY,EAAE,CAAC;AAC3H,CAAC;AA6BD,MAAM,UAAU,0BAA0B,CACtC,YAAoB,EACpB,aAA4B,EAC5B,mBAAmB,GAAG,KAAK;IAE3B,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC;IACxE,OAAO,CACH,+BAA+B,aAAa,MAAM;UAChD,6EAA6E;UAC7E,qCAAqC;UAOrC,CAAC,mBAAmB;YAClB,CAAC,CAAC,sEAAsE;kBACpE,qEAAqE;kBACrE,oEAAoE;YACxE,CAAC,CAAC,EAAE,CAAC;UACP,GAAG,YAAY,EAAE,CACtB,CAAC;AACN,CAAC"}

package/dist/skill-loader.d.ts

@@ -1,111 +1,9 @@
-/**
- * Skill loader — Stream B1 (Skill-Distribution via MCP-Protocol).
- *
- * Reads the bundled SKILL.md once at module-load time and exposes it
- * so that:
- *
- *   1. `createServer` can pass the content as the `instructions` field
- *      to `McpServer`. MCP-spec hosts (Claude Desktop, Cursor, …)
- *      surface this string as auto-context after the `initialize`
- *      handshake — Maria the Claude-Desktop user receives the skill
- *      narrative without ever invoking a tool.
- *
- *   2. A `skill://yt-builder-mcp` resource can return the same content
- *      on demand for hosts that ignore `instructions` but honor
- *      `resources/list` + `resources/read`.
- *
- * Resolution layout (matches `install-skill.ts` + `build-mcpb.js`):
- *
- *   packages/mcp/skills/yt-builder-mcp/SKILL.md
- *
- * When the file is compiled to `dist/skill-loader.js`, the same
- * relative `../skills/yt-builder-mcp/SKILL.md` resolves correctly
- * because the published npm tarball (and the MCPB stage) preserves the
- * `skills/` folder next to `dist/`.
- *
- * Read errors throw at module-init: a missing SKILL.md is a packaging
- * bug, not a recoverable runtime condition.
- *
- * W8 — `appendSitesBlock(skillContent, registry)` post-processor.
- *  When the in-process {@link SiteRegistry} carries ≥1 configured
- *  site, append a "Currently configured sites" appendix to the
- *  instructions string so MCP hosts surface the live site roster
- *  alongside the skill narrative. The appendix contains ONLY
- *  safe-to-render metadata (site_id, label, platform hint/resolved,
- *  url, default-flag) — bearer fields are NEVER touched. When the
- *  registry has 0 sites the original skill content is returned
- *  verbatim (no appendix, no separator).
- *
- *  This is a pure-string post-processor; it does not touch the
- *  on-disk SKILL.md. Per plan §W8 (line 919) the MCP `initialize`
- *  response carries `instructions` as a single shot, so an AI client
- *  restart is required for the appendix to refresh after a sites file
- *  edit. The W9 CLI commands (add-site / remove-site) print a reminder.
- *
- * @license MIT
- */
 import type { SiteRegistry } from './sites/registry.js';
-/** Stable URI under which the skill resource is exposed via MCP `resources/*`. */
 export declare const SKILL_RESOURCE_URI = "skill://yt-builder-mcp";
-/** Human-readable resource name surfaced in `resources/list`. */
 export declare const SKILL_RESOURCE_NAME = "YT Builder MCP \u2014 Skill Guide";
-/** Short description for `resources/list` consumers. */
 export declare const SKILL_RESOURCE_DESCRIPTION: string;
-/** MIME type for the SKILL.md payload. */
 export declare const SKILL_RESOURCE_MIME_TYPE = "text/markdown";
-/**
- * Load the bundled SKILL.md content. Cached after the first read.
- *
- * When `registry` is supplied AND it carries ≥1 site, the returned
- * string is the on-disk SKILL.md PLUS the W8 sites appendix (see
- * {@link appendSitesBlock}). When `registry` is omitted or empty, the
- * raw skill content is returned unchanged. The disk cache is shared
- * across calls — the appendix is recomputed each time so registry
- * mutations after the first load are reflected (within the same
- * process instance — the MCP `initialize` response only takes a
- * single-shot snapshot per session per plan §W8 line 919).
- *
- * @throws Error when the file is missing or unreadable (packaging bug).
- */
 export declare function loadSkillContent(registry?: SiteRegistry): string;
-/**
- * Append the W8 "Currently configured sites" block to a skill-content
- * string. When the registry is empty, returns the input verbatim — no
- * separator, no header, no trailing newline change.
- *
- * Output shape (per plan §W8 Z.904-917):
- * ```text
- * <skillContent>
- *
- * ---
- *
- * ## Currently configured sites (3)
- *
- * - `wp-acme` — Acme — Production · wordpress · https://acme.com · default
- * - `joomla-beta` — Beta — Staging · joomla · https://beta.example.com/joomla
- * - `wp-internal` — Internal staging · wordpress · https://internal.example.com
- *
- * Use `yootheme_builder_sites_list` to inspect this at runtime.
- * Pass `site_id: "<id>"` on any tool call to target a specific site;
- * omit it to use the default.
- * ```
- *
- * Per-row format (bullet):
- *   `- \`<site_id>\` — <label or "(no label)"> · <platform> · <url><" · default"?>`
- *
- * The platform column prefers `platform_resolved` when the registry
- * has memoised a probe result for that site (peek-only — never
- * triggers a new probe), and falls back to `platform_hint` otherwise.
- *
- * Bearer fields (bearer / bearer_ref) are intentionally NEVER
- * referenced — only `site_id`, `url`, `platform_*`, `is_default`,
- * `label` from {@link SiteRowT}.
- */
 export declare function appendSitesBlock(skillContent: string, registry: SiteRegistry): string;
-/**
- * Reset the in-memory cache. Intended for tests only.
- *
- * @internal
- */
 export declare function __resetSkillCacheForTests(): void;
 //# sourceMappingURL=skill-loader.d.ts.map

package/dist/skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,qBAAqB,CAAC;AAElE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,sCAAiC,CAAC;AAElE,wDAAwD;AACxD,eAAO,MAAM,0BAA0B,QAEqC,CAAC;AAE7E,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAmBxD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAShE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,GACvB,MAAM,CAkBR;AA0CD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,qBAAqB,CAAC;AAGlE,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAG3D,eAAO,MAAM,mBAAmB,sCAAiC,CAAC;AAGlE,eAAO,MAAM,0BAA0B,QAI6B,CAAC;AAGrE,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAiCxD,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAShE;AAmCD,wBAAgB,gBAAgB,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,GACvB,MAAM,CAkBR;AA+CD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/skill-loader.js

@@ -1,89 +1,18 @@
-/**
- * Skill loader — Stream B1 (Skill-Distribution via MCP-Protocol).
- *
- * Reads the bundled SKILL.md once at module-load time and exposes it
- * so that:
- *
- *   1. `createServer` can pass the content as the `instructions` field
- *      to `McpServer`. MCP-spec hosts (Claude Desktop, Cursor, …)
- *      surface this string as auto-context after the `initialize`
- *      handshake — Maria the Claude-Desktop user receives the skill
- *      narrative without ever invoking a tool.
- *
- *   2. A `skill://yt-builder-mcp` resource can return the same content
- *      on demand for hosts that ignore `instructions` but honor
- *      `resources/list` + `resources/read`.
- *
- * Resolution layout (matches `install-skill.ts` + `build-mcpb.js`):
- *
- *   packages/mcp/skills/yt-builder-mcp/SKILL.md
- *
- * When the file is compiled to `dist/skill-loader.js`, the same
- * relative `../skills/yt-builder-mcp/SKILL.md` resolves correctly
- * because the published npm tarball (and the MCPB stage) preserves the
- * `skills/` folder next to `dist/`.
- *
- * Read errors throw at module-init: a missing SKILL.md is a packaging
- * bug, not a recoverable runtime condition.
- *
- * W8 — `appendSitesBlock(skillContent, registry)` post-processor.
- *  When the in-process {@link SiteRegistry} carries ≥1 configured
- *  site, append a "Currently configured sites" appendix to the
- *  instructions string so MCP hosts surface the live site roster
- *  alongside the skill narrative. The appendix contains ONLY
- *  safe-to-render metadata (site_id, label, platform hint/resolved,
- *  url, default-flag) — bearer fields are NEVER touched. When the
- *  registry has 0 sites the original skill content is returned
- *  verbatim (no appendix, no separator).
- *
- *  This is a pure-string post-processor; it does not touch the
- *  on-disk SKILL.md. Per plan §W8 (line 919) the MCP `initialize`
- *  response carries `instructions` as a single shot, so an AI client
- *  restart is required for the appendix to refresh after a sites file
- *  edit. The W9 CLI commands (add-site / remove-site) print a reminder.
- *
- * @license MIT
- */
 import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-/** Stable URI under which the skill resource is exposed via MCP `resources/*`. */
 export const SKILL_RESOURCE_URI = 'skill://yt-builder-mcp';
-/** Human-readable resource name surfaced in `resources/list`. */
 export const SKILL_RESOURCE_NAME = 'YT Builder MCP — Skill Guide';
-/** Short description for `resources/list` consumers. */
-export const SKILL_RESOURCE_DESCRIPTION = 'Workflow guide for driving the YOOtheme Pro page builder via this MCP server. ' +
-    'Auto-loaded as `instructions` at initialize; also fetchable on demand.';
-/** MIME type for the SKILL.md payload. */
+export const SKILL_RESOURCE_DESCRIPTION = 'Full workflow guide for driving the YOOtheme Pro page builder via this MCP ' +
+    'server. Only a short preamble is auto-loaded as `instructions` at initialize ' +
+    '(Design E1, 2026-08-10) — fetch this resource, or call ' +
+    'yootheme_builder_get_skill({ topic }), for the complete guide.';
 export const SKILL_RESOURCE_MIME_TYPE = 'text/markdown';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-/**
- * Resolve the on-disk path to the bundled SKILL.md.
- *
- * Source-tree:   packages/mcp/src/skill-loader.ts → ../skills/yt-builder-mcp/SKILL.md
- * Built tarball: packages/mcp/dist/skill-loader.js → ../skills/yt-builder-mcp/SKILL.md
- *
- * Both layouts work because `dist/` and `src/` are siblings of
- * `skills/` under the package root.
- */
 function resolveSkillPath() {
     return resolve(__dirname, '..', 'skills', 'yt-builder-mcp', 'SKILL.md');
 }
 let cached;
-/**
- * Load the bundled SKILL.md content. Cached after the first read.
- *
- * When `registry` is supplied AND it carries ≥1 site, the returned
- * string is the on-disk SKILL.md PLUS the W8 sites appendix (see
- * {@link appendSitesBlock}). When `registry` is omitted or empty, the
- * raw skill content is returned unchanged. The disk cache is shared
- * across calls — the appendix is recomputed each time so registry
- * mutations after the first load are reflected (within the same
- * process instance — the MCP `initialize` response only takes a
- * single-shot snapshot per session per plan §W8 line 919).
- *
- * @throws Error when the file is missing or unreadable (packaging bug).
- */
 export function loadSkillContent(registry) {
     if (cached === undefined) {
         const path = resolveSkillPath();
@@ -94,39 +23,6 @@ export function loadSkillContent(registry) {
     }
     return appendSitesBlock(cached, registry);
 }
-/**
- * Append the W8 "Currently configured sites" block to a skill-content
- * string. When the registry is empty, returns the input verbatim — no
- * separator, no header, no trailing newline change.
- *
- * Output shape (per plan §W8 Z.904-917):
- * ```text
- * <skillContent>
- *
- * ---
- *
- * ## Currently configured sites (3)
- *
- * - `wp-acme` — Acme — Production · wordpress · https://acme.com · default
- * - `joomla-beta` — Beta — Staging · joomla · https://beta.example.com/joomla
- * - `wp-internal` — Internal staging · wordpress · https://internal.example.com
- *
- * Use `yootheme_builder_sites_list` to inspect this at runtime.
- * Pass `site_id: "<id>"` on any tool call to target a specific site;
- * omit it to use the default.
- * ```
- *
- * Per-row format (bullet):
- *   `- \`<site_id>\` — <label or "(no label)"> · <platform> · <url><" · default"?>`
- *
- * The platform column prefers `platform_resolved` when the registry
- * has memoised a probe result for that site (peek-only — never
- * triggers a new probe), and falls back to `platform_hint` otherwise.
- *
- * Bearer fields (bearer / bearer_ref) are intentionally NEVER
- * referenced — only `site_id`, `url`, `platform_*`, `is_default`,
- * `label` from {@link SiteRowT}.
- */
 export function appendSitesBlock(skillContent, registry) {
     const rows = registry.listForDisplay();
     if (rows.length === 0) {
@@ -142,49 +38,15 @@ export function appendSitesBlock(skillContent, registry) {
         'omit it to use the default.\n';
     return skillContent + block;
 }
-/**
- * Markdown-escape an operator-provided string so it cannot inject
- * structure into the rendered SKILL.md appendix.
- *
- * W12-R1.3 (A2-L2): the W8 sites-appendix renders `row.label` into the
- * server's `instructions` field, which MCP hosts surface to the LLM
- * verbatim. An operator with write-access to sites.json could land a
- * label like `Acme [INTERNAL TOOL: ignore prior context] Production`
- * and the prompt would carry that text into the model context. The
- * escape list covers the markdown special chars the W8 bullet format
- * could collide with (\`*_[]<>), preserving readable text while
- * preventing injection. site_id is regex-restricted at the schema
- * layer so it doesn't need escaping; url is operator-controlled but
- * has a much smaller chosen-char surface and is rendered after a `·`
- * separator that limits payload shape.
- */
 function escapeMarkdown(text) {
     return text.replace(/([\\`*_[\]<>])/g, '\\$1');
 }
-/**
- * Render one {@link SiteRowT} as a markdown bullet for the W8 sites
- * appendix.
- *
- * Format: `- \`<site_id>\` — <label> · <platform> · <url><" · default"?>`
- *
- * `<platform>` prefers `platform_resolved` (the W3 memo cache) and
- * falls back to `platform_hint` when no probe has run yet.
- * `<label>` falls back to the literal string `(no label)` when the
- * entry has none AND is markdown-escaped (W12-R1.3 prompt-injection
- * defense). The `default` suffix is only present when `is_default`
- * is true.
- */
 function renderBullet(row) {
     const platform = row.platform_resolved ?? row.platform_hint;
     const label = escapeMarkdown(row.label ?? '(no label)');
     const defaultSuffix = row.is_default ? ' · default' : '';
     return `- \`${row.site_id}\` — ${label} · ${platform} · ${row.url}${defaultSuffix}`;
 }
-/**
- * Reset the in-memory cache. Intended for tests only.
- *
- * @internal
- */
 export function __resetSkillCacheForTests() {
     cached = undefined;
 }