mcp-google-api 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.26.0](https://github.com/Ogekuri/mcp-google-api/compare/v0.25.0..v0.26.0) - 2026-11-08
+### 🚜  Changes
+- add opencode CLI support and alphabetical CLI listing [useReq] *(cliTargets)*
+  - REQ-110/DES-017 updated: opencode joins the supported CLI registry; supported-name listings print alphabetically.
+  - REQ-112/REQ-113 updated: opencode MCP config at ~/.config/opencode/opencode.json (JSON mcp map) and skills at ~/.config/opencode/skills.
+  - REQ-117 updated: show CLI Configuration table covers all seven CLIs in alphabetical order; CLI_TARGETS registry reordered alphabetically.
+  - JSON read-modify-write helpers gained a mapKey parameter (default mcpServers, mcp for opencode) preserving unrelated keys; CliTarget gained jsonMcpMapKey.
+  - Unit suite 146/146 green; behavioral proof verified paths, mcp-map install/uninstall round-trip, and alphabetical show rows.
+- rebuild dist binaries on every launcher run [useReq] *(mcp-google-api.sh)*
+  - PRJ-019 amended: the dev launcher rebuilds dist from the current sources before every execution and aborts non-zero when the rebuild fails; dependency installs stay explicit (npm ci).
+  - PRJ-022 added: every argument is forwarded unchanged to the rebuilt dist/cli.js with exit-code propagation via exec.
+  - PKG-019 amended: the helper-script no-implicit-install/build rule now carves out the PRJ-018 development launcher.
+  - Build output routes to stderr so the exec'd CLI keeps stdout clean for stdio JSON-RPC framing (CTN-003).
+  - No src/ changes; unit suite 146/146 green; live proof verified rebuild, exit propagation, and JSON-pure stdout.
+- render show tables as box-drawing grid [useReq] *(cliShow)*
+  - REQ-185 added: the show CLI Configuration and Installation Status tables render as box-drawing grids using the specific border characters.
+  - REQ-186 added: data rows emit without inter-row border lines, with exactly one header separator and a closing bottom border.
+  - renderAsciiTable now builds borders via a parametric borderLine helper (top/header/body/bottom) and pipe-delimited rows; column sizing, cell wrapping, and alignment are unchanged.
+  - WORKFLOW.md TRACE-K and EDGE-06 runtime model updated; REFERENCES.md regenerated; no test files modified.
+- print enable/disable result as human-readable confirmation [useReq] *(cli)*
+  - PRJ-008 updated: enable and disable join the human-readable stdout operation-report exceptions.
+  - REQ-184 added: enable/disable print a human-readable confirmation naming the resolved CLI and the resulting enabled state, exit 0.
+  - runEnableDisableCliCommand now writes plain-text confirmations on both success branches (state change and idempotent no-op); the unsupported-name JSON stderr diagnostic and exit 2 are unchanged (REQ-110).
+  - WORKFLOW.md TRACE-K and EDGE-06 runtime model updated; REFERENCES.md regenerated; no test files modified.
+- render GitHub probe failure reason in version report [useReq] *(upgradeManager)*
+  - REQ-181 added: --ver/--version now prints 'GitHub latest: unknown (<reason>)' when the GitHub releases probe fails, <reason> carrying the probe diagnostic message.
+  - REQ-164 updated to reference the REQ-181 failed-probe diagnostic rendering.
+  - probeLatestGitHubVersion embeds the GitHub API error message body field (e.g. HTTP 404 rate limit) via the new tolerant readGitHubErrorDetail helper.
+  - WORKFLOW.md TRACE-L and EDGE-06/EDGE-10 runtime model updated; REFERENCES.md regenerated; no test files modified.
+
 ## [0.25.0](https://github.com/Ogekuri/mcp-google-api/compare/v0.24.0..v0.25.0) - 2026-11-08
 ### 🐛  Bug Fixes
 - make doctor spawn tests hermetic with isolated home [useReq] *(cliSpawn)*
@@ -637,6 +667,7 @@
 - \[0.23.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.23.0
 - \[0.24.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.24.0
 - \[0.25.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.25.0
+- \[0.26.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.26.0
 
 [0.2.0]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.2.0
 [0.3.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.2.0..v0.3.0
@@ -661,3 +692,4 @@
 [0.23.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.22.0..v0.23.0
 [0.24.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.23.0..v0.24.0
 [0.25.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.24.0..v0.25.0
+[0.26.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.25.0..v0.26.0

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.0)
 
 <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">

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();
@@ -1959,7 +1970,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}
@@ -2173,13 +2184,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 +2220,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 +2391,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 +2404,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 +2559,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 +2988,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) {