Migrate docs to Mintlify: remove Docs.tsx, search.ts, search-index.json, mdx.d.ts; redirect /docs to docs.opensync.dev; update files.md, changelog.md, task.md

Author: waynesutton

.gitignore

@@ -26,7 +26,7 @@ dist/
 # Logs
 *.log
 
-# Documentation (internal)
-docs/
+# Internal documentation (setup guides, PRDs, marketing)
+docs-internal/
 
 # Disabled pages (kept for reference, no files currently disabled)

changelog.md

@@ -8,6 +8,14 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Changed
 
+- Migrated all in-app documentation to Mintlify at docs.opensync.dev
+  - Removed Docs.tsx (full in-app documentation page with sidebar, search, and markdown export)
+  - Removed src/lib/search.ts (client-side search index builder for docs)
+  - Removed src/search-index.json (pre-built search index data)
+  - Removed src/mdx.d.ts (MDX type declarations)
+  - All /docs, /docs/*, and /docs-legacy routes now redirect externally to docs.opensync.dev
+  - Added DocsRedirect component in App.tsx for client-side redirect
+  - Updated Sidebar.tsx docs link to point to external docs.opensync.dev
 - Platform Stats header now displays "last 1000 sessions" label for clarity
   - Users know the leaderboard data is based on recent activity, not all-time totals
 
@@ -16,6 +24,8 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Fixed Netlify build error: Stats.tsx was git-ignored causing module not found error
   - Removed src/pages/Stats.tsx from .gitignore so placeholder page is included in build
   - Updated Stats.tsx header comment to reflect it's no longer git-ignored
+- Fixed Netlify build error caused by removed Docs.tsx import references
+  - Cleaned up all imports of deleted files (search.ts, search-index.json, mdx.d.ts)
 
 ### Added
 

convex/_generated/api.d.ts

@@ -92,6 +92,7 @@ export declare const components: {
         "internal",
         {
           entryId: string;
+          order: "desc" | "asc";
           paginationOpts: {
             cursor: string | null;
             endCursor?: string | null;
@@ -145,16 +146,6 @@ export declare const components: {
         {
           created: boolean;
           entryId: string;
-          replacedVersion: {
-            contentHash?: string;
-            entryId: string;
-            filterValues: Array<{ name: string; value: any }>;
-            importance: number;
-            key?: string;
-            metadata?: Record<string, any>;
-            status: "pending" | "ready" | "replaced";
-            title?: string;
-          } | null;
           status: "pending" | "ready" | "replaced";
         }
       >;
@@ -182,6 +173,24 @@ export declare const components: {
         { entryId: string; startOrder: number },
         null
       >;
+      deleteByKeyAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { beforeVersion?: number; key: string; namespaceId: string },
+        null
+      >;
+      deleteByKeySync: FunctionReference<
+        "action",
+        "internal",
+        { key: string; namespaceId: string },
+        null
+      >;
+      deleteSync: FunctionReference<
+        "action",
+        "internal",
+        { entryId: string },
+        null
+      >;
       findByContentHash: FunctionReference<
         "query",
         "internal",
@@ -200,6 +209,7 @@ export declare const components: {
           importance: number;
           key?: string;
           metadata?: Record<string, any>;
+          replacedAt?: number;
           status: "pending" | "ready" | "replaced";
           title?: string;
         } | null
@@ -215,6 +225,7 @@ export declare const components: {
           importance: number;
           key?: string;
           metadata?: Record<string, any>;
+          replacedAt?: number;
           status: "pending" | "ready" | "replaced";
           title?: string;
         } | null
@@ -223,7 +234,7 @@ export declare const components: {
         "query",
         "internal",
         {
-          namespaceId: string;
+          namespaceId?: string;
           order?: "desc" | "asc";
           paginationOpts: {
             cursor: string | null;
@@ -245,6 +256,7 @@ export declare const components: {
             importance: number;
             key?: string;
             metadata?: Record<string, any>;
+            replacedAt?: number;
             status: "pending" | "ready" | "replaced";
             title?: string;
           }>;
@@ -257,20 +269,44 @@ export declare const components: {
         "internal",
         { entryId: string },
         {
-          replacedVersion: {
+          replacedEntry: {
             contentHash?: string;
             entryId: string;
             filterValues: Array<{ name: string; value: any }>;
             importance: number;
             key?: string;
             metadata?: Record<string, any>;
+            replacedAt?: number;
             status: "pending" | "ready" | "replaced";
             title?: string;
           } | null;
         }
       >;
     };
     namespaces: {
+      deleteNamespace: FunctionReference<
+        "mutation",
+        "internal",
+        { namespaceId: string },
+        {
+          deletedNamespace: null | {
+            createdAt: number;
+            dimension: number;
+            filterNames: Array<string>;
+            modelId: string;
+            namespace: string;
+            namespaceId: string;
+            status: "pending" | "ready" | "replaced";
+            version: number;
+          };
+        }
+      >;
+      deleteNamespaceSync: FunctionReference<
+        "action",
+        "internal",
+        { namespaceId: string },
+        null
+      >;
       get: FunctionReference<
         "query",
         "internal",
@@ -335,6 +371,37 @@ export declare const components: {
           splitCursor?: string | null;
         }
       >;
+      listNamespaceVersions: FunctionReference<
+        "query",
+        "internal",
+        {
+          namespace: string;
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            createdAt: number;
+            dimension: number;
+            filterNames: Array<string>;
+            modelId: string;
+            namespace: string;
+            namespaceId: string;
+            status: "pending" | "ready" | "replaced";
+            version: number;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        }
+      >;
       lookup: FunctionReference<
         "query",
         "internal",
@@ -351,7 +418,7 @@ export declare const components: {
         "internal",
         { namespaceId: string },
         {
-          replacedVersion: null | {
+          replacedNamespace: null | {
             createdAt: number;
             dimension: number;
             filterNames: Array<string>;
@@ -385,6 +452,7 @@ export declare const components: {
             importance: number;
             key?: string;
             metadata?: Record<string, any>;
+            replacedAt?: number;
             status: "pending" | "ready" | "replaced";
             title?: string;
           }>;

convex/rag.ts

@@ -3,12 +3,14 @@ import { action, internalAction } from "./_generated/server";
 import { internal, components } from "./_generated/api";
 import { RAG } from "@convex-dev/rag";
 import { openai } from "@ai-sdk/openai";
-import type { EmbeddingModelV1, LanguageModelV1 } from "@ai-sdk/provider";
+import type { EmbeddingModelV2, LanguageModelV2 } from "@ai-sdk/provider";
 
 // Initialize RAG with user namespace filtering
-// Type cast needed due to AI SDK v3 -> v1 model type mismatch
+// Type cast needed due to AI SDK model type mismatch
 const rag = new RAG(components.rag, {
-  textEmbeddingModel: openai.embedding("text-embedding-3-small") as unknown as EmbeddingModelV1<string>,
+  textEmbeddingModel: openai.embedding(
+    "text-embedding-3-small",
+  ) as unknown as EmbeddingModelV2<string>,
   embeddingDimension: 1536,
   filterNames: ["userId"],
 });
@@ -28,9 +30,7 @@ export const indexSession = internalAction({
     await rag.add(ctx, {
       namespace: `user_${data.session.userId}`,
       text: data.textContent,
-      filterValues: [
-        { name: "userId", value: data.session.userId.toString() },
-      ],
+      filterValues: [{ name: "userId", value: data.session.userId.toString() }],
     });
 
     return null;
@@ -99,14 +99,16 @@ export const generateWithContext = action({
     // Generate response using RAG's generateText with proper API signature
     // Type cast needed due to AI SDK v3 -> v1 model type mismatch
     const { text } = await rag.generateText(ctx, {
-      model: openai("gpt-4o-mini") as unknown as LanguageModelV1,
+      model: openai("gpt-4o-mini") as unknown as LanguageModelV2,
       search: {
         namespace: `user_${user._id}`,
         limit: 5,
         vectorScoreThreshold: 0.5,
       },
       prompt: query,
-      system: systemPrompt || "You are a helpful coding assistant. Use the provided context from previous coding sessions to answer questions.",
+      system:
+        systemPrompt ||
+        "You are a helpful coding assistant. Use the provided context from previous coding sessions to answer questions.",
     });
 
     return { text, contextUsed: !!context };