@vibescope/mcp-server 0.4.0 → 0.4.2

package/src/version.ts

@@ -0,0 +1,109 @@
+/**
+ * Version checking utilities
+ *
+ * Compares the locally installed version against the latest published
+ * version on npm to detect available updates.
+ */
+
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@vibescope/mcp-server';
+const PACKAGE_NAME = '@vibescope/mcp-server';
+
+export interface VersionInfo {
+	current: string;
+	latest: string | null;
+	updateAvailable: boolean;
+	error?: string;
+}
+
+/**
+ * Get the current locally installed version from package.json
+ */
+export function getLocalVersion(): string {
+	try {
+		const __dirname = dirname(fileURLToPath(import.meta.url));
+		const pkgPath = resolve(__dirname, '..', 'package.json');
+		const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+		return pkg.version;
+	} catch {
+		return 'unknown';
+	}
+}
+
+/**
+ * Fetch the latest published version from npm registry
+ */
+export async function getLatestVersion(): Promise<string | null> {
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 5000);
+
+		const response = await fetch(`${NPM_REGISTRY_URL}/latest`, {
+			signal: controller.signal,
+			headers: { 'Accept': 'application/json' },
+		});
+
+		clearTimeout(timeout);
+
+		if (!response.ok) return null;
+
+		const data = (await response.json()) as { version?: string };
+		return data.version ?? null;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Compare semver strings. Returns true if latest > current.
+ */
+function isNewer(current: string, latest: string): boolean {
+	const parse = (v: string) => v.split('.').map(Number);
+	const c = parse(current);
+	const l = parse(latest);
+
+	for (let i = 0; i < 3; i++) {
+		if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
+		if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
+	}
+	return false;
+}
+
+/**
+ * Check if an update is available
+ */
+export async function checkVersion(): Promise<VersionInfo> {
+	const current = getLocalVersion();
+	const latest = await getLatestVersion();
+
+	if (!latest) {
+		return {
+			current,
+			latest: null,
+			updateAvailable: false,
+			error: 'Could not reach npm registry to check for updates',
+		};
+	}
+
+	return {
+		current,
+		latest,
+		updateAvailable: isNewer(current, latest),
+	};
+}
+
+/**
+ * Get the update warning message for server instructions, or null if up to date
+ */
+export async function getUpdateWarning(): Promise<string | null> {
+	const info = await checkVersion();
+
+	if (info.updateAvailable && info.latest) {
+		return `⚠️ UPDATE AVAILABLE: Vibescope MCP server v${info.current} is outdated. Latest version is v${info.latest}. Before starting work, inform the user that an update is available and recommend running the \`check_mcp_version\` tool, or ask them to update with: npm install -g ${PACKAGE_NAME}@latest (or npx @vibescope/mcp-server@latest for auto-update on next run).`;
+	}
+
+	return null;
+}