@inquir/compute-cli 0.4.2 → 0.4.4

package/dist/commands/apps-replicas.js

@@ -0,0 +1,278 @@
+import { cancelApplicationRollout, deleteAppReplicaVolumes, getAppReplicas, listApplicationRollouts, rebuildAppReplica, requireAuth, resolveApplication, updateApplication, } from '../utils/api.js';
+import { hasFlag, readFlagValue, readJsonFlag } from '../utils/args.js';
+import { usageError } from '../utils/errors.js';
+import { confirm } from '../utils/prompt.js';
+import { dim, formatTable, printInfo, printLine, printSuccess, printWarning } from '../utils/output.js';
+import { formatRoleEndpoints, replicaRoleCell, roleConditionWarnings } from '../lib/replica-roles.js';
+/**
+ * Stateful replicas on the command line (docs/roadmap/STATEFUL_REPLICAS.md
+ * §7.2). Every command writes the same `scale` object as inquir.yaml's
+ * services.web.scale and the API: nothing here is a CLI-only setting.
+ *
+ *   inquir apps scale <app> --replicas N --stateful   scale.mode: stateful, scale.replicas: N
+ *   inquir apps replicas <app>                        the ordinals: server, volume, release, state
+ *   inquir apps replicas rebuild <app> <n>            rebuild ordinal n on another server
+ *   inquir apps replicas delete-volume <app> <n>      delete ordinal n's retained volumes
+ *   inquir apps rollout <app> [--partition P]         the stateful rollout; P holds ordinals below it
+ *   inquir apps rollout cancel <app> [<rollout-id>]   end a stateful rollout that can move nothing (ABORTED), or pause a live one
+ */
+export const REPLICAS_VALUE_FLAGS = ['--partition', '--reason'];
+export const REPLICAS_HELP = {
+    replicas: [
+        'Usage: inquir apps replicas <app> [--json]',
+        '       inquir apps replicas rebuild <app> <n> [--reason <text>] [--yes]',
+        '       inquir apps replicas delete-volume <app> <n> [--yes]',
+        '',
+        '  Stateful replicas are Alpha: they may change and have limits; keep backups of their data.',
+        '  The ordinals of a stateful application (scale.mode: stateful): each one\'s server,',
+        '  volume (generation, state), the release it runs and its state.',
+        '  rebuild        Start ordinal <n> on another server with a new, empty volume. Its',
+        '                 runtime.hooks.init (when: emptyVolume) or the image bootstraps the data;',
+        '                 the old volume is kept for scale.retention.retentionDays.',
+        '  delete-volume  Delete the retained volumes of ordinal <n> (scaled down, or the old',
+        '                 generation a rebuild left). Its data is gone for good.',
+    ],
+    rollout: [
+        'Usage: inquir apps rollout <app> [--partition <n>] [--json]',
+        '',
+        '  How the newest release reaches a stateful application\'s ordinals: one at a time,',
+        '  the highest first (scale.update). --partition <n> keeps ordinals below <n> on their',
+        '  release (a canary: --partition <replicas-1>, check, then --partition 0).',
+        '',
+        '       inquir apps rollout cancel <app> [<rollout-id>] [--reason <text>] [--yes]',
+        '  Cancel the newest open stateful rollout (or <rollout-id>): one that can move nothing',
+        '  any more (the application is stateless again, or production is another release) ends;',
+        '  a live one pauses until you deploy a fix or roll back.',
+    ],
+};
+function parseOrdinal(raw, usage) {
+    if (raw === undefined || !/^(0|[1-9][0-9]?)$/.test(raw))
+        throw usageError('The replica ordinal must be an integer such as 0 or 2', usage);
+    return Number(raw);
+}
+/** The stored block with `change` merged over it: the CLI never drops keys it was not asked to change. */
+export function mergeScale(stored, change) {
+    const merged = { ...(stored ?? {}), ...change };
+    if (change.update || stored?.update)
+        merged.update = { ...(stored?.update ?? {}), ...(change.update ?? {}) };
+    if (merged.mode === 'stateless') {
+        // A stateless application carries no stateful key (the schema refuses them).
+        return { mode: 'stateless' };
+    }
+    return merged;
+}
+/**
+ * `inquir apps scale <app> --replicas N --stateful` (or `--stateless`): the
+ * `scale` block of the application. Returns false when neither flag is given,
+ * so the caller handles the stateless scaling policy as before.
+ */
+export async function statefulScaleSubcommand(args, identifier, apiOptions) {
+    const stateful = hasFlag(args, '--stateful');
+    const stateless = hasFlag(args, '--stateless');
+    if (!stateful && !stateless)
+        return false;
+    const usage = 'inquir apps scale <app> --replicas <n> --stateful';
+    if (stateful && stateless)
+        throw usageError('--stateful and --stateless are exclusive', usage);
+    const replicasRaw = readFlagValue(args, '--replicas');
+    const replicas = replicasRaw === undefined ? undefined : Number(replicasRaw);
+    if (replicas !== undefined && (!Number.isInteger(replicas) || replicas < 1 || replicas > 8)) {
+        throw usageError('--replicas must be an integer from 1 to 8', usage);
+    }
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(identifier, apiOptions);
+    const current = await getAppReplicas(app.id, apiOptions);
+    const scale = mergeScale(current.scale, stateless
+        ? { mode: 'stateless' }
+        : { mode: 'stateful', ...(replicas !== undefined ? { replicas } : {}) });
+    const updated = await updateApplication(app.id, { scale, ...(hasFlag(args, '--override') ? { scaleOverride: true } : {}) }, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify(updated, null, 2));
+        return true;
+    }
+    printSuccess(stateless ? `${app.name} scales as identical replicas again` : `${app.name}: ${scale.replicas ?? 1} stateful replica(s)`);
+    if (!stateless)
+        printInfo(dim(`  Each replica has its own volume and name; see: inquir apps replicas ${app.name}`));
+    return true;
+}
+function describeVolumes(ordinal) {
+    return ordinal.volumes.map((volume) => `${volume.logicalName}@g${volume.generation}${volume.state === 'ACTIVE' ? '' : ` ${volume.state.toLowerCase()}`}`).join(', ');
+}
+function ordinalStatus(ordinal) {
+    if (ordinal.state === 'RETAINED')
+        return 'retained';
+    if (ordinal.rebuildRequested)
+        return 'rebuilding';
+    if (ordinal.conditions.some((condition) => condition.reason === 'RunnerLost'))
+        return 'server lost';
+    if (ordinal.conditions.some((condition) => condition.type === 'VolumeGenerationRefused'))
+        return 'volume refused';
+    if (!ordinal.attempt)
+        return 'stopped';
+    return ordinal.attempt.serving ? 'serving' : ordinal.attempt.observedState.toLowerCase();
+}
+export async function replicasSubcommand(args, positionals, apiOptions) {
+    const [first, ...rest] = positionals;
+    if (first === 'rebuild')
+        return rebuildReplica(args, rest, apiOptions);
+    if (first === 'delete-volume')
+        return deleteReplicaVolume(args, rest, apiOptions);
+    if (!first)
+        throw usageError('Missing application', 'inquir apps replicas <app>');
+    if (rest.length > 0)
+        throw usageError(`Unexpected argument '${rest[0]}'`, 'inquir apps replicas <app>');
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(first, apiOptions);
+    const replicas = await getAppReplicas(app.id, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify(replicas, null, 2));
+        return;
+    }
+    if (replicas.mode !== 'stateful') {
+        printInfo(`${app.name} runs identical (stateless) replicas. Give each its own volume: inquir apps scale ${app.name} --replicas 2 --stateful`);
+        return;
+    }
+    printLine(formatTable(replicas.ordinals.map((ordinal) => ({
+        replica: `${app.name}-${ordinal.ordinal}`,
+        server: ordinal.host ?? ordinal.runnerId?.slice(0, 8) ?? '-',
+        location: ordinal.location ?? '',
+        volume: describeVolumes(ordinal),
+        release: (ordinal.releaseId ?? '').slice(0, 8),
+        role: replicaRoleCell(ordinal),
+        status: ordinalStatus(ordinal),
+    })), ['replica', 'server', 'location', 'volume', 'release', 'role', 'status']));
+    // P2 role endpoints (§3.5, §3.8): the endpoints block, and a warning per RoleConflict.
+    for (const line of formatRoleEndpoints(replicas))
+        printLine(line);
+    for (const warning of roleConditionWarnings(replicas.conditions))
+        printWarning(warning);
+    for (const entry of replicas.status?.unplaced ?? [])
+        printWarning(`${app.name}-${entry.ordinal}: not placed: ${entry.message}`);
+    if (replicas.status?.waitingFor !== undefined)
+        printInfo(dim(`  Waiting for ${app.name}-${replicas.status.waitingFor} to serve before the next replica starts`));
+    if (replicas.rollout && ['PROGRESSING', 'PAUSED'].includes(replicas.rollout.phase)) {
+        printInfo(dim(`  Rollout of ${replicas.rollout.releaseId.slice(0, 8)}: ${replicas.rollout.phase.toLowerCase()}; see inquir apps rollout ${app.name}`));
+    }
+    if (replicas.managedKeys?.length)
+        printInfo(dim(`  Managed by inquir.yaml: scale.${replicas.managedKeys.join(', scale.')}`));
+}
+async function rebuildReplica(args, positionals, apiOptions) {
+    const usage = 'inquir apps replicas rebuild <app> <n> [--reason <text>]';
+    const [identifier, rawOrdinal] = positionals;
+    if (!identifier)
+        throw usageError('Missing application', usage);
+    const ordinal = parseOrdinal(rawOrdinal, usage);
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(identifier, apiOptions);
+    if (!hasFlag(args, '--yes') && !(await confirm(`Rebuild ${app.name}-${ordinal} on another server? It starts on a new, empty volume; the current one is kept for the retention period.`))) {
+        printInfo('Nothing changed.');
+        return;
+    }
+    const reason = readFlagValue(args, '--reason');
+    const result = await rebuildAppReplica(app.id, ordinal, { ...(reason ? { reason } : {}) }, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify(result, null, 2));
+        return;
+    }
+    printSuccess(`Rebuild of ${app.name}-${ordinal} requested`);
+    printInfo(dim(`  Follow it: inquir apps replicas ${app.name}`));
+}
+async function deleteReplicaVolume(args, positionals, apiOptions) {
+    const usage = 'inquir apps replicas delete-volume <app> <n>';
+    const [identifier, rawOrdinal] = positionals;
+    if (!identifier)
+        throw usageError('Missing application', usage);
+    const ordinal = parseOrdinal(rawOrdinal, usage);
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(identifier, apiOptions);
+    if (!hasFlag(args, '--yes') && !(await confirm(`Delete the retained volumes of ${app.name}-${ordinal}? The data cannot be recovered.`))) {
+        printInfo('Nothing changed.');
+        return;
+    }
+    const result = await deleteAppReplicaVolumes(app.id, ordinal, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify(result, null, 2));
+        return;
+    }
+    printSuccess(`Deleting ${result.volumes} retained volume(s) of ${app.name}-${ordinal}`);
+}
+async function cancelRollout(args, positionals, apiOptions) {
+    const usage = 'inquir apps rollout cancel <app> [<rollout-id>] [--reason <text>]';
+    const [identifier, rolloutId, ...extra] = positionals;
+    if (!identifier)
+        throw usageError('Missing application', usage);
+    if (extra.length > 0)
+        throw usageError(`Unexpected argument '${extra[0]}'`, usage);
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(identifier, apiOptions);
+    let target = rolloutId;
+    if (!target) {
+        const { items } = await listApplicationRollouts(app.id, 20, apiOptions);
+        target = items.find((rollout) => rollout.kind === 'STATEFUL' && (rollout.phase === 'PROGRESSING' || rollout.phase === 'PAUSED'))?.id;
+        if (!target) {
+            printInfo(`${app.name} has no open stateful rollout.`);
+            return;
+        }
+    }
+    if (!hasFlag(args, '--yes') && !(await confirm(`Cancel rollout ${target.slice(0, 8)} of ${app.name}?`))) {
+        printInfo('Nothing changed.');
+        return;
+    }
+    const reason = readFlagValue(args, '--reason');
+    const result = await cancelApplicationRollout(app.id, target, { ...(reason ? { reason } : {}) }, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify(result, null, 2));
+        return;
+    }
+    printSuccess(`Rollout ${result.id.slice(0, 8)} of ${app.name}: ${result.phase.toLowerCase()}`);
+    if (result.reason)
+        printInfo(dim(`  ${result.reason}`));
+}
+export async function rolloutSubcommand(args, positionals, apiOptions) {
+    if (positionals[0] === 'cancel')
+        return cancelRollout(args, positionals.slice(1), apiOptions);
+    const usage = 'inquir apps rollout <app> [--partition <n>]';
+    const [identifier, ...extra] = positionals;
+    if (!identifier)
+        throw usageError('Missing application', usage);
+    if (extra.length > 0)
+        throw usageError(`Unexpected argument '${extra[0]}'`, usage);
+    await requireAuth(apiOptions);
+    const app = await resolveApplication(identifier, apiOptions);
+    const partitionRaw = readFlagValue(args, '--partition');
+    if (partitionRaw !== undefined) {
+        const partition = Number(partitionRaw);
+        if (!Number.isInteger(partition) || partition < 0 || partition > 8)
+            throw usageError('--partition must be an integer from 0 to 8', usage);
+        const current = await getAppReplicas(app.id, apiOptions);
+        if (current.mode !== 'stateful')
+            throw usageError(`${app.name} is not stateful; a partition holds stateful replicas`, usage);
+        await updateApplication(app.id, {
+            scale: mergeScale(current.scale, { update: { partition } }),
+            ...(hasFlag(args, '--override') ? { scaleOverride: true } : {}),
+        }, apiOptions);
+        printSuccess(`${app.name}: replicas below ${partition} keep their release`);
+    }
+    const replicas = await getAppReplicas(app.id, apiOptions);
+    if (readJsonFlag(args)) {
+        printLine(JSON.stringify({ rollout: replicas.rollout ?? null, ordinals: replicas.ordinals.map((o) => ({ ordinal: o.ordinal, releaseId: o.releaseId })) }, null, 2));
+        return;
+    }
+    const rollout = replicas.rollout;
+    if (!rollout) {
+        printInfo(`No rollout yet for ${app.name}.`);
+        return;
+    }
+    printLine(`Release ${rollout.releaseId.slice(0, 8)}: ${rollout.phase.toLowerCase()}` +
+        `${rollout.predecessorReleaseId ? ` (from ${rollout.predecessorReleaseId.slice(0, 8)})` : ''}`);
+    printLine(`Replicas on it: ${replicas.ordinals.filter((o) => o.releaseId === rollout.releaseId).map((o) => o.ordinal).join(', ') || 'none'}`);
+    if (rollout.strategy) {
+        printInfo(dim(`  order ${rollout.strategy.order}, partition ${rollout.strategy.partition}, ` +
+            `min ready ${rollout.strategy.minReadySeconds}s, at most ${rollout.strategy.maxUnavailable} unavailable`));
+    }
+    if (rollout.reason)
+        printInfo(dim(`  ${rollout.reason}`));
+    if (rollout.phase === 'PAUSED')
+        printWarning('Paused: deploy a fix, or roll back explicitly (inquir apps rollback).');
+}
+//# sourceMappingURL=apps-replicas.js.map

