mcp-google-api 0.25.0 → 0.26.1

package/README.md

@@ -10,7 +10,7 @@
 > * **No Support or Feature Requests:** please **do not** open issues, bug reports, or feature requests. They will not be addressed or accepted at this stage.
 > * **No Warranty:** this software is provided **"AS IS"**, without warranty of any kind, express or implied. Use it strictly for testing and evaluation purposes at your own sole risk.
 
-# mcp-google-api / MCP Google API server (0.25.0)
+# mcp-google-api / MCP Google API server (0.26.1)
 
 <p align="center">
   <img src="https://img.shields.io/badge/node-%3E%3D24-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js >= 24">
@@ -212,11 +212,14 @@ mcp-google-api snippet --transport http --port 3100   # HTTP URL snippet
 ```bash
 mcp-google-api --ver         # installed version, npmjs latest, GitHub latest (three lines)
 mcp-google-api --upgrade     # npm install -g mcp-google-api@latest, then refresh skills and registrations with a summary
+mcp-google-api --upgrade --develop   # install the latest tagged GitHub release (any branch)
+mcp-google-api --upgrade --force     # force package re-download and complete reinstallation (npm install --force)
+mcp-google-api --upgrade --develop --force   # forced reinstall of the latest tagged GitHub release
 mcp-google-api uninstall     # remove MCP registrations + skills from every enabled CLI
 mcp-google-api --uninstall   # npm uninstall -g mcp-google-api
 ```
 
-`--upgrade` first checks the registry and skips cleanly when the installed version is already the latest; after a successful upgrade it re-runs `install` through the upgraded package and prints the starting → updated version transition plus one entry per processed CLI.
+`--upgrade` reinstalls the package in every invocation with no pre-upgrade version comparison; after a successful upgrade it re-runs `install` through the upgraded package and prints the starting → updated version transition plus one entry per processed CLI. `--force` appends the npm `--force` flag so the package is re-downloaded and fully reinstalled (standard runs, with or without `--develop`, stay unforced).
 
 # Documentation
 

package/dist/cli.js

@@ -1608,6 +1608,15 @@ var DEFAULT_GITHUB_RELEASES_API_URL = "https://api.github.com/repos/Ogekuri/mcp-
 function stripReleaseTagPrefix(tag) {
   return tag.trim().replace(/^v/i, "");
 }
