automate.ax 0.1.3

package/dist/cli/commands/project.js

@@ -0,0 +1,20 @@
+import { defineCommand } from "citty";
+import { commandNames } from "../command-names.js";
+import { projectCreateCommand } from "./project-create.js";
+import { projectDeleteCommand } from "./project-delete.js";
+import { projectListCommand } from "./project-list.js";
+import { projectRenameCommand } from "./project-rename.js";
+import { projectShowCommand } from "./project-show.js";
+export const projectCommand = defineCommand({
+    meta: {
+        name: commandNames.project.root,
+        description: "Manage projects",
+    },
+    subCommands: {
+        [commandNames.project.create]: projectCreateCommand,
+        [commandNames.project.delete]: projectDeleteCommand,
+        [commandNames.project.list]: projectListCommand,
+        [commandNames.project.rename]: projectRenameCommand,
+        [commandNames.project.show]: projectShowCommand,
+    },
+});

package/dist/cli/index.d.ts

@@ -0,0 +1,19 @@
+import "./lib/hijack-clack-logger.js";
+export declare const showUsage: typeof import("citty").showUsage;
+/** Root CLI command definition. */
+export declare const main: import("citty").CommandDef<{
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output JSON";
+        readonly default: false;
+    };
+}>;
+/**
+ * Runs the Automate.ax CLI and formats failures for the selected output mode.
+ *
+ * @param rawArgs - Command-line arguments excluding the runtime executable.
+ */
+export declare function runMain(rawArgs?: string[]): Promise<void> | Promise<{
+    result: unknown;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,sCAAkC;AAgBlC,eAAO,MAAM,SAAS,kCAAe,CAAA;AAGrC,mCAAmC;AACnC,eAAO,MAAM,IAAI;;;;;;EAyBf,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,WAAwB;;GAgBtD"}

package/dist/cli/index.js

@@ -0,0 +1,63 @@
+import "./lib/hijack-clack-logger.js";
+import { defineCommand, runCommand, runMain as runCittyMain } from "citty";
+import { commandNames } from "./command-names.js";
+import { acceptCommand } from "./commands/accept.js";
+import { debugCommand } from "./commands/debug.js";
+import { deployCommand } from "./commands/deploy.js";
+import { loginCommand } from "./commands/login.js";
+import { logoutCommand } from "./commands/logout.js";
+import { organizationCommand } from "./commands/org.js";
+import { orgInviteCommand } from "./commands/org-invite.js";
+import { orgUpgradeCommand } from "./commands/org-upgrade.js";
+import { projectCommand } from "./commands/project.js";
+import { meCommand } from "./commands/me.js";
+import { showUsage as cliShowUsage } from "./usage.js";
+import { writeJsonError } from "./utils.js";
+export const showUsage = cliShowUsage;
+const CLI_VERSION = "0.1.2";
+/** Root CLI command definition. */
+export const main = defineCommand({
+    meta: {
+        name: commandNames.root,
+        version: CLI_VERSION,
+        description: "Automate.ax CLI",
+    },
+    args: {
+        json: {
+            type: "boolean",
+            description: "Output JSON",
+            default: false,
+        },
+    },
+    subCommands: {
+        [commandNames.accept]: acceptCommand,
+        [commandNames.debug]: debugCommand,
+        [commandNames.deploy]: deployCommand,
+        [commandNames.invite]: orgInviteCommand,
+        [commandNames.login]: loginCommand,
+        [commandNames.logout]: logoutCommand,
+        [commandNames.me]: meCommand,
+        [commandNames.org.root]: organizationCommand,
+        [commandNames.project.root]: projectCommand,
+        [commandNames.upgrade]: orgUpgradeCommand,
+    },
+});
+/**
+ * Runs the Automate.ax CLI and formats failures for the selected output mode.
+ *
+ * @param rawArgs - Command-line arguments excluding the runtime executable.
+ */
+export function runMain(rawArgs = process.argv.slice(2)) {
+    // JSON mode uses runCommand so Citty doesn't print human usage/errors.
+    // Tradeoff: Citty's built-in --help/--version handling is bypassed when
+    // --json is present, so those combinations currently return JSON errors.
+    return (rawArgs.includes("--json")
+        ? runCommand(main, { rawArgs })
+        : runCittyMain(main, { rawArgs, showUsage })).catch((error) => {
+        if (rawArgs.includes("--json")) {
+            writeJsonError(error);
+            process.exit(1);
+        }
+        throw error;
+    });
+}

package/dist/cli/lib/api-client.d.ts

@@ -0,0 +1,3 @@
+import type { Client } from "@automate.ax/client";
+export declare const apiClient: Client;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/cli/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAOjD,eAAO,MAAM,SAAS,EAAE,MAUvB,CAAA"}

package/dist/cli/lib/api-client.js

@@ -0,0 +1,14 @@
+import { createORPCClient } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+import { joinURL } from "ufo";
+import { loadSavedTokenSync } from "../utils.js";
+import { env } from "./env.js";
+export const apiClient = createORPCClient(new RPCLink({
+    headers: () => {
+        const token = loadSavedTokenSync();
+        if (!token)
+            throw new Error("API credentials are unavailable.");
+        return { authorization: `Bearer ${token}` };
+    },
+    url: joinURL(env.APP_ORIGIN, "/api/rpc"),
+}));

package/dist/cli/lib/auth-client.d.ts

@@ -0,0 +1,80 @@
+export interface CliAuthUser {
+    createdAt: Date | string;
+    email: string;
+    emailVerified: boolean;
+    id: string;
+    image?: string | null;
+    isAnonymous?: boolean | null;
+    name: string;
+    updatedAt: Date | string;
+}
+export interface CliAuthSession {
+    user: CliAuthUser;
+}
+export interface CliSubscription {
+    plan: string;
+    status: string;
+}
+export interface CliAuthClient {
+    device: {
+        code(input: {
+            client_id: string;
+        }): Promise<{
+            device_code: string;
+            user_code: string;
+        }>;
+        token(input: {
+            client_id: string;
+            device_code: string;
+            fetchOptions?: {
+                headers: Record<string, string>;
+            };
+            grant_type: string;
+        }): Promise<{
+            access_token: string;
+        }>;
+    };
+    getSession(): Promise<CliAuthSession | null>;
+    organization: {
+        acceptInvitation(input: {
+            invitationId: string;
+        }): Promise<{
+            member: {
+                organizationId: string;
+                role: string;
+            };
+        }>;
+    };
+    signIn: {
+        anonymous(): Promise<CliAuthSession>;
+    };
+    signOut(): Promise<unknown>;
+    subscription: {
+        billingPortal(input: {
+            customerType: "organization";
+            disableRedirect: true;
+            referenceId: string;
+            returnUrl: string;
+        }): Promise<{
+            url: string;
+        }>;
+        list(input: {
+            query: {
+                customerType: "organization";
+                referenceId: string;
+            };
+        }): Promise<CliSubscription[]>;
+        upgrade(input: {
+            cancelUrl: string;
+            customerType: "organization";
+            disableRedirect: true;
+            plan: "pro";
+            referenceId: string;
+            successUrl: string;
+        }): Promise<{
+            url: string | null;
+        }>;
+    };
+}
+export declare const authClient: CliAuthClient;
+//# sourceMappingURL=auth-client.d.ts.map

package/dist/cli/lib/auth-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/auth-client.ts"],"names":[],"mappings":"AA8CA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,OAAO,CAAA;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,IAAI,CAAC,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAC1C,WAAW,EAAE,MAAM,CAAA;YACnB,SAAS,EAAE,MAAM,CAAA;SAClB,CAAC,CAAA;QACF,KAAK,CAAC,KAAK,EAAE;YACX,SAAS,EAAE,MAAM,CAAA;YACjB,WAAW,EAAE,MAAM,CAAA;YACnB,YAAY,CAAC,EAAE;gBACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;aAChC,CAAA;YACD,UAAU,EAAE,MAAM,CAAA;SACnB,GAAG,OAAO,CAAC;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACtC,CAAA;IACD,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC5C,YAAY,EAAE;QACZ,gBAAgB,CAAC,KAAK,EAAE;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YACzD,MAAM,EAAE;gBACN,cAAc,EAAE,MAAM,CAAA;gBACtB,IAAI,EAAE,MAAM,CAAA;aACb,CAAA;SACF,CAAC,CAAA;KACH,CAAA;IACD,MAAM,EAAE;QACN,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;KACrC,CAAA;IACD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3B,YAAY,EAAE;QACZ,aAAa,CAAC,KAAK,EAAE;YACnB,YAAY,EAAE,cAAc,CAAA;YAC5B,eAAe,EAAE,IAAI,CAAA;YACrB,WAAW,EAAE,MAAM,CAAA;YACnB,SAAS,EAAE,MAAM,CAAA;SAClB,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,EAAE;YACV,KAAK,EAAE;gBACL,YAAY,EAAE,cAAc,CAAA;gBAC5B,WAAW,EAAE,MAAM,CAAA;aACpB,CAAA;SACF,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;QAC9B,OAAO,CAAC,KAAK,EAAE;YACb,SAAS,EAAE,MAAM,CAAA;YACjB,YAAY,EAAE,cAAc,CAAA;YAC5B,eAAe,EAAE,IAAI,CAAA;YACrB,IAAI,EAAE,KAAK,CAAA;YACX,WAAW,EAAE,MAAM,CAAA;YACnB,UAAU,EAAE,MAAM,CAAA;SACnB,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAA;KACpC,CAAA;CACF;AAED,eAAO,MAAM,UAAU,EAAE,aA8BvB,CAAA"}

package/dist/cli/lib/auth-client.js

@@ -0,0 +1,61 @@
+import { apiKeyClient } from "@better-auth/api-key/client";
+import { stripeClient } from "@better-auth/stripe/client";
+import { createAuthClient } from "better-auth/client";
+import { anonymousClient, deviceAuthorizationClient, emailOTPClient, organizationClient, } from "better-auth/client/plugins";
+import { createAccessControl } from "better-auth/plugins/access";
+import { adminAc, defaultStatements, memberAc, ownerAc, } from "better-auth/plugins/organization/access";
+import { joinURL } from "ufo";
+import { loadSavedTokenSync, saveTokenSync } from "../utils.js";
+import { env } from "./env.js";
+/** Access-control statements available to CLI organization roles. */
+const statement = {
+    ...defaultStatements,
+    project: ["create", "update", "delete"],
+};
+const ac = createAccessControl(statement);
+/** Project permissions granted to organization members. */
+const member = ac.newRole({
+    project: ["create"],
+    ...memberAc.statements,
+});
+/** Project permissions granted to organization administrators. */
+const admin = ac.newRole({
+    project: ["create", "update"],
+    ...adminAc.statements,
+});
+/** Project permissions granted to organization owners. */
+const owner = ac.newRole({
+    project: ["create", "update", "delete"],
+    ...ownerAc.statements,
+});
+export const authClient = createAuthClient({
+    baseURL: joinURL(env.APP_ORIGIN, "/api/auth"),
+    fetchOptions: {
+        throw: true,
+        auth: {
+            type: "Bearer",
+            token: () => loadSavedTokenSync() || "",
+        },
+        onSuccess: (ctx) => {
+            const token = ctx.response.headers.get("set-auth-token");
+            if (token) {
+                saveTokenSync(token);
+            }
+        },
+    },
+    plugins: [
+        organizationClient({
+            ac,
+            roles: {
+                owner,
+                admin,
+                member,
+            },
+        }),
+        anonymousClient(),
+        emailOTPClient(),
+        apiKeyClient(),
+        stripeClient({ subscription: true }),
+        deviceAuthorizationClient(),
+    ],
+});

package/dist/cli/lib/automation-build.d.ts

@@ -0,0 +1,30 @@
+export declare const AUTOMATION_BUILD_DIR = ".automate/build";
+export interface AutomationFile {
+    path: string;
+    relativePath: string;
+}
+export interface AutomationBuildResult {
+    dir: string;
+    automations: Array<{
+        body: Blob;
+        identityKey: string;
+    }>;
+}
+/**
+ * Finds automation entry points below a project directory.
+ *
+ * @param dir - Project directory to search.
+ */
+export declare function findAutomationFiles(dir: string): Promise<{
+    path: string;
+    relativePath: string;
+}[]>;
+/**
+ * Bundles automation entry points and reads their deployable artifacts.
+ *
+ * @param projectDir - Project directory that owns the automations.
+ * @param automationFiles - Automation entry points to build.
+ * @throws When two source paths produce the same artifact filename.
+ */
+export declare function buildAutomations(projectDir: string, automationFiles: AutomationFile[]): Promise<AutomationBuildResult>;
+//# sourceMappingURL=automation-build.d.ts.map

package/dist/cli/lib/automation-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-build.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/automation-build.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,oBAAoB,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,IAAI,CAAA;QACV,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;CACH;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM;;;KAkBpD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,cAAc,EAAE,GAChC,OAAO,CAAC,qBAAqB,CAAC,CAoChC"}

package/dist/cli/lib/automation-build.js

@@ -0,0 +1,90 @@
+import { mkdir, readFile, rm } from "node:fs/promises";
+import { build as esbuild } from "esbuild";
+import { globby } from "globby";
+import path from "node:path";
+export const AUTOMATION_BUILD_DIR = ".automate/build";
+/**
+ * Finds automation entry points below a project directory.
+ *
+ * @param dir - Project directory to search.
+ */
+export async function findAutomationFiles(dir) {
+    const resolvedDir = path.resolve(dir);
+    return (await globby("**/*.automation.ts", {
+        absolute: true,
+        cwd: resolvedDir,
+        gitignore: true,
+        onlyFiles: true,
+    }))
+        .map((automationPath) => ({
+        path: automationPath,
+        relativePath: path.relative(resolvedDir, automationPath),
+    }))
+        .toSorted((a, b) => a.relativePath.localeCompare(b.relativePath));
+}
+/**
+ * Bundles automation entry points and reads their deployable artifacts.
+ *
+ * @param projectDir - Project directory that owns the automations.
+ * @param automationFiles - Automation entry points to build.
+ * @throws When two source paths produce the same artifact filename.
+ */
+export async function buildAutomations(projectDir, automationFiles) {
+    const buildDir = path.join(path.resolve(projectDir), AUTOMATION_BUILD_DIR);
+    await rm(buildDir, { recursive: true, force: true });
+    await mkdir(buildDir, { recursive: true });
+    const automations = [];
+    const artifactStems = new Set();
+    for (const automationFile of automationFiles) {
+        const artifactStem = getAutomationArtifactStem(automationFile.relativePath);
+        if (artifactStems.has(artifactStem)) {
+            throw new Error(`Multiple automation files resolve to the same build artifact name: ${artifactStem}`);
+        }
+        artifactStems.add(artifactStem);
+        automations.push({
+            body: new Blob([
+                await readFile(await bundleBuildFile(automationFile.path, path.join(buildDir, "bundles"), `${artifactStem}.js`)),
+            ]),
+            identityKey: automationFile.relativePath,
+        });
+    }
+    return {
+        dir: buildDir,
+        automations,
+    };
+}
+/**
+ * Converts an automation source path into a filesystem-safe artifact stem.
+ *
+ * @param relativePath - Automation path relative to its project.
+ */
+function getAutomationArtifactStem(relativePath) {
+    return relativePath
+        .replace(/\.automation\.[cm]?[jt]sx?$/, "")
+        .split(/[\\/]+/)
+        .filter((part) => part.length > 0)
+        .map((part) => part.replaceAll(/[^A-Za-z0-9._-]+/g, "-"))
+        .join("-");
+}
+/**
+ * Bundles one automation entry point into an ECMAScript module.
+ *
+ * @param sourcePath - Automation entry point to bundle.
+ * @param outdir - Directory where the bundle should be written.
+ * @param filename - Output bundle filename.
+ */
+async function bundleBuildFile(sourcePath, outdir, filename) {
+    await mkdir(outdir, { recursive: true });
+    const outfile = path.join(outdir, filename);
+    await esbuild({
+        bundle: true,
+        entryPoints: [sourcePath],
+        format: "esm",
+        logLevel: "silent",
+        outfile,
+        platform: "node",
+        target: "node24",
+        write: true,
+    });
+    return outfile;
+}

package/dist/cli/lib/config-dir.d.ts

@@ -0,0 +1,47 @@
+export declare const configFileNames: readonly ["automate.config.ts", "automate.config.mts", "automate.config.cts", "automate.config.js", "automate.config.mjs", "automate.config.cjs", "automate.config.json"];
+export type ConfigDirPriority = 0 | 1 | 2;
+export interface ConfigDirMatch {
+    configPath: string;
+    dir: string;
+    priority: ConfigDirPriority;
+}
+export interface FindConfigDirMatchesOptions {
+    cwd?: string;
+    maxDownDepth?: number;
+}
+/**
+ * Finds the nearest project config directories around a working directory.
+ *
+ * @param options - Search root and maximum downward traversal depth.
+ * @param options.cwd - Directory from which to begin searching.
+ * @param options.maxDownDepth - Maximum descendant depth to inspect.
+ */
+export declare function findConfigDirMatches({ cwd, maxDownDepth, }?: FindConfigDirMatchesOptions): Promise<{
+    configPath: string;
+    dir: string;
+    priority: 1;
+}[] | {
+    configPath: string;
+    dir: string;
+    priority: 2;
+}[] | {
+    configPath: string;
+    dir: string;
+    priority: 0;
+}[]>;
+/**
+ * Resolves a user-selected directory and finds its project config file.
+ *
+ * @param dir - Directory path, relative to the supplied working directory.
+ * @param options - Resolution options.
+ * @param options.cwd - Base directory for resolving `dir`.
+ * @throws When the directory contains no recognized config file.
+ */
+export declare function findExplicitConfigDirMatch(dir: string, { cwd }?: {
+    cwd?: string;
+}): Promise<{
+    configPath: string;
+    dir: string;
+    priority: 0;
+}>;
+//# sourceMappingURL=config-dir.d.ts.map

package/dist/cli/lib/config-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-dir.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/config-dir.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,2KAQlB,CAAA;AAOV,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,GAAmB,EACnB,YAAgB,GACjB,GAAE,2BAAgC;;;;;;;;;;;;KAiBlC;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,EAAE,GAAmB,EAAE,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO;;;;GAkB/C"}

package/dist/cli/lib/config-dir.js

@@ -0,0 +1,146 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { globby } from "globby";
+export const configFileNames = [
+    "automate.config.ts",
+    "automate.config.mts",
+    "automate.config.cts",
+    "automate.config.js",
+    "automate.config.mjs",
+    "automate.config.cjs",
+    "automate.config.json",
+];
+/** Preference order used when a directory contains multiple config formats. */
+const configNamePriority = new Map(configFileNames.map((fileName, index) => [fileName, index]));
+/**
+ * Finds the nearest project config directories around a working directory.
+ *
+ * @param options - Search root and maximum downward traversal depth.
+ * @param options.cwd - Directory from which to begin searching.
+ * @param options.maxDownDepth - Maximum descendant depth to inspect.
+ */
+export async function findConfigDirMatches({ cwd = process.cwd(), maxDownDepth = 5, } = {}) {
+    const resolvedCwd = path.resolve(cwd);
+    const currentConfigPath = await findConfigPath(resolvedCwd);
+    if (currentConfigPath) {
+        return [
+            {
+                configPath: currentConfigPath,
+                dir: resolvedCwd,
+                priority: 0,
+            },
+        ];
+    }
+    const parentMatch = await findParentConfigDirMatch(resolvedCwd);
+    if (parentMatch)
+        return [parentMatch];
+    return findDownConfigDirMatches(resolvedCwd, maxDownDepth);
+}
+/**
+ * Resolves a user-selected directory and finds its project config file.
+ *
+ * @param dir - Directory path, relative to the supplied working directory.
+ * @param options - Resolution options.
+ * @param options.cwd - Base directory for resolving `dir`.
+ * @throws When the directory contains no recognized config file.
+ */
+export async function findExplicitConfigDirMatch(dir, { cwd = process.cwd() } = {}) {
+    const resolvedDir = path.resolve(cwd, dir);
+    const configPath = await findConfigPath(resolvedDir);
+    if (!configPath) {
+        throw new Error(`No config found in ${resolvedDir}. Expected one of: ${configFileNames.join(", ")}`);
+    }
+    return {
+        configPath,
+        dir: resolvedDir,
+        priority: 0,
+    };
+}
+/**
+ * Walks parent directories looking for the nearest project config.
+ *
+ * @param cwd - Directory whose parents should be searched.
+ */
+async function findParentConfigDirMatch(cwd) {
+    let dir = path.dirname(cwd);
+    while (dir !== cwd) {
+        const configPath = await findConfigPath(dir);
+        if (configPath) {
+            return {
+                configPath,
+                dir,
+                priority: 1,
+            };
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Finds project configs below a directory within a fixed depth.
+ *
+ * @param cwd - Directory whose descendants should be searched.
+ * @param maxDepth - Maximum number of descendant levels to inspect.
+ */
+async function findDownConfigDirMatches(cwd, maxDepth) {
+    const configPathByDir = new Map();
+    for (const configPath of await globby(configFileNames.map((fileName) => `**/${fileName}`), {
+        absolute: true,
+        cwd,
+        deep: maxDepth + 1,
+        gitignore: true,
+        onlyFiles: true,
+    })) {
+        const dir = path.dirname(configPath);
+        const currentConfigPath = configPathByDir.get(dir);
+        if (!currentConfigPath ||
+            getConfigNamePriority(configPath) <
+                getConfigNamePriority(currentConfigPath)) {
+            configPathByDir.set(dir, configPath);
+        }
+    }
+    return Array.from(configPathByDir.entries())
+        .map(([dir, configPath]) => ({
+        configPath,
+        dir,
+        priority: 2,
+    }))
+        .toSorted((a, b) => a.dir.localeCompare(b.dir));
+}
+/**
+ * Finds the highest-priority recognized config file in a directory.
+ *
+ * @param dir - Directory to inspect.
+ */
+async function findConfigPath(dir) {
+    for (const fileName of configFileNames) {
+        const configPath = path.join(dir, fileName);
+        if (await isFile(configPath))
+            return configPath;
+    }
+    return null;
+}
+/**
+ * Checks whether a path points to a regular file.
+ *
+ * @param filePath - Filesystem path to inspect.
+ */
+async function isFile(filePath) {
+    try {
+        return (await fs.stat(filePath)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Looks up a config filename's selection priority.
+ *
+ * @param configPath - Full config path whose basename should be ranked.
+ */
+function getConfigNamePriority(configPath) {
+    return configNamePriority.get(path.basename(configPath)) ?? Infinity;
+}

package/dist/cli/lib/detail-block.d.ts

@@ -0,0 +1,16 @@
+/** Layout options for a terminal detail block. */
+type DetailBlockOptions = {
+    keyAlignment?: "left" | "right";
+    lineSpacing?: number;
+    padding?: number;
+    separator?: string | null;
+};
+/**
+ * Renders labeled values as an aligned, multiline terminal detail block.
+ *
+ * @param details - Labels mapped to values; nullish values are omitted.
+ * @param options - Alignment, spacing, padding, and separator settings.
+ */
+export declare function renderDetailBlock(details: Record<string, string | number | boolean | null | undefined>, options?: DetailBlockOptions): string;
+export {};
+//# sourceMappingURL=detail-block.d.ts.map

package/dist/cli/lib/detail-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-block.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/detail-block.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,KAAK,kBAAkB,GAAG;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACrE,OAAO,GAAE,kBAAuB,UA2BjC"}

package/dist/cli/lib/detail-block.js

@@ -0,0 +1,25 @@
+import stringWidth from "string-width";
+/**
+ * Renders labeled values as an aligned, multiline terminal detail block.
+ *
+ * @param details - Labels mapped to values; nullish values are omitted.
+ * @param options - Alignment, spacing, padding, and separator settings.
+ */
+export function renderDetailBlock(details, options = {}) {
+    const { keyAlignment = "left", lineSpacing = 0, padding = 2, separator = "", } = options;
+    const entries = Object.entries(details).filter(([, v]) => v != null);
+    const keyWidth = Math.max(0, ...entries.map(([key]) => stringWidth(key)));
+    return entries
+        .map(([key, value]) => {
+        const keyPadding = " ".repeat(keyWidth - stringWidth(key));
+        const valuePadding = " ".repeat(padding);
+        const separatorValue = separator || "";
+        const continuationPadding = " ".repeat(keyWidth + stringWidth(separatorValue) + padding);
+        const [firstLine = "", ...remainingLines] = String(value).split("\n");
+        return [
+            `${keyAlignment === "right" ? `${keyPadding}${key}` : key}${separatorValue}${keyAlignment === "right" ? valuePadding : `${keyPadding}${valuePadding}`}${firstLine}`,
+            ...remainingLines.map((line) => `${continuationPadding}${line}`),
+        ].join("\n");
+    })
+        .join("\n".repeat(Math.max(0, Math.trunc(lineSpacing)) + 1));
+}

package/dist/cli/lib/env.d.ts

@@ -0,0 +1,4 @@
+export declare const env: {
+    APP_ORIGIN: string;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/cli/lib/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/env.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG;;CAIK,CAAA"}

package/dist/cli/lib/env.js

@@ -0,0 +1,7 @@
+import z from "zod";
+const DEFAULT_APP_ORIGIN = "https://automate.ax";
+export const env = z
+    .object({
+    APP_ORIGIN: z.url().prefault(DEFAULT_APP_ORIGIN),
+})
+    .parse(process.env);

package/dist/cli/lib/hijack-clack-logger.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hijack-clack-logger.d.ts.map