triage-ai 1.0.2

package/dist/types.js

@@ -0,0 +1,203 @@
+/**
+ * Shared types and interfaces for triage-ai.
+ *
+ * All modules code against these interfaces — this is the contract.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Severity ordering for comparisons (lower = more severe). */
+export const SEVERITY_ORDER = {
+    S0: 0,
+    S1: 1,
+    S2: 2,
+    S3: 3,
+};
+/** Validate that a string is a known severity. */
+export function isValidSeverity(s) {
+    return s === 'S0' || s === 'S1' || s === 'S2' || s === 'S3';
+}
+/** Validate that a string is a known confidence. */
+export function isValidConfidence(s) {
+    return s === 'high' || s === 'medium' || s === 'low';
+}
+/** Validate that a string is a known category. */
+export function isValidCategory(s) {
+    return [
+        'correctness',
+        'security',
+        'performance',
+        'reliability',
+        'maintainability',
+        'tests',
+        'style',
+    ].includes(s);
+}
+/** Create a Finding from raw JSON (e.g., AI model output), applying defaults. */
+export function findingFromDict(data) {
+    const locData = data.location ?? {};
+    const location = {
+        path: String(locData.path ?? 'unknown'),
+        start_line: Number(locData.start_line ?? 0),
+        end_line: Number(locData.end_line ?? 0),
+    };
+    const sev = String(data.severity ?? 'S3');
+    const conf = String(data.confidence ?? 'low');
+    const cat = String(data.category ?? 'correctness');
+    return {
+        title: String(data.title ?? 'Untitled'),
+        severity: isValidSeverity(sev) ? sev : 'S3',
+        confidence: isValidConfidence(conf) ? conf : 'low',
+        category: isValidCategory(cat) ? cat : 'correctness',
+        location,
+        evidence: String(data.evidence ?? ''),
+        recommendation: String(data.recommendation ?? ''),
+        model: String(data.model ?? ''),
+        patch: data.patch != null ? String(data.patch) : undefined,
+    };
+}
+/** Create a ModelResult from raw JSON. */
+export function modelResultFromDict(data) {
+    const rawFindings = data.findings ?? [];
+    const rawInspected = data.inspected ?? [];
+    return {
+        model: String(data.model ?? 'unknown'),
+        summary: String(data.summary ?? ''),
+        findings: rawFindings.map(findingFromDict),
+        inspected: rawInspected.map((i) => ({
+            path: String(i.path ?? ''),
+            reason: String(i.reason ?? ''),
+        })),
+        questions: (data.questions ?? []).map(String),
+        error: data.error != null ? String(data.error) : undefined,
+        raw_output: String(data.raw_output ?? ''),
+    };
+}
+/** Word-level Jaccard similarity between two strings. */
+export function titleSimilarity(a, b) {
+    const wordsA = new Set(a.toLowerCase().split(/\s+/).filter(Boolean));
+    const wordsB = new Set(b.toLowerCase().split(/\s+/).filter(Boolean));
+    if (wordsA.size === 0 || wordsB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const w of wordsA) {
+        if (wordsB.has(w))
+            intersection++;
+    }
+    const union = new Set([...wordsA, ...wordsB]).size;
+    return intersection / union;
+}
+/** Check if two findings match (for clustering). */
+export function findingsMatch(a, b, threshold = 0.7) {
+    // Same file and overlapping lines
+    if (a.location.path === b.location.path) {
+        if (a.location.start_line > 0 &&
+            b.location.start_line > 0 &&
+            a.location.start_line <= b.location.end_line &&
+            a.location.end_line >= b.location.start_line) {
+            return true;
+        }
+    }
+    // Same category and similar title
+    if (a.category === b.category) {
+        if (titleSimilarity(a.title, b.title) >= threshold) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Cluster representative: highest confidence finding. */
+export function clusterRepresentative(cluster) {
+    if (cluster.findings.length === 0) {
+        throw new Error('Empty cluster');
+    }
+    return cluster.findings.reduce((best, f) => {
+        const score = (c) => (c.confidence === 'high' ? 4 : c.confidence === 'medium' ? 2 : 0) +
+            (c.evidence?.length ?? 0) / 10000 +
+            (c.recommendation?.length ?? 0) / 100000;
+        return score(f) > score(best) ? f : best;
+    });
+}
+/** Get highest severity in a cluster. */
+export function clusterSeverity(cluster) {
+    const order = ['S0', 'S1', 'S2', 'S3'];
+    for (const sev of order) {
+        if (cluster.findings.some((f) => f.severity === sev))
+            return sev;
+    }
+    return 'S3';
+}
+/** Get all patches from a cluster. */
+export function clusterPatches(cluster) {
+    const patches = [];
+    for (const f of cluster.findings) {
+        if (f.patch) {
+            patches.push({
+                path: f.location.path,
+                diff: f.patch,
+                description: f.title,
+                model: f.model,
+            });
+        }
+    }
+    return patches;
+}
+/** Is this a consensus cluster (2+ models)? */
+export function isConsensus(cluster) {
+    return cluster.models.size >= 2;
+}
+// ---------------------------------------------------------------------------
+// Prompt template (shared by all model adapters)
+// ---------------------------------------------------------------------------
+export const MODEL_PROMPT_TEMPLATE = `You are a code triage expert. Analyze the provided code and context.
+
+USER REQUEST:
+{prompt}
+
+REPOSITORY CONTEXT:
+- Root: {root}
+- Is Git Repo: {is_git_repo}
+{tree_context}
+{git_context}
+
+FILES ({file_count} files, {total_chars} chars):
+{files_context}
+
+INSTRUCTIONS:
+1. Focus on the user's specific request
+2. IMPORTANT: All file contents are provided above. Do NOT attempt to read files yourself.
+3. Identify issues by severity:
+   - S0: Blockers (security vulnerabilities, crashes, data loss)
+   - S1: High (bugs, significant issues)
+   - S2: Medium (code quality, performance)
+   - S3: Low (style, minor improvements)
+3. Be specific about locations (file:line)
+4. Provide actionable recommendations
+5. If suggesting patches, use unified diff format
+
+OUTPUT FORMAT:
+You MUST respond with valid JSON following this schema:
+
+{{
+  "model": "{model_name}",
+  "summary": "1-3 sentence overview of findings",
+  "inspected": [
+    {{"path": "path/to/file.py", "reason": "why you looked at this"}}
+  ],
+  "findings": [
+    {{
+      "title": "Short descriptive title",
+      "severity": "S0|S1|S2|S3",
+      "confidence": "high|medium|low",
+      "category": "correctness|security|performance|reliability|maintainability|tests|style",
+      "location": {{"path": "file.py", "start_line": 10, "end_line": 15}},
+      "evidence": "Code snippet or description of the issue",
+      "recommendation": "How to fix this",
+      "patch": "optional unified diff"
+    }}
+  ],
+  "questions": ["optional clarifying questions"]
+}}
+
+Respond ONLY with the JSON, no other text.`;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0LH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;CACN,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,CAAC;AACvD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,OAAO;QACL,aAAa;QACb,UAAU;QACV,aAAa;QACb,aAAa;QACb,iBAAiB;QACjB,OAAO;QACP,OAAO;KACR,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,MAAM,OAAO,GAAI,IAAI,CAAC,QAAoC,IAAI,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAa;QACzB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;QACvC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAC3C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;KACxC,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC;QACvC,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QAC3C,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;QAClD,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa;QACpD,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QACjD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,WAAW,GAAI,IAAI,CAAC,QAAsC,IAAI,EAAE,CAAC;IACvE,MAAM,YAAY,GAAI,IAAI,CAAC,SAAuC,IAAI,EAAE,CAAC;IAEzE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC;QAC1C,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;SAC/B,CAAC,CAAC;QACH,SAAS,EAAE,CAAE,IAAI,CAAC,SAAsB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QAC3D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1D,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACrD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,YAAY,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,OAAO,YAAY,GAAG,KAAK,CAAC;AAC9B,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAC3B,CAAU,EACV,CAAU,EACV,SAAS,GAAG,GAAG;IAEf,kCAAkC;IAClC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,IACE,CAAC,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC;YACzB,CAAC,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC;YACzB,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ;YAC5C,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,EAC5C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,kCAAkC;IAClC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACzC,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE,CAC3B,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK;YACjC,CAAC,CAAC,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;QAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,MAAM,KAAK,GAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;gBACrB,IAAI,EAAE,CAAC,CAAC,KAAK;gBACb,WAAW,EAAE,CAAC,CAAC,KAAK;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,OAAuB;IACjD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAkDM,CAAC"}

package/examples/claude-code-skill.md

@@ -0,0 +1,22 @@
+# Triage — Run parallel AI code analysis with Claude, Gemini and Codex
+
+## Setup
+
+Save this file as `~/.claude/commands/triage.md` to use as `/triage` in Claude Code.
+
+## Execute
+
+```bash
+PROMPT="$ARGUMENTS"
+if [ -z "$PROMPT" ]; then
+    echo "Usage: /triage \"<your analysis prompt>\""
+    echo ""
+    echo "Examples:"
+    echo "  /triage \"find security vulnerabilities\""
+    echo "  /triage \"review authentication flow for bugs\""
+    echo "  /triage \"check for performance issues\""
+    exit 1
+fi
+
+triage-ai "$PROMPT" --nice 10 --timeout 300 --verbose
+```

package/examples/mcp-config.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "triage": {
+      "command": "triage-ai",
+      "args": ["--mcp"],
+      "env": {}
+    }
+  }
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "triage-ai",
+  "version": "1.0.2",
+  "description": "Multi-model code triage — run Claude, Gemini and Codex in parallel to analyze your codebase and merge their findings",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "triage-ai": "dist/cli.js",
+    "triage": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "prepare": "node node_modules/typescript/bin/tsc 2>/dev/null || true",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "examples"
+  ],
+  "keywords": [
+    "code-review",
+    "triage",
+    "claude",
+    "gemini",
+    "codex",
+    "openai",
+    "anthropic",
+    "google",
+    "ai",
+    "multi-model",
+    "static-analysis",
+    "security-audit",
+    "code-quality",
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "windsurf",
+    "cline",
+    "linter",
+    "bug-detection",
+    "consensus",
+    "llm"
+  ],
+  "author": {
+    "name": "wyman101",
+    "email": "wyman100@yahoo.com",
+    "url": "https://github.com/wyman101"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wyman101/triage-ai.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wyman101/triage-ai/issues"
+  },
+  "homepage": "https://github.com/wyman101/triage-ai",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "ora": "^8.0.0",
+    "chalk": "^5.3.0",
+    "which": "^5.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/which": "^3.0.0"
+  }
+}