@qikdev/mcp 6.6.2 → 6.6.5

package/build/src/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Qik Platform MCP Server - Enhanced Version
+ * Qik Platform MCP Server - Enhanced Version with Comprehensive Documentation
  *
  * This MCP server provides comprehensive integration with the Qik platform,
  * enabling AI assistants to interact with Qik's content management system,
@@ -13,6 +13,35 @@
  * - Dynamic tool schema generation
  * - Comprehensive API coverage
  * - Intelligent request building and field validation
+ * - Advanced disambiguation logic for definitions vs instances
+ * - Workflow system documentation and automation
+ * - Comprehensive scope and permission management
+ *
+ * IMPORTANT QIK CONCEPTS:
+ *
+ * 1. DEFINITIONS vs INSTANCES:
+ *    - Definitions: Templates that define structure (e.g., "workflow definition", "content type definition")
+ *    - Instances: Actual content items created from definitions (e.g., "workflow card", "article instance")
+ *    - When user says "create a workflow" they usually mean create a workflow DEFINITION
+ *    - When user says "add Jim to workflow X" they mean create a workflow CARD instance
+ *
+ * 2. WORKFLOW SYSTEM:
+ *    - Workflow Definitions: Define the structure with columns, steps, automation
+ *    - Workflow Cards: Individual items that move through the workflow
+ *    - Columns: Represent stages in the workflow (e.g., "To Do", "In Progress", "Done")
+ *    - Steps: Specific positions within columns where cards can be placed
+ *    - Automation: Entry/exit/success/fail functions that run when cards move
+ *
+ * 3. SCOPE SYSTEM:
+ *    - Hierarchical permission structure (like folders)
+ *    - Every content item must belong to at least one scope
+ *    - Users need appropriate permissions within scopes to perform actions
+ *    - Scopes can inherit permissions from parent scopes
+ *
+ * 4. CONTENT TYPE SYSTEM:
+ *    - Base types: Core Qik types (article, profile, event, etc.)
+ *    - Extended types: Custom types that extend base types with additional fields
+ *    - Fields vs DefinedFields: Fields go at root level, definedFields go in data object
  */
 export declare class QikMCPServer {
     private server;
@@ -21,9 +50,11 @@ export declare class QikMCPServer {
     private userSession;
     private lastGlossaryUpdate;
     private readonly GLOSSARY_CACHE_TTL;
+    private serverName;
     constructor();
     private log;
     private initializeServer;
+    private loadServerName;
     private loadUserSession;
     private loadGlossary;
     private formatError;
@@ -44,7 +75,61 @@ export declare class QikMCPServer {
     private findContentTypeByDescription;
     private getAvailableScopes;
     private extractScopesWithPermissions;
+    private validateFilter;
+    private createBirthdayFilter;
+    private createDateRangeFilter;
+    private createGenderFilter;
+    private createAgeRangeFilter;
+    private createThisMonthBirthdayFilter;
+    private createRecentContentFilter;
+    private createScopeFilter;
+    private generateEnhancedFilterSchema;
+    /**
+     * Enhanced intelligent content creation with advanced disambiguation logic
+     *
+     * This method provides sophisticated analysis of user intent to distinguish between:
+     * - Creating workflow DEFINITIONS vs workflow CARD instances
+     * - Creating content type DEFINITIONS vs content INSTANCES
+     * - Understanding context clues like "add person to workflow" vs "create new workflow"
+     */
     private intelligentContentCreation;
+    /**
+     * Analyzes user intent to distinguish between different types of content creation
+     */
+    private analyzeUserIntent;
+    /**
+     * Handles workflow-specific disambiguation with comprehensive guidance
+     */
+    private handleWorkflowDisambiguation;
+    /**
+     * Handles cases where no content types match the description
+     */
+    private handleNoContentTypeMatches;
+    /**
+     * Categorizes content types for better organization in help text
+     */
+    private categorizeContentTypes;
+    /**
+     * Handles cases where multiple content types match
+     */
+    private handleMultipleContentTypeMatches;
+    /**
+     * Handles single content type match with comprehensive guidance
+     */
+    private handleSingleContentTypeMatch;
+    /**
+     * Analyzes content type structure for comprehensive information
+     */
+    private analyzeContentTypeStructure;
+    /**
+     * Handles content creation when data is provided
+     */
+    private handleContentCreationWithData;
+    /**
+     * Generates comprehensive creation guidance
+     */
+    private generateCreationGuidance;
+    private generateToolDescription;
     private setupToolHandlers;
     private getUserSession;
     private getGlossary;

package/build/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG;AAsIH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;;IAwCpD,OAAO,CAAC,GAAG;YAQG,gBAAgB;YAYhB,eAAe;YAUf,YAAY;IAuC1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,gCAAgC;IAkCxC,OAAO,CAAC,6BAA6B;IAkFrC,OAAO,CAAC,4BAA4B;YAKtB,kBAAkB;IAUhC,OAAO,CAAC,4BAA4B;YAoCtB,0BAA0B;IA8KxC,OAAO,CAAC,iBAAiB;YAsgBX,cAAc;YAad,WAAW;YAkGX,oBAAoB;YA+BpB,UAAU;YA6BV,WAAW;YAsCX,aAAa;YAmHb,aAAa;YAqBb,aAAa;YAoBb,YAAY;YAyBZ,aAAa;YA6Bb,OAAO;YAoBP,UAAU;YAoBV,UAAU;YAsCV,aAAa;YAiCb,SAAS;YAoBT,YAAY;IAoBpB,GAAG;CAKV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAwKH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IACpD,OAAO,CAAC,UAAU,CAAiB;;IAwCnC,OAAO,CAAC,GAAG;YAQG,gBAAgB;YAchB,cAAc;YAgBd,eAAe;YAUf,YAAY;IAuC1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,gCAAgC;IAkCxC,OAAO,CAAC,6BAA6B;IAkFrC,OAAO,CAAC,4BAA4B;YAKtB,kBAAkB;IAUhC,OAAO,CAAC,4BAA4B;IAqCpC,OAAO,CAAC,cAAc;IAoEtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;IAcrC,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,4BAA4B;IAqHpC;;;;;;;OAOG;YACW,0BAA0B;IAyBxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyDzB;;OAEG;YACW,4BAA4B;IA2J1C;;OAEG;YACW,0BAA0B;IAgDxC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;OAEG;YACW,gCAAgC;IAoD9C;;OAEG;YACW,4BAA4B;IAuD1C;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoCnC;;OAEG;YACW,6BAA6B;IAuC3C;;OAEG;YACW,wBAAwB;IAqCtC,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,iBAAiB;YAmnBX,cAAc;YAad,WAAW;YAkGX,oBAAoB;YA+BpB,UAAU;YA6BV,WAAW;YAsCX,aAAa;YAmHb,aAAa;YAqBb,aAAa;YAoBb,YAAY;YAyBZ,aAAa;YA6Bb,OAAO;YAoBP,UAAU;YAoBV,UAAU;YAsCV,aAAa;YAiCb,SAAS;YAoBT,YAAY;IAoBpB,GAAG;CAKV"}