@intentius/chant 0.124.27 → 0.124.28

package/dist/cli/handlers/approve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/approve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EACuE,KAAK,UAAU,EAC5F,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAEuC,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAChG,MAAM,wBAAwB,CAAC;AAQhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkDlD,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuGrE;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oGAAoG;IACpG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAkW9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,OAAO,GAAE,SAAS,iBAAiB,EAA+B,GACjE,MAAM,EAAE,CA8BV"}
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/approve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EACuE,KAAK,UAAU,EAC5F,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAEuC,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAChG,MAAM,wBAAwB,CAAC;AAQhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkDlD,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GrE;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oGAAoG;IACpG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA4W9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,OAAO,GAAE,SAAS,iBAAiB,EAA+B,GACjE,MAAM,EAAE,CA8BV"}

package/dist/cli/handlers/approve.js

@@ -11,7 +11,7 @@ import { appendGateResolution, appendPendingGate, readGateLedger, latestPendingG
 import { isPlanDigest, samePlanDigest } from "../../lifecycle/plan-digest.js";
 import { gateContextDigest, gatePolicyRequest, loadGatePolicyEvaluator, } from "../../op/gate-approval.js";
 import { approverOf, humanQuorumSince, tallyGateApprovals } from "../../op/gate.js";
-import { FAN_OUT_GATE_OP, OVERRIDE_GATE_OP, WORKSPACE_UPGRADE_GATE_OP } from "../../op/gate-name.js";
+import { FAN_OUT_GATE_OP, OVERRIDE_GATE_OP, RELEASE_GATE_OP, WORKSPACE_UPGRADE_GATE_OP } from "../../op/gate-name.js";
 import { PR_GATE_OP } from "../../pr-loop.js";
 import { pushLifecycleReport, requireLifecycleLedger } from "../../lifecycle/git.js";
 import { LIFECYCLE_LOCAL_NOTE, isLifecycleLocalNote } from "../../lifecycle/local-note.js";
@@ -99,6 +99,8 @@ export async function runApprove(ctx) {
             timestamp: now,
             expiresAt: now,
             ...(standing.description ? { description: standing.description } : {}),
+            ...(standing.runId ? { runId: standing.runId } : {}),
+            ...(standing.gitSha ? { gitSha: standing.gitSha } : {}),
         });
         const push = await reportedPush(`The expiry is recorded locally on ${LIFECYCLE_BRANCH}. Until it reaches the remote, ` +
             `a run in another checkout still sees the old pending fact.`);
@@ -109,7 +111,9 @@ export async function runApprove(ctx) {
                 ? `The next \`chant components pr-apply\` decides this gate from scratch and records a fresh pending fact.`
                 : opName === WORKSPACE_UPGRADE_GATE_OP
                     ? `The next \`chant workspace upgrade ${gate}\` decides this gate from scratch and records a fresh pending fact.`
-                    : `The next \`chant run ${opName}\` decides this gate from scratch and records a fresh pending fact.`));
+                    : opName === RELEASE_GATE_OP
+                        ? `The next \`chant components promote --release\` decides this gate from scratch and records a fresh pending fact.`
+                        : `The next \`chant run ${opName}\` decides this gate from scratch and records a fresh pending fact.`));
         return 0;
     }
     // #3760: an override of a denied plan names its rules and gives a reason.
