@skrr-ai/cli 0.1.109 → 0.1.111

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

@@ -0,0 +1,20 @@
+import { AppsCommand } from '../../lib/apps-command';
+/**
+ * Report the app an installation runs. The Store's report, for an installed App: the same reasons, the same
+ * queue, and the same limits (a report on a version once, a `security` one while none is open). A report
+ * REMOVES nothing, pauses nothing and tells nobody: it is a row that a moderator reads.
+ */
+export default class AppsReport extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        reason: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/report.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+/**
+ * Report the app an installation runs. The Store's report, for an installed App: the same reasons, the same
+ * queue, and the same limits (a report on a version once, a `security` one while none is open). A report
+ * REMOVES nothing, pauses nothing and tells nobody: it is a row that a moderator reads.
+ */
+class AppsReport extends apps_command_1.AppsCommand {
+    static description = 'Report the app an installation runs (use --reason security to report a vulnerability). A report is read by the people who moderate the Store; it does not pause, remove or tell anyone by itself.';
+    static examples = [
+        '<%= config.bin %> apps report appi_abc --reason broken --description "Shows a blank window"',
+        '<%= config.bin %> apps report appi_abc --reason security --description "Sends my notes to a host it never declared"',
+    ];
+    static args = {
+        installation: core_1.Args.string({
+            description: 'The installation id (appi_...) of the app you are reporting',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        reason: core_1.Flags.string({
+            description: 'Why you are reporting it',
+            required: true,
+            options: data_provider_1.STORE_REPORT_REASONS.map((entry) => entry.value),
+        }),
+        description: core_1.Flags.string({ description: 'What happened (required for security reports)' }),
+        version: core_1.Flags.string({
+            description: 'The version the report is about (appv_...); it must be the one the installation runs',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output the report as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsReport);
+        const reason = flags.reason;
+        if (reason === data_provider_1.STORE_SECURITY_REPORT_REASON && !flags.description?.trim()) {
+            this.error('A security report needs --description, so that whoever reads it can reproduce the problem.', { exit: 1 });
+        }
+        try {
+            const result = await data_provider_1.dataService.reportAppInstallation(args.installation, {
+                reason,
+                ...(flags.description === undefined ? {} : { description: flags.description }),
+                ...(flags.version === undefined ? {} : { versionId: flags.version }),
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(result.private
+                ? `Security report ${result.reportId} sent privately about ${result.appId} (${result.versionLabel || result.versionId}).`
+                : `Report ${result.reportId} submitted about ${result.appId} (${result.versionLabel || result.versionId}).`);
+            this.log(`Follow it with: ${this.config.bin} store reports --agent ${result.appId}`);
+        }
+        catch (error) {
+            this.failReport(error);
+        }
+    }
+}
+exports.default = AppsReport;

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

@@ -0,0 +1,12 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsResume extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/resume.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+const appInstallations_1 = require("../../lib/appInstallations");
+class AppsResume extends apps_command_1.AppsCommand {
+    static description = 'Lift a pause. What it is afterwards is what its approval says about the version it runs: ready, or still needing your approval again if the version moved while it was paused.';
+    static examples = ['<%= config.bin %> apps resume appi_abc'];
+    static args = {
+        installation: core_1.Args.string({
+            description: 'The installation id (appi_...)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the installation as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsResume);
+        try {
+            const result = await data_provider_1.dataService.resumeAppInstallation(args.installation);
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`${result.installation.id} is ${(0, appInstallations_1.describeAvailability)(result.installation.availability)}`);
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsResume;

package/dist/commands/apps/settings/set.d.ts

@@ -0,0 +1,13 @@
+import { AppsCommand } from '../../../lib/apps-command';
+export default class AppsSettingsSet extends AppsCommand {
+    static description: string;
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/settings/set.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../../lib/apps-command");
+const appSettings_1 = require("../../../lib/appSettings");
+class AppsSettingsSet extends apps_command_1.AppsCommand {
+    static description = 'Replace installation settings from a JSON file. Without --yes, show resulting schedules and change nothing. Every write requires explicit human consent to the bundle and exact settings, and names the current version/settings/consent so concurrent edits are refused. Existing suspended or manually edited jobs keep their state.';
+    static args = { installation: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        json: core_1.Flags.boolean(),
+        file: core_1.Flags.string({
+            required: true,
+            description: 'JSON settings record; omitted keys use manifest defaults. Never include secrets',
+        }),
+        yes: core_1.Flags.boolean({
+            description: 'Explicitly approve these settings and resulting schedules under your installer authority',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsSettingsSet);
+        try {
+            const current = await data_provider_1.dataService.getAppInstallationSettings(args.installation);
+            const settings = (0, appSettings_1.readAppSettingsFile)(flags.file, current.configuration);
+            const lines = (0, appSettings_1.formatAppSettings)(current.configuration, settings, current.timezone);
+            if (!flags.yes)
+                return this.failWithCliError({
+                    message: `${lines.join('\n')}\nNothing changed. Run again with --yes to approve exactly these settings.`,
+                    code: 'APP_CONSENT_REQUIRED',
+                    exit: 2,
+                    retryable: false,
+                    details: { settings, current },
+                });
+            if (!flags.json)
+                for (const line of lines)
+                    this.logToStderr(line);
+            const result = await data_provider_1.dataService.putAppInstallationSettings(args.installation, {
+                settings,
+                expectedSettings: current.settings,
+                expectedVersionId: current.expectedVersionId,
+                expectedGrantedAt: current.expectedGrantedAt,
+                consent: { versionId: current.expectedVersionId, bundleHash: current.bundleHash, settings },
+            });
+            if (flags.json)
+                return this.printJsonResult(result);
+            this.log(`Saved settings for ${args.installation}. Schedule reconciliation was requested; use apps installations show to inspect job state.`);
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsSettingsSet;

package/dist/commands/apps/settings/show.d.ts

@@ -0,0 +1,11 @@
+import { AppsCommand } from '../../../lib/apps-command';
+export default class AppsSettingsShow extends AppsCommand {
+    static description: string;
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/settings/show.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../../lib/apps-command");
+class AppsSettingsShow extends apps_command_1.AppsCommand {
+    static description = 'Show installation settings, declared fields and the resulting job schedules. Includes the exact version, settings and consent timestamp required for a safe update.';
+    static args = { installation: core_1.Args.string({ required: true, ignoreStdin: true }) };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output settings and update preconditions as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsSettingsShow);
+        try {
+            const current = await data_provider_1.dataService.getAppInstallationSettings(args.installation);
+            if (flags.json)
+                return this.printJsonResult(current);
+            this.log(JSON.stringify(current.settings, null, 2));
+            this.log(`Version ${current.expectedVersionId}; consent ${current.expectedGrantedAt}; timezone ${current.timezone}`);
+            for (const job of (0, data_provider_1.appSettingsSchedulePreview)(current.configuration, current.settings))
+                this.log(`${(0, data_provider_1.plainAppLabel)(job.title)}: ${job.problem ?? job.schedule}`);
+            if (!current.canEdit)
+                this.log('Settings cannot be changed with this grant. The installer must approve the current version first.');
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsSettingsShow;

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

@@ -0,0 +1,12 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsShow extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        app: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/show.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+class AppsShow extends apps_command_1.AppsCommand {
+    static description = 'Show an app: its draft (revision, size) and its versions.';
+    static examples = ['<%= config.bin %> apps show habit-tracker'];
+    static args = {
+        app: core_1.Args.string({
+            description: 'The app id (app_...) or its slug',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({
+            description: 'Output the app, its draft summary and its versions as JSON',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsShow);
+        const appId = await this.appId(args.app);
+        try {
+            const result = await data_provider_1.dataService.getMyApp(appId);
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`${result.app.id}  ${result.app.slug}`);
+            if (result.draft) {
+                this.log(`draft: rev ${result.draft.rev}, ${result.draft.files.count}/${result.draft.files.maxFiles} files, ${result.draft.files.chars}/${result.draft.files.maxChars} characters`);
+            }
+            else {
+                this.log('draft: none');
+            }
+            if (result.versions.length === 0)
+                this.log('versions: none');
+            for (const version of result.versions) {
+                this.log(`v${version.version}  ${version.id}  ${version.bundleHash.slice(0, 12)}  ${version.distribution.visibility}/${version.distribution.status}`);
+            }
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsShow;

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

@@ -0,0 +1,12 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsSuspend extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/suspend.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+class AppsSuspend extends apps_command_1.AppsCommand {
+    static description = 'Pause an installation: nothing it declares works (its window shows it is paused, its jobs do not fire) until you resume it. Nothing is deleted.';
+    static examples = ['<%= config.bin %> apps suspend appi_abc'];
+    static args = {
+        installation: core_1.Args.string({
+            description: 'The installation id (appi_...)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the installation as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsSuspend);
+        try {
+            const result = await data_provider_1.dataService.suspendAppInstallation(args.installation);
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`${result.installation.id} is paused`);
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsSuspend;

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

@@ -0,0 +1,13 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsUninstall extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'delete-data': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/uninstall.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+class AppsUninstall extends apps_command_1.AppsCommand {
+    static description = "Remove an installation. An app that holds data cannot be removed without saying the data may go (--delete-data): deleting data is a person's to confirm, and nothing is removed until you do.";
+    static examples = [
+        '<%= config.bin %> apps uninstall appi_abc',
+        '<%= config.bin %> apps uninstall appi_abc --delete-data',
+    ];
+    static args = {
+        installation: core_1.Args.string({
+            description: 'The installation id (appi_...)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output { deleted, deletedDocs } as JSON' }),
+        'delete-data': core_1.Flags.boolean({
+            description: 'Say that the data this app holds may be deleted with it',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsUninstall);
+        try {
+            const result = await data_provider_1.dataService.uninstallAppInstallation(args.installation, {
+                confirmDataDeletion: flags['delete-data'] === true,
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`removed ${args.installation}${result.deletedDocs > 0 ? `; ${result.deletedDocs} document${result.deletedDocs === 1 ? '' : 's'} of its data deleted` : ''}`);
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsUninstall;

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

@@ -0,0 +1,14 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsUpgrade extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        installation: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/upgrade.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../lib/apps-command");
+const appInstallations_1 = require("../../lib/appInstallations");
+class AppsUpgrade extends apps_command_1.AppsCommand {
+    static description = 'Move an installation to another version of its app (a newer one, or an older one to roll back). It never widens what was approved: a version that asks for more lands as needing your approval again, and does not run until you give it (`apps reconsent`).';
+    static examples = [
+        '<%= config.bin %> apps upgrade appi_abc --version appv_xyz',
+        '<%= config.bin %> apps upgrade appi_abc --version appv_xyz --expected-version appv_old',
+    ];
+    static args = {
+        installation: core_1.Args.string({
+            description: 'The installation id (appi_...)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the installation as JSON' }),
+        version: core_1.Flags.string({ description: 'The version to move to (appv_...)', required: true }),
+        'expected-version': core_1.Flags.string({
+            description: 'Move only if it still runs this version (appv_...); otherwise nothing changes',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsUpgrade);
+        try {
+            const result = await data_provider_1.dataService.activateAppInstallationVersion(args.installation, {
+                versionId: flags.version,
+                ...(flags['expected-version'] ? { expectedVersionId: flags['expected-version'] } : {}),
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`${result.installation.id} runs v${result.version.version} (${result.version.id}); it ${(0, appInstallations_1.describeAvailability)(result.installation.availability)}`);
+            if (result.installation.availability === 'needs_reconsent') {
+                this.log(`This version needs your approval. Review it with \`${this.config.bin} apps disclosure ${result.version.id} --installation ${result.installation.id}\`, then \`${this.config.bin} apps reconsent ${result.installation.id} --yes\`.`);
+            }
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsUpgrade;

package/dist/commands/apps/version/create.d.ts

@@ -0,0 +1,14 @@
+import { AppsCommand } from '../../../lib/apps-command';
+export default class AppsVersionCreate extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        app: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        changelog: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expected-rev': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/version/create.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../../lib/apps-command");
+const appsCheck_1 = require("../../../lib/appsCheck");
+class AppsVersionCreate extends apps_command_1.AppsCommand {
+    static description = 'Cut an immutable version from the draft as it is now. Refused (with the check) if the draft has errors that are not guesses. A version is private and a draft: it is not published.';
+    static examples = [
+        '<%= config.bin %> apps version create habit-tracker --changelog "habits persist" --expected-rev 8',
+    ];
+    static args = {
+        app: core_1.Args.string({
+            description: 'The app id (app_...) or its slug',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output { version, check, draftRev } as JSON' }),
+        changelog: core_1.Flags.string({ description: 'What changed' }),
+        'expected-rev': core_1.Flags.integer({
+            description: 'Cut only if the draft is still at this revision',
+            min: 0,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsVersionCreate);
+        const appId = await this.appId(args.app);
+        try {
+            const result = await data_provider_1.dataService.createAppVersion({
+                appId,
+                ...(flags.changelog === undefined ? {} : { changelog: flags.changelog }),
+                ...(flags['expected-rev'] === undefined ? {} : { expectedRev: flags['expected-rev'] }),
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`version ${result.version.version}  ${result.version.id}`);
+            this.log(`bundle ${result.version.bundleHash}`);
+            this.log(`cut from draft rev ${result.draftRev}; ${result.version.distribution.visibility}/${result.version.distribution.status}`);
+            if (result.check.issues.length > 0)
+                for (const line of (0, appsCheck_1.formatAppCheckReport)(result.check))
+                    this.log(line);
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsVersionCreate;

package/dist/commands/apps/version/show.d.ts

@@ -0,0 +1,12 @@
+import { AppsCommand } from '../../../lib/apps-command';
+export default class AppsVersionShow extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        version: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/version/show.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const apps_command_1 = require("../../../lib/apps-command");
+class AppsVersionShow extends apps_command_1.AppsCommand {
+    static description = 'Show one version: its bundle hash, its files, what it declares and where it stands.';
+    static examples = ['<%= config.bin %> apps version show appv_...'];
+    static args = {
+        version: core_1.Args.string({
+            description: 'The version id (appv_...)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the version, with its manifest, as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsVersionShow);
+        try {
+            const result = await data_provider_1.dataService.getAppVersion(args.version);
+            const { version } = result;
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`v${version.version}  ${version.id}  (${version.distribution.visibility}/${version.distribution.status})`);
+            this.log(`bundle ${version.bundleHash}`);
+            for (const file of version.files)
+                this.log(`${file.path}  ${file.size} bytes  ${file.sha256.slice(0, 12)}`);
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsVersionShow;

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

@@ -0,0 +1,12 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsVersions extends AppsCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        app: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}