@skrr-ai/cli 0.1.110 → 0.1.111

package/dist/commands/apps/preview.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 AppsPreview extends apps_command_1.AppsCommand {
+    static description = "Open a preview of an app's draft as it is now. It renders from the draft (no version is made, no grant is needed). It draws nothing: a preview is drawn when a person opens it (My Apps, a draft's Preview button), and that opens a session of its own. Opening one here REPLACES the draft's current preview, including one a person has open (that window stops reporting) and the log `apps logs` reads. In a preview, capability calls are answered from sandbox data kept in that person's browser; a where, orderBy or cursor, http.fetch, tools and services are not available, and each such refusal is written to the log `apps logs` reads.";
+    static examples = ['<%= config.bin %> apps preview 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 preview session as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsPreview);
+        const appId = await this.appId(args.app);
+        try {
+            const preview = await data_provider_1.dataService.createAppPreview(appId);
+            if (flags.json) {
+                this.printJsonResult(preview);
+                return;
+            }
+            this.log(`preview ${preview.previewId}  (draft rev ${preview.draftRev}, until ${preview.expiresAt})`);
+            this.log(`check: ${preview.check.ok ? 'ok' : `${preview.check.summary.errors} error(s)`}, ${preview.check.summary.warnings} warning(s)`);
+            this.log('Writing more files makes this preview stale: open a new one.');
+            this.log("Nothing has drawn this preview, and opening it replaced the one there was, including one a person has open. A person's Preview in My Apps opens a session of its own; `apps logs` has content only after that, and only if the frame failed or was refused a call.");
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsPreview;

package/dist/commands/apps/publish/propose.d.ts

@@ -0,0 +1,14 @@
+import { AppsCommand } from '../../../lib/apps-command';
+export default class AppsPublishPropose 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>;
+        visibility: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/publish/propose.js

@@ -0,0 +1,45 @@
+"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 AppsPublishPropose extends apps_command_1.AppsCommand {
+    static description = "Propose that a version be published. This records a request the app's owner answers; it publishes nothing, and the version stays private until a person with the right to publish acts on it.";
+    static examples = [
+        '<%= config.bin %> apps publish propose appv_... --visibility workspace --reason "ready for the team"',
+    ];
+    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 proposal as JSON' }),
+        visibility: core_1.Flags.string({
+            description: 'Where it would be published (workspace)',
+            required: true,
+        }),
+        reason: core_1.Flags.string({ description: 'Why, in a sentence (the owner reads it)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsPublishPropose);
+        try {
+            const result = await data_provider_1.dataService.proposeAppPublish(args.version, {
+                visibility: flags.visibility,
+                ...(flags.reason === undefined ? {} : { reason: flags.reason }),
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`request ${result.requestId} is waiting for the app's owner (${result.visibility}). Nothing is published until they act on it.`);
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsPublishPropose;

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

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

package/dist/commands/apps/pull.js

@@ -0,0 +1,56 @@
+"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 appsFs_1 = require("../../lib/appsFs");
+class AppsPull extends apps_command_1.AppsCommand {
+    static description = "Write an app's draft into a local directory, so a harness can edit it with its own tools and check it offline. The server's paths are judged again here before anything is written; a symbolic link in the directory is refused, never written through. Prints the revision to name when you push it back.";
+    static examples = [
+        '<%= config.bin %> apps pull habit-tracker ./habit-tracker',
+        '<%= config.bin %> apps pull habit-tracker ./habit-tracker --force',
+    ];
+    static args = {
+        app: core_1.Args.string({
+            description: 'The app id (app_...) or its slug',
+            required: true,
+            ignoreStdin: true,
+        }),
+        dir: core_1.Args.string({
+            description: 'The local directory (created if it does not exist)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output { rev, root, written } as JSON' }),
+        force: core_1.Flags.boolean({
+            description: 'Replace files that already exist (never a symbolic link)',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsPull);
+        const appId = await this.appId(args.app);
+        try {
+            const tree = await data_provider_1.dataService.getAppDraftTree(appId);
+            const result = (0, appsFs_1.writePackageDir)(args.dir, tree.files, { force: flags.force });
+            if (flags.json) {
+                this.printJsonResult({
+                    appId,
+                    rev: tree.rev,
+                    root: result.root,
+                    written: result.written,
+                });
+                return;
+            }
+            this.log(`wrote ${result.written.length} file${result.written.length === 1 ? '' : 's'} to ${result.root}`);
+            this.log(`rev: ${tree.rev}  (push it back with --expected-rev ${tree.rev})`);
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsPull;

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

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

package/dist/commands/apps/push.js

@@ -0,0 +1,75 @@
+"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 appsFs_1 = require("../../lib/appsFs");
+class AppsPush extends apps_command_1.AppsCommand {
+    static description = 'Replace an app\'s whole draft with a local directory. The directory is read without following symbolic links (a link is refused, naming it), anything starting with "." and node_modules are left out and listed, and the draft must still be at --expected-rev. Files in the draft that the directory does not have are removed.';
+    static examples = [
+        '<%= config.bin %> apps push habit-tracker ./habit-tracker --expected-rev 7',
+        '<%= config.bin %> apps push habit-tracker ./habit-tracker --expected-rev 7 --dry-run',
+    ];
+    static args = {
+        app: core_1.Args.string({
+            description: 'The app id (app_...) or its slug',
+            required: true,
+            ignoreStdin: true,
+        }),
+        dir: core_1.Args.string({ description: 'The local directory', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output { appId, rev, paths, removed, skipped } as JSON' }),
+        'expected-rev': core_1.Flags.integer({
+            description: 'The draft revision you last read (apps pull prints it)',
+            required: true,
+            min: 0,
+        }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Read and judge the directory, send nothing',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsPush);
+        const appId = await this.appId(args.app);
+        try {
+            const local = (0, appsFs_1.readPackageDir)(args.dir);
+            const files = local.files.map((file) => ({
+                path: file.path,
+                content: file.content,
+            }));
+            if (flags['dry-run']) {
+                const out = {
+                    appId,
+                    root: local.root,
+                    files: files.map((file) => file.path),
+                    skipped: local.skipped,
+                };
+                this.log(flags.json
+                    ? JSON.stringify(out, null, 2)
+                    : `would send ${files.length} files from ${local.root}${local.skipped.length ? ` (left out: ${local.skipped.join(', ')})` : ''}`);
+                return;
+            }
+            const result = await data_provider_1.dataService.replaceAppDraftTree(appId, {
+                expectedRev: flags['expected-rev'],
+                files,
+            });
+            if (flags.json) {
+                this.printJsonResult({ ...result, skipped: local.skipped });
+                return;
+            }
+            this.log(`pushed ${result.paths.length} files  (rev ${result.rev})`);
+            if (result.removed && result.removed.length > 0) {
+                this.log(`removed from the draft: ${result.removed.join(', ')}`);
+            }
+            if (local.skipped.length > 0)
+                this.log(`left out: ${local.skipped.join(', ')}`);
+        }
+        catch (error) {
+            this.failApps(error);
+        }
+    }
+}
+exports.default = AppsPush;

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

@@ -0,0 +1,13 @@
+import { AppsCommand } from '../../lib/apps-command';
+export default class AppsReconsent 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>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/reconsent.js

@@ -0,0 +1,67 @@
+"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 AppsReconsent extends apps_command_1.AppsCommand {
+    static description = 'Approve an installation again, for the version it runs now. A new version that asks for more (or an app whose code changed under an approval that is bound to it, or a job that was added or rewritten) stops until you do. Without --yes it shows what changed and approves nothing.';
+    static examples = [
+        '<%= config.bin %> apps reconsent appi_abc',
+        '<%= config.bin %> apps reconsent appi_abc --yes',
+    ];
+    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' }),
+        yes: core_1.Flags.boolean({ description: 'Approve what the disclosure lists' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AppsReconsent);
+        try {
+            const current = await data_provider_1.dataService.getAppInstallation(args.installation);
+            const shown = await data_provider_1.dataService.getAppGrantDisclosure({
+                versionId: current.installation.versionId,
+                installationId: current.installation.id,
+            });
+            const disclosure = (0, data_provider_1.parseAppDisclosure)(shown.disclosure);
+            const lines = (0, appInstallations_1.formatDisclosure)(shown.disclosure, shown.facts);
+            if (!disclosure || !disclosure.bundleHash) {
+                return this.failWithCliError({
+                    message: `${lines.join('\n')}\n→ Nothing was approved.`,
+                    code: 'APP_DISCLOSURE_UNREADABLE',
+                    exit: 1,
+                    retryable: false,
+                });
+            }
+            if (!flags.yes) {
+                return this.failWithCliError({
+                    message: `${lines.join('\n')}\n→ Nothing was approved. To approve exactly this, run it again with --yes.`,
+                    code: 'APP_CONSENT_REQUIRED',
+                    exit: 2,
+                    retryable: false,
+                    details: { disclosure: shown.disclosure },
+                });
+            }
+            const result = await data_provider_1.dataService.reconsentAppInstallation(current.installation.id, {
+                versionId: current.installation.versionId,
+                bundleHash: disclosure.bundleHash,
+            });
+            if (flags.json) {
+                this.printJsonResult(result);
+                return;
+            }
+            this.log(`approved ${result.installation.id}: it is ${result.installation.availability} now`);
+        }
+        catch (error) {
+            this.failInstallation(error);
+        }
+    }
+}
+exports.default = AppsReconsent;

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>;
+}