@pathmode/mcp-server 1.6.0 → 1.8.0

package/README.md

@@ -28,11 +28,11 @@ The Intent Compiler turns Claude Code into a Socratic product thinking partner.
   Does that capture it, or is there more to the pain?
 ```
 
-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.
+When the spec is ready, Claude saves it as `intent.md` and optionally exports as `.cursorrules`, `CLAUDE.md`, or `AGENTS.md` (Codex/Cursor) — so every AI agent in your project sees the intent as its implementation context.
 
 ### Quick Start
 
-Add to `.claude/settings.json`:
+Add to `.mcp.json` in your project root:
 
 ```json
 {
@@ -120,7 +120,7 @@ Restart Claude Code. The skills register at session start and auto-invoke when y
 | 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_export` | Export as `.cursorrules`, a `CLAUDE.md` or `AGENTS.md` section, or an Outcomes rubric |
 
 ### Intent Compiler Prompt
 
@@ -156,7 +156,7 @@ npx @pathmode/mcp-server@latest setup pm_live_...
 }
 ```
 
-Works with Claude Code (`.claude/settings.json`), Claude Desktop (`claude_desktop_config.json`), and Cursor (`.cursor/mcp.json`).
+Works with Claude Code (`.mcp.json` in the project root), 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).
 
@@ -208,7 +208,7 @@ Read `intent.md` files from your project directory without an API key:
 
 | Tool | Description |
 |------|-------------|
-| `export_context` | Generate CLAUDE.md, .cursorrules, or intent.md files. For claude-md, optionally pass a product ID; for cursorrules/intent-md, product is derived from the resolved intent |
+| `export_context` | Generate CLAUDE.md, AGENTS.md (Codex/modern Cursor), .cursorrules, or intent.md files. For claude-md/agents-md, optionally pass a product ID; for cursorrules/intent-md, product is derived from the resolved intent |
 | `get_agent_prompt` | Get a structured execution prompt for an intent |
 | `get_workspace` | Get workspace details including strategy, active products, and constitution |
 | `get_constitution` | Get mandatory constraint rules for the workspace |

package/dist/api-client.d.ts

@@ -12,6 +12,14 @@ export interface ApiStructuredOutcome {
     text: string;
     priority?: 'must' | 'should' | 'could';
 }
