@vibescope/mcp-server 0.2.2 → 0.2.4

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export declare const AGENT_PERSONAS: readonly ["Apex", "Arc", "Atlas", "Blaze", "Bolt", "Byte", "Cipher", "Core", "Dash", "Drift", "Echo", "Edge", "Ember", "Flux", "Forge", "Ghost", "Glitch", "Haze", "Hex", "Ion", "Iris", "Jade", "Jet", "Karma", "Kite", "Lux", "Mako", "Neon", "Nova", "Onyx", "Orbit", "Pixel", "Pulse", "Quest", "Rex", "Rune", "Shade", "Spark", "Storm", "Trace", "Turbo", "Vex", "Volt", "Warp", "Wave", "Zen", "Zero"];
+export declare const AGENT_PERSONAS: readonly ["Yoda", "Leia", "Han", "Luke", "Rey", "Finn", "Kylo", "Mando", "Grogu", "Ahsoka", "Frodo", "Gandalf", "Aragorn", "Legolas", "Gimli", "Sam", "Bilbo", "Gollum", "Spock", "Kirk", "Picard", "Data", "Worf", "Seven", "Paul", "Chani", "Duncan", "Stilgar", "Leto", "Neo", "Trinity", "Morpheus", "Mal", "River", "Kaylee", "Wash", "Arya", "Tyrion", "Dany", "Bran", "Groot", "Rocket", "Gamora", "Drax", "Loki", "Thor", "Ripley", "Jarvis", "Cortana", "GLaDOS"];
 export type AgentPersona = typeof AGENT_PERSONAS[number];
 export declare const FALLBACK_ACTIVITIES: readonly [{
     readonly activity: "feature_ideation";
@@ -67,7 +67,10 @@ export type FallbackActivity = typeof FALLBACK_ACTIVITIES[number];
  */
 export declare function getRandomFallbackActivity(): FallbackActivity;
 /**
- * Select an available persona from the pool (randomly)
+ * Select an available persona from the pool
+ * Uses time-based seeding to ensure variety across sessions while maintaining
+ * determinism within the same minute (for retry consistency).
+ *
  * @param usedPersonas Set of personas currently in use
  * @param instanceId The instance ID for fallback naming
  * @returns The selected persona name

package/dist/utils.js

@@ -3,56 +3,68 @@
 // ============================================================================
 // ============================================================================
 // Agent Persona Pool
-// Short, memorable names for distinguishing agents on the dashboard
+// Iconic sci-fi & fantasy character names for agents on the dashboard
 // ============================================================================
 export const AGENT_PERSONAS = [
-    'Apex',
-    'Arc',
-    'Atlas',
-    'Blaze',
-    'Bolt',
-    'Byte',
-    'Cipher',
-    'Core',
-    'Dash',
-    'Drift',
-    'Echo',
-    'Edge',
-    'Ember',
-    'Flux',
-    'Forge',
-    'Ghost',
-    'Glitch',
-    'Haze',
-    'Hex',
-    'Ion',
-    'Iris',
-    'Jade',
-    'Jet',
-    'Karma',
-    'Kite',
-    'Lux',
-    'Mako',
-    'Neon',
-    'Nova',
-    'Onyx',
-    'Orbit',
-    'Pixel',
-    'Pulse',
-    'Quest',
-    'Rex',
-    'Rune',
-    'Shade',
-    'Spark',
-    'Storm',
-    'Trace',
-    'Turbo',
-    'Vex',
-    'Volt',
-    'Warp',
-    'Wave',
-    'Zen',
-    'Zero',
+    // Star Wars
+    'Yoda',
+    'Leia',
+    'Han',
+    'Luke',
+    'Rey',
+    'Finn',
+    'Kylo',
+    'Mando',
+    'Grogu',
+    'Ahsoka',
+    // Lord of the Rings
+    'Frodo',
+    'Gandalf',
+    'Aragorn',
+    'Legolas',
+    'Gimli',
+    'Sam',
+    'Bilbo',
+    'Gollum',
+    // Star Trek
+    'Spock',
+    'Kirk',
+    'Picard',
+    'Data',
+    'Worf',
+    'Seven',
+    // Dune
+    'Paul',
+    'Chani',
+    'Duncan',
+    'Stilgar',
+    'Leto',
+    // The Matrix
+    'Neo',
+    'Trinity',
+    'Morpheus',
+    // Firefly
+    'Mal',
+    'River',
+    'Kaylee',
+    'Wash',
+    // Game of Thrones
+    'Arya',
+    'Tyrion',
+    'Dany',
+    'Bran',
+    // Marvel / Guardians
+    'Groot',
+    'Rocket',
+    'Gamora',
+    'Drax',
+    'Loki',
+    'Thor',
+    // Classic Sci-Fi AIs & Characters
+    'Ripley',
+    'Jarvis',
+    'Cortana',
+    'GLaDOS',
 ];
 // ============================================================================
 // Fallback Activities for Idle Agents
@@ -151,7 +163,30 @@ export function getRandomFallbackActivity() {
     return FALLBACK_ACTIVITIES[index];
 }
 /**
- * Select an available persona from the pool (randomly)
+ * Fisher-Yates shuffle with a seed for reproducible randomness
+ */
+function seededShuffle(array, seed) {
+    const result = [...array];
+    let currentSeed = seed;
+    // Simple seeded random number generator (mulberry32)
+    const random = () => {
+        currentSeed = (currentSeed + 0x6D2B79F5) | 0;
+        let t = currentSeed;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = Math.floor(random() * (i + 1));
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+/**
+ * Select an available persona from the pool
+ * Uses time-based seeding to ensure variety across sessions while maintaining
+ * determinism within the same minute (for retry consistency).
+ *
  * @param usedPersonas Set of personas currently in use
  * @param instanceId The instance ID for fallback naming
  * @returns The selected persona name
@@ -161,8 +196,12 @@ export function selectPersona(usedPersonas, instanceId) {
     if (availablePersonas.length === 0) {
         return `Agent-${instanceId.slice(0, 6)}`;
     }
-    const randomIndex = Math.floor(Math.random() * availablePersonas.length);
-    return availablePersonas[randomIndex];
+    // Use current minute as seed for variety, plus some randomness for the final pick
+    // This ensures different starting points each minute while allowing retries to work
+    const minuteSeed = Math.floor(Date.now() / 60000);
+    const shuffled = seededShuffle(availablePersonas, minuteSeed);
+    // Pick randomly from the shuffled list for additional variety
+    return shuffled[Math.floor(Math.random() * shuffled.length)];
 }
 export class RateLimiter {
     requests = new Map();

package/package.json

@@ -1,46 +1,51 @@
-{
-  "name": "@vibescope/mcp-server",
-  "version": "0.2.2",
-  "description": "MCP server for Vibescope - AI project tracking tools",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "vibescope-mcp": "dist/index.js",
-    "vibescope-cli": "dist/cli.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Nonatomic/Vibescope.git",
-    "directory": "packages/mcp-server"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "docs:generate": "npx tsx scripts/generate-docs.ts --output=docs/TOOLS.md",
-    "docs:preview": "npx tsx scripts/generate-docs.ts",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "vibescope",
-    "ai",
-    "project-management"
-  ],
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^22.10.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.7.0",
-    "vitest": "^4.0.17"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.2"
-  }
-}
+{
+  "name": "@vibescope/mcp-server",
+  "version": "0.2.4",
+  "description": "MCP server for Vibescope - AI project tracking tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "vibescope-mcp": "dist/index.js",
+    "vibescope-cli": "dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nonatomic/Vibescope.git",
+    "directory": "packages/mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "docs:generate": "npx tsx scripts/generate-docs.ts --output=docs/TOOLS.md",
+    "docs:preview": "npx tsx scripts/generate-docs.ts",
+    "version:check": "npx tsx scripts/version-bump.ts --dry-run",
+    "version:bump": "npx tsx scripts/version-bump.ts",
+    "version:patch": "npx tsx scripts/version-bump.ts --patch",
+    "version:minor": "npx tsx scripts/version-bump.ts --minor",
+    "version:major": "npx tsx scripts/version-bump.ts --major",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "vibescope",
+    "ai",
+    "project-management"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.17"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2"
+  }
+}

package/scripts/version-bump.ts

@@ -0,0 +1,203 @@
+#!/usr/bin/env npx tsx
+/**
+ * Automatic Semantic Version Bumping Script
+ *
+ * Analyzes git commit messages since the last version tag to determine
+ * the appropriate version bump based on conventional commits.
+ *
+ * Patterns:
+ * - `feat!:` or `BREAKING CHANGE:` → major bump
+ * - `feat:` or `feat(scope):` → minor bump
+ * - `fix:` or `fix(scope):` → patch bump
+ * - `docs:`, `chore:`, `style:`, `refactor:`, `test:` → patch bump (if any fix/feat)
+ *
+ * Usage:
+ *   npx tsx scripts/version-bump.ts [--dry-run] [--major|--minor|--patch]
+ *
+ * Options:
+ *   --dry-run    Show what would be done without making changes
+ *   --major      Force a major version bump
+ *   --minor      Force a minor version bump
+ *   --patch      Force a patch version bump
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = resolve(__dirname, '../package.json');
+
+interface PackageJson {
+	version: string;
+	[key: string]: unknown;
+}
+
+type BumpType = 'major' | 'minor' | 'patch' | 'none';
+
+function parseArgs(): { dryRun: boolean; forceBump: BumpType | null } {
+	const args = process.argv.slice(2);
+	const dryRun = args.includes('--dry-run');
+
+	let forceBump: BumpType | null = null;
+	if (args.includes('--major')) forceBump = 'major';
+	else if (args.includes('--minor')) forceBump = 'minor';
+	else if (args.includes('--patch')) forceBump = 'patch';
+
+	return { dryRun, forceBump };
+}
+
+function getCurrentVersion(): string {
+	const packageJson: PackageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+	return packageJson.version;
+}
+
+function getLastVersionTag(): string | null {
+	try {
+		// Get the latest tag that matches a version pattern (v*.*.* or *.*.*)
+		const tag = execSync('git describe --tags --abbrev=0 --match "v*" 2>/dev/null || git describe --tags --abbrev=0 --match "[0-9]*" 2>/dev/null', {
+			encoding: 'utf-8',
+			cwd: resolve(__dirname, '../../..')
+		}).trim();
+		return tag || null;
+	} catch {
+		return null;
+	}
+}
+
+function getCommitsSinceTag(tag: string | null): string[] {
+	try {
+		const range = tag ? `${tag}..HEAD` : 'HEAD';
+		const commits = execSync(`git log ${range} --pretty=format:"%s" -- packages/mcp-server`, {
+			encoding: 'utf-8',
+			cwd: resolve(__dirname, '../../..')
+		}).trim();
+		return commits ? commits.split('\n').filter(Boolean) : [];
+	} catch {
+		return [];
+	}
+}
+
+function analyzeCommits(commits: string[]): { bumpType: BumpType; reasons: string[] } {
+	const reasons: string[] = [];
+	let bumpType: BumpType = 'none';
+
+	for (const commit of commits) {
+		const lowerCommit = commit.toLowerCase();
+
+		// Check for breaking changes (major)
+		if (lowerCommit.includes('breaking change') || /^[a-z]+(\([^)]+\))?!:/.test(commit)) {
+			bumpType = 'major';
+			reasons.push(`BREAKING: ${commit}`);
+		}
+		// Check for features (minor) - only upgrade if not already major
+		else if (/^feat(\([^)]+\))?:/.test(commit)) {
+			if (bumpType !== 'major') {
+				bumpType = 'minor';
+			}
+			reasons.push(`Feature: ${commit}`);
+		}
+		// Check for fixes (patch) - only upgrade if still none
+		else if (/^fix(\([^)]+\))?:/.test(commit)) {
+			if (bumpType === 'none') {
+				bumpType = 'patch';
+			}
+			reasons.push(`Fix: ${commit}`);
+		}
+		// Other conventional commits that warrant a patch
+		else if (/^(docs|chore|style|refactor|test|perf|build|ci)(\([^)]+\))?:/.test(commit)) {
+			reasons.push(`Other: ${commit}`);
+		}
+	}
+
+	// If we have reasons but no bump type, default to patch
+	if (bumpType === 'none' && reasons.length > 0) {
+		bumpType = 'patch';
+	}
+
+	return { bumpType, reasons };
+}
+
+function bumpVersion(currentVersion: string, bumpType: BumpType): string {
+	const [major, minor, patch] = currentVersion.split('.').map(Number);
+
+	switch (bumpType) {
+		case 'major':
+			return `${major + 1}.0.0`;
+		case 'minor':
+			return `${major}.${minor + 1}.0`;
+		case 'patch':
+			return `${major}.${minor}.${patch + 1}`;
+		default:
+			return currentVersion;
+	}
+}
+
+function updatePackageJson(newVersion: string): void {
+	const packageJson: PackageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+	packageJson.version = newVersion;
+	writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+}
+
+function main(): void {
+	const { dryRun, forceBump } = parseArgs();
+
+	console.log('🔍 Analyzing version bump for @vibescope/mcp-server...\n');
+
+	const currentVersion = getCurrentVersion();
+	console.log(`Current version: ${currentVersion}`);
+
+	const lastTag = getLastVersionTag();
+	console.log(`Last version tag: ${lastTag || '(none found)'}`);
+
+	const commits = getCommitsSinceTag(lastTag);
+	console.log(`Commits to analyze: ${commits.length}\n`);
+
+	let bumpType: BumpType;
+	let reasons: string[];
+
+	if (forceBump) {
+		bumpType = forceBump;
+		reasons = [`Forced ${forceBump} bump via command line`];
+		console.log(`⚡ Forcing ${forceBump} version bump\n`);
+	} else {
+		const analysis = analyzeCommits(commits);
+		bumpType = analysis.bumpType;
+		reasons = analysis.reasons;
+
+		if (reasons.length > 0) {
+			console.log('📝 Relevant commits:');
+			for (const reason of reasons.slice(0, 10)) {
+				console.log(`   - ${reason}`);
+			}
+			if (reasons.length > 10) {
+				console.log(`   ... and ${reasons.length - 10} more`);
+			}
+			console.log();
+		}
+	}
+
+	if (bumpType === 'none') {
+		console.log('✅ No version bump needed - no relevant changes detected.');
+		return;
+	}
+
+	const newVersion = bumpVersion(currentVersion, bumpType);
+	console.log(`📦 Version bump: ${currentVersion} → ${newVersion} (${bumpType})`);
+
+	if (dryRun) {
+		console.log('\n🔸 Dry run - no changes made.');
+		return;
+	}
+
+	updatePackageJson(newVersion);
+	console.log(`\n✅ Updated package.json to version ${newVersion}`);
+	console.log('\nNext steps:');
+	console.log('  1. Review the changes: git diff packages/mcp-server/package.json');
+	console.log('  2. Commit: git add -A && git commit -m "chore(release): bump @vibescope/mcp-server to ' + newVersion + '"');
+	console.log('  3. Create a tag: git tag -a v' + newVersion + ' -m "Release v' + newVersion + '"');
+	console.log('  4. Push: git push && git push --tags');
+}
+
+main();

package/src/api-client.test.ts

@@ -509,7 +509,7 @@ describe('VibescopeApiClient', () => {
 	});
 
 	describe('completeTask', () => {
-		it('should call correct endpoint', async () => {
+		it('should call proxy endpoint', async () => {
 			mockFetch.mockResolvedValue(
 				createMockResponse({ success: true })
 			);
@@ -518,12 +518,17 @@ describe('VibescopeApiClient', () => {
 				summary: 'Task completed successfully',
 			});
 
+			// completeTask uses proxy endpoint for consistency (direct endpoint had Vercel routing issues)
 			expect(mockFetch).toHaveBeenCalledWith(
-				expect.stringContaining('/api/mcp/tasks/task-123/complete'),
+				expect.stringContaining('/api/mcp/proxy'),
 				expect.objectContaining({
 					method: 'POST',
 					body: JSON.stringify({
-						summary: 'Task completed successfully',
+						operation: 'complete_task',
+						args: {
+							task_id: 'task-123',
+							summary: 'Task completed successfully',
+						},
 					}),
 				})
 			);