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

package/dist/src/commands/release.js

@@ -0,0 +1,219 @@
+/**
+ * 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 { appDeployWait, releasePlanRefusalLines, releaseWorkspace, rollbackWorkspace, workspaceHistory, } from '@elaraai/e3-cloud-client';
+import { none, some } from '@elaraai/east';
+import { getValidToken } from '../credentials.js';
+import { exitError, formatError, parseRepoUrl } from '../utils.js';
+/** A package, as people name it: `acme@1.5.0`. */
+function packageWords(pkg) {
+    return `${pkg.name}@${pkg.version}`;
+}
+/** When, in UTC, as the CLI prints it: `2026-10-12 14:02`. */
+function when(at) {
+    return at.toISOString().replace('T', ' ').slice(0, 16);
+}
+/** The plan a response carries. */
+function planOf(response) {
+    return response.type === 'releasing' ? response.value.plan : response.value;
+}
+/** What a plan does, a line for each part. */
+export function planLines(plan) {
+    const head = plan.source.type === 'workspace'
+        ? `Release ${plan.source.value} to ${plan.target}`
+        : `Roll ${plan.target} back to the entry of ${when(plan.source.value.at)}`;
+    const lines = [head];
+    const row = (label, words) => lines.push(`  ${label.padEnd(9)} ${words}`);
+    const from = plan.package.from.type === 'some' ? plan.package.from.value : null;
+    const to = plan.package.to.type === 'some' ? plan.package.to.value : null;
+    if (to !== null)
+        row('Package', from === null ? packageWords(to) : from.hash === to.hash ? `${packageWords(to)}, as it runs` : `${packageWords(from)} → ${packageWords(to)}`);
+    const theirs = plan.source.type === 'workspace' ? `${plan.source.value}'s ` : '';
+    const apps = plan.apps.map((app) => {
+        switch (app.change.type) {
+            case 'added': return `${app.name} added (${theirs}v${app.change.value.to.number})`;
+            case 'updated': return `${app.name} v${app.change.value.from.number} → ${theirs}v${app.change.value.to.number}`;
+            case 'unchanged': return `${app.name} unchanged`;
+            case 'removed': return `${app.name} removed`;
+        }
+    });
+    if (apps.length > 0)
+        row('Apps', apps.join(' · '));
+    // The bundles staged for the platform's next e3 that go with the apps
+    const staged = plan.apps.flatMap((app) => {
+        const { from: was, to: now } = app.stagedFor;
+        if (was.type === now.type && (was.type === 'none' || (now.type === 'some' && was.value === now.value)))
+            return [];
+        return [now.type === 'some' ? `${app.name}'s bundle for e3 ${now.value} staged` : `${app.name}'s bundle for e3 ${was.type === 'some' ? was.value : ''} cleared`];
+    });
+    if (staged.length > 0)
+        row('Staged', staged.join(' · '));
+    const records = plan.records.map((record) => {
+        const name = record.record.replace(/^records\//, '');
+        switch (record.action.type) {
+            case 'mint': return `${name} new`;
+            case 'keep': return `${name} kept`;
+            case 'migrate': return `${name} migrates (${record.action.value.steps.length} step${record.action.value.steps.length === 1 ? '' : 's'})`;
+            case 'reset': return `${name} reset: ${record.action.value.reason}`;
+            case 'drop': return `${name} dropped`;
+            case 'refused': return `${name} refused`;
+        }
+    });
+    if (records.length > 0)
+        row('Records', records.join(' · '));
+    const built = plan.indexes.filter((index) => index.action.type === 'build').map((index) => index.index);
+    if (built.length > 0)
+        row('Indexes', `${built.join(', ')} built`);
+    const kept = plan.inputs.filter((input) => input.action.type === 'keep').map((input) => input.input);
+    const reset = plan.inputs.filter((input) => input.action.type === 'reset').map((input) => input.input);
+    const inputs = [
+        ...(kept.length > 0 ? [`${plan.target}'s kept: ${kept.join(', ')}`] : []),
+        ...(reset.length > 0 ? [`reset: ${reset.join(', ')}`] : []),
+    ];
+    if (inputs.length > 0)
+        row('Inputs', inputs.join(' · '));
+    if (plan.carry.length > 0)
+        row('Carry', plan.carry.map((ref) => ref.path).join(' · '));
+    if (to !== null)
+        row('Checks', plan.checks.length === 0 ? `every app fits ${packageWords(to)}` : `${plan.checks.length} app${plan.checks.length === 1 ? '' : 's'} would not fit`);
+    // The changes forced onto the target past its protection, which this undoes
+    for (const [i, undone] of plan.undoes.entries()) {
+        row(i === 0 ? 'Undoes' : '', `${undone.summary} (forced by ${undone.actor}, ${when(undone.at)})`);
+    }
+    return lines;
+}
+/** Shows a plan, ends with its refusal if it has one, and applies it once shown unless asked only for the plan. */
+async function planThenApply(plan, apply, planOnly, wait) {
+    const planned = planOf(await plan());
+    console.log(planLines(planned).join('\n'));
+    const refusal = releasePlanRefusalLines(planned);
+    if (refusal.length > 0) {
+        console.error(['Refused:', ...refusal.map((line) => `  ${line}`)].join('\n'));
+        process.exit(1);
+    }
+    if (planOnly)
+        return;
+    const response = await apply(planned);
+    switch (response.type) {
+        case 'refused':
+            console.error(['Refused:', ...releasePlanRefusalLines(response.value).map((line) => `  ${line}`)].join('\n'));
+            process.exit(1);
+            break;
+        case 'released':
+            console.log(`Done: ${response.value.target}'s apps switched`);
+            break;
+        case 'releasing':
+            await wait(response.value.job);
+            break;
+        case 'planned':
+            break;
+    }
+}
+/** Waits for a release's deploy job, saying what it is at, then what it kept. */
+async function waitFor(baseUrl, repo, workspace, job, token) {
+    console.log(`Deploying to ${workspace} (job ${job})…`);
+    let said = '';
+    const result = await appDeployWait(baseUrl, repo, workspace, job, { token }, {
+        // The token read afresh for each poll: a long deploy outlives it
+        refresh: async () => ({ token: await getValidToken(baseUrl) }),
+        onProgress: (progress) => {
+            const now = progress.type === 'pending' ? 'waiting for the workspace' : 'deploying';
+            if (now !== said)
+                console.log(`  ${now}…`);
+            said = now;
+        },
+    });
+    const kept = result.inputs.filter((input) => input.action.type === 'keep').map((input) => input.input);
+    if (kept.length > 0)
+        console.log(`  ${workspace} kept the ${kept.length === 1 ? 'input' : 'inputs'} people set: ${kept.join(', ')}`);
+    console.log(`Done: ${workspace} runs what was released`);
+}
+/** What an entry of a workspace's history did, in a few words. */
+export function entryKindWords(kind) {
+    switch (kind.type) {
+        case 'release': return `release from ${kind.value.from}`;
+        case 'rollback': return 'rollback';
+        case 'copy': return `copy from ${kind.value.from}`;
+        case 'app_deploy': return 'app deploy';
+        case 'deploy': return 'deploy';
+        case 'staging_added': return `staging ${kind.value.staging} added`;
+        case 'staging_stopped': return `staging ${kind.value.staging} stopped`;
+        case 'staging_skipped': return kind.value.type === 'app_deploy' ? 'app deploy, forced' : `${kind.value.value.app} removed, forced`;
+    }
+}
+/** An entry of a workspace's history, as a line. */
+function entryLine(entry) {
+    const kind = entryKindWords(entry.kind);
+    const pkg = entry.package.type === 'some' ? packageWords(entry.package.value) : 'no package';
+    const apps = entry.apps.map((app) => `${app.name} v${app.number}`).join(', ');
+    const outcome = entry.outcome.type === 'failed' ? `failed: ${entry.outcome.value}` : entry.outcome.type;
+    return `${when(entry.at)}  ${kind.padEnd(24)}  ${pkg}${apps === '' ? '' : `  ${apps}`}  ${outcome}\n    ${entry.id}`;
+}
+export const releaseCommand = {
+    /** e3-cloud release <repoUrl> <from> <to> [--plan] [--carry <path...>] [--remove-apps] */
+    async release(url, from, to, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const request = { from, carry: options.carry ?? [], removeApps: options.removeApps === true };
+            await planThenApply(() => releaseWorkspace(baseUrl, repo, to, { ...request, plan: true }, { token }), () => releaseWorkspace(baseUrl, repo, to, { ...request, plan: false }, { token }), options.plan === true, (job) => waitFor(baseUrl, repo, to, job, token));
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud rollback <repoUrl> <workspace> [historyId] [--plan] */
+    async rollback(url, workspace, id, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const to = id === undefined ? none : some(id);
+            await planThenApply(() => rollbackWorkspace(baseUrl, repo, workspace, { to, plan: true }, { token }), 
+            // Back to the entry the plan shown named, not to whatever differs by then
+            (planned) => rollbackWorkspace(baseUrl, repo, workspace, {
+                to: planned.source.type === 'history' ? some(planned.source.value.id) : to,
+                plan: false,
+            }, { token }), options.plan === true, (job) => waitFor(baseUrl, repo, workspace, job, token));
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud history <repoUrl> <workspace> [--limit <n>] */
+    async history(url, workspace, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const limit = options.limit === undefined ? undefined : Number(options.limit);
+            if (limit !== undefined && (!Number.isInteger(limit) || limit < 1))
+                exitError(`--limit is a whole number from 1, not '${options.limit}'`);
+            const page = await workspaceHistory(baseUrl, repo, workspace, { token }, limit === undefined ? {} : { limit });
+            if (page.entries.length === 0) {
+                console.log(`${workspace} has no history yet`);
+                return;
+            }
+            for (const entry of page.entries)
+                console.log(entryLine(entry));
+            if (page.next.type === 'some')
+                console.log(`… older entries follow (${page.entries.length} shown)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=release.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type RoleGrant } from '@elaraai/e3-cloud-types';
+/**
+ * A grant as `--grant` writes it: `workspace/app` for every page, or
+ * `workspace/app:page,page` for those pages.
+ *
+ * @param text - The option's value
+ * @returns The grant, or null when it is not one
+ */
+export declare function parseGrant(text: string): RoleGrant | null;
+/** A grant in words, as `--grant` writes it. */
+export declare function grantWords(grant: RoleGrant): string;
+export declare const roleCommand: {
+    list(url: string): Promise<void>;
+    show(url: string, name: string): Promise<void>;
+    set(url: string, name: string, options: {
+        grant: string[];
+    }): Promise<void>;
+    remove(url: string, name: string): Promise<void>;
+};
+//# sourceMappingURL=role.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../src/commands/role.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAI3F;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOzD;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD;AAOD,eAAO,MAAM,WAAW;cACN,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAYtB,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;aAUrC,MAAM,QAAQ,MAAM,WAAW;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;gBAiB/D,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUvD,CAAC"}

package/dist/src/commands/role.js

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3-cloud role: a repository's business roles, the jobs
+ * its users do, each granting apps, every page of each or some. A person
+ * holds them through `e3-cloud user add --role user --roles …`.
+ */
+import { variant } from '@elaraai/east';
+import { deleteRole, getRole, listRoles, putRole } from '@elaraai/e3-cloud-client';
+import { ALL_APPS_ROLE } from '@elaraai/e3-cloud-types';
+import { getValidToken } from '../credentials.js';
+import { parseRepoUrl, formatError, exitError } from '../utils.js';
+/**
+ * A grant as `--grant` writes it: `workspace/app` for every page, or
+ * `workspace/app:page,page` for those pages.
+ *
+ * @param text - The option's value
+ * @returns The grant, or null when it is not one
+ */
+export function parseGrant(text) {
+    const match = /^([^/:]+)\/([^/:]+)(?::(.+))?$/.exec(text.trim());
+    if (match === null)
+        return null;
+    const [, workspace, app, pages] = match;
+    if (pages === undefined)
+        return { workspace: workspace, app: app, pages: variant('all', null) };
+    const named = pages.split(',').map((page) => page.trim()).filter((page) => page !== '');
+    return named.length === 0 ? null : { workspace: workspace, app: app, pages: variant('some', named) };
+}
+/** A grant in words, as `--grant` writes it. */
+export function grantWords(grant) {
+    return `${grant.workspace}/${grant.app}${grant.pages.type === 'all' ? '' : `:${grant.pages.value.join(',')}`}`;
+}
+/** A role in words: its name, and what it grants. */
+function roleLine(role) {
+    return `${role.name.padEnd(28)} ${role.grants.length === 0 ? '(grants nothing)' : role.grants.map(grantWords).join('  ')}`;
+}
+export const roleCommand = {
+    async list(url) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const roles = await listRoles(baseUrl, repo, { token });
+            console.log(`${ALL_APPS_ROLE.padEnd(28)} every app of the live workspaces (built in)`);
+            for (const role of roles)
+                console.log(roleLine(role));
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async show(url, name) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            console.log(roleLine(await getRole(baseUrl, repo, name, { token })));
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async set(url, name, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const grants = [];
+            for (const text of options.grant) {
+                const grant = parseGrant(text);
+                if (grant === null)
+                    exitError(`'${text}' is no grant: write workspace/app, or workspace/app:page,page`);
+                grants.push(grant);
+            }
+            const role = await putRole(baseUrl, repo, { name, grants }, { token });
+            console.log(`Set ${roleLine(role)}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async remove(url, name) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            await deleteRole(baseUrl, repo, name, { token });
+            console.log(`Removed ${name}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=role.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export declare const scheduleCommand: {
+    set(url: string, options: {
+        cron?: string;
+        forceTasks?: string;
+        forceRegex?: string;
+        timezone?: string;
+        description?: string;
+        enabled?: string;
+    }): Promise<void>;
+    get(url: string): Promise<void>;
+    remove(url: string): Promise<void>;
+    list(url: string): Promise<void>;
+};
+//# sourceMappingURL=schedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/commands/schedule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,eAAO,MAAM,eAAe;aAEnB,MAAM,WACF;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,IAAI,CAAC;aA8DD,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBA0BnB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAYxB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BvC,CAAC"}

package/dist/src/commands/schedule.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Schedule management commands — set, get, remove, list schedules.
+ */
+import { some, none } from '@elaraai/east';
+import { getSchedule, setSchedule, removeSchedule, listSchedules, } from '@elaraai/e3-cloud-client';
+import { taskList } from '@elaraai/e3-api-client';
+import { getValidToken } from '../credentials.js';
+import { parseWorkspaceUrl, parseRepoUrl, formatError, exitError, confirm } from '../utils.js';
+export const scheduleCommand = {
+    async set(url, options) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            // Build request — for updates, first fetch existing values
+            const existing = await getSchedule(baseUrl, repo, workspace, { token });
+            const cronExpression = options.cron ?? existing?.cronExpression;
+            if (!cronExpression) {
+                exitError('--cron is required when creating a new schedule');
+            }
+            let forceTasks;
+            if (options.forceRegex) {
+                // Resolve regex against deployed task list
+                const tasks = await taskList(baseUrl, repo, workspace, { token });
+                const regex = new RegExp(options.forceRegex);
+                const matched = tasks.filter(t => regex.test(t.name)).map(t => t.name);
+                if (matched.length === 0) {
+                    exitError(`No tasks matched pattern: ${options.forceRegex}`);
+                }
+                console.log(`Matched ${matched.length} tasks: ${matched.join(', ')}`);
+                if (!await confirm('Use these as force-tasks?'))
+                    return;
+                forceTasks = matched;
+            }
+            else if (options.forceTasks) {
+                forceTasks = options.forceTasks.split(',').map(s => s.trim());
+            }
+            else {
+                forceTasks = existing?.forceTasks ?? [];
+            }
+            const enabled = options.enabled !== undefined
+                ? options.enabled !== 'false'
+                : (existing?.enabled ?? true);
+            const schedule = await setSchedule(baseUrl, repo, workspace, {
+                cronExpression,
+                timezone: options.timezone ? some(options.timezone) : none,
+                forceTasks,
+                enabled,
+                description: options.description ? some(options.description) : (existing?.description ?? none),
+            }, { token });
+            console.log(`Schedule ${existing ? 'updated' : 'created'} for ${repo}/${workspace}:`);
+            console.log(`  Cron:            ${schedule.cronExpression}`);
+            console.log(`  Timezone:        ${schedule.timezone}`);
+            console.log(`  Force tasks:     ${schedule.forceTasks.join(', ') || '(none)'}`);
+            console.log(`  Status:          ${schedule.enabled ? 'enabled' : 'disabled'}`);
+            if (schedule.description.type === 'some') {
+                console.log(`  Description:     ${schedule.description.value}`);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async get(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            const schedule = await getSchedule(baseUrl, repo, workspace, { token });
+            if (!schedule) {
+                console.log(`No schedule configured for ${repo}/${workspace}`);
+                return;
+            }
+            console.log(`Schedule for ${repo}/${workspace}:`);
+            console.log(`  Cron:            ${schedule.cronExpression}`);
+            console.log(`  Timezone:        ${schedule.timezone}`);
+            console.log(`  Force tasks:     ${schedule.forceTasks.join(', ') || '(none)'}`);
+            console.log(`  Status:          ${schedule.enabled ? 'enabled' : 'disabled'}`);
+            if (schedule.description.type === 'some') {
+                console.log(`  Description:     ${schedule.description.value}`);
+            }
+            console.log(`  Last updated:    ${schedule.updatedAt}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async remove(url) {
+        try {
+            const { baseUrl, repo, workspace } = parseWorkspaceUrl(url);
+            const token = await getValidToken(baseUrl);
+            await removeSchedule(baseUrl, repo, workspace, { token });
+            console.log(`Schedule removed for ${repo}/${workspace}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    async list(url) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const schedules = await listSchedules(baseUrl, repo, { token });
+            if (schedules.length === 0) {
+                console.log(`No schedules configured for ${repo}`);
+                return;
+            }
+            console.log(`Schedules for ${repo}:`);
+            for (const s of schedules) {
+                const desc = s.description.type === 'some' ? s.description.value : '';
+                const row = [
+                    `  ${s.workspace.padEnd(16)}`,
+                    `${s.cronExpression.padEnd(16)}`,
+                    `${s.timezone.padEnd(20)}`,
+                    `${(s.enabled ? 'enabled' : 'disabled').padEnd(12)}`,
+                    desc,
+                ].join('');
+                console.log(row);
+            }
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=schedule.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export declare const secretsCommand: {
+    /** e3-cloud secrets set <repoUrl> <NAME> [--value v] (value via stdin otherwise) */
+    set(url: string, name: string, options: {
+        value?: string;
+    }): Promise<void>;
+    /** e3-cloud secrets list <repoUrl> */
+    list(url: string): Promise<void>;
+    /** e3-cloud secrets rm <repoUrl> <NAME> */
+    rm(url: string, name: string): Promise<void>;
+};
+//# sourceMappingURL=secrets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,eAAO,MAAM,cAAc;IACzB,oFAAoF;aACrE,MAAM,QAAQ,MAAM,WAAW;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhF,sCAAsC;cACtB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtC,2CAA2C;YAC7B,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD,CAAC"}

package/dist/src/commands/secrets.js

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Secrets commands — set, list, rm.
+ *
+ * Manages per-repo secrets: credentials task code reads at runtime with
+ * `Env.get("NAME")` (east-node-std). Values are write-only — they can be set
+ * and deleted here but never read back; `list` shows names and modification
+ * times only. The value for `set` comes from `--value` or, preferably, stdin
+ * (keeps it out of shell history and process listings). Values are never
+ * echoed by any command.
+ */
+import { listSecrets, putSecret, deleteSecret } from '@elaraai/e3-cloud-client';
+import { getValidToken } from '../credentials.js';
+import { parseRepoUrl, formatError, exitError } from '../utils.js';
+/** Read all of stdin as a UTF-8 string. */
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString('utf-8');
+}
+export const secretsCommand = {
+    /** e3-cloud secrets set <repoUrl> <NAME> [--value v] (value via stdin otherwise) */
+    async set(url, name, options) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            let value = options.value;
+            if (value === undefined) {
+                if (process.stdin.isTTY) {
+                    exitError('No value given. Pipe it on stdin (e.g. `printf %s "$VALUE" | e3-cloud secrets set …`) or pass --value.');
+                }
+                value = await readStdin();
+                // Trim exactly one trailing newline — `echo` and heredocs append one.
+                if (value.endsWith('\n'))
+                    value = value.slice(0, -1);
+            }
+            if (value.length === 0)
+                exitError('Secret value must not be empty.');
+            await putSecret(baseUrl, repo, name, value, { token });
+            console.log(`Set secret ${name} (takes effect on the next task run)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud secrets list <repoUrl> */
+    async list(url) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            const entries = await listSecrets(baseUrl, repo, { token });
+            if (entries.length === 0) {
+                console.log('No secrets.');
+                return;
+            }
+            for (const entry of entries) {
+                console.log(`${entry.lastModified.toISOString()}  ${entry.name}`);
+            }
+            console.log(`${entries.length} secret${entries.length === 1 ? '' : 's'} (values are write-only and never shown)`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+    /** e3-cloud secrets rm <repoUrl> <NAME> */
+    async rm(url, name) {
+        try {
+            const { baseUrl, repo } = parseRepoUrl(url);
+            const token = await getValidToken(baseUrl);
+            await deleteSecret(baseUrl, repo, name, { token });
+            console.log(`Deleted secret ${name}`);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    },
+};
+//# sourceMappingURL=secrets.js.map