@ohos-ports/nx 23.2.1-beta.1 → 23.3.0-beta.1

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 (351) hide show
  1. package/README.md +1 -1
  2. package/dist/bin/init-local.js +7 -1
  3. package/dist/bin/nx.js +2 -2
  4. package/dist/nx-cloud-internals.d.ts +1 -0
  5. package/dist/nx-cloud-internals.js +9 -0
  6. package/dist/plugins/package-json.js +1 -1
  7. package/dist/src/command-line/add/add.js +5 -1
  8. package/dist/src/command-line/affected/affected.js +70 -9
  9. package/dist/src/command-line/affected/command-object.js +1 -1
  10. package/dist/src/command-line/format/format.js +2 -18
  11. package/dist/src/command-line/graph/graph.d.ts +31 -0
  12. package/dist/src/command-line/graph/graph.js +113 -20
  13. package/dist/src/command-line/init/implementation/add-nx-to-monorepo.js +0 -3
  14. package/dist/src/command-line/init/implementation/add-nx-to-nest.js +0 -3
  15. package/dist/src/command-line/init/implementation/add-nx-to-npm-repo.js +0 -3
  16. package/dist/src/command-line/init/implementation/angular/index.js +0 -3
  17. package/dist/src/command-line/init/implementation/angular/legacy-angular-versions.js +0 -3
  18. package/dist/src/command-line/init/implementation/format.js +2 -3
  19. package/dist/src/command-line/init/implementation/utils.d.ts +0 -1
  20. package/dist/src/command-line/init/implementation/utils.js +6 -9
  21. package/dist/src/command-line/init/init-v2.js +0 -3
  22. package/dist/src/command-line/migrate/agentic/capture-generator-output.d.ts +25 -0
  23. package/dist/src/command-line/migrate/agentic/capture-generator-output.js +121 -5
  24. package/dist/src/command-line/migrate/agentic/close-agent-session.d.ts +21 -0
  25. package/dist/src/command-line/migrate/agentic/close-agent-session.js +126 -0
  26. package/dist/src/command-line/migrate/agentic/definitions.d.ts +24 -0
  27. package/dist/src/command-line/migrate/agentic/definitions.js +79 -20
  28. package/dist/src/command-line/migrate/agentic/format-command.d.ts +14 -0
  29. package/dist/src/command-line/migrate/agentic/format-command.js +44 -0
  30. package/dist/src/command-line/migrate/agentic/handoff-gitignore.d.ts +3 -3
  31. package/dist/src/command-line/migrate/agentic/handoff-gitignore.js +3 -3
  32. package/dist/src/command-line/migrate/agentic/handoff.d.ts +50 -17
  33. package/dist/src/command-line/migrate/agentic/handoff.js +166 -24
  34. package/dist/src/command-line/migrate/agentic/instruction-files.d.ts +23 -0
  35. package/dist/src/command-line/migrate/agentic/instruction-files.js +41 -0
  36. package/dist/src/command-line/migrate/agentic/master/invocations.d.ts +12 -0
  37. package/dist/src/command-line/migrate/agentic/master/invocations.js +54 -0
  38. package/dist/src/command-line/migrate/agentic/master/run-master-session.d.ts +16 -0
  39. package/dist/src/command-line/migrate/agentic/master/run-master-session.js +175 -0
  40. package/dist/src/command-line/migrate/agentic/master/spawn-master.d.ts +31 -0
  41. package/dist/src/command-line/migrate/agentic/master/spawn-master.js +222 -0
  42. package/dist/src/command-line/migrate/agentic/prompts/final-validation.d.ts +13 -0
  43. package/dist/src/command-line/migrate/agentic/prompts/final-validation.js +41 -0
  44. package/dist/src/command-line/migrate/agentic/prompts/fragments.d.ts +17 -0
  45. package/dist/src/command-line/migrate/agentic/prompts/fragments.js +90 -0
  46. package/dist/src/command-line/migrate/agentic/prompts/generic-validation.js +4 -3
  47. package/dist/src/command-line/migrate/agentic/prompts/system-prompt.d.ts +25 -1
  48. package/dist/src/command-line/migrate/agentic/prompts/system-prompt.js +57 -34
  49. package/dist/src/command-line/migrate/agentic/run-step.js +28 -4
  50. package/dist/src/command-line/migrate/agentic/runner.d.ts +3 -15
  51. package/dist/src/command-line/migrate/agentic/runner.js +57 -239
  52. package/dist/src/command-line/migrate/agentic/terminal-repair.d.ts +1 -0
  53. package/dist/src/command-line/migrate/agentic/terminal-repair.js +27 -0
  54. package/dist/src/command-line/migrate/agentic/types.d.ts +23 -8
  55. package/dist/src/command-line/migrate/agentic/types.js +10 -7
  56. package/dist/src/command-line/migrate/agentic/windows-cmd.d.ts +33 -0
  57. package/dist/src/command-line/migrate/agentic/windows-cmd.js +88 -0
  58. package/dist/src/command-line/migrate/command-object.d.ts +2 -0
  59. package/dist/src/command-line/migrate/command-object.js +11 -1
  60. package/dist/src/command-line/migrate/deferred-output.d.ts +44 -0
  61. package/dist/src/command-line/migrate/deferred-output.js +92 -0
  62. package/dist/src/command-line/migrate/execute-migration.d.ts +9 -3
  63. package/dist/src/command-line/migrate/execute-migration.js +53 -16
  64. package/dist/src/command-line/migrate/migrate-analytics.d.ts +34 -9
  65. package/dist/src/command-line/migrate/migrate-analytics.js +71 -10
  66. package/dist/src/command-line/migrate/migrate-commits.d.ts +5 -4
  67. package/dist/src/command-line/migrate/migrate-commits.js +16 -6
  68. package/dist/src/command-line/migrate/migrate-config.d.ts +5 -2
  69. package/dist/src/command-line/migrate/migrate-config.js +19 -11
  70. package/dist/src/command-line/migrate/migrate-output.d.ts +3 -7
  71. package/dist/src/command-line/migrate/migrate-output.js +3 -7
  72. package/dist/src/command-line/migrate/migrate.d.ts +3 -0
  73. package/dist/src/command-line/migrate/migrate.js +183 -46
  74. package/dist/src/command-line/migrate/resolve-package-version.js +2 -19
  75. package/dist/src/command-line/migrate/run/agent-output.d.ts +11 -0
  76. package/dist/src/command-line/migrate/run/agent-output.js +21 -2
  77. package/dist/src/command-line/migrate/run/agent-work-payload.d.ts +37 -0
  78. package/dist/src/command-line/migrate/run/agent-work-payload.js +156 -0
  79. package/dist/src/command-line/migrate/run/atomic-write.d.ts +8 -0
  80. package/dist/src/command-line/migrate/run/atomic-write.js +17 -0
  81. package/dist/src/command-line/migrate/run/broker.d.ts +150 -0
  82. package/dist/src/command-line/migrate/run/broker.js +568 -0
  83. package/dist/src/command-line/migrate/run/clean-retry.d.ts +12 -0
  84. package/dist/src/command-line/migrate/run/clean-retry.js +99 -0
  85. package/dist/src/command-line/migrate/run/existing-run-report.d.ts +55 -0
  86. package/dist/src/command-line/migrate/run/existing-run-report.js +227 -0
  87. package/dist/src/command-line/migrate/run/give-up.d.ts +41 -0
  88. package/dist/src/command-line/migrate/run/give-up.js +148 -0
  89. package/dist/src/command-line/migrate/run/index.d.ts +9 -6
  90. package/dist/src/command-line/migrate/run/index.js +21 -2
  91. package/dist/src/command-line/migrate/run/issues.d.ts +127 -0
  92. package/dist/src/command-line/migrate/run/issues.js +1121 -0
  93. package/dist/src/command-line/migrate/run/orchestrator.d.ts +59 -1
  94. package/dist/src/command-line/migrate/run/orchestrator.js +1529 -457
  95. package/dist/src/command-line/migrate/run/run-id.d.ts +0 -8
  96. package/dist/src/command-line/migrate/run/run-id.js +0 -30
  97. package/dist/src/command-line/migrate/run/run-state.d.ts +77 -17
  98. package/dist/src/command-line/migrate/run/run-state.js +263 -32
  99. package/dist/src/command-line/migrate/run/runbook.d.ts +18 -0
  100. package/dist/src/command-line/migrate/run/runbook.js +118 -0
  101. package/dist/src/command-line/migrate/run/state-lock.d.ts +33 -2
  102. package/dist/src/command-line/migrate/run/state-lock.js +128 -2
  103. package/dist/src/command-line/migrate/run/state-machine.d.ts +50 -1
  104. package/dist/src/command-line/migrate/run/state-machine.js +339 -26
  105. package/dist/src/command-line/migrate/run/util.d.ts +3 -1
  106. package/dist/src/command-line/migrate/run/util.js +24 -3
  107. package/dist/src/command-line/migrate/run/worker.js +290 -129
  108. package/dist/src/command-line/migrate/step-actions.d.ts +1 -1
  109. package/dist/src/command-line/migrate/step-actions.js +7 -1
  110. package/dist/src/command-line/migrate/text.d.ts +6 -0
  111. package/dist/src/command-line/migrate/text.js +25 -0
  112. package/dist/src/command-line/migrate/version-skew-guard.js +2 -0
  113. package/dist/src/command-line/nx-cloud/connect/connect-to-nx-cloud.js +5 -11
  114. package/dist/src/command-line/release/publish.js +11 -8
  115. package/dist/src/command-line/release/utils/get-touched-projects-for-group.js +3 -3
  116. package/dist/src/command-line/release/utils/release-graph.js +1 -1
  117. package/dist/src/command-line/release/utils/remote-release-clients/github.js +5 -8
  118. package/dist/src/command-line/release/utils/remote-release-clients/gitlab.js +3 -3
  119. package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.d.ts +4 -2
  120. package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.js +37 -3
  121. package/dist/src/command-line/release/version/version-actions.d.ts +3 -0
  122. package/dist/src/command-line/reset/reset.js +10 -4
  123. package/dist/src/command-line/run/run-one.js +5 -1
  124. package/dist/src/command-line/run-many/run-many.js +6 -12
  125. package/dist/src/command-line/show/command-object.js +1 -1
  126. package/dist/src/command-line/show/projects.js +52 -1
  127. package/dist/src/command-line/yargs-utils/shared-options.d.ts +5 -1
  128. package/dist/src/command-line/yargs-utils/shared-options.js +38 -4
  129. package/dist/src/config/task-graph.d.ts +1 -1
  130. package/dist/src/config/workspace-json-project-json.d.ts +23 -1
  131. package/dist/src/core/graph/main.js +1 -1
  132. package/dist/src/core/graph/runtime.js +1 -1
  133. package/dist/src/core/graph/styles.js +1 -1
  134. package/dist/src/daemon/client/client.d.ts +14 -8
  135. package/dist/src/daemon/client/client.js +41 -12
  136. package/dist/src/daemon/message-types/get-plugin-capabilities.d.ts +5 -0
  137. package/dist/src/daemon/message-types/get-plugin-capabilities.js +11 -0
  138. package/dist/src/daemon/message-types/run-tasks-execution-hooks.d.ts +3 -2
  139. package/dist/src/daemon/message-types/select-affected-tasks.d.ts +21 -0
  140. package/dist/src/daemon/message-types/select-affected-tasks.js +11 -0
  141. package/dist/src/daemon/message-types/ultracache-configuration-version.d.ts +8 -0
  142. package/dist/src/daemon/message-types/ultracache-configuration-version.js +2 -0
  143. package/dist/src/daemon/server/dotenv-graph-changes.d.ts +1 -1
  144. package/dist/src/daemon/server/dotenv-graph-changes.js +2 -2
  145. package/dist/src/daemon/server/handle-get-plugin-capabilities.d.ts +2 -0
  146. package/dist/src/daemon/server/handle-get-plugin-capabilities.js +13 -0
  147. package/dist/src/daemon/server/handle-hash-tasks.d.ts +10 -2
  148. package/dist/src/daemon/server/handle-hash-tasks.js +18 -3
  149. package/dist/src/daemon/server/handle-select-affected-tasks.d.ts +3 -0
  150. package/dist/src/daemon/server/handle-select-affected-tasks.js +26 -0
  151. package/dist/src/daemon/server/handle-tasks-execution-hooks.d.ts +3 -2
  152. package/dist/src/daemon/server/{handle-outputs-changes.d.ts → handle-watch-events.d.ts} +4 -4
  153. package/dist/src/daemon/server/{handle-outputs-changes.js → handle-watch-events.js} +36 -37
  154. package/dist/src/daemon/server/outputs-tracking.d.ts +7 -19
  155. package/dist/src/daemon/server/outputs-tracking.js +7 -107
  156. package/dist/src/daemon/server/planning-context.d.ts +8 -0
  157. package/dist/src/daemon/server/planning-context.js +18 -0
  158. package/dist/src/daemon/server/project-graph-incremental-recomputation.d.ts +22 -7
  159. package/dist/src/daemon/server/project-graph-incremental-recomputation.js +104 -74
  160. package/dist/src/daemon/server/restart-checks.d.ts +22 -0
  161. package/dist/src/daemon/server/restart-checks.js +77 -0
  162. package/dist/src/daemon/server/server.d.ts +1 -0
  163. package/dist/src/daemon/server/server.js +54 -30
  164. package/dist/src/daemon/server/shutdown-utils.d.ts +0 -5
  165. package/dist/src/daemon/server/shutdown-utils.js +3 -26
  166. package/dist/src/daemon/server/ultracache-configuration-state.d.ts +7 -0
  167. package/dist/src/daemon/server/ultracache-configuration-state.js +36 -0
  168. package/dist/src/devkit-internals.d.ts +3 -1
  169. package/dist/src/devkit-internals.js +8 -3
  170. package/dist/src/executors/run-commands/run-commands.impl.d.ts +2 -1
  171. package/dist/src/executors/run-commands/run-commands.impl.js +19 -5
  172. package/dist/src/executors/run-commands/running-tasks.d.ts +5 -4
  173. package/dist/src/executors/run-commands/running-tasks.js +13 -13
  174. package/dist/src/hasher/create-task-hasher.d.ts +8 -1
  175. package/dist/src/hasher/create-task-hasher.js +13 -3
  176. package/dist/src/hasher/hash-plan-inspector.js +2 -2
  177. package/dist/src/hasher/hash-task.d.ts +2 -2
  178. package/dist/src/hasher/hash-task.js +28 -17
  179. package/dist/src/hasher/native-task-hasher-impl.d.ts +20 -4
  180. package/dist/src/hasher/native-task-hasher-impl.js +75 -9
  181. package/dist/src/hasher/task-hasher.d.ts +24 -7
  182. package/dist/src/hasher/task-hasher.js +27 -8
  183. package/dist/src/hasher/task-planning-context.d.ts +13 -0
  184. package/dist/src/hasher/task-planning-context.js +12 -0
  185. package/dist/src/native/assert-supported-platform.js +1 -1
  186. package/dist/src/native/index.d.ts +582 -21
  187. package/dist/src/native/index.js +3 -5
  188. package/dist/src/native/native-bindings.js +19 -7
  189. package/dist/src/native/nx.wasm32-wasi.debug.wasm +0 -0
  190. package/dist/src/native/nx.wasm32-wasi.wasm +0 -0
  191. package/dist/src/native/transform-objects.d.ts +11 -2
  192. package/dist/src/native/transform-objects.js +46 -0
  193. package/dist/src/nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud.js +15 -8
  194. package/dist/src/nx-cloud/update-manager.d.ts +3 -0
  195. package/dist/src/nx-cloud/update-manager.js +19 -13
  196. package/dist/src/nx-cloud/utilities/client.d.ts +1 -1
  197. package/dist/src/nx-cloud/utilities/client.js +1 -1
  198. package/dist/src/nx-cloud/utilities/is-workspace-claimed.js +2 -1
  199. package/dist/src/nx-cloud/utilities/nx-cloud-http-client.d.ts +5 -0
  200. package/dist/src/nx-cloud/utilities/nx-cloud-http-client.js +16 -0
  201. package/dist/src/nx-cloud/utilities/url-shorten.js +17 -10
  202. package/dist/src/plugins/js/index.js +45 -64
  203. package/dist/src/plugins/js/lock-file/lock-file.d.ts +4 -4
  204. package/dist/src/plugins/js/lock-file/lock-file.js +6 -7
  205. package/dist/src/plugins/js/lock-file/pnpm-parser.js +1 -1
  206. package/dist/src/plugins/js/lock-file/utils/pnpm-normalizer.d.ts +2 -0
  207. package/dist/src/plugins/js/lock-file/utils/pnpm-normalizer.js +22 -0
  208. package/dist/src/plugins/js/project-graph/affected/lock-file-changes.d.ts +10 -2
  209. package/dist/src/plugins/js/project-graph/affected/lock-file-changes.js +51 -29
  210. package/dist/src/plugins/js/project-graph/affected/npm-packages.d.ts +10 -2
  211. package/dist/src/plugins/js/project-graph/affected/npm-packages.js +32 -11
  212. package/dist/src/plugins/js/project-graph/build-dependencies/target-project-locator.js +22 -18
  213. package/dist/src/plugins/js/utils/register.js +13 -4
  214. package/dist/src/plugins/package-json/create-nodes.d.ts +2 -2
  215. package/dist/src/plugins/package-json/create-nodes.js +13 -13
  216. package/dist/src/project-graph/affected/affected-project-graph-models.d.ts +14 -0
  217. package/dist/src/project-graph/affected/affected-project-graph.js +5 -18
  218. package/dist/src/project-graph/affected/affected-projects.d.ts +7 -0
  219. package/dist/src/project-graph/affected/affected-projects.js +42 -0
  220. package/dist/src/project-graph/affected/affected-reasons.d.ts +116 -0
  221. package/dist/src/project-graph/affected/affected-reasons.js +459 -0
  222. package/dist/src/project-graph/affected/affected-tasks.d.ts +103 -0
  223. package/dist/src/project-graph/affected/affected-tasks.js +386 -0
  224. package/dist/src/project-graph/affected/print-explanation.d.ts +11 -0
  225. package/dist/src/project-graph/affected/print-explanation.js +44 -0
  226. package/dist/src/project-graph/error-types.d.ts +5 -0
  227. package/dist/src/project-graph/error-types.js +44 -5
  228. package/dist/src/project-graph/file-utils.d.ts +2 -0
  229. package/dist/src/project-graph/file-utils.js +12 -3
  230. package/dist/src/project-graph/nx-deps-cache.d.ts +5 -2
  231. package/dist/src/project-graph/nx-deps-cache.js +4 -4
  232. package/dist/src/project-graph/plugins/get-plugins.d.ts +3 -1
  233. package/dist/src/project-graph/plugins/get-plugins.js +60 -82
  234. package/dist/src/project-graph/plugins/in-process-loader.d.ts +1 -1
  235. package/dist/src/project-graph/plugins/in-process-loader.js +1 -4
  236. package/dist/src/project-graph/plugins/isolation/index.d.ts +1 -1
  237. package/dist/src/project-graph/plugins/isolation/index.js +3 -1
  238. package/dist/src/project-graph/plugins/isolation/isolated-plugin.d.ts +8 -0
  239. package/dist/src/project-graph/plugins/isolation/isolated-plugin.js +42 -6
  240. package/dist/src/project-graph/plugins/isolation/load-isolated-plugin.d.ts +10 -1
  241. package/dist/src/project-graph/plugins/isolation/load-isolated-plugin.js +67 -17
  242. package/dist/src/project-graph/plugins/isolation/messaging.d.ts +3 -2
  243. package/dist/src/project-graph/plugins/isolation/plugin-worker.js +5 -1
  244. package/dist/src/project-graph/plugins/loaded-nx-plugin.d.ts +5 -2
  245. package/dist/src/project-graph/plugins/loaded-nx-plugin.js +14 -1
  246. package/dist/src/project-graph/plugins/nx-plugin-capabilities.d.ts +6 -0
  247. package/dist/src/project-graph/plugins/nx-plugin-capabilities.js +28 -0
  248. package/dist/src/project-graph/plugins/task-results-stub.d.ts +50 -0
  249. package/dist/src/project-graph/plugins/task-results-stub.js +111 -0
  250. package/dist/src/project-graph/plugins/tasks-execution-hooks.d.ts +3 -2
  251. package/dist/src/project-graph/plugins/tasks-execution-hooks.js +14 -1
  252. package/dist/src/project-graph/project-graph.js +43 -42
  253. package/dist/src/project-graph/utils/project-configuration/target-merging.js +67 -0
  254. package/dist/src/project-graph/utils/project-configuration/target-normalization.js +83 -0
  255. package/dist/src/project-graph/utils/project-configuration/utils.d.ts +1 -0
  256. package/dist/src/project-graph/utils/project-configuration/utils.js +1 -0
  257. package/dist/src/tasks-runner/batch/run-batch.js +15 -0
  258. package/dist/src/tasks-runner/cache.d.ts +37 -2
  259. package/dist/src/tasks-runner/cache.js +42 -1
  260. package/dist/src/tasks-runner/create-task-graph.d.ts +24 -1
  261. package/dist/src/tasks-runner/create-task-graph.js +57 -2
  262. package/dist/src/tasks-runner/default-tasks-runner.js +1 -1
  263. package/dist/src/tasks-runner/forked-process-task-runner.d.ts +1 -1
  264. package/dist/src/tasks-runner/forked-process-task-runner.js +11 -10
  265. package/dist/src/tasks-runner/init-tasks-runner.d.ts +7 -2
  266. package/dist/src/tasks-runner/init-tasks-runner.js +15 -7
  267. package/dist/src/tasks-runner/is-tui-enabled.js +4 -3
  268. package/dist/src/tasks-runner/life-cycle.d.ts +7 -0
  269. package/dist/src/tasks-runner/life-cycle.js +7 -0
  270. package/dist/src/tasks-runner/life-cycles/summary-terminal-output-life-cycle.d.ts +35 -0
  271. package/dist/src/tasks-runner/life-cycles/summary-terminal-output-life-cycle.js +146 -0
  272. package/dist/src/tasks-runner/prune-task-graph.d.ts +17 -0
  273. package/dist/src/tasks-runner/prune-task-graph.js +45 -0
  274. package/dist/src/tasks-runner/run-command.d.ts +41 -5
  275. package/dist/src/tasks-runner/run-command.js +98 -22
  276. package/dist/src/tasks-runner/running-tasks/batch-process.d.ts +93 -19
  277. package/dist/src/tasks-runner/running-tasks/batch-process.js +184 -88
  278. package/dist/src/tasks-runner/task-io-service.d.ts +11 -3
  279. package/dist/src/tasks-runner/task-io-service.js +14 -5
  280. package/dist/src/tasks-runner/task-orchestrator.d.ts +71 -4
  281. package/dist/src/tasks-runner/task-orchestrator.js +266 -66
  282. package/dist/src/tasks-runner/tasks-runner.d.ts +2 -0
  283. package/dist/src/tasks-runner/terminal-output-path.d.ts +11 -0
  284. package/dist/src/tasks-runner/terminal-output-path.js +18 -0
  285. package/dist/src/tasks-runner/utils.d.ts +5 -0
  286. package/dist/src/tasks-runner/utils.js +14 -2
  287. package/dist/src/ultracache/config.d.ts +21 -0
  288. package/dist/src/ultracache/config.js +29 -0
  289. package/dist/src/ultracache/fetch.d.ts +21 -0
  290. package/dist/src/ultracache/fetch.js +43 -0
  291. package/dist/src/ultracache/overrides.d.ts +17 -0
  292. package/dist/src/ultracache/overrides.js +61 -0
  293. package/dist/src/ultracache/report.d.ts +13 -0
  294. package/dist/src/ultracache/report.js +62 -0
  295. package/dist/src/ultracache/store.d.ts +41 -0
  296. package/dist/src/ultracache/store.js +158 -0
  297. package/dist/src/utils/ab-testing.d.ts +4 -1
  298. package/dist/src/utils/ab-testing.js +22 -19
  299. package/dist/src/utils/chunkify.d.ts +1 -7
  300. package/dist/src/utils/chunkify.js +2 -8
  301. package/dist/src/utils/command-line-utils.d.ts +20 -0
  302. package/dist/src/utils/command-line-utils.js +10 -3
  303. package/dist/src/utils/create-cli-options.d.ts +6 -0
  304. package/dist/src/utils/create-cli-options.js +29 -0
  305. package/dist/src/utils/db-connection.d.ts +2 -0
  306. package/dist/src/utils/db-connection.js +2 -0
  307. package/dist/src/utils/formatters/index.d.ts +6 -0
  308. package/dist/src/utils/formatters/index.js +5 -0
  309. package/dist/src/utils/formatters/prettier.d.ts +0 -8
  310. package/dist/src/utils/formatters/prettier.js +4 -26
  311. package/dist/src/utils/git-utils.d.ts +19 -0
  312. package/dist/src/utils/git-utils.js +97 -39
  313. package/dist/src/utils/handle-errors.js +5 -43
  314. package/dist/src/utils/http-client.d.ts +27 -0
  315. package/dist/src/utils/http-client.js +193 -0
  316. package/dist/src/utils/installed-nx-version.js +2 -48
  317. package/dist/src/utils/json-diff.d.ts +4 -2
  318. package/dist/src/utils/json-diff.js +6 -94
  319. package/dist/src/utils/min-release-age/packument.js +1 -1
  320. package/dist/src/utils/nx-cloud-utils.d.ts +2 -0
  321. package/dist/src/utils/nx-cloud-utils.js +6 -1
  322. package/dist/src/utils/output.d.ts +22 -3
  323. package/dist/src/utils/output.js +28 -5
  324. package/dist/src/utils/package-json.d.ts +25 -0
  325. package/dist/src/utils/package-json.js +49 -6
  326. package/dist/src/utils/package-manager.d.ts +6 -0
  327. package/dist/src/utils/package-manager.js +10 -0
  328. package/dist/src/utils/plugins/plugin-capabilities.js +7 -2
  329. package/dist/src/utils/project-graph-utils.d.ts +2 -0
  330. package/dist/src/utils/project-graph-utils.js +12 -0
  331. package/dist/src/utils/provenance.js +20 -4
  332. package/dist/src/utils/serialize-overrides-into-command-line.js +2 -4
  333. package/dist/src/utils/workspace-context.d.ts +51 -3
  334. package/dist/src/utils/workspace-context.js +174 -10
  335. package/package.json +31 -47
  336. package/schemas/nx-schema.json +38 -0
  337. package/schemas/project-schema.json +35 -0
  338. package/dist/src/daemon/server/file-watching/route-workspace-changes.d.ts +0 -9
  339. package/dist/src/daemon/server/file-watching/route-workspace-changes.js +0 -76
  340. package/dist/src/daemon/server/watcher.d.ts +0 -18
  341. package/dist/src/daemon/server/watcher.js +0 -126
  342. package/dist/src/nx-cloud/utilities/axios.d.ts +0 -4
  343. package/dist/src/nx-cloud/utilities/axios.js +0 -17
  344. package/dist/src/project-graph/affected/locators/project-glob-changes.d.ts +0 -2
  345. package/dist/src/project-graph/affected/locators/project-glob-changes.js +0 -47
  346. package/dist/src/project-graph/affected/locators/workspace-json-changes.d.ts +0 -4
  347. package/dist/src/project-graph/affected/locators/workspace-json-changes.js +0 -47
  348. package/dist/src/project-graph/affected/locators/workspace-projects.d.ts +0 -3
  349. package/dist/src/project-graph/affected/locators/workspace-projects.js +0 -74
  350. package/dist/src/utils/collapse-expanded-outputs.d.ts +0 -10
  351. package/dist/src/utils/collapse-expanded-outputs.js +0 -72
