Issues API

// GET /trpc/issues.list
{
  repoId: string;
  state?: 'open' | 'closed';
  status?: string;           // e.g., 'triage', 'backlog', 'in_progress'
  priority?: string;         // 'urgent' | 'high' | 'medium' | 'low' | 'none'
  assignee?: string;         // User ID
  project?: string;          // Project name
  cycle?: number;            // Cycle number
  overdue?: boolean;
  dueSoon?: boolean;
  limit?: number;
  offset?: number;
}

Array<{
  id: string;
  number: number;
  title: string;
  body?: string;
  state: 'open' | 'closed';
  status?: string;
  priority?: string;
  dueDate?: string;
  estimate?: number;
  parentNumber?: number;
  projectId?: string;
  cycleId?: string;
  authorId: string;
  author: User | null;
  assigneeId?: string;
  labels: Label[];
  subIssueCount?: number;
  subIssueProgress?: number;
  createdAt: string;
  updatedAt: string;
  closedAt?: string;
}>

// GET /trpc/issues.get
{
  repoId: string;
  number: number;
}

{
  ...issue,
  relations?: {
    blocking: number[];
    blockedBy: number[];
    related: number[];
    duplicates: number[];
    duplicatedBy: number[];
  };
}

// POST /trpc/issues.create
{
  repoId: string;
  title: string;
  body?: string;
  labels?: string[];
  priority?: 'urgent' | 'high' | 'medium' | 'low' | 'none';
  dueDate?: string;          // ISO date string
  estimate?: number;         // Story points
  parentNumber?: number;     // Create as sub-issue
  project?: string;          // Project name
  cycle?: number;            // Cycle number
  assigneeId?: string;
  templateId?: string;       // Use issue template
}

// POST /trpc/issues.update
{
  issueId: string;
  title?: string;
  body?: string;
  status?: string;
  priority?: string;
  dueDate?: string;
  estimate?: number;
  assigneeId?: string;
}

// POST /trpc/issues.close
{ repoId: string; number: number }

// POST /trpc/issues.reopen
{ repoId: string; number: number }

// POST /trpc/issues.updatePriority
{
  repoId: string;
  number: number;
  priority: 'urgent' | 'high' | 'medium' | 'low' | 'none';
}

// POST /trpc/issues.setDueDate
{
  repoId: string;
  number: number;
  dueDate: string;           // ISO date string
}

// POST /trpc/issues.clearDueDate
{
  repoId: string;
  number: number;
}

// POST /trpc/issues.setEstimate
{
  repoId: string;
  number: number;
  estimate: number;          // Story points
}

// POST /trpc/issues.clearEstimate
{
  repoId: string;
  number: number;
}

// GET /trpc/issues.listOverdue
{ repoId: string }

// GET /trpc/issues.listDueSoon
{ repoId: string; days?: number }  // Default: 7 days

// GET /trpc/issues.getTotalEstimate
{
  repoId: string;
  projectId?: string;
  cycleId?: string;
}

// POST /trpc/issues.setParent
{
  repoId: string;
  number: number;
  parentNumber: number;
}

// POST /trpc/issues.removeParent
{
  repoId: string;
  number: number;
}

// GET /trpc/issues.getSubIssues
{
  repoId: string;
  number: number;
}

// GET /trpc/issues.getSubIssueProgress
{
  repoId: string;
  number: number;
}

{
  total: number;
  completed: number;
  percentage: number;
}

// POST /trpc/issues.createSubIssue
{
  repoId: string;
  parentNumber: number;
  title: string;
  body?: string;
  priority?: string;
}

// POST /trpc/issues.addRelation
{
  repoId: string;
  sourceNumber: number;
  targetNumber: number;
  type: 'blocks' | 'relates_to' | 'duplicates';
}

// POST /trpc/issues.removeRelation
{
  repoId: string;
  sourceNumber: number;
  targetNumber: number;
  type: 'blocks' | 'relates_to' | 'duplicates';
}

// GET /trpc/issues.getRelations
{
  repoId: string;
  number: number;
}

{
  blocking: number[];
  blockedBy: number[];
  related: number[];
  duplicates: number[];
  duplicatedBy: number[];
}

// GET /trpc/issues.isBlocked
{
  repoId: string;
  number: number;
}

// POST /trpc/issues.markAsDuplicate
{
  repoId: string;
  duplicateNumber: number;
  canonicalNumber: number;
}

// POST /trpc/issues.addComment
{
  repoId: string;
  number: number;
  body: string;
}

