@bull-js/cli 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bull contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @bull-js/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Stubborn about architecture.** The CLI of [Bull](https://github.com/nicolasandradedesarrollosit/bull.js),
+the opinionated React framework that refuses to build unless you respect Model–View–ViewModel.
+Vite does the bundling; Bull checks the architecture before it runs.
+
+```bash
+npm create @bull-js@latest my-app
+cd my-app
+npm run dev
+```
+
+| Command | What it does |
+|---|---|
+| `bull dev` | Vite dev server with live architecture checks and a browser overlay |
+| `bull build` | Checks the architecture and, only if it holds, builds with Vite |
+| `bull preview` | Serves the production build |
+| `bull check` | Analysis only, great for CI (`--format json`) |
+| `bull explain <rule>` | Explains a rule with "don't / do" examples |
+| `bull create <name>` / `bull init` | New project, or add Bull to an existing one |
+| `bull generate` (`g`) | Scaffolds features, models, ViewModels and Views |
+| `bull fix` | Safe automatic fixes, with `--dry-run` |
+| `bull graph` | Import graph between layers (tree, Mermaid, DOT, HTML, JSON) |
+| `bull doctor` / `bull info` | Setup checklist and project summary |
+| `bull completion <shell>` | Shell completions for bash, zsh, fish and PowerShell |
+
+Configure it in `bull.config.ts`:
+
+```ts
+import { defineConfig } from "@bull-js/cli";
+
+export default defineConfig({
+  dev: { overlay: "blocking" },
+  vite: { server: { proxy: { "/api": "http://localhost:3000" } } },
+});
+```
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node