@vitest-agent/mcp 1.0.1 → 1.2.0

package/resources/index.js

@@ -1,166 +0,0 @@
-import { renderPatternsIndex, renderUpstreamIndex } from "./indexes.js";
-import { decodePatternsManifest, decodeUpstreamManifest } from "./manifest-schema.js";
-import { readPattern } from "./patterns.js";
-import { readUpstreamDoc } from "./upstream-docs.js";
-import { Effect } from "effect";
-import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-//#region src/resources/index.ts
-/**
-* Convert the readonly ResourceAnnotations decoded from a manifest into
-* the mutable shape the MCP SDK's Annotations type expects. The shape is
-* structurally identical; only the readonly-ness differs.
-*/
-function toSdkAnnotations(a) {
-	const out = {};
-	if (a.audience !== void 0) out.audience = [...a.audience];
-	if (a.priority !== void 0) out.priority = a.priority;
-	return out;
-}
-/**
-* Locate the `public/` directory that holds the served corpus across the
-* source and built layouts. `@savvy-web/bundler` mirrors the package-root
-* `public/` tree next to the emitted chunk (`<pkg>/public/`), so:
-*
-*   built (bundle):  index.js at dist/<env>/pkg/resources/ -> ../public
-*   source (vitest): index.ts at packages/mcp/src/resources/ -> ../../public
-*
-* Probe both and fail loudly when neither carries the patterns index, so a
-* broken build surfaces a clear path list at startup instead of an opaque
-* ENOENT the first time a consumer reads `vitest-agent://patterns/`.
-*/
-function resolveContentRoots() {
-	const here = dirname(fileURLToPath(import.meta.url));
-	const candidates = [join(here, "..", "public"), join(here, "..", "..", "public")];
-	for (const base of candidates) if (existsSync(join(base, "patterns", "_meta.json"))) return {
-		vendorRoot: join(base, "vendor", "vitest-docs"),
-		patternsRoot: join(base, "patterns")
-	};
-	throw new Error(`[vitest-agent-mcp] cannot locate the served corpus: no public/patterns/_meta.json found (tried: ${candidates.join(", ")})`);
-}
-async function listManifestPages(vendorRoot) {
-	const manifestPath = join(vendorRoot, "manifest.json");
-	if (!existsSync(manifestPath)) return [];
-	let raw;
-	try {
-		raw = await readFile(manifestPath, "utf8");
-	} catch {
-		return [];
-	}
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch {
-		return [];
-	}
-	const decoded = await Effect.runPromise(decodeUpstreamManifest(parsed).pipe(Effect.catchAll(() => Effect.succeed(null))));
-	if (!decoded?.pages) return [];
-	return decoded.pages.map((page) => ({
-		relativePath: page.path,
-		title: page.title,
-		description: page.description,
-		...page.annotations ? { annotations: page.annotations } : {}
-	}));
-}
-async function listPatternEntries(patternsRoot) {
-	const metaPath = join(patternsRoot, "_meta.json");
-	if (!existsSync(metaPath)) return [];
-	let raw;
-	try {
-		raw = await readFile(metaPath, "utf8");
-	} catch {
-		return [];
-	}
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch {
-		return [];
-	}
-	const decoded = await Effect.runPromise(decodePatternsManifest(parsed).pipe(Effect.catchAll(() => Effect.succeed(null))));
-	if (!decoded) return [];
-	return decoded.patterns.map((p) => ({
-		slug: p.slug,
-		title: p.title,
-		summary: p.summary,
-		...p.annotations ? { annotations: p.annotations } : {}
-	}));
-}
-function registerAllResources(server) {
-	const { vendorRoot, patternsRoot } = resolveContentRoots();
-	server.registerResource("vitest_docs_index", "vitest://docs/", {
-		title: "Vitest documentation: index",
-		description: "Use first when you need any Vitest API, configuration, or behavioral information and aren't sure which page covers it — lists every page in the vendored snapshot grouped by section (api, config, guide) so you can pick the right `vitest://docs/<path>` URI before fetching.",
-		mimeType: "text/markdown"
-	}, async (uri) => {
-		const result = await renderUpstreamIndex(vendorRoot);
-		return { contents: [{
-			uri: uri.href,
-			mimeType: result.mimeType,
-			text: result.content
-		}] };
-	});
-	server.registerResource("vitest_docs_page", new ResourceTemplate("vitest://docs/{+path}", { list: async () => {
-		return { resources: (await listManifestPages(vendorRoot)).map((page) => ({
-			name: `vitest_docs_${page.relativePath.replace(/\//g, "_")}`,
-			uri: `vitest://docs/${page.relativePath}`,
-			title: page.title ?? page.relativePath,
-			description: page.description ?? `Vitest docs page: ${page.relativePath}`,
-			mimeType: "text/markdown",
-			...page.annotations ? { annotations: toSdkAnnotations(page.annotations) } : {}
-		})) };
-	} }), {
-		title: "Vitest Documentation Page",
-		description: "A single page from the vendored vitest.dev docs.",
-		mimeType: "text/markdown"
-	}, async (uri, variables) => {
-		const path = variables.path;
-		const result = await readUpstreamDoc(vendorRoot, Array.isArray(path) ? path.join("/") : String(path));
-		return { contents: [{
-			uri: uri.href,
-			mimeType: result.mimeType,
-			text: result.content
-		}] };
-	});
-	server.registerResource("vitest_agent_patterns_index", "vitest-agent://patterns/", {
-		title: "vitest-agent patterns: index",
-		description: "Use first when you need a curated vitest-agent pattern and want to discover what's available — lists every pattern slug with its title and one-line summary so you can pick the right `vitest-agent://patterns/<slug>` URI before fetching.",
-		mimeType: "text/markdown"
-	}, async (uri) => {
-		const result = await renderPatternsIndex(patternsRoot);
-		return { contents: [{
-			uri: uri.href,
-			mimeType: result.mimeType,
-			text: result.content
-		}] };
-	});
-	server.registerResource("vitest_agent_pattern", new ResourceTemplate("vitest-agent://patterns/{slug}", { list: async () => {
-		return { resources: (await listPatternEntries(patternsRoot)).map((p) => ({
-			name: `vitest_agent_pattern_${p.slug.replace(/[^A-Za-z0-9]/g, "_")}`,
-			uri: `vitest-agent://patterns/${p.slug}`,
-			title: p.title,
-			description: p.summary,
-			mimeType: "text/markdown",
-			...p.annotations ? { annotations: toSdkAnnotations(p.annotations) } : {}
-		})) };
-	} }), {
-		title: "vitest-agent Pattern",
-		description: "A single curated pattern from the vitest-agent project.",
-		mimeType: "text/markdown"
-	}, async (uri, variables) => {
-		const slug = variables.slug;
-		const result = await readPattern(patternsRoot, Array.isArray(slug) ? slug[0] : String(slug));
-		return { contents: [{
-			uri: uri.href,
-			mimeType: result.mimeType,
-			text: result.content
-		}] };
-	});
-}
-
-//#endregion
-export { registerAllResources };

