delegate-sf-mcp 0.2.0

package/bin/status.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { TokenManager } from '../src/auth/token-manager.js';
+import { FileStorageManager } from '../src/auth/file-storage.js';
+
+// Load environment variables
+config();
+
+class StatusChecker {
+  constructor() {
+    this.fileStorage = new FileStorageManager();
+  }
+
+  async checkStatus() {
+    console.log('🔍 MCP Salesforce Server Status Check');
+    console.log('=====================================\n');
+
+    // Check configuration
+    console.log('📋 Configuration Status:');
+    const configStatus = await this.checkConfiguration();
+    
+    if (!configStatus.valid) {
+      console.log('\n❌ Configuration incomplete. Please run salesforce_setup tool first.');
+      return;
+    }
+
+    // Check authentication
+    console.log('\n🔐 Authentication Status:');
+    await this.checkAuthentication(configStatus.credentials);
+    
+    console.log('\n💡 Next Steps:');
+    console.log('- If authentication failed, run: npm run setup');
+    console.log('- If successful, add to Claude Desktop configuration');
+    console.log('- Use npm run config-help for Connected App setup');
+  }
+
+  async checkConfiguration() {
+    try {
+      const credentials = await this.fileStorage.getCredentials();
+      
+      if (!credentials) {
+        console.log('❌ No credentials found in ~/.mcp-salesforce.json');
+        console.log('   Run the salesforce_setup tool to configure credentials');
+        return { valid: false };
+      }
+
+      const { clientId, clientSecret, instanceUrl } = credentials;
+      
+      if (!clientId || !clientSecret || !instanceUrl) {
+        console.log('❌ Incomplete credentials in ~/.mcp-salesforce.json');
+        console.log('   Run the salesforce_setup tool to reconfigure credentials');
+        return { valid: false };
+      }
+
+      console.log(`✅ Client ID: ${this.maskSensitive('CLIENT_ID', clientId)}`);
+      console.log(`✅ Client Secret: ${this.maskSensitive('CLIENT_SECRET', clientSecret)}`);
+      console.log(`✅ Instance URL: ${instanceUrl}`);
+      
+      // Check API config
+      const apiConfig = await this.fileStorage.getApiConfig();
+      console.log(`✅ API Version: ${apiConfig.apiVersion}`);
+      console.log(`✅ Callback Port: ${apiConfig.callbackPort}`);
+
+      return { valid: true, credentials };
+    } catch (error) {
+      console.log(`❌ Configuration check failed: ${error.message}`);
+      return { valid: false };
+    }
+  }
+
+  async checkAuthentication(credentials) {
+    try {
+      const tokenManager = new TokenManager(
+        credentials.clientId,
+        credentials.clientSecret,
+        credentials.instanceUrl
+      );
+
+      const hasTokens = await tokenManager.initialize();
+      
+      if (!hasTokens) {
+        console.log('❌ No authentication tokens found');
+        console.log('   Run: npm run setup');
+        return false;
+      }
+
+      const tokenInfo = tokenManager.getTokenInfo();
+      console.log('✅ Tokens found in ~/.mcp-salesforce.json');
+      console.log(`   Instance: ${tokenInfo.instance_url}`);
+      
+      if (tokenInfo.expires_at) {
+        const expiresIn = Math.round((tokenInfo.expires_at - Date.now()) / (1000 * 60));
+        console.log(`   Expires: ${expiresIn} minutes`);
+      }
+
+      // Test the tokens
+      console.log('🧪 Testing token validity...');
+      const testResult = await tokenManager.testTokens();
+      
+      if (testResult.valid) {
+        console.log('✅ Authentication successful!');
+        console.log(`   API versions available: ${testResult.apiVersions}`);
+        return true;
+      } else {
+        console.log(`❌ Token validation failed: ${testResult.error}`);
+        console.log('   Run: npm run setup');
+        return false;
+      }
+    } catch (error) {
+      console.log(`❌ Authentication check failed: ${error.message}`);
+      return false;
+    }
+  }
+
+  maskSensitive(key, value) {
+    if (key.includes('SECRET')) {
+      return value.substring(0, 8) + '***';
+    }
+    if (key.includes('CLIENT_ID')) {
+      return value.substring(0, 12) + '***';
+    }
+    return value;
+  }
+}
+
+// Run status check if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const checker = new StatusChecker();
+  checker.checkStatus().catch(error => {
+    console.error('❌ Status check failed:', error.message);
+    process.exit(1);
+  });
+}

