sfcc-dev-mcp 1.0.15 → 1.0.19

package/tests/mcp/yaml/evaluate-script.full-mode.test.mcp.yml

@@ -0,0 +1,281 @@
+---
+description: "Test evaluate_script tool for script debugger functionality"
+tests:
+  # Basic functionality tests
+  - it: "should evaluate simple arithmetic expression"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-simple"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          siteId: "RefArch"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-simple"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:regex:\"result\":\\s*\"2\"|success.*true"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  - it: "should include success status in response"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-success"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-success"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  - it: "should include execution time in response"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-timing"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-timing"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:executionTimeMs"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  # Site parameter tests  
+  - it: "should accept different siteId values"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-site"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          siteId: "RefArchGlobal"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-site"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  - it: "should accept siteId in Sites-{id}-Site format"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-site-sites-format"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          siteId: "Sites-RefArchGlobal-Site"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-site-sites-format"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  - it: "should accept locale parameter"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-locale"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          locale: "default"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-locale"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  # Timeout parameter tests
+  - it: "should accept custom timeout value"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-timeout"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          timeout: 15000
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-timeout"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  # Custom breakpoint tests
+  - it: "should accept custom breakpoint file and line"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-custom-bp"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          breakpointFile: "/app_storefront_base/cartridge/controllers/Default.js"
+          breakpointLine: 26
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-custom-bp"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  - it: "should accept custom breakpoint file without line (defaults to strategic lines)"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-custom-bp-default-line"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "1 + 1"
+          breakpointFile: "/app_storefront_base/cartridge/controllers/Default.js"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-custom-bp-default-line"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:contains:success"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  # SFCC API simulation tests
+  - it: "should evaluate Site.current.ID expression"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-site-api"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments:
+          script: "var Site = require('dw/system/Site'); return Site.current.ID;"
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-site-api"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:regex:MockSiteID|success.*true"
+          isError: false
+      stderr: "toBeEmpty"
+    performance:
+      maxResponseTime: "10000ms"
+
+  # Tool schema validation
+  - it: "should be listed in tools/list with correct schema"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-schema"
+      method: "tools/list"
+      params: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-schema"
+        result:
+          tools: "match:arrayContains:name:evaluate_script"
+      stderr: "toBeEmpty"
+
+  # Error handling - missing required parameter
+  - it: "should fail when script parameter is missing"
+    request:
+      jsonrpc: "2.0"
+      id: "eval-no-script"
+      method: "tools/call"
+      params:
+        name: "evaluate_script"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "eval-no-script"
+        result:
+          content:
+            match:arrayElements:
+              type: "text"
+              text: "match:regex:required|missing|script"
+          isError: true
+      stderr: "toBeEmpty"

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

@@ -0,0 +1,330 @@
+# ==================================================================================
+# SFCC MCP Server - get_isml_categories Tool YAML Tests
+# Comprehensive testing for ISML category listing functionality
+# Tests category structure, counts, and metadata
+# 
+# Discovery Commands:
+# npx aegis query get_isml_categories --config "aegis.config.docs-only.json"
+# 
+# Quick Test Commands:
+# npx aegis "tests/mcp/yaml/get-isml-categories.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --verbose
+# npx aegis "tests/mcp/yaml/get-isml-categories.docs-only.test.mcp.yml" --config "aegis.config.docs-only.json" --debug --timing
+# ==================================================================================
+description: "SFCC MCP Server get_isml_categories tool - comprehensive validation"
+
+# ==================================================================================
+# BASIC TOOL STRUCTURE VALIDATION
+# ==================================================================================
+tests:
+  - it: "should list get_isml_categories 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_categories
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# SUCCESSFUL CATEGORY LISTING TESTS
+# ==================================================================================
+  - it: "should return array of ISML categories"
+    request:
+      jsonrpc: "2.0"
+      id: "list-categories-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "list-categories-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:regex:\\[[\\s\\S]*\\]"
+          isError: false
+      performance:
+        maxResponseTime: "500ms"
+      stderr: "toBeEmpty"
+
+  - it: "should include all major ISML categories"
+    request:
+      jsonrpc: "2.0"
+      id: "all-categories-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "all-categories-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:Control Flow"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include payment and analytics categories"
+    request:
+      jsonrpc: "2.0"
+      id: "extended-categories-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "extended-categories-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:Payment"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include category metadata fields"
+    request:
+      jsonrpc: "2.0"
+      id: "category-metadata-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "category-metadata-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:name"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include control-flow category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "control-flow-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "control-flow-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:control-flow"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include output category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "output-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "output-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:output"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include includes category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "includes-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "includes-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:includes"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include scripting category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "scripting-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "scripting-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:scripting"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include cache category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "cache-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "cache-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:cache"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include decorators category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "decorators-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "decorators-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:decorators"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include special category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "special-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "special-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:special"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include payment category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "payment-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "payment-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:payment"
+          isError: false
+      stderr: "toBeEmpty"
+
+  - it: "should include analytics category with proper metadata"
+    request:
+      jsonrpc: "2.0"
+      id: "analytics-category-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "analytics-category-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:contains:analytics"
+          isError: false
+      stderr: "toBeEmpty"
+
+# ==================================================================================
+# PERFORMANCE & RESOURCE VALIDATION
+# ==================================================================================
+  - it: "should complete category listing within performance SLA"
+    request:
+      jsonrpc: "2.0"
+      id: "perf-1"
+      method: "tools/call"
+      params:
+        name: "get_isml_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "perf-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:type:string"
+          isError: false
+      performance:
+        maxResponseTime: "500ms"
+      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_categories"
+        arguments: {}
+    expect:
+      response:
+        jsonrpc: "2.0"
+        id: "json-valid-1"
+        result:
+          content:
+            - type: "text"
+              text: "match:regex:\\[[\\s\\S]*\\]"
+          isError: false
+      stderr: "toBeEmpty"