bestax-mcp 1.0.1 → 1.1.0

package/data/catalog.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "generatedFrom": {
     "package": "@allxsmith/bestax-bulma",
-    "version": "5.11.1"
+    "version": "5.11.2"
   },
   "docsBase": "https://bestax.io/docs",
   "categories": [

package/dist/format.d.ts

@@ -11,6 +11,20 @@
  * separate call, because most questions do not need them.
  */
 import type { CatalogEntry, ComponentRecord, CssVar, Example, Part, Skill } from './data.js';
+/**
+ * Tag an outbound link with `utm_source=bestax-mcp` so a docs or Storybook
+ * visit that started here shows up as such in the site analytics. Render-time
+ * only — the URLs in `data/` are generated and stay canonical. Idempotent, and
+ * anything that is not an http(s) URL passes through unchanged.
+ *
+ * Coverage is deliberately partial: only links this server composes itself —
+ * the Docs/Storybook footer on component responses and the version-drift
+ * notice — go through here. Skill bodies and reference docs are served
+ * verbatim from the bundled markdown, untagged links included, because
+ * rewriting URLs inside arbitrary markdown/code examples risks corrupting
+ * them. Do not "fix" that by running this over served markdown.
+ */
+export declare function attributed(url: string): string;
 export declare function table(headers: string[], rows: string[][]): string;
 export declare function renderPart(part: Part, { heading }?: {
     heading?: boolean | undefined;

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,MAAM,EACN,OAAO,EACP,IAAI,EAEJ,KAAK,EACN,MAAM,WAAW,CAAC;AAUnB,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAOjE;AAsBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAc,EAAE;;CAAK,GAAG,MAAM,CAiCtE;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAsDR;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAI1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBpD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAkB7D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAgBpD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;;;;;EAM3D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;EAK1C"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,MAAM,EACN,OAAO,EACP,IAAI,EAEJ,KAAK,EACN,MAAM,WAAW,CAAC;AAUnB;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAOjE;AAsBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAc,EAAE;;CAAK,GAAG,MAAM,CAiCtE;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAwDR;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAI1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBpD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAkB7D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAgBpD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;;;;;EAM3D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;EAK1C"}

package/dist/format.js

@@ -4,6 +4,38 @@ const cell = (text) => String(text ?? '')
     .replace(/\|/g, '\\|')
     .replace(/\r?\n/g, ' ')
     .trim();
+/**
+ * Tag an outbound link with `utm_source=bestax-mcp` so a docs or Storybook
+ * visit that started here shows up as such in the site analytics. Render-time
+ * only — the URLs in `data/` are generated and stay canonical. Idempotent, and
+ * anything that is not an http(s) URL passes through unchanged.
+ *
+ * Coverage is deliberately partial: only links this server composes itself —
+ * the Docs/Storybook footer on component responses and the version-drift
+ * notice — go through here. Skill bodies and reference docs are served
+ * verbatim from the bundled markdown, untagged links included, because
+ * rewriting URLs inside arbitrary markdown/code examples risks corrupting
+ * them. Do not "fix" that by running this over served markdown.
+ */
+export function attributed(url) {
+    if (!/^https?:\/\//.test(url))
+        return url;
+    // Split the fragment FIRST: the already-tagged check below must inspect
+    // only the query. A `#utm_source=bestax-mcp` inside a fragment (or the
+    // same text inside another parameter's value) is not attribution — the
+    // analytics request never sees it — so matching it would skip tagging.
+    // Do not use URL.searchParams: it re-encodes Storybook `path=/story/...`
+    // as `%2F`.
+    const hashIndex = url.indexOf('#');
+    const hash = hashIndex === -1 ? '' : url.slice(hashIndex);
+    const withoutHash = hashIndex === -1 ? url : url.slice(0, hashIndex);
+    const queryIndex = withoutHash.indexOf('?');
+    const query = queryIndex === -1 ? '' : withoutHash.slice(queryIndex + 1);
+    if (query.split('&').includes('utm_source=bestax-mcp'))
+        return url;
+    const sep = queryIndex === -1 ? '?' : '&';
+    return `${withoutHash}${sep}utm_source=bestax-mcp${hash}`;
+}
 export function table(headers, rows) {
     if (!rows.length)
         return '';
@@ -105,9 +137,10 @@ export function renderComponent(record, include) {
     if (include.includes('related') && record.related.length) {
         out.push(`**Related:** ${record.related.map(r => `\`${r}\``).join(', ')}.`);
     }
-    const links = [`Docs: ${record.docsUrl}`];
-    if (record.storybook)
-        links.push(`Storybook: ${record.storybook}`);
+    const links = [`Docs: ${attributed(record.docsUrl)}`];
+    if (record.storybook) {
+        links.push(`Storybook: ${attributed(record.storybook)}`);
+    }
     out.push(links.join(' · '));
     return out.join('\n\n');
 }

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AA6FjD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,CAurBpB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AA6FjD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,CAyrBpB"}

package/dist/server.js

@@ -579,8 +579,10 @@ export async function createServer(options = {}) {
     });
     // -- Prompts, one per skill ----------------------------------------------
     //
-    // Generated from the manifest, never listed here. skills/CLAUDE.md counts the
-    // roster as already duplicated in five places; this would have been a sixth.
+    // Generated from the manifest, never listed here. The roster is derived, not
+    // hand-listed (#540); the prose copies that cannot be derived are held to the
+    // directory by the skills-roster conformance check (`pnpm check:conformance
+    // --only=skills-roster`). A list here would be one more copy for it to chase.
     for (const skill of skills) {
         server.registerPrompt(skill.promptName, {
             title: skill.name,

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CACzD;AAkBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI7D;AAcD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAyCD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAetB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAS5D"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CACzD;AAkBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI7D;AAcD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAyCD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAetB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAS5D"}

package/dist/version.js

@@ -15,6 +15,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { dirname, join, parse } from 'node:path';
+import { attributed } from './format.js';
 const PACKAGE = '@allxsmith/bestax-bulma';
 /**
  * The one string in this server that does not come from its own committed data.
@@ -143,5 +144,5 @@ export function versionNote(info) {
     }
     return (`⚠ This index documents ${PACKAGE} ${info.indexed}; this project has ` +
         `${info.installed}. Props, defaults and CSS variables may differ — check ` +
-        `https://bestax.io/docs before relying on anything above.`);
+        `${attributed('https://bestax.io/docs')} before relying on anything above.`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bestax-mcp",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "MCP server for @allxsmith/bestax-bulma — component props, examples, CSS variables and agent skills, served offline from a version-pinned index",
   "type": "module",
   "bin": {