ci-triage 0.3.1 → 0.3.2

package/dist/index.js

@@ -9,7 +9,7 @@ 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);
@@ -27,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]',
@@ -39,6 +41,8 @@ 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 (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)',
@@ -59,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;
@@ -75,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];
@@ -84,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') {
@@ -159,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');
@@ -304,6 +375,9 @@ export async function triageRepo(options) {
             event: metadata.event,
         },
     });
+    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) {
@@ -361,12 +435,13 @@ 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);

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/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.1",
+  "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": {