@invarn/cibuild 1.6.2 → 1.8.0

package/dist/src/commands/build.d.ts

@@ -1,5 +1,48 @@
+export interface SetupOptions {
+    keystore: boolean;
+    keystoreProperties: boolean;
+    googleServices: boolean;
+    googlePlayDeploy: boolean;
+    googlePlayPackageName: string;
+    /** Whether the release workflow should produce an AAB or APK. Defaults to 'apk'. */
+    artifactType: 'apk' | 'aab';
+    /** Resolved keystore file paths per workflow (relative to project root), if found on disk. */
+    keystorePaths: Record<string, string>;
+}
+export interface WorkflowVariantConfig {
+    /** Value for the VARIANT env var, e.g. "debug", "release", "stagingDebug". */
+    variant: string;
+    /** Capitalised build type for gradle-build inputs, e.g. "Debug", "Release", "StagingDebug". */
+    buildType: string;
+    /** Gradle assemble task, e.g. "assembleDebug", "assembleRelease", "assembleStagingDebug". */
+    gradleTask: string;
+}
+export interface WorkflowVariants {
+    primary: WorkflowVariantConfig;
+    pullRequest: WorkflowVariantConfig;
+    release: WorkflowVariantConfig;
+}
+export interface IosWorkflowSchemeConfig {
+    scheme: string;
+    configuration: string;
+    distributionMethod: string;
+}
+export interface IosWorkflowVariants {
+    primary: IosWorkflowSchemeConfig;
+    pullRequest: IosWorkflowSchemeConfig;
+    release: IosWorkflowSchemeConfig;
+}
+export interface IosSetupOptions {
+    cocoaPods: boolean;
+    codeSigning: boolean;
+    appStoreDeploy: boolean;
+    bundleId: string;
+}
+export declare function generateAndroidPipeline(javaVersion?: number, setup?: SetupOptions, variants?: WorkflowVariants, cacheTechnology?: "gradle" | "kmm", metaNamespace?: 'invarn' | 'cibuild.io'): string;
+export declare function generateIosPipeline(projectPath: string, setup: IosSetupOptions, variants: IosWorkflowVariants, metaNamespace?: 'invarn' | 'cibuild.io'): string;
 export declare function handleBuildCommand(detectMobileProjectRoot: (dir: string) => "android" | "ios" | "kmm" | null, options?: {
     createPipelinesDir?: boolean;
     nonInteractive?: boolean;
+    metaNamespace?: 'invarn' | 'cibuild.io';
 }): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

package/dist/src/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAm8BA,wBAAsB,kBAAkB,CACtC,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,EAC1E,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,OAAO,CAAC,IAAI,CAAC,CA4Bf"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,YAAY,EAAE,KAAK,GAAG,KAAK,CAAC;IAC5B,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAiBD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,uBAAuB,CAAC;IACjC,WAAW,EAAE,uBAAuB,CAAC;IACrC,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoJD,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,MAAW,EACxB,KAAK,GAAE,YAAgL,EACvL,QAAQ,GAAE,gBAAmC,EAC7C,eAAe,GAAE,QAAQ,GAAG,KAAgB,EAC5C,aAAa,GAAE,QAAQ,GAAG,YAA2B,GACpD,MAAM,CA2NR;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,mBAAmB,EAC7B,aAAa,GAAE,QAAQ,GAAG,YAA2B,GACpD,MAAM,CA4LR;AAgVD,wBAAsB,kBAAkB,CACtC,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,EAC1E,OAAO,GAAE;IACP,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;CACpC,GACL,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/src/commands/build.js

@@ -122,7 +122,7 @@ function detectSetupNeeds(warnings) {
         artifactType: 'apk',
     };
 }
