veryfront 0.1.403 → 0.1.405

package/esm/src/server/bootstrap.js

@@ -16,6 +16,8 @@ import { initializeEsbuild } from "../platform/compat/esbuild.js";
 import { logger } from "../utils/index.js";
 import { isDebugEnabled } from "../utils/constants/env.js";
 import { getEnvSource, hasEnvLoaded, loadEnv, markEnvLoaded, supportsEnvFiles, } from "../utils/env-loader.js";
+import { getLogBuffer } from "../observability/log-buffer.js";
+import { createFileLogSubscriber, } from "../observability/file-log-subscriber.js";
 import { ReloadNotifier } from "./reload-notifier.js";
 import { clearDomainCache } from "./utils/domain-lookup.js";
 const bootstrapLog = logger.component("bootstrap");
@@ -60,14 +62,51 @@ function wireTracingShim() {
         bootstrapLog.debug("[bootstrap] no TracingExporter extension — using no-op tracer");
     }
 }
-function combineDispose(extensionLoader, fsDispose) {
+const DEFAULT_FILE_LOG_PATH = ".veryfront/logs/server.log";
+const DEFAULT_FILE_LOG_MAX_SIZE = "10mb";
+const DEFAULT_FILE_LOG_MAX_FILES = 5;
+const DEFAULT_FILE_LOG_LEVEL = "warn";
+const DEFAULT_FILE_LOG_FORMAT = "json";
+function maybeAttachFileLogSubscriber(config) {
+    const fileConfig = config.observability?.logging?.file;
+    if (!fileConfig?.enabled)
+        return null;
+    const resolved = {
+        enabled: true,
+        path: fileConfig.path ?? DEFAULT_FILE_LOG_PATH,
+        maxSize: fileConfig.maxSize ?? DEFAULT_FILE_LOG_MAX_SIZE,
+        maxFiles: fileConfig.maxFiles ?? DEFAULT_FILE_LOG_MAX_FILES,
+        level: fileConfig.level ?? DEFAULT_FILE_LOG_LEVEL,
+        format: fileConfig.format ?? DEFAULT_FILE_LOG_FORMAT,
+    };
+    const subscriber = createFileLogSubscriber(resolved);
+    const unsubscribe = getLogBuffer().subscribe(subscriber.getSubscriber());
+    bootstrapLog.debug("[bootstrap] File log subscriber attached", {
+        path: resolved.path,
+        level: resolved.level,
+        format: resolved.format,
+    });
+    return { subscriber, unsubscribe };
+}
+async function teardownFileLog(handle) {
+    if (!handle)
+        return;
+    handle.unsubscribe();
+    await handle.subscriber.close();
+}
+function combineDispose(extensionLoader, fsDispose, fileLogHandle) {
     return async () => {
         try {
             await extensionLoader.teardownAll();
         }
         finally {
-            if (fsDispose)
-                fsDispose();
+            try {
+                await teardownFileLog(fileLogHandle ?? null);
+            }
+            finally {
+                if (fsDispose)
+                    fsDispose();
+            }
         }
     };
 }
@@ -144,118 +183,131 @@ export async function bootstrap(projectDir, adapter) {
     await ensureEnvLoaded(projectDir, adapter);
     bootstrapLog.debug("Loading config with base adapter");
     let config = await getConfig(projectDir, adapter);
-    const fsType = config.fs?.type;
-    const needsFSAdapter = fsType != null && fsType !== "local";
-    if (!needsFSAdapter) {
-        bootstrapLog.debug("Using local filesystem (no FSAdapter needed)");
-        const extensionLoader = await orchestrateExtensions({
-            projectDir,
-            config,
-            logger: bootstrapLog,
-            primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
-            builtinExtensions: createBuiltinExtensions(),
-        });
-        wireTracingShim();
-        assertRequiredContracts();
-        return {
-            adapter,
-            config,
-            usingFSAdapter: false,
-            extensionLoader,
-            dispose: combineDispose(extensionLoader),
+    let fileLog = maybeAttachFileLogSubscriber(config);
+    try {
+        const fsType = config.fs?.type;
+        const needsFSAdapter = fsType != null && fsType !== "local";
+        if (!needsFSAdapter) {
+            bootstrapLog.debug("Using local filesystem (no FSAdapter needed)");
+            const extensionLoader = await orchestrateExtensions({
+                projectDir,
+                config,
+                logger: bootstrapLog,
+                primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
+                builtinExtensions: createBuiltinExtensions(),
+            });
+            wireTracingShim();
+            assertRequiredContracts();
+            return {
+                adapter,
+                config,
+                usingFSAdapter: false,
+                extensionLoader,
+                dispose: combineDispose(extensionLoader, undefined, fileLog),
+            };
+        }
+        bootstrapLog.debug("Initializing FSAdapter", { type: fsType });
+        // Inject server-layer callbacks into FS config so the platform layer
+        // doesn't need to import from the server layer
+        const fsWithCallbacks = {
+            ...config.fs,
+            invalidationCallbacks: {
+                triggerReload: (changedPaths, project) => ReloadNotifier.triggerReload(changedPaths, project),
+                clearDomainCache,
+            },
         };
-    }
-    bootstrapLog.debug("Initializing FSAdapter", { type: fsType });
-    // Inject server-layer callbacks into FS config so the platform layer
-    // doesn't need to import from the server layer
-    const fsWithCallbacks = {
-        ...config.fs,
-        invalidationCallbacks: {
-            triggerReload: (changedPaths, project) => ReloadNotifier.triggerReload(changedPaths, project),
-            clearDomainCache,
-        },
-    };
-    const enhancedAdapter = await enhanceAdapterWithFS(adapter, { ...config, fs: fsWithCallbacks }, projectDir);
-    if (enhancedAdapter === adapter) {
+        const enhancedAdapter = await enhanceAdapterWithFS(adapter, { ...config, fs: fsWithCallbacks }, projectDir);
+        if (enhancedAdapter === adapter) {
+            bootstrapLog.debug("Framework initialized successfully", {
+                projectDir,
+                runtime: adapter.id,
+                fsAdapter: "local",
+            });
+            const extensionLoader = await orchestrateExtensions({
+                projectDir,
+                config,
+                logger: bootstrapLog,
+                primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
+                builtinExtensions: createBuiltinExtensions(),
+            });
+            wireTracingShim();
+            assertRequiredContracts();
+            return {
+                adapter,
+                config,
+                usingFSAdapter: false,
+                extensionLoader,
+                dispose: combineDispose(extensionLoader, undefined, fileLog),
+            };
+        }
+        const isProxyMode = config.fs?.veryfront?.proxyMode === true;
+        const isProductionMode = config.fs?.veryfront?.productionMode === true;
+        if (isProxyMode) {
+            bootstrapLog.debug("Skipping config reload in proxy mode (using local config)");
+        }
+        else if (isProductionMode) {
+            bootstrapLog.debug("Skipping config reload in production mode (using local config)");
+        }
+        else {
+            bootstrapLog.debug("Reloading config with FSAdapter");
+            clearConfigCache();
+            const originalConfig = config;
+            const reloadedConfig = await getConfig(projectDir, enhancedAdapter);
+            const usesDefaultDevConfig = reloadedConfig.dev?.port === 3000 &&
+                reloadedConfig.dev?.host === "localhost" &&
+                !reloadedConfig.dev?.hmr;
+            if (usesDefaultDevConfig && originalConfig.dev) {
+                bootstrapLog.debug("Keeping original config (FSAdapter returned defaults)");
+                config = originalConfig;
+            }
+            else {
+                config = reloadedConfig;
+            }
+            // Re-attach file log subscriber if config was reloaded with different settings
+            const newFileLog = maybeAttachFileLogSubscriber(config);
+            if (newFileLog) {
+                await teardownFileLog(fileLog);
+                fileLog = newFileLog;
+            }
+        }
         bootstrapLog.debug("Framework initialized successfully", {
             projectDir,
             runtime: adapter.id,
-            fsAdapter: "local",
+            fsAdapter: fsType,
         });
-        const extensionLoader = await orchestrateExtensions({
+        let fsDispose;
+        if (isExtendedFSAdapter(enhancedAdapter.fs)) {
+            const underlying = enhancedAdapter.fs.getUnderlyingAdapter();
+            if ("dispose" in underlying &&
+                typeof underlying.dispose === "function") {
+                fsDispose = () => underlying.dispose();
+            }
+        }
+        // If extension orchestration fails after the FS adapter has been wired up,
+        // release the FS resources (WebSocket connections, caches) before
+        // propagating the error — otherwise the adapter would leak.
+        const extensionLoader = await orchestrateOrDisposeFS(() => orchestrateExtensions({
             projectDir,
             config,
             logger: bootstrapLog,
             primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
             builtinExtensions: createBuiltinExtensions(),
-        });
+        }), fsDispose);
         wireTracingShim();
         assertRequiredContracts();
         return {
-            adapter,
+            adapter: enhancedAdapter,
             config,
-            usingFSAdapter: false,
+            usingFSAdapter: true,
+            fsAdapterType: fsType,
             extensionLoader,
-            dispose: combineDispose(extensionLoader),
+            dispose: combineDispose(extensionLoader, fsDispose, fileLog),
         };
     }
-    const isProxyMode = config.fs?.veryfront?.proxyMode === true;
-    const isProductionMode = config.fs?.veryfront?.productionMode === true;
-    if (isProxyMode) {
-        bootstrapLog.debug("Skipping config reload in proxy mode (using local config)");
-    }
-    else if (isProductionMode) {
-        bootstrapLog.debug("Skipping config reload in production mode (using local config)");
-    }
-    else {
-        bootstrapLog.debug("Reloading config with FSAdapter");
-        clearConfigCache();
-        const originalConfig = config;
-        const reloadedConfig = await getConfig(projectDir, enhancedAdapter);
-        const usesDefaultDevConfig = reloadedConfig.dev?.port === 3000 &&
-            reloadedConfig.dev?.host === "localhost" &&
-            !reloadedConfig.dev?.hmr;
-        if (usesDefaultDevConfig && originalConfig.dev) {
-            bootstrapLog.debug("Keeping original config (FSAdapter returned defaults)");
-            config = originalConfig;
-        }
-        else {
-            config = reloadedConfig;
-        }
-    }
-    bootstrapLog.debug("Framework initialized successfully", {
-        projectDir,
-        runtime: adapter.id,
-        fsAdapter: fsType,
-    });
-    let fsDispose;
-    if (isExtendedFSAdapter(enhancedAdapter.fs)) {
-        const underlying = enhancedAdapter.fs.getUnderlyingAdapter();
-        if ("dispose" in underlying &&
-            typeof underlying.dispose === "function") {
-            fsDispose = () => underlying.dispose();
-        }
+    catch (err) {
+        await teardownFileLog(fileLog);
+        throw err;
     }
-    // If extension orchestration fails after the FS adapter has been wired up,
-    // release the FS resources (WebSocket connections, caches) before
-    // propagating the error — otherwise the adapter would leak.
-    const extensionLoader = await orchestrateOrDisposeFS(() => orchestrateExtensions({
-        projectDir,
-        config,
-        logger: bootstrapLog,
-        primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
-        builtinExtensions: createBuiltinExtensions(),
-    }), fsDispose);
-    wireTracingShim();
-    assertRequiredContracts();
-    return {
-        adapter: enhancedAdapter,
-        config,
-        usingFSAdapter: true,
-        fsAdapterType: fsType,
-        extensionLoader,
-        dispose: combineDispose(extensionLoader, fsDispose),
-    };
 }
 export async function bootstrapDev(projectDir, adapter) {
     bootstrapDevLog.debug("Starting development mode initialization");

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.403";
+export declare const VERSION = "0.1.405";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.403";
+export const VERSION = "0.1.405";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.403",
+  "version": "0.1.405",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/commands/install/registry.ts

@@ -1,4 +1,4 @@
-import { readTextFile } from "../../../src/platform/index.js";
+import manifest from "../../templates/manifest.js";
 import { type AITool, type AIToolId, AIToolIdSchema, AIToolSchema } from "./types.js";
 
 const AI_TOOLS_RAW = [
@@ -67,6 +67,13 @@ export function isValidToolId(id: string): id is AIToolId {
 
 export function getTemplateContent(toolId: string): Promise<string> {
   const { template } = getToolById(toolId);
-  const templatePath = new URL(`../../templates/ai-rules/${template}`, import.meta.url).pathname;
-  return readTextFile(templatePath);
+  const entry = (manifest as Record<string, unknown>).templates as Record<
+    string,
+    { files: Record<string, string> }
+  >;
+  const aiRule = entry[`ai-rules:${template}`];
+  if (!aiRule) throw new Error(`Template not found in manifest: ${template}`);
+  const content = aiRule.files[template];
+  if (!content) throw new Error(`Template file not found in manifest: ${template}`);
+  return Promise.resolve(content);
 }

package/src/cli/templates/manifest.js

@@ -587,6 +587,36 @@ export default {
         "app/api/auth/docs-google/callback/route.ts": "import { createOAuthCallbackHandler, docsGoogleConfig } from \"veryfront/oauth\";\nimport { tokenStore } from \"../../../../../lib/token-store.ts\";\nimport { oauthMemoryTokenStore } from \"../../../../../lib/oauth-memory-store.ts\";\n\nconst hybridTokenStore = {\n  getTokens(serviceId: string, userId: string) {\n    return tokenStore.getToken(userId, serviceId);\n  },\n  async setTokens(\n    serviceId: string,\n    userId: string,\n    tokens: { accessToken: string; refreshToken?: string; expiresAt?: number },\n  ) {\n    await tokenStore.setToken(userId, serviceId, tokens);\n  },\n  async clearTokens(serviceId: string, userId: string) {\n    await tokenStore.revokeToken(userId, serviceId);\n  },\n  setState(\n    state: string,\n    meta: {\n      userId: string;\n      serviceId: string;\n      codeVerifier?: string;\n      redirectUri?: string;\n      scopes?: string[];\n      createdAt: number;\n    },\n  ) {\n    return oauthMemoryTokenStore.setState(state, meta);\n  },\n  consumeState(state: string) {\n    return oauthMemoryTokenStore.consumeState(state);\n  },\n};\n\nexport const GET = createOAuthCallbackHandler(docsGoogleConfig, { tokenStore: hybridTokenStore });\n",
         "app/api/auth/docs-google/route.ts": "import { createOAuthInitHandler, docsGoogleConfig } from \"veryfront/oauth\";\nimport { oauthMemoryTokenStore } from \"../../../../../lib/oauth-memory-store.ts\";\n\n// TODO: Replace with real user ID from your auth system (e.g., session cookie, JWT).\n// NEVER return a shared constant in production - it breaks per-user token isolation (VULN-AUTH-2).\nfunction getUserId(_request: Request): string {\n  return \"current-user\";\n}\n\nexport const GET = createOAuthInitHandler(docsGoogleConfig, {\n  tokenStore: oauthMemoryTokenStore,\n  getUserId,\n});"
       }
+    },
+    "ai-rules:claude-code.md": {
+      "files": {
+        "claude-code.md": "# Veryfront Project\n\nZero-config React meta-framework for AI-native applications.\n\n## Quick Reference\n\n| Command                          | Purpose                                  |\n| -------------------------------- | ---------------------------------------- |\n| `veryfront dev`                  | Start dev server (http://localhost:3000) |\n| `veryfront build`                | Production build                         |\n| `veryfront deploy`               | Deploy to Veryfront cloud                |\n| `veryfront generate page <name>` | Generate new page                        |\n| `veryfront generate api <name>`  | Generate API route                       |\n\n## Project Structure\n\n- `src/pages/*.tsx` → Routes (file-based routing)\n- `src/api/*.ts` → API endpoints (`/api/*`)\n- `src/components/` → Shared components\n- `agents/` → AI agents\n- `tools/` → MCP tools\n\n## When Asked to Add Features\n\n1. **Pages**: Create in `src/pages/` (e.g., `about.tsx` → `/about`)\n2. **APIs**: Create in `src/api/` (e.g., `users.ts` → `/api/users`)\n3. **Components**: Create in `src/components/`\n4. **AI Agents**: Create in `agents/`\n\n## Code Patterns\n\n```tsx\n// Page (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// Dynamic API (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Conventions\n\n- Use TypeScript\n- Use React 19 features\n- Use Tailwind for styling\n- Co-locate tests (`*.test.ts`)\n- Use `#veryfront/*` imports\n\n## Testing\n\n- Run `veryfront dev` and check browser\n- API endpoints at `/api/*`\n- Run `deno task test` for tests\n"
+      }
+    },
+    "ai-rules:skill.md": {
+      "files": {
+        "skill.md": "---\nname: veryfront\ndescription: Build and deploy fullstack AI-native React apps with Veryfront CLI\nlicense: MIT\ncompatibility: Claude Code, Cursor, VS Code, Codex, Gemini CLI\nmetadata:\n  author: veryfront\n  version: \"1.0\"\n---\n\n# Veryfront\n\nZero-config React meta-framework for AI-native applications.\n\n## Commands\n\n| Command                          | Purpose                           |\n| -------------------------------- | --------------------------------- |\n| `veryfront dev`                  | Start development server with HMR |\n| `veryfront build`                | Build for production              |\n| `veryfront deploy`               | Deploy to Veryfront cloud         |\n| `veryfront generate page <name>` | Generate a new page               |\n| `veryfront generate api <name>`  | Generate an API route             |\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (*.tsx → routes)\n├── api/             # API routes (*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → `/about`\n- **API endpoint**: Create `src/api/users.ts` → `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Code Examples\n\n### Page Component\n\n```tsx\n// src/pages/about.tsx\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\n### API Route\n\n```ts\n// src/api/hello.ts\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n```\n\n### Dynamic API Route\n\n```ts\n// src/api/users/[id].ts\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation\n- Use `#veryfront/*` imports for framework modules\n\n## Testing\n\n- Development: `veryfront dev` (http://localhost:3000)\n- API endpoints: `/api/*`\n- Run tests: `deno task test`\n"
+      }
+    },
+    "ai-rules:copilot.md": {
+      "files": {
+        "copilot.md": "# Veryfront Project Instructions\n\nThis is a Veryfront project - a zero-config React meta-framework for AI-native applications.\n\n## CLI Commands\n\n- `veryfront dev` - Start development server with hot module replacement\n- `veryfront build` - Build for production deployment\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Scaffold a new page\n- `veryfront generate api <name>` - Scaffold an API route\n\n## File Structure\n\nThe project uses file-based routing:\n\n- `src/pages/*.tsx` - React pages (automatically become routes)\n- `src/api/*.ts` - API endpoints (accessible at `/api/*`)\n- `src/components/` - Shared React components\n- `agents/` - AI agent definitions\n- `tools/` - MCP tool implementations\n\n## Code Patterns\n\n### Creating a Page\n\n```tsx\n// src/pages/about.tsx → accessible at /about\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\n### Creating an API Endpoint\n\n```ts\n// src/api/hello.ts → accessible at /api/hello\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\nexport function POST(request: Request) {\n  // Handle POST request\n  return Response.json({ success: true });\n}\n```\n\n### Dynamic Routes\n\n```ts\n// src/api/users/[id].ts → accessible at /api/users/:id\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ userId: params.id });\n}\n```\n\n## Technology Stack\n\n- Runtime: Deno\n- UI: React 19 with Server Components\n- Styling: Tailwind CSS\n- Language: TypeScript (required)\n\n## Best Practices\n\n- Co-locate test files with implementation (`*.test.ts`)\n- Use `#veryfront/*` import aliases for framework modules\n- Follow React 19 patterns (use hook, Server Components)\n- Use Response.json() for API responses\n"
+      }
+    },
+    "ai-rules:windsurf.md": {
+      "files": {
+        "windsurf.md": "# Veryfront Project\n\nYou are in a Veryfront project - zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `veryfront dev` - Start development server with HMR\n- `veryfront build` - Build for production\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Generate a new page\n- `veryfront generate api <name>` - Generate an API route\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (pages/*.tsx → routes)\n├── api/             # API routes (api/*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → accessible at `/about`\n- **API endpoint**: Create `src/api/users.ts` → accessible at `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation (`*.test.ts`)\n- Use `#veryfront/*` imports for framework modules\n\n## File Patterns\n\n```tsx\n// Page component (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API route (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// API with params (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Testing\n\n- Run `veryfront dev` and check browser at http://localhost:3000\n- API endpoints available at `/api/*`\n- Use `deno task test` to run tests\n"
+      }
+    },
+    "ai-rules:agents.md": {
+      "files": {
+        "agents.md": "# Veryfront Agent Instructions\n\nThis is a Veryfront project. Veryfront is a zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `npx veryfront dev` - Start development server\n- `npx veryfront build` - Build for production\n- `npx veryfront deploy` - Deploy to cloud\n- `npx veryfront generate page <name>` - Generate a page\n- `npx veryfront generate api <name>` - Generate an API route\n\n## File Conventions\n\n- **Pages**: `src/pages/*.tsx` (file-based routing)\n- **APIs**: `src/api/*.ts` (serverless functions at `/api/*`)\n- **Components**: `src/components/*.tsx`\n- **AI Agents**: `agents/*.ts`\n- **MCP Tools**: `tools/*.ts`\n\n## Examples\n\n### Create a new page\n\n```tsx\n// src/pages/about.tsx\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\nThis page will be accessible at `/about`.\n\n### Create an API endpoint\n\n```ts\n// src/api/hello.ts\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\nexport function POST(request: Request) {\n  return Response.json({ success: true });\n}\n```\n\nThis API will be accessible at `/api/hello`.\n\n### Create a dynamic API route\n\n```ts\n// src/api/users/[id].ts\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ userId: params.id });\n}\n```\n\nThis API will be accessible at `/api/users/:id`.\n\n## Technology Stack\n\n- **Runtime**: Deno\n- **UI Framework**: React 19\n- **Styling**: Tailwind CSS\n- **Language**: TypeScript\n\n## Best Practices\n\n- Co-locate tests with implementation files (`*.test.ts`)\n- Use `#veryfront/*` import aliases\n- Use React 19 features (use hook, Server Components)\n- Return `Response.json()` from API routes\n"
+      }
+    },
+    "ai-rules:cursor.md": {
+      "files": {
+        "cursor.md": "# Veryfront Project\n\nYou are in a Veryfront project - zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `veryfront dev` - Start development server with HMR\n- `veryfront build` - Build for production\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Generate a new page\n- `veryfront generate api <name>` - Generate an API route\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (pages/*.tsx → routes)\n├── api/             # API routes (api/*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → accessible at `/about`\n- **API endpoint**: Create `src/api/users.ts` → accessible at `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation (`*.test.ts`)\n- Use `#veryfront/*` imports for framework modules\n\n## File Patterns\n\n```tsx\n// Page component (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API route (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// API with params (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Testing\n\n- Run `veryfront dev` and check browser at http://localhost:3000\n- API endpoints available at `/api/*`\n- Use `deno task test` to run tests\n"
+      }
     }
   }
 };

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.403",
+  "version": "0.1.405",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/deps/esm.sh/@types/react-dom@19.2.3/client.d.ts

@@ -4,7 +4,7 @@
 
 // See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
 
-import React = require("https://esm.sh/@types/react@19.2.3/index.d.ts");
+import React = require("https://esm.sh/@types/react@19.2.14/index.d.ts");
 
 export {};
 

package/src/deps/esm.sh/@types/{react@19.2.3 → react@19.2.14}/global.d.ts

@@ -18,6 +18,7 @@ interface KeyboardEvent extends Event {}
 interface MouseEvent extends Event {}
 interface TouchEvent extends Event {}
 interface PointerEvent extends Event {}
+interface SubmitEvent extends Event {}
 interface ToggleEvent extends Event {}
 interface TransitionEvent extends Event {}
 interface UIEvent extends Event {}

package/src/deps/esm.sh/@types/{react@19.2.3 → react@19.2.14}/index.d.ts

@@ -16,6 +16,7 @@ type NativeKeyboardEvent = KeyboardEvent;
 type NativeMouseEvent = MouseEvent;
 type NativeTouchEvent = TouchEvent;
 type NativePointerEvent = PointerEvent;
+type NativeSubmitEvent = SubmitEvent;
 type NativeToggleEvent = ToggleEvent;
 type NativeTransitionEvent = TransitionEvent;
 type NativeUIEvent = UIEvent;
@@ -225,12 +226,20 @@ declare namespace React {
 
     type ComponentState = any;
 
+    interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES {}
+
     /**
      * A value which uniquely identifies a node among items in an array.
      *
      * @see {@link https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key React Docs}
      */
-    type Key = string | number | bigint;
+    type Key =
+        | string
+        | number
+        | bigint
+        | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES[
+            keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES
+        ];
 
     /**
      * @internal The props any component can receive.
@@ -1884,7 +1893,7 @@ declare namespace React {
      *
      * @param callback A synchronous, void callback that will execute as a single, complete React commit.
      *
-     * @see https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks
+     * @see {@link https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks}
      */
     // NOTES
     // - the order of these signatures matters - typescript will check the signatures in source order.
@@ -1926,7 +1935,31 @@ declare namespace React {
         reducer: (state: State, action: Action) => State,
     ): [State, (action: Action) => void];
 
-    export type Usable<T> = PromiseLike<T> | Context<T>;
+    interface UntrackedReactPromise<T> extends PromiseLike<T> {
+        status?: void;
+    }
+
+    export interface PendingReactPromise<T> extends PromiseLike<T> {
+        status: "pending";
+    }
+
+    export interface FulfilledReactPromise<T> extends PromiseLike<T> {
+        status: "fulfilled";
+        value: T;
+    }
+
+    export interface RejectedReactPromise<T> extends PromiseLike<T> {
+        status: "rejected";
+        reason: unknown;
+    }
+
+    export type ReactPromise<T> =
+        | UntrackedReactPromise<T>
+        | PendingReactPromise<T>
+        | FulfilledReactPromise<T>
+        | RejectedReactPromise<T>;
+
+    export type Usable<T> = ReactPromise<T> | Context<T>;
 
     export function use<T>(usable: Usable<T>): T;
 
@@ -2041,15 +2074,28 @@ declare namespace React {
         target: EventTarget & Target;
     }
 
+    /**
+     * @deprecated FormEvent doesn't actually exist.
+     *             You probably meant to use {@link ChangeEvent}, {@link InputEvent}, {@link SubmitEvent}, or just {@link SyntheticEvent} instead
+     *             depending on the event type.
+     */
     interface FormEvent<T = Element> extends SyntheticEvent<T> {
     }
 
     interface InvalidEvent<T = Element> extends SyntheticEvent<T> {
-        target: EventTarget & T;
     }
 
-    interface ChangeEvent<T = Element> extends SyntheticEvent<T> {
-        target: EventTarget & T;
+    /**
+     * change events bubble in React so their target is generally unknown.
+     * Only for form elements we know their target type because form events can't
+     * be nested.
+     * This type exists purely to narrow `target` for form elements. It doesn't
+     * reflect a DOM event. Change events are just fired as standard {@link SyntheticEvent}.
+     */
+    interface ChangeEvent<CurrentTarget = Element, Target = Element> extends SyntheticEvent<CurrentTarget> {
+        // TODO: This is wrong for change event handlers on arbitrary. Should
+        // be EventTarget & Target, but kept for backward compatibility until React 20.
+        target: EventTarget & CurrentTarget;
     }
 
     interface InputEvent<T = Element> extends SyntheticEvent<T, NativeInputEvent> {
@@ -2119,6 +2165,13 @@ declare namespace React {
         shiftKey: boolean;
     }
 
+    interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
+        // `submitter` is available in react@canary
+        // submitter: HTMLElement | null;
+        // SubmitEvents are always targetted at HTMLFormElements.
+        target: EventTarget & HTMLFormElement;
+    }
+
     interface TouchEvent<T = Element> extends UIEvent<T, NativeTouchEvent> {
         altKey: boolean;
         changedTouches: TouchList;
@@ -2174,11 +2227,19 @@ declare namespace React {
     type CompositionEventHandler<T = Element> = EventHandler<CompositionEvent<T>>;
     type DragEventHandler<T = Element> = EventHandler<DragEvent<T>>;
     type FocusEventHandler<T = Element> = EventHandler<FocusEvent<T>>;
+    /**
+     * @deprecated FormEventHandler doesn't actually exist.
+     *             You probably meant to use {@link ChangeEventHandler}, {@link InputEventHandler}, {@link SubmitEventHandler}, or just {@link EventHandler} instead
+     *             depending on the event type.
+     */
     type FormEventHandler<T = Element> = EventHandler<FormEvent<T>>;
-    type ChangeEventHandler<T = Element> = EventHandler<ChangeEvent<T>>;
+    type ChangeEventHandler<CurrentTarget = Element, Target = Element> = EventHandler<
+        ChangeEvent<CurrentTarget, Target>
+    >;
     type InputEventHandler<T = Element> = EventHandler<InputEvent<T>>;
     type KeyboardEventHandler<T = Element> = EventHandler<KeyboardEvent<T>>;
     type MouseEventHandler<T = Element> = EventHandler<MouseEvent<T>>;
+    type SubmitEventHandler<T = Element> = EventHandler<SubmitEvent<T>>;
     type TouchEventHandler<T = Element> = EventHandler<TouchEvent<T>>;
     type PointerEventHandler<T = Element> = EventHandler<PointerEvent<T>>;
     type UIEventHandler<T = Element> = EventHandler<UIEvent<T>>;
@@ -2232,19 +2293,19 @@ declare namespace React {
         onBlur?: FocusEventHandler<T> | undefined;
         onBlurCapture?: FocusEventHandler<T> | undefined;
 
-        // Form Events
-        onChange?: FormEventHandler<T> | undefined;
-        onChangeCapture?: FormEventHandler<T> | undefined;
+        // form related Events
+        onChange?: ChangeEventHandler<T> | undefined;
+        onChangeCapture?: ChangeEventHandler<T> | undefined;
         onBeforeInput?: InputEventHandler<T> | undefined;
-        onBeforeInputCapture?: FormEventHandler<T> | undefined;
-        onInput?: FormEventHandler<T> | undefined;
-        onInputCapture?: FormEventHandler<T> | undefined;
-        onReset?: FormEventHandler<T> | undefined;
-        onResetCapture?: FormEventHandler<T> | undefined;
-        onSubmit?: FormEventHandler<T> | undefined;
-        onSubmitCapture?: FormEventHandler<T> | undefined;
-        onInvalid?: FormEventHandler<T> | undefined;
-        onInvalidCapture?: FormEventHandler<T> | undefined;
+        onBeforeInputCapture?: InputEventHandler<T> | undefined;
+        onInput?: InputEventHandler<T> | undefined;
+        onInputCapture?: InputEventHandler<T> | undefined;
+        onReset?: ReactEventHandler<T> | undefined;
+        onResetCapture?: ReactEventHandler<T> | undefined;
+        onSubmit?: SubmitEventHandler<T> | undefined;
+        onSubmitCapture?: SubmitEventHandler<T> | undefined;
+        onInvalid?: ReactEventHandler<T> | undefined;
+        onInvalidCapture?: ReactEventHandler<T> | undefined;
 
         // Image Events
         onLoad?: ReactEventHandler<T> | undefined;
@@ -2788,7 +2849,7 @@ declare namespace React {
 
         // Living Standard
         /**
-         * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert
+         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert}
          */
         inert?: boolean | undefined;
         /**
@@ -3251,7 +3312,9 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         width?: number | string | undefined;
 
-        onChange?: ChangeEventHandler<T> | undefined;
+        // No other element dispatching change events can be nested in a <input>
+        // so we know the target will be a HTMLInputElement.
+        onChange?: ChangeEventHandler<T, HTMLInputElement> | undefined;
     }
 
     interface KeygenHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3416,7 +3479,9 @@ declare namespace React {
         required?: boolean | undefined;
         size?: number | undefined;
         value?: string | readonly string[] | number | undefined;
-        onChange?: ChangeEventHandler<T> | undefined;
+        // No other element dispatching change events can be nested in a <select>
+        // so we know the target will be a HTMLSelectElement.
+        onChange?: ChangeEventHandler<T, HTMLSelectElement> | undefined;
     }
 
     interface SourceHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3468,7 +3533,9 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         wrap?: string | undefined;
 
-        onChange?: ChangeEventHandler<T> | undefined;
+        // No other element dispatching change events can be nested in a <textarea>
+        // so we know the target will be a HTMLTextAreaElement.
+        onChange?: ChangeEventHandler<T, HTMLTextAreaElement> | undefined;
     }
 
     interface TdHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3540,6 +3607,9 @@ declare namespace React {
         method?: string | undefined;
         min?: number | string | undefined;
         name?: string | undefined;
+        nonce?: string | undefined;
+        part?: string | undefined;
+        slot?: string | undefined;
         style?: CSSProperties | undefined;
         target?: string | undefined;
         type?: string | undefined;
@@ -4057,7 +4127,6 @@ declare namespace React {
          * Captures which component contained the exception, and its ancestors.
          */
         componentStack?: string | null;
-        digest?: string | null;
     }
 
     // Keep in sync with JSX namespace in ./jsx-runtime.d.ts and ./jsx-dev-runtime.d.ts