kreftjs 0.0.3-beta → 0.0.4-beta

package/README.md

@@ -22,8 +22,8 @@ action add() { count++ }
 You need [Node.js](https://nodejs.org) 22.5 or newer.
 
 ```bash
-npm i -g kreftjs          # once: makes the `kreftjs` command available everywhere
-kreftjs new my-app        # asks: JavaScript or TypeScript?
+npm i -g kreftjs          # once: makes the `kreft` command available everywhere
+kreft new my-app        # asks: JavaScript or TypeScript?
 cd my-app
 npm run dev
 ```
@@ -38,7 +38,7 @@ Open the address in the terminal (normally `http://localhost:8000`). A new proje
 | **Router** | Nested routes, layouts, guards, error pages, clean URLs. |
 | **Backend** | `Route`, controllers, form requests, policies, models with relations, soft deletes and scopes, migrations, seeders, factories, jobs, mail, notifications, cache, Redis, file storage, scheduling. |
 | **Authentication** | Cookie sessions with CSRF protection, API tokens with permissions, device list, two-factor codes, email verification, account lockout. |
-| **Tooling** | `kreftjs dev` with hot reload, DevTools, an error monitor, `kreftjs build` (CSP-safe), prerendering, TypeScript, Vite and Electron support, a safer `kreftjs add`, an MCP server for AI agents. |
+| **Tooling** | `kreft dev` with hot reload, DevTools, an error monitor, `kreft build` (CSP-safe), prerendering, TypeScript, Vite and Electron support, a safer `kreft add`, an MCP server for AI agents. |
 
 ## Learn more
 
@@ -49,7 +49,7 @@ Open the address in the terminal (normally `http://localhost:8000`). A new proje
 | Add an API and a database | [Routing](docs/README.md#routing), [Models](docs/README.md#models-and-the-database), [Migrations](docs/README.md#migrations-seeders-and-factories) |
 | Understand sign-in | [Authentication](docs/README.md#authentication) |
 | Go to production | [Build and deploy](docs/README.md#build-and-deploy), [Production checklist](docs/README.md#production-checklist) |
-| Look up a command | [Command line](docs/README.md#command-line), then `kreftjs list` |
+| Look up a command | [Command line](docs/README.md#command-line), then `kreft list` |
 
 ## The demo
 
@@ -60,9 +60,9 @@ In this repository, `npm run dev` serves live examples of every feature at **htt
 ```text
 kreftjs.js, kreftjs.d.ts  the browser runtime and its TypeScript types
 server.js, server.d.ts    the backend entry point: require('kreftjs/server')
-bin/                      the `kreftjs` command and the backend modules (bin/backend/)
+bin/                      the `kreft` command and the backend modules (bin/backend/)
 tools/                    hot reload client, DevTools, Vite plugin
-templates/app/            the project that `kreftjs new` creates
+templates/app/            the project that `kreft new` creates
 editors/vscode/           syntax colours and snippets for .kreftjs files
 demo/                     the interactive demo
 docs/                     the manual (README.md) and its viewer (Docs.kreftjs)
@@ -71,23 +71,23 @@ test/                     security regression tests: npm test
 
 ## Security
 
-Views are escaped, logins use HttpOnly cookies with CSRF protection, passwords use scrypt, and `kreftjs dev` only answers your own computer. The manual has a [Security overview](docs/README.md#security-overview) and a [Production checklist](docs/README.md#production-checklist). Run `npm test` to run the security regression tests.
+Views are escaped, logins use HttpOnly cookies with CSRF protection, passwords use scrypt, and `kreft dev` only answers your own computer. The manual has a [Security overview](docs/README.md#security-overview) and a [Production checklist](docs/README.md#production-checklist). Run `npm test` to run the security regression tests.
 
 ## Migrating from Som.js
 
-Kreft is Som.js under a new name: the package is `kreftjs` (version 0.0.3-beta), the command is `kreftjs`, the global is `Kreftjs` and component files end in `.kreftjs`. The old names keep working, so an existing project runs without edits. New files and everything the tools write use the new names. Move over when it suits you. (`kreft` was an earlier spelling of the new name; it is accepted in the same places.)
+Kreft is Som.js under a new name: the package is `kreftjs` (version 0.0.4-beta), the command is `kreft` (`kreftjs` works too), the global is `Kreftjs` and component files end in `.kreftjs`. The old names keep working, so an existing project runs without edits. New files and everything the tools write use the new names. Move over when it suits you. (`kreft` was an earlier spelling of the new name; it is accepted in the same places.)
 
 | Som.js | Kreft | Still works? |
 |---|---|---|
-| `npm i -g somjs` | `npm i -g kreftjs` | `kreft` is another name for `kreftjs`. Kreft does not install a `som` command, so it does not clash with an old Som.js (remove that with `npm rm -g somjs`). |
-| `som dev`, `som build`, `som make:page` … | `kreftjs dev`, `kreftjs build`, `kreftjs make:page` … | Replace `som` with `kreftjs`. |
+| `npm i -g somjs` | `npm i -g kreftjs` | `kreftjs` is another name for `kreft`. Kreft does not install a `som` command, so it does not clash with an old Som.js (remove that with `npm rm -g somjs`). |
+| `som dev`, `som build`, `som make:page` … | `kreft dev`, `kreft build`, `kreft make:page` … | Replace `som` with `kreftjs`. |
 | `Counter.som` (and `Counter.kreft`) | `Counter.kreftjs` | Yes. All three extensions compile; a name that is missing with one extension is tried with the others (`layouts/app.kreftjs` finds `layouts/app.som`). |
 | `s-if`, `s-each`, `s-model` … (every `s-` directive) | `k-if`, `k-each`, `k-model` … | Yes. Both prefixes are read in templates. |
 | `<som-view>`, `<som-link>`, `<som-wait>`, `<som-component>`, `<som-yield>`, `<som-section>`, `<som-portal>` | `<kreft-view>`, `<kreft-link>` … | Yes. Both tag names work. |
 | `Som` (global object) | `Kreftjs` | `Som` and `Kreft` point to the same object. `Som` is deprecated. |
 | `Som.compileSom(source)` | `Kreftjs.compile(source)` | `compileSom` is kept as an alias. |
 | `window.somDesktop` | `window.kreftDesktop` | Same object under both names. |
-| `som.js`, `som.d.ts` in your project | `kreftjs.js`, `kreftjs.d.ts` | An existing `som.js` (or `kreft.js`) keeps working; `kreftjs update` rewrites it in place with the new runtime. |
+| `som.js`, `som.d.ts` in your project | `kreftjs.js`, `kreftjs.d.ts` | An existing `som.js` (or `kreft.js`) keeps working; `kreft update` rewrites it in place with the new runtime. |
 | `som.config.json`, `config/som.json` | `kreftjs.config.json`, `config/kreftjs.json` | Yes: `kreft.config.json` and `som.config.json` are read too (the new name wins). |
 | `require('somjs/server')` | `require('kreftjs/server')` | Also accepted: `kreft/server`, `@kreft/server`, `somjs/server`, `som/server`, `@somjs/server`. |
 | `som_session`, `som_2fa`, `som_bypass` cookies | `kreft_session`, `kreft_2fa`, `kreft_bypass` | `app/Auth/Session.js` belongs to your project, so an existing project keeps its `som_` names until you edit that file. The framework's CSRF check and the maintenance-mode bypass accept both. New projects use the new names. |
@@ -95,7 +95,7 @@ Kreft is Som.js under a new name: the package is `kreftjs` (version 0.0.3-beta),
 | `window.__SOM_ENV__`, `__SOM_DEV__`, `__SOM_LANG__`, `__SOM_VITE__` | `__KREFT_ENV__` … | Read by the runtime under both names. |
 | `/__som/…` dev-server addresses | `/__kreft/…` | The dev server answers both. |
 | Vite: `import som from 'somjs/vite'` | `import kreftjs from 'kreftjs/vite'` | The plugin also exports `kreft`, `som` and `somPlugin`, and handles `.kreft` and `.som` files. |
-| VS Code extension `.som` language | `.kreftjs` language | The new extension colours `.kreft` and `.som` files as well. Run `kreftjs vscode` to install it. |
+| VS Code extension `.som` language | `.kreftjs` language | The new extension colours `.kreft` and `.som` files as well. Run `kreft vscode` to install it. |
 
 Kept on purpose, with a TODO for 3.1: the `som_migrations` table (renaming it would lose the migration history of every deployed database), the `som:` prefix of `saved`/`Kreftjs.storage` keys in `localStorage`, and the `som:queue:` / `som:delayed:` Redis keys of the queue. Renaming them needs a migration with a fallback read, so it waits for a minor release.
 

package/bin/add.js

@@ -1,5 +1,5 @@
 /*
- * kreftjs add <packages...>  /  kreftjs install <packages...>
+ * kreft add <packages...>  /  kreft install <packages...>
  *
  * Enterprise-Grade Security Gatekeeper & Package Installer for Kreft:
  *
@@ -63,7 +63,7 @@ const BUILTIN_ALTERNATIVES = {
   dotenv: 'Kreft automatically parses .env into process.env & Kreftjs.env natively out of the box.',
   'body-parser': 'Kreft natively parses JSON, form-data, and raw payloads in request.js.',
   cors: 'Kreft routes and dev server include built-in CORS origin and preflight validation.',
-  nodemon: 'Kreft includes built-in file watching, hot reloading, and dev tools (kreftjs dev).',
+  nodemon: 'Kreft includes built-in file watching, hot reloading, and dev tools (kreft dev).',
   sqlite3: 'Kreft includes a native zero-dependency SQLite driver (built-in). Use better-sqlite3 only if you need C-bindings.',
   'cookie-parser': 'Kreft natively parses, signs, and sets cookies on request/response objects.',
   multer: 'Kreft natively handles multipart file uploads via request.file() and request.files().',
@@ -889,7 +889,7 @@ function displayPackageInfoCards(projectDir, evaluationReports, auditData) {
         type: 'update',
         icon: yellow('🔔 Update Available:'),
         message: `Version v${latestVersion} is out! (Installed: v${installedVersion})`,
-        action: `Run "kreftjs update ${name}" to upgrade to the latest version.`,
+        action: `Run "kreft update ${name}" to upgrade to the latest version.`,
       });
     } else {
       notifications.push({
@@ -1029,18 +1029,18 @@ function runSecurityAudit(npmCmd, project, auditData) {
 
 function printHelp() {
   console.log(`
-  ${bold('kreftjs add <packages...>') }  (alias: ${dim('kreftjs install')}, ${dim('kreftjs i')})
+  ${bold('kreft add <packages...>') }  (alias: ${dim('kreft install')}, ${dim('kreft i')})
 
   Enterprise-Grade Security Gatekeeper & Package Installer for Kreft.
 
   Usage:
-    kreftjs add <packages...>           Install package(s) with full security gatekeeper verification
-    kreftjs add pg mysql2               Install verified database drivers
-    kreftjs add -D vitest               Install as devDependency
-    kreftjs add --check <pkg>           Inspect package security report without installing (alias: --dry-run)
-    kreftjs add -y <pkg>                Auto-confirm unverified packages in CI/CD (alias: --yes)
-    kreftjs add --allow-scripts <pkg>   Allow lifecycle scripts (postinstall/build)
-    kreftjs add --force <pkg>           Bypass security warnings & redundancy checks
+    kreft add <packages...>           Install package(s) with full security gatekeeper verification
+    kreft add pg mysql2               Install verified database drivers
+    kreft add -D vitest               Install as devDependency
+    kreft add --check <pkg>           Inspect package security report without installing (alias: --dry-run)
+    kreft add -y <pkg>                Auto-confirm unverified packages in CI/CD (alias: --yes)
+    kreft add --allow-scripts <pkg>   Allow lifecycle scripts (postinstall/build)
+    kreft add --force <pkg>           Bypass security warnings & redundancy checks
 
   Security Protections & Verification Rules:
     1. Zero-Dependency Redundancy Guard:

package/bin/artisan-more.js

@@ -1,23 +1,23 @@
 /*
  * Full-stack CLI commands:
  *
- *   kreftjs list                         every command (yours too)
- *   kreftjs about                        versions, settings, folders
- *   kreftjs tinker                       a console with your models, DB, Cache… (await works)
- *   kreftjs key:generate                 a new APP_KEY in .env
- *   kreftjs down [--secret=x] / kreftjs up   maintenance mode
- *   kreftjs db:wipe                      drop every table
- *   kreftjs migrate:refresh [--seed]     undo every migration, then run them again
- *   kreftjs migrate:reset                undo every migration
- *   kreftjs queue:work [--queue=a,b] [--once] [--stop-when-empty]
- *   kreftjs queue:failed / queue:retry <id|all> / queue:flush / queue:table
- *   kreftjs schedule:work / schedule:run / schedule:list
- *   kreftjs cache:clear / cache:table
- *   kreftjs notifications:table
- *   kreftjs event:list
- *   kreftjs make:job, make:event, make:listener, make:mail, make:notification, make:policy, make:request,
+ *   kreft list                         every command (yours too)
+ *   kreft about                        versions, settings, folders
+ *   kreft tinker                       a console with your models, DB, Cache… (await works)
+ *   kreft key:generate                 a new APP_KEY in .env
+ *   kreft down [--secret=x] / kreft up   maintenance mode
+ *   kreft db:wipe                      drop every table
+ *   kreft migrate:refresh [--seed]     undo every migration, then run them again
+ *   kreft migrate:reset                undo every migration
+ *   kreft queue:work [--queue=a,b] [--once] [--stop-when-empty]
+ *   kreft queue:failed / queue:retry <id|all> / queue:flush / queue:table
+ *   kreft schedule:work / schedule:run / schedule:list
+ *   kreft cache:clear / cache:table
+ *   kreft notifications:table
+ *   kreft event:list
+ *   kreft make:job, make:event, make:listener, make:mail, make:notification, make:policy, make:request,
  *       make:resource, make:factory, make:rule, make:command, make:observer
- *   Your own commands: app/Console/Commands/*.js (kreftjs make:command SendReport)
+ *   Your own commands: app/Console/Commands/*.js (kreft make:command SendReport)
  */
 const fs = require('fs');
 const path = require('path');
@@ -42,7 +42,7 @@ async function withApp(o, ctx, fn) {
 
 /* ------------------------------------------------------------------ built-in migration tables */
 const tableStubs = {
-  jobs: `// The queue's tables: jobs waiting (kreftjs queue:work, or kreftjs dev, runs them) and jobs that failed
+  jobs: `// The queue's tables: jobs waiting (kreft queue:work, or kreft dev, runs them) and jobs that failed
 module.exports = {
   up(schema) {
     schema.create('jobs', (table) => {
@@ -110,7 +110,7 @@ function tableCommand(kind, fileName) {
     const exists = fs.existsSync(dir) && fs.readdirSync(dir).some((f) => f.includes(fileName));
     if (exists) return console.log(`  There is already a ${fileName} migration.`);
     write(path.join(dir, `${nextStamp(dir)}_${fileName}.js`), tableStubs[kind]);
-    console.log(dim('  Then: kreftjs migrate'));
+    console.log(dim('  Then: kreft migrate'));
   };
 }
 commands['queue:table'] = tableCommand('jobs', 'create_jobs_table');
@@ -124,7 +124,7 @@ commands['queue:work'] = async function (args) {
   const queues = (raw.split('=')[1] || 'default').split(',');
   await withApp(o, ctx, async () => {
     const q = require('./backend/queue.js');
-    if (!(await q.tablesReady())) return console.error('  No jobs table. Make it with:  kreftjs queue:table, then kreftjs migrate');
+    if (!(await q.tablesReady())) return console.error('  No jobs table. Make it with:  kreft queue:table, then kreft migrate');
     console.log(`  Working on the ${queues.join(', ')} queue${queues.length > 1 ? 's' : ''}. Stop with Ctrl+C.\n`);
     await q.work({ queues, once: o.flags.has('once'), stopWhenEmpty: o.flags.has('stop-when-empty'), log: console.log });
   });
@@ -135,13 +135,13 @@ commands['queue:failed'] = async function (args) {
     const rows = await db.query('SELECT id, queue, payload, exception, failed_at FROM failed_jobs ORDER BY id DESC LIMIT 50');
     if (!rows.length) return console.log('  No failed jobs.');
     for (const r of rows) console.log(`  ${String(r.id).padEnd(5)} ${String(r.failed_at).slice(0, 19)}  ${JSON.parse(r.payload).class}  ${dim(String(r.exception).split('\n')[0].slice(0, 90))}`);
-    console.log(dim('\n  Try one again: kreftjs queue:retry <id>  (or all)'));
+    console.log(dim('\n  Try one again: kreft queue:retry <id>  (or all)'));
   });
 };
 commands['queue:retry'] = async function (args) {
   const o = options(args), ctx = context(o);
   const which = o._[0];
-  if (!which) return console.error('  kreftjs queue:retry <id>   or   kreftjs queue:retry all');
+  if (!which) return console.error('  kreft queue:retry <id>   or   kreft queue:retry all');
   await withDb(o, ctx, async (db) => {
     const { Builder } = require('./backend/query.js');
     const rows = which === 'all' ? await new Builder('failed_jobs').get() : await new Builder('failed_jobs').where('id', which).get();
@@ -169,10 +169,10 @@ commands['queue:stop'] = async function (args) {
   q.stop(target);
   if (target === 'all' || target === '*') {
     console.log(`  ${red('STOPPED')} All running queues have been stopped.`);
-    console.log(dim('  Resume anytime with: kreftjs queue:resume --all'));
+    console.log(dim('  Resume anytime with: kreft queue:resume --all'));
   } else {
     console.log(`  ${yellow('STOPPED')} Queue "${target}" has been stopped.`);
-    console.log(dim(`  Resume with: kreftjs queue:resume ${target}`));
+    console.log(dim(`  Resume with: kreft queue:resume ${target}`));
   }
 };
 commands['queue:pause'] = commands['queue:stop'];
@@ -417,7 +417,7 @@ commands['sitemap'] = async function (args) {
   }
   bar.complete(`${routes.length} URLs indexed`);
 
-  if (/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(:|\/|$)/.test(baseUrl)) console.log(`  WARN  The sitemap uses ${baseUrl}. Search engines need your real address: kreftjs sitemap --url https://example.com (or set APP_URL)`);
+  if (/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(:|\/|$)/.test(baseUrl)) console.log(`  WARN  The sitemap uses ${baseUrl}. Search engines need your real address: kreft sitemap --url https://example.com (or set APP_URL)`);
   const { SEO } = require('./backend/support.js');
   const xml = SEO.sitemap(routes, { baseUrl });
   const robots = SEO.robots({ allow: '/', sitemapUrl: `${baseUrl.replace(/\/+$/, '')}/sitemap.xml` });
@@ -602,7 +602,7 @@ commands.down = function (args) {
   const data = { time: Math.floor(Date.now() / 1000), retry: Number(get('retry')) || null, message: get('message') || 'We are making the site better. Please come back soon.', secret };
   fs.mkdirSync(path.dirname(downFile(ctx)), { recursive: true });
   fs.writeFileSync(downFile(ctx), JSON.stringify(data, null, 2), { mode: 0o600 });
-  console.log(`  ${yellow('DOWN')}  The app is in maintenance mode: visitors see a 503 page.${secret ? `\n  You can still use it at: /${secret}  (once; a cookie remembers you)` : ''}\n  Back with: kreftjs up`);
+  console.log(`  ${yellow('DOWN')}  The app is in maintenance mode: visitors see a 503 page.${secret ? `\n  You can still use it at: /${secret}  (once; a cookie remembers you)` : ''}\n  Back with: kreft up`);
 };
 commands.up = function (args) {
   const o = options(args), ctx = context(o);
@@ -621,7 +621,7 @@ commands.about = function (args) {
   row('Node.js', process.version);
   row('App name', process.env.APP_NAME || '-');
   row('App URL', process.env.APP_URL || '-');
-  row('APP_KEY', process.env.APP_KEY ? green('set') : red('missing (kreftjs key:generate)'));
+  row('APP_KEY', process.env.APP_KEY ? green('set') : red('missing (kreft key:generate)'));
   row('TypeScript', ok(has(path.join(ctx.project, 'tsconfig.json'))));
   row('Maintenance mode', has(downFile(ctx)) ? yellow('down') : 'live');
   console.log('\n  Drivers');
@@ -653,7 +653,7 @@ commands.tinker = async function (args) {
 const stub = {
   job: (n) => `const { Job } = require('kreftjs/server')
 
-// dispatch(new ${n}(…)) puts it on the queue; kreftjs queue:work (or kreftjs dev) runs handle()
+// dispatch(new ${n}(…)) puts it on the queue; kreft queue:work (or kreft dev) runs handle()
 class ${n} extends Job {
   static tries = 3        // try again after an error, up to 3 times
   static backoff = 10     // seconds between tries
@@ -728,7 +728,7 @@ class ${n} extends Notification {
   }
 
   via(notifiable) {
-    return ['mail', 'database'] // 'database' needs the notifications table: kreftjs notifications:table
+    return ['mail', 'database'] // 'database' needs the notifications table: kreft notifications:table
   }
 
   toMail(notifiable) {
@@ -894,21 +894,21 @@ function makeIn(folder, suffix, build, usage) {
     return build(o, ctx, dirs, name, path.join(ctx.base, ...folder.split('/'), ...dirs, name + '.js'));
   };
 }
-make.job = makeIn('app/Jobs', '', (o, c, d, n, f) => write(f, stub.job(n)), 'kreftjs make:job SendWelcomeEmail');
-make.event = makeIn('app/Events', '', (o, c, d, n, f) => write(f, stub.event(n)), 'kreftjs make:event OrderShipped');
-make.listener = makeIn('app/Listeners', '', (o, c, d, n, f) => write(f, stub.listener(n, o.event)), 'kreftjs make:listener SendShipmentNotice --event OrderShipped');
-make.mail = makeIn('app/Mail', 'Mail', (o, c, d, n, f) => write(f, stub.mail(n)), 'kreftjs make:mail WelcomeMail');
-make.notification = makeIn('app/Notifications', '', (o, c, d, n, f) => write(f, stub.notification(n)), 'kreftjs make:notification InvoicePaid');
-make.policy = makeIn('app/Policies', 'Policy', (o, c, d, n, f) => write(f, stub.policy(n, o.model || n.replace(/Policy$/, ''))), 'kreftjs make:policy PostPolicy [--model Post]');
-make.request = make.request || makeIn('app/Http/Requests', 'Request', (o, c, d, n, f) => write(f, stub.request(n)), 'kreftjs make:request StorePostRequest');
-make.resource = make.resource || makeIn('app/Http/Resources', 'Resource', (o, c, d, n, f) => write(f, stub.resource(n)), 'kreftjs make:resource PostResource');
-make.rule = make.rule || makeIn('app/Rules', '', (o, c, d, n, f) => write(f, stub.rule(n)), 'kreftjs make:rule Uppercase');
-make.observer = makeIn('app/Observers', 'Observer', (o, c, d, n, f) => write(f, stub.observer(n, o.model || n.replace(/Observer$/, ''))), 'kreftjs make:observer PostObserver [--model Post]');
-make.command = makeIn('app/Console/Commands', '', (o, c, d, n, f) => write(f, stub.command(n, o.command || n.replace(/Command$/, '').replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase().replace(/-/, ':'))), 'kreftjs make:command SendReport [--command report:send]');
+make.job = makeIn('app/Jobs', '', (o, c, d, n, f) => write(f, stub.job(n)), 'kreft make:job SendWelcomeEmail');
+make.event = makeIn('app/Events', '', (o, c, d, n, f) => write(f, stub.event(n)), 'kreft make:event OrderShipped');
+make.listener = makeIn('app/Listeners', '', (o, c, d, n, f) => write(f, stub.listener(n, o.event)), 'kreft make:listener SendShipmentNotice --event OrderShipped');
+make.mail = makeIn('app/Mail', 'Mail', (o, c, d, n, f) => write(f, stub.mail(n)), 'kreft make:mail WelcomeMail');
+make.notification = makeIn('app/Notifications', '', (o, c, d, n, f) => write(f, stub.notification(n)), 'kreft make:notification InvoicePaid');
+make.policy = makeIn('app/Policies', 'Policy', (o, c, d, n, f) => write(f, stub.policy(n, o.model || n.replace(/Policy$/, ''))), 'kreft make:policy PostPolicy [--model Post]');
+make.request = make.request || makeIn('app/Http/Requests', 'Request', (o, c, d, n, f) => write(f, stub.request(n)), 'kreft make:request StorePostRequest');
+make.resource = make.resource || makeIn('app/Http/Resources', 'Resource', (o, c, d, n, f) => write(f, stub.resource(n)), 'kreft make:resource PostResource');
+make.rule = make.rule || makeIn('app/Rules', '', (o, c, d, n, f) => write(f, stub.rule(n)), 'kreft make:rule Uppercase');
+make.observer = makeIn('app/Observers', 'Observer', (o, c, d, n, f) => write(f, stub.observer(n, o.model || n.replace(/Observer$/, ''))), 'kreft make:observer PostObserver [--model Post]');
+make.command = makeIn('app/Console/Commands', '', (o, c, d, n, f) => write(f, stub.command(n, o.command || n.replace(/Command$/, '').replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase().replace(/-/, ':'))), 'kreft make:command SendReport [--command report:send]');
 make.factory = function (args) {
   const o = options(args), ctx = context(o);
   let { name } = nested(o._[0]);
-  if (!name) return console.error('  kreftjs make:factory PostFactory [--model Post]');
+  if (!name) return console.error('  kreft make:factory PostFactory [--model Post]');
   if (!name.endsWith('Factory')) name += 'Factory';
   const model = o.model ? nested(o.model) : { dirs: [], name: name.replace(/Factory$/, '') };
   write(path.join(ctx.base, 'database', 'factories', name + '.js'), stub.factory(name, model.name, '../../app/Models/' + [...model.dirs, model.name].join('/')));
@@ -979,7 +979,7 @@ commands.list = function (args) {
   const groups = {};
   for (const c of builtIn) (groups[c.includes(':') ? c.split(':')[0] : ''] = groups[c.includes(':') ? c.split(':')[0] : ''] || []).push(c);
   console.log(`\n  Kreft ${pkg.version}\n\n  Commands:`);
-  console.log('    new  dev  serve  build  update  db  vscode   (kreftjs help for their options)');
+  console.log('    new  dev  serve  build  update  db  vscode   (kreft help for their options)');
   console.log('    ' + (groups[''] || []).join('  '));
   for (const [g, list] of Object.entries(groups)) if (g) console.log(`  ${g}\n    ${list.join('  ')}`);
   const mine = customCommands(ctx.base);

package/bin/artisan.js

@@ -1,19 +1,19 @@
 /*
  * The backend commands:
  *
- *   kreftjs migrate                      run new migrations
- *   kreftjs migrate:rollback [--step 2]  undo the last batch (or the last 2 migrations)
- *   kreftjs migrate:fresh [--seed]       drop every table, migrate again (and seed)
- *   kreftjs migrate:status               which migrations ran
- *   kreftjs db:seed [--class PostSeeder] run database/seeders/DatabaseSeeder.js (or another seeder)
- *   kreftjs route:list                   the routes in routes/api.js
- *   kreftjs make:model Post [-m -f -s -c -p -r] [--route=file] [--auth] [--all]
- *   kreftjs make:controller PostController [--api] [--model Post] [--route=file] [--auth]
- *   kreftjs make:page Post [--model Post] [--route=file] [--auth]
- *   kreftjs make:migration create_posts_table
- *   kreftjs make:seeder PostSeeder
- *   kreftjs make:factory PostFactory
- *   kreftjs make:middleware EnsureIsAdmin
+ *   kreft migrate                      run new migrations
+ *   kreft migrate:rollback [--step 2]  undo the last batch (or the last 2 migrations)
+ *   kreft migrate:fresh [--seed]       drop every table, migrate again (and seed)
+ *   kreft migrate:status               which migrations ran
+ *   kreft db:seed [--class PostSeeder] run database/seeders/DatabaseSeeder.js (or another seeder)
+ *   kreft route:list                   the routes in routes/api.js
+ *   kreft make:model Post [-m -f -s -c -p -r] [--route=file] [--auth] [--all]
+ *   kreft make:controller PostController [--api] [--model Post] [--route=file] [--auth]
+ *   kreft make:page Post [--model Post] [--route=file] [--auth]
+ *   kreft make:migration create_posts_table
+ *   kreft make:seeder PostSeeder
+ *   kreft make:factory PostFactory
+ *   kreft make:middleware EnsureIsAdmin
  *
  * Every command takes --db <url> (or DATABASE_URL in .env) and --backend <folder> (default: the project).
  */
@@ -168,13 +168,13 @@ async function runSeed(db, b, ctx, className) {
   // an older project: database/seed.sql
   const sql = path.join(ctx.base, 'database', 'seed.sql');
   if (!className && fs.existsSync(sql)) { await db.exec(fs.readFileSync(sql, 'utf8')); return console.log('  Seeded from database/seed.sql'); }
-  console.log(`  No database/seeders/${className || 'DatabaseSeeder'}.js. Make one with:  kreftjs make:seeder ${className || 'DatabaseSeeder'}`);
+  console.log(`  No database/seeders/${className || 'DatabaseSeeder'}.js. Make one with:  kreft make:seeder ${className || 'DatabaseSeeder'}`);
 }
 
 /* ------------------------------------------------------------------ make:… */
 const pascal = (s) => s.replace(/(^|[-_\s])(\w)/g, (_, __, c) => c.toUpperCase()).replace(/[^\w]/g, '');
 // 'User/ProfileController', 'user\\profile-controller' or 'User.ProfileController' → { dirs: ['User'], name: 'ProfileController' }
-// (folders are made when they don't exist yet, e.g. kreftjs make:controller User/ProfileController)
+// (folders are made when they don't exist yet, e.g. kreft make:controller User/ProfileController)
 function nested(raw) {
   const parts = String(raw || '').split(/[\\/]+/).map((p) => pascal(p)).filter(Boolean);
   const name = parts.pop() || '';
@@ -298,7 +298,7 @@ module.exports = ${name}
   migration: (name) => {
     const create = name.match(/^create_(\w+?)_table$/);
     const change = name.match(/^\w+_(?:to|from|in)_(\w+?)_table$/);
-    if (create) return `// kreftjs migrate runs up(); kreftjs migrate:rollback runs down()
+    if (create) return `// kreft migrate runs up(); kreft migrate:rollback runs down()
 module.exports = {
   up(schema) {
     schema.create('${create[1]}', (table) => {
@@ -313,7 +313,7 @@ module.exports = {
 }
 `;
     const t = change ? change[1] : 'table_name';
-    return `// kreftjs migrate runs up(); kreftjs migrate:rollback runs down()
+    return `// kreft migrate runs up(); kreft migrate:rollback runs down()
 module.exports = {
   up(schema) {
     schema.table('${t}', (table) => {
@@ -331,7 +331,7 @@ module.exports = {
   },
   seeder: (name, model, modelReq) => `const { Seeder, DB } = require('kreftjs/server')
 ${model ? `const ${model} = require('${modelReq || '../../app/Models/' + model}')\n` : ''}
-// kreftjs db:seed --class ${name}  (or this.call(${name}) from DatabaseSeeder)
+// kreft db:seed --class ${name}  (or this.call(${name}) from DatabaseSeeder)
 class ${name} extends Seeder {
   async run() {
 ${model ? `    // await ${model}.factory().count(10).create()\n    // await ${model}.create({ … })\n` : name === 'DatabaseSeeder' ? '    // await this.call([UserSeeder, PostSeeder])\n' : "    // await DB.table('posts').insert({ … })\n"}  }
@@ -1186,15 +1186,15 @@ const make = {
   model(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name, rel } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:model Post [-m -f -s -c -p -r] [--route=file] [--auth] [--all] [--folder=Admin]   (Shop/Product: app/Models/Shop/Product.js)');
+    if (!name) return console.error('  kreft make:model Post [-m -f -s -c -p -r] [--route=file] [--auth] [--all] [--folder=Admin]   (Shop/Product: app/Models/Shop/Product.js)');
     const all = o.flags.has('a') || o.flags.has('all');
     const auth = o.flags.has('auth');
     const hasRoute = all || o.flags.has('r') || o.flags.has('route') || Boolean(o.route);
 
     // Support placing all auxiliary files (controllers, pages, routes) in a specific folder [except model]:
-    // e.g. kreftjs make:model Post --all --folder=Admin
-    //      kreftjs make:model Post --all Admin
-    //      kreftjs make:model Admin/Post --all --flat-model
+    // e.g. kreft make:model Post --all --folder=Admin
+    //      kreft make:model Post --all Admin
+    //      kreft make:model Admin/Post --all --flat-model
     const targetFolder = o.folder || o.subfolder || o['in'] || o.group || o.path || (o._[1] && !o._[1].startsWith('-') ? o._[1] : null);
     const flatModel = o.flags.has('flat-model') || o.flags.has('except-model') || o.flags.has('no-model-dir') || Boolean(targetFolder);
 
@@ -1222,7 +1222,7 @@ const make = {
   controller(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:controller PostController [--api] [--model Post] [--route=file] [--auth]');
+    if (!name) return console.error('  kreft make:controller PostController [--api] [--model Post] [--route=file] [--auth]');
     if (!/Controller$/.test(name)) name += 'Controller';
     const m = o.model ? nested(o.model) : o.flags.has('api') || o.flags.has('resource') ? { dirs: [], name: name.replace(/Controller$/, '') } : null;
     const model = m ? m.name : null;
@@ -1250,7 +1250,7 @@ const make = {
   page(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:page Post [--model Post] [--route=file] [--auth]');
+    if (!name) return console.error('  kreft make:page Post [--model Post] [--route=file] [--auth]');
     const m = o.model ? nested(o.model) : { dirs, name };
     const modelDirs = m.dirs && m.dirs.length ? m.dirs : dirs;
     const endpoint = [...(modelDirs.length ? modelDirs.map((d) => snake(d).replace(/_/g, '-')) : []), plural(snake(m.name)).replace(/_/g, '-')].join('/');
@@ -1270,7 +1270,7 @@ const make = {
   factory(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:factory PostFactory [--model Post]');
+    if (!name) return console.error('  kreft make:factory PostFactory [--model Post]');
     if (!name.endsWith('Factory')) name += 'Factory';
     const m = o.model ? nested(o.model) : { dirs: [], name: name.replace(/Factory$/, '') };
     const modelReq = '../../app/Models/' + [...m.dirs, m.name].join('/');
@@ -1279,14 +1279,14 @@ const make = {
   migration(args) {
     const o = options(args), ctx = context(o);
     const name = snake(o._[0] || '').replace(/[^a-z0-9_]/g, '_');
-    if (!name) return console.error('  kreftjs make:migration create_posts_table');
+    if (!name) return console.error('  kreft make:migration create_posts_table');
     const dir = migrationsOf(o, ctx);
     write(path.join(dir, `${nextStamp(dir)}_${name}.js`), stubs.migration(name));
   },
   seeder(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:seeder PostSeeder');
+    if (!name) return console.error('  kreft make:seeder PostSeeder');
     if (!/Seeder$/.test(name)) name += 'Seeder';
     const m = o.model ? nested(o.model) : null;
     const modelReq = m ? up(2 + dirs.length) + ['app', 'Models', ...m.dirs, m.name].join('/') : null;
@@ -1295,14 +1295,14 @@ const make = {
   middleware(args) {
     const o = options(args), ctx = context(o);
     const { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:middleware EnsureIsAdmin');
+    if (!name) return console.error('  kreft make:middleware EnsureIsAdmin');
     write(path.join(ctx.base, 'app', 'Http', 'Middleware', ...dirs, name + '.js'), stubs.middleware(name));
     if (dirs.length) console.log(dim(`  In a folder, give it a name in app/Http/Kernel.js:  aliases: { '${snake(name).replace(/_/g, '-')}': 'Middleware/${[...dirs, name].join('/')}.js' }`));
   },
   request(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:request StorePostRequest [--model Post]');
+    if (!name) return console.error('  kreft make:request StorePostRequest [--model Post]');
     if (!/Request$/.test(name)) name += 'Request';
     const reqDir = path.join(ctx.base, 'app', 'Http', 'Requests');
     if (!fs.existsSync(reqDir)) fs.mkdirSync(reqDir, { recursive: true });
@@ -1317,7 +1317,7 @@ const make = {
   resource(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:resource PostResource');
+    if (!name) return console.error('  kreft make:resource PostResource');
     if (!/Resource$/.test(name)) name += 'Resource';
     const resDir = path.join(ctx.base, 'app', 'Http', 'Resources');
     if (!fs.existsSync(resDir)) fs.mkdirSync(resDir, { recursive: true });
@@ -1331,7 +1331,7 @@ const make = {
   rule(args) {
     const o = options(args), ctx = context(o);
     let { dirs, name } = nested(o._[0]);
-    if (!name) return console.error('  kreftjs make:rule Uppercase');
+    if (!name) return console.error('  kreft make:rule Uppercase');
     const ruleDir = path.join(ctx.base, 'app', 'Rules');
     if (!fs.existsSync(ruleDir)) fs.mkdirSync(ruleDir, { recursive: true });
     const isTs = isTsProject(path.join(ruleDir, ...dirs, name + '.js'));
@@ -1345,7 +1345,7 @@ const make = {
     const o = options(args), ctx = context(o);
     const locale = (o._[0] || '').toLowerCase().trim();
     if (!locale || /[\/\\]|\.\./.test(locale)) {
-      console.error('  kreftjs make:lang <locale>   (e.g. kreftjs make:lang ar)');
+      console.error('  kreft make:lang <locale>   (e.g. kreft make:lang ar)');
       return;
     }
     // Place in project root lang/ (matching standard Laravel 9/10/11) or backend/lang/ if already existing
@@ -1494,7 +1494,7 @@ const make = {
     console.log(dim(`  Use in frontend: { __('auth.failed') } or { t('Sign In') }`));
   },
 };
-// kreftjs make:errors — the error pages (errors/404.kreftjs, 403, 500…)
+// kreft make:errors — the error pages (errors/404.kreftjs, 403, 500…)
 make.errors = function (args) {
   const o = options(args), ctx = context(o);
   const from = path.join(__dirname, '..', 'templates', 'errors');
@@ -1511,12 +1511,12 @@ make.errors = function (args) {
   }
 };
 
-// kreftjs make:routes admin        → frontend/routes/admin.kreftjs (pages), listed in Kreftjs.router({ routes: […] }) in index.html
-// kreftjs make:routes admin --api  → backend/routes/admin.js (API), loaded by routes/api.js
+// kreft make:routes admin        → frontend/routes/admin.kreftjs (pages), listed in Kreftjs.router({ routes: […] }) in index.html
+// kreft make:routes admin --api  → backend/routes/admin.js (API), loaded by routes/api.js
 make.routes = function (args) {
   const o = options(args), ctx = context(o);
   const name = String(o._[0] || '').replace(/\.(kreftjs|kreft|som|js)$/, '').replace(/[^\w-]/g, '');
-  if (!name) return console.error('  kreftjs make:routes admin        (pages)\n  kreftjs make:routes admin --api  (API)');
+  if (!name) return console.error('  kreft make:routes admin        (pages)\n  kreft make:routes admin --api  (API)');
   if (o.flags.has('api')) {
     const file = path.join(ctx.base, 'routes', name + '.js');
     if (!write(file, stubs.apiRoutes(name))) return;
@@ -1549,12 +1549,12 @@ make.routes = function (args) {
   console.log(`  ${green('UPDATED')}  ${path.relative(process.cwd(), index)}  (${entry} in Kreftjs.router)`);
 };
 
-// kreftjs make:admin you@example.com      → that user may open the admin panel (/admin)
-// kreftjs make:admin you@example.com --remove
+// kreft make:admin you@example.com      → that user may open the admin panel (/admin)
+// kreft make:admin you@example.com --remove
 commands['make:admin'] = async function (args) {
   const o = options(args), ctx = context(o);
   const email = String(o._[0] || '').trim().toLowerCase(); // Register keeps emails in lowercase
-  if (!email) return console.error('  kreftjs make:admin you@example.com   (--remove takes the rights away)');
+  if (!email) return console.error('  kreft make:admin you@example.com   (--remove takes the rights away)');
   await withDb(o, ctx, async (db) => {
     const value = o.flags.has('remove') ? 0 : 1;
     const r = await db.run(`UPDATE ${db.q('users')} SET ${db.q('is_admin')} = ? WHERE LOWER(${db.q('email')}) = ?`, [db.kind === 'postgres' ? Boolean(value) : value, email]);
@@ -1615,8 +1615,8 @@ async function removeModel(args) {
   }
 
   if (!targetModelName) {
-    console.error('  Usage: kreftjs remove:model <Name> [--all] [--controller] [--request] [--route] [--migration] [--seeder] [--factory] [--page] [--folder=Folder]');
-    console.error('         kreftjs remove model <Name> [options]');
+    console.error('  Usage: kreft remove:model <Name> [--all] [--controller] [--request] [--route] [--migration] [--seeder] [--factory] [--page] [--folder=Folder]');
+    console.error('         kreft remove model <Name> [options]');
     console.error('         kreft:remove model <Name> [options]');
     return;
   }

package/bin/backend/command.js

@@ -1,5 +1,5 @@
 /*
- * Custom console commands (app/Console/Commands, kreftjs make:command SendReport).
+ * Custom console commands (app/Console/Commands, kreft make:command SendReport).
  *
  *   class SendReport extends Command {
  *     static signature = 'send:report {user} {--queue}'

package/bin/backend/factory.js

@@ -144,7 +144,7 @@ class Factory {
         }
       }
     }
-    if (!def) throw new Error(`No factory for ${Model && Model.name ? Model.name : 'Model'}. Make one: kreftjs make:factory ${(Model && Model.name) || 'Model'}Factory`);
+    if (!def) throw new Error(`No factory for ${Model && Model.name ? Model.name : 'Model'}. Make one: kreft make:factory ${(Model && Model.name) || 'Model'}Factory`);
     return new Factory(def);
   }
   constructor(def) {

package/bin/backend/index.js

@@ -5,8 +5,8 @@
  *   app/Http/Controllers/PostController.js
  *   app/Http/Middleware/Authenticate.js   'auth' in a route finds Authenticate.js (or Auth.js)
  *   app/Models/Post.js
- *   database/migrations/*.js              kreftjs migrate, kreftjs migrate:rollback, kreftjs migrate:fresh --seed
- *   database/seeders/DatabaseSeeder.js    kreftjs db:seed
+ *   database/migrations/*.js              kreft migrate, kreft migrate:rollback, kreft migrate:fresh --seed
+ *   database/seeders/DatabaseSeeder.js    kreft db:seed
  *
  * In your files:  const { Route, Model, DB, abort, response } = require('kreftjs/server')
  */
@@ -171,7 +171,7 @@ function createBackend(baseDir, { db = null, production = false, log = console,
     const known = { auth: 'Authenticate', guest: 'RedirectIfAuthenticated', verified: 'EnsureEmailIsVerified', 'password.confirm': 'RequirePassword', admin: 'EnsureIsAdmin', role: 'EnsureHasRole', abilities: 'CheckAbilities', ability: 'CheckForAnyAbility' }[name];
     const names = [name, p, p + 'Middleware', known].filter(Boolean);
     const file = names.map((n) => findFile(path.join(dir, n))).find(Boolean);
-    if (!file) throw new Error(`No middleware "${name}". Make it with:  kreftjs make:middleware ${p}`);
+    if (!file) throw new Error(`No middleware "${name}". Make it with:  kreft make:middleware ${p}`);
     if (!isInsideDir(file, path.resolve(baseDir, 'app'))) throw new Error(`Forbidden middleware path.`);
     return { fn: await loadModuleAsync(file), args };
   }

package/bin/backend/model.js

@@ -61,7 +61,7 @@ class ModelNotFoundError extends Error {
   }
 }
 
-// where the project's backend is (for factories); set by kreftjs dev / kreftjs serve / the kreftjs commands
+// where the project's backend is (for factories); set by kreft dev / kreft serve / the kreftjs commands
 let baseDir = null;
 const setBaseDir = (dir) => { baseDir = dir; };
 const getBaseDir = () => baseDir;
@@ -454,7 +454,7 @@ class Model {
     if ((await fire(C, 'saving', this)) === false) return false;
     if ((await fire(C, creating ? 'creating' : 'updating', this)) === false) return false;
     if (!(await tableExists(C.table))) {
-      throw new Error(`Table "${C.table}" does not exist in the database. Run "kreftjs migrate" to create it.`);
+      throw new Error(`Table "${C.table}" does not exist in the database. Run "kreft migrate" to create it.`);
     }
     const cols = await columnsOf(C.table);
     const has = (c) => cols.some((x) => x.name === c);

package/bin/backend/notifications.js

@@ -16,7 +16,7 @@
  *
  *   await user.notify(new InvoicePaid(invoice))
  *   await Notification.send(users, new InvoicePaid(invoice))
- *   const list = await user.notifications().get()           // the notifications table (kreftjs notifications:table)
+ *   const list = await user.notifications().get()           // the notifications table (kreft notifications:table)
  *   await user.unreadNotifications().update({ read_at: new Date() })
  */
 const crypto = require('crypto');