@@ -1,10 +1,12 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.selectTasksForProjects = selectTasksForProjects;
3
4
  exports.runCommand = runCommand;
4
- exports.runCommandForTasks = runCommandForTasks;
5
+ exports.runTasksForCommand = runTasksForCommand;
5
6
  exports.setEnvVarsBasedOnArgs = setEnvVarsBasedOnArgs;
6
7
  exports.invokeTasksRunner = invokeTasksRunner;
7
8
  exports.constructLifeCycles = constructLifeCycles;
9
+ exports.runnerInputsForSelection = runnerInputsForSelection;
8
10
  exports.getRunner = getRunner;
9
11
  exports.getRunnerOptions = getRunnerOptions;
10
12
  const tslib_1 = require("tslib");
@@ -23,6 +25,9 @@ const is_ci_1 = require("../utils/is-ci");
23
25
  const nx_cloud_utils_1 = require("../utils/nx-cloud-utils");
24
26
  const update_manager_1 = require("../nx-cloud/update-manager");
25
27
  const logger_1 = require("../utils/logger");
28
+ const overrides_1 = require("../ultracache/overrides");
29
+ const report_1 = require("../ultracache/report");
30
+ const store_1 = require("../ultracache/store");
26
31
  const nx_key_1 = require("../utils/nx-key");
