ci-triage 0.3.0 → 0.3.1

package/dist/index.js

@@ -10,6 +10,7 @@ import { getDbStats, getFlakes, getRemediations, markResolved, markVerified, per
 import { analyzeLlm } from './llm-analyzer.js';
 import { fetchRepoContext } from './repo-context.js';
 import { buildMultiJson, detectSharedPatterns, formatMultiSummary } from './multi.js';
+import { startMcpServer } from './mcp-server.js';
 // --version support
 const _require = createRequire(import.meta.url);
 let pkgVersion = 'unknown';
@@ -39,8 +40,10 @@ function usage() {
         '  --md <path>             Write markdown report to file',
         '  --json                  Output JSON instead of human text',
         '  --provider <p>          Force CI provider: github | gitlab | circleci',
-        '  --llm                   Enable LLM root-cause analysis (requires OPENAI_API_KEY)',
+        '  --llm                   Enable LLM root-cause analysis (auto-on when OPENAI_API_KEY is set)',
+        '  --no-llm                Disable LLM even when OPENAI_API_KEY is set (alias: CI_TRIAGE_NO_LLM=1)',
         '  --llm-model <model>     Override LLM model (default: gpt-4.1-mini)',
+        '  --mcp                   Start MCP server (stdio transport) for agent tool use',
         '  --version               Print version and exit',
     ].join('\n'));
     process.exit(1);
@@ -176,6 +179,8 @@ export function parseArgs(argv) {
         outputJson: args.includes('--json'),
         provider,
         llm: args.includes('--llm'),
+        noLlm: args.includes('--no-llm'),
+        mcp: args.includes('--mcp'),
         llmModel,
     };
 }
@@ -299,7 +304,12 @@ export async function triageRepo(options) {
             event: metadata.event,
         },
     });
