API Reference

{ fullName: string } // "facebook/react"

{
  _id: Id<"repositories">,
  fullName: string,
  owner: string,
  name: string,
  stars: number,
  language: string,
  description: string,
  summary?: string,
  architecture?: string,
  mermaidDiagram?: string,
  status: "queued" | "processing" | "completed" | "failed",
  lastAnalyzedAt?: number
} | null

const repo = useQuery(api.repos.getByFullName, {
  fullName: "facebook/react"
});

{ fullName: string }

const start = useMutation(api.repos.startAnalysis);
await start.mutateAsync({ fullName: "facebook/react" });

Array<{
  fullName: string,
  stars: number,
  language: string,
  lastAnalyzedAt: number
}>

const indexed = useQuery(api.repos.listIndexed);

{ repoId: Id<"repositories"> }

Array<{
  _id: Id<"architectureEntities">,
  name: string,
  description: string,
  importance: number,
  layer: "entry-point" | "core" | "feature" | "utility" | "integration",
  path: string,
  githubUrl: string
}>

{
  repoId: Id<"repositories">,
  slug: string
}

{
  repoId: Id<"repositories">,
  difficulty?: 1 | 2 | 3 | 4 | 5  // Optional filter
}

Array<{
  _id: Id<"issues">,
  number: number,
  title: string,
  difficulty: 1 | 2 | 3 | 4 | 5,
  difficultyRationale: string,
  skills: string[],
  filesTouch: string[]
}>

{
  repoId: Id<"repositories">,
  number: number
}

{ repoId: Id<"repositories"> }

Array<{
  _id: Id<"pullRequests">,
  number: number,
  title: string,
  summary: string,
  impact: "Low" | "Medium" | "High",
  filesChanged: number
}>

{
  repoId: Id<"repositories">,
  number: number
}

{ conversationId: Id<"conversations"> }

{
  _id: Id<"conversations">,
  repoId: Id<"repositories">,
  title: string,
  messages: Array<{
    role: "user" | "assistant",
    content: string,
    toolCalls?: Array<{ name: string, args: any }>
  }>
}

{
  conversationId: Id<"conversations">,
  message: string
}

const send = useMutation(api.chat.sendMessage);
await send.mutateAsync({
  conversationId,
  message: "How does auth work?"
});

{
  repoId: Id<"repositories">,
  initialMessage?: string
}

{ owner: string }

{
  login: string,
  name?: string,
  avatarUrl: string,
  type: "User" | "Organization"
}

{
  query: string,
  limit?: number  // Default 10
}

Array<{
  fullName: string,
  description: string,
  stars: number,
  language: string
}>

{
  query: string,
  limit?: number  // Default 5
}

{
  pattern?: string,  // Glob pattern
  directory?: string
}

{ path: string }

{ difficulty?: 1 | 2 | 3 | 4 | 5 }

{ number: number }

{ number: number }

{
  _id: Id<"users">,
  name: string,
  email: string,
  image?: string
} | null

const user = useQuery(api.auth.getCurrentUser);