@intentius/chant-lexicon-terraform 0.124.52 → 0.124.55

package/dist/cone.js

@@ -0,0 +1,119 @@
+/**
+ * choudoufu's cone plans (#4545, moved from terragucci's `cone.ts`): `plan
+ * -cone=<base>` plans only the blocks a change touches and every block that
+ * reads them.
+ *
+ * A wave that applies an open pull request plans a live root as the cone of
+ * its change since the pull request's base, as the plan note did. A wave
+ * that applies a merge commit and a drift run plan the whole estate, as do
+ * a root with no `live` block, an estate file (`estate.chdf.hcl`), whose
+ * form choudoufu refuses `-cone` on, and any binary but choudoufu.
+ *
+ * choudoufu's guard can plan the whole estate anyway (no base, a provider,
+ * terraform or live block or the lock file changed, a cone over 30% of the
+ * estate's blocks, and so on). It says why in a warning. A cone plan says
+ * its size in a warning too, and with `-out FILE` writes `FILE.cone.json`:
+ * the cone's base, the commit it named and the addresses it targets.
+ *
+ * The record's targets join the root's plan digest ({@link conePlanDigest}),
+ * so the digest an approval binds names the cone. A wave that plans again
+ * after its approval and finds another cone has another digest, and refuses
+ * as moved. choudoufu's `apply FILE` checks the same record again.
+ *
+ * Pure, apart from reading the record beside a plan file.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { computePlanDigest } from "@intentius/chant/lifecycle/plan-digest";
+/** The flags choudoufu refuses beside `-cone`, or plans in full with: a plan that carries one gets no `-cone`. */
+export const CONE_EXCLUDES = ["-target", "-exclude", "-destroy", "-refresh-only", "-json", "-estate"];
+/** Whether `binary` (a name or a path) is choudoufu. */
+export const isChoudoufu = (binary) => basename(binary) === "choudoufu";
+/**
+ * The `-cone` argument a plan takes: `-cone=<base>` for choudoufu with a
+ * base, on a root that takes it (`live`), when none of `args` is a flag in
+ * {@link CONE_EXCLUDES}. Otherwise none, and the plan is full.
+ */
+export function coneArgs(binary, base, args, cone) {
+    if (!base || !cone || !isChoudoufu(binary))
+        return [];
+    const excluded = args.some((a) => CONE_EXCLUDES.some((f) => a === f || a.startsWith(`${f}=`)));
+    return excluded ? [] : [`-cone=${base}`];
+}
+/** The path of the cone record beside a plan file. */
+export const coneRecordPath = (planFile) => `${planFile}.cone.json`;
+/** The cone record beside `planFile`, or none when there is none or it does not read as one. */
+export function readConeRecord(planFile) {
+    const path = coneRecordPath(planFile);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const r = JSON.parse(readFileSync(path, "utf-8"));
+        if (!r || typeof r.base !== "string" || !Array.isArray(r.targets) || !r.targets.every((t) => typeof t === "string"))
+            return undefined;
+        return { base: r.base, base_sha: typeof r.base_sha === "string" ? r.base_sha : "", targets: [...r.targets].sort() };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The detail of the last warning with this summary in a plan's output, its
+ * lines joined. The binary prints a warning as `Warning: <summary>`, a blank
+ * line, and the detail up to the next blank line or the plan's summary; a box
+ * drawn around it with colour on is stripped.
+ */
+function warningDetail(text, summary) {
+    const lines = text.replace(/\r\n/g, "\n").split("\n").map((l) => l.replace(/^[\s│╷╵]*/, "").trimEnd());
+    let found;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i] !== `Warning: ${summary}`)
+            continue;
+        let j = i + 1;
+        while (j < lines.length && lines[j] === "")
+            j++;
+        const detail = [];
+        for (; j < lines.length && lines[j] !== "" && !/^(Plan: |No changes\.|Changes to Outputs:)/.test(lines[j]); j++)
+            detail.push(lines[j]);
+        found = detail.join(" ").replace(/\s+/g, " ").trim();
+    }
+    return found;
+}
+/**
+ * What a plan run with `-cone=<base>` did, from its output and the record
+ * beside `planFile`. A fallback warning means the whole estate was planned,
+ * even after a cone warning. With no fallback, the record is the cone. With
+ * neither, choudoufu said nothing this reads, and the plan counts as full.
+ */
+export function readPlanCone(output, planFile, base) {
+    const fell = warningDetail(output, "Cone plan fell back to a full plan");
+    if (fell !== undefined) {
+        const m = /^This plan covers the whole estate \(guard ([^)]*)\): (.*?)\.?$/.exec(fell);
+        return { base, fallback: m ? { kind: m[1], reason: m[2] } : { kind: "unknown", reason: fell } };
+    }
+    const record = readConeRecord(planFile);
+    if (!record)
+        return { base, fallback: { kind: "unknown", reason: "choudoufu wrote no cone record beside the plan" } };
+    const size = /: (\d+) of the estate's (\d+) blocks/.exec(warningDetail(output, "Cone plan") ?? "");
+    return { base, ...(size ? { blocks: Number(size[1]), of: Number(size[2]) } : {}), record };
+}
+/** What a cone plan did, in words: its size, or why it planned the whole estate. */
+export function coneText(cone) {
+    if (cone.fallback)
+        return `the whole estate, since ${cone.fallback.reason} (guard ${cone.fallback.kind})`;
+    const n = cone.record?.targets.length ?? 0;
+    const size = cone.blocks !== undefined && cone.of !== undefined ? `${cone.blocks} of the estate's ${cone.of} blocks` : `${n} target${n === 1 ? "" : "s"}`;
+    return `the cone of the change since ${cone.base}, ${size}`;
+}
+/**
+ * A root's plan digest with its cone in it: the plan's own digest, unchanged,
+ * when the plan was full; with a cone, the digest over the plan's digest and
+ * the cone's targets, so an approval of one cone counts for no other. The
+ * digest's kind is terragucci's, so approvals recorded before the move still
+ * name the same digest.
+ */
+export function conePlanDigest(planDigest, cone) {
+    if (!cone?.record)
+        return planDigest;
+    return computePlanDigest("terragucci-cone-plan", { plan: planDigest, targets: [...cone.record.targets].sort() });
+}