-function generateAndroidPipeline(javaVersion = 17, setup = { keystore: false, keystoreProperties: false, googleServices: false, googlePlayDeploy: false, googlePlayPackageName: '', artifactType: 'apk', keystorePaths: {} }, variants = DEFAULT_VARIANTS, cacheTechnology = "gradle") {
+export function generateAndroidPipeline(javaVersion = 17, setup = { keystore: false, keystoreProperties: false, googleServices: false, googlePlayDeploy: false, googlePlayPackageName: '', artifactType: 'apk', keystorePaths: {} }, variants = DEFAULT_VARIANTS, cacheTechnology = "gradle", metaNamespace = 'cibuild.io') {
     const keystoreStepFor = (wf) => {
         if (!setup.keystore)
             return "";
@@ -204,7 +204,7 @@ function generateAndroidPipeline(javaVersion = 17, setup = { keystore: false, ke
     return `format_version: '1'
 
 meta:
-  cibuild.io:
+  ${metaNamespace}:
     stack: ${stack}
     machine_type: standard
     platform: ${platformMeta}
@@ -333,7 +333,7 @@ ${googlePlayStep}
               fi
 `;
 }
-function generateIosPipeline(projectPath, setup, variants) {
+export function generateIosPipeline(projectPath, setup, variants, metaNamespace = 'cibuild.io') {
     const { primary: pv, pullRequest: prv, release: rv } = variants;
     // Global scheme is the primary scheme (used as default across workflows)
     const globalScheme = pv.scheme;
@@ -409,7 +409,7 @@ function generateIosPipeline(projectPath, setup, variants) {
     return `format_version: '1'
 
 meta:
-  cibuild.io:
+  ${metaNamespace}:
     stack: macos-xcode-26.4
     machine_type: performance
     platform: ios
@@ -771,7 +771,7 @@ async function handleIosBuildCommand(cwd, options = {}) {
         }
     }
     // 7. Generate and write the pipeline
-    const yaml = generateIosPipeline(iosScanResult.projectPath, iosSetupOptions, iosVariants);
+    const yaml = generateIosPipeline(iosScanResult.projectPath, iosSetupOptions, iosVariants, options.metaNamespace);
     writeFileSync(outputPath, yaml, "utf-8");
     console.log("\n✅ Generated .ci/pipelines/cibuild.yml");
     console.log("   Platform: iOS");
@@ -1042,7 +1042,7 @@ async function handleAndroidBuildCommand(cwd, options, cacheTechnology) {
     // that exact JDK — a newer JDK can cross-compile. Enforce a minimum of 17
     // since ubuntu-latest runners ship with JDK 17+ and JDK <17 is unavailable.
     const javaVersion = Math.max(scanResult.detectedJavaVersion ?? 17, 17);
-    const yaml = generateAndroidPipeline(javaVersion, setupOptions, variants, cacheTechnology);
+    const yaml = generateAndroidPipeline(javaVersion, setupOptions, variants, cacheTechnology, options.metaNamespace);
     writeFileSync(outputPath, yaml, "utf-8");
     console.log("\n✅ Generated .ci/pipelines/cibuild.yml");
     console.log(`   Platform: ${platformLabel}`);

package/dist/src/commands/build.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Unit tests for the YAML scaffold generators in build.ts.
+ *
+ * `generateIosPipeline` and `generateAndroidPipeline` are pure
+ * functions today (input → YAML string), so we drive them directly
+ * rather than through the interactive `handleBuildCommand` shell.
+ *
+ * Focus is the meta-namespace flip: standalone `cibuild` callers get
+ * `meta.cibuild.io:` (default), while invarn-CLI-routed calls pass
+ * `metaNamespace: 'invarn'` and get `meta.invarn:`.
+ */
+export {};
+//# sourceMappingURL=build.test.d.ts.map

package/dist/src/commands/build.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.test.d.ts","sourceRoot":"","sources":["../../../src/commands/build.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/src/commands/build.test.js

@@ -0,0 +1,59 @@
+/**
+ * Unit tests for the YAML scaffold generators in build.ts.
+ *
+ * `generateIosPipeline` and `generateAndroidPipeline` are pure
+ * functions today (input → YAML string), so we drive them directly
+ * rather than through the interactive `handleBuildCommand` shell.
+ *
+ * Focus is the meta-namespace flip: standalone `cibuild` callers get
+ * `meta.cibuild.io:` (default), while invarn-CLI-routed calls pass
+ * `metaNamespace: 'invarn'` and get `meta.invarn:`.
+ */
+import { describe, test, expect } from '@jest/globals';
+import { generateIosPipeline, generateAndroidPipeline, } from './build.js';
+const iosSetup = {
+    cocoaPods: false,
+    codeSigning: false,
+    appStoreDeploy: false,
+    bundleId: 'com.example.app',
+};
+const iosVariants = {
+    primary: { scheme: 'MyApp', configuration: 'Debug', distributionMethod: 'development' },
+    pullRequest: { scheme: 'MyApp', configuration: 'Debug', distributionMethod: 'development' },
+    release: { scheme: 'MyApp', configuration: 'Release', distributionMethod: 'app-store' },
+};
+describe('generateIosPipeline — meta namespace', () => {
+    test('emits meta.cibuild.io: by default (standalone cibuild path)', () => {
+        const yaml = generateIosPipeline('./MyApp', iosSetup, iosVariants);
+        expect(yaml).toContain('meta:\n  cibuild.io:\n');
+        expect(yaml).not.toContain('meta:\n  invarn:\n');
+    });
+    test('emits meta.cibuild.io: when explicitly passed "cibuild.io"', () => {
+        const yaml = generateIosPipeline('./MyApp', iosSetup, iosVariants, 'cibuild.io');
+        expect(yaml).toContain('meta:\n  cibuild.io:\n');
+        expect(yaml).not.toContain('meta:\n  invarn:\n');
+    });
+    test('emits meta.invarn: when explicitly passed "invarn" (invarn-CLI path)', () => {
+        const yaml = generateIosPipeline('./MyApp', iosSetup, iosVariants, 'invarn');
+        expect(yaml).toContain('meta:\n  invarn:\n');
+        expect(yaml).not.toContain('meta:\n  cibuild.io:\n');
+    });
+});
+describe('generateAndroidPipeline — meta namespace', () => {
+    test('emits meta.cibuild.io: by default (standalone cibuild path)', () => {
+        const yaml = generateAndroidPipeline();
+        expect(yaml).toContain('meta:\n  cibuild.io:\n');
+        expect(yaml).not.toContain('meta:\n  invarn:\n');
+    });
+    test('emits meta.cibuild.io: when explicitly passed "cibuild.io"', () => {
+        const yaml = generateAndroidPipeline(17, undefined, undefined, 'gradle', 'cibuild.io');
+        expect(yaml).toContain('meta:\n  cibuild.io:\n');
+        expect(yaml).not.toContain('meta:\n  invarn:\n');
+    });
+    test('emits meta.invarn: when explicitly passed "invarn" (invarn-CLI path)', () => {
+        const yaml = generateAndroidPipeline(17, undefined, undefined, 'gradle', 'invarn');
+        expect(yaml).toContain('meta:\n  invarn:\n');
+        expect(yaml).not.toContain('meta:\n  cibuild.io:\n');
+    });
+});
+//# sourceMappingURL=build.test.js.map

package/dist/src/commands/edit.d.ts

@@ -1,3 +1,12 @@
+import type { YAMLPipeline } from '../yaml/types.js';
 import '../yaml/steps/index.js';
+/**
+ * Detects the target platform of a workflow.
+ * Checks (in order):
+ *   1. meta.invarn.platform (preferred), falling back to meta.cibuild.io.platform
+ *   2. Existing steps in the workflow — fallback
+ * Returns 'ios' or 'android', or null if platform cannot be determined.
+ */
+export declare function detectWorkflowPlatform(pipeline: YAMLPipeline, workflowName: string): 'ios' | 'android' | null;
 export declare function handleEditCommand(pipelinePath: string, workflowName?: string): Promise<void>;
 //# sourceMappingURL=edit.d.ts.map

package/dist/src/commands/edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/commands/edit.ts"],"names":[],"mappings":"AAUA,OAAO,wBAAwB,CAAC;AAkYhC,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA+Sf"}
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/commands/edit.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,kBAAkB,CAAC;AAE/D,OAAO,wBAAwB,CAAC;AAsShC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAgB7G;AAqED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA+Sf"}

package/dist/src/commands/edit.js

@@ -4,6 +4,7 @@ import { resolve, basename } from 'node:path';
 import * as yaml from 'js-yaml';
 import prompts from 'prompts';
 import { loadYAMLPipeline } from '../yaml/parser.js';
+import { getInvarnMeta } from '../yaml/meta-helpers.js';
 import { SecretsManager } from '../yaml/secrets-manager.js';
 import { getAvailableSteps, getStepMetadata } from '../yaml/steps/registry.js';
 // Ensure the step registry is populated
@@ -286,13 +287,13 @@ async function handleAddRegisteredStep(pipelinePath, workflowName, _pipeline, st
 /**
  * Detects the target platform of a workflow.
  * Checks (in order):
- *   1. meta.cibuild.io.platform — explicit declaration, most reliable
+ *   1. meta.invarn.platform (preferred), falling back to meta.cibuild.io.platform
  *   2. Existing steps in the workflow — fallback
  * Returns 'ios' or 'android', or null if platform cannot be determined.
  */
-function detectWorkflowPlatform(pipeline, workflowName) {
-    // 1. Explicit platform declaration in meta
-    const metaPlatform = pipeline.meta?.['cibuild.io']?.platform;
+export function detectWorkflowPlatform(pipeline, workflowName) {
+    // 1. Explicit platform declaration on the Invarn-owned meta block
+    const metaPlatform = getInvarnMeta(pipeline)?.platform;
     if (metaPlatform === 'ios' || metaPlatform === 'android' || metaPlatform === 'kmm')
         return metaPlatform === 'kmm' ? 'ios' : metaPlatform;
     // 2. Scan existing steps as fallback

package/dist/src/commands/edit.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for edit-command helpers.
+ * Focused on the dual-read of meta.invarn + meta.cibuild.io for the platform hint.
+ */
+export {};
+//# sourceMappingURL=edit.test.d.ts.map

package/dist/src/commands/edit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.test.d.ts","sourceRoot":"","sources":["../../../src/commands/edit.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/commands/edit.test.js

@@ -0,0 +1,45 @@
+/**
+ * Unit tests for edit-command helpers.
+ * Focused on the dual-read of meta.invarn + meta.cibuild.io for the platform hint.
+ */
+import { describe, test, expect } from '@jest/globals';
+import { detectWorkflowPlatform } from './edit.js';
+describe('detectWorkflowPlatform — meta dual-read', () => {
+    function pipelineWithMeta(meta) {
+        return {
+            format_version: '4',
+            meta,
+            workflows: {
+                primary: {
+                    steps: [{ 'script@1.0.0': { inputs: {} } }],
+                },
+            },
+        };
+    }
+    test('reads platform from meta.invarn when only invarn is present', () => {
+        const pipeline = pipelineWithMeta({
+            invarn: { platform: 'ios' },
+        });
+        expect(detectWorkflowPlatform(pipeline, 'primary')).toBe('ios');
+    });
+    test('prefers meta.invarn.platform over meta.cibuild.io.platform when both are present', () => {
+        const pipeline = pipelineWithMeta({
+            invarn: { platform: 'ios' },
+            'cibuild.io': { platform: 'android' },
+        });
+        expect(detectWorkflowPlatform(pipeline, 'primary')).toBe('ios');
+    });
+    test('falls back to meta.cibuild.io.platform when meta.invarn is absent', () => {
+        const pipeline = pipelineWithMeta({
+            'cibuild.io': { platform: 'android' },
+        });
+        expect(detectWorkflowPlatform(pipeline, 'primary')).toBe('android');
+    });
+    test('maps kmm to ios from meta.invarn', () => {
+        const pipeline = pipelineWithMeta({
+            invarn: { platform: 'kmm' },
+        });
+        expect(detectWorkflowPlatform(pipeline, 'primary')).toBe('ios');
+    });
+});
+//# sourceMappingURL=edit.test.js.map

package/dist/src/commands/init.d.ts

@@ -1,6 +1,13 @@
 export interface InitOptions {
     importPath?: string;
     create?: boolean;
+    /**
+     * Which namespace to emit in the generated `meta.<ns>` block of the new
+     * pipeline YAML. Defaults to `'cibuild.io'` so the standalone `cibuild`
+     * CLI keeps emitting the legacy namespace. Invarn-CLI-routed calls pass
+     * `'invarn'` so wrapped flows emit the canonical Invarn namespace.
+     */
+    metaNamespace?: 'invarn' | 'cibuild.io';
 }
 /**
  * Check dependencies, then either import an existing YAML pipeline or

package/dist/src/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0Q7E"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;CACzC;AAUD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2Q7E"}

package/dist/src/commands/init.js

@@ -5,6 +5,7 @@ import { resolve } from "node:path";
 import prompts from "prompts";
 import { detectMobileProjectRoot } from "../shared/detect-project.js";
 import { ensureCiBuildGitignoreEntries } from "../shared/gitignore.js";
+import { getInvarnMeta } from "../yaml/meta-helpers.js";
 import { loadYAMLPipeline } from "../yaml/parser.js";
 import { handleBuildCommand } from "./build.js";
 import { generateGitHubActionsWorkflow } from "./github-workflow.js";
@@ -188,6 +189,7 @@ export async function handleInitCommand(opts = {}) {
         await handleBuildCommand(detectMobileProjectRoot, {
             createPipelinesDir: true,
             nonInteractive: !!opts.create,
+            metaNamespace: opts.metaNamespace,
         });
         process.exit(0);
     }
@@ -238,7 +240,7 @@ export async function handleInitCommand(opts = {}) {
     let importedPlatform = null;
     try {
         const yamlPipeline = loadYAMLPipeline(destPath);
-        const meta = yamlPipeline.meta?.["cibuild.io"];
+        const meta = getInvarnMeta(yamlPipeline);
         if (meta?.platform === "ios" || meta?.platform === "android" || meta?.platform === "kmm") {
             importedPlatform = meta.platform === "kmm" ? "ios" : meta.platform;
         }

package/dist/src/yaml/converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/yaml/converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAW,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,YAAY,CAAC;AAKzE,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkCD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,QAAQ,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA0I3B;AAwGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEtE"}
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/yaml/converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAW,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,YAAY,CAAC;AAMzE,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkCD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,QAAQ,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA0I3B;AAwGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEtE"}

package/dist/src/yaml/converter.js

@@ -2,6 +2,7 @@
  * Converts YAML pipeline workflows to PipelineDef format
  * This bridges the YAML configuration with the existing runner engine
  */
+import { getInvarnMeta } from './meta-helpers.js';
 import { detectPlatformInfo } from './platform-detector.js';
 import { EnvResolver } from './env-resolver.js';
 import { getStepExecutor, UnrecognizedStepError } from './steps/registry.js';
@@ -61,16 +62,16 @@ export async function convertYAMLToPipelineDef(pipeline, config, workflowName, y
     // Step 3: Environment variable resolution
     const envResolver = new EnvResolver(pipeline, selectedWorkflow, selectedWorkflowName, platformInfo.platform, platformInfo.stack, yamlFilePath);
     // Step 3.5: Auto-inject cache steps if cachedBuild is enabled
-    const cibuildMeta = pipeline.meta?.['cibuild.io'];
-    const cachedBuild = cibuildMeta?.cachedBuild === true;
+    const invarnMeta = getInvarnMeta(pipeline);
+    const cachedBuild = invarnMeta?.cachedBuild === true;
     let workflowSteps = [...selectedWorkflow.steps];
-    if (cachedBuild && cibuildMeta?.platform) {
+    if (cachedBuild && invarnMeta?.platform) {
         const platformToCacheTechnology = {
             ios: 'ios',
             android: 'gradle',
             kmm: 'kmm',
         };
-        const technology = platformToCacheTechnology[cibuildMeta.platform];
+        const technology = platformToCacheTechnology[invarnMeta.platform];
         if (technology) {
             // Remove any manually written cache-pull/cache-push steps
             workflowSteps = workflowSteps.filter(step => {

package/dist/src/yaml/converter.test.js

@@ -492,6 +492,57 @@ describe('convertYAMLToPipelineDef - Warning System', () => {
             expect(result.pipeline.steps[2].name).toBe('cache-push');
             expect(result.pipeline.steps[2].script).toContain('kmm-');
         });
+        test('should inject cache steps when cachedBuild + platform live under meta.invarn', async () => {
+            const pipeline = {
+                format_version: '1',
+                meta: {
+                    invarn: {
+                        stack: 'macos-xcode-26.4',
+                        platform: 'kmm',
+                        cachedBuild: true,
+                    },
+                },
+                workflows: {
+                    build: {
+                        steps: [
+                            { 'script@1.0.0': { inputs: { content: 'echo "building"' } } },
+                        ],
+                    },
+                },
+            };
+            const result = await convertYAMLToPipelineDef(pipeline, mockConfig, 'build');
+            expect(result.pipeline.steps.length).toBe(3);
+            expect(result.pipeline.steps[0].name).toBe('cache-pull');
+            expect(result.pipeline.steps[1].name).toBe('script');
+            expect(result.pipeline.steps[2].name).toBe('cache-push');
+        });
+        test('should prefer meta.invarn cachedBuild over meta.cibuild.io when both are present', async () => {
+            const pipeline = {
+                format_version: '1',
+                meta: {
+                    invarn: {
+                        stack: 'macos-xcode-26.4',
+                        platform: 'kmm',
+                        cachedBuild: true,
+                    },
+                    'cibuild.io': {
+                        stack: 'macos-xcode-26.4',
+                        platform: 'kmm',
+                        cachedBuild: false,
+                    },
+                },
+                workflows: {
+                    build: {
+                        steps: [
+                            { 'script@1.0.0': { inputs: { content: 'echo "building"' } } },
+                        ],
+                    },
+                },
+            };
+            const result = await convertYAMLToPipelineDef(pipeline, mockConfig, 'build');
+            expect(result.pipeline.steps.length).toBe(3);
+            expect(result.pipeline.steps[0].name).toBe('cache-pull');
+        });
     });
 });
 //# sourceMappingURL=converter.test.js.map

package/dist/src/yaml/meta-helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Helpers for reading the Invarn-owned metadata block from a parsed YAML pipeline.
+ *
+ * Invarn-owned configuration historically lived under `meta.cibuild.io` and is
+ * being migrated to `meta.invarn`. Both keys share the same shape (YAMLCIBuildMeta).
+ * Readers should always go through `getInvarnMeta()` so that:
+ *
+ *   1. New YAMLs that emit `meta.invarn` are read directly.
+ *   2. Legacy YAMLs that still carry `meta.cibuild.io` continue to work.
+ *   3. When both blocks are present, `meta.invarn` wins as a whole — the legacy
+ *      block is treated as stale and ignored field-by-field, matching the
+ *      migration plan in `.scratch/cibuild-io-namespace-rename/PRD.md`.
+ *
+ * Removing the `meta.cibuild.io` fallback is the last step of that migration; it
+ * happens in a single place once usage of the legacy namespace drops to zero.
+ */
+import type { YAMLCIBuildMeta, YAMLPipeline } from './types.js';
+export declare function getInvarnMeta(pipeline: YAMLPipeline): YAMLCIBuildMeta | undefined;
+//# sourceMappingURL=meta-helpers.d.ts.map

package/dist/src/yaml/meta-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-helpers.d.ts","sourceRoot":"","sources":["../../../src/yaml/meta-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,CAEjF"}

package/dist/src/yaml/meta-helpers.js

@@ -0,0 +1,20 @@
+/**
+ * Helpers for reading the Invarn-owned metadata block from a parsed YAML pipeline.
+ *
+ * Invarn-owned configuration historically lived under `meta.cibuild.io` and is
+ * being migrated to `meta.invarn`. Both keys share the same shape (YAMLCIBuildMeta).
+ * Readers should always go through `getInvarnMeta()` so that:
+ *
+ *   1. New YAMLs that emit `meta.invarn` are read directly.
+ *   2. Legacy YAMLs that still carry `meta.cibuild.io` continue to work.
+ *   3. When both blocks are present, `meta.invarn` wins as a whole — the legacy
+ *      block is treated as stale and ignored field-by-field, matching the
+ *      migration plan in `.scratch/cibuild-io-namespace-rename/PRD.md`.
+ *
+ * Removing the `meta.cibuild.io` fallback is the last step of that migration; it
+ * happens in a single place once usage of the legacy namespace drops to zero.
+ */
+export function getInvarnMeta(pipeline) {
+    return pipeline.meta?.invarn ?? pipeline.meta?.['cibuild.io'];
+}
+//# sourceMappingURL=meta-helpers.js.map

package/dist/src/yaml/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/yaml/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,cAAe,SAAQ,KAAK;aACM,QAAQ,CAAC,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAI/D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA0C/D;AA8GD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEjF"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/yaml/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,cAAe,SAAQ,KAAK;aACM,QAAQ,CAAC,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAI/D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA0C/D;AAkHD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEjF"}

package/dist/src/yaml/parser.js

@@ -102,26 +102,29 @@ function validateYAMLPipeline(parsed, filePath) {
                 throw new YAMLValidationError(`Invalid platform '${parsed.meta.platform}' in ${filePath}. Must be one of: ${validPlatforms.join(', ')}`);
             }
         }
-        // Validate cibuild.io section if present
-        if (parsed.meta['cibuild.io']) {
-            const cibuildMeta = parsed.meta['cibuild.io'];
-            if (typeof cibuildMeta !== 'object') {
-                throw new YAMLValidationError(`Invalid 'meta.cibuild.io' section in ${filePath}: Expected an object`);
-            }
-            // Validate stack pattern if specified
-            if (cibuildMeta.stack && typeof cibuildMeta.stack === 'string') {
-                const stackPattern = /^(macos|linux)-/;
-                if (cibuildMeta.stack !== 'local' && !stackPattern.test(cibuildMeta.stack)) {
-                    throw new YAMLValidationError(`Invalid stack '${cibuildMeta.stack}' in ${filePath}. Stack must be 'local' or start with 'macos-' or 'linux-'`);
-                }
-            }
-            // Validate machine_type if specified
-            if (cibuildMeta.machine_type) {
-                const validMachineTypes = ['standard', 'performance'];
-                if (!validMachineTypes.includes(cibuildMeta.machine_type)) {
-                    throw new YAMLValidationError(`Invalid machine_type '${cibuildMeta.machine_type}' in ${filePath}. Must be one of: ${validMachineTypes.join(', ')}`);
-                }
-            }
+        // Validate the Invarn-owned metadata block under either namespace.
+        // Both `meta.invarn` (preferred) and `meta.cibuild.io` (legacy) share the same shape.
+        validateInvarnMetaBlock(parsed.meta.invarn, 'meta.invarn', filePath);
+        validateInvarnMetaBlock(parsed.meta['cibuild.io'], 'meta.cibuild.io', filePath);
+    }
+}
+function validateInvarnMetaBlock(block, blockName, filePath) {
+    if (block === undefined || block === null) {
+        return;
+    }
+    if (typeof block !== 'object') {
+        throw new YAMLValidationError(`Invalid '${blockName}' section in ${filePath}: Expected an object`);
+    }
+    if (block.stack && typeof block.stack === 'string') {
+        const stackPattern = /^(macos|linux)-/;
+        if (block.stack !== 'local' && !stackPattern.test(block.stack)) {
+            throw new YAMLValidationError(`Invalid stack '${block.stack}' in ${filePath}. Stack must be 'local' or start with 'macos-' or 'linux-'`);
+        }
+    }
+    if (block.machine_type) {
+        const validMachineTypes = ['standard', 'performance'];
+        if (!validMachineTypes.includes(block.machine_type)) {
+            throw new YAMLValidationError(`Invalid machine_type '${block.machine_type}' in ${filePath}. Must be one of: ${validMachineTypes.join(', ')}`);
         }
     }
 }

package/dist/src/yaml/parser.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for parser validation of the meta.invarn / meta.cibuild.io blocks.
+ */
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/src/yaml/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../../src/yaml/parser.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/yaml/parser.test.js

@@ -0,0 +1,83 @@
+/**
+ * Unit tests for parser validation of the meta.invarn / meta.cibuild.io blocks.
+ */
+import { describe, test, expect, beforeEach, afterEach } from '@jest/globals';
+import { writeFileSync, mkdtempSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { loadYAMLPipeline, YAMLValidationError } from './parser.js';
+describe('parser validation — meta.invarn block', () => {
+    let workDir;
+    beforeEach(() => {
+        workDir = mkdtempSync(join(tmpdir(), 'cibuild-parser-test-'));
+    });
+    afterEach(() => {
+        rmSync(workDir, { recursive: true, force: true });
+    });
+    function writeYaml(name, content) {
+        const path = join(workDir, name);
+        writeFileSync(path, content, 'utf-8');
+        return path;
+    }
+    test('accepts a well-formed meta.invarn block', () => {
+        const path = writeYaml('good.yml', `format_version: '4'
+meta:
+  invarn:
+    stack: macos-xcode-26.4
+    machine_type: standard
+workflows:
+  primary:
+    steps:
+      - script@1.0.0:
+          inputs:
+            content: echo "test"
+`);
+        expect(() => loadYAMLPipeline(path)).not.toThrow();
+    });
+    test('rejects a meta.invarn block with an invalid stack pattern', () => {
+        const path = writeYaml('bad-stack.yml', `format_version: '4'
+meta:
+  invarn:
+    stack: windows-fancy-1.0
+workflows:
+  primary:
+    steps:
+      - script@1.0.0:
+          inputs:
+            content: echo
+`);
+        expect(() => loadYAMLPipeline(path)).toThrow(YAMLValidationError);
+        expect(() => loadYAMLPipeline(path)).toThrow(/Invalid stack 'windows-fancy-1.0'/);
+    });
+    test('rejects a meta.invarn block with an invalid machine_type', () => {
+        const path = writeYaml('bad-machine.yml', `format_version: '4'
+meta:
+  invarn:
+    stack: linux-docker-android-22.04
+    machine_type: turbo
+workflows:
+  primary:
+    steps:
+      - script@1.0.0:
+          inputs:
+            content: echo
+`);
+        expect(() => loadYAMLPipeline(path)).toThrow(YAMLValidationError);
+        expect(() => loadYAMLPipeline(path)).toThrow(/Invalid machine_type 'turbo'/);
+    });
+    test('still rejects malformed meta.cibuild.io for backward compat', () => {
+        const path = writeYaml('legacy-bad.yml', `format_version: '4'
+meta:
+  cibuild.io:
+    stack: bsd-something
+workflows:
+  primary:
+    steps:
+      - script@1.0.0:
+          inputs:
+            content: echo
+`);
+        expect(() => loadYAMLPipeline(path)).toThrow(/Invalid stack 'bsd-something'/);
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/src/yaml/platform-detector.d.ts

@@ -16,7 +16,7 @@ export declare class PlatformDetector {
     constructor(pipeline: YAMLPipeline, workflow: YAMLWorkflow, workflowName: string);
     /**
      * Detects the platform using 3-tier priority detection
-     * Priority 1: meta.cibuild.io.stack
+     * Priority 1: meta.invarn.stack (preferred), falling back to meta.cibuild.io.stack
      * Priority 2: meta.platform
      * Priority 3: auto-detect from workflow steps
      *