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

package/dist/update.d.ts

@@ -0,0 +1,45 @@
+import { type Command } from '@oclif/core';
+import { type AppCliConfig, type AppCliSession } from './config.ts';
+import { type Installation } from './install.ts';
+/** How often the hint asks the server. */
+export declare const HINT_INTERVAL_MS: number;
+/** How long the hint waits for the server. */
+export declare const HINT_TIMEOUT_MS: number;
+/** Who updates this installation: `<bin> update` (`cli`), the runner (`runner`), or nobody (`none`). */
+export type UpdatedBy = 'cli' | 'runner' | 'none';
+export interface UpdateEnvironment {
+    /** The command name, such as `acme`. */
+    readonly bin: string;
+    /** The product the application serves the CLI as; `bin` by default. */
+    readonly product?: string;
+    /** The running version. */
+    readonly running: string;
+    readonly installation?: Installation | undefined;
+    readonly target?: string;
+    /** Where the hint remembers what it found; `<state dir>/cache/update.json` by default. */
+    readonly cacheFile?: string;
+    readonly now?: () => number;
+    readonly fetch?: typeof fetch;
+}
+/** Who updates the installation `environment` describes. */
+export declare function updatedBy(environment: UpdateEnvironment): UpdatedBy;
+/** The hint line when the server serves a newer CLI for a CLI installed alone; undefined otherwise. */
+export declare function updateHint(session: AppCliSession, environment: UpdateEnvironment): Promise<string | undefined>;
+/** What `<bin> update` answers. */
+export interface CliUpdateResult {
+    readonly current: string;
+    readonly latest: string;
+    readonly updated: boolean;
+    /** The version it replaced, kept beside the new one for a rollback. */
+    readonly previous?: string;
+}
+/** Updates a CLI installed alone to the newest version the session's server serves for this platform. */
+export declare function updateCli(session: AppCliSession, environment: UpdateEnvironment, options: {
+    readonly check?: boolean;
+    readonly log?: (line: string) => void;
+}): Promise<CliUpdateResult>;
+/** The environment of the running CLI `config` describes; undefined when it does not update itself. */
+export declare function updateEnvironment(config: AppCliConfig): UpdateEnvironment | undefined;
+/** `<bin> update`, for a CLI whose configuration names `selfUpdate`. */
+export declare function updateCommand(app: AppCliConfig): Command.Class;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAcA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAGtB,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,EAAE,MAAyB,CAAC;AACzD,8CAA8C;AAC9C,eAAO,MAAM,eAAe,EAAE,MAAa,CAAC;AAE5C,wGAAwG;AACxG,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,WAAW,EAAE,iBAAiB,GAAG,SAAS,CAInE;AA4CD,uGAAuG;AACvG,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yGAAyG;AACzG,wBAAsB,SAAS,CAC7B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC3E,OAAO,CAAC,eAAe,CAAC,CAuD1B;AAYD,uGAAuG;AACvG,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,GACnB,iBAAiB,GAAG,SAAS,CAS/B;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAsC9D"}

package/dist/update.js

