@intentius/chant 0.124.27 → 0.124.29

package/dist/build-params.js

@@ -27,7 +27,11 @@ function coerce(name, raw, def, errors) {
  * Resolve a project's declared build-time parameters against one build's
  * supplied inputs. Precedence per parameter, most to least specific:
  * `cli` (`--param name=value`) > `fromFile` (`--params-file`) > the
- * parameter's own declared `env` mapping (only if set) > `def.default`.
+ * parameter's own declared `env` mapping (only if set) > a workspace flag's
+ * value for the build's environment (`input.flags`, #4024) > `def.default`.
+ * When `input.flags.gated` is set, a flag-backed parameter takes none of the
+ * first three: a value from any of them is a build error, so a flag can't be
+ * flipped around the environment's gate.
  *
  * A parameter with no declared `default` and no value from any source is a
  * build error, not a silently-`undefined` value — a build-time parameter
@@ -60,9 +64,24 @@ export function resolveBuildParams(defs, input) {
             errors.push(`unknown build parameter "${key}" (from --params-file) — not declared in chant.config.ts's buildParams`);
         }
     }
+    const flags = input.flags;
+    for (const [name, binding] of Object.entries(flags?.byParam ?? {})) {
+        if (!(name in declared)) {
+            errors.push(`flag "${binding.flag}" sets build parameter "${name}", which chant.config.ts's buildParams does not declare`);
+        }
+    }
     for (const [name, def] of Object.entries(declared)) {
         let raw;
         let source;
+        const binding = flags?.byParam[name];
+        if (binding && flags?.gated) {
+            // #4024: in an environment with a gate, the flag record is the only way to set the parameter.
+            const around = name in cli ? "--param" : name in fromFile ? "--params-file" : def.env && env[def.env] !== undefined ? `the env var ${def.env}` : null;
+            if (around !== null) {
+                errors.push(flagGateRefusal(name, binding.flag, flags.env, around));
+                continue;
+            }
+        }
         if (name in cli) {
             raw = cli[name];
             source = "cli";
@@ -80,6 +99,10 @@ export function resolveBuildParams(defs, input) {
             raw = env[def.env];
             source = "env";
         }
+        else if (binding && binding.value !== undefined) {
+            raw = binding.value;
+            source = `flag:${binding.flag}`;
+        }
         else if (def.default !== undefined) {
             raw = def.default;
             source = "default";
@@ -102,6 +125,13 @@ export function resolveBuildParams(defs, input) {
     }
     return { provenance, errors };
 }
+/**
+ * The build error for a flag-backed parameter that `around` (`--param`,
+ * `--params-file` or an env var) set in an environment with a gate (#4024).
+ */
+export function flagGateRefusal(name, flag, env, around) {
+    return `build parameter "${name}" is backed by the flag "${flag}", and "${env}" has a gate, so ${around} can't set it; change the flag record and let the change go through the gate`;
+}
 /** Project the resolved provenance records down to a plain `{ name: value }` map — what actually gets bound to `params.<name>` (see ./params.ts). */
 export function buildParamValues(provenance) {
     return Object.fromEntries(provenance.map((p) => [p.name, p.value]));

package/dist/change-set-graph.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Place a change set's entries on the graph (#4022).
+ *
+ * A reader such as behold draws the graph `chant graph --format ir` and
+ * `chant workspace graph` print, and wants each change of a change set on the
+ * node it changes. The planner's address is not that node's id: a terraform
+ * plan names an instance, `module.app.terraform_data.instance[0]`, where the
+ * graph has one node per block, `<root>/module.app/terraform_data.instance`
+ * (the terraform lexicon's entity key, `hcl/parse.ts`). So chant maps the
+ * address itself, against the node ids of the graph it read, and a reader
+ * never derives an id.
+ *
+ * {@link changeSetNodeCandidates} lists the ids an entry's address can have,
+ * by planner. {@link mapChangeSetToGraph} keeps the first that the graph
+ * holds and puts the member's name in front, as `chant workspace graph`
+ * does, with the node's source file as `source` when the graph gives one
+ * (#4025). An entry whose address the graph does not hold gets `node: null`:
+ * a delete of a block the source no longer declares, or a warden or sql
+ * change outside the graph.
+ *
+ * Like `./change-set.ts`, this imports nothing at run time, so it bundles
+ * into one file with the change-set code.
+ */
+import type { ChangeSetDocument, ChangeSetEntry } from "./change-set.js";
+/** The graph a document is mapped onto: the node ids of one member's own IR. */
+export interface ChangeSetGraphNodes {
+    /** The workspace member whose graph it is, its path of names joined with `/` when nested, or null outside a workspace. */
+    member: string | null;
+    /** The commit the graph was read at, or null when unknown. */
+    at: string | null;
+    /** Every node id of the member's `chant graph --format ir`, without the member in front. */
+    ids: Iterable<string>;
+    /**
+     * The source file of each node that has one (#4025), by the same ids, as a
+     * path from the repository root. An entry mapped onto such a node gets it
+     * as `source`.
+     */
+    sources?: ReadonlyMap<string, string>;
+}
+/**
+ * The block key the terraform lexicon gives an address in its root:
+ * `module.<call>/` for each module call, then the block's own address with
+ * no index. `module.app.terraform_data.instance[0]` is
+ * `module.app/terraform_data.instance`.
+ */
+export declare function terraformBlockKey(address: string): string | undefined;
+/**
+ * The ids, in the order tried, that an entry's address can have in its
+ * member's graph IR:
+ *
+ * - `chant`: the address, which is the entity name the IR uses as its id.
+ * - `terraform`, `tofu`, `choudoufu`: `<root>/<block key>`, the root being
+ *   the change-set member (`terraformBlockKey`), then the address.
+ * - `warden`, `sql`: the address.
+ */
+export declare function changeSetNodeCandidates(entry: Pick<ChangeSetEntry, "member" | "planner" | "address">): string[];
+/**
+ * The document with each entry's `node` set from `graph`, and `graph`
+ * recording which graph it was. A null `graph` (none could be read) gives
+ * every entry `node: null`. The digest is unchanged: `node` is not hashed.
+ */
+export declare function mapChangeSetToGraph(doc: ChangeSetDocument, graph: ChangeSetGraphNodes | null): ChangeSetDocument;
+//# sourceMappingURL=change-set-graph.d.ts.map

package/dist/change-set-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-set-graph.d.ts","sourceRoot":"","sources":["../src/change-set-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEtE,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,0HAA0H;IAC1H,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,4FAA4F;IAC5F,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AA+BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAW/G;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,iBAAiB,CAehH"}

package/dist/change-set-graph.js

@@ -0,0 +1,130 @@
+/**
+ * Place a change set's entries on the graph (#4022).
+ *
+ * A reader such as behold draws the graph `chant graph --format ir` and
+ * `chant workspace graph` print, and wants each change of a change set on the
+ * node it changes. The planner's address is not that node's id: a terraform
+ * plan names an instance, `module.app.terraform_data.instance[0]`, where the
+ * graph has one node per block, `<root>/module.app/terraform_data.instance`
+ * (the terraform lexicon's entity key, `hcl/parse.ts`). So chant maps the
+ * address itself, against the node ids of the graph it read, and a reader
+ * never derives an id.
+ *
+ * {@link changeSetNodeCandidates} lists the ids an entry's address can have,
+ * by planner. {@link mapChangeSetToGraph} keeps the first that the graph
+ * holds and puts the member's name in front, as `chant workspace graph`
+ * does, with the node's source file as `source` when the graph gives one
+ * (#4025). An entry whose address the graph does not hold gets `node: null`:
+ * a delete of a block the source no longer declares, or a warden or sql
+ * change outside the graph.
+ *
+ * Like `./change-set.ts`, this imports nothing at run time, so it bundles
+ * into one file with the change-set code.
+ */
+/**
+ * Split a terraform address into its dot-separated parts, dropping every
+ * `[...]` index. A quoted key may hold `.` or `]`, so quotes are honoured.
+ */
+function terraformParts(address) {
+    const parts = [];
+    let current = "";
+    let depth = 0;
+    let quoted = false;
+    for (let i = 0; i < address.length; i++) {
+        const c = address[i];
+        if (depth > 0) {
+            if (quoted) {
+                if (c === "\\")
+                    i++;
+                else if (c === '"')
+                    quoted = false;
+            }
+            else if (c === '"')
+                quoted = true;
+            else if (c === "]")
+                depth--;
+            continue;
+        }
+        if (c === "[")
+            depth++;
+        else if (c === ".") {
+            parts.push(current);
+            current = "";
+        }
+        else
+            current += c;
+    }
+    parts.push(current);
+    return parts.filter((p) => p.length > 0);
+}
+/**
+ * The block key the terraform lexicon gives an address in its root:
+ * `module.<call>/` for each module call, then the block's own address with
+ * no index. `module.app.terraform_data.instance[0]` is
+ * `module.app/terraform_data.instance`.
+ */
+export function terraformBlockKey(address) {
+    const parts = terraformParts(address);
+    const scope = [];
+    let i = 0;
+    while (parts[i] === "module" && i + 1 < parts.length) {
+        scope.push(`module.${parts[i + 1]}`);
+        i += 2;
+    }
+    const rest = parts.slice(i);
+    let block;
+    if (rest[0] === "data" && rest.length >= 3)
+        block = `data.${rest[1]}.${rest[2]}`;
+    else if (rest.length >= 2)
+        block = `${rest[0]}.${rest[1]}`;
+    else if (rest.length === 0 && scope.length > 0) {
+        // The module call itself is a block of its caller.
+        const call = scope.pop();
+        block = call;
+    }
+    if (block === undefined)
+        return undefined;
+    return [...scope, block].join("/");
+}
+/**
+ * The ids, in the order tried, that an entry's address can have in its
+ * member's graph IR:
+ *
+ * - `chant`: the address, which is the entity name the IR uses as its id.
+ * - `terraform`, `tofu`, `choudoufu`: `<root>/<block key>`, the root being
+ *   the change-set member (`terraformBlockKey`), then the address.
+ * - `warden`, `sql`: the address.
+ */
+export function changeSetNodeCandidates(entry) {
+    switch (entry.planner) {
+        case "terraform":
+        case "tofu":
+        case "choudoufu": {
+            const key = terraformBlockKey(entry.address);
+            return key === undefined ? [entry.address] : [`${entry.member}/${key}`, entry.address];
+        }
+        default:
+            return [entry.address];
+    }
+}
+/**
+ * The document with each entry's `node` set from `graph`, and `graph`
+ * recording which graph it was. A null `graph` (none could be read) gives
+ * every entry `node: null`. The digest is unchanged: `node` is not hashed.
+ */
+export function mapChangeSetToGraph(doc, graph) {
+    if (graph === null) {
+        return { ...doc, entries: doc.entries.map((e) => ({ ...e, node: null })), graph: null };
+    }
+    const ids = new Set(graph.ids);
+    const prefix = graph.member ? `${graph.member}/` : "";
+    return {
+        ...doc,
+        entries: doc.entries.map((e) => {
+            const id = changeSetNodeCandidates(e).find((c) => ids.has(c));
+            const source = id === undefined ? undefined : graph.sources?.get(id);
+            return { ...e, node: id === undefined ? null : `${prefix}${id}`, ...(source !== undefined ? { source } : {}) };
+        }),
+        graph: { member: graph.member, at: graph.at },
+    };
+}

package/dist/change-set.d.ts

@@ -102,6 +102,25 @@ export interface ChangeSetEntry {
     /** The estate, environment or org the change lands in. */
     scope?: string;
     attributes: ChangeSetAttribute[];
+    /**
+     * The graph node the entry changes, as `chant graph --format ir` and
+     * `chant workspace graph` name it (#4022): `<member>/<id>` inside a
+     * workspace. Null when the graph holds no node for the address, such as
+     * a delete of a block the source no longer declares. Absent until the
+     * document is mapped onto a graph (`./change-set-graph.ts`), and never
+     * part of the digest.
+     */
+    node?: string | null;
+    /**
+     * The source file that declares the entry's node, from the repository
+     * root (#4025): the node's `sourceLoc.file` in the member's graph IR, with
+     * the member's directory in front. Set beside `node` when a stored change
+     * set is mapped onto a graph whose node has a source location, absent
+     * otherwise. Like `node`, never part of the digest. The overlap report
+     * attributes the entry to a work item through the commits that changed
+     * this file.
+     */
+    source?: string;
 }
 /** Something a planner could not read, so the plan says nothing about it. */
 export interface ChangeSetHole {
@@ -182,6 +201,29 @@ export interface ChangeSetDocument {
     /** Triggered actions, sorted by member and address. Absent when no member runs one. */
     sideEffects?: ChangeSetSideEffect[];
     summary: ChangeSetSummary;
+    /**
+     * The graph the entries' `node` ids come from (#4022): the workspace member
+     * whose graph it is, or null outside a workspace, and the commit it was
+     * read at, or null when that is unknown. Null when no graph could be read,
+     * so every `node` is null. Absent on a document never mapped. Not hashed.
+     */
+    graph?: ChangeSetGraph | null;
+    /**
+     * The release this change set was planned for (#4045): the `releaseDigest`
+     * of the release a `components promote --release` deploys. Set with
+     * `environment` on a release gate's document, absent on every other. Part
+     * of the digest when present, so a stored document names the one release
+     * and environment its gate bound, and two releases whose plans read the
+     * same never share a document or an approval.
+     */
+    releaseDigest?: string;
+    /** The environment this change set was planned for (#4045), set with `releaseDigest`. Part of the digest when present. */
+    environment?: string;
+}
+/** Where a document's node ids come from. */
+export interface ChangeSetGraph {
+    member: string | null;
+    at: string | null;
 }
 /**
  * The set digest over members' plan digests: `computePlanDigest("change-set",
@@ -196,19 +238,29 @@ export declare function changeSetDigest(members: ReadonlyArray<Pick<ChangeSetMem
 /**
  * The document's digest: `computePlanDigest("change-set-document", …)` over
  * the set digest ({@link changeSetDigest}), each member's name, status and
- * holes, the entries and the side effects. Members are sorted by name and
+ * holes, the entries (without their graph `node`) and the side effects.
+ * Members are sorted by name and
  * entries and side effects by the keys {@link composeChangeSet} sorts them by,
  * so order makes no difference.
  *
  * A provisional member is left out, with its entries and side effects, as
  * the set digest leaves it out: no approval of the document covers it.
+ *
+ * A release gate's document (#4045) also hashes the `releaseDigest` and
+ * `environment` it was planned for. A document without them hashes as it
+ * always has, so no earlier digest moves.
  */
-export declare function changeSetDocumentDigest(doc: Pick<ChangeSetDocument, "members" | "entries" | "sideEffects">): string;
+export declare function changeSetDocumentDigest(doc: Pick<ChangeSetDocument, "members" | "entries" | "sideEffects" | "releaseDigest" | "environment">): string;
 /** The summary of a set of members and entries. */
 export declare function summarizeChangeSet(members: ChangeSetMember[], entries: ChangeSetEntry[]): ChangeSetSummary;
 export interface ComposeChangeSetOptions {
     /** The chant version to record in `chant`. */
     chant?: string;
+    /** The release and environment a release gate's change set was planned for (#4045), recorded and hashed. */
+    planned?: {
+        releaseDigest: string;
+        environment: string;
+    };
 }
 /**
  * Join adapters' parts into one document: members sorted by name, entries
@@ -222,7 +274,14 @@ export declare function composeChangeSet(parts: ReadonlyArray<ChangeSetPart>, op
  * effects give ({@link changeSetDocumentDigest}). A document that names a
  * member twice has no digest and is not verified.
  */
-export declare function verifyChangeSetDigest(doc: Pick<ChangeSetDocument, "digest" | "members" | "entries" | "sideEffects">): boolean;
+export declare function verifyChangeSetDigest(doc: Pick<ChangeSetDocument, "digest" | "members" | "entries" | "sideEffects" | "releaseDigest" | "environment">): boolean;
+/**
+ * Whether a change set changes nothing (ws-104 question 6, #4045): it has at
+ * least one member, every member planned, none failed or provisional, no
+ * member has a hole, and every entry is a `no-op` or a `read`. A release
+ * gate over such a document passes without an approval.
+ */
+export declare function isEmptyChangeSet(doc: Pick<ChangeSetDocument, "members" | "entries">): boolean;
 export interface LifecyclePlanPartInput {
     member: string;
     /** `chant lifecycle plan <env> --json`, parsed. */

package/dist/change-set.d.ts.map

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

package/dist/change-set.js

@@ -78,12 +78,17 @@ export function changeSetDigest(members) {
 /**
  * The document's digest: `computePlanDigest("change-set-document", …)` over
  * the set digest ({@link changeSetDigest}), each member's name, status and
- * holes, the entries and the side effects. Members are sorted by name and
+ * holes, the entries (without their graph `node`) and the side effects.
+ * Members are sorted by name and
  * entries and side effects by the keys {@link composeChangeSet} sorts them by,
  * so order makes no difference.
  *
  * A provisional member is left out, with its entries and side effects, as
  * the set digest leaves it out: no approval of the document covers it.
+ *
+ * A release gate's document (#4045) also hashes the `releaseDigest` and
+ * `environment` it was planned for. A document without them hashes as it
+ * always has, so no earlier digest moves.
  */
 export function changeSetDocumentDigest(doc) {
     const provisional = new Set(doc.members.filter((m) => m.provisional === true).map((m) => m.member));
@@ -91,9 +96,19 @@ export function changeSetDocumentDigest(doc) {
         .filter((m) => !provisional.has(m.member))
         .map((m) => ({ member: m.member, status: m.status, holes: m.holes }))
         .sort((a, b) => byString(a.member, b.member));
-    const entries = doc.entries.filter((e) => !provisional.has(e.member)).sort((a, b) => byString(entryKey(a), entryKey(b)));
+    // An entry's graph node (#4022) and its source file (#4025) say where on
+    // the graph the change is, not what the plan does, so they stay outside
+    // the digest: mapping a stored
+    // document onto a graph never moves the value its gate bound.
+    const entries = doc.entries
+        .filter((e) => !provisional.has(e.member))
+        .map(({ node: _node, source: _source, ...e }) => e)
+        .sort((a, b) => byString(entryKey(a), entryKey(b)));
     const sideEffects = (doc.sideEffects ?? []).filter((s) => !provisional.has(s.member)).sort(bySideEffect);
-    return computePlanDigest("change-set-document", { set: changeSetDigest(doc.members), members, entries, sideEffects });
+    const planned = doc.releaseDigest !== undefined || doc.environment !== undefined
+        ? { planned: { releaseDigest: doc.releaseDigest ?? null, environment: doc.environment ?? null } }
+        : {};
+    return computePlanDigest("change-set-document", { set: changeSetDigest(doc.members), members, entries, sideEffects, ...planned });
 }
 /** The summary of a set of members and entries. */
 export function summarizeChangeSet(members, entries) {
@@ -155,12 +170,14 @@ export function composeChangeSet(parts, options = {}) {
     const sideEffects = parts
         .flatMap((p) => (p.sideEffects ?? []).map((s) => ({ member: p.member.member, ...s })))
         .sort(bySideEffect);
-    const digest = changeSetDocumentDigest({ members, entries, sideEffects });
+    const planned = options.planned ? { releaseDigest: options.planned.releaseDigest, environment: options.planned.environment } : {};
+    const digest = changeSetDocumentDigest({ members, entries, sideEffects, ...planned });
     return {
         $schema: CHANGE_SET_SCHEMA_ID,
         contract: CHANGE_SET_CONTRACT,
         ...(options.chant !== undefined ? { chant: options.chant } : {}),
         digest,
+        ...planned,
         members,
         entries,
         ...(sideEffects.length > 0 ? { sideEffects } : {}),
@@ -180,6 +197,21 @@ export function verifyChangeSetDigest(doc) {
         return false;
     }
 }
+/**
+ * Whether a change set changes nothing (ws-104 question 6, #4045): it has at
+ * least one member, every member planned, none failed or provisional, no
+ * member has a hole, and every entry is a `no-op` or a `read`. A release
+ * gate over such a document passes without an approval.
+ */
+export function isEmptyChangeSet(doc) {
+    if (doc.members.length === 0)
+        return false;
+    for (const m of doc.members) {
+        if (m.status !== "planned" || m.provisional === true || m.holes.length > 0)
+            return false;
+    }
+    return doc.entries.every((e) => e.action === "no-op" || e.action === "read");
+}
 function lifecycleAttributes(entry) {
     const because = new Set(entry.disruptionBecause ?? []);
     return (entry.deltas ?? []).map((d) => ({

package/dist/chant-version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The installed chant's version, read from `@intentius/chant`'s own
+ * package.json, or "0.0.0" when it can't be read. The path is the same from
+ * `src/` and `dist/`, so it holds whether chant runs from source or from its
+ * build. Kept outside `cli/` so that a module the Op entry loads, such as the
+ * run-event writer (#4041), can name the version without loading the CLI.
+ */
+export declare const CHANT_VERSION: string;
+//# sourceMappingURL=chant-version.d.ts.map

package/dist/chant-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chant-version.d.ts","sourceRoot":"","sources":["../src/chant-version.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,MAMxB,CAAC"}

package/dist/chant-version.js

@@ -0,0 +1,16 @@
+import { createRequire } from "node:module";
+/**
+ * The installed chant's version, read from `@intentius/chant`'s own
+ * package.json, or "0.0.0" when it can't be read. The path is the same from
+ * `src/` and `dist/`, so it holds whether chant runs from source or from its
+ * build. Kept outside `cli/` so that a module the Op entry loads, such as the
+ * run-event writer (#4041), can name the version without loading the CLI.
+ */
+export const CHANT_VERSION = (() => {
+    try {
+        return createRequire(import.meta.url)("../package.json").version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();

package/dist/cli/build-params-cli.d.ts

@@ -1,4 +1,4 @@
-import { type BuildParamsConfig } from "../build-params.js";
+import { type BuildParamFlags, type BuildParamsConfig } from "../build-params.js";
 import type { BuildParamProvenance } from "../provenance.js";
 /**
  * Shared CLI-layer wiring for chant #1064's build-time parameters, factored
@@ -26,6 +26,10 @@ export interface CliBuildParamsArgs {
     paramsFile?: string;
     /** `--verbose` — list every resolved parameter one per line instead of the one-line count (#1424). */
     verbose?: boolean;
+    /** The workspace flags backing parameters in this build's environment (#4024), from `../flag-params.ts`. */
+    flags?: BuildParamFlags;
+    /** `false` to resolve without printing the summary line, for a caller that checks more before it prints ({@link echoBuildParams}). */
+    echo?: boolean;
 }
 export interface CliBuildParamsResolution {
     success: boolean;
@@ -56,6 +60,8 @@ export interface CliBuildParamsResolution {
  * `[param] <name> = <value> (<source>)` instead (#1424).
  */
 export declare function resolveCliBuildParams(buildParamsConfig: BuildParamsConfig | undefined, args: CliBuildParamsArgs): CliBuildParamsResolution;
+/** Print a successful resolution: the one-line summary, or every value under `--verbose` or `CHANT_PARAM_ECHO=all` (#1424). */
+export declare function echoBuildParams(provenance: readonly BuildParamProvenance[], verboseFlag?: boolean): void;
 /**
  * `N build parameters resolved (1 from cli, 3 default); --verbose to list` —
  * the non-verbose echo of a successful resolution (#1424). Sources appear in

package/dist/cli/build-params-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-params-cli.d.ts","sourceRoot":"","sources":["../../src/cli/build-params-cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D;;;;;;;;;;;;;;;GAeG;AAEH,4SAA4S;AAC5S,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQtF;AAED,qOAAqO;AACrO,MAAM,WAAW,kBAAkB;IACjC,mNAAmN;IACnN,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,IAAI,EAAE,kBAAkB,GACvB,wBAAwB,CA4C1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAUtF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,oBAAoB,EAAE,GAAG,SAAS,CAAC,CAU7C"}
+{"version":3,"file":"build-params-cli.d.ts","sourceRoot":"","sources":["../../src/cli/build-params-cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D;;;;;;;;;;;;;;;GAeG;AAEH,4SAA4S;AAC5S,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQtF;AAED,qOAAqO;AACrO,MAAM,WAAW,kBAAkB;IACjC,mNAAmN;IACnN,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,sIAAsI;IACtI,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,IAAI,EAAE,kBAAkB,GACvB,wBAAwB,CAgC1B;AAED,+HAA+H;AAC/H,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAcxG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CActF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,oBAAoB,EAAE,GAAG,SAAS,CAAC,CAU7C"}

package/dist/cli/build-params-cli.js

@@ -65,6 +65,7 @@ export function resolveCliBuildParams(buildParamsConfig, args) {
         cli: args.cli,
         fromFile,
         env: process.env,
+        ...(args.flags ? { flags: args.flags } : {}),
     });
     for (const message of resolution.errors) {
         errors.push(formatError({ message }));
@@ -72,21 +73,26 @@ export function resolveCliBuildParams(buildParamsConfig, args) {
     if (errors.length > 0) {
         return { success: false, provenance: [], errors };
     }
+    if (args.echo !== false)
+        echoBuildParams(resolution.provenance, args.verbose);
+    return { success: true, provenance: resolution.provenance, errors: [] };
+}
+/** Print a successful resolution: the one-line summary, or every value under `--verbose` or `CHANT_PARAM_ECHO=all` (#1424). */
+export function echoBuildParams(provenance, verboseFlag) {
     // #1424 — one line by default. A project with two dozen declared
     // parameters printed two dozen grey lines on every build, ahead of the
     // warnings the reader actually needed. The count by source still answers
     // "did my override reach the build" (the failure mode
     // warnIfParamsCannotReachProject exists for); --verbose names every value.
-    const verbose = args.verbose === true || process.env.CHANT_PARAM_ECHO === "all";
+    const verbose = verboseFlag === true || process.env.CHANT_PARAM_ECHO === "all";
     if (verbose) {
-        for (const p of resolution.provenance) {
+        for (const p of provenance) {
             console.error(formatInfo(`[param] ${p.name} = ${JSON.stringify(p.value)} (${p.source})`));
         }
     }
-    else if (resolution.provenance.length > 0) {
-        console.error(formatInfo(summarizeBuildParams(resolution.provenance)));
+    else if (provenance.length > 0) {
+        console.error(formatInfo(summarizeBuildParams(provenance)));
     }
-    return { success: true, provenance: resolution.provenance, errors: [] };
 }
 /**
  * `N build parameters resolved (1 from cli, 3 default); --verbose to list` —
@@ -95,9 +101,12 @@ export function resolveCliBuildParams(buildParamsConfig, args) {
  */
 export function summarizeBuildParams(provenance) {
     const counts = new Map();
-    for (const p of provenance)
-        counts.set(p.source, (counts.get(p.source) ?? 0) + 1);
-    const order = ["cli", "params-file", "env", "default"];
+    // Every flag source (`flag:<name>`, #4024) counts as one, "from flags".
+    for (const p of provenance) {
+        const source = p.source.startsWith("flag:") ? "flags" : p.source;
+        counts.set(source, (counts.get(source) ?? 0) + 1);
+    }
+    const order = ["cli", "params-file", "env", "flags", "default"];
     const rank = (s) => (order.includes(s) ? order.indexOf(s) : order.length);
     const parts = [...counts.keys()]
         .sort((a, b) => rank(a) - rank(b))

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

@@ -80,6 +80,14 @@ export interface BuildOptions {
         serializers: Serializer[];
         result?: ReturnType<typeof build>;
     };
+    /**
+     * Where each output file goes: called with its absolute path and its
+     * content in place of creating the directory and writing the file. A
+     * release cut (#4046) passes one that keeps the files in memory, so it
+     * records exactly what this build writes and nothing left on disk by an
+     * earlier one.
+     */
+    writeFile?: (path: string, content: string) => void;
 }
 /**
  * Resolve the output format for `chant build`.

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

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