@invarn/cibuild 1.3.16 → 1.3.17

package/dist/src/envman/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Type definitions for the CI Build Environment Variable Manager (envman)
+ */
+/**
+ * A single environment variable entry in the store
+ */
+export interface EnvEntry {
+    key: string;
+    value: string;
+    sensitive?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * The environment variable store structure
+ */
+export interface EnvStore {
+    version: string;
+    envs: EnvEntry[];
+}
+/**
+ * Options for adding an environment variable
+ */
+export interface AddOptions {
+    key: string;
+    value?: string;
+    valueFile?: string;
+    sensitive?: boolean;
+    skipIfEmpty?: boolean;
+    append?: boolean;
+}
+/**
+ * Options for running a command with environment variables
+ */
+export interface RunOptions {
+    command: string[];
+    expandEnvs?: boolean;
+}
+/**
+ * Result of an envman operation
+ */
+export interface EnvmanResult {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+/**
+ * Default store file name
+ */
+export declare const DEFAULT_STORE_FILE = ".envstore.json";
+/**
+ * Current store version
+ */
+export declare const STORE_VERSION = "1.0.0";
+//# sourceMappingURL=types.d.ts.map

package/dist/src/envman/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/envman/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC"}

package/dist/src/envman/types.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for the CI Build Environment Variable Manager (envman)
+ */
+/**
+ * Default store file name
+ */
+export const DEFAULT_STORE_FILE = '.envstore.json';
+/**
+ * Current store version
+ */
+export const STORE_VERSION = '1.0.0';
+//# sourceMappingURL=types.js.map

package/dist/src/lib.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @invarn/cibuild library API
+ *
+ * Programmatic access to cibuild pipeline parsing, conversion, and execution.
+ * This is the non-interactive library surface — no prompts, no TTY dependencies.
+ *
+ * Usage:
+ *   import {
+ *     loadYAMLPipeline,
+ *     convertYAMLToPipelineDef,
+ *     PipelineRunner,
+ *     loadConfig,
+ *   } from '@invarn/cibuild/lib';
+ */
+import './yaml/steps/index.js';
+export { PipelineRunner, StepExecutionError } from './runner.js';
+export { loadConfig } from './config.js';
+export { loadYAMLPipeline, getWorkflowNames, hasWorkflow, YAMLParseError, YAMLValidationError, } from './yaml/parser.js';
+export { convertYAMLToPipelineDef, getAvailableWorkflows, YAMLConversionError, } from './yaml/converter.js';
+export type { ConversionResult } from './yaml/converter.js';
+export { pipeline } from './pipeline.js';
+export { getStepExecutor, hasStep, getAvailableSteps, registerStep, getStepMetadata, } from './yaml/steps/registry.js';
+export type { StepDef, PipelineDef, CIConfig, PipelineFactory, PipelineContext, StepBuilders, } from './types.js';
+export type { StepExecutor, StepMetadata, StepPlatform, StepExecutionContext, } from './yaml/steps/base.js';
+export type { YAMLPipeline, YAMLWorkflow, YAMLStep, YAMLStepInputs, YAMLEnvVar, YAMLApp, YAMLMeta, ParsedStep, PlatformInfo, Platform, MachineType, } from './yaml/types.js';
+export { MissingEnvironmentVariableError } from './yaml/env-resolver.js';
+//# sourceMappingURL=lib.d.ts.map

package/dist/src/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,uBAAuB,CAAC;AAI/B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EACL,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAI9B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/lib.js

@@ -0,0 +1,32 @@
+/**
+ * @invarn/cibuild library API
+ *
+ * Programmatic access to cibuild pipeline parsing, conversion, and execution.
+ * This is the non-interactive library surface — no prompts, no TTY dependencies.
+ *
+ * Usage:
+ *   import {
+ *     loadYAMLPipeline,
+ *     convertYAMLToPipelineDef,
+ *     PipelineRunner,
+ *     loadConfig,
+ *   } from '@invarn/cibuild/lib';
+ */
+// Side-effect: initialize the step registry (registers all step executors).
+// Must run before any convertYAMLToPipelineDef call.
+import './yaml/steps/index.js';
+// ─── Runner ─────────────────────────────────────────────────────────────
+export { PipelineRunner, StepExecutionError } from './runner.js';
+// ─── Config ─────────────────────────────────────────────────────────────
+export { loadConfig } from './config.js';
+// ─── YAML parser ────────────────────────────────────────────────────────
+export { loadYAMLPipeline, getWorkflowNames, hasWorkflow, YAMLParseError, YAMLValidationError, } from './yaml/parser.js';
+// ─── YAML converter (non-interactive) ───────────────────────────────────
+export { convertYAMLToPipelineDef, getAvailableWorkflows, YAMLConversionError, } from './yaml/converter.js';
+// ─── Pipeline DSL factory ───────────────────────────────────────────────
+export { pipeline } from './pipeline.js';
+// ─── Step registry ──────────────────────────────────────────────────────
+export { getStepExecutor, hasStep, getAvailableSteps, registerStep, getStepMetadata, } from './yaml/steps/registry.js';
+// ─── Error types ────────────────────────────────────────────────────────
+export { MissingEnvironmentVariableError } from './yaml/env-resolver.js';
+//# sourceMappingURL=lib.js.map

package/dist/src/pipeline.d.ts

@@ -0,0 +1,3 @@
+import type { PipelineFactory } from "./types.js";
+export declare const pipeline: PipelineFactory;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/src/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8C,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9F,eAAO,MAAM,QAAQ,EAAE,eAmEtB,CAAC"}

package/dist/src/pipeline.js

@@ -0,0 +1,57 @@
+export const pipeline = (name, builder) => {
+    const def = {
+        name,
+        artifacts: [],
+        steps: [],
+        stepsOrder: [],
+    };
+    const stepBuilders = {
+        script(name, options) {
+            def.steps.push({
+                id: options.id,
+                name,
+                kind: "script",
+                shell: options.shell,
+                script: options.script,
+            });
+        },
+        python(name, options) {
+            def.steps.push({
+                id: options.id,
+                name,
+                kind: "python",
+                script: options.script,
+            });
+        },
+        ruby(name, options) {
+            def.steps.push({
+                id: options.id,
+                name,
+                kind: "ruby",
+                script: options.script,
+            });
+        },
+        node(name, options) {
+            def.steps.push({
+                id: options.id,
+                name,
+                kind: "node",
+                script: options.script,
+            });
+        },
+    };
+    const pipelineContext = {
+        artifacts(paths) {
+            def.artifacts = paths;
+        },
+        steps(builder) {
+            builder(stepBuilders);
+        },
+        stepsOrder(ids) {
+            def.stepsOrder = ids;
+        },
+    };
+    builder(pipelineContext);
+    return def;
+};
+//# sourceMappingURL=pipeline.js.map

package/dist/src/runner.d.ts

@@ -0,0 +1,17 @@
+import type { StepDef, PipelineDef, CIConfig } from "./types.js";
+export declare class StepExecutionError extends Error {
+    stepId: string;
+    stepName: string;
+    exitCode: number;
+    constructor(stepId: string, stepName: string, exitCode: number);
+}
+export declare class PipelineRunner {
+    private config;
+    constructor(config: CIConfig);
+    runStep(step: StepDef): Promise<void>;
+    private formatDuration;
+    validatePipeline(pipeline: PipelineDef): void;
+    displayWarnings(warnings: string[], skippedSteps: number): void;
+    runPipeline(pipeline: PipelineDef, warnings?: string[], skippedSteps?: number): Promise<void>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,kBAAmB,SAAQ,KAAK;IAElC,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;gBAFhB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAK1B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAE9B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsI3C,OAAO,CAAC,cAAc;IAYtB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAwB7C,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAczD,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0CpG"}

package/dist/src/runner.js

@@ -0,0 +1,234 @@
+import { spawn } from "node:child_process";
+import { dirname, join, resolve } from "node:path";
+import { unlinkSync, existsSync, writeFileSync, chmodSync, mkdtempSync, rmSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+// Use absolute path for envstore so it works regardless of cd in scripts
+const ENVMAN_ENVSTORE_PATH = resolve(process.cwd(), ".ci", ".envstore.json");
+export class StepExecutionError extends Error {
+    stepId;
+    stepName;
+    exitCode;
+    constructor(stepId, stepName, exitCode) {
+        super(`Step "${stepName}" failed with exit code ${exitCode}`);
+        this.stepId = stepId;
+        this.stepName = stepName;
+        this.exitCode = exitCode;
+        this.name = "StepExecutionError";
+    }
+}
+export class PipelineRunner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async runStep(step) {
+        console.log(`\n[${step.id}] Running: ${step.name}`);
+        console.log("─".repeat(60));
+        const startTime = Date.now();
+        return new Promise((resolve, reject) => {
+            let cmd;
+            let args;
+            let tmpScriptPath;
+            switch (step.kind) {
+                case "script":
+                    // Write script to a temporary file to avoid issues with nested command substitutions
+                    // when passing complex scripts via -c
+                    cmd = step.shell ?? this.config.interpreters.bash;
+                    try {
+                        const tmpDir = mkdtempSync(join(tmpdir(), 'cibuild-script-'));
+                        tmpScriptPath = join(tmpDir, `step-${step.id || 'script'}.sh`);
+                        // Prepend envman shell function that writes directly to the envstore JSON file.
+                        // This avoids calling the ci binary (pkg binaries have issues with subcommands).
+                        const envmanShim = `envman() {
+  local cmd="\$1"; shift
+  local store="\${ENVMAN_ENVSTORE_PATH:-.ci/.envstore.json}"
+  case "\$cmd" in
+    add)
+      local key="" value="" valuefile="" sensitive=false skipifempty=false append=false
+      while [ \$# -gt 0 ]; do
+        case "\$1" in
+          --key|-k) key="\$2"; shift 2 ;;
+          --value|-v) value="\$2"; shift 2 ;;
+          --valuefile|-f) valuefile="\$2"; shift 2 ;;
+          --sensitive|-s) sensitive=true; shift ;;
+          --skip-if-empty) skipifempty=true; shift ;;
+          --append|-a) append=true; shift ;;
+          *) shift ;;
+        esac
+      done
+      [ -z "\$key" ] && { echo "envman add: --key required" >&2; return 1; }
+      if [ -n "\$valuefile" ]; then
+        value="\$(cat "\$valuefile")"
+      elif [ -z "\$value" ] && ! [ -t 0 ]; then
+        value="\$(cat)"
+      fi
+      [ "\$skipifempty" = true ] && [ -z "\$value" ] && return 0
+      node -e '
+        const fs=require("fs");
+        const f=process.argv[1], k=process.argv[2], v=process.argv[3];
+        const s=process.argv[4]==="true", a=process.argv[5]==="true";
+        let store={envs:[]};
+        try{store=JSON.parse(fs.readFileSync(f,"utf-8"))}catch{}
+        const idx=store.envs.findIndex(e=>e.key===k);
+        if(a && idx>=0){store.envs[idx].value+=v}
+        else if(idx>=0){store.envs[idx].value=v;store.envs[idx].sensitive=s}
+        else{store.envs.push({key:k,value:v,sensitive:s})}
+        fs.mkdirSync(require("path").dirname(f),{recursive:true});
+        fs.writeFileSync(f,JSON.stringify(store,null,2));
+      ' "\$store" "\$key" "\$value" "\$sensitive" "\$append"
+      echo "envman: \$key set"
+      ;;
+    init)
+      node -e 'const fs=require("fs");const f=process.argv[1];fs.mkdirSync(require("path").dirname(f),{recursive:true});fs.writeFileSync(f,JSON.stringify({envs:[]},null,2))' "\$store"
+      ;;
+    *)
+      echo "envman: unknown command: \$cmd" >&2; return 1
+      ;;
+  esac
+}
+export -f envman
+`;
+                        writeFileSync(tmpScriptPath, envmanShim + step.script, 'utf-8');
+                        chmodSync(tmpScriptPath, 0o755);
+                        args = ["-l", tmpScriptPath];
+                    }
+                    catch (err) {
+                        reject(new Error(`Failed to create temporary script file: ${err}`));
+                        return;
+                    }
+                    break;
+                case "python":
+                    cmd = this.config.interpreters.python;
+                    args = ["-c", step.script];
+                    break;
+                case "ruby":
+                    cmd = this.config.interpreters.ruby;
+                    args = ["-e", step.script];
+                    break;
+                case "node":
+                    cmd = this.config.interpreters.node;
+                    args = ["-e", step.script];
+                    break;
+                default:
+                    reject(new Error(`Unknown step kind: ${step.kind}`));
+                    return;
+            }
+            // Set envstore path so envman works regardless of cd in scripts
+            const env = {
+                ...process.env,
+                ENVMAN_ENVSTORE_PATH,
+            };
+            const child = spawn(cmd, args, {
+                stdio: "inherit",
+                shell: false,
+                env,
+            });
+            const cleanupTmp = () => {
+                if (tmpScriptPath) {
+                    try {
+                        rmSync(dirname(tmpScriptPath), { recursive: true, force: true });
+                    }
+                    catch { }
+                }
+            };
+            child.on("error", (err) => {
+                cleanupTmp();
+                reject(new Error(`Failed to spawn ${cmd}: ${err.message}`));
+            });
+            child.on("exit", (code) => {
+                const duration = Date.now() - startTime;
+                const durationStr = this.formatDuration(duration);
+                cleanupTmp();
+                if (code === 0) {
+                    console.log(`[${step.id}] ✓ Success (${durationStr})\n`);
+                    resolve();
+                }
+                else {
+                    reject(new StepExecutionError(step.id, step.name, code ?? 1));
+                }
+            });
+        });
+    }
+    formatDuration(ms) {
+        if (ms < 1000) {
+            return `${ms}ms`;
+        }
+        else if (ms < 60000) {
+            return `${(ms / 1000).toFixed(1)}s`;
+        }
+        else {
+            const minutes = Math.floor(ms / 60000);
+            const seconds = Math.floor((ms % 60000) / 1000);
+            return `${minutes}m ${seconds}s`;
+        }
+    }
+    validatePipeline(pipeline) {
+        const stepIds = new Set(pipeline.steps.map((s) => s.id));
+        const duplicates = pipeline.steps
+            .map((s) => s.id)
+            .filter((id, index, arr) => arr.indexOf(id) !== index);
+        if (duplicates.length > 0) {
+            throw new Error(`Duplicate step IDs found: ${duplicates.join(", ")}`);
+        }
+        for (const orderId of pipeline.stepsOrder) {
+            if (!stepIds.has(orderId)) {
+                throw new Error(`Step ID "${orderId}" in stepsOrder not found in steps`);
+            }
+        }
+        if (pipeline.stepsOrder.length !== pipeline.steps.length) {
+            const missingIds = pipeline.steps
+                .filter((s) => !pipeline.stepsOrder.includes(s.id))
+                .map((s) => s.id);
+            throw new Error(`Some steps are not in stepsOrder: ${missingIds.join(", ")}`);
+        }
+    }
+    displayWarnings(warnings, skippedSteps) {
+        console.log("\n" + "═".repeat(60));
+        console.log("⚠️  UNSUPPORTED STEPS DETECTED");
+        console.log("═".repeat(60));
+        warnings.forEach((warning) => {
+            console.log(warning);
+        });
+        console.log("─".repeat(60));
+        console.log(`ℹ️  Skipped ${skippedSteps} unsupported step${skippedSteps !== 1 ? 's' : ''}. Build will continue.`);
+        console.log("═".repeat(60) + "\n");
+    }
+    async runPipeline(pipeline, warnings, skippedSteps) {
+        // Ensure .ci directory exists (envstore lives there)
+        mkdirSync(resolve(process.cwd(), ".ci"), { recursive: true });
+        // Clear envstore at the start of each build for a clean slate
+        if (existsSync(ENVMAN_ENVSTORE_PATH)) {
+            unlinkSync(ENVMAN_ENVSTORE_PATH);
+        }
+        console.log(`\n╔═════════════════════════════════════════════════════════╗`);
+        console.log(`║  Pipeline: ${pipeline.name.padEnd(42)} ║`);
+        console.log(`╚═════════════════════════════════════════════════════════╝\n`);
+        // Display warnings if provided
+        if (warnings && warnings.length > 0) {
+            this.displayWarnings(warnings, skippedSteps || 0);
+        }
+        this.validatePipeline(pipeline);
+        const stepsMap = new Map(pipeline.steps.map((s) => [s.id, s]));
+        for (const stepId of pipeline.stepsOrder) {
+            const step = stepsMap.get(stepId);
+            if (!step) {
+                throw new Error(`Step ${stepId} not found`);
+            }
+            try {
+                await this.runStep(step);
+            }
+            catch (err) {
+                if (step.isSkippable && err instanceof StepExecutionError) {
+                    console.log(`\n⚠️  [${step.id}] Step "${step.name}" failed but is marked skippable — continuing.\n`);
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        console.log("\n" + "═".repeat(60));
+        console.log("✓ Pipeline completed successfully");
+        console.log("═".repeat(60) + "\n");
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/types.d.ts

@@ -0,0 +1,57 @@
+export interface StepDef {
+    id: string;
+    name: string;
+    kind: "script" | "python" | "ruby" | "node";
+    shell?: string;
+    script: string;
+    isSkippable?: boolean;
+}
+export interface PipelineDef {
+    name: string;
+    artifacts: string[];
+    steps: StepDef[];
+    stepsOrder: string[];
+}
+export interface CIConfig {
+    artifactsDir: string;
+    interpreters: {
+        python: string;
+        ruby: string;
+        node: string;
+        bash: string;
+    };
+    maxConcurrentJobs: number;
+    paths: {
+        buildsDir: string;
+        cacheDir: string;
+        derivedDataDir: string;
+    };
+    /** When true, steps that require remote infrastructure (S3, servers) skip gracefully */
+    local?: boolean;
+}
+export interface StepBuilders {
+    script(name: string, options: {
+        id: string;
+        shell?: string;
+        script: string;
+    }): void;
+    python(name: string, options: {
+        id: string;
+        script: string;
+    }): void;
+    ruby(name: string, options: {
+        id: string;
+        script: string;
+    }): void;
+    node(name: string, options: {
+        id: string;
+        script: string;
+    }): void;
+}
+export interface PipelineContext {
+    artifacts(paths: string[]): void;
+    steps(builder: (s: StepBuilders) => void): void;
+    stepsOrder(ids: string[]): void;
+}
+export type PipelineFactory = (name: string, builder: (ctx: PipelineContext) => void) => PipelineDef;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,KAAK,WAAW,CAAC"}

package/dist/src/types.js

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

package/dist/src/yaml/bitrise-compat.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Bitrise YAML Compatibility Layer
+ *
+ * This module provides compatibility functions to convert Bitrise YAML pipelines
+ * to CI Build format, including metadata conversion and environment variable mapping.
+ */
+import type { YAMLPipeline } from './types.js';
+/**
+ * Map of Bitrise environment variables to CI Build equivalents
+ * Used for automatic variable substitution (FR-9.2)
+ */
+export declare const BITRISE_ENV_MAP: Record<string, string>;
+/**
+ * Bitrise environment variables that require user input
+ * These cannot be automatically mapped and must be provided by the user (FR-9.3)
+ */
+export declare const BITRISE_USER_REQUIRED_VARS: string[];
+/**
+ * Error class for Bitrise-specific environment variable issues
+ * Provides detailed information about missing variables (FR-9.3, FR-9.4, FR-9.5)
+ */
+export declare class BitriseEnvironmentError extends Error {
+    readonly missingVariables: BitriseVariableInfo[];
+    constructor(missingVariables: BitriseVariableInfo[]);
+}
+/**
+ * Information about a missing Bitrise environment variable
+ */
+export interface BitriseVariableInfo {
+    /** Variable name (e.g., BITRISE_PUBLIC_INSTALL_PAGE_URL) */
+    name: string;
+    /** Step where the variable is used */
+    stepName: string;
+    /** Input field where the variable is used */
+    inputField: string;
+    /** CI Build equivalent variable name (if available) */
+    cibuildEquivalent?: string;
+    /** Suggested action for the user */
+    suggestedAction: string;
+}
+/**
+ * Converts Bitrise metadata to CI Build format
+ * Transforms meta.bitrise.io to meta.cibuild.io (FR-1.1, FR-1.2, FR-1.3)
+ *
+ * @param pipeline YAML pipeline object (mutated in place)
+ */
+export declare function convertBitriseMetadata(pipeline: YAMLPipeline): void;
+/**
+ * Detects Bitrise-specific environment variables in step inputs
+ * Scans recursively through objects and arrays (FR-9.1)
+ *
+ * @param inputs Step inputs object
+ * @param stepName Name of the step (for error reporting)
+ * @returns Array of detected Bitrise variable information
+ */
+export declare function detectBitriseEnvironmentVariables(inputs: any, stepName: string): BitriseVariableInfo[];
+/**
+ * Checks if a variable should trigger a warning vs error
+ * Mapped variables generate info logs, unmapped variables generate errors
+ *
+ * @param varName Bitrise variable name
+ * @returns True if variable needs user configuration (error), false if auto-mapped (info)
+ */
+export declare function requiresUserConfiguration(varName: string): boolean;
+//# sourceMappingURL=bitrise-compat.d.ts.map

package/dist/src/yaml/bitrise-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitrise-compat.d.ts","sourceRoot":"","sources":["../../../src/yaml/bitrise-compat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,UAKtC,CAAC;AAEF;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;gBAE5C,gBAAgB,EAAE,mBAAmB,EAAE;CAMpD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAsBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,GACf,mBAAmB,EAAE,CAOvB;AA2HD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE"}