package/dist/commands/apps-replicas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-replicas.js","sourceRoot":"","sources":["../../src/commands/apps-replicas.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EAAE,uBAAuB,EAAE,cAAc,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,WAAW,EAC1H,kBAAkB,EAAE,iBAAiB,GACtC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,aAAa,GAA6B;IACrD,QAAQ,EAAE;QACR,4CAA4C;QAC5C,yEAAyE;QACzE,6DAA6D;QAC7D,EAAE;QACF,6FAA6F;QAC7F,sFAAsF;QACtF,kEAAkE;QAClE,oFAAoF;QACpF,2FAA2F;QAC3F,4EAA4E;QAC5E,sFAAsF;QACtF,yEAAyE;KAC1E;IACD,OAAO,EAAE;QACP,6DAA6D;QAC7D,EAAE;QACF,qFAAqF;QACrF,uFAAuF;QACvF,4EAA4E;QAC5E,EAAE;QACF,kFAAkF;QAClF,wFAAwF;QACxF,yFAAyF;QACzF,0DAA0D;KAC3D;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,GAAuB,EAAE,KAAa;IAC1D,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,UAAU,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;IAC1I,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,UAAU,CAAC,MAAgC,EAAE,MAAoB;IAC/E,MAAM,MAAM,GAAiB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9D,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7G,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,6EAA6E;QAC7E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAc,EAAE,UAAkB,EAAE,UAA6B;IAEjE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,mDAAmD,CAAC;IAClE,IAAI,QAAQ,IAAI,SAAS;QAAE,MAAM,UAAU,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;IAC/F,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7E,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,UAAU,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS;QAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;QACvB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACxI,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,qCAAqC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACvI,IAAI,CAAC,SAAS;QAAE,SAAS,CAAC,GAAG,CAAC,yEAAyE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,OAAwC;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvK,CAAC;AAED,SAAS,aAAa,CAAC,OAAwC;IAC7D,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IACpD,IAAI,OAAO,CAAC,gBAAgB;QAAE,OAAO,YAAY,CAAC;IAClD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAAC;QAAE,OAAO,aAAa,CAAC;IACpG,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,yBAAyB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAClH,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAc,EAAE,WAAqB,EAAE,UAA6B;IAC3G,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACvE,IAAI,KAAK,KAAK,eAAe;QAAE,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAClF,IAAI,CAAC,KAAK;QAAE,MAAM,UAAU,CAAC,qBAAqB,EAAE,4BAA4B,CAAC,CAAC;IAClF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,UAAU,CAAC,wBAAwB,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;IACxG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,qFAAqF,GAAG,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAC9I,OAAO;IACT,CAAC;IACD,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG;QAC5D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC;KAC/B,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChF,uFAAuF;IACvF,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,QAAQ,CAAC;QAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAClE,KAAK,MAAM,OAAO,IAAI,qBAAqB,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACxF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE;QAAE,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,iBAAiB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChI,IAAI,QAAQ,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS;QAAE,SAAS,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,0CAA0C,CAAC,CAAC,CAAC;IACjK,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnF,SAAS,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,6BAA6B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzJ,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM;QAAE,SAAS,CAAC,GAAG,CAAC,mCAAmC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/H,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,WAAqB,EAAE,UAA6B;IAChG,MAAM,KAAK,GAAG,0DAA0D,CAAC;IACzE,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,WAAW,CAAC;IAC7C,IAAI,CAAC,UAAU;QAAE,MAAM,UAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,CAC5C,WAAW,GAAG,CAAC,IAAI,IAAI,OAAO,yGAAyG,CACxI,CAAC,EAAE,CAAC;QACH,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACvG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,YAAY,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,OAAO,YAAY,CAAC,CAAC;IAC5D,SAAS,CAAC,GAAG,CAAC,qCAAqC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAc,EAAE,WAAqB,EAAE,UAA6B;IACrG,MAAM,KAAK,GAAG,8CAA8C,CAAC;IAC7D,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,WAAW,CAAC;IAC7C,IAAI,CAAC,UAAU;QAAE,MAAM,UAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,kCAAkC,GAAG,CAAC,IAAI,IAAI,OAAO,iCAAiC,CAAC,CAAC,EAAE,CAAC;QACxI,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1E,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,YAAY,CAAC,YAAY,MAAM,CAAC,OAAO,0BAA0B,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAc,EAAE,WAAqB,EAAE,UAA6B;IAC/F,MAAM,KAAK,GAAG,mEAAmE,CAAC;IAClF,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;IACtD,IAAI,CAAC,UAAU;QAAE,MAAM,UAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,UAAU,CAAC,wBAAwB,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnF,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7D,IAAI,MAAM,GAAuB,SAAS,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;QACxE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,aAAa,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC;QACrI,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,gCAAgC,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;QACxG,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7G,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,YAAY,CAAC,WAAW,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,MAAM;QAAE,SAAS,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc,EAAE,WAAqB,EAAE,UAA6B;IAC1G,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,6CAA6C,CAAC;IAC5D,MAAM,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,MAAM,UAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,UAAU,CAAC,wBAAwB,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnF,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC;YAAE,MAAM,UAAU,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QAC1I,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,MAAM,UAAU,CAAC,GAAG,GAAG,CAAC,IAAI,uDAAuD,EAAE,KAAK,CAAC,CAAC;QAC7H,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE;YAC9B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;YAC3D,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,EAAE,UAAU,CAAC,CAAC;QACf,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,oBAAoB,SAAS,qBAAqB,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpK,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,SAAS,CAAC,sBAAsB,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,SAAS,CAAC,WAAW,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE;QAClF,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,SAAS,CAAC,mBAAmB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9I,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,KAAK,eAAe,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI;YAC1F,aAAa,OAAO,CAAC,QAAQ,CAAC,eAAe,cAAc,OAAO,CAAC,QAAQ,CAAC,cAAc,cAAc,CAAC,CAAC,CAAC;IAC/G,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ;QAAE,YAAY,CAAC,uEAAuE,CAAC,CAAC;AACxH,CAAC"}

