@getxflow/cli 1.3.0 → 1.5.0

package/README.md

@@ -10,7 +10,7 @@ cd my-app/apps/my-app && npm install && xflow dev
 xflow deploy -m "First version"
 ```
 
-Requires Node 20+. The package has no dependencies: it holds an access key, and nobody
+Requires Node 22+. The package has no dependencies: it holds an access key, and nobody
 else's code belongs next to it.
 
 | Command | What it does |

package/dist/bin.js

@@ -180,15 +180,11 @@ async function run(args) {
                 await (0, db_1.dbExec)({ ...args, words: args.words.slice(2) });
                 return;
             }
-            if (second === 'move') {
-                await (0, db_1.dbMove)(rest);
-                return;
-            }
             if (second === undefined || second === 'status') {
                 await (0, db_1.dbStatus)({ ...args, words: args.words.slice(2) });
                 return;
             }
-            throw new errors_1.CliError(`Unknown command: db ${second}`, 'Available: status, list, schema, query, exec, migrate and move');
+            throw new errors_1.CliError(`Unknown command: db ${second}`, 'Available: status, list, schema, query, exec and migrate');
         case 'storage':
             if (second === 'push') {
                 await (0, storage_1.storagePush)(rest);

package/dist/commands/db.js

@@ -5,7 +5,6 @@ exports.dbList = dbList;
 exports.dbSchema = dbSchema;
 exports.dbQuery = dbQuery;
 exports.dbExec = dbExec;
-exports.dbMove = dbMove;
 exports.dbMigrate = dbMigrate;
 exports.migrateBeforeDeploy = migrateBeforeDeploy;
 const node_fs_1 = require("node:fs");
@@ -20,41 +19,6 @@ const ui_1 = require("../ui");
 const sources_1 = require("./sources");
 /** Migration files live in the repo; the applied history lives in the database. */
 const MIGRATIONS_DIR = 'migrations';
-function serverLabel(server) {
-    if (server === undefined)
-        return '-';
-    if (server === null)
-        return 'platform';
-    return server.status === 'active' ? `own "${server.name}"` : `own "${server.name}", ${server.status}`;
-}
-const moving = (move) => move?.status === 'copying' || move?.status === 'switching';
-/** Asked apart from the history: during a move the database does not answer, this does. */
-async function projectDatabase(client, projectId) {
-    try {
-        return await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/db/move`);
-    }
-    catch (e) {
-        if (e instanceof api_1.ApiError && e.code === 'not_deployed')
-            return null;
-        throw e;
-    }
-}
-function printPlace(history, place) {
-    (0, ui_1.out)(`Schema: ${(0, ui_1.bold)(history.schema)}`);
-    if (history.server !== undefined)
-        (0, ui_1.out)(`Server: ${serverLabel(history.server)}`);
-    if (place?.move)
-        (0, ui_1.out)(`Move:   ${moveLine(place.move)}`);
-    (0, ui_1.out)('');
-}
-/** Mid-move the history cannot be read, so the answer is the move itself. */
-function printMoving(place) {
-    if (place.database)
-        (0, ui_1.out)(`Database: ${(0, ui_1.bold)(place.database.name)}`);
-    (0, ui_1.out)(`Server:   ${serverLabel(place.server)}`);
-    (0, ui_1.out)(`Move:     ${place.move?.note ?? ''}`);
-    (0, ui_1.note)((0, ui_1.dim)('  Migrations and queries wait until it is over; the platform finishes it on its own'));
-}
 const STATE_LABEL = {
     pending: 'waiting',
     applied: 'applied',
@@ -86,11 +50,9 @@ async function dbStatus(args) {
     // is the applied history alone, which does not depend on any working copy.
     if ((0, args_1.flagString)(args, 'project') !== undefined) {
         const { projectId, client } = await (0, session_1.projectTarget)(args);
-        const place = await projectDatabase(client, projectId);
-        if (place && moving(place.move))
-            return printMoving(place);
         const history = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/db/migrate`);
-        printPlace(history, place);
+        (0, ui_1.out)(`Schema: ${(0, ui_1.bold)(history.schema)}`);
+        (0, ui_1.out)('');
         if (history.applied.length === 0) {
             (0, ui_1.note)('No migrations have been applied yet');
             return;
@@ -102,15 +64,13 @@ async function dbStatus(args) {
     const { root, config } = (0, config_1.requireProject)();
     const client = await (0, session_1.connectProject)(config.projectId, root, config);
     const local = readMigrations(root);
-    const place = await projectDatabase(client, config.projectId);
-    if (place && moving(place.move))
-        return printMoving(place);
     const status = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/db/status`, {
         method: 'POST',
         body: { migrations: local },
         timeoutMs: 60_000,
     });
-    printPlace({ schema: status.schema, server: status.server, applied: [] }, place);
+    (0, ui_1.out)(`Schema: ${(0, ui_1.bold)(status.schema)}`);
+    (0, ui_1.out)('');
     if (status.migrations.length === 0) {
         (0, ui_1.note)(`No migrations. The first one: ${MIGRATIONS_DIR}/0001_init.sql`);
         return;
@@ -121,65 +81,23 @@ async function dbStatus(args) {
         (0, ui_1.warn)('A changed file is never applied again and db migrate refuses it: write a new migration');
     }
 }
-function serverRow(server) {
-    const room = server.used_bytes !== null && server.space_bytes !== null
-        ? `${(0, ui_1.formatBytes)(server.used_bytes)} of ${(0, ui_1.formatBytes)(server.space_bytes)} used`
-        : '';
-    return [
-        server.id === null ? 'platform' : `own "${server.name}"`,
-        server.id === null ? 'plan space' : server.tier ?? '',
-        server.status === 'active' ? '' : server.status,
-        room,
-        `${server.databases} ${server.databases === 1 ? 'database' : 'databases'}`,
-    ];
-}
-/** The databases of the projects of the organization, and the servers they can live on. */
+/** The databases of the projects of the organization, largest first. */
 async function dbList() {
     const client = (0, session_1.connect)((0, config_1.localConfig)());
     const data = await (0, api_1.apiJson)(client, '/api/v1/org/databases');
     if (data.databases.length === 0) {
         (0, ui_1.note)('The organization has no databases');
         (0, ui_1.note)((0, ui_1.dim)('  One is created with the first project: xflow init'));
+        return;
     }
-    else {
-        printDatabases(data.databases, data.total, data.truncated);
-    }
-    printServers(data.servers);
-}
-function moveLine(move) {
-    return move.finished_at ? `${move.note} (${(0, ui_1.formatAge)(move.finished_at)})` : move.note;
-}
-function printDatabases(databases, total, truncated) {
-    (0, ui_1.table)(databases.map((database) => [
+    (0, ui_1.table)(data.databases.map((database) => [
         database.name,
         database.id,
-        database.schema ?? '-',
-        serverLabel(database.server),
-        typeof database.bytes === 'number' ? (0, ui_1.formatBytes)(database.bytes) : '',
+        database.schema_name,
+        database.bytes === null ? '' : (0, ui_1.formatBytes)(database.bytes),
     ]));
-    if (truncated)
-        (0, ui_1.note)((0, ui_1.dim)(`  Shown ${databases.length} of ${total}`));
-    for (const database of databases) {
-        if (database.move)
-            (0, ui_1.note)((0, ui_1.dim)(`  ${database.name}: ${moveLine(database.move)}`));
-    }
-    const down = new Map();
-    for (const { server } of databases)
-        if (server && server.status !== 'active')
-            down.set(server.id, server);
-    for (const server of down.values()) {
-        (0, ui_1.note)((0, ui_1.dim)(`  Server "${server.name}" is not running (${server.status}): its databases do not answer until it is back. ` +
-            'Not fixable from the code: tell the person, the server state is in the «Базы данных» (Databases) section of the web interface'));
-    }
-}
-/** Where a new or a moved database can go, with the room on each. Only the platform: no choice to show. */
-function printServers(servers) {
-    if (!servers || servers.length < 2)
-        return;
-    (0, ui_1.out)('');
-    (0, ui_1.out)((0, ui_1.bold)('Servers'));
-    (0, ui_1.table)(servers.map(serverRow));
-    (0, ui_1.note)((0, ui_1.dim)('  Without --server a new project keeps its database on the platform server. To put it on another: xflow init --server <name>, or xflow db move --to <name> for one that already exists'));
+    if (data.truncated)
+        (0, ui_1.note)((0, ui_1.dim)(`  Shown ${data.databases.length} of ${data.total}`));
 }
 /** Long values would tear the columns apart; the cut is marked, never silent. */
 const CELL_LIMIT = 60;
@@ -328,64 +246,6 @@ async function dbExec(args) {
             (0, ui_1.note)((0, ui_1.dim)(`  The first ${data.rows.length} returned rows: the rest are saved but not sent back`));
     }
 }
-const MOVE_POLL_MS = 3_000;
-/** Past this the command lets go: the move carries on, db status follows it. */
-const MOVE_FOLLOW_MS = 10 * 60_000;
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/**
- * Moving the project database to another server of the organization. The platform
- * runs the move by itself; this command starts it and follows it to the end.
- */
-async function dbMove(args) {
-    const to = (0, args_1.flagString)(args, 'to');
-    if (!to) {
-        throw new errors_1.CliError('Name the server: --to <name>', 'The servers and their names: xflow db list ("platform" is the common one)');
-    }
-    const { projectId, client } = await (0, session_1.projectTarget)(args);
-    const path = `/api/v1/projects/${projectId}/db/move`;
-    let place;
-    // The platform takes the project name as the yes; --yes looks it up.
-    const confirm = (0, args_1.flagBool)(args, 'yes')
-        ? (await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`)).name
-        : undefined;
-    try {
-        place = await (0, api_1.apiJson)(client, path, {
-            method: 'POST',
-            body: { to, confirm },
-            timeoutMs: 60_000,
-        });
-    }
-    catch (e) {
-        // Said in the words of this command: the flag, and the name that goes in it.
-        if (e instanceof api_1.ApiError && e.code === 'confirm_required') {
-            throw new errors_1.CliError(e.message, `To move it: xflow db move --to "${to}" --yes`);
-        }
-        throw e;
-    }
-    (0, ui_1.note)((0, ui_1.dim)('  The platform carries the move through by itself: stopping this command does not stop it'));
-    const deadline = Date.now() + MOVE_FOLLOW_MS;
-    let shown = '';
-    while (moving(place.move)) {
-        const line = place.move?.note ?? '';
-        if (line !== shown)
-            (0, ui_1.step)(line);
-        shown = line;
-        if (Date.now() > deadline) {
-            (0, ui_1.note)('Still going: xflow db status follows it');
-            return;
-        }
-        await sleep(MOVE_POLL_MS);
-        place = await (0, api_1.apiJson)(client, path);
-    }
-    const { move } = place;
-    if (move?.status === 'failed')
-        throw new errors_1.CliError(move.note);
-    if (move && (move.functions_done ?? 0) < (move.functions_total ?? 0)) {
-        (0, ui_1.warn)(move.note);
-        return;
-    }
-    (0, ui_1.ok)(move?.note ?? `The database is on ${serverLabel(place.server)}`);
-}
 async function dbMigrate(args) {
     const { root, config } = (0, config_1.requireProject)();
     const client = await (0, session_1.connectProject)(config.projectId, root, config);

package/dist/commands/org.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.orgList = orgList;
 exports.orgMembers = orgMembers;
+exports.findOrg = findOrg;
 exports.orgSwitch = orgSwitch;
 const api_1 = require("../api");
 const config_1 = require("../config");
@@ -47,6 +48,19 @@ async function orgMembers() {
     const count = data.truncated ? `${data.members.length} of ${data.total}` : String(data.total);
     (0, ui_1.note)((0, ui_1.dim)(`  ${count} in "${org ? label(org) : 'the organization'}". Inviting and removing people happens in the platform interface`));
 }
+/** An organization by id, or by name ignoring case; a name shared by several asks for the id. */
+function findOrg(orgs, wanted) {
+    const byId = orgs.find((org) => org.organizationId === wanted);
+    if (byId)
+        return byId;
+    const byName = orgs.filter((org) => (org.name ?? '').toLowerCase() === wanted.toLowerCase());
+    if (byName.length > 1) {
+        throw new errors_1.CliError(`Several organizations are named "${wanted}"`, `Use the id instead: ${byName.map((org) => org.organizationId).join(', ')}`);
+    }
+    if (!byName[0])
+        throw new errors_1.CliError(`No stored key for "${wanted}"`, 'The list: xflow org. To add one: xflow login');
+    return byName[0];
+}
 /** Local switch of the active organization: a pointer move, no browser. */
 function orgSwitch(args) {
     const wanted = args.words[0];
@@ -57,15 +71,7 @@ function orgSwitch(args) {
     if (orgs.length === 0) {
         throw new errors_1.CliError(`No keys for ${apiUrl}`, 'Sign in: xflow login');
     }
-    const byId = orgs.find((org) => org.organizationId === wanted);
-    const byName = orgs.filter((org) => (org.name ?? '').toLowerCase() === wanted.toLowerCase());
-    if (!byId && byName.length > 1) {
-        throw new errors_1.CliError(`Several organizations are named "${wanted}"`, `Use the id instead: ${byName.map((org) => org.organizationId).join(', ')}`);
-    }
-    const target = byId ?? byName[0];
-    if (!target) {
-        throw new errors_1.CliError(`No stored key for "${wanted}"`, 'The list: xflow org. To add one: xflow login');
-    }
+    const target = findOrg(orgs, wanted);
     if (target.active) {
         (0, ui_1.ok)(`"${label(target)}" is already the active organization`);
         return;

package/dist/commands/projects.js

@@ -13,6 +13,7 @@ const args_1 = require("../args");
 const config_1 = require("../config");
 const credentials_1 = require("../credentials");
 const errors_1 = require("../errors");
+const org_1 = require("./org");
 const session_1 = require("../session");
 const skills_1 = require("./skills");
 const sources_1 = require("./sources");
@@ -61,15 +62,28 @@ async function init(args) {
     const target = (0, node_path_1.resolve)(args.words[0] ?? '.');
     const name = (0, args_1.flagString)(args, 'name') ?? (0, node_path_1.basename)(target);
     const noApp = (0, args_1.flagBool)(args, 'no-app');
-    const client = (0, session_1.connect)();
+    let client = (0, session_1.connect)();
+    // A person in several organizations names the one that gets the project: the active one may be a client's.
+    const orgs = client.source === 'env' ? [] : (0, credentials_1.listOrgs)(client.apiUrl);
+    const wanted = (0, args_1.flagString)(args, 'org');
+    if (wanted) {
+        if (client.source === 'env')
+            throw new errors_1.CliError('--org does not apply to a key from XFLOW_TOKEN', 'That key belongs to one organization: drop --org');
+        const org = (0, org_1.findOrg)(orgs, wanted);
+        client = { apiUrl: client.apiUrl, token: org.token, source: 'folder', organizationId: org.organizationId };
+    }
+    else if (orgs.length > 1) {
+        throw new errors_1.CliError(`You are signed in to ${orgs.length} organizations: name the one that gets the project`, `xflow init ${args.words[0] ?? '.'} --org <name>. The list: xflow org`);
+    }
+    const orgName = orgs.find((org) => org.organizationId === client.organizationId)?.name;
     if (!isEmptyEnough(target)) {
         throw new errors_1.CliError(`The directory ${target} is not empty`, 'Create the project in an empty folder: xflow init my-project. To link an existing folder to a project: xflow link <id>');
     }
     const folder = noApp ? null : checkFolder((0, args_1.flagString)(args, 'app') ?? (0, sources_1.appFolderName)(name, new Set(), 'app'));
-    (0, ui_1.step)('Creating the project on the platform');
+    (0, ui_1.step)(orgName ? `Creating the project in "${orgName}"` : 'Creating the project on the platform');
     const project = await (0, api_1.apiJson)(client, '/api/v1/projects', {
         method: 'POST',
-        body: { name, app: folder ? { name } : null, server: (0, args_1.flagString)(args, 'server') ?? null },
+        body: { name, app: folder ? { name } : null },
         timeoutMs: 60_000,
     });
     try {
@@ -91,8 +105,6 @@ async function init(args) {
     }
     (0, skills_1.installSkillQuietly)(target);
     (0, ui_1.ok)(`Project "${project.name}" created`);
-    if (project.server)
-        (0, ui_1.note)((0, ui_1.dim)(`  Its database goes to the own server "${project.server.name}"`));
     (0, ui_1.out)('');
     (0, ui_1.out)(`  ${(0, ui_1.bold)('Next:')}`);
     (0, ui_1.out)(`    cd ${(0, node_path_1.basename)(target)}`);
@@ -251,7 +263,7 @@ async function get(args) {
     if (card.description)
         (0, ui_1.out)(card.description);
     (0, ui_1.out)('');
-    (0, ui_1.out)(`Database: ${card.database.schema}${card.database.server_id ? ' (own server)' : ''}`);
+    (0, ui_1.out)(`Database: ${card.database.schema}`);
     (0, ui_1.out)('');
     (0, ui_1.out)('Apps:');
     if (card.apps.length === 0)

package/dist/flags.js

@@ -44,7 +44,7 @@ exports.KNOWN = {
     'org list': [],
     'org members': [],
     'org switch': [],
-    init: ['name', 'app', 'no-app', 'server'],
+    init: ['name', 'app', 'no-app', 'org'],
     link: [],
     projects: [],
     'projects list': [],
@@ -81,7 +81,6 @@ exports.KNOWN = {
     'db query': ['json', 'project'],
     'db exec': ['allow-destructive', 'json', 'project'],
     'db migrate': ['dry-run', 'allow-destructive'],
-    'db move': ['to', 'yes', 'project'],
     storage: ['json', 'project'],
     'storage ls': ['json', 'project'],
     'storage list': ['json', 'project'],
@@ -118,7 +117,7 @@ exports.KNOWN = {
  * line here, or a refusal nobody prints any more stays behind as a lie.
  */
 exports.WORKING_COPY = {
-    pull: 'it writes the sources next to it',
+    pull: 'it writes the sources next to it. A project without a folder comes down whole with xflow link <id> in an empty one',
     status: 'it compares the folder with the revision on the platform',
     dev: 'it runs the dev server of the app folder it stands in',
     'apps add': 'it lays the template into apps/',

package/dist/help.js

@@ -91,14 +91,12 @@ ${(0, ui_1.bold)('Functions')}
 
 ${(0, ui_1.bold)('Database')}
   xflow db status                 which migrations are applied and which are waiting
-  xflow db list                   databases of the projects and the servers of the organization
+  xflow db list                   databases of the projects of the organization, with sizes
   xflow db schema [table]         tables of the project, or the columns of one
   xflow db query 'select ...'     read data, in a read-only transaction
   xflow db exec 'update ...'      a one-off data change, outside the migration history
   xflow db migrate [--dry-run] [--allow-destructive]
                                   apply the migrations from migrations/*.sql
-  xflow db move --to <server> --yes
-                                  move the project database to another server
 
 ${(0, ui_1.bold)('Pages')}
   xflow pages                     public sites of the organization at <name>.xflowpage.ru
@@ -173,7 +171,7 @@ no working copy of its own:
   xflow db query --project 3f2a… 'select id, title from tasks where done = false'
   xflow functions invoke kanban --project 3f2a… --data-file card.json
 
-Which commands: ${(0, ui_1.bold)('db status')}, ${(0, ui_1.bold)('db query')}, ${(0, ui_1.bold)('db exec')}, ${(0, ui_1.bold)('db schema')}, ${(0, ui_1.bold)('db move')}, ${(0, ui_1.bold)('functions list')},
+Which commands: ${(0, ui_1.bold)('db status')}, ${(0, ui_1.bold)('db query')}, ${(0, ui_1.bold)('db exec')}, ${(0, ui_1.bold)('db schema')}, ${(0, ui_1.bold)('functions list')},
 ${(0, ui_1.bold)('functions invoke')}, ${(0, ui_1.bold)('functions logs')}, ${(0, ui_1.bold)('logs')}, ${(0, ui_1.bold)('env')}, ${(0, ui_1.bold)('env rm')},
 ${(0, ui_1.bold)('connections')}, ${(0, ui_1.bold)('connections link')}, ${(0, ui_1.bold)('connections unlink')}, ${(0, ui_1.bold)('schedules')},
 ${(0, ui_1.bold)('schedules set')}, ${(0, ui_1.bold)('schedules rm')}, ${(0, ui_1.bold)('storage ls')}, ${(0, ui_1.bold)('storage push')},
@@ -336,8 +334,8 @@ is a hard gate on a changed contract, and until you run this command nothing els
 will work.`,
     db: `${(0, ui_1.bold)('xflow db')}: schema, data, migrations
 
-  xflow db status                  what is applied, what is waiting, the server
-  xflow db list                    databases of the projects, the servers of the organization
+  xflow db status                  what is applied, what is waiting
+  xflow db list                    databases of the projects of the organization, with sizes
   xflow db schema [table]          tables of the project, or the columns of one
   xflow db query 'select ...'      read data (rows: the query's own limit, 50 without
                                    one, 300 at most; --json prints the values whole)
@@ -345,26 +343,10 @@ will work.`,
   xflow db exec 'update ...'       a one-off data change: one INSERT, UPDATE, DELETE or MERGE
                                    (or <file>.sql; --allow-destructive, --json)
   xflow db migrate                 store the project root, then apply migrations/*.sql
-  xflow db move --to <server> --yes
-                                   move the project database to another server
 
 Every project has exactly one database of its own, shared by all of its apps and functions,
 and every command here works from any folder of the project. ${(0, ui_1.bold)('list')} is about the
-organization: one database per project, and where each lives: ${(0, ui_1.bold)('platform')} is the common
-server, ${(0, ui_1.bold)('own "<name>"')} an own server of the organization. While an own server is not
-running, its databases do not answer, and that is not fixable from the code. An organization
-with own servers also gets them listed, with the room used on each: that is the choice for
-${(0, ui_1.bold)('xflow init --server')} and ${(0, ui_1.bold)('db move')}.
-
-${(0, ui_1.bold)('move')} takes the database of this project to another server of the organization:
-${(0, ui_1.bold)('platform')} or an own server by name (or id, when two share a name). The platform copies
-the tables, switches the functions of the project and removes the old copy; nothing needs a
-deploy. While it copies, the apps read data but cannot save anything new, usually for a
-couple of minutes, which is why it asks for ${(0, ui_1.bold)('--yes')}. It also needs the
-right to move databases on the key: off by default, only its owner turns it on, in the
-platform settings where the key permissions live. The command follows the move to the end;
-stopping it does not stop the move, and ${(0, ui_1.bold)('xflow db status')} shows where it stands. A move
-that fails is rolled back. Buying, paying for and deleting servers stay with the person.
+organization: one database per project, largest first, to see which project takes the room.
 
 ${(0, ui_1.bold)('schema')} answers a different question than the ${(0, ui_1.bold)('migrations/')} directory: the files say
 what you did, the schema says what is actually in there. ${(0, ui_1.bold)('query')} runs inside a READ ONLY transaction, so
@@ -776,8 +758,8 @@ change them, restyle them or delete what you do not use.
   --name <name>       project name (the folder name by default)
   --app <folder>      the folder of the first app (made from the name by default)
   --no-app            a project without apps: its functions are workflows
-  --server <name>     the database of the project, right away on that server:
-                      platform, or an own server of the organization (xflow db list)
+  --org <name>        the organization that gets the project; required when you are
+                      signed in to several (xflow org)
 
 More apps later: ${(0, ui_1.bold)('xflow apps add <folder>')}. If writing the files fails, the project stays
 on the platform and the CLI says how to pick it up with the link command.`,

package/dist/version.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
 /** Keep in sync with cli/package.json. */
-exports.CLI_VERSION = '1.3.0';
+exports.CLI_VERSION = '1.5.0';
 /** Overridden by XFLOW_API_URL or the `api` field in xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@getxflow/cli",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "CLI for the XFlow platform: projects with apps, functions and a database; source sync, deployment and publishing",
   "license": "UNLICENSED",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "bin": {
     "xflow": "dist/bin.js"

package/skills/xflow/SKILL.md

@@ -12,7 +12,8 @@ address and runs its backend: one database and cloud functions per project.
 No `xflow.json` in the folder or above it means it is not bound to a project yet:
 `xflow projects list` names the projects of the organization with their ids, `xflow link <id>`
 binds the folder to one (an empty folder gets the whole project), and `xflow init` starts a new
-project with its first app.
+project with its first app. A person signed in to several organizations names the one that gets it:
+`xflow init <dir> --org <name>` (ask them which one if unsure; `xflow org` lists them).
 
 ## First rule
 
@@ -27,7 +28,7 @@ instead of guessing; give the person https://docs.getxflow.com when they ask how
 
 ## Keeping these instructions current
 
-These instructions ship with xflow CLI 1.3.0, so the copy you are reading can be older than
+These instructions ship with xflow CLI 1.5.0, so the copy you are reading can be older than
 the CLI answering your commands.
 
 When the CLI says this file does not match it, run `xflow skills --refresh` and then **read
@@ -61,8 +62,8 @@ the error points away from the cause. The sections below carry the details.
 6. An already applied migration is never re-run, and `xflow db migrate` refuses a
    name it already holds with different content. A schema change is always a new file.
 7. When `xflow db migrate` answers `db_write_locked`, or an INSERT or CREATE TABLE in a
-   function fails with `permission denied` (42501), the database is over its plan size and
-   Postgres itself refuses. Reads, updates and deletes keep working, so the fix is deleting data
+   function fails with `database size limit ... reached` (53100), the database is over its plan
+   size and Postgres itself refuses. Reads, updates and deletes keep working, so the fix is deleting data
    (`xflow db exec` or a migration), never a rewrite of the SQL. Write comes back within the hour. The limit
    is shared by the organization: `xflow db list` shows the size of each project database.
 8. Heavy media does not travel with the sources. Photos, video and PDFs go up with
@@ -566,30 +567,20 @@ needs deleting and why, and let the person decide. With both in place the affect
 dumped first (up to 50 000 rows each) and kept for 7 days; getting a dump back is a request to
 the person, no command does it. Check with `--dry-run`.
 
-An organization can have own database servers. `xflow db list` names the server of each project
-database (`platform` is the common one) and the own servers with the room used.
-- A new project with its database on a chosen server: `xflow init --server <name>`.
-- An existing one: `xflow db move --to <name> --yes`. Writes close while it
-  copies, usually a couple of minutes; the platform switches the functions itself. It needs the
-  right to move databases, off on the key by default: refused for the right, say what should move
-  where and why, and the person turns it on or moves it in the «Базы данных» (Databases) section.
-- Buying, paying for and deleting servers are the person's, in the web interface.
-
-Code stays the same on an own server: pass `DATABASE_URL` as is, without an `ssl` option. While
-an own server is not running, migrations and queries say so and functions that use the database
-time out: tell the person instead of retrying.
-
-An own server comes tuned and guarded, so do not tune it from migrations:
-- Installed: `pgcrypto`, `pg_trgm`, `unaccent`, `citext`, `btree_gin`, `btree_gist`,
-  `pg_stat_statements`. `gen_random_uuid()` is built in everywhere, `uuidv7()` on an own server.
-  Never `uuid-ossp`. Anything else (`postgis`, `pgvector`) is a request to the person.
-- A statement is cut after 30 seconds, waiting for a lock after 3, a transaction left open after
-  30. A query that needs longer is a wrong query (a missing index, or a report that belongs in a
-  scheduled function writing a summary table). A scheduled job that genuinely needs more runs
-  `SET statement_timeout = '5min'` on its own connection. A database that used `citext` or
-  another extension type cannot move back to `platform`.
-- A restart on a plan change takes about a minute. Create the `Client` inside the handler, or
-  keep a `Pool` at module level: a `Client` created at module level dies with the restart.
+Pass `DATABASE_URL` as is, without an `ssl` option. The database is PostgreSQL 18, so do not
+tune it from migrations:
+- Installed: `pg_trgm`. `gen_random_uuid()` and `uuidv7()` are built in. Never `uuid-ossp`.
+  Anything else (`postgis`, `pgvector`) is a request to the person.
+- A statement is cut after 30 seconds, waiting for a lock after 10, a transaction left open after
+  60. A query that needs longer is a wrong query (a missing index, or a report that belongs in a
+  scheduled function writing a summary table).
+
+Calls of one project run at the same time in one process. A `Client`, even one made at module
+level, gets its own pooled connection for each call, so `connect()` twice is fine. Keep
+per-request data out of module-level variables. Session state (`SET` without `LOCAL`, temp tables,
+advisory locks) lasts until the call ends, and a transaction left open is rolled back: set what
+the call needs inside the handler. A `Client` that listens for `notification` keeps its own
+connection.
 
 ## File storage