kreftjs 0.0.3-beta → 0.0.5-beta

package/bin/kreftjs.js

@@ -2,15 +2,15 @@
 /*
  * The kreftjs command
  *
- *   kreftjs new my-app            create a new Kreft project
- *   kreftjs dev                   run the dev server in this folder (http://localhost:8000)
- *   kreftjs dev --port 3000       another port
- *   kreftjs dev ./site            another folder
- *   kreftjs build                 build this folder for production into ./dist
- *   kreftjs vscode                install colors and snippets for .kreftjs files in VS Code
- *   kreftjs serve dist            run the built app in production (with --db: its database API)
- *   kreftjs db migrate            run new database/migrations/*.sql   (also: seed, tables, sql "…")
- *   kreftjs help                  show this help
+ *   kreft new my-app            create a new Kreft project
+ *   kreft dev                   run the dev server in this folder (http://localhost:8000)
+ *   kreft dev --port 3000       another port
+ *   kreft dev ./site            another folder
+ *   kreft build                 build this folder for production into ./dist
+ *   kreft vscode                install colors and snippets for .kreftjs files in VS Code
+ *   kreft serve dist            run the built app in production (with --db: its database API)
+ *   kreft db migrate            run new database/migrations/*.sql   (also: seed, tables, sql "…")
+ *   kreft help                  show this help
  *
  * No dependencies — only Node.js.
  */
@@ -71,7 +71,7 @@ guard.checkStart(command);
 if (['queue:work', 'queue:start', 'schedule:work'].includes(command)) guard.watch([process.cwd()]);
 if (commands[command]) commands[command](rest);
 else if (command && !command.startsWith('-')) {
-  // your own commands: app/Console/Commands (kreftjs make:command SendReport)
+  // your own commands: app/Console/Commands (kreft make:command SendReport)
   require('./artisan-more.js').runCustom(command, rest).then((found) => { if (!found) unknown(); }, (e) => { console.error('  ' + (e.stack || e)); process.exitCode = 1; });
 } else unknown();
 