package/dist/commands/apps.d.ts

@@ -1,4 +1,4 @@
-import { type AppNetworkPolicy, type AppPortSpec, type AppRuntimeSpec, type AppScalingPolicy, type ApiRequestOptions, type ApplicationDetail, type AppLocationStatus, type AppVolumeBackup, type AppBackupPolicy, type Build, type Release } from '../utils/api.js';
+import { type AppNetworkPolicy, type AppNetworkPolicyInput, type AppPortSpec, type AppRuntimeSpec, type AppScalingPolicy, type ApiRequestOptions, type ApplicationDetail, type AppLocationStatus, type AppVolumeBackup, type AppBackupPolicy, type Build, type Release } from '../utils/api.js';
 import { type AppLogHistoryResponse, type AppRuntimeLogEntry, type AppRuntimeLogQuery } from '../sdk.js';
 export declare function appsCommand(args: string[]): Promise<void>;
 /**
@@ -38,7 +38,7 @@ export declare function parseDurationSeconds(value: string): number;
 /** Build the partial policy sent by `apps scale`; omitted values remain unchanged server-side. */
 export declare function buildScalingPatchFromFlags(args: string[], positionalActivation?: string): Partial<AppScalingPolicy>;
 type AppVolumeSpec = NonNullable<AppRuntimeSpec['volumes']>[number];
