fix: auto-fix ESLint errors across 87 files

app/api/accounts/[id]/route.ts

@@ -23,6 +23,7 @@
  * - id (required): The unique identifier of the account (UUID)
  *
  * @param request - The request object
+ * @param params.params
  * @param params - Route params containing the account ID
  * @returns A NextResponse with account data
  */

app/api/admins/coding/slack/route.ts

@@ -2,19 +2,21 @@
 import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getSlackTagsHandler } from "@/lib/admins/slack/getSlackTagsHandler";
 
 /**
  * GET /api/admins/coding/slack
  *
  * Returns Slack tagging analytics for the Recoup Coding Agent bot.
  * Pulls directly from the Slack API as the source of truth.
  * Supports period filtering: all (default), daily, weekly, monthly.
  * Requires admin authentication.
+ *
+ * @param request
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getSlackTagsHandler(request);
 }
 
 /** CORS preflight handler. */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/admins/privy/route.ts

@@ -8,11 +8,16 @@ import { getPrivyLoginsHandler } from "@/lib/admins/privy/getPrivyLoginsHandler"
  * Returns Privy login statistics for the requested time period.
  * Supports daily (last 24h), weekly (last 7 days), and monthly (last 30 days) periods.
  * Requires admin authentication.
+ *
+ * @param request
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getPrivyLoginsHandler(request);
 }
 
+/**
+ *
+ */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/songs/analyze/presets/route.ts

