mcp-google-api 0.22.0 → 0.22.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.22.1](https://github.com/Ogekuri/mcp-google-api/compare/v0.22.0..v0.22.1) - 2026-11-06
+### 🐛  Bug Fixes
+- report skipped server-start dispatch with build remediation [useReq] *(cli)*
+  - Root cause of the persistent pi 'MCP connection closed' after the 0.21.0 rename:
+  - the REQ-114 launcher 'npx -y mcp-google-api start --stdio' resolves a same-name
+  - local project in the spawn cwd, launching a stale pre-rename dist artifact that
+  - skips dispatch and exits 0 silently (reproduced: exit 0, zero stdout bytes).
+  - Add describeUndispatchedServerStart() and handleUndispatchedEntry() to the CLI
+  - entry gate: server-start-shaped argv that matches no gate rule now emits a JSON
+  - build-remediation diagnostic on stderr (REQ-094) and exits 1; stdout stays
+  - JSON-RPC-clean (CTN-003); non-server-start argv keeps the silent exit-0 no-op.
+  - Extend tests/cliEntryGate.unit.test.ts with failing-first reproducers (3 tests);
+  - full suite 132/132 green; typecheck, static checks, and build clean.
+  - Document the stale-artifact remediation in docs/CONFIGURATION.md; update
+  - WORKFLOW.md TRACE-A/EDGE-06 and regenerate REFERENCES.md.
+
 ## [0.22.0](https://github.com/Ogekuri/mcp-google-api/compare/v0.21.0..v0.22.0) - 2026-11-06
 ### 🐛  Bug Fixes
 - symlink-aware main-module gate restores CLI dispatch [useReq] *(cli)*
@@ -393,6 +409,7 @@
 - \[0.20.0\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.20.0
 - \[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.22.1\]: https://github.com/Ogekuri/mcp-google-api/releases/tag/v0.22.1
 
 [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
@@ -414,3 +431,4 @@
 [0.20.0]: https://github.com/Ogekuri/mcp-google-api/compare/v0.19.0..v0.20.0
 [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.22.1]: https://github.com/Ogekuri/mcp-google-api/compare/v0.22.0..v0.22.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.22.0)
+# mcp-google-api / MCP Google API server (0.22.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">

package/dist/cli.d.ts

@@ -141,5 +141,11 @@ declare function runShowCommand(options: {
     resourcesRoot: string;
     streams?: ExecStreams;
 }): number;
+declare function describeUndispatchedServerStart(args: readonly string[]): string | undefined;
+declare function handleUndispatchedEntry(args: readonly string[], streams?: {
+    stderr: {
+        write: (text: string) => unknown;
+    };
+}): number;
 
-export { DOCTOR_PROBES, type DoctorCheck, type DoctorLiveProbe, type DoctorOptions, type DoctorProbeId, type DoctorProbesParseResult, type DoctorReport, EXEC_TOOLS, type ServerStartupOutcome, type ShutdownExitHook, createShutdownHandler, execTool, installShutdownHandlers, parseDoctorProbes, runApiKeyCommand, runAutoUpdateCommand, runDoctor, runEnableDisableCliCommand, runExecCommand, runHostCommand, runInstallUninstallCommand, runPortCommand, runShowCommand, runSnippetCommand, runToolsCommand, startServer };
+export { DOCTOR_PROBES, type DoctorCheck, type DoctorLiveProbe, type DoctorOptions, type DoctorProbeId, type DoctorProbesParseResult, type DoctorReport, EXEC_TOOLS, type ServerStartupOutcome, type ShutdownExitHook, createShutdownHandler, describeUndispatchedServerStart, execTool, handleUndispatchedEntry, installShutdownHandlers, parseDoctorProbes, runApiKeyCommand, runAutoUpdateCommand, runDoctor, runEnableDisableCliCommand, runExecCommand, runHostCommand, runInstallUninstallCommand, runPortCommand, runShowCommand, runSnippetCommand, runToolsCommand, startServer };

package/dist/cli.js

@@ -3112,6 +3112,32 @@ function isEntryMainModule() {
     return false;
   }
 }
+function describeUndispatchedServerStart(args) {
+  const isServerStart = (args.includes("start") || args.includes("run")) && args.includes("--stdio");
+  if (!isServerStart) {
+    return void 0;
+  }
+  return "CLI dispatch was skipped for this server-start launch: the running artifact is not the mcp-google-api entrypoint (stale build after a distribution rename). Rebuild the local artifact with 'npm run build' (or 'npm run verify'), or refresh the global installation with 'npm install -g mcp-google-api@latest', then reconnect the MCP client.";
+}
+function handleUndispatchedEntry(args, streams = process) {
+  const error = describeUndispatchedServerStart(args);
+  if (error === void 0) {
+    return 0;
+  }
+  streams.stderr.write(
+    JSON.stringify(
+      {
+        error,
+        requestedEntry: process.argv[1] ?? null,
+        modulePath: fileURLToPath(import.meta.url),
+        remediation: ["npm run build", "npm install -g mcp-google-api@latest"]
+      },
+      null,
+      2
+    ) + "\n"
+  );
+  return 1;
+}
 var isRunDirectly = process.argv[1] && (process.argv[1].endsWith("cli.ts") || process.argv[1].endsWith("cli.js") || process.argv[1].endsWith("mcp-google-api") || process.argv[1].includes("mcp-google-api"));
 var isMainModule = isEntryMainModule();
 if (isRunDirectly || isMainModule) {
@@ -3605,12 +3631,16 @@ Usage: mcp-google-api <command> [options]
     ).help();
     cli.parse();
   }
+} else {
+  process.exitCode = handleUndispatchedEntry(process.argv.slice(2));
 }
 export {
   DOCTOR_PROBES,
   EXEC_TOOLS,
   createShutdownHandler,
+  describeUndispatchedServerStart,
   execTool,
+  handleUndispatchedEntry,
   installShutdownHandlers,
   parseDoctorProbes,
   runApiKeyCommand,