import type { ToolState } from "../toolState.ts";
import { getApiUrl } from "./apiUrl.ts";
import { buildPullfrogFooter } from "./buildPullfrogFooter.ts";
import { log } from "./cli.ts";
import { createOctokit, parseRepoContext } from "./github.ts";
import { updateProgressComment } from "./progressComment.ts";
import { getGitHubInstallationToken } from "./token.ts";

interface ReportErrorParams {
  toolState: ToolState;
  error: string;
  title?: string;
  /**
   * When the run has no pre-existing progress comment to update (silent
   * IncrementalReview / pull_request_synchronize, mode-less polls), create
   * a fresh issue comment on `toolState.issueNumber` instead of returning
   * silently. Used for terminal errors (BillingError, TransientError) where
   * the GH job summary is the only other surface and most users never open
   * it. see #775.
   */
  createIfMissing?: boolean;
}

export async function reportErrorToComment(ctx: ReportErrorParams): Promise<void> {
  const formattedError = ctx.title ? `${ctx.title}\n\n${ctx.error}` : ctx.error;

  const repoContext = parseRepoContext();
  const octokit = createOctokit(getGitHubInstallationToken());
  const runId = process.env.GITHUB_RUN_ID
    ? Number.parseInt(process.env.GITHUB_RUN_ID, 10)
    : undefined;

  const customParts: string[] = [];
  if (runId) {
    const apiUrl = getApiUrl();
    customParts.push(
      `[Rerun failed job ➔](${apiUrl}/trigger/${repoContext.owner}/${repoContext.name}/${runId}?action=rerun)`
    );
  }

  const footer = buildPullfrogFooter({
    triggeredBy: true,
    workflowRun: runId ? { owner: repoContext.owner, repo: repoContext.name, runId } : undefined,
    customParts,
    model: ctx.toolState.model,
    fallbackFrom: ctx.toolState.modelFallback?.from,
  });

  const body = `${formattedError}${footer}`;

  const comment = ctx.toolState.progressComment;
  if (comment) {
    await updateProgressComment(
      { octokit, owner: repoContext.owner, repo: repoContext.name },
      comment,
      body
    );
    ctx.toolState.wasUpdated = true;
    return;
  }

  // silent triggers (pull_request_synchronize IncrementalReview, etc.)
  // intentionally have no progress comment. for terminal errors that need
  // user action — billing exhaustion, transient billing-service outage —
  // surface a fresh issue comment instead of leaving the GH job summary as
  // the only signal. see #775.
  if (!ctx.createIfMissing) return;
  if (!ctx.toolState.issueNumber) return;

  try {
    const created = await octokit.rest.issues.createComment({
      owner: repoContext.owner,
      repo: repoContext.name,
      issue_number: ctx.toolState.issueNumber,
      body,
    });
    ctx.toolState.progressComment = { id: created.data.id, type: "issue" };
    ctx.toolState.wasUpdated = true;
  } catch (error) {
    log.warning(
      `[errorReport] fallback comment create failed: ${error instanceof Error ? error.message : String(error)}`
    );
  }
}