sfcc-dev-mcp 1.0.15 → 1.0.19

package/tests/mcp/yaml/get-isml-element.docs-only.test.mcp.yml

@@ -0,0 +1,294 @@
+# ==================================================================================
+# SFCC MCP Server - get_isml_element Tool YAML Tests
+# Comprehensive testing for ISML element detail retrieval functionality
+# Tests element retrieval, filtering options, and error handling
+# 
+# Discovery Commands:
+# npx aegis query get_isml_element 'elementName:isif' --config "aegis.config.docs-only.json"
+# npx aegis query get_isml_element 'elementName:print' --config "aegis.config.docs-only.json"
+# npx aegis query get_isml_element 'elementName:nonexistent' --config "aegis.config.docs-only.json"
+# 
+# Quick Test Commands:
+# npx aegis "tests/mcp/yaml/get-isml-element.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --verbose
+# npx aegis "tests/mcp/yaml/get-isml-element.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --debug --timing
+# ==================================================================================
+description: "SFCC MCP Server get_isml_element tool - comprehensive validation"
+
+# ==================================================================================
+# BASIC TOOL STRUCTURE VALIDATION
+# ==================================================================================
+tests:
+  - it: "should list get_isml_element tool in available tools"
+    request:
+      jsonrpc: "2.0"
+      id: "tool-list-1"
+      method: "tools/list"
+      params: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "tool-list-1"
+        result:
+          tools:
+            match:arrayContains:name:get_isml_element
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# SUCCESSFUL ELEMENT RETRIEVAL TESTS
+# ==================================================================================
+  - it: "should retrieve isif element with full details"
+    request:
+      jsonrpc: "2.0"
+      id: "get-isif-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-isif-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:ISML Conditional Elements"
+          isError: false
+      performance:
+        maxResponseTime: "1000ms"
+      stderr: "toBeEmpty"
+
+  - it: "should retrieve isloop element details"
+    request:
+      jsonrpc: "2.0"
+      id: "get-isloop-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isloop"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-isloop-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isloop"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should retrieve isprint element details"
+    request:
+      jsonrpc: "2.0"
+      id: "get-isprint-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isprint"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-isprint-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isprint"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should normalize element name without is prefix"
+    request:
+      jsonrpc: "2.0"
+      id: "get-normalize-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "print"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-normalize-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isprint"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include section information"
+    request:
+      jsonrpc: "2.0"
+      id: "get-sections-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+          includeSections: true
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-sections-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:sections"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include attribute information"
+    request:
+      jsonrpc: "2.0"
+      id: "get-attributes-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isloop"
+          includeAttributes: true
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-attributes-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:attributes"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include full content by default"
+    request:
+      jsonrpc: "2.0"
+      id: "get-content-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+          includeContent: true
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "get-content-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:content"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# ERROR HANDLING TESTS
+# ==================================================================================
+  - it: "should return error for non-existent element"
+    request:
+      jsonrpc: "2.0"
+      id: "error-notfound-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "nonexistent"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "error-notfound-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:not found"
+          isError: true
+      performance:
+        maxResponseTime: "800ms"
+      stderr: "toBeEmpty"
+
+  - it: "should require elementName parameter"
+    request:
+      jsonrpc: "2.0"
+      id: "error-missing-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "error-missing-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:elementName"
+          isError: true
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# PERFORMANCE & RESOURCE VALIDATION
+# ==================================================================================
+  - it: "should complete element retrieval within performance SLA"
+    request:
+      jsonrpc: "2.0"
+      id: "perf-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "perf-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:type:string"
+          isError: false
+      performance:
+        maxResponseTime: "1000ms"
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# CONTENT VALIDATION TESTS
+# ==================================================================================
+  - it: "should return valid JSON object structure"
+    request:
+      jsonrpc: "2.0"
+      id: "json-valid-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "json-valid-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:regex:\\{[\\s\\S]*\\}"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include category information"
+    request:
+      jsonrpc: "2.0"
+      id: "category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_element"
+        arguments:
+          elementName: "isif"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:category"
+          isError: false
+      stderr: "toBeEmpty"

package/tests/mcp/yaml/get-isml-elements-by-category.docs-only.test.mcp.yml