@@ -0,0 +1,177 @@
+// `<bin> update`, and the hint that a newer CLI is served, for a CLI whose configuration names `selfUpdate`.
+//
+// A CLI installed alone by the install script (`install.json` says `mode: cli`) updates itself from the server the
+// person is signed in to, with their key: it resolves the newest version the server serves for this platform, downloads
+// it, checks its SHA-256, unpacks it beside the running version and switches `current`, keeping the previous version
+// for a rollback (`install.ts`). An installation the script made for a runner (`mode: runner`) is the runner's, which
+// updates itself.
+//
+// The hint asks at most every `HINT_INTERVAL_MS` per server and remembers the answer in `<state dir>/cache/update.json`,
+// so a command waits for the network at most once in that time, and never longer than `HINT_TIMEOUT_MS`.
+import { readFileSync } from 'node:fs';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Flags } from '@oclif/core';
+import { currentTarget, EXIT_CODES, } from '@nocobase/agent-protocol';
+import { appCliHome } from "./config.js";
+import { currentSession } from "./dynamic/session.js";
+import { applyUpdate, detectInstallation, isNewer, latestArtifact, } from "./install.js";
+import { AppCommand, UsageError } from "./lib/command.js";
+import { ApiClient } from "./lib/http.js";
+/** How often the hint asks the server. */
+export const HINT_INTERVAL_MS = 12 * 60 * 60_000;
+/** How long the hint waits for the server. */
+export const HINT_TIMEOUT_MS = 3000;
+/** Who updates the installation `environment` describes. */
+export function updatedBy(environment) {
+    const { installation } = environment;
+    if (installation === undefined)
+        return 'none';
+    return installation.mode === 'runner' ? 'runner' : 'cli';
+}
+function clientOf(session, environment, timeoutMs) {
+    return new ApiClient({
+        server: session.server,
+        headers: { ...session.headers },
+        ...(timeoutMs === undefined ? {} : { timeoutMs }),
+        ...(environment.fetch === undefined ? {} : { fetch: environment.fetch }),
+    });
+}
+async function readCache(file) {
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeCache(file, value) {
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = `${file}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    await rename(temporary, file);
+}
+function cacheFileOf(environment) {
+    return (environment.cacheFile ?? path.join(appCliHome(), 'cache', 'update.json'));
+}
+/** The hint line when the server serves a newer CLI for a CLI installed alone; undefined otherwise. */
+export async function updateHint(session, environment) {
+    if (updatedBy(environment) !== 'cli')
+        return undefined;
+    const now = (environment.now ?? Date.now)();
+    const cacheFile = cacheFileOf(environment);
+    const cached = await readCache(cacheFile);
+    let latest;
+    if (cached?.server === session.server &&
+        now - cached.checkedAt < HINT_INTERVAL_MS)
+        latest = cached.latest;
+    else {
+        try {
+            latest = (await latestArtifact(clientOf(session, environment, HINT_TIMEOUT_MS), environment.product ?? environment.bin, environment.target ?? currentTarget())).version;
+        }
+        catch {
+            latest = null;
+        }
+        await writeCache(cacheFile, {
+            server: session.server,
+            checkedAt: now,
+            latest,
+        }).catch(() => undefined);
+    }
+    return latest !== null && isNewer(latest, environment.running)
+        ? `A newer ${environment.bin} (${latest}) is available; run \`${environment.bin} update\`.`
+        : undefined;
+}
+/** Updates a CLI installed alone to the newest version the session's server serves for this platform. */
+export async function updateCli(session, environment, options) {
+    const { bin } = environment;
+    const by = updatedBy(environment);
+    if (by === 'none')
+        throw new UsageError(`This ${bin} was not installed by the install script, so it cannot replace itself. Install it again with the ` +
+            'install command, or update it the way it was installed.');
+    if (by === 'runner')
+        throw new UsageError(`This ${bin} was installed for a runner, which keeps it up to date itself.`);
+    const client = clientOf(session, environment);
+    const latest = await latestArtifact(client, environment.product ?? bin, environment.target ?? currentTarget());
+    const result = {
+        current: environment.running,
+        latest: latest.version,
+        updated: false,
+    };
+    if (!isNewer(latest.version, environment.running)) {
+        options.log?.(`${bin} ${environment.running} is up to date (${session.server} serves ${latest.version}).`);
+        return result;
+    }
+    if (options.check) {
+        options.log?.(`${bin} ${latest.version} is available (this is ${environment.running}). Run \`${bin} update\`.`);
+        return result;
+    }
+    const installation = environment.installation;
+    const { previous } = await applyUpdate({
+        installation,
+        bin,
+        client,
+        update: {
+            version: latest.version,
+            url: latest.url,
+            sha256: latest.sha256,
+        },
+    });
+    options.log?.(`Updated ${bin} ${environment.running} → ${latest.version}; ${previous ?? 'the previous version'} stays in ` +
+        `${path.join(installation.prefix, 'versions')}.`);
+    return {
+        ...result,
+        updated: true,
+        ...(previous === undefined ? {} : { previous }),
+    };
+}
+// src/update.ts and dist/update.js both sit one level below the package root.
+const OWN_VERSION = JSON.parse(readFileSync(path.resolve(import.meta.dirname, '..', 'package.json'), 'utf8')).version;
+/** The environment of the running CLI `config` describes; undefined when it does not update itself. */
+export function updateEnvironment(config) {
+    const own = config.selfUpdate;
+    if (own === undefined)
+        return undefined;
+    return {
+        bin: config.bin,
+        running: config.version ?? OWN_VERSION,
+        installation: detectInstallation(own.packageRoot),
+        ...(own.product === undefined ? {} : { product: own.product }),
+    };
+}
+/** `<bin> update`, for a CLI whose configuration names `selfUpdate`. */
+export function updateCommand(app) {
+    return class Update extends AppCommand {
+        static summary = `Update ${app.bin} to the newest version the server serves.`;
+        static description = `Asks the server you are signed in to for the newest ${app.bin} it serves for this platform, downloads it, ` +
+            `checks its SHA-256 and switches to it, keeping the previous version beside it. For ${app.bin} installed alone ` +
+            'by the install script.';
+        static examples = [
+            '<%= config.bin %> update',
+            '<%= config.bin %> update --check',
+        ];
+        static flags = {
+            check: Flags.boolean({
+                description: 'Only say whether a newer version is served.',
+            }),
+        };
+        async run() {
+            const { flags } = await this.parse(Update);
+            const environment = updateEnvironment(app);
+            if (environment === undefined)
+                throw new UsageError(`${app.bin} does not update itself.`);
+            const session = await currentSession();
+            if (session === undefined)
+                throw new UsageError(`Sign in first: \`${app.bin} login --server <url>\`.`, EXIT_CODES.auth);
+            if (session.kind === 'run')
+                throw new UsageError(`This ${app.bin} belongs to an agent's run; the runner keeps it up to date.`);
+            return updateCli(session, environment, {
+                check: flags.check === true,
+                log: (line) => this.log(line),
+            });
+        }
+    };
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/dist/whoami.d.ts

@@ -0,0 +1,31 @@
+import { type Command } from '@oclif/core';
+import { type AppCliConfig } from './config.ts';
+/** What `whoami` answers. */
+export interface WhoamiResult {
+    readonly server: string;
+    readonly kind: 'person' | 'run';
+    readonly userId: string;
+    readonly displayName: string;
+    readonly runId?: string;
+    /** Where the credential comes from: a run's file, the environment, or a profile. */
+    readonly source: 'run' | 'env' | 'profile';
+    readonly profile?: string;
+    /** What the profile holds: the session a browser sign-in received, or an API key. */
+    readonly credential?: 'session' | 'apiKey';
+    /** For a session, when it expires unless used again; the server renews it while the CLI is in use. */
+    readonly expiresAt?: string;
+    readonly key?: {
+        readonly id?: string;
+        readonly name?: string;
+    };
+    readonly actions: readonly string[];
+    readonly commands: number;
+    /** The commands that need an action the caller does not hold, with that action. */
+    readonly missing: readonly {
+        readonly command: string;
+        readonly action: string;
+    }[];
+}
+/** `<bin> whoami`: the identity the CLI acts as, as the server sees it, and what it may and may not do. */
+export declare function whoamiCommand(app: AppCliConfig): Command.Class;
+//# sourceMappingURL=whoami.d.ts.map

package/dist/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../src/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAO7D,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3C,sGAAsG;IACtG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACL;AASD,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CA0H9D"}

package/dist/whoami.js

@@ -0,0 +1,118 @@
+import { Flags } from '@oclif/core';
+import { EXIT_CODES } from '@nocobase/agent-protocol';
+import { z } from 'zod';
+import { authRouteOf } from "./config.js";
+import { loadManifest } from "./dynamic/manifest.js";
+import { currentSession, serverPath } from "./dynamic/session.js";
+import { AppCommand, UsageError } from "./lib/command.js";
+import { readUserConfig, userClient } from "./lib/credentials.js";
+import { globalFlags } from "./lib/globals.js";
+/** Better Auth's `GET /get-session`, as far as `whoami` reads it. */
+const BetterAuthSessionSchema = z
+    .object({
+    session: z.object({ expiresAt: z.union([z.string(), z.date()]) }),
+})
+    .nullable();
+/** `<bin> whoami`: the identity the CLI acts as, as the server sees it, and what it may and may not do. */
+export function whoamiCommand(app) {
+    return class Whoami extends AppCommand {
+        static summary = 'Show who the CLI acts as, and what it may do.';
+        static description = "Inside a run's working directory the CLI acts as the run, with the token from the run's credentials file; " +
+            (app.envPrefix === undefined
+                ? ''
+                : `with ${app.envPrefix}_API_KEY set it acts with that key; `) +
+            `anywhere else it acts as the profile \`${app.bin} login\` signed in. Shows the server, the user, when the ` +
+            "session expires (or the key's name), the business actions held, and how many commands need an action you " +
+            'lack (--missing lists them).';
+        static flags = {
+            missing: Flags.boolean({
+                description: 'List the commands that need an action you do not hold, by that action.',
+            }),
+        };
+        async run() {
+            const { flags } = await this.parse(Whoami);
+            const session = await currentSession();
+            if (!session)
+                throw new UsageError(`Not signed in. Run \`${app.bin} login\` first${app.envPrefix ? `, or set ${app.envPrefix}_SERVER and ${app.envPrefix}_API_KEY` : ''}.`, EXIT_CODES.auth);
+            const manifest = await loadManifest(session);
+            const { identity } = manifest;
+            const user = session.kind === 'user'
+                ? await readUserConfig({
+                    paths: this.paths,
+                    config: app,
+                    profile: globalFlags().profile,
+                })
+                : undefined;
+            let expiresAt;
+            if (user?.kind === 'session')
+                expiresAt = await userClient(user)
+                    .request('GET', serverPath(user.server, authRouteOf(app.auth, '/get-session')), undefined)
+                    .then((answer) => {
+                    const at = BetterAuthSessionSchema.parse(answer)?.session.expiresAt;
+                    return at === undefined ? undefined : new Date(at).toISOString();
+                })
+                    .catch(() => undefined);
+            const keyName = user?.keyName;
+            const missing = (manifest.withheld ?? [])
+                .filter((command) => command.reason === 'action' && command.action)
+                .map((command) => ({
+                command: command.id.split(':').join(' '),
+                action: command.action,
+            }));
+            const actions = identity.actions ?? [];
+            const source = session.kind === 'run'
+                ? 'run'
+                : user?.storage === 'env'
+                    ? 'env'
+                    : 'profile';
+            this.log(identity.kind === 'run'
+                ? `Run ${identity.runId ?? ''} acting for ${identity.displayName} (${identity.userId}) on ${session.server}`
+                : `${identity.displayName} (${identity.userId}) on ${session.server}`);
+            if (source === 'env')
+                this.log(`Key      from ${app.envPrefix}_API_KEY`);
+            if (source === 'profile')
+                this.log(`Profile  ${user?.profile ?? ''}` +
+                    (user?.kind === 'session'
+                        ? `, signed in through the browser${expiresAt ? `, session expires ${expiresAt}` : ''}`
+                        : `, API key${keyName ? ` "${keyName}"` : ''}`));
+            this.log(`Actions  ${actions.length === 0 ? '(none)' : actions.join(', ')}`);
+            this.log(`Commands ${manifest.commands.length} offered` +
+                (missing.length > 0
+                    ? `; ${missing.length} need an action you do not hold${flags.missing ? ':' : ` (\`${app.bin} whoami --missing\` lists them)`}`
+                    : ''));
+            if (flags.missing) {
+                const byAction = new Map();
+                for (const entry of missing)
+                    byAction.set(entry.action, [
+                        ...(byAction.get(entry.action) ?? []),
+                        entry.command,
+                    ]);
+                for (const [action, commands] of [...byAction].sort(([a], [b]) => a.localeCompare(b)))
+                    this.log(`  ${action}: ${commands.join(', ')}`);
+            }
+            return {
+                server: session.server,
+                kind: identity.kind,
+                userId: identity.userId,
+                displayName: identity.displayName,
+                ...(identity.runId ? { runId: identity.runId } : {}),
+                source,
+                ...(user?.profile ? { profile: user.profile } : {}),
+                ...(user && source === 'profile' ? { credential: user.kind } : {}),
+                ...(expiresAt ? { expiresAt } : {}),
+                ...(keyName || user?.keyId
+                    ? {
+                        key: {
+                            ...(user?.keyId ? { id: user.keyId } : {}),
+                            ...(keyName ? { name: keyName } : {}),
+                        },
+                    }
+                    : {}),
+                actions,
+                commands: manifest.commands.length,
+                missing,
+            };
+        }
+    };
+}
+//# sourceMappingURL=whoami.js.map

package/dist/whoami.js.map

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

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@nocobase/app-cli-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-beta.0",
+  "description": "A branded command line for a NocoBase application: signs in, and runs the business commands the application's command manifest publishes over its API",
+  "type": "module",
+  "license": "Apache-2.0",
+  "prettier": "@nocobase/dev-config/prettier",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./request": {
+      "types": "./dist/request.d.ts",
+      "import": "./dist/request.js"
+    },
+    "./install": {
+      "types": "./dist/install.d.ts",
+      "import": "./dist/install.js"
+    },
+    "./parse": {
+      "types": "./dist/parse/index.d.ts",
+      "import": "./dist/parse/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@oclif/core": "^4.14.0",
+    "zod": "^4.6.5",
+    "@nocobase/agent-protocol": "^0.1.0-beta.1",
+    "@nocobase/cli-envelope": "^0.1.0-beta.0"
+  },
+  "devDependencies": {
+    "@hono/node-server": "^2.1.1",
+    "@types/node": "^24.0.0",
+    "eslint": "^10.0.0",
+    "hono": "^4.13.2",
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "@nocobase/dev-config": "0.1.0-beta.19"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nocobase/nocobase3.git",
+    "directory": "packages/app/app-cli-client"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix --max-warnings 0",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "check": "pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
+    "fix": "pnpm lint:fix && pnpm format"
+  }
 }