mcp-google-api 0.23.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # 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)*
+  - Root cause of the CI-only failure: the doctor spawn test inherited the
+  - host HOME, so it read the developer machine's real
+  - ~/.config/mcp-google-api/config.json; locally the real API key made the
+  - REQ-070 api-key check pass (exit 0), while the clean CI runner had no
+  - settings file, so doctor correctly exited 1 and the gate failed.
+  - spawnCli now accepts an injectable HOME override; the doctor success
+  - test provisions an isolated home with the DES-018 settings fixture and
+  - a valid-format test key, so local runs reproduce the CI runner state
+  - exactly and the discrepancy can no longer hide before publication.
+  - Add a REQ-070 regression pin: doctor exits 1 on a clean isolated home
+  - without a configured API key (the exact CI failure state).
+  - Evidence: clean-HOME reproduction exited 1 with api-key fail before the
+  - fix; after the fix the suite passes 4/4 both with the real and a clean
+  - HOME; full suite 146/146; local pre-release gate green (exit 0).
+  - No source changes: doctor clean-env exit-1 behavior is REQ-070-correct.
+
+## [0.24.0](https://github.com/Ogekuri/mcp-google-api/compare/v0.23.0..v0.24.0) - 2026-11-08
+### ⛰️  Features
+- add pre-release-check.sh release gate [useReq] *(scripts)*
+  - Ship scripts/pre-release-check.sh running the release-gating stages
+  - in mandatory order: publish-version guard, typecheck, unit tests,
+  - production build, aborting at the first failed stage (PKG-058/059).
+  - The script exits 0 only when every stage passes, runs from any cwd
+  - by resolving the repository root, and never installs dependencies
+  - or publishes (PKG-060).
+  - Add tests/preReleaseCheck.unit.test.ts (TST-024): static contract on
+  - stage order, fail-fast wiring, repository-root cd, and no install/
+  - publish commands, plus a sandbox run proving fail-fast exit 1 on an
+  - injected failing stage.
+  - Runtime verification: full run green (guard 0.23.0 publishable,
+  - typecheck clean, 143/143 unit tests, build success, exit 0); real
+  - fail-fast observed on a missing-toolchain run (typecheck FAILED ->
+  - exit 1, later stages skipped).
+
+### 🐛  Bug Fixes
+- sync package-lock bin path with package.json launcher [useReq] *(packaging)*
+  - The committed package-lock.json root bin entry still recorded the
+  - superseded dist/cli.js launcher, so every standard bootstrap
+  - (npm install) rewrote the tracked lockfile and left a fresh clone dirty.
+  - Regenerate the lockfile bin entry to bin/mcp-google-api.mjs, matching
+  - the package.json launcher contract (PRJ-020).
+  - Add a level-0 regression guard test asserting lockfile/package.json
+  - bin-map identity to tests/npmPublishContract.unit.test.ts, closing
+  - the TST-021 coverage gap that let the drift go undetected.
+  - Evidence: reproducer red on the stale lockfile, green after the fix;
+  - full suite 138/138 pass, typecheck clean, static analysis clean.
+
+### 🚜  Changes
+- gate pipeline on pre-release test checks [useReq] *(release)*
+  - Add a Pre-release check step to .github/workflows/release-npm.yml
+  - running scripts/pre-release-check.sh after npm ci and before every
+  - build, pack, publish, and release-creation step, so versions whose
+  - tests fail produce no release artifact and are never published
+  - (PKG-063).
+  - The gate executes the PKG-058 stages (publish-version guard,
+  - typecheck, unit tests, build) in fail-fast order (PKG-059) and never
+  - installs dependencies or publishes (PKG-060).
+  - Update the workflow header and pack-step comments; the release
+  - pipeline defines no direct test commands - all test stages live in
+  - the gate script.
+  - SRS: add PKG-063 and extend TST-020 with the gate contract.
+  - Tests: ciContract asserts gate presence, placement, and absence of
+  - direct test commands; suite 6/6, full suite 145/145.
+- clean run-created artifacts in pre-release-check [useReq] *(scripts)*
+  - scripts/pre-release-check.sh now snapshots the repository state before
+  - the stages and removes on exit every artifact directory the run created
+  - (e.g. the tsup dist/ tree), on both success and fail-fast paths, so the
+  - repository is left as found (PKG-061).
+  - Pre-existing artifact directories are preserved untouched (PKG-062).
+  - SRS: add PKG-061/PKG-062 and extend TST-024 with the cleanup contract.
+  - Tests: shared sandbox helper plus two behavioral proofs - run-created
+  - dist removed on the fail-fast path, pre-existing dist sentinel intact.
+  - Verification: suite 7/7; full run 145/145 tests with dist removed after
+  - the run; pre-existing dist preserved in a second scenario; static
+  - analysis clean; git status clean after every run.
+
 ## [0.23.0](https://github.com/Ogekuri/mcp-google-api/compare/v0.22.0..v0.23.0) - 2026-11-07
 ### ⛰️  Features
 - add copilot CLI agent support (DES-017, REQ-110/112/113/117) [useReq] *(cli-targets)*
@@ -556,6 +665,9 @@
 - \[0.21.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.21.0
 - \[0.22.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.22.0
 - \[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
@@ -578,3 +690,6 @@
 [0.21.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.20.0..v0.21.0
 [0.22.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.21.0..v0.22.0
 [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.23.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) {