27
32
  const output_1 = require("../utils/output");
28
33
  const configure_ai_agents_disclaimer_1 = require("../ai/configure-ai-agents-disclaimer");
@@ -35,6 +40,7 @@ const dynamic_run_many_terminal_output_life_cycle_1 = require("./life-cycles/dyn
35
40
  const dynamic_run_one_terminal_output_life_cycle_1 = require("./life-cycles/dynamic-run-one-terminal-output-life-cycle");
36
41
  const static_run_many_terminal_output_life_cycle_1 = require("./life-cycles/static-run-many-terminal-output-life-cycle");
37
42
  const static_run_one_terminal_output_life_cycle_1 = require("./life-cycles/static-run-one-terminal-output-life-cycle");
43
+ const summary_terminal_output_life_cycle_1 = require("./life-cycles/summary-terminal-output-life-cycle");
38
44
  const store_run_information_life_cycle_1 = require("./life-cycles/store-run-information-life-cycle");
39
45
  const task_history_life_cycle_1 = require("./life-cycles/task-history-life-cycle");
40
46
  const task_profiling_life_cycle_1 = require("./life-cycles/task-profiling-life-cycle");
@@ -82,7 +88,7 @@ async function getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, pr
82
88
  process.env.NX_TUI = 'false';
83
89
  }