package/resources/indexes.js

@@ -1,77 +0,0 @@
-import { readFile, readdir } from "node:fs/promises";
-import { join } from "node:path";
-
-//#region src/resources/indexes.ts
-async function listMarkdownPages(root) {
-	const out = [];
-	async function walk(rel) {
-		const entries = await readdir(join(root, rel), { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith(".") || entry.name.startsWith("_")) continue;
-			const next = rel ? `${rel}/${entry.name}` : entry.name;
-			if (entry.isDirectory()) await walk(next);
-			else if (entry.isFile() && entry.name.endsWith(".md") && entry.name !== "ATTRIBUTION.md") out.push(next.replace(/\.md$/, ""));
-		}
-	}
-	await walk("");
-	out.sort();
-	return out;
-}
-async function renderUpstreamIndex(vendorRoot) {
-	const manifestRaw = await readFile(join(vendorRoot, "manifest.json"), "utf8");
-	const manifest = JSON.parse(manifestRaw);
-	const pages = await listMarkdownPages(vendorRoot);
-	const grouped = /* @__PURE__ */ new Map();
-	for (const page of pages) {
-		const slash = page.indexOf("/");
-		const section = slash === -1 ? "root" : page.slice(0, slash);
-		const list = grouped.get(section) ?? [];
-		list.push(page);
-		grouped.set(section, list);
-	}
-	const lines = [];
-	lines.push("# Vitest Documentation (Upstream Snapshot)");
-	lines.push("");
-	lines.push(`Snapshotted from [vitest-dev/vitest](https://github.com/vitest-dev/vitest) at tag \`${manifest.tag}\` (commit \`${manifest.commitSha.slice(0, 12)}\`).`);
-	lines.push("");
-	lines.push("Fetch any page by URI: `vitest://docs/<path>` (e.g., `vitest://docs/api/mock`).");
-	lines.push("");
-	const sections = [...grouped.keys()].sort();
-	for (const section of sections) {
-		lines.push(`## ${section}`);
-		lines.push("");
-		for (const page of grouped.get(section) ?? []) {
-			const display = page.startsWith(`${section}/`) ? page.slice(section.length + 1) : page;
-			lines.push(`- \`vitest://docs/${page}\` — ${display}`);
-		}
-		lines.push("");
-	}
-	return {
-		content: lines.join("\n"),
-		mimeType: "text/markdown"
-	};
-}
-async function renderPatternsIndex(patternsRoot) {
-	const metaRaw = await readFile(join(patternsRoot, "_meta.json"), "utf8");
-	const meta = JSON.parse(metaRaw);
-	const lines = [];
-	lines.push("# vitest-agent Curated Patterns");
-	lines.push("");
-	lines.push("Hand-written patterns specific to the vitest-agent project. Fetch any pattern by URI: `vitest-agent://patterns/<slug>`.");
-	lines.push("");
-	for (const pattern of meta.patterns) {
-		lines.push(`## ${pattern.title}`);
-		lines.push("");
-		lines.push(pattern.summary);
-		lines.push("");
-		lines.push(`- URI: \`vitest-agent://patterns/${pattern.slug}\``);
-		lines.push("");
-	}
-	return {
-		content: lines.join("\n"),
-		mimeType: "text/markdown"
-	};
-}
-
-//#endregion
-export { renderPatternsIndex, renderUpstreamIndex };

