@runa-cmd/core 0.1.0

package/dist/plugin.js

@@ -0,0 +1,194 @@
+import { RunaError } from './errors.js';
+// ─── Public builder ─────────────────────────────────────────
+/**
+ * Validate and return a PluginConfig.
+ * Passthrough with shape validation — ensures required fields exist.
+ */
+export function definePlugin(config) {
+    if (!config.meta?.name) {
+        throw new RunaError('Plugin must have meta.name defined.', {
+            code: 'INVALID_PLUGIN',
+            exitCode: 1,
+        });
+    }
+    if (typeof config.setup !== 'function') {
+        throw new RunaError(`Plugin '${config.meta.name}' must have a setup() function.`, {
+            code: 'INVALID_PLUGIN',
+            exitCode: 1,
+        });
+    }
+    return config;
+}
+/**
+ * Resolve a list of plugin inputs (direct configs or lazy imports)
+ * into resolved PluginConfig objects.
+ */
+export async function resolvePlugins(plugins) {
+    const resolved = [];
+    for (const plugin of plugins) {
+        if (typeof plugin === 'function') {
+            try {
+                const mod = await plugin();
+                if (!mod.default) {
+                    throw new RunaError('Lazy-loaded plugin module does not have a default export.', {
+                        code: 'PLUGIN_LOAD_ERROR',
+                        exitCode: 1,
+                    });
+                }
+                resolved.push(mod.default);
+            }
+            catch (err) {
+                if (err instanceof RunaError)
+                    throw err;
+                throw new RunaError(`Failed to load lazy plugin: ${err instanceof Error ? err.message : String(err)}`, { code: 'PLUGIN_LOAD_ERROR', exitCode: 1 });
+            }
+        }
+        else {
+            resolved.push(plugin);
+        }
+    }
+    return resolved;
+}
+// ─── Topological sort (Kahn's algorithm) ────────────────────
+/**
+ * Sort plugins in dependency order using Kahn's algorithm.
+ * Detects circular dependencies and missing dependencies.
+ */
+export function topologicalSort(plugins) {
+    // Build name → plugin map
+    const byName = new Map();
+    for (const plugin of plugins) {
+        byName.set(plugin.meta.name, plugin);
+    }
+    // Build adjacency list and in-degree count
+    // edge: dependency → dependent (dependency must come first)
+    const inDegree = new Map();
+    const dependents = new Map(); // dep → [things that depend on it]
+    for (const plugin of plugins) {
+        const name = plugin.meta.name;
+        if (!inDegree.has(name))
+            inDegree.set(name, 0);
+        if (!dependents.has(name))
+            dependents.set(name, []);
+        for (const dep of plugin.meta.dependencies ?? []) {
+            if (!byName.has(dep)) {
+                throw new RunaError(`Plugin '${name}' depends on '${dep}', which is not registered.`, {
+                    code: 'PLUGIN_MISSING_DEPENDENCY',
+                    exitCode: 1,
+                });
+            }
+            if (!dependents.has(dep))
+                dependents.set(dep, []);
+            const depList = dependents.get(dep);
+            if (depList)
+                depList.push(name);
+            inDegree.set(name, (inDegree.get(name) ?? 0) + 1);
+        }
+    }
+    // Kahn's: start with nodes that have no dependencies
+    const queue = [];
+    for (const [name, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(name);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current)
+            break;
+        const plugin = byName.get(current);
+        if (plugin)
+            sorted.push(plugin);
+        for (const dependent of dependents.get(current) ?? []) {
+            const newDegree = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDegree);
+            if (newDegree === 0) {
+                queue.push(dependent);
+            }
+        }
+    }
+    // If sorted doesn't include all plugins, there's a cycle
+    if (sorted.length !== plugins.length) {
+        const remaining = plugins
+            .filter((p) => !sorted.includes(p))
+            .map((p) => `'${p.meta.name}'`)
+            .join(', ');
+        throw new RunaError(`Circular dependency detected among plugins: ${remaining}.`, {
+            code: 'PLUGIN_CIRCULAR_DEPENDENCY',
+            exitCode: 1,
+        });
+    }
+    return sorted;
+}
+/**
+ * Create a PluginAPI for a specific plugin, enforcing capability checks.
+ */
+export function createPluginAPI(pluginName, capabilities, refs) {
+    const caps = capabilities ?? {};
+    return {
+        addCommand(name, command) {
+            if (!caps.addCommands) {
+                throw new RunaError(`Plugin '${pluginName}' called addCommand() but did not declare addCommands capability.`, { code: 'PLUGIN_CAPABILITY_VIOLATION', exitCode: 1 });
+            }
+            refs.commands[name] = command;
+        },
+        addGlobalOption(name, schema, meta) {
+            if (!caps.addGlobalOptions) {
+                throw new RunaError(`Plugin '${pluginName}' called addGlobalOption() but did not declare addGlobalOptions capability.`, { code: 'PLUGIN_CAPABILITY_VIOLATION', exitCode: 1 });
+            }
+            refs.globalOptions[name] = schema;
+            if (meta) {
+                refs.globalMeta.options[name] = meta;
+            }
+        },
+        addMiddleware(middleware) {
+            if (!caps.addMiddleware) {
+                throw new RunaError(`Plugin '${pluginName}' called addMiddleware() but did not declare addMiddleware capability.`, { code: 'PLUGIN_CAPABILITY_VIOLATION', exitCode: 1 });
+            }
+            refs.middleware.push(middleware);
+        },
+        hook(name, handler) {
+            // No capability check for hooks — all plugins can hook
+            refs.hookRegister(name, handler);
+        },
+        getSchema() {
+            return refs.getSchema();
+        },
+        getCommands() {
+            return refs.commands;
+        },
+    };
+}
+// ─── Setup orchestration ────────────────────────────────────
+/**
+ * Call setup(api) for each plugin in topological order.
+ */
+export async function runPluginSetup(plugins, refs) {
+    for (const plugin of plugins) {
+        const api = createPluginAPI(plugin.meta.name, plugin.capabilities, refs);
+        await plugin.setup(api);
+    }
+}
+// ─── Cleanup orchestration ──────────────────────────────────
+/**
+ * Call cleanup() for each plugin in REVERSE topological order.
+ * Each cleanup is wrapped in try/catch — failures don't prevent others from running.
+ * Returns collected errors.
+ */
+export async function runPluginCleanup(plugins) {
+    const errors = [];
+    // Reverse order: dependents clean up before dependencies
+    const reversed = [...plugins].reverse();
+    for (const plugin of reversed) {
+        if (typeof plugin.cleanup === 'function') {
+            try {
+                await plugin.cleanup();
+            }
+            catch (err) {
+                errors.push(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,225 @@
+/**
+ * @runa-cmd/core — Core type definitions
+ *
+ * All TypeScript types, interfaces, and type utilities for the Runa CLI framework.
+ * This is a type-only module — no runtime code.
+ */
+import type { ZodType, z } from 'zod';
+export interface OptionMeta {
+    /** CLI aliases, e.g. ['-e', '--environment'] */
+    alias?: string[];
+    /** Environment variable name, e.g. 'DEPLOY_ENV' */
+    env?: string;
+    /** Help group name, e.g. 'Deploy' */
+    group?: string;
+    /** Deprecation message, e.g. 'Use --confirm instead' */
+    deprecated?: string;
+    /** Value hint for help, e.g. 'staging|prod' */
+    hint?: string;
+}
+export interface CommandMeta<TOptions extends Record<string, ZodType> = Record<string, ZodType>> {
+    name: string;
+    description: string;
+    version?: string;
+    /** Option metadata — keys MUST be a subset of TOptions keys */
+    options?: {
+        [K in keyof TOptions]?: OptionMeta;
+    };
+}
+export interface CLIMeta {
+    name: string;
+    version?: string;
+    description?: string;
+}
+/** Infer args types from a record of Zod schemas */
+export type InferArgs<T extends Record<string, ZodType>> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+/** Infer options types from a record of Zod schemas */
+export type InferOptions<T extends Record<string, ZodType>> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+/** What the run() handler receives */
+export interface RunContext<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>> {
+    args: InferArgs<TArgs>;
+    options: InferOptions<TOptions>;
+    globalOptions: Record<string, unknown>;
+    command: CommandMeta<TOptions>;
+    rawArgs: string[];
+}
+/**
+ * If TOutput extends ZodType, run() must return data matching the schema.
+ * If TOutput is undefined, run() returns void.
+ */
+export type RunReturn<TOutput> = TOutput extends ZodType ? z.infer<TOutput> | Promise<z.infer<TOutput>> : void | Promise<void>;
+export interface CommandConfig<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>, TOutput extends ZodType | undefined = undefined> {
+    meta: CommandMeta<TOptions>;
+    args?: TArgs;
+    options?: TOptions;
+    output?: TOutput;
+    run: (ctx: RunContext<TArgs, TOptions>) => RunReturn<TOutput>;
+}
+export interface Command {
+    readonly _type: 'runa:command';
+    readonly meta: CommandMeta;
+    readonly args?: Record<string, ZodType>;
+    readonly options?: Record<string, ZodType>;
+    readonly output?: ZodType;
+    readonly run: (ctx: RunContext) => unknown;
+}
+export interface CommandTree {
+    [key: string]: Command | CommandTree;
+}
+export interface CLIConfigOptions {
+    /** Config file base name, e.g. 'mycli' → looks for mycli.config.* */
+    name: string;
+    /** Additional config file loaders beyond built-in JSON */
+    loaders?: ConfigLoader[];
+    /** Directories to search for config files. Default: ['.', '~'] */
+    searchPaths?: string[];
+}
+export interface CLIConfig {
+    meta: CLIMeta;
+    commands: CommandTree;
+    plugins?: Array<PluginConfig | (() => Promise<{
+        default: PluginConfig;
+    }>)>;
+    middleware?: Middleware[];
+    config?: CLIConfigOptions;
+    globalOptions?: Record<string, ZodType>;
+    globalMeta?: {
+        options?: Record<string, OptionMeta>;
+    };
+}
+export interface CLI {
+    readonly _type: 'runa:cli';
+    readonly config: CLIConfig;
+    run(argv?: string[]): Promise<void>;
+}
+export interface PluginMeta {
+    name: string;
+    version: string;
+    description?: string;
+    /** Names of other plugins this depends on */
+    dependencies?: string[];
+}
+export interface PluginCapabilities {
+    addCommands?: boolean;
+    addGlobalOptions?: boolean;
+    addMiddleware?: boolean;
+}
+export interface PluginConfig {
+    meta: PluginMeta;
+    capabilities?: PluginCapabilities;
+    setup: (api: PluginAPI) => void | Promise<void>;
+    cleanup?: () => void | Promise<void>;
+}
+export interface PluginAPI {
+    addCommand(name: string, command: Command): void;
+    addGlobalOption(name: string, schema: ZodType, meta?: OptionMeta): void;
+    addMiddleware(middleware: Middleware): void;
+    hook(name: HookName, handler: HookHandler): void;
+    getSchema(): CLISchema;
+    getCommands(): CommandTree;
+}
+export declare const HOOK_NAMES: {
+    readonly BEFORE_PARSE: "beforeParse";
+    readonly ON_GLOBAL_FLAGS: "onGlobalFlags";
+    readonly AFTER_PARSE: "afterParse";
+    readonly BEFORE_RUN: "beforeRun";
+    readonly AFTER_RUN: "afterRun";
+    readonly ON_ERROR: "onError";
+    readonly CLEANUP: "cleanup";
+};
+export type HookName = (typeof HOOK_NAMES)[keyof typeof HOOK_NAMES];
+export interface HookContext {
+    cli: CLIMeta;
+    rawArgs: string[];
+    globalOptions?: Record<string, unknown>;
+    command?: CommandMeta;
+    args?: Record<string, unknown>;
+    options?: Record<string, unknown>;
+    error?: Error;
+    /** Call this in onGlobalFlags to short-circuit the lifecycle */
+    shortCircuit?: () => void;
+    /** Set this in onError to prevent default error output */
+    handled?: boolean;
+}
+export type HookHandler = (ctx: HookContext) => void | Promise<void>;
+export interface MiddlewareContext {
+    next: () => Promise<void>;
+    globalOptions: Record<string, unknown>;
+}
+export type MiddlewareFn = (ctx: MiddlewareContext) => Promise<void>;
+export interface Middleware {
+    readonly _type: 'runa:middleware';
+    readonly handler: MiddlewareFn;
+}
+export interface ConfigLoader {
+    /** File extensions this loader handles, e.g. ['.json'] */
+    extensions: string[];
+    /** Read and parse the config file at the given path */
+    load(filePath: string): Promise<unknown>;
+}
+export interface CLISchema {
+    meta: CLIMeta;
+    commands: CommandSchema[];
+    globalOptions: OptionSchema[];
+}
+export interface CommandSchema {
+    name: string;
+    description: string;
+    /** Full command path, e.g. ['config', 'set'] for nested commands */
+    fullPath: string[];
+    args: ArgSchema[];
+    options: OptionSchema[];
+    hasOutput: boolean;
+    subcommands?: CommandSchema[];
+}
+export interface ArgSchema {
+    name: string;
+    description?: string;
+    type: ParamType;
+    required: boolean;
+    defaultValue?: unknown;
+    isVariadic: boolean;
+    enumValues?: string[];
+}
+export interface OptionSchema {
+    name: string;
+    description?: string;
+    type: ParamType;
+    required: boolean;
+    defaultValue?: unknown;
+    alias?: string[];
+    env?: string;
+    group?: string;
+    deprecated?: string;
+    hint?: string;
+    enumValues?: string[];
+}
+export declare const PARAM_TYPES: {
+    readonly STRING: "string";
+    readonly NUMBER: "number";
+    readonly BOOLEAN: "boolean";
+    readonly ENUM: "enum";
+    readonly ARRAY: "array";
+};
+export type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];
+export interface ParamMetadata {
+    /** Key name from the schema record */
+    name: string;
+    /** Detected base type */
+    zodType: ParamType;
+    /** Whether the field is optional (has .optional() or .default()) */
+    isOptional: boolean;
+    /** Default value extracted from .default(), or undefined */
+    defaultValue: unknown;
+    /** Whether this is a z.array() (variadic arg) */
+    isArray: boolean;
+    /** Enum values extracted from z.enum() */
+    enumValues?: string[];
+    /** Description extracted from .describe() */
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+// ─── Lifecycle Hooks ────────────────────────────────────────
+export const HOOK_NAMES = {
+    BEFORE_PARSE: 'beforeParse',
+    ON_GLOBAL_FLAGS: 'onGlobalFlags',
+    AFTER_PARSE: 'afterParse',
+    BEFORE_RUN: 'beforeRun',
+    AFTER_RUN: 'afterRun',
+    ON_ERROR: 'onError',
+    CLEANUP: 'cleanup',
+};
+// ─── Schema Walker Output ───────────────────────────────────
+export const PARAM_TYPES = {
+    STRING: 'string',
+    NUMBER: 'number',
+    BOOLEAN: 'boolean',
+    ENUM: 'enum',
+    ARRAY: 'array',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyKA,+DAA+D;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,eAAe;IAChC,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;CACT,CAAC;AAsFX,+DAA+D;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACL,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @runa-cmd/core — Zod v4 re-export
+ *
+ * Subpath: @runa-cmd/core/zod
+ * Provides convenience import so consumers can use a single package.
+ */
+export { z } from 'zod';
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/zod.js

@@ -0,0 +1,8 @@
+/**
+ * @runa-cmd/core — Zod v4 re-export
+ *
+ * Subpath: @runa-cmd/core/zod
+ * Provides convenience import so consumers can use a single package.
+ */
+export { z } from 'zod';
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@runa-cmd/core",
+  "version": "0.1.0",
+  "description": "Schema-driven, TypeScript-first CLI engine — commands, parsing, plugins, middleware. Zero runtime deps.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "cli",
+    "command-line",
+    "zod",
+    "typescript",
+    "schema-driven",
+    "parseargs",
+    "plugin",
+    "middleware"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./zod": {
+      "types": "./dist/zod.d.ts",
+      "import": "./dist/zod.js"
+    }
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jrodrigopuca/runa-cmd.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/jrodrigopuca/runa-cmd/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/jrodrigopuca/runa-cmd/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "clean": "rm -rf dist"
+  }
+}