@pathmode/mcp-server 1.11.0 → 1.12.1

package/README.md

@@ -61,6 +61,7 @@ That's it. No API key needed.
 id: "intent_17291..."
 version: 1
 status: "draft"
+readiness: "passed 6/6"
 ---
 # Fix Checkout Payment Timeout
 
@@ -78,6 +79,8 @@ timeouts exceeding 3 seconds.
 - **Unknown provider status**: Hold order, notify user within 30s
 ```
 
+The `readiness` line is the deterministic preflight verdict, stamped on every save — "passed 6/6", or "failed N/6" naming the blocking gates — so any agent reading the file knows whether the spec cleared the gate without re-running it. Specs exported from a Pathmode workspace also carry `source:` (the canonical intent URL — the file is a working copy of that record) and `evidence:` (how many linked evidence items back it).
+
 **.cursorrules** — Agent-directive format for Cursor:
 ```
 # CURRENT OBJECTIVE

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:
@@ -34165,6 +34233,8 @@ function formatIntentMd(spec, opts = {}) {
         id: spec.id || `intent_${Date.now()}`,
         version: opts.version && opts.version >= 1 ? opts.version : 1,
         status: opts.status || 'draft',
+        ...(opts.readiness ? { readiness: opts.readiness } : {}),
+        ...(opts.source ? { source: opts.source } : {}),
         created: opts.created || now,
         updated: now,
     };
@@ -35034,6 +35104,7 @@ exports.isVerificationCheckSubstantive = isVerificationCheckSubstantive;
 exports.isObjectiveSpecific = isObjectiveSpecific;
 exports.isOutcomeMeasurable = isOutcomeMeasurable;
 exports.computeReadinessVerdict = computeReadinessVerdict;
+exports.formatReadinessFrontmatter = formatReadinessFrontmatter;
 exports.formatReadinessVerdict = formatReadinessVerdict;
 // ── Text/shape coercion (mirrors lib/intentReadiness coerceText/asArray) ───
 function coerceText(value) {
@@ -35205,6 +35276,29 @@ const GATE_LABELS = {
     edgeCases: 'Edge cases',
     verification: 'Verification',
 };
+/** Gate keys → short labels for the frontmatter blocking list. */
+const FRONTMATTER_GATE_LABELS = {
+    goal: 'title',
+    objective: 'objective',
+    outcomes: 'outcomes',
+    constraints: 'constraints',
+    edgeCases: 'edge-cases',
+    verification: 'verification',
+};
+/**
+ * Single-line readiness value stamped into intent.md frontmatter, so the verdict travels
+ * with the file: "passed 6/6" or "failed 4/6 — blocking: constraints, verification".
+ * Deterministic and greppable. Mirrored in lib/intentReadiness.formatReadinessFrontmatter;
+ * lib/preflightReadinessParity.test.ts fails CI if the two drift.
+ */
+function formatReadinessFrontmatter(verdict) {
+    const total = exports.READINESS_GATE_ORDER.length;
+    const passed = exports.READINESS_GATE_ORDER.filter((k) => verdict.signals[k]).length;
+    if (verdict.ready)
+        return `passed ${passed}/${total}`;
+    const blocking = exports.READINESS_GATE_ORDER.filter((k) => !verdict.signals[k]).map((k) => FRONTMATTER_GATE_LABELS[k]);
+    return `failed ${passed}/${total} — blocking: ${blocking.join(', ')}`;
+}
 /** Human/agent-readable verdict block, stable enough to parse by line prefix. */
 function formatReadinessVerdict(verdict, specTitle) {
     const lines = [];
@@ -65155,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.11.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"}}');
 
 /***/ })
 
@@ -65257,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);
@@ -66354,13 +66457,20 @@ function startMcpServer() {
             };
         }
         const { id, version, status, created } = decision;
