@number10/ci-runner-cli 0.1.0

package/dist/internal/core/contracts/step.d.ts

@@ -0,0 +1,82 @@
+import type { ParsedStepMetrics } from './parser.js';
+/**
+ * Terminal status of a pipeline step.
+ */
+export type StepStatus = 'passed' | 'failed' | 'skipped' | 'timed_out';
+/**
+ * Failure or skip reason assigned to a step result.
+ */
+export type StepResultReason = 'command_failed' | 'command_timeout' | 'optional_step_failed';
+/**
+ * Retry behavior for a step.
+ */
+export interface StepRetryPolicy {
+    /** Maximum execution attempts including the first run. */
+    readonly maxAttempts: number;
+    /** Delay between retry attempts in milliseconds. */
+    readonly delayMs?: number;
+    /** When true, retries are also allowed after timeout failures. */
+    readonly retryOnTimeout?: boolean;
+}
+/**
+ * Immutable definition of one runnable CI step.
+ */
+export interface PipelineStep {
+    /** Stable machine identifier for programmatic usage. */
+    readonly id: string;
+    /** Human readable label used in logs and summaries. */
+    readonly name: string;
+    /** Shell command executed for this step. */
+    readonly command: string;
+    /** Optional working directory override. */
+    readonly cwd?: string;
+    /** Optional environment override merged with process env. */
+    readonly env?: Readonly<Record<string, string>>;
+    /** Optional steps become skipped when execution fails. */
+    readonly optional?: boolean;
+    /** Optional timeout in milliseconds for one attempt. */
+    readonly timeoutMs?: number;
+    /** Retry policy for transient failures. */
+    readonly retry?: StepRetryPolicy;
+}
+/**
+ * Captured process output data for one execution attempt.
+ */
+export interface StepExecutionOutput {
+    /** Exit code returned by the process, or null when unavailable. */
+    readonly exitCode: number | null;
+    /** Termination signal if process ended by signal. */
+    readonly signal: NodeJS.Signals | null;
+    /** Captured stdout content. */
+    readonly stdout: string;
+    /** Captured stderr content. */
+    readonly stderr: string;
+}
+/**
+ * Result object returned for each completed pipeline step.
+ */
+export interface StepResult {
+    /** Step identifier copied from the step definition. */
+    readonly id: string;
+    /** Step display name copied from the step definition. */
+    readonly name: string;
+    /** Final status after retries and optional handling. */
+    readonly status: StepStatus;
+    /** Final reason for non-success outcomes. */
+    readonly reason?: StepResultReason;
+    /** Number of attempts executed for this step. */
+    readonly attempts: number;
+    /** Indicates whether at least one retry happened. */
+    readonly retried: boolean;
+    /** Step start timestamp in Unix milliseconds. */
+    readonly startedAt: number;
+    /** Step finish timestamp in Unix milliseconds. */
+    readonly finishedAt: number;
+    /** Total step duration in milliseconds. */
+    readonly durationMs: number;
+    /** Captured process output from the last execution attempt. */
+    readonly output: StepExecutionOutput;
+    /** Optional structured metrics parsed from process output. */
+    readonly metrics: ParsedStepMetrics | null;
+}
+//# sourceMappingURL=step.d.ts.map

package/dist/internal/core/contracts/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/contracts/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAEtE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,sBAAsB,CAAA;AAE5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAClC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC3C"}

package/dist/internal/core/execution/nodeCommandExecutor.d.ts

@@ -0,0 +1,8 @@
+import type { CommandExecutor } from '../contracts/executor.js';
+/**
+ * Creates a Node.js shell command executor.
+ *
+ * @returns Command executor implementation.
+ */
+export declare const createNodeCommandExecutor: () => CommandExecutor;
+//# sourceMappingURL=nodeCommandExecutor.d.ts.map

package/dist/internal/core/execution/nodeCommandExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeCommandExecutor.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/execution/nodeCommandExecutor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,0BAA0B,CAAA;AAEjC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAO,eAiE5C,CAAA"}

package/dist/internal/core/index.d.ts