package/docs/README.md

@@ -0,0 +1,52 @@
+# Documentation
+
+This directory contains all project documentation files.
+
+## Architecture & Design
+- [`mcp-salesforce-architecture.md`](./mcp-salesforce-architecture.md) - Overall system architecture
+- [`IMPLEMENTATION_SUMMARY.md`](./IMPLEMENTATION_SUMMARY.md) - Implementation overview
+
+## Setup & Installation
+- [`INSTALL.md`](./INSTALL.md) - Installation instructions
+- [`setup.md`](./setup.md) - Setup guide
+- [`oauth-guide.md`](./oauth-guide.md) - OAuth setup guide
+
+## Features & Enhancements
+- [`SALESFORCE_BACKUP_FEATURE_PLAN.md`](./SALESFORCE_BACKUP_FEATURE_PLAN.md) - Backup feature planning
+- [`SALESFORCE_BACKUP_IMPLEMENTATION_COMPLETE.md`](./SALESFORCE_BACKUP_IMPLEMENTATION_COMPLETE.md) - Backup implementation
+- [`SALESFORCE_TIME_MACHINE_COMPLETE.md`](./SALESFORCE_TIME_MACHINE_COMPLETE.md) - Time machine feature
+- [`DYNAMIC_CONTEXT_LEARNING_COMPLETE.md`](./DYNAMIC_CONTEXT_LEARNING_COMPLETE.md) - Learning system
+- [`learning-system-demo.md`](./learning-system-demo.md) - Learning system demo
+- [`context-learning.md`](./context-learning.md) - Context learning details
+- [`AHA_MOMENT_CAPTURE_ENHANCEMENT.md`](./AHA_MOMENT_CAPTURE_ENHANCEMENT.md) - Aha moment capture
+- [`FIELD_WRITABILITY_ENHANCEMENT_COMPLETE.md`](./FIELD_WRITABILITY_ENHANCEMENT_COMPLETE.md) - Field writability
+- [`INTERNATIONALIZATION_COMPLETE.md`](./INTERNATIONALIZATION_COMPLETE.md) - I18n support
+- [`QUICK_SETUP_FEATURE_COMPLETE.md`](./QUICK_SETUP_FEATURE_COMPLETE.md) - Quick setup feature
+- [`TRANSLATION_COMPLETE.md`](./TRANSLATION_COMPLETE.md) - Translation support
+
+## Development Progress
+- [`NPX_IMPLEMENTATION_COMPLETE.md`](./NPX_IMPLEMENTATION_COMPLETE.md) - NPX implementation
+- [`OAUTH_FIX_COMPLETE.md`](./OAUTH_FIX_COMPLETE.md) - OAuth fixes
+- [`ASYNC_BACKUP_SYSTEM_COMPLETE.md`](./ASYNC_BACKUP_SYSTEM_COMPLETE.md) - Async backup system
+- [`ASYNC_BACKUP_IMPLEMENTATION_COMPLETE.md`](./ASYNC_BACKUP_IMPLEMENTATION_COMPLETE.md) - Async backup implementation
+
+## Bug Fixes & Resolutions
+- [`OAUTH_CSRF_FIXES_COMPLETE.md`](./OAUTH_CSRF_FIXES_COMPLETE.md) - CSRF fixes
+- [`OAUTH_CSRF_RESOLUTION_COMPLETE.md`](./OAUTH_CSRF_RESOLUTION_COMPLETE.md) - CSRF resolution
+- [`PATH_RESOLUTION_FIX_COMPLETE.md`](./PATH_RESOLUTION_FIX_COMPLETE.md) - Path resolution fixes
+- [`PATH_RESOLUTION_BUGS_FIXED.md`](./PATH_RESOLUTION_BUGS_FIXED.md) - Path resolution bugs
+- [`HANGING_ISSUE_RESOLVED.md`](./HANGING_ISSUE_RESOLVED.md) - Hanging issue resolution
+- [`COMPLETED_INTERVIEW_ISSUE_RESOLVED.md`](./COMPLETED_INTERVIEW_ISSUE_RESOLVED.md) - Interview issue fix
+
+## Cleanup & Maintenance
+- [`FINAL_CLEANUP_SUMMARY.md`](./FINAL_CLEANUP_SUMMARY.md) - Final cleanup summary
+- [`FINAL_FILE_STRUCTURE_CLEANUP_COMPLETE.md`](./FINAL_FILE_STRUCTURE_CLEANUP_COMPLETE.md) - File structure cleanup
+- [`API_CLEANUP_COMPLETE.md`](./API_CLEANUP_COMPLETE.md) - API cleanup
+- [`CONSOLE_LOG_CLEANUP_COMPLETE.md`](./CONSOLE_LOG_CLEANUP_COMPLETE.md) - Console log cleanup
+
+## Examples & Usage
+- [`examples.md`](./examples.md) - Usage examples
+- See also: [`../examples/`](../examples/) directory for demo scripts
+
+## Setup Screenshots
+- `step1.png`, `step2.png`, `step3.png`, `step4.png` - Installation and setup screenshots