@@ -81,7 +81,7 @@ function help() {
   Kreft ${pkg.version}
 
   Usage:
-    kreftjs new <name>      Create a new project in a folder called <name>, with login, register,
+    kreft new <name>        Create a new project in a folder called <name>, with login, register,
                             password reset, email verification and profile pages (on SQLite)
         --db <kind>         …on another database (sqlite, mysql or postgres), plus a Todos example
         --no-auth           …without login, register, profile and users (--auth: with them, the default)
@@ -91,7 +91,7 @@ function help() {
         --js                …use JavaScript (default when non-interactive)
         --electron          …with Electron desktop app support (main.js, preload.js, packaging)
         --vite              …with Vite.js bundling & instant HMR (vite.config.js, npm run vite)
-    kreftjs dev [folder]    Start the dev server (default: this folder)
+    kreft dev [folder]      Start the dev server (default: this folder)
         --port <number>     Port to use (default: 8000, or the next free one)
         --host <address>    Who may open it (default: 127.0.0.1, only this computer; 0.0.0.0: your network)
         --api <file.json>   Serve a REST API from a JSON file at /api (GET, POST, PUT, PATCH, DELETE)
@@ -104,83 +104,83 @@ function help() {
         --server <dir>      Your own Node.js code for /api (default: server/): server/hello.js → /api/hello
         --db <database>     Serve the tables of a database at /api (new migrations run first):
                               sqlite:database/app.db   (built in, nothing to install)
-                              mysql://user:pass@localhost:3306/shop   (kreftjs add mysql2)
-                              postgres://user:pass@localhost:5432/shop  (kreftjs add pg)
-    kreftjs serve [folder]  Run a built app for real users (folder: dist). Same --port and --db;
+                              mysql://user:pass@localhost:3306/shop   (kreft add mysql2)
+                              postgres://user:pass@localhost:5432/shop  (kreft add pg)
+    kreft serve [folder]    Run a built app for real users (folder: dist). Same --port and --db;
                             only the tables listed in kreftjs.config.json are served
 
   Bundler & Dev Server (Vite.js):
-    kreftjs vite            Start Vite dev server and proxy backend API (alias: kreftjs vite:dev)
-    kreftjs vite:dev        Start Vite dev server with instant HMR and backend proxy
-    kreftjs vite:build      Build production bundle with Vite and Rollup
-    kreftjs vite:preview    Preview production build locally with Vite
-    kreftjs vite:init       Add Vite configuration to an existing project (alias: kreftjs make:vite)
+    kreft vite              Start Vite dev server and proxy backend API (alias: kreft vite:dev)
+    kreft vite:dev          Start Vite dev server with instant HMR and backend proxy
+    kreft vite:build        Build production bundle with Vite and Rollup
+    kreft vite:preview      Preview production build locally with Vite
+    kreft vite:init         Add Vite configuration to an existing project (alias: kreft make:vite)
 
   Desktop (Electron.js):
-    kreftjs electron        Start dev server and launch desktop window (alias: kreftjs electron:dev)
-    kreftjs electron:dev    Start dev server and launch desktop window
-    kreftjs electron:build  Build static bundle and package desktop app with electron-builder
-    kreftjs electron:init   Add Electron support to an existing project (alias: kreftjs make:electron)
-
-  The backend (kreftjs list shows every command, yours too):
-    kreftjs key:generate    Set the application encryption key in .env (--show: print only)
-    kreftjs migrate         Run new migrations in database/migrations (.js or .sql)
-    kreftjs migrate:rollback  Undo the last batch of migrations (--step 2: the last two)
-    kreftjs migrate:fresh   Drop every table and migrate again (--seed: then seed)
-    kreftjs migrate:status  Which migrations ran
-    kreftjs db:seed         Run database/seeders/DatabaseSeeder.js (--class PostSeeder: another one)
-    kreftjs route:list      The routes in routes/api.js
-    kreftjs storage:link    Connect public/storage to storage/app/public (--force) (alias: kreftjs link:storage)
-    kreftjs storage:unlink  Remove the storage link (alias: kreftjs unlink:storage)
-    kreftjs sitemap         Generate public/sitemap.xml and robots.txt
-    kreftjs log             Tail recent log entries from storage/logs/kreft.log (--lines 50, --level error)
-    kreftjs log:clear       Clear the log file
-    kreftjs make:model Post   app/Models/Post.js (-m -f -s -c -p -r, --route=file, --auth, --all)
-    kreftjs make:controller PostController (--api, --model Post, -r, --route=file, --auth)
-    kreftjs make:request StorePostRequest  app/Http/Requests/StorePostRequest.js (--model Post)
-    kreftjs make:resource PostResource   app/Http/Resources/PostResource.js
-    kreftjs make:rule Uppercase        app/Rules/Uppercase.js
-    kreftjs make:page Post  frontend/pages/Post.kreftjs (--model Post, -r, --route=file, --auth)
-    kreftjs make:factory PostFactory database/factories/PostFactory.js (--model Post)
-    kreftjs make:migration create_posts_table
-    kreftjs make:seeder PostSeeder
-    kreftjs make:middleware EnsureIsAdmin
-    kreftjs make:job SendWelcomeEmail  app/Jobs/SendWelcomeEmail.js
-    kreftjs make:event OrderShipped    app/Events/OrderShipped.js
-    kreftjs make:listener SendShipmentNotice app/Listeners/SendShipmentNotice.js (--event OrderShipped)
-    kreftjs make:mail WelcomeMail      app/Mail/WelcomeMail.js
-    kreftjs make:notification InvoicePaid  app/Notifications/InvoicePaid.js
-    kreftjs make:policy PostPolicy     app/Policies/PostPolicy.js (--model Post)
-    kreftjs make:observer PostObserver   app/Observers/PostObserver.js (--model Post)
-    kreftjs make:command SendReport    app/Console/Commands/SendReport.js (--command report:send)
-    kreftjs make:errors     The error pages in errors/ (401, 403, 404, 419, 429, 500, 503…)
-    kreftjs make:admin <email>  Let that user open the admin panel at /admin (--remove: take it away)
-    kreftjs make:routes admin   A new route file for pages: frontend/routes/admin.kreftjs (--api: backend/routes/admin.js)
-    kreftjs db tables       List tables and columns
-    kreftjs db sql "<SQL>"  Run one SQL statement and print the result
-    kreftjs build [folder]  Build for production (default: this folder)
+    kreft electron          Start dev server and launch desktop window (alias: kreft electron:dev)
+    kreft electron:dev      Start dev server and launch desktop window
+    kreft electron:build    Build static bundle and package desktop app with electron-builder
+    kreft electron:init     Add Electron support to an existing project (alias: kreft make:electron)
+
+  The backend (kreft list shows every command, yours too):
+    kreft key:generate      Set the application encryption key in .env (--show: print only)
+    kreft migrate           Run new migrations in database/migrations (.js or .sql)
+    kreft migrate:rollback    Undo the last batch of migrations (--step 2: the last two)
+    kreft migrate:fresh     Drop every table and migrate again (--seed: then seed)
+    kreft migrate:status    Which migrations ran
+    kreft db:seed           Run database/seeders/DatabaseSeeder.js (--class PostSeeder: another one)
+    kreft route:list        The routes in routes/api.js
+    kreft storage:link      Connect public/storage to storage/app/public (--force) (alias: kreft link:storage)
+    kreft storage:unlink    Remove the storage link (alias: kreft unlink:storage)
+    kreft sitemap           Generate public/sitemap.xml and robots.txt
+    kreft log               Tail recent log entries from storage/logs/kreft.log (--lines 50, --level error)
+    kreft log:clear         Clear the log file
+    kreft make:model Post     app/Models/Post.js (-m -f -s -c -p -r, --route=file, --auth, --all)
+    kreft make:controller PostController (--api, --model Post, -r, --route=file, --auth)
+    kreft make:request StorePostRequest    app/Http/Requests/StorePostRequest.js (--model Post)
+    kreft make:resource PostResource     app/Http/Resources/PostResource.js
+    kreft make:rule Uppercase          app/Rules/Uppercase.js
+    kreft make:page Post    frontend/pages/Post.kreftjs (--model Post, -r, --route=file, --auth)
+    kreft make:factory PostFactory database/factories/PostFactory.js (--model Post)
+    kreft make:migration create_posts_table
+    kreft make:seeder PostSeeder
+    kreft make:middleware EnsureIsAdmin
+    kreft make:job SendWelcomeEmail    app/Jobs/SendWelcomeEmail.js
+    kreft make:event OrderShipped      app/Events/OrderShipped.js
+    kreft make:listener SendShipmentNotice app/Listeners/SendShipmentNotice.js (--event OrderShipped)
+    kreft make:mail WelcomeMail        app/Mail/WelcomeMail.js
+    kreft make:notification InvoicePaid    app/Notifications/InvoicePaid.js
+    kreft make:policy PostPolicy       app/Policies/PostPolicy.js (--model Post)
+    kreft make:observer PostObserver     app/Observers/PostObserver.js (--model Post)
+    kreft make:command SendReport      app/Console/Commands/SendReport.js (--command report:send)
+    kreft make:errors       The error pages in errors/ (401, 403, 404, 419, 429, 500, 503…)
+    kreft make:admin <email>    Let that user open the admin panel at /admin (--remove: take it away)
+    kreft make:routes admin     A new route file for pages: frontend/routes/admin.kreftjs (--api: backend/routes/admin.js)
+    kreft db tables         List tables and columns
+    kreft db sql "<SQL>"    Run one SQL statement and print the result
+    kreft build [folder]    Build for production (default: this folder)
         --out <folder>      Where to write it (default: dist)
         --base <path>       Change the <base href> (for example /)
         --prerender [paths] Also save every page as ready HTML (needs: npm i -D jsdom)
         --include <folder>  Also copy this folder into the output (for example docs)
-    kreftjs add <packages...>   Install npm packages with strict security gatekeeper (alias: kreftjs install, kreftjs i)
+    kreft add <packages...>     Install npm packages with strict security gatekeeper (alias: kreft install, kreft i)
         -D, --dev           Install as devDependency
         -y, --yes           Auto-confirm unverified community packages in CI/CD
         --dry-run, --check  Inspect package security report without installing
         --allow-scripts     Permit postinstall lifecycle scripts (default: sandboxed with --ignore-scripts)
         --force             Bypass redundancy blocks, typosquat traps and security warnings
-    kreftjs update [packages]   Update project packages (npm update) and Kreft runtime files
+    kreft update [packages]     Update project packages (npm update) and Kreft runtime files
         --latest            Upgrade packages to their latest versions
         --check             Check for outdated packages (npm outdated)
         --core              Update only Kreft runtime files (kreftjs.js, kreftjs.d.ts, server.d.ts)
         --npm               Update only npm dependencies
-    kreftjs vscode          Install .kreftjs colors and snippets in VS Code (also Cursor, VSCodium)
+    kreft vscode            Install .kreftjs colors and snippets in VS Code (also Cursor, VSCodium)
 
   Examples:
-    kreftjs new shop
+    kreft new shop
     cd shop
     npm run dev
-    kreftjs update
+    kreft update
     npm run build
 `);
 }
@@ -191,7 +191,7 @@ function unknown() {
   process.exit(1);
 }
 
-/* ------------------------------------------------------------------ kreftjs new */
+/* ------------------------------------------------------------------ kreft new */
 async function createProject(args) {
   let name = null, dbKind = null, ui = null, ts = false, langChosen = false, electron = false, vite = false, redis = false, auth = true, authChosen = false;
   for (let i = 0; i < args.length; i++) {
@@ -217,7 +217,7 @@ async function createProject(args) {
     process.exit(1);
   }
   if (!name) {
-    console.error('  Give the project a name:  kreftjs new my-app  (or: kreftjs new my-app --ts)');
+    console.error('  Give the project a name:  kreft new my-app  (or: kreft new my-app --ts)');
     process.exit(1);
   }
   const target = path.resolve(name);
@@ -264,8 +264,8 @@ async function createProject(args) {
     version: '0.1.0',
     private: true,
     scripts: {
-      dev: 'kreftjs dev --seed', start: 'kreftjs dev --seed', build: 'kreftjs build', preview: 'kreftjs dev dist', serve: 'kreftjs serve dist',
-      migrate: 'kreftjs migrate', 'db:seed': 'kreftjs db:seed', 'migrate:fresh': 'kreftjs migrate:fresh --seed',
+      dev: 'kreft dev --seed', start: 'kreft dev --seed', build: 'kreft build', preview: 'kreft dev dist', serve: 'kreft serve dist',
+      migrate: 'kreft migrate', 'db:seed': 'kreft db:seed', 'migrate:fresh': 'kreft migrate:fresh --seed',
     },
   };
   // .env: the project's own settings (from .env.example, with its name filled in)
@@ -298,7 +298,7 @@ async function createProject(args) {
   Created ${name}/
 
   Next:
-    cd ${name}${ts ? '\n    npm install            (TypeScript, its Node.js types and esbuild)' : ''}${vite ? '\n    npm install            (install vite)\n    kreftjs vite:dev           (launch Vite dev server with instant HMR)' : ''}${electron ? '\n    npm install            (install electron & electron-builder)\n    kreftjs electron:dev       (launch desktop window)' : ''}${dbKind === 'mysql' ? '\n    kreftjs add mysql2         (the MySQL driver, verified & sandboxed)' : dbKind === 'postgres' ? '\n    kreftjs add pg             (the PostgreSQL driver, verified & sandboxed)' : ''}${dbKind && dbKind !== 'sqlite' ? '\n    (set DATABASE_URL in .env to your database)' : ''}
+    cd ${name}${ts ? '\n    npm install            (TypeScript, its Node.js types and esbuild)' : ''}${vite ? '\n    npm install            (install vite)\n    kreft vite:dev           (launch Vite dev server with instant HMR)' : ''}${electron ? '\n    npm install            (install electron & electron-builder)\n    kreft electron:dev       (launch desktop window)' : ''}${dbKind === 'mysql' ? '\n    kreft add mysql2         (the MySQL driver, verified & sandboxed)' : dbKind === 'postgres' ? '\n    kreft add pg             (the PostgreSQL driver, verified & sandboxed)' : ''}${dbKind && dbKind !== 'sqlite' ? '\n    (set DATABASE_URL in .env to your database)' : ''}
     npm run dev
 
 ${auth ? `  Then log in as test@example.com with the password "password", or register.
@@ -306,7 +306,7 @@ ${auth ? `  Then log in as test@example.com with the password "password", or reg
 ` : '  Created without authentication (--no-auth): there is no login, registration or users table.\n'}`);
 }
 
-// kreftjs new my-app --ts  →  TypeScript across backend (.ts) and frontend (.kreftjs, .ts), tsconfig.json, and npm run typecheck
+// kreft new my-app --ts  →  TypeScript across backend (.ts) and frontend (.kreftjs, .ts), tsconfig.json, and npm run typecheck
 function toTypeScript(target, projectPkg) {
   const { toTs, TSCONFIG } = require('./to-ts.js');
   const walk = (dir) => {
@@ -341,7 +341,7 @@ export interface ApiList<T> {
   // a typed helper for the frontend, used like any module: import { money } from '../logic/format.ts'
   fs.mkdirSync(path.join(target, 'frontend', 'logic'), { recursive: true });
   fs.writeFileSync(path.join(target, 'frontend', 'logic', 'format.ts'), `// A TypeScript module for the pages: import { money, ago } from '../logic/format.ts'
-// kreftjs dev turns it into JavaScript as it is sent; kreftjs build writes it as format.js
+// kreft dev turns it into JavaScript as it is sent; kreft build writes it as format.js
 
 export function money(amount: number, currency: string = 'USD'): string {
   return new Intl.NumberFormat('en', { style: 'currency', currency }).format(amount)
@@ -388,7 +388,7 @@ button { font-variant-numeric: tabular-nums; justify-self: start; }
   }
 }
 
-// kreftjs new my-app --ui bootstrap  →  the library's CDN links in index.html
+// kreft new my-app --ui bootstrap  →  the library's CDN links in index.html
 function uiKits() { return {
   tailwind: ['<!-- Tailwind CSS: use its classes in any .kreftjs file -->', '<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>'],
   bootstrap: ['<!-- Bootstrap: its classes and components (data-bs-toggle…) work in any .kreftjs file -->', '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css">', '<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js" defer></script>'],
@@ -411,14 +411,14 @@ function addUiKit(target, ui) {
   fs.writeFileSync(file, updated);
 }
 
-// kreftjs new my-app --db sqlite  →  database/migrations, a seed, kreftjs.config.json and a Todos page
+// kreft new my-app --db sqlite  →  database/migrations, a seed, kreftjs.config.json and a Todos page
 function addDatabase(target, kind, projectName) {
   const back = path.join(target, 'backend'), front = path.join(target, 'frontend');
   const file = (rel, text) => { fs.mkdirSync(path.dirname(path.join(back, rel)), { recursive: true }); fs.writeFileSync(path.join(back, rel), text); };
   const d = new Date(), p2 = (n) => String(n).padStart(2, '0');
   const stamp = `${d.getFullYear()}_${p2(d.getMonth() + 1)}_${p2(d.getDate())}_000001`;
   // A migration, a model, a controller, a seeder and a route
-  file(`database/migrations/${stamp}_create_todos_table.js`, `// kreftjs dev runs new migrations by itself (or: kreftjs migrate). kreftjs migrate:rollback runs down().
+  file(`database/migrations/${stamp}_create_todos_table.js`, `// kreft dev runs new migrations by itself (or: kreft migrate). kreft migrate:rollback runs down().
 module.exports = {
   up(schema) {
     schema.create('todos', (table) => {
@@ -484,7 +484,7 @@ module.exports = TodoController
   file('database/seeders/TodoSeeder.js', `const { Seeder } = require('kreftjs/server')
 const Todo = require('../../app/Models/Todo')
 
-// DatabaseSeeder calls this one (or on its own: kreftjs db:seed --class TodoSeeder)
+// DatabaseSeeder calls this one (or on its own: kreft db:seed --class TodoSeeder)
 class TodoSeeder extends Seeder {
   async run() {
     await Todo.create({ title: 'Learn Kreft', done: true })
@@ -579,7 +579,7 @@ function copyFolder(from, to) {
   }
 }
 
-/* ------------------------------------------------------------------ kreftjs vscode */
+/* ------------------------------------------------------------------ kreft vscode */
 function installVscode() {
   const os = require('os');
   const from = path.join(__dirname, '..', 'editors', 'vscode');
@@ -609,12 +609,12 @@ function installVscode() {
   console.log('\n  Restart VS Code (or run "Reload Window") to see updated colors and formatting in .kreftjs files.\n');
 }
 
-/* ------------------------------------------------------------------ kreftjs dev */
+/* ------------------------------------------------------------------ kreft dev */
 async function devServer(args, { production = false } = {}) {
   const isProd = Boolean(production || process.env.APP_ENV === 'production' || process.env.NODE_ENV === 'production');
   let port = production ? Number(process.env.PORT) || 8000 : 8000, folder = production ? 'dist' : '.', apiFile = null, delay = 0, saveApi = true, hot = !production, dbUrl = null, migrations = null, serverFolder = null, backendFolder = null, seedNew = false;
-  // kreftjs dev only answers this computer; --host 0.0.0.0 shares it on your network.
-  // kreftjs serve answers everyone (HOST in the environment can narrow it).
+  // kreft dev only answers this computer; --host 0.0.0.0 shares it on your network.
+  // kreft serve answers everyone (HOST in the environment can narrow it).
   let host = production ? process.env.HOST || '0.0.0.0' : '127.0.0.1';
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--port' || args[i] === '-p') port = Number(args[++i]) || port;
@@ -635,7 +635,7 @@ async function devServer(args, { production = false } = {}) {
   const lay = require('./layout.js').layout(folder === 'dist' || folder === '.' ? '.' : folder);
   const root = !production && folder === '.' ? lay.frontend : path.resolve(folder);
   if (production && !fs.existsSync(root)) {
-    console.error(`  Nothing to serve in ${root}. Build first: kreftjs build`);
+    console.error(`  Nothing to serve in ${root}. Build first: kreft build`);
     process.exit(1);
   }
   const mockApi = apiFile && !production ? createMockApi(path.resolve(apiFile), delay, saveApi) : null;
@@ -654,7 +654,7 @@ async function devServer(args, { production = false } = {}) {
   const hasBackend = Boolean(apiRoutesFile);
   // kreftjs serve: the backend must not sit inside the folder that is served, or its files could be downloaded
   if (production && hasBackend && (backendDir === root || backendDir.startsWith(root + path.sep))) {
-    console.error(`  The backend (${backendDir}) is inside the folder being served (${root}).\n  Serve the built site instead: kreftjs build, then kreftjs serve dist`);
+    console.error(`  The backend (${backendDir}) is inside the folder being served (${root}).\n  Serve the built site instead: kreft build, then kreft serve dist`);
     process.exit(1);
   }
   if (production && hasBackend && !process.env.APP_KEY) console.warn('  Warning: no APP_KEY in .env. Signed links (email verification) stop working on every restart.');
@@ -664,7 +664,7 @@ async function devServer(args, { production = false } = {}) {
     const { createDbApi } = require('./db-api.js');
     try {
       db = await connect(dbUrl, { root: config.dir });
-      if (!production) { // kreftjs dev runs new migrations by itself; for kreftjs serve, run `kreftjs migrate`
+      if (!production) { // kreft dev runs new migrations by itself; for kreft serve, run `kreft migrate`
         const { migrator, installAlias } = require('./backend/index.js');
         installAlias(); // require('kreftjs/server') and .ts files work in migrations and seeders
         require('./backend/model.js').setBaseDir(backendDir);
@@ -693,7 +693,7 @@ async function devServer(args, { production = false } = {}) {
     const n = backend.routes().length;
     backendRoutesCount = n;
     // queued jobs, mails and notifications run in the background here, and routes/console.js runs on schedule
-    // (QUEUE_WORKER=off or SCHEDULER=off in .env when a separate `kreftjs queue:work` / cron does it)
+    // (QUEUE_WORKER=off or SCHEDULER=off in .env when a separate `kreft queue:work` / cron does it)
     if (db) {
       const queue = require('./backend/queue.js');
       const queues = String(process.env.QUEUE_NAMES || 'high,default,low').split(',').map((x) => x.trim());
@@ -709,7 +709,7 @@ async function devServer(args, { production = false } = {}) {
       }
       if (process.env.SCHEDULER !== 'off') require('./backend/schedule.js').startScheduler(backendDir);
     }
-    backendNote = `\n  Routes:  ${path.relative(process.cwd(), apiRoutesFile) || 'routes/api.js'} → ${n} route${n === 1 ? '' : 's'} at /api  (kreftjs route:list)`;
+    backendNote = `\n  Routes:  ${path.relative(process.cwd(), apiRoutesFile) || 'routes/api.js'} → ${n} route${n === 1 ? '' : 's'} at /api  (kreft route:list)`;
   }
 
   // ----- your own server code: server/hello.js → /api/hello (any Node.js package can be used there)
@@ -726,7 +726,7 @@ async function devServer(args, { production = false } = {}) {
     console.error(`  --server: ${serverFolder} does not exist.`);
     process.exit(1);
   }
-  // npm packages in the browser (kreftjs dev only; kreftjs build puts them in dist/deps)
+  // npm packages in the browser (kreft dev only; kreft build puts them in dist/deps)
   const npmMap = () => (production ? null : deps.importMap(project));
 
   const types = {
@@ -739,7 +739,7 @@ async function devServer(args, { production = false } = {}) {
 
   const prodHeaders = isProd ? { 'Referrer-Policy': 'same-origin', 'X-Frame-Options': 'SAMEORIGIN', 'Strict-Transport-Security': 'max-age=31536000; includeSubDomains; preload' } : {};
   function send(res, file, opts = {}) { // opts.seo: tags for <head> (pages from seo.js), opts.status: 404 for a page that does not exist
-    // a TypeScript module for the browser: its JavaScript (kreftjs build writes it as .js)
+    // a TypeScript module for the browser: its JavaScript (kreft build writes it as .js)
     if (!production && /\.(m|c)?ts$/i.test(file) && !file.endsWith('.d.ts')) {
       const { transpileTs } = require('./backend/typescript.js');
       res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8', 'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff' });
@@ -759,7 +759,7 @@ async function devServer(args, { production = false } = {}) {
     });
     if (!production && type === 'text/html') {
       let html = fs.readFileSync(file, 'utf8');
-      // PUBLIC_ values from .env, as Kreftjs.env (kreftjs build puts them in app.js)
+      // PUBLIC_ values from .env, as Kreftjs.env (kreft build puts them in app.js)
       const envTag = `<script>${env.envScript(env.publicEnv())}</script>`;
       const langHelper = require('./lang.js');
       const langDirs = langHelper.findLangDirs(root);
@@ -899,7 +899,7 @@ async function devServer(args, { production = false } = {}) {
     if (cur.mtimeMs === prev.mtimeMs) return; // not a real change (the file may not exist at all)
     const before = process.env.DATABASE_URL;
     env.loadEnv(envDir);
-    console.log('  .env changed' + (process.env.DATABASE_URL !== before ? ' (restart kreftjs dev to use the new DATABASE_URL)' : ''));
+    console.log('  .env changed' + (process.env.DATABASE_URL !== before ? ' (restart kreft dev to use the new DATABASE_URL)' : ''));
     clients.forEach((c) => c.write(`data: ${JSON.stringify({ type: 'reload', path: '/.env' })}\n\n`));
   });
   // files a browser must never get: the database itself, its settings and password, hidden files, locks, dumps
@@ -914,7 +914,7 @@ async function devServer(args, { production = false } = {}) {
       try { seo = await require('./backend/seo-pages.js').resolve(backendDir, urlPath, req); } catch (e) { console.log('  routes/seo.js: ' + (e && e.message || e)); }
     }
     // a crawler or link preview gets the page already drawn (and a 404 when the app shows its 404 page)
-    if (ssr.wants(req) && (!seo || seo.status === 200) && !fs.readFileSync(file, 'utf8').includes('data-kreft-ssg')) { // a page kreftjs build --prerender already drew is sent as it is
+    if (ssr.wants(req) && (!seo || seo.status === 200) && !fs.readFileSync(file, 'utf8').includes('data-kreft-ssg')) { // a page kreft build --prerender already drew is sent as it is
       const page = await ssr.render(urlPath, search);
       if (page) {
         res.writeHead(page.status, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': isProd ? 'no-cache' : 'no-store', 'Vary': 'User-Agent', 'X-Content-Type-Options': 'nosniff', ...prodHeaders });
@@ -960,7 +960,7 @@ async function devServer(args, { production = false } = {}) {
     }
     if (urlPath.startsWith('/__kreft/npm/')) {
       const file = deps.packageFile(project, urlPath.slice('/__kreft/npm/'.length));
-      if (!file) { res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' }); return res.end('Not in node_modules: ' + urlPath.slice(11) + '  (kreftjs add ' + (urlPath.slice(11).match(deps.NAME) || [''])[0] + ')'); }
+      if (!file) { res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' }); return res.end('Not in node_modules: ' + urlPath.slice(11) + '  (kreft add ' + (urlPath.slice(11).match(deps.NAME) || [''])[0] + ')'); }
       return send(res, file);
     }
     const spec = urlPath.slice('/__kreft/deps/'.length).replace(/\/$/, '');
@@ -973,7 +973,7 @@ async function devServer(args, { production = false } = {}) {
   const privateDirs = [serverDir, ...(hasBackend ? ['app', 'routes', 'database', 'config', 'storage'].map((d) => path.join(backendDir, d)) : []), path.join(root, 'config')];
   const insideServerDir = (file) => privateDirs.some((d) => file === d || file.startsWith(d + path.sep));
 
-  // kreftjs down: storage/framework/down.json → a 503 for everyone, except with the secret (kreftjs down --secret=…)
+  // kreftjs down: storage/framework/down.json → a 503 for everyone, except with the secret (kreft down --secret=…)
   const downPath = path.join(backendDir, 'storage', 'framework', 'down.json');
   let downCache = { at: 0, data: null };
   const downInfo = () => {
@@ -1013,7 +1013,7 @@ async function devServer(args, { production = false } = {}) {
   }
 
   // DNS rebinding: a web page can make its own name (evil.example) point at 127.0.0.1 and then read everything
-  // kreftjs dev serves, with the browser believing it is the same site. A server that only answers this computer
+  // kreft dev serves, with the browser believing it is the same site. A server that only answers this computer
   // therefore only answers the names of this computer (add more with KREFT_ALLOWED_HOSTS=my-tunnel.example).
   const hostOnly = (h) => String(h || '').toLowerCase().replace(/:\d+$/, '').replace(/^\[|\]$/g, '');
   const isLocalName = (n) => n === 'localhost' || n === '127.0.0.1' || n === '::1' || n.endsWith('.localhost');
@@ -1097,7 +1097,7 @@ async function devServer(args, { production = false } = {}) {
       }
       if (hot && urlPath.startsWith('/__kreft/')) return devFiles(req, res, urlPath);
       if (adminDir && (urlPath === '/admin' || urlPath.startsWith('/admin/'))) return adminFiles(req, res, urlPath);
-      // /storage/…: files on the public disk (backend/storage/app/public), connected by kreftjs storage:link.
+      // /storage/…: files on the public disk (backend/storage/app/public), connected by kreft storage:link.
       // They are sent as downloads of plain data: an uploaded .html or .svg can't run scripts on your site.
       if (urlPath.startsWith('/storage/')) {
         const pub = path.join(backendDir, 'storage', 'app', 'public');
@@ -1185,7 +1185,7 @@ async function devServer(args, { production = false } = {}) {
 
 /* ------------------------------------------------------------------ settings: kreftjs.config.json
  * { "db": "sqlite:database/app.db", "tables": { "posts": true, "users": { "write": false, "hidden": ["password"] } } }
- * Looked for in the folder being served, then its parents (so `kreftjs serve dist` finds the project's file).
+ * Looked for in the folder being served, then its parents (so `kreft serve dist` finds the project's file).
  * DATABASE_URL in the environment wins over "db" — put real passwords there, not in the file.
  */
 function readConfig(start) { return require('./kreftjs-config.js').readConfig(start); }
@@ -1195,7 +1195,7 @@ function migrationsDir(...dirs) {
 }
 const describeDb = (url) => url.replace(/\/\/([^:@/]+):[^@/]*@/, '//$1:•••@');
 
-/* ------------------------------------------------------------------ kreftjs db */
+/* ------------------------------------------------------------------ kreft db */
 async function dbCommand(args) {
   const [sub = 'help', ...rest] = args;
   let dbUrl = null, folder = '.', migrations = null;
@@ -1211,10 +1211,10 @@ async function dbCommand(args) {
   dbUrl = dbUrl || process.env.DATABASE_URL || config.db;
   if (sub === 'help' || !['migrate', 'seed', 'tables', 'sql'].includes(sub)) {
     console.log(`
-  kreftjs db migrate          The same as kreftjs migrate
-  kreftjs db seed             The same as kreftjs db:seed
-  kreftjs db tables           List tables and columns
-  kreftjs db sql "<SQL>"      Run one statement and print the result
+  kreft db migrate          The same as kreft migrate
+  kreft db seed             The same as kreft db:seed
+  kreft db tables           List tables and columns
+  kreft db sql "<SQL>"      Run one statement and print the result
 
   The database comes from --db, DATABASE_URL or "db" in kreftjs.config.json.
 `);
@@ -1225,7 +1225,7 @@ async function dbCommand(args) {
   let db;
   try {
     db = await connect(dbUrl, { root: config.dir });
-    if (sub === 'migrate' || sub === 'seed') { // the same as kreftjs migrate and kreftjs db:seed
+    if (sub === 'migrate' || sub === 'seed') { // the same as kreft migrate and kreft db:seed
       await db.close(); db = null;
       return require('./artisan.js').commands[sub === 'migrate' ? 'migrate' : 'db:seed'](rest);
     } else if (sub === 'tables') {
@@ -1236,7 +1236,7 @@ async function dbCommand(args) {
       console.log('');
     } else if (sub === 'sql') {
       const sql = extra.join(' ');
-      if (!sql.trim()) { console.error('  kreftjs db sql "SELECT * FROM posts"'); process.exit(1); }
+      if (!sql.trim()) { console.error('  kreft db sql "SELECT * FROM posts"'); process.exit(1); }
       if (/^\s*(select|with|pragma|show|describe|explain)\b/i.test(sql)) console.table(await db.query(sql));
       else { const r = await db.run(sql); console.log(`  Done: ${r.changes} row${r.changes === 1 ? '' : 's'} changed.`); }
     }
@@ -1248,7 +1248,7 @@ async function dbCommand(args) {
   }
 }
 
-/* ------------------------------------------------------------------ kreftjs dev --api db.json
+/* ------------------------------------------------------------------ kreft dev --api db.json
  * A small REST API for trying things out, made from a JSON file:
  *   { "posts": [ { "id": 1, "title": "Hello" } ], "$required": { "posts": ["title"] } }
  *

package/bin/layout.js

@@ -1,7 +1,7 @@
 /*
  * Where a project's parts are.
  *
- * New projects (kreftjs new) keep frontend and backend apart:
+ * New projects (kreft new) keep frontend and backend apart:
  *   frontend/   the only folder a browser can reach: index.html, pages, components, routes/web.kreftjs …
  *   backend/    never served: routes/api.js, app/, database/ (and server/)
  *   .env, package.json, node_modules/   at the top, next to both

package/bin/no-auth.js

@@ -1,5 +1,5 @@
 /*
- * kreftjs new my-app --no-auth
+ * kreft new my-app --no-auth
  *
  * A new app comes with login, registration, password reset, email verification, a profile and an admin area. This takes
  * all of that out again, so the app starts as a plain site: the welcome page, the docs, the error monitor and the tests
@@ -24,7 +24,7 @@ const TO_REMOVE = [
 
 const API = (todos) => `// Your API: every address here starts with /api.
 // All API routes live directly in this file. Add your new routes here!
-// See them all anytime with: kreftjs route:list
+// See them all anytime with: kreft route:list
 const { Route } = require('kreftjs/server')
 ${todos ? `const TodoController = require('../app/Http/Controllers/TodoController')
 
@@ -50,7 +50,7 @@ module.exports = AppServiceProvider
 
 const SEEDER = (todos) => `const { Seeder } = require('kreftjs/server')
 
-// kreftjs db:seed  (kreftjs dev --seed fills a new database)
+// kreft db:seed  (kreft dev --seed fills a new database)
 class DatabaseSeeder extends Seeder {
   async run() {
 ${todos ? "    await this.call(require('./TodoSeeder'))\n" : ''}  }
@@ -134,7 +134,7 @@ function removeAuth(target) {
   const to = html.indexOf("    Kreftjs.app('App.kreftjs')");
   if (from >= 0 && to > from) {
     html = html.slice(0, from) + `    const router = Kreftjs.router({
-      routes: ['routes/web.kreftjs'], // the pages are in routes/web.kreftjs; add more files: kreftjs make:routes admin
+      routes: ['routes/web.kreftjs'], // the pages are in routes/web.kreftjs; add more files: kreft make:routes admin
       layout: 'app',              // every page goes inside layouts/app.kreftjs…
       errors: 'errors',           // error pages: errors/404.kreftjs for unknown addresses, abort(403) → errors/403.kreftjs
     })

package/bin/prerender.js

@@ -1,8 +1,8 @@
 /*
- * kreftjs build --prerender — saves every page of the router as ready HTML (static site generation).
+ * kreft build --prerender — saves every page of the router as ready HTML (static site generation).
  *
- *   kreftjs build --prerender                    every route without :params
- *   kreftjs build --prerender /users/1,/users/2  also these addresses
+ *   kreft build --prerender                    every route without :params
+ *   kreft build --prerender /users/1,/users/2  also these addresses
  *
  * Each page opens in a simulated browser (jsdom), waits until its data has loaded, and the result
  * is written to dist/<path>/index.html. Visitors and search engines get the content at once;
@@ -176,7 +176,7 @@ module.exports = async function prerender(dist, root, extra) {
   try {
     jsdom = loadJsdom(root);
   } catch (_) {
-    throw new Error('it needs jsdom. Install it once in your project:\n\n    kreftjs add -D jsdom\n');
+    throw new Error('it needs jsdom. Install it once in your project:\n\n    kreft add -D jsdom\n');
   }
   const { JSDOM } = jsdom;
   if (typeof fetch !== 'function') throw new Error('it needs Node.js 18 or newer.');

package/bin/server-routes.js

@@ -17,7 +17,7 @@
  * Export get, post, put, patch and del (delete is a reserved word), or one `handle` for every method.
  * What you return goes back as JSON (nothing → 204). ctx.fail(status, message or { field: [...] })
  * stops with an error. ctx.res is Node's response, if you need it (stream, a file, a redirect).
- * kreftjs dev picks up changes to these files by itself.
+ * kreft dev picks up changes to these files by itself.
  */
 const fs = require('fs');
 const path = require('path');
@@ -62,7 +62,7 @@ function createServerRoutes(dir, { db = null, production = false, prefix = '/api
     return out.sort((a, b) => a.dynamic - b.dynamic); // /users/me before /users/[id]
   };
   const list = () => {
-    // kreftjs dev looks for new files twice a second at most; kreftjs serve reads the folder once
+    // kreft dev looks for new files twice a second at most; kreft serve reads the folder once
     if (!scannedAt || (!production && Date.now() - scannedAt > 500)) { routes = scan(); scannedAt = Date.now(); }
     return routes;
   };

package/bin/ssr.js

@@ -2,7 +2,7 @@
  * Whole pages for crawlers and link previews: the server answers them with the page already drawn.
  *
  * A search engine or a chat app that does not run JavaScript would see an empty <div id="app">. For those
- * visitors the server opens the page in a simulated browser (the same one `kreftjs build --prerender` uses),
+ * visitors the server opens the page in a simulated browser (the same one `kreft build --prerender` uses),
  * waits until its data has loaded, and answers with the result. Everyone else gets the normal page.
  *
  *   KREFT_SSR=bots   (default) crawlers and link-preview bots only
@@ -45,7 +45,7 @@ function create({ root, origin, log = () => { }, cached = true }) {
     if (jsdom || unavailable) return jsdom;
     try { jsdom = require('./prerender.js').loadJsdom(root); } catch (_) {
       unavailable = true;
-      if (mode !== 'off') log('  SSR for crawlers needs jsdom: kreftjs add -D jsdom (crawlers get the normal page until then)');
+      if (mode !== 'off') log('  SSR for crawlers needs jsdom: kreft add -D jsdom (crawlers get the normal page until then)');
     }
     return jsdom;
   }

package/bin/terminal.js

@@ -167,7 +167,7 @@ function renderDevBanner({
     lines.push(`  ${c.dim('•')} ${c.bold('Database:')} ${c.green(database)}`);
   }
   if (routesCount > 0) {
-    lines.push(`  ${c.dim('•')} ${c.bold('API:')}      ${c.cyan(routesCount + ' routes')} ${c.dim('(kreftjs route:list)')}`);
+    lines.push(`  ${c.dim('•')} ${c.bold('API:')}      ${c.cyan(routesCount + ' routes')} ${c.dim('(kreft route:list)')}`);
   }
   if (serverRoutesCount > 0) {
     lines.push(`  ${c.dim('•')} ${c.bold('Server:')}   ${c.cyan(serverRoutesCount + ' custom endpoints')}`);

package/bin/to-ts.js

@@ -1,4 +1,4 @@
-// JavaScript backend files → TypeScript (kreftjs new --ts, and kreftjs make:* in a TypeScript project):
+// JavaScript backend files → TypeScript (kreft new --ts, and kreftjs make:* in a TypeScript project):
 // require → import, module.exports → export default. Inline require('./X') stays (it works at run time).
 function toTs(code) {
   return code