@vibescope/mcp-server 0.5.0 → 0.5.1

package/src/version.ts

@@ -1,162 +1,162 @@
-/**
- * Version checking utilities
- *
- * Compares the locally installed version against the latest published
- * version on npm to detect available updates. Uses a file-based cache
- * (~/.vibescope/version-cache.json) with 1-hour TTL to avoid hitting
- * the npm registry on every startup.
- */
-
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { resolve, dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { homedir } from 'os';
-
-const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@vibescope/mcp-server';
-const PACKAGE_NAME = '@vibescope/mcp-server';
-const CACHE_DIR = join(homedir(), '.vibescope');
-const CACHE_PATH = join(CACHE_DIR, 'version-cache.json');
-const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
-
-interface VersionCache {
-	latestVersion: string;
-	fetchedAt: number; // epoch ms
-}
-
-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';
-	}
-}
-
-/**
- * Read version from file-based cache if still valid
- */
-function readVersionCache(): string | null {
-	try {
-		if (!existsSync(CACHE_PATH)) return null;
-		const raw = JSON.parse(readFileSync(CACHE_PATH, 'utf-8')) as VersionCache;
-		if (Date.now() - raw.fetchedAt < CACHE_TTL_MS) {
-			return raw.latestVersion;
-		}
-		return null; // expired
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Write version to file-based cache
- */
-function writeVersionCache(version: string): void {
-	try {
-		if (!existsSync(CACHE_DIR)) {
-			mkdirSync(CACHE_DIR, { recursive: true });
-		}
-		const cache: VersionCache = { latestVersion: version, fetchedAt: Date.now() };
-		writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2) + '\n');
-	} catch {
-		// Non-critical — silently ignore write failures
-	}
-}
-
-/**
- * Fetch the latest published version from npm registry
- */
-export async function getLatestVersion(options?: { bypassCache?: boolean }): Promise<string | null> {
-	// Check cache first (unless bypassed)
-	if (!options?.bypassCache) {
-		const cached = readVersionCache();
-		if (cached) return cached;
-	}
-
-	try {
-		const controller = new AbortController();
-		const timeout = setTimeout(() => controller.abort(), 3000);
-
-		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 };
-		const version = data.version ?? null;
-
-		// Write to cache on successful fetch
-		if (version) writeVersionCache(version);
-
-		return version;
-	} 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(options?: { bypassCache?: boolean }): Promise<VersionInfo> {
-	const current = getLocalVersion();
-	const latest = await getLatestVersion(options);
-
-	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;
-}
+/**
+ * Version checking utilities
+ *
+ * Compares the locally installed version against the latest published
+ * version on npm to detect available updates. Uses a file-based cache
+ * (~/.vibescope/version-cache.json) with 1-hour TTL to avoid hitting
+ * the npm registry on every startup.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@vibescope/mcp-server';
+const PACKAGE_NAME = '@vibescope/mcp-server';
+const CACHE_DIR = join(homedir(), '.vibescope');
+const CACHE_PATH = join(CACHE_DIR, 'version-cache.json');
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+
+interface VersionCache {
+	latestVersion: string;
+	fetchedAt: number; // epoch ms
+}
+
+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';
+	}
+}
+
+/**
+ * Read version from file-based cache if still valid
+ */
+function readVersionCache(): string | null {
+	try {
+		if (!existsSync(CACHE_PATH)) return null;
+		const raw = JSON.parse(readFileSync(CACHE_PATH, 'utf-8')) as VersionCache;
+		if (Date.now() - raw.fetchedAt < CACHE_TTL_MS) {
+			return raw.latestVersion;
+		}
+		return null; // expired
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Write version to file-based cache
+ */
+function writeVersionCache(version: string): void {
+	try {
+		if (!existsSync(CACHE_DIR)) {
+			mkdirSync(CACHE_DIR, { recursive: true });
+		}
+		const cache: VersionCache = { latestVersion: version, fetchedAt: Date.now() };
+		writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2) + '\n');
+	} catch {
+		// Non-critical — silently ignore write failures
+	}
+}
+
+/**
+ * Fetch the latest published version from npm registry
+ */
+export async function getLatestVersion(options?: { bypassCache?: boolean }): Promise<string | null> {
+	// Check cache first (unless bypassed)
+	if (!options?.bypassCache) {
+		const cached = readVersionCache();
+		if (cached) return cached;
+	}
+
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 3000);
+
+		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 };
+		const version = data.version ?? null;
+
+		// Write to cache on successful fetch
+		if (version) writeVersionCache(version);
+
+		return version;
+	} 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(options?: { bypassCache?: boolean }): Promise<VersionInfo> {
+	const current = getLocalVersion();
+	const latest = await getLatestVersion(options);
+
+	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;
+}

package/tsconfig.json

@@ -1,16 +1,16 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/__test-*.ts", "src/handlers/checkouts.ts", "src/handlers/knowledge-query.ts", "src/handlers/roles.ts"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/__test-*.ts", "src/handlers/checkouts.ts", "src/handlers/knowledge-query.ts", "src/handlers/roles.ts"]
+}

package/vitest.config.ts

@@ -1,14 +1,14 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-	test: {
-		globals: true,
-		environment: 'node',
-		include: ['src/**/*.test.ts'],
-		setupFiles: ['./src/handlers/__test-setup__.ts'],
-		coverage: {
-			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
-		},
-	},
-});
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+	test: {
+		globals: true,
+		environment: 'node',
+		include: ['src/**/*.test.ts'],
+		setupFiles: ['./src/handlers/__test-setup__.ts'],
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html'],
+		},
+	},
+});

package/dist/tools.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const tools: Tool[];