@@ -154,7 +158,9 @@ export async function runApprove(ctx) {
                 ? `The pull request's apply (\`chant components pr-apply\`) walks through gate "${gate}" when it plans this same digest.`
                 : opName === WORKSPACE_UPGRADE_GATE_OP
                     ? `Repeat \`chant workspace upgrade ${gate}\` with the same target, and it applies the patch this approval names.`
-                    : `Run \`chant run ${opName}\` and it walks through gate "${gate}".`)));
+                    : opName === RELEASE_GATE_OP
+                        ? `Repeat the same \`chant components promote --release\`, and it walks through gate "${gate}" when it plans this same change set for this release.`
+                        : `Run \`chant run ${opName}\` and it walks through gate "${gate}".`)));
     return 0;
 }
 /**
@@ -187,7 +193,7 @@ export async function recordGateApproval(opName, gate, opts) {
     // so there is no `*.op.ts` to find and nothing is wrong when none is there.
     // #3949: a gate that lists this one as an alias, after an Op was restructured.
     const successor = aliasingGate([...ops.values()].map((o) => o.config), opName, gate);
-    if (!successor && !ops.has(opName) && opName !== FAN_OUT_GATE_OP && opName !== WORKSPACE_UPGRADE_GATE_OP && opName !== OVERRIDE_GATE_OP) {
+    if (!successor && !ops.has(opName) && opName !== FAN_OUT_GATE_OP && opName !== WORKSPACE_UPGRADE_GATE_OP && opName !== OVERRIDE_GATE_OP && opName !== RELEASE_GATE_OP) {
         console.error(formatWarning({
             message: `Op "${opName}" was not found among discovered *.op.ts declarations — recording the resolution anyway`,
         }));
@@ -284,6 +290,10 @@ export async function recordGateApproval(opName, gate, opts) {
     const checkpointDigest = standing?.checkpointDigest !== undefined && samePlanDigest(planDigest, standing.planDigest)
         ? standing.checkpointDigest
         : undefined;
+    // #4045: a release gate's fact names the release its change set was
+    // planned for. An approval of that fact's plan is for that release too; an
+    // approval of another plan names none, and no release gate counts it.
+    const releaseDigest = standing?.releaseDigest !== undefined && samePlanDigest(planDigest, standing.planDigest) ? standing.releaseDigest : undefined;
     // chant#2384 — the gate's whole value is that its two halves have different
     // authors. At a shell they do: a person runs, reads the plan, and approves.
     // On MCP and ACP the person's only act was launching the server, and every
@@ -476,6 +486,10 @@ export async function recordGateApproval(opName, gate, opts) {
         ...(planDigest !== undefined ? { planDigest } : {}),
         ...(checkpointDigest !== undefined ? { checkpointDigest } : {}),
         ...(environment !== undefined ? { environment } : {}),
+        ...(releaseDigest !== undefined ? { releaseDigest } : {}),
+        // #4020: the commit and run the gate waited on, off the fact this approves.
+        ...(standing?.gitSha ? { gitSha: standing.gitSha } : {}),
+        ...(standing?.runId ? { runId: standing.runId } : {}),
         origin,
         ...(refusal && opts.allowSameOrigin ? { sameOriginOverride: true } : {}),
     });
@@ -490,6 +504,7 @@ export async function recordGateApproval(opName, gate, opts) {
     if (record.planDigest) {
         console.error(formatInfo(`This approves the plan ${record.planDigest}` +
             (record.environment !== undefined ? ` in environment "${record.environment}"` : "") +
+            (record.releaseDigest !== undefined ? ` for release ${record.releaseDigest}` : "") +
             ", and only that plan. A run whose fresh plan differs refuses rather than applying it."));
     }
     if (record.checkpointDigest) {

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+IlD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJnE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4KlD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJnE"}

package/dist/cli/handlers/build.js

@@ -6,6 +6,7 @@ import { generateComponentsPipeline } from "../../components/cli-support.js";
 import { loadChantConfigUpward } from "../../config.js";
 import { resolveCliBuildParams, parseParamFlags } from "../build-params-cli.js";
 import { findWorkspaceRoot } from "../../project-root.js";
+import { resolvePromotionSource } from "../../components/promote-order.js";
 /**
  * `chant build --components --generate <lexicon>` — generate mode (#563,
  * epic #551 Phase 3). Discovers `Component` declarations under `args.path`
@@ -42,6 +43,23 @@ async function runGenerateComponents(ctx) {
             console.error(message);
         return 1;
     }
+    // #4030: the generated promote job runs `promote --from <env> --to <promote-to>`,
+    // which the member's declared promotion order refuses when it skips a step.
+    // Refuse here, with the same code, rather than write a job that fails.
+    if (args.promoteTo) {
+        // Loaded here, not at the top: a build without --promote-to loads no workspace module (#2526).
+        const { promotionOrder } = await import("../../workspace/promotion-order.js");
+        const resolved = resolvePromotionSource({
+            order: promotionOrder(config.environments),
+            to: args.promoteTo,
+            from: args.env ?? "production",
+            ...(args.allowSkip ? { allowSkip: true } : {}),
+        });
+        if ("error" in resolved) {
+            console.error(formatError({ message: `${resolved.error.message} [${resolved.error.code}]`, hint: resolved.error.fix }));
+            return 1;
+        }
+    }
     // A project inside a workspace member gets that member's pipeline (#2542):
     // path-filtered, run in the member's directory, written to a file named
     // after the member and recorded as the member's generated file. The
@@ -59,11 +77,14 @@ async function runGenerateComponents(ctx) {
                 lexicon,
                 env: args.env,
                 promoteTo: args.promoteTo,
+                ...(args.allowSkip ? { allowSkip: true } : {}),
                 output: args.output,
                 params: args.param,
                 paramsFile: args.paramsFile,
                 ...(args.waveGate ? { waveGate: { gate: args.waveGate, ...(args.canary?.length ? { canary: args.canary } : {}), ...(args.base ? { base: args.base } : {}) } } : {}),
                 ...(args.prLoop ? { prLoop: { ...(args.gate ? { gate: args.gate } : {}), ...(args.branch ? { branch: args.branch } : {}) } } : {}),
+                ...(args.image ? { image: args.image } : {}),
+                ...(args.beforeScript?.length ? { beforeScript: args.beforeScript } : {}),
             });
         }
         catch (err) {
@@ -78,6 +99,10 @@ async function runGenerateComponents(ctx) {
     const result = await generateComponentsPipeline(args.path, lexicon, {
         env: args.env,
         ...(args.promoteTo ? { promoteTo: args.promoteTo } : {}),
+        // #4030: the job passes --allow-skip through, so it is not refused again at deploy time.
+        ...(args.promoteTo && args.allowSkip
+            ? { promoteCommand: ["chant", "components", "promote", "--from", args.env ?? "production", "--to", args.promoteTo, "--allow-skip"] }
+            : {}),
         ...(plan ? { member: plan.member } : {}),
         // #3049: one job per wave of a gated-wave fan-out instead of one per component.
         ...(args.waveGate
@@ -87,6 +112,9 @@ async function runGenerateComponents(ctx) {
         ...(args.prLoop
             ? { prLoop: { ...(args.gate ? { gate: args.gate } : {}), ...(args.branch ? { branch: args.branch } : {}) } }
             : {}),
+        // #4002: the job image and the lines that install what it lacks, chant itself included.
+        ...(args.image ? { image: args.image } : {}),
+        ...(args.beforeScript?.length ? { beforeScript: args.beforeScript } : {}),
     }, args.sandbox, paramsResolution.provenance);
     if (!result.success) {
         console.error(formatError({ message: result.error ?? "Failed to generate CI pipeline from components" }));

package/dist/cli/handlers/change-set.d.ts

@@ -8,4 +8,14 @@ import type { CommandContext } from "../registry.js";
  * file; no project, no plugins, no network.
  */
 export declare function runChangeSetSummary(ctx: CommandContext): Promise<number>;
