agentic-toolkit/src/types.ts

export type Variant = "per-ticket" | "single-pr";

export type IssueKind = "AFK" | "HITL";

export type IssueStatus =
  | "Backlog"
  | "Ready"
  | "In progress"
  | "In review"
  | "Needs human"
  | "Done";

export interface ProjectIssue {
  number: number;
  nodeId: string;
  /** ProjectV2Item id (the Project's row for this issue), distinct from `nodeId` (the Issue itself). */
  itemId: string;
  title: string;
  body: string;
  kind: IssueKind;
  status: IssueStatus;
  blockedBy: number[];
  assignee?: string;
}

export interface ProjectState {
  projectId: string;
  projectNumber: number;
  ownerLogin: string;
  repo: string;
  issues: ProjectIssue[];
}

export interface Phase {
  index: number;
  issues: ProjectIssue[];
}

export type FailureKind =
  | "agent-error"
  | "tests-failed"
  | "build-failed"
  | "sandbox-timeout"
  | "unknown";

export interface FailureContext {
  variant: Variant;
  retryCount: number;
}

export type FailureAction =
  | { kind: "retry" }
  | { kind: "skip"; reason: string }
  | { kind: "halt"; reason: string };

export interface RepoContext {
  contextMdPath?: string;
  adrDirPath?: string;
}

export interface AgentResult {
  success: boolean;
  failure?: { kind: FailureKind; logs: string };
}

export interface RunnerOptions {
  projectNumber: number;
  variant: Variant;
  targetRepoPath: string;
  baseBranch?: string;
  githubToken: string;
  ownerLogin: string;
  repo: string;
}