84
90
  // Kick off in the background so the URL is ready by the exit report. A brief
85
- // sync preamble (git remote + axios load) runs here; the network call does not.
91
+ // sync preamble (git remote lookup) runs here; the network call does not.
86
92
  (0, performance_report_1.prefetchRemoteCacheOnboardingUrl)(nxJson);
87
93
  if ((0, is_tui_enabled_1.isTuiEnabled)()) {
88
94
  const interceptedNxCloudLogs = [];
@@ -265,8 +271,14 @@ async function getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, pr
265
271
  renderIsDone,
266
272
  };
267
273
  }
274
+ if (nxArgs.resolvedOutputStyle === 'summary') {
275
+ return {
276
+ lifeCycle: new summary_terminal_output_life_cycle_1.SummaryTerminalOutputLifeCycle(tasks),
277
+ renderIsDone: Promise.resolve(),
278
+ };
279
+ }
268
280
  const { runnerOptions } = getRunner(nxArgs, nxJson);
269
- const useDynamicOutput = shouldUseDynamicLifeCycle(tasks, runnerOptions, nxArgs.outputStyle);
281
+ const useDynamicOutput = shouldUseDynamicLifeCycle(tasks, runnerOptions, nxArgs.specifiedOutputStyle);
270
282
  if (isRunOne) {
271
283
  if (useDynamicOutput) {
272
284
  return await (0, dynamic_run_one_terminal_output_life_cycle_1.createRunOneDynamicOutputRenderer)({
@@ -298,8 +310,22 @@ async function getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, pr
298
310
  }
299
311
  }
300
312
  }
301
- function createTaskGraphAndRunValidations(projectGraph, extraTargetDependencies, projectNames, nxArgs, overrides, extraOptions) {
302
- const taskGraph = (0, create_task_graph_1.createTaskGraph)(projectGraph, extraTargetDependencies, projectNames, nxArgs.targets, nxArgs.configuration, overrides, extraOptions.excludeTaskDependencies);
313
+ /**
314
+ * `targets` on whole projects, as `run-many` runs them: every task of the
315
+ * projects' targets and what they depend on, with those tasks initiating.
316
+ */
317
+ function selectTasksForProjects(projectGraph, projectNames, nxArgs, overrides, extraTargetDependencies, excludeTaskDependencies) {
318
+ const taskGraph = (0, create_task_graph_1.createTaskGraph)(projectGraph, extraTargetDependencies, projectNames, nxArgs.targets, nxArgs.configuration, overrides, excludeTaskDependencies);
319
+ const projects = new Set(projectNames);
320
+ return {
321
+ taskGraph,
322
+ initiatingTaskIds: Object.values(taskGraph.tasks)
323
+ .filter((t) => projects.has(t.target.project) &&
324
+ nxArgs.targets.includes(t.target.target))
325
+ .map((t) => t.id),
326
+ };
327
+ }
328
+ function runValidations(projectGraph, taskGraph, nxArgs) {
303
329
  (0, task_graph_utils_1.assertTaskGraphDoesNotContainInvalidTargets)(taskGraph);
304
330
  const cycle = (0, task_graph_utils_1.findCycle)(taskGraph);
305
331
  if (cycle) {
@@ -325,7 +351,7 @@ function createTaskGraphAndRunValidations(projectGraph, extraTargetDependencies,
325
351
  }
326
352
  return taskGraph;
327
353
  }
328
- async function runCommand(projectsToRun, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
354
+ async function runCommand(taskSelection, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
329
355
  const status = await (0, handle_errors_1.handleErrors)(process.env.NX_VERBOSE_LOGGING === 'true', async () => {
330
356
  const id = (0, native_1.hashArray)([...process.argv, Date.now().toString()]);
331
357
  await (0, tasks_execution_hooks_1.runPreTasksExecution)({
@@ -335,7 +361,7 @@ async function runCommand(projectsToRun, currentProjectGraph, { nxJson }, nxArgs
335
361
  argv: process.argv,
336
362
  });
337
363
  const startTime = Date.now();
338
- const { taskResults, completed } = await runCommandForTasks(projectsToRun, currentProjectGraph, { nxJson }, {
364
+ const { taskResults, completed } = await runTasksForCommand(taskSelection, currentProjectGraph, { nxJson }, {
339
365
  ...nxArgs,
340
366
  skipNxCache: nxArgs.skipNxCache ||
341
367
  process.env.NX_SKIP_NX_CACHE === 'true' ||
@@ -361,17 +387,20 @@ async function runCommand(projectsToRun, currentProjectGraph, { nxJson }, nxArgs
361
387
  });
362
388
  return status;
363
389
  }
364
- async function runCommandForTasks(projectsToRun, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
390
+ async function runTasksForCommand(taskSelection, currentProjectGraph, { nxJson }, nxArgs, overrides, initiatingProject, extraTargetDependencies, extraOptions) {
365
391
  // Kick off the license lookup in the background so it overlaps with task
366
392
  // execution. The log itself is deferred to the print site below so it
367
393
  // never lands in the middle of task output.
368
394
  const nxKeyPromise = (0, nx_key_1.getNxKeyInformation)().catch(() => null);
369
- const projectNames = projectsToRun.map((t) => t.name);
370
- const projectNameSet = new Set(projectNames);
371
- const { projectGraph, taskGraph } = await ensureWorkspaceIsInSyncAndGetGraphs(currentProjectGraph, nxJson, projectNames, nxArgs, overrides, extraTargetDependencies, extraOptions);
395
+ const { projectGraph, taskGraph } = await ensureWorkspaceIsInSyncAndGetGraphs(currentProjectGraph, nxJson, nxArgs, overrides, extraTargetDependencies, extraOptions, taskSelection);
372
396
  const tasks = Object.values(taskGraph.tasks);
373
- const initiatingTasks = tasks.filter((t) => projectNameSet.has(t.target.project) &&
374
- nxArgs.targets.includes(t.target.target));
397
+ // A sync generator can remove a selected task, so absent ids are skipped.
398
+ const initiatingTasks = taskSelection.initiatingTaskIds
399
+ .map((id) => taskGraph.tasks[id])
400
+ .filter(Boolean);
401
+ const projectNames = [
402
+ ...new Set(initiatingTasks.map((t) => t.target.project)),
403
+ ];
375
404
  const { lifeCycle, renderIsDone, printSummary, restoreTerminal } = await getTerminalOutputLifeCycle(initiatingProject, initiatingTasks, projectNames, tasks, taskGraph, nxArgs, nxJson, overrides);
376
405
  try {
377
406
  const taskResults = await invokeTasksRunner({
@@ -384,6 +413,8 @@ async function runCommandForTasks(projectsToRun, currentProjectGraph, { nxJson }
384
413
  loadDotEnvFiles: extraOptions.loadDotEnvFiles,
385
414
  initiatingProject,
386
415
  initiatingTasks,
416
+ planningContext: taskSelection.planningContext,
417
+ ultracacheConfigurationOutcome: taskSelection.ultracacheConfigurationOutcome,
387
418
  });
388
419
  await renderIsDone.finally(() => restoreTerminal?.());
389
420
  if (printSummary) {
@@ -411,6 +442,9 @@ async function runCommandForTasks(projectsToRun, currentProjectGraph, { nxJson }
411
442
  }
412
443
  async function printConfigureAiAgentsDisclaimer() {
413
444
  try {
445
+ if ((0, is_ci_1.isCI)()) {
446
+ return;
447
+ }
414
448
  if (!client_1.daemonClient.enabled() || !(await client_1.daemonClient.isServerAvailable())) {
415
449
  return;
416
450
  }
@@ -437,8 +471,8 @@ function didCommandComplete(tasks, taskResults) {
437
471
  // Any stopped task means the run was interrupted
438
472
  return !Object.values(taskResults).some((r) => r.status === 'stopped');
439
473
  }
440
- async function ensureWorkspaceIsInSyncAndGetGraphs(projectGraph, nxJson, projectNames, nxArgs, overrides, extraTargetDependencies, extraOptions) {
441
- let taskGraph = createTaskGraphAndRunValidations(projectGraph, extraTargetDependencies ?? {}, projectNames, nxArgs, overrides, extraOptions);
474
+ async function ensureWorkspaceIsInSyncAndGetGraphs(projectGraph, nxJson, nxArgs, overrides, extraTargetDependencies, extraOptions, taskSelection) {
475
+ let taskGraph = runValidations(projectGraph, taskSelection.taskGraph, nxArgs);
442
476
  if (nxArgs.skipSync || (0, is_ci_1.isCI)()) {
443
477
  return { projectGraph, taskGraph };
444
478
  }
@@ -553,9 +587,21 @@ async function ensureWorkspaceIsInSyncAndGetGraphs(projectGraph, nxJson, project
553
587
  });
554
588
  await confirmRunningTasksWithSyncFailures();
555
589
  }
556
- // Re-create project graph and task graph
590
+ // Rebuild rather than carry: a sync generator may remove tasks or move inferred
591
+ // outputs, so the old graph and planning context are stale.
592
+ taskSelection.planningContext = undefined;
593
+ const projectNames = [
594
+ ...new Set(taskSelection.initiatingTaskIds
595
+ .filter((id) => taskGraph.tasks[id])
596
+ .map((id) => taskGraph.tasks[id].target.project)),
597
+ ];
557
598
  projectGraph = await (0, project_graph_1.createProjectGraphAsync)();
558
- taskGraph = createTaskGraphAndRunValidations(projectGraph, extraTargetDependencies ?? {}, projectNames, nxArgs, overrides, extraOptions);
599
+ const rebuilt = selectTasksForProjects(projectGraph, projectNames, nxArgs, overrides, extraTargetDependencies ?? {}, extraOptions.excludeTaskDependencies).taskGraph;
600
+ taskGraph = runValidations(projectGraph,
601
+ // Before validation, so a cycle or atomizer error names what will actually run.
602
+ taskSelection.taskIds
603
+ ? (0, utils_1.pruneToSelectedTasks)(rebuilt, taskSelection.taskIds)
604
+ : rebuilt, nxArgs);
559
605
  const successTitle = anySyncGeneratorsFailed
560
606
  ? // the identified changes were synced successfully, but the workspace
561
607
  // is still not up to date, which we'll mention next
@@ -641,12 +687,12 @@ function setEnvVarsBasedOnArgs(nxArgs, loadDotEnvFiles) {
641
687
  // grouping applies, let it win over the implicit request; an output style the
642
688
  // user asked for explicitly still wins over grouping.
643
689
  const batchMode = process.env.NX_BATCH_MODE === 'true' || nxArgs.batch;
644
- if (nxArgs.outputStyle == 'stream' ||
690
+ if (nxArgs.specifiedOutputStyle == 'stream' ||
645
691
  (batchMode && !(0, output_1.isLogGroupingEnabled)())) {
646
692
  process.env.NX_STREAM_OUTPUT = 'true';
647
693
  process.env.NX_PREFIX_OUTPUT = 'true';
648
694
  }
649
- if (nxArgs.outputStyle == 'stream-without-prefixes') {
695
+ if (nxArgs.specifiedOutputStyle == 'stream-without-prefixes') {
650
696
  process.env.NX_STREAM_OUTPUT = 'true';
651
697
  process.env.NX_PREFIX_OUTPUT = 'false';
652
698
  }
@@ -659,16 +705,22 @@ function setEnvVarsBasedOnArgs(nxArgs, loadDotEnvFiles) {
659
705
  process.env.NX_LOAD_DOT_ENV_FILES = 'true';
660
706
  }
661
707
  }
662
- async function invokeTasksRunner({ tasks, projectGraph, taskGraph, lifeCycle, nxJson, nxArgs, loadDotEnvFiles, initiatingProject, initiatingTasks, }) {
708
+ async function invokeTasksRunner({ tasks, projectGraph, taskGraph, lifeCycle, nxJson, nxArgs, loadDotEnvFiles, initiatingProject, initiatingTasks, planningContext, ultracacheConfigurationOutcome: loadedUltracacheConfigurationOutcome, }) {
663
709
  setEnvVarsBasedOnArgs(nxArgs, loadDotEnvFiles);
664
710
  // this needs to be done before we start to run the tasks
665
711
  const taskDetails = (0, hash_task_1.getTaskDetails)();
666
712
  const { tasksRunner, runnerOptions } = getRunner(nxArgs, nxJson);
667
- let hasher = (0, create_task_hasher_1.createTaskHasher)(projectGraph, nxJson, runnerOptions);
713
+ // Must precede hashing: the Ultracache configurations are a source for task hashes.
714
+ const ultracacheConfigurationOutcome = loadedUltracacheConfigurationOutcome !== undefined
715
+ ? loadedUltracacheConfigurationOutcome
716
+ : await (0, store_1.loadUltracacheConfigurationsForRun)(nxJson, runnerOptions);
717
+ const ultracacheConfigurations = (0, store_1.configurationsOf)(ultracacheConfigurationOutcome);
718
+ let hasher = (0, create_task_hasher_1.createTaskHasher)(projectGraph, nxJson, runnerOptions, ultracacheConfigurations, planningContext);
668
719
  // this is used for two reasons: to fetch all remote cache hits AND
669
720
  // to submit everything that is known in advance to Nx Cloud to run in
670
721
  // a distributed fashion
671
- await (0, hash_task_1.hashTasksThatDoNotDependOnOutputsOfOtherTasks)(hasher, projectGraph, taskGraph, nxJson, taskDetails);
722
+ const deferredTaskIds = await (0, hash_task_1.hashTasksThatDoNotDependOnOutputsOfOtherTasks)(hasher, projectGraph, taskGraph, nxJson, taskDetails, ultracacheConfigurations);
723
+ reportUltracacheConfigurations(ultracacheConfigurationOutcome, projectGraph, taskGraph, nxArgs);
672
724
  const taskResultsLifecycle = new task_results_life_cycle_1.TaskResultsLifeCycle();
673
725
  const compositedLifeCycle = new life_cycle_1.CompositeLifeCycle([
674
726
  ...constructLifeCycles(lifeCycle, taskGraph, nxJson, nxArgs.skipNxCache),
@@ -733,8 +785,12 @@ async function invokeTasksRunner({ tasks, projectGraph, taskGraph, lifeCycle, nx
733
785
  // per-task-env shape and normalizes internally.
734
786
  return hasher.hashTasks(tasks, taskGraph_, envOrPerTaskEnvs);
735
787
  },
788
+ hashTasksUpfront(tasks, taskGraph_, perTaskEnvs) {
789
+ return hasher.hashTasksUpfront(tasks, taskGraph_, perTaskEnvs);
790
+ },
736
791
  },
737
792
  daemon: client_1.daemonClient,
793
+ deferredTaskIds,
738
794
  });
739
795
  if (promiseOrObservable.subscribe) {
740
796
  promiseOrObservable = convertObservableToPromise(promiseOrObservable);
@@ -789,6 +845,7 @@ function shouldUseDynamicLifeCycle(tasks, options, outputStyle) {
789
845
  if ((0, is_ci_1.isCI)())
790
846
  return false;
791
847
  if ((0, output_1.isStaticOutputStyle)(outputStyle) ||
848
+ outputStyle === 'summary' ||
792
849
  outputStyle === 'stream' ||
793
850
  outputStyle === 'stream-without-prefixes')
794
851
  return false;
@@ -811,6 +868,25 @@ function loadTasksRunner(modulePath) {
811
868
  throw e;
812
869
  }
813
870
  }
871
+ function reportUltracacheConfigurations(outcome, projectGraph, taskGraph, nxArgs) {
872
+ if (!outcome || outcome.status === 'skipped')
873
+ return;
874
+ if (!nxArgs.verbose && process.env.NX_VERBOSE_LOGGING !== 'true')
875
+ return;
876
+ const summary = (0, report_1.formatUltracacheSummary)((0, overrides_1.buildUltracacheOverrides)(projectGraph, taskGraph, outcome.configurations), outcome.status);
877
+ output_1.output.note({ title: summary.line, bodyLines: summary.bodyLines });
878
+ }
879
+ /**
880
+ * What affected task selection reads from the runner options, so it plans as
881
+ * the run hashes. The Ultracache configurations are loaded once, for selection and the run.
882
+ */
883
+ async function runnerInputsForSelection(nxArgs, nxJson) {
884
+ const { runnerOptions } = getRunner(nxArgs, nxJson);
885
+ return {
886
+ ultracacheConfigurationOutcome: await (0, store_1.loadUltracacheConfigurationsForRun)(nxJson, runnerOptions),
887
+ selectivelyHashTsConfig: runnerOptions?.selectivelyHashTsConfig ?? false,
888
+ };
889
+ }
814
890
  function getRunner(nxArgs, nxJson) {
815
891
  let runner = nxArgs.runner;
816
892
  runner = runner ?? 'default';
@@ -4,6 +4,20 @@ import { BatchResults } from '../batch/batch-messages';
4
4
  export declare class BatchProcess {
5
5
  private childProcess;
6
6
  private executorName;
7
+ /**
8
+ * Whether the active output style puts task bytes on the terminal at all.
9
+ * `summary` does not, and its life cycle cannot enforce that here: this
10
+ * class writes to `output` directly from a stream handler, so without being
11
+ * told it would print a whole batch into a run that asked for log paths.
12
+ *
13
+ * False makes this capture rather than print. Suppressing the write alone
14
+ * would drop the bytes entirely off GitHub Actions, where nothing else
15
+ * captures them - and the worker's own crash output is exactly what no task
16
+ * ever claims, so it would exist nowhere.
17
+ */
18
+ private readonly printsOutput;
19
+ /** Labels the capture file so it is identifiable in `batchOutputs/`. */
20
+ private readonly batchId;
7
21
  private exitCallbacks;
8
22
  private batchResultsCallbacks;
9
23
  private taskResultsCallbacks;
@@ -24,49 +38,109 @@ export declare class BatchProcess {
24
38
  * length of a JS string.
25
39
  */
26
40
  private capturedOutputPath;
27
- private capturedOutputFd;
41
+ private capturedOutputStream;
42
+ /** Sources paused for backpressure, awaiting a 'drain' that may never come. */
43
+ private readonly pausedSources;
28
44
  /**
29
45
  * Set once the capture is released. A chunk can still arrive after that —
30
- * stdout delivers past the exit event — and reopening then would mint a
31
- * second numbered file that nothing ever cleans up.
46
+ * stdout delivers past the exit event — and writing then would reach a file
47
+ * the renderer has already read.
32
48
  */
33
49
  private capturedOutputDiscarded;
34
50
  /**
35
- * Set when writing the capture failed. Distinct from discarded: the bytes
36
- * already on disk are still the best record of the batch, so the file is kept
37
- * and rendered, while everything after the failure goes live to the terminal.
51
+ * Set when the capture file could not be written. Whatever reached it is kept
52
+ * and still rendered: that is the head of the batch's log, where a compiler's
53
+ * first non-cascading errors are. Everything after it goes to the terminal -
54
+ * see `capture`.
38
55
  */
39
56
  private capturedOutputFailed;
40
- private static capturedOutputCount;
41
- constructor(childProcess: ChildProcess, executorName: string);
57
+ /** Set once the failure has been reported, so it is said once per batch. */
58
+ private capturedOutputWarned;
59
+ /** Set before `end()`: a write after it would destroy the unflushed tail. */
60
+ private capturedOutputClosing;
61
+ private static captureSeq;
62
+ /** Turns `flushCapturedOutput` waits for a resumed source to empty. */
63
+ private static readonly MAX_DRAIN_TURNS;
64
+ /**
65
+ * Makes the capture file unique across every batch in the process, which
66
+ * `batchId` alone does not: `TasksSchedule.batchCounters` is per instance, so
67
+ * a second orchestrator in the same process - `runDiscreteTasks` and
68
+ * `runContinuousTasks`, not the CLI - re-mints `<executor> 1`, and the pid
69
+ * cannot separate them.
70
+ */
71
+ private readonly captureSeq;
72
+ /**
73
+ * Separates this capture from one minted by a DIFFERENT process, which
74
+ * `captureSeq` cannot: it is a per-process static that restarts at 1. These
75
+ * files now outlive their batch and `cacheDir` can be shared across checkouts
76
+ * of a repo, so without this a recycled pid truncates a log an earlier run's
77
+ * summary is still pointing at.
78
+ */
79
+ private readonly captureNonce;
80
+ constructor(childProcess: ChildProcess, executorName: string,
81
+ /**
82
+ * Whether the active output style puts task bytes on the terminal at all.
83
+ * `summary` does not, and its life cycle cannot enforce that here: this
84
+ * class writes to `output` directly from a stream handler, so without being
85
+ * told it would print a whole batch into a run that asked for log paths.
86
+ *
87
+ * False makes this capture rather than print. Suppressing the write alone
88
+ * would drop the bytes entirely off GitHub Actions, where nothing else
89
+ * captures them - and the worker's own crash output is exactly what no task
90
+ * ever claims, so it would exist nowhere.
91
+ */
92
+ printsOutput?: boolean,
93
+ /** Labels the capture file so it is identifiable in `batchOutputs/`. */
94
+ batchId?: string);
42
95
  onExit(cb: (code: number) => void): void;
43
96
  onBatchResults(cb: (results: BatchResults) => void): void;
44
97
  onTaskResults(cb: (task: string, result: TaskResult) => void): void;
45
98
  onOutput(cb: (output: string) => void): void;
46
99
  private capture;
100
+ /**
101
+ * Puts bytes the capture could not take back on the terminal, on the stream
102
+ * they arrived on.
103
+ */
104
+ private forwardUncaptured;
105
+ /**
106
+ * Names the failure once. A stream reports it asynchronously, so the chunk
107
+ * that tripped it may or may not have reached disk - unlike a `writeSync`,
108
+ * there is no byte count to tell. Every chunk after it is forwarded.
109
+ */
110
+ private warnCaptureFailed;
111
+ /**
112
+ * Lets the worker write again after the capture has stopped.
113
+ *
114
+ * Without this a failed capture wedges the whole run: the source stays
115
+ * paused, so the worker blocks once its stdout pipe fills, never sends its
116
+ * results, and `getResults` waits on a batch that can no longer finish.
117
+ */
118
+ private resumeCapturedSources;
119
+ private openCapturedOutput;
120
+ /**
121
+ * Flushes and closes the capture so the file is complete before a caller
122
+ * reads it.
123
+ */
124
+ flushCapturedOutput(): Promise<void>;
47
125
  /**
48
126
  * Path to the file holding everything held back from the live stream under
49
127
  * log grouping, or undefined if nothing was captured. Used to render the whole
50
128
  * batch as one fold, so output no task claimed is not lost.
51
129
  *
52
- * The file is deliberately left open rather than closed here. A worker's
53
- * stdout can deliver after its exit event — which is what `getResults()`
54
- * settles on — and leaving the fd open keeps such a chunk appending to this
55
- * same file instead of minting a second numbered one that nothing cleans up.
56
- * The caller reads the file once, synchronously, while rendering the fold, so
57
- * anything arriving after that read is not shown; writes are unbuffered, so
58
- * the read always sees a complete prefix of what has arrived by then.
130
+ * Not valid to read before `flushCapturedOutput`; that flush ends the stream,
131
+ * so a chunk arriving afterwards - a worker's stdout can deliver past the
132
+ * exit event `getResults()` settles on - is dropped rather than appended.
59
133
  */
60
134
  getCapturedOutputPath(): string | undefined;
61
135
  /** Releases the capture file. Safe to call more than once. */
62
136
  discardCapturedOutput(): void;
63
137
  /**
64
- * Closes the fd and unlinks the file, leaving no path behind for a caller to
65
- * read. Tolerates a partially-initialized capture, since it also runs when
66
- * opening or writing the file is what failed.
138
+ * Destroys the stream and unlinks the file, leaving no path behind for a
139
+ * caller to read. Tolerates a partially-initialized capture, since it also
140
+ * runs when opening or writing the file is what failed.
67
141
  */
68
142
  private releaseCapturedOutput;
69
- /** Closes the fd, keeping the file and its path readable. */
143
+ /** Destroys the stream, dropping anything still buffered. The file stays. */
70
144
  private closeCapturedOutput;
71
145
  getResults(): Promise<BatchResults>;
72
146
  send(message: Serializable): void;