+/**
+ * `chant change-set show <digest>` (#4022): the change-set document a gate
+ * bound, stored on `chant/lifecycle` under its digest, with each entry's
+ * graph node. `--json` prints the read contract's `change-set-show`
+ * document (`../../workspace/change-set-show.ts`); without it, the grouped
+ * summary and each entry with its node. `--member` reads a workspace
+ * member's ledger from anywhere in the checkout. Exit 1 when nothing is
+ * stored under the digest.
+ */
+export declare function runChangeSetShow(ctx: CommandContext): Promise<number>;
 //# sourceMappingURL=change-set.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/change-set.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9E"}
+{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/change-set.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC3E"}

package/dist/cli/handlers/change-set.js

@@ -1,8 +1,10 @@
 import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 import { CHANGE_SET_CONTRACT, CHANGE_SET_SCHEMA_ID } from "../../change-set.js";
 import { GITHUB_COMMENT_LIMIT, groupChangeSet, renderPlanSummaryMarkdown, renderPlanSummaryText } from "../../plan-summary.js";
-import { formatError } from "../format.js";
+import { formatError, formatWarning } from "../format.js";
 const USAGE = "chant change-set summary <change-set.json> [--format text|json|markdown] [--limit <chars>]";
+const SHOW_USAGE = "chant change-set show <digest> [--member <name>] [--json]";
 /**
  * `chant change-set summary <file>` (#3188): the grouped plan summary of a
  * change-set document (`../../change-set.ts`), such as the `document` a
@@ -44,3 +46,51 @@ export async function runChangeSetSummary(ctx) {
         process.stdout.write(renderPlanSummaryText(summary));
     return 0;
 }
+/**
+ * `chant change-set show <digest>` (#4022): the change-set document a gate
+ * bound, stored on `chant/lifecycle` under its digest, with each entry's
+ * graph node. `--json` prints the read contract's `change-set-show`
+ * document (`../../workspace/change-set-show.ts`); without it, the grouped
+ * summary and each entry with its node. `--member` reads a workspace
+ * member's ledger from anywhere in the checkout. Exit 1 when nothing is
+ * stored under the digest.
+ */
+export async function runChangeSetShow(ctx) {
+    const { args } = ctx;
+    const digest = args.extraPositional;
+    const { changeSetShowDocument, CHANGE_SET_DIGEST_PATTERN } = await import("../../workspace/change-set-show.js");
+    if (!digest || !CHANGE_SET_DIGEST_PATTERN.test(digest)) {
+        console.error(formatError({ message: digest ? `${digest} is not a change-set digest` : "change-set show needs the digest a gate binds", hint: SHOW_USAGE }));
+        return 1;
+    }
+    if ((args.members?.length ?? 0) > 1) {
+        console.error(formatError({ message: `change-set show reads one member, not ${args.members.join(", ")}`, hint: SHOW_USAGE }));
+        return 1;
+    }
+    const member = args.members?.[0]?.split("/").filter(Boolean);
+    const doc = await changeSetShowDocument({ cwd: resolve("."), digest, ...(member ? { member } : {}) });
+    if (args.json) {
+        console.log(JSON.stringify(doc, null, 2));
+        return "error" in doc || doc.changeSet === null ? 1 : 0;
+    }
+    if ("error" in doc) {
+        console.error(formatError({ message: doc.error.message, hint: SHOW_USAGE }));
+        return 1;
+    }
+    if (doc.reason)
+        console.error(formatWarning({ message: doc.reason.message }));
+    if (doc.changeSet === null) {
+        if (!doc.reason)
+            console.error(formatError({ message: `no change set is stored under ${digest}${doc.member ? ` for member ${doc.member}` : ""}`, hint: "A pull-request or release gate stores the change set it binds; a component gate binds a lifecycle plan and stores none." }));
+        return 1;
+    }
+    process.stdout.write(renderPlanSummaryText(groupChangeSet(doc.changeSet)));
+    const graph = doc.changeSet.graph;
+    console.log(graph ? `\nNodes from the graph of ${graph.member ?? "this project"}${graph.at ? ` at ${graph.at.slice(0, 12)}` : ""}:` : "\nNo graph was read, so no entry has a node.");
+    for (const e of doc.changeSet.entries) {
+        if (e.action === "no-op" || e.action === "read")
+            continue;
+        console.log(`  ${e.action.padEnd(8)} ${e.member}  ${e.address}${e.deposed ? ` (deposed ${e.deposed})` : ""}  ${e.node ?? "(no node)"}`);
+    }
+    return 0;
+}

package/dist/cli/handlers/fan-out.d.ts

@@ -72,7 +72,7 @@ export declare function resolveChangedUnits(ctx: CommandContext, config: ChantCo
  * chant components fan-out --base <ref> | --from-affected <file>
  *   [--head <ref>] [--include-dependents] [--env <env>] [--gate <name>]
  *   [--dry-run] [--json] [--resume <file>] [--seed-outputs <file>]
- *   [--dump-outputs <file>] [--progress-json]
+ *   [--dump-outputs <file>] [--progress-json | --events-json]
  */
 export declare function runComponentsFanOut(ctx: CommandContext): Promise<number>;
 //# sourceMappingURL=fan-out.d.ts.map

package/dist/cli/handlers/fan-out.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/fan-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAa7F,OAAO,EAAmB,KAAK,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAMnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IACJ,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+ErE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAoR9E"}
+{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/fan-out.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAc7F,OAAO,EAAmB,KAAK,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAMnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IACJ,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+ErE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA+R9E"}

package/dist/cli/handlers/fan-out.js

@@ -51,6 +51,7 @@ import { readFanOutAttempt, writeFanOutAttempt } from "../../components/fan-out-
 import { describeChangedWave, withWaveRecord } from "../../gated-waves.js";
 import { renderFanOutHuman, renderFanOutJson, renderFanOutPlan } from "../../components/fan-out-output.js";
 import { ndjsonProgressSink } from "../../components/run-progress.js";
+import { openCliRunEvents, refusesBothStreams } from "../run-events.js";
 import { summaryLedgerPrefix, writeGatedRunSummary } from "../../op/gate-summary.js";
 import { approveCommand, gateIsSealed } from "../../op/gate.js";
 import { getHeadCommit } from "../../lifecycle/git.js";
@@ -59,7 +60,7 @@ import { resolveCliBuildParams, parseParamFlags } from "../build-params-cli.js";
 import { formatError, formatInfo, formatWarning } from "../format.js";
 import { FAN_OUT_GATE_OP } from "../../op/gate-name.js";
 import { resolveBuildRoot } from "./lifecycle.js";
-import { GATED_EXIT_CODE, recordAutoReleasesForRun } from "./run.js";
+import { GATED_EXIT_CODE, autoReleaseRun, recordAutoReleasesForRun } from "./run.js";
 /**
  * The stack-level change signal, from whichever end the invocation supplied.
  *
@@ -156,10 +157,12 @@ export async function resolveChangedUnits(ctx, config, opts = {}) {
  * chant components fan-out --base <ref> | --from-affected <file>
  *   [--head <ref>] [--include-dependents] [--env <env>] [--gate <name>]
  *   [--dry-run] [--json] [--resume <file>] [--seed-outputs <file>]
- *   [--dump-outputs <file>] [--progress-json]
+ *   [--dump-outputs <file>] [--progress-json | --events-json]
  */
 export async function runComponentsFanOut(ctx) {
     const { args } = ctx;
+    if (refusesBothStreams(args))
+        return 1;
     const projectPath = resolve(".");
     const { config } = await loadChantConfig(projectPath).catch(() => ({ config: {} }));
     const paramsResolution = resolveCliBuildParams(config.buildParams, {
@@ -312,6 +315,10 @@ export async function runComponentsFanOut(ctx) {
         };
         writeFanOutAttempt(resumePath, attempt);
     };
+    // The run id the release records carry, chosen before the run so that
+    // `--events-json` (#4041) names the run by it too.
+    const release = autoReleaseRun(`fan-out-${Date.now()}`);
+    const events = await openCliRunEvents(args, { kind: "component", name: `fan-out ${derived.plan.order.join(",")}`, runId: release.runId, cwd: projectPath });
     let result;
     try {
         result = await runFanOut(derived.plan, derived.components, registry, {
@@ -342,6 +349,7 @@ export async function runComponentsFanOut(ctx) {
                 }
                 : {}),
             ...(args.progressJson ? { onProgress: ndjsonProgressSink() } : {}),
+            ...(events ? { onRunEvent: events.emit } : {}),
             ...(resumePath
                 ? {
                     onComponentSettled: (settled, outputs) => {
@@ -360,6 +368,7 @@ export async function runComponentsFanOut(ctx) {
         });
     }
     catch (err) {
+        events?.settle("failed", err instanceof Error ? err.message : String(err));
         // `--wave <n>` reached before an earlier wave applied: nothing ran.
         if (err instanceof EarlierWaveNotAppliedError) {
             console.error(formatError({ message: err.message }));
@@ -367,6 +376,8 @@ export async function runComponentsFanOut(ctx) {
         }
         throw err;
     }
+    // The fan-out settles the stream; this only ends one it left open.
+    events?.settle(result.status === "fail" ? "failed" : result.status);
     if (args.dumpOutputs) {
         const dumpPath = resolve(args.dumpOutputs);
         mkdirSync(dirname(dumpPath), { recursive: true });
@@ -395,7 +406,7 @@ export async function runComponentsFanOut(ctx) {
     // A gated-wave run can stop at a later wave's gate after earlier waves
     // applied, and those applies are recorded like any other.
     if (result.status !== "gated" || result.completed.length > 0) {
-        await recordAutoReleasesForRun(result.results, args.env ?? "local", `fan-out-${Date.now()}`, resolveAutoReleaseDisabled(config, args.noReleaseRecord));
+        await recordAutoReleasesForRun(result.results, args.env ?? "local", release.runId, resolveAutoReleaseDisabled(config, args.noReleaseRecord), release.runOrigin);
     }
     // A failed root outranks a gate in the status, but a gated-wave run that
     // stopped at a wave's gate still prints how to approve it.

package/dist/cli/handlers/pr.d.ts

@@ -29,6 +29,12 @@
  *
  * Every run writes `pr-plan.json` or `pr-apply.json` (`pr-report.schema.json`),
  * `change-set.json` and `pr-note.md` under `--output` (default `.chant/pr`). *
+ * `--events-json` (#4041, #4007) streams the stage's run events to stdout,
+ * one `run-event.schema.json` line each: the planning as a `plan` phase with
+ * a step per component, the gate's decision as a `gate` phase, and on
+ * pr-apply the apply's waves and components as `chant run --components`
+ * streams them.
+ *
  * `--member <name>` (#3465) runs a workspace member's loop: the member's
  * generated pipeline passes it from the member's directory. The gate is
  * recorded under `pr-<n>-<member>`, and the note and the statuses carry the
@@ -38,8 +44,8 @@
 import type { CommandContext } from "../registry.js";
 /** Where the reports land unless `--output` says. */
 export declare const PR_REPORT_DIR = ".chant/pr";
-/** chant components pr-plan --base <ref> --pr <n> [--env <env>] [--gate <name>] [--forge <kind>] [--output <dir>] [--json] */
+/** chant components pr-plan --base <ref> --pr <n> [--env <env>] [--gate <name>] [--forge <kind>] [--output <dir>] [--json] [--events-json] */
 export declare function runComponentsPrPlan(ctx: CommandContext): Promise<number>;
-/** chant components pr-apply --base <ref> [--pr <n>] [--env <env>] [--gate <name>] [--forge <kind>] [--require-review] [--output <dir>] [--json] */
+/** chant components pr-apply --base <ref> [--pr <n>] [--env <env>] [--gate <name>] [--forge <kind>] [--require-review] [--output <dir>] [--json] [--events-json] */
 export declare function runComponentsPrApply(ctx: CommandContext): Promise<number>;
 //# sourceMappingURL=pr.d.ts.map

package/dist/cli/handlers/pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/pr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAyCH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,qDAAqD;AACrD,eAAO,MAAM,aAAa,cAAc,CAAC;AA0MzC,8HAA8H;AAC9H,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C9E;AAED,oJAAoJ;AACpJ,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkL/E"}
+{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/pr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AA4CH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,qDAAqD;AACrD,eAAO,MAAM,aAAa,cAAc,CAAC;AAoPzC,8IAA8I;AAC9I,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAuDD,oKAAoK;AACpK,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzE"}