@grafema/mcp 0.2.11 → 0.3.0-beta

package/dist/handlers/guard-handlers.js.map

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

package/dist/handlers/index.d.ts

@@ -11,4 +11,8 @@ export { handleGetCoverage } from './coverage-handlers.js';
 export { handleFindGuards } from './guard-handlers.js';
 export { handleGetDocumentation } from './documentation-handlers.js';
 export { handleReportIssue } from './issue-handlers.js';
+export { handleGetNode, handleGetNeighbors, handleTraverseGraph } from './graph-handlers.js';
+export { handleAddKnowledge, handleQueryKnowledge, handleQueryDecisions, handleSupersedeFact, handleGetKnowledgeStats } from './knowledge-handlers.js';
+export { handleDescribe } from './notation-handlers.js';
+export { handleGraphQLQuery } from './graphql-handlers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGvJ,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/handlers/index.js

@@ -11,4 +11,10 @@ export { handleGetCoverage } from './coverage-handlers.js';
 export { handleFindGuards } from './guard-handlers.js';
 export { handleGetDocumentation } from './documentation-handlers.js';
 export { handleReportIssue } from './issue-handlers.js';
+export { handleGetNode, handleGetNeighbors, handleTraverseGraph } from './graph-handlers.js';
+export { handleAddKnowledge, handleQueryKnowledge, handleQueryDecisions, handleSupersedeFact, handleGetKnowledgeStats } from './knowledge-handlers.js';
+// Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
+// export { handleGitChurn, handleGitCoChange, handleGitOwnership, handleGitArchaeology } from './knowledge-handlers.js';
+export { handleDescribe } from './notation-handlers.js';
+export { handleGraphQLQuery } from './graphql-handlers.js';
 //# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvJ,0EAA0E;AAC1E,yHAAyH;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/handlers/issue-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/issue-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAkElF"}
+{"version":3,"file":"issue-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/issue-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA6DlF"}

package/dist/handlers/issue-handlers.js

@@ -5,9 +5,7 @@ import { textResult, } from '../utils.js';
 // === BUG REPORTING ===
 export async function handleReportIssue(args) {
     const { title, description, context, labels = ['bug'] } = args;
-    // Use user's token if provided, otherwise fall back to project's issue-only token
-    const GRAFEMA_ISSUE_TOKEN = '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';
-    const githubToken = process.env.GITHUB_TOKEN || GRAFEMA_ISSUE_TOKEN;
+    const githubToken = process.env.GITHUB_TOKEN;
     const repo = 'Disentinel/grafema';
     // Build issue body
     const body = `## Description
@@ -15,12 +13,11 @@ ${description}
 
 ${context ? `## Context\n\`\`\`\n${context}\n\`\`\`\n` : ''}
 ## Environment
-- Grafema version: 0.1.0-alpha.1
 - Reported via: MCP tool
 
 ---
-*This issue was automatically created via Grafema MCP server.*`;
-    // Try GitHub API if token is available
+*This issue was created via Grafema MCP server.*`;
+    // Try GitHub API if user has a token configured
     if (githubToken) {
         try {
             const response = await fetch(`https://api.github.com/repos/${repo}/issues`, {
@@ -38,9 +35,7 @@ ${context ? `## Context\n\`\`\`\n${context}\n\`\`\`\n` : ''}
             });
             if (response.ok) {
                 const issue = await response.json();
-                return textResult(`✅ Issue created successfully!\n\n` +
-                    `**Issue #${issue.number}**: ${issue.html_url}\n\n` +
-                    `Thank you for reporting this issue.`);
+                return textResult(`Issue created: #${issue.number} ${issue.html_url}`);
             }
             else {
                 const error = await response.text();
@@ -48,19 +43,19 @@ ${context ? `## Context\n\`\`\`\n${context}\n\`\`\`\n` : ''}
             }
         }
         catch (error) {
-            // Fall through to manual template if API fails
             console.error('[report_issue] GitHub API failed:', error);
         }
     }
-    // Fallback: return template for manual submission
+    // Return template for manual submission
     const issueUrl = `https://github.com/${repo}/issues/new`;
     const encodedTitle = encodeURIComponent(title);
     const encodedBody = encodeURIComponent(body);
     const encodedLabels = encodeURIComponent(labels.join(','));
     const directUrl = `${issueUrl}?title=${encodedTitle}&body=${encodedBody}&labels=${encodedLabels}`;
-    return textResult(`⚠️ Failed to create issue automatically. Please create it manually:\n\n` +
-        `**Quick link** (may truncate long descriptions):\n${directUrl}\n\n` +
-        `**Or copy this template to** ${issueUrl}:\n\n` +
-        `---\n**Title:** ${title}\n\n${body}\n---`);
+    return textResult(`Create issue manually:\n\n` +
+        `**Link:** ${directUrl}\n\n` +
+        `Or copy to ${issueUrl}:\n\n` +
+        `---\n**Title:** ${title}\n\n${body}\n---\n\n` +
+        `Tip: Set GITHUB_TOKEN env var to create issues automatically.`);
 }
 //# sourceMappingURL=issue-handlers.js.map

