@adriandmitroca/relay 0.0.2

package/src/worker/triage.ts

@@ -0,0 +1,122 @@
+import { runClaudeJson, type ClaudeOptions, type ClaudeStreamEvent } from "./claude.ts";
+import { logger } from "../utils/logger.ts";
+
+export interface TriageResult {
+  fixable: boolean;
+  confidence: number;
+  reason: string;
+  plan: string | null;
+  failed?: boolean;
+  failureReason?: string;
+  sessionId?: string;
+  durationMs: number;
+  inputTokens: number;
+  outputTokens: number;
+  costUsd?: number;
+}
+
+export async function triageIssue(
+  issueContext: string,
+  repoPath: string,
+  timeoutMs: number,
+  projectContext?: string,
+  model?: "sonnet" | "opus" | "haiku",
+  onEvent?: (event: ClaudeStreamEvent) => void,
+  logPath?: string,
+): Promise<TriageResult> {
+  const contextSection = projectContext ? `\nProject conventions and context:\n${projectContext}\n` : "";
+
+  const prompt = `You are triaging a task to decide if it can be automatically implemented by an AI coding agent.
+
+Tasks can be anything: bug fixes, new features, refactors, improvements, chores, etc. Your job is to assess whether this task is well-defined enough and scoped appropriately for an AI agent to implement autonomously.
+${contextSection}
+Analyze this task in the context of the codebase:
+
+${issueContext}
+
+Steps:
+1. Understand what the task is asking for (bug fix, feature, refactor, etc.)
+2. For bugs: use the stacktrace (if available) to find the exact file(s) and line(s) where the error originates
+3. For features/improvements: identify the relevant files and understand the existing patterns
+4. Read the relevant code to understand what needs to change
+5. Check if tests exist for the affected area
+6. Decide if this is implementable and plan the implementation
+
+Respond with ONLY a JSON object:
+{
+  "fixable": true/false,
+  "confidence": 0.0-1.0,
+  "reason": "Brief explanation of what needs to be done and why this is/isn't implementable",
+  "plan": "If fixable: numbered steps, each specifying the exact file path, function/line, and what change to make. Include test file if one needs to be added or updated. Be concrete — e.g. 'In src/auth/login.ts line 42, add null check before accessing user.profile'. Otherwise null."
+}
+
+IS implementable (common patterns):
+- Bug fixes: null checks, error handling, type errors, off-by-one, wrong comparisons
+- Runtime errors from Sentry — if the stacktrace points to code in this repo, it's likely fixable
+- New features with clear requirements that follow existing patterns in the codebase
+- Refactors with well-defined scope (rename, extract, move, simplify)
+- Adding/updating tests for existing functionality
+- UI changes with clear descriptions (add button, change layout, update text)
+- Adding validation, logging, or error handling
+- Performance improvements with obvious targets
+
+NOT implementable:
+- The stacktrace points entirely to third-party code with no app code involved
+- Requires infrastructure, deployment, or config changes outside the repo
+- Needs product/design decisions or clarification from humans — the task description is too vague
+- Would be a large architectural refactor touching many unrelated systems
+- Requires access to external services, APIs, or credentials not in the repo
+
+Important: An error that "shouldn't land on Sentry" IS fixable — the fix is to add proper error handling so it doesn't propagate. Missing error handling is a code bug.`;
+
+  const opts: ClaudeOptions = {
+    cwd: repoPath,
+    timeoutMs,
+    allowedTools: ["Read", "Grep", "Glob"],
+    model,
+    onEvent,
+    logPath,
+  };
+
+  const result = await runClaudeJson<TriageResult>(prompt, opts);
+
+  if (!result.success || !result.data) {
+    logger.warn("Triage failed", { error: result.error });
+    const failureReason = result.error?.includes("Timed out") ? "triage:timeout" : "triage:claude_failed";
+    return {
+      fixable: false,
+      confidence: 0,
+      reason: `Triage failed: ${result.error ?? "unknown error"}`,
+      plan: null,
+      failed: true,
+      failureReason,
+      durationMs: result.durationMs,
+      inputTokens: result.inputTokens,
+      outputTokens: result.outputTokens,
+      costUsd: result.costUsd,
+    };
+  }
+
+  const data = result.data;
+  logger.info("Triage complete", {
+    fixable: data.fixable,
+    confidence: data.confidence,
+    reason: data.reason,
+    sessionId: result.sessionId,
+    durationMs: result.durationMs,
+    inputTokens: result.inputTokens,
+    outputTokens: result.outputTokens,
+  });
+
+  return {
+    fixable: !!data.fixable,
+    confidence: typeof data.confidence === "number" ? data.confidence : 0,
+    reason: data.reason ?? "No reason given",
+    plan: data.plan ?? null,
+    sessionId: result.sessionId,
+    durationMs: result.durationMs,
+    inputTokens: result.inputTokens,
+    outputTokens: result.outputTokens,
+    costUsd: result.costUsd,
+  };
+}