@nocobase/app-cli-client 0.0.0-stage → 0.1.0-beta.1

package/dist/parse/help.js

@@ -0,0 +1,151 @@
+// The help of a manifest command, and the list of an area's commands, as text: what the CLI on a machine and an online
+// run's shell both print.
+import { DOWNLOAD_OUT_FLAG } from '@nocobase/agent-protocol';
+import { commandWords, parameterLabel, positionalOf } from "./arguments.js";
+/** Rows as two aligned columns, indented. */
+export function helpColumns(rows) {
+    const width = Math.max(...rows.map(([left]) => left.length));
+    return rows.map(([left, right]) => `  ${left.padEnd(width)}  ${right}`.trimEnd());
+}
+/** Where a default comes from, as help names it: `$GITHUB_REPOSITORY or $CI_PROJECT_PATH`. */
+function envLabel(sources) {
+    return sources
+        .map((source) => typeof source === 'string'
+        ? `$${source}`
+        : `${source.path} of $${source.file}`)
+        .join(' or ');
+}
+function valueHint(parameter) {
+    if (parameter.type === 'boolean')
+        return '';
+    if (parameter.in === 'file' || parameter.binary)
+        return ' <path>';
+    if (parameter.enum)
+        return ` <${parameter.enum.join('|')}>`;
+    if (parameter.type === 'string[]' || parameter.type === 'number[]')
+        return ' <value>…';
+    if (parameter.type === 'json')
+        return ' <json|key=value>';
+    return ` <${parameter.type}>`;
+}
+/** The FLAGS rows of a command. */
+export function flagRows(command, localFiles = true) {
+    const lines = [];
+    for (const parameter of command.parameters) {
+        if (parameter.position !== undefined)
+            continue;
+        if (!localFiles && (parameter.in === 'file' || parameter.binary))
+            continue;
+        const notes = [
+            parameter.required ? 'required' : '',
+            parameter.default !== undefined
+                ? `default: ${JSON.stringify(parameter.default)}`
+                : '',
+            parameter.env?.length ? `default from ${envLabel(parameter.env)}` : '',
+            parameter.upload?.multiple ? 'repeat for more' : '',
+            parameter.ticket
+                ? `streamed; at most ${parameter.ticket.maxBytes} bytes`
+                : '',
+            parameter.changed
+                ? `sends the files changed in ${parameter.changed.dir}, at most ${parameter.changed.maxFiles}`
+                : '',
+            (parameter.type === 'string[]' || parameter.type === 'number[]') &&
+                !parameter.upload
+                ? 'repeat for more'
+                : '',
+        ].filter(Boolean);
+        lines.push([
+            `${parameter.alias ? `-${parameter.alias}, ` : ''}--${parameter.name}${valueHint(parameter)}`,
+            `${parameter.description ?? ''}${notes.length > 0 ? ` (${notes.join(', ')})` : ''}`.trim(),
+        ]);
+        if (parameter.contentFile)
+            lines.push([
+                `--${parameter.name}-file <path>`,
+                `Read --${parameter.name} from a file.`,
+            ]);
+    }
+    const fromEnv = command.parameters.find((parameter) => parameter.fromEnv !== undefined);
+    if (fromEnv) {
+        const source = command.parameters.find((parameter) => parameter.field === fromEnv.fromEnv);
+        lines.push([
+            '--from-env',
+            `Read ${parameterLabel(fromEnv)} from the environment variable named by ${source ? parameterLabel(source) : fromEnv.fromEnv}, keeping it off the command line.`,
+        ]);
+    }
+    if (command.body?.file)
+        lines.push([
+            `--${command.body.file} <file.json>`,
+            'The request body as a JSON object; the flags override its fields.',
+        ]);
+    if (localFiles && command.output.kind === 'download')
+        lines.push([
+            `--${DOWNLOAD_OUT_FLAG} <path>`,
+            'Where to save the file: a path, or a directory to save it into (default: the current directory, under its own name).',
+        ]);
+    return lines;
+}
+/** A command's help: usage, arguments, flags, description and examples. */
+export function renderCommandHelp(command, options) {
+    const { bin } = options;
+    const positional = positionalOf(command);
+    const flags = flagRows(command, options.localFiles ?? true);
+    const globals = options.globalFlags ?? [];
+    const usage = [
+        bin,
+        commandWords(command),
+        ...positional.map((parameter) => parameter.required ? `<${parameter.name}>` : `[<${parameter.name}>]`),
+        '[flags]',
+    ].join(' ');
+    return [
+        command.summary,
+        '',
+        'USAGE',
+        `  $ ${usage}`,
+        ...(positional.length > 0
+            ? [
+                '',
+                'ARGUMENTS',
+                ...helpColumns(positional.map((parameter) => [
+                    parameter.name,
+                    `${parameter.description ?? ''}${parameter.required ? '' : ' (optional)'}`.trim(),
+                ])),
+            ]
+            : []),
+        ...(flags.length > 0 ? ['', 'FLAGS', ...helpColumns(flags)] : []),
+        ...(globals.length > 0
+            ? ['', 'GLOBAL FLAGS', ...helpColumns(globals)]
+            : []),
+        ...(command.description
+            ? ['', 'DESCRIPTION', `  ${command.description}`]
+            : []),
+        ...(command.examples?.length
+            ? [
+                '',
+                'EXAMPLES',
+                ...command.examples.map((example) => `  $ ${bin} ${example}`),
+            ]
+            : []),
+    ].join('\n');
+}
+/** The commands under `prefix` (all with an empty prefix), one line each; undefined when there are none. */
+export function renderCommandList(commands, prefix = []) {
+    const start = prefix.join(':');
+    const listed = commands.filter((command) => !start || command.id === start || command.id.startsWith(`${start}:`));
+    if (listed.length === 0)
+        return undefined;
+    return helpColumns(listed.map((command) => [commandWords(command), command.summary])).join('\n');
+}
+/** The help of the commands under `prefix`; undefined when there are none. */
+export function renderTopicHelp(bin, commands, prefix) {
+    const list = renderCommandList(commands, prefix);
+    if (!list)
+        return undefined;
+    return [
+        'USAGE',
+        `  $ ${[bin, ...prefix, 'COMMAND'].join(' ')}`,
+        '',
+        'COMMANDS',
+        list,
+    ].join('\n');
+}
+//# sourceMappingURL=help.js.map

