@cascivo/mcp 0.2.0 → 0.3.3

package/dist/index.d.mts

@@ -75,6 +75,8 @@ interface RegistryComponent {
   category: string;
   version: string;
   files: string[];
+  /** filename → sha256 of upstream content — lets agents detect drift between installed and current source. */
+  fileHashes?: Record<string, string>;
   dependencies: string[];
   tags: string[];
   meta: ComponentManifest;
@@ -139,7 +141,7 @@ interface GenerationPromptOptions {
 declare function buildGenerationPrompt(registry: Registry, options?: GenerationPromptOptions): string;
 //#endregion
 //#region src/index.d.ts
-declare const VERSION = "0.0.0";
+declare const VERSION: string;
 /** Start the MCP server over stdio. */
 declare function main(): Promise<void>;
 //#endregion

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/server.ts","../src/theme.ts","../src/scaffold.ts","../src/registry.ts","../src/grammar.ts","../src/prompt.ts","../src/index.ts"],"mappings":";;;KA2BK,OAAA,IAAW,GAAA,UAAa,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;AAAA,UAE3C,aAAA;EACf,YAAA;EACA,OAAA;;EAEA,OAAA,GAAU,OAAO;AAAA;;iBAeH,YAAA,CAAa,OAAA,GAAS,aAAA,GAAqB,SAAS;;;UChDnD,WAAA;;EAEf,OAAA;EDyBG;ECvBH,OAAA;;EAEA,MAAA;AAAA;;;;;AD2BiB;iBCmJH,gBAAA,CAAiB,MAAA,EAAQ,WAAW,EAAE,IAAA;;;UCpLrC,eAAA;EACf,WAAA;EACA,UAAU;AAAA;;;;;iBAgCI,YAAA,CAAa,OAAwB,EAAf,eAAe;;;UC9BpC,YAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,MAAA;EACA,QAAA;EACA,KAAA;EACA,KAAA,EAAO,YAAY;EACnB,MAAA;EACA,aAAA;IAAiB,IAAA;IAAc,IAAA;IAAc,QAAA;EAAA;EAC7C,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,WAAA;EAAA;EACzC,YAAA;EACA,IAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,KAAA;EACA,YAAA;EACA,IAAA;EACA,IAAA,EAAM,iBAAiB;AAAA;AAAA,UAGR,QAAA;EACf,OAAA;EACA,WAAA;EACA,UAAA,EAAY,iBAAiB;AAAA;AAAA,iBAwBf,YAAA,CAAa,IAAA,YAAgB,QAAQ;;iBAUrC,cAAA,CACd,QAAA,EAAU,QAAA,EACV,QAAA,WACA,IAAA,YACC,iBAAiB;;iBAQJ,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,IAAA,WAAe,iBAAiB;;iBAoGjE,gBAAA,CAAiB,QAAA,EAAU,QAAA,EAAU,KAAA,WAAgB,iBAAiB;;;UChLrE,WAAA;EACf,IAAA;EACA,QAAA;EJaU;EIXV,IAAA;EJWkC;EITlC,IAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,QAAA;EACA,KAAA,EAAO,WAAW;EAClB,QAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,UAAA,EAAY,gBAAgB;AAAA;;;;;;iBAQd,SAAA,CAAU,IAAY;AAAA,iBA8BtB,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,MAAA,cAAoB,WAAW;;AJnC7D;AAenB;;;;iBI2EgB,aAAA,CAAc,OAAoB,EAAX,WAAW;;;UChHjC,uBAAA;;EAEf,UAAU;AAAA;;;;;;iBAsCI,qBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,GAAS,uBAA4B;;;cChD1B,OAAA;;iBA0BS,IAAA,IAAQ,OAAO"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/server.ts","../src/theme.ts","../src/scaffold.ts","../src/registry.ts","../src/grammar.ts","../src/prompt.ts","../src/index.ts"],"mappings":";;;KA4BK,OAAA,IAAW,GAAA,UAAa,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;AAAA,UAE3C,aAAA;EACf,YAAA;EACA,OAAA;;EAEA,OAAA,GAAU,OAAO;AAAA;;iBAeH,YAAA,CAAa,OAAA,GAAS,aAAA,GAAqB,SAAS;;;UCjDnD,WAAA;;EAEf,OAAA;ED0BG;ECxBH,OAAA;;EAEA,MAAA;AAAA;;;;;AD4BiB;iBCkJH,gBAAA,CAAiB,MAAA,EAAQ,WAAW,EAAE,IAAA;;;UCpLrC,eAAA;EACf,WAAA;EACA,UAAU;AAAA;;;;;iBAgCI,YAAA,CAAa,OAAwB,EAAf,eAAe;;;UC7BpC,YAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,MAAA;EACA,QAAA;EACA,KAAA;EACA,KAAA,EAAO,YAAY;EACnB,MAAA;EACA,aAAA;IAAiB,IAAA;IAAc,IAAA;IAAc,QAAA;EAAA;EAC7C,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,WAAA;EAAA;EACzC,YAAA;EACA,IAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,KAAA;EHekE;EGblE,UAAA,GAAa,MAAA;EACb,YAAA;EACA,IAAA;EACA,IAAA,EAAM,iBAAiB;AAAA;AAAA,UAGR,QAAA;EACf,OAAA;EACA,WAAA;EACA,UAAA,EAAY,iBAAiB;AAAA;AAAA,iBAwBf,YAAA,CAAa,IAAA,YAAgB,QAAQ;;iBAUrC,cAAA,CACd,QAAA,EAAU,QAAA,EACV,QAAA,WACA,IAAA,YACC,iBAAiB;;iBAQJ,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,IAAA,WAAe,iBAAiB;AA9EjF;AAAA,iBA0MgB,gBAAA,CAAiB,QAAA,EAAU,QAAA,EAAU,KAAA,WAAgB,iBAAiB;;;UC3MrE,WAAA;EACf,IAAA;EACA,QAAA;EJcU;EIZV,IAAA;EJYkC;EIVlC,IAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,QAAA;EACA,KAAA,EAAO,WAAW;EAClB,QAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,UAAA,EAAY,gBAAgB;AAAA;;;;;;iBAQd,SAAA,CAAU,IAAY;AAAA,iBA8BtB,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,MAAA,cAAoB,WAAW;;AJlC7D;AAenB;;;;iBI0EgB,aAAA,CAAc,OAAoB,EAAX,WAAW;;;UChHjC,uBAAA;;EAEf,UAAU;AAAA;;;;;;iBAsCI,qBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,GAAS,uBAA4B;;;cC5C1B,OAAA;;iBA4BS,IAAA,IAAQ,OAAO"}

