@justscale/core 0.1.0

package/dist/cli/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/cli/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUnD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAa;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAEjC,OAAO;QACL,KAAK,CAAC,OAAO,CACX,OAAe,EACf,IAA6B;YAE7B,OAAO,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,YAAY;YAChB,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Typed CLI Arguments
+ *
+ * Type-safe CLI argument definitions with metadata for prompts, flags, and validation.
+ * Uses Zod v4's metadata system with branded types for compile-time enforcement.
+ *
+ * @example
+ * ```typescript
+ * import { cliArgs, arg } from "@justscale/cli";
+ * import { z } from "zod";
+ *
+ * const CreateUserArgs = cliArgs({
+ *   email: arg(z.string().email(), {
+ *     prompt: 'Email address',
+ *     flags: ['-e', '--email'],
+ *   }),
+ *   password: arg(z.string().min(8), {
+ *     prompt: 'Password',
+ *     secret: true,
+ *     confirm: true,
+ *   }),
+ *   role: arg(z.enum(['admin', 'user']).default('user'), {
+ *     prompt: 'Role',
+ *     flags: ['-r', '--role'],
+ *   }),
+ * });
+ *
+ * // Positional args (first two are positional):
+ * const AddUserArgs = cliArgs({
+ *   name: arg(z.string(), { prompt: 'Username', position: 0 }),
+ *   team: arg(z.string(), { prompt: 'Team', position: 1 }),
+ *   admin: arg(z.boolean().default(false), { prompt: 'Admin?', flags: ['--admin'] }),
+ * });
+ * // CLI: add-user john engineering --admin
+ * ```
+ */
+import { ZodObject, type ZodType } from 'zod';
+/**
+ * Metadata for a CLI field.
+ * Defines how the field is prompted, validated, and parsed.
+ */
+export interface CliFieldMeta {
+    /** Prompt message shown when asking for input */
+    prompt: string;
+    /** CLI flags for this argument (e.g., ['-e', '--email']) */
+    flags?: string[];
+    /** Hide input (for passwords) */
+    secret?: boolean;
+    /** Ask twice for confirmation (used with secret) */
+    confirm?: boolean;
+    /** Position for positional args (0, 1, 2...). Omit for flag-only args. */
+    position?: number;
+    /** Description shown in help text (overrides Zod's .describe()) */
+    description?: string;
+}
+/** Brand symbol for CLI args - ensures compile-time enforcement */
+declare const CLI_ARG_BRAND: unique symbol;
+/**
+ * A CLI-enabled field schema.
+ * Brands the Zod type to ensure it has CLI metadata attached.
+ */
+export type CliArg<T extends ZodType = ZodType> = T & {
+    readonly [CLI_ARG_BRAND]: CliFieldMeta;
+};
+/**
+ * Shape type that requires all fields to be CliArg.
+ * Used by cliArgs() to enforce metadata on all fields.
+ */
+export type CliArgsShape = Record<string, CliArg<ZodType>>;
+/**
+ * Create a CLI argument with metadata.
+ * Attaches CLI metadata to a Zod schema and brands the type.
+ *
+ * @param schema - Zod schema for validation
+ * @param meta - CLI metadata (prompt, flags, secret, etc.)
+ * @returns Branded CliArg type
+ *
+ * @example
+ * ```typescript
+ * // Simple flag argument
+ * arg(z.string().email(), { prompt: 'Email', flags: ['-e', '--email'] })
+ *
+ * // Secret with confirmation
+ * arg(z.string().min(8), { prompt: 'Password', secret: true, confirm: true })
+ *
+ * // Positional argument
+ * arg(z.string(), { prompt: 'Name', position: 0 })
+ * ```
+ */
+export declare function arg<T extends ZodType>(schema: T, meta: CliFieldMeta): CliArg<T>;
+/**
+ * Create a CLI input schema from CliArg fields.
+ * ONLY accepts CliArg fields - raw Zod schemas will cause a compile error.
+ *
+ * @param shape - Object with CliArg fields
+ * @returns Zod object schema with CLI metadata preserved
+ *
+ * @example
+ * ```typescript
+ * // This compiles:
+ * const Args = cliArgs({
+ *   email: arg(z.string().email(), { prompt: 'Email' }),
+ * });
+ *
+ * // This FAILS to compile (missing arg() wrapper):
+ * const Args = cliArgs({
+ *   email: z.string().email(), // Error: Type 'ZodString' is not assignable to 'CliArg'
+ * });
+ * ```
+ */
+export declare function cliArgs<T extends CliArgsShape>(shape: T): ZodObject<{
+    [K in keyof T]: T[K] extends CliArg<infer U> ? U : never;
+}>;
+/**
+ * Extract CLI metadata from a schema shape.
+ * Used by the parser/runner to get prompts, flags, etc.
+ *
+ * @param schema - ZodObject schema created with cliArgs()
+ * @returns Map of field name to CLI metadata
+ */
+export declare function extractCliMeta(schema: ZodType): Map<string, CliFieldMeta>;
+/**
+ * Get CLI metadata for a single field.
+ *
+ * @param schema - Zod schema with metadata
+ * @returns CLI metadata or undefined
+ */
+export declare function getCliMeta(schema: ZodType): CliFieldMeta | undefined;
+/**
+ * Check if a schema has CLI metadata.
+ */
+export declare function hasCliMeta(schema: ZodType): boolean;
+/**
+ * Get positional arguments in order.
+ * Returns fields with position metadata, sorted by position number.
+ *
+ * @param schema - ZodObject schema with CLI metadata
+ * @returns Array of [fieldName, metadata] sorted by position
+ */
+export declare function getPositionalArgs(schema: ZodType): Array<[string, CliFieldMeta]>;
+/**
+ * Get flag arguments (non-positional).
+ * Returns fields without position metadata.
+ *
+ * @param schema - ZodObject schema with CLI metadata
+ * @returns Array of [fieldName, metadata]
+ */
+export declare function getFlagArgs(schema: ZodType): Array<[string, CliFieldMeta]>;
+export {};
+//# sourceMappingURL=args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO,EAAK,MAAM,KAAK,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD,mEAAmE;AACnE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,CAAC,GAAG;IACpD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,YAAY,CAAA;CACvC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,OAAO,EACnC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,CAAC,CAAC,CAIX;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,YAAY,EAC5C,KAAK,EAAE,CAAC,GACP,SAAS,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,CAGzE;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAMpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEnD;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,GACd,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAc/B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAW1E"}

