@intentius/chant 0.124.78 → 0.124.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (184) hide show
  1. package/dist/action-pins.d.ts.map +1 -1
  2. package/dist/action-pins.js +1 -2
  3. package/dist/change-set.d.ts +10 -1
  4. package/dist/change-set.d.ts.map +1 -1
  5. package/dist/change-set.js +4 -1
  6. package/dist/ci-agent.d.ts +16 -2
  7. package/dist/ci-agent.d.ts.map +1 -1
  8. package/dist/ci-agent.js +6 -1
  9. package/dist/ci-commit.d.ts.map +1 -1
  10. package/dist/ci-commit.js +2 -3
  11. package/dist/ci-note-commands.d.ts +199 -0
  12. package/dist/ci-note-commands.d.ts.map +1 -0
  13. package/dist/ci-note-commands.js +372 -0
  14. package/dist/ci-product.d.ts +6 -2
  15. package/dist/ci-product.d.ts.map +1 -1
  16. package/dist/ci-product.js +5 -1
  17. package/dist/cli/handlers/build.d.ts.map +1 -1
  18. package/dist/cli/handlers/build.js +7 -1
  19. package/dist/cli/handlers/pr-notes.d.ts +13 -0
  20. package/dist/cli/handlers/pr-notes.d.ts.map +1 -0
  21. package/dist/cli/handlers/pr-notes.js +73 -0
  22. package/dist/cli/handlers/release.d.ts +8 -0
  23. package/dist/cli/handlers/release.d.ts.map +1 -1
  24. package/dist/cli/handlers/release.js +64 -2
  25. package/dist/cli/handlers/run-wave.js +1 -0
  26. package/dist/cli/main.d.ts.map +1 -1
  27. package/dist/cli/main.js +17 -1
  28. package/dist/cli/mcp/product-tools.d.ts +6 -0
  29. package/dist/cli/mcp/product-tools.d.ts.map +1 -1
  30. package/dist/cli/mcp/product-tools.js +6 -0
  31. package/dist/cli/mcp/read-only.d.ts +12 -0
  32. package/dist/cli/mcp/read-only.d.ts.map +1 -1
  33. package/dist/cli/mcp/read-only.js +16 -0
  34. package/dist/cli/mcp/server.d.ts +11 -0
  35. package/dist/cli/mcp/server.d.ts.map +1 -1
  36. package/dist/cli/mcp/server.js +26 -5
  37. package/dist/cli/mcp/types.d.ts +5 -1
  38. package/dist/cli/mcp/types.d.ts.map +1 -1
  39. package/dist/cli/parse-args.d.ts.map +1 -1
  40. package/dist/cli/parse-args.js +10 -0
  41. package/dist/cli/registry.d.ts +4 -0
  42. package/dist/cli/registry.d.ts.map +1 -1
  43. package/dist/components/capability.d.ts +53 -0
  44. package/dist/components/capability.d.ts.map +1 -1
  45. package/dist/components/group-digest.d.ts +17 -0
  46. package/dist/components/group-digest.d.ts.map +1 -0
  47. package/dist/components/group-digest.js +18 -0
  48. package/dist/components/groups.d.ts +2 -11
  49. package/dist/components/groups.d.ts.map +1 -1
  50. package/dist/components/groups.js +2 -12
  51. package/dist/components/index.d.ts +1 -1
  52. package/dist/components/index.d.ts.map +1 -1
  53. package/dist/components/pr-pipeline.d.ts +22 -0
  54. package/dist/components/pr-pipeline.d.ts.map +1 -1
  55. package/dist/components/pr-pipeline.js +26 -0
  56. package/dist/components/product-pipeline.d.ts +12 -0
  57. package/dist/components/product-pipeline.d.ts.map +1 -1
  58. package/dist/components/product-pipeline.js +5 -1
  59. package/dist/config.d.ts +14 -0
  60. package/dist/config.d.ts.map +1 -1
  61. package/dist/config.js +5 -0
  62. package/dist/lexicon.d.ts.map +1 -1
  63. package/dist/lexicon.js +1 -2
  64. package/dist/lifecycle/release-cut.d.ts +7 -1
  65. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  66. package/dist/lifecycle/release-cut.js +1 -0
  67. package/dist/lifecycle/release-images.d.ts +12 -3
  68. package/dist/lifecycle/release-images.d.ts.map +1 -1
  69. package/dist/lifecycle/release-images.js +6 -7
  70. package/dist/lifecycle/release-publish.d.ts +8 -1
  71. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  72. package/dist/lifecycle/release-publish.js +30 -3
  73. package/dist/lifecycle/release-version.d.ts +86 -0
  74. package/dist/lifecycle/release-version.d.ts.map +1 -0
  75. package/dist/lifecycle/release-version.js +208 -0
  76. package/dist/mcp/types.d.ts +26 -0
  77. package/dist/mcp/types.d.ts.map +1 -1
  78. package/dist/notify-product.d.ts.map +1 -1
  79. package/dist/notify-product.js +1 -2
  80. package/dist/op/activities/review-product.d.ts.map +1 -1
  81. package/dist/op/activities/review-product.js +1 -2
  82. package/dist/op/gate.d.ts +17 -0
  83. package/dist/op/gate.d.ts.map +1 -1
  84. package/dist/op/gate.js +36 -0
  85. package/dist/op/index.d.ts +8 -6
  86. package/dist/op/index.d.ts.map +1 -1
  87. package/dist/op/index.js +5 -4
  88. package/dist/op/op-waves-after-plan.d.ts +109 -1
  89. package/dist/op/op-waves-after-plan.d.ts.map +1 -1
  90. package/dist/op/op-waves-after-plan.js +180 -3
  91. package/dist/op/op-waves-capability-spec.js +1 -2
  92. package/dist/op/op-waves-capability.d.ts +93 -3
  93. package/dist/op/op-waves-capability.d.ts.map +1 -1
  94. package/dist/op/op-waves-capability.js +218 -10
  95. package/dist/op/op-waves-run-hooks.d.ts +104 -0
  96. package/dist/op/op-waves-run-hooks.d.ts.map +1 -0
  97. package/dist/op/op-waves-run-hooks.js +145 -0
  98. package/dist/op/op-waves-run.d.ts +21 -0
  99. package/dist/op/op-waves-run.d.ts.map +1 -1
  100. package/dist/op/op-waves-run.js +307 -21
  101. package/dist/op/op-waves.d.ts +11 -1
  102. package/dist/op/op-waves.d.ts.map +1 -1
  103. package/dist/op/op-waves.js +7 -1
  104. package/dist/op/runtime.d.ts +2 -0
  105. package/dist/op/runtime.d.ts.map +1 -1
  106. package/dist/pr-forge-reads.d.ts +151 -1
  107. package/dist/pr-forge-reads.d.ts.map +1 -1
  108. package/dist/pr-forge-reads.js +265 -1
  109. package/dist/pr-plan-note.d.ts.map +1 -1
  110. package/dist/pr-plan-note.js +1 -2
  111. package/dist/release-floors.d.ts +19 -1
  112. package/dist/release-floors.d.ts.map +1 -1
  113. package/dist/release-floors.js +23 -5
  114. package/dist/wave-runtime.mjs +312 -312
  115. package/dist/workspace/change-set.schema.json +7 -0
  116. package/dist/workspace/release-workflow.d.ts +7 -0
  117. package/dist/workspace/release-workflow.d.ts.map +1 -1
  118. package/dist/workspace/release-workflow.js +11 -1
  119. package/package.json +1 -1
  120. package/src/action-pins.test.ts +1 -2
  121. package/src/action-pins.ts +1 -3
  122. package/src/change-set.test.ts +20 -0
  123. package/src/change-set.ts +11 -1
  124. package/src/ci-agent.test.ts +9 -0
  125. package/src/ci-agent.ts +15 -2
  126. package/src/ci-commit.test.ts +2 -3
  127. package/src/ci-commit.ts +2 -3
  128. package/src/ci-note-commands.test.ts +377 -0
  129. package/src/ci-note-commands.ts +479 -0
  130. package/src/ci-product.ts +6 -2
  131. package/src/cli/handlers/build.ts +7 -1
  132. package/src/cli/handlers/pr-notes.ts +70 -0
  133. package/src/cli/handlers/release.ts +55 -2
  134. package/src/cli/handlers/run-wave.ts +1 -0
  135. package/src/cli/main.ts +17 -1
  136. package/src/cli/mcp/product-tools.test.ts +49 -0
  137. package/src/cli/mcp/product-tools.ts +7 -0
  138. package/src/cli/mcp/read-only.ts +19 -0
  139. package/src/cli/mcp/server.test.ts +30 -0
  140. package/src/cli/mcp/server.ts +28 -5
  141. package/src/cli/mcp/types.ts +6 -1
  142. package/src/cli/parse-args.ts +8 -0
  143. package/src/cli/registry.ts +4 -0
  144. package/src/components/capability.ts +52 -0
  145. package/src/components/group-digest.ts +20 -0
  146. package/src/components/groups.ts +3 -13
  147. package/src/components/index.ts +2 -0
  148. package/src/components/pr-pipeline.ts +35 -0
  149. package/src/components/product-pipeline.test.ts +14 -0
  150. package/src/components/product-pipeline.ts +13 -1
  151. package/src/config.ts +15 -0
  152. package/src/lexicon.ts +1 -2
  153. package/src/lifecycle/release-cut.ts +11 -0
  154. package/src/lifecycle/release-images-dockerfile.test.ts +10 -2
  155. package/src/lifecycle/release-images.ts +12 -8
  156. package/src/lifecycle/release-publish.ts +34 -3
  157. package/src/lifecycle/release-version.test.ts +155 -0
  158. package/src/lifecycle/release-version.ts +226 -0
  159. package/src/mcp/types.ts +27 -0
  160. package/src/notify-message-words.test.ts +1 -2
  161. package/src/notify-product.ts +1 -2
  162. package/src/op/activities/review-product.ts +1 -2
  163. package/src/op/gate.ts +46 -0
  164. package/src/op/index.ts +10 -4
  165. package/src/op/op-waves-after-plan-wave.test.ts +225 -0
  166. package/src/op/op-waves-after-plan.ts +228 -5
  167. package/src/op/op-waves-capability-spec.ts +1 -1
  168. package/src/op/op-waves-capability.test.ts +9 -1
  169. package/src/op/op-waves-capability.ts +246 -13
  170. package/src/op/op-waves-gate-port.test.ts +232 -0
  171. package/src/op/op-waves-run-hooks.test.ts +183 -0
  172. package/src/op/op-waves-run-hooks.ts +194 -0
  173. package/src/op/op-waves-run.ts +313 -25
  174. package/src/op/op-waves-step-wave.test.ts +276 -0
  175. package/src/op/op-waves.ts +15 -2
  176. package/src/op/runtime.ts +2 -0
  177. package/src/pr-forge-reads-compare.test.ts +145 -0
  178. package/src/pr-forge-reads.test.ts +203 -0
  179. package/src/pr-forge-reads.ts +398 -1
  180. package/src/pr-plan-note.ts +1 -2
  181. package/src/release-floors.ts +32 -5
  182. package/src/workspace/change-set.schema.json +7 -0
  183. package/src/workspace/release-workflow.test.ts +18 -0
  184. package/src/workspace/release-workflow.ts +21 -1
