what-framework-cli 0.5.3 → 0.5.4

package/README.md

@@ -0,0 +1,102 @@
+# what-framework-cli
+
+CLI for [What Framework](https://whatfw.com). Provides a zero-config dev server with HMR, production builds with content hashing and gzip, preview server, and static site generation.
+
+## Install
+
+```bash
+npm install what-framework-cli --save-dev
+```
+
+Or use directly:
+
+```bash
+npx what-framework-cli dev
+```
+
+## Commands
+
+### `what dev`
+
+Start a development server with hot module reloading via WebSocket.
+
+```bash
+what dev
+what dev --port 8080
+what dev --host 0.0.0.0
+```
+
+Features:
+- WebSocket-based HMR with automatic reconnection
+- Bare import transforms (`what` -> framework modules)
+- File-based routing from `src/pages/`
+- SPA fallback for client-side routing
+- Server action endpoint
+
+### `what build`
+
+Create a production build with minification, content hashing, and gzip compression.
+
+```bash
+what build
+```
+
+Output:
+- Minified JS and HTML
+- Content-hashed filenames for cache busting
+- Gzipped copies of all JS files
+- `manifest.json` mapping original filenames to hashed versions
+- Bundled framework runtime
+
+### `what preview`
+
+Preview a production build locally.
+
+```bash
+what preview
+what preview --port 4000
+```
+
+### `what generate`
+
+Static site generation. Runs a build, then pre-renders all pages.
+
+```bash
+what generate
+```
+
+### `what init`
+
+Create a new project (prefer `npx create-what` for the full scaffolding experience).
+
+```bash
+what init my-app
+```
+
+## Configuration
+
+Create a `what.config.js` in your project root:
+
+```js
+export default {
+  mode: 'hybrid',          // 'static' | 'server' | 'client' | 'hybrid'
+  pagesDir: 'src/pages',   // Pages directory for file-based routing
+  outDir: 'dist',          // Build output directory
+};
+```
+
+## Options
+
+| Flag | Description | Default |
+|---|---|---|
+| `--port` | Server port | `3000` (dev), `4000` (preview) |
+| `--host` | Server host | `localhost` |
+
+## Links
+
+- [Documentation](https://whatfw.com)
+- [GitHub](https://github.com/zvndev/what-fw)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "what-framework-cli",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "What Framework CLI - Dev server, build, and deployment tools",
   "type": "module",
   "bin": {
@@ -31,5 +31,5 @@
   "bugs": {
     "url": "https://github.com/zvndev/what-fw/issues"
   },
-  "homepage": "https://whatframework.dev"
+  "homepage": "https://whatfw.com"
 }

package/src/cli.js

@@ -278,12 +278,42 @@ async function dev() {
   // WebSocket server for HMR (zero dependencies)
   const wsClients = new Set();
 
+  // Auto-start MCP bridge if what-devtools-mcp is installed
+  let mcpProcess = null;
+  const noMcp = args.includes('--no-mcp');
+  if (!noMcp) {
+    try {
+      const { resolve: importResolve } = await import('node:module');
+      // Check if the package exists by trying to resolve it
+      const mcpBin = join(cwd, 'node_modules', '.bin', 'what-devtools-mcp');
+      const { existsSync: mcpExists } = await import('node:fs');
+      if (mcpExists(mcpBin)) {
+        const { spawn } = await import('node:child_process');
+        const mcpPort = getFlag('--mcp-port', 9229);
+        mcpProcess = spawn('node', [mcpBin], {
+          env: { ...process.env, WHAT_MCP_PORT: String(mcpPort) },
+          stdio: 'pipe',
+        });
+        mcpProcess.on('error', () => {}); // Silently ignore spawn errors
+        mcpProcess.on('exit', () => { mcpProcess = null; });
+        // Clean up on exit
+        process.on('exit', () => mcpProcess?.kill());
+        process.on('SIGINT', () => { mcpProcess?.kill(); process.exit(0); });
+      }
+    } catch {}
+  }
+
   server.listen(port, host, () => {
     console.log(`\n  what dev server\n`);
     console.log(`  Local:   http://${host}:${port}`);
     console.log(`  Mode:    ${config.mode || 'hybrid'}`);
     console.log(`  Pages:   ${config.pagesDir || 'src/pages'}`);
-    console.log(`  HMR:     WebSocket (instant reload)\n`);
+    console.log(`  HMR:     WebSocket (instant reload)`);
+    if (mcpProcess) {
+      const mcpPort = getFlag('--mcp-port', 9229);
+      console.log(`  MCP:     ws://localhost:${mcpPort} (AI debugging enabled)`);
+    }
+    console.log();
   });
 
   // Initialize WebSocket server