-        const content = (0, intent_compiler_1.formatIntentMd)({ ...spec, id }, { version, status, created });
+        // The preflight verdict travels with the file: stamped into frontmatter on every save,
+        // recomputed from the spec alone (deterministic). A failing verdict never blocks the
+        // save — the gate reports, the user decides.
+        const verdict = (0, readiness_1.computeReadinessVerdict)(spec);
+        const content = (0, intent_compiler_1.formatIntentMd)({ ...spec, id }, { version, status, created, readiness: (0, readiness_1.formatReadinessFrontmatter)(verdict) });
         (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
         const action = decision.action === 'update' ? `Updated intent spec (v${version})` : 'Saved intent spec';
+        const readinessNote = verdict.ready
+            ? ''
+            : `\n\n${(0, readiness_1.formatReadinessVerdict)(verdict, spec.title)}`;
         return {
             content: [{
                     type: 'text',
-                    text: `✓ ${action} at ${filePath}\n  id: ${id} · status: ${status}\n\nTo connect this to Pathmode for dependency tracking and team collaboration, visit pathmode.io`,
+                    text: `✓ ${action} at ${filePath}\n  id: ${id} · status: ${status} · readiness: ${(0, readiness_1.formatReadinessFrontmatter)(verdict)}${readinessNote}\n\nTo connect this to Pathmode for dependency tracking and team collaboration, visit pathmode.io`,
                 }],
         };
     });

package/dist/intent-compiler.d.ts

@@ -83,6 +83,10 @@ export interface IntentMdOptions {
     status?: string;
     /** Original `created` timestamp. Preserved across updates; defaults to now. */
     created?: string;
+    /** Preflight verdict line ("passed 6/6" / "failed 4/6 — blocking: …"), recomputed at save time. */
+    readiness?: string;
+    /** Canonical record URL (cloud intents). Omitted when this file is the only copy. */
+    source?: string;
 }
 /**
  * Generate intent.md content with YAML frontmatter.

package/dist/intent-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/intent-compiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/intent-compiler.ts"],"names":[],"mappings":"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"}

package/dist/readiness.d.ts

@@ -42,5 +42,12 @@ export interface ReadinessVerdict {
  * (the legacy phase-engagement signal never gates the verdict here).
  */
 export declare function computeReadinessVerdict(spec: ReadinessSpecInput): ReadinessVerdict;
+/**
+ * Single-line readiness value stamped into intent.md frontmatter, so the verdict travels
+ * with the file: "passed 6/6" or "failed 4/6 — blocking: constraints, verification".
+ * Deterministic and greppable. Mirrored in lib/intentReadiness.formatReadinessFrontmatter;
+ * lib/preflightReadinessParity.test.ts fails CI if the two drift.
+ */
+export declare function formatReadinessFrontmatter(verdict: ReadinessVerdict): string;
 /** Human/agent-readable verdict block, stable enough to parse by line prefix. */
 export declare function formatReadinessVerdict(verdict: ReadinessVerdict, specTitle?: string): string;

package/dist/readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,CAIjE;AAoCD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAQ3E;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI9F;AAQD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOjF;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAID,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOjE,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,wFAAyF,CAAC;AAK3H,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAoBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,CAkBlF;AAWD,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5F"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,CAIjE;AAoCD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAQ3E;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI9F;AAQD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOjF;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAID,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOjE,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,wFAAyF,CAAC;AAK3H,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAoBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,CAkBlF;AAqBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAM5E;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5F"}

package/package.json

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

package/skills/preflight/SKILL.md

@@ -30,6 +30,8 @@ If the verdict passes: say so and stop. Do not invent extra requirements beyond
 
 The gate is pure functions over the spec text: no model call, no network. Re-running never changes the verdict unless the spec changed. That makes it a floor you can put in front of any implementation work — and it means a passing verdict is reproducible evidence, not an opinion. The same gate runs live at preflight.pathmode.io.
 
+Every `intent_save` also stamps the verdict into the file's frontmatter as `readiness:` ("passed 6/6", or "failed N/6" with the blocking gates named), so anyone reading intent.md — human or agent — sees the gate state without re-running anything. A failing verdict never blocks the save; the gate reports, the user decides.
+
 ## Division of labor with the other skills
 
 - `preflight` — deterministic verdict: IS the spec ready? Cheap, run it first and often.