Upload folder using huggingface_hub

README.md

@@ -3,8 +3,8 @@ title: Jenkins Error Explainer
 emoji: 🔧
 colorFrom: blue
 colorTo: green
-sdk: docker
-app_file: app.py
+sdk: static
+app_file: index.html
 pinned: false
 ---
 

index.html

@@ -6,112 +6,323 @@
     <title>Jenkins Error Explainer</title>
     <style>
         * { box-sizing: border-box; margin: 0; padding: 0; }
-        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #f5f5f5; padding: 20px; }
-        .container { max-width: 800px; margin: 0 auto; }
-        h1 { color: #333; margin-bottom: 10px; }
-        .description { color: #666; margin-bottom: 20px; }
-        textarea { width: 100%; height: 200px; padding: 15px; border: 1px solid #ddd; border-radius: 8px; font-family: monospace; font-size: 14px; resize: vertical; }
-        button { background: #4CAF50; color: white; border: none; padding: 12px 24px; font-size: 16px; border-radius: 8px; cursor: pointer; margin-top: 10px; }
-        button:hover { background: #45a049; }
-        button:disabled { background: #ccc; cursor: not-allowed; }
-        #result { margin-top: 20px; padding: 20px; background: white; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
-        .error-category { color: #e74c3c; font-weight: bold; }
-        .summary { margin: 15px 0; }
-        .causes ul { margin-left: 20px; }
-        .references { margin-top: 15px; font-size: 14px; color: #666; }
-        .loading { color: #666; font-style: italic; }
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); min-height: 100vh; padding: 40px 20px; }
+        .container { max-width: 800px; margin: 0 auto; background: white; border-radius: 16px; box-shadow: 0 20px 60px rgba(0,0,0,0.3); overflow: hidden; }
+        .header { background: linear-gradient(135deg, #4a90d9 0%, #5c3cb8 100%); color: white; padding: 30px; text-align: center; }
+        .header h1 { font-size: 28px; margin-bottom: 8px; }
+        .header p { opacity: 0.9; font-size: 14px; }
+        .content { padding: 30px; }
+        textarea { width: 100%; height: 200px; padding: 15px; border: 2px solid #e0e0e0; border-radius: 12px; font-family: 'Monaco', 'Menlo', monospace; font-size: 13px; resize: vertical; transition: border-color 0.3s; }
+        textarea:focus { outline: none; border-color: #667eea; }
+        .btn { display: block; width: 100%; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; border: none; padding: 16px; font-size: 16px; font-weight: 600; border-radius: 12px; cursor: pointer; margin-top: 20px; transition: transform 0.2s, box-shadow 0.2s; }
+        .btn:hover { transform: translateY(-2px); box-shadow: 0 8px 20px rgba(102, 126, 234, 0.4); }
+        .btn:disabled { opacity: 0.7; cursor: not-allowed; transform: none; }
+        #result { margin-top: 30px; display: none; }
+        #result.show { display: block; animation: fadeIn 0.4s ease; }
+        @keyframes fadeIn { from { opacity: 0; transform: translateY(10px); } to { opacity: 1; transform: translateY(0); } }
+        .error-category { display: inline-block; background: linear-gradient(135deg, #ff6b6b 0%, #ee5a5a 100%); color: white; padding: 8px 16px; border-radius: 20px; font-weight: 600; font-size: 14px; margin-bottom: 15px; }
+        .section { margin: 20px 0; }
+        .section h3 { color: #333; font-size: 16px; margin-bottom: 10px; }
+        .summary { background: #f8f9fa; padding: 15px; border-radius: 10px; line-height: 1.6; color: #555; }
+        .causes { background: #fff3e0; padding: 15px; border-radius: 10px; }
+        .causes ul { margin-left: 20px; color: #e65100; }
+        .causes li { margin: 8px 0; }
+        .references { background: #e8f5e9; padding: 15px; border-radius: 10px; }
+        .references ul { margin-left: 20px; color: #2e7d32; }
+        .references li { margin: 5px 0; }
+        .footer { background: #f5f5f5; padding: 20px; text-align: center; color: #888; font-size: 12px; }
     </style>
 </head>
 <body>
     <div class="container">
-        <h1>🔧 Jenkins Error Explainer</h1>
-        <p class="description">AI-powered Jenkins pipeline error diagnosis</p>
+        <div class="header">
+            <h1>🔧 Jenkins Error Explainer</h1>
+            <p>AI-powered Jenkins pipeline error diagnosis</p>
+        </div>
         
-        <textarea id="logInput" placeholder="Paste your Jenkins error log here..."></textarea>
-        <br>
-        <button onclick="explainError()" id="submitBtn">Explain Error</button>
+        <div class="content">
+            <textarea id="logInput" placeholder="Paste your Jenkins error log here...
+
+Example:
+Started by user admin
+org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed:
+WorkflowScript: 10: expecting '}', found '' @ line 10, column 1
+"></textarea>
+            <button class="btn" onclick="explainError()" id="submitBtn">Analyze Error</button>
+            
+            <div id="result">
+                <span class="error-category" id="category"></span>
+                
+                <div class="section">
+                    <h3>📝 Summary</h3>
+                    <div class="summary" id="summary"></div>
+                </div>
+                
+                <div class="section">
+                    <h3>🔍 Likely Causes</h3>
+                    <div class="causes"><ul id="causes"></ul></div>
+                </div>
+                
+                <div class="section">
+                    <h3>📚 References</h3>
+                    <div class="references"><ul id="references"></ul></div>
+                </div>
+            </div>
+        </div>
         
-        <div id="result"></div>
+        <div class="footer">
+            Built with ❤️ for Jenkins Developers
+        </div>
     </div>
 
     <script>
+        const ERROR_DATABASE = {
+            groovy_syntax_error: {
+                category: "Groovy Syntax Error",
+                summary: "The pipeline failed due to a Groovy syntax error, most likely caused by an invalid or incomplete Jenkinsfile.",
+                causes: [
+                    "Missing or mismatched braces in the Jenkinsfile",
+                    "Invalid declarative pipeline structure",
+                    "Incorrect string quotes or special characters",
+                    "Missing required keywords like 'pipeline', 'stages', or 'steps'"
+                ],
+                references: [
+                    "Pipeline Syntax Reference (Jenkins.io)",
+                    "Declarative Pipeline Documentation",
+                    "Groovy Language Documentation"
+                ]
+            },
+            missing_agent: {
+                category: "Missing Agent",
+                summary: "The pipeline attempted to execute a step that requires a node, but no agent was allocated.",
+                causes: [
+                    "Using 'agent none' without defining a stage-level agent",
+                    "Executing node-dependent steps (like 'sh', 'node') without a workspace",
+                    "Missing agent directive in declarative pipeline"
+                ],
+                references: [
+                    "Agent Directive (Jenkins.io)",
+                    "Pipeline Steps Documentation"
+                ]
+            },
+            no_node_available: {
+                category: "No Node Available",
+                summary: "The pipeline could not be scheduled because no Jenkins node matched the requested label.",
+                causes: [
+                    "The specified node label does not exist",
+                    "All matching nodes are offline or busy",
+                    "No executors available on matching nodes",
+                    "Node label typo or case mismatch"
+                ],
+                references: [
+                    "Distributed Builds (Jenkins.io)",
+                    "Node Label Plugin Documentation",
+                    "Label Selector Plugin"
+                ]
+            },
+            missing_plugin: {
+                category: "Missing Plugin",
+                summary: "The pipeline referenced a step that is not available, indicating a missing or uninstalled plugin.",
+                causes: [
+                    "Required plugin is not installed",
+                    "Plugin is installed but not enabled",
+                    "Incorrect step name in the Jenkinsfile",
+                    "Plugin version mismatch"
+                ],
+                references: [
+                    "Plugin Index",
+                    "Pipeline Steps Reference",
+                    "Managing Plugins Documentation"
+                ]
+            },
+            missing_credentials: {
+                category: "Missing Credentials",
+                summary: "The pipeline referenced credentials that do not exist in Jenkins.",
+                causes: [
+                    "Credentials ID is incorrect or misspelled",
+                    "Credentials were not configured in Jenkins",
+                    "Credentials have expired or been deleted",
+                    "User does not have permission to use the credentials"
+                ],
+                references: [
+                    "Credentials Plugin Documentation",
+                    "Using Credentials in Pipelines",
+                    "Credential Binding Plugin"
+                ]
+            },
+            file_not_found: {
+                category: "File Not Found",
+                summary: "The pipeline attempted to access a file that does not exist in the workspace.",
+                causes: [
+                    "File path is incorrect or has typos",
+                    "File was not generated in previous build step",
+                    "File was not checked out from version control",
+                    "Working directory mismatch"
+                ],
+                references: [
+                    "Pipeline Basic Steps",
+                    "Workspace Plugin Documentation",
+                    "File Operations Plugin"
+                ]
+            },
+            git_authentication_error: {
+                category: "Git Authentication Error",
+                summary: "Jenkins failed to authenticate with the Git repository during checkout.",
+                causes: [
+                    "Invalid or missing Git credentials",
+                    "SSH key not configured properly",
+                    "Repository URL authentication method mismatch",
+                    "Token has expired or been revoked"
+                ],
+                references: [
+                    "Git Plugin Documentation",
+                    "Credential Binding Plugin",
+                    "SSH Credentials Plugin"
+                ]
+            },
+            timeout_error: {
+                category: "Timeout Error",
+                summary: "The pipeline or a step took too long to complete and was terminated.",
+                causes: [
+                    "Step execution time exceeded timeout limit",
+                    "Network latency or connection issues",
+                    "External service not responding",
+                    "Build queue is too long causing delays"
+                ],
+                references: [
+                    "Timeout Step Documentation",
+                    "Pipeline Timeout Configuration",
+                    "Jenkins Queue Management"
+                ]
+            },
+            out_of_memory: {
+                category: "Out of Memory",
+                summary: "The build failed due to insufficient memory allocation.",
+                causes: [
+                    "JVM heap size too small for the build",
+                    "Memory leak in the application",
+                    "Too many parallel builds consuming memory",
+                    "Large file processing exceeding limits"
+                ],
+                references: [
+                    "JVM Memory Tuning",
+                    "Pipeline Resource Management",
+                    "Kubernetes Memory Limits"
+                ]
+            },
+            permission_denied: {
+                category: "Permission Denied",
+                summary: "The pipeline attempted an operation without sufficient permissions.",
+                causes: [
+                    "Insufficient file system permissions",
+                    "Missing role-based access control (RBAC) permissions",
+                    "Pipeline lacks required approval or authorization",
+                    "Security realm authentication failure"
+                ],
+                references: [
+                    "Matrix Authorization Strategy",
+                    "Role-Based Access Control Plugin",
+                    "Pipeline Security Documentation"
+                ]
+            },
+            docker_error: {
+                category: "Docker Error",
+                summary: "The pipeline failed while building or running Docker containers.",
+                causes: [
+                    "Docker daemon not running or not accessible",
+                    "Invalid Docker image name or tag",
+                    "Dockerfile syntax errors",
+                    "Insufficient permissions to pull images"
+                ],
+                references: [
+                    "Docker Pipeline Plugin",
+                    "Dockerfile Reference",
+                    "Kaniko vs Docker Build"
+                ]
+            },
+            unknown: {
+                category: "Unknown Error",
+                summary: "The error could not be confidently identified. Please check the error message for more details.",
+                causes: [
+                    "Review the full error log for specific details",
+                    "Check Jenkins system logs for more information",
+                    "Search Jenkins community forums for the error",
+                    "Contact Jenkins administrators for help"
+                ],
+                references: [
+                    "Jenkins Pipeline Troubleshooting Guide",
+                    "Jenkins Users Mailing List",
+                    "Jenkins Community Forum"
+                ]
+            }
+        };
+
+        function detectErrorCategory(log) {
+            const lower = log.toLowerCase();
+            
+            if (lower.includes('groovy') && (lower.includes('syntax') || lower.includes('expecting') || lower.includes('failed'))) {
+                return 'groovy_syntax_error';
+            }
+            if (lower.includes('agent') && (lower.includes('none') || lower.includes('null'))) {
+                return 'missing_agent';
+            }
+            if (lower.includes('no node') || lower.includes('no such agent') || lower.includes('label')) {
+                return 'no_node_available';
+            }
+            if (lower.includes('no such dsl') || lower.includes('undefined method') || lower.includes('not a valid step')) {
+                return 'missing_plugin';
+            }
+            if (lower.includes('credentials') && (lower.includes('not found') || lower.includes('null') || lower.includes('missing'))) {
+                return 'missing_credentials';
+            }
+            if (lower.includes('file not found') || lower.includes('no such file') || lower.includes('does not exist')) {
+                return 'file_not_found';
+            }
+            if ((lower.includes('git') || lower.includes('checkout')) && (lower.includes('authentication') || lower.includes('failed') || lower.includes('permission'))) {
+                return 'git_authentication_error';
+            }
+            if (lower.includes('timeout') || lower.includes('timed out') || lower.includes('deadline exceeded')) {
+                return 'timeout_error';
+            }
+            if (lower.includes('outofmemory') || lower.includes('out of memory') || lower.includes('heap space') || lower.includes('oom')) {
+                return 'out_of_memory';
+            }
+            if (lower.includes('permission denied') || lower.includes('access denied') || lower.includes('unauthorized')) {
+                return 'permission_denied';
+            }
+            if (lower.includes('docker') && (lower.includes('error') || lower.includes('failed') || lower.includes('not found'))) {
+                return 'docker_error';
+            }
+            return 'unknown';
+        }
+
         function explainError() {
             const logText = document.getElementById('logInput').value;
             const resultDiv = document.getElementById('result');
             const btn = document.getElementById('submitBtn');
             
             if (!logText.trim()) {
-                resultDiv.innerHTML = '<p class="loading">Please provide a Jenkins error log.</p>';
+                alert('Please provide a Jenkins error log.');
                 return;
             }
             
             btn.disabled = true;
             btn.textContent = 'Analyzing...';
             
-            const category = detectError(logText);
-            const explanations = getExplanation(category);
-            
-            resultDiv.innerHTML = `
-                <p class="error-category">Error Category: ${category}</p>
-                <p class="summary"><strong>Summary:</strong> ${explanations.summary}</p>
-                <div class="causes">
-                    <strong>Likely Causes:</strong>
-                    <ul>${explanations.causes.map(c => `<li>${c}</li>`).join('')}</ul>
-                </div>
-            `;
-            
-            btn.disabled = false;
-            btn.textContent = 'Explain Error';
-        }
-        
-        function detectError(log) {
-            const lower = log.toLowerCase();
-            if (lower.includes('groovy') || lower.includes('syntax') || lower.includes("expecting '}'")) return 'groovy_syntax_error';
-            if (lower.includes('agent') && lower.includes('none')) return 'missing_agent';
-            if (lower.includes('no node') || lower.includes('no such agent')) return 'no_node_available';
-            if (lower.includes('no such DSL') || lower.includes('undefined method')) return 'missing_plugin';
-            if (lower.includes('credentials') || lower.includes('not found')) return 'missing_credentials';
-            if (lower.includes('file not found') || lower.includes('no such file')) return 'file_not_found';
-            if (lower.includes('authentication') || lower.includes('git')) return 'git_authentication_error';
-            return 'unknown';
-        }
-        
-        function getExplanation(category) {
-            const explanations = {
-                groovy_syntax_error: {
-                    summary: 'The pipeline failed due to a Groovy syntax error, most likely caused by an invalid or incomplete Jenkinsfile.',
-                    causes: ['Missing or mismatched braces in the Jenkinsfile', 'Invalid declarative pipeline structure']
-                },
-                missing_agent: {
-                    summary: 'The pipeline attempted to execute a step that requires a node, but no agent was allocated.',
-                    causes: ["Using 'agent none' without defining a stage-level agent", "Executing node-dependent steps without a workspace"]
-                },
-                no_node_available: {
-                    summary: 'The pipeline could not be scheduled because no Jenkins node matched the requested label.',
-                    causes: ['The specified node label does not exist', 'All matching nodes are offline or busy']
-                },
-                missing_plugin: {
-                    summary: 'The pipeline referenced a step that is not available, indicating a missing or uninstalled plugin.',
-                    causes: ['Required plugin is not installed', 'Incorrect step name in the Jenkinsfile']
-                },
-                missing_credentials: {
-                    summary: 'The pipeline referenced credentials that do not exist in Jenkins.',
-                    causes: ['Credentials ID is incorrect or misspelled', 'Credentials were not configured in Jenkins']
-                },
-                file_not_found: {
-                    summary: 'The pipeline attempted to access a file that does not exist in the workspace.',
-                    causes: ['File path is incorrect', 'File was not generated or checked out']
-                },
-                git_authentication_error: {
-                    summary: 'Jenkins failed to authenticate with the Git repository during checkout.',
-                    causes: ['Invalid or missing Git credentials', 'Repository requires token-based authentication']
-                },
-                unknown: {
-                    summary: 'The error could not be confidently identified. Please check the error message for more details.',
-                    causes: ['Review the full error log', 'Check Jenkins system logs']
-                }
-            };
-            return explanations[category] || explanations.unknown;
+            setTimeout(() => {
+                const category = detectErrorCategory(logText);
+                const info = ERROR_DATABASE[category];
+                
+                document.getElementById('category').textContent = info.category;
+                document.getElementById('summary').textContent = info.summary;
+                document.getElementById('causes').innerHTML = info.causes.map(c => `<li>${c}</li>`).join('');
+                document.getElementById('references').innerHTML = info.references.map(r => `<li>${r}</li>`).join('');
+                
+                resultDiv.classList.add('show');
+                
+                btn.disabled = false;
+                btn.textContent = 'Analyze Error';
+            }, 500);
         }
     </script>
 </body>