package/dist/parse/help.js.map

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

package/dist/parse/index.d.ts

@@ -0,0 +1,5 @@
+export { accepts, CliParseError, envDefaultOf, commandWords, missingArguments, needsLocalFiles, parameterLabel, parseCommandLine, positionalOf, type CliCall, type CliFileRef, type CliParseIo, type CliParseOptions, } from './arguments.ts';
+export { apiExitCode } from './exit.ts';
+export { flagRows, helpColumns, renderCommandHelp, renderCommandList, renderTopicHelp, type CommandHelpOptions, type HelpRow, } from './help.ts';
+export type { CliCommand, CliEnvDefault, CliManifest, CliParameter, CliWithheldCommand, } from './manifest.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/parse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,OAAO,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/parse/index.js

@@ -0,0 +1,7 @@
+// `@nocobase/app-cli-client/parse`: how a command line is read against a manifest command, and the help built from the
+// manifest, with no file, environment or terminal of its own. The CLI reads its lines with it, and so does the `acme`
+// command of an online run's shell, through a `CliParseIo` over that shell's files and environment.
+export { accepts, CliParseError, envDefaultOf, commandWords, missingArguments, needsLocalFiles, parameterLabel, parseCommandLine, positionalOf, } from "./arguments.js";
+export { apiExitCode } from "./exit.js";
+export { flagRows, helpColumns, renderCommandHelp, renderCommandList, renderTopicHelp, } from "./help.js";
+//# sourceMappingURL=index.js.map

package/dist/parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,sHAAsH;AACtH,oGAAoG;AACpG,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,GAKb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAGhB,MAAM,WAAW,CAAC"}

