@pathmode/mcp-server 1.12.0 → 1.12.1

package/dist/cli-info.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `--version` / `--help` handling.
+ *
+ * Without this, any argument that is not a known subcommand falls through to
+ * StdioServerTransport, which waits on stdin forever. `npx @pathmode/mcp-server --version`
+ * — the first thing someone types after installing — looked like a hang.
+ *
+ * Deliberately narrow: only these exact flags are claimed. An unrecognized flag still
+ * starts the server, because an MCP client passing something we do not know about must
+ * get a working server, not a usage screen on stdout (which would corrupt the JSON-RPC
+ * stream). Like the other subcommands, these print to stdout and must run before the
+ * transport claims it.
+ */
+export declare function isVersionCommand(argv?: string[]): boolean;
+export declare function isHelpCommand(argv?: string[]): boolean;
+export declare function formatVersion(version: string): string;
+export declare function formatHelp(version: string): string;

package/dist/cli-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/cli-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,wBAAgB,gBAAgB,CAAC,IAAI,WAAe,GAAG,OAAO,CAE7D;AAED,wBAAgB,aAAa,CAAC,IAAI,WAAe,GAAG,OAAO,CAE1D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6BlD"}

package/dist/index.js

@@ -33753,6 +33753,74 @@ class PathmodeClient {
 exports.PathmodeClient = PathmodeClient;
 
 
+/***/ }),
+
+/***/ 7198:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+/**
+ * `--version` / `--help` handling.
+ *
+ * Without this, any argument that is not a known subcommand falls through to
+ * StdioServerTransport, which waits on stdin forever. `npx @pathmode/mcp-server --version`
+ * — the first thing someone types after installing — looked like a hang.
+ *
+ * Deliberately narrow: only these exact flags are claimed. An unrecognized flag still
+ * starts the server, because an MCP client passing something we do not know about must
+ * get a working server, not a usage screen on stdout (which would corrupt the JSON-RPC
+ * stream). Like the other subcommands, these print to stdout and must run before the
+ * transport claims it.
+ */
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.isVersionCommand = isVersionCommand;
+exports.isHelpCommand = isHelpCommand;
+exports.formatVersion = formatVersion;
+exports.formatHelp = formatHelp;
+const VERSION_FLAGS = new Set(['--version', '-v']);
+const HELP_FLAGS = new Set(['--help', '-h']);
+function isVersionCommand(argv = process.argv) {
+    return argv.slice(2).some((a) => VERSION_FLAGS.has(a));
+}
+function isHelpCommand(argv = process.argv) {
+    return argv.slice(2).some((a) => HELP_FLAGS.has(a));
+}
+function formatVersion(version) {
+    return `@pathmode/mcp-server ${version}`;
+}
+function formatHelp(version) {
+    return [
+        formatVersion(version),
+        '',
+        'MCP server for Pathmode — intent specs your coding agent can read.',
+        '',
+        'USAGE',
+        '  npx @pathmode/mcp-server                 Start the server (stdio). This is what an',
+        '                                           MCP client runs; it waits on stdin by design.',
+        '  npx @pathmode/mcp-server setup [key]     Configure Claude Code/Desktop, Cursor, Windsurf.',
+        '  npx @pathmode/mcp-server install-skills  Install the skill pack into this project.',
+        '  npx @pathmode/mcp-server --version       Print the version.',
+        '  npx @pathmode/mcp-server --help          Print this help.',
+        '',
+        'MODES',
+        '  Local (default, no key)  Specs live in intent.md in your repo. Nothing leaves the machine.',
+        '  Cloud (with a key)       Syncs intent and evidence with a Pathmode workspace.',
+        '                           Set PATHMODE_API_KEY, or run setup with a pm_live_ key.',
+        '',
+        'FLAGS',
+        '  --local                  Force local mode even when an API key is configured.',
+        '',
+        'ENVIRONMENT',
+        '  PATHMODE_API_KEY         Workspace key (pm_live_…). Absent means local mode.',
+        '  PATHMODE_API_URL         Override the API base URL. Defaults to https://pathmode.io',
+        '  PATHMODE_MCP_DEBUG=1     Log the inferred mode to stderr on startup.',
+        '',
+        'Docs: https://pathmode.io/developers · Preflight: https://preflight.pathmode.io',
+    ].join('\n');
+}
+
+
 /***/ }),
 
 /***/ 3783:
