@grafema/mcp 0.3.28 → 0.3.31

package/src/handlers/index.ts

@@ -14,7 +14,7 @@ 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 { handleRemember, handleRecall, handleSemanticSearch, handleExploreEntity, handleAddAssertion, handleUpdateAssertion, handleDeleteAssertion, handleEnoxQuery, handleEnoxTraverse, handleEnoxStats, handleRecentActivity, handleUpdateNode, handleCrawlEntity, handleSaveDocument } from './enox-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';

package/src/handlers/query-handlers.ts

@@ -524,22 +524,35 @@ async function enrichNodes(
 
 /** Convert a semantic ID to human-readable "name in file.ts" format.
  * Handles: grafema://host/path/file.ts#TYPE->name[scope], path/file.ts#TYPE->name,
- * TYPE-%3Ename (URL-encoded, no file prefix), or raw node IDs. */
-function humanReadableId(semanticId: string): string {
+ * TYPE-%3Ename (URL-encoded, no file prefix), or raw node IDs.
+ *
+ * Exported for unit testing.
+ * @internal */
+export function humanReadableId(semanticId: string): string {
   if (!semanticId) return '?';
-  // Decode URI components first
-  let id = semanticId;
-  try { id = decodeURIComponent(id); } catch { /* keep as-is */ }
-
-  // Find the # separator between file path and node descriptor
-  const hashIdx = id.lastIndexOf('#');
-  let filePart = '';
-  let nodePart = id;
+
+  // Split file path from node descriptor on the FIRST literal '#' of the RAW
+  // (still percent-encoded) id, BEFORE decoding. The grafema:// URI form encodes
+  // the disambiguation counter ('#N', appended by computeSemanticIdV2 for hash
+  // collisions) as '%23N' inside the fragment. Decoding first and then splitting
+  // on the LAST '#' would mistake that counter for the path/fragment boundary and
+  // corrupt the label. A file path never contains a literal '#'. This mirrors the
+  // canonical parseSemanticIdV2 (packages/util/src/core/SemanticId.ts).
+  const hashIdx = semanticId.indexOf('#');
+  let rawFile = '';
+  let rawNode = semanticId;
   if (hashIdx !== -1) {
-    filePart = id.slice(0, hashIdx);
-    nodePart = id.slice(hashIdx + 1);
+    rawFile = semanticId.slice(0, hashIdx);
+    rawNode = semanticId.slice(hashIdx + 1);
   }
 
+  const decode = (s: string): string => {
+    try { return decodeURIComponent(s); } catch { return s; }
+  };
+  const filePart = decode(rawFile);
+  // Strip the trailing disambiguation counter ('#N') from the decoded descriptor.
+  const nodePart = decode(rawNode).replace(/#\d+$/, '');
+
   const fileName = filePart ? (filePart.split('/').pop() || '') : '';
 
   // Extract name from TYPE->name or TYPE->name[in:scope,h:hash]

package/src/server.ts

@@ -67,11 +67,6 @@ import {
   handleGetNode,
   handleGetNeighbors,
   handleTraverseGraph,
-  handleAddKnowledge,
-  handleQueryKnowledge,
-  handleQueryDecisions,
-  handleSupersedeFact,
-  handleGetKnowledgeStats,
   // Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
   // handleGitChurn,
   // handleGitCoChange,
@@ -83,6 +78,20 @@ import {
   handleExplain,
   handleTraceEffects,
   handleFindSharedBehaviors,
+  handleRemember,
+  handleRecall,
+  handleSemanticSearch,
+  handleExploreEntity,
+  handleAddAssertion,
+  handleUpdateAssertion,
+  handleDeleteAssertion,
+  handleEnoxQuery,
+  handleEnoxTraverse,
+  handleEnoxStats,
+  handleRecentActivity,
+  handleUpdateNode,
+  handleCrawlEntity,
+  handleSaveDocument,
 } from './handlers/index.js';
 import type { ExplainArgs } from './handlers/index.js';
 import type {
@@ -112,10 +121,6 @@ import type {
   GetNodeArgs,
   GetNeighborsArgs,
   TraverseGraphArgs,
-  AddKnowledgeArgs,
-  QueryKnowledgeArgs,
-  QueryDecisionsArgs,
-  SupersedeFactArgs,
   // Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
   // GitChurnArgs,
   // GitCoChangeArgs,
@@ -127,6 +132,21 @@ import type {
   QueryRegistryArgs,
   FindSharedBehaviorsArgs,
 } from './types.js';
+import type {
+  RememberArgs,
+  RecallArgs,
+  SemanticSearchArgs,
+  ExploreEntityArgs,
+  AddAssertionArgs,
+  UpdateAssertionArgs,
+  DeleteAssertionArgs,
+  QueryGraphKnowledgeArgs,
+  TraverseArgs as EnoxTraverseArgs,
+  RecentActivityArgs,
+  UpdateNodeArgs as EnoxUpdateNodeArgs,
+  CrawlEntityArgs,
+  SaveDocumentArgs,
+} from './handlers/enox-handlers.js';
 
 /**
  * Type-safe argument casting helper.
@@ -358,26 +378,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         result = await handleTraverseGraph(asArgs<TraverseGraphArgs>(args));
         break;
 
-      case 'add_knowledge':
-        result = await handleAddKnowledge(asArgs<AddKnowledgeArgs>(args));
-        break;
-
-      case 'query_knowledge':
-        result = await handleQueryKnowledge(asArgs<QueryKnowledgeArgs>(args));
-        break;
-
-      case 'query_decisions':
-        result = await handleQueryDecisions(asArgs<QueryDecisionsArgs>(args));
-        break;
-
-      case 'supersede_fact':
-        result = await handleSupersedeFact(asArgs<SupersedeFactArgs>(args));
-        break;
-
-      case 'get_knowledge_stats':
-        result = await handleGetKnowledgeStats();
-        break;
-
       // Disabled: requires git-ingest (US-17). See US-17 in AI-AGENT-STORIES.md
       // case 'git_churn':
       //   result = await handleGitChurn(asArgs<GitChurnArgs>(args));
@@ -411,6 +411,63 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         result = await handleFindSharedBehaviors(asArgs<FindSharedBehaviorsArgs>(args));
         break;
 
+      // === Enox knowledge graph ===
+      case 'remember':
+        result = await handleRemember(asArgs<RememberArgs>(args));
+        break;
+
+      case 'recall':
+        result = await handleRecall(asArgs<RecallArgs>(args));
+        break;
+
+      case 'semantic_search':
+        result = await handleSemanticSearch(asArgs<SemanticSearchArgs>(args));
+        break;
+
+      case 'enox_explore':
+        result = await handleExploreEntity(asArgs<ExploreEntityArgs>(args));
+        break;
+
+      case 'add_assertion':
+        result = await handleAddAssertion(asArgs<AddAssertionArgs>(args));
+        break;
+
+      case 'update_assertion':
+        result = await handleUpdateAssertion(asArgs<UpdateAssertionArgs>(args));
+        break;
+
+      case 'delete_assertion':
+        result = await handleDeleteAssertion(asArgs<DeleteAssertionArgs>(args));
+        break;
+
+      case 'enox_query':
+        result = await handleEnoxQuery(asArgs<QueryGraphKnowledgeArgs>(args));
+        break;
+
+      case 'enox_traverse':
+        result = await handleEnoxTraverse(asArgs<EnoxTraverseArgs>(args));
+        break;
+
+      case 'enox_stats':
+        result = await handleEnoxStats();
+        break;
+
+      case 'recent_activity':
+        result = await handleRecentActivity(asArgs<RecentActivityArgs>(args));
+        break;
+
+      case 'update_node':
+        result = await handleUpdateNode(asArgs<EnoxUpdateNodeArgs>(args));
+        break;
+
+      case 'crawl_entity':
+        result = await handleCrawlEntity(asArgs<CrawlEntityArgs>(args));
+        break;
+
+      case 'save_document':
+        result = await handleSaveDocument(asArgs<SaveDocumentArgs>(args));
+        break;
+
       default:
         result = errorResult(`Unknown tool: ${name}`);
     }

package/src/types.ts

@@ -428,6 +428,84 @@ export interface SupersedeFactArgs {
   new_slug?: string;
 }
 
+// === ENOX ARGS (knowledge graph) ===
+
+export interface EnoxRememberArgs {
+  subject: string;
+  fact: string;
+  domain?: string;
+  confidence?: number;
+  relation?: string;
+}
+
+export interface EnoxRecallArgs {
+  query: string;
+  depth?: number;
+}
+
+export interface EnoxSemanticSearchArgs {
+  query: string;
+  top_k?: number;
+  domain?: string;
+  include_edges?: boolean;
+}
+
+export interface EnoxExploreArgs {
+  entity: string;
+}
+
+export interface EnoxAddAssertionArgs {
+  from: string;
+  relation: string;
+  to: string;
+  context?: string;
+  confidence?: number;
+  domain?: string;
+}
+
+export interface EnoxUpdateAssertionArgs {
+  fact_id: string;
+  context?: string;
+  confidence?: number;
+}
+
+export interface EnoxDeleteAssertionArgs {
+  fact_id: string;
+}
+
+export interface EnoxQueryGraphArgs {
+  type?: string;
+  domain?: string;
+  name?: string;
+  limit?: number;
+}
+
+export interface EnoxTraverseArgs {
+  start: string;
+  direction?: string;
+  edge_types?: string[];
+  max_depth?: number;
+}
+
+export interface EnoxRecentActivityArgs {
+  since?: string;
+  limit?: number;
+}
+
+export interface EnoxUpdateNodeArgs {
+  node_id: string;
+  name?: string;
+  domain?: string;
+  description?: string;
+}
+
+export interface EnoxSaveDocumentArgs {
+  title: string;
+  content: string;
+  doc_type?: string;
+  relates_to?: string[];
+}
+
 // === DESCRIBE ARGS (DSL notation) ===
 
 export interface DescribeArgs {

package/dist/definitions.d.ts

@@ -1,23 +0,0 @@
-/**
- * MCP Tool Definitions
- */
-interface SchemaProperty {
-    type: string;
-    description?: string;
-    enum?: string[];
-    items?: SchemaProperty;
-    properties?: Record<string, SchemaProperty>;
-    required?: string[];
-}
-export interface ToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: 'object';
-        properties: Record<string, SchemaProperty>;
-        required?: string[];
-    };
-}
-export declare const TOOLS: ToolDefinition[];
-export {};
-//# sourceMappingURL=definitions.d.ts.map

package/dist/definitions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,KAAK,EAAE,cAAc,EA+nBjC,CAAC"}