@stacksjs/skills 0.70.113 → 0.70.114

package/README.md

@@ -34,7 +34,7 @@ As a developer, Stacks helps you every step along the way—in beginner & expert
 
 Stacks runs on [Bun](https://bun.sh). You'll need:
 
-- **Bun ≥ 1.3.11** — install with `curl -fsSL https://bun.sh/install | bash`, or upgrade an existing install with `bun upgrade`.
+- **Bun ≥ 1.3.0** — install with `curl -fsSL https://bun.sh/install | bash`, or upgrade an existing install with `bun upgrade`.
 - **macOS, Linux, or WSL** — Windows-native is on the roadmap; today the toolchain assumes a POSIX shell.
 - **Node.js is NOT required.** Bun handles the JS/TS runtime, package management, and bundling.
 
@@ -45,7 +45,7 @@ That's it for the framework itself. Individual features (Postgres, Redis, AWS de
 The fastest path, assuming Bun is installed:
 
 ```bash
-bunx buddy new my-project
+bunx @stacksjs/buddy new my-project
 ```
 
 A one-line installer (`curl -Ssf stacksjs.com/install | sh`) is also planned and will appear here once it lands; for now the `bunx` form above is the supported install path.
@@ -74,18 +74,16 @@ buddy --help # view help menu
 # please note: you may suffix any command with the
 # `command --help` flag to review the help menu
 
+buddy new my-project # creates a new Stacks project
 buddy install # installs dependencies
 buddy add # adds a stack or dependency
-buddy fresh # fresh reinstall of all deps
-buddy clean # removes all deps
+buddy fresh # fresh reinstall of all deps (--force skips the confirmation)
+buddy clean # removes all deps (--force skips the confirmation)
 buddy setup # sets up the project initially
 buddy setup:oh-my-zsh # optional: sets up Oh My Zsh with auto-completions & "aliases"
 
-buddy upgrade # upgrades all dependencies
-buddy upgrade -i # prompts you to select which updates to apply (wip)
+buddy upgrade # upgrades the Stacks framework (alias: buddy update)
 buddy upgrade:dependencies # auto-upgrades package.json deps
-buddy upgrade:framework # auto-upgrades deps & the Stacks framework
-buddy upgrade:search-engine # auto-upgrades configured search engine
 buddy upgrade:shell # upgrades the shell integration
 buddy upgrade:binary # upgrades the `stacks` binary
 buddy upgrade:bun # upgrades to latest project-defined Bun version
@@ -94,48 +92,42 @@ buddy upgrade:all # auto-upgrades all of the above
 # if you need any more info on any command listed here, you may suffix
 # any of them via the "help option", i.e. `buddy ... --help`
 
-buddy dev # starts the frontend dev server
-buddy dev -i # prompts any of the dev servers (components, functions, views, docs, or api)
+buddy dev # starts the dev servers (frontend, api & docs)
+buddy dev -i # prompts you to select which dev server to start
 buddy dev:api # starts the API dev server
 buddy dev:dashboard # starts the Admin/Dashboard dev server
 buddy dev:desktop # starts the Desktop dev server
 buddy dev:views # starts frontend dev server
 buddy dev:components # starts component dev server
-buddy dev:functions # stubs functions
 buddy dev:docs # starts local docs dev server
-buddy dev docs # also starts the local docs dev server (colon is optional for all commands)
-buddy development # `buddy dev` alias
+buddy dev docs # also starts the local docs dev server (dev takes the server name as an argument)
 
 buddy share # creates a sharable link to your local project
 
-# for Laravel folks, `serve` may ring more familiar than the `dev` name. Hence, we aliased it
-buddy serve
-buddy serve:components
-buddy serve:desktop
-buddy serve:views
-buddy serve:functions
-buddy serve:docs
+# production servers (the same entries the deploy target runs as services)
+buddy serve # starts the production HTTP server (STX views + /api proxy)
+buddy serve:api # starts the production API server
 
 # building for production (e.g. AWS, Google Cloud, npm, Vercel, Netlify, et al.)
 buddy build # select a specific build (follow CLI prompts)
-buddy build:views # builds SSG views
+buddy build:frontend # builds the frontend (aliases: build:views, build:pages)
 buddy build:desktop # builds Desktop application
-buddy build:library # builds any or all libraries
 buddy build:functions # builds function library
 buddy build:components # builds Vue component library & Web Component library
 buddy build:web-components # builds framework agnostic Web Component library (i.e. Custom Elements)
-buddy build:all # builds all your code
-
-# `buddy build` aliases
-buddy prod
-buddy prod:components
-buddy prod:desktop
-buddy prod:library
-buddy prod:views
-buddy prod:functions
-buddy prod:web-components
-buddy prod:all
-buddy production # `buddy prod` alias
+buddy build:cli # builds the Buddy CLI binary
+buddy build:server # builds the Stacks cloud server (Docker image)
+buddy build:docs # builds the documentation site
+
+# `buddy build:*` aliases
+buddy prod:components # alias for build:components
+buddy prod:desktop # alias for build:desktop
+buddy prod:web-components # alias for build:web-components
+buddy prod:frontend # alias for build:frontend
+buddy prod:cli # alias for build:cli
+buddy prod:server # alias for build:server
+buddy prod:docs # alias for build:docs
+buddy prod:frontend-static # alias for build:frontend-static
 
 # sets your application key
 buddy key:generate
@@ -144,31 +136,28 @@ buddy make:component HelloWorld # bootstraps a HelloWorld component
 buddy make:function hello-world # bootstraps a hello-world function
 buddy make:view hello-world # bootstraps a hello-word page
 buddy make:model Car # bootstraps a Car model
-buddy make:database cars # creates a cars database
+buddy make:database cars # prints guidance: tables come from models + migrations, there is no separate create step
 buddy make:migration create_cars_table # creates a cars migration file
 buddy make:factory cars # creates a Car factory file
-buddy make:table cars # bootstraps a cars data table
 buddy make:notification welcome-email # bootstraps a welcome-email notification
 buddy make:lang de # bootstraps a lang/de.yml language file
-buddy make:stack my-project # shares logic with `bunx --bun stacks new my-project`
+buddy make:stack my-plugin # scaffolds a publishable stack/plugin (new project? use `bunx @stacksjs/buddy new`)
 
 buddy migrate # runs database migrations
+buddy migrate:fresh # drops all tables & re-runs migrations (destroys all data; --seed reseeds)
 buddy migrate:dns # sets the ./config/dns.ts file
+buddy seed # runs database seeders
 
 buddy dns example.com # list all DNS records for example.com
 buddy dns example.com --type MX # list MX records for example.com
 
-buddy https example.com/api/hello
-# http [flags] [METHOD] URL [ITEM [ITEM]]
-buddy http --help
-buddy http PUT example.com/api/put X-API-Token:123 name=John # Custom HTTP method, HTTP headers and JSON data
-buddy http -v example.com/api/get # See the request that is being sent using one of the output options
-buddy http POST example.com/api/post hello=World # submitting forms
-buddy http -a USERNAME POST https://api.github.com/repos/user/repo/issues/83/comments body='Great feature! :heart:'
-buddy http localhost:8000 Host:example.com
+buddy http example.com/api/hello # sends a GET request & prints the response
+buddy http -v example.com/api/get # same, with verbose output
 
 buddy lint # runs linter
 buddy lint:fix # runs linter and fixes issues
+buddy format # formats your project codebase
+buddy format:check # checks formatting without making changes
 
 buddy commit # follow CLI prompts for committing staged changes
 buddy release # creates the releases for the stack & triggers the Release Action (workflow)
@@ -176,21 +165,12 @@ buddy changelog # generates CHANGELOG.md
 
 # when deploying your app/s to a remote server or cloud provider
 buddy deploy # select a specific deployment (follow CLI prompts)
-# buddy deploy:docs # deploys docs to AWS (or other configured provider)
-# buddy deploy:functions # deploys functions to AWS (or other configured provider)
-# buddy deploy:views # deploys views to AWS (or other configured provider)
-# buddy deploy:all # deploys all your code
-buddy undeploy # be careful: "undeploys" removes/deletes your deployed resources
+buddy undeploy # be careful: "undeploys" removes/deletes your deployed resources (--yes skips the confirmation)
 
 buddy cloud:remove # removes cloud setup
 buddy cloud:cleanup # removes cloud setup & cleans up all potentially leftover resources
 buddy cloud:add --jump-box # adds a jump box to your cloud setup
 
-# select the example to run (follow CLI prompts)
-buddy example # prompts you to select which example to run
-buddy example:vue # runs the Vue example
-buddy example:web-components # runs the Web Component example
-
 # you likely won’t need to run these commands as they are auto-triggered, but they are available
 buddy generate  # prompts you to select which generator to run
 buddy generate:types # generates types for your components, functions, & views
@@ -199,7 +179,6 @@ buddy generate:web-types # generates Web Component types
 buddy generate:vscode-custom-data # generates VSCode custom data
 buddy generate:ide-helpers # generates IDE helpers
 buddy generate:component-meta # generates component meta
-buddy generate:all # runs all generators
 
 # generates your application key
 buddy key:generate # generates your application key
@@ -216,23 +195,31 @@ buddy env:rotate # rotate a keypair
 buddy types:generate # generates types for your components, functions, & views
 buddy types:fix # auto-fixes types for your components, functions, & views
 
-buddy domains # alias for `buddy domains:list`
 buddy domains:add stacksjs.com # adds a domain
 buddy domains:remove stacksjs.com # removes a domain
-buddy domains:list # lists all domains
-buddy domains:update # apply ./config/dns.ts updates
 buddy domains:purchase stacksjs.com # purchase a new domain
 
+# handy utilities
+buddy doctor # runs health checks on your Stacks installation
+buddy list # lists all available Buddy commands
+buddy route:list # lists your routes
+buddy ports # checks your project for port issues & misconfigurations
+buddy outdated # lists outdated project dependencies
+buddy env:check # checks your environment configuration & validates setup
+buddy tinker # interactive REPL with the Stacks framework preloaded
+buddy down # puts the app into maintenance mode
+buddy up # brings the app out of maintenance mode
+
 # test your stack
-buddy test # runs test suite (unit & e2e)
-buddy test:coverage # runs test coverage
+buddy test # runs your test suite
+buddy test:unit # runs unit tests
+buddy test:feature # runs feature tests
 buddy test:types # runs typecheck
 
-# the CLI may be triggered in any
-# of the following syntax
-stx fresh
-buddy fresh
-bud fresh
+# the published @stacksjs/buddy package ships
+# `buddy`, `bud`, & `stx` bins; inside this repo
+# the CLI is invoked as ./buddy
+./buddy fresh
 ```
 
 </details>

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/skills",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.113",
+  "version": "0.70.114",
   "description": "Agent skills for the Stacks framework, following the agentskills.io standard.",
   "author": "Chris Breuer",
   "contributors": [
@@ -54,11 +54,11 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/path": "0.70.113",
-    "@stacksjs/storage": "0.70.113"
+    "@stacksjs/path": "0.70.114",
+    "@stacksjs/storage": "0.70.114"
   },
   "devDependencies": {
-    "better-dx": "^0.2.16",
-    "@stacksjs/types": "0.70.113"
+    "better-dx": "catalog:",
+    "@stacksjs/types": "0.70.114"
   }
 }