sfcc-dev-mcp 1.0.19 → 1.0.21

package/docs-site-v2/tools/index.md

@@ -1,36 +0,0 @@
----
-title: Tools Catalog
-description: Browse all SFCC Dev MCP tools by category, mode, and practical prompt examples for daily development workflows.
----
-
-# Tools catalog
-
-Browse the full tool surface, filter by category, and copy example prompts.
-
-<Callout title="Legend" variant="info">
-Docs mode tools are available without credentials. Full mode tools require `dw.json`.
-</Callout>
-
-<ToolExplorer />
-
-<div class="vp-card" style="margin-top: 24px;">
-	<strong>Legend</strong>
-	<ul>
-		<li><span class="vp-tool-card__mode" data-mode="full">Full</span> Requires credentials</li>
-		<li><span class="vp-tool-card__mode" data-mode="both">Docs + Full</span> Available in both modes</li>
-	</ul>
-</div>
-
-<div class="vp-card" style="margin-top: 24px;">
-	<strong>Mode recommendation</strong>
-	<p>Explore freely in Documentation Mode first. Add <code>--dw-json</code> later to unlock log analysis, system and custom objects, job log insights, and code version management.</p>
-</div>
-
-<div class="vp-card" style="margin-top: 24px;">
-	<strong>Next steps</strong>
-	<p>Move from raw tool surface into practical flows or reinforce secure patterns before enabling full-mode capabilities.</p>
-	<div class="home-cta-row" style="justify-content: flex-start;">
-		<a class="home-button home-button--primary" href="/examples">Examples & Use Cases</a>
-		<a class="home-button" href="/security">Security Guidance</a>
-	</div>
-</div>

package/docs-site-v2/troubleshooting/index.md

