bc-code-intelligence-mcp 1.5.9 → 1.6.1

package/dist/tools/debug/diagnose_git_layer/handler.js

@@ -0,0 +1,286 @@
+import simpleGit from 'simple-git';
+import { join } from 'path';
+export function createDiagnoseGitLayerHandler() {
+    return async function diagnoseGitLayer(args) {
+        const { git_url, auth_type, token_env_var, branch = 'main', test_type = 'full' } = args;
+        const diagnostics = {
+            timestamp: new Date().toISOString(),
+            url: git_url,
+            auth_type,
+            tests: []
+        };
+        // Test 1: URL Format Validation
+        if (test_type === 'connectivity' || test_type === 'full') {
+            const urlTest = validateGitUrl(git_url);
+            diagnostics.tests.push(urlTest);
+        }
+        // Test 2: Authentication Configuration
+        if (test_type === 'authentication' || test_type === 'full') {
+            const authTest = await testAuthConfiguration(git_url, auth_type, token_env_var);
+            diagnostics.tests.push(authTest);
+        }
+        // Test 3: Network Connectivity (if full test)
+        if (test_type === 'connectivity' || test_type === 'full') {
+            const connectivityTest = await testGitConnectivity(git_url, auth_type, token_env_var);
+            diagnostics.tests.push(connectivityTest);
+        }
+        // Test 4: Clone Test (if full or clone test)
+        if (test_type === 'clone' || test_type === 'full') {
+            const cloneTest = await testGitClone(git_url, auth_type, token_env_var, branch);
+            diagnostics.tests.push(cloneTest);
+        }
+        // Generate recommendations based on failures
+        const recommendations = generateRecommendations(diagnostics.tests, auth_type);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...diagnostics,
+                        summary: generateDiagnosticSummary(diagnostics.tests),
+                        recommendations
+                    }, null, 2)
+                }]
+        };
+    };
+}
+function validateGitUrl(url) {
+    const test = {
+        name: 'URL Format Validation',
+        passed: false,
+        details: {}
+    };
+    // Check URL format
+    try {
+        const urlObj = new URL(url);
+        test.details.protocol = urlObj.protocol;
+        test.details.hostname = urlObj.hostname;
+        test.details.pathname = urlObj.pathname;
+        // Azure DevOps specific validation
+        if (url.includes('dev.azure.com') || url.includes('visualstudio.com')) {
+            test.details.provider = 'Azure DevOps';
+            // Parse Azure DevOps URL components
+            const azureMatch = url.match(/dev\.azure\.com\/([^\/]+)\/([^\/]+)\/_git\/(.+?)(?:\.git)?$/);
+            if (azureMatch) {
+                test.details.organization = azureMatch[1];
+                test.details.project = azureMatch[2];
+                test.details.repository = azureMatch[3];
+                test.passed = true;
+                test.details.message = 'Valid Azure DevOps URL format';
+            }
+            else {
+                test.details.message = 'Invalid Azure DevOps URL format. Expected: https://dev.azure.com/{org}/{project}/_git/{repo}';
+                test.details.recommendation = 'Verify your Azure DevOps repository URL format';
+            }
+        }
+        else if (url.includes('github.com')) {
+            test.details.provider = 'GitHub';
+            test.passed = true;
+        }
+        else if (url.includes('gitlab.com')) {
+            test.details.provider = 'GitLab';
+            test.passed = true;
+        }
+        else {
+            test.details.provider = 'Unknown';
+            test.passed = true; // Generic git URL
+        }
+    }
+    catch (error) {
+        test.details.message = `Invalid URL: ${error instanceof Error ? error.message : String(error)}`;
+        test.details.recommendation = 'Provide a valid HTTP(S) or SSH URL';
+    }
+    return test;
+}
+async function testAuthConfiguration(url, authType, tokenEnvVar) {
+    const test = {
+        name: 'Authentication Configuration',
+        passed: false,
+        details: {}
+    };
+    test.details.auth_type = authType;
+    if (authType === 'token') {
+        if (!tokenEnvVar) {
+            test.details.message = 'Token environment variable not specified';
+            test.details.recommendation = 'Specify token_env_var parameter';
+            return test;
+        }
+        test.details.token_env_var = tokenEnvVar;
+        const tokenValue = process.env[tokenEnvVar];
+        if (!tokenValue) {
+            test.details.message = `Environment variable ${tokenEnvVar} not set or empty`;
+            test.details.recommendation = `Set ${tokenEnvVar} environment variable with your PAT`;
+            test.details.check_instructions = [
+                `Run: echo $env:${tokenEnvVar} (PowerShell) or echo $${tokenEnvVar} (Bash)`,
+                'Verify the PAT is not expired',
+                'Ensure the PAT has "Code (Read)" permission for Azure DevOps'
+            ];
+            return test;
+        }
+        test.details.token_length = tokenValue.length;
+        test.details.token_prefix = tokenValue.substring(0, 4) + '...';
+        // Azure DevOps PAT validation
+        if (url.includes('dev.azure.com')) {
+            // Azure DevOps PATs are typically 52 characters
+            if (tokenValue.length === 52) {
+                test.passed = true;
+                test.details.message = 'PAT format appears valid for Azure DevOps';
+            }
+            else {
+                test.details.message = `PAT length (${tokenValue.length}) unusual for Azure DevOps (expected 52 characters)`;
+                test.details.recommendation = 'Verify this is a valid Azure DevOps Personal Access Token';
+            }
+        }
+        else {
+            test.passed = true;
+            test.details.message = 'Token configuration present';
+        }
+    }
+    else if (authType === 'ssh') {
+        test.details.message = 'SSH authentication configured';
+        test.passed = true;
+    }
+    else {
+        test.details.message = `Unsupported auth type: ${authType}`;
+        test.details.recommendation = 'Use "token", "basic", or "ssh" for auth_type';
+    }
+    return test;
+}
+async function testGitConnectivity(url, authType, tokenEnvVar) {
+    const test = {
+        name: 'Git Connectivity Test',
+        passed: false,
+        details: {}
+    };
+    try {
+        const git = simpleGit();
+        // Prepare URL with auth for ls-remote test
+        let testUrl = url;
+        if (authType === 'token' && tokenEnvVar) {
+            const token = process.env[tokenEnvVar];
+            if (token && testUrl.startsWith('https://')) {
+                // For Azure DevOps, use empty username with PAT
+                testUrl = testUrl.replace('https://', `https://:${token}@`);
+            }
+        }
+        // Try ls-remote to test connectivity without cloning
+        const result = await git.listRemote(['--heads', testUrl]);
+        test.passed = true;
+        test.details.message = 'Successfully connected to repository';
+        test.details.branches_found = result.split('\n').filter(Boolean).length;
+    }
+    catch (error) {
+        test.details.message = 'Failed to connect to repository';
+        test.details.error = error.message;
+        // Parse common error scenarios
+        if (error.message.includes('Authentication failed') || error.message.includes('403')) {
+            test.details.issue = 'Authentication failure';
+            test.details.recommendation = 'Verify PAT is valid and has Code (Read) permission';
+        }
+        else if (error.message.includes('Could not resolve host')) {
+            test.details.issue = 'Network/DNS issue';
+            test.details.recommendation = 'Check network connection and URL hostname';
+        }
+        else if (error.message.includes('Repository not found') || error.message.includes('404')) {
+            test.details.issue = 'Repository not found';
+            test.details.recommendation = 'Verify repository URL and access permissions';
+        }
+        else {
+            test.details.issue = 'Unknown error';
+            test.details.recommendation = 'Check error message for details';
+        }
+    }
+    return test;
+}
+async function testGitClone(url, authType, tokenEnvVar, branch) {
+    const test = {
+        name: 'Git Clone Test',
+        passed: false,
+        details: {}
+    };
+    const tempDir = join(process.cwd(), '.bckb-diagnostic-temp', Date.now().toString());
+    try {
+        const git = simpleGit();
+        // Prepare URL with auth
+        let cloneUrl = url;
+        if (authType === 'token' && tokenEnvVar) {
+            const token = process.env[tokenEnvVar];
+            if (token && cloneUrl.startsWith('https://')) {
+                // For Azure DevOps, use empty username with PAT as password
+                cloneUrl = cloneUrl.replace('https://', `https://:${token}@`);
+            }
+        }
+        test.details.clone_url_format = cloneUrl.replace(/:([^@]+)@/, ':***@'); // Mask token in output
+        await git.clone(cloneUrl, tempDir, [
+            '--depth', '1',
+            '--single-branch',
+            '--branch', branch
+        ]);
+        test.passed = true;
+        test.details.message = `Successfully cloned repository (branch: ${branch})`;
+        test.details.temp_location = tempDir;
+    }
+    catch (error) {
+        test.details.message = 'Clone failed';
+        test.details.error = error.message;
+        // Detailed error analysis
+        if (error.message.includes('authentication failed') || error.message.includes('invalid credentials')) {
+            test.details.issue = 'Authentication failed during clone';
+            test.details.recommendation = [
+                'Verify PAT is valid and not expired',
+                'Ensure PAT has "Code (Read)" scope in Azure DevOps',
+                'Check that the PAT belongs to a user with repository access',
+                'Try regenerating the PAT in Azure DevOps'
+            ];
+        }
+        else if (error.message.includes(`Couldn't find remote ref ${branch}`)) {
+            test.details.issue = `Branch '${branch}' not found`;
+            test.details.recommendation = `Verify branch name - try 'main' or 'master'`;
+        }
+        else {
+            test.details.issue = 'Clone operation failed';
+            test.details.recommendation = 'Review error message for specific cause';
+        }
+    }
+    return test;
+}
+function generateDiagnosticSummary(tests) {
+    const passed = tests.filter(t => t.passed).length;
+    const failed = tests.filter(t => !t.passed).length;
+    return {
+        total_tests: tests.length,
+        passed,
+        failed,
+        overall_status: failed === 0 ? 'PASS' : 'FAIL',
+        failed_tests: tests.filter(t => !t.passed).map(t => t.name)
+    };
+}
+function generateRecommendations(tests, authType) {
+    const recommendations = [];
+    const failedTests = tests.filter(t => !t.passed);
+    if (failedTests.length === 0) {
+        return ['All tests passed! Git layer should work with this configuration.'];
+    }
+    // URL format issues
+    if (failedTests.some(t => t.name === 'URL Format Validation')) {
+        recommendations.push('Fix the repository URL format before proceeding');
+    }
+    // Auth configuration issues
+    if (failedTests.some(t => t.name === 'Authentication Configuration')) {
+        recommendations.push('Configure authentication properly (set environment variable with valid PAT)');
+        if (authType === 'token') {
+            recommendations.push('For Azure DevOps: Create a PAT with "Code (Read)" scope at https://dev.azure.com/{org}/_usersSettings/tokens');
+        }
+    }
+    // Connectivity issues
+    if (failedTests.some(t => t.name === 'Git Connectivity Test')) {
+        recommendations.push('Test network connectivity and verify repository URL');
+        recommendations.push('Ensure firewall/proxy allows git protocol access');
+    }
+    // Clone issues
+    if (failedTests.some(t => t.name === 'Git Clone Test')) {
+        recommendations.push('Review clone test error details for specific issue');
+        recommendations.push('Verify PAT permissions include repository access');
+    }
+    return recommendations;
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/debug/diagnose_git_layer/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../src/tools/debug/diagnose_git_layer/handler.ts"],"names":[],"mappings":"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"}

package/dist/tools/debug/diagnose_git_layer/schema.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Schema for diagnose_git_layer tool
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const diagnoseGitLayerTool: Tool;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/debug/diagnose_git_layer/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/debug/diagnose_git_layer/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,eAAO,MAAM,oBAAoB,EAAE,IAiClC,CAAC"}

package/dist/tools/debug/diagnose_git_layer/schema.js

@@ -0,0 +1,35 @@
+export const diagnoseGitLayerTool = {
+    name: 'diagnose_git_layer',
+    description: 'Diagnose git layer authentication and connectivity issues. Use this when git layers fail to load or Azure DevOps PAT authentication is not working.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            git_url: {
+                type: 'string',
+                description: 'Git repository URL to test (e.g., https://dev.azure.com/org/project/_git/repo)'
+            },
+            auth_type: {
+                type: 'string',
+                enum: ['token', 'basic', 'ssh'],
+                description: 'Authentication type being used'
+            },
+            token_env_var: {
+                type: 'string',
+                description: 'Environment variable name containing the PAT/token (if using token auth)'
+            },
+            branch: {
+                type: 'string',
+                description: 'Branch to test (defaults to main)',
+                default: 'main'
+            },
+            test_type: {
+                type: 'string',
+                enum: ['connectivity', 'authentication', 'clone', 'full'],
+                description: 'Type of diagnostic test to run',
+                default: 'full'
+            }
+        },
+        required: ['git_url', 'auth_type']
+    }
+};
+//# sourceMappingURL=schema.js.map

