shutro-erp 0.3.0 → 0.3.2

package/dist/cli/index.js

@@ -21,11 +21,11 @@ export const PACKAGE = Object.freeze({
     name: 'shutro-erp/cli',
     rfc: 'RFC 0001',
 });
-const USAGE = `Usage: kosh <command>
+const USAGE = `Usage: shutro-erp <command>
 
 Commands (run in the installation's folder; they read .env and src/modules.ts):
-  init [folder]          Set up an installation: database, company, administrator, apps (kosh init --help)
-  apps                   The apps: installed, disabled, available (kosh apps --help)
+  init [folder]          Set up an installation: database, company, administrator, apps (shutro-erp init --help)
+  apps                   The apps: installed, disabled, available (shutro-erp apps --help)
   apps install <app …>   Install apps and what they need, in one transaction
   apps disable <app …>   Switch apps off (their data stays); apps enable <app …> brings them back
   migrate                Plan schema changes into migrations/NNNN_*.sql, apply pending files, run the modules'
@@ -41,10 +41,10 @@ Commands (run in the installation's folder; they read .env and src/modules.ts):
   user create <login>    Create a user: --name, --email, --roles reporting.user,messaging.user, --password
   user password <login>  Set a new password
   generate client   Typed API client from the module set or an OpenAPI document
-      --modules <file|package>   a module (or file) exporting Kosh modules (\`modules\`, default, or each export)
+      --modules <file|package>   a module (or file) exporting Shutro ERP modules (\`modules\`, default, or each export)
       --from <file|url>          an OpenAPI document instead (a URL needs --token)
       --token <token>            Bearer token for --from <url>
-      --out <file>               where to write (default: src/api/kosh.gen.ts)
+      --out <file>               where to write (default: src/api/shutro-erp.gen.ts)
       --check                    fail if the file is out of date (CI)
 
 Every command takes --modules <file> (default src/modules.ts).
@@ -74,21 +74,21 @@ async function generate(argv, write, options) {
     });
     const cwd = options.cwd ?? process.cwd();
     if ((values.modules === undefined) === (values.from === undefined)) {
-        write('kosh generate client: pass exactly one of --modules or --from.\n');
+        write('shutro-erp generate client: pass exactly one of --modules or --from.\n');
         return 2;
     }
     const document = values.modules === undefined
         ? await documentFrom(values.from, values.token, cwd, options.fetch ?? globalThis.fetch)
         : openApiOf(await modulesOf(values.modules, cwd));
     const code = generateClient(document);
-    const out = resolve(cwd, values.out ?? 'src/api/kosh.gen.ts');
+    const out = resolve(cwd, values.out ?? 'src/api/shutro-erp.gen.ts');
     if (values.check === true) {
         const current = await readFile(out, 'utf8').catch(() => '');
         if (current.replaceAll('\r\n', '\n') === code) {
             write(`${out} is up to date.\n`);
             return 0;
         }
-        write(`${out} is out of date: run kosh generate client.\n`);
+        write(`${out} is out of date: run shutro-erp generate client.\n`);
         return 1;
     }
     await mkdir(dirname(out), { recursive: true });
@@ -128,7 +128,7 @@ export async function runCli(argv, write, options = {}) {
             return await command(argv.slice(1), write, cwd);
         }
         catch (error) {
-            write(`kosh ${argv[0]}: ${error instanceof Error ? error.message : String(error)}\n`);
+            write(`shutro-erp ${argv[0]}: ${error instanceof Error ? error.message : String(error)}\n`);
             return 1;
         }
     if (argv[0] === 'generate' && argv[1] === 'client') {
@@ -136,10 +136,10 @@ export async function runCli(argv, write, options = {}) {
             return await generate(argv.slice(2), write, options);
         }
         catch (error) {
-            write(`kosh generate client: ${error instanceof Error ? error.message : String(error)}\n`);
+            write(`shutro-erp generate client: ${error instanceof Error ? error.message : String(error)}\n`);
             return 1;
         }
     }
-    write(`Unknown command '${argv.join(' ')}'. Run kosh --help.\n`);
+    write(`Unknown command '${argv.join(' ')}'. Run shutro-erp --help.\n`);
     return 2;
 }

package/dist/cli/init.d.ts

@@ -14,5 +14,5 @@ export interface InitIo {
     /** What the output can show (colour, icons, spinners). Default: plain lines. */
     readonly terminal?: Terminal;
 }
-/** Runs `kosh init`. Returns the exit code. */
+/** Runs `shutro-erp init`. Returns the exit code. */
 export declare function runInit(argv: readonly string[], io: InitIo): Promise<number>;

package/dist/cli/init.js

@@ -1,5 +1,5 @@
 /**
- * `kosh init`: sets up an installation in a folder. It asks for (or takes as flags) the database, the first company,
+ * `shutro-erp init`: sets up an installation in a folder. It asks for (or takes as flags) the database, the first company,
  * the administrator, the apps, file storage, Valkey and the port; checks the database (and creates it when it does
  * not exist yet); writes the starter project and `.env`; plans and applies the first migration; installs the company,
  * the administrator and each app's default data; and enrols the administrator's authenticator app (administrator
@@ -9,7 +9,7 @@
 import { spawn, spawnSync } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
-import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { chmod, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
 import { createServer as createNetServer } from 'node:net';
 import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -39,14 +39,14 @@ export function releaseVersion(from = dirname(fileURLToPath(import.meta.url))) {
     }
     return KOSH_VERSION;
 }
-export const INIT_USAGE = `Usage: kosh init [folder] [options]
+export const INIT_USAGE = `Usage: shutro-erp init [folder] [options]
 
-Sets up a Kosh installation: asks for the database, the first company, the administrator, the apps,
+Sets up a Shutro ERP installation: asks for the database, the first company, the administrator, the apps,
 file storage and the port (Enter keeps the default), then writes the project, creates the database
 tables and the administrator, and enrols the administrator's authenticator app.
 
 Options (each also answers its question; with --yes the rest take their defaults):
-  --database-url <url>      PostgreSQL, e.g. postgres://user:pass@localhost:5432/kosh
+  --database-url <url>      PostgreSQL, e.g. postgres://user:pass@localhost:5432/my_erp
   --docker-db               start PostgreSQL in Docker (compose.yaml) instead
   --create-database         create the database when it does not exist
   --company <name>          the first company        --currency <code>   its currency (ISO 4217)
@@ -54,7 +54,7 @@ Options (each also answers its question; with --yes the rest take their defaults
                             with Accounting (default: BD for BDT, IN for INR, none otherwise; "none" for none)
   --lang <en|bn>            language                 --tz <zone>         time zone (IANA)
   --admin-login <login>     --admin-name <name>      --admin-email <email>
-  --admin-password <pw>     (or KOSH_ADMIN_PASSWORD; at least 12 characters)
+  --admin-password <pw>     (or SHUTRO_ERP_ADMIN_PASSWORD; at least 12 characters)
   --apps <list>             comma-separated: ${SELECTABLE_APPS.join(', ')} (default: all; bridges come with the apps they connect)
   --storage-dir <dir>       attachments in a folder (default ./var/attachments)
   --s3-endpoint <url> --s3-bucket <name> --s3-access-key <key> --s3-secret-key <secret> [--s3-region <r>]
@@ -141,7 +141,7 @@ const required = (what) => (v) => (v.trim() === '' ? `${what} is required.` : nu
 /** Opens the database; offers to create it when it does not exist. Returns the PostgreSQL version. */
 async function checkDatabase(url, create) {
     const probe = async (target) => {
-        const driver = pg.createDriver({ url: target, max: 1, applicationName: 'kosh init' });
+        const driver = pg.createDriver({ url: target, max: 1, applicationName: 'shutro-erp init' });
         try {
             const [row] = await driver.query({
                 text: 'SHOW server_version',
@@ -171,7 +171,7 @@ async function checkDatabase(url, create) {
             const admin = pg.createDriver({
                 url: parsed.toString(),
                 max: 1,
-                applicationName: 'kosh init',
+                applicationName: 'shutro-erp init',
             });
             try {
                 await admin.query({ text: `CREATE DATABASE "${name}"`, params: [] });
@@ -219,10 +219,10 @@ async function ask(prompter, flags, cwd, positional, ui) {
     const dir = resolve(cwd, positional ?? (await q(null, 'Project folder', '.')));
     const name = basename(dir)
         .toLowerCase()
-        .replace(/[^a-z0-9-]+/g, '-') || 'kosh-app';
+        .replace(/[^a-z0-9-]+/g, '-') || 'shutro-erp-app';
     ui.step('database', 'Database', 'PostgreSQL 16 or later: a server you have, or one in Docker');
     const postgres = {
-        user: 'kosh',
+        user: 'shutro',
         password: randomBytes(18)
             .toString('base64url')
             .replace(/[^A-Za-z0-9]/g, '')
@@ -503,6 +503,7 @@ async function modulesFor(apps) {
         (await import('../notify/index.js')).notify,
         (await import('../mail/index.js')).mail,
         (await import('../automation/index.js')).automation,
+        (await import('../integrations/index.js')).integrations,
         (await import('../studio/index.js')).studio,
         (await import('../import/index.js')).dataImport,
     ];
@@ -541,17 +542,17 @@ async function modulesFor(apps) {
 }
 function envFile(a) {
     const lines = [
-        '# Kosh settings (kosh init). Keep this file out of version control: it holds credentials.',
+        '# Shutro ERP settings (shutro-erp init). Keep this file out of version control: it holds credentials.',
         `DATABASE_URL=${a.databaseUrl}`,
         `PORT=${a.port}`,
     ];
     if (a.storage.kind === 'dir')
-        lines.push(`KOSH_STORAGE_DIR=${a.storage.dir}`);
+        lines.push(`SHUTRO_ERP_STORAGE_DIR=${a.storage.dir}`);
     else
         lines.push(`S3_ENDPOINT=${a.storage.endpoint}`, `S3_BUCKET=${a.storage.bucket}`, `S3_ACCESS_KEY=${a.storage.accessKey}`, `S3_SECRET_KEY=${a.storage.secretKey}`, `S3_REGION=${a.storage.region}`);
     if (a.valkeyUrl !== '')
         lines.push(`VALKEY_URL=${a.valkeyUrl}`);
-    lines.push('', '# Where users open the back-office (links in emails and notifications).', `KOSH_BASE_URL=http://localhost:${a.webPort}`, '# Email notifications: an SMTP server (Mailpit in development: smtp://localhost:1025, inbox on :8025).', '# SMTP_URL=smtp://user:password@smtp.example.com:587', '# MAIL_FROM=Kosh <no-reply@example.com>', '# Replies by email (RFC 0006 part 7): the inbound mailbox domain, and the webhook secret your provider sends.', `MAIL_INBOUND_SECRET=${a.inboundSecret}`, '# MAIL_INBOUND_DOMAIN=mail.example.com', '# MAIL_INBOUND_ALIAS=reply', `MAIL_INBOUND_WEBHOOK_SECRET=${a.inboundWebhookSecret}`, '# Without a webhook provider, a mailbox read every 30 s: IMAP_URL=imaps://user:password@host:993/INBOX', '', '# Kosh Studio (RFC 0012): propose (default: changes become patches) or write (development, one server: Studio', '# writes src/modules/<name>/ and applies at once). KOSH_STUDIO_DIR: the project folder (default: the working one).', '# KOSH_STUDIO=write', '# Proposals as pull requests (GitHub) or merge requests (GitLab): the repository and a token with the rights', '# to push branches and open them. Without them, proposals are patches to download.', '# KOSH_STUDIO_GIT_URL=https://github.com/acme/erp', '# KOSH_STUDIO_GIT_TOKEN=', '# KOSH_STUDIO_GIT_BASE=main', '', '# The AI assistant (RFC 0013): off until an administrator switches it on in Settings → AI assistant.', '# ANTHROPIC_API_KEY=', '# KOSH_ASSISTANT_MODEL=claude-opus-5-5', '# KOSH_ASSISTANT_MONTHLY_TOKENS=2000000', '', '# SMS and WhatsApp through Twilio (opt-in per user; a phone number on the user).', '# TWILIO_ACCOUNT_SID=', '# TWILIO_AUTH_TOKEN=', '# TWILIO_SMS_FROM=+1...', '# TWILIO_WHATSAPP_FROM=+1...', '', '# Web push (generated by kosh init; keep them, browsers subscribed with the public key stay subscribed).', `VAPID_PUBLIC_KEY=${a.vapid.publicKey}`, `VAPID_PRIVATE_KEY=${a.vapid.privateKey}`, `VAPID_SUBJECT=${a.admin.email === '' ? 'mailto:admin@localhost' : `mailto:${a.admin.email}`}`);
+    lines.push('', '# Where users open the back-office (links in emails and notifications).', `SHUTRO_ERP_BASE_URL=http://localhost:${a.webPort}`, '# Email notifications: an SMTP server (Mailpit in development: smtp://localhost:1025, inbox on :8025).', '# SMTP_URL=smtp://user:password@smtp.example.com:587', '# MAIL_FROM=Shutro ERP <no-reply@example.com>', '# Replies by email (RFC 0006 part 7): the inbound mailbox domain, and the webhook secret your provider sends.', `MAIL_INBOUND_SECRET=${a.inboundSecret}`, '# MAIL_INBOUND_DOMAIN=mail.example.com', '# MAIL_INBOUND_ALIAS=reply', `MAIL_INBOUND_WEBHOOK_SECRET=${a.inboundWebhookSecret}`, '# Without a webhook provider, a mailbox read every 30 s: IMAP_URL=imaps://user:password@host:993/INBOX', '', '# Shutro ERP Studio (RFC 0012): propose (default: changes become patches) or write (development, one server: Studio', '# writes src/modules/<name>/ and applies at once). SHUTRO_ERP_STUDIO_DIR: the project folder (default: the working one).', '# SHUTRO_ERP_STUDIO=write', '# Proposals as pull requests (GitHub) or merge requests (GitLab): the repository and a token with the rights', '# to push branches and open them. Without them, proposals are patches to download.', '# SHUTRO_ERP_STUDIO_GIT_URL=https://github.com/acme/erp', '# SHUTRO_ERP_STUDIO_GIT_TOKEN=', '# SHUTRO_ERP_STUDIO_GIT_BASE=main', '', '# The AI assistant (RFC 0013): off until an administrator switches it on in Settings → AI assistant.', '# ANTHROPIC_API_KEY=', '# SHUTRO_ERP_ASSISTANT_MODEL=claude-opus-5-5', '# SHUTRO_ERP_ASSISTANT_MONTHLY_TOKENS=2000000', '', '# SMS and WhatsApp through Twilio (opt-in per user; a phone number on the user).', '# TWILIO_ACCOUNT_SID=', '# TWILIO_AUTH_TOKEN=', '# TWILIO_SMS_FROM=+1...', '# TWILIO_WHATSAPP_FROM=+1...', '', '# Web push (generated by shutro-erp init; keep them, browsers subscribed with the public key stay subscribed).', `VAPID_PUBLIC_KEY=${a.vapid.publicKey}`, `VAPID_PRIVATE_KEY=${a.vapid.privateKey}`, `VAPID_SUBJECT=${a.admin.email === '' ? 'mailto:admin@localhost' : `mailto:${a.admin.email}`}`);
     lines.push('', '# PostgreSQL in Docker (compose.yaml): docker compose up -d db, or everything with docker compose up -d --build', `POSTGRES_USER=${a.postgres.user}`, `POSTGRES_PASSWORD=${a.postgres.password}`, `POSTGRES_DB=${a.postgres.db}`, `POSTGRES_PORT=${a.postgres.port}`);
     return `${lines.join('\n')}\n`;
 }
@@ -618,15 +619,37 @@ async function setUp(server, a, ui) {
             text: "SELECT to_regclass('public.res_users')::text AS found",
             params: [],
         });
-        if (installed?.found === null || installed?.found === undefined) {
-            task.update('planning');
-            const plan = await migrate.planMigration({
-                driver: server.driver,
-                registry: server.registry.registry,
-                ignore: FRAMEWORK_TABLES, // the framework's own tables, not a model's: never dropped
+        // A database another project set up keeps that project's migration history: this folder cannot continue it.
+        const status = await migrate.migrationStatus({ driver: server.driver, dir });
+        const here = new Set((await readdir(dir).catch(() => []))
+            .map((f) => /^(\d+)_/.exec(f)?.[1])
+            .filter(Boolean));
+        const foreign = status.applied.filter((m) => !here.has(m.version));
+        if (foreign.length > 0)
+            throw new Error(`The database "${new URL(a.databaseUrl).pathname.slice(1)}" belongs to another installation: its migrations ` +
+                `(${foreign.map((m) => `${m.version}_${m.name}`).join(', ')}) are not in this project's migrations folder. ` +
+                'Choose a new database for this project, or run shutro-erp init (or migrate) in the folder of the ' +
+                'project that created it.');
+        // Always what the database lacks: a new one gets every table; one made by an earlier version (or another
+        // project's choice of apps) gets the tables and columns these apps add, before their data migrations run.
+        const fresh = installed?.found === null || installed?.found === undefined;
+        task.update('planning');
+        const plan = await migrate.planMigration({
+            driver: server.driver,
+            registry: server.registry.registry,
+            ignore: FRAMEWORK_TABLES, // the framework's own tables, not a model's: never dropped
+        });
+        if (plan.destructive.length > 0)
+            throw new Error(`The database "${new URL(a.databaseUrl).pathname.slice(1)}" has data these apps would drop or change ` +
+                `(${plan.destructive.map((op) => migrate.renderOperation(op)).join('; ')}). Use a new database, or ` +
+                'review the change and run shutro-erp migrate --allow-destructive in the project first.');
+        if (plan.statements.length > 0) {
+            const file = await migrate.writeMigrationFile({
+                dir,
+                name: fresh ? 'init' : 'update',
+                plan,
             });
-            const file = await migrate.writeMigrationFile({ dir, name: 'init', plan });
-            ui.detail(`planned ${plan.statements.length} statements in migrations/${basename(file.path)}`);
+            ui.detail(`planned ${plan.statements.length} statements in migrations/${basename(file.path)}${fresh ? '' : ' (the database had an earlier version)'}`);
         }
         task.update('applying');
         const result = await migrate.applyMigrations({
@@ -634,8 +657,8 @@ async function setUp(server, a, ui) {
             dir,
             registry: server.registry.registry,
         });
-        // The installed set (RFC 0008): what `kosh apps` changes later.
-        await recordInstalledApps(server.driver, server.registry.loaded.modules, ['base', 'settings', 'realtime', 'notify', ...a.apps], `kosh init (${a.admin.login})`);
+        // The installed set (RFC 0008): what `shutro-erp apps` changes later.
+        await recordInstalledApps(server.driver, server.registry.loaded.modules, ['base', 'settings', 'realtime', 'notify', ...a.apps], `shutro-erp init (${a.admin.login})`);
         task.finish(`Database tables ready ${ui.style('gray', `(applied ${result.applied.length} migration(s))`)}`);
     });
     const [users] = await server.driver.query({
@@ -654,7 +677,7 @@ async function setUp(server, a, ui) {
             company: { name: a.company, currency: a.currency },
             admin: { login: a.admin.login, name: a.admin.name, password: a.admin.password },
         });
-        await server.shutro.bootstrap({ reason: 'kosh init', company }, async (env) => {
+        await server.shutro.bootstrap({ reason: 'shutro-erp init', company }, async (env) => {
             const model = (name) => env.model(name);
             const lang = a.lang === 'bn' ? 'bn_BD' : 'en_US';
             await model('res.users')
@@ -747,10 +770,10 @@ async function enrol(server, a, prompter, ui) {
             ui.fail(error instanceof Error ? error.message : String(error));
         }
     }
-    ui.warn('Not enrolled: run kosh init again later, or enrol from the API (POST /api/v1/auth/2fa/setup).');
+    ui.warn('Not enrolled: run shutro-erp init again later, or enrol from the API (POST /api/v1/auth/2fa/setup).');
     return false;
 }
-/** Runs `kosh init`. Returns the exit code. */
+/** Runs `shutro-erp init`. Returns the exit code. */
 export async function runInit(argv, io) {
     const { values, positionals } = parseArgs({
         args: [...argv],
@@ -853,10 +876,10 @@ export async function runInit(argv, io) {
     let server;
     const started = Date.now();
     try {
-        await ui.banner(`The ERP framework on Shutro · v${releaseVersion()}`);
-        ui.intro('Kosh setup', interactive
+        await ui.banner(`ERP · business software on the Shutro ORM · v${releaseVersion()}`);
+        ui.intro('Shutro ERP setup', interactive
             ? 'Enter keeps the default · ↑ ↓ choose · Space ticks · Ctrl+C quits'
-            : 'Kosh setup: press Enter to keep the value in [brackets].');
+            : 'Shutro ERP setup: press Enter to keep the value in [brackets].');
         const answers = await ask(prompter, values, io.cwd, positionals[0], ui);
         ui.step('files', 'Project files', answers.dir);
         await ui.task('Writing the project', async () => {
@@ -899,7 +922,7 @@ export async function runInit(argv, io) {
             enrolled = await enrol(live, answers, prompter, ui);
         }
         else if (values.yes === true && values['no-2fa'] !== true)
-            ui.info('The authenticator app is enrolled interactively: run npx kosh init again (without --yes).');
+            ui.info('The authenticator app is enrolled interactively: run npx shutro-erp init again (without --yes).');
         const rows = [
             [
                 'Company',
@@ -918,6 +941,7 @@ export async function runInit(argv, io) {
                     'notify',
                     'mail',
                     'automation',
+                    'integrations',
                     'studio',
                     'import',
                     ...answers.apps,
@@ -932,12 +956,12 @@ export async function runInit(argv, io) {
             ['Took', `${((Date.now() - started) / 1000).toFixed(1)}s`],
         ];
         if (!autoStart)
-            ui.outro(ui.style('green', 'Kosh is set up'));
-        ui.card(`${terminal.emoji ? '🚀 ' : ''}Kosh is set up`, rows, enrolled || values['no-2fa'] === true ? 'green' : 'yellow');
+            ui.outro(ui.style('green', 'Shutro ERP is set up'));
+        ui.card(`${terminal.emoji ? '🚀 ' : ''}Shutro ERP is set up`, rows, enrolled || values['no-2fa'] === true ? 'green' : 'yellow');
         if (autoStart) {
             if (!enrolled)
-                ui.warn('Administrator rights need a second factor: run `kosh init` again to enrol the authenticator app.');
-            ui.step('rocket', 'Starting Kosh', 'Dependencies, the API, the back-office, then your browser');
+                ui.warn('Administrator rights need a second factor: run `shutro-erp init` again to enrol the authenticator app.');
+            ui.step('rocket', 'Starting Shutro ERP', 'Dependencies, the API, the back-office, then your browser');
             // The installer's own connection is not needed any more: the API has its own.
             await server?.close();
             server = undefined;
@@ -955,7 +979,7 @@ export async function runInit(argv, io) {
             `  ${cmd('npm run web')}        ${ui.style('gray', `# the back-office on http://localhost:${answers.webPort}`)}\n\n` +
             `  Sign in as "${answers.admin.login}"${enrolled ? ' with your password and a code from the authenticator app' : ''}.\n`);
         if (!enrolled)
-            ui.warn('Administrator rights need a second factor: run `kosh init` again to enrol the authenticator app.');
+            ui.warn('Administrator rights need a second factor: run `shutro-erp init` again to enrol the authenticator app.');
         return 0;
     }
     catch (error) {
@@ -964,7 +988,7 @@ export async function runInit(argv, io) {
             return 130;
         }
         ui.write('\n');
-        ui.fail(`kosh init stopped: ${error instanceof Error ? error.message : String(error)}`);
+        ui.fail(`shutro-erp init stopped: ${error instanceof Error ? error.message : String(error)}`);
         return 1;
     }
     finally {

package/dist/cli/launch.js

@@ -1,5 +1,5 @@
 /**
- * After `kosh init`: the project's dependencies installed with the package manager that ran the installer, the API
+ * After `shutro-erp init`: the project's dependencies installed with the package manager that ran the installer, the API
  * and the back-office started, each waited for until it answers, and the back-office opened in the default browser.
  * Both keep running in this terminal until Ctrl+C, which stops them together. Their output is kept, and shown when
  * one of them fails to start.
@@ -24,14 +24,17 @@ export function browserCommand(url, platform = process.platform) {
 const windows = process.platform === 'win32';
 /** A child process running `pm args` in `cwd`, its output kept (the last 200 lines). */
 function start(pm, args, cwd) {
-    const child = spawn(pm, args, {
+    const options = {
         cwd,
         env: { ...process.env, FORCE_COLOR: '0' },
         stdio: ['ignore', 'pipe', 'pipe'],
-        // npm, pnpm… are .cmd scripts on Windows; elsewhere a process group, stopped as a whole.
-        shell: windows,
-        detached: !windows,
-    });
+        detached: !windows, // elsewhere a process group, stopped as a whole
+    };
+    // npm, pnpm… are .cmd scripts on Windows: run through the shell as one command line (the arguments are this
+    // module's own words, never input), which Node prefers to separate arguments with `shell: true`.
+    const child = windows
+        ? spawn([pm, ...args].join(' '), { ...options, shell: true })
+        : spawn(pm, args, options);
     const lines = [];
     const keep = (chunk) => {
         lines.push(...chunk
@@ -117,7 +120,7 @@ export async function launch(o, ui) {
     opened.on('error', () => ui.info(`Open ${webUrl} in your browser.`));
     opened.unref();
     ui.ok(`Opened ${ui.style('cyan', webUrl)} in your browser · sign in as "${o.login}"`);
-    ui.outro(`${ui.style('green', 'Kosh is running')}  ${ui.style('gray', `back-office ${webUrl} · API ${apiUrl} · Ctrl+C stops both`)}`);
+    ui.outro(`${ui.style('green', 'Shutro ERP is running')}  ${ui.style('gray', `back-office ${webUrl} · API ${apiUrl} · Ctrl+C stops both`)}`);
     // Until Ctrl+C, or until one of them stops by itself (its last lines are shown).
     const which = await Promise.race([
         new Promise((done) => {

package/dist/cli/project.d.ts

@@ -1,13 +1,13 @@
 import type { KoshModule } from '../modules-sdk/index.js';
 import { type KoshServer } from '../server/index.js';
-/** The Kosh modules a file or package exports: `modules`, the default export, or every module export. */
+/** The Shutro ERP modules a file or package exports: `modules`, the default export, or every module export. */
 export declare function modulesOf(specifier: string, cwd: string): Promise<KoshModule[]>;
 /** Opens the installation in `cwd`: `.env`, the modules, a server (not listening). */
 export declare function openProject(cwd: string, modulesFile: string, options?: {
     /** `schema`: installed and disabled modules (what migrations keep); default: the installed ones (what is served). */
     readonly set?: 'served' | 'schema';
 }): Promise<KoshServer>;
-/** What seed data is loaded with: a server's, or an app change's transaction (`kosh apps`). */
+/** What seed data is loaded with: a server's, or an app change's transaction (`shutro-erp apps`). */
 export interface SeedContext {
     readonly shutro: KoshServer['shutro'];
     readonly driver: Pick<KoshServer['driver'], 'query'>;
@@ -24,13 +24,13 @@ export declare function migrateProject(server: KoshServer, dir: string, write: (
     allowDestructive?: boolean;
     seed?: boolean;
 }): Promise<number>;
-/** `kosh migrate [status] …` */
+/** `shutro-erp migrate [status] …` */
 export declare function runMigrate(argv: readonly string[], write: (t: string) => void, cwd: string): Promise<number>;
-/** `kosh seed [module …]` */
+/** `shutro-erp seed [module …]` */
 export declare function runSeed(argv: readonly string[], write: (t: string) => void, cwd: string): Promise<number>;
-/** The files of a new module (`kosh module create <name>`). */
+/** The files of a new module (`shutro-erp module create <name>`). */
 export declare function moduleFiles(name: string): Record<string, string>;
-/** `kosh module create <name>`: scaffolds src/modules/<name>/ and lists it in src/modules.ts. */
+/** `shutro-erp module create <name>`: scaffolds src/modules/<name>/ and lists it in src/modules.ts. */
 export declare function runModule(argv: readonly string[], write: (t: string) => void, cwd: string): Promise<number>;
-/** `kosh user create <login> …` and `kosh user password <login>`. */
+/** `shutro-erp user create <login> …` and `shutro-erp user password <login>`. */
 export declare function runUser(argv: readonly string[], write: (t: string) => void, cwd: string, prompter?: import('./prompt.js').Prompter): Promise<number>;

package/dist/cli/project.js

@@ -1,6 +1,6 @@
 /**
- * Commands that work on an installation (a folder made by `kosh init`): `kosh migrate`, `kosh seed`,
- * `kosh module create`. They read `.env` (DATABASE_URL, storage, ...) and the module list in `src/modules.ts`.
+ * Commands that work on an installation (a folder made by `shutro-erp init`): `shutro-erp migrate`, `shutro-erp seed`,
+ * `shutro-erp module create`. They read `.env` (DATABASE_URL, storage, ...) and the module list in `src/modules.ts`.
  *
  * - Schema migrations are versioned SQL files in `migrations/`, planned from the modules against the live database
  *   (Shutro migrate) and applied in order; each module's data migrations (`migrations` in its Shutro module) run
@@ -21,7 +21,7 @@ function isModule(value) {
         'accessLevels' in value &&
         'name' in value);
 }
-/** The Kosh modules a file or package exports: `modules`, the default export, or every module export. */
+/** The Shutro ERP modules a file or package exports: `modules`, the default export, or every module export. */
 export async function modulesOf(specifier, cwd) {
     const target = specifier.startsWith('.') ||
         specifier.startsWith('/') ||
@@ -39,7 +39,7 @@ export async function modulesOf(specifier, cwd) {
     }
     const all = Object.values(exported).filter(isModule);
     if (all.length === 0)
-        throw new Error(`${specifier} exports no Kosh modules (defineModule from shutro-erp/modules-sdk).`);
+        throw new Error(`${specifier} exports no Shutro ERP modules (defineModule from shutro-erp/modules-sdk).`);
     return all;
 }
 /** Opens the installation in `cwd`: `.env`, the modules, a server (not listening). */
@@ -49,9 +49,9 @@ export async function openProject(cwd, modulesFile, options = {}) {
         process.loadEnvFile(envFile);
     const databaseUrl = process.env['DATABASE_URL'];
     if (databaseUrl === undefined || databaseUrl === '')
-        throw new Error('DATABASE_URL is not set: run kosh init, or add it to .env.');
+        throw new Error('DATABASE_URL is not set: run shutro-erp init, or add it to .env.');
     if (!existsSync(resolve(cwd, modulesFile)))
-        throw new Error(`${modulesFile} does not exist: run kosh init, or pass --modules <file>.`);
+        throw new Error(`${modulesFile} does not exist: run shutro-erp init, or pass --modules <file>.`);
     process.env['KOSH_SCHEDULES'] = 'off';
     // The module list is the catalogue; the database says which of them are installed (RFC 0008).
     const modules = await installedModules(databaseUrl, await modulesOf(modulesFile, cwd), options.set === 'schema' ? ['installed', 'disabled'] : ['installed']);
@@ -93,7 +93,7 @@ export async function seedWith(context, write, only) {
         : context.modules.filter((m) => only.includes(m.name));
     for (const d of await installDefaults(context.shutro, context.modules, {
         company: companyId,
-        reason: 'kosh seed',
+        reason: 'shutro-erp seed',
     }))
         if (wanted.some((m) => m.name === d.module))
             write(`  ${d.module.padEnd(16)} ${d.summary}
@@ -117,7 +117,7 @@ async function apply(server, dir, write, allowDestructive) {
     }
     catch (error) {
         if (error instanceof Error && error.name === 'DestructiveMigrationError') {
-            write(`${error.message}\nReview it, then run kosh migrate --allow-destructive.\n`);
+            write(`${error.message}\nReview it, then run shutro-erp migrate --allow-destructive.\n`);
             return 1;
         }
         throw error;
@@ -152,7 +152,7 @@ export async function migrateProject(server, dir, write, options = {}) {
     if (options.planOnly === true)
         return 0;
     if (plan.destructive.length > 0 && options.allowDestructive !== true) {
-        write('It drops or changes existing data: review the file, then run kosh migrate --allow-destructive.\n');
+        write('It drops or changes existing data: review the file, then run shutro-erp migrate --allow-destructive.\n');
         return 1;
     }
     if (plan.statements.length > 0 || pending.length === 0) {
@@ -173,11 +173,11 @@ export async function migrateProject(server, dir, write, options = {}) {
             await seed(server, write, served !== undefined && served.length > 0 ? served : undefined);
         }
         else
-            write('No company yet: seed data waits for kosh init.\n');
+            write('No company yet: seed data waits for shutro-erp init.\n');
     }
     return 0;
 }
-/** `kosh migrate [status] …` */
+/** `shutro-erp migrate [status] …` */
 export async function runMigrate(argv, write, cwd) {
     const { values, positionals } = parseArgs({
         args: [...argv],
@@ -217,7 +217,7 @@ export async function runMigrate(argv, write, cwd) {
         await server.close();
     }
 }
-/** `kosh seed [module …]` */
+/** `shutro-erp seed [module …]` */
 export async function runSeed(argv, write, cwd) {
     const { values, positionals } = parseArgs({
         args: [...argv],
@@ -239,7 +239,7 @@ const title = (name) => name
     .split(/[-_]+/)
     .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
     .join(' ');
-/** The files of a new module (`kosh module create <name>`). */
+/** The files of a new module (`shutro-erp module create <name>`). */
 export function moduleFiles(name) {
     const id = camel(name);
     const label = title(name);
@@ -265,7 +265,7 @@ export const Item = defineModel('${model}', {
 });
 `,
         'data.ts': `/**
- * Seed data of the ${label} module: \`kosh seed\` (and \`kosh migrate\`) create these records, update them when they
+ * Seed data of the ${label} module: \`shutro-erp seed\` (and \`shutro-erp migrate\`) create these records, update them when they
  * change here, and delete records removed from this list. \`noupdate\` records are created once, then left to the users.
  * Refer to other records by external id: orm.ref('res.currency', 'base.currency_bdt').
  */
@@ -277,7 +277,7 @@ export const data = [
 `,
         'migrations.ts': `/**
  * Data migrations of the ${label} module: each runs once, when an installed module is upgraded past its version
- * (raise \`version\` in index.ts, then \`kosh migrate\`). Schema changes need none: \`kosh migrate\` plans them.
+ * (raise \`version\` in index.ts, then \`shutro-erp migrate\`). Schema changes need none: \`shutro-erp migrate\` plans them.
  */
 import type { DataMigration } from 'shutro-erp/orm';
 
@@ -293,7 +293,7 @@ export const migrations: DataMigration[] = [
 `,
         'index.ts': `/**
  * The ${label} module: its Shutro models, groups, seed data and data migrations, plus access levels, an app,
- * menus, actions and views. Installed by listing it in src/modules.ts, then \`kosh migrate\`.
+ * menus, actions and views. Installed by listing it in src/modules.ts, then \`shutro-erp migrate\`.
  */
 import { base, baseShutro } from 'shutro-erp';
 import { defineModule } from 'shutro-erp/modules-sdk';
@@ -340,11 +340,11 @@ export const ${id} = defineModule({
 `,
     };
 }
-/** `kosh module create <name>`: scaffolds src/modules/<name>/ and lists it in src/modules.ts. */
+/** `shutro-erp module create <name>`: scaffolds src/modules/<name>/ and lists it in src/modules.ts. */
 export async function runModule(argv, write, cwd) {
     const [action, name] = argv;
     if (action !== 'create' || name === undefined) {
-        write('Usage: kosh module create <name>   (lower-case letters, digits and -, e.g. library)\n');
+        write('Usage: shutro-erp module create <name>   (lower-case letters, digits and -, e.g. library)\n');
         return 2;
     }
     if (!/^[a-z][a-z0-9-]{1,40}$/.test(name) ||
@@ -379,7 +379,7 @@ export async function runModule(argv, write, cwd) {
         else
             write(`  add ${id} to the modules list in src/modules.ts\n`);
     }
-    write(`\nNext: kosh apps install ${name}   (creates its tables and loads its seed data, in one transaction)\n`);
+    write(`\nNext: shutro-erp apps install ${name}   (creates its tables and loads its seed data, in one transaction)\n`);
     return 0;
 }
 /** The access levels a role list names: `reporting.user`, `messaging.user`, … (groups of installed modules). */
@@ -396,7 +396,7 @@ function groupsOf(server, roles) {
         throw new Error(`Unknown role(s): ${unknown.join(', ')}. Known: ${[...known].sort().join(', ')}.`);
     return list;
 }
-/** `kosh user create <login> …` and `kosh user password <login>`. */
+/** `shutro-erp user create <login> …` and `shutro-erp user password <login>`. */
 export async function runUser(argv, write, cwd, prompter) {
     const { values, positionals } = parseArgs({
         args: [...argv],
@@ -411,8 +411,8 @@ export async function runUser(argv, write, cwd, prompter) {
     });
     const [action, login] = positionals;
     if ((action !== 'create' && action !== 'password') || login === undefined) {
-        write('Usage: kosh user create <login> [--name <name>] [--email <email>] [--roles a.user,b.manager] [--password <pw>]\n' +
-            '       kosh user password <login> [--password <pw>]\n');
+        write('Usage: shutro-erp user create <login> [--name <name>] [--email <email>] [--roles a.user,b.manager] [--password <pw>]\n' +
+            '       shutro-erp user password <login> [--password <pw>]\n');
         return 2;
     }
     const { terminalPrompter } = await import('./prompt.js');
@@ -436,7 +436,7 @@ export async function runUser(argv, write, cwd, prompter) {
             params: [],
         });
         if (company === undefined)
-            throw new Error('No company yet: run kosh init first.');
+            throw new Error('No company yet: run shutro-erp init first.');
         const [user] = await server.driver.query({
             text: 'SELECT id::text AS id FROM res_users WHERE login = $1',
             params: [login],
@@ -444,7 +444,7 @@ export async function runUser(argv, write, cwd, prompter) {
         if (action === 'password') {
             if (user === undefined)
                 throw new Error(`No user "${login}".`);
-            await server.shutro.bootstrap({ reason: `kosh user password ${login}` }, (env) => auth.setPassword(env, Number(user.id), password));
+            await server.shutro.bootstrap({ reason: `shutro-erp user password ${login}` }, (env) => auth.setPassword(env, Number(user.id), password));
             write(`Password of "${login}" changed.\n`);
             return 0;
         }
@@ -459,7 +459,7 @@ export async function runUser(argv, write, cwd, prompter) {
             groups: groupsOf(server, values.roles),
         });
         if (values.email !== undefined)
-            await server.shutro.bootstrap({ reason: `kosh user create ${login}` }, async (env) => {
+            await server.shutro.bootstrap({ reason: `shutro-erp user create ${login}` }, async (env) => {
                 await env.model('res.users')
                     .browse([id])
                     .write({ email: values.email });

package/dist/cli/prompt.js

@@ -1,5 +1,5 @@
 /**
- * Terminal questions for `kosh init`, on `node:readline` (no dependency). Answers can be scripted for tests and
+ * Terminal questions for `shutro-erp init`, on `node:readline` (no dependency). Answers can be scripted for tests and
  * non-interactive installs (`--yes` with flags): every question goes through {@link Prompter}.
  */
 import { createInterface } from 'node:readline';
@@ -150,7 +150,7 @@ export function defaultsPrompter() {
     return {
         async ask(q) {
             if (q.default === undefined)
-                throw new Error(`"${q.message}" has no default: pass it as a flag (kosh init --help).`);
+                throw new Error(`"${q.message}" has no default: pass it as a flag (shutro-erp init --help).`);
             const problem = q.validate?.(q.default) ?? null;
             if (problem !== null)
                 throw new Error(`${q.message}: ${problem}`);