package/dist/config.d.ts

@@ -65,8 +65,15 @@ export declare const terraformRootSchema: z.ZodObject<{
     workspace: z.ZodOptional<z.ZodString>;
     /** `-var-file` arguments, in order, relative to `dir`. */
     varFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** `-backend-config` key/value pairs handed to `init`. */
+    /** `-backend-config` key/value pairs handed to `init`, after {@link backendConfigFiles}. */
     backendConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /**
+     * Backend-config files handed to `init` as `-backend-config=<path>`, in
+     * order and before the {@link backendConfig} pairs, relative to `dir`
+     * (chant#4459). The composition reads their `key = "value"` lines as it
+     * reads the pairs, to find a root's state before init.
+     */
+    backendConfigFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     /**
      * The choudoufu estate this root runs against, for a live root whose HCL
      * does not declare one of its own (#2479).
@@ -118,6 +125,16 @@ export declare const terraformRootSchema: z.ZodObject<{
         plan: "plan";
         state: "state";
     }>>;
+    /**
+     * The root is declared only so a change to it brings this project into the
+     * change (#4484). A dns member that declares another cloud's root, so that
+     * an azure change reaches dns, sets it on that root. Change detection
+     * (`changedUnits`) still counts the root; the build and every live read
+     * skip it, so it is never drawn or read as this project's own: its entities
+     * are not built, and `describeResources`, drift and the owned-resource
+     * reads leave it out. An Op step that names the root still runs against it.
+     */
+    signalOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const terraformConfigSchema: z.ZodObject<{
     /**
@@ -164,6 +181,21 @@ export declare const terraformConfigSchema: z.ZodObject<{
         plan: "plan";
         state: "state";
     }>>;
+    /**
+     * Composed runs (#4419, #4438), off unless `enabled` is true. When on, the
+     * `terraform-apply` components a change reaches, and the ones they read,
+     * plan as one plan and apply as one apply of a composed root of `module`
+     * calls, so a value one root creates reaches its readers in that apply. A
+     * component that cannot compose plans wave by wave as without the setting,
+     * and the report says why (`compositionFor` in `compose.ts`).
+     *
+     * `max` caps how many roots compose; a change over it applies wholly in
+     * waves. Default 10.
+     */
+    compose: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
     /** Named root modules. The name is the entity-key prefix, so keep it stable. */
     roots: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         /** Root module directory, relative to the project root (where `chant.config.*` lives). */
@@ -172,8 +204,15 @@ export declare const terraformConfigSchema: z.ZodObject<{
         workspace: z.ZodOptional<z.ZodString>;
         /** `-var-file` arguments, in order, relative to `dir`. */
         varFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        /** `-backend-config` key/value pairs handed to `init`. */
+        /** `-backend-config` key/value pairs handed to `init`, after {@link backendConfigFiles}. */
         backendConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * Backend-config files handed to `init` as `-backend-config=<path>`, in
+         * order and before the {@link backendConfig} pairs, relative to `dir`
+         * (chant#4459). The composition reads their `key = "value"` lines as it
+         * reads the pairs, to find a root's state before init.
+         */
+        backendConfigFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
         /**
          * The choudoufu estate this root runs against, for a live root whose HCL
          * does not declare one of its own (#2479).
@@ -225,20 +264,27 @@ export declare const terraformConfigSchema: z.ZodObject<{
             plan: "plan";
             state: "state";
         }>>;
+        /**
+         * The root is declared only so a change to it brings this project into the
+         * change (#4484). A dns member that declares another cloud's root, so that
+         * an azure change reaches dns, sets it on that root. Change detection
+         * (`changedUnits`) still counts the root; the build and every live read
+         * skip it, so it is never drawn or read as this project's own: its entities
+         * are not built, and `describeResources`, drift and the owned-resource
+         * reads leave it out. An Op step that names the root still runs against it.
+         */
+        signalOnly: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
-    /**
-     * One pulumi workspace member read into the graph (#3179). `chant workspace
-     * graph` writes this into the reader project it makes for a `pulumi` member;
-     * it is not meant to be written by hand. `dir` is the member's directory,
-     * absolute; `label` names the entities. The graph is the checked-in
-     * `stack-export.json` there; the program is never run.
-     */
-    pulumiMember: z.ZodOptional<z.ZodObject<{
-        dir: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type TerraformRootConfig = z.infer<typeof terraformRootSchema>;
+/**
+ * The roots a project owns: `roots` without the ones marked `signalOnly`
+ * (#4484), which only feed change detection. The build and the live reads
+ * take these; `changedUnits` takes every root.
+ */
+export declare function ownRoots<R extends {
+    signalOnly?: boolean;
+}>(roots: Record<string, R> | undefined): Record<string, R>;
 export type TerraformConfig = z.infer<typeof terraformConfigSchema>;
 declare module "@intentius/chant/config" {
     interface ChantConfig {

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB;;;;EAA2C,CAAC;AAClF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;EAA4B,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;IAC9B,0FAA0F;;IAE1F,4EAA4E;;IAE5E,0DAA0D;;IAE1D,0DAA0D;;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;IAEH,+EAA+E;;;;;;IAE/E;;;;;;;;;;;;;;OAcG;;;;;kBAEH,CAAC;AAEH,eAAO,MAAM,qBAAqB;IAChC;;;;;;;OAOG;;;;;;IAEH;;;;;;;OAOG;;;;;;IAEH;;;;;;;;;;;OAWG;;IAEH,6FAA6F;;;;;IAE7F,gFAAgF;;QAxFhF,0FAA0F;;QAE1F,4EAA4E;;QAE5E,0DAA0D;;QAE1D,0DAA0D;;QAE1D;;;;;;;;;;;;;;;;;;;;;;;;WAwBG;;QAEH,+EAA+E;;;;;;QAE/E;;;;;;;;;;;;;;WAcG;;;;;;IAwCH;;;;;;OAMG;;;;;kBAEH,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,WAAW;QACnB,SAAS,CAAC,EAAE,eAAe,CAAC;KAC7B;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB;;;;EAA2C,CAAC;AAClF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;EAA4B,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;IAC9B,0FAA0F;;IAE1F,4EAA4E;;IAE5E,0DAA0D;;IAE1D,4FAA4F;;IAE5F;;;;;OAKG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;IAEH,+EAA+E;;;;;;IAE/E;;;;;;;;;;;;;;OAcG;;;;;IAEH;;;;;;;;OAQG;;kBAEH,CAAC;AAEH,eAAO,MAAM,qBAAqB;IAChC;;;;;;;OAOG;;;;;;IAEH;;;;;;;OAOG;;;;;;IAEH;;;;;;;;;;;OAWG;;IAEH,6FAA6F;;;;;IAE7F;;;;;;;;;;OAUG;;;;;IAOH,gFAAgF;;QA1HhF,0FAA0F;;QAE1F,4EAA4E;;QAE5E,0DAA0D;;QAE1D,4FAA4F;;QAE5F;;;;;WAKG;;QAEH;;;;;;;;;;;;;;;;;;;;;;;;WAwBG;;QAEH,+EAA+E;;;;;;QAE/E;;;;;;;;;;;;;;WAcG;;;;;QAEH;;;;;;;;WAQG;;;kBAyDH,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAEpH;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,WAAW;QACnB,SAAS,CAAC,EAAE,eAAe,CAAC;KAC7B;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC"}

package/dist/config.js

@@ -55,8 +55,15 @@ export const terraformRootSchema = z.strictObject({
     workspace: z.string().optional(),
     /** `-var-file` arguments, in order, relative to `dir`. */
     varFiles: z.array(z.string()).optional(),
-    /** `-backend-config` key/value pairs handed to `init`. */
+    /** `-backend-config` key/value pairs handed to `init`, after {@link backendConfigFiles}. */
     backendConfig: z.record(z.string(), z.string()).optional(),
+    /**
+     * Backend-config files handed to `init` as `-backend-config=<path>`, in
+     * order and before the {@link backendConfig} pairs, relative to `dir`
+     * (chant#4459). The composition reads their `key = "value"` lines as it
+     * reads the pairs, to find a root's state before init.
+     */
+    backendConfigFiles: z.array(z.string()).optional(),
     /**
      * The choudoufu estate this root runs against, for a live root whose HCL
      * does not declare one of its own (#2479).
@@ -101,6 +108,16 @@ export const terraformRootSchema = z.strictObject({
      * every root, for one run.
      */
     observe: terraformObserveDepthSchema.optional(),
+    /**
+     * The root is declared only so a change to it brings this project into the
+     * change (#4484). A dns member that declares another cloud's root, so that
+     * an azure change reaches dns, sets it on that root. Change detection
+     * (`changedUnits`) still counts the root; the build and every live read
+     * skip it, so it is never drawn or read as this project's own: its entities
+     * are not built, and `describeResources`, drift and the owned-resource
+     * reads leave it out. An Op step that names the root still runs against it.
+     */
+    signalOnly: z.boolean().optional(),
 });
 export const terraformConfigSchema = z.strictObject({
     /**
@@ -136,14 +153,31 @@ export const terraformConfigSchema = z.strictObject({
     moduleRoot: z.string().optional(),
     /** The default {@link TerraformRootConfig.observe} for every root that sets none (#4358). */
     observe: terraformObserveDepthSchema.optional(),
-    /** Named root modules. The name is the entity-key prefix, so keep it stable. */
-    roots: z.record(z.string(), terraformRootSchema).default({}),
     /**
-     * One pulumi workspace member read into the graph (#3179). `chant workspace
-     * graph` writes this into the reader project it makes for a `pulumi` member;
-     * it is not meant to be written by hand. `dir` is the member's directory,
-     * absolute; `label` names the entities. The graph is the checked-in
-     * `stack-export.json` there; the program is never run.
+     * Composed runs (#4419, #4438), off unless `enabled` is true. When on, the
+     * `terraform-apply` components a change reaches, and the ones they read,
+     * plan as one plan and apply as one apply of a composed root of `module`
+     * calls, so a value one root creates reaches its readers in that apply. A
+     * component that cannot compose plans wave by wave as without the setting,
+     * and the report says why (`compositionFor` in `compose.ts`).
+     *
+     * `max` caps how many roots compose; a change over it applies wholly in
+     * waves. Default 10.
      */
-    pulumiMember: z.strictObject({ dir: z.string().min(1), label: z.string().optional() }).optional(),
+    compose: z
+        .strictObject({
+        enabled: z.boolean(),
+        max: z.number().int().min(2).optional(),
+    })
+        .optional(),
+    /** Named root modules. The name is the entity-key prefix, so keep it stable. */
+    roots: z.record(z.string(), terraformRootSchema).default({}),
 });
+/**
+ * The roots a project owns: `roots` without the ones marked `signalOnly`
+ * (#4484), which only feed change detection. The build and the live reads
+ * take these; `changedUnits` takes every root.
+ */
+export function ownRoots(roots) {
+    return Object.fromEntries(Object.entries(roots ?? {}).filter(([, r]) => r.signalOnly !== true));
+}

package/dist/cost-hold.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The terraform lexicon's preset for an op wave's cost hold (#4545,
+ * `holds.cost` on the spec): infracost over each root's plan document, the
+ * `show -json` file `terraform-apply`'s plan names as `artifact.planJson`.
+ *
+ * ```ts
+ * const spec = { ..., step: { kind: "terraform-apply", root: "{target}" }, holds: { cost: terraformCostHold({ approveAbove: 100 }) } };
+ * ```
+ *
+ * The shape is core's `OpWaveCostHold`, written out here so the lexicon
+ * builds against a core without it.
+ */
+/** infracost's own command over one plan document. */
+export declare const INFRACOST_ARGV: readonly ["infracost", "breakdown", "--path", "{planJson}", "--format", "json", "--log-level", "error"];
+export interface TerraformCostHold {
+    command: string[];
+    approveAbove: number;
+    format: "infracost";
+    currency?: string;
+}
+/** A cost hold that prices each root with infracost, waiting over `approveAbove` a month. `command` replaces infracost's argv; it must name `{planJson}`. */
+export declare function terraformCostHold(options: {
+    approveAbove: number;
+    currency?: string;
+    command?: string[];
+}): TerraformCostHold;
+//# sourceMappingURL=cost-hold.d.ts.map

package/dist/cost-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-hold.d.ts","sourceRoot":"","sources":["../src/cost-hold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,YAAI,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAEtI,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6JAA6J;AAC7J,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,iBAAiB,CAI7H"}

package/dist/cost-hold.js

@@ -0,0 +1,21 @@
+/**
+ * The terraform lexicon's preset for an op wave's cost hold (#4545,
+ * `holds.cost` on the spec): infracost over each root's plan document, the
+ * `show -json` file `terraform-apply`'s plan names as `artifact.planJson`.
+ *
+ * ```ts
+ * const spec = { ..., step: { kind: "terraform-apply", root: "{target}" }, holds: { cost: terraformCostHold({ approveAbove: 100 }) } };
+ * ```
+ *
+ * The shape is core's `OpWaveCostHold`, written out here so the lexicon
+ * builds against a core without it.
+ */
+/** infracost's own command over one plan document. */
+export const INFRACOST_ARGV = ["infracost", "breakdown", "--path", "{planJson}", "--format", "json", "--log-level", "error"];
+/** A cost hold that prices each root with infracost, waiting over `approveAbove` a month. `command` replaces infracost's argv; it must name `{planJson}`. */
+export function terraformCostHold(options) {
+    const command = options.command ?? [...INFRACOST_ARGV];
+    if (!command.some((a) => a.includes("{planJson}")))
+        throw new Error("terraformCostHold: the command must name {planJson}, the root's plan document");
+    return { command, approveAbove: options.approveAbove, format: "infracost", ...(options.currency ? { currency: options.currency } : {}) };
+}

package/dist/describe-resources.d.ts

@@ -120,6 +120,14 @@
  * not-observed, then foreign, then adoptable, then owned, and a block whose
  * instances are all absent is absent. Partial knowledge is not knowledge,
  * which is the same rule choudoufu applies to its own `INCOMPLETE_BLOCK`.
+ * The precedence is core's `TERRAFORM_INSTANCE_ROLLUP` and the rollup is
+ * core's `rollupInstances` (`@intentius/chant/instance-nodes`, #4454), the
+ * one place it is written.
+ *
+ * The block's verdict is not the whole answer. A present block also carries
+ * each instance's own verdict on `instances`, keyed as Terraform prints it
+ * (`[0]`, `["a"]`), which the live graph draws as an instance node under the
+ * block node (#4454). The state read does the same with the rows it found.
  *
  * ## What is readable at all
  *
@@ -195,6 +203,31 @@
  * The cost is two refreshes of the estate per read, run one after the other
  * so they never share the root's cache file.
  *
+ * ## Engine facts on a live root (#4528)
+ *
+ * After `live-plan -json` answers, the same document is handed to `choudoufu
+ * live-graph -json -from-plan=<file>` (choudoufu#2285), which builds the
+ * root's graph from the configuration and that file alone: no second live
+ * read, so the facts and the verdicts above come from one refresh (choudoufu
+ * #1014, the #4520 ruling Q3). `<file>` is the `<root>.live-plan.json`
+ * written under {@link TERRAFORM_LIVE_PLAN_DIR_ENV} when the caller asked
+ * for it, and otherwise a copy in a temporary directory removed afterwards.
+ *
+ * The document's node ids are choudoufu's addresses (the ruling's Q2). A
+ * block node maps to its entity with {@link entityKeyFor}; an instance node
+ * (`instanceOf` set) maps to its block's entity, and its facts go on that
+ * block's `instances` entry of the same address, from which core's
+ * `observedInstanceNodeId` draws the instance node. Each node's `facts` land
+ * on `ResourceMetadata.facts` or `InstanceObservation.facts`, and edges with
+ * a grain land on the observation's `edges`, endpoints mapped the same way
+ * ({@link readEngineGraph}). Facts are never read for a decision: ownership
+ * and the change set keep reading the verdicts above.
+ *
+ * A choudoufu without the command, older than
+ * `MIN_CHOUDOUFU_GRAPH_VERSION`, answers with a usage error: `facts` stay
+ * absent, the root gets one note, and the rest of the read is unchanged. Any
+ * other failure of the graph read degrades the same way, with its own note.
+ *
  * ## Nothing from `values` is surfaced
  *
  * A state row's `values` are the resource's full attribute set, secrets
@@ -206,10 +239,13 @@
 import type { DescribeResourcesResult, ResourceMetadata, TeardownEnumeration } from "@intentius/chant/lexicon";
 import { type DeclaredEntity, type UnobservedReason } from "@intentius/chant/observation";
 import type { OwnershipMarker } from "@intentius/chant/ownership";
-import { choudoufuLiveLs, choudoufuLivePlanDocument, terraformInit, terraformPlanRead, terraformShow } from "./op/activities/terraform.js";
+import type { EngineFacts } from "@intentius/chant/engine-facts";
+import type { IREdge } from "@intentius/chant/graph-ir";
+import { choudoufuLiveGraph, choudoufuLiveLs, choudoufuLivePlanDocument, terraformInit, terraformPlanRead, terraformShow } from "./op/activities/terraform.js";
 import type { TerraformObserveDepth } from "./config.js";
 export { TERRAFORM_STATE_OWNERSHIP_KEYS } from "./state-ownership.js";
 export { TERRAFORM_LIVE_MARKER_KEYS } from "./live-ownership.js";
+export { LIVE_PLAN_OMISSION_REASONS } from "./live-plan-reasons.js";
 /** One row out of `values.root_module.resources[]`, at any module depth. */
 export interface StateResourceRow {
     /** Fully qualified terraform address, `module.<name>.` prefixes included. */
@@ -323,16 +359,6 @@ export interface LivePlanIndex {
  * degrade to "this section said nothing", never to a throw.
  */
 export declare function indexLivePlan(document: unknown): LivePlanIndex;
-/**
- * choudoufu's omission reason codes, mapped onto chant's total vocabulary
- * (`internal/live/projection/result.go`). `"absent"` is not an
- * {@link UnobservedReason}: it is the tri-state's OBSERVED-ABSENT, the one
- * omission that is a claim of knowledge rather than of ignorance.
- *
- * A code this table does not know maps to `read-failed`, which is the safe
- * direction: no NOT-OBSERVED verdict ever becomes a create or a delete.
- */
-export declare const LIVE_PLAN_OMISSION_REASONS: Readonly<Record<string, UnobservedReason | "absent">>;
 /**
  * Every instance address in the document belonging to the declared block
  * `address`. Exported for the behaviour request builder (`./behaviour/`,
@@ -387,6 +413,35 @@ export declare function classifyLiveInstance(address: string, index: LivePlanInd
 export declare const TERRAFORM_LIVE_PLAN_DIR_ENV = "CHANT_TERRAFORM_LIVE_PLAN_DIR";
 /** The file {@link TERRAFORM_LIVE_PLAN_DIR_ENV} names for a root: the root's name, made safe for a file name. */
 export declare function livePlanDocumentFile(root: string): string;
+/** {@link readEngineGraph}'s answer: facts and edges keyed in chant's id space. */
+export interface EngineGraphRead {
+    /** Facts of a block node, by entity key. */
+    blocks: Map<string, EngineFacts>;
+    /** Facts of an instance node, by its block's entity key, then by the instance address. */
+    instances: Map<string, Map<string, EngineFacts>>;
+    /** Edges with a grain, endpoints as live graph node ids. */
+    edges: IREdge[];
+}
+/**
+ * Read an engine graph document (`choudoufu live-graph -json`, chant#4527's
+ * schema) for one root into chant's id space. Node ids are choudoufu's
+ * addresses (the #4520 ruling, Q2): a block node is the entity
+ * {@link entityKeyFor} names; an instance node (`instanceOf`) belongs to its
+ * block's entity, and as an edge endpoint it is the live instance node id
+ * core's `observedInstanceNodeId` gives. A node with no address (an estate
+ * the configuration reads, `estate:<name>`) has no chant entity, so its
+ * edges are left out. Edges keep their grain; one without a grain is left out.
+ *
+ * Throws when the document is not an engine graph document.
+ */
+export declare function readEngineGraph(root: string, document: unknown): EngineGraphRead;
+/**
+ * `resources` with {@link readEngineGraph}'s facts on them: a block's on
+ * `ResourceMetadata.facts`, an instance's on its `instances` entry of the
+ * same address. Nothing else changes, and nothing is added for an entity the
+ * read did not return.
+ */
+export declare function withEngineFacts(resources: Record<string, ResourceMetadata>, read: EngineGraphRead): Record<string, ResourceMetadata>;
 /** One `items[]` entry of a `live-ls -json` listing. */
 export interface LiveLsItem {
     /** ARN or other stable identity. */
@@ -446,7 +501,8 @@ export interface LiveEstateOptions {
     roots?: string[];
 }
 /**
- * Every live root the project declares, in config order. Reads the project
+ * Every live root the project declares, in config order, leaving out a
+ * `signalOnly` one (#4484). Reads the project
  * config the same way the activities do, so `terraform.roots` is read once
  * and the same answer reaches both.
  */
@@ -493,6 +549,12 @@ export interface TerraformReadDeps {
     /** The document alone (chant #2498): this reader indexes it and never reads the human render. */
     livePlan: typeof choudoufuLivePlanDocument;
     liveLs: typeof choudoufuLiveLs;
+    /**
+     * The engine graph read on a live root (#4528). Optional so a test that
+     * never asks for facts need not stub it; omitted, no facts are read and no
+     * note is added.
+     */
+    liveGraph?: typeof choudoufuLiveGraph;
     /**
      * The plan depth's read (#4358). Optional so a test that never asks for the
      * plan depth need not stub it; omitted, the real activity runs.

package/dist/describe-resources.d.ts.map

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