-    const llmEnabled = options.llm || !!process.env['OPENAI_API_KEY'];
+    const noLlm = options.noLlm || !!process.env['CI_TRIAGE_NO_LLM'];
+    const autoLlm = !noLlm && !!process.env['OPENAI_API_KEY'];
+    if (autoLlm && !options.llm && !noLlm) {
+        process.stderr.write('ℹ using LLM analysis (set CI_TRIAGE_NO_LLM=1 or pass --no-llm to disable)\n');
+    }
+    const llmEnabled = !noLlm && (options.llm || !!process.env['OPENAI_API_KEY']);
     if (llmEnabled) {
         const repoContext = await repoContextPromise;
         const failureEntries = classified.map((f) => ({
@@ -341,6 +351,7 @@ async function runMultiCommand(options) {
                 repo,
                 provider: options.provider,
                 llm: options.llm,
+                noLlm: options.noLlm,
                 llmModel: options.llmModel,
             });
             reports.push(report);
@@ -359,6 +370,11 @@ async function runMultiCommand(options) {
 }
 async function main() {
     const options = parseArgs(process.argv);
+    // --mcp: start MCP server in stdio mode
+    if (options.mcp) {
+        await startMcpServer();
+        return;
+    }
     // Handle subcommands
     if (options.subcommand === 'flakes') {
         await runFlakesCommand(options.repo);
@@ -442,7 +458,12 @@ async function main() {
         },
     });
     // LLM analysis (gated)
-    const llmEnabled = options.llm || !!process.env['OPENAI_API_KEY'];
+    const noLlm = options.noLlm || !!process.env['CI_TRIAGE_NO_LLM'];
+    const autoLlm = !noLlm && !!process.env['OPENAI_API_KEY'];
+    if (autoLlm && !options.llm && !noLlm) {
+        process.stderr.write('ℹ using LLM analysis (set CI_TRIAGE_NO_LLM=1 or pass --no-llm to disable)\n');
+    }
+    const llmEnabled = !noLlm && (options.llm || !!process.env['OPENAI_API_KEY']);
     if (llmEnabled) {
         const repoContext = await repoContextPromise;
         const failureEntries = classified.map((f) => ({

package/dist/parser.js

@@ -1,3 +1,4 @@
+import { infraParsers } from './parsers/index.js';
 const ANSI_REGEX = /\x1B\[[0-?]*[ -/]*[@-~]/g;
 const TIMESTAMP_PREFIX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z\s*/;
 const MAX_LINES = 25_000;
@@ -10,7 +11,12 @@ const ERROR_LINE_REGEX = [
     /^FAILED\b.+$/,
     /^Caused by:\s+.+$/i,
     /\b(?:heap out of memory|permission denied|cannot find module|failed to start container|no such image)\b/i,
+    /\b(?:command not found|script returned exit code|the command exited with)\b/i,
     /\b(?:eacces|enoent|econnrefused|etimedout|timed out|rate limit(?:ed)?|too many requests)\b/i,
+    /\bcurl:\s*\(\d+\).*(?:4\d{2}|5\d{2})\b/i,
+    /\b(?:http(?:\/\d(?:\.\d)?)?\s+|status(?: code)?[:=]?\s*)(?:4\d{2}|5\d{2})\b/i,
+    /\b(?:pages?\s+(?:deploy|deployment).*(?:failed|error)|failed to create deployment)\b/i,
+    /\b(?:codeql|code[- ]scanning).*(?:workflow error|analysis failed|database .* failed|required permissions|init failed|analyze failed)\b/i,
     /\b(?:environment variable .* not set|missing env(?:ironment)? variable|undefined env)\b/i,
     /\b(?:npm audit|vulnerabilities|eslint|linting failed|error ts\d{4})\b/i,
     /\berror\s+TS\d{4}\b/i,
@@ -243,17 +249,16 @@ export function parseInfraFailures(rawLog) {
             continue;
         }
         const context = `${lines[i - 1] ?? ''}\n${line}\n${lines[i + 1] ?? ''}`;
-        // Shell script/runtime errors from bash/sh.
-        if (/^.+:\s*line\s+\d+:\s*.+$/i.test(line) ||
-            /\bcommand not found\b/i.test(line) ||
-            /\bpermission denied\b/i.test(line) ||
-            /\bno such file or directory\b/i.test(line)) {
-            failures.push(createInfraFailure(lines, i, line));
-            continue;
-        }
-        // HTTP errors.
-        if (/\bHTTP\s*(?:403|404|429|5\d{2})\b/i.test(line) || /\b(?:403 Forbidden|404 Not Found)\b/i.test(line)) {
-            failures.push(createInfraFailure(lines, i, line));
+        const matchedByHandler = infraParsers
+            .map((handler) => handler({
+            line,
+            prevLine: lines[i - 1] ?? '',
+            nextLine: lines[i + 1] ?? '',
+            context,
+        }))
+            .find((value) => Boolean(value));
+        if (matchedByHandler) {
+            failures.push(createInfraFailure(lines, i, matchedByHandler));
             continue;
         }
         // GitHub Actions explicit step failure line.
@@ -272,14 +277,10 @@ export function parseInfraFailures(rawLog) {
             failures.push(createInfraFailure(lines, i, line));
             continue;
         }
-        // GitHub Pages deploy failures.
-        if (/\bError:\s*Get Pages site failed\b/i.test(line) ||
-            (/\bHttpError:\s*Not Found\b/i.test(line) && /\bpages?\b/i.test(context))) {
-            failures.push(createInfraFailure(lines, i, line));
-            continue;
-        }
-        // CodeQL/configuration errors.
-        if (/\bconfiguration error\b/i.test(line) && /\b(?:codeql|code[- ]scanning)\b/i.test(context)) {
+        // CodeQL/configuration/workflow errors.
+        if ((/\bconfiguration error\b/i.test(line) && /\b(?:codeql|code[- ]scanning)\b/i.test(context)) ||
+            (/\b(?:workflow error|analysis failed|database .* failed|required permissions|init failed|analyze failed|autobuild failed)\b/i.test(line) &&
+                /\b(?:codeql|code[- ]scanning|github\/codeql-action)\b/i.test(context))) {
             failures.push(createInfraFailure(lines, i, line));
             continue;
         }

package/dist/parsers/deploy-pages-failure.js

@@ -0,0 +1,33 @@
+const GITHUB_PAGES_PATTERNS = [
+    /\bError:\s*Get Pages site failed\b/i,
+    /\bfailed to create deployment\b/i,
+    /\bpages?\s+(?:deploy|deployment).*(?:failed|error)\b/i,
+];
+const VERCEL_PATTERNS = [
+    /\bvercel\b.*\b(?:error|failed|failure)\b/i,
+    /\b(?:vercel|vc)\s+deploy\b.*\b(?:error|failed)\b/i,
+    /\b(?:project|team)\s+not found\b.*\bvercel\b/i,
+    /\bNo Output Directory named\b/i,
+    /\bCommand\s+\".+\"\s+exited with\s+[1-9]\d*\b/i,
+];
+const CLOUDFLARE_PATTERNS = [
+    /\bcloudflare\b.*\b(?:error|failed|failure)\b/i,
+    /\bcloudflare pages\b.*\b(?:error|failed|failure)\b/i,
+    /\bwrangler\b.*\b(?:error|failed|failure)\b/i,
+    /\bA request to the Cloudflare API\b.*\bfailed\b/i,
+];
+export const parseDeployPagesFailure = ({ line, context }) => {
+    if (GITHUB_PAGES_PATTERNS.some((pattern) => pattern.test(line))) {
+        return line.trim();
+    }
+    if (/\bHttpError:\s*Not Found\b/i.test(line) && /\b(?:pages?|deploy)\b/i.test(context)) {
+        return line.trim();
+    }
+    if (VERCEL_PATTERNS.some((pattern) => pattern.test(line))) {
+        return line.trim();
+    }
+    if (CLOUDFLARE_PATTERNS.some((pattern) => pattern.test(line))) {
+        return line.trim();
+    }
+    return null;
+};

package/dist/parsers/http-error.js

@@ -0,0 +1,13 @@
+const HTTP_PATTERNS = [
+    /\bHTTP(?:\/\d(?:\.\d)?)?\s+(?:4\d{2}|5\d{2})\b/i,
+    /\b(?:status|status code)[:=]?\s*(?:4\d{2}|5\d{2})\b/i,
+    /\bcurl:\s*\(\d+\).*(?:4\d{2}|5\d{2})\b/i,
+    /\bfetch\b.*\b(?:HTTP|status|status code)[:=]?\s*(?:4\d{2}|5\d{2})\b/i,
+    /\b(?:4\d{2}|5\d{2})\s+(?:Bad Request|Unauthorized|Forbidden|Not Found|Too Many Requests|Internal Server Error|Bad Gateway|Service Unavailable|Gateway Timeout)\b/i,
+];
+export const parseHttpError = ({ line }) => {
+    if (HTTP_PATTERNS.some((pattern) => pattern.test(line))) {
+        return line.trim();
+    }
+    return null;
+};

package/dist/parsers/index.js

@@ -0,0 +1,9 @@
+import { parseDeployPagesFailure } from './deploy-pages-failure.js';
+import { parseHttpError } from './http-error.js';
+import { parseShellScriptFailure } from './shell-failure.js';
+export const infraParsers = [
+    parseShellScriptFailure,
+    parseHttpError,
+    parseDeployPagesFailure,
+];
+export { parseDeployPagesFailure, parseHttpError, parseShellScriptFailure };

package/dist/parsers/shell-failure.js

@@ -0,0 +1,14 @@
+const SHELL_PATTERNS = [
+    /^.+:\s*line\s+\d+:\s*.+$/i,
+    /\bcommand not found\b/i,
+    /\bpermission denied\b/i,
+    /\bno such file or directory\b/i,
+    /\b(?:script returned exit code|the command exited with)\s*([1-9]\d*)\b/i,
+    /\bexit code\s+([1-9]\d*)\b/i,
+];
+export const parseShellScriptFailure = ({ line }) => {
+    if (SHELL_PATTERNS.some((pattern) => pattern.test(line))) {
+        return line.trim();
+    }
+    return null;
+};

package/dist/parsers/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ci-triage",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Open-source CI failure triage for humans and agents — smart log parsing, flake detection, structured JSON, MCP server.",
   "type": "module",
   "bin": {
@@ -41,7 +41,7 @@
   "homepage": "https://github.com/clankamode/ci-triage",
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.13.10",
+    "@types/node": "^25.3.1",
     "typescript": "^5.9.2",
     "vitest": "^4.0.18"
   },