-/** `--volume name:/absolute/container/path[:ro]`; host paths are never accepted. */
+/** `--volume name:/absolute/container/path[:ro][:size=<MB>]`; host paths are never accepted. */
 export declare function parseVolumeFlag(value: string): AppVolumeSpec;
 /** `--drain-grace <seconds>`: whole seconds, 0..3600, as the API's runtime schema. */
 export declare function parseDrainGraceFlag(value: string): number;
@@ -59,6 +59,8 @@ export declare function formatBackupPolicy(policy: AppBackupPolicy): string;
  * suggesting it.
  */
 export declare function emptyBackupsLines(appName: string, policy: AppBackupPolicy | undefined): string[];
+/** A row's status as the CLI prints it: an empty volume's backup is READY (restorable) and says it is empty. */
+export declare function formatBackupStatus(backup: Pick<AppVolumeBackup, 'status' | 'empty'>): string;
 /**
  * The refusals of `apps connect` and `apps connection-url`, told as what to do
  * next. The server's code and message are kept; the cause, the fix and the
@@ -133,7 +135,7 @@ export declare function buildNetworkPolicyPatch(input: {
     egress?: string;
     ingress?: string;
     current?: AppNetworkPolicy;
-}): AppNetworkPolicy | undefined;
+}): AppNetworkPolicyInput | undefined;
 /** A build-sourced release is best named by its build; a pulled one by its ref. */
 export declare function describeImage(release: Pick<Release, 'imageSource' | 'buildId' | 'imageRef' | 'imageDigest'>): string;
 /** One line for a startup probe; defaults as the server applies them (src/apps/startup-probe.ts). */