// GET /trpc/issues.comments
{
  repoId: string;
  number: number;
}

// POST /trpc/issues.updateComment
{ commentId: string; body: string }

// POST /trpc/issues.deleteComment
{ commentId: string }

// GET /trpc/issues.listLabels
{ repoId: string }

// POST /trpc/issues.createLabel
{
  repoId: string;
  name: string;
  color: string;
  description?: string;
}

// POST /trpc/issues.updateLabel
{
  labelId: string;
  name?: string;
  color?: string;
  description?: string;
}

// POST /trpc/issues.deleteLabel
{ labelId: string }

// POST /trpc/issues.addLabel
{ repoId: string; number: number; labelId: string }

// POST /trpc/issues.removeLabel
{ repoId: string; number: number; labelId: string }

// GET /trpc/issues.listGroupedByStatus
{
  repoId: string;
  projectId?: string;
  cycleId?: string;
}

{
  [status: string]: Issue[];
}

// POST /trpc/issues.updateStatus
{
  repoId: string;
  number: number;
  status: string;
}

// GET /trpc/issues.statuses
{ repoId: string }

// GET /trpc/issues.priorities

// GET /trpc/issues.listTriage
{ repoId: string }

// POST /trpc/issues.acceptTriage
{
  repoId: string;
  number: number;
  targetStatus?: string;     // Default: 'backlog'
  priority?: string;
}

// POST /trpc/issues.rejectTriage
{
  repoId: string;
  number: number;
  reason: string;
}

// GET /trpc/issues.getActivity
{
  repoId: string;
  number: number;
  limit?: number;
}

Array<{
  id: string;
  issueNumber: number;
  action: string;
  field?: string;
  oldValue?: string;
  newValue?: string;
  actor: string;
  createdAt: string;
}>

// GET /trpc/issues.getRepoActivity
{
  repoId: string;
  limit?: number;
}

// GET /trpc/issues.listTemplates
{ repoId: string }

// GET /trpc/issues.getTemplate
{ templateId: string }

// POST /trpc/issues.createTemplate
{
  repoId: string;
  name: string;
  title?: string;
  body?: string;
  labels?: string[];
  priority?: string;
}

// POST /trpc/issues.updateTemplate
{
  templateId: string;
  name?: string;
  title?: string;
  body?: string;
  labels?: string[];
  priority?: string;
}

// POST /trpc/issues.deleteTemplate
{ templateId: string }

// GET /trpc/issues.listViews
{ repoId: string }

// GET /trpc/issues.getView
{ viewId: string }

// POST /trpc/issues.createView
{
  repoId: string;
  name: string;
  filters: {
    status?: string[];
    priority?: string[];
    assignee?: string[];
    labels?: string[];
    dueDate?: 'overdue' | 'due_soon' | 'no_date';
  };
  sort?: {
    field: string;
    direction: 'asc' | 'desc';
  };
}

// POST /trpc/issues.updateView
{
  viewId: string;
  name?: string;
  filters?: object;
  sort?: object;
}

// POST /trpc/issues.deleteView
{ viewId: string }

// GET /trpc/issues.getIssuesByView
{ viewId: string }

import { createTRPCClient } from '@trpc/client';
import type { AppRouter } from './api';

const client = createTRPCClient<AppRouter>({
  url: 'http://localhost:3000/trpc',
});

// Create an issue with Linear-style fields
const issue = await client.issues.create.mutate({
  repoId: 'repo-uuid',
  title: 'Implement user settings',
  body: 'Add user preferences page',
  priority: 'high',
  dueDate: '2024-02-01',
  estimate: 5,
});

// Create sub-issues
await client.issues.createSubIssue.mutate({
  repoId: 'repo-uuid',
  parentNumber: issue.number,
  title: 'Design settings UI',
});

await client.issues.createSubIssue.mutate({
  repoId: 'repo-uuid',
  parentNumber: issue.number,
  title: 'Implement backend API',
});

// Add a blocking relation
await client.issues.addRelation.mutate({
  repoId: 'repo-uuid',
  sourceNumber: 43,
  targetNumber: 44,
  type: 'blocks',
});

// Get Kanban board data
const kanban = await client.issues.listGroupedByStatus.query({
  repoId: 'repo-uuid',
});

// Move issue on Kanban board
await client.issues.updateStatus.mutate({
  repoId: 'repo-uuid',
  number: issue.number,
  status: 'in_progress',
});

// Get activity feed
const activity = await client.issues.getRepoActivity.query({
  repoId: 'repo-uuid',
  limit: 50,
});