package/dist/cli/args.js

@@ -0,0 +1,172 @@
+/**
+ * Typed CLI Arguments
+ *
+ * Type-safe CLI argument definitions with metadata for prompts, flags, and validation.
+ * Uses Zod v4's metadata system with branded types for compile-time enforcement.
+ *
+ * @example
+ * ```typescript
+ * import { cliArgs, arg } from "@justscale/cli";
+ * import { z } from "zod";
+ *
+ * const CreateUserArgs = cliArgs({
+ *   email: arg(z.string().email(), {
+ *     prompt: 'Email address',
+ *     flags: ['-e', '--email'],
+ *   }),
+ *   password: arg(z.string().min(8), {
+ *     prompt: 'Password',
+ *     secret: true,
+ *     confirm: true,
+ *   }),
+ *   role: arg(z.enum(['admin', 'user']).default('user'), {
+ *     prompt: 'Role',
+ *     flags: ['-r', '--role'],
+ *   }),
+ * });
+ *
+ * // Positional args (first two are positional):
+ * const AddUserArgs = cliArgs({
+ *   name: arg(z.string(), { prompt: 'Username', position: 0 }),
+ *   team: arg(z.string(), { prompt: 'Team', position: 1 }),
+ *   admin: arg(z.boolean().default(false), { prompt: 'Admin?', flags: ['--admin'] }),
+ * });
+ * // CLI: add-user john engineering --admin
+ * ```
+ */
+import { ZodObject, z } from 'zod';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Create a CLI argument with metadata.
+ * Attaches CLI metadata to a Zod schema and brands the type.
+ *
+ * @param schema - Zod schema for validation
+ * @param meta - CLI metadata (prompt, flags, secret, etc.)
+ * @returns Branded CliArg type
+ *
+ * @example
+ * ```typescript
+ * // Simple flag argument
+ * arg(z.string().email(), { prompt: 'Email', flags: ['-e', '--email'] })
+ *
+ * // Secret with confirmation
+ * arg(z.string().min(8), { prompt: 'Password', secret: true, confirm: true })
+ *
+ * // Positional argument
+ * arg(z.string(), { prompt: 'Name', position: 0 })
+ * ```
+ */
+export function arg(schema, meta) {
+    // Use Zod v4's .meta() to attach CLI metadata
+    const withMeta = schema.meta({ cli: meta });
+    return withMeta;
+}
+/**
+ * Create a CLI input schema from CliArg fields.
+ * ONLY accepts CliArg fields - raw Zod schemas will cause a compile error.
+ *
+ * @param shape - Object with CliArg fields
+ * @returns Zod object schema with CLI metadata preserved
+ *
+ * @example
+ * ```typescript
+ * // This compiles:
+ * const Args = cliArgs({
+ *   email: arg(z.string().email(), { prompt: 'Email' }),
+ * });
+ *
+ * // This FAILS to compile (missing arg() wrapper):
+ * const Args = cliArgs({
+ *   email: z.string().email(), // Error: Type 'ZodString' is not assignable to 'CliArg'
+ * });
+ * ```
+ */
+export function cliArgs(shape) {
+    // Use z.object() to create the schema - preserves metadata on fields
+    return z.object(shape);
+}
+// ============================================================================
+// Metadata Extraction
+// ============================================================================
+/**
+ * Extract CLI metadata from a schema shape.
+ * Used by the parser/runner to get prompts, flags, etc.
+ *
+ * @param schema - ZodObject schema created with cliArgs()
+ * @returns Map of field name to CLI metadata
+ */
+export function extractCliMeta(schema) {
+    const result = new Map();
+    // Handle ZodObject
+    if (schema instanceof ZodObject) {
+        const shape = schema.shape;
+        for (const [key, fieldSchema] of Object.entries(shape)) {
+            const meta = fieldSchema.meta?.();
+            if (meta && typeof meta === 'object' && 'cli' in meta) {
+                result.set(key, meta.cli);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Get CLI metadata for a single field.
+ *
+ * @param schema - Zod schema with metadata
+ * @returns CLI metadata or undefined
+ */
+export function getCliMeta(schema) {
+    const meta = schema.meta?.();
+    if (meta && typeof meta === 'object' && 'cli' in meta) {
+        return meta.cli;
+    }
+    return undefined;
+}
+/**
+ * Check if a schema has CLI metadata.
+ */
+export function hasCliMeta(schema) {
+    return getCliMeta(schema) !== undefined;
+}
+// ============================================================================
+// Argument Ordering
+// ============================================================================
+/**
+ * Get positional arguments in order.
+ * Returns fields with position metadata, sorted by position number.
+ *
+ * @param schema - ZodObject schema with CLI metadata
+ * @returns Array of [fieldName, metadata] sorted by position
+ */
+export function getPositionalArgs(schema) {
+    const meta = extractCliMeta(schema);
+    const positional = [];
+    for (const [key, fieldMeta] of meta) {
+        if (fieldMeta.position !== undefined) {
+            positional.push([key, fieldMeta]);
+        }
+    }
+    // Sort by position
+    positional.sort((a, b) => (a[1].position ?? 0) - (b[1].position ?? 0));
+    return positional;
+}
+/**
+ * Get flag arguments (non-positional).
+ * Returns fields without position metadata.
+ *
+ * @param schema - ZodObject schema with CLI metadata
+ * @returns Array of [fieldName, metadata]
+ */
+export function getFlagArgs(schema) {
+    const meta = extractCliMeta(schema);
+    const flags = [];
+    for (const [key, fieldMeta] of meta) {
+        if (fieldMeta.position === undefined) {
+            flags.push([key, fieldMeta]);
+        }
+    }
+    return flags;
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/assemble.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared CLI assembly: glue together the user's `app` builder, the
+ * built-in `WorkspaceController`, and CLI controllers contributed by
+ * installed packages. Used by both the `just` binary and the `mcp serve`
+ * command so they dispatch against the exact same DI graph.
+ */
+import { type App } from '../app.js';
+/**
+ * Return a ready-to-run CLI `App`:
+ *
+ * - If `justscale.config.ts` declares `app`, resolve the active env (via
+ *   `loadEnvironment` anchored at the config file), pick the loader for
+ *   `env.type`, import the module, coerce the default export to a
+ *   JustScale builder, register `WorkspaceController` plus any
+ *   package-contributed CLI controllers, and `.build()`.
+ *
+ * - Otherwise, run just the built-in `WorkspaceController`.
+ */
+export declare function assembleCliApp(): Promise<App<any>>;
+//# sourceMappingURL=assemble.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/cli/assemble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAMxD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAuCxD"}

package/dist/cli/assemble.js

@@ -0,0 +1,55 @@
+/**
+ * Shared CLI assembly: glue together the user's `app` builder, the
+ * built-in `WorkspaceController`, and CLI controllers contributed by
+ * installed packages. Used by both the `just` binary and the `mcp serve`
+ * command so they dispatch against the exact same DI graph.
+ */
+import { createAppInternal } from '../app.js';
+import { loadEnvironment } from '../features/environment/load.js';
+import { WorkspaceController } from './workspace-controller.js';
+import { discover, discoverPackageCommands } from './discovery.js';
+import { pickAppLoader } from './define-project.js';
+/**
+ * Return a ready-to-run CLI `App`:
+ *
+ * - If `justscale.config.ts` declares `app`, resolve the active env (via
+ *   `loadEnvironment` anchored at the config file), pick the loader for
+ *   `env.type`, import the module, coerce the default export to a
+ *   JustScale builder, register `WorkspaceController` plus any
+ *   package-contributed CLI controllers, and `.build()`.
+ *
+ * - Otherwise, run just the built-in `WorkspaceController`.
+ */
+export async function assembleCliApp() {
+    const result = await discover();
+    if (!result || !result.config.app) {
+        const app = createAppInternal({ controllers: [WorkspaceController] });
+        await app.ready;
+        return app;
+    }
+    // Load env first - its `type` drives which app module to load. The
+    // config file URL anchors `env/` resolution to the project root (not
+    // the workspace cwd that `just` may have been invoked from).
+    const env = await loadEnvironment({ from: { url: result.configFileUrl } });
+    const loader = pickAppLoader(result.config.app, env.type);
+    const appModule = await loader();
+    const exported = appModule.default ?? appModule;
+    // `exported` is typically a DefinedApp callable: `(env?) => Promise<builder>`.
+    // Passing the pre-loaded env skips its internal `loadEnvironment` call so
+    // we don't double-load. Non-callable exports (rare) pass through.
+    const builderLike = typeof exported === 'function'
+        ? await exported(env)
+        : exported;
+    if (!builderLike || typeof builderLike.addControllers !== 'function') {
+        throw new Error('`app` must resolve to a JustScale builder (before `.build()`). ' +
+            'Export a factory that returns the builder, e.g.:\n\n' +
+            '  export default defineApp(import.meta, (env) => JustScale().add(env)...)\n');
+    }
+    const packageControllers = await discoverPackageCommands();
+    const builtApp = builderLike
+        .addControllers([WorkspaceController, ...packageControllers])
+        .build();
+    await builtApp.app.ready;
+    return builtApp.app;
+}
+//# sourceMappingURL=assemble.js.map

package/dist/cli/assemble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../src/cli/assemble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;IAEhC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,CAAC,KAAK,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,mEAAmE;IACnE,qEAAqE;IACrE,6DAA6D;IAC7D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,MAAM,MAAM,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAI,SAAmC,CAAC,OAAO,IAAI,SAAS,CAAC;IAE3E,+EAA+E;IAC/E,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,UAAU;QAC5B,CAAC,CAAC,MAAO,QAAqC,CAAC,GAAG,CAAC;QACnD,CAAC,CAAC,QAAQ,CAAC;IAEf,IAAI,CAAC,WAAW,IAAI,OAAQ,WAA4C,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CACb,iEAAiE;YACjE,sDAAsD;YACtD,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,MAAM,uBAAuB,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAI,WAAyF;SACxG,cAAc,CAAC,CAAC,mBAAmB,EAAE,GAAG,kBAAkB,CAAC,CAAC;SAC5D,KAAK,EAAE,CAAC;IACX,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;IACzB,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC"}

package/dist/cli/bin/main.d.ts

@@ -0,0 +1,26 @@
+/**
+ * just CLI entry point
+ *
+ * Dispatches in two modes depending on the command:
+ *
+ * - Built-in commands (build, run, test, init, install, dev, mcp serve)
+ *   execute in an isolated app with only `WorkspaceController`. They don't
+ *   depend on any user-provided service, so we skip the cost of discovering
+ *   and building the user's `justscale.config.ts` app entry.
+ *
+ * - Everything else (user-defined CLI commands, package-contributed CLI
+ *   controllers, --help) loads the user's `app` entry (picked by env.type),
+ *   appends the built-in controllers plus any CLI controllers discovered
+ *   on installed packages via `justscale.modes.cli`, calls `.build()`, and
+ *   runs the resulting app. That gives every controller access to the
+ *   *same* DI container, so e.g. `@justscale/auth`'s `AuthCliController`
+ *   can inject the user's `ModelRepository.of(User)` and `UserService`.
+ *
+ * Usage:
+ *   just <command> [args]
+ *   just --socket /path <command>
+ *   just --env <name> <command>
+ *   just --local
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/bin/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/cli/bin/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA2WH,wBAAsB,IAAI,kBA2DzB"}