+export interface IntentDecision {
+    id: string;
+    choice: string;
+    ruledOut?: string;
+    reason: string;
+    evidenceIds?: string[];
+    resolvedAt: number;
+}
 export interface ApiIntent {
     id: string;
     workspaceId: string;
@@ -35,6 +43,7 @@ export interface ApiIntent {
     verification: Record<string, any>;
     externalLinks: any[];
     evidenceAnchors: Record<string, string[]>;
+    decisions?: IntentDecision[];
     implementationContext?: {
         relevantAreas: {
             path: string;
@@ -83,6 +92,13 @@ export interface CreateIntentInput {
         expectedBehavior: string;
     }[];
     verification?: {
+        checks?: {
+            id?: string;
+            kind?: string;
+            description: string;
+            status?: string;
+            verifies?: string;
+        }[];
         manualChecks?: string[];
         unitTests?: string[];
         e2eTests?: string[];
@@ -107,6 +123,13 @@ export interface UpdateIntentInput {
         expectedBehavior: string;
     }[];
     verification?: {
+        checks?: {
+            id?: string;
+            kind?: string;
+            description: string;
+            status?: string;
+            verifies?: string;
+        }[];
         manualChecks?: string[];
         unitTests?: string[];
         e2eTests?: string[];
@@ -141,6 +164,13 @@ export interface LinkEvidenceInput {
     link?: string[];
     unlink?: string[];
 }
+export interface RecordFindingInput {
+    assumption: string;
+    finding: string;
+    target?: string;
+    correction?: string;
+    source?: string;
+}
 export interface ApiVerificationResult {
     pass: boolean;
     score: number;
@@ -184,6 +214,10 @@ export interface ApiWorkspace {
         id: string;
         category: string;
         text: string;
+        rationale?: string;
+        scope?: string;
+        enforcement?: 'advisory' | 'required' | 'blocking';
+        examples?: string[];
         isActive: boolean;
         createdAt: string;
     }[];
@@ -232,10 +266,11 @@ export declare class PathmodeClient {
         verificationChecklistCount?: number;
     }>;
     logNote(intentId: string, note: string, source?: string): Promise<any>;
+    recordFinding(intentId: string, input: RecordFindingInput): Promise<any>;
     getWorkspace(): Promise<ApiWorkspace>;
     getConstitution(): Promise<any>;
     exportClaudeMd(): Promise<string>;
-    exportContext(format: 'claude-md' | 'cursorrules' | 'intent-md', intentId?: string, productId?: string): Promise<string>;
+    exportContext(format: 'claude-md' | 'agents-md' | 'cursorrules' | 'intent-md', intentId?: string, productId?: string): Promise<string>;
     createIntent(input: CreateIntentInput): Promise<ApiIntent>;
     updateIntent(id: string, updates: UpdateIntentInput): Promise<ApiIntent>;
     queryEvidence(filters?: EvidenceQuery): Promise<{

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

@@ -12,7 +12,7 @@
  * 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:
+ * Add to .mcp.json in the project root:
  *   {
  *     "mcpServers": {
  *       "pathmode": {

package/dist/index.js

@@ -5330,7 +5330,7 @@ module.exports = {
 
 
 const { parseSetCookie } = __nccwpck_require__(9000)
-const { stringify, getHeadersList } = __nccwpck_require__(799)
+const { stringify } = __nccwpck_require__(799)
 const { webidl } = __nccwpck_require__(1523)
 const { Headers } = __nccwpck_require__(8526)
 
@@ -5406,14 +5406,13 @@ function getSetCookies (headers) {
 
   webidl.brandCheck(headers, Headers, { strict: false })
 
-  const cookies = getHeadersList(headers).cookies
+  const cookies = headers.getSetCookie()
 
   if (!cookies) {
     return []
   }
 
-  // In older versions of undici, cookies is a list of name:value.
-  return cookies.map((pair) => parseSetCookie(Array.isArray(pair) ? pair[1] : pair))
+  return cookies.map((pair) => parseSetCookie(pair))
 }
 
 /**
@@ -5841,14 +5840,15 @@ module.exports = {
 /***/ }),
 
 /***/ 799:
-/***/ ((module, __unused_webpack_exports, __nccwpck_require__) => {
+/***/ ((module) => {
 
 "use strict";
 
 
-const assert = __nccwpck_require__(2613)
-const { kHeadersList } = __nccwpck_require__(7506)
-
+/**
+ * @param {string} value
+ * @returns {boolean}
+ */
 function isCTLExcludingHtab (value) {
   if (value.length === 0) {
     return false
@@ -6109,31 +6109,13 @@ function stringify (cookie) {
   return out.join('; ')
 }
 
-let kHeadersListNode
-
-function getHeadersList (headers) {
-  if (headers[kHeadersList]) {
-    return headers[kHeadersList]
-  }
-
-  if (!kHeadersListNode) {
-    kHeadersListNode = Object.getOwnPropertySymbols(headers).find(
-      (symbol) => symbol.description === 'headers list'
-    )
-
-    assert(kHeadersListNode, 'Headers cannot be parsed')
-  }
-
-  const headersList = headers[kHeadersListNode]
-  assert(headersList)
-
-  return headersList
-}
-
 module.exports = {
   isCTLExcludingHtab,
-  stringify,
-  getHeadersList
+  validateCookieName,
+  validateCookiePath,
+  validateCookieValue,
+  toIMFDate,
+  stringify
 }
 
 
@@ -8062,6 +8044,14 @@ const { isUint8Array, isArrayBuffer } = __nccwpck_require__(8253)
 const { File: UndiciFile } = __nccwpck_require__(3044)
 const { parseMIMEType, serializeAMimeType } = __nccwpck_require__(7845)
 
+let random
+try {
+  const crypto = __nccwpck_require__(7598)
+  random = (max) => crypto.randomInt(0, max)
+} catch {
+  random = (max) => Math.floor(Math.random(max))
+}
+
 let ReadableStream = globalThis.ReadableStream
 
 /** @type {globalThis['File']} */
@@ -8147,7 +8137,7 @@ function extractBody (object, keepalive = false) {
     // Set source to a copy of the bytes held by object.
     source = new Uint8Array(object.buffer.slice(object.byteOffset, object.byteOffset + object.byteLength))
   } else if (util.isFormDataLike(object)) {
-    const boundary = `----formdata-undici-0${`${Math.floor(Math.random() * 1e11)}`.padStart(11, '0')}`
+    const boundary = `----formdata-undici-0${`${random(1e11)}`.padStart(11, '0')}`
     const prefix = `--${boundary}\r\nContent-Disposition: form-data`
 
     /*! formdata-polyfill. MIT License. Jimmy Wärting <https://jimmy.warting.se/opensource> */
@@ -10129,6 +10119,7 @@ const {
   isValidHeaderName,
   isValidHeaderValue
 } = __nccwpck_require__(5182)
+const util = __nccwpck_require__(9023)
 const { webidl } = __nccwpck_require__(1523)
 const assert = __nccwpck_require__(2613)
 
@@ -10682,6 +10673,9 @@ Object.defineProperties(Headers.prototype, {
   [Symbol.toStringTag]: {
     value: 'Headers',
     configurable: true
+  },
+  [util.inspect.custom]: {
+    enumerable: false
   }
 })
 
@@ -19858,6 +19852,20 @@ class Pool extends PoolBase {
       ? { ...options.interceptors }
       : undefined
     this[kFactory] = factory
+
+    this.on('connectionError', (origin, targets, error) => {
+      // If a connection error occurs, we remove the client from the pool,
+      // and emit a connectionError event. They will not be re-used.
+      // Fixes https://github.com/nodejs/undici/issues/3895
+      for (const target of targets) {
+        // Do not use kRemoveClient here, as it will close the client,
+        // but the client cannot be closed in this state.
+        const idx = this[kClients].indexOf(target)
+        if (idx !== -1) {
+          this[kClients].splice(idx, 1)
+        }
+      }
+    })
   }
 
   [kGetDispatcher] () {
@@ -33618,6 +33626,13 @@ class PathmodeClient {
         });
         return res.json();
     }
+    async recordFinding(intentId, input) {
+        const res = await this.fetch(`/intents/${intentId}/findings`, {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+        return res.json();
+    }
     async getWorkspace() {
         const res = await this.fetch('/workspace');
         return res.json();
@@ -33904,6 +33919,57 @@ exports.formatIntentMd = formatIntentMd;
 exports.formatCursorRules = formatCursorRules;
 exports.formatClaudeMdSection = formatClaudeMdSection;
 exports.formatOutcomeRubric = formatOutcomeRubric;
+const VERIFICATION_KIND_LABELS = {
+    fastest: 'Fastest check',
+    'shipped-signal': 'Shipped signal',
+    'regression-guard': 'Regression guard',
+    manual: 'Manual check',
+    test: 'Automated test',
+};
+const VERIFICATION_KIND_ORDER = ['fastest', 'shipped-signal', 'regression-guard', 'manual', 'test'];
+const VERIFICATION_KIND_SET = new Set(VERIFICATION_KIND_ORDER);
+/** Read verification uniformly as a check collection: canonical checks[] + adapted legacy buckets. */
+function toVerificationChecks(v) {
+    if (!v || typeof v !== 'object')
+        return [];
+    const out = [];
+    for (const c of Array.isArray(v.checks) ? v.checks : []) {
+        const description = typeof c?.description === 'string' ? c.description.trim() : '';
+        if (!description)
+            continue;
+        out.push({
+            kind: VERIFICATION_KIND_SET.has(c.kind) ? c.kind : 'test',
+            description,
+            status: c.status,
+            verifies: typeof c.verifies === 'string' && c.verifies.trim()
+                ? c.verifies.trim()
+                : undefined,
+        });
+    }
+    const legacy = [
+        [v.e2eTests, 'test'], [v.unitTests, 'test'], [v.manualChecks, 'manual'],
+    ];
+    for (const [arr, kind] of legacy) {
+        for (const s of arr ?? []) {
+            if (typeof s === 'string' && s.trim())
+                out.push({ kind, description: s.trim() });
+        }
+    }
+    return out;
+}
+/** Group verification into ordered, non-empty kind groups for rendering. */
+function groupVerificationChecks(v) {
+    const checks = toVerificationChecks(v);
+    return VERIFICATION_KIND_ORDER
+        .map((kind) => ({ kind, label: VERIFICATION_KIND_LABELS[kind], checks: checks.filter((c) => c.kind === kind) }))
+        .filter((g) => g.checks.length > 0);
+}
+/** A single check rendered as agent-facing text, annotated with its verdict and verifies target. */
+function renderCheckLine(c) {
+    const verifies = c.verifies ? ` (verifies: ${c.verifies})` : '';
+    const status = c.status && c.status !== 'unknown' ? ` [${c.status}]` : '';
+    return `${c.description}${verifies}${status}`;
+}
 /** Extract text from a string or structured outcome. */
 function getOutcomeText(o) {
     return typeof o === 'string' ? o : o.text;
@@ -34001,7 +34067,7 @@ WHEN THE SPEC FEELS READY AND ALL STATUS ITEMS ARE [X]:
 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\`
+4. Ask if they also want to export it as \`.cursorrules\`, \`CLAUDE.md\`, or \`AGENTS.md\` (Codex/Cursor) 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:
@@ -34015,13 +34081,26 @@ IMPORTANT:
   - edgeCases: { scenario: string, expectedBehavior: string }[] (optional)
   - healthMetrics: string[] (optional)
   - scope: { inScope?: string[], outOfScope?: string[] } (optional)
-  - verification: { manualChecks?: string[], unitTests?: string[], e2eTests?: string[] } (optional)
+  - verification: { checks?: { kind: 'fastest'|'shipped-signal'|'regression-guard'|'manual'|'test', description: string }[] } (optional) — verification is a feedback loop, not just tests: a fastest check (quickest signal it works), a shipped-signal (observable production signal it landed), a regression-guard (what must not break), plus manual/test as needed. Legacy { manualChecks?, unitTests?, e2eTests? } string arrays are still accepted.
 
 Now, start the conversation. If they haven't provided one yet, ask for the concrete evidence (quote, metric, or ticket) driving this work.`;
 }
 // ============================================================
 // Format: intent.md
 // ============================================================
+/** Text-only decisions lines for the local file formatters (local mode has no evidence store).
+ *  Defensive: skips entries missing a string choice/reason. Returns [] when none (incl. a leading
+ *  blank line for section spacing when present). */
+function decisionLines(decisions, heading) {
+    const valid = (decisions || []).filter(d => d && typeof d.choice === 'string' && d.choice.length > 0 && typeof d.reason === 'string');
+    if (valid.length === 0)
+        return [];
+    const lines = ['', heading];
+    for (const d of valid) {
+        lines.push(`- **${d.choice}**${d.ruledOut ? ` (instead of: ${d.ruledOut})` : ''} — ${d.reason}`);
+    }
+    return lines;
+}
 /**
  * Generate intent.md content with YAML frontmatter.
  * Adapted from lib/agentPromptGenerator.ts generateIntentMd().
@@ -34049,6 +34128,7 @@ function formatIntentMd(spec) {
         sections.push('## Objective');
         sections.push(spec.objective);
     }
+    sections.push(...decisionLines(spec.decisions, '## Decisions & Ruled-Out Alternatives'));
     if (spec.outcomes?.length) {
         sections.push('');
         sections.push('## Outcomes');
@@ -34091,27 +34171,15 @@ function formatIntentMd(spec) {
             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}`);
-            }
+    const intentMdChecks = groupVerificationChecks(spec.verification);
+    if (intentMdChecks.length) {
+        sections.push('');
+        sections.push('## Verification');
+        sections.push('_A feedback loop, not just a test list._');
+        for (const g of intentMdChecks) {
+            sections.push(`**${g.label}**:`);
+            for (const c of g.checks)
+                sections.push(`- [ ] ${renderCheckLine(c)}`);
         }
     }
     sections.push('');
@@ -34138,6 +34206,7 @@ function formatCursorRules(spec) {
         sections.push('# WHY');
         sections.push(spec.objective);
     }
+    sections.push(...decisionLines(spec.decisions, '# DECISIONS (already settled — do not relitigate)'));
     if (spec.outcomes?.length) {
         sections.push('');
         sections.push('# SUCCESS OUTCOMES');
@@ -34184,25 +34253,15 @@ function formatCursorRules(spec) {
             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}`);
-            }
+    const cursorChecks = groupVerificationChecks(spec.verification);
+    if (cursorChecks.length) {
+        sections.push('');
+        sections.push('# VERIFICATION');
+        sections.push('After implementation, verify (a feedback loop, not just tests):');
+        for (const g of cursorChecks) {
+            sections.push(`**${g.label}**:`);
+            for (const c of g.checks)
+                sections.push(`- ${renderCheckLine(c)}`);
         }
     }
     sections.push('');
@@ -34228,6 +34287,7 @@ function formatClaudeMdSection(spec) {
     if (spec.objective) {
         sections.push(`**Objective**: ${spec.objective}`);
     }
+    sections.push(...decisionLines(spec.decisions, '**Decisions**:'));
     if (spec.outcomes?.length) {
         sections.push('**Outcomes**:');
         sections.push(spec.outcomes.map(o => `- [ ] ${getPriorityLabel(o)}${getOutcomeText(o)}`).join('\n'));
@@ -34307,6 +34367,13 @@ function buildWriterDescription(spec) {
         sections.push('');
         sections.push(`Why this matters: ${spec.objective}`);
     }
+    const decisions = (spec.decisions || []).filter(d => d && typeof d.choice === 'string' && d.choice.length > 0 && typeof d.reason === 'string');
+    if (decisions.length > 0) {
+        sections.push('');
+        sections.push('Decisions already made (do not relitigate):');
+        for (const d of decisions)
+            sections.push(`- ${d.choice}${d.ruledOut ? ` (instead of: ${d.ruledOut})` : ''} — ${d.reason}`);
+    }
     if (spec.scope?.inScope?.length) {
         sections.push('');
         sections.push('In scope:');
@@ -34391,17 +34458,9 @@ function buildGraderRubric(spec, opts = {}) {
             sections.push(`- ${c}`);
     }
     // Verification → procedures the grader must run to produce evidence
-    const v = spec.verification;
     const checks = [];
-    for (const t of v?.e2eTests ?? [])
-        if (t?.trim())
-            checks.push(`[e2e] ${t}`);
-    for (const t of v?.unitTests ?? [])
-        if (t?.trim())
-            checks.push(`[unit] ${t}`);
-    for (const t of v?.manualChecks ?? [])
-        if (t?.trim())
-            checks.push(`[manual] ${t}`);
+    for (const c of toVerificationChecks(spec.verification))
+        checks.push(`[${c.kind}] ${renderCheckLine(c)}`);
     for (const t of spec.implementationContext?.verificationSuggestions ?? [])
         if (t?.trim())
             checks.push(`[suggested] ${t}`);
@@ -34443,11 +34502,7 @@ function formatOutcomeRubric(spec, opts = {}) {
     const maxIterations = opts.maxIterations ?? 5;
     const description = buildWriterDescription(spec);
     const rubric = buildGraderRubric(spec, opts);
-    const hasVerification = [
-        ...(spec.verification?.e2eTests ?? []),
-        ...(spec.verification?.unitTests ?? []),
-        ...(spec.verification?.manualChecks ?? []),
-    ].some((t) => t?.trim());
+    const hasVerification = toVerificationChecks(spec.verification).length > 0;
     const doc = [];
     doc.push('<!-- Pathmode → Claude Managed Agents: Outcomes rubric -->');
     doc.push(`<!-- Generated ${new Date().toISOString()} | pathmode.io -->`);
@@ -34677,6 +34732,58 @@ function extractVerification(body) {
 }
 
 
+/***/ }),
+
+/***/ 4681:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+/**
+ * Idempotent merge of a Pathmode-generated section into an existing agent-instructions file
+ * (CLAUDE.md / AGENTS.md). The section is wrapped in <!-- PATHMODE:START ... --> / <!-- PATHMODE:END -->
+ * markers (both the local formatClaudeMdSection and the cloud generateClaudeMdContent emit them),
+ * so re-running replaces the marked block in place instead of appending a duplicate. This is the
+ * no-drift guarantee of the round-trip: the repo's Pathmode context is regenerated from the
+ * canonical source, never hand-maintained.
+ */
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.mergePathmodeSection = mergePathmodeSection;
+/** Matches the whole PATHMODE block, tolerant of the suffixed start marker
+ *  (`<!-- PATHMODE:START - Do not edit... -->`). Not global — there is one block per file. */
+const PATHMODE_SECTION_RE = /<!-- PATHMODE:START[\s\S]*?-->[\s\S]*?<!-- PATHMODE:END -->/;
+/** The section embeds a volatile `_Generated at <timestamp>_` line. Strip it so a re-generated
+ *  section that differs ONLY by a fresher timestamp still compares equal (reports 'unchanged' →
+ *  caller skips the write → no noisy timestamp-only diff that would mask real drift). */
+const GENERATED_AT_RE = /^_Generated at .*$/m;
+const withoutTimestamp = (s) => s.replace(GENERATED_AT_RE, '');
+/**
+ * Merge `section` (a marker-wrapped Pathmode block) into `existing` file content.
+ * - empty file        -> the section becomes the whole file ('created')
+ * - has a PATHMODE block, byte-identical to `section` -> no change ('unchanged' — proven no drift)
+ * - has a PATHMODE block, different -> replace it in place ('replaced')
+ * - no PATHMODE block  -> append it after the existing content ('appended')
+ * Pure; callers decide whether to actually write (skip the write when 'unchanged').
+ */
+function mergePathmodeSection(existing, section) {
+    if (!existing)
+        return { content: section, action: 'created' };
+    const match = existing.match(PATHMODE_SECTION_RE);
+    if (match) {
+        if (withoutTimestamp(match[0]) === withoutTimestamp(section)) {
+            return { content: existing, action: 'unchanged' };
+        }
+        // Replacer FUNCTION, not a string: `section` may contain `$&`, `$$`, `` $` ``, `$'`, `$1`
+        // (a user's spec text), which String.replace would otherwise interpret as special patterns
+        // and corrupt the merged file. The function form substitutes `section` verbatim.
+        return { content: existing.replace(PATHMODE_SECTION_RE, () => section), action: 'replaced' };
+    }
+    // No existing block: append, separated by a blank line, normalizing trailing whitespace so
+    // re-runs stay stable (the next run finds the marker and replaces in place).
+    return { content: `${existing.replace(/\s*$/, '')}\n\n${section}\n`, action: 'appended' };
+}
+
+
 /***/ }),
 
 /***/ 8294:
@@ -34715,7 +34822,9 @@ function claudeDesktopPaths() {
     return [path_1.default.join(os_1.default.homedir(), '.config', 'Claude', 'claude_desktop_config.json')];
 }
 function claudeCodePaths() {
-    return [path_1.default.join(os_1.default.homedir(), '.claude', 'settings.json')];
+    // Claude Code reads project-scoped MCP servers from .mcp.json in the
+    // project root — not from .claude/settings.json or ~/.claude/settings.json.
+    return [path_1.default.join(process.cwd(), '.mcp.json')];
 }
 function cursorPaths() {
     return [path_1.default.join(os_1.default.homedir(), '.cursor', 'mcp.json')];
@@ -34731,7 +34840,7 @@ function windsurfPaths() {
     return [path_1.default.join(os_1.default.homedir(), '.codeium', 'windsurf', 'mcp_config.json')];
 }
 const TOOLS = [
-    { name: 'Claude Code', paths: claudeCodePaths, configKey: 'mcpServers' },
+    { name: 'Claude Code', paths: claudeCodePaths, configKey: 'mcpServers', omitApiKey: true },
     { name: 'Claude Desktop', paths: claudeDesktopPaths, configKey: 'mcpServers' },
     { name: 'Cursor', paths: cursorPaths, configKey: 'mcpServers' },
     { name: 'Windsurf', paths: windsurfPaths, configKey: 'mcpServers' },
@@ -34748,7 +34857,13 @@ function log(msg) { console.log(msg); }
 function success(msg) { console.log(`  ${GREEN}✓${RESET} ${msg}`); }
 function warn(msg) { console.log(`  ${YELLOW}!${RESET} ${msg}`); }
 function fail(msg) { console.log(`  ${RED}✗${RESET} ${msg}`); }
-function getMcpServerBlock(apiKey) {
+function getMcpServerBlock(apiKey, omitApiKey) {
+    if (omitApiKey) {
+        return {
+            command: 'npx',
+            args: ['@pathmode/mcp-server'],
+        };
+    }
     return {
         command: 'npx',
         args: ['@pathmode/mcp-server'],
@@ -34862,7 +34977,7 @@ async function runSetup() {
         const existingPath = possiblePaths.find(p => fs_1.default.existsSync(p));
         const configPath = existingPath || possiblePaths[0];
         // Only configure if the tool's config dir exists (tool is installed)
-        // Exception: Claude Code — always configure since ~/.claude/ may not exist yet
+        // Exception: Claude Code — its .mcp.json lives in the project root, so always configure
         const configDir = path_1.default.dirname(configPath);
         const toolInstalled = tool.name === 'Claude Code' || fs_1.default.existsSync(configDir);
         if (!toolInstalled) {
@@ -34889,7 +35004,7 @@ async function runSetup() {
         if (!config[tool.configKey]) {
             config[tool.configKey] = {};
         }
-        config[tool.configKey].pathmode = getMcpServerBlock(apiKey);
+        config[tool.configKey].pathmode = getMcpServerBlock(apiKey, tool.omitApiKey);
         if (writeJsonSafe(configPath, config)) {
             success(`${tool.name} → ${DIM}${shortenPath(configPath)}${RESET}`);
             configured++;
@@ -34911,7 +35026,7 @@ async function runSetup() {
     if (configured === 0) {
         log(`${YELLOW}No supported tools detected.${RESET} Add manually:`);
         log('');
-        log(`  ${DIM}// .claude/settings.json, ~/.cursor/mcp.json, or claude_desktop_config.json${RESET}`);
+        log(`  ${DIM}// .mcp.json (project root), ~/.cursor/mcp.json, or claude_desktop_config.json${RESET}`);
         log(`  ${CYAN}{${RESET}`);
         log(`  ${CYAN}  "mcpServers": {${RESET}`);
         log(`  ${CYAN}    "pathmode": {${RESET}`);
@@ -35020,6 +35135,14 @@ module.exports = require("net");
 
 /***/ }),
 
+/***/ 7598:
+/***/ ((module) => {
+
+"use strict";
+module.exports = require("node:crypto");
+
+/***/ }),
+
 /***/ 8474:
 /***/ ((module) => {
 
@@ -64494,6 +64617,14 @@ module.exports = /*#__PURE__*/JSON.parse('{"$id":"https://raw.githubusercontent.
 "use strict";
 module.exports = /*#__PURE__*/JSON.parse('{"$schema":"http://json-schema.org/draft-07/schema#","$id":"http://json-schema.org/draft-07/schema#","title":"Core schema meta-schema","definitions":{"schemaArray":{"type":"array","minItems":1,"items":{"$ref":"#"}},"nonNegativeInteger":{"type":"integer","minimum":0},"nonNegativeIntegerDefault0":{"allOf":[{"$ref":"#/definitions/nonNegativeInteger"},{"default":0}]},"simpleTypes":{"enum":["array","boolean","integer","null","number","object","string"]},"stringArray":{"type":"array","items":{"type":"string"},"uniqueItems":true,"default":[]}},"type":["object","boolean"],"properties":{"$id":{"type":"string","format":"uri-reference"},"$schema":{"type":"string","format":"uri"},"$ref":{"type":"string","format":"uri-reference"},"$comment":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"default":true,"readOnly":{"type":"boolean","default":false},"examples":{"type":"array","items":true},"multipleOf":{"type":"number","exclusiveMinimum":0},"maximum":{"type":"number"},"exclusiveMaximum":{"type":"number"},"minimum":{"type":"number"},"exclusiveMinimum":{"type":"number"},"maxLength":{"$ref":"#/definitions/nonNegativeInteger"},"minLength":{"$ref":"#/definitions/nonNegativeIntegerDefault0"},"pattern":{"type":"string","format":"regex"},"additionalItems":{"$ref":"#"},"items":{"anyOf":[{"$ref":"#"},{"$ref":"#/definitions/schemaArray"}],"default":true},"maxItems":{"$ref":"#/definitions/nonNegativeInteger"},"minItems":{"$ref":"#/definitions/nonNegativeIntegerDefault0"},"uniqueItems":{"type":"boolean","default":false},"contains":{"$ref":"#"},"maxProperties":{"$ref":"#/definitions/nonNegativeInteger"},"minProperties":{"$ref":"#/definitions/nonNegativeIntegerDefault0"},"required":{"$ref":"#/definitions/stringArray"},"additionalProperties":{"$ref":"#"},"definitions":{"type":"object","additionalProperties":{"$ref":"#"},"default":{}},"properties":{"type":"object","additionalProperties":{"$ref":"#"},"default":{}},"patternProperties":{"type":"object","additionalProperties":{"$ref":"#"},"propertyNames":{"format":"regex"},"default":{}},"dependencies":{"type":"object","additionalProperties":{"anyOf":[{"$ref":"#"},{"$ref":"#/definitions/stringArray"}]}},"propertyNames":{"$ref":"#"},"const":true,"enum":{"type":"array","items":true,"minItems":1,"uniqueItems":true},"type":{"anyOf":[{"$ref":"#/definitions/simpleTypes"},{"type":"array","items":{"$ref":"#/definitions/simpleTypes"},"minItems":1,"uniqueItems":true}]},"format":{"type":"string"},"contentMediaType":{"type":"string"},"contentEncoding":{"type":"string"},"if":{"$ref":"#"},"then":{"$ref":"#"},"else":{"$ref":"#"},"allOf":{"$ref":"#/definitions/schemaArray"},"anyOf":{"$ref":"#/definitions/schemaArray"},"oneOf":{"$ref":"#/definitions/schemaArray"},"not":{"$ref":"#"}},"default":true}');
 
+/***/ }),
+
+/***/ 8330:
+/***/ ((module) => {
+
+"use strict";
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@pathmode/mcp-server","version":"1.8.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":"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"}}');
+
 /***/ })
 
 /******/ 	});
@@ -64554,7 +64685,7 @@ var exports = __webpack_exports__;
  * 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:
+ * Add to .mcp.json in the project root:
  *   {
  *     "mcpServers": {
  *       "pathmode": {
@@ -64587,8 +64718,13 @@ 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 pathmode_section_1 = __nccwpck_require__(4681);
 const setup_1 = __nccwpck_require__(8294);
 const install_skills_1 = __nccwpck_require__(3783);
+// 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
 // and must run before StdioServerTransport claims stdout for JSON-RPC.
@@ -64628,7 +64764,7 @@ function startMcpServer() {
     // ============================================================
     const server = new mcp_js_1.McpServer({
         name: 'pathmode',
-        version: '1.4.5',
+        version: SERVER_VERSION,
     });
     // Annotation presets
     const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -64646,6 +64782,22 @@ function startMcpServer() {
     function normalizeText(value) {
         return (value || '').trim();
     }
+    // Clamp a caller-supplied write path to the project root (process.cwd()).
+    // The optional `path` argument on intent_save / intent_export is influenced by
+    // the MCP client, so an absolute path or `..` segments could otherwise land a
+    // file outside the intended project folder. Reject those before any fs write.
+    function resolveWithinProject(requestedPath) {
+        const root = process.cwd();
+        if ((0, path_1.isAbsolute)(requestedPath)) {
+            throw new Error(`Refusing to write outside the project: "${requestedPath}" is an absolute path. Pass a path relative to the project root.`);
+        }
+        const resolved = (0, path_1.resolve)(root, requestedPath);
+        const rel = (0, path_1.relative)(root, resolved);
+        if (rel === '' || rel.startsWith('..') || (0, path_1.isAbsolute)(rel)) {
+            throw new Error(`Refusing to write outside the project: "${requestedPath}" resolves outside the project root.`);
+        }
+        return resolved;
+    }
     // Keep this selection heuristic aligned with the canonical readiness rules in
     // /Users/jannelammi/code/Pathmode/lib/intentReadiness.ts. The MCP package cannot
     // import app/lib code directly, so this mirrors only the minimum logic needed
@@ -64665,6 +64817,24 @@ function startMcpServer() {
             return anyReady;
         return intents[0];
     }
+    /** The union of evidence IDs an intent cites: directly linked + section anchors + decision-cited.
+     *  Mirrors lib/intentSpecHelpers.collectSpecEvidenceIds (the MCP package can't import app/lib). */
+    function collectCitedEvidenceIds(intent) {
+        const anchorIds = Object.values((intent?.evidenceAnchors || {})).flat();
+        const decisionIds = (intent?.decisions || []).flatMap((d) => d?.evidenceIds || []);
+        const all = [...(intent?.evidenceIds || []), ...anchorIds, ...decisionIds];
+        return Array.from(new Set(all.filter((id) => typeof id === 'string' && id.length > 0)));
+    }
+    /** Cheap, fetch-free coverage summary from the intent's own fields. Tells an agent how much
+     *  evidence backs the intent and where to get the full text, without bloating the default call. */
+    function summarizeCitedEvidence(intent) {
+        return {
+            citedCount: collectCitedEvidenceIds(intent).length,
+            linkedCount: (intent?.evidenceIds || []).length,
+            anchoredSections: Object.keys(intent?.evidenceAnchors || {}).length,
+            note: 'Evidence is referenced by ID. Call get_agent_prompt for the full evidence-backed execution prompt, or re-call get_current_intent with include_evidence=true to inline the evidence content.',
+        };
+    }
     // Note: The MCP SDK catches errors thrown in tool handlers and returns them as
     // error text results. CloudClientError thrown by requireCloudClient() will
     // surface its message to the client without crashing the server.
@@ -64673,10 +64843,13 @@ function startMcpServer() {
     // ============================================================
     server.registerTool('get_current_intent', {
         title: 'Get Current Intent',
-        description: 'Get the currently active intent, preferring approved intents with real objective/outcome content over empty stubs. Returns the full IntentSpec with objective, outcomes, constraints, and edge cases.',
-        inputSchema: { status: zod_1.z.string().optional().describe('Filter by status: draft, validated, approved, shipped, verified') },
+        description: 'Get the currently active intent, preferring approved intents with real objective/outcome content over empty stubs. Returns the full IntentSpec plus an evidenceSummary (how much user evidence backs it). Evidence is referenced by ID; pass include_evidence=true to inline the evidence content, or call get_agent_prompt for the full evidence-backed execution prompt.',
+        inputSchema: {
+            status: zod_1.z.string().optional().describe('Filter by status: draft, validated, approved, shipped, verified'),
+            include_evidence: zod_1.z.boolean().optional().describe('Inline the actual evidence items (truncated) this intent cites. Default false — the default response carries only a fetch-free evidenceSummary to keep casual calls cheap.'),
+        },
         annotations: READ_ONLY,
-    }, async ({ status }) => {
+    }, async ({ status, include_evidence }) => {
         if (isLocalMode) {
             const intents = (0, local_reader_1.readLocalIntents)();
             const filtered = status ? intents.filter(i => i.status === status) : intents;
@@ -64684,18 +64857,47 @@ function startMcpServer() {
             if (!current) {
                 return { content: [{ type: 'text', text: 'No intents found locally.' }] };
             }
+            // Local mode has no cloud evidence store — return the intent as-is.
             return { content: [{ type: 'text', text: JSON.stringify(current, null, 2) }] };
         }
         const cloud = requireCloudClient();
-        const intents = await cloud.listIntents(status || 'approved');
+        let intents = await cloud.listIntents(status || 'approved');
         if (intents.length === 0) {
-            const allIntents = await cloud.listIntents();
-            if (allIntents.length === 0) {
+            intents = await cloud.listIntents();
+            if (intents.length === 0) {
                 return { content: [{ type: 'text', text: 'No intents found in workspace.' }] };
             }
-            return { content: [{ type: 'text', text: JSON.stringify(pickCurrentIntent(allIntents), null, 2) }] };
         }
-        return { content: [{ type: 'text', text: JSON.stringify(pickCurrentIntent(intents), null, 2) }] };
+        const current = pickCurrentIntent(intents);
+        // Default: a fetch-free coverage summary (no extra API call). On request: the cited
+        // evidence content, fetched once for the product and filtered to this intent's citations.
+        const evidenceSummary = summarizeCitedEvidence(current);
+        let evidence;
+        let unresolvedEvidenceIds;
+        if (include_evidence && current?.productId) {
+            const cited = collectCitedEvidenceIds(current);
+            if (cited.length > 0) {
+                // Pull up to the API max (200) and filter to this intent's citations. A cited item
+                // older than that page won't resolve — surface it as unresolvedEvidenceIds rather
+                // than silently returning an incomplete evidence block.
+                const { evidence: pool } = await cloud.queryEvidence({ productId: current.productId, limit: 200 });
+                const found = new Map(pool.map(e => [e.id, e]));
+                evidence = cited
+                    .map(id => found.get(id))
+                    .filter((e) => !!e)
+                    .map(e => ({
+                    id: e.id,
+                    type: e.type,
+                    content: e.content.length > 200 ? `${e.content.slice(0, 200)}…` : e.content,
+                    source: e.source,
+                    severity: e.severity,
+                }));
+                const missing = cited.filter(id => !found.has(id));
+                if (missing.length > 0)
+                    unresolvedEvidenceIds = missing;
+            }
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ ...current, evidenceSummary, ...(evidence ? { evidence } : {}), ...(unresolvedEvidenceIds ? { unresolvedEvidenceIds } : {}) }, null, 2) }] };
     });
     server.registerTool('list_intents', {
         title: 'List Intents',
@@ -64724,7 +64926,7 @@ function startMcpServer() {
     });
     server.registerTool('get_intent', {
         title: 'Get Intent',
-        description: 'Get a single intent by ID with full details including objective, outcomes, constraints, edge cases, and relations.',
+        description: 'Get a single intent by ID with full details including objective, outcomes, constraints, edge cases, and relations. Evidence is referenced by ID; call get_agent_prompt for the full evidence-backed execution prompt.',
         inputSchema: { intentId: zod_1.z.string().describe('The intent ID to fetch') },
         annotations: READ_ONLY,
     }, async ({ intentId }) => {
@@ -64993,27 +65195,29 @@ function startMcpServer() {
     });
     /** Map a cloud ApiIntent into the IntentFields shape the formatters consume. */
     function apiIntentToFields(intent) {
-        const v = (intent.verification || {});
         return {
             id: intent.id,
             title: intent.title,
             objective: intent.objective,
             outcomes: intent.outcomes ?? [],
+            decisions: intent.decisions,
             constraints: intent.constraints,
             edgeCases: (intent.edgeCases ?? []).map((e) => ({ scenario: e.scenario, expectedBehavior: e.expectedBehavior })),
             healthMetrics: intent.healthMetrics,
             scope: intent.scope,
-            verification: { manualChecks: v.manualChecks, unitTests: v.unitTests, e2eTests: v.e2eTests },
+            // Pass the whole verification through (checks[] + legacy buckets) so feedback-loop checks
+            // survive the cloud→local bridge; the formatters adapt both shapes uniformly.
+            verification: (intent.verification || undefined),
             implementationContext: intent.implementationContext ?? undefined,
         };
     }
     server.registerTool('export_context', {
         title: 'Export Context',
-        description: 'Export workspace context as a formatted file. Use "claude-md" for CLAUDE.md (full workspace context), "cursorrules" for Cursor AI rules, "intent-md" for a single intent specification file, or "outcome-rubric" for a Claude Managed Agents Outcomes rubric (writer description + evidence-forcing grader rubric) derived from the resolved intent, its implementation context, and the workspace constitution. For cursorrules/intent-md/outcome-rubric, product context is always derived from the resolved intent. For claude-md, pass productId to select a specific product, otherwise the first active product is used.',
+        description: 'Export workspace context as a formatted file. Use "claude-md" for CLAUDE.md (full workspace context), "agents-md" for the same workspace context written for AGENTS.md (the native instruction file for OpenAI Codex and modern Cursor), "cursorrules" for Cursor AI rules, "intent-md" for a single intent specification file, or "outcome-rubric" for a Claude Managed Agents Outcomes rubric (writer description + evidence-forcing grader rubric) derived from the resolved intent, its implementation context, and the workspace constitution. claude-md and agents-md produce identical, agent-agnostic content (the difference is only the target filename). For cursorrules/intent-md/outcome-rubric, product context is always derived from the resolved intent. For claude-md/agents-md, pass productId to select a specific product, otherwise the first active product is used.',
         inputSchema: {
-            format: zod_1.z.enum(['claude-md', 'cursorrules', 'intent-md', 'outcome-rubric']).describe('Export format'),
+            format: zod_1.z.enum(['claude-md', 'agents-md', 'cursorrules', 'intent-md', 'outcome-rubric']).describe('Export format'),
             intentId: zod_1.z.string().optional().describe('Intent ID (optional, for cursorrules and intent-md)'),
-            productId: zod_1.z.string().optional().describe('Product ID (optional, only used for claude-md format to select a specific product)'),
+            productId: zod_1.z.string().optional().describe('Product ID (optional, only used for claude-md/agents-md format to select a specific product)'),
         },
         annotations: READ_ONLY,
     }, async ({ format, intentId, productId }) => {
@@ -65047,6 +65251,41 @@ function startMcpServer() {
             return { content: [{ type: 'text', text: `Export failed: ${e.message}` }] };
         }
     });
+    server.tool('sync_context', 'Write this workspace\'s canonical Pathmode context into the repo\'s CLAUDE.md (or AGENTS.md), idempotently — the round-trip. Pulls the latest from Pathmode and replaces the PATHMODE-marked section in place, so the repo\'s agent instructions never drift from the source of truth. Unlike export_context (which returns the text for you to read), this writes the file; re-running when nothing changed reports "no drift". Run it after the canonical context changes in Pathmode.', {
+        format: zod_1.z.enum(['claude-md', 'agents-md']).optional().describe('Target file: claude-md → CLAUDE.md (default), agents-md → AGENTS.md (Codex and other AGENTS.md-aware agents).'),
+        productId: zod_1.z.string().optional().describe('Product ID (optional; defaults to the first active product).'),
+        path: zod_1.z.string().optional().describe('Output file path relative to the project root. Must stay inside the project (absolute paths and ".." are rejected). Defaults to CLAUDE.md / AGENTS.md.'),
+    }, async ({ format, productId, path }) => {
+        if (isLocalMode) {
+            return { content: [{ type: 'text', text: 'Sync requires cloud mode. Use PATHMODE_API_KEY to connect.' }] };
+        }
+        const fmt = format || 'claude-md';
+        try {
+            // Pull the canonical, marker-wrapped section from the cloud (generateClaudeMdContent emits
+            // the same <!-- PATHMODE:START/END --> markers the merge keys on).
+            const section = await requireCloudClient().exportContext(fmt, undefined, productId);
+            const defaultFile = fmt === 'agents-md' ? 'AGENTS.md' : 'CLAUDE.md';
+            const filePath = resolveWithinProject(path || defaultFile);
+            let existing = '';
+            try {
+                existing = (0, fs_1.readFileSync)(filePath, 'utf-8');
+            }
+            catch { /* file doesn't exist yet */ }
+            const merged = (0, pathmode_section_1.mergePathmodeSection)(existing, section);
+            if (merged.action !== 'unchanged')
+                (0, fs_1.writeFileSync)(filePath, merged.content, 'utf-8');
+            const msg = {
+                unchanged: `✓ ${filePath} is already in sync with Pathmode — no drift.`,
+                created: `✓ Created ${filePath} from your Pathmode context.`,
+                appended: `✓ Added the Pathmode context section to ${filePath}.`,
+                replaced: `✓ Synced ${filePath} — refreshed the Pathmode context section from canonical.`,
+            };
+            return { content: [{ type: 'text', text: msg[merged.action] }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Sync failed: ${e.message}` }] };
+        }
+    });
     server.registerTool('get_agent_prompt', {
         title: 'Get Agent Prompt',
         description: 'Get a formatted execution prompt for a specific intent. This is the full structured prompt including objective, outcomes, constraints, edge cases, and verification steps.',
@@ -65151,6 +65390,31 @@ function startMcpServer() {
                 }]
         };
     });
+    server.registerTool('record_implementation_finding', {
+        title: 'Record Implementation Finding',
+        description: 'Write a correction back to an intent when BUILDING it revealed the spec was wrong. Use this the moment you discover the spec assumed something the implementation contradicts — instead of only fixing it in your head or this chat, record it so the NEXT agent or person inherits the correction. This is the inverse of a decision: it closes the refinement loop so the same stale premise is not rebuilt. Open findings ride into future agent prompts until a human reconciles them into the spec.',
+        inputSchema: {
+            intentId: zod_1.z.string().describe('The intent ID whose spec the finding is about'),
+            assumption: zod_1.z.string().describe('What the spec assumed or said before you built it'),
+            finding: zod_1.z.string().describe('What building it actually revealed — the fact that contradicts the assumption'),
+            target: zod_1.z.string().optional().describe('Which part of the spec this contradicts: "objective", "outcome:<id>", "constraint:<index>", "edgeCase:<id>", "check:<id>" (a verification check — recording this flips that check to failing), or plain prose'),
+            correction: zod_1.z.string().optional().describe('Your proposed correction to the intent, if you have one'),
+            source: zod_1.z.string().optional().describe('Where this came from, e.g. "claude-code @ owner/repo" — provenance for the audit trail'),
+        },
+        annotations: WRITE_OP,
+    }, async ({ intentId, assumption, finding, target, correction, source }) => {
+        if (isLocalMode) {
+            return { content: [{ type: 'text', text: 'Recording findings requires cloud mode. Use PATHMODE_API_KEY to connect.' }] };
+        }
+        const result = await requireCloudClient().recordFinding(intentId, { assumption, finding, target, correction, source });
+        const openCount = result?.openCount;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Finding recorded for intent ${intentId}. The next agent that pulls this intent will see it flagged as unreconciled until a human folds it into the spec.${typeof openCount === 'number' ? ` Open findings now: ${openCount}.` : ''}`
+                }]
+        };
+    });
     server.registerTool('create_intent', {
         title: 'Create Intent',
         description: 'Create a new intent spec in the workspace. Requires at minimum a title, objective, and productId. Returns the created intent with its ID. Use list_intents first to see existing intents and avoid duplicates.',
@@ -65166,6 +65430,12 @@ function startMcpServer() {
                 expectedBehavior: zod_1.z.string(),
             })).optional().describe('Failure modes and boundary conditions'),
             verification: zod_1.z.object({
+                checks: zod_1.z.array(zod_1.z.object({
+                    kind: zod_1.z.enum(['fastest', 'manual', 'shipped-signal', 'regression-guard', 'test']),
+                    description: zod_1.z.string(),
+                    status: zod_1.z.enum(['unknown', 'passing', 'failing']).optional(),
+                    verifies: zod_1.z.string().optional(),
+                })).optional().describe('Feedback-loop checks (preferred over the legacy test buckets)'),
                 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(),
@@ -65200,6 +65470,12 @@ function startMcpServer() {
                 expectedBehavior: zod_1.z.string(),
             })).optional().describe('Replace all edge cases'),
             verification: zod_1.z.object({
+                checks: zod_1.z.array(zod_1.z.object({
+                    kind: zod_1.z.enum(['fastest', 'manual', 'shipped-signal', 'regression-guard', 'test']),
+                    description: zod_1.z.string(),
+                    status: zod_1.z.enum(['unknown', 'passing', 'failing']).optional(),
+                    verifies: zod_1.z.string().optional(),
+                })).optional().describe('Feedback-loop checks (preferred over the legacy test buckets)'),
                 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(),
@@ -65382,6 +65658,11 @@ function startMcpServer() {
         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'),
+        decisions: zod_1.z.array(zod_1.z.object({
+            choice: zod_1.z.string(),
+            ruledOut: zod_1.z.string().optional(),
+            reason: zod_1.z.string(),
+        })).optional().describe('Decisions settled during design + the alternatives ruled out, so the agent does not relitigate them'),
         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(),
@@ -65393,6 +65674,12 @@ function startMcpServer() {
             outOfScope: zod_1.z.array(zod_1.z.string()).optional().describe('What is explicitly out of scope'),
         }).optional().describe('Scope boundaries — what to build and what to avoid'),
         verification: zod_1.z.object({
+            checks: zod_1.z.array(zod_1.z.object({
+                kind: zod_1.z.enum(['fastest', 'manual', 'shipped-signal', 'regression-guard', 'test']),
+                description: zod_1.z.string(),
+                status: zod_1.z.enum(['unknown', 'passing', 'failing']).optional(),
+                verifies: zod_1.z.string().optional(),
+            })).optional().describe('Feedback-loop checks (preferred over the legacy test buckets)'),
             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(),
@@ -65411,9 +65698,9 @@ function startMcpServer() {
     });
     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'),
+        path: zod_1.z.string().optional().describe('File path relative to the project root. Must stay inside the project (absolute paths and ".." are rejected). Defaults to intent.md'),
     }, async ({ spec, path }) => {
-        const filePath = (0, path_1.resolve)(process.cwd(), path || 'intent.md');
+        const filePath = resolveWithinProject(path || 'intent.md');
         const content = (0, intent_compiler_1.formatIntentMd)({ ...spec, id: `intent_${Date.now()}` });
         (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
         return {
@@ -65423,14 +65710,14 @@ function startMcpServer() {
                 }],
         };
     });
-    server.tool('intent_export', 'Export an intent spec as .cursorrules, a CLAUDE.md section, or a Claude Managed Agents Outcomes rubric for AI agent consumption.', {
-        format: zod_1.z.enum(['cursorrules', 'claude-md', 'outcome-rubric']).describe('Export format'),
+    server.tool('intent_export', 'Export an intent spec as .cursorrules, a CLAUDE.md or AGENTS.md section, or a Claude Managed Agents Outcomes rubric for AI agent consumption. Use agents-md for Codex, Cursor, and other AGENTS.md-aware agents.', {
+        format: zod_1.z.enum(['cursorrules', 'claude-md', 'agents-md', 'outcome-rubric']).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'),
+        path: zod_1.z.string().optional().describe('Output file path relative to the project root. Must stay inside the project (absolute paths and ".." are rejected). Defaults to .cursorrules, CLAUDE.md, or AGENTS.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');
+            const filePath = resolveWithinProject(path || '.cursorrules');
             (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
             return {
                 content: [{
@@ -65441,7 +65728,7 @@ function startMcpServer() {
         }
         else if (format === 'outcome-rubric') {
             const content = (0, intent_compiler_1.formatOutcomeRubric)(spec);
-            const filePath = (0, path_1.resolve)(process.cwd(), path || 'outcome-rubric.md');
+            const filePath = resolveWithinProject(path || 'outcome-rubric.md');
             (0, fs_1.writeFileSync)(filePath, content, 'utf-8');
             return {
                 content: [{
@@ -65452,25 +65739,25 @@ function startMcpServer() {
         }
         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
+            const defaultFile = format === 'agents-md' ? 'AGENTS.md' : 'CLAUDE.md';
+            const filePath = resolveWithinProject(path || defaultFile);
             let existing = '';
             try {
                 existing = (0, fs_1.readFileSync)(filePath, 'utf-8');
             }
             catch { /* file doesn't exist yet */ }
-            // Tolerant of the suffixed start marker emitted by formatClaudeMdSection
-            // (`<!-- PATHMODE:START - Do not edit... -->`), so re-exports replace
-            // the block instead of appending a duplicate.
-            const marker = /<!-- PATHMODE:START[\s\S]*?-->[\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');
+            const merged = (0, pathmode_section_1.mergePathmodeSection)(existing, section);
+            if (merged.action !== 'unchanged')
+                (0, fs_1.writeFileSync)(filePath, merged.content, 'utf-8');
+            const audience = format === 'agents-md'
+                ? 'Codex, Cursor, and other AGENTS.md-aware agents'
+                : 'Claude Code';
             return {
                 content: [{
                         type: 'text',
-                        text: `✓ Exported CLAUDE.md section to ${filePath}\n\nClaude Code will now see this intent as context in every conversation.`,
+                        text: merged.action === 'unchanged'
+                            ? `✓ ${filePath} already has this intent's context — no change.`
+                            : `✓ Exported ${defaultFile} section to ${filePath}\n\n${audience} will now see this intent as context in every conversation.`,
                     }],
             };
         }

package/dist/intent-compiler.d.ts

@@ -8,6 +8,23 @@
  * 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 IntentDecision {
+    id?: string;
+    choice: string;
+    ruledOut?: string;
+    reason: string;
+    evidenceIds?: string[];
+    resolvedAt?: number;
+}
+export type VerificationCheckKind = 'fastest' | 'manual' | 'shipped-signal' | 'regression-guard' | 'test';
+export type VerificationCheckStatus = 'unknown' | 'passing' | 'failing';
+export interface VerificationCheck {
+    id?: string;
+    kind: VerificationCheckKind;
+    description: string;
+    status?: VerificationCheckStatus;
+    verifies?: string;
+}
 export interface IntentFields {
     id?: string;
     title: string;
@@ -17,6 +34,8 @@ export interface IntentFields {
         text: string;
         priority?: 'must' | 'should' | 'could';
     })[];
+    /** Decision log — choices settled + alternatives ruled out (text only; local mode has no evidence store). */
+    decisions?: IntentDecision[];
     constraints?: string[];
     edgeCases?: {
         scenario: string;
@@ -28,6 +47,9 @@ export interface IntentFields {
         outOfScope?: string[];
     };
     verification?: {
+        /** Canonical feedback-loop check collection (fastest / shipped-signal / regression-guard / manual / test). */
+        checks?: VerificationCheck[];
+        /** Legacy buckets — adapted to checks on read. */
         manualChecks?: string[];
         unitTests?: string[];
         e2eTests?: string[];

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":"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,CAAC,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;KAAE,CAAC,EAAE,CAAC;IAC7F,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,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtD,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;IACF;sFACkF;IAClF,qBAAqB,CAAC,EAAE;QACpB,aAAa,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACnD,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;KACtC,GAAG,IAAI,CAAC;CACZ;AAwDD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA2D/C;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA+FzD;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAwF5D;AAOD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAsDhE;AAOD,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AA6KD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAuC/F"}
+{"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/pathmode-section.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Idempotent merge of a Pathmode-generated section into an existing agent-instructions file
+ * (CLAUDE.md / AGENTS.md). The section is wrapped in <!-- PATHMODE:START ... --> / <!-- PATHMODE:END -->
+ * markers (both the local formatClaudeMdSection and the cloud generateClaudeMdContent emit them),
+ * so re-running replaces the marked block in place instead of appending a duplicate. This is the
+ * no-drift guarantee of the round-trip: the repo's Pathmode context is regenerated from the
+ * canonical source, never hand-maintained.
+ */
+export type PathmodeMergeAction = 'created' | 'replaced' | 'appended' | 'unchanged';
+export interface PathmodeMergeResult {
+    content: string;
+    action: PathmodeMergeAction;
+}
+/**
+ * Merge `section` (a marker-wrapped Pathmode block) into `existing` file content.
+ * - empty file        -> the section becomes the whole file ('created')
+ * - has a PATHMODE block, byte-identical to `section` -> no change ('unchanged' — proven no drift)
+ * - has a PATHMODE block, different -> replace it in place ('replaced')
+ * - no PATHMODE block  -> append it after the existing content ('appended')
+ * Pure; callers decide whether to actually write (skip the write when 'unchanged').
+ */
+export declare function mergePathmodeSection(existing: string, section: string): PathmodeMergeResult;

package/dist/pathmode-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/pathmode-section.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAiB3F"}

package/dist/pathmode-section.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/pathmode-section.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/pathmode-section.test.ts"],"names":[],"mappings":""}

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiHH,wBAAgB,YAAY,CAAC,IAAI,WAAe,GAAG,MAAM,EAAE,CAG1D;AAED,wBAAgB,cAAc,CAAC,IAAI,WAAe,GAAG,OAAO,CAE3D;AAID,wBAAsB,QAAQ,kBAsJ7B"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/jannelammi/code/Pathmode/packages/mcp-server/src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0HH,wBAAgB,YAAY,CAAC,IAAI,WAAe,GAAG,MAAM,EAAE,CAG1D;AAED,wBAAgB,cAAc,CAAC,IAAI,WAAe,GAAG,OAAO,CAE3D;AAID,wBAAsB,QAAQ,kBAsJ7B"}

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "pathmode",
   "display_name": "Pathmode",
-  "version": "1.5.0",
+  "version": "1.7.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": {

package/package.json

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