@@ -28,6 +28,7 @@ export async function OPTIONS() {
  * - status: "success"
  * - presets: Array of { name, label, description, requiresAudio, responseFormat }
  *
+ * @param request
  * @returns A NextResponse with the list of available presets
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {

app/api/transcribe/route.ts

@@ -2,6 +2,10 @@ import { NextRequest, NextResponse } from "next/server";
 import { processAudioTranscription } from "@/lib/transcribe/processAudioTranscription";
 import { formatTranscriptionError } from "@/lib/transcribe/types";
 
+/**
+ *
+ * @param req
+ */
 export async function POST(req: NextRequest) {
   try {
     const body = await req.json();

lib/admins/emails/__tests__/validateGetAdminEmailsQuery.test.ts

@@ -12,6 +12,10 @@ vi.mock("@/lib/admins/validateAdminAuth", () => ({
   validateAdminAuth: vi.fn(),
 }));
 
+/**
+ *
+ * @param url
+ */
 function createMockRequest(url: string): NextRequest {
   return {
     url,

lib/admins/pr/__tests__/getPrMergedStatusHandler.test.ts

@@ -19,6 +19,10 @@ vi.mock("@/lib/github/fetchGithubPrStatus", () => ({
 const PR_URL_1 = "https://github.com/recoupable/api/pull/42";
 const PR_URL_2 = "https://github.com/recoupable/chat/pull/100";
 
+/**
+ *
+ * @param urls
+ */
 function makeRequest(urls: string[] = [PR_URL_1]) {
   const params = new URLSearchParams();
   urls.forEach(url => params.append("pull_requests", url));

lib/admins/pr/getPrStatusHandler.ts

@@ -10,6 +10,8 @@ import { fetchGithubPrStatus } from "@/lib/github/fetchGithubPrStatus";
  * Uses the GitHub REST API to check each PR's state.
  *
  * Requires admin authentication.
+ *
+ * @param request
  */
 export async function getPrStatusHandler(request: NextRequest): Promise<NextResponse> {
   try {

lib/admins/privy/countNewAccounts.ts

@@ -5,6 +5,9 @@ import { getCutoffMs } from "./getCutoffMs";
 
 /**
  * Counts how many users in the list were created within the cutoff period.
+ *
+ * @param users
+ * @param period
  */
 export function countNewAccounts(users: User[], period: PrivyLoginsPeriod): number {
   const cutoffMs = getCutoffMs(period);

lib/admins/privy/fetchPrivyLogins.ts

@@ -20,6 +20,10 @@ export type FetchPrivyLoginsResult = {
   totalPrivyUsers: number;
 };
 
+/**
+ *
+ * @param period
+ */
 export async function fetchPrivyLogins(period: PrivyLoginsPeriod): Promise<FetchPrivyLoginsResult> {
   const isAll = period === "all";
   const cutoffMs = getCutoffMs(period);

lib/admins/privy/getCutoffMs.ts

@@ -5,6 +5,8 @@ import { PERIOD_DAYS } from "./periodDays";
  * Returns the cutoff timestamp in milliseconds for a given period.
  * Uses midnight UTC calendar day boundaries to match Privy dashboard behavior.
  * Returns 0 for "all" (no cutoff).
+ *
+ * @param period
  */
 export function getCutoffMs(period: PrivyLoginsPeriod): number {
   if (period === "all") return 0;

lib/admins/privy/getLatestVerifiedAt.ts

@@ -4,6 +4,8 @@ import type { User } from "@privy-io/node";
 /**
  * Returns the most recent latest_verified_at (in ms) across all linked_accounts for a Privy user.
  * Returns null if no linked account has a latest_verified_at.
+ *
+ * @param user
  */
 export function getLatestVerifiedAt(user: User): number | null {
   const linkedAccounts = user.linked_accounts;

lib/admins/privy/toMs.ts

@@ -1,6 +1,8 @@
 /**
  * Normalizes a Privy timestamp to milliseconds.
  * Privy docs say milliseconds but examples show seconds (10 digits).
+ *
+ * @param timestamp
  */
 export function toMs(timestamp: number): number {
   return timestamp > 1e12 ? timestamp : timestamp * 1000;

lib/ai/getModel.ts

@@ -3,6 +3,7 @@ import { GatewayLanguageModelEntry } from "@ai-sdk/gateway";
 
 /**
  * Returns a specific model by its ID from the list of available models.
+ *
  * @param modelId - The ID of the model to find
  * @returns The matching model or undefined if not found
  */

lib/ai/isEmbedModel.ts

@@ -3,6 +3,8 @@ import { GatewayLanguageModelEntry } from "@ai-sdk/gateway";
 /**
  * Determines if a model is an embedding model (not suitable for chat).
  * Embed models typically have 0 output pricing since they only produce embeddings.
+ *
+ * @param m
  */
 export const isEmbedModel = (m: GatewayLanguageModelEntry): boolean => {
   const pricing = m.pricing;

lib/artists/__tests__/createArtistPostHandler.test.ts

@@ -14,6 +14,11 @@ vi.mock("@/lib/auth/validateAuthContext", () => ({
   validateAuthContext: (...args: unknown[]) => mockValidateAuthContext(...args),
 }));
 
+/**
+ *
+ * @param body
+ * @param headers
+ */
 function createRequest(body: unknown, headers: Record<string, string> = {}): NextRequest {
   const defaultHeaders: Record<string, string> = {
     "Content-Type": "application/json",

lib/artists/__tests__/validateCreateArtistBody.test.ts

@@ -9,6 +9,11 @@ vi.mock("@/lib/auth/validateAuthContext", () => ({
   validateAuthContext: (...args: unknown[]) => mockValidateAuthContext(...args),
 }));
 
+/**
+ *
+ * @param body
+ * @param headers
+ */
 function createRequest(body: unknown, headers: Record<string, string> = {}): NextRequest {
   const defaultHeaders: Record<string, string> = { "Content-Type": "application/json" };
   return new NextRequest("http://localhost/api/artists", {

lib/auth/__tests__/validateAuthContext.test.ts

@@ -33,6 +33,10 @@ const mockGetAuthenticatedAccountId = vi.mocked(getAuthenticatedAccountId);
 const mockValidateOrganizationAccess = vi.mocked(validateOrganizationAccess);
 const mockCanAccessAccount = vi.mocked(canAccessAccount);
 
+/**
+ *
+ * @param headers
+ */
 function createMockRequest(headers: Record<string, string> = {}): Request {
   return {
     headers: {

lib/catalog/formatCatalogSongsAsCSV.ts

@@ -2,6 +2,8 @@ import { CatalogSong } from "./getCatalogSongs";
 
 /**
  * Formats catalog songs into the CSV-like format expected by the scorer
+ *
+ * @param songs
  */
 export function formatCatalogSongsAsCSV(songs: CatalogSong[]): string {
   const csvLines = songs.map(song => {

lib/catalog/getCatalogDataAsCSV.ts

@@ -3,6 +3,8 @@ import { formatCatalogSongsAsCSV } from "./formatCatalogSongsAsCSV";
 
 /**
  * Gets all catalog songs and formats them as CSV for the scorer
+ *
+ * @param catalogId
  */
 export async function getCatalogDataAsCSV(catalogId: string): Promise<string> {
   const allSongs: CatalogSong[] = [];

lib/catalog/getCatalogSongs.ts

@@ -25,6 +25,13 @@ export interface CatalogSongsResponse {
   error?: string;
 }
 
+/**
+ *
+ * @param catalogId
+ * @param pageSize
+ * @param page
+ * @param artistName
+ */
 export async function getCatalogSongs(
   catalogId: string,
   pageSize: number = 100,

lib/catalog/getCatalogs.ts

@@ -8,6 +8,10 @@ export interface CatalogsResponse {
   error?: string;
 }
 
+/**
+ *
+ * @param accountId
+ */
 export async function getCatalogs(accountId: string): Promise<CatalogsResponse> {
   try {
     const response = await fetch(

lib/chat/__tests__/integration/chatEndToEnd.test.ts

@@ -170,6 +170,11 @@ const mockDeductCredits = vi.mocked(deductCredits);
 const mockGenerateChatTitle = vi.mocked(generateChatTitle);
 
 // Helper to create mock NextRequest
+/**
+ *
+ * @param body
+ * @param headers
+ */
 function createMockRequest(body: unknown, headers: Record<string, string> = {}): Request {
   return {
     json: () => Promise.resolve(body),

lib/chat/toolChains/getPrepareStepResult.ts

@@ -12,6 +12,8 @@ type PrepareStepOptions = {
 /**
  * Returns the next tool to run based on timeline progression through tool chains.
  * Uses toolCallsContent to track exact execution order and position in sequence.
+ *
+ * @param options
  */
 const getPrepareStepResult = (options: PrepareStepOptions): PrepareStepResult | undefined => {
   const { steps } = options;

lib/chats/__tests__/createChatHandler.test.ts

@@ -41,6 +41,10 @@ vi.mock("../generateChatTitle", () => ({
   generateChatTitle: vi.fn(),
 }));
 
+/**
+ *
+ * @param headers
+ */
 function createMockRequest(
   headers: Record<string, string> = { "x-api-key": "test-api-key" },
 ): NextRequest {

lib/chats/processCompactChatRequest.ts

@@ -17,6 +17,9 @@ interface ProcessCompactChatRequestParams {
  * Verifies the chat exists and the user has access before compacting.
  *
  * @param params - The parameters for processing the chat compaction.
+ * @param params.chatId
+ * @param params.prompt
+ * @param params.accountId
  * @returns The result of the compaction attempt.
  */
 export async function processCompactChatRequest({

lib/coding-agent/__tests__/handleGitHubWebhook.test.ts

@@ -45,6 +45,12 @@ const BASE_PAYLOAD = {
   },
 };
 
+/**
+ *
+ * @param body
+ * @param event
+ * @param signature
+ */
 function makeRequest(body: unknown, event = "issue_comment", signature = "valid") {
   return {
     text: () => Promise.resolve(JSON.stringify(body)),

lib/coding-agent/__tests__/onMergeTestToMainAction.test.ts

@@ -12,6 +12,9 @@ beforeEach(() => {
   process.env.GITHUB_TOKEN = "ghp_test";
 });
 
+/**
+ *
+ */
 function createMockBot() {
   return { onAction: vi.fn() } as any;
 }

lib/coding-agent/encodeGitHubThreadId.ts

@@ -6,6 +6,8 @@ import type { GitHubThreadId } from "@chat-adapter/github";
  *
  * - PR-level: `github:{owner}/{repo}:{prNumber}`
  * - Review comment: `github:{owner}/{repo}:{prNumber}:rc:{reviewCommentId}`
+ *
+ * @param thread
  */
 export function encodeGitHubThreadId(thread: GitHubThreadId): string {
   const { owner, repo, prNumber, reviewCommentId } = thread;

lib/coding-agent/handleMergeSuccess.ts

@@ -7,6 +7,8 @@ import type { CodingAgentThreadState } from "./types";
  * Handles post-merge cleanup after all PRs merged successfully.
  * Deletes the shared PR state keys for all repos and persists the latest
  * snapshot via upsertAccountSnapshot.
+ *
+ * @param state
  */
 export async function handleMergeSuccess(state: CodingAgentThreadState): Promise<void> {
   try {

lib/coding-agent/parseMergeActionId.ts

@@ -1,6 +1,8 @@
 /**
  * Parses a merge action ID like "merge_pr:recoupable/api#42"
  * into { repo, number } or null if the format doesn't match.
+ *
+ * @param actionId
  */
 export function parseMergeActionId(actionId: string) {
   const match = actionId.match(/^merge_pr:(.+)#(\d+)$/);

lib/coding-agent/parseMergeTestToMainActionId.ts

@@ -1,6 +1,8 @@
 /**
  * Parses a merge_test_to_main action ID like "merge_test_to_main:recoupable/api"
  * into the repo string, or null if the format doesn't match.
+ *
+ * @param actionId
  */
 export function parseMergeTestToMainActionId(actionId: string): string | null {
   const prefix = "merge_test_to_main:";

lib/composio/getCallbackUrl.ts

@@ -19,6 +19,7 @@ interface CallbackOptions {
  *
  * @param options.destination - Where to redirect: "chat" or "connectors"
  * @param options.roomId - For chat destination, the room ID to return to
+ * @param options
  * @returns Full callback URL with success indicator
  */
 export function getCallbackUrl(options: CallbackOptions): string {

lib/content/__tests__/validateCreateContentBody.test.ts

@@ -20,6 +20,10 @@ vi.mock("@/lib/content/resolveArtistSlug", () => ({
   resolveArtistSlug: vi.fn().mockResolvedValue("gatsby-grace"),
 }));
 
+/**
+ *
+ * @param body
+ */
 function createRequest(body: unknown): NextRequest {
   return new NextRequest("http://localhost/api/content/create", {
     method: "POST",

lib/content/contentTemplates.ts

@@ -25,6 +25,10 @@ export const CONTENT_TEMPLATES: ContentTemplate[] = [
 /** Derived from the first entry in CONTENT_TEMPLATES to avoid string duplication. */
 export const DEFAULT_CONTENT_TEMPLATE = CONTENT_TEMPLATES[0].name;
 
+/**
+ *
+ * @param template
+ */
 export function isSupportedContentTemplate(template: string): boolean {
   return CONTENT_TEMPLATES.some(item => item.name === template);
 }

lib/content/createContentHandler.ts

@@ -9,6 +9,8 @@ import { selectAccountSnapshots } from "@/lib/supabase/account_snapshots/selectA
 /**
  * Handler for POST /api/content/create.
  * Always returns runIds array (KISS — one response shape for single and batch).
+ *
+ * @param request
  */
 export async function createContentHandler(request: NextRequest): Promise<NextResponse> {
   const validated = await validateCreateContentBody(request);

lib/content/getArtistContentReadiness.ts

@@ -22,6 +22,11 @@ export interface ArtistContentReadiness {
 /**
  * Checks whether an artist has the expected files for content creation.
  * Searches the main repo and org submodule repos.
+ *
+ * @param root0
+ * @param root0.accountId
+ * @param root0.artistAccountId
+ * @param root0.artistSlug
  */
 export async function getArtistContentReadiness({
   accountId,

lib/content/getArtistFileTree.ts

@@ -4,6 +4,9 @@ import { getOrgRepoUrls } from "@/lib/github/getOrgRepoUrls";
 /**
  * Gets the file tree that contains the artist, checking the main repo
  * first, then falling back to org submodule repos.
+ *
+ * @param githubRepo
+ * @param artistSlug
  */
 export async function getArtistFileTree(
   githubRepo: string,

lib/content/getArtistRootPrefix.ts

@@ -1,3 +1,8 @@
+/**
+ *
+ * @param paths
+ * @param artistSlug
+ */
 export function getArtistRootPrefix(paths: string[], artistSlug: string): string {
   const preferredPrefix = `artists/${artistSlug}/`;
   if (paths.some(path => path.startsWith(preferredPrefix))) {