@pathmode/mcp-server 1.1.0 → 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pathmode Oy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,45 +1,36 @@
 # @pathmode/mcp-server
 
-Connect Claude Code, Cursor, and other AI agents to your [Pathmode](https://pathmode.io) Intent Layer.
+Build structured intent specs through Socratic AI conversation — right in your terminal.
 
-Get strategic context, dependency graph analysis, and structured implementation prompts — so your AI agent builds the right thing, not just any thing.
+No signup. No API key. Just add the MCP server and start talking.
 
-## Features
+## Intent Compiler
 
-- **Intent context** — Structured specs with objectives, outcomes, constraints, and edge cases
-- **Dependency graph analysis** — Critical path, cycle detection, bottleneck identification
-- **Context export** — Generate CLAUDE.md, .cursorrules, and intent.md files
-- **Workspace strategy** — Vision, non-negotiables, architecture principles
-- **Constitution rules** — Mandatory constraints for all implementations
-- **Implementation tracking** — Status updates and technical decision logging
+The Intent Compiler turns Claude Code into a Socratic product thinking partner. Describe a problem, paste a support ticket, or explain what's broken — Claude challenges vague thinking, asks pointed questions, and builds a structured spec.
 
-## Quick Start
-
-```bash
-npx @pathmode/mcp-server
 ```
+> Help me write an intent spec for our checkout flow
 
-## Setup
+  What's broken about it? When you say "checkout flow" — is the whole
+  thing failing, or is there one specific moment where users bail?
 
-### Claude Desktop
+> Payment step times out and users get confused
 
-Add to `~/.config/Claude/claude_desktop_config.json`:
+  When you say "times out" — is that 5 seconds or 30? And what does
+  the user actually see? A spinner? A blank screen? An error?
 
-```json
-{
-  "mcpServers": {
-    "pathmode": {
-      "command": "npx",
-      "args": ["@pathmode/mcp-server"],
-      "env": {
-        "PATHMODE_API_KEY": "pm_live_..."
-      }
-    }
-  }
-}
+> About 8 seconds, they see a spinner with no feedback
+
+  Proposed Objective: "Reduce cart abandonment caused by payment step
+  timeouts exceeding 3 seconds, where users see a spinner with no
+  status feedback or recovery path."
+
+  Does that capture it, or is there more to the pain?
 ```
 
-### Claude Code
+When the spec is ready, Claude saves it as `intent.md` and optionally exports as `.cursorrules` or `CLAUDE.md` — so every AI agent in your project sees the intent as its implementation context.
+
+### Quick Start
 
 Add to `.claude/settings.json`:
 
@@ -48,18 +39,79 @@ Add to `.claude/settings.json`:
   "mcpServers": {
     "pathmode": {
       "command": "npx",
-      "args": ["@pathmode/mcp-server"],
-      "env": {
-        "PATHMODE_API_KEY": "pm_live_..."
-      }
+      "args": ["@pathmode/mcp-server"]
     }
   }
 }
 ```
 
-### Cursor
+Then in Claude Code:
 
-Add to `.cursor/mcp.json`:
+```
+> Help me write an intent spec for [your problem here]
+```
+
+That's it. No API key needed.
+
+### What You Get
+
+**intent.md** — Structured spec with YAML frontmatter:
+```markdown
+---
+id: "intent_17291..."
+version: 1
+status: "draft"
+---
+# Fix Checkout Payment Timeout
+
+## Objective
+Reduce cart abandonment caused by payment step
+timeouts exceeding 3 seconds.
+
+## Outcomes
+- [ ] Payment completes in under 3 seconds (p95)
+- [ ] Users see real-time status during processing
+- [ ] Failed payments show actionable error with retry
+
+## Edge Cases
+- **Network timeout during payment**: Show retry button, no double-charge
+- **Unknown provider status**: Hold order, notify user within 30s
+```
+
+**.cursorrules** — Agent-directive format for Cursor:
+```
+# CURRENT OBJECTIVE
+You are implementing: "Fix Checkout Payment Timeout"
+
+# SUCCESS OUTCOMES
+Your implementation MUST satisfy ALL of these:
+- Payment completes in under 3 seconds (p95)
+- Users see real-time status during processing
+- Failed payments show actionable error with retry
+```
+
+**CLAUDE.md** — Appends a `<!-- PATHMODE:START -->` section so Claude Code sees the intent in every conversation.
+
+### Intent Compiler Tools
+
+| Tool | Description |
+|------|-------------|
+| `intent_save` | Save an intent spec to `intent.md` in the project root |
+| `intent_export` | Export as `.cursorrules` or `CLAUDE.md` section |
+
+### Intent Compiler Prompt
+
+| Prompt | Description |
+|--------|-------------|
+| `compile-intent` | Start a Socratic conversation to build an intent spec |
+
+---
+
+## Team Features (API Key Required)
+
+For teams shipping with AI agents, connect to your [Pathmode](https://pathmode.io) workspace for dependency tracking, strategic context, and governance.
+
+### Setup with API Key
 
 ```json
 {
@@ -75,6 +127,10 @@ Add to `.cursor/mcp.json`:
 }
 ```
 
+Works with Claude Code (`.claude/settings.json`), Claude Desktop (`claude_desktop_config.json`), and Cursor (`.cursor/mcp.json`).
+
+Get your API key from **Settings > API Keys** in the [Pathmode app](https://pathmode.io).
+
 ### Local Mode (Offline)
 
 Read `intent.md` files from your project directory without an API key:
@@ -90,46 +146,45 @@ Read `intent.md` files from your project directory without an API key:
 }
 ```
 
-## Configuration
+### Configuration
 
 | Method | Details |
 |--------|---------|
 | Environment variable | `PATHMODE_API_KEY=pm_live_...` |
 | Config file | `~/.pathmode/config.json` with `apiKey`, `apiUrl`, `workspaceId` |
 | Local mode | `--local` flag — reads `intent.md` and `.pathmode/intents/*.md` |
+| No config | Intent Compiler works without any configuration |
 
