stonyx 0.2.3-alpha.4 → 0.2.3-alpha.6

package/README.md

@@ -5,19 +5,23 @@
 - 100% JavaScript (ES Modules)
 - Drop-in module system — no boilerplate
 - Automatic async module loading and initialization
-- Built-in CLI for bootstrapping and testing
+- Built-in CLI for scaffolding, bootstrapping, and testing
 
 ## Quick Start
 
 ```bash
-npm install stonyx
+npm install -g stonyx
+stonyx new my-app
+cd my-app
+stonyx serve
 ```
 
-The CLI handles everything — no manual `new Stonyx()` calls needed:
+The `new` command walks you through module selection and generates a ready-to-run project. From there, the CLI handles bootstrapping:
 
 ```bash
 stonyx serve    # Bootstrap + run app.js
 stonyx test     # Bootstrap + run tests
+stonyx help     # Show all available commands
 ```
 
 Stonyx reads `config/environment.js`, initializes all `@stonyx/*` modules from your `devDependencies`, and runs your application.
@@ -40,8 +44,12 @@ Stonyx reads `config/environment.js`, initializes all `@stonyx/*` modules from y
 | Module | Description |
 |--------|-------------|
 | [@stonyx/cron](https://github.com/abofs/stonyx-cron) | Lightweight async job scheduling |
-| [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
+| [@stonyx/discord](https://github.com/abofs/stonyx-discord) | Discord bot with command and event handler auto-discovery |
+| [@stonyx/events](https://github.com/abofs/stonyx-events) | Pub/sub event system |
+| [@stonyx/oauth](https://github.com/abofs/stonyx-oauth) | OAuth provider integration |
 | [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, and serializers |
+| [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
+| [@stonyx/sockets](https://github.com/abofs/stonyx-sockets) | WebSocket server and client |
 
 ## License
 

package/docs/cli.md

@@ -12,10 +12,20 @@ stonyx <command> [...args]
 
 | Command | Alias | Description |
 |---------|-------|-------------|
+| `new` | `n` | Scaffold a new Stonyx project |
 | `serve` | `s` | Bootstrap Stonyx and run the app |
 | `test` | `t` | Bootstrap Stonyx in test mode and run tests |
 | `help` | `h` | Show available commands |
 
+### new
+
+Scaffolds a new Stonyx project in the current directory. Prompts for a project name and which modules to include, then generates the project structure and runs `pnpm install`.
+
+```bash
+stonyx new              # Prompts for project name
+stonyx new my-app       # Creates my-app/ in the current directory
+```
+
 ### serve
 
 Bootstraps Stonyx (loads config, initializes modules, runs lifecycle hooks), then imports your application entry point.

package/docs/modules.md

@@ -72,7 +72,11 @@ await waitForModule('rest-server'); // Waits for @stonyx/rest-server
 | Module | Description |
 |--------|-------------|
 | [@stonyx/cron](https://github.com/abofs/stonyx-cron) | Lightweight async job scheduling with min-heap |
-| [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
+| [@stonyx/discord](https://github.com/abofs/stonyx-discord) | Discord bot with command and event handler auto-discovery |
+| [@stonyx/events](https://github.com/abofs/stonyx-events) | Pub/sub event system |
+| [@stonyx/oauth](https://github.com/abofs/stonyx-oauth) | OAuth provider integration |
 | [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, serializers, and optional REST integration |
+| [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
+| [@stonyx/sockets](https://github.com/abofs/stonyx-sockets) | WebSocket server and client |
 
 See each module's repository for its specific documentation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stonyx",
-  "version": "0.2.3-alpha.4",
+  "version": "0.2.3-alpha.6",
   "description": "Base stonyx framework module",
   "main": "main.js",
   "type": "module",
@@ -30,10 +30,10 @@
     "url": "https://github.com/abofs/stonyx/issues"
   },
   "dependencies": {
+    "@stonyx/utils": "0.2.3-beta.5",
     "node-chronicle": "^0.2.0"
   },
   "devDependencies": {
-    "@stonyx/utils": "0.2.3-beta.5",
     "qunit": "^2.24.1",
     "sinon": "^21.0.0"
   },

package/scripts/postinstall.js

@@ -1,4 +1,8 @@
-import { copyFile, createDirectory } from '@stonyx/utils/file';
+// Skip postinstall for global installations
+const isGlobal = !process.env.INIT_CWD || process.env.npm_config_global === 'true';
+if (isGlobal) process.exit(0);
+
+const { copyFile, createDirectory } = await import('@stonyx/utils/file');
 
 const projectDir = process.env.INIT_CWD;
 const configDir = `${projectDir}/config`;