package/dist/handlers/issue-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"issue-handlers.js","sourceRoot":"","sources":["../../src/handlers/issue-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,GACX,MAAM,aAAa,CAAC;AAMrB,wBAAwB;AAExB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAqB;IAC3D,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC;IAC/D,kFAAkF;IAClF,MAAM,mBAAmB,GAAG,+FAA+F,CAAC;IAC5H,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,mBAAmB,CAAC;IACpE,MAAM,IAAI,GAAG,oBAAoB,CAAC;IAElC,mBAAmB;IACnB,MAAM,IAAI,GAAG;EACb,WAAW;;EAEX,OAAO,CAAC,CAAC,CAAC,uBAAuB,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE;;;;;;+DAMI,CAAC;IAE9D,uCAAuC;IACvC,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gCAAgC,IAAI,SAAS,EAAE;gBAC1E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,eAAe,EAAE,SAAS,WAAW,EAAE;oBACvC,cAAc,EAAE,kBAAkB;oBAClC,QAAQ,EAAE,gCAAgC;iBAC3C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK;oBACL,IAAI;oBACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBAC5F,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0C,CAAC;gBAC5E,OAAO,UAAU,CACf,mCAAmC;oBACnC,YAAY,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,QAAQ,MAAM;oBACnD,qCAAqC,CACtC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,sBAAsB,IAAI,aAAa,CAAC;IACzD,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,GAAG,QAAQ,UAAU,YAAY,SAAS,WAAW,WAAW,aAAa,EAAE,CAAC;IAElG,OAAO,UAAU,CACf,yEAAyE;QACzE,qDAAqD,SAAS,MAAM;QACpE,gCAAgC,QAAQ,OAAO;QAC/C,mBAAmB,KAAK,OAAO,IAAI,OAAO,CAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"issue-handlers.js","sourceRoot":"","sources":["../../src/handlers/issue-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,GACX,MAAM,aAAa,CAAC;AAMrB,wBAAwB;AAExB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAqB;IAC3D,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC;IAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC7C,MAAM,IAAI,GAAG,oBAAoB,CAAC;IAElC,mBAAmB;IACnB,MAAM,IAAI,GAAG;EACb,WAAW;;EAEX,OAAO,CAAC,CAAC,CAAC,uBAAuB,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE;;;;;iDAKV,CAAC;IAEhD,gDAAgD;IAChD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gCAAgC,IAAI,SAAS,EAAE;gBAC1E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,eAAe,EAAE,SAAS,WAAW,EAAE;oBACvC,cAAc,EAAE,kBAAkB;oBAClC,QAAQ,EAAE,gCAAgC;iBAC3C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK;oBACL,IAAI;oBACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBAC5F,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0C,CAAC;gBAC5E,OAAO,UAAU,CACf,mBAAmB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CACpD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,QAAQ,GAAG,sBAAsB,IAAI,aAAa,CAAC;IACzD,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,GAAG,QAAQ,UAAU,YAAY,SAAS,WAAW,WAAW,aAAa,EAAE,CAAC;IAElG,OAAO,UAAU,CACf,4BAA4B;QAC5B,aAAa,SAAS,MAAM;QAC5B,cAAc,QAAQ,OAAO;QAC7B,mBAAmB,KAAK,OAAO,IAAI,WAAW;QAC9C,+DAA+D,CAChE,CAAC;AACJ,CAAC"}

package/dist/handlers/knowledge-handlers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP Knowledge Handlers
+ */
+import type { ToolResult, AddKnowledgeArgs, QueryKnowledgeArgs, QueryDecisionsArgs, SupersedeFactArgs } from '../types.js';
+/**
+ * Add a new knowledge node.
+ */
+export declare function handleAddKnowledge(args: AddKnowledgeArgs): Promise<ToolResult>;
+/**
+ * Query knowledge nodes with filters.
+ */
+export declare function handleQueryKnowledge(args: QueryKnowledgeArgs): Promise<ToolResult>;
+/**
+ * Query decisions, optionally filtered by module or status.
+ */
+export declare function handleQueryDecisions(args: QueryDecisionsArgs): Promise<ToolResult>;
+/**
+ * Supersede an existing fact with a new version.
+ */
+export declare function handleSupersedeFact(args: SupersedeFactArgs): Promise<ToolResult>;
+/**
+ * Get knowledge base statistics.
+ */
+export declare function handleGetKnowledgeStats(): Promise<ToolResult>;
+//# sourceMappingURL=knowledge-handlers.d.ts.map

package/dist/handlers/knowledge-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/knowledge-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAMlB,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BpF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+CxF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCxF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBtF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC,CAyDnE"}

package/dist/handlers/knowledge-handlers.js

@@ -0,0 +1,208 @@
+/**
+ * MCP Knowledge Handlers
+ */
+import { getOrCreateKnowledgeBase } from '../state.js';
+import { textResult, errorResult } from '../utils.js';
+// Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
+// import { getChurn, getCoChanges, getOwnership, getArchaeology } from '@grafema/util';
+/**
+ * Add a new knowledge node.
+ */
+export async function handleAddKnowledge(args) {
+    try {
+        const kb = await getOrCreateKnowledgeBase();
+        const node = await kb.addNode({
+            type: args.type,
+            content: args.content,
+            slug: args.slug,
+            subtype: args.subtype,
+            scope: args.scope,
+            projections: args.projections,
+            relates_to: args.relates_to,
+            status: args.status,
+            confidence: args.confidence,
+            effective_from: args.effective_from,
+            applies_to: args.applies_to,
+            task_id: args.task_id,
+        });
+        return textResult(`Created ${node.type} node: ${node.id}\n` +
+            `File: ${node.filePath}\n` +
+            `Lifecycle: ${node.lifecycle}\n` +
+            (node.content.length > 200
+                ? `Content: ${node.content.slice(0, 200)}...`
+                : `Content: ${node.content}`));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to add knowledge: ${message}`);
+    }
+}
+/**
+ * Query knowledge nodes with filters.
+ */
+export async function handleQueryKnowledge(args) {
+    try {
+        const kb = await getOrCreateKnowledgeBase();
+        const nodes = await kb.queryNodes({
+            type: args.type,
+            projection: args.projection,
+            relates_to: args.relates_to,
+            text: args.text,
+            include_dangling_only: args.include_dangling_only,
+        });
+        if (nodes.length === 0) {
+            return textResult('No matching knowledge nodes found.');
+        }
+        const lines = [`Found ${nodes.length} node(s):\n`];
+        for (const node of nodes) {
+            lines.push(`## ${node.id}`);
+            lines.push(`Type: ${node.type} | Lifecycle: ${node.lifecycle}`);
+            if (node.projections.length > 0)
+                lines.push(`Projections: ${node.projections.join(', ')}`);
+            if (node.type === 'DECISION') {
+                const d = node;
+                lines.push(`Status: ${d.status}`);
+                if (d.applies_to?.length)
+                    lines.push(`Applies to: ${d.applies_to.join(', ')}`);
+            }
+            // Include resolution status for code references
+            const resolved = await kb.resolveReferences(node);
+            if (resolved.length > 0) {
+                lines.push('Code refs:');
+                for (const r of resolved) {
+                    const icon = r.status === 'resolved' ? 'OK' : 'DANGLING';
+                    lines.push(`  [${icon}] ${r.address}${r.codeNodeId ? ` → ${r.codeNodeId}` : ''}`);
+                }
+            }
+            lines.push('');
+            lines.push(node.content.length > 500 ? node.content.slice(0, 500) + '...' : node.content);
+            lines.push('');
+        }
+        return textResult(lines.join('\n'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to query knowledge: ${message}`);
+    }
+}
+/**
+ * Query decisions, optionally filtered by module or status.
+ */
+export async function handleQueryDecisions(args) {
+    try {
+        const kb = await getOrCreateKnowledgeBase();
+        let decisions;
+        if (args.module) {
+            decisions = await kb.activeDecisionsFor(args.module);
+            if (args.status) {
+                decisions = decisions.filter(d => d.status === args.status);
+            }
+        }
+        else {
+            const nodes = await kb.queryNodes({
+                type: 'DECISION',
+                status: args.status,
+            });
+            decisions = nodes;
+        }
+        if (decisions.length === 0) {
+            return textResult('No matching decisions found.');
+        }
+        const lines = [`Found ${decisions.length} decision(s):\n`];
+        for (const d of decisions) {
+            lines.push(`## ${d.id} [${d.status}]`);
+            if (d.applies_to?.length)
+                lines.push(`Applies to: ${d.applies_to.join(', ')}`);
+            if (d.effective_from)
+                lines.push(`Effective from: ${d.effective_from}`);
+            if (d.superseded_by)
+                lines.push(`Superseded by: ${d.superseded_by}`);
+            lines.push('');
+            lines.push(d.content);
+            lines.push('');
+        }
+        return textResult(lines.join('\n'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to query decisions: ${message}`);
+    }
+}
+/**
+ * Supersede an existing fact with a new version.
+ */
+export async function handleSupersedeFact(args) {
+    try {
+        const kb = await getOrCreateKnowledgeBase();
+        const result = await kb.supersedeFact(args.old_id, args.new_content, args.new_slug);
+        return textResult(`Superseded fact:\n` +
+            `Old: ${result.old.id} (now has superseded_by: ${result.old.superseded_by})\n` +
+            `New: ${result.new.id}\n` +
+            `File: ${result.new.filePath}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to supersede fact: ${message}`);
+    }
+}
+/**
+ * Get knowledge base statistics.
+ */
+export async function handleGetKnowledgeStats() {
+    try {
+        const kb = await getOrCreateKnowledgeBase();
+        const stats = await kb.getStats();
+        const lines = [
+            `## Knowledge Base Stats\n`,
+            `Total nodes: ${stats.totalNodes}`,
+            `Total edges: ${stats.totalEdges}`,
+        ];
+        if (Object.keys(stats.byType).length > 0) {
+            lines.push('\n### By Type');
+            for (const [type, count] of Object.entries(stats.byType)) {
+                lines.push(`- ${type}: ${count}`);
+            }
+        }
+        if (Object.keys(stats.byLifecycle).length > 0) {
+            lines.push('\n### By Lifecycle');
+            for (const [lifecycle, count] of Object.entries(stats.byLifecycle)) {
+                lines.push(`- ${lifecycle}: ${count}`);
+            }
+        }
+        if (Object.keys(stats.edgesByType).length > 0) {
+            lines.push('\n### Edges by Type');
+            for (const [type, count] of Object.entries(stats.edgesByType)) {
+                lines.push(`- ${type}: ${count}`);
+            }
+        }
+        if (stats.danglingRefs.length > 0) {
+            lines.push(`\n### Dangling KB References (${stats.danglingRefs.length})`);
+            for (const ref of stats.danglingRefs.slice(0, 10)) {
+                lines.push(`- ${ref}`);
+            }
+            if (stats.danglingRefs.length > 10) {
+                lines.push(`... and ${stats.danglingRefs.length - 10} more`);
+            }
+        }
+        if (stats.danglingCodeRefs.length > 0) {
+            lines.push(`\n### Dangling Code References (${stats.danglingCodeRefs.length})`);
+            for (const ref of stats.danglingCodeRefs.slice(0, 10)) {
+                lines.push(`- ${ref.nodeId} → ${ref.address}`);
+            }
+            if (stats.danglingCodeRefs.length > 10) {
+                lines.push(`... and ${stats.danglingCodeRefs.length - 10} more`);
+            }
+        }
+        return textResult(lines.join('\n'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to get knowledge stats: ${message}`);
+    }
+}
+// Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
+// export async function handleGitChurn(args: GitChurnArgs): Promise<ToolResult> { ... }
+// export async function handleGitCoChange(args: GitCoChangeArgs): Promise<ToolResult> { ... }
+// export async function handleGitOwnership(args: GitOwnershipArgs): Promise<ToolResult> { ... }
+// export async function handleGitArchaeology(args: GitArchaeologyArgs): Promise<ToolResult> { ... }
+//# sourceMappingURL=knowledge-handlers.js.map

package/dist/handlers/knowledge-handlers.js.map

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

package/dist/handlers/notation-handlers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Notation Handlers — describe tool
+ */
+import type { ToolResult, DescribeArgs } from '../types.js';
+export declare function handleDescribe(args: DescribeArgs): Promise<ToolResult>;
+//# sourceMappingURL=notation-handlers.d.ts.map

package/dist/handlers/notation-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notation-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/notation-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CA0DrB"}

package/dist/handlers/notation-handlers.js

@@ -0,0 +1,53 @@
+/**
+ * MCP Notation Handlers — describe tool
+ */
+import { ensureAnalyzed } from '../analysis.js';
+import { renderNotation, extractSubgraph, PERSPECTIVES, generateLegend, isGrafemaUri, toCompactSemanticId } from '@grafema/util';
+import { textResult, errorResult } from '../utils.js';
+export async function handleDescribe(args) {
+    const db = await ensureAnalyzed();
+    const { target, depth = 1, perspective } = args;
+    // Step 1: Resolve target → node ID
+    let node = await db.getNode(target);
+    // If not found by semantic ID, try queryNodes for file path or name
+    if (!node) {
+        // Try as file path (MODULE node)
+        for await (const n of db.queryNodes({ file: target, type: 'MODULE' })) {
+            node = n;
+            break;
+        }
+    }
+    if (!node) {
+        // Try by name (any type)
+        for await (const n of db.queryNodes({ name: target })) {
+            node = n;
+            break;
+        }
+    }
+    if (!node) {
+        const displayTarget = isGrafemaUri(target) ? toCompactSemanticId(target) : target;
+        return errorResult(`Target not found: "${displayTarget}"\n` +
+            `Try: semantic ID (from find_nodes), file path, or node name.`);
+    }
+    // Step 2: Extract subgraph
+    const subgraph = await extractSubgraph(db, node.id, depth);
+    // Step 3: Build options
+    const options = {
+        depth,
+        includeLocations: depth >= 2,
+    };
+    if (perspective && PERSPECTIVES[perspective]) {
+        options.archetypeFilter = PERSPECTIVES[perspective];
+    }
+    // Step 4: Render
+    const notation = renderNotation(subgraph, options);
+    if (!notation.trim()) {
+        return textResult(`[${node.type}] ${node.name ?? node.id}\nNo relationships found at depth=${depth}.`);
+    }
+    // Append legend (generated from archetypes.ts — single source of truth) + LOD hint
+    const depthHint = depth < 3
+        ? `Showing depth=${depth}. Use depth=${depth + 1} for more detail.`
+        : `Showing depth=${depth}.`;
+    return textResult(`${notation}\n\n${generateLegend()}\n${depthHint}`);
+}
+//# sourceMappingURL=notation-handlers.js.map

package/dist/handlers/notation-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notation-handlers.js","sourceRoot":"","sources":["../../src/handlers/notation-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEjI,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAkB;IAElB,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAEhD,mCAAmC;IACnC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,iCAAiC;QACjC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACtE,IAAI,GAAG,CAAC,CAAC;YACT,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,yBAAyB;QACzB,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,CAAC;YACT,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAClF,OAAO,WAAW,CAChB,sBAAsB,aAAa,KAAK;YACxC,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAE3D,wBAAwB;IACxB,MAAM,OAAO,GAAoB;QAC/B,KAAK;QACL,gBAAgB,EAAE,KAAK,IAAI,CAAC;KAC7B,CAAC;IACF,IAAI,WAAW,IAAI,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,iBAAiB;IACjB,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEnD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,UAAU,CACf,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,qCAAqC,KAAK,GAAG,CACpF,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC;QACzB,CAAC,CAAC,iBAAiB,KAAK,eAAe,KAAK,GAAG,CAAC,mBAAmB;QACnE,CAAC,CAAC,iBAAiB,KAAK,GAAG,CAAC;IAE9B,OAAO,UAAU,CAAC,GAAG,QAAQ,OAAO,cAAc,EAAE,KAAK,SAAS,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/handlers/project-handlers.js

@@ -2,7 +2,7 @@
  * MCP Project Handlers
  */
 import { getProjectPath } from '../state.js';
-import { validateServices, validatePatterns, validateWorkspace, GRAFEMA_VERSION, getSchemaVersion } from '@grafema/core';
+import { validateServices, validatePatterns, validateWorkspace, GRAFEMA_VERSION, getSchemaVersion } from '@grafema/util';
 import { existsSync, readdirSync, statSync, writeFileSync, mkdirSync } from 'fs';
 import { join, basename } from 'path';
 import { stringify as stringifyYAML } from 'yaml';

package/dist/handlers/query-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/query-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EAId,MAAM,aAAa,CAAC;AAIrB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA0E9E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiD9E"}
+{"version":3,"file":"query-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/query-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EAId,MAAM,aAAa,CAAC;AAIrB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA0LhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiF9E;AAgDD,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAkD9E"}