insforge 1.3.0 → 1.4.8

package/docs/vscode-extension.mdx

@@ -0,0 +1,74 @@
+---
+title: "VS Code Extension"
+description: "Connect your InsForge projects to AI coding assistants and install MCP with one click."
+---
+
+## Overview
+
+The InsForge VS Code extension:
+
+- Logs you in to InsForge (OAuth + PKCE)
+- Lets you pick an org/project
+- Installs InsForge MCP for your AI client
+
+It launches the MCP installer (`npx @insforge/install`) with your project’s API key and API base URL.
+
+## Links
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=InsForge.insforge)
+- [Open VSX](https://open-vsx.org/extension/InsForge/insforge)
+
+## Install
+
+1. Open VS Code
+2. Go to **Extensions**
+3. Search for **InsForge**
+4. Install the extension published by **insforge**
+
+## Use the extension
+
+<Steps>
+  <Step title="Open the InsForge panel">
+    Click the **InsForge** icon in the Activity Bar (left sidebar).
+  </Step>
+
+  <Step title="Login">
+    Click **Login with InsForge** and complete the login flow in your browser.
+
+    <Note>The callback is <code>http://127.0.0.1:54321/callback</code>.</Note>
+  </Step>
+
+  <Step title="Select a project">
+    Pick an organization and project from the InsForge tree view, or run <code>InsForge: Select Project</code> from the Command Palette.
+  </Step>
+
+  <Step title="Install MCP">
+    Run <code>InsForge: Install MCP</code> (or right-click a project and choose **Install MCP**), then pick the AI client you want to configure.
+
+    The installer runs in a VS Code terminal.
+  </Step>
+</Steps>
+
+## Supported AI clients
+
+The extension supports the following MCP “clients” (the value passed to `@insforge/install`):
+
+| Client | Typical config location |
+|---|---|
+| `cursor` | `~/.cursor/mcp.json` |
+| `claude-code` | `.mcp.json` in your workspace (project-local) |
+| `copilot` | `.vscode/mcp.json` in your workspace (project-local) |
+| `windsurf` | `~/.codeium/windsurf/` |
+| `cline` | Cline VS Code extension config |
+| `roocode` | Roo Code VS Code extension config |
+| `codex` | OpenAI Codex CLI config |
+| `trae` | Trae IDE config |
+| `qoder` | Qoder IDE config |
+
+If your client isn’t listed, run the installer manually (see <a href="/quickstart">Quickstart</a>).
+
+## Notes
+
+- **Project-local installs**: `claude-code` and `copilot` require an open workspace folder.
+- **Port in use**: free up `54321` and retry login.
+

package/eslint.config.js

@@ -319,6 +319,7 @@ export default defineConfig(
       'examples/**',
       'openapi/**',
       'functions/',
+      'backend/src/infra/database/migrations/bootstrap/**', // Bootstrap scripts run before build
     ],
   }
 );

package/examples/response-examples.md

@@ -156,7 +156,7 @@ All API responses now follow a consistent format with `success` field and proper
 ```json
 {
   "success": true,
-  "data": ["users", "posts", "comments"],
+  "data": ["posts", "comments"],
   "meta": {
     "timestamp": "2024-01-01T00:00:00.000Z"
   }

package/frontend/package.json

@@ -66,4 +66,4 @@
     "vite": "^7.0.5",
     "vite-plugin-svgr": "^4.3.0"
   }
-}
+}

package/frontend/src/App.tsx

@@ -1,5 +1,7 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { AuthProvider } from '@/lib/contexts/AuthContext';
+import { ModalProvider } from '@/lib/contexts/ModalContext';
+import { OnboardingController } from '@/features/onboard';
 import { AppRoutes } from '@/lib/routing/AppRoutes';
 import { ToastProvider } from '@/lib/hooks/useToast';
 import { SocketProvider } from '@/lib/contexts/SocketContext';
@@ -23,9 +25,12 @@ function App() {
         <SocketProvider>
           <ToastProvider>
             <PostHogAnalyticsProvider>
-              <SQLEditorProvider>
-                <AppRoutes />
-              </SQLEditorProvider>
+              <ModalProvider>
+                <OnboardingController />
+                <SQLEditorProvider>
+                  <AppRoutes />
+                </SQLEditorProvider>
+              </ModalProvider>
             </PostHogAnalyticsProvider>
           </ToastProvider>
         </SocketProvider>