@@ -155,6 +155,13 @@
155
155
  },
156
156
  "description": "Added in contract 1 by #4463, written by chant 0.124.54 and newer. The inputs the member was previewed with stand-in values for (#4463), as var.<name>, sorted. Every attribute they drive is marked unknown in its entries, and its planDigest covers them."
157
157
  },
158
+ "outputs": {
159
+ "type": "array",
160
+ "items": {
161
+ "type": "string"
162
+ },
163
+ "description": "Added in contract 1 by #4849, written by chant 0.124.79 and newer. The outputs the member's plan changes, by name, sorted. Absent when it changes none. A member with any is a change even when every entry is a no-op. Its planDigest covers them."
164
+ },
158
165
  "holes": {
159
166
  "type": "array",
160
167
  "description": "What the planner could not read, so the plan says nothing about it.",
@@ -68,6 +68,13 @@ export interface ReleaseWorkflowInput {
68
68
  imageArchives?: string[];
69
69
  /** `release.lane` (#4692): the gate's green lane. */
70
70
  lane?: string;
71
+ /**
72
+ * The config declares `release.version` (#4840): the publish job runs
73
+ * `chant release stamp <label>` before the images and the build, so what
74
+ * it builds and publishes carries the label as its version. The cut
75
+ * stamps on its own.
76
+ */
77
+ version?: boolean;
71
78
  /**
72
79
  * `release.publish` (#4767). On GitHub, a `forge: "github"` target with no
73
80
  * `tokenEnv` reads `GITHUB_TOKEN`, so the publish job sets it to the job's
@@ -1 +1 @@
1
- {"version":3,"file":"release-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/release-workflow.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,uBAAuB,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAKvE,CAAC;AAEF,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IACpC,8HAA8H;IAC9H,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;IAC7B,iLAAiL;IACjL,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yJAAyJ;IACzJ,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,kMAAkM;IAClM,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,MAAM,EAAE,CAEzE;AAED,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAOlE,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAoGzE;AAkFD,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AA6L9D,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,iBAAiB,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6DvG"}
1
+ {"version":3,"file":"release-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/release-workflow.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,uBAAuB,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAKvE,CAAC;AAEF,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IACpC,8HAA8H;IAC9H,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;IAC7B,iLAAiL;IACjL,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yJAAyJ;IACzJ,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,kMAAkM;IAClM,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,MAAM,EAAE,CAEzE;AAED,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAOlE,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAuGzE;AAoFD,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAoM9D,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,iBAAiB,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DvG"}
@@ -59,6 +59,7 @@ export function renderReleaseWorkflow(input) {
59
59
  const flags = publishFlags(input.groups).join(" ");
60
60
  const after = p.after ?? [];
61
61
  const images = input.images === true;
62
+ const version = input.version === true;
62
63
  const extra = jobExtras(p, input.forge);
63
64
  // #4767: Forgejo's job token is not a GitHub token, and GitLab has no such expression.
64
65
  const forgeToken = input.forge === "github" && p.env?.GITHUB_TOKEN === undefined && (input.publish ?? []).some((t) => t.type === "forge" && t.forge === "github" && !t.tokenEnv)
@@ -66,7 +67,7 @@ export function renderReleaseWorkflow(input) {
66
67
  : [];
67
68
  if (p.trigger === "dispatch") {
68
69
  const archives = images ? (input.imageArchives ?? []).map((a) => (root ? `${root}/${a.replace(/^\.\//, "")}` : a.replace(/^\.\//, ""))) : [];
69
- const o = { chant, install, build, root, verify, flags, after, images, archives, forge: input.forge, extra, forgeToken, gate: p.gate ?? "last-green", ...(input.lane ? { lane: input.lane } : {}) };
70
+ const o = { chant, install, build, root, verify, flags, after, images, version, archives, forge: input.forge, extra, forgeToken, gate: p.gate ?? "last-green", ...(input.lane ? { lane: input.lane } : {}) };
70
71
  return input.forge === "gitlab" ? renderGitlabDispatch(o) : renderGithubDispatch(o);
71
72
  }
72
73
  // #4657: the images are built from the release, so chant/lifecycle is fetched before them and the build after.
@@ -86,6 +87,7 @@ export function renderReleaseWorkflow(input) {
86
87
  ...(root ? [` - cd ${root}`] : []),
87
88
  ` - ${install}`,
88
89
  ...extra.gitlabScript.map((l) => ` - ${l}`),
90
+ ...(version ? [` - ${chant} release stamp ${label}`] : []),
89
91
  ...(images ? [...fetches, ...imageLines(label, `export CHANT_RELEASE_DIGESTS="$PWD/${RELEASE_DIGESTS_FILE}"`).map((l) => ` - ${l}`)] : []),
90
92
  ...(build ? [` - ${build}`] : []),
91
93
  ...(images ? [] : fetches),
@@ -117,6 +119,7 @@ export function renderReleaseWorkflow(input) {
117
119
  ...githubSetup(),
118
120
  ` - run: ${install}`,
119
121
  ...extra.githubSteps,
122
+ ...(version ? [` - run: ${chant} release stamp ${label}`] : []),
120
123
  ...(images ? [...fetches, ...imageLines(label, `echo "CHANT_RELEASE_DIGESTS=$PWD/${RELEASE_DIGESTS_FILE}" >> "$GITHUB_ENV"`).map((l) => ` - run: ${l}`)] : []),
121
124
  ...(build ? [` - run: ${build}`] : []),
122
125
  ...(images ? [] : fetches),
@@ -198,6 +201,10 @@ function commonDir(paths) {
198
201
  function imagesLine(o) {
199
202
  return `${o.chant} release images "$CHANT_RELEASE_LABEL"${o.archives.length > 0 ? " --no-build" : ""} -o ${RELEASE_DIGESTS_FILE}`;
200
203
  }
204
+ /** The publish job's `release stamp` line (#4840). */
205
+ function stampLine(o) {
206
+ return `${o.chant} release stamp "$CHANT_RELEASE_LABEL"`;
207
+ }
201
208
  /** The node one-liner that prints a JSON document's field from stdin, or from the file its argument names. */
202
209
  const field = (path) => `node -e 'const f=process.argv[1];const t=f?require("fs").readFileSync(f,"utf8"):require("fs").readFileSync(0,"utf8");const d=JSON.parse(t);process.stdout.write(String(${path}??""))'`;
203
210
  /** The gate's shell: the commit to cut, from `ci last-green`, refused when there is none or, under `head`, when it is not the dispatched one. */
@@ -298,6 +305,7 @@ function renderGithubDispatch(o) {
298
305
  ...(o.archives.length > 0
299
306
  ? [` - uses: ${usesRef(o.forge === "forgejo" ? ACTION_PINS.downloadArtifact3 : ACTION_PINS.downloadArtifact4)}`, " with:", ` name: ${RELEASE_IMAGES_ARTIFACT}`, ` path: ${commonDir(o.archives)}`]
300
307
  : []),
308
+ ...(o.version ? [` - run: ${stampLine(o)}`] : []),
301
309
  ...(o.images ? [` - run: ${imagesLine(o)}`, ` - run: echo "CHANT_RELEASE_DIGESTS=$PWD/${RELEASE_DIGESTS_FILE}" >> "$GITHUB_ENV"`] : []),
302
310
  ...(o.build ? [` - run: ${o.build}`] : []),
303
311
  ...(o.verify ? [` - run: ${o.chant} release verify "$CHANT_RELEASE_LABEL"`] : []),
@@ -348,6 +356,7 @@ function renderGitlabDispatch(o) {
348
356
  ...o.extra.gitlabScript,
349
357
  ...fetches,
350
358
  ...auth,
359
+ ...(o.version ? [stampLine(o)] : []),
351
360
  ...(o.images ? [imagesLine(o), `export CHANT_RELEASE_DIGESTS="$PWD/${RELEASE_DIGESTS_FILE}"`] : []),
352
361
  ...(o.build ? [o.build] : []),
353
362
  ...(o.verify ? [`${o.chant} release verify "$CHANT_RELEASE_LABEL"`] : []),
@@ -409,6 +418,7 @@ export async function runReleaseWorkflow(ctx) {
409
418
  ...(release?.workflow ? { pipeline: release.workflow } : {}),
410
419
  ...((release?.images?.length ?? 0) > 0 ? { images: true, imageArchives: resolveReleaseImages(release.images).map((i) => i.archive) } : {}),
411
420
  ...(release?.lane ? { lane: release.lane } : {}),
421
+ ...(release?.version ? { version: true } : {}),
412
422
  ...(release?.publish ? { publish: release.publish } : {}),
413
423
  ...(args.ciInstall ? { install: args.ciInstall } : {}),
414
424
  ...(args.buildCommand ? { build: args.buildCommand } : {}),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intentius/chant",
3
- "version": "0.124.78",
3
+ "version": "0.124.80",
4
4
  "description": "Declarative infrastructure-as-code toolkit — TypeScript on Node.js",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://intentius.io/chant",
@@ -2,7 +2,6 @@ import { describe, expect, it } from "vitest";
2
2
  import { readdirSync, readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
  import { ACTION_PINS, CACHE4_PIN_FLOOR, pinAtMajor, pinMajor, tagComments, unpinnedActions, usesRef } from "./action-pins";
5
- import { NEXT_RELEASE } from "./release-floors";
6
5
 
7
6
  describe("the action pin table", () => {
8
7
  it("holds a full commit SHA and a release of the row's major for every action", () => {
@@ -46,7 +45,7 @@ describe("the action pin table", () => {
46
45
  // The restore row shares the commit; moving it keeps its own subpath.
47
46
  expect(pinAtMajor(ACTION_PINS.cacheRestore4.sha, "v4")).toBe(ACTION_PINS.cacheRestore4);
48
47
  expect(tagComments(` uses: ${usesRef(ACTION_PINS.cache4)}`)).toBe(` uses: ${usesRef(ACTION_PINS.cache4)} # v4.3.0`);
49
- expect(CACHE4_PIN_FLOOR).toBe(NEXT_RELEASE);
48
+ expect(CACHE4_PIN_FLOOR).toBe("0.124.78");
50
49
  });
51
50
  });
52
51
 
@@ -19,10 +19,8 @@
19
19
  * gh api repos/actions/checkout/commits/v6 --jq .sha
20
20
  */
21
21
 
22
- import { NEXT_RELEASE } from "./release-floors";
23
-
24
22
  /** The first chant whose table has the `cache4` row (#4816). */
25
- export const CACHE4_PIN_FLOOR = NEXT_RELEASE;
23
+ export const CACHE4_PIN_FLOOR = "0.124.78";
26
24
 
27
25
  export interface ActionPin {
28
26
  /** The action, with its subpath: `actions/cache/restore`. */
@@ -315,3 +315,23 @@ describe("a grouped member (ws-107, #4440)", () => {
315
315
  expect(isEmptyChangeSet(composeChangeSet([part("a", { digest, reads: [] }), part("b", { digest, reads: ["a.id"] })]))).toBe(false);
316
316
  });
317
317
  });
318
+
319
+ describe("a member whose plan changes outputs (#4849)", () => {
320
+ const part = (member: string, outputs?: string[]): ChangeSetPart => ({
321
+ member: { member, lexicon: "terraform", planner: "tofu", status: "planned", planDigest: computePlanDigest("p", member), holes: [], ...(outputs ? { outputs } : {}) },
322
+ entries: [{ member, lexicon: "terraform", planner: "tofu", address: "aws_s3_bucket.a", type: "aws_s3_bucket", name: "a", action: "no-op", attributes: [] }],
323
+ });
324
+
325
+ test("a change set whose only change is an output is not empty", () => {
326
+ expect(isEmptyChangeSet(composeChangeSet([part("a"), part("b")]))).toBe(true);
327
+ expect(isEmptyChangeSet(composeChangeSet([part("a"), part("b", ["url"])]))).toBe(false);
328
+ });
329
+
330
+ test("the outputs are not hashed again, since the member's plan digest covers them, and the schema reads them", () => {
331
+ const plain = composeChangeSet([part("a"), part("b")]);
332
+ const outputs = composeChangeSet([part("a"), part("b", ["url"])]);
333
+ expect(outputs.digest).toBe(plain.digest);
334
+ expect(verifyChangeSetDigest(outputs)).toBe(true);
335
+ expectValid(outputs);
336
+ });
337
+ });
package/src/change-set.ts CHANGED
@@ -200,6 +200,14 @@ export interface ChangeSetMember {
200
200
  placeholders?: string[];
201
201
  /** The planner's own digest of the same plan, when it prints one (choudoufu's per-root digest). */
202
202
  nativeDigest?: string;
203
+ /**
204
+ * The outputs the member's plan changes, by name, sorted (#4849). Absent
205
+ * when it changes none. A member with any is a change, even when every
206
+ * entry is a no-op ({@link isEmptyChangeSet}). Not hashed again: the
207
+ * member's `planDigest` already covers them. Added within contract 1 by
208
+ * chant `CHANGE_SET_OUTPUTS_FLOOR` (release-floors).
209
+ */
210
+ outputs?: string[];
203
211
  holes: ChangeSetHole[];
204
212
  /**
205
213
  * Set on a member a capability planned with others as one group (ws-107,
@@ -475,12 +483,14 @@ export function verifyChangeSetDigest(
475
483
  * planner marked `mayAppear`. A release gate over such a document passes
476
484
  * without an approval. A member that reads a value its group computes in its
477
485
  * apply (`group.reads`, ws-107 ruling 4) makes it not empty: what the plan
478
- * shows may not be all the apply does.
486
+ * shows may not be all the apply does. A member whose plan changes an
487
+ * output (`outputs`, #4849) makes it not empty too.
479
488
  */
480
489
  export function isEmptyChangeSet(doc: Pick<ChangeSetDocument, "members" | "entries">): boolean {
481
490
  if (doc.members.length === 0) return false;
482
491
  for (const m of doc.members) {
483
492
  if (m.status !== "planned" || m.provisional === true || m.holes.length > 0) return false;
493
+ if (m.outputs && m.outputs.length > 0) return false;
484
494
  if (m.group && m.group.reads.length > 0) return false;
485
495
  }
486
496
  return doc.entries.every((e) => (e.action === "no-op" || e.action === "read") && e.mayAppear !== true);
@@ -345,4 +345,13 @@ describe("the run record", () => {
345
345
  expect(r).toMatchObject({ op: "plywood-drift-app", env: "local", status: "ok", labels: { Agent: "drift" }, outcomes: { agent: { trigger: "drift", result: "opened", usage: { usd: 0.4 } } } });
346
346
  expect(r.phases[0]!.steps[0]).toMatchObject({ fn: "agent:drift", status: "ok", durationMs: 300_000 });
347
347
  });
348
+
349
+ test("takes a product's own trigger word and records it as given (#4817)", () => {
350
+ const settings = { name: "terragucci-review", on: "review", env: "local" };
351
+ const r = agentRunRecordInput({ settings, started: "2026-10-27T11:00:00Z", ended: "2026-10-27T11:01:00Z", result: "updated", reason: "noted" });
352
+ expect(r).toMatchObject({ op: "terragucci-review", labels: { Agent: "review" }, outcomes: { agent: { trigger: "review", result: "updated" } } });
353
+ expect(r.phases[0]!.steps[0]).toMatchObject({ fn: "agent:review", status: "ok" });
354
+ const refused = agentRunRecordInput({ settings: { ...settings, name: "terragucci-refused-wave", on: "refused-wave" }, started: "2026-10-27T11:00:00Z", ended: "2026-10-27T11:00:00Z", result: "refused", reason: "refused" });
355
+ expect(refused).toMatchObject({ status: "ok", labels: { Agent: "refused-wave" }, outcomes: { agent: { trigger: "refused-wave" } } });
356
+ });
348
357
  });
package/src/ci-agent.ts CHANGED
@@ -51,6 +51,14 @@ export const CI_AGENT_FLOOR = "0.124.55";
51
51
  export type AgentTrigger = "comment" | "drift";
52
52
  export const AGENT_TRIGGERS: readonly AgentTrigger[] = ["comment", "drift"];
53
53
 
54
+ /**
55
+ * The trigger a run record names (#4817): one of chant's {@link AgentTrigger}s,
56
+ * or a product's own word for a model run it records on the same ledger, such
57
+ * as terragucci's `review` and `refused-wave`. A record's `trigger` was always
58
+ * a plain string, so a record written with chant's two words reads the same.
59
+ */
60
+ export type AgentRunTrigger = AgentTrigger | (string & {});
61
+
54
62
  /**
55
63
  * A scheduled Op spec's `agent` (#4616): the agent jobs the Op generator
56
64
  * writes. With `on: "comment"` the spec is the agent's own workflow,
@@ -763,9 +771,14 @@ export interface LandInput {
763
771
  runUrl?: string;
764
772
  }
765
773
 
766
- /** The run record of one agent run (#4551): op `<name>`, one phase with one step, the outcome in `outcomes`. */
774
+ /**
775
+ * The run record of one agent run (#4551): op `<name>`, one phase with one
776
+ * step, the outcome in `outcomes`. `settings.on` is the outcome's `trigger`,
777
+ * the `Agent` label and the step's `agent:<on>`. A trigger outside
778
+ * {@link AGENT_TRIGGERS}, a product's own word (#4817), is recorded as given.
779
+ */
767
780
  export function agentRunRecordInput(o: {
768
- settings: Pick<AgentSettings, "name" | "on" | "env">;
781
+ settings: Pick<AgentSettings, "name" | "env"> & { on: AgentRunTrigger };
769
782
  started: string;
770
783
  ended: string;
771
784
  result: AgentResult;
@@ -36,7 +36,6 @@ import {
36
36
  } from "./ci-commit";
37
37
  import { assertProductWords, parseProductComment } from "./ci-product-words";
38
38
  import { PLYWOOD } from "./__fixtures__/product-words";
39
- import { NEXT_RELEASE } from "./release-floors";
40
39
  import type { OpRunRecord, OpRunRecordInput } from "./op/runtime";
41
40
  import type { PullRequestHead } from "./pr-forge";
42
41
 
@@ -574,7 +573,7 @@ describe("the comment's argument (#4820)", () => {
574
573
  });
575
574
 
576
575
  test("the floor is the next release until it ships", () => {
577
- expect(CI_COMMIT_ARG_FLOOR).toBe(NEXT_RELEASE);
576
+ expect(CI_COMMIT_ARG_FLOOR).toBe("0.124.78");
578
577
  });
579
578
  });
580
579
 
@@ -642,6 +641,6 @@ describe("the harness's BREAK switch for land (#4836)", () => {
642
641
  });
643
642
 
644
643
  test("the floor is the next release until it ships", () => {
645
- expect(CI_COMMIT_HARNESS_BREAK_FLOOR).toBe(NEXT_RELEASE);
644
+ expect(CI_COMMIT_HARNESS_BREAK_FLOOR).toBe("0.124.78");
646
645
  });
647
646
  });
package/src/ci-commit.ts CHANGED
@@ -32,7 +32,6 @@ import { CHANT_EXIT } from "./exit-codes";
32
32
  import { FORGE_TOKEN_VARS } from "./ci-handover";
33
33
  import { agentForbiddenPaths, AgentError, branchOk, errText, LOGIN, readSmall, SHA, type AgentGit } from "./ci-agent";
34
34
  import { COMMIT_COMMENT_ARG, parseProductComment, type CiProductWords } from "./ci-product-words";
35
- import { NEXT_RELEASE } from "./release-floors";
36
35
  import type { OpRunRecord, OpRunRecordInput } from "./op/runtime";
37
36
  import type { RunOrigin } from "./lifecycle/release-ledger";
38
37
  import type { PrForge } from "./pr-forge";
@@ -51,9 +50,9 @@ export const CI_COMMIT_FILES_FLOOR = "0.124.73";
51
50
  */
52
51
  export const CI_COMMIT_REPLY_FLOOR = "0.124.77";
53
52
  /** The first chant whose commit job takes `commentArg`, one argument after the comment's word passed into the argv (#4820). */
54
- export const CI_COMMIT_ARG_FLOOR = NEXT_RELEASE;
53
+ export const CI_COMMIT_ARG_FLOOR = "0.124.78";
55
54
  /** The first chant whose `commit land` reads {@link COMMIT_HARNESS_BREAK_ENV} in a BREAK arm of chant's e2e harness (#4836). */
56
- export const CI_COMMIT_HARNESS_BREAK_FLOOR = NEXT_RELEASE;
55
+ export const CI_COMMIT_HARNESS_BREAK_FLOOR = "0.124.78";
57
56
 
58
57
  /** What starts a commit run: a person's comment, or a check job's finding. */
59
58
  export type CommitTrigger = "comment" | "check";