@kawacode/mcp 5.0.4 → 5.1.1

package/README.md

@@ -24,28 +24,12 @@ This MCP server enables AI coding assistants to understand what you're working o
 - **Decision recording**: Track architectural decisions and trade-offs with constraint validation
 - **Code block assignment**: Associate code changes with intents for better commit history
 
-## Usage
-
-The MCP server works together with Kawa Code, AI code generators such as Cursor, Claude Code,
-and the Kawa Code extensions.
-
-## Key Features
-
-- **Context Persistence**: Never lose track of what you were working on across AI sessions
-- **Smart Context Retrieval**: Relevance-based context loading - only fetch what's needed for the current task
-- **Zero-Knowledge Encryption**: Code blocks encrypted client-side before cloud sync, API cannot decrypt
-- **Team Conflict Detection**: Know when teammates are working on the same files/lines
-- **Decision Tracking**: Record architectural decisions with constraint validation and conflict detection
-- **Commit Integration**: Link all code changes to intent context for better git history
-- **Cross-Platform**: Works with Claude Code and Cursor AI via MCP protocol
-
 ## Prerequisites
 
 ### Required
 
 - **Node.js >= 18.0.0** — runtime for the MCP server
-- **[Kawa Code](https://codeawareness.com/product) desktop app running** — kawa.mcp is a thin MCP-to-IPC adapter; all git operations, storage, and API communication happen in Kawa Code
-- **Active Kawa Code account** — for cloud sync and team features
+- **[Kawa Code](https://kawacode.ai) desktop app running** — kawa.mcp is a thin MCP-to-IPC adapter; all git operations, storage, and API communication happen in Kawa Code
 
 ### Optional (for history inference)
 
@@ -54,63 +38,27 @@ and the Kawa Code extensions.
 
 ## Installation
 
-```bash
-# Clone the repository (if not already cloned)
-cd /path/to/kawa.mcp
-
-# Install dependencies
-npm install
-
-# Build the TypeScript source
-npm run build
-```
-
-## Quick Start
-
-1. **Start Kawa Code**: Launch the Kawa Code desktop app and log in
-2. **Configure MCP**: Add kawa.mcp to your AI assistant's MCP configuration (see Configuration section)
-3. **Restart AI**: Restart Claude Code or Cursor to load the MCP server
-4. **Test connection**: The server will try to connect to Kawa Code on startup
-5. **Start coding**: Use `check_active_intent` to begin tracking your work
-
-## Setting Up CLAUDE.md
-
-For Claude Code to use the MCP tools effectively, your project needs a `CLAUDE.md` file that tells Claude *when* to call the tools and provides your repository coordinates.
-
-Copy the example template into your project root and fill in the placeholders:
+Add the MCP server to Claude Code (available across all your projects):
 
 ```bash
-cp /path/to/kawa.mcp/CLAUDE.md.example /path/to/your-project/CLAUDE.md
+claude mcp add kawa-intents --scope user -- npx -y @kawacode/mcp
 ```
 
-Or just merge the example with your own content.
-See [`CLAUDE.md.example`](./CLAUDE.md.example) for the full template with optional sections for monorepos, code style, and architecture.
-
-## Configuration
-
-### Claude Code
-
-Create a `.mcp.json` file in your project root (recommended for teams — commit it to git):
+Or for a single project, create a `.mcp.json` file in your project root (recommended for teams — commit it to git):
 
 ```json
 {
   "mcpServers": {
     "kawa-intents": {
       "type": "stdio",
-      "command": "node",
-      "args": ["/absolute/path/to/kawa.mcp/build/index.js"]
+      "command": "npx",
+      "args": ["-y", "@kawacode/mcp"]
     }
   }
 }
 ```
 
-Or add it at user level (available across all your projects):
-
-```bash
-claude mcp add --transport stdio kawa-intents --scope user -- node /absolute/path/to/kawa.mcp/build/index.js
-```
-
-### Cursor AI
+#### Cursor AI setup
 
 Add to your Cursor MCP configuration (`~/.cursor/mcp.json`):
 
@@ -118,14 +66,56 @@ Add to your Cursor MCP configuration (`~/.cursor/mcp.json`):
 {
   "mcpServers": {
     "kawa-intents": {
-      "command": "node",
-      "args": ["/absolute/path/to/kawa.mcp/build/index.js"]
+      "command": "npx",
+      "args": ["-y", "@kawacode/mcp"]
     }
   }
 }
 ```
 
-**Important:** Use absolute paths, not relative paths or `~` shortcuts.
+## Quick Start
+
+1. **Start Kawa Code**: Launch the Kawa Code desktop app and log in
+2. **Install MCP**: Run `claude mcp add kawa-intents --scope user -- npx -y @kawacode/mcp`
+3. **Restart AI**: Restart Claude Code or Cursor to load the MCP server
+4. **Test connection**: The server will try to connect to Kawa Code on startup
+5. **Start coding**: You'll start seeing `check_active_intent` at the start of your work with Claude Code
+
+## Setting Up CLAUDE.md
+
+#### Quick prompt to tell Claude Code to set up everything:
+
+```
+Read the CLAUDE.md.example file from the @kawacode/mcp package and create a CLAUDE.md in this project's root. Fill in the repoOrigin and repoPath with the actual values from this repository's git config. Fill in the Project Overview with a brief description of this project.
+```
+
+After this, you can start working using your usual workflow. Kawa Code will automatically start improving your LLM's code generation quality.
+
+To benefit from Kawa Code's intent-driven development immediately, tell Claude Code to infer code decisions from your git history:
+
+```
+Please run the infer history tool on tier 5, with a maximum 3000 commit history.
+```
+
+This can take a while, depending on how many commits you asked it to analyze. You'll see a progress bar in Kawa Code application.
+Once this is done, you can open the project in Kawa Code (or you can use one of Kawa Code extensions for Visual Studio Code, emacs, or vim) to see the intents at every step in the code evolution.
+Kawa Code will now select the relevant intents and micro-decisions made to speed up code generation, issue troubleshooting, bug fixing etc.
+This relevant context will also help generating a more correct solution to your prompt request.
+
+## Usage
+
+The MCP server works together with Kawa Code, AI code generators such as Cursor, Claude Code,
+and the Kawa Code extensions.
+
+## Key Features
+
+- **Context Persistence**: Never lose track of what you were working on across AI sessions
+- **Smart Context Retrieval**: Relevance-based context loading - only fetch what's needed for the current task
+- **Zero-Knowledge Encryption**: Code blocks encrypted client-side before cloud sync, API cannot decrypt
+- **Team Conflict Detection**: Know when teammates are working on the same files/lines
+- **Decision Tracking**: Record architectural decisions with constraint validation and conflict detection
+- **Commit Integration**: Link all code changes to intent context for better git history
+- **Cross-Platform**: Works with Claude Code and Cursor AI via MCP protocol
 
 ## Available Tools
 

package/build/services/muninn-ipc.d.ts

@@ -29,7 +29,7 @@ export declare function request(domain: string, action: string, data?: any): Pro
  * Ensure a repository path is registered with Muninn as a project.
  *
  * Sends `code:add` with the folder path so Muninn activates the project,
- * sets up git state, and pulls intents/decisions/lessons from the API.
+ * sets up git state, and pulls intents/decisions from the API.
  * Always sends the request — Muninn's AddHandler is idempotent and
  * returns the existing project if already added.
  * Errors are logged but not thrown — repo registration is best-effort.

package/build/services/muninn-ipc.js

@@ -233,7 +233,7 @@ export async function request(domain, action, data = {}) {
  * Ensure a repository path is registered with Muninn as a project.
  *
  * Sends `code:add` with the folder path so Muninn activates the project,
- * sets up git state, and pulls intents/decisions/lessons from the API.
+ * sets up git state, and pulls intents/decisions from the API.
  * Always sends the request — Muninn's AddHandler is idempotent and
  * returns the existing project if already added.
  * Errors are logged but not thrown — repo registration is best-effort.

package/build/tools/evolve-decisions.d.ts

@@ -1,18 +1,15 @@
 import { z } from 'zod';
 export declare const evolveDecisionsSchema: z.ZodObject<{
     stories: z.ZodArray<z.ZodAny, "many">;
-    apiKey: z.ZodString;
     model: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     repoPath: z.ZodOptional<z.ZodString>;
     repoOrigin: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    apiKey: string;
     model: string;
     stories: any[];
     repoOrigin?: string | undefined;
     repoPath?: string | undefined;
 }, {
-    apiKey: string;
     stories: any[];
     repoOrigin?: string | undefined;
     repoPath?: string | undefined;
@@ -29,18 +26,15 @@ export declare const evolveDecisionsTool: {
     description: string;
     inputSchema: z.ZodObject<{
         stories: z.ZodArray<z.ZodAny, "many">;
-        apiKey: z.ZodString;
         model: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         repoPath: z.ZodOptional<z.ZodString>;
         repoOrigin: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        apiKey: string;
         model: string;
         stories: any[];
         repoOrigin?: string | undefined;
         repoPath?: string | undefined;
     }, {
-        apiKey: string;
         stories: any[];
         repoOrigin?: string | undefined;
         repoPath?: string | undefined;

package/build/tools/evolve-decisions.js

@@ -2,7 +2,6 @@ import { z } from 'zod';
 import { request } from '../services/muninn-ipc.js';
 export const evolveDecisionsSchema = z.object({
     stories: z.array(z.any()).describe('Array of story objects from a previous infer_history run'),
-    apiKey: z.string().describe('Anthropic API key for LLM calls (customer\'s own key)'),
     model: z.string().optional().default('claude-haiku-4-5-20251001').describe('Anthropic model for edge classification (default: claude-haiku-4-5-20251001, cheaper model recommended)'),
     repoPath: z.string().optional().describe('Local path to the repository root (required for auto-persist after evolution)'),
     repoOrigin: z.string().optional().describe('Git remote origin URL (auto-detected from repoPath if not provided)'),
@@ -10,7 +9,6 @@ export const evolveDecisionsSchema = z.object({
 export async function evolveDecisions(input) {
     const res = await request('inference', 'evolve', {
         stories: input.stories,
-        apiKey: input.apiKey,
         model: input.model,
         repoPath: input.repoPath,
         repoOrigin: input.repoOrigin,
@@ -36,7 +34,7 @@ This analyzes how decisions relate across stories over time:
 
 Note: \`infer_history\` already chains evolve + persist automatically. Use this tool only if you want to run evolution separately on a pre-existing set of stories.
 
-If \`repoPath\` is provided, curated stories are automatically persisted as intents with decisions and lessons after evolution completes.
+If \`repoPath\` is provided, curated stories are automatically persisted as intents with decisions after evolution completes.
 
 The pipeline runs asynchronously — returns immediately. Uses a cheaper model (haiku) by default since edge classification requires less reasoning than story analysis.`,
     inputSchema: evolveDecisionsSchema,

package/build/tools/evolve-decisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"evolve-decisions.js","sourceRoot":"","sources":["../../src/tools/evolve-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,yGAAyG,CAAC;IACrL,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;IACzH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CAClH,CAAC,CAAA;AASF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE;QAC/C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAA;IAEF,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,iFAAiF;KAC1G,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;uKAgBwJ;IACrK,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,eAAe;CACzB,CAAA"}
+{"version":3,"file":"evolve-decisions.js","sourceRoot":"","sources":["../../src/tools/evolve-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,yGAAyG,CAAC;IACrL,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;IACzH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CAClH,CAAC,CAAA;AASF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE;QAC/C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAA;IAEF,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,iFAAiF;KAC1G,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;uKAgBwJ;IACrK,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,eAAe;CACzB,CAAA"}

package/build/tools/get-session-decisions.d.ts

@@ -27,6 +27,7 @@ export interface DecisionPoint {
     context?: string;
     alternatives: string[];
     consequences?: string;
+    symptom?: string;
     relatedFiles: string[];
     constraintsChecked: string[];
     constraintViolations: ConstraintViolation[];

package/build/tools/get-session-decisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-session-decisions.js","sourceRoot":"","sources":["../../src/tools/get-session-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;IACzH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpE,CAAC,CAAA;AA8BF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA+B;IACvE,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IACpE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE;QAC5C,UAAU,EAAE,YAAY;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAA;IAEF,MAAM,SAAS,GAAoB,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QACxE,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QACxD,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE;QAC3D,IAAI,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI;QACjD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;QAClC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,YAAY,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE;QACrD,kBAAkB,EAAE,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC,kBAAkB,IAAI,EAAE;QACvE,oBAAoB,EAAE,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,oBAAoB,IAAI,EAAE;KAC9E,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS;QACT,KAAK,EAAE,SAAS,CAAC,MAAM;KACxB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;sCAQuB;IACpC,WAAW,EAAE,yBAAyB;IACtC,OAAO,EAAE,mBAAmB;CAC7B,CAAA"}
+{"version":3,"file":"get-session-decisions.js","sourceRoot":"","sources":["../../src/tools/get-session-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;IACzH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpE,CAAC,CAAA;AA+BF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA+B;IACvE,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IACpE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE;QAC5C,UAAU,EAAE,YAAY;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAA;IAEF,MAAM,SAAS,GAAoB,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QACxE,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QACxD,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE;QAC3D,IAAI,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI;QACjD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;QAClC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,YAAY,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE;QACrD,kBAAkB,EAAE,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC,kBAAkB,IAAI,EAAE;QACvE,oBAAoB,EAAE,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,oBAAoB,IAAI,EAAE;KAC9E,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS;QACT,KAAK,EAAE,SAAS,CAAC,MAAM;KACxB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;sCAQuB;IACpC,WAAW,EAAE,yBAAyB;IACtC,OAAO,EAAE,mBAAmB;CAC7B,CAAA"}

package/build/tools/index.d.ts

@@ -249,6 +249,7 @@ export declare const allTools: ({
         context: import("zod").ZodOptional<import("zod").ZodString>;
         alternatives: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
         consequences: import("zod").ZodOptional<import("zod").ZodString>;
+        symptom: import("zod").ZodOptional<import("zod").ZodString>;
         relatedFiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
         constraintsChecked: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
         constraintViolations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
@@ -274,6 +275,7 @@ export declare const allTools: ({
         context?: string | undefined;
         alternatives?: string[] | undefined;
         consequences?: string | undefined;
+        symptom?: string | undefined;
         relatedFiles?: string[] | undefined;
         constraintsChecked?: string[] | undefined;
         constraintViolations?: {
@@ -291,6 +293,7 @@ export declare const allTools: ({
         intentId?: string | undefined;
         alternatives?: string[] | undefined;
         consequences?: string | undefined;
+        symptom?: string | undefined;
         relatedFiles?: string[] | undefined;
         constraintsChecked?: string[] | undefined;
         constraintViolations?: {
@@ -600,7 +603,6 @@ export declare const allTools: ({
     description: string;
     inputSchema: import("zod").ZodObject<{
         repoPath: import("zod").ZodString;
-        apiKey: import("zod").ZodString;
         commits: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
         tier: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
         contextIssues: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
@@ -610,7 +612,6 @@ export declare const allTools: ({
         estimateOnly: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
     }, "strip", import("zod").ZodTypeAny, {
         repoPath: string;
-        apiKey: string;
         commits: number;
         tier: number;
         contextIssues: boolean;
@@ -620,7 +621,6 @@ export declare const allTools: ({
         estimateOnly: boolean;
     }, {
         repoPath: string;
-        apiKey: string;
         commits?: number | undefined;
         tier?: number | undefined;
         contextIssues?: boolean | undefined;
@@ -635,18 +635,15 @@ export declare const allTools: ({
     description: string;
     inputSchema: import("zod").ZodObject<{
         stories: import("zod").ZodArray<import("zod").ZodAny, "many">;
-        apiKey: import("zod").ZodString;
         model: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
         repoPath: import("zod").ZodOptional<import("zod").ZodString>;
         repoOrigin: import("zod").ZodOptional<import("zod").ZodString>;
     }, "strip", import("zod").ZodTypeAny, {
-        apiKey: string;
         model: string;
         stories: any[];
         repoOrigin?: string | undefined;
         repoPath?: string | undefined;
     }, {
-        apiKey: string;
         stories: any[];
         repoOrigin?: string | undefined;
         repoPath?: string | undefined;

package/build/tools/infer-history.d.ts

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 export declare const inferHistorySchema: z.ZodObject<{
     repoPath: z.ZodString;
-    apiKey: z.ZodString;
     commits: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     tier: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     contextIssues: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -11,7 +10,6 @@ export declare const inferHistorySchema: z.ZodObject<{
     estimateOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     repoPath: string;
-    apiKey: string;
     commits: number;
     tier: number;
     contextIssues: boolean;
@@ -21,7 +19,6 @@ export declare const inferHistorySchema: z.ZodObject<{
     estimateOnly: boolean;
 }, {
     repoPath: string;
-    apiKey: string;
     commits?: number | undefined;
     tier?: number | undefined;
     contextIssues?: boolean | undefined;
@@ -43,6 +40,8 @@ export interface InferHistoryResponse {
         est_stories: number;
         cost_usd: number;
     };
+    forge?: string;
+    forge_cli_available?: boolean;
     commit_count?: number;
     message: string;
 }
@@ -52,7 +51,6 @@ export declare const inferHistoryTool: {
     description: string;
     inputSchema: z.ZodObject<{
         repoPath: z.ZodString;
-        apiKey: z.ZodString;
         commits: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         tier: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         contextIssues: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -62,7 +60,6 @@ export declare const inferHistoryTool: {
         estimateOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         repoPath: string;
-        apiKey: string;
         commits: number;
         tier: number;
         contextIssues: boolean;
@@ -72,7 +69,6 @@ export declare const inferHistoryTool: {
         estimateOnly: boolean;
     }, {
         repoPath: string;
-        apiKey: string;
         commits?: number | undefined;
         tier?: number | undefined;
         contextIssues?: boolean | undefined;

package/build/tools/infer-history.js

@@ -2,34 +2,46 @@ import { z } from 'zod';
 import { request } from '../services/muninn-ipc.js';
 export const inferHistorySchema = z.object({
     repoPath: z.string().describe('Local path to the repository root'),
-    apiKey: z.string().describe('Anthropic API key for LLM calls (customer\'s own key)'),
     commits: z.number().optional().default(50).describe('Number of recent commits to analyze (default: 50)'),
-    tier: z.number().optional().default(4).describe('Enrichment tier 1-5: 1=git log, 2=+PR descriptions, 3=+revert diffs, 4=+issue discussions, 5=+full diffs (default: 4)'),
+    tier: z.number().optional().default(5).describe('Enrichment tier 1-5: 1=git log, 2=+PR/MR descriptions (needs gh/glab), 3=+revert diffs, 4=+issue discussions (needs gh/glab), 5=+full diffs (default: 5)'),
     contextIssues: z.boolean().optional().default(false).describe('Include context issues from commit date range (Tier 4 only)'),
     model: z.string().optional().default('claude-sonnet-4-20250514').describe('Anthropic model to use (default: claude-sonnet-4-20250514)'),
     maxStories: z.number().optional().default(0).describe('Maximum stories to analyze in Pass 2 (0 = unlimited)'),
     allowCommitSplitting: z.boolean().optional().default(false).describe('Allow splitting a single commit into multiple stories when it contains unrelated changes (recommended for repos with messy commit history)'),
-    estimateOnly: z.boolean().optional().default(false).describe('If true, only estimate token cost without running the pipeline'),
+    estimateOnly: z.boolean().optional().default(true).describe('If true (default), only estimate token cost without running the pipeline. Set to false to run the full pipeline.'),
 });
 export async function inferHistory(input) {
     if (input.estimateOnly) {
         const res = await request('inference', 'estimate', {
             repoPath: input.repoPath,
-            apiKey: input.apiKey,
             commits: input.commits,
             tier: input.tier,
             contextIssues: input.contextIssues,
             model: input.model,
         });
+        let forgeWarning = '';
+        if (input.tier >= 2 && !res.forge_cli_available) {
+            const forge = res.forge ?? 'Unknown';
+            if (forge === 'Unknown') {
+                forgeWarning = '\n⚠ Unrecognized git hosting platform. Tiers 2 (PR/MR descriptions) and 4 (issue discussions) will be skipped.';
+            }
+            else if (forge === 'GitHub') {
+                forgeWarning = '\n⚠ GitHub CLI (gh) not found or not authenticated. Tiers 2 and 4 will be skipped. Run `gh auth login` to include PR and issue context.';
+            }
+            else if (forge === 'GitLab') {
+                forgeWarning = '\n⚠ GitLab CLI (glab) not found or not authenticated. Tiers 2 and 4 will be skipped. Run `glab auth login` to include MR and issue context.';
+            }
+        }
         return {
             estimate: res.estimate,
+            forge: res.forge,
+            forge_cli_available: res.forge_cli_available,
             commit_count: res.commit_count,
-            message: `Estimated cost: $${res.estimate?.cost_usd ?? '?'} for ~${res.estimate?.est_stories ?? '?'} stories from ${res.commit_count ?? '?'} commits`
+            message: `Estimated cost: $${res.estimate?.cost_usd ?? '?'} for ~${res.estimate?.est_stories ?? '?'} stories from ${res.commit_count ?? '?'} commits${forgeWarning}`
         };
     }
     const res = await request('inference', 'run', {
         repoPath: input.repoPath,
-        apiKey: input.apiKey,
         commits: input.commits,
         tier: input.tier,
         contextIssues: input.contextIssues,
@@ -44,14 +56,14 @@ export async function inferHistory(input) {
 }
 export const inferHistoryTool = {
     name: 'infer_history',
-    description: `Analyze git commit history to extract structured development knowledge (intents, decisions, lessons).
+    description: `Analyze git commit history to extract structured development knowledge (intents and decisions).
 
 Runs the full pipeline automatically: infer → evolve → persist.
 
 1. **Pass 1**: Groups commits into coherent development stories with value hints
-2. **Pass 2**: Deep analysis of each story to extract architectural decisions and lessons
+2. **Pass 2**: Deep analysis of each story to extract architectural decisions
 3. **Evolution**: Curates decisions by finding relationships (supersedes, reinforces, contradicts, specializes)
-4. **Persist**: Stores curated stories as intents with decisions and lessons (auto-syncs to cloud)
+4. **Persist**: Stores curated stories as intents with decisions (auto-syncs to cloud)
 
 Use \`estimateOnly: true\` first to preview token cost before running the full pipeline.
 
@@ -59,10 +71,12 @@ The pipeline supports checkpointing — if interrupted, re-running resumes from
 
 Enrichment tiers control how much context is gathered:
 - Tier 1: Git log only (fastest, cheapest)
-- Tier 2: + PR descriptions and review comments
+- Tier 2: + PR/MR descriptions and review comments (requires forge CLI: gh or glab)
 - Tier 3: + Diffs for revert commits
-- Tier 4: + GitHub issue discussions with decision-level content (recommended)
-- Tier 5: + Full diffs and code annotation extraction (most expensive)`,
+- Tier 4: + Issue discussions with decision-level content (requires forge CLI)
+- Tier 5: + Full diffs and code annotation extraction (most expensive)
+
+Supports GitHub (gh CLI) and GitLab (glab CLI). Forge is auto-detected from the remote origin.`,
     inputSchema: inferHistorySchema,
     handler: inferHistory
 };

package/build/tools/infer-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"infer-history.js","sourceRoot":"","sources":["../../src/tools/infer-history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"infer-history.js","sourceRoot":"","sources":["../../src/tools/infer-history.ts"],"names":[],"mappings":"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"}

package/build/tools/record-decision.d.ts

@@ -9,6 +9,7 @@ export declare const recordDecisionSchema: z.ZodObject<{
     context: z.ZodOptional<z.ZodString>;
     alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     consequences: z.ZodOptional<z.ZodString>;
+    symptom: z.ZodOptional<z.ZodString>;
     relatedFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     constraintsChecked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     constraintViolations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -34,6 +35,7 @@ export declare const recordDecisionSchema: z.ZodObject<{
     context?: string | undefined;
     alternatives?: string[] | undefined;
     consequences?: string | undefined;
+    symptom?: string | undefined;
     relatedFiles?: string[] | undefined;
     constraintsChecked?: string[] | undefined;
     constraintViolations?: {
@@ -51,6 +53,7 @@ export declare const recordDecisionSchema: z.ZodObject<{
     intentId?: string | undefined;
     alternatives?: string[] | undefined;
     consequences?: string | undefined;
+    symptom?: string | undefined;
     relatedFiles?: string[] | undefined;
     constraintsChecked?: string[] | undefined;
     constraintViolations?: {
@@ -78,6 +81,7 @@ export declare const recordDecisionTool: {
         context: z.ZodOptional<z.ZodString>;
         alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         consequences: z.ZodOptional<z.ZodString>;
+        symptom: z.ZodOptional<z.ZodString>;
         relatedFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         constraintsChecked: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         constraintViolations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -103,6 +107,7 @@ export declare const recordDecisionTool: {
         context?: string | undefined;
         alternatives?: string[] | undefined;
         consequences?: string | undefined;
+        symptom?: string | undefined;
         relatedFiles?: string[] | undefined;
         constraintsChecked?: string[] | undefined;
         constraintViolations?: {
@@ -120,6 +125,7 @@ export declare const recordDecisionTool: {
         intentId?: string | undefined;
         alternatives?: string[] | undefined;
         consequences?: string | undefined;
+        symptom?: string | undefined;
         relatedFiles?: string[] | undefined;
         constraintsChecked?: string[] | undefined;
         constraintViolations?: {

package/build/tools/record-decision.js

@@ -17,6 +17,7 @@ export const recordDecisionSchema = z.object({
     context: z.string().optional().describe('What we were trying to accomplish when this decision was made'),
     alternatives: z.array(z.string()).optional().describe('Other options that were considered'),
     consequences: z.string().optional().describe('Downstream implications of this decision'),
+    symptom: z.string().optional().describe('Observable symptom that indicates this decision is relevant (e.g., error messages, runtime panics, unexpected behavior). Useful for discovery and constraint decisions.'),
     relatedFiles: z.array(z.string()).optional().describe('File paths affected by this decision'),
     constraintsChecked: z.array(z.string()).optional().describe('Which architectural constraints were verified before this decision'),
     constraintViolations: z.array(constraintViolationSchema).optional()
@@ -33,6 +34,7 @@ export async function recordDecision(input) {
         context: input.context,
         alternatives: input.alternatives || [],
         consequences: input.consequences,
+        symptom: input.symptom,
         relatedFiles: input.relatedFiles || [],
         constraintsChecked: input.constraintsChecked || [],
         constraintViolations: input.constraintViolations || [],

package/build/tools/record-decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-decision.js","sourceRoot":"","sources":["../../src/tools/record-decision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-decision.js","sourceRoot":"","sources":["../../src/tools/record-decision.ts"],"names":[],"mappings":"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"}

package/build/tools/resolve-origin.js

@@ -18,6 +18,7 @@ export function resolveOrigin(repoOrigin, repoPath) {
                 cwd: repoPath,
                 encoding: 'utf-8',
                 timeout: 5000,
+                windowsHide: true,
             }).trim();
             if (origin)
                 return origin;

package/build/tools/resolve-origin.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-origin.js","sourceRoot":"","sources":["../../src/tools/resolve-origin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,UAA8B,EAAE,QAAiB;IAC7E,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,oCAAoC,EAAE;gBAC5D,GAAG,EAAE,QAAQ;gBACb,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC,IAAI,EAAE,CAAA;YACT,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IACD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IACjC,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAA;AACH,CAAC"}
+{"version":3,"file":"resolve-origin.js","sourceRoot":"","sources":["../../src/tools/resolve-origin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,UAA8B,EAAE,QAAiB;IAC7E,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,oCAAoC,EAAE;gBAC5D,GAAG,EAAE,QAAQ;gBACb,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC,IAAI,EAAE,CAAA;YACT,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IACD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IACjC,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kawacode/mcp",
-  "version": "5.0.4",
+  "version": "5.1.1",
   "description": "MCP server for Kawa Code intent integration with Claude Code and Cursor AI",
   "main": "build/index.js",
   "bin": {

package/build/services/active-intent-store.d.ts

@@ -1,36 +0,0 @@
-/**
- * In-memory active intent tracking.
- *
- * Simple Map keyed by normalized origin. Replaces Muninn's per-repo
- * active intent tracking. State lives only for the MCP server lifetime.
- */
-import type { Intent } from './kawa-api.js';
-export interface ActiveIntent {
-    id: string;
-    title: string;
-    description: string;
-    templateType: string;
-    status: string;
-    constraints: string[];
-    blocks: Array<{
-        filePath: string;
-        startLine: number;
-        endLine: number;
-        contentSnippet?: string;
-    }>;
-    branch?: string;
-    forkedFrom?: string;
-    createdAt?: string;
-}
-declare class ActiveIntentStore {
-    private store;
-    get(origin: string): ActiveIntent | null;
-    set(origin: string, intent: ActiveIntent): void;
-    clear(origin: string): void;
-    /** Return all active intents as [origin, intent] pairs */
-    getAll(): Array<[string, ActiveIntent]>;
-    /** Convert an API Intent to the ActiveIntent shape and store it */
-    setFromApiIntent(origin: string, apiIntent: Intent, cloudId: string): void;
-}
-export declare const activeIntentStore: ActiveIntentStore;
-export {};