@elaraai/e3-cloud-cli 0.0.0-stage → 1.0.89-alpha.0

package/dist/src/commands/feedback.js

@@ -0,0 +1,197 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Feedback commands — list, show, close, reopen, enable, disable.
+ *
+ * Users send notes about a part of a workspace's pages (`FB-<number>`, per
+ * workspace). These commands read and handle them: `list` the workspace's
+ * notes of a status with their counts (owners and admins), or `--mine`, the
+ * caller's own; `show` one note whole with its context, and save its
+ * screenshot; `close` and `reopen` one (owners and admins); and `enable` and
+ * `disable` the workspace's feedback (owners and admins).
+ */
+import { writeFileSync } from 'node:fs';
+import { ApiError, closeFeedback, feedbackId, feedbackScreenshotUrl, getFeedback, listFeedback, listMyFeedback, putFeedbackSettings, reopenFeedback, } from '@elaraai/e3-cloud-client';
+import { getValidToken } from '../credentials.js';
+import { parseWorkspaceUrl, formatError, exitError } from '../utils.js';
+/** An error, in words: an API error's code and the server's message. */
+function describe(err) {
+    if (err instanceof ApiError)
+        return typeof err.details === 'string' ? `${err.code}: ${err.details}` : err.code;
+    return formatError(err);
+}
+/** A note's number, from `12` or `FB-12`. */
+function numberOf(text) {
+    const match = /^(?:FB-)?([1-9][0-9]*)$/i.exec(text.trim());
+    if (match === null)
+        exitError(`'${text}' names no note: give its number, e.g. 12 or FB-12`);
+    return Number(match[1]);
+}
+/** A status option, checked. */
+function statusOf(text) {
+    if (text === undefined)
+        return undefined;
+    if (text !== 'open' && text !== 'closed')
+        exitError(`--status is open or closed, not '${text}'`);
+    return text;
+}
+/** A page size option, checked. */
+function limitOf(text) {
+    if (text === undefined)
+        return undefined;
+    const limit = Number(text);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 50)
+        exitError(`--limit is a whole number from 1 to 50, not '${text}'`);
+    return limit;
+}
+/** A moment, as a terminal shows it. */
+function when(at) {
+    return at.toISOString().replace('T', ' ').slice(0, 16);
+}
+/** Text on one line, cut to a width. */
+function line(text, width) {
+    const one = text.replace(/\s+/g, ' ').trim();
+    return one.length <= width ? one : `${one.slice(0, width - 1)}…`;
+}
+/** Who sent a note. */
+function senderOf(note) {
+    return note.sender.email.type === 'some' ? note.sender.email.value : note.sender.sub;
+}
+export const feedbackCommand = {
+    /** e3-cloud feedback list <workspaceUrl> [--status] [--limit] [--cursor] [--mine] */
+    async list(url, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const status = statusOf(options.status) ?? 'open';
+            const page = {
+                status,
+                ...(limitOf(options.limit) !== undefined && { limit: limitOf(options.limit) }),
+                ...(options.cursor !== undefined && { cursor: options.cursor }),
+            };
+            if (options.mine === true) {
+                const mine = await listMyFeedback(baseUrl, repo, workspace, { token }, page);
+                if (mine.notes.length === 0)
+                    console.log(`You have no ${status} feedback in ${workspace}.`);
+                for (const note of mine.notes) {
+                    console.log(`${feedbackId(note.number).padEnd(8)} ${when(note.createdAt)}  ${line(note.part, 30).padEnd(30)}  ${line(note.note, 60)}`);
+                }
+                if (mine.next.type === 'some')
+                    console.log(`More: --cursor ${mine.next.value}`);
+                return;
+            }
+            const list = await listFeedback(baseUrl, repo, workspace, { token }, page);
+            console.log(`${workspace}: ${list.counts.open} open, ${list.counts.closed} closed`);
+            if (list.notes.length === 0)
+                console.log(`No ${status} feedback.`);
+            for (const note of list.notes) {
+                console.log([
+                    feedbackId(note.number).padEnd(8),
+                    when(note.createdAt),
+                    line(senderOf(note), 24).padEnd(24),
+                    line(note.part.label, 24).padEnd(24),
+                    line(note.page.route, 32).padEnd(32),
+                    line(note.note, 50),
+                ].join('  '));
+            }
+            if (list.next.type === 'some')
+                console.log(`More: --cursor ${list.next.value}`);
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+    /** e3-cloud feedback show <workspaceUrl> <number> [--status] [--screenshot <file>] */
+    async show(url, number, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const status = statusOf(options.status);
+            const note = await getFeedback(baseUrl, repo, workspace, numberOf(number), { token }, status === undefined ? {} : { status });
+            const rows = [
+                ['Feedback', `${feedbackId(note.number)} (${note.status.type})`],
+                ['Sent', `${note.createdAt.toISOString()} by ${senderOf(note)}${note.sender.name.type === 'some' ? ` (${note.sender.name.value})` : ''}`],
+                ['URL', note.page.url],
+                ['Page', `${note.page.route} — ${note.page.title}`],
+                ['Part', `${note.part.label} (${note.part.scope.type}; ${note.part.kind.type} ${note.part.kind.value})`],
+                ['Path', note.part.path],
+                ['Text', line(note.part.text, 200)],
+                ['Task', note.data.task.type === 'some' ? note.data.task.value : '—'],
+                ...[...note.data.datasets].map(([path, hash]) => ['Dataset', `${path} = ${hash}`]),
+                ['Viewport', `${note.page.viewportWidth}×${note.page.viewportHeight} @${note.page.devicePixelRatio}x, ${note.page.theme}`],
+                ['Version', note.page.version],
+                ['Screenshot', note.screenshot.type === 'stored'
+                        ? `${note.screenshot.value.mediaType}, ${note.screenshot.value.width}×${note.screenshot.value.height}, ${note.screenshot.value.size} bytes`
+                        : `none: ${note.screenshot.value}`],
+            ];
+            for (const [label, value] of rows)
+                console.log(`${label.padEnd(11)} ${value}`);
+            console.log('');
+            console.log(note.note);
+            if (options.screenshot !== undefined) {
+                if (note.screenshot.type !== 'stored')
+                    exitError(`${feedbackId(note.number)} was sent without a screenshot.`);
+                const download = await feedbackScreenshotUrl(baseUrl, repo, workspace, note.number, { token }, { status: note.status.type });
+                const response = await fetch(download);
+                if (!response.ok)
+                    exitError(`The screenshot could not be read: HTTP ${response.status}`);
+                writeFileSync(options.screenshot, new Uint8Array(await response.arrayBuffer()));
+                console.log(`\nSaved the screenshot to ${options.screenshot}`);
+            }
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+    /** e3-cloud feedback close <workspaceUrl> <number> */
+    async close(url, number) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const note = await closeFeedback(baseUrl, repo, workspace, numberOf(number), { token });
+            console.log(`${feedbackId(note.number)} is closed`);
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+    /** e3-cloud feedback reopen <workspaceUrl> <number> */
+    async reopen(url, number) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const note = await reopenFeedback(baseUrl, repo, workspace, numberOf(number), { token });
+            console.log(`${feedbackId(note.number)} is open`);
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+    /** e3-cloud feedback enable <workspaceUrl> */
+    async enable(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            await putFeedbackSettings(baseUrl, repo, workspace, true, { token });
+            console.log(`Feedback is on in ${workspace}: its pages show the Feedback button`);
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+    /** e3-cloud feedback disable <workspaceUrl> */
+    async disable(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            await putFeedbackSettings(baseUrl, repo, workspace, false, { token });
+            console.log(`Feedback is off in ${workspace}: its notes are kept`);
+        }
+        catch (err) {
+            exitError(describe(err));
+        }
+    },
+};
+//# sourceMappingURL=feedback.js.map

package/dist/src/commands/feedback.js.map

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

package/dist/src/commands/records.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export declare const recordsCommand: {
+    /** e3-cloud records list <repoUrl> <workspace> */
+    list(url: string, workspace: string): Promise<void>;
+    /** e3-cloud records history <repoUrl> <workspace> <record> [--limit n] [--before cursor] */
+    history(url: string, workspace: string, record: string, options: {
+        limit?: string;
+        before?: string;
+    }): Promise<void>;
+    /** e3-cloud records show <repoUrl> <workspace> <record> <commit> [-o file] */
+    show(url: string, workspace: string, record: string, commit: string, options: {
+        output?: string;
+    }): Promise<void>;
+    /** e3-cloud records rollback <repoUrl> <workspace> <record> <commit> [--expect-head h] [--yes] */
+    rollback(url: string, workspace: string, record: string, commit: string, options: {
+        expectHead?: string;
+        yes?: boolean;
+    }): Promise<void>;
+    /** e3-cloud records backup <repoUrl> <workspace> <record> [--note text] */
+    backup(url: string, workspace: string, record: string, options: {
+        note?: string;
+    }): Promise<void>;
+    /** e3-cloud records backups <repoUrl> <workspace> <record> */
+    backups(url: string, workspace: string, record: string): Promise<void>;
+    /** e3-cloud records restore <repoUrl> <workspace> <record> <backupId> [--expect-head h] [--yes] */
+    restore(url: string, workspace: string, record: string, id: string, options: {
+        expectHead?: string;
+        yes?: boolean;
+    }): Promise<void>;
+    /** e3-cloud records backup-pull <repoUrl> <workspace> <record> <backupId> -o <file> */
+    backupPull(url: string, workspace: string, record: string, id: string, options: {
+        output: string;
+    }): Promise<void>;
+    /** e3-cloud records backup-rm <repoUrl> <workspace> <record> <backupId> [--yes] */
+    backupRm(url: string, workspace: string, record: string, id: string, options: {
+        yes?: boolean;
+    }): Promise<void>;
+};
+//# sourceMappingURL=records.d.ts.map

package/dist/src/commands/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/commands/records.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiIH,eAAO,MAAM,cAAc;IACzB,kDAAkD;cAClC,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzD,4FAA4F;iBACzE,MAAM,aAAa,MAAM,UAAU,MAAM,WAAW;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B1H,8EAA8E;cAC9D,MAAM,aAAa,MAAM,UAAU,MAAM,UAAU,MAAM,WAAW;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BvH,kGAAkG;kBAC9E,MAAM,aAAa,MAAM,UAAU,MAAM,UAAU,MAAM,WAAW;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9I,2EAA2E;gBACzD,MAAM,aAAa,MAAM,UAAU,MAAM,WAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAavG,8DAA8D;iBAC3C,MAAM,aAAa,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5E,mGAAmG;iBAChF,MAAM,aAAa,MAAM,UAAU,MAAM,MAAM,MAAM,WAAW;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzI,uFAAuF;oBACjE,MAAM,aAAa,MAAM,UAAU,MAAM,MAAM,MAAM,WAAW;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxH,mFAAmF;kBAC/D,MAAM,aAAa,MAAM,UAAU,MAAM,MAAM,MAAM,WAAW;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CActH,CAAC"}

package/dist/src/commands/records.js

@@ -0,0 +1,301 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Records commands — history, show, rollback, backup management.
+ *
+ * Operates the cloud's system-of-record surface: the durable audit index
+ * (survives `$compact` + GC), the record's value at a commit, `$rollback`/
+ * `$restore` commits, and backups — rows naming states, which the platform
+ * keeps while the backup exists, and whose values download by segments.
+ * Mutating commands send the `X-E3-Client: cli` channel tag so audit entries
+ * show where the action came from. Rollback/restore ask for confirmation
+ * unless `--yes`.
+ *
+ * Base mutations remain on the e3 CLI (`e3 mutate` / `e3 history` /
+ * `e3 compact`); these commands add the operator layer on top.
+ */
+import { createWriteStream, writeFileSync } from 'node:fs';
+import { once } from 'node:events';
+import { decodeBeast2, encodeEastFor, some, none, variant } from '@elaraai/east';
+import { listRecordInfos, recordAudit, recordStateAt, recordStatePage, recordValueChunks, rollbackRecord, listRecordBackups, createRecordBackup, restoreRecordBackup, recordBackupStream, deleteRecordBackup, } from '@elaraai/e3-cloud-client';
+import { getValidToken } from '../credentials.js';
+import { parseRepoUrl, formatError, exitError, confirm } from '../utils.js';
+const SOURCE = 'cli';
+/** Rows `show` prints of a record too large to print whole. */
+const SHOW_ROWS = 100;
+/** Render a MutationResult outcome for the terminal; exits non-zero unless committed. */
+function reportOutcome(action, result) {
+    const outcome = result.outcome;
+    switch (outcome.type) {
+        case 'committed':
+            console.log(`${action}: committed ${outcome.value.commitHash.slice(0, 12)} (state ${outcome.value.stateHash.slice(0, 12)})`);
+            return;
+        case 'invalid':
+            exitError(`${action} refused: ${outcome.value.message}`);
+            break;
+        case 'conflict':
+            exitError(outcome.value.detail.type === 'some'
+                ? `${action} conflicted: ${outcome.value.detail.value}`
+                : `${action} lost a concurrent-write race (${outcome.value.attempts} attempts) — retry.`);
+            break;
+        case 'failed':
+            exitError(`${action} failed (exit ${outcome.value.exitCode}): ${outcome.value.stderr}`);
+            break;
+        case 'timed_out':
+            exitError(`${action} timed out after ${outcome.value.ms} ms: ${outcome.value.stderr}`);
+            break;
+    }
+}
+/** Writes a value's chunks to a file, and says how many bytes it wrote. */
+async function writeChunks(file, chunks) {
+    const out = createWriteStream(file);
+    let bytes = 0;
+    try {
+        for await (const chunk of chunks) {
+            bytes += chunk.length;
+            if (!out.write(chunk))
+                await once(out, 'drain');
+        }
+    }
+    finally {
+        out.end();
+        await once(out, 'close');
+    }
+    return bytes;
+}
+/** Prints a beast2 value as East. */
+function printValue(bytes) {
+    const { type, value } = decodeBeast2(bytes);
+    process.stdout.write(Buffer.from(encodeEastFor(type)(value)));
+    process.stdout.write('\n');
+}
+/** Resolve a commit hash or unique prefix (≥6 hex chars) against the
+ *  record's audit index, so hashes can be pasted straight from `history`
+ *  output (which shows 12-char prefixes). */
+async function resolveCommitHash(baseUrl, repo, workspace, record, hashOrPrefix, token) {
+    if (/^[a-f0-9]{64}$/.test(hashOrPrefix))
+        return hashOrPrefix;
+    if (!/^[a-f0-9]{6,63}$/.test(hashOrPrefix)) {
+        exitError(`'${hashOrPrefix}' is not a commit hash or prefix (need ≥6 hex characters).`);
+    }
+    const matches = new Set();
+    let before;
+    for (let page = 0; page < 10; page++) {
+        const result = await recordAudit(baseUrl, repo, workspace, record, { token }, {
+            limit: 200,
+            ...(before !== undefined ? { before } : {}),
+        });
+        for (const entry of result.entries) {
+            if (entry.commitHash.startsWith(hashOrPrefix))
+                matches.add(entry.commitHash);
+        }
+        if (result.nextBefore.type !== 'some')
+            break;
+        before = result.nextBefore.value;
+    }
+    const resolved = [...matches];
+    if (resolved.length === 1)
+        return resolved[0];
+    if (resolved.length === 0) {
+        exitError(`No commit matching '${hashOrPrefix}' in the most recent 2000 audit entries — pass the full 64-character hash.`);
+    }
+    exitError(`Commit prefix '${hashOrPrefix}' is ambiguous (${resolved.length} matches) — use more characters.`);
+}
+function fmtWhen(at) {
+    return at.toISOString().replace('T', ' ').replace(/\.\d+Z$/, 'Z');
+}
+export const recordsCommand = {
+    /** e3-cloud records list <repoUrl> <workspace> */
+    async list(url, workspace) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const records = await listRecordInfos(baseUrl, repo, workspace, { token });
+            if (records.length === 0) {
+                console.log('No records in this workspace.');
+                return;
+            }
+            for (const record of records) {
+                if (record.head.type === 'some') {
+                    const head = record.head.value;
+                    console.log(`${record.name}  head ${head.commitHash.slice(0, 12)} (${head.mutation} by ${head.actor} at ${fmtWhen(head.at)})  backups ${record.backupCount}${record.moreBackups ? '+' : ''}`);
+                }
+                else {
+                    console.log(`${record.name}  (no state)  backups ${record.backupCount}${record.moreBackups ? '+' : ''}`);
+                }
+                console.log(`  mutations: ${record.mutations.join(', ') || '(none)'}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records history <repoUrl> <workspace> <record> [--limit n] [--before cursor] */
+    async history(url, workspace, record, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const limit = options.limit !== undefined ? Number(options.limit) : undefined;
+            const page = await recordAudit(baseUrl, repo, workspace, record, { token }, {
+                ...(limit !== undefined && Number.isFinite(limit) ? { limit } : {}),
+                ...(options.before !== undefined ? { before: options.before } : {}),
+            });
+            if (page.entries.length === 0) {
+                console.log('No audit entries.');
+                return;
+            }
+            for (const entry of page.entries) {
+                const source = entry.source.type === 'some' ? entry.source.value : 'api';
+                const gone = entry.stateAvailable ? '' : '  [state reclaimed — restore from a backup]';
+                console.log(`${fmtWhen(entry.at)}  ${entry.commitHash.slice(0, 12)}  ${entry.mutation}  ${entry.actor} (${source})${gone}`);
+            }
+            if (page.nextBefore.type === 'some') {
+                console.log(`\nMore: --before '${page.nextBefore.value}'`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records show <repoUrl> <workspace> <record> <commit> [-o file] */
+    async show(url, workspace, record, commit, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const commitHash = await resolveCommitHash(baseUrl, repo, workspace, record, commit, token);
+            const state = await recordStateAt(baseUrl, repo, workspace, record, commitHash, { token });
+            if (options.output !== undefined) {
+                // A value too large to answer whole downloads by its segments
+                let bytes;
+                if (state.kind === 'value') {
+                    writeFileSync(options.output, state.data);
+                    bytes = state.data.byteLength;
+                }
+                else {
+                    bytes = await writeChunks(options.output, await recordValueChunks(baseUrl, repo, variant('manifest', state.manifest), { token }));
+                }
+                console.log(`Wrote ${bytes} bytes (beast2) to ${options.output}`);
+                return;
+            }
+            if (state.kind === 'value') {
+                printValue(state.data);
+                return;
+            }
+            const page = await recordStatePage(baseUrl, repo, workspace, record, commitHash, { offset: 0, limit: SHOW_ROWS }, { token });
+            printValue(page.data);
+            console.error(`(the first ${page.count} of ${state.rows} rows; -o <file> writes the whole value)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records rollback <repoUrl> <workspace> <record> <commit> [--expect-head h] [--yes] */
+    async rollback(url, workspace, record, commit, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const commitHash = await resolveCommitHash(baseUrl, repo, workspace, record, commit, token);
+            if (!options.yes) {
+                const ok = await confirm(`Roll '${record}' back to ${commitHash.slice(0, 12)}? History is preserved (a $rollback commit is appended) and downstream tasks re-run.`);
+                if (!ok)
+                    exitError('Aborted.');
+            }
+            const result = await rollbackRecord(baseUrl, repo, workspace, record, {
+                targetCommitHash: commitHash,
+                expectedHead: options.expectHead !== undefined ? some(options.expectHead) : none,
+            }, { token }, SOURCE);
+            reportOutcome('Rollback', result);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records backup <repoUrl> <workspace> <record> [--note text] */
+    async backup(url, workspace, record, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const info = await createRecordBackup(baseUrl, repo, workspace, record, {
+                ...(options.note !== undefined ? { note: options.note } : {}),
+            }, { token }, SOURCE);
+            console.log(`Backup ${info.id} created (head ${info.commitHash.slice(0, 12)}, state ${info.stateHash.slice(0, 12)})`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records backups <repoUrl> <workspace> <record> */
+    async backups(url, workspace, record) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const backups = await listRecordBackups(baseUrl, repo, workspace, record, { token });
+            if (backups.length === 0) {
+                console.log('No backups.');
+                return;
+            }
+            for (const backup of backups) {
+                const note = backup.note.type === 'some' ? `  "${backup.note.value}"` : '';
+                const auto = backup.auto ? '  [auto]' : '';
+                const migrations = backup.migrations.length > 0 ? `  migrations ${backup.migrations.join(', ')}` : '';
+                console.log(`${backup.id}  head ${backup.commitHash.slice(0, 12)}${migrations}  by ${backup.actor}${auto}${note}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records restore <repoUrl> <workspace> <record> <backupId> [--expect-head h] [--yes] */
+    async restore(url, workspace, record, id, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            if (!options.yes) {
+                const ok = await confirm(`Restore '${record}' from backup ${id}? A $restore commit is appended (history preserved) and downstream tasks re-run.`);
+                if (!ok)
+                    exitError('Aborted.');
+            }
+            const result = await restoreRecordBackup(baseUrl, repo, workspace, record, id, {
+                expectedHead: options.expectHead !== undefined ? some(options.expectHead) : none,
+            }, { token }, SOURCE);
+            reportOutcome('Restore', result);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records backup-pull <repoUrl> <workspace> <record> <backupId> -o <file> */
+    async backupPull(url, workspace, record, id, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            // The record's value, downloaded by segments: a plain beast2 value file
+            const { chunks } = await recordBackupStream(baseUrl, repo, workspace, record, id, { token });
+            const bytes = await writeChunks(options.output, chunks);
+            console.log(`Wrote ${bytes} bytes (beast2) to ${options.output}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud records backup-rm <repoUrl> <workspace> <record> <backupId> [--yes] */
+    async backupRm(url, workspace, record, id, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            if (!options.yes) {
+                const ok = await confirm(`Delete backup ${id} of '${record}'? This cannot be undone.`);
+                if (!ok)
+                    exitError('Aborted.');
+            }
+            await deleteRecordBackup(baseUrl, repo, workspace, record, id, { token });
+            console.log(`Deleted backup ${id}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=records.js.map

package/dist/src/commands/records.js.map

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

package/dist/src/commands/release.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Releases:
+ *
+ * - `e3-cloud release <repo-url> <from> <to> [--plan] [--carry <path...>] [--remove-apps]`
+ * - `e3-cloud rollback <repo-url> <workspace> [<history-id>] [--plan]`
+ * - `e3-cloud history <repo-url> <workspace> [--limit <n>]`
+ *
+ * A release and a rollback print their plan first, always; `--plan` stops
+ * there. One that deploys its package waits for its deploy job. A workspace
+ * is released to only by its staging (`e3-cloud staging`);
+ * the plan names any change an admin forced onto it since its last release,
+ * which the release undoes.
+ */
+import { type ReleasePlan, type WorkspaceHistoryEntry } from '@elaraai/e3-cloud-client';
+/** What a plan does, a line for each part. */
+export declare function planLines(plan: ReleasePlan): string[];
+/** What an entry of a workspace's history did, in a few words. */
+export declare function entryKindWords(kind: WorkspaceHistoryEntry['kind']): string;
+export declare const releaseCommand: {
+    /** e3-cloud release <repoUrl> <from> <to> [--plan] [--carry <path...>] [--remove-apps] */
+    release(url: string, from: string, to: string, options: {
+        plan?: boolean;
+        carry?: string[];
+        removeApps?: boolean;
+    }): Promise<void>;
+    /** e3-cloud rollback <repoUrl> <workspace> [historyId] [--plan] */
+    rollback(url: string, workspace: string, id: string | undefined, options: {
+        plan?: boolean;
+    }): Promise<void>;
+    /** e3-cloud history <repoUrl> <workspace> [--limit <n>] */
+    history(url: string, workspace: string, options: {
+        limit?: string;
+    }): Promise<void>;
+};
+//# sourceMappingURL=release.d.ts.map

package/dist/src/commands/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/release.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAML,KAAK,WAAW,EAEhB,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAoBlC,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CA0DrD;AAoDD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAAG,MAAM,CAW1E;AAWD,eAAO,MAAM,cAAc;IACzB,0FAA0F;iBACvE,MAAM,QAAQ,MAAM,MAAM,MAAM,WAAW;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxI,mEAAmE;kBAC/C,MAAM,aAAa,MAAM,MAAM,MAAM,GAAG,SAAS,WAAW;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlH,2DAA2D;iBACxC,MAAM,aAAa,MAAM,WAAW;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB1F,CAAC"}