package/dist/parse/manifest.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Where an input left off the line is read from: an environment variable, or a field (dot-separated `path`) of the
+ * JSON file the variable `file` names.
+ */
+export type CliEnvDefault = string | {
+    readonly file: string;
+    readonly path: string;
+};
+/** One input of a command: an argument or a flag, and where it goes in the request. */
+export interface CliParameter {
+    readonly name: string;
+    readonly field: string;
+    readonly in: 'path' | 'query' | 'body' | 'file';
+    readonly position?: number | undefined;
+    readonly type: 'string' | 'number' | 'integer' | 'boolean' | 'string[]' | 'number[]' | 'json';
+    readonly required: boolean;
+    readonly description?: string | undefined;
+    readonly enum?: readonly string[] | undefined;
+    readonly default?: unknown;
+    readonly alias?: string | undefined;
+    readonly contentFile?: boolean | undefined;
+    readonly prompt?: boolean | undefined;
+    /** `--from-env` fills it from the environment variable named by the value of this field. */
+    readonly fromEnv?: string | undefined;
+    /** Read from the environment when not given, the first found wins; a value given on the line always wins. */
+    readonly env?: readonly CliEnvDefault[] | undefined;
+    readonly upload?: {
+        readonly method: string;
+        readonly path: string;
+        readonly part: string;
+        readonly field: string;
+        readonly multiple: boolean;
+        readonly maxBytes?: number | undefined;
+    } | undefined;
+    readonly ticket?: {
+        readonly maxBytes: number;
+        readonly accept?: readonly string[] | undefined;
+        /** The file may be left out; when given, its name goes in the body field `field`. */
+        readonly optional?: boolean | undefined;
+    } | undefined;
+    readonly changed?: {
+        readonly dir: string;
+        readonly manifest: string;
+        readonly maxBytes: number;
+        readonly maxFiles: number;
+        readonly accept?: readonly string[] | undefined;
+    } | undefined;
+    readonly binary?: boolean | undefined;
+    readonly multiple?: boolean | undefined;
+}
+/** One command: a request to one API route. */
+export interface CliCommand {
+    readonly id: string;
+    readonly summary: string;
+    readonly description?: string | undefined;
+    readonly operationId?: string | undefined;
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    readonly path: string;
+    readonly parameters: readonly CliParameter[];
+    readonly body?: {
+        readonly media: 'application/json' | 'multipart/form-data';
+        readonly file?: string | undefined;
+        readonly required?: boolean | undefined;
+    } | undefined;
+    readonly output: {
+        readonly kind: 'data' | 'list' | 'empty' | 'download';
+        readonly columns?: readonly string[] | undefined;
+    };
+    readonly confirm?: string | undefined;
+    readonly examples?: readonly string[] | undefined;
+    readonly identities: readonly ('person' | 'run')[];
+    readonly action?: string | undefined;
+}
+/** A command the caller is not offered, and why. */
+export interface CliWithheldCommand {
+    readonly id: string;
+    readonly summary: string;
+    readonly reason: 'identity' | 'action';
+    readonly identities: readonly ('person' | 'run')[];
+    readonly action?: string | undefined;
+}
+export interface CliManifest {
+    readonly version: number;
+    readonly etag: string;
+    readonly identity: {
+        readonly kind: 'person' | 'run';
+        readonly userId: string;
+        readonly displayName: string;
+        readonly runId?: string | undefined;
+        /** Absent from a server older than manifest version 4. */
+        readonly actions?: readonly string[] | undefined;
+    };
+    readonly commands: readonly CliCommand[];
+    /** Absent from a server older than manifest version 4. */
+    readonly withheld?: readonly CliWithheldCommand[] | undefined;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/parse/manifest.d.ts.map

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

package/dist/parse/manifest.js

@@ -0,0 +1,4 @@
+// The command manifest as a CLI reads it (`GET /api/cli/manifest`): the commands the application's API document describes
+// for the caller, each a request to one of its routes. Types only, so the parser beside it runs anywhere.
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/parse/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/parse/manifest.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,0GAA0G"}

package/dist/profile.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from '@oclif/core';
+import type { AppCliConfig } from './config.ts';
+export declare function profileCommands(app: AppCliConfig): Record<string, Command.Class>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,YAAY,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CA4F/B"}

package/dist/profile.js

@@ -0,0 +1,80 @@
+// `<bin> profile list|use|remove`: the servers the CLI is signed in to, one profile each (`lib/credentials.ts`).
+import { createInterface } from 'node:readline/promises';
+import { Args } from '@oclif/core';
+import { EXIT_CODES } from '@nocobase/agent-protocol';
+import { AppCommand, UsageError } from "./lib/command.js";
+import { checkProfileName, listProfiles, removeProfile, useProfile, } from "./lib/credentials.js";
+import { CliCommandError } from "./lib/envelope.js";
+import { describeStorage } from "./lib/secrets/index.js";
+export function profileCommands(app) {
+    class List extends AppCommand {
+        static summary = 'List the profiles: one per server signed in to.';
+        async run() {
+            await this.parse(List);
+            const profiles = await listProfiles({ paths: this.paths, config: app });
+            if (profiles.length === 0)
+                this.log(`No profiles. Sign in with \`${app.bin} login\`.`);
+            for (const profile of profiles)
+                this.log(`${profile.current ? '*' : ' '} ${profile.name.padEnd(12)} ${profile.server}  ${profile.keyName ? `"${profile.keyName}", ` : ''}${describeStorage(profile.storage, 'config.json')}`);
+            return { profiles };
+        }
+    }
+    class Use extends AppCommand {
+        static summary = 'Make a profile the current one.';
+        static args = {
+            name: Args.string({ description: 'The profile.', required: true }),
+        };
+        static examples = ['<%= config.bin %> profile use staging'];
+        async run() {
+            const { args } = await this.parse(Use);
+            await useProfile(checkProfileName(args.name), {
+                paths: this.paths,
+                config: app,
+            });
+            this.log(`Using profile ${args.name}.`);
+            return { current: args.name };
+        }
+    }
+    class Remove extends AppCommand {
+        static summary = 'Forget a profile and its key here, leaving the key valid on the server.';
+        static description = `To revoke the key too, run \`${app.bin} logout --profile <name>\` instead.`;
+        static supportsDryRun = true;
+        static args = {
+            name: Args.string({ description: 'The profile.', required: true }),
+        };
+        async run() {
+            const { args } = await this.parse(Remove);
+            const name = checkProfileName(args.name);
+            const known = (await listProfiles({ paths: this.paths, config: app })).find((profile) => profile.name === name);
+            if (!known)
+                throw new UsageError(`There is no profile ${name}.`, EXIT_CODES.notFound);
+            if (this.dryRun) {
+                this.log(`Would forget profile ${name} (${known.server}).`);
+                return { removed: name, server: known.server, dryRun: true };
+            }
+            if (!this.yes) {
+                if (!process.stdin.isTTY || !process.stderr.isTTY)
+                    throw new CliCommandError('CONFIRMATION_REQUIRED', `Forget profile ${name} (${known.server})? Nothing was done without a terminal to ask in.`, {
+                        exit: EXIT_CODES.validation,
+                        suggestions: [
+                            { message: 'Pass --yes to go ahead without asking.' },
+                        ],
+                    });
+                const lines = createInterface({
+                    input: process.stdin,
+                    output: process.stderr,
+                });
+                const answer = await lines
+                    .question(`Forget profile ${name} (${known.server})? [y/N] `)
+                    .finally(() => lines.close());
+                if (!/^y(es)?$/iu.test(answer.trim()))
+                    throw new UsageError('Not done.', EXIT_CODES.general);
+            }
+            await removeProfile(name, { paths: this.paths, config: app });
+            this.log(`Forgot profile ${name}.`);
+            return { removed: name, server: known.server };
+        }
+    }
+    return { 'profile:list': List, 'profile:use': Use, 'profile:remove': Remove };
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

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

package/dist/request.d.ts

@@ -0,0 +1,25 @@
+/** The part of a manifest parameter the request needs. */
+export interface RequestParameter {
+    readonly field: string;
+    readonly in: 'path' | 'query' | 'body' | 'file';
+}
+/** The part of a manifest command the request needs. */
+export interface RequestCommand {
+    readonly method: string;
+    /** Below the server's origin, with `{field}` placeholders. */
+    readonly path: string;
+}
+/** A command's request: its method, its path with the query string, and its body's fields. */
+export interface FilledRequest {
+    readonly method: string;
+    readonly path: string;
+    readonly fields: Record<string, unknown>;
+}
+/** A value as it goes into a path or a query string. */
+export declare function requestText(value: unknown): string;
+/**
+ * Fills `command`'s request with `values`, each a parameter and its value; `base` holds body fields the values then
+ * override, such as a body read from a file. `file` parameters are left to the caller.
+ */
+export declare function fillRequest(command: RequestCommand, values: Iterable<readonly [RequestParameter, unknown]>, base?: Readonly<Record<string, unknown>>): FilledRequest;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAIA,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACjD;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,EACtD,IAAI,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC3C,aAAa,CAsBf"}

package/dist/request.js

@@ -0,0 +1,35 @@
+// The request a manifest command makes, from the values given for its parameters: path parameters fill the route's
+// `{field}` placeholders, query parameters the query string (an array repeats), body parameters the body's fields. It
+// imports nothing, so a server that calls its own routes the way the CLI does (an online agent's tools) shares it.
+/** A value as it goes into a path or a query string. */
+export function requestText(value) {
+    return typeof value === 'string' ? value : JSON.stringify(value);
+}
+/**
+ * Fills `command`'s request with `values`, each a parameter and its value; `base` holds body fields the values then
+ * override, such as a body read from a file. `file` parameters are left to the caller.
+ */
+export function fillRequest(command, values, base = {}) {
+    let route = command.path;
+    const query = new URLSearchParams();
+    const fields = { ...base };
+    for (const [parameter, value] of values) {
+        if (value === undefined)
+            continue;
+        if (parameter.in === 'path')
+            route = route.replace(`{${parameter.field}}`, encodeURIComponent(requestText(value)));
+        else if (parameter.in === 'query') {
+            for (const item of Array.isArray(value) ? value : [value])
+                query.append(parameter.field, requestText(item));
+        }
+        else if (parameter.in === 'body')
+            fields[parameter.field] = value;
+    }
+    const search = query.toString();
+    return {
+        method: command.method,
+        path: search ? `${route}?${search}` : route,
+        fields,
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,sHAAsH;AACtH,mHAAmH;AAsBnH,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAuB,EACvB,MAAsD,EACtD,OAA0C,EAAE;IAE5C,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,SAAS,CAAC,EAAE,KAAK,MAAM;YACzB,KAAK,GAAG,KAAK,CAAC,OAAO,CACnB,IAAI,SAAS,CAAC,KAAK,GAAG,EACtB,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CACvC,CAAC;aACC,IAAI,SAAS,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvD,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;aAAM,IAAI,SAAS,CAAC,EAAE,KAAK,MAAM;YAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK;QAC3C,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,17 @@
+import { type Command } from '@oclif/core';
+import { type AppCliConfig } from './config.ts';
+export interface RunAppCliOptions {
+    /** Static commands the application adds, by oclif id (`topic:name`). */
+    readonly commands?: Readonly<Record<string, Command.Class>>;
+    readonly topics?: Readonly<Record<string, {
+        description: string;
+    }>>;
+    /**
+     * The first words of lines whose commands read every flag themselves, such as `runner`: the global flags stay on
+     * those lines, so `runner uninstall --dry-run` reaches its own `--dry-run`.
+     */
+    readonly ownFlags?: readonly string[];
+}
+/** Runs the CLI `config` describes with `argv`, and exits the way oclif does. */
+export declare function runAppCli(config: AppCliConfig, argv?: string[], options?: RunAppCliOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAMvE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AA8BjE,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAqCD,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,MAAM,EAA0B,EACtC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/run.js

@@ -0,0 +1,88 @@
+// Loads and runs the CLI. The oclif configuration is synthesized here rather than read from package.json, so the same
+// code runs from `src/` (Node strips the types) and from the compiled `dist/`.
+import { Config, Errors, flush, run } from '@oclif/core';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { defineCommands, STATIC_TOPICS } from "./commands.js";
+import { configureAppCli } from "./config.js";
+import { setOriginalArgv } from "./dynamic/index.js";
+import { failureEnvelope } from "./lib/envelope.js";
+import { extractGlobalFlags, globalFlags, setGlobalFlags, } from "./lib/globals.js";
+import { UsageError } from "./lib/command.js";
+/** A line whose global flags cannot be read: answered as any invalid usage is. */
+async function refuseLine(config, argv, error) {
+    const failure = new UsageError(error instanceof Error ? error.message : String(error));
+    if (argv.includes('--json'))
+        process.stdout.write(`${JSON.stringify(failureEnvelope(argv.filter((word) => !word.startsWith('-')).join(' '), failure, [], config.bin), null, 2)}\n`);
+    else
+        process.stderr.write(` ›   Error: ${failure.message}\n`);
+    process.exitCode = failure.exit;
+}
+// src/run.ts and dist/run.js both sit one level below the package root.
+const PACKAGE_ROOT = path.resolve(import.meta.dirname, '..');
+function pjson(config, fromSource, topics) {
+    const manifest = JSON.parse(readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+    const extension = fromSource ? 'ts' : 'js';
+    const root = fromSource ? './src' : './dist';
+    const description = config.description ?? manifest.description;
+    return {
+        // oclif's name heads `--version` (`acme/1.2.3 darwin-arm64 node-v24…`): the branded command, not this package.
+        name: config.bin,
+        version: config.version ?? manifest.version,
+        ...(description === undefined ? {} : { description }),
+        oclif: {
+            bin: config.bin,
+            dirname: config.bin,
+            topicSeparator: ' ',
+            additionalHelpFlags: ['-h'],
+            topics: { ...STATIC_TOPICS, ...topics },
+            commands: {
+                strategy: 'explicit',
+                target: `${root}/commands.${extension}`,
+                identifier: 'COMMANDS',
+            },
+            hooks: {
+                command_not_found: `${root}/hooks/command-not-found.${extension}`,
+            },
+            helpClass: `${root}/dynamic/help.${extension}`,
+        },
+    };
+}
+/** Runs the CLI `config` describes with `argv`, and exits the way oclif does. */
+export async function runAppCli(config, argv = process.argv.slice(2), options = {}) {
+    const fromSource = import.meta.filename.endsWith('.ts');
+    configureAppCli(config);
+    let line;
+    try {
+        const own = options.ownFlags?.includes(argv[0] ?? '') ||
+            (argv[0] === 'help' && options.ownFlags?.includes(argv[1] ?? ''));
+        const extracted = own
+            ? { argv: [...argv], flags: extractGlobalFlags([]).flags }
+            : extractGlobalFlags(argv);
+        line = extracted.argv;
+        setGlobalFlags(extracted.flags);
+    }
+    catch (error) {
+        await refuseLine(config, argv, error);
+        return;
+    }
+    if (globalFlags().noColor || process.env.NO_COLOR) {
+        process.env.NO_COLOR = '1';
+        process.env.FORCE_COLOR = '0';
+    }
+    defineCommands(config, options.commands);
+    setOriginalArgv(line);
+    argv = line;
+    try {
+        const loaded = await Config.load({
+            root: PACKAGE_ROOT,
+            pjson: pjson(config, fromSource, options.topics ?? {}),
+        });
+        await run(argv, loaded);
+        await flush();
+    }
+    catch (error) {
+        await Errors.handle(error);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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