@@ -0,0 +1,334 @@
+# ==================================================================================
+# SFCC MCP Server - get_isml_elements_by_category Tool YAML Tests
+# Comprehensive testing for ISML element category filtering functionality
+# Tests category-based filtering for all ISML element types
+# 
+# Discovery Commands:
+# npx aegis query get_isml_elements_by_category 'category:control-flow' --config "aegis.config.docs-only.json"
+# npx aegis query get_isml_elements_by_category 'category:output' --config "aegis.config.docs-only.json"
+# npx aegis query get_isml_elements_by_category 'category:scripting' --config "aegis.config.docs-only.json"
+# npx aegis query get_isml_elements_by_category 'category:payment' --config "aegis.config.docs-only.json"
+# 
+# Quick Test Commands:
+# npx aegis "tests/mcp/yaml/get-isml-elements-by-category.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --verbose
+# npx aegis "tests/mcp/yaml/get-isml-elements-by-category.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --debug --timing
+# ==================================================================================
+description: "SFCC MCP Server get_isml_elements_by_category tool - comprehensive validation"
+
+# ==================================================================================
+# BASIC TOOL STRUCTURE VALIDATION
+# ==================================================================================
+tests:
+  - it: "should list get_isml_elements_by_category tool in available tools"
+    request:
+      jsonrpc: "2.0"
+      id: "tool-list-1"
+      method: "tools/list"
+      params: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "tool-list-1"
+        result:
+          tools:
+            match:arrayContains:name:get_isml_elements_by_category
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# CONTROL FLOW CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve control-flow elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-control-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "control-flow"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-control-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isif"
+          isError: false
+      performance:
+        maxResponseTime: "1000ms"
+      stderr: "toBeEmpty"
+
+  - it: "should only return control-flow category elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-control-2"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "control-flow"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-control-2"
+        result:
+          content:
+            - type: "text"
+              text: "match:not:contains:isprint"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# OUTPUT CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve output elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-output-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "output"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-output-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isprint"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# INCLUDES CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve includes and components elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-includes-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "includes"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-includes-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isinclude"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# SCRIPTING CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve scripting elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-scripting-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "scripting"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-scripting-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isscript"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# CACHE CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve cache elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-cache-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "cache"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-cache-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:iscache"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# DECORATORS CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve decorator elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-decorators-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "decorators"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-decorators-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isdecorate"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# PAYMENT CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve payment elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-payment-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "payment"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-payment-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:ispayment"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# ANALYTICS CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve analytics elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-analytics-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "analytics"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-analytics-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isactivedatacontext"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# SPECIAL CATEGORY TESTS
+# ==================================================================================
+  - it: "should retrieve special elements"
+    request:
+      jsonrpc: "2.0"
+      id: "category-special-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "special"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-special-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:isredirect"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# ERROR HANDLING TESTS
+# ==================================================================================
+  - it: "should require category parameter"
+    request:
+      jsonrpc: "2.0"
+      id: "error-missing-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "error-missing-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:category"
+          isError: true
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# PERFORMANCE & RESOURCE VALIDATION
+# ==================================================================================
+  - it: "should complete category filtering within performance SLA"
+    request:
+      jsonrpc: "2.0"
+      id: "perf-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "control-flow"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "perf-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:type:string"
+          isError: false
+      performance:
+        maxResponseTime: "1000ms"
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# CONTENT VALIDATION TESTS
+# ==================================================================================
+  - it: "should return valid JSON array structure"
+    request:
+      jsonrpc: "2.0"
+      id: "json-valid-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_elements_by_category"
+        arguments:
+          category: "control-flow"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "json-valid-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:regex:\\[[\\s\\S]*\\]"
+          isError: false
+      stderr: "toBeEmpty"

package/tests/mcp/yaml/get-sfcc-class-info.docs-only.test.mcp.yml

@@ -1177,7 +1177,7 @@ tests:
               text: "match:contains:Error"
           isError: true
       performance:
-        maxResponseTime: "50ms"  # Validation errors should be extremely fast
+        maxResponseTime: "250ms"  # Validation errors should be fast (CI-friendly threshold)
       stderr: "toBeEmpty"
 
   - it: "should handle malformed class name error efficiently"
@@ -1199,7 +1199,7 @@ tests:
               text: "match:contains:Error"
           isError: true
       performance:
-        maxResponseTime: "50ms"  # Invalid input should fail extremely fast
+        maxResponseTime: "250ms"  # Invalid input should fail quickly (CI-friendly threshold)
       stderr: "toBeEmpty"
 
   - it: "should handle cached responses quickly"