chore: fix prettier formatting and expand lint-staged config

- Auto-format all files with prettier
- Expand lint-staged to cover convex/**, *.md, *.html, *.json
- Prevent future CI format check failures

Author: hyochan

package.json

@@ -7,14 +7,17 @@
     "packages/*"
   ],
   "lint-staged": {
-    "packages/site/src/**/*.{ts,tsx}": [
+    "packages/site/**/*.{ts,tsx}": [
       "bash -c 'cd packages/site && bun run typecheck'",
       "bunx prettier --write"
     ],
-    "packages/site/src/**/*.{js,jsx,css,json}": [
+    "packages/site/**/*.{js,jsx,css,json,md,html}": [
       "bunx prettier --write"
     ],
-    "packages/gql/src/**/*.{ts,graphql}": [
+    "packages/gql/**/*.{ts,graphql}": [
+      "bunx prettier --write"
+    ],
+    "*.{md,json}": [
       "bunx prettier --write"
     ]
   },

packages/site/REFACTORING_GUIDE.md

@@ -1,12 +1,15 @@
 # Navigation Refactoring Guide
 
 ## Problem
+
 Navigation structure is hardcoded in `src/pages/docs/index.tsx`, violating SSOT principle and making maintenance difficult.
 
 ## Solution
+
 Created `src/lib/navigation.ts` as Single Source of Truth for all navigation items.
 
 ## Before (Hardcoded)
+
 ```tsx
 <MenuDropdown
   title="APIs"
@@ -23,53 +26,66 @@ Created `src/lib/navigation.ts` as Single Source of Truth for all navigation ite
 ```
 
 ## After (Config-driven)
+
 ```tsx
-import { REFERENCE_NAV, TUTORIAL_NAV, SIMPLE_NAV_LINKS } from "../../lib/navigation";
+import {
+  REFERENCE_NAV,
+  TUTORIAL_NAV,
+  SIMPLE_NAV_LINKS,
+} from "../../lib/navigation";
 
 // In component:
-{REFERENCE_NAV.map((section) => (
-  <MenuDropdown
-    key={section.title}
-    title={section.title}
-    titleTo={section.titleTo}
-    items={section.items}
-    onItemClick={closeSidebar}
-    isExpanded={expandedReference === section.title.toLowerCase()}
-    onToggle={() => handleReferenceToggle(section.title.toLowerCase())}
-  />
-))}
+{
+  REFERENCE_NAV.map((section) => (
+    <MenuDropdown
+      key={section.title}
+      title={section.title}
+      titleTo={section.titleTo}
+      items={section.items}
+      onItemClick={closeSidebar}
+      isExpanded={expandedReference === section.title.toLowerCase()}
+      onToggle={() => handleReferenceToggle(section.title.toLowerCase())}
+    />
+  ));
+}
 ```
 
 ## Benefits
 
 ### ✅ SSOT Compliance
+
 - All navigation items defined in one place
 - Easy to add/remove/update items
 - No duplication
 
 ### ✅ Type Safety
+
 - Full TypeScript support
 - Compile-time validation
 - Autocomplete in IDE
 
 ### ✅ Maintainability
+
 - Changes in one place affect entire app
 - Easy to refactor route structure
 - Clear separation of concerns
 
 ### ✅ Scalability
+
 - Easy to add new sections
 - Supports dynamic navigation
 - Can extend for i18n, permissions, etc.
 
 ## Migration Steps
 
 1. **Import config**:
+
    ```tsx
    import { REFERENCE_NAV, TUTORIAL_NAV } from "../../lib/navigation";
    ```
 
 2. **Replace Reference section**:
+
    ```tsx
    <h3 style={{ marginTop: "2rem" }}>Reference</h3>
    <ul>
@@ -119,56 +135,62 @@ import { REFERENCE_NAV, TUTORIAL_NAV, SIMPLE_NAV_LINKS } from "../../lib/navigat
 ## Future Enhancements
 
 ### Dynamic Navigation
+
 ```tsx
 // navigation.ts
 export const getNavigationForUser = (userRole: string) => {
-  return REFERENCE_NAV.filter(section =>
+  return REFERENCE_NAV.filter((section) =>
     hasPermission(userRole, section.title)
   );
 };
 ```
 
 ### Internationalization
+
 ```tsx
 // navigation.ts
 export const getLocalizedNav = (locale: string) => {
-  return REFERENCE_NAV.map(section => ({
+  return REFERENCE_NAV.map((section) => ({
     ...section,
     title: t(section.title, { locale }),
-    items: section.items.map(item => ({
+    items: section.items.map((item) => ({
       ...item,
-      label: t(item.label, { locale })
-    }))
+      label: t(item.label, { locale }),
+    })),
   }));
 };
 ```
 
 ### Search Integration
+
 ```tsx
 // All nav items flattened for search
 export const getAllNavItems = () => [
-  ...REFERENCE_NAV.flatMap(s => s.items),
-  ...TUTORIAL_NAV.flatMap(s => s.items),
+  ...REFERENCE_NAV.flatMap((s) => s.items),
+  ...TUTORIAL_NAV.flatMap((s) => s.items),
   ...SIMPLE_NAV_LINKS,
 ];
 ```
 
 ## Testing
-```tsx
-import { REFERENCE_NAV, TUTORIAL_NAV } from '../lib/navigation';
 
-describe('Navigation Config', () => {
-  it('should have valid routes', () => {
-    const allItems = [...REFERENCE_NAV, ...TUTORIAL_NAV].flatMap(s => s.items);
-    allItems.forEach(item => {
+```tsx
+import { REFERENCE_NAV, TUTORIAL_NAV } from "../lib/navigation";
+
+describe("Navigation Config", () => {
+  it("should have valid routes", () => {
+    const allItems = [...REFERENCE_NAV, ...TUTORIAL_NAV].flatMap(
+      (s) => s.items
+    );
+    allItems.forEach((item) => {
       expect(item.to).toMatch(/^\/docs\//);
     });
   });
 
-  it('should have unique labels', () => {
+  it("should have unique labels", () => {
     const labels = [...REFERENCE_NAV, ...TUTORIAL_NAV]
-      .flatMap(s => s.items)
-      .map(i => i.label);
+      .flatMap((s) => s.items)
+      .map((i) => i.label);
     const unique = new Set(labels);
     expect(labels.length).toBe(unique.size);
   });

packages/site/convex/comments/mutation.ts

@@ -40,15 +40,18 @@ export const addComment = mutation({
         .withIndex("by_user", (q) => q.eq("userId", userId))
         .first();
 
-      await ctx.runMutation(internal.notifications.mutation.createNotification, {
-        userId: post.authorId,
-        type: "COMMENT_ON_POST",
-        title: "New Comment",
-        message: `${commenterProfile?.displayName || commenterProfile?.githubUsername || "Someone"} commented on your post "${post.title}"`,
-        postId: args.postId,
-        commentId,
-        triggeredById: userId,
-      });
+      await ctx.runMutation(
+        internal.notifications.mutation.createNotification,
+        {
+          userId: post.authorId,
+          type: "COMMENT_ON_POST",
+          title: "New Comment",
+          message: `${commenterProfile?.displayName || commenterProfile?.githubUsername || "Someone"} commented on your post "${post.title}"`,
+          postId: args.postId,
+          commentId,
+          triggeredById: userId,
+        }
+      );
     }
 
     // If this is a reply, notify the parent comment author
@@ -60,20 +63,27 @@ export const addComment = mutation({
           .withIndex("by_user", (q) => q.eq("userId", userId))
           .first();
 
-        await ctx.runMutation(internal.notifications.mutation.createNotification, {
-          userId: parentComment.authorId,
-          type: "COMMENT_ON_POST",
-          title: "New Reply",
-          message: `${commenterProfile?.displayName || commenterProfile?.githubUsername || "Someone"} replied to your comment`,
-          postId: args.postId,
-          commentId,
-          triggeredById: userId,
-        });
+        await ctx.runMutation(
+          internal.notifications.mutation.createNotification,
+          {
+            userId: parentComment.authorId,
+            type: "COMMENT_ON_POST",
+            title: "New Reply",
+            message: `${commenterProfile?.displayName || commenterProfile?.githubUsername || "Someone"} replied to your comment`,
+            postId: args.postId,
+            commentId,
+            triggeredById: userId,
+          }
+        );
       }
     }
 
     // Send notifications to mentioned users
-    const mentionedUserIds = await getMentionedUserIds(ctx.db, args.content, userId);
+    const mentionedUserIds = await getMentionedUserIds(
+      ctx.db,
+      args.content,
+      userId
+    );
     // Filter out users who already received notifications (post author, parent comment author)
     const alreadyNotified = new Set([post.authorId]);
     if (args.parentId) {
@@ -85,19 +95,25 @@ export const addComment = mutation({
       .query("userProfiles")
       .withIndex("by_user", (q) => q.eq("userId", userId))
       .first();
-    const commenterName = commenterProfile?.displayName || commenterProfile?.githubUsername || "Someone";
+    const commenterName =
+      commenterProfile?.displayName ||
+      commenterProfile?.githubUsername ||
+      "Someone";
 
     for (const mentionedUserId of mentionedUserIds) {
       if (!alreadyNotified.has(mentionedUserId)) {
-        await ctx.runMutation(internal.notifications.mutation.createNotification, {
-          userId: mentionedUserId,
-          type: "MENTIONED",
-          title: "You were mentioned",
-          message: `${commenterName} mentioned you in a comment on "${post.title}"`,
-          postId: args.postId,
-          commentId,
-          triggeredById: userId,
-        });
+        await ctx.runMutation(
+          internal.notifications.mutation.createNotification,
+          {
+            userId: mentionedUserId,
+            type: "MENTIONED",
+            title: "You were mentioned",
+            message: `${commenterName} mentioned you in a comment on "${post.title}"`,
+            postId: args.postId,
+            commentId,
+            triggeredById: userId,
+          }
+        );
       }
     }
 
@@ -162,7 +178,10 @@ export const deleteComment = mutation({
     // Update post comment count
     if (post) {
       await ctx.db.patch(post._id, {
-        commentsCount: Math.max(0, post.commentsCount - 1 - childReplies.length),
+        commentsCount: Math.max(
+          0,
+          post.commentsCount - 1 - childReplies.length
+        ),
       });
     }
 
@@ -183,7 +202,10 @@ export const toggleCommentLike = mutation({
     const existingLike = await ctx.db
       .query("likes")
       .withIndex("by_target_user", (q) =>
-        q.eq("targetType", "comment").eq("targetId", args.commentId).eq("userId", userId)
+        q
+          .eq("targetType", "comment")
+          .eq("targetId", args.commentId)
+          .eq("userId", userId)
       )
       .first();
 
@@ -213,15 +235,18 @@ export const toggleCommentLike = mutation({
           .withIndex("by_user", (q) => q.eq("userId", userId))
           .first();
 
-        await ctx.runMutation(internal.notifications.mutation.createNotification, {
-          userId: comment.authorId,
-          type: "LIKE_ON_COMMENT",
-          title: "New Like",
-          message: `${likerProfile?.displayName || likerProfile?.githubUsername || "Someone"} liked your comment`,
-          postId: comment.postId,
-          commentId: args.commentId,
-          triggeredById: userId,
-        });
+        await ctx.runMutation(
+          internal.notifications.mutation.createNotification,
+          {
+            userId: comment.authorId,
+            type: "LIKE_ON_COMMENT",
+            title: "New Like",
+            message: `${likerProfile?.displayName || likerProfile?.githubUsername || "Someone"} liked your comment`,
+            postId: comment.postId,
+            commentId: args.commentId,
+            triggeredById: userId,
+          }
+        );
       }
 
       return { liked: true };

packages/site/convex/comments/query.ts

@@ -36,7 +36,10 @@ export const getComments = query({
           const like = await ctx.db
             .query("likes")
             .withIndex("by_target_user", (q) =>
-              q.eq("targetType", "comment").eq("targetId", comment._id).eq("userId", userId)
+              q
+                .eq("targetType", "comment")
+                .eq("targetId", comment._id)
+                .eq("userId", userId)
             )
             .first();
           hasLiked = !!like;
@@ -46,7 +49,10 @@ export const getComments = query({
         const githubUsername =
           authorProfile?.githubUsername || authorUser?.name || "user";
         const displayName =
-          authorProfile?.displayName || authorProfile?.githubUsername || authorUser?.name || "Anonymous";
+          authorProfile?.displayName ||
+          authorProfile?.githubUsername ||
+          authorUser?.name ||
+          "Anonymous";
         const avatarUrl =
           authorProfile?.avatarUrl || authorUser?.image || undefined;
 
@@ -70,9 +76,7 @@ export const getComments = query({
 
     const commentsWithReplies = parentComments.map((parent) => ({
       ...parent,
-      replies: childComments.filter(
-        (child) => child.parentId === parent._id
-      ),
+      replies: childComments.filter((child) => child.parentId === parent._id),
     }));
 
     return commentsWithReplies;

packages/site/convex/lemon_squeezy/webhook.ts

@@ -178,7 +178,10 @@ export const webhook = httpAction(async (ctx, request) => {
       if (githubUsername && membershipId) {
         const githubToken = process.env.GITHUB_REPO_ADMIN_TOKEN;
         if (githubToken) {
-          const inviteSent = await addRepoCollaborator(githubUsername, githubToken);
+          const inviteSent = await addRepoCollaborator(
+            githubUsername,
+            githubToken
+          );
           if (inviteSent) {
             await ctx.runMutation(internal.pro.mutation.markGithubInviteSent, {
               membershipId,