@intentius/terragucci 0.4.9 → 0.4.10

package/dist/terragucci.schema.json

@@ -161,9 +161,16 @@
               "minLength": 1
             }
           }
+        },
+        "compose": {
+          "type": "boolean"
+        },
+        "compose_max": {
+          "type": "integer",
+          "minimum": 2
         }
       },
-      "description": "The canary wave, the jobs one wave spreads across, and extra apply order."
+      "description": "The canary wave, the jobs one wave spreads across, extra apply order, and whether a change's roots apply as one composed run."
     },
     "drift": {
       "anyOf": [
@@ -1810,9 +1817,16 @@
                   "minLength": 1
                 }
               }
+            },
+            "compose": {
+              "type": "boolean"
+            },
+            "compose_max": {
+              "type": "integer",
+              "minimum": 2
             }
           },
-          "description": "The canary wave, the jobs one wave spreads across, and extra apply order."
+          "description": "The canary wave, the jobs one wave spreads across, extra apply order, and whether a change's roots apply as one composed run."
         },
         "drift": {
           "anyOf": [

package/dist/types.d.ts

@@ -385,11 +385,15 @@ export interface ProjectSettings {
     /**
      * `canary`: globs for the wave that applies first. `jobs`: the most jobs one wave's roots or units spread across (GitHub and Forgejo).
      * `after`: plain roots only, for a root or glob the roots or globs it applies after, beside the order its `terraform_remote_state` reads give.
+     * `compose`: plain roots only, opt-in beside the waves: the roots a change reaches plan as one composed run and apply as one (./compose.ts). Default false.
+     * `compose_max`: the most roots one composed run covers; a change that reaches more applies in waves. Default 10.
      */
     waves?: {
         canary?: string[];
         jobs?: number;
         after?: Record<string, string[]>;
+        compose?: boolean;
+        compose_max?: number;
     };
     /** A cron schedule for tf-drift, or false. */
     drift?: string | false;
@@ -778,6 +782,10 @@ export interface RegistrySettings {
     download?: "tarball" | "git-tags" | "oci";
 }
 /** Why a control repo's projects take no `rollouts` job: each project's pipeline sees only its own roots. */
+/** Why `waves.compose` is refused with `binary: choudoufu`: one run would have to carry several estates (INTENTIUS/choudoufu#2059). */
+export declare const COMPOSE_NOT_CHOUDOUFU = "a composed run splits one working state back into each root's state, and choudoufu keeps no state to split, so leave waves.compose unset with binary: choudoufu";
+/** Why `waves.compose` is refused in a Terragrunt repo. */
+export declare const COMPOSE_NOT_TERRAGRUNT = "a Terragrunt repo's units apply through terragrunt, one run per unit, so they cannot compose; leave waves.compose unset";
 export declare const WAVE_JOBS_NOT_PR_APPLY = "apply.when: pull-request applies every wave in the one job a comment starts, so a wave has no jobs to spread across; leave waves.jobs unset";
 /** Why a control repo's projects take no `rollouts` job: each project's pipeline sees only its own roots. */
 export declare const ROLLOUTS_SINGLE_REPO = "a control repo's rollout plans its waves across every project, and a project's pipeline sees only its own roots; leave rollouts unset and run terragucci respond rollout --mode apply on a schedule in the control repo";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/terragucci",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "The whole Terraform lifecycle, handled: one config file, generated pipelines for GitHub, GitLab and Forgejo.",
   "license": "Apache-2.0",
   "type": "module",