package/resources/manifest-schema.js

@@ -1,46 +0,0 @@
-import { Schema } from "effect";
-
-//#region src/resources/manifest-schema.ts
-const RELATIVE_PATH = /^[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*$/;
-/**
-* MCP 2025-11-25 resource annotations. Both sub-fields are optional so a
-* partially-annotated manifest decodes cleanly during an editorial pass.
-*
-* `audience` is the set of client roles a resource is relevant to; today
-* only `assistant` is meaningful for the vitest-agent MCP server.
-* `priority` is a float in [0, 1] that lets a client rank or filter
-* results before pulling content into context. See the editorial guide
-* in `docs/superpowers/specs/2.0-resource-annotations.md` for the
-* priority bands per content type.
-*/
-const ResourceAnnotations = Schema.Struct({
-	audience: Schema.optional(Schema.Array(Schema.Literal("user", "assistant"))),
-	priority: Schema.optional(Schema.Number.pipe(Schema.between(0, 1)))
-});
-const ManifestPage = Schema.Struct({
-	path: Schema.String.pipe(Schema.pattern(RELATIVE_PATH)),
-	title: Schema.NonEmptyString,
-	description: Schema.NonEmptyString,
-	annotations: Schema.optional(ResourceAnnotations)
-});
-const UpstreamManifest = Schema.Struct({
-	tag: Schema.NonEmptyString,
-	commitSha: Schema.NonEmptyString,
-	capturedAt: Schema.NonEmptyString,
-	source: Schema.NonEmptyString,
-	pages: Schema.optional(Schema.Array(ManifestPage))
-});
-const decodeUpstreamManifest = Schema.decodeUnknown(UpstreamManifest);
-const encodeUpstreamManifest = Schema.encodeUnknown(UpstreamManifest);
-const SLUG_PATTERN = /^[A-Za-z0-9._]+(?:[/-][A-Za-z0-9._]+)*$/;
-const PatternEntry = Schema.Struct({
-	slug: Schema.String.pipe(Schema.pattern(SLUG_PATTERN)),
-	title: Schema.NonEmptyString,
-	summary: Schema.NonEmptyString,
-	annotations: Schema.optional(ResourceAnnotations)
-});
-const PatternsManifest = Schema.Struct({ patterns: Schema.Array(PatternEntry) });
-const decodePatternsManifest = Schema.decodeUnknown(PatternsManifest);
-
-//#endregion
-export { decodePatternsManifest, decodeUpstreamManifest };

package/resources/paths.js

@@ -1,20 +0,0 @@
-import { isAbsolute, normalize, resolve, sep } from "node:path";
-
-//#region src/resources/paths.ts
-/**
-* Resolves a user-provided relative path against a vendored root,
-* appending `.md` if missing and rejecting traversal attempts.
-*/
-function resolveResourcePath(root, relativePath) {
-	if (relativePath === "") return root;
-	if (relativePath.includes("\0")) throw new Error("path contains null byte");
-	if (isAbsolute(relativePath)) throw new Error("absolute path not allowed");
-	const stripped = relativePath.replace(/^\/+/, "");
-	const resolved = resolve(root, normalize(stripped.endsWith(".md") ? stripped : `${stripped}.md`));
-	const rootWithSep = root.endsWith(sep) ? root : `${root}${sep}`;
-	if (!resolved.startsWith(rootWithSep) && resolved !== root) throw new Error("path escapes vendor root");
-	return resolved;
-}
-
-//#endregion
-export { resolveResourcePath };

package/resources/patterns.js

@@ -1,22 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-
-//#region src/resources/patterns.ts
-const SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
-async function readPattern(patternsRoot, slug) {
-	if (!SLUG_PATTERN.test(slug)) throw new Error(`invalid slug: ${slug}`);
-	const absPath = join(patternsRoot, `${slug}.md`);
-	try {
-		return {
-			content: await readFile(absPath, "utf8"),
-			mimeType: "text/markdown"
-		};
-	} catch (err) {
-		const code = err.code;
-		if (code === "ENOENT" || code === "EISDIR") throw new Error(`pattern not found: ${slug}. See vitest-agent://patterns/ for the index.`);
-		throw err;
-	}
-}
-
-//#endregion
-export { readPattern };

package/resources/upstream-docs.js

@@ -1,22 +0,0 @@
-import { resolveResourcePath } from "./paths.js";
-import { readFile } from "node:fs/promises";
-
-//#region src/resources/upstream-docs.ts
-async function readUpstreamDoc(vendorRoot, relativePath) {
-	const absPath = resolveResourcePath(vendorRoot, relativePath);
-	let content;
-	try {
-		content = await readFile(absPath, "utf8");
-	} catch (err) {
-		const code = err.code;
-		if (code === "ENOENT" || code === "EISDIR") throw new Error(`upstream doc not found: ${relativePath}`);
-		throw err;
-	}
-	return {
-		content,
-		mimeType: "text/markdown"
-	};
-}
-
-//#endregion
-export { readUpstreamDoc };