package/dist/index.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { argv } from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -7,6 +8,15 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+//#region src/host.ts
+/**
+* Canonical host for hosted cascivo artifacts (registry.json, context.json,
+* tokens.catalog.json, marketplace.json, per-item r/<name>.json, llms.txt).
+* docs.cascivo.com serves the same tree as a mirror — code always fetches the
+* canonical host. Keep in sync with CASCIVO_HOST in packages/cli.
+*/
+const CASCIVO_HOST = "https://cascivo.com";
+//#endregion
 //#region src/registry.ts
 const HERE$4 = dirname(fileURLToPath(import.meta.url));
 /**
@@ -42,7 +52,23 @@ function getComponent(registry, name) {
 	const target = name.toLowerCase();
 	return registry.components.find((c) => c.name.toLowerCase() === target || c.meta.name.toLowerCase() === target)?.meta;
 }
-const DIRECTORY_URL = "https://cascivo.com/r/registries.json";
+/**
+* Manifest enriched with distribution facts (version, file hashes) so an agent
+* can compare its installed copy against upstream — `getComponent` alone
+* drops those registry-entry fields.
+*/
+function getComponentWithVersion(registry, name) {
+	const target = name.toLowerCase();
+	const entry = registry.components.find((c) => c.name.toLowerCase() === target || c.meta.name.toLowerCase() === target);
+	if (!entry) return void 0;
+	return {
+		...entry.meta,
+		version: entry.version,
+		files: entry.files,
+		...entry.fileHashes ? { fileHashes: entry.fileHashes } : {}
+	};
+}
+const DIRECTORY_URL = `${CASCIVO_HOST}/r/registries.json`;
 const FETCH_TIMEOUT_MS = 15e3;
 const MAX_BODY_BYTES = 1048576;
 async function fetchWithGuards(url, fetchFn = fetch) {
@@ -608,18 +634,18 @@ function buildGenerationPrompt(registry, options = {}) {
 //#endregion
 //#region src/tokens.ts
 const HERE$3 = dirname(fileURLToPath(import.meta.url));
-const CATALOG_BASE_URL = "https://cascivo.com";
+const CATALOG_BASE_URL$1 = CASCIVO_HOST;
 async function loadTokenCatalog(fetchFn) {
 	const localPaths = [join(HERE$3, "..", "..", "..", "apps", "site", "public", "tokens.catalog.json"), join(HERE$3, "tokens.catalog.json")];
 	for (const p of localPaths) if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
-	const res = await (fetchFn ?? fetch)(`${CATALOG_BASE_URL}/tokens.catalog.json`);
+	const res = await (fetchFn ?? fetch)(`${CATALOG_BASE_URL$1}/tokens.catalog.json`);
 	if (!res.ok) throw new Error(`Failed to fetch token catalog: ${res.status}`);
 	return res.json();
 }
 //#endregion
 //#region src/variants.ts
 const HERE$2 = dirname(fileURLToPath(import.meta.url));
-const BASE_URL = "https://cascivo.com";
+const BASE_URL = CASCIVO_HOST;
 async function loadVariantMatrix(fetchFn) {
 	const localPaths = [join(HERE$2, "..", "..", "..", "apps", "site", "public", "tokens.variants.json"), join(HERE$2, "tokens.variants.json")];
 	for (const p of localPaths) if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
@@ -799,7 +825,7 @@ function validateComponentSource(input, options = {}) {
 //#endregion
 //#region src/context.ts
 const HERE$1 = dirname(fileURLToPath(import.meta.url));
-const CONTEXT_BASE_URL = "https://cascivo.com";
+const CONTEXT_BASE_URL = CASCIVO_HOST;
 async function loadContext(fetchFn) {
 	const localPaths = [join(HERE$1, "..", "..", "..", "apps", "site", "public", "context.json"), join(HERE$1, "context.json")];
 	for (const p of localPaths) if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
@@ -874,39 +900,42 @@ function selectComponent(need, components) {
 //#endregion
 //#region src/templates.ts
 const HERE = dirname(fileURLToPath(import.meta.url));
-const EMPTY = {
-	generatedAt: "",
-	templates: [],
-	facets: {
-		categories: [],
-		frameworks: [],
-		tags: []
-	}
-};
+const CATALOG_BASE_URL = CASCIVO_HOST;
 /**
-* Resolve the marketplace catalog location. Checks, in order: an explicit path,
+* Resolve a local marketplace catalog. Checks, in order: an explicit path,
 * the `CASCIVO_MARKETPLACE_PATH` env var, a copy bundled next to the built
 * server, and the in-repo `apps/site/public/marketplace.json` (dev).
+* Returns null when no candidate exists on disk.
 */
 function resolveCatalogPath(explicit) {
-	const candidates = [
+	return [
 		explicit,
 		process.env.CASCIVO_MARKETPLACE_PATH,
 		join(HERE, "marketplace.json"),
 		join(HERE, "..", "..", "..", "apps", "site", "public", "marketplace.json"),
 		join(HERE, "..", "..", "apps", "site", "public", "marketplace.json")
-	].filter((p) => typeof p === "string" && p.length > 0);
-	return candidates.find((p) => existsSync(p)) ?? candidates[candidates.length - 1] ?? "";
+	].filter((p) => typeof p === "string" && p.length > 0).find((p) => existsSync(p)) ?? null;
 }
-/** Load the marketplace catalog, returning an empty catalog if none is found. */
-function loadCatalog(explicit) {
+/**
+* Load the marketplace catalog: bundled/local copy first, then the hosted one.
+* Throws when neither is available — an empty catalog would silently make
+* every template invisible, which is worse than a visible error.
+*/
+async function loadCatalog(explicit, fetchFn) {
 	const path = resolveCatalogPath(explicit);
-	if (!path || !existsSync(path)) return EMPTY;
-	try {
+	if (path) try {
 		return JSON.parse(readFileSync(path, "utf8"));
-	} catch {
-		return EMPTY;
+	} catch {}
+	const url = `${CATALOG_BASE_URL}/marketplace.json`;
+	const fn = fetchFn ?? fetch;
+	let res;
+	try {
+		res = await fn(url);
+	} catch (e) {
+		throw new Error(`Marketplace catalog unavailable: no local copy and ${url} unreachable (${e instanceof Error ? e.message : e})`);
 	}
+	if (!res.ok) throw new Error(`Marketplace catalog unavailable: no local copy and ${url} returned ${res.status}`);
+	return res.json();
 }
 /** Filter the catalog's templates. Pure. */
 function listTemplates(catalog, filter = {}) {
@@ -999,7 +1028,7 @@ function createServer(options = {}) {
 			const meta = getComponent(remoteRegistry, name);
 			return meta ? json(meta) : error(`Component "${name}" not found in registry "${ns}".`);
 		}
-		const meta = getComponent(registry, name);
+		const meta = getComponentWithVersion(registry, name);
 		return meta ? json(meta) : error(`Component "${name}" not found.`);
 	});
 	server.registerTool("search_components", {
@@ -1053,8 +1082,13 @@ function createServer(options = {}) {
 			framework: z.enum(["react-vite", "react-next"]).optional().describe("Filter by target framework"),
 			verifiedOnly: z.boolean().optional().describe("Only verified templates")
 		}
-	}, ({ category, tag, framework, verifiedOnly }) => {
-		const catalog = loadCatalog();
+	}, async ({ category, tag, framework, verifiedOnly }) => {
+		let catalog;
+		try {
+			catalog = await loadCatalog(void 0, fetchFn);
+		} catch (e) {
+			return error(e instanceof Error ? e.message : String(e));
+		}
 		const filter = {};
 		if (category) filter.category = category;
 		if (tag) filter.tag = tag;
@@ -1066,8 +1100,14 @@ function createServer(options = {}) {
 		title: "Get template",
 		description: "Get one marketplace template by name or install spec — its components, install command, demo link, and screenshots.",
 		inputSchema: { name: z.string().describe("Template name or install spec, e.g. \"@cascivo/dashboard\"") }
-	}, ({ name }) => {
-		const tpl = getTemplate(loadCatalog(), name);
+	}, async ({ name }) => {
+		let catalog;
+		try {
+			catalog = await loadCatalog(void 0, fetchFn);
+		} catch (e) {
+			return error(e instanceof Error ? e.message : String(e));
+		}
+		const tpl = getTemplate(catalog, name);
 		if (!tpl) return error(`Template "${name}" not found in the marketplace catalog.`);
 		return json(tpl);
 	});
@@ -1078,8 +1118,9 @@ function createServer(options = {}) {
 			name: z.string().describe("Template name or install spec, e.g. \"@cascivo/dashboard\""),
 			cwd: z.string().optional().describe("Project directory (default: current directory)")
 		}
-	}, ({ name, cwd }) => {
-		const spec = getTemplate(loadCatalog(), name)?.installSpec ?? name;
+	}, async ({ name, cwd }) => {
+		const catalog = await loadCatalog(void 0, fetchFn).catch(() => null);
+		const spec = (catalog ? getTemplate(catalog, name)?.installSpec : void 0) ?? name;
 		const result = spawnSync("npx", [
 			"-y",
 			"cascivo",
@@ -1374,7 +1415,7 @@ export function Diagram() {
 }
 //#endregion
 //#region src/index.ts
-const VERSION = "0.0.0";
+const VERSION = createRequire(import.meta.url)("../package.json").version;
 /** Start the MCP server over stdio. */
 async function main() {
 	await createServer({ version: VERSION }).connect(new StdioServerTransport());