@@ -0,0 +1,10 @@
+export type { CommandExecutionRequest, CommandExecutionResult, CommandExecutor, } from './contracts/executor.js';
+export type { ParsedStepMetrics, StepOutputParser, StepParserResolver } from './contracts/parser.js';
+export type { PipelineReporter } from './contracts/reporter.js';
+export type { PipelineRunOptions, PipelineRunResult, PipelineSummary } from './contracts/run.js';
+export type { PipelineStep, StepExecutionOutput, StepResult, StepResultReason, StepRetryPolicy, StepStatus, } from './contracts/step.js';
+export { createNodeCommandExecutor } from './execution/nodeCommandExecutor.js';
+export { StepParserRegistry } from './parsers/parserRegistry.js';
+export { formatPipelineResultAsJson } from './reporters/jsonFormatter.js';
+export { createPipelineRunner, PipelineRunner } from './runner/pipelineRunner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,GAChB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AACpG,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAChG,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/internal/core/parsers/parserRegistry.d.ts

@@ -0,0 +1,29 @@
+import type { ParsedStepMetrics, StepOutputParser, StepParserResolver } from '../contracts/parser.js';
+import type { PipelineStep, StepExecutionOutput } from '../contracts/step.js';
+/**
+ * In-memory parser registry with ordered fallback resolution.
+ */
+export declare class StepParserRegistry implements StepParserResolver {
+    private readonly parsers;
+    /**
+     * Creates a parser registry.
+     *
+     * @param parsers Initial parser list.
+     */
+    constructor(parsers?: readonly StepOutputParser[]);
+    /**
+     * Adds a parser to the registry.
+     *
+     * @param parser Parser instance.
+     */
+    register(parser: StepOutputParser): void;
+    /**
+     * Parses output using the first matching parser that returns a metric.
+     *
+     * @param step Step definition.
+     * @param output Step output payload.
+     * @returns Parsed metric or null.
+     */
+    parse(step: PipelineStep, output: StepExecutionOutput): ParsedStepMetrics | null;
+}
+//# sourceMappingURL=parserRegistry.d.ts.map

package/dist/internal/core/parsers/parserRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parserRegistry.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/parsers/parserRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE7E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C;;;;OAIG;gBACgB,OAAO,GAAE,SAAS,gBAAgB,EAAO;IAI5D;;;;OAIG;IACI,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAI/C;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,IAAI;CAcxF"}

package/dist/internal/core/reporters/jsonFormatter.d.ts

@@ -0,0 +1,10 @@
+import type { PipelineRunResult } from '../contracts/run.js';
+/**
+ * Formats pipeline result data as JSON output.
+ *
+ * @param result Pipeline run result.
+ * @param indentation Number of spaces used for indentation.
+ * @returns JSON representation.
+ */
+export declare const formatPipelineResultAsJson: (result: PipelineRunResult, indentation?: number) => string;
+//# sourceMappingURL=jsonFormatter.d.ts.map

package/dist/internal/core/reporters/jsonFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFormatter.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/reporters/jsonFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,iBAAiB,EAAE,oBAAe,KAAG,MAEvF,CAAA"}

package/dist/internal/core/runner/pipelineRunner.d.ts

@@ -0,0 +1,34 @@
+import type { PipelineRunOptions, PipelineRunResult } from '../contracts/run.js';
+/**
+ * Pipeline execution engine for sequential CI step orchestration.
+ */
+export declare class PipelineRunner {
+    private readonly options;
+    /**
+     * Creates a pipeline runner.
+     *
+     * @param options Runtime options.
+     */
+    constructor(options: PipelineRunOptions);
+    /**
+     * Executes all configured pipeline steps.
+     *
+     * @returns Final pipeline result.
+     */
+    run(): Promise<PipelineRunResult>;
+    private executeStep;
+    private buildFailedResult;
+    private buildStepResult;
+    private emitPipelineStart;
+    private emitStepStart;
+    private emitStepComplete;
+    private emitPipelineComplete;
+}
+/**
+ * Creates a pipeline runner instance.
+ *
+ * @param options Runtime options.
+ * @returns Pipeline runner.
+ */
+export declare const createPipelineRunner: (options: PipelineRunOptions) => PipelineRunner;
+//# sourceMappingURL=pipelineRunner.d.ts.map

