@justscale/core 0.1.0

package/dist/cli/service.js

@@ -0,0 +1,95 @@
+/**
+ * Provides reflection and execution capabilities for CLI commands.
+ */
+import { buildRouteMap, generateAppHelp } from './runner.js';
+import { generateHelp } from './parser.js';
+/**
+ * Abstract class token for dependency injection.
+ * Inject this in your controllers to access CLI capabilities.
+ */
+export class CliService {
+}
+/** @internal */
+export class LazyCliService extends CliService {
+    _impl = null;
+    /** Set the real implementation. Called after app creation. */
+    setImplementation(impl) {
+        this._impl = impl;
+    }
+    get impl() {
+        if (!this._impl) {
+            throw new Error('CliService not initialized.');
+        }
+        return this._impl;
+    }
+    listCommands() {
+        return this.impl.listCommands();
+    }
+    async execute(command, args, io) {
+        return this.impl.execute(command, args, io);
+    }
+    help() {
+        return this.impl.help();
+    }
+    helpFor(command) {
+        return this.impl.helpFor(command);
+    }
+}
+/** Create a CliService instance for the given app. */
+export function createCliService(app) {
+    return {
+        listCommands() {
+            const commands = [];
+            for (const controller of app.controllers) {
+                for (const route of controller.routes) {
+                    if (route.method === 'CLI') {
+                        const command = route.segments.join(' ');
+                        commands.push(command);
+                    }
+                }
+            }
+            return commands;
+        },
+        async execute(command, args, io) {
+            const normalized = command.trim().replace(/\s+/g, ' ');
+            let targetRoute = null;
+            let targetDeps = {};
+            for (const controller of app.controllers) {
+                for (const route of controller.routes) {
+                    if (route.method !== 'CLI')
+                        continue;
+                    if (route.segments.join(' ') === normalized) {
+                        targetRoute = route;
+                        targetDeps = controller.deps;
+                        break;
+                    }
+                }
+                if (targetRoute)
+                    break;
+            }
+            if (!targetRoute) {
+                throw new Error(`Unknown command: ${command}`);
+            }
+            let result;
+            const wrappedIO = {
+                ...io,
+                result: (data) => {
+                    result = data;
+                },
+            };
+            await app.execute({ route: targetRoute, deps: targetDeps, params: {} }, { args, io: wrappedIO });
+            return result;
+        },
+        help() {
+            return generateAppHelp('', buildRouteMap(app));
+        },
+        helpFor(command) {
+            const normalized = command.trim().replace(/\s+/g, ' ');
+            const route = buildRouteMap(app).get(normalized);
+            if (!route)
+                return null;
+            return generateHelp(route.fullCommand, route.argDefs, route.description);
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/cli/service.js.map

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

package/dist/cli/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLI Plugin Type Augmentation
+ *
+ * Extends core interfaces for CLI transport:
+ * - ControllerSettings: adds 'command' for subcommand namespace
+ * - TransportContext: adds 'args' and 'io'
+ * - RouteFactories: adds Cli
+ */
+import type { Prettify } from '../core/index.js';
+import type { z } from 'zod';
+import type { CliRouteBuilder, CliRouteDef, CliBaseContext } from './builder/index.js';
+import type { CliIO } from './io.js';
+/** Result schema symbol for typed results */
+export declare const RESULT_SCHEMA: unique symbol;
+/** Read the result schema from a route definition. */
+export declare function getResultSchema(route: unknown): z.ZodType | undefined;
+/**
+ * Extract positional args and flags from a Zod object schema.
+ * Convention: required fields (no default, not optional) = positional args
+ * Everything else = named flags
+ */
+export type ExtractArgs<T extends z.ZodType> = T extends z.ZodObject<infer Shape> ? {
+    [K in keyof Shape]: z.infer<Shape[K]>;
+} : Record<string, unknown>;
+/**
+ * CLI-specific context additions
+ */
+export interface CliContext<TArgs = Record<string, unknown>, TResult = void> {
+    /** Parsed command arguments */
+    args: TArgs;
+    /** CLI I/O interface for input/output */
+    io: CliIO<TResult>;
+}
+/**
+ * Full CLI route context with deps flattened.
+ * Instead of { deps: { db }, args, io } you get { db, args, io }
+ */
+export type CliRouteContext<TDeps = Record<string, unknown>, TArgs = Record<string, unknown>, TResult = void> = Prettify<TDeps & CliContext<TArgs, TResult>>;
+/** CLI route handler */
+export type CliRouteHandler<TDeps = Record<string, unknown>, TArgs = Record<string, unknown>, TResult = void> = (ctx: CliRouteContext<TDeps, TArgs, TResult>) => void | Promise<void>;
+/** CLI factory - supports both direct handler and builder pattern */
+export type CliFactory<TDeps> = {
+    <TCommand extends string>(command: TCommand): CliRouteBuilder<CliBaseContext, never, {}, TCommand>;
+    <TCommand extends string, TInput extends z.ZodType>(command: TCommand, input: TInput): CliRouteBuilder<CliBaseContext<z.infer<TInput>>, never, {}, TCommand>;
+    <TCommand extends string, TInput extends z.ZodType>(command: TCommand, input: TInput, handler: CliRouteHandler<TDeps, z.infer<TInput>>): CliRouteDef<TCommand, never, {}>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,6CAA6C;AAC7C,eAAO,MAAM,aAAa,eAA6B,CAAC;AAExD,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,SAAS,CAErE;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAClE,MAAM,KAAK,CACZ,GACG;KAAG,CAAC,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IACzE,+BAA+B;IAC/B,IAAI,EAAE,KAAK,CAAA;IACX,yCAAyC;IACzC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CACzB,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAG,IAAI,IACZ,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjD,wBAAwB;AACxB,MAAM,MAAM,eAAe,CACzB,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAG,IAAI,IACZ,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1E,qEAAqE;AACrE,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI;IAE9B,CAAC,QAAQ,SAAS,MAAM,EACtB,OAAO,EAAE,QAAQ,GAChB,eAAe,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;IAGvD,CAAC,QAAQ,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,OAAO,EAChD,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,MAAM,GACZ,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;IAGxE,CAAC,QAAQ,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,OAAO,EAChD,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAC/C,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;CACpC,CAAC"}

package/dist/cli/types.js

@@ -0,0 +1,20 @@
+/**
+ * CLI Plugin Type Augmentation
+ *
+ * Extends core interfaces for CLI transport:
+ * - ControllerSettings: adds 'command' for subcommand namespace
+ * - TransportContext: adds 'args' and 'io'
+ * - RouteFactories: adds Cli
+ */
+/** Result schema symbol for typed results */
+export const RESULT_SCHEMA = Symbol('cli.resultSchema');
+/** Read the result schema from a route definition. */
+export function getResultSchema(route) {
+    return route?.[RESULT_SCHEMA];
+}
+// Note: CLI types are now defined directly in core since CLI is built-in:
+// - SupportedMethods.CLI → plugin/plugin.ts
+// - ControllerSettings.command → controller/controller.ts
+// - TransportContext.args/io → controller/controller.ts
+// - RouteFactories.Cli → plugin/plugin.ts
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAExD,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAQ,KAAiC,EAAE,CAAC,aAAa,CAA0B,CAAC;AACtF,CAAC;AA6DD,0EAA0E;AAC1E,4CAA4C;AAC5C,0DAA0D;AAC1D,wDAAwD;AACxD,0CAA0C"}

package/dist/cli/wizard.d.ts

@@ -0,0 +1,11 @@
+import type { CliIO } from './io.js';
+export interface WizardProject {
+    root: string;
+    packageJson: Record<string, any>;
+    hasDependency: (name: string) => boolean;
+}
+export interface WizardContext {
+    io: CliIO<any>;
+    project: WizardProject;
+}
+//# sourceMappingURL=wizard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/cli/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACvB"}

package/dist/cli/wizard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wizard.js.map

package/dist/cli/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/cli/wizard.ts"],"names":[],"mappings":""}

package/dist/cli/workspace-controller.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Workspace CLI Controller
+ *
+ * Provides built-in commands for workspace operations:
+ * - build: Build using TypeScript and Turbo
+ * - run: Run a package, script, or file
+ * - test: Run tests
+ * - init: Set up project config, IDE, and AI tooling
+ * - install: Install a JustScale plugin with optional wizard
+ */
+/**
+ * Find the workspace root by looking for pnpm-workspace.yaml.
+ */
+export declare function findWorkspaceRoot(startDir?: string): string;
+/**
+ * Idempotently install tab-completion for the current shell. Returns a
+ * short status string when a change was made (to show the user), or
+ * `null` when there was nothing to do (already installed, unsupported
+ * shell, non-dev environment, or completion intentionally opted out).
+ *
+ * `force: true` bypasses the dev-mode gate and the opt-out env var —
+ * used by the explicit `just completion install` command.
+ */
+export declare function installShellCompletion(opts?: {
+    force?: boolean;
+}): string | null;
+export declare const WorkspaceController: import("../core/controller.js").ControllerDef<{}, {
+    readonly build: import("./builder/types.js").CliRouteDef<"build", never, {}>;
+    readonly run: import("./builder/types.js").CliRouteDef<"run", never, {}>;
+    readonly test: import("./builder/types.js").CliRouteDef<"test", never, {}>;
+    readonly init: import("./builder/types.js").CliRouteDef<"init", never, {}>;
+    readonly install: import("./builder/types.js").CliRouteDef<"install", never, {}>;
+    readonly dev: import("./builder/types.js").CliRouteDef<"dev", never, {}>;
+    readonly mcpServe: import("./builder/types.js").CliRouteDef<"mcp serve", never, {}>;
+}, import("../core/controller.js").ControllerSettings>;
+//# sourceMappingURL=workspace-controller.d.ts.map

package/dist/cli/workspace-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-controller.d.ts","sourceRoot":"","sources":["../../src/cli/workspace-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAa3D;AAuHD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CA+BpF;AAyXD,eAAO,MAAM,mBAAmB;;;;;;;;sDAyX9B,CAAC"}