ci-triage 0.3.0 → 0.3.2

package/dist/index.js

@@ -9,7 +9,8 @@ import { getProvider, detectProvider } from './providers/index.js';
 import { getDbStats, getFlakes, getRemediations, markResolved, markVerified, persistRun, pruneRuns } from './flake-store.js';
 import { analyzeLlm } from './llm-analyzer.js';
 import { fetchRepoContext } from './repo-context.js';
-import { buildMultiJson, detectSharedPatterns, formatMultiSummary } from './multi.js';
+import { buildMultiJson, detectSharedPatterns, filterReportsSince, formatMultiSummary } from './multi.js';
+import { startMcpServer } from './mcp-server.js';
 // --version support
 const _require = createRequire(import.meta.url);
 let pkgVersion = 'unknown';
@@ -26,10 +27,12 @@ function usage() {
         '',
         'Usage:',
         '  ci-triage owner/repo [limit] [--run <id>] [--md report.md] [--json]',
-        '  ci-triage multi owner/repo1 owner/repo2 owner/repo3 [--json]',
+        '  ci-triage multi owner/repo1,owner/repo2 [--json] [--since 24h]',
+        '  ci-triage --multi owner/repo1,owner/repo2 [--json] [--since 24h]',
         '  ci-triage flakes owner/repo',
         '  ci-triage db prune [--days 90]',
         '  ci-triage db stats [owner/repo] [--json]',
+        '  ci-triage mcp',
         '  ci-triage resolve <owner/repo> <run-id> "<description>" [--commit <sha>]',
         '  ci-triage verify <owner/repo> <run-id> --clean-run <clean-run-id>',
         '  ci-triage history <owner/repo> [--json]',
@@ -38,9 +41,13 @@ function usage() {
         '  --run <id>              Triage a specific run ID',
         '  --md <path>             Write markdown report to file',
         '  --json                  Output JSON instead of human text',
+        '  --multi                 Run cross-repo triage mode',
+        '  --since <duration>      Multi mode time filter, e.g. 24h, 7d, 30m',
         '  --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);
@@ -56,6 +63,52 @@ export function emitEmptyOutputWarning(totalFailures, llmRan) {
         process.stderr.write(EMPTY_OUTPUT_WARNING);
     }
 }
+function positionalArgsExcludingOptionValues(args) {
+    const optionsWithValues = new Set([
+        '--run',
+        '--md',
+        '--provider',
+        '--llm-model',
+        '--days',
+        '--commit',
+        '--clean-run',
+        '--since',
+    ]);
+    const positional = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const token = args[i];
+        if (optionsWithValues.has(token)) {
+            i += 1;
+            continue;
+        }
+        if (token.startsWith('--'))
+            continue;
+        positional.push(token);
+    }
+    return positional;
+}
+function parseSinceHours(raw) {
+    if (!raw)
+        return undefined;
+    const match = raw.match(/^(\d+)([mhd])$/i);
+    if (!match)
+        return undefined;
+    const value = Number(match[1]);
+    if (!Number.isFinite(value) || value <= 0)
+        return undefined;
+    const unit = match[2].toLowerCase();
+    if (unit === 'm')
+        return value / 60;
+    if (unit === 'h')
+        return value;
+    return value * 24;
+}
+function parseMultiRepos(args) {
+    return args
+        .flatMap((arg) => arg.split(','))
+        .map((repo) => repo.trim())
+        .filter((repo) => repo.length > 0);
+}
 function buildRepoContextHint(repoContext, failures) {
     if (!repoContext)
         return null;
@@ -72,6 +125,10 @@ export function parseArgs(argv) {
         process.stdout.write(`ci-triage v${pkgVersion}\n`);
         process.exit(0);
     }
+    // subcommand/flag: ci-triage mcp OR ci-triage --mcp
+    if (args[0] === 'mcp' || args.includes('--mcp')) {
+        return { repo: '', limit: 0, outputJson: false, mcp: true, subcommand: 'mcp' };
+    }
     // subcommand: ci-triage flakes owner/repo
     if (args[0] === 'flakes') {
         const repo = args[1];
@@ -81,15 +138,32 @@ export function parseArgs(argv) {
         }
         return { repo, limit: 0, outputJson: false, subcommand: 'flakes' };
     }
-    // subcommand: ci-triage multi owner/repo1 owner/repo2 [--json]
-    if (args[0] === 'multi') {
-        const repos = args.slice(1).filter((arg) => !arg.startsWith('--'));
+    // subcommand/flag: ci-triage multi owner/repo1,owner/repo2 [--json] [--since 24h]
+    // or: ci-triage --multi owner/repo1,owner/repo2 [--json] [--since 24h]
+    if (args[0] === 'multi' || args.includes('--multi')) {
+        const sinceIdx = args.indexOf('--since');
+        const sinceRaw = sinceIdx >= 0 ? args[sinceIdx + 1] : undefined;
+        const sinceHours = parseSinceHours(sinceRaw);
+        if (sinceIdx >= 0 && sinceHours === undefined) {
+            console.error('Usage: --since <duration>, e.g. 24h, 7d, 30m');
+            process.exit(1);
+        }
+        const multiArgs = args[0] === 'multi' ? args.slice(1) : args;
+        const repos = parseMultiRepos(positionalArgsExcludingOptionValues(multiArgs));
         if (repos.length === 0 ||
             repos.some((repo) => !/^[A-Za-z0-9_./%-]+\/[A-Za-z0-9_./%-]+$/.test(repo))) {
-            console.error('Usage: ci-triage multi owner/repo1 owner/repo2 owner/repo3 [--json]');
+            console.error('Usage: ci-triage multi owner/repo1,owner/repo2 [--json] [--since 24h]');
             process.exit(1);
         }
-        return { repo: repos[0], repos, limit: 0, outputJson: args.includes('--json'), subcommand: 'multi' };
+        return {
+            repo: repos[0],
+            repos,
+            multi: true,
+            sinceHours,
+            limit: 0,
+            outputJson: args.includes('--json'),
+            subcommand: 'multi',
+        };
     }
     // subcommand: ci-triage db prune [--days 90]
     if (args[0] === 'db' && args[1] === 'prune') {
@@ -156,7 +230,7 @@ export function parseArgs(argv) {
     if (!repo || !/^[A-Za-z0-9_./%-]+\/[A-Za-z0-9_./%-]+$/.test(repo)) {
         usage();
     }
-    const positionalArgs = args.slice(1).filter((arg) => !arg.startsWith('--'));
+    const positionalArgs = positionalArgsExcludingOptionValues(args.slice(1));
     const parsedLimit = positionalArgs[0] ? Number(positionalArgs[0]) : 10;
     const limit = Math.min(Math.max(Number.isFinite(parsedLimit) ? parsedLimit : 10, 1), 100);
     const runIdx = args.indexOf('--run');
@@ -176,6 +250,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 +375,15 @@ export async function triageRepo(options) {
             event: metadata.event,
         },
     });
-    const llmEnabled = options.llm || !!process.env['OPENAI_API_KEY'];
+    if (run.createdAt && Number.isFinite(Date.parse(run.createdAt))) {
+        report.timestamp = run.createdAt;
+    }
+    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 +425,7 @@ async function runMultiCommand(options) {
                 repo,
                 provider: options.provider,
                 llm: options.llm,
+                noLlm: options.noLlm,
                 llmModel: options.llmModel,
             });
             reports.push(report);
@@ -350,15 +435,21 @@ async function runMultiCommand(options) {
             console.error(`Failed to triage ${repo}: ${message}`);
         }
     }
