@pathmode/mcp-server 1.7.0 → 1.8.0

package/README.md

@@ -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
 
@@ -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;
@@ -236,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":"AAAA;;;GAGG;AAQH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,qBAAqB,CAAC,EAAE;QACpB,aAAa,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAClD,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACxC,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,uBAAuB,EAAE,MAAM,EAAE,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE;YAAE,QAAQ,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/E,mBAAmB,EAAE,MAAM,CAAC;KAC/B,GAAG,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1L,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1L,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;KACrC,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,iBAAiB,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;QACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACP;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAKD,wBAAgB,UAAU,IAAI,cAAc,GAAG,IAAI,CAmBlD;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,cAAc;YAMpB,KAAK;IAqBb,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOlD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKzC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,SAAgB,EAAE,IAAI,SAAY,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAKnH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1D,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,qBAAqB,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC7D,0BAA0B,CAAC,EAAE,MAAM,CAAC;KACvC,CAAC;IAQI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAQrE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC;IAQxE,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAKrC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAK/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKjC,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtI,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ1D,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQxE,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAU/F,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQhE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ/I,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQtH"}

package/dist/index.js

@@ -33626,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();
@@ -33912,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;
@@ -34023,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().
@@ -34057,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');
@@ -34099,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('');
@@ -34146,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');
@@ -34192,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('');
@@ -34236,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'));
@@ -34315,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:');
@@ -34399,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}`);
@@ -34451,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 -->`);
@@ -34685,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:
@@ -64524,7 +64623,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"$schema":"http://json-schema.org/dra
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@pathmode/mcp-server","version":"1.7.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"}}');
+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"}}');
 
 /***/ })
 
@@ -64619,6 +64718,7 @@ 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
@@ -64682,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
@@ -64701,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.
@@ -64709,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;
@@ -64720,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',
@@ -64760,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 }) => {
@@ -65029,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 }) => {
@@ -65083,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.',
@@ -65187,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.',
@@ -65202,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(),
@@ -65236,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(),
@@ -65418,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(),
@@ -65429,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(),
@@ -65447,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 {
@@ -65462,11 +65713,11 @@ function startMcpServer() {
     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, CLAUDE.md, or AGENTS.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: [{
@@ -65477,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: [{
@@ -65489,28 +65740,24 @@ function startMcpServer() {
         else {
             const section = (0, intent_compiler_1.formatClaudeMdSection)(spec);
             const defaultFile = format === 'agents-md' ? 'AGENTS.md' : 'CLAUDE.md';
-            const filePath = (0, path_1.resolve)(process.cwd(), path || defaultFile);
-            // Append or replace PATHMODE section in existing file
+            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 ${defaultFile} section to ${filePath}\n\n${audience} 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/package.json

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