c64bridge 0.8.0 → 0.9.0

package/mcp.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "entry": "dist/index.js",
   "type": "stdio",
@@ -9,11 +9,14 @@
     "mcp-server",
     "model context protocol",
     "openai",
-    "ultimate64",
-    "commodore64",
-    "commodore 64",
+    "commodore",
     "c64",
     "c64u",
+    "commodore64",
+    "commodore 64",
+    "commodore 64 ultimate",
+    "ultimate64",
+    "ultimate 64",
     "sid",
     "basic",
     "assembly",
@@ -22,9 +25,7 @@
     "retrogaming",
     "vintage computing",
     "hardware integration",
-    "c64 development",
-    "commodore 64 ultimate",
-    "ultimate 64"
+    "c64 development"
   ],
   "env": {
     "LOG_LEVEL": {
@@ -112,11 +113,11 @@
       "default": "120000000"
     },
     "VICE_BINARY": {
-      "description": "VICE binary to launch for managed emulator sessions and audio capture",
+      "description": "VICE binary to launch for managed emulator sessions and audio capture; automatic search is used only when this override is missing or invalid",
       "default": "x64sc"
     },
     "VICE_DIRECTORY": {
-      "description": "Override the VICE resource directory used for ROM and UI asset discovery",
+      "description": "Override the VICE resource directory used for ROM and UI asset discovery; automatic search is used only when this override is missing or invalid",
       "default": "auto-detect"
     },
     "VICE_HOST": {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "c64bridge",
-  "version": "0.8.0",
-  "description": "Local MCP server for controlling a Commodore 64 via Ultimate 64 REST API",
+  "version": "0.9.0",
+  "mcpName": "io.github.chrisgleissner/c64bridge",
+  "description": "C64 Bridge MCP server for Commodore 64 Ultimate hardware and VICE emulator control",
   "type": "module",
   "main": "dist/index.js",
   "packageManager": "bun@1.3.1",
@@ -21,9 +22,11 @@
     "lint": "npm run check",
     "test": "node scripts/invoke-bun.mjs scripts/run-tests.ts",
     "test:node": "node scripts/run-tests.mjs",
+    "test:vice:mock": "npm run test -- --platform=vice --target=mock",
+    "test:vice:device": "FORCE_XVFB=1 VICE_VISIBLE=false VICE_WARP=true npm run test -- --platform=vice --target=device",
     "coverage": "node scripts/run-coverage.mjs",
     "coverage:single": "node scripts/invoke-bun.mjs scripts/run-tests.ts --coverage",
-    "test:matrix": "npm run test -- --platform=c64u --target=mock && npm run test -- --platform=vice --target=mock && npm run test -- --platform=vice --target=device",
+    "test:matrix": "npm run test -- --platform=c64u --target=mock && npm run test:vice:mock && npm run test:vice:device",
     "mcp:generate": "node scripts/invoke-bun.mjs scripts/generate-mcp-interface.ts",
     "check:package": "node scripts/check-package.mjs",
     "check:run-local": "bash scripts/run-mcp-check.sh local 5",
@@ -39,7 +42,8 @@
     "changelog:generate": "node scripts/generate-changelog.mjs",
     "release:prepare": "node scripts/prepare-release.mjs",
     "compare:rest": "node scripts/compare-rest-apis.mjs",
-    "vice:smoke": "node scripts/invoke-bun.mjs test/vice/viceSmokeTest.ts"
+    "vice:smoke": "node scripts/invoke-bun.mjs test/vice/viceSmokeTest.ts",
+    "vice:smoke:visible": "node scripts/invoke-bun.mjs test/vice/viceSmokeTest.ts --visible-demo"
   },
   "keywords": [
     "mcp",
@@ -58,27 +62,28 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.2",
-    "axios": "^1.7.7",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "axios": "^1.16.0",
     "date-fns": "^4.1.0",
-    "fastify": "^5.6.1",
-    "jimp": "^1.6.0",
-    "meyda": "^5.6.2",
-    "octokit": "^5.0.4",
-    "pitchfinder": "^2.2.0",
+    "fastify": "^5.8.5",
+    "jimp": "^1.6.1",
+    "meyda": "^5.6.3",
+    "octokit": "^5.0.5",
+    "pitchfinder": "^2.3.4",
     "reflect-metadata": "^0.2.2",
-    "yaml": "^2.6.0"
+    "yaml": "^2.8.4"
   },
   "optionalDependencies": {
     "naudiodon": "^2.3.6"
   },
   "devDependencies": {
-    "@types/node": "^24.12.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
   },
   "files": [
     "mcp.json",
+    "server.json",
     "AGENTS.md",
     "LICENSE",
     "README.md",

package/scripts/fetch-external-sources.mjs

@@ -7,8 +7,7 @@ import { register } from 'node:module';
 async function main() {
   const __dirname = path.dirname(fileURLToPath(import.meta.url));
   const projectRoot = path.resolve(__dirname, '..');
-  const tsNodeLoader = pathToFileURL(path.join(projectRoot, 'node_modules', 'ts-node', 'esm.mjs')).href;
-  register(tsNodeLoader, pathToFileURL(projectRoot));
+  register("tsx/esm", pathToFileURL(projectRoot));
   const { fetchFromCsv } = await import('../src/rag/externalFetcher.ts');
   // Resolve sources.csv from env, dist/rag, or src/rag (in that order)
   let csvPath = process.env.RAG_SOURCES_CSV;

package/scripts/prepare-release.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { execSync } from 'node:child_process';
-import { readFile, writeFile } from 'node:fs/promises';
+import { access, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
 
@@ -16,6 +16,27 @@ const updateJsonFile = async (relativePath, updater) => {
   await writeFile(filePath, JSON.stringify(updated, null, 2) + '\n');
 };
 
+const fileExists = async (relativePath) => {
+  try {
+    await access(path.resolve(relativePath));
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+const getRepositoryMetadata = (repository) => {
+  const url = typeof repository === 'string' ? repository : repository?.url;
+  if (!url) {
+    return undefined;
+  }
+
+  return {
+    url,
+    source: url.includes('github.com') ? 'github' : undefined,
+  };
+};
+
 const normaliseVersion = (value) => value.replace(/^v/, '');
 
 const isExactVersion = (value) => /^v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(value);
@@ -72,6 +93,42 @@ await updateJsonFile('mcp.json', async (data) => ({
   version: newVersion,
 }));
 
+if (await fileExists('server.json')) {
+  await updateJsonFile('server.json', async (data) => {
+    const packages = Array.isArray(data.packages) ? [...data.packages] : [];
+    const primaryPackage = packages[0] ?? {
+      registryType: 'npm',
+      transport: {
+        type: 'stdio',
+      },
+    };
+
+    packages[0] = {
+      ...primaryPackage,
+      identifier: pkg.name,
+      version: newVersion,
+      transport: primaryPackage.transport ?? {
+        type: 'stdio',
+      },
+    };
+
+    const repository = getRepositoryMetadata(pkg.repository);
+
+    return {
+      ...data,
+      name: pkg.mcpName ?? data.name,
+      version: newVersion,
+      repository: repository
+        ? {
+            ...(data.repository ?? {}),
+            ...repository,
+          }
+        : data.repository,
+      packages,
+    };
+  });
+}
+
 // Manifest generation removed (runtime discovery via MCP stdio)
 
 // Update CHANGELOG.md from commits since last tag using Conventional Commits subjects.
@@ -88,4 +145,4 @@ if (skippedVersionBump && hasExistingChangelogEntry) {
 }
 
 console.log(`Release metadata updated to ${newVersion}.`);
-console.log('Next steps: commit the changes, open a PR, and tag the merged commit.');
+console.log('Next steps: commit and push the changes, then create the release tag from GitHub once main is ready.');

package/scripts/run-coverage.mjs

@@ -13,6 +13,22 @@ const runner = path.join(repoRoot, "scripts", "invoke-bun.mjs");
 const configPath = path.join(repoRoot, ".c8rc.json");
 const testRoot = path.join(repoRoot, "test");
 const DEFAULT_COVERAGE_SHARD_SIZE = 12;
+const DEFAULT_VICE_MOCK_TEST_FILES = [
+  "test/device.test.mjs",
+  "test/viceIntegration.test.mjs",
+  "test/viceModule.test.mjs",
+  "test/groupedToolsShims.test.mjs",
+  "test/toolsTypes.test.mjs",
+  "test/platformRegistry.test.mjs",
+  "test/meta/program.test.mjs",
+  "test/mcpServerIntegration.test.mjs",
+  "test/c64Client.test.mjs",
+  "test/vice/viceSmokeTest.ts",
+];
+const DEFAULT_VICE_DEVICE_TEST_FILES = [
+  "test/device.test.mjs",
+  "test/vice/viceSmokeTest.ts",
+];
 
 const legs = [
   { name: "c64u-mock", args: ["--platform=c64u", "--target=mock"] },
@@ -50,11 +66,20 @@ export async function main() {
   const allTestFiles = await listRepoTestFiles(testRoot);
   const isolatedTestSet = new Set(isolatedTests);
   const defaultTestFiles = allTestFiles.filter((f) => !isolatedTestSet.has(f));
-  const coverageBatches = buildCoverageBatches(defaultTestFiles, [...supplementalTests, ...isolatedTests], process.env);
   for (const leg of legs) {
     const legDir = path.join(coverageDir, "matrix", leg.name);
     await fs.mkdir(legDir, { recursive: true });
 
+    const legDefaultFiles = leg.name === "vice-mock"
+      ? DEFAULT_VICE_MOCK_TEST_FILES
+      : leg.name === "vice-device"
+        ? DEFAULT_VICE_DEVICE_TEST_FILES
+        : defaultTestFiles;
+    const legSupplementalTests = leg.name.startsWith("vice")
+      ? []
+      : [...supplementalTests, ...isolatedTests];
+    const coverageBatches = buildCoverageBatches(legDefaultFiles, legSupplementalTests, process.env);
+
     const reports = [];
     for (const batch of coverageBatches) {
       reports.push(await runCoverageLeg(leg, legDir, batch.label, batch.files));

package/scripts/run-tests.mjs

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 export const DEFAULT_TARGET = "mock";
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const registerDataUri = "data:text/javascript,import { register } from \"node:module\"; import { pathToFileURL } from \"node:url\"; register(\"ts-node/esm\", pathToFileURL(\"./\"));";
+const tsLoader = "tsx/esm";
 const { nodeArgs, target, explicitBaseUrl } = buildNodeTestArgs(process.argv.slice(2));
 const defaultEmbeddingsDir = path.join(repoRoot, "artifacts", "test-embeddings");
 if (!fs.existsSync(defaultEmbeddingsDir)) {
@@ -180,7 +180,7 @@ function isMainModule(moduleUrl) {
 
 export function buildNodeTestArgs(args, root = repoRoot) {
   const defaultTestFiles = listRepoTestFiles(path.join(root, "test"), root);
-  const nodeArgs = ["--import", registerDataUri, "--test"];
+  const nodeArgs = ["--import", tsLoader, "--test"];
   let target = DEFAULT_TARGET;
   let explicitBaseUrl = null;
   let hasExplicitTestFiles = false;