package/dist/commands/apps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/commands/apps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/commands/apps.ts"],"names":[],"mappings":"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"}

package/dist/commands/apps.js

@@ -3,6 +3,7 @@ import { alertsSubcommand, logHistorySubcommand, metricsSubcommand, OBSERVATION_
 import { RESOURCES_HELP, RESOURCES_VALUE_FLAGS, resourcesSubcommand } from './apps-resources.js';
 import { DESCRIBE_HELP, describeSubcommand } from './apps-describe.js';
 import { INSTANCES_HELP, instancesSubcommand, resolveReplicaAllocationId } from './apps-instances.js';
+import { REPLICAS_HELP, REPLICAS_VALUE_FLAGS, replicasSubcommand, rolloutSubcommand, statefulScaleSubcommand } from './apps-replicas.js';
 import { followPromoteRollout } from './apps-promote.js';
 import { hasFlag, readFlagValue, readJsonFlag, readLimitFlag, readMultiFlag, readPositionalArgs, } from '../utils/args.js';
 import { listAppBackups, getAppBackup, createAppBackup, deleteAppBackup, restoreAppBackup, getAppConnectionUrl, connectApps, createApiClient, addApplicationDomain, archiveApplication, cancelBuild, createApplication, getBuild, listApplicationDomains, listBuilds, queueBuild, removeApplicationDomain, createRelease, redeployApplication, execInApplication, getAppLimits, getAppLocation, getApplication, getProject, getProductionReplacement, getRelease, listApplications, promoteRelease, isPromoteAccepted, requireAuth, resolveApplication, rollbackApplication, stopRelease, streamBuildLogs, streamReleaseLogs, updateApplication, wakeApplication, pauseApplication, verifyApplicationDomain, } from '../utils/api.js';
@@ -19,6 +20,7 @@ import { packSourceForUpload } from '../utils/source-pack.js';
 /** Value flags across every subcommand — readPositionalArgs must know them all. */
 const VALUE_FLAGS = [
     ...OBSERVATION_VALUE_FLAGS,
+    ...REPLICAS_VALUE_FLAGS,
     ...RESOURCES_VALUE_FLAGS,
     '--project',
     '--template',
@@ -120,6 +122,10 @@ export async function appsCommand(args) {
             return updateSubcommand(args, rest, apiOptions);
         case 'scale':
             return scaleSubcommand(args, rest, apiOptions);
+        case 'replicas':
+            return replicasSubcommand(args, rest, apiOptions);
+        case 'rollout':
+            return rolloutSubcommand(args, rest, apiOptions);
         case 'wake':
             return wakeSubcommand(args, rest, apiOptions);
         case 'pause':
@@ -164,6 +170,9 @@ function printAppsHelp() {
         'exec <app> [--replica <r>] -- <cmd>  Run a command in production (one replica: name or index)',
         'update <app>                Change env vars, ports, resources, egress, node selector',
         'scale <app> [mode]          Set always/http/manual scaling (--replicas for always)',
+        'scale <app> --replicas <n> --stateful  Ordered replicas, each with its own volume and name (Alpha)',
+        'replicas <app> [rebuild|delete-volume]  Replicas of a stateful app: server, volume, release (Alpha)',
+        'rollout <app> [--partition <n>]  How a release reaches the replicas of a stateful app (Alpha)',
         'wake <app>                  Start a sleeping application',
         'pause <app>                 Stop an http/manual app (HTTP wakes only http mode)',
         "domain <app> [hostname]     Bind a hostname (or list them); --verify / --remove; '*.example.com' needs --yes (not recommended)",
@@ -187,8 +196,9 @@ function printAppsHelp() {
         '--volume-runner <id>        Pin volumes (and the container) to a worker runner',
         '--node-selector KEY=VALUE   update: run only on servers with this node label (repeatable),',
         '                            e.g. inquir.io/region=eu; --clear-node-selector removes it',
-        '--location <id|auto>        update (experimental): run in this location, e.g. nl or ru; auto',
-        '                            runs wherever there is capacity. Applies from the next deploy',
+        '--location <id|auto>        create/update (experimental): run in this location, e.g. nl or ru; auto',
+        '                            runs wherever there is capacity (inquir.yaml: services.web.location).',
+        '                            Applies from the next deploy',
         '--set KEY=VALUE             create/update: environment variable (repeatable)',
         '--unset KEY                 update: remove an environment variable and its production-only marker (repeatable)',
         '--memory <mb>               Memory ceiling (default 512)',
@@ -427,22 +437,27 @@ const VOLUME_NAME_RE = /^[a-z0-9]([a-z0-9-]{0,30}[a-z0-9])?$/;
 const MAX_APP_VOLUMES = 16;
 // eslint-disable-next-line no-control-regex -- Container mount paths must reject control characters.
 const CONTROL_CHAR_RE = /[\u0000-\u001f\u007f]/;
-/** `--volume name:/absolute/container/path[:ro]`; host paths are never accepted. */
+/** `--volume name:/absolute/container/path[:ro][:size=<MB>]`; host paths are never accepted. */
 export function parseVolumeFlag(value) {
     const separator = value.indexOf(':');
     const name = separator > 0 ? value.slice(0, separator) : '';
     let mountPath = separator > 0 ? value.slice(separator + 1) : '';
     let readOnly = false;
+    let sizeMb;
     if (/^[A-Za-z]:[\\/]/.test(mountPath)) {
         throw usageError(`Invalid --volume mount path '${mountPath}'`, `Volume targets are absolute paths inside the Linux container, for example data:/var/lib/data. ${MSYS_PATH_HINT}`);
     }
-    const modifierAt = mountPath.lastIndexOf(':');
-    if (modifierAt >= 0) {
+    // Trailing modifiers, each at most once: ro, size=<MB> (the same sizeMb inquir.yaml takes).
+    for (let modifierAt = mountPath.lastIndexOf(':'); modifierAt >= 0; modifierAt = mountPath.lastIndexOf(':')) {
         const modifier = mountPath.slice(modifierAt + 1);
-        if (modifier !== 'ro') {
-            throw usageError(`Invalid --volume modifier '${modifier}' in '${value}'`, 'inquir apps deploy <app> --volume data:/var/lib/data[:ro]');
+        const size = /^size=(\d{1,7})$/.exec(modifier);
+        if (modifier === 'ro' && !readOnly)
+            readOnly = true;
+        else if (size && sizeMb === undefined && Number(size[1]) >= 64 && Number(size[1]) <= 1048576)
+            sizeMb = Number(size[1]);
+        else {
+            throw usageError(`Invalid --volume modifier '${modifier}' in '${value}'`, 'inquir apps deploy <app> --volume data:/var/lib/data[:ro][:size=1024] (size in MB, 64 to 1048576)');
         }
-        readOnly = true;
         mountPath = mountPath.slice(0, modifierAt);
     }
     if (!VOLUME_NAME_RE.test(name)) {
@@ -464,7 +479,7 @@ export function parseVolumeFlag(value) {
         ['/dev', '/proc', '/sys'].some((root) => normalized === root || normalized.startsWith(`${root}/`))) {
         throw usageError(`Invalid --volume mount path '${mountPath}'`, 'Mount below an application data directory, for example data:/var/lib/data');
     }
-    return { name, mountPath: normalized, ...(readOnly ? { readOnly: true } : {}) };
+    return { name, mountPath: normalized, ...(readOnly ? { readOnly: true } : {}), ...(sizeMb !== undefined ? { sizeMb } : {}) };
 }
 function assertVolumeSet(volumes) {
     if (volumes.length > MAX_APP_VOLUMES) {
@@ -610,6 +625,7 @@ async function createAppSubcommand(args, positionals, apiOptions) {
         egress: readFlagValue(args, '--egress'),
         ingress: readFlagValue(args, '--ingress'),
     });
+    const location = parseLocationFlag(readFlagValue(args, '--location'));
     const project = await resolveCreateProject(args, apiOptions);
     const app = await createApplication({
         name,
@@ -620,6 +636,7 @@ async function createAppSubcommand(args, positionals, apiOptions) {
         runtime: buildRuntimeFromFlags(args),
         ...(Object.keys(envVars).length > 0 ? { envVars } : {}),
         ...(networkPolicy ? { networkPolicy } : {}),
+        ...(location ? { location } : {}),
     }, project.apiOptions).catch((error) => {
         // A worker runner pulls only a digest-pinned registry image, and this
         // installation has no mirror of the template's image yet.
@@ -693,6 +710,7 @@ export const SUBCOMMAND_HELP = {
     ...RESOURCES_HELP,
     ...DESCRIBE_HELP,
     ...INSTANCES_HELP,
+    ...REPLICAS_HELP,
     logs: [
         'Usage: inquir apps logs <app|release|build> [--tail <n>] [--no-follow] [--replica <name|index|allocation>]',
         '  Prints the last --tail lines (default 200, at most 2000), then follows new',
@@ -783,6 +801,12 @@ export const SUBCOMMAND_HELP = {
         'Examples:',
         '  inquir apps scale web always --replicas 2',
         '  inquir apps scale web http --idle-timeout 15m',
+        '',
+        'Stateful replicas (Alpha: may change and has limits; keep backups of their data)',
+        '  An application with a volume: each replica its own volume and name',
+        '  inquir apps scale db --replicas 3 --stateful   (scale.mode: stateful, as in inquir.yaml)',
+        '  inquir apps scale db --stateless              back to identical replicas, from one replica',
+        '  --override  change a scale key the deployed inquir.yaml manages (until the next Git deploy)',
     ],
     wake: [
         'Usage: inquir apps wake <app> [--json]',
@@ -937,13 +961,17 @@ export function emptyBackupsLines(appName, policy) {
     }
     return [`No backups for ${appName} yet — create one: inquir apps backups ${appName} create`];
 }
+/** A row's status as the CLI prints it: an empty volume's backup is READY (restorable) and says it is empty. */
+export function formatBackupStatus(backup) {
+    return backup.status === 'READY' && backup.empty === true ? 'READY (empty)' : backup.status;
+}
 /** The one backup table: `create` prints it too, once the rows settle. */
 function renderBackupTable(items) {
     const keeps = items.some((b) => b.retention);
     printLine(formatTable(items.map((b) => ({
         id: b.id.slice(0, 8),
         volume: b.volumeName,
-        status: b.status,
+        status: formatBackupStatus(b),
         trigger: b.trigger,
         size: formatBytes(b.sizeBytes ?? b.artifactSizeBytes),
         created: b.createdAt.replace('T', ' ').slice(0, 19),
@@ -986,7 +1014,7 @@ async function waitForBackups(applicationId, started, apiOptions, json, timeoutM
                 continue;
             settled.set(row.id, current);
             const size = current.status === 'READY' ? ` ${formatBytes(current.sizeBytes ?? current.artifactSizeBytes)}` : '';
-            announce(`— ${current.volumeName} ${current.status}${size} (${formatElapsed(Date.now() - startedAt)}) —`);
+            announce(`— ${current.volumeName} ${formatBackupStatus(current)}${size} (${formatElapsed(Date.now() - startedAt)}) —`);
         }
         if (settled.size === started.length)
             return started.map((row) => settled.get(row.id));
@@ -1066,7 +1094,9 @@ async function backupsSubcommand(args, positionals, apiOptions) {
         const when = match.createdAt.replace('T', ' ').slice(0, 16);
         const summary = `${app.name} volume ${match.volumeName} from the ${when} backup (${formatBytes(match.sizeBytes ?? match.artifactSizeBytes)})`;
         if (!runtime().yes) {
-            const approved = await confirm(`Overwrite ${summary}? Everything written since ${when} is lost, and ${app.name} stops during the restore.`, false);
+            // The backup of an empty volume restores as an empty volume: say so, it removes every file.
+            const emptied = match.empty === true ? ` The volume was empty then: the restore removes every file in ${match.volumeName}.` : '';
+            const approved = await confirm(`Overwrite ${summary}? Everything written since ${when} is lost, and ${app.name} stops during the restore.${emptied}`, false);
             if (!approved) {
                 throw usageError(`Refusing to restore ${app.name} without confirmation`, `inquir apps backups ${identifier} restore ${match.id.slice(0, 8)} --yes`);
             }
@@ -1323,6 +1353,10 @@ export function printManifestEnvOutcome(queued) {
     const applied = Array.isArray(outcome.manifestEnv?.applied) ? outcome.manifestEnv.applied : [];
     if (applied.length > 0)
         printInfo(dim(`  inquir.yaml env applied: ${applied.join(', ')}`));
+    // networkPolicy / scaling / location the deploy applied (deferred and restored keys come as warnings).
+    const settings = Array.isArray(outcome.manifestSettings?.applied) ? outcome.manifestSettings.applied : [];
+    if (settings.length > 0)
+        printInfo(dim(`  inquir.yaml settings applied: ${settings.join(', ')}`));
     const warnings = Array.isArray(outcome.warnings) ? outcome.warnings : [];
     for (const warning of warnings)
         printWarning(`  warning: ${warning}`);
@@ -1456,9 +1490,15 @@ async function runSourceBuild(applicationId, appName, args, apiOptions) {
         },
     }, apiOptions);
     if (!json) {
-        printInfo(queued.deduplicated
-            ? `Build ${queued.buildId.slice(0, 8)} reused (identical source already built)`
-            : `Build ${queued.buildId.slice(0, 8)} queued for ${appName}`);
+        const image = queued.image === true ? queued.imageRef : undefined;
+        printInfo(image
+            ? `Build ${queued.buildId.slice(0, 8)}: inquir.yaml imageRef, nothing to build (deploys ${image})`
+            : queued.deduplicated
+                ? `Build ${queued.buildId.slice(0, 8)} reused (identical source already built)`
+                : `Build ${queued.buildId.slice(0, 8)} queued for ${appName}`);
+        // inquir.yaml keys the platform ignored (a typo is named, never silent).
+        for (const warning of queued.warnings ?? [])
+            printWarning(`  warning: ${warning}`);
     }
     return waitForBuild(queued.buildId, apiOptions, {
         json, initial: queued, noLogs: queued.deduplicated || isTerminalBuildStatus(queued.status),
@@ -2347,6 +2387,9 @@ async function scaleSubcommand(args, positionals, apiOptions) {
     if (!identifier) {
         throw usageError('Missing application', 'inquir apps scale <app> <always|http|manual>');
     }
+    // Stateful replicas: the scale block (scale.mode, scale.replicas), not the stateless policy.
+    if (positionalActivation === undefined && await statefulScaleSubcommand(args, identifier, apiOptions))
+        return;
     if (extra.length > 0) {
         throw usageError(`Unexpected argument '${extra[0]}'`, 'inquir apps scale <app> <always|http|manual>');
     }