@@ -1,204 +0,0 @@
----
-title: Troubleshooting
-description: Diagnose SFCC Dev MCP startup, authentication, logs, OCAPI access, and client connection issues with quick fixes.
----
-
-# Troubleshooting
-
-## Quick checks
-
-- Node.js 18+ is installed
-- `dw.json` exists and has `chmod 600` permissions
-- The SFCC sandbox is active and reachable
-
-<Callout title="Quick test" variant="info">
-Run `npx -y sfcc-dev-mcp --debug` to verify the server starts without errors.
-</Callout>
-
-## Server will not start
-
-```bash
-node --version
-npx -y sfcc-dev-mcp --debug
-```
-
-<Collapsible title="Node.js version mismatch" open>
-
-```bash
-node --version
-nvm install 18 && nvm use 18
-```
-
-If you work with older SFRA/SiteGenesis projects, set a higher default Node version for MCP:
-
-```bash
-nvm alias default 18
-nvm use 12.22.6
-```
-
-</Collapsible>
-
-<Collapsible title="File permissions">
-
-```bash
-chmod 600 dw.json
-ls -la dw.json
-```
-
-</Collapsible>
-
-<Collapsible title="Package installation">
-
-```bash
-npm install -g sfcc-dev-mcp
-npx -y sfcc-dev-mcp --version
-```
-
-</Collapsible>
-
-## Authentication issues
-
-- Verify `hostname`, `username`, and `password`
-- Regenerate `client-id` and `client-secret` if OCAPI calls fail
-- Confirm OCAPI resources in Business Manager match the configuration page
-
-<Collapsible title="Test connectivity">
-
-```bash
-curl -I https://your-instance.sandbox.us01.dx.commercecloud.salesforce.com
-```
-
-</Collapsible>
-
-<Collapsible title="Regenerate API credentials">
-
-```bash
-curl -X POST \
-	https://your-instance.sandbox.us01.dx.commercecloud.salesforce.com/dw/oauth2/access_token \
-	-H "Content-Type: application/x-www-form-urlencoded" \
-	-d "grant_type=client_credentials&client_id=NEW_ID&client_secret=NEW_SECRET"
-```
-
-</Collapsible>
-
-## Log tools return no data
-
-- Test WebDAV access directly:
-
-```bash
-curl -u "username:password" https://your-instance.sandbox.us01.dx.commercecloud.salesforce.com/on/demandware.servlet/webdav/Sites/Logs/
-```
-
-- Ensure logs exist for the requested date
-
-<Collapsible title="Wrong date format">
-
-```javascript
-get_latest_error({ date: "20241218" })
-```
-
-</Collapsible>
-
-## System object tools failing
-
-- Confirm Data API resources include `definition_search` endpoints (POST)
-- Ensure `client-id` matches the OCAPI client in Account Manager
-
-<Collapsible title="Required Data API resources">
-
-```json
-{
-	"_v": "23.2",
-	"clients": [{
-		"client_id": "YOUR_CLIENT_ID",
-		"resources": [
-			{ "resource_id": "/system_object_definitions", "methods": ["get"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/system_object_definitions/*", "methods": ["get"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/system_object_definition_search", "methods": ["post"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/system_object_definitions/*/attribute_definition_search", "methods": ["post"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/system_object_definitions/*/attribute_group_search", "methods": ["post"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/custom_object_definitions/*/attribute_definition_search", "methods": ["post"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/site_preferences/preference_groups/*/*/preference_search", "methods": ["post"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/code_versions", "methods": ["get"], "read_attributes": "(**)", "write_attributes": "(**)" },
-			{ "resource_id": "/code_versions/*", "methods": ["get", "patch"], "read_attributes": "(**)", "write_attributes": "(**)" }
-		]
-	}]
-}
-```
-
-</Collapsible>
-
-## Job log tools issues
-
-<Collapsible title="Job log access">
-
-```bash
-curl -u "username:password" \
-	https://your-instance.sandbox.us01.dx.commercecloud.salesforce.com/on/demandware.servlet/webdav/Sites/Logs/jobs/
-```
-
-</Collapsible>
-
-<Collapsible title="Minimal health flow">
-
-```bash
-aegis query search_job_logs_by_name 'jobName:MyJob|limit:3'
-aegis query get_job_log_entries 'jobName:MyJob|limit:40'
-aegis query get_job_execution_summary 'jobName:MyJob'
-```
-
-</Collapsible>
-
-## AI client not connecting
-
-<Collapsible title="Validate MCP config">
-
-```bash
-python -m json.tool claude_desktop_config.json
-npx -y sfcc-dev-mcp --debug
-```
-
-</Collapsible>
-
-## Auto-discovery not working
-
-<Collapsible title="No tools after adding dw.json" open>
-
-- Ensure your client supports MCP `roots/list` (VS Code/Copilot/Cursor do).
-- Re-open the workspace after adding `dw.json`.
-- If your client does not support workspace roots, pass `--dw-json` explicitly.
-
-</Collapsible>
-
-## Debug logging
-
-```bash
-npx -y sfcc-dev-mcp --debug
-npx -y sfcc-dev-mcp --debug false --dw-json /path/to/dw.json
-```
-
-## Log file locations
-
-- macOS: `/var/folders/{user-id}/T/sfcc-mcp-logs/`
-- Linux: `/tmp/sfcc-mcp-logs/`
-- Windows: `%TEMP%\sfcc-mcp-logs\`
-
-```bash
-node -e "console.log(require('os').tmpdir() + '/sfcc-mcp-logs')"
-```
-
-## Getting help
-
-Collect diagnostic data and remove secrets before sharing:
-
-```bash
-node --version
-npm --version
-npm list sfcc-dev-mcp
-```
-
-## AI client not connecting
-
-- Validate your MCP config file JSON
-- Restart the client after changes
-- Ensure the MCP server command uses `npx` and an absolute `dw.json` path

package/eslint.config.js

@@ -1,139 +0,0 @@
-import js from '@eslint/js';
-import tseslint from 'typescript-eslint';
-
-export default tseslint.config(
-  // Base recommended configs
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-
-  // Global settings
-  {
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'module',
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-      },
-    },
-  },
-
-  // TypeScript files
-  {
-    files: ['**/*.ts', '**/*.tsx'],
-    languageOptions: {
-      parser: tseslint.parser,
-      parserOptions: {
-        project: ['./tsconfig.json', './tsconfig.test.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-    },
-    rules: {
-      // TypeScript specific rules
-      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'off',
-      '@typescript-eslint/prefer-nullish-coalescing': 'error',
-      '@typescript-eslint/prefer-optional-chain': 'error',
-      '@typescript-eslint/no-empty-object-type': 'off',
-
-      // General code quality rules
-      'no-console': 'off',
-      'prefer-const': 'error',
-      'no-var': 'error',
-      'object-shorthand': 'error',
-      'prefer-arrow-callback': 'error',
-      'prefer-template': 'error',
-      'no-trailing-spaces': 'error',
-      'eol-last': 'error',
-      'comma-dangle': ['error', 'always-multiline'],
-      'quotes': ['error', 'single', { avoidEscape: true }],
-      'semi': ['error', 'always'],
-
-      // Basic formatting rules
-      'indent': ['error', 2, { SwitchCase: 1 }],
-      'linebreak-style': ['error', 'unix'],
-      'max-len': ['error', { code: 120, ignoreUrls: true, ignoreStrings: true, ignoreTemplateLiterals: true }],
-      'no-multiple-empty-lines': ['error', { max: 2, maxEOF: 1 }],
-      'object-curly-spacing': ['error', 'always'],
-      'array-bracket-spacing': ['error', 'never'],
-      'key-spacing': ['error', { beforeColon: false, afterColon: true }],
-      'comma-spacing': ['error', { before: false, after: true }],
-      'space-before-blocks': ['error', 'always'],
-      'space-infix-ops': 'error',
-      'brace-style': ['error', '1tbs', { allowSingleLine: true }],
-      'curly': ['error', 'all'],
-    },
-  },
-
-  // Test files
-  {
-    files: ['**/*.test.ts', '**/*.spec.ts', 'tests/**/*.ts'],
-    languageOptions: {
-      globals: {
-        jest: 'readonly',
-        describe: 'readonly',
-        it: 'readonly',
-        expect: 'readonly',
-        beforeEach: 'readonly',
-        afterEach: 'readonly',
-        beforeAll: 'readonly',
-        afterAll: 'readonly',
-      },
-    },
-    rules: {
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'off',
-    },
-  },
-
-  // Script files
-  {
-    files: ['scripts/**/*.js'],
-    languageOptions: {
-      sourceType: 'module',
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-      },
-    },
-  },
-
-  // Mock files (CommonJS format)
-  {
-    files: ['**/__mocks__/**/*.js'],
-    languageOptions: {
-      sourceType: 'script',
-      globals: {
-        module: 'writable',
-        exports: 'writable',
-        jest: 'readonly',
-      },
-    },
-  },
-
-  // Ignore patterns
-  {
-    ignores: [
-      'tmp/**',
-      'dist/**',
-      'node_modules/**',
-      'coverage/**',
-      'docs-site-v2/**',
-      'docs-site-old/**',
-      '*.config.js',
-      'jest.config.js',
-      'tests/servers/**',
-      '.github/skills/salesforce-developer-site-scraper/scripts/**',
-      '.github/skills/salesforce-help-site-scraper/scripts/**',
-    ],
-  },
-);

package/jest.config.js

@@ -1,27 +0,0 @@
-export default {
-  preset: 'ts-jest/presets/default-esm',
-  extensionsToTreatAsEsm: ['.ts'],
-  testEnvironment: 'node',
-  testTimeout: process.env.CI ? 30000 : 10000, // 30s for CI, 10s for local
-  roots: ['<rootDir>/src', '<rootDir>/tests'],
-  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
-  transform: {
-    '^.+\\.ts$': ['ts-jest', {
-      useESM: true
-    }],
-  },
-  transformIgnorePatterns: [
-    'node_modules/(?!(webdav|@modelcontextprotocol)/)'
-  ],
-  moduleNameMapper: {
-    '^(\\.{1,2}/.*)\\.js$': '$1',
-    '^webdav$': '<rootDir>/tests/__mocks__/webdav.js'
-  },
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/main.ts',
-    '!src/index.ts',
-  ],
-  coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov', 'html'],
-};

package/memories/repo/docs-site-v2-build.json

@@ -1,11 +0,0 @@
-{
-  "subject": "docs-site-v2 build workflow",
-  "fact": "The docs-v2 site is built from the docs-site-v2 directory using `npm run build`, which runs `vitepress build .` and then generates `public/sitemap.xml` and `public/llms.txt` via node scripts.",
-  "citations": [
-    "docs-site-v2/package.json",
-    "docs-site-v2/scripts/generate-sitemap.js",
-    "docs-site-v2/scripts/generate-llms.js"
-  ],
-  "reason": "This verified command chain is useful for future documentation changes and release validation tasks.",
-  "category": "build"
-}