-Get your API key from **Settings > API Keys** in the [Pathmode app](https://pathmode.io).
-
-## Tools
+### Team Tools
 
-### Intent Management
+#### Intent Management
 
-| Tool | Description | Annotations |
-|------|-------------|-------------|
-| `get_current_intent` | Get the active intent (first approved, or most recent) | readOnly |
-| `get_intent` | Get a single intent by ID with full details | readOnly |
-| `list_intents` | List all intents, optionally filtered by status | readOnly |
-| `search_intents` | Search intents by keyword across goals, objectives, and outcomes | readOnly |
-| `update_intent_status` | Update intent status (draft > validated > approved > shipped > verified) | write |
-| `log_implementation_note` | Record a technical decision or implementation note | write |
+| Tool | Description |
+|------|-------------|
+| `get_current_intent` | Get the active intent (first approved, or most recent) |
+| `get_intent` | Get a single intent by ID with full details |
+| `list_intents` | List all intents, optionally filtered by status |
+| `search_intents` | Search intents by keyword across goals, objectives, and outcomes |
+| `update_intent_status` | Update intent status (draft > validated > approved > shipped > verified) |
+| `log_implementation_note` | Record a technical decision or implementation note |
 
-### Strategic Analysis
+#### Strategic Analysis
 
-| Tool | Description | Annotations |
-|------|-------------|-------------|
-| `analyze_intent_graph` | Analyze dependency graph for critical path, cycles, bottlenecks, and risks | readOnly |
-| `get_intent_relations` | Get the dependency graph for a specific intent | readOnly |
+| Tool | Description |
+|------|-------------|
+| `analyze_intent_graph` | Analyze dependency graph for critical path, cycles, bottlenecks |
+| `get_intent_relations` | Get the dependency graph for a specific intent |
 
-### Context & Export
+#### Context & Export
 
-| Tool | Description | Annotations |
-|------|-------------|-------------|
-| `export_context` | Generate CLAUDE.md, .cursorrules, or intent.md files | readOnly |
-| `get_agent_prompt` | Get a structured execution prompt for an intent | readOnly |
-| `get_workspace` | Get workspace details including strategy and constitution | readOnly |
-| `get_constitution` | Get mandatory constraint rules for the workspace | readOnly |
+| Tool | Description |
+|------|-------------|
+| `export_context` | Generate CLAUDE.md, .cursorrules, or intent.md files |
+| `get_agent_prompt` | Get a structured execution prompt for an intent |
+| `get_workspace` | Get workspace details including strategy and constitution |
+| `get_constitution` | Get mandatory constraint rules for the workspace |
 
-### Prompts
+#### Team Prompts
 
 | Prompt | Description |
 |--------|-------------|
@@ -137,7 +192,7 @@ Get your API key from **Settings > API Keys** in the [Pathmode app](https://path
 | `review-risks` | Analyze the intent graph for architectural risks |
 | `what-next` | Suggest the highest-priority intent to work on next |
 
-### Resources
+#### Resources
 
 | URI | Description |
 |-----|-------------|
@@ -145,99 +200,37 @@ Get your API key from **Settings > API Keys** in the [Pathmode app](https://path
 | `intent://graph` | Full intent dependency graph |
 | `intent://workspace-strategy` | Workspace vision, principles, and active constitution rules |
 
-## Usage Examples
-
-### Example 1: Get Implementation Context
-
-**User prompt:** "What should I implement next?"
-
-**Expected tool calls:**
-1. `get_current_intent` — Fetches the first approved intent
-2. `get_agent_prompt` with `intentId` and `mode: "execute"` — Gets the structured implementation prompt
-
-**Expected output:** A full specification with objective, observable outcomes, constraints, edge cases, and verification steps that the AI agent uses to plan and execute the implementation.
-
----
-
-### Example 2: Analyze Architectural Risks
-
-**User prompt:** "Are there any risks in our intent dependency graph?"
-
-**Expected tool calls:**
-1. `analyze_intent_graph` with `analysis: "full"` — Runs complete graph analysis
-
-**Expected output:**
-```json
-{
-  "summary": { "total": 12, "statusDistribution": { "draft": 3, "approved": 5, "shipped": 4 } },
-  "criticalPath": [
-    { "id": "abc", "userGoal": "User authentication", "status": "shipped" },
-    { "id": "def", "userGoal": "Role-based access control", "status": "approved" },
-    { "id": "ghi", "userGoal": "Admin dashboard", "status": "draft" }
-  ],
-  "cycles": [],
-  "bottlenecks": [
-    { "id": "def", "userGoal": "Role-based access control", "dependentCount": 4, "status": "approved" }
-  ],
-  "orphanCount": 2
-}
-```
-
-The AI agent summarizes: the critical path has 3 steps, "Role-based access control" is a bottleneck blocking 4 other intents and should be prioritized, and 2 intents have no relationships.
-
----
-
-### Example 3: Generate a CLAUDE.md Context File
-
-**User prompt:** "Generate a CLAUDE.md for this project"
-
-**Expected tool calls:**
-1. `export_context` with `format: "claude-md"` — Generates workspace context
-
-**Expected output:** A markdown file containing workspace strategy, active constitution rules, and all approved intents formatted as structured context that can be added to any project's `CLAUDE.md` file. The AI agent can write this directly to disk.
-
----
-
-### Example 4: Search and Track Implementation
-
-**User prompt:** "Find all intents related to authentication and mark the login one as shipped"
-
-**Expected tool calls:**
-1. `search_intents` with `query: "authentication"` — Finds matching intents
-2. `update_intent_status` with `intentId` and `status: "shipped"` — Updates the login intent
-3. `log_implementation_note` — Documents what was implemented
-
-**Expected output:** The search returns matching intents, the status is updated, and a note is logged documenting the implementation approach.
-
 ## Troubleshooting
 
 **"No Pathmode configuration found"**
-Set the `PATHMODE_API_KEY` environment variable or create `~/.pathmode/config.json`.
+This no longer causes an error. The Intent Compiler works without any configuration. Team features require an API key.
 
 **Tools return "not available in local mode"**
-Most tools require cloud mode. Set up an API key, or use `--local` for basic intent reading from `intent.md` files.
+Most team tools require cloud mode. Set up an API key, or use `--local` for basic intent reading.
 
 **Connection timeout**
-Ensure your API key is valid and has the correct scopes (read, write). Check your network connection to `pathmode.io`.
+Ensure your API key is valid and has the correct scopes. Check your network connection to `pathmode.io`.
 
 ## Privacy Policy
 
 This MCP server connects to the Pathmode API (`pathmode.io`) to read and write intent specifications, workspace data, and constitution rules on behalf of the authenticated user.
 
-**Data collected:** The server transmits your API key for authentication and sends/receives workspace data (intents, constitution rules, workspace strategy) via the Pathmode API.
+The **Intent Compiler** works entirely offline — no data is sent to Pathmode servers. Specs are saved locally to your project directory.
 
-**Data storage:** The MCP server itself does not store any data locally (except in `--local` mode where it reads existing `intent.md` files from your project directory). All persistent data is stored in Pathmode's cloud infrastructure.
+**Data collected (team features only):** The server transmits your API key for authentication and sends/receives workspace data via the Pathmode API.
 
-**Third-party sharing:** No data is shared with third parties. The server communicates exclusively with the Pathmode API.
+**Data storage:** The MCP server does not store data locally (except `intent.md` files it creates and in `--local` mode). Persistent data is stored in Pathmode's cloud infrastructure.
 
-**Data retention:** Data retention follows Pathmode's standard data retention policies. See the full privacy policy at [https://pathmode.io/privacy](https://pathmode.io/privacy).
+**Third-party sharing:** No data is shared with third parties. The server communicates exclusively with the Pathmode API.
 
-**Contact:** For privacy inquiries, contact privacy@pathmode.io.
+Full privacy policy: [pathmode.io/privacy](https://pathmode.io/privacy)
 
-## Support
+## Links
 
-- Issues: [github.com/pathmode/mcp-server/issues](https://github.com/pathmode/mcp-server/issues)
-- Documentation: [pathmode.io/docs](https://pathmode.io/docs)
+- [Intent Compiler page](https://pathmode.io/intent-compiler) — Overview and setup guide
+- [Try in browser](https://pathmode.io/sandbox) — Interactive sandbox, no install needed
+- [Pathmode](https://pathmode.io) — Full platform for teams
+- [Issues](https://github.com/pathmodeio/mcp-server/issues)
 
 ## License
 

package/dist/api-client.d.ts

@@ -17,12 +17,11 @@ export interface ApiIntent {
     version: number;
     objective: string;
     problemSeverity?: string;
-    userGoal: string;
+    title: string;
     outcomes: string[];
     healthMetrics: string[];
     strategicAlignment?: string;
     alignmentNotes?: string;
-    preconditions: Record<string, any>;
     context: Record<string, any>;
     constraints: string[];
     verification: Record<string, any>;
@@ -74,7 +73,18 @@ export declare class PathmodeClient {
         prompt: string;
         json: object;
     }>;
-    updateIntentStatus(id: string, status: string): Promise<any>;
+    updateIntentStatus(id: string, status: string): Promise<{
+        id: string;
+        status: string;
+        updatedAt: string;
+        shippedAt?: string;
+        verifiedAt?: string;
+        verificationChecklist?: {
+            text: string;
+            category: string;
+        }[];
+        verificationChecklistCount?: number;
+    }>;
     logNote(intentId: string, note: string, source?: string): Promise<any>;
     getWorkspace(): Promise<ApiWorkspace>;
     getConstitution(): Promise<any>;

package/dist/api-client.d.ts.map

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

package/dist/index.d.ts

@@ -6,13 +6,15 @@
  *   npx @pathmode/mcp-server            # Cloud mode (uses ~/.pathmode/config.json)
  *   npx @pathmode/mcp-server --local     # Local mode (reads intent.md from cwd)
  *
+ * The Intent Compiler (compile-intent prompt, intent_save, intent_export tools)
+ * works without an API key — zero-config intent spec building in Claude Code.
+ *
  * Add to .claude/settings.json:
  *   {
  *     "mcpServers": {
  *       "pathmode": {
  *         "command": "npx",
- *         "args": ["@pathmode/mcp-server"],
- *         "env": { "PATHMODE_API_KEY": "pm_live_..." }
+ *         "args": ["@pathmode/mcp-server"]
  *       }
  *     }
  *   }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/index.js

@@ -11468,6 +11468,297 @@ class PathmodeClient {
 exports.PathmodeClient = PathmodeClient;
 
 
+/***/ }),
+
+/***/ 6488:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+/**
+ * Intent Compiler — Zero-config intent spec builder for Claude Code.
+ *
+ * Provides:
+ * 1. A Socratic conversation prompt that turns Claude into a product thinking partner
+ * 2. Format generators for intent.md, .cursorrules, and CLAUDE.md
+ *
+ * Architecture: Claude Code IS the conversation engine. This module only provides
+ * the personality prompt and file format generators. No AI API calls happen here.
+ */
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.getCompileIntentPrompt = getCompileIntentPrompt;
+exports.formatIntentMd = formatIntentMd;
+exports.formatCursorRules = formatCursorRules;
+exports.formatClaudeMdSection = formatClaudeMdSection;
+// ============================================================
+// Compile Intent Prompt
+// ============================================================
+/**
+ * Returns the system prompt that turns Claude into a Socratic intent interviewer.
+ * Adapted from intentDesignerMachine.ts conversationFirstPreamble for terminal use.
+ */
+function getCompileIntentPrompt() {
+    return `You are a sharp product thinking partner. Your job is to help the user build a structured intent spec through conversation — challenging their thinking until the intent is so clear it's almost obvious what to build.
+
+RULES:
+- Push back on vague language. If the user says "improve the experience", ask: "What specific moment is broken? What would the user see differently?"
+- Ask ONE pointed question at a time. Never list 3 questions.
+- When the user gives a clear answer, propose how you'd write that as a spec field. Explain WHY you worded it that way.
+- Look for inconsistencies between what they say the problem is and what outcomes they propose.
+- Be direct and concise. No pleasantries. No "Great question!" or "That's a good point!"
+- When the spec has existing content, critique it before adding more. Quality over quantity.
+
+VOICE:
+- Short sentences. Direct. Like a smart colleague, not a consultant.
+- Use concrete examples when challenging: "When you say 'faster', do you mean 2 seconds or 20 seconds?"
+- When you write spec fields, use precise language. No filler words.
+
+CONVERSATION FLOW (guidance, not rigid steps):
+1. **Problem** — What's broken? What's the pain? What happens today that shouldn't?
+2. **Goal** — What specific user outcome would solve this? Make it concrete and singular.
+3. **Outcomes** — Observable, testable state changes. Not activities, not implementations.
+4. **Edge Cases** — What's the most embarrassing way this could fail in a demo?
+5. **Review** — Play devil's advocate. What's missing? What would you cut?
+
+You are NOT bound by this order. Follow the user's thinking wherever it goes. If they start with edge cases, work backwards to the objective.
+
+BUILDING THE SPEC:
+As the conversation progresses, keep a mental model of the spec fields:
+- **Title**: Short name for the intent (what is this?)
+- **Objective**: Why this matters — the problem and who has it
+- **Outcomes**: 2-5 observable, testable results (not activities)
+- **Constraints**: Hard limits the implementation must respect
+- **Edge Cases**: Scenario + expected behavior pairs
+- **Health Metrics**: What to monitor after shipping (optional)
+- **Verification**: How to confirm it actually works (optional)
+
+When you have enough clarity on ANY field, state it clearly:
+> **Proposed Objective**: "Reduce failed deliveries in multi-unit buildings from 23% to under 5% by fixing address resolution at the driver app level."
+
+Then ask if that captures it or needs refinement.
+
+WHEN THE SPEC FEELS READY:
+Once you have at minimum a title, objective, and 2+ outcomes:
+1. Present the full spec as a summary for the user to review
+2. Ask if they want to save it
+3. When confirmed, call the \`intent_save\` tool with the complete spec
+4. Ask if they also want to export it as \`.cursorrules\` or \`CLAUDE.md\` for AI agent consumption — if yes, call \`intent_export\`
+5. Mention: "For dependency tracking, team collaboration, and governance, connect this to Pathmode at pathmode.io"
+
+IMPORTANT:
+- The spec fields in \`intent_save\` must use this exact structure:
+  - title: string
+  - objective: string
+  - outcomes: string[] (list of outcome statements)
+  - constraints: string[] (optional)
+  - edgeCases: { scenario: string, expectedBehavior: string }[] (optional)
+  - healthMetrics: string[] (optional)
+  - verification: { manualChecks?: string[], unitTests?: string[], e2eTests?: string[] } (optional)
+
+Now, ask the user what they're working on. If they've already described something, dig into it.`;
+}
+// ============================================================
+// Format: intent.md
+// ============================================================
+/**
+ * Generate intent.md content with YAML frontmatter.
+ * Adapted from lib/agentPromptGenerator.ts generateIntentMd().
+ */
+function formatIntentMd(spec) {
+    const now = new Date().toISOString();
+    const frontmatter = {
+        id: spec.id || `intent_${Date.now()}`,
+        version: 1,
+        status: 'draft',
+        created: now,
+        updated: now,
+    };
+    const yamlLines = Object.entries(frontmatter)
+        .map(([key, value]) => `${key}: ${typeof value === 'string' ? `"${value}"` : value}`)
+        .join('\n');
+    const sections = [];
+    sections.push('---');
+    sections.push(yamlLines);
+    sections.push('---');
+    sections.push('');
+    sections.push(`# ${spec.title || 'Untitled Intent'}`);
+    if (spec.objective) {
+        sections.push('');
+        sections.push('## Objective');
+        sections.push(spec.objective);
+    }
+    if (spec.outcomes?.length) {
+        sections.push('');
+        sections.push('## Outcomes');
+        for (const outcome of spec.outcomes) {
+            sections.push(`- [ ] ${outcome}`);
+        }
+    }
+    if (spec.constraints?.length) {
+        sections.push('');
+        sections.push('## Constraints');
+        for (const constraint of spec.constraints) {
+            sections.push(`- ${constraint}`);
+        }
+    }
+    if (spec.edgeCases?.length) {
+        sections.push('');
+        sections.push('## Edge Cases');
+        for (const ec of spec.edgeCases) {
+            sections.push(`- **${ec.scenario}**: ${ec.expectedBehavior}`);
+        }
+    }
+    if (spec.healthMetrics?.length) {
+        sections.push('');
+        sections.push('## Health Metrics');
+        for (const metric of spec.healthMetrics) {
+            sections.push(`- ${metric}`);
+        }
+    }
+    if (spec.verification) {
+        const { e2eTests, unitTests, manualChecks } = spec.verification;
+        const hasContent = e2eTests?.length || unitTests?.length || manualChecks?.length;
+        if (hasContent) {
+            sections.push('');
+            sections.push('## Verification');
+            if (e2eTests?.length) {
+                sections.push('**E2E Tests**:');
+                for (const t of e2eTests)
+                    sections.push(`- [ ] ${t}`);
+            }
+            if (unitTests?.length) {
+                sections.push('**Unit Tests**:');
+                for (const t of unitTests)
+                    sections.push(`- [ ] ${t}`);
+            }
+            if (manualChecks?.length) {
+                sections.push('**Manual Checks**:');
+                for (const t of manualChecks)
+                    sections.push(`- [ ] ${t}`);
+            }
+        }
+    }
+    sections.push('');
+    return sections.join('\n');
+}
+// ============================================================
+// Format: .cursorrules
+// ============================================================
+/**
+ * Generate .cursorrules content for a single intent.
+ * Adapted from lib/agentPromptGenerator.ts generateCursorRules().
+ */
+function formatCursorRules(spec) {
+    const sections = [];
+    sections.push('# Pathmode Intent Rules');
+    sections.push(`# Generated at ${new Date().toISOString()}`);
+    sections.push('# Regenerate with: intentspec pull (or use Pathmode MCP compile-intent prompt)');
+    // Current objective
+    sections.push('');
+    sections.push('# CURRENT OBJECTIVE');
+    sections.push(`You are implementing: "${spec.title || 'Untitled Feature'}"`);
+    if (spec.objective) {
+        sections.push('');
+        sections.push('# WHY');
+        sections.push(spec.objective);
+    }
+    if (spec.outcomes?.length) {
+        sections.push('');
+        sections.push('# SUCCESS OUTCOMES');
+        sections.push('Your implementation MUST satisfy ALL of these:');
+        for (const outcome of spec.outcomes) {
+            sections.push(`- ${outcome}`);
+        }
+    }
+    if (spec.constraints?.length) {
+        sections.push('');
+        sections.push('# CONSTRAINTS');
+        sections.push('These are mandatory rules. You MUST NOT violate them:');
+        for (const constraint of spec.constraints) {
+            sections.push(`- ${constraint}`);
+        }
+    }
+    if (spec.edgeCases?.length) {
+        sections.push('');
+        sections.push('# EDGE CASES');
+        sections.push('Handle these scenarios:');
+        for (const ec of spec.edgeCases) {
+            sections.push(`- ${ec.scenario} → ${ec.expectedBehavior}`);
+        }
+    }
+    if (spec.healthMetrics?.length) {
+        sections.push('');
+        sections.push('# HEALTH METRICS');
+        sections.push('Monitor these after shipping:');
+        for (const metric of spec.healthMetrics) {
+            sections.push(`- ${metric}`);
+        }
+    }
+    if (spec.verification) {
+        const { e2eTests, unitTests, manualChecks } = spec.verification;
+        const hasContent = e2eTests?.length || unitTests?.length || manualChecks?.length;
+        if (hasContent) {
+            sections.push('');
+            sections.push('# VERIFICATION');
+            sections.push('After implementation, verify:');
+            if (e2eTests?.length) {
+                for (const t of e2eTests)
+                    sections.push(`- [e2e] ${t}`);
+            }
+            if (unitTests?.length) {
+                for (const t of unitTests)
+                    sections.push(`- [unit] ${t}`);
+            }
+            if (manualChecks?.length) {
+                for (const t of manualChecks)
+                    sections.push(`- [manual] ${t}`);
+            }
+        }
+    }
+    sections.push('');
+    return sections.join('\n');
+}
+// ============================================================
+// Format: CLAUDE.md section
+// ============================================================
+/**
+ * Generate a CLAUDE.md section wrapped in PATHMODE markers.
+ * Can be appended to an existing CLAUDE.md or used standalone.
+ * Adapted from lib/agentPromptGenerator.ts generateClaudeMdContent().
+ */
+function formatClaudeMdSection(spec) {
+    const sections = [];
+    sections.push('<!-- PATHMODE:START - Do not edit this section manually -->');
+    sections.push('# Pathmode Intent Context');
+    sections.push(`_Generated at ${new Date().toISOString()} | [pathmode.io](https://pathmode.io)_`);
+    sections.push('');
+    sections.push('## Active Intent');
+    sections.push(`### ${spec.title || 'Untitled Intent'}`);
+    sections.push(`**Status**: draft`);
+    if (spec.objective) {
+        sections.push(`**Objective**: ${spec.objective}`);
+    }
+    if (spec.outcomes?.length) {
+        sections.push('**Outcomes**:');
+        sections.push(spec.outcomes.map(o => `- [ ] ${o}`).join('\n'));
+    }
+    if (spec.constraints?.length) {
+        sections.push('**Constraints**:');
+        sections.push(spec.constraints.map(c => `- ${c}`).join('\n'));
+    }
+    if (spec.edgeCases?.length) {
+        sections.push('**Edge Cases**:');
+        sections.push(spec.edgeCases.map(ec => `- **${ec.scenario}**: ${ec.expectedBehavior}`).join('\n'));
+    }
+    if (spec.healthMetrics?.length) {
+        sections.push('**Health Metrics**:');
+        sections.push(spec.healthMetrics.map(m => `- ${m}`).join('\n'));
+    }
+    sections.push('<!-- PATHMODE:END -->');
+    return sections.join('\n\n');
+}
+
+
 /***/ }),
 
 /***/ 3518:
@@ -11528,7 +11819,7 @@ function readIntentFile(filePath) {
             status: data.status || 'draft',
             version: data.version || 1,
             objective: data.objective || extractSection(body, 'Objective') || '',
-            userGoal: data.userGoal || extractTitle(body) || 'Untitled Intent',
+            title: data.title || data.userGoal || extractTitle(body) || 'Untitled Intent',
             stageName: data.stage || undefined,
             severity: data.severity || undefined,
             outcomes,
@@ -39392,13 +39683,15 @@ var exports = __webpack_exports__;
  *   npx @pathmode/mcp-server            # Cloud mode (uses ~/.pathmode/config.json)
  *   npx @pathmode/mcp-server --local     # Local mode (reads intent.md from cwd)
  *
+ * The Intent Compiler (compile-intent prompt, intent_save, intent_export tools)
+ * works without an API key — zero-config intent spec building in Claude Code.
+ *
  * Add to .claude/settings.json:
  *   {
  *     "mcpServers": {
  *       "pathmode": {
  *         "command": "npx",
- *         "args": ["@pathmode/mcp-server"],
- *         "env": { "PATHMODE_API_KEY": "pm_live_..." }
+ *         "args": ["@pathmode/mcp-server"]
  *       }
  *     }
  *   }
@@ -39407,27 +39700,26 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 const mcp_js_1 = __nccwpck_require__(3886);
 const stdio_js_1 = __nccwpck_require__(4239);
 const zod_1 = __nccwpck_require__(924);
+const path_1 = __nccwpck_require__(6928);
+const fs_1 = __nccwpck_require__(9896);
 const api_client_1 = __nccwpck_require__(7475);
 const local_reader_1 = __nccwpck_require__(3518);
+const intent_compiler_1 = __nccwpck_require__(6488);
 const isLocalMode = process.argv.includes('--local');
 let client = null;
 if (!isLocalMode) {
     const config = (0, api_client_1.loadConfig)();
-    if (!config) {
-        console.error('No Pathmode configuration found. Either:\n' +
-            '  1. Run `intentspec login` to configure\n' +
-            '  2. Set PATHMODE_API_KEY environment variable\n' +
-            '  3. Use --local flag for offline mode');
-        process.exit(1);
+    if (config) {
+        client = new api_client_1.PathmodeClient(config);
     }
-    client = new api_client_1.PathmodeClient(config);
+    // No exit — Intent Compiler tools work without an API key
 }
 // ============================================================
 // Server Setup
 // ============================================================
 const server = new mcp_js_1.McpServer({
     name: 'pathmode',
-    version: '1.1.0',
+    version: '1.2.0',
 });
 // Annotation presets
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -39521,7 +39813,7 @@ server.registerTool('get_intent_relations', {
                 type: 'text',
                 text: JSON.stringify({
                     intentId: intent.id,
-                    userGoal: intent.userGoal,
+                    title: intent.title,
                     relations: intent.relations,
                 }, null, 2)
             }]
@@ -39540,7 +39832,7 @@ server.registerTool('search_intents', {
         const intents = (0, local_reader_1.readLocalIntents)();
         const q = query.toLowerCase();
         const matches = intents.filter(i => {
-            const text = [i.userGoal, i.objective, ...i.outcomes, ...i.constraints].join(' ').toLowerCase();
+            const text = [i.title, i.objective, ...i.outcomes, ...i.constraints].join(' ').toLowerCase();
             return text.includes(q) && (!status || i.status === status);
         });
         return { content: [{ type: 'text', text: JSON.stringify({ results: matches, count: matches.length, query }, null, 2) }] };
@@ -39549,12 +39841,12 @@ server.registerTool('search_intents', {
         const intents = await client.listIntents(status);
         const q = query.toLowerCase();
         const matches = intents.filter(i => {
-            const text = [i.userGoal, i.objective, ...(i.outcomes || []), ...(i.constraints || [])].join(' ').toLowerCase();
+            const text = [i.title, i.objective, ...(i.outcomes || []), ...(i.constraints || [])].join(' ').toLowerCase();
             return text.includes(q);
         });
         const results = matches.map(i => ({
             id: i.id,
-            userGoal: i.userGoal,
+            title: i.title,
             objective: i.objective,
             status: i.status,
             stageName: i.stageName,
@@ -39697,7 +39989,7 @@ server.registerTool('analyze_intent_graph', {
         for (const [id, dependents] of reverse) {
             if (dependents.size >= 3) {
                 const spec = specMap.get(id);
-                bottlenecks.push({ id, userGoal: spec?.userGoal || 'Untitled', dependentCount: dependents.size, status: spec?.status || 'unknown' });
+                bottlenecks.push({ id, title: spec?.title || 'Untitled', dependentCount: dependents.size, status: spec?.status || 'unknown' });
             }
         }
         // Orphans
@@ -39715,19 +40007,19 @@ server.registerTool('analyze_intent_graph', {
         if (type === 'critical-path') {
             const pathDetails = criticalPath.map(id => {
                 const s = specMap.get(id);
-                return { id, userGoal: s?.userGoal || 'Untitled', status: s?.status || 'unknown' };
+                return { id, title: s?.title || 'Untitled', status: s?.status || 'unknown' };
             });
             return { content: [{ type: 'text', text: JSON.stringify({ criticalPath: pathDetails, length: criticalPath.length }, null, 2) }] };
         }
         if (type === 'risks') {
             const risks = [];
             for (const cycle of cycles) {
-                const names = cycle.slice(0, -1).map(id => specMap.get(id)?.userGoal || 'Untitled');
+                const names = cycle.slice(0, -1).map(id => specMap.get(id)?.title || 'Untitled');
                 risks.push({ type: 'cycle', severity: 'critical', message: `Circular dependency: ${names.join(' \u2192 ')}` });
             }
             for (const b of bottlenecks) {
                 const isDraft = b.status === 'draft' || b.status === 'validated';
-                risks.push({ type: 'bottleneck', severity: isDraft ? 'critical' : 'warning', message: `"${b.userGoal}" blocks ${b.dependentCount} intents${isDraft ? ` and is still ${b.status}` : ''}` });
+                risks.push({ type: 'bottleneck', severity: isDraft ? 'critical' : 'warning', message: `"${b.title}" blocks ${b.dependentCount} intents${isDraft ? ` and is still ${b.status}` : ''}` });
             }
             return { content: [{ type: 'text', text: JSON.stringify({ risks }, null, 2) }] };
         }
@@ -39736,9 +40028,9 @@ server.registerTool('analyze_intent_graph', {
             summary: { total: intents.length, statusDistribution: statusDist },
             criticalPath: criticalPath.map(id => {
                 const s = specMap.get(id);
-                return { id, userGoal: s?.userGoal || 'Untitled', status: s?.status || 'unknown' };
+                return { id, title: s?.title || 'Untitled', status: s?.status || 'unknown' };
             }),
-            cycles: cycles.map(c => c.slice(0, -1).map(id => ({ id, userGoal: specMap.get(id)?.userGoal || 'Untitled' }))),
+            cycles: cycles.map(c => c.slice(0, -1).map(id => ({ id, title: specMap.get(id)?.title || 'Untitled' }))),
             bottlenecks,
             orphanCount: orphans.length,
         };
@@ -39825,7 +40117,7 @@ server.registerTool('get_constitution', {
 // ============================================================
 server.registerTool('update_intent_status', {
     title: 'Update Intent Status',
-    description: 'Update the status of an intent. Use this to mark an intent as shipped after implementation, or verified after testing.',
+    description: 'Update the status of an intent. Use this to mark an intent as shipped after implementation, or verified after testing. For shipped/verified transitions, the response includes a verification checklist of outcomes, constitution rules, and health metrics that should be confirmed.',
     inputSchema: {
         intentId: zod_1.z.string().describe('The intent ID to update'),
         status: zod_1.z.enum(['draft', 'validated', 'approved', 'shipped', 'verified']).describe('The new status'),
@@ -39836,10 +40128,19 @@ server.registerTool('update_intent_status', {
         return { content: [{ type: 'text', text: 'Status updates are not available in local mode. Use cloud mode.' }] };
     }
     const result = await client.updateIntentStatus(intentId, status);
+    let responseText = `Intent ${intentId} status updated to "${status}".`;
+    // Surface verification checklist for shipped/verified transitions
+    if (result.verificationChecklist && result.verificationChecklist.length > 0) {
+        responseText += `\n\nVerification Checklist (${result.verificationChecklistCount} items to verify):`;
+        for (const item of result.verificationChecklist) {
+            responseText += `\n  [ ] [${item.category}] ${item.text}`;
+        }
+        responseText += `\n\nThese items should be verified. Use log_implementation_note to record verification results.`;
+    }
     return {
         content: [{
                 type: 'text',
-                text: `Intent ${intentId} status updated to "${status}". ${JSON.stringify(result)}`
+                text: responseText
             }]
     };
 });
@@ -39902,6 +40203,88 @@ server.prompt('what-next', 'Suggest the highest-priority intent to work on next,
     };
 });
 // ============================================================
+// Intent Compiler — Zero-config tools (no API key needed)
+// ============================================================
+const intentSpecSchema = {
+    title: zod_1.z.string().describe('Short name for the intent'),
+    objective: zod_1.z.string().describe('Why this matters — the problem and who has it'),
+    outcomes: zod_1.z.array(zod_1.z.string()).describe('Observable, testable state changes'),
+    constraints: zod_1.z.array(zod_1.z.string()).optional().describe('Hard limits the implementation must respect'),
+    edgeCases: zod_1.z.array(zod_1.z.object({
+        scenario: zod_1.z.string(),
+        expectedBehavior: zod_1.z.string(),
+    })).optional().describe('Failure modes and boundary conditions'),
+    healthMetrics: zod_1.z.array(zod_1.z.string()).optional().describe('What to monitor after shipping'),
+    verification: zod_1.z.object({
+        manualChecks: zod_1.z.array(zod_1.z.string()).optional(),
+        unitTests: zod_1.z.array(zod_1.z.string()).optional(),
+        e2eTests: zod_1.z.array(zod_1.z.string()).optional(),
+    }).optional().describe('How to confirm it works'),
+};
+server.prompt('compile-intent', 'Start a Socratic conversation to build a structured intent spec from user feedback or a problem description. No Pathmode account needed.', {}, async () => {
+    return {
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: (0, intent_compiler_1.getCompileIntentPrompt)(),
+                },
+            }],
+    };
+});
+server.tool('intent_save', 'Save an intent spec to intent.md in the project root. Called after building a spec through conversation.', {
+    spec: zod_1.z.object(intentSpecSchema),
+    path: zod_1.z.string().optional().describe('File path relative to cwd. Defaults to intent.md'),
+}, async ({ spec, path }) => {
+    const filePath = (0, path_1.resolve)(process.cwd(), path || 'intent.md');
+    const content = (0, intent_compiler_1.formatIntentMd)({ ...spec, id: `intent_${Date.now()}` });
+    (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
+    return {
+        content: [{
+                type: 'text',
+                text: `✓ Saved intent spec to ${filePath}\n\nTo connect this to Pathmode for dependency tracking and team collaboration, visit pathmode.io`,
+            }],
+    };
+});
+server.tool('intent_export', 'Export an intent spec as .cursorrules or CLAUDE.md section for AI agent consumption.', {
+    format: zod_1.z.enum(['cursorrules', 'claude-md']).describe('Export format'),
+    spec: zod_1.z.object(intentSpecSchema),
+    path: zod_1.z.string().optional().describe('Output file path. Defaults to .cursorrules or CLAUDE.md'),
+}, async ({ format, spec, path }) => {
+    if (format === 'cursorrules') {
+        const content = (0, intent_compiler_1.formatCursorRules)(spec);
+        const filePath = (0, path_1.resolve)(process.cwd(), path || '.cursorrules');
+        (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✓ Exported .cursorrules to ${filePath}\n\nCursor and other AI agents will now see this intent as their implementation context.`,
+                }],
+        };
+    }
+    else {
+        const section = (0, intent_compiler_1.formatClaudeMdSection)(spec);
+        const filePath = (0, path_1.resolve)(process.cwd(), path || 'CLAUDE.md');
+        // Append or replace PATHMODE section in existing file
+        let existing = '';
+        try {
+            existing = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        }
+        catch { /* file doesn't exist yet */ }
+        const marker = /<!-- PATHMODE:START -->[\s\S]*?<!-- PATHMODE:END -->/;
+        const updated = marker.test(existing)
+            ? existing.replace(marker, section)
+            : existing ? existing + '\n\n' + section : section;
+        (0, fs_1.writeFileSync)(filePath, updated, 'utf-8');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✓ Exported CLAUDE.md section to ${filePath}\n\nClaude Code will now see this intent as context in every conversation.`,
+                }],
+        };
+    }
+});
+// ============================================================
 // Resources
 // ============================================================
 server.resource('intent://current', 'intent://current', async (uri) => {
@@ -39938,7 +40321,7 @@ server.resource('intent://graph', 'intent://graph', async (uri) => {
     const intents = await client.listIntents();
     const graph = intents.map(i => ({
         id: i.id,
-        userGoal: i.userGoal,
+        title: i.title,
         status: i.status,
         relations: i.relations,
     }));

package/dist/intent-compiler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Intent Compiler — Zero-config intent spec builder for Claude Code.
+ *
+ * Provides:
+ * 1. A Socratic conversation prompt that turns Claude into a product thinking partner
+ * 2. Format generators for intent.md, .cursorrules, and CLAUDE.md
+ *
+ * Architecture: Claude Code IS the conversation engine. This module only provides
+ * the personality prompt and file format generators. No AI API calls happen here.
+ */
+export interface IntentFields {
+    id?: string;
+    title: string;
+    objective: string;
+    outcomes: string[];
+    constraints?: string[];
+    edgeCases?: {
+        scenario: string;
+        expectedBehavior: string;
+    }[];
+    healthMetrics?: string[];
+    verification?: {
+        manualChecks?: string[];
+        unitTests?: string[];
+        e2eTests?: string[];
+    };
+}
+/**
+ * Returns the system prompt that turns Claude into a Socratic intent interviewer.
+ * Adapted from intentDesignerMachine.ts conversationFirstPreamble for terminal use.
+ */
+export declare function getCompileIntentPrompt(): string;
+/**
+ * Generate intent.md content with YAML frontmatter.
+ * Adapted from lib/agentPromptGenerator.ts generateIntentMd().
+ */
+export declare function formatIntentMd(spec: IntentFields): string;
+/**
+ * Generate .cursorrules content for a single intent.
+ * Adapted from lib/agentPromptGenerator.ts generateCursorRules().
+ */
+export declare function formatCursorRules(spec: IntentFields): string;
+/**
+ * Generate a CLAUDE.md section wrapped in PATHMODE markers.
+ * Can be appended to an existing CLAUDE.md or used standalone.
+ * Adapted from lib/agentPromptGenerator.ts generateClaudeMdContent().
+ */
+export declare function formatClaudeMdSection(spec: IntentFields): string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/intent-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,YAAY;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACL;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA2D/C;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAkFzD;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA2E5D;AAOD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAyChE"}

package/dist/local-reader.d.ts

@@ -7,7 +7,7 @@ export interface LocalIntent {
     status: string;
     version: number;
     objective: string;
-    userGoal: string;
+    title: string;
     stageName?: string;
     severity?: string;
     outcomes: string[];

package/dist/local-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/local-reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAmBhD"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/local-reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAmBhD"}

package/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <path d="M50 50 L95 25 L95 75 L50 100 Z" fill="#3A8A8C" />
+  <path d="M50 50 L5 75 L5 25 L50 0 Z" fill="#C94C56" />
+  <path d="M5 75 L50 100 L50 50 Z" fill="#A87693" />
+  <path d="M50 0 L95 25 L50 50 Z" fill="#3D476D" />
+  <path d="M45 40 L65 50 L45 60 Z" fill="#ffffff" fill-opacity="0.9" />
+</svg>

package/manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "pathmode",
   "display_name": "Pathmode",
-  "version": "1.1.0",
-  "description": "Connect AI agents to your Intent Layer. Get strategic context, dependency graphs, and implementation prompts.",
-  "long_description": "Pathmode MCP Server connects Claude Code, Cursor, and other AI agents to your product team's Intent Layer. AI agents get structured specifications (objectives, outcomes, constraints, edge cases), dependency graph analysis (critical path, bottlenecks, cycles), and workspace strategy context \u2014 so they build the right thing, not just any thing.",
+  "version": "1.2.0",
+  "description": "Build structured intent specs through Socratic AI conversation, or connect to your Intent Layer for strategic context and dependency graphs.",
+  "long_description": "Pathmode MCP Server includes the Intent Compiler — a zero-config Socratic conversation that helps you build structured intent specs (objectives, outcomes, constraints, edge cases) right in Claude Code. No signup needed. For teams, connect to your Pathmode workspace for dependency graph analysis (critical path, bottlenecks, cycles), workspace strategy context, and governance — so AI agents build the right thing, not just any thing.",
   "author": {
     "name": "Pathmode",
     "url": "https://pathmode.io"
@@ -12,14 +12,16 @@
   "homepage": "https://pathmode.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pathmode/mcp-server"
+    "url": "https://github.com/pathmodeio/mcp-server"
   },
-  "documentation": "https://github.com/pathmode/mcp-server#readme",
-  "support": "https://github.com/pathmode/mcp-server/issues",
+  "documentation": "https://github.com/pathmodeio/mcp-server#readme",
+  "support": "https://github.com/pathmodeio/mcp-server/issues",
   "license": "MIT",
+  "icon": "icon.svg",
   "keywords": [
     "pathmode",
     "intent-engineering",
+    "intent-compiler",
     "product-development",
     "dependency-graph",
     "ai-agents",
@@ -43,9 +45,9 @@
     "api_key": {
       "type": "string",
       "title": "Pathmode API Key",
-      "description": "Your Pathmode API key (starts with pm_live_). Get one from Settings > API Keys in the Pathmode app.",
+      "description": "Optional. Your Pathmode API key (starts with pm_live_) for team features. The Intent Compiler works without it. Get a key from Settings > API Keys in the Pathmode app.",
       "sensitive": true,
-      "required": true
+      "required": false
     }
   },
   "compatibility": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pathmode/mcp-server",
-  "version": "1.1.0",
-  "description": "Pathmode MCP Server — Connect Claude Code, Cursor, and AI agents to your Intent Layer. Get strategic context, dependency graphs, and implementation prompts.",
+  "version": "1.2.1",
+  "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"
@@ -9,6 +9,7 @@
   "files": [
     "dist/",
     "manifest.json",
+    "icon.svg",
     "README.md"
   ],
   "scripts": {
@@ -24,6 +25,7 @@
     "cursor",
     "windsurf",
     "intent-engineering",
+    "intent-compiler",
     "ai-agents",
     "product-development",
     "dependency-graph",
@@ -37,7 +39,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pathmode/mcp-server.git"
+    "url": "git+https://github.com/pathmodeio/mcp-server.git"
   },
   "homepage": "https://pathmode.io",
   "dependencies": {