@@ -65181,7 +65249,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"$schema":"http://json-schema.org/dra
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@pathmode/mcp-server","version":"1.12.0","publishConfig":{"access":"public"},"mcpName":"io.github.pathmodeio/mcp-server","description":"Pathmode MCP Server — Build structured intent specs through Socratic AI conversation (zero-config), or connect to your Intent Layer for strategic context, dependency graphs, and implementation prompts.","main":"dist/index.js","bin":{"pathmode-mcp":"dist/index.js"},"files":["dist/","manifest.json","icon.svg","README.md","skills/"],"scripts":{"build":"rm -rf dist && ncc build src/index.ts -o dist","dev":"ts-node src/index.ts","prepublishOnly":"npm run build"},"keywords":["pathmode","mcp","model-context-protocol","claude-code","claude-code-skills","agent-skills","cursor","windsurf","intent-engineering","intent-compiler","ai-agents","product-development","dependency-graph","strategic-planning"],"author":"Pathmode","license":"MIT","type":"commonjs","engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/pathmodeio/mcp-server.git","directory":"packages/mcp-server"},"homepage":"https://pathmode.io","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","gray-matter":"^4.0.3","zod":"^3.24.0"},"devDependencies":{"@types/node":"^25.1.0","@vercel/ncc":"^0.38.4","ts-node":"^10.9.2","typescript":"^5.9.3"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@pathmode/mcp-server","version":"1.12.1","publishConfig":{"access":"public"},"mcpName":"io.github.pathmodeio/mcp-server","description":"Pathmode MCP Server — Build structured intent specs through Socratic AI conversation (zero-config), or connect to your Intent Layer for strategic context, dependency graphs, and implementation prompts.","main":"dist/index.js","bin":{"pathmode-mcp":"dist/index.js"},"files":["dist/","manifest.json","icon.svg","README.md","skills/"],"scripts":{"build":"rm -rf dist && ncc build src/index.ts -o dist","dev":"ts-node src/index.ts","prepublishOnly":"npm run build"},"keywords":["pathmode","mcp","model-context-protocol","claude-code","claude-code-skills","agent-skills","cursor","windsurf","intent-engineering","intent-compiler","ai-agents","product-development","dependency-graph","strategic-planning"],"author":"Pathmode","license":"MIT","type":"commonjs","engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/pathmodeio/mcp-server.git","directory":"packages/mcp-server"},"homepage":"https://pathmode.io","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","gray-matter":"^4.0.3","zod":"^3.24.0"},"devDependencies":{"@types/node":"^25.1.0","@vercel/ncc":"^0.38.4","ts-node":"^10.9.2","typescript":"^5.9.3"}}');
 
 /***/ })
 
@@ -65283,15 +65351,24 @@ const intent_compiler_1 = __nccwpck_require__(6488);
 const pathmode_section_1 = __nccwpck_require__(4681);
 const setup_1 = __nccwpck_require__(8294);
 const install_skills_1 = __nccwpck_require__(3783);
+const cli_info_1 = __nccwpck_require__(7198);
 // Server version is sourced from package.json so the version reported to MCP
 // clients always matches the published package. ncc statically resolves this
 // require() and inlines the JSON at build time (no runtime fs read).
 const { version: SERVER_VERSION } = __nccwpck_require__(8330);
 // ─── Subcommand routing ───────────────────────────────────────
-// Human-readable subcommands (`setup`, `install-skills`) use stdout
+// Human-readable subcommands (`setup`, `install-skills`, `--version`, `--help`) use stdout
 // and must run before StdioServerTransport claims stdout for JSON-RPC.
 // We call startMcpServer() only when NOT in a subcommand.
-if ((0, setup_1.isSetupCommand)()) {
+if ((0, cli_info_1.isVersionCommand)()) {
+    console.log((0, cli_info_1.formatVersion)(SERVER_VERSION));
+    process.exit(0);
+}
+else if ((0, cli_info_1.isHelpCommand)()) {
+    console.log((0, cli_info_1.formatHelp)(SERVER_VERSION));
+    process.exit(0);
+}
+else if ((0, setup_1.isSetupCommand)()) {
     (0, setup_1.runSetup)().then(() => process.exit(0)).catch((err) => {
         console.error(err);
         process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pathmode/mcp-server",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "publishConfig": {
     "access": "public"
   },