@runa-cmd/core 0.1.0

package/dist/config/search.js

@@ -0,0 +1,40 @@
+/**
+ * @runa-cmd/core — Config file discovery
+ *
+ * Searches up search paths for config files matching {name}.config.{ext}.
+ * First match wins. Returns null if no config found.
+ */
+import { access } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Search for a config file in the given paths.
+ *
+ * For each search path, for each loader, checks if
+ * `{path}/{name}.config{ext}` exists.
+ *
+ * Search paths are checked in order; first match wins.
+ * '~' is resolved to os.homedir().
+ *
+ * Returns null if no config file is found (not an error).
+ */
+export async function searchConfig(name, loaders, searchPaths) {
+    for (const rawPath of searchPaths) {
+        // Resolve ~ to home directory
+        const searchPath = rawPath === '~' ? homedir() : rawPath;
+        for (const loader of loaders) {
+            for (const ext of loader.extensions) {
+                const filePath = join(searchPath, `${name}.config${ext}`);
+                try {
+                    await access(filePath);
+                    return { filePath, loader };
+                }
+                catch {
+                    // File does not exist, continue searching
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=search.js.map

package/dist/config/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/config/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,IAAY,EACZ,OAAuB,EACvB,WAAqB;IAErB,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QACnC,8BAA8B;QAC9B,MAAM,UAAU,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAEzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,UAAU,GAAG,EAAE,CAAC,CAAC;gBAC1D,IAAI,CAAC;oBACJ,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAC7B,CAAC;gBAAC,MAAM,CAAC;oBACR,0CAA0C;gBAC3C,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @runa-cmd/core — Error class hierarchy
+ *
+ * RunaError (base) → ValidationError | CommandNotFoundError | CommandError
+ * POSIX-aligned exit codes: 2 (usage), 127 (not found), 1 (general).
+ */
+import type { z } from 'zod';
+type ZodIssue = z.core.$ZodIssue;
+export declare class RunaError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    constructor(message: string, options: {
+        code: string;
+        exitCode?: number;
+    });
+}
+export declare class ValidationError extends RunaError {
+    readonly issues: ZodIssue[];
+    constructor(issues: ZodIssue[]);
+}
+export declare class CommandNotFoundError extends RunaError {
+    readonly suggestion?: string;
+    constructor(commandName: string, suggestion?: string);
+}
+export declare class CommandError extends RunaError {
+    constructor(message: string, options?: {
+        code?: string;
+        exitCode?: number;
+    });
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,KAAK,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;AASjC,qBAAa,SAAU,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAUzE;AAID,qBAAa,eAAgB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEhB,MAAM,EAAE,QAAQ,EAAE;CAgB9B;AAID,qBAAa,oBAAqB,SAAQ,SAAS;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAapD;AAID,qBAAa,YAAa,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAW3E"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+// V8-specific: captureStackTrace is not in the standard Error type
+const captureStackTrace = 
+// biome-ignore lint/complexity/noBannedTypes: V8's captureStackTrace expects Function for the constructor argument
+Error.captureStackTrace;
+// ─── RunaError ──────────────────────────────────────────────
+export class RunaError extends Error {
+    code;
+    exitCode;
+    constructor(message, options) {
+        super(message);
+        this.name = 'RunaError';
+        this.code = options.code;
+        this.exitCode = options.exitCode ?? 1;
+        if (captureStackTrace) {
+            captureStackTrace(this, this.constructor);
+        }
+    }
+}
+// ─── ValidationError ────────────────────────────────────────
+export class ValidationError extends RunaError {
+    issues;
+    constructor(issues) {
+        const message = issues
+            .map((issue) => {
+            const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';
+            return `${path}${issue.message}`;
+        })
+            .join('\n');
+        super(message, { code: 'VALIDATION_ERROR', exitCode: 2 });
+        this.name = 'ValidationError';
+        this.issues = issues;
+        if (captureStackTrace) {
+            captureStackTrace(this, this.constructor);
+        }
+    }
+}
+// ─── CommandNotFoundError ───────────────────────────────────
+export class CommandNotFoundError extends RunaError {
+    suggestion;
+    constructor(commandName, suggestion) {
+        const message = suggestion
+            ? `Command not found: '${commandName}'. Did you mean '${suggestion}'?`
+            : `Command not found: '${commandName}'.`;
+        super(message, { code: 'COMMAND_NOT_FOUND', exitCode: 127 });
+        this.name = 'CommandNotFoundError';
+        this.suggestion = suggestion;
+        if (captureStackTrace) {
+            captureStackTrace(this, this.constructor);
+        }
+    }
+}
+// ─── CommandError ───────────────────────────────────────────
+export class CommandError extends RunaError {
+    constructor(message, options) {
+        super(message, {
+            code: options?.code ?? 'COMMAND_ERROR',
+            exitCode: options?.exitCode ?? 1,
+        });
+        this.name = 'CommandError';
+        if (captureStackTrace) {
+            captureStackTrace(this, this.constructor);
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,mEAAmE;AACnE,MAAM,iBAAiB;AACtB,mHAAmH;AAClH,KAA0E,CAAC,iBAAiB,CAAC;AAE/F,+DAA+D;AAE/D,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACb,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,OAA4C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEtC,IAAI,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;CACD;AAED,+DAA+D;AAE/D,MAAM,OAAO,eAAgB,SAAQ,SAAS;IACpC,MAAM,CAAa;IAE5B,YAAY,MAAkB;QAC7B,MAAM,OAAO,GAAG,MAAM;aACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;CACD;AAED,+DAA+D;AAE/D,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACzC,UAAU,CAAU;IAE7B,YAAY,WAAmB,EAAE,UAAmB;QACnD,MAAM,OAAO,GAAG,UAAU;YACzB,CAAC,CAAC,uBAAuB,WAAW,oBAAoB,UAAU,IAAI;YACtE,CAAC,CAAC,uBAAuB,WAAW,IAAI,CAAC;QAE1C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;CACD;AAED,+DAA+D;AAE/D,MAAM,OAAO,YAAa,SAAQ,SAAS;IAC1C,YAAY,OAAe,EAAE,OAA8C;QAC1E,KAAK,CAAC,OAAO,EAAE;YACd,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,eAAe;YACtC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAE3B,IAAI,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @runa-cmd/core — Public API
+ *
+ * This barrel re-exports the complete public surface of @runa-cmd/core.
+ * Internal modules (schema-walker, parseargs-bridge, resolve, variadic) are NOT exported.
+ */
+export { defineCLI, runCLI } from './cli.js';
+export { defineCommand } from './command.js';
+export { jsonLoader } from './config/loader.js';
+export { CommandError, CommandNotFoundError, RunaError, ValidationError, } from './errors.js';
+export { getSchema } from './introspect.js';
+export { defineMiddleware } from './middleware.js';
+export { definePlugin } from './plugin.js';
+export type { ArgSchema, CLI, CLIConfig, CLIConfigOptions, CLIMeta, CLISchema, Command, CommandConfig, CommandMeta, CommandSchema, CommandTree, ConfigLoader, HookContext, HookHandler, HookName, InferArgs, InferOptions, Middleware, MiddlewareContext, MiddlewareFn, OptionMeta, OptionSchema, ParamMetadata, ParamType, PluginAPI, PluginCapabilities, PluginConfig, PluginMeta, RunContext, RunReturn, } from './types.js';
+export { HOOK_NAMES, PARAM_TYPES } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EACN,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,eAAe,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACX,SAAS,EACT,GAAG,EACH,SAAS,EACT,gBAAgB,EAChB,OAAO,EAEP,SAAS,EAET,OAAO,EAEP,aAAa,EAEb,WAAW,EACX,aAAa,EACb,WAAW,EAEX,YAAY,EACZ,WAAW,EACX,WAAW,EAEX,QAAQ,EAER,SAAS,EACT,YAAY,EAEZ,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,YAAY,EAEZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,kBAAkB,EAElB,YAAY,EACZ,UAAU,EAEV,UAAU,EACV,SAAS,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @runa-cmd/core — Public API
+ *
+ * This barrel re-exports the complete public surface of @runa-cmd/core.
+ * Internal modules (schema-walker, parseargs-bridge, resolve, variadic) are NOT exported.
+ */
+export { defineCLI, runCLI } from './cli.js';
+// ─── Builder functions ──────────────────────────────────────
+export { defineCommand } from './command.js';
+// ─── Config utilities ───────────────────────────────────────
+export { jsonLoader } from './config/loader.js';
+// ─── Error classes ──────────────────────────────────────────
+export { CommandError, CommandNotFoundError, RunaError, ValidationError, } from './errors.js';
+// ─── Introspection ──────────────────────────────────────────
+export { getSchema } from './introspect.js';
+export { defineMiddleware } from './middleware.js';
+export { definePlugin } from './plugin.js';
+// ─── Runtime constants ──────────────────────────────────────
+export { HOOK_NAMES, PARAM_TYPES } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,+DAA+D;AAC/D,OAAO,EACN,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,+DAA+D;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+C3C,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/introspect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @runa-cmd/core — Schema introspection
+ *
+ * getSchema() walks the command tree and extracts structured metadata
+ * (CLISchema) for use by plugins (help, MCP, completions).
+ */
+import type { ZodType } from 'zod';
+import type { CLIConfig, CLISchema, OptionMeta } from './types.js';
+/**
+ * Extract the full CLI schema for introspection.
+ *
+ * Used by plugins (help, MCP, completions) to discover commands,
+ * args, options, and metadata without executing anything.
+ */
+export declare function getSchema(config: CLIConfig, extraGlobalOptions?: Record<string, ZodType>, extraGlobalMeta?: Record<string, OptionMeta>): CLISchema;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,KAAK,EAEX,SAAS,EACT,SAAS,EAIT,UAAU,EAEV,MAAM,YAAY,CAAC;AA6FpB;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,SAAS,EACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAC1C,SAAS,CAwCX"}

package/dist/introspect.js

@@ -0,0 +1,128 @@
+import { walkSchema } from './parse/schema-walker.js';
+// ─── Helpers ────────────────────────────────────────────────
+function isCommand(value) {
+    return '_type' in value && value._type === 'runa:command';
+}
+/**
+ * Walk a command and extract its schema information.
+ */
+function walkCommand(name, command, parentPath) {
+    const fullPath = [...parentPath, name];
+    // Extract arg schemas
+    const argSchemas = [];
+    if (command.args) {
+        const metadata = walkSchema(command.args);
+        for (const meta of metadata) {
+            argSchemas.push({
+                name: meta.name,
+                description: meta.description,
+                type: meta.zodType,
+                required: !meta.isOptional,
+                defaultValue: meta.defaultValue,
+                isVariadic: meta.isArray,
+                enumValues: meta.enumValues,
+            });
+        }
+    }
+    // Extract option schemas
+    const optionSchemas = [];
+    if (command.options) {
+        const metadata = walkSchema(command.options);
+        const optMeta = (command.meta.options ?? {});
+        for (const meta of metadata) {
+            const om = optMeta[meta.name];
+            optionSchemas.push({
+                name: meta.name,
+                description: meta.description,
+                type: meta.zodType,
+                required: !meta.isOptional,
+                defaultValue: meta.defaultValue,
+                alias: om?.alias,
+                env: om?.env,
+                group: om?.group,
+                deprecated: om?.deprecated,
+                hint: om?.hint,
+                enumValues: meta.enumValues,
+            });
+        }
+    }
+    return {
+        name,
+        description: command.meta.description,
+        fullPath,
+        args: argSchemas,
+        options: optionSchemas,
+        hasOutput: !!command.output,
+    };
+}
+/**
+ * Recursively walk a command tree and extract schemas for all commands.
+ */
+function walkTree(tree, parentPath) {
+    const schemas = [];
+    for (const [name, entry] of Object.entries(tree)) {
+        if (isCommand(entry)) {
+            schemas.push(walkCommand(name, entry, parentPath));
+        }
+        else {
+            // It's a subtree — recurse and collect as subcommands
+            const subcommands = walkTree(entry, [...parentPath, name]);
+            schemas.push({
+                name,
+                description: '',
+                fullPath: [...parentPath, name],
+                args: [],
+                options: [],
+                hasOutput: false,
+                subcommands,
+            });
+        }
+    }
+    return schemas;
+}
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Extract the full CLI schema for introspection.
+ *
+ * Used by plugins (help, MCP, completions) to discover commands,
+ * args, options, and metadata without executing anything.
+ */
+export function getSchema(config, extraGlobalOptions, extraGlobalMeta) {
+    // Walk the command tree
+    const commands = walkTree(config.commands, []);
+    // Extract global option schemas
+    const globalOptionSchemas = [];
+    const allGlobalOptions = {
+        ...(config.globalOptions ?? {}),
+        ...(extraGlobalOptions ?? {}),
+    };
+    const allGlobalMeta = {
+        ...(config.globalMeta?.options ?? {}),
+        ...(extraGlobalMeta ?? {}),
+    };
+    if (Object.keys(allGlobalOptions).length > 0) {
+        const metadata = walkSchema(allGlobalOptions);
+        for (const meta of metadata) {
+            const om = allGlobalMeta[meta.name];
+            globalOptionSchemas.push({
+                name: meta.name,
+                description: meta.description,
+                type: meta.zodType,
+                required: !meta.isOptional,
+                defaultValue: meta.defaultValue,
+                alias: om?.alias,
+                env: om?.env,
+                group: om?.group,
+                deprecated: om?.deprecated,
+                hint: om?.hint,
+                enumValues: meta.enumValues,
+            });
+        }
+    }
+    return {
+        meta: config.meta,
+        commands,
+        globalOptions: globalOptionSchemas,
+    };
+}
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @runa-cmd/core — Lifecycle hook registry + execution engine
+ *
+ * Manages the 7-hook pipeline:
+ * beforeParse → onGlobalFlags → afterParse → beforeRun → afterRun → onError → cleanup
+ *
+ * Hooks are sequential arrays. Cleanup ALWAYS runs.
+ */
+import type { HookContext, HookHandler, HookName } from './types.js';
+export interface EmitResult {
+    /** True if an onGlobalFlags handler called shortCircuit() */
+    shortCircuited: boolean;
+}
+export interface HookRegistry {
+    /** Register a handler for a lifecycle hook */
+    register(name: HookName, handler: HookHandler): void;
+    /** Emit a hook, running all handlers in registration order */
+    emit(name: HookName, context: HookContext): Promise<EmitResult>;
+    /** Get all handlers for a hook (for testing/introspection) */
+    getHandlers(name: HookName): HookHandler[];
+}
+/**
+ * Create a new hook registry.
+ * Handlers are stored per hook name and execute in registration order.
+ */
+export declare function createHookRegistry(): HookRegistry;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,UAAU;IAC1B,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACrD,8DAA8D;IAC9D,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChE,8DAA8D;IAC9D,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CA+DjD"}

package/dist/lifecycle.js

@@ -0,0 +1,62 @@
+/**
+ * Create a new hook registry.
+ * Handlers are stored per hook name and execute in registration order.
+ */
+export function createHookRegistry() {
+    const handlers = new Map();
+    return {
+        register(name, handler) {
+            if (!handlers.has(name)) {
+                handlers.set(name, []);
+            }
+            const list = handlers.get(name);
+            if (list) {
+                list.push(handler);
+            }
+        },
+        async emit(name, context) {
+            const hookHandlers = handlers.get(name) ?? [];
+            let shortCircuited = false;
+            if (name === 'onGlobalFlags') {
+                // onGlobalFlags supports short-circuit via context.shortCircuit()
+                let didShortCircuit = false;
+                const ctxWithShortCircuit = {
+                    ...context,
+                    shortCircuit: () => {
+                        didShortCircuit = true;
+                    },
+                };
+                for (const handler of hookHandlers) {
+                    await handler(ctxWithShortCircuit);
+                    if (didShortCircuit) {
+                        shortCircuited = true;
+                        break;
+                    }
+                }
+                return { shortCircuited };
+            }
+            if (name === 'cleanup') {
+                // Cleanup handlers: each wrapped in try/catch, ALL must run
+                for (const handler of hookHandlers) {
+                    try {
+                        await handler(context);
+                    }
+                    catch {
+                        // Cleanup errors are swallowed to ensure all handlers run.
+                        // Plugin cleanup errors are reported separately.
+                    }
+                }
+                return { shortCircuited: false };
+            }
+            // Standard hooks: run sequentially, propagate errors
+            for (const handler of hookHandlers) {
+                await handler(context);
+            }
+            return { shortCircuited: false };
+        },
+        getHandlers(name) {
+            return handlers.get(name) ?? [];
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEpD,OAAO;QACN,QAAQ,CAAC,IAAc,EAAE,OAAoB;YAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxB,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;QACF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAc,EAAE,OAAoB;YAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,cAAc,GAAG,KAAK,CAAC;YAE3B,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC9B,kEAAkE;gBAClE,IAAI,eAAe,GAAG,KAAK,CAAC;gBAC5B,MAAM,mBAAmB,GAAgB;oBACxC,GAAG,OAAO;oBACV,YAAY,EAAE,GAAG,EAAE;wBAClB,eAAe,GAAG,IAAI,CAAC;oBACxB,CAAC;iBACD,CAAC;gBAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;oBACpC,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;oBACnC,IAAI,eAAe,EAAE,CAAC;wBACrB,cAAc,GAAG,IAAI,CAAC;wBACtB,MAAM;oBACP,CAAC;gBACF,CAAC;gBACD,OAAO,EAAE,cAAc,EAAE,CAAC;YAC3B,CAAC;YAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxB,4DAA4D;gBAC5D,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;oBACpC,IAAI,CAAC;wBACJ,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACR,2DAA2D;wBAC3D,iDAAiD;oBAClD,CAAC;gBACF,CAAC;gBACD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;YAClC,CAAC;YAED,qDAAqD;YACrD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;gBACpC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;QAED,WAAW,CAAC,IAAc;YACzB,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @runa-cmd/core — defineMiddleware()
+ *
+ * Simple wrapper that brands a MiddlewareFn into a Middleware object.
+ * Middleware follows the Koa/Hono onion model with next().
+ */
+import type { Middleware, MiddlewareFn } from './types.js';
+/**
+ * Create a branded Middleware from a handler function.
+ *
+ * Middleware handlers are async functions receiving { next, globalOptions }.
+ * Call `await next()` to execute the next middleware or command.
+ * Code before next() runs before the command; code after runs after.
+ */
+export declare function defineMiddleware(handler: MiddlewareFn): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI3D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAKlE"}

package/dist/middleware.js

@@ -0,0 +1,15 @@
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Create a branded Middleware from a handler function.
+ *
+ * Middleware handlers are async functions receiving { next, globalOptions }.
+ * Call `await next()` to execute the next middleware or command.
+ * Code before next() runs before the command; code after runs after.
+ */
+export function defineMiddleware(handler) {
+    return {
+        _type: 'runa:middleware',
+        handler,
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAQA,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACrD,OAAO;QACN,KAAK,EAAE,iBAA0B;QACjC,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/parse/parseargs-bridge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @runa-cmd/core — util.parseArgs bridge
+ *
+ * Converts schema walker metadata + option meta into a valid
+ * util.parseArgs configuration object.
+ */
+import type { ParseArgsConfig } from 'node:util';
+import type { OptionMeta, ParamMetadata } from '../types.js';
+export interface ParseArgsBridgeConfig {
+    parseArgsConfig: ParseArgsConfig;
+    /** Maps long alias names → canonical option name */
+    longAliasMap: Record<string, string>;
+}
+/**
+ * Build a util.parseArgs configuration from schema walker output.
+ *
+ * @param metadata - Parameter metadata from schema walker (for options only)
+ * @param optionMeta - OptionMeta from meta.options (aliases, env, etc.)
+ * @param hasArgs - Whether the command has positional args
+ */
+export declare function buildParseArgsConfig(metadata: ParamMetadata[], optionMeta?: Record<string, OptionMeta>, hasArgs?: boolean): ParseArgsBridgeConfig;
+//# sourceMappingURL=parseargs-bridge.d.ts.map

package/dist/parse/parseargs-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseargs-bridge.d.ts","sourceRoot":"","sources":["../../src/parse/parseargs-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI7D,MAAM,WAAW,qBAAqB;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,aAAa,EAAE,EACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,OAAO,CAAC,EAAE,OAAO,GACf,qBAAqB,CAsDvB"}

package/dist/parse/parseargs-bridge.js

@@ -0,0 +1,54 @@
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Build a util.parseArgs configuration from schema walker output.
+ *
+ * @param metadata - Parameter metadata from schema walker (for options only)
+ * @param optionMeta - OptionMeta from meta.options (aliases, env, etc.)
+ * @param hasArgs - Whether the command has positional args
+ */
+export function buildParseArgsConfig(metadata, optionMeta, hasArgs) {
+    const options = {};
+    const longAliasMap = {};
+    for (const param of metadata) {
+        // Map Zod type → parseArgs type
+        // boolean → 'boolean' (enables --no-* negation)
+        // everything else → 'string' (Zod handles coercion later)
+        const parseArgsType = param.zodType === 'boolean' ? 'boolean' : 'string';
+        const optConfig = {
+            type: parseArgsType,
+        };
+        // Extract aliases from meta
+        const meta = optionMeta?.[param.name];
+        if (meta?.alias) {
+            for (const alias of meta.alias) {
+                if (alias.startsWith('--')) {
+                    // Long alias: register as a separate option pointing to the same name
+                    const longName = alias.slice(2);
+                    longAliasMap[longName] = param.name;
+                    // Register the long alias in parseArgs too
+                    options[longName] = { type: parseArgsType };
+                }
+                else if (alias.startsWith('-') && alias.length === 2) {
+                    // Short alias: single char after '-'
+                    optConfig.short = alias[1];
+                }
+            }
+        }
+        // Set boolean defaults so parseArgs returns them correctly
+        // For booleans with defaults, pass the default to parseArgs
+        if (parseArgsType === 'boolean' && param.defaultValue !== undefined) {
+            optConfig.default = param.defaultValue;
+        }
+        options[param.name] = optConfig;
+    }
+    return {
+        parseArgsConfig: {
+            options,
+            allowPositionals: hasArgs ?? false,
+            strict: false, // Let Zod handle unknown option errors
+            allowNegative: true, // Enable --no-* boolean negation
+        },
+        longAliasMap,
+    };
+}
+//# sourceMappingURL=parseargs-bridge.js.map

package/dist/parse/parseargs-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseargs-bridge.js","sourceRoot":"","sources":["../../src/parse/parseargs-bridge.ts"],"names":[],"mappings":"AAiBA,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CACnC,QAAyB,EACzB,UAAuC,EACvC,OAAiB;IAEjB,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,MAAM,YAAY,GAA2B,EAAE,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC9B,gCAAgC;QAChC,gDAAgD;QAChD,0DAA0D;QAC1D,MAAM,aAAa,GAAyB,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE/F,MAAM,SAAS,GAKX;YACH,IAAI,EAAE,aAAa;SACnB,CAAC;QAEF,4BAA4B;QAC5B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YACjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5B,sEAAsE;oBACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAChC,YAAY,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;oBACpC,2CAA2C;oBAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;gBAC7C,CAAC;qBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxD,qCAAqC;oBACrC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5B,CAAC;YACF,CAAC;QACF,CAAC;QAED,2DAA2D;QAC3D,4DAA4D;QAC5D,IAAI,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrE,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC,YAAuB,CAAC;QACnD,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACjC,CAAC;IAED,OAAO;QACN,eAAe,EAAE;YAChB,OAAO;YACP,gBAAgB,EAAE,OAAO,IAAI,KAAK;YAClC,MAAM,EAAE,KAAK,EAAE,uCAAuC;YACtD,aAAa,EAAE,IAAI,EAAE,iCAAiC;SACtD;QACD,YAAY;KACZ,CAAC;AACH,CAAC"}

package/dist/parse/resolve.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @runa-cmd/core — Value resolution pipeline
+ *
+ * Merge priority: CLI args > env vars > config file > Zod defaults.
+ * Maps positionals to args by insertion order.
+ * Pre-coerces number strings before Zod .parse().
+ */
+import { type ZodType } from 'zod';
+import type { OptionMeta } from '../types.js';
+export interface ParseArgsResult {
+    values: Record<string, unknown>;
+    positionals: string[];
+}
+export interface ResolveInput {
+    /** Raw output from util.parseArgs */
+    parseArgsResult: ParseArgsResult;
+    /** Long alias map from parseargs-bridge */
+    longAliasMap?: Record<string, string>;
+    /** Command schemas */
+    schemas: {
+        args?: Record<string, ZodType>;
+        options?: Record<string, ZodType>;
+    };
+    /** Option metadata (for env var mapping) */
+    meta?: {
+        options?: Record<string, OptionMeta>;
+    };
+    /** Config file values */
+    configValues?: Record<string, unknown>;
+    /** Environment variables (defaults to process.env, injectable for testing) */
+    env?: Record<string, string | undefined>;
+}
+export interface ResolveOutput {
+    parsedArgs: Record<string, unknown>;
+    parsedOptions: Record<string, unknown>;
+}
+/**
+ * Resolve values from all sources and validate through Zod.
+ *
+ * Pipeline:
+ * 1. Map positionals to args by insertion order
+ * 2. Merge option values (CLI > env > config)
+ * 3. Pre-coerce number strings
+ * 4. Validate through Zod schemas
+ * 5. Return typed results or throw ValidationError
+ */
+export declare function resolveValues(input: ResolveInput): ResolveOutput;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/parse/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/parse/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAY,KAAK,OAAO,EAAK,MAAM,KAAK,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAM7D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC5B,qCAAqC;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,sBAAsB;IACtB,OAAO,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,4CAA4C;IAC5C,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAChD,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAkOD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAwDhE"}