+async function readGitHubErrorDetail(response) {
+  try {
+    const payload = await response.json();
+    const detail = typeof payload?.message === "string" ? payload.message.trim() : "";
+    return detail.length > 0 ? detail : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function probeLatestGitHubVersion(deps = {}) {
   const releasesUrl = deps.releasesUrl ?? DEFAULT_GITHUB_RELEASES_API_URL;
   const timeoutMs = deps.timeoutMs ?? DEFAULT_UPDATE_CHECK_TIMEOUT_MS;
@@ -1621,9 +1630,11 @@ async function probeLatestGitHubVersion(deps = {}) {
       signal: AbortSignal.timeout(timeoutMs)
     });
     if (!response.ok) {
+      const detail = await readGitHubErrorDetail(response);
+      const cause = detail ? `: ${detail.replace(/\.+$/, "")}` : "";
       return {
         status: "error",
-        message: `GitHub releases API responded with HTTP ${response.status}.`
+        message: `GitHub releases API responded with HTTP ${response.status}${cause}.`
       };
     }
     const payload = await response.json();
@@ -1660,9 +1671,11 @@ var PACKAGE_UPGRADE_COMMAND = [
   "-g",
   `${DEFAULT_PACKAGE_NAME}@latest`
 ];
+var UPGRADE_FORCE_OPTION = "--force";
 var GITHUB_UPGRADE_REPOSITORY = "Ogekuri/mcp-google-api";
-function buildDevelopUpgradeCommand(tag) {
-  return ["npm", "install", "-g", `github:${GITHUB_UPGRADE_REPOSITORY}#${tag}`];
+function buildDevelopUpgradeCommand(tag, force = false) {
+  const command = ["npm", "install", "-g", `github:${GITHUB_UPGRADE_REPOSITORY}#${tag}`];
+  return force ? [...command, UPGRADE_FORCE_OPTION] : command;
 }
 var PACKAGE_UNINSTALL_COMMAND = [
   "npm",
@@ -1770,25 +1783,40 @@ async function checkVersionIdle(deps = {}) {
   return result;
 }
 function parseManagementCommand(args) {
-  if (args.length === 1) {
-    const arg = args[0];
-    if (arg === "--ver" || arg === "--version" || arg === "--upgrade" || arg === "--uninstall") {
-      return arg;
+  const upgradeCount = args.filter((arg) => arg === "--upgrade").length;
+  if (upgradeCount === 0) {
+    if (args.length === 1) {
+      const arg = args[0];
+      if (arg === "--ver" || arg === "--version" || arg === "--uninstall") {
+        return arg;
+      }
     }
     return void 0;
   }
-  if (args.length === 2) {
-    const hasUpgrade = args.includes("--upgrade");
-    const hasDevelop = args.includes("--develop") || args.includes("--dev");
-    if (hasUpgrade && hasDevelop) {
-      return "--upgrade";
-    }
+  if (upgradeCount !== 1) {
+    return void 0;
+  }
+  const optionTokens = args.filter(
+    (arg) => arg === "--develop" || arg === "--dev" || arg === UPGRADE_FORCE_OPTION
+  );
+  if (args.length !== optionTokens.length + 1) {
+    return void 0;
+  }
+  const channelCount = optionTokens.filter(
+    (arg) => arg === "--develop" || arg === "--dev"
+  ).length;
+  const forceCount = optionTokens.filter((arg) => arg === UPGRADE_FORCE_OPTION).length;
+  if (channelCount > 1 || forceCount > 1) {
+    return void 0;
   }
-  return void 0;
+  return "--upgrade";
 }
 function parseUpgradeChannel(args) {
   return args.includes("--develop") || args.includes("--dev") ? "develop" : "npm";
 }
+function parseUpgradeForce(args) {
+  return args.includes(UPGRADE_FORCE_OPTION);
+}
 function runPackageManagerCommand(command, deps = {}) {
   const logger = deps.logger ?? Logger;
   const spawnImpl = deps.spawn ?? spawnSync;
@@ -1959,7 +1987,7 @@ async function runVersionCommand(options, deps = {}) {
   ]);
   const installedVersion = options.currentVersion || "unknown";
   const npmLatest = resolveProbeLatestVersion(npmProbe);
-  const githubLatest = githubProbe.status === "ok" ? githubProbe.version : "unknown";
+  const githubLatest = githubProbe.status === "ok" ? githubProbe.version : `unknown (${githubProbe.message})`;
   const stdout = deps.stdout ?? process.stdout;
   stdout.write(`${installedVersion}
 npmjs latest: ${npmLatest}
@@ -1974,7 +2002,10 @@ async function runUpgradeCommand(options, deps = {}) {
       (deps.logger ?? Logger).error(`GitHub upgrade channel probe failed: ${githubProbe.message}`);
       return 1;
     }
-    const upgraded2 = runPackageUpdateCommand(buildDevelopUpgradeCommand(githubProbe.tag), deps);
+    const upgraded2 = runPackageUpdateCommand(
+      buildDevelopUpgradeCommand(githubProbe.tag, options.force === true),
+      deps
+    );
     if (upgraded2 !== 0) {
       return upgraded2;
     }
@@ -1983,7 +2014,8 @@ async function runUpgradeCommand(options, deps = {}) {
     stdout2.write(renderUpgradeSummary(options.currentVersion, githubProbe.version, outcome2));
     return outcome2.exitCode;
   }
-  const upgraded = runPackageUpdateCommand(PACKAGE_UPGRADE_COMMAND, deps);
+  const updateCommand = options.force === true ? [...PACKAGE_UPGRADE_COMMAND, UPGRADE_FORCE_OPTION] : PACKAGE_UPGRADE_COMMAND;
+  const upgraded = runPackageUpdateCommand(updateCommand, deps);
   if (upgraded !== 0) {
     return upgraded;
   }
@@ -2173,13 +2205,21 @@ var COPILOT_TARGET = {
   mcpConfigPath: (home) => join3(homeRoot(home), ".copilot", "mcp.json"),
   skillsDir: (home) => join3(homeRoot(home), ".copilot", "skills")
 };
+var OPENCODE_TARGET = {
+  id: "opencode",
+  configFormat: "json",
+  jsonMcpMapKey: "mcp",
+  mcpConfigPath: (home) => join3(homeRoot(home), ".config", "opencode", "opencode.json"),
+  skillsDir: (home) => join3(homeRoot(home), ".config", "opencode", "skills")
+};
 var CLI_TARGETS = {
-  pi: PI_TARGET,
-  openclaw: OPENCLAW_TARGET,
-  codex: CODEX_TARGET,
   antigravity: ANTIGRAVITY_TARGET,
   claude: CLAUDE_TARGET,
-  copilot: COPILOT_TARGET
+  codex: CODEX_TARGET,
+  copilot: COPILOT_TARGET,
+  openclaw: OPENCLAW_TARGET,
+  opencode: OPENCODE_TARGET,
+  pi: PI_TARGET
 };
 function resolveCliTarget(name) {
   return CLI_TARGETS[name.trim().toLowerCase()];
@@ -2201,35 +2241,35 @@ function writeJsonConfig(configPath, value) {
   writeFileSync3(temporary, JSON.stringify(value, null, 2) + "\n", "utf-8");
   renameSync2(temporary, configPath);
 }
-function writeJsonMcpServerEntry(configPath, serverName, entry) {
+function writeJsonMcpServerEntry(configPath, serverName, entry, mapKey = "mcpServers") {
   const config = readJsonConfig(configPath);
-  const mcpServers = config.mcpServers ?? {};
+  const mcpServers = config[mapKey] ?? {};
   if (mcpServers === null || typeof mcpServers !== "object" || Array.isArray(mcpServers)) {
-    throw new Error(`mcpServers is not an object: ${configPath}`);
+    throw new Error(`${mapKey} is not an object: ${configPath}`);
   }
   mcpServers[serverName] = entry;
-  config.mcpServers = mcpServers;
+  config[mapKey] = mcpServers;
   writeJsonConfig(configPath, config);
 }
-function removeJsonMcpServerEntry(configPath, serverName) {
+function removeJsonMcpServerEntry(configPath, serverName, mapKey = "mcpServers") {
   if (!existsSync(configPath)) return false;
   const config = readJsonConfig(configPath);
-  const mcpServers = config.mcpServers;
+  const mcpServers = config[mapKey];
   if (mcpServers === void 0) return false;
   if (mcpServers === null || typeof mcpServers !== "object" || Array.isArray(mcpServers)) {
-    throw new Error(`mcpServers is not an object: ${configPath}`);
+    throw new Error(`${mapKey} is not an object: ${configPath}`);
   }
   const map = mcpServers;
   if (!(serverName in map)) return false;
   delete map[serverName];
-  config.mcpServers = map;
+  config[mapKey] = map;
   writeJsonConfig(configPath, config);
   return true;
 }
-function readJsonMcpServerEntry(configPath, serverName) {
+function readJsonMcpServerEntry(configPath, serverName, mapKey = "mcpServers") {
   try {
     const config = readJsonConfig(configPath);
-    const mcpServers = config.mcpServers;
+    const mcpServers = config[mapKey];
     if (mcpServers === null || typeof mcpServers !== "object" || Array.isArray(mcpServers)) {
       return void 0;
     }
@@ -2372,7 +2412,7 @@ function isServerRegistered(target, serverName, home) {
   if (target.configFormat === "toml") {
     return hasTomlMcpServerSection(configPath, serverName);
   }
-  return readJsonMcpServerEntry(configPath, serverName) !== void 0;
+  return readJsonMcpServerEntry(configPath, serverName, target.jsonMcpMapKey) !== void 0;
 }
 function applyServerRegistration(target, serverName, entry, home) {
   const configPath = target.mcpConfigPath(home);
@@ -2385,9 +2425,9 @@ function applyServerRegistration(target, serverName, entry, home) {
     return;
   }
   if (entry === void 0) {
-    removeJsonMcpServerEntry(configPath, serverName);
+    removeJsonMcpServerEntry(configPath, serverName, target.jsonMcpMapKey);
   } else {
-    writeJsonMcpServerEntry(configPath, serverName, entry);
+    writeJsonMcpServerEntry(configPath, serverName, entry, target.jsonMcpMapKey);
   }
 }
 
@@ -2540,22 +2580,22 @@ function renderAsciiTable(headers, rows, maxWidth = MAX_CELL_WIDTH) {
     const lengths = [header.length, ...rows.map((row) => (row[index] ?? "").length)];
     return Math.max(1, Math.min(Math.max(...lengths), Math.max(1, maxWidth)));
   });
-  const border = "+" + widths.map((width) => "-".repeat(width + 2)).join("+") + "+";
+  const borderLine = (left, middle, right) => left + widths.map((width) => "\u2500".repeat(width + 2)).join(middle) + right;
   const renderRow = (cells) => {
     const wrapped = cells.map((cell, index) => wrapCell(cell ?? "", widths[index]));
     const height = Math.max(...wrapped.map((part) => part.length));
     const lines = [];
     for (let line = 0; line < height; line += 1) {
       const parts = wrapped.map((part, index) => (part[line] ?? "").padEnd(widths[index]));
-      lines.push("| " + parts.join(" | ") + " |");
+      lines.push("\u2502 " + parts.join(" \u2502 ") + " \u2502");
     }
     return lines;
   };
-  const output = [border, ...renderRow(headers), border];
+  const output = [borderLine("\u250C", "\u252C", "\u2510"), ...renderRow(headers), borderLine("\u251C", "\u253C", "\u2524")];
   for (const row of rows) {
     output.push(...renderRow(row));
-    output.push(border);
   }
+  output.push(borderLine("\u2514", "\u2534", "\u2518"));
   return output.join("\n");
 }
 function buildCliRows(home) {
@@ -2969,16 +3009,14 @@ function runEnableDisableCliCommand(name, enable, options = {}) {
   const settings = loadCliSettings(options.home);
   const already = settings.enabled.includes(target.id);
   if (enable === already) {
-    streams.stdout.write(
-      JSON.stringify({ cli: target.id, enabled: enable, message: `${target.id} is already ${enable ? "enabled" : "disabled"}.` }, null, 2) + "\n"
-    );
+    streams.stdout.write(`${target.id} is already ${enable ? "enabled" : "disabled"}.
+`);
     return 0;
   }
   settings.enabled = enable ? [...settings.enabled, target.id] : settings.enabled.filter((item) => item !== target.id);
   saveCliSettings(settings, options.home);
-  streams.stdout.write(
-    JSON.stringify({ cli: target.id, enabled: enable, message: `${enable ? "Enabled" : "Disabled"} ${target.id}.` }, null, 2) + "\n"
-  );
+  streams.stdout.write(`${enable ? "Enabled" : "Disabled"} ${target.id}.
+`);
   return 0;
 }
 function runApiKeyCommand(key, options) {
@@ -3239,7 +3277,8 @@ if (isMainModule) {
   const managementCommand = parseManagementCommand(hideBin(process.argv));
   if (managementCommand !== void 0) {
     const upgradeChannel = parseUpgradeChannel(hideBin(process.argv));
-    void runManagementCommand(managementCommand, { currentVersion: packageVersion, channel: upgradeChannel }).then((code) => {
+    const upgradeForce = parseUpgradeForce(hideBin(process.argv));
+    void runManagementCommand(managementCommand, { currentVersion: packageVersion, channel: upgradeChannel, force: upgradeForce }).then((code) => {
       process.exitCode = code;
     }).catch((error) => {
       const message = error instanceof Error ? error.message : String(error);
@@ -3716,6 +3755,7 @@ Usage: mcp-google-api <command> [options]
   --version     Alias of --ver
   --upgrade     Upgrade the global package to the latest version and refresh installed skills
                 --develop | --dev: install the latest tagged GitHub release (any branch)
+                --force: force package re-download and complete reinstallation (npm install --force)
   --uninstall   Remove the globally installed mcp-google-api package`
     ).help();
     cli.parse();