Skip to content

CLAUDE.md

Latest commit

 

History

History
46 lines (29 loc) · 3.03 KB

CLAUDE.md

File metadata and controls

46 lines (29 loc) · 3.03 KB
Raw

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

No test framework is configured yet.

Architecture

Next.js 16 App Router with Supabase auth, a LangGraph.js AI agent, and a Notion-style task table.

Route Groups

  • src/app/(dashboard)/ — Protected routes (tasks, settings). Layout checks Supabase session; redirects to /auth/login if unauthenticated. Includes dashboard/ (stats/analytics) and tasks/[id]/ (single task detail).
  • src/app/auth/ — Login, signup, OAuth callback. Layout has decorative left panel.
  • src/app/api/ — API routes: sync/ (POST triggers AI sync), sync/task/ (POST single-task sync), sync/status/ (GET), settings/ (GET/POST), cron/sync/ (GET, bearer-token protected).
  • src/app/privacy/ — Privacy policy (public page).

Supabase Three-Client Pattern

  • Browser client (lib/supabase/client.ts): createBrowserClient — used in hooks and client components.
  • Server client (lib/supabase/server.ts): createServerClient with cookies() — used in server components and API routes.
  • Middleware (lib/supabase/middleware.ts): updateSession refreshes auth on every request. src/middleware.ts redirects unauthed users to login and authed users away from auth pages.

AI Sync Agent (lib/agent/)

LangGraph StateGraph that loops over tasks: fetchGithubData → advanceOrFinish → (loop or END). Each iteration fetches GitHub issue/PR/comments/reviews/events, calls Claude with a system prompt defining the 12-status taxonomy, and returns {suggestedStatus, confidence, summary}. Runner applies updates at confidence ≥ 0.6 (summary only) or ≥ 0.75 (status change).

Task Table (components/task-table/)

Notion-style inline-editable table. Cell components in cells/ subfolder (status-cell, url-cell, text-cell, date-cell, amount-cell, note-cell). Each cell handles its own edit mode. The table uses useTasks and useCustomColumns hooks for CRUD with optimistic updates and Supabase Realtime subscriptions.

Browser Extension (extension/)

Chrome extension (Manifest V3) surfacing Tasker on GitHub issue/PR pages. Structure, build, and message protocol: extension/CLAUDE.md.

Key Conventions

  • UI primitives are Base UI (@base-ui/react), NOT Radix. Use render prop for composition (e.g., <PopoverTrigger render={<button />}>), NOT asChild.
  • shadcn/ui style: base-nova. Components use CVA for variants, Tailwind CSS variables for theming (bg-primary, text-foreground), and data-slot attributes.
  • Path alias: @/* maps to src/*.
  • Status system: 12 statuses in 3 groups (todo/in_progress/complete). Config in lib/status.ts.
  • Encryption: AES-256-GCM for API keys and tokens. Format: base64(iv):base64(authTag):base64(ciphertext). See lib/encryption.ts.
  • GitHub URL parsing: lib/github.ts has parseIssueUrl() and parsePrUrl() — extract owner/repo/number from URLs.
  • Tailwind CSS v4 with PostCSS. CSS variables for dark/light theming.