snow-flow 3.6.5 → 3.6.6

package/.mcp.json.template

@@ -199,7 +199,7 @@
       "args": [
         "{{PROJECT_ROOT}}/dist/mcp/servicenow-local-development-mcp.js"
       ],
-      "description": "Local development bridge for Claude Code - pull any ServiceNow artifact to local files with native tool integration (snow_pull_artifact, snow_push_artifact, snow_validate_artifact_coherence), smart field chunking for large artifacts, ES5 validation, coherence checking, 12+ artifact types support",
+      "description": "UNIVERSAL ARTIFACT DETECTION v3.6.6 - finds ANY ServiceNow record by sys_id using sys_metadata! Pull any artifact (even custom tables) to local files with Claude Code native tools. Supports all tables, generic artifact creation for unknown types, smart chunking, ES5 validation, coherence checking. Tools: snow_pull_artifact, snow_push_artifact, snow_validate_artifact_coherence",
       "env": {
         "SNOW_INSTANCE": "{{SNOW_INSTANCE}}",
         "SNOW_CLIENT_ID": "{{SNOW_CLIENT_ID}}",

package/dist/cli.js

@@ -2646,6 +2646,125 @@ async function createMCPConfig(targetDir, force = false) {
     const claudeSettingsPath = (0, path_1.join)(targetDir, '.claude/settings.json');
     await fs_1.promises.writeFile(claudeSettingsPath, JSON.stringify(claudeSettings, null, 2));
 }
+// Setup MCP configuration function
+async function setupMCPConfig(targetDir, instanceUrl, clientId, clientSecret, force = false) {
+    // Find the Snow-Flow installation root
+    let snowFlowRoot = '';
+    // Try different locations to find the Snow-Flow root
+    const possiblePaths = [
+        (0, path_1.join)(targetDir, 'node_modules/snow-flow'),
+        (0, path_1.join)(targetDir, '../snow-flow-dev/snow-flow'),
+        (0, path_1.join)(process.env.HOME || '', 'Projects/snow-flow-dev/snow-flow'),
+        __dirname.includes('dist') ? (0, path_1.resolve)(__dirname, '..') : __dirname
+    ];
+    for (const testPath of possiblePaths) {
+        try {
+            await fs_1.promises.access((0, path_1.join)(testPath, '.mcp.json.template'));
+            snowFlowRoot = testPath;
+            break;
+        }
+        catch {
+            // Keep trying
+        }
+    }
+    if (!snowFlowRoot) {
+        // Last resort: assume we're running from the installed package
+        snowFlowRoot = (0, path_1.resolve)(__dirname, '..');
+        // Verify we can find the template
+        try {
+            await fs_1.promises.access((0, path_1.join)(snowFlowRoot, '.mcp.json.template'));
+        }
+        catch {
+            throw new Error('Could not find snow-flow project root');
+        }
+    }
+    // Read the template file
+    const templatePath = (0, path_1.join)(snowFlowRoot, '.mcp.json.template');
+    let templateContent;
+    try {
+        templateContent = await fs_1.promises.readFile(templatePath, 'utf-8');
+    }
+    catch (error) {
+        console.error('❌ Could not find .mcp.json.template file');
+        throw error;
+    }
+    // Replace placeholders in template
+    const mcpConfigContent = templateContent
+        .replace(/{{PROJECT_ROOT}}/g, snowFlowRoot)
+        .replace(/{{SNOW_INSTANCE}}/g, '${SNOW_INSTANCE}')
+        .replace(/{{SNOW_CLIENT_ID}}/g, '${SNOW_CLIENT_ID}')
+        .replace(/{{SNOW_CLIENT_SECRET}}/g, '${SNOW_CLIENT_SECRET}')
+        .replace(/{{SNOW_DEPLOYMENT_TIMEOUT}}/g, '${SNOW_DEPLOYMENT_TIMEOUT}')
+        .replace(/{{MCP_DEPLOYMENT_TIMEOUT}}/g, '${MCP_DEPLOYMENT_TIMEOUT}')
+        .replace(/{{NEO4J_URI}}/g, '${NEO4J_URI}')
+        .replace(/{{NEO4J_USER}}/g, '${NEO4J_USER}')
+        .replace(/{{NEO4J_PASSWORD}}/g, '${NEO4J_PASSWORD}')
+        .replace(/{{SNOW_FLOW_ENV}}/g, '${SNOW_FLOW_ENV}');
+    // Parse to ensure it's valid JSON
+    const mcpConfig = JSON.parse(mcpConfigContent);
+    // Keep the standard MCP structure that Claude Code expects
+    const finalConfig = {
+        "mcpServers": mcpConfig.servers
+    };
+    // Create .mcp.json in project root for Claude Code discovery
+    const mcpConfigPath = (0, path_1.join)(targetDir, '.mcp.json');
+    try {
+        await fs_1.promises.access(mcpConfigPath);
+        if (force) {
+            console.log('⚠️  .mcp.json already exists, overwriting with --force flag');
+            await fs_1.promises.writeFile(mcpConfigPath, JSON.stringify(finalConfig, null, 2));
+        }
+        else {
+            console.log('⚠️  .mcp.json already exists, skipping (use --force to overwrite)');
+        }
+    }
+    catch {
+        await fs_1.promises.writeFile(mcpConfigPath, JSON.stringify(finalConfig, null, 2));
+    }
+    // Also create legacy config in .claude for backward compatibility
+    const legacyConfigPath = (0, path_1.join)(targetDir, '.claude/mcp-config.json');
+    await fs_1.promises.writeFile(legacyConfigPath, JSON.stringify(finalConfig, null, 2));
+}
+// Refresh MCP configuration command
+program
+    .command('refresh-mcp')
+    .description('Refresh MCP server configuration to latest version')
+    .option('--force', 'Force overwrite existing configuration')
+    .action(async (options) => {
+    console.log(chalk_1.default.blue.bold(`\n🔄 Refreshing MCP Configuration to v${version_js_1.VERSION}...`));
+    console.log('='.repeat(60));
+    try {
+        // Check if project is initialized
+        const envPath = (0, path_1.join)(process.cwd(), '.env');
+        if (!(0, fs_2.existsSync)(envPath)) {
+            console.error(chalk_1.default.red('\n❌ No .env file found. Please run "snow-flow init" first.'));
+            process.exit(1);
+        }
+        // Load env vars
+        dotenv_1.default.config({ path: envPath });
+        const instanceUrl = process.env.SNOW_INSTANCE;
+        const clientId = process.env.SNOW_CLIENT_ID;
+        const clientSecret = process.env.SNOW_CLIENT_SECRET;
+        if (!instanceUrl || !clientId || !clientSecret) {
+            console.error(chalk_1.default.red('\n❌ Missing ServiceNow credentials in .env file.'));
+            process.exit(1);
+        }
+        console.log('\n📝 Updating MCP configuration...');
+        await setupMCPConfig(process.cwd(), instanceUrl, clientId, clientSecret, options.force || false);
+        console.log(chalk_1.default.green('\n✅ MCP configuration refreshed successfully!'));
+        console.log('\n📢 IMPORTANT: Restart Claude Code to use the new configuration:');
+        console.log(chalk_1.default.cyan('   claude --mcp-config .mcp.json'));
+        console.log('\n💡 The Local Development server now includes:');
+        console.log('   • Universal artifact detection via sys_metadata');
+        console.log('   • Support for ANY ServiceNow table (even custom)');
+        console.log('   • Generic artifact handling for unknown types');
+        console.log('   • Automatic file structure creation');
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('\n❌ Failed to refresh MCP configuration:'), error);
+        process.exit(1);
+    }
+});
 // Direct widget creation command
 program
     .command('create-widget [type]')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "3.6.5",
-  "description": "UNIVERSAL ARTIFACT DETECTION via sys_metadata! v3.6.5 can now find ANY ServiceNow record by sys_id alone - even custom tables. Generic artifact support for unknown tables. Smarter pullArtifactBySysId that queries sys_metadata first. Auto-creates editable file structure for ANY table type. Includes early auto-compact at 65%, audit logging, and consolidated CLAUDE.md.",
+  "version": "3.6.6",
+  "description": "MCP TEMPLATE FIX - v3.6.6 ensures snow-flow init generates correct .mcp.json with UNIVERSAL ARTIFACT DETECTION. Uses sys_metadata to find ANY ServiceNow record by sys_id alone. Generic artifact support for custom/unknown tables. Auto-creates editable file structure for ANY table type. Includes early auto-compact, audit logging, and consolidated CLAUDE.md.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {