@orchestrator-claude/mcp-server 3.31.0 → 3.31.1

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

@@ -4,34 +4,30 @@
  * Handlers for GraphRAG tools (searchByEmbedding, enrichContext, findMandatoryPatterns).
  */
 import type { IOrchestratorApiClient } from '../client/types.js';
+interface McpTextContent {
+    type: 'text';
+    text: string;
+}
+type McpResponse = {
+    content: McpTextContent[];
+} | {
+    content: McpTextContent[];
+    isError: true;
+};
 export declare function createSearchByEmbeddingHandler(client: IOrchestratorApiClient): (args: {
     query: string;
     limit?: number;
     threshold?: number;
     tags?: string[];
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 export declare function createEnrichContextHandler(client: IOrchestratorApiClient): (args: {
     query: string;
     maxDocuments?: number;
     includeGraph?: boolean;
     includeVector?: boolean;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 export declare function createFindMandatoryPatternsHandler(client: IOrchestratorApiClient): (args: {
     artifactType: string;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
+export {};
 //# sourceMappingURL=graphrag-handlers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphrag-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/graphrag-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAuBjE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,sBAAsB,IAC7D,MAAM;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;;;;;GAYF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,IACzD,MAAM;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;;;;;GAYF;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,sBAAsB,IACjE,MAAM;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE;;;;;GAQ7C"}
+{"version":3,"file":"graphrag-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/graphrag-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,KAAK,WAAW,GAAG;IAAE,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAsBhG,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IACR,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,KAAK,OAAO,CAAC,WAAW,CAAC,CAkBzB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IACR,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,KAAK,OAAO,CAAC,WAAW,CAAC,CAkBzB;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAS1D"}

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

@@ -1 +1 @@
-{"version":3,"file":"graphrag-handlers.js","sourceRoot":"","sources":["../../src/handlers/graphrag-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,SAAS,cAAc,CAAC,IAAa;IACnC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA8B;IAC3E,OAAO,KAAK,EAAE,IAKb,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE;gBACxD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAA8B;IACvE,OAAO,KAAK,EAAE,IAKb,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE;gBACpD,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC;YACH,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,MAA8B;IAC/E,OAAO,KAAK,EAAE,IAA8B,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACrE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"graphrag-handlers.js","sourceRoot":"","sources":["../../src/handlers/graphrag-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQvD,SAAS,cAAc,CAAC,IAAa;IACnC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAA8B;IAO9B,OAAO,KAAK,EAAE,IAKb,EAAwB,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE;gBACxD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAA8B;IAO9B,OAAO,KAAK,EAAE,IAKb,EAAwB,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE;gBACpD,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC;YACH,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,MAA8B;IAE9B,OAAO,KAAK,EAAE,IAA8B,EAAwB,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACrE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

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

@@ -4,37 +4,32 @@
  * Handlers for Hook-related MCP tools (listHooks, getHook, getHookBySlug, createHook, updateHook, deprecateHook).
  */
 import type { IOrchestratorApiClient } from '../client/types.js';
+interface McpTextContent {
+    type: 'text';
+    text: string;
+}
+type McpResponse = {
+    content: McpTextContent[];
+} | {
+    content: McpTextContent[];
+    isError: true;
+};
 /**
  * Creates handler for listHooks tool
  */
-export declare function createListHooksHandler(client: IOrchestratorApiClient): () => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+export declare function createListHooksHandler(client: IOrchestratorApiClient): () => Promise<McpResponse>;
 /**
  * Creates handler for getHook tool
  */
 export declare function createGetHookHandler(client: IOrchestratorApiClient): (args: {
     id: string;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 /**
  * Creates handler for getHookBySlug tool
  */
 export declare function createGetHookBySlugHandler(client: IOrchestratorApiClient): (args: {
     slug: string;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 /**
  * Creates handler for createHook tool
  */
@@ -48,12 +43,7 @@ export declare function createCreateHookHandler(client: IOrchestratorApiClient):
     handlerConfig: unknown;
     agent?: string;
     enabled?: boolean;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 /**
  * Creates handler for updateHook tool
  */
@@ -61,21 +51,12 @@ export declare function createUpdateHookHandler(client: IOrchestratorApiClient):
     id: string;
     enabled?: boolean;
     description?: string;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
 /**
  * Creates handler for deprecateHook tool
  */
 export declare function createDeprecateHookHandler(client: IOrchestratorApiClient): (args: {
     id: string;
-}) => Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
+}) => Promise<McpResponse>;
+export {};
 //# sourceMappingURL=hooks-handlers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hooks-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/hooks-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAyBjE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB;;;;;GASpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,IACnD,MAAM;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;GAQnC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,IACzD,MAAM;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;GAQrC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,IACtD,MAAM;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;;;;;GAQF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,IACtD,MAAM;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAY5E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,IACzD,MAAM;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;GAQnC"}
+{"version":3,"file":"hooks-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/hooks-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,KAAK,WAAW,GAAG;IAAE,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAwBhG;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CASjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAShD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CASlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAK,OAAO,CAAC,WAAW,CAAC,CAmBzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAiBzF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAShD"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqlC5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI,CAO/G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAotC5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,OAAe,GACvB,IAAI,CAON"}

package/dist/handlers/index.js

@@ -11,7 +11,7 @@ import { z } from 'zod';
 // Workflow handlers
 import { createDetectWorkflowHandler, createStartWorkflowHandler, createAdvancePhaseHandler, createGetStatusHandler, createGetWorkflowsHandler, createCompleteWorkflowHandler, createCreatePhaseHandler, } from './workflow-handlers.js';
 // Gate handlers
-import { createCreateCheckpointHandler, createValidateArtifactHandler, } from './gate-handlers.js';
+import { createCreateCheckpointHandler, createValidateArtifactHandler } from './gate-handlers.js';
 // Pending action handlers
 import { createGetNextActionHandler, createSetPendingActionHandler, createClearPendingActionHandler, createApproveActionHandler, } from './pending-action-handlers.js';
 // Metrics handlers
@@ -25,7 +25,7 @@ import { createListTemplatesHandler, createGetTemplateByIdHandler, createCreateT
 // Schema handlers
 import { createListSchemasHandler, createGetSchemaHandler, createCreateSchemaHandler, createUpdateSchemaHandler, createDeleteSchemaHandler, } from './schemas-handlers.js';
 // Pattern handlers
-import { createListPatternsHandler, createGetPatternHandler, } from './patterns-handlers.js';
+import { createListPatternsHandler, createGetPatternHandler } from './patterns-handlers.js';
 // Checkpoint handlers
 import { createListCheckpointsHandler, createGetCheckpointHandler, } from './checkpoints-handlers.js';
 // WorkflowDefinition handlers
@@ -45,7 +45,7 @@ import { createAddKBRelationshipHandler, createGetRelatedDocumentsHandler, creat
 // GraphRAG handlers
 import { createSearchByEmbeddingHandler, createEnrichContextHandler, createFindMandatoryPatternsHandler, } from './graphrag-handlers.js';
 // Stack Conventions handlers (RFC-026 Sprint 2)
-import { createGetStackConventionsHandler, } from './stack-conventions-handlers.js';
+import { createGetStackConventionsHandler } from './stack-conventions-handlers.js';
 import { createValidatePackFreshnessHandler } from './freshness-handlers.js';
 /**
  * Registers core tools (~59 tools) — workflow, context, gates, pending actions,
@@ -63,17 +63,40 @@ function registerCoreTools(server, client) {
     server.registerTool('startWorkflow', {
         description: 'Start a new workflow',
         inputSchema: z.object({
-            type: z.string().describe('Workflow type: feature_development, bug_fix, refactoring, emergency_debug, or dynamic'),
+            type: z
+                .string()
+                .describe('Workflow type: feature_development, bug_fix, refactoring, emergency_debug, project_management_enterprise, or dynamic'),
             prompt: z.string().describe('User prompt or feature description'),
-            title: z.string().optional().describe('Human-readable title for the workflow (ADR-017 Phase 2)'),
-            executionMode: z.string().optional().describe('Execution mode for dynamic workflows, e.g. "llm-driven" (ADR-017 Phase 2)'),
+            title: z
+                .string()
+                .optional()
+                .describe('Human-readable title for the workflow (ADR-017 Phase 2)'),
+            executionMode: z
+                .string()
+                .optional()
+                .describe('Execution mode for dynamic workflows, e.g. "llm-driven" (ADR-017 Phase 2)'),
+            variant: z
+                .string()
+                .optional()
+                .describe('RFC-031 variant selector for the workflow type, e.g. "cirurgico" for ' +
+                'project_management_enterprise. Omit for default (full) execution.'),
+            inputs: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('RFC-031 required_inputs key-value map for the selected variant. ' +
+                'Keys and expected values depend on the variant definition. ' +
+                'Example for project_management_enterprise variant=cirurgico: ' +
+                '{ "framework": "<artifact_ref>", "scope": "<file_ref>" }.'),
         }),
     }, createStartWorkflowHandler(client));
     server.registerTool('advancePhase', {
         description: 'Advance workflow to next phase',
         inputSchema: z.object({
             workflowId: z.string().describe('Workflow ID'),
-            targetPhase: z.string().optional().describe('Target phase name (research, specify, plan, implement, validate)'),
+            targetPhase: z
+                .string()
+                .optional()
+                .describe('Target phase name. Free-form workflow phase — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Workflow-type-specific; future phases accepted.'),
         }),
     }, createAdvancePhaseHandler(client));
     server.registerTool('getStatus', {
@@ -111,24 +134,47 @@ function registerCoreTools(server, client) {
         description: 'Set a pending action for workflow',
         inputSchema: z.object({
             workflowId: z.string().describe('Workflow ID'),
-            action: z.object({
-                agent: z.string().describe('Agent name (specifier, planner, task-generator, implementer, researcher, reviewer)'),
+            action: z
+                .object({
+                agent: z
+                    .string()
+                    .describe('Agent name (specifier, planner, task-generator, implementer, researcher, reviewer)'),
                 prompt: z.string().describe('Prompt/instructions for the agent'),
-                expectedOutput: z.object({
-                    artifact: z.string().describe('Artifact type (specification, plan, tasks, implementation-report)'),
-                    phase: z.string().describe('Workflow phase (research, specify, plan, tasks, implement)'),
-                    contentType: z.string().optional().default('markdown').describe('Content type (markdown, yaml, json)'),
-                }).describe('Expected output configuration (REQUIRED)'),
-                inputArtifacts: z.array(z.string()).optional().describe('List of input artifact paths to provide as context'),
-                requiresApproval: z.boolean().optional().describe('Whether action requires user approval before execution'),
-            }).describe('Pending action details'),
+                expectedOutput: z
+                    .object({
+                    artifact: z
+                        .string()
+                        .describe('Artifact type (specification, plan, tasks, implementation-report)'),
+                    phase: z
+                        .string()
+                        .describe('Workflow phase. Free-form — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Workflow-type-specific; future phases accepted.'),
+                    contentType: z
+                        .string()
+                        .optional()
+                        .default('markdown')
+                        .describe('Content type (markdown, yaml, json)'),
+                })
+                    .describe('Expected output configuration (REQUIRED)'),
+                inputArtifacts: z
+                    .array(z.string())
+                    .optional()
+                    .describe('List of input artifact paths to provide as context'),
+                requiresApproval: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether action requires user approval before execution'),
+            })
+                .describe('Pending action details'),
         }),
     }, createSetPendingActionHandler(client));
     server.registerTool('clearPendingAction', {
         description: 'Clear pending action for workflow',
         inputSchema: z.object({
             workflowId: z.string().describe('Workflow ID'),
-            result: z.record(z.string(), z.unknown()).optional().describe('Optional result data from action completion'),
+            result: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Optional result data from action completion'),
         }),
     }, createClearPendingActionHandler(client));
     server.registerTool('approveAction', {
@@ -155,14 +201,18 @@ function registerCoreTools(server, client) {
         description: 'Start tracking an agent invocation',
         inputSchema: z.object({
             agentName: z.string().describe('Name of the agent'),
-            phase: z.string().describe('Workflow phase'),
+            phase: z
+                .string()
+                .describe('Workflow phase. Free-form — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Workflow-type-specific; future phases accepted.'),
             workflowId: z.string().optional().describe('Workflow ID (optional)'),
         }),
     }, createStartAgentInvocationHandler(client));
     server.registerTool('completeAgentInvocation', {
         description: 'Mark agent invocation as complete',
         inputSchema: z.object({
-            invocationId: z.string().describe('Invocation ID'),
+            invocationId: z
+                .string()
+                .describe('Invocation ID. Free-form string — UUID is conventional but not required (e.g. `s199-step-b-auditor` is accepted for human-tagged invocations).'),
             status: z.string().describe('Completion status (completed, failed, etc.)'),
             summary: z.string().optional().describe('Optional summary of invocation result'),
         }),
@@ -172,8 +222,14 @@ function registerCoreTools(server, client) {
         description: 'Search the knowledge base',
         inputSchema: z.object({
             query: z.string().optional().describe('Search query string'),
-            tier: z.string().optional().describe('Filter by tier (critical, foundational, operational, reference)'),
-            category: z.string().optional().describe('Filter by category (architecture, patterns, conventions, workflows, agents, governance)'),
+            tier: z
+                .string()
+                .optional()
+                .describe('Filter by tier (critical, foundational, operational, reference)'),
+            category: z
+                .string()
+                .optional()
+                .describe('Filter by category (architecture, patterns, conventions, workflows, agents, governance)'),
             tags: z.string().optional().describe('Comma-separated list of tags to filter by'),
             limit: z.number().optional().describe('Maximum results to return'),
         }),
@@ -241,7 +297,10 @@ function registerCoreTools(server, client) {
     server.registerTool('listTemplates', {
         description: 'List all templates, optionally filtered by type and domain',
         inputSchema: z.object({
-            type: z.string().optional().describe('Filter by template type (specification, plan, tasks, etc.)'),
+            type: z
+                .string()
+                .optional()
+                .describe('Filter by template type (specification, plan, tasks, etc.)'),
             domain: z.string().optional().describe('Filter by domain (orchestrator, workflow, etc.)'),
         }),
     }, createListTemplatesHandler(client));
@@ -267,7 +326,10 @@ function registerCoreTools(server, client) {
         inputSchema: z.object({
             id: z.string().describe('Template ID'),
             content: z.string().optional().describe('Updated template content'),
-            variables: z.record(z.string(), z.unknown()).optional().describe('Updated variables schema'),
+            variables: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Updated variables schema'),
         }),
     }, createUpdateTemplateHandler(client));
     server.registerTool('deleteTemplate', {
@@ -293,7 +355,9 @@ function registerCoreTools(server, client) {
             name: z.string().describe('Schema name'),
             version: z.string().describe('Schema version (semver)'),
             jsonSchema: z.record(z.string(), z.unknown()).describe('JSON Schema definition'),
-            targetArtifactType: z.string().describe('Target artifact type (specification, plan, tasks, etc.)'),
+            targetArtifactType: z
+                .string()
+                .describe('Target artifact type (specification, plan, tasks, etc.)'),
             description: z.string().optional().describe('Schema description'),
         }),
     }, createCreateSchemaHandler(client));
@@ -314,7 +378,10 @@ function registerCoreTools(server, client) {
     server.registerTool('listPatterns', {
         description: 'List all code patterns, optionally filtered by language and framework',
         inputSchema: z.object({
-            language: z.string().optional().describe('Filter by programming language (typescript, python, etc.)'),
+            language: z
+                .string()
+                .optional()
+                .describe('Filter by programming language (typescript, python, etc.)'),
             framework: z.string().optional().describe('Filter by framework (express, fastify, etc.)'),
         }),
     }, createListPatternsHandler(client));
@@ -342,16 +409,26 @@ function registerCoreTools(server, client) {
         description: 'Create a new workflow definition',
         inputSchema: z.object({
             name: z.string().describe('Workflow definition name'),
-            type: z.string().describe('Workflow type (feature_development, bug_fix, refactoring, etc.)'),
-            phases: z.array(z.string()).describe('List of phases (research, specify, plan, tasks, implement)'),
-            defaultConfig: z.record(z.string(), z.unknown()).optional().describe('Default configuration object'),
+            type: z
+                .string()
+                .describe('Workflow type (feature_development, bug_fix, refactoring, etc.)'),
+            phases: z
+                .array(z.string())
+                .describe('List of workflow phases. Free-form phase names — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Define any subset appropriate for the workflow type.'),
+            defaultConfig: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Default configuration object'),
         }),
     }, createCreateWorkflowDefinitionHandler(client));
     server.registerTool('updateWorkflowDefinition', {
         description: 'Update an existing workflow definition',
         inputSchema: z.object({
             id: z.string().describe('Workflow definition ID'),
-            defaultConfig: z.record(z.string(), z.unknown()).optional().describe('Updated default configuration'),
+            defaultConfig: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Updated default configuration'),
             phases: z.array(z.string()).optional().describe('Updated phases list'),
         }),
     }, createUpdateWorkflowDefinitionHandler(client));
@@ -454,7 +531,10 @@ function registerCoreTools(server, client) {
         inputSchema: z.object({
             id: z.string().describe('Skill definition ID'),
             description: z.string().optional().describe('Updated description'),
-            handler: z.record(z.string(), z.unknown()).optional().describe('Updated handler configuration'),
+            handler: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Updated handler configuration'),
         }),
     }, createUpdateSkillDefinitionHandler(client));
     server.registerTool('deleteSkillDefinition', {
@@ -471,7 +551,10 @@ function registerCoreTools(server, client) {
             title: z.string().describe('Document title'),
             content: z.string().describe('Document content (markdown)'),
             tier: z.string().describe('Document tier (critical, foundational, operational, reference)'),
-            category: z.string().optional().describe('Document category (architecture, patterns, etc.)'),
+            category: z
+                .string()
+                .optional()
+                .describe('Document category (architecture, patterns, etc.)'),
             tags: z.array(z.string()).optional().describe('Document tags'),
         }),
     }, createCreateKBDocumentHandler(client));
@@ -503,7 +586,10 @@ function registerExtendedTools(server, client) {
             workflowId: z.string().describe('Workflow ID (must be a dynamic workflow)'),
             name: z.string().describe('Phase name, e.g. "scan", "implement", "validate"'),
             budgetUsd: z.number().optional().describe('Optional budget cap in USD for this phase'),
-            metadata: z.record(z.string(), z.unknown()).optional().describe('Optional metadata for the phase'),
+            metadata: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Optional metadata for the phase'),
         }),
     }, createCreatePhaseHandler(client));
     server.registerTool('completeWorkflow', {
@@ -517,7 +603,9 @@ function registerExtendedTools(server, client) {
         description: 'Store artifact content for a workflow phase',
         inputSchema: z.object({
             workflowId: z.string().describe('Workflow ID'),
-            phase: z.string().describe('Workflow phase (specify, plan, tasks, implement)'),
+            phase: z
+                .string()
+                .describe('Workflow phase. Free-form — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Workflow-type-specific; future phases accepted.'),
             content: z.string().describe('Artifact content'),
             type: z.string().describe('Artifact type (specification, plan, tasks, etc.)'),
             contentType: z.string().optional().describe('Content MIME type (default: text/markdown)'),
@@ -551,9 +639,13 @@ function registerExtendedTools(server, client) {
         description: 'Correct artifact content for a past phase (admin-only, bypasses phase gate). Requires correctionReason for audit trail.',
         inputSchema: z.object({
             workflowId: z.string().describe('Workflow ID'),
-            phase: z.string().describe('Workflow phase to correct (specify, plan, tasks, implement)'),
+            phase: z
+                .string()
+                .describe('Workflow phase to correct. Free-form — examples: discovery, research, specify, plan, tasks, framework, operational, implement, deliver, review, validation, calibration, governance. Workflow-type-specific; future phases accepted.'),
             content: z.string().describe('Corrected artifact content'),
-            type: z.string().describe('Artifact type (specification, plan, tasks, implementation-report)'),
+            type: z
+                .string()
+                .describe('Artifact type (specification, plan, tasks, implementation-report)'),
             correctionReason: z.string().describe('Reason for correction (required for audit trail)'),
             contentType: z.string().optional().describe('Content MIME type (default: text/markdown)'),
             metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata'),
@@ -614,16 +706,26 @@ function registerExtendedTools(server, client) {
     server.registerTool('getStackConventions', {
         description: 'Get detailed stack conventions for the current project from the Vault KB. Use when baseline context is insufficient — e.g. when you need framework-specific patterns for testing, routing, or error handling.',
         inputSchema: z.object({
-            pack: z.string().describe('Convention pack ID (from PatternSet conventions_pack field, e.g. "node-bun-typescript")'),
-            topic: z.string().optional().describe('Filter by topic (e.g. "testing", "error-handling", "file-structure"). Omit for all conventions.'),
+            pack: z
+                .string()
+                .describe('Convention pack ID (from PatternSet conventions_pack field, e.g. "node-bun-typescript")'),
+            topic: z
+                .string()
+                .optional()
+                .describe('Filter by topic (e.g. "testing", "error-handling", "file-structure"). Omit for all conventions.'),
         }),
     }, createGetStackConventionsHandler(client));
     // Pack Freshness Validation Tool (RFC-026 Sprint 5)
     server.registerTool('validatePackFreshness', {
         description: 'Validate convention pack content against official documentation via Context7 + semantic comparison. Returns per-section freshness status (fresh/stale/unknown) with confidence scores.',
         inputSchema: z.object({
-            pack: z.string().describe('Convention pack ID (e.g. "react-native-expo", "node-bun-typescript")'),
-            sections: z.array(z.string()).optional().describe('Specific sections to validate (e.g. ["Expo Router", "Testing"]). Omit for all sections.'),
+            pack: z
+                .string()
+                .describe('Convention pack ID (e.g. "react-native-expo", "node-bun-typescript")'),
+            sections: z
+                .array(z.string())
+                .optional()
+                .describe('Specific sections to validate (e.g. ["Expo Router", "Testing"]). Omit for all sections.'),
         }),
     }, createValidatePackFreshnessHandler(client));
 }