package/dist/internal/core/runner/pipelineRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineRunner.d.ts","sourceRoot":"","sources":["../../../../src/internal/core/runner/pipelineRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAA;AAGjG;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGuC;IAE/D;;;;OAIG;gBACgB,OAAO,EAAE,kBAAkB;IAe9C;;;;OAIG;IACU,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;YAqChC,WAAW;IA6DzB,OAAO,CAAC,iBAAiB;IAsCzB,OAAO,CAAC,eAAe;YA+BT,iBAAiB;YAOjB,aAAa;YAOb,gBAAgB;YAOhB,oBAAoB;CAMnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,kBAAkB,KAAG,cAElE,CAAA"}

package/dist/parsers/defaultStepParsers.d.ts

@@ -0,0 +1,8 @@
+import type { StepOutputParser } from '../internal/core/index.js';
+/**
+ * Creates default parsers for common test outputs.
+ *
+ * @returns Parser list.
+ */
+export declare const createDefaultStepParsers: () => readonly StepOutputParser[];
+//# sourceMappingURL=defaultStepParsers.d.ts.map

package/dist/parsers/defaultStepParsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStepParsers.d.ts","sourceRoot":"","sources":["../../src/parsers/defaultStepParsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEpF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAO,SAAS,gBAAgB,EAmFpE,CAAA"}

package/dist/reporters/prettyReporter.d.ts

@@ -0,0 +1,46 @@
+import type { PipelineReporter, PipelineRunResult, PipelineStep, StepResult } from '../internal/core/index.js';
+/**
+ * Options for the pretty console reporter.
+ */
+export interface PrettyReporterOptions {
+    /** Emits stdout/stderr also for successful steps. */
+    readonly verbose: boolean;
+}
+/**
+ * Compact console reporter with failure-focused detail output.
+ */
+export declare class PrettyReporter implements PipelineReporter {
+    private readonly options;
+    /**
+     * Creates a pretty reporter.
+     *
+     * @param options Reporter options.
+     */
+    constructor(options: PrettyReporterOptions);
+    /**
+     * Handles pipeline start.
+     *
+     * @param steps Pipeline steps.
+     */
+    onPipelineStart(steps: readonly PipelineStep[]): void;
+    /**
+     * Handles step start.
+     *
+     * @param step Current step.
+     */
+    onStepStart(step: PipelineStep): void;
+    /**
+     * Handles step completion.
+     *
+     * @param result Step result.
+     */
+    onStepComplete(result: StepResult): void;
+    /**
+     * Handles pipeline completion.
+     *
+     * @param result Pipeline result.
+     */
+    onPipelineComplete(result: PipelineRunResult): void;
+    private printOutput;
+}
+//# sourceMappingURL=prettyReporter.d.ts.map

package/dist/reporters/prettyReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettyReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/prettyReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACX,MAAM,2BAA2B,CAAA;AAElC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C;;;;OAIG;gBACgB,OAAO,EAAE,qBAAqB;IAIjD;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAI5D;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI5C;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA2C/C;;;;OAIG;IACI,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAe1D,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/runPipeline.d.ts

@@ -0,0 +1,26 @@
+import type { CliOutputFormat } from './config/types.js';
+/**
+ * Runtime options for a CLI execution.
+ */
+export interface RunCliPipelineOptions {
+    /** Base working directory. */
+    readonly cwd: string;
+    /** Optional explicit config path. */
+    readonly configPath?: string;
+    /** Output format selection. */
+    readonly format: CliOutputFormat;
+    /** Verbose output mode. */
+    readonly verbose: boolean;
+    /** Enables fail-fast behavior. */
+    readonly failFast: boolean;
+    /** Enables watch mode. */
+    readonly watch: boolean;
+}
+/**
+ * Executes the pipeline according to CLI options.
+ *
+ * @param options CLI runtime options.
+ * @returns Final exit code.
+ */
+export declare const runCliPipeline: (options: RunCliPipelineOptions) => Promise<number>;
+//# sourceMappingURL=runPipeline.d.ts.map

package/dist/runPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPipeline.d.ts","sourceRoot":"","sources":["../src/runPipeline.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIxD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,qBAAqB,KAAG,OAAO,CAAC,MAAM,CA8BnF,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@number10/ci-runner-cli",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "CLI runner package for ci-runner.",
+  "bin": {
+    "ci-runner": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    },
+    "./types": {
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20.19.0",
+    "pnpm": ">=10.28.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "vite build --config vite.config.ts && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "test": "vitest run --config vitest.config.ts"
+  }
+}