package/examples/README.md

@@ -0,0 +1,35 @@
+# Examples & Demos
+
+This directory contains example scripts and demos for the MCP Salesforce server.
+
+## Demo Scripts
+
+### Core Functionality
+- [`demo-complete.js`](./demo-complete.js) - Complete functionality demonstration
+- [`demo-salesforce-backup.js`](./demo-salesforce-backup.js) - Backup system demo
+
+### Learning System
+- [`demo-dynamic-learning.js`](./demo-dynamic-learning.js) - Dynamic learning capabilities
+- [`demo-aha-moment-capture.js`](./demo-aha-moment-capture.js) - Aha moment capture demo
+- [`demo-additional-questions.js`](./demo-additional-questions.js) - Additional questions demo
+
+### Time Machine
+- [`demo-time-machine.js`](./demo-time-machine.js) - Basic time machine demo
+- [`demo-time-machine-advanced.js`](./demo-time-machine-advanced.js) - Advanced time machine features
+
+## Running Examples
+
+To run any demo script:
+
+```bash
+node examples/demo-script-name.js
+```
+
+Make sure you have:
+1. Set up your environment variables in `.env`
+2. Authenticated with Salesforce using the setup tool
+3. Installed all dependencies with `npm install`
+
+## Related Documentation
+
+See the [`../docs/`](../docs/) directory for detailed documentation on features demonstrated in these examples.

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "delegate-sf-mcp",
+  "version": "0.2.0",
+  "description": "Delegate Salesforce MCP Server",
+  "type": "module",
+  "scripts": {
+    "auth": "node auth.js",
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "jsforce": "^1.11.1",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  }
+}

package/scripts/README.md

@@ -0,0 +1,30 @@
+# Development Scripts
+
+This directory contains development, debugging, and testing scripts.
+
+## Debug Scripts
+- [`debug-learning.js`](./debug-learning.js) - Debug learning system
+- [`debug-oauth-csrf.js`](./debug-oauth-csrf.js) - Debug OAuth CSRF issues
+
+## Fix Scripts
+- [`fix-oauth-csrf.js`](./fix-oauth-csrf.js) - OAuth CSRF fix script
+
+## Test Scripts
+- [`test-*.js`](./test-async-backup.js) - Various test scripts for different components
+- [`minimal-test.js`](./minimal-test.js) - Minimal functionality test
+- [`explore-sf.js`](./explore-sf.js) - Salesforce exploration script
+
+## Usage
+
+These scripts are primarily for development and debugging purposes. Most require:
+
+1. Environment variables set in `.env`
+2. Valid Salesforce authentication
+3. Node.js dependencies installed
+
+Example:
+```bash
+node scripts/minimal-test.js
+```
+
+**Note:** These scripts are development tools and not part of the main package functionality. Use the examples in [`../examples/`](../examples/) for production usage patterns.