package/dist/tools/debug/diagnose_git_layer/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/tools/debug/diagnose_git_layer/schema.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qJAAqJ;IAClK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;gBAC/B,WAAW,EAAE,gCAAgC;aAC9C;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0EAA0E;aACxF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;gBAChD,OAAO,EAAE,MAAM;aAChB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,cAAc,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC;gBACzD,WAAW,EAAE,gCAAgC;gBAC7C,OAAO,EAAE,MAAM;aAChB;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;KACnC;CACF,CAAC"}

package/dist/tools/debug/diagnose_local_layer/handler.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handler for diagnose_local_layer tool
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function createDiagnoseLocalLayerHandler(): (args: any) => Promise<CallToolResult>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/tools/debug/diagnose_local_layer/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/tools/debug/diagnose_local_layer/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKpE,wBAAgB,+BAA+B,KACJ,MAAM,GAAG,KAAG,OAAO,CAAC,cAAc,CAAC,CAyL7E"}

package/dist/tools/debug/diagnose_local_layer/handler.js

@@ -0,0 +1,285 @@
+import { existsSync, accessSync, constants as fsConstants } from 'fs';
+import { stat, readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+export function createDiagnoseLocalLayerHandler() {
+    return async function diagnoseLocalLayer(args) {
+        const { layer_path = './bc-code-intel-overrides' } = args;
+        const diagnostics = {
+            timestamp: new Date().toISOString(),
+            layer_path,
+            tests: []
+        };
+        // Test 1: Path Existence
+        const pathTest = {
+            name: 'Path Existence Check',
+            passed: false,
+            details: {}
+        };
+        pathTest.details.absolute_path = join(process.cwd(), layer_path);
+        pathTest.details.exists = existsSync(pathTest.details.absolute_path);
+        if (pathTest.details.exists) {
+            pathTest.passed = true;
+            pathTest.details.message = 'Directory exists';
+        }
+        else {
+            pathTest.details.message = 'Directory does not exist';
+            pathTest.details.recommendation = `Create directory: mkdir ${layer_path}`;
+        }
+        diagnostics.tests.push(pathTest);
+        // Test 2: Permissions Check
+        if (pathTest.details.exists) {
+            const permTest = {
+                name: 'Path Permissions Check',
+                passed: false,
+                details: {}
+            };
+            try {
+                accessSync(pathTest.details.absolute_path, fsConstants.R_OK);
+                permTest.details.readable = true;
+            }
+            catch {
+                permTest.details.readable = false;
+            }
+            try {
+                accessSync(pathTest.details.absolute_path, fsConstants.W_OK);
+                permTest.details.writable = true;
+            }
+            catch {
+                permTest.details.writable = false;
+            }
+            if (permTest.details.readable) {
+                permTest.passed = true;
+                permTest.details.message = 'Directory is accessible';
+            }
+            else {
+                permTest.details.message = 'Directory is not readable';
+                permTest.details.recommendation = 'Check file permissions on the directory';
+            }
+            diagnostics.tests.push(permTest);
+        }
+        // Test 3: Content Discovery
+        if (pathTest.details.exists) {
+            const contentTest = {
+                name: 'Content Discovery',
+                passed: false,
+                details: {}
+            };
+            try {
+                const files = await readdir(pathTest.details.absolute_path);
+                contentTest.details.total_files = files.length;
+                // Check for markdown files
+                const mdFiles = files.filter(f => f.endsWith('.md'));
+                contentTest.details.markdown_files = mdFiles.length;
+                // Check for expected directories
+                const expectedDirs = ['domains', 'topics', 'overrides', 'specialists'];
+                const foundDirs = files.filter(f => expectedDirs.includes(f));
+                contentTest.details.expected_directories_found = foundDirs;
+                // Recursively count markdown files
+                let totalMdFiles = mdFiles.length;
+                for (const item of files) {
+                    const itemPath = join(pathTest.details.absolute_path, item);
+                    try {
+                        const stats = await stat(itemPath);
+                        if (stats.isDirectory()) {
+                            const subFiles = await countMarkdownFiles(itemPath);
+                            totalMdFiles += subFiles;
+                        }
+                    }
+                    catch {
+                        // Skip inaccessible items
+                    }
+                }
+                contentTest.details.total_markdown_files = totalMdFiles;
+                if (totalMdFiles > 0) {
+                    contentTest.passed = true;
+                    contentTest.details.message = `Found ${totalMdFiles} markdown file(s)`;
+                }
+                else {
+                    contentTest.details.message = 'No markdown files found';
+                    contentTest.details.recommendation = 'Add .md files to the directory or subdirectories (domains/, topics/, overrides/)';
+                    contentTest.details.example_structure = [
+                        `${layer_path}/domains/performance/my-optimization.md`,
+                        `${layer_path}/topics/company-specific-pattern.md`,
+                        `${layer_path}/overrides/existing-topic-override.md`
+                    ];
+                }
+            }
+            catch (error) {
+                contentTest.details.message = 'Failed to read directory contents';
+                contentTest.details.error = error.message;
+            }
+            diagnostics.tests.push(contentTest);
+        }
+        // Test 4: Markdown File Validation (sample)
+        if (pathTest.details.exists) {
+            const validationTest = {
+                name: 'Markdown File Validation',
+                passed: false,
+                details: {}
+            };
+            try {
+                const sampleMdFiles = await findSampleMarkdownFiles(pathTest.details.absolute_path, 3);
+                validationTest.details.files_checked = sampleMdFiles.length;
+                if (sampleMdFiles.length > 0) {
+                    const validFiles = [];
+                    const invalidFiles = [];
+                    for (const file of sampleMdFiles) {
+                        const isValid = await validateMarkdownFile(file);
+                        if (isValid) {
+                            validFiles.push(file);
+                        }
+                        else {
+                            invalidFiles.push(file);
+                        }
+                    }
+                    validationTest.details.valid_files = validFiles.length;
+                    validationTest.details.invalid_files = invalidFiles.length;
+                    if (validFiles.length > 0) {
+                        validationTest.passed = true;
+                        validationTest.details.message = `${validFiles.length} of ${sampleMdFiles.length} files have valid frontmatter`;
+                    }
+                    else {
+                        validationTest.details.message = 'No valid markdown files with frontmatter found';
+                        validationTest.details.recommendation = 'Ensure markdown files have YAML frontmatter with title, domain, etc.';
+                    }
+                    if (invalidFiles.length > 0) {
+                        validationTest.details.invalid_file_examples = invalidFiles.slice(0, 2);
+                        validationTest.details.issue = 'Some files missing or have invalid YAML frontmatter';
+                    }
+                }
+            }
+            catch (error) {
+                validationTest.details.message = 'Failed to validate markdown files';
+                validationTest.details.error = error.message;
+            }
+            diagnostics.tests.push(validationTest);
+        }
+        // Generate recommendations
+        const recommendations = generateLocalLayerRecommendations(diagnostics.tests);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...diagnostics,
+                        summary: generateDiagnosticSummary(diagnostics.tests),
+                        recommendations
+                    }, null, 2)
+                }]
+        };
+    };
+}
+async function countMarkdownFiles(dir) {
+    let count = 0;
+    try {
+        const files = await readdir(dir);
+        for (const file of files) {
+            const filePath = join(dir, file);
+            try {
+                const stats = await stat(filePath);
+                if (stats.isDirectory()) {
+                    count += await countMarkdownFiles(filePath);
+                }
+                else if (file.endsWith('.md')) {
+                    count++;
+                }
+            }
+            catch {
+                // Skip inaccessible files
+            }
+        }
+    }
+    catch {
+        // Skip inaccessible directories
+    }
+    return count;
+}
+async function findSampleMarkdownFiles(dir, limit) {
+    const files = [];
+    const findInDir = async (currentDir) => {
+        if (files.length >= limit)
+            return;
+        try {
+            const items = await readdir(currentDir);
+            for (const item of items) {
+                if (files.length >= limit)
+                    break;
+                const itemPath = join(currentDir, item);
+                try {
+                    const stats = await stat(itemPath);
+                    if (stats.isDirectory()) {
+                        await findInDir(itemPath);
+                    }
+                    else if (item.endsWith('.md')) {
+                        files.push(itemPath);
+                    }
+                }
+                catch {
+                    // Skip inaccessible items
+                }
+            }
+        }
+        catch {
+            // Skip inaccessible directories
+        }
+    };
+    await findInDir(dir);
+    return files;
+}
+async function validateMarkdownFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        // Check for YAML frontmatter
+        const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            return false;
+        }
+        // Basic validation - has some required fields
+        const frontmatter = frontmatterMatch[1];
+        return frontmatter.includes('title:') || frontmatter.includes('domain:');
+    }
+    catch {
+        return false;
+    }
+}
+function generateDiagnosticSummary(tests) {
+    const passed = tests.filter(t => t.passed).length;
+    const failed = tests.filter(t => !t.passed).length;
+    return {
+        total_tests: tests.length,
+        passed,
+        failed,
+        overall_status: failed === 0 ? 'PASS' : 'FAIL',
+        failed_tests: tests.filter(t => !t.passed).map(t => t.name)
+    };
+}
+function generateLocalLayerRecommendations(tests) {
+    const recommendations = [];
+    const failedTests = tests.filter(t => !t.passed);
+    if (failedTests.length === 0) {
+        return ['All local layer checks passed! Layer should be loading correctly.'];
+    }
+    // Path doesn't exist
+    if (failedTests.some(t => t.name === 'Path Existence Check')) {
+        recommendations.push('Create the local layer directory before adding content');
+        recommendations.push('Use: mkdir -p ./bc-code-intel-overrides/domains');
+    }
+    // Permission issues
+    if (failedTests.some(t => t.name === 'Path Permissions Check')) {
+        recommendations.push('Fix directory permissions to allow read access');
+        recommendations.push('Check ownership and group permissions');
+    }
+    // No content
+    if (failedTests.some(t => t.name === 'Content Discovery')) {
+        recommendations.push('Add markdown files with BC knowledge to the directory');
+        recommendations.push('Organize in subdirectories: domains/, topics/, or overrides/');
+        recommendations.push('Each .md file should have YAML frontmatter with title, domain, tags, etc.');
+    }
+    // Invalid files
+    if (failedTests.some(t => t.name === 'Markdown File Validation')) {
+        recommendations.push('Ensure markdown files have proper YAML frontmatter (---...---)');
+        recommendations.push('Required frontmatter fields: title, domain');
+        recommendations.push('See embedded knowledge files for examples');
+    }
+    return recommendations;
+}
+//# sourceMappingURL=handler.js.map