-    const patterns = detectSharedPatterns(reports);
+    const filteredReports = filterReportsSince(reports, options.sinceHours);
+    const patterns = detectSharedPatterns(filteredReports);
     if (options.outputJson) {
-        process.stdout.write(buildMultiJson(reports, patterns));
+        process.stdout.write(buildMultiJson(filteredReports, patterns));
         return;
     }
-    process.stdout.write(formatMultiSummary(reports, patterns));
+    process.stdout.write(formatMultiSummary(filteredReports, patterns));
 }
 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 +533,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/multi.js

@@ -10,6 +10,47 @@ function reportFailures(report) {
 function normalizeError(error) {
     return error.replace(/\s+/g, ' ').trim();
 }
+function toEpochMs(value) {
+    if (!value)
+        return 0;
+    const ts = Date.parse(value);
+    return Number.isFinite(ts) ? ts : 0;
+}
+export function filterReportsSince(reports, sinceHours, nowMs = Date.now()) {
+    if (sinceHours === undefined)
+        return reports;
+    const cutoffMs = nowMs - sinceHours * 60 * 60 * 1000;
+    return reports.filter((report) => toEpochMs(report.timestamp) >= cutoffMs);
+}
+export function rankReportsBySeverity(reports) {
+    const weights = {
+        critical: 4,
+        high: 3,
+        medium: 2,
+        low: 1,
+    };
+    return reports
+        .map((report) => {
+        const failures = reportFailures(report);
+        const severity_counts = { critical: 0, high: 0, medium: 0, low: 0 };
+        let severity_score = 0;
+        for (const failure of failures) {
+            const sev = failure.severity;
+            if (sev in weights) {
+                severity_counts[sev] += 1;
+                severity_score += weights[sev];
+            }
+        }
+        return {
+            repo: report.repo,
+            severity_score,
+            total_failures: failures.length,
+            severity_counts,
+            root_cause: report.summary.root_cause,
+        };
+    })
+        .sort((a, b) => b.severity_score - a.severity_score || b.total_failures - a.total_failures || a.repo.localeCompare(b.repo));
+}
 export function detectSharedPatterns(reports) {
     const byFixAction = new Map();
     const byCategory = new Map();
@@ -74,12 +115,18 @@ export function detectSharedPatterns(reports) {
     return patterns;
 }
 export function formatMultiSummary(reports, patterns) {
+    const ranked = rankReportsBySeverity(reports);
     const lines = [`Multi-repo triage: ${reports.length} repos`, ''];
+    lines.push('Ranked by failure severity:');
+    for (const rank of ranked) {
+        lines.push(`  ${rank.repo} - score ${rank.severity_score} (${rank.total_failures} failures, root cause: ${rank.root_cause})`);
+    }
+    lines.push('');
     if (patterns.length === 0) {
-        lines.push('Shared patterns detected: none', '');
+        lines.push('Shared root causes detected: none', '');
     }
     else {
-        lines.push('Shared patterns detected:');
+        lines.push('Shared root causes detected:');
         for (const pattern of patterns) {
             const repos = pattern.repos.map((repo) => repo.split('/').at(-1) ?? repo).join(', ');
             if (pattern.fix_action) {
@@ -95,22 +142,14 @@ export function formatMultiSummary(reports, patterns) {
         }
         lines.push('');
     }
-    lines.push('Per-repo:');
-    for (const report of reports) {
-        const failures = reportFailures(report);
-        const actionCounts = new Map();
-        for (const failure of failures) {
-            const action = failure.fix_action ?? 'unknown';
-            actionCounts.set(action, (actionCounts.get(action) ?? 0) + 1);
-        }
-        const actionSummary = [...actionCounts.entries()]
-            .sort((a, b) => b[1] - a[1])
-            .map(([action, count]) => `${action} x${count}`)
-            .join(', ');
-        lines.push(`  ${report.repo} - ${failures.length} failures${actionSummary ? ` (${actionSummary})` : ''}`);
-    }
     return `${lines.join('\n')}\n`;
 }
 export function buildMultiJson(reports, patterns) {
-    return `${JSON.stringify({ repos: reports, patterns }, null, 2)}\n`;
+    const ranked = rankReportsBySeverity(reports);
+    return `${JSON.stringify({
+        repos: reports,
+        ranked_repos: ranked,
+        shared_root_causes: patterns,
+        patterns,
+    }, null, 2)}\n`;
 }

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/dist/providers/circleci.js

@@ -35,6 +35,7 @@ export class CircleCiProvider {
             workflowName: 'CircleCI',
             conclusion: p.state === 'created' ? null : p.state,
             url: `https://app.circleci.com/pipelines/${repo}/${p.number}`,
+            createdAt: p.created_at,
         }));
     }
     async resolveRun(repo, runId) {

package/dist/providers/github.js

@@ -49,7 +49,7 @@ export class GitHubProvider {
     async listRuns(repo, limit) {
         const runs = runJson([
             'run', 'list', '--repo', repo, '--limit', String(limit),
-            '--json', 'databaseId,displayTitle,workflowName,conclusion,url',
+            '--json', 'databaseId,displayTitle,workflowName,conclusion,url,createdAt',
         ]);
         return runs.map((r) => ({
             id: r.databaseId,
@@ -57,6 +57,7 @@ export class GitHubProvider {
             workflowName: r.workflowName,
             conclusion: r.conclusion,
             url: r.url,
+            createdAt: r.createdAt,
         }));
     }
     async resolveRun(repo, runId) {

package/dist/providers/gitlab.js

@@ -39,6 +39,7 @@ export class GitLabProvider {
             workflowName: 'GitLab CI',
             conclusion: p.status === 'success' ? 'success' : p.status === 'failed' ? 'failure' : p.status,
             url: p.web_url,
+            createdAt: p.created_at,
         }));
     }
     async resolveRun(repo, runId) {
@@ -50,6 +51,7 @@ export class GitLabProvider {
                 workflowName: 'GitLab CI',
                 conclusion: pipeline.status === 'success' ? 'success' : pipeline.status === 'failed' ? 'failure' : pipeline.status,
                 url: pipeline.web_url,
+                createdAt: pipeline.created_at,
             };
         }
         const runs = await this.listRuns(repo, 20);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ci-triage",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "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"
   },