shutro-erp 0.2.1 → 0.3.1

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,17 +9,19 @@
 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';
 import { parseArgs } from 'node:util';
 import { base, createServer, DEMO_PASSWORD, FRAMEWORK_TABLES, installBase, installDemo, KOSH_VERSION, migrate, pg, recordInstalledApps, } from '../server/index.js';
+import { launch } from './launch.js';
 import { seed } from './project.js';
-import { defaultsPrompter, terminalPrompter } from './prompt.js';
+import { choose, chooseMany, defaultsPrompter, terminalPrompter } from './prompt.js';
 import * as templates from './templates.js';
-import { APPS, bridgesFor, SELECTABLE_APPS } from './templates.js';
-import { createUi, PLAIN_TERMINAL } from './ui.js';
+import { APPS, bridgesFor, COUNTRY_NAMES, LOCALIZED_COUNTRIES, SELECTABLE_APPS, } from './templates.js';
+import { CancelledError, interactivePrompter } from './tui.js';
+import { createUi, PLAIN_TERMINAL, railed } from './ui.js';
 /**
  * The version of the `shutro-erp` package this CLI runs from: new projects depend on it. In the workspace (no such
  * package around the CLI) the framework version stands in.
@@ -37,28 +39,33 @@ 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)
+  --country <code>          the company's country (ISO 3166): ${LOCALIZED_COUNTRIES.join(', ')} install its localization
+                            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>]
   --valkey-url <url>        optional: rate limits and caches shared across servers
-  --port <port>             the API's port (default 3000)
+  --port <port>             the API's port (default 3000, or the next free one)
+  --web-port <port>         the back-office's port in development (default 5173, or the next free one)
   --demo                    load demo data: a sample company with contacts, products, orders, invoices and
                             projects, made by demo users (dina, rahim, karim, sumi; one shared password)
   --no-2fa                  skip the authenticator enrolment (administrator rights wait for it)
+  --no-start                do not install, start and open the installation at the end (in a terminal it
+                            installs the dependencies, starts the API and the back-office, opens the browser)
   --yes                     do not ask; use flags and defaults
 `;
 const dockerAvailable = () => spawnSync('docker', ['version', '--format', '{{.Server.Version}}'], { encoding: 'utf8' })
@@ -134,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',
@@ -164,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: [] });
@@ -212,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, '')
@@ -228,9 +235,19 @@ async function ask(prompter, flags, cwd, positional, ui) {
     if (flag('database-url') === undefined) {
         const docker = flags['docker-db'] === true ||
             (dockerAvailable() && flags['yes'] !== true
-                ? (await q(null, 'PostgreSQL: (1) a server I already have, or (2) start one in Docker for me', '2', {
-                    validate: (v) => (v === '1' || v === '2' ? null : '1 or 2'),
-                })) === '2'
+                ? (await choose(prompter, {
+                    message: 'Which PostgreSQL?',
+                    fallback: 'PostgreSQL: (1) a server I already have, or (2) start one in Docker for me',
+                    choices: [
+                        { value: 'server', label: 'A server I already have', hint: 'host, port, user' },
+                        {
+                            value: 'docker',
+                            label: 'Start one in Docker for me',
+                            hint: 'PostgreSQL 18, its own volume',
+                        },
+                    ],
+                    default: 'docker',
+                })) === 'docker'
                 : false);
         if (docker) {
             if (!dockerAvailable())
@@ -312,9 +329,41 @@ async function ask(prompter, flags, cwd, positional, ui) {
     const currency = (await q('currency', 'Currency (ISO code)', 'BDT', {
         validate: (v) => (/^[A-Za-z]{3}$/.test(v) ? null : 'Three letters, e.g. BDT, USD, EUR'),
     })).toUpperCase();
-    const lang = await q('lang', 'Language (en, bn)', 'en', {
-        validate: (v) => (['en', 'bn'].includes(v) ? null : 'en or bn'),
-    });
+    const countryFlag = flag('country');
+    if (countryFlag !== undefined && !/^([A-Za-z]{2}|none)$/i.test(countryFlag))
+        throw new Error('--country: Two letters, e.g. BD, or none');
+    const countryAnswer = (countryFlag ??
+        (await choose(prompter, {
+            message: 'Country (taxes, chart of accounts, fiscal year)',
+            fallback: `Country (ISO code; ${LOCALIZED_COUNTRIES.join(', ')} set up taxes and the chart; "none" for none)`,
+            choices: [
+                ...LOCALIZED_COUNTRIES.map((c) => ({
+                    value: c,
+                    label: COUNTRY_NAMES[c] ?? c,
+                    hint: 'its taxes, chart and returns',
+                })),
+                {
+                    value: 'none',
+                    label: 'Another country',
+                    hint: 'the generic chart; taxes are yours to add',
+                },
+            ],
+            default: currency === 'BDT' ? 'BD' : currency === 'INR' ? 'IN' : 'none',
+        }))).toUpperCase();
+    const country = countryAnswer === 'NONE' ? '' : countryAnswer;
+    const langFlag = flag('lang');
+    if (langFlag !== undefined && !['en', 'bn'].includes(langFlag))
+        throw new Error('--lang: en or bn');
+    const lang = langFlag ??
+        (await choose(prompter, {
+            message: 'Language',
+            fallback: 'Language (en, bn)',
+            choices: [
+                { value: 'en', label: 'English' },
+                { value: 'bn', label: 'বাংলা', hint: 'Bangla' },
+            ],
+            default: 'en',
+        }));
     const tz = await q('tz', 'Time zone', Intl.DateTimeFormat().resolvedOptions().timeZone, {
         validate: (v) => {
             try {
@@ -355,36 +404,43 @@ async function ask(prompter, flags, cwd, positional, ui) {
             ui.warn('The passwords differ; try again.');
         }
     ui.step('apps', 'Apps', 'All are selected; remove the ones you do not need');
-    for (const key of SELECTABLE_APPS) {
-        const app = APPS[key];
-        ui.write(`  ${ui.terminal.emoji ? app.icon : ui.style('cyan', '•')}  ${ui.style('bold', key.padEnd(12))} ${ui.style('gray', app.label)}\n`);
-    }
-    const appList = await q('apps', 'Apps to install (comma-separated)', SELECTABLE_APPS.join(','), {
-        validate: (v) => {
-            const unknown = v
-                .split(',')
-                .map((s) => s.trim())
-                .filter((s) => s !== '' && !(s in APPS));
-            return unknown.length === 0 ? null : `Unknown: ${unknown.join(', ')}`;
-        },
-    });
-    const chosen = [
-        ...new Set(appList
-            .split(',')
-            .map((s) => s.trim())
-            .filter((s) => s in APPS)),
-    ];
-    // The bridges of the chosen apps come along (RFC 0008 §5.1).
-    const apps = [...chosen, ...bridgesFor(chosen).filter((b) => !chosen.includes(b))];
+    const appsFlag = flag('apps');
+    if (appsFlag === undefined && prompter.multiselect === undefined)
+        for (const key of SELECTABLE_APPS) {
+            const app = APPS[key];
+            ui.write(`  ${ui.terminal.emoji ? app.icon : ui.style('cyan', '•')}  ${ui.style('bold', key.padEnd(12))} ${ui.style('gray', app.label)}\n`);
+        }
+    const unknownApps = (appsFlag ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s !== '' && !(s in APPS));
+    if (unknownApps.length > 0)
+        throw new Error(`--apps: Unknown: ${unknownApps.join(', ')}`);
+    const appList = appsFlag?.split(',').map((s) => s.trim()) ??
+        (await chooseMany(prompter, {
+            message: 'Apps to install',
+            fallback: 'Apps to install (comma-separated)',
+            choices: SELECTABLE_APPS.map((key) => ({ value: key, label: key, hint: APPS[key].label })),
+            defaults: SELECTABLE_APPS,
+        }));
+    const chosen = [...new Set(appList.filter((s) => s in APPS))];
+    // The bridges of the chosen apps come along (RFC 0008 §5.1), and the country's localization (RFC 0016).
+    const apps = [...chosen, ...bridgesFor(chosen, country).filter((b) => !chosen.includes(b))];
     const demo = flags['demo'] === true ||
         (await prompter.confirm('  Load demo data (a sample company with orders, invoices and projects; not for production)?', false));
     ui.step('storage', 'File storage', 'Where attachments and generated documents are kept');
     let storage;
     const s3 = flag('s3-endpoint') !== undefined ||
         (flag('storage-dir') === undefined &&
-            (await q(null, 'Store files in (1) a folder or (2) S3-compatible storage', '1', {
-                validate: (v) => (v === '1' || v === '2' ? null : '1 or 2'),
-            })) === '2');
+            (await choose(prompter, {
+                message: 'Where are files kept?',
+                fallback: 'Store files in (1) a folder or (2) S3-compatible storage',
+                choices: [
+                    { value: 'dir', label: 'A folder on this server', hint: './var/attachments' },
+                    { value: 's3', label: 'S3-compatible storage', hint: 'AWS S3, MinIO, SeaweedFS, R2' },
+                ],
+                default: 'dir',
+            })) === 's3');
     if (s3)
         storage = {
             kind: 's3',
@@ -407,17 +463,20 @@ async function ask(prompter, flags, cwd, positional, ui) {
         };
     else
         storage = { kind: 'dir', dir: await q('storage-dir', 'Folder', './var/attachments') };
-    ui.step('server', 'Server', 'The API port and an optional shared cache');
-    const valkeyUrl = await q('valkey-url', 'Valkey/Redis URL (optional, Enter to skip)', '');
-    const port = Number(await q('port', 'API port', '3000', {
-        validate: (v) => /^\d+$/.test(v) && Number(v) > 0 && Number(v) < 65536 ? null : 'A port number',
+    ui.step('server', 'Server', 'The ports of the API and the back-office, and an optional shared cache');
+    const portNumber = (v) => /^\d+$/.test(v) && Number(v) > 0 && Number(v) < 65536 ? null : 'A port number (1–65535)';
+    const port = Number(await q('port', 'API port', String(await freePort(3000)), { validate: portNumber }));
+    const webPort = Number(await q('web-port', 'Back-office (web) port', String(await freePort(port === 5173 ? 5174 : 5173)), {
+        validate: (v) => portNumber(v) ?? (Number(v) === port ? 'Another port than the API' : null),
     }));
+    const valkeyUrl = await q('valkey-url', 'Valkey/Redis URL (optional, Enter to skip)', '');
     return {
         dir,
         name,
         databaseUrl,
         company,
         currency,
+        country,
         lang,
         tz,
         admin: { login, name: adminName, email, password: password },
@@ -426,6 +485,7 @@ async function ask(prompter, flags, cwd, positional, ui) {
         storage,
         valkeyUrl,
         port,
+        webPort,
         postgres,
         dockerDb,
         vapid: (await import('../notify/index.js')).generateVapidKeys(),
@@ -444,6 +504,7 @@ async function modulesFor(apps) {
         (await import('../mail/index.js')).mail,
         (await import('../automation/index.js')).automation,
         (await import('../studio/index.js')).studio,
+        (await import('../import/index.js')).dataImport,
     ];
     for (const app of apps) {
         if (app === 'permissions')
@@ -471,22 +532,26 @@ async function modulesFor(apps) {
             modules.push((await import('../project/index.js')).project);
         if (app === 'sale_project')
             modules.push((await import('../sale_project/index.js')).saleProject);
+        if (app === 'l10n_bd')
+            modules.push((await import('../l10n_bd/index.js')).l10nBd);
+        if (app === 'l10n_in')
+            modules.push((await import('../l10n_in/index.js')).l10nIn);
     }
     return modules;
 }
 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:5173', '# 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`;
 }
@@ -496,6 +561,7 @@ async function writeProject(a, ui) {
         name: a.name,
         apps: a.apps,
         port: a.port,
+        webPort: a.webPort,
         koshVersion: releaseVersion(),
         dockerDb: a.postgres.db,
         fileStorage: a.storage.kind === 'dir',
@@ -552,15 +618,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({
@@ -568,8 +656,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({
@@ -588,7 +676,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')
@@ -681,10 +769,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],
@@ -694,6 +782,7 @@ export async function runInit(argv, io) {
             'create-database': { type: 'boolean' },
             company: { type: 'string' },
             currency: { type: 'string' },
+            country: { type: 'string' },
             lang: { type: 'string' },
             tz: { type: 'string' },
             'admin-login': { type: 'string' },
@@ -709,7 +798,9 @@ export async function runInit(argv, io) {
             's3-region': { type: 'string' },
             'valkey-url': { type: 'string' },
             port: { type: 'string' },
+            'web-port': { type: 'string' },
             'no-2fa': { type: 'boolean' },
+            'no-start': { type: 'boolean' },
             demo: { type: 'boolean' },
             'docker-db': { type: 'boolean' },
             yes: { type: 'boolean', short: 'y' },
@@ -723,15 +814,34 @@ export async function runInit(argv, io) {
     const terminal = io.terminal ?? PLAIN_TERMINAL;
     const interactive2fa = values['no-2fa'] !== true && values.yes !== true;
     // Six question steps, then the project files and the database, then (interactively) the second factor.
-    const ui = createUi(io.write, terminal, { steps: interactive2fa ? 9 : 8 });
+    // At the end, in a terminal: install, start and open the installation (not for scripts, CI and tests).
+    const autoStart = values['no-start'] !== true && io.prompter === undefined && process.stdout.isTTY === true;
+    const ui = createUi(io.write, terminal, {
+        steps: (interactive2fa ? 9 : 8) + (autoStart ? 1 : 0),
+    });
+    const interactive = io.prompter === undefined &&
+        values.yes !== true &&
+        process.stdin.isTTY === true &&
+        railed(terminal);
     const asked = io.prompter ??
         (values.yes === true
             ? defaultsPrompter()
-            : terminalPrompter(process.stdin, process.stdout, {
-                marker: ui.style('cyan', '? '),
-                fallback: (t) => ui.style('gray', t),
-                problem: (t) => ui.style('yellow', `${terminal.unicode ? '▲' : '!'} ${t}`),
-            }));
+            : interactive
+                ? interactivePrompter(process.stdin, process.stdout, terminal)
+                : terminalPrompter(process.stdin, process.stdout, {
+                    marker: ui.style('cyan', '? '),
+                    fallback: (t) => ui.style('gray', t),
+                    problem: (t) => ui.style('yellow', `${terminal.unicode ? '▲' : '!'} ${t}`),
+                }));
+    const paused = async (work) => {
+        ui.pause();
+        try {
+            return await work();
+        }
+        finally {
+            ui.resume();
+        }
+    };
     // A question stops the spinner while it is asked (the prompter writes to the terminal itself).
     const prompter = {
         async ask(q) {
@@ -752,13 +862,23 @@ export async function runInit(argv, io) {
                 ui.resume();
             }
         },
+        ...(asked.select === undefined
+            ? {}
+            : { select: (q) => paused(() => asked.select(q)) }),
+        ...(asked.multiselect === undefined
+            ? {}
+            : {
+                multiselect: (q) => paused(() => asked.multiselect(q)),
+            }),
         close: () => asked.close(),
     };
     let server;
     const started = Date.now();
     try {
-        await ui.banner(`The ERP framework on Shutro · v${releaseVersion()}`);
-        ui.write(`  ${ui.style('gray', 'Kosh setup: press Enter to keep the value in [brackets].')}\n`);
+        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'
+            : '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 () => {
@@ -801,9 +921,12 @@ 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', `${answers.company} (${answers.currency})`],
+            [
+                'Company',
+                `${answers.company} (${answers.currency}${answers.country === '' ? '' : `, ${answers.country}`})`,
+            ],
             [
                 'Administrator',
                 `${answers.admin.login} ${ui.style(enrolled ? 'green' : 'yellow', enrolled ? '· 2FA on' : '· 2FA pending')}`,
@@ -818,6 +941,7 @@ export async function runInit(argv, io) {
                     'mail',
                     'automation',
                     'studio',
+                    'import',
                     ...answers.apps,
                 ].join(', '),
             ],
@@ -825,22 +949,44 @@ export async function runInit(argv, io) {
                 ? [['Demo users', `dina, rahim, karim, sumi · password "${DEMO_PASSWORD}"`]]
                 : []),
             ['Database', answers.dockerDb ? `Docker (port ${answers.postgres.port})` : 'your server'],
+            ['Back-office', `http://localhost:${answers.webPort}`],
             ['API', `http://localhost:${answers.port}`],
             ['Took', `${((Date.now() - started) / 1000).toFixed(1)}s`],
         ];
-        ui.card(`${terminal.emoji ? '🚀 ' : ''}Kosh is set up`, rows, enrolled || values['no-2fa'] === true ? 'green' : 'yellow');
+        if (!autoStart)
+            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 `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;
+            await launch({
+                dir: answers.dir,
+                port: answers.port,
+                webPort: answers.webPort,
+                login: answers.admin.login,
+            }, ui);
+            return 0;
+        }
         const relative = answers.dir === resolve(io.cwd) ? '' : `cd ${positionals[0] ?? answers.dir}\n  `;
         const cmd = (c) => ui.style('cyan', c);
         ui.write(`\n  ${ui.style('bold', 'Next')}\n  ${relative}${cmd('npm install')}\n  ${cmd('npm start')}          ${ui.style('gray', `# the API on http://localhost:${answers.port}`)}\n` +
-            `  ${cmd('npm run web')}        ${ui.style('gray', '# the back-office on http://localhost:5173')}\n\n` +
+            `  ${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) {
+        if (error instanceof CancelledError) {
+            ui.outro(ui.style('red', 'Setup cancelled: nothing more was done.'));
+            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.d.ts

@@ -0,0 +1,16 @@
+import type { Ui } from './ui.js';
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/** The package manager that ran the CLI (`npx`, `pnpm dlx`, `yarn dlx`, `bunx`), from its user agent; npm otherwise. */
+export declare function packageManager(env?: NodeJS.ProcessEnv): PackageManager;
+/** The command that opens `url` in the default browser on `platform`. */
+export declare function browserCommand(url: string, platform?: string): readonly [string, readonly string[]];
+export interface LaunchOptions {
+    readonly dir: string;
+    readonly port: number;
+    readonly webPort: number;
+    readonly login: string;
+}
+/**
+ * Installs, starts and opens the installation; returns when the user stops it (Ctrl+C) or a server stops by itself.
+ */
+export declare function launch(o: LaunchOptions, ui: Ui): Promise<void>;