@runa-cmd/core 0.2.0-beta.5 → 0.2.0-beta.7

package/dist/trace.d.ts

@@ -5,28 +5,52 @@
  * RUNA_DEBUG=1 prints it while it happens.
  */
 import type { HookName } from './types.js';
+/**
+ * Where a value came from: the terminal, env, the config file, its default, or
+ * the input of a tool call through MCP.
+ */
 export type ValueSource = 'cli' | 'env' | 'config' | 'default' | 'input';
+/**
+ * One thing a run did: the config file it read, where an option came from, a
+ * hook and how long it took, the command, or something written. Its shape isn't
+ * part of the versioning contract.
+ */
 export type TraceEvent = {
+    /** The config file was looked for */
     step: 'config';
+    /** The file it read, if it found one */
     file?: string;
 } | {
+    /** An option got its value */
     step: 'option';
+    /** Its key */
     name: string;
+    /** Whether it's a global option or the command's own */
     scope: 'global' | 'command';
+    /** Where the value came from */
     source: ValueSource;
     /** Left out when it comes from env: it can be a secret */
     value?: unknown;
 } | {
+    /** A hook ran, if it had handlers */
     step: 'hook';
+    /** Which one */
     name: HookName;
+    /** How long its handlers took */
     ms: number;
 } | {
+    /** The command ran */
     step: 'run';
+    /** Its whole path */
     command: string[];
+    /** How long it took, with its middleware */
     ms: number;
 } | {
+    /** Something was written */
     step: 'output';
+    /** Where */
     stream: 'stdout' | 'stderr';
+    /** What */
     text: string;
 };
 /** One line per event. Never a value: this output ends up in CI logs. */

package/dist/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzE,MAAM,MAAM,UAAU,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACf,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAa/D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAC3B,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,UAAU,EAAE,CAMd"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GACnB;IACA,qCAAqC;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACb,GACD;IACA,8BAA8B;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,gCAAgC;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACf,GACD;IACA,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;CACV,GACD;IACA,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;CACV,GACD;IACA,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY;IACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACZ,CAAC;AAEL,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAa/D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAC3B,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,UAAU,EAAE,CAMd"}

package/dist/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAwBA,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,KAAiB;IAC1C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACZ,OAAO,gBAAgB,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QACpD,KAAK,QAAQ;YACZ,OAAO,gBAAgB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QACvD,KAAK,MAAM;YACV,OAAO,cAAc,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC;QACjD,KAAK,KAAK;YACT,OAAO,aAAa,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC;QAC7D;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAC3B,KAA2B,EAC3B,KAAe,EACf,MAA+B,EAC/B,OAAoC;IAEpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,QAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC/D,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AA+DA,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,KAAiB;IAC1C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACZ,OAAO,gBAAgB,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QACpD,KAAK,QAAQ;YACZ,OAAO,gBAAgB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QACvD,KAAK,MAAM;YACV,OAAO,cAAc,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC;QACjD,KAAK,KAAK;YACT,OAAO,aAAa,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC;QAC7D;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAC3B,KAA2B,EAC3B,KAAe,EACf,MAA+B,EAC/B,OAAoC;IAEpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,QAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC/D,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -5,6 +5,10 @@
  * This is a type-only module — no runtime code.
  */
 import type { ZodType, z } from 'zod';
+/**
+ * What an option needs besides its schema: aliases, env, help and config.
+ * It goes in `meta.options`, by the option's key, so the Zod schema stays pure.
+ */
 export interface OptionMeta {
     /** CLI aliases, e.g. ['-e', '--environment'] */
     alias?: string[];
@@ -26,26 +30,38 @@ export interface OptionMeta {
 }
 /** A command as it reaches run() and hooks: by then, it always has its name. */
 export type NamedCommandMeta<TOptions extends Record<string, ZodType> = Record<string, ZodType>> = CommandMeta<TOptions> & {
+    /** The command's own name: the last part of its path */
     name: string;
     /** The whole path, e.g. ['tag', 'add']: `name` alone can't tell it from `add` */
     path: string[];
 };
+/** What a command says about itself: its name, description and option metadata. */
 export interface CommandMeta<TOptions extends Record<string, ZodType> = Record<string, ZodType>> {
     /**
      * The name of a CLI of one command, which runCLI requires. In defineCLI, the
      * key names the command: this is optional there, and has to match it.
      */
     name?: string;
+    /** One line, shown in help and read by a model as the tool's description */
     description: string;
+    /**
+     * Printed by `--version` when the command is the CLI, as with runCLI(). In a
+     * command of defineCLI it would do nothing, so it stops the CLI at startup:
+     * the version goes in defineCLI's meta.
+     */
     version?: string;
     /** Option metadata — keys MUST be a subset of TOptions keys */
     options?: {
         [K in keyof TOptions]?: OptionMeta;
     };
 }
+/** What a CLI says about itself. */
 export interface CLIMeta {
+    /** The program name, as people type it. It names the CLI in help and in its config file */
     name: string;
+    /** Printed by `--version` */
     version?: string;
+    /** One line, shown at the top of the help */
     description?: string;
 }
 /** Infer args types from a record of Zod schemas */
@@ -58,10 +74,15 @@ export type InferOptions<T extends Record<string, ZodType>> = {
 };
 /** What the run() handler receives */
 export interface RunContext<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>> {
+    /** The positional arguments, validated and typed by their schemas */
     args: InferArgs<TArgs>;
+    /** The options, from the terminal, env, the config file or their defaults, validated and typed */
     options: InferOptions<TOptions>;
+    /** The CLI's global options, untyped: the command doesn't declare them */
     globalOptions: Record<string, unknown>;
+    /** The command that runs, with its whole path */
     command: NamedCommandMeta<TOptions>;
+    /** The arguments of the process, as given, global options and what follows `--` included */
     rawArgs: string[];
     /** What's left after `--`, verbatim and unvalidated, if the command declares `rest: true`. Else `[]` */
     rest: string[];
@@ -77,13 +98,19 @@ export type RunReturn<TOutput, TResult = void> = TOutput extends ZodType ? z.inf
 export type FormatContext<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>> = Pick<RunContext<TArgs, TOptions>, 'args' | 'options'>;
 /** What format() receives: the data, once it's no longer a promise. */
 export type RunResult<TOutput, TResult> = TOutput extends ZodType ? z.infer<TOutput> : TResult;
+/** What defineCommand() takes. */
 export interface CommandConfig<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>, TOutput extends ZodType | undefined = undefined, TResult = void> {
+    /** Its name, description and option metadata */
     meta: CommandMeta<TOptions>;
+    /** Positional arguments, in the order of their keys. Only the last one can be a z.array() */
     args?: TArgs;
+    /** Named options. A key in camelCase is a flag in kebab-case: `darkColor` is `--dark-color` */
     options?: TOptions;
+    /** The schema of what run() returns. It's checked, and an MCP tool gets it as structured data */
     output?: TOutput;
     /** Take what's left after `--` in `ctx.rest`. Without it, that's a usage error */
     rest?: boolean;
+    /** What the command does. Return the data, and Runa shows it */
     run: (ctx: RunContext<TArgs, TOptions>) => RunReturn<TOutput, TResult>;
     /**
      * What a person reads at the terminal, from what run() returned. A tool gets
@@ -94,20 +121,35 @@ export interface CommandConfig<TArgs extends Record<string, ZodType> = Record<st
     /** False if this is only for people at a terminal: an MCP server won't offer it */
     tool?: boolean;
 }
+/** A command, as defineCommand() returns it. Its fields are those of CommandConfig. */
 export interface Command {
+    /** Marks the object as a command */
     readonly _type: 'runa:command';
+    /** See CommandConfig.meta */
     readonly meta: CommandMeta;
+    /** See CommandConfig.args */
     readonly args?: Record<string, ZodType>;
+    /** See CommandConfig.options */
     readonly options?: Record<string, ZodType>;
+    /** See CommandConfig.output */
     readonly output?: ZodType;
+    /** See CommandConfig.rest */
     readonly rest?: boolean;
+    /** See CommandConfig.run */
     readonly run: (ctx: RunContext) => unknown;
+    /** See CommandConfig.format */
     readonly format?: (result: unknown, context: FormatContext) => string;
+    /** See CommandConfig.tool */
     readonly tool?: boolean;
 }
+/**
+ * The commands of a CLI, by name. A nested object is a group:
+ * `{ config: { get, set } }` gives `tool config get` and `tool config set`.
+ */
 export interface CommandTree {
     [key: string]: Command | CommandTree;
 }
+/** Where and how a CLI finds its config file. */
 export interface CLIConfigOptions {
     /** Config file base name, e.g. 'mycli' → looks for mycli.config.* */
     name: string;
@@ -116,16 +158,26 @@ export interface CLIConfigOptions {
     /** Directories to search for config files. Default: ['.', '~'] */
     searchPaths?: string[];
 }
+/** What defineCLI() takes. */
 export interface CLIConfig {
+    /** Its name, version and description */
     meta: CLIMeta;
+    /** The commands, by the name people type */
     commands: CommandTree;
+    /** Plugins, or functions that import one, which load when the CLI starts */
     plugins?: Array<PluginConfig | (() => Promise<{
+        /** The plugin, as the module's default export */
         default: PluginConfig;
     }>)>;
+    /** Middleware around every command. The first one is the outermost */
     middleware?: Middleware[];
+    /** Read a config file. Without it, the CLI reads none */
     config?: CLIConfigOptions;
+    /** Options every command takes, read in `ctx.globalOptions` */
     globalOptions?: Record<string, ZodType>;
+    /** Metadata of the global options, by key, as `meta.options` for a command */
     globalMeta?: {
+        /** Aliases, env, help and config of each global option, by its key */
         options?: Record<string, OptionMeta>;
     };
     /**
@@ -140,37 +192,72 @@ export interface RunCLIOptions extends Omit<CLIConfig, 'meta' | 'commands'> {
     /** Arguments to parse. Default: process.argv.slice(2) */
     argv?: string[];
 }
+/** A CLI, as defineCLI() returns it. */
 export interface CLI {
+    /** Marks the object as a CLI */
     readonly _type: 'runa:cli';
+    /** What it was defined with */
     readonly config: CLIConfig;
+    /**
+     * Run it, and end the process with its exit code. It's the entry point of a
+     * process: call it once, from main.ts. To run it in a test, use testCLI().
+     *
+     * @param argv - Default: process.argv.slice(2)
+     */
     run(argv?: string[]): Promise<void>;
 }
+/** What a plugin says about itself. */
 export interface PluginMeta {
+    /** Unique among the plugins of a CLI, and what errors and `dependencies` name it by */
     name: string;
     /** Informative only: Runa does not read it. Compatibility belongs in peerDependencies */
     version?: string;
+    /** One line about what it does */
     description?: string;
     /** Names of other plugins this depends on */
     dependencies?: string[];
 }
+/**
+ * What a plugin adds to the CLI, declared up front. Using a method without its
+ * capability stops the CLI at startup, naming the plugin.
+ */
 export interface PluginCapabilities {
+    /** Allows `api.addCommand()` */
     addCommands?: boolean;
+    /** Allows `api.addGlobalOption()` */
     addGlobalOptions?: boolean;
+    /** Allows `api.addMiddleware()` */
     addMiddleware?: boolean;
+    /** Allows `api.replaceHelp()` */
     replaceHelp?: boolean;
 }
+/** A plugin, as definePlugin() takes it. */
 export interface PluginConfig {
+    /** Its name and what it depends on */
     meta: PluginMeta;
+    /** What it adds to the CLI */
     capabilities?: PluginCapabilities;
+    /** Extends the CLI when it starts: add options and commands, and register hooks */
     setup: (api: PluginAPI) => void | Promise<void>;
+    /**
+     * Releases what setup() opened. It runs after the `cleanup` hook, and also
+     * when the CLI fails to start
+     */
     cleanup?: () => void | Promise<void>;
 }
+/** What a plugin's setup() receives to extend the CLI. */
 export interface PluginAPI {
+    /** Add a command at the root. Needs the `addCommands` capability */
     addCommand(name: string, command: Command): void;
+    /** Add an option every command takes. Needs the `addGlobalOptions` capability */
     addGlobalOption(name: string, schema: ZodType, meta?: OptionMeta): void;
+    /** Add a middleware around every command. Needs the `addMiddleware` capability */
     addMiddleware(middleware: Middleware): void;
+    /** Run a handler at a step of every run */
     hook(name: HookName, handler: HookHandler): void;
+    /** The CLI as help and MCP describe it: commands, args and options */
     getSchema(): CLISchema;
+    /** The command tree, as it is now: what other plugins added included */
     getCommands(): CommandTree;
     /** The config file of the CLI, if it has one. With a path, only that command's values */
     getConfigValues(commandPath?: string[]): Promise<Record<string, unknown> | undefined>;
@@ -184,114 +271,191 @@ export type HelpTarget = CLISchema | CommandSchema;
  * stdout if the person asked for it, stderr if there was nothing to run.
  */
 export type HelpHandler = (target: HelpTarget, output: NodeJS.WritableStream) => void | Promise<void>;
+/** The steps of a run a plugin can hook into, in the order they happen. */
 export declare const HOOK_NAMES: {
+    /** First of all, before anything is parsed: a handler may rewrite `ctx.rawArgs` */
     readonly BEFORE_PARSE: 'beforeParse';
+    /** The global options are read. Help and `--mcp` stop the run here */
     readonly ON_GLOBAL_FLAGS: 'onGlobalFlags';
+    /** The command and its values are known */
     readonly AFTER_PARSE: 'afterParse';
+    /** Right before the middleware and the command */
     readonly BEFORE_RUN: 'beforeRun';
+    /** The command ended well. It doesn't run after a failure */
     readonly AFTER_RUN: 'afterRun';
+    /** Something failed: `ctx.error` says what. Set `ctx.handled` to print nothing */
     readonly ON_ERROR: 'onError';
+    /** Last, always: after an error and after Ctrl+C too */
     readonly CLEANUP: 'cleanup';
 };
+/** The name of a hook: one of the values of HOOK_NAMES. */
 export type HookName = (typeof HOOK_NAMES)[keyof typeof HOOK_NAMES];
 /** Where a run comes from: a person or script at the CLI, or a tool call. */
 export type Invocation = {
+    /** A person or a script ran the CLI */
     surface: 'cli';
 } | {
+    /** A model called it as a tool through MCP: what it writes reaches the model */
     surface: 'tool';
+    /** The name of the tool that was called */
     tool: string;
 };
+/** What a hook handler receives. What it has grows as the run goes on. */
 export interface HookContext {
+    /** The CLI's name, version and description */
     cli: CLIMeta;
+    /** A person or script at the CLI, or a tool call through MCP */
     invocation: Invocation;
+    /**
+     * In beforeParse, the whole argv, which a handler may rewrite before it's
+     * parsed. From onGlobalFlags on, only the command's part: without the global
+     * options, and without what follows `--`. run() gets the original as it was.
+     */
     rawArgs: string[];
     /** Aborted when the run must stop */
     signal: AbortSignal;
+    /** The global options, from onGlobalFlags on */
     globalOptions?: Record<string, unknown>;
+    /** The command that runs, from afterParse on */
     command?: NamedCommandMeta;
+    /** Its positional arguments, from afterParse on */
     args?: Record<string, unknown>;
+    /** Its options, from afterParse on */
     options?: Record<string, unknown>;
+    /** What failed, in onError and in cleanup after a failure */
     error?: Error;
     /** Call this in onGlobalFlags to short-circuit the lifecycle */
     shortCircuit?: () => void;
     /** Set this in onError to prevent default error output */
     handled?: boolean;
 }
+/** A hook handler. It can be async, and the run waits for it. */
 export type HookHandler = (ctx: HookContext) => void | Promise<void>;
+/** What a middleware receives. */
 export interface MiddlewareContext {
+    /** Run the command, and the middleware after this one. Always `await` it, or throw to stop */
     next: () => Promise<void>;
+    /** The CLI's global options. A middleware doesn't see the command's own */
     globalOptions: Record<string, unknown>;
     /** The command that runs, with its whole path */
     command: NamedCommandMeta;
 }
+/** The function a middleware runs. */
 export type MiddlewareFn = (ctx: MiddlewareContext) => Promise<void>;
+/** A middleware, as defineMiddleware() returns it. */
 export interface Middleware {
+    /** Marks the object as a middleware */
     readonly _type: 'runa:middleware';
+    /** What it runs around a command */
     readonly handler: MiddlewareFn;
 }
+/** Reads config files of another format than JSON, which Runa reads by itself. */
 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>;
 }
+/** A CLI described as data, as help and MCP read it. */
 export interface CLISchema {
+    /** The CLI's name, version and description */
     meta: CLIMeta;
+    /** Its commands, groups included */
     commands: CommandSchema[];
+    /** The options every command takes */
     globalOptions: OptionSchema[];
     /** Name of the command that runs without a subcommand: set by runCLI() */
     root?: string;
 }
+/** A command, or a group of commands, described as data. */
 export interface CommandSchema {
+    /** Its own name */
     name: string;
+    /** One line about what it does */
     description: string;
     /** Full command path, e.g. ['config', 'set'] for nested commands */
     fullPath: string[];
     /** What a person types to run it, with the CLI, e.g. ['tool', 'config', 'set']. Set for help */
     commandLine?: string[];
+    /** Its positional arguments, in order */
     args: ArgSchema[];
+    /** Its options */
     options: OptionSchema[];
+    /** Whether it declares an `output` schema */
     hasOutput: boolean;
+    /** The commands of a group */
     subcommands?: CommandSchema[];
 }
+/** A positional argument, described as data. */
 export interface ArgSchema {
+    /** Its key in `args` */
     name: string;
+    /** From its `.describe()` */
     description?: string;
+    /** Its base type */
     type: ParamType;
+    /** False if it has `.optional()` or `.default()` */
     required: boolean;
+    /** From its `.default()` */
     defaultValue?: unknown;
+    /** Whether it takes the rest of the values, as a z.array() does */
     isVariadic: boolean;
+    /** The values a z.enum() allows */
     enumValues?: string[];
 }
+/** An option, described as data. */
 export interface OptionSchema {
     /** The key in code, in config files and in MCP tools */
     name: string;
     /** The long flag, without dashes: what a person types */
     flag: string;
+    /** From its `.describe()` */
     description?: string;
     /** `array` means the option repeats, with `itemType` values */
     type: ParamType;
+    /** The type of each value of an option that repeats */
     itemType?: ParamType;
     /** What help calls the value, if the author named it */
     valueName?: string;
+    /** False if it has `.optional()` or `.default()` */
     required: boolean;
+    /** From its `.default()` */
     defaultValue?: unknown;
     /** What help shows instead of `defaultValue`, if the author wrote it */
     defaultDescription?: string;
+    /** See OptionMeta.alias */
     alias?: string[];
+    /** See OptionMeta.env */
     env?: string;
+    /** See OptionMeta.group */
     group?: string;
+    /** See OptionMeta.deprecated */
     deprecated?: string;
+    /** The values a z.enum() allows */
     enumValues?: string[];
+    /**
+     * A global option, in the help of a command: it works there, but isn't the
+     * command's own, so help lists it under GLOBAL OPTIONS. Not set when the
+     * command is the CLI, as with runCLI()
+     */
+    inherited?: boolean;
 }
+/** The base types Runa reads from a Zod schema. */
 export declare const PARAM_TYPES: {
+    /** z.string(), and any type Runa doesn't read otherwise */
     readonly STRING: 'string';
+    /** z.number(), z.int() included */
     readonly NUMBER: 'number';
+    /** z.boolean(): a flag, with its `--no-` */
     readonly BOOLEAN: 'boolean';
+    /** z.enum(): one of a fixed set of values */
     readonly ENUM: 'enum';
+    /** z.array(): an option that repeats, or the last positional */
     readonly ARRAY: 'array';
 };
+/** A base type: one of the values of PARAM_TYPES. */
 export type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];
+/** What Runa reads from the schema of one arg or option. */
 export interface ParamMetadata {
     /** Key name from the schema record */
     name: string;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,19 +1,33 @@
 // ─── Lifecycle Hooks ────────────────────────────────────────
+/** The steps of a run a plugin can hook into, in the order they happen. */
 export const HOOK_NAMES = {
+    /** First of all, before anything is parsed: a handler may rewrite `ctx.rawArgs` */
     BEFORE_PARSE: 'beforeParse',
+    /** The global options are read. Help and `--mcp` stop the run here */
     ON_GLOBAL_FLAGS: 'onGlobalFlags',
+    /** The command and its values are known */
     AFTER_PARSE: 'afterParse',
+    /** Right before the middleware and the command */
     BEFORE_RUN: 'beforeRun',
+    /** The command ended well. It doesn't run after a failure */
     AFTER_RUN: 'afterRun',
+    /** Something failed: `ctx.error` says what. Set `ctx.handled` to print nothing */
     ON_ERROR: 'onError',
+    /** Last, always: after an error and after Ctrl+C too */
     CLEANUP: 'cleanup',
 };
 // ─── Schema Walker Output ───────────────────────────────────
+/** The base types Runa reads from a Zod schema. */
 export const PARAM_TYPES = {
+    /** z.string(), and any type Runa doesn't read otherwise */
     STRING: 'string',
+    /** z.number(), z.int() included */
     NUMBER: 'number',
+    /** z.boolean(): a flag, with its `--no-` */
     BOOLEAN: 'boolean',
+    /** z.enum(): one of a fixed set of values */
     ENUM: 'enum',
+    /** z.array(): an option that repeats, or the last positional */
     ARRAY: 'array',
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqPA,+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;AA0GX,+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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmVA,+DAA+D;AAE/D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,mFAAmF;IACnF,YAAY,EAAE,aAAa;IAC3B,sEAAsE;IACtE,eAAe,EAAE,eAAe;IAChC,2CAA2C;IAC3C,WAAW,EAAE,YAAY;IACzB,kDAAkD;IAClD,UAAU,EAAE,WAAW;IACvB,6DAA6D;IAC7D,SAAS,EAAE,UAAU;IACrB,kFAAkF;IAClF,QAAQ,EAAE,SAAS;IACnB,wDAAwD;IACxD,OAAO,EAAE,SAAS;CACT,CAAC;AA8KX,+DAA+D;AAE/D,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,2DAA2D;IAC3D,MAAM,EAAE,QAAQ;IAChB,mCAAmC;IACnC,MAAM,EAAE,QAAQ;IAChB,4CAA4C;IAC5C,OAAO,EAAE,SAAS;IAClB,6CAA6C;IAC7C,IAAI,EAAE,MAAM;IACZ,gEAAgE;IAChE,KAAK,EAAE,OAAO;CACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runa-cmd/core",
-  "version": "0.2.0-beta.5",
+  "version": "0.2.0-beta.7",
   "description": "Schema-driven, TypeScript-first CLI engine — commands, parsing, plugins, middleware. Zero runtime deps.",
   "license": "MIT",
   "type": "module",
@@ -65,7 +65,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch --preserveWatchOutput",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "biome check .",