@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.
- package/README.md +1 -1
- package/dist/bin/init-local.js +7 -1
- package/dist/bin/nx.js +2 -2
- package/dist/nx-cloud-internals.d.ts +1 -0
- package/dist/nx-cloud-internals.js +9 -0
- package/dist/plugins/package-json.js +1 -1
- package/dist/src/command-line/add/add.js +5 -1
- package/dist/src/command-line/affected/affected.js +70 -9
- package/dist/src/command-line/affected/command-object.js +1 -1
- package/dist/src/command-line/format/format.js +2 -18
- package/dist/src/command-line/graph/graph.d.ts +31 -0
- package/dist/src/command-line/graph/graph.js +113 -20
- package/dist/src/command-line/init/implementation/add-nx-to-monorepo.js +0 -3
- package/dist/src/command-line/init/implementation/add-nx-to-nest.js +0 -3
- package/dist/src/command-line/init/implementation/add-nx-to-npm-repo.js +0 -3
- package/dist/src/command-line/init/implementation/angular/index.js +0 -3
- package/dist/src/command-line/init/implementation/angular/legacy-angular-versions.js +0 -3
- package/dist/src/command-line/init/implementation/format.js +2 -3
- package/dist/src/command-line/init/implementation/utils.d.ts +0 -1
- package/dist/src/command-line/init/implementation/utils.js +6 -9
- package/dist/src/command-line/init/init-v2.js +0 -3
- package/dist/src/command-line/migrate/agentic/capture-generator-output.d.ts +25 -0
- package/dist/src/command-line/migrate/agentic/capture-generator-output.js +121 -5
- package/dist/src/command-line/migrate/agentic/close-agent-session.d.ts +21 -0
- package/dist/src/command-line/migrate/agentic/close-agent-session.js +126 -0
- package/dist/src/command-line/migrate/agentic/definitions.d.ts +24 -0
- package/dist/src/command-line/migrate/agentic/definitions.js +79 -20
- package/dist/src/command-line/migrate/agentic/format-command.d.ts +14 -0
- package/dist/src/command-line/migrate/agentic/format-command.js +44 -0
- package/dist/src/command-line/migrate/agentic/handoff-gitignore.d.ts +3 -3
- package/dist/src/command-line/migrate/agentic/handoff-gitignore.js +3 -3
- package/dist/src/command-line/migrate/agentic/handoff.d.ts +50 -17
- package/dist/src/command-line/migrate/agentic/handoff.js +166 -24
- package/dist/src/command-line/migrate/agentic/instruction-files.d.ts +23 -0
- package/dist/src/command-line/migrate/agentic/instruction-files.js +41 -0
- package/dist/src/command-line/migrate/agentic/master/invocations.d.ts +12 -0
- package/dist/src/command-line/migrate/agentic/master/invocations.js +54 -0
- package/dist/src/command-line/migrate/agentic/master/run-master-session.d.ts +16 -0
- package/dist/src/command-line/migrate/agentic/master/run-master-session.js +175 -0
- package/dist/src/command-line/migrate/agentic/master/spawn-master.d.ts +31 -0
- package/dist/src/command-line/migrate/agentic/master/spawn-master.js +222 -0
- package/dist/src/command-line/migrate/agentic/prompts/final-validation.d.ts +13 -0
- package/dist/src/command-line/migrate/agentic/prompts/final-validation.js +41 -0
- package/dist/src/command-line/migrate/agentic/prompts/fragments.d.ts +17 -0
- package/dist/src/command-line/migrate/agentic/prompts/fragments.js +90 -0
- package/dist/src/command-line/migrate/agentic/prompts/generic-validation.js +4 -3
- package/dist/src/command-line/migrate/agentic/prompts/system-prompt.d.ts +25 -1
- package/dist/src/command-line/migrate/agentic/prompts/system-prompt.js +57 -34
- package/dist/src/command-line/migrate/agentic/run-step.js +28 -4
- package/dist/src/command-line/migrate/agentic/runner.d.ts +3 -15
- package/dist/src/command-line/migrate/agentic/runner.js +57 -239
- package/dist/src/command-line/migrate/agentic/terminal-repair.d.ts +1 -0
- package/dist/src/command-line/migrate/agentic/terminal-repair.js +27 -0
- package/dist/src/command-line/migrate/agentic/types.d.ts +23 -8
- package/dist/src/command-line/migrate/agentic/types.js +10 -7
- package/dist/src/command-line/migrate/agentic/windows-cmd.d.ts +33 -0
- package/dist/src/command-line/migrate/agentic/windows-cmd.js +88 -0
- package/dist/src/command-line/migrate/command-object.d.ts +2 -0
- package/dist/src/command-line/migrate/command-object.js +11 -1
- package/dist/src/command-line/migrate/deferred-output.d.ts +44 -0
- package/dist/src/command-line/migrate/deferred-output.js +92 -0
- package/dist/src/command-line/migrate/execute-migration.d.ts +9 -3
- package/dist/src/command-line/migrate/execute-migration.js +53 -16
- package/dist/src/command-line/migrate/migrate-analytics.d.ts +34 -9
- package/dist/src/command-line/migrate/migrate-analytics.js +71 -10
- package/dist/src/command-line/migrate/migrate-commits.d.ts +5 -4
- package/dist/src/command-line/migrate/migrate-commits.js +16 -6
- package/dist/src/command-line/migrate/migrate-config.d.ts +5 -2
- package/dist/src/command-line/migrate/migrate-config.js +19 -11
- package/dist/src/command-line/migrate/migrate-output.d.ts +3 -7
- package/dist/src/command-line/migrate/migrate-output.js +3 -7
- package/dist/src/command-line/migrate/migrate.d.ts +3 -0
- package/dist/src/command-line/migrate/migrate.js +183 -46
- package/dist/src/command-line/migrate/resolve-package-version.js +2 -19
- package/dist/src/command-line/migrate/run/agent-output.d.ts +11 -0
- package/dist/src/command-line/migrate/run/agent-output.js +21 -2
- package/dist/src/command-line/migrate/run/agent-work-payload.d.ts +37 -0
- package/dist/src/command-line/migrate/run/agent-work-payload.js +156 -0
- package/dist/src/command-line/migrate/run/atomic-write.d.ts +8 -0
- package/dist/src/command-line/migrate/run/atomic-write.js +17 -0
- package/dist/src/command-line/migrate/run/broker.d.ts +150 -0
- package/dist/src/command-line/migrate/run/broker.js +568 -0
- package/dist/src/command-line/migrate/run/clean-retry.d.ts +12 -0
- package/dist/src/command-line/migrate/run/clean-retry.js +99 -0
- package/dist/src/command-line/migrate/run/existing-run-report.d.ts +55 -0
- package/dist/src/command-line/migrate/run/existing-run-report.js +227 -0
- package/dist/src/command-line/migrate/run/give-up.d.ts +41 -0
- package/dist/src/command-line/migrate/run/give-up.js +148 -0
- package/dist/src/command-line/migrate/run/index.d.ts +9 -6
- package/dist/src/command-line/migrate/run/index.js +21 -2
- package/dist/src/command-line/migrate/run/issues.d.ts +127 -0
- package/dist/src/command-line/migrate/run/issues.js +1121 -0
- package/dist/src/command-line/migrate/run/orchestrator.d.ts +59 -1
- package/dist/src/command-line/migrate/run/orchestrator.js +1529 -457
- package/dist/src/command-line/migrate/run/run-id.d.ts +0 -8
- package/dist/src/command-line/migrate/run/run-id.js +0 -30
- package/dist/src/command-line/migrate/run/run-state.d.ts +77 -17
- package/dist/src/command-line/migrate/run/run-state.js +263 -32
- package/dist/src/command-line/migrate/run/runbook.d.ts +18 -0
- package/dist/src/command-line/migrate/run/runbook.js +118 -0
- package/dist/src/command-line/migrate/run/state-lock.d.ts +33 -2
- package/dist/src/command-line/migrate/run/state-lock.js +128 -2
- package/dist/src/command-line/migrate/run/state-machine.d.ts +50 -1
- package/dist/src/command-line/migrate/run/state-machine.js +339 -26
- package/dist/src/command-line/migrate/run/util.d.ts +3 -1
- package/dist/src/command-line/migrate/run/util.js +24 -3
- package/dist/src/command-line/migrate/run/worker.js +290 -129
- package/dist/src/command-line/migrate/step-actions.d.ts +1 -1
- package/dist/src/command-line/migrate/step-actions.js +7 -1
- package/dist/src/command-line/migrate/text.d.ts +6 -0
- package/dist/src/command-line/migrate/text.js +25 -0
- package/dist/src/command-line/migrate/version-skew-guard.js +2 -0
- package/dist/src/command-line/nx-cloud/connect/connect-to-nx-cloud.js +5 -11
- package/dist/src/command-line/release/publish.js +11 -8
- package/dist/src/command-line/release/utils/get-touched-projects-for-group.js +3 -3
- package/dist/src/command-line/release/utils/release-graph.js +1 -1
- package/dist/src/command-line/release/utils/remote-release-clients/github.js +5 -8
- package/dist/src/command-line/release/utils/remote-release-clients/gitlab.js +3 -3
- package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.d.ts +4 -2
- package/dist/src/command-line/release/utils/remote-release-clients/remote-release-client.js +37 -3
- package/dist/src/command-line/release/version/version-actions.d.ts +3 -0
- package/dist/src/command-line/reset/reset.js +10 -4
- package/dist/src/command-line/run/run-one.js +5 -1
- package/dist/src/command-line/run-many/run-many.js +6 -12
- package/dist/src/command-line/show/command-object.js +1 -1
- package/dist/src/command-line/show/projects.js +52 -1
- package/dist/src/command-line/yargs-utils/shared-options.d.ts +5 -1
- package/dist/src/command-line/yargs-utils/shared-options.js +38 -4
- package/dist/src/config/task-graph.d.ts +1 -1
- package/dist/src/config/workspace-json-project-json.d.ts +23 -1
- package/dist/src/core/graph/main.js +1 -1
- package/dist/src/core/graph/runtime.js +1 -1
- package/dist/src/core/graph/styles.js +1 -1
- package/dist/src/daemon/client/client.d.ts +14 -8
- package/dist/src/daemon/client/client.js +41 -12
- package/dist/src/daemon/message-types/get-plugin-capabilities.d.ts +5 -0
- package/dist/src/daemon/message-types/get-plugin-capabilities.js +11 -0
- package/dist/src/daemon/message-types/run-tasks-execution-hooks.d.ts +3 -2
- package/dist/src/daemon/message-types/select-affected-tasks.d.ts +21 -0
- package/dist/src/daemon/message-types/select-affected-tasks.js +11 -0
- package/dist/src/daemon/message-types/ultracache-configuration-version.d.ts +8 -0
- package/dist/src/daemon/message-types/ultracache-configuration-version.js +2 -0
- package/dist/src/daemon/server/dotenv-graph-changes.d.ts +1 -1
- package/dist/src/daemon/server/dotenv-graph-changes.js +2 -2
- package/dist/src/daemon/server/handle-get-plugin-capabilities.d.ts +2 -0
- package/dist/src/daemon/server/handle-get-plugin-capabilities.js +13 -0
- package/dist/src/daemon/server/handle-hash-tasks.d.ts +10 -2
- package/dist/src/daemon/server/handle-hash-tasks.js +18 -3
- package/dist/src/daemon/server/handle-select-affected-tasks.d.ts +3 -0
- package/dist/src/daemon/server/handle-select-affected-tasks.js +26 -0
- package/dist/src/daemon/server/handle-tasks-execution-hooks.d.ts +3 -2
- package/dist/src/daemon/server/{handle-outputs-changes.d.ts → handle-watch-events.d.ts} +4 -4
- package/dist/src/daemon/server/{handle-outputs-changes.js → handle-watch-events.js} +36 -37
- package/dist/src/daemon/server/outputs-tracking.d.ts +7 -19
- package/dist/src/daemon/server/outputs-tracking.js +7 -107
- package/dist/src/daemon/server/planning-context.d.ts +8 -0
- package/dist/src/daemon/server/planning-context.js +18 -0
- package/dist/src/daemon/server/project-graph-incremental-recomputation.d.ts +22 -7
- package/dist/src/daemon/server/project-graph-incremental-recomputation.js +104 -74
- package/dist/src/daemon/server/restart-checks.d.ts +22 -0
- package/dist/src/daemon/server/restart-checks.js +77 -0
- package/dist/src/daemon/server/server.d.ts +1 -0
- package/dist/src/daemon/server/server.js +54 -30
- package/dist/src/daemon/server/shutdown-utils.d.ts +0 -5
- package/dist/src/daemon/server/shutdown-utils.js +3 -26
- package/dist/src/daemon/server/ultracache-configuration-state.d.ts +7 -0
- package/dist/src/daemon/server/ultracache-configuration-state.js +36 -0
- package/dist/src/devkit-internals.d.ts +3 -1
- package/dist/src/devkit-internals.js +8 -3
- package/dist/src/executors/run-commands/run-commands.impl.d.ts +2 -1
- package/dist/src/executors/run-commands/run-commands.impl.js +19 -5
- package/dist/src/executors/run-commands/running-tasks.d.ts +5 -4
- package/dist/src/executors/run-commands/running-tasks.js +13 -13
- package/dist/src/hasher/create-task-hasher.d.ts +8 -1
- package/dist/src/hasher/create-task-hasher.js +13 -3
- package/dist/src/hasher/hash-plan-inspector.js +2 -2
- package/dist/src/hasher/hash-task.d.ts +2 -2
- package/dist/src/hasher/hash-task.js +28 -17
- package/dist/src/hasher/native-task-hasher-impl.d.ts +20 -4
- package/dist/src/hasher/native-task-hasher-impl.js +75 -9
- package/dist/src/hasher/task-hasher.d.ts +24 -7
- package/dist/src/hasher/task-hasher.js +27 -8
- package/dist/src/hasher/task-planning-context.d.ts +13 -0
- package/dist/src/hasher/task-planning-context.js +12 -0
- package/dist/src/native/assert-supported-platform.js +1 -1
- package/dist/src/native/index.d.ts +582 -21
- package/dist/src/native/index.js +3 -5
- package/dist/src/native/native-bindings.js +19 -7
- package/dist/src/native/nx.wasm32-wasi.debug.wasm +0 -0
- package/dist/src/native/nx.wasm32-wasi.wasm +0 -0
- package/dist/src/native/transform-objects.d.ts +11 -2
- package/dist/src/native/transform-objects.js +46 -0
- package/dist/src/nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud.js +15 -8
- package/dist/src/nx-cloud/update-manager.d.ts +3 -0
- package/dist/src/nx-cloud/update-manager.js +19 -13
- package/dist/src/nx-cloud/utilities/client.d.ts +1 -1
- package/dist/src/nx-cloud/utilities/client.js +1 -1
- package/dist/src/nx-cloud/utilities/is-workspace-claimed.js +2 -1
- package/dist/src/nx-cloud/utilities/nx-cloud-http-client.d.ts +5 -0
- package/dist/src/nx-cloud/utilities/nx-cloud-http-client.js +16 -0
- package/dist/src/nx-cloud/utilities/url-shorten.js +17 -10
- package/dist/src/plugins/js/index.js +45 -64
- package/dist/src/plugins/js/lock-file/lock-file.d.ts +4 -4
- package/dist/src/plugins/js/lock-file/lock-file.js +6 -7
- package/dist/src/plugins/js/lock-file/pnpm-parser.js +1 -1
- package/dist/src/plugins/js/lock-file/utils/pnpm-normalizer.d.ts +2 -0
- package/dist/src/plugins/js/lock-file/utils/pnpm-normalizer.js +22 -0
- package/dist/src/plugins/js/project-graph/affected/lock-file-changes.d.ts +10 -2
- package/dist/src/plugins/js/project-graph/affected/lock-file-changes.js +51 -29
- package/dist/src/plugins/js/project-graph/affected/npm-packages.d.ts +10 -2
- package/dist/src/plugins/js/project-graph/affected/npm-packages.js +32 -11
- package/dist/src/plugins/js/project-graph/build-dependencies/target-project-locator.js +22 -18
- package/dist/src/plugins/js/utils/register.js +13 -4
- package/dist/src/plugins/package-json/create-nodes.d.ts +2 -2
- package/dist/src/plugins/package-json/create-nodes.js +13 -13
- package/dist/src/project-graph/affected/affected-project-graph-models.d.ts +14 -0
- package/dist/src/project-graph/affected/affected-project-graph.js +5 -18
- package/dist/src/project-graph/affected/affected-projects.d.ts +7 -0
- package/dist/src/project-graph/affected/affected-projects.js +42 -0
- package/dist/src/project-graph/affected/affected-reasons.d.ts +116 -0
- package/dist/src/project-graph/affected/affected-reasons.js +459 -0
- package/dist/src/project-graph/affected/affected-tasks.d.ts +103 -0
- package/dist/src/project-graph/affected/affected-tasks.js +386 -0
- package/dist/src/project-graph/affected/print-explanation.d.ts +11 -0
- package/dist/src/project-graph/affected/print-explanation.js +44 -0
- package/dist/src/project-graph/error-types.d.ts +5 -0
- package/dist/src/project-graph/error-types.js +44 -5
- package/dist/src/project-graph/file-utils.d.ts +2 -0
- package/dist/src/project-graph/file-utils.js +12 -3
- package/dist/src/project-graph/nx-deps-cache.d.ts +5 -2
- package/dist/src/project-graph/nx-deps-cache.js +4 -4
- package/dist/src/project-graph/plugins/get-plugins.d.ts +3 -1
- package/dist/src/project-graph/plugins/get-plugins.js +60 -82
- package/dist/src/project-graph/plugins/in-process-loader.d.ts +1 -1
- package/dist/src/project-graph/plugins/in-process-loader.js +1 -4
- package/dist/src/project-graph/plugins/isolation/index.d.ts +1 -1
- package/dist/src/project-graph/plugins/isolation/index.js +3 -1
- package/dist/src/project-graph/plugins/isolation/isolated-plugin.d.ts +8 -0
- package/dist/src/project-graph/plugins/isolation/isolated-plugin.js +42 -6
- package/dist/src/project-graph/plugins/isolation/load-isolated-plugin.d.ts +10 -1
- package/dist/src/project-graph/plugins/isolation/load-isolated-plugin.js +67 -17
- package/dist/src/project-graph/plugins/isolation/messaging.d.ts +3 -2
- package/dist/src/project-graph/plugins/isolation/plugin-worker.js +5 -1
- package/dist/src/project-graph/plugins/loaded-nx-plugin.d.ts +5 -2
- package/dist/src/project-graph/plugins/loaded-nx-plugin.js +14 -1
- package/dist/src/project-graph/plugins/nx-plugin-capabilities.d.ts +6 -0
- package/dist/src/project-graph/plugins/nx-plugin-capabilities.js +28 -0
- package/dist/src/project-graph/plugins/task-results-stub.d.ts +50 -0
- package/dist/src/project-graph/plugins/task-results-stub.js +111 -0
- package/dist/src/project-graph/plugins/tasks-execution-hooks.d.ts +3 -2
- package/dist/src/project-graph/plugins/tasks-execution-hooks.js +14 -1
- package/dist/src/project-graph/project-graph.js +43 -42
- package/dist/src/project-graph/utils/project-configuration/target-merging.js +67 -0
- package/dist/src/project-graph/utils/project-configuration/target-normalization.js +83 -0
- package/dist/src/project-graph/utils/project-configuration/utils.d.ts +1 -0
- package/dist/src/project-graph/utils/project-configuration/utils.js +1 -0
- package/dist/src/tasks-runner/batch/run-batch.js +15 -0
- package/dist/src/tasks-runner/cache.d.ts +37 -2
- package/dist/src/tasks-runner/cache.js +42 -1
- package/dist/src/tasks-runner/create-task-graph.d.ts +24 -1
- package/dist/src/tasks-runner/create-task-graph.js +57 -2
- package/dist/src/tasks-runner/default-tasks-runner.js +1 -1
- package/dist/src/tasks-runner/forked-process-task-runner.d.ts +1 -1
- package/dist/src/tasks-runner/forked-process-task-runner.js +11 -10
- package/dist/src/tasks-runner/init-tasks-runner.d.ts +7 -2
- package/dist/src/tasks-runner/init-tasks-runner.js +15 -7
- package/dist/src/tasks-runner/is-tui-enabled.js +4 -3
- package/dist/src/tasks-runner/life-cycle.d.ts +7 -0
- package/dist/src/tasks-runner/life-cycle.js +7 -0
- package/dist/src/tasks-runner/life-cycles/summary-terminal-output-life-cycle.d.ts +35 -0
- package/dist/src/tasks-runner/life-cycles/summary-terminal-output-life-cycle.js +146 -0
- package/dist/src/tasks-runner/prune-task-graph.d.ts +17 -0
- package/dist/src/tasks-runner/prune-task-graph.js +45 -0
- package/dist/src/tasks-runner/run-command.d.ts +41 -5
- package/dist/src/tasks-runner/run-command.js +98 -22
- package/dist/src/tasks-runner/running-tasks/batch-process.d.ts +93 -19
- package/dist/src/tasks-runner/running-tasks/batch-process.js +184 -88
- package/dist/src/tasks-runner/task-io-service.d.ts +11 -3
- package/dist/src/tasks-runner/task-io-service.js +14 -5
- package/dist/src/tasks-runner/task-orchestrator.d.ts +71 -4
- package/dist/src/tasks-runner/task-orchestrator.js +266 -66
- package/dist/src/tasks-runner/tasks-runner.d.ts +2 -0
- package/dist/src/tasks-runner/terminal-output-path.d.ts +11 -0
- package/dist/src/tasks-runner/terminal-output-path.js +18 -0
- package/dist/src/tasks-runner/utils.d.ts +5 -0
- package/dist/src/tasks-runner/utils.js +14 -2
- package/dist/src/ultracache/config.d.ts +21 -0
- package/dist/src/ultracache/config.js +29 -0
- package/dist/src/ultracache/fetch.d.ts +21 -0
- package/dist/src/ultracache/fetch.js +43 -0
- package/dist/src/ultracache/overrides.d.ts +17 -0
- package/dist/src/ultracache/overrides.js +61 -0
- package/dist/src/ultracache/report.d.ts +13 -0
- package/dist/src/ultracache/report.js +62 -0
- package/dist/src/ultracache/store.d.ts +41 -0
- package/dist/src/ultracache/store.js +158 -0
- package/dist/src/utils/ab-testing.d.ts +4 -1
- package/dist/src/utils/ab-testing.js +22 -19
- package/dist/src/utils/chunkify.d.ts +1 -7
- package/dist/src/utils/chunkify.js +2 -8
- package/dist/src/utils/command-line-utils.d.ts +20 -0
- package/dist/src/utils/command-line-utils.js +10 -3
- package/dist/src/utils/create-cli-options.d.ts +6 -0
- package/dist/src/utils/create-cli-options.js +29 -0
- package/dist/src/utils/db-connection.d.ts +2 -0
- package/dist/src/utils/db-connection.js +2 -0
- package/dist/src/utils/formatters/index.d.ts +6 -0
- package/dist/src/utils/formatters/index.js +5 -0
- package/dist/src/utils/formatters/prettier.d.ts +0 -8
- package/dist/src/utils/formatters/prettier.js +4 -26
- package/dist/src/utils/git-utils.d.ts +19 -0
- package/dist/src/utils/git-utils.js +97 -39
- package/dist/src/utils/handle-errors.js +5 -43
- package/dist/src/utils/http-client.d.ts +27 -0
- package/dist/src/utils/http-client.js +193 -0
- package/dist/src/utils/installed-nx-version.js +2 -48
- package/dist/src/utils/json-diff.d.ts +4 -2
- package/dist/src/utils/json-diff.js +6 -94
- package/dist/src/utils/min-release-age/packument.js +1 -1
- package/dist/src/utils/nx-cloud-utils.d.ts +2 -0
- package/dist/src/utils/nx-cloud-utils.js +6 -1
- package/dist/src/utils/output.d.ts +22 -3
- package/dist/src/utils/output.js +28 -5
- package/dist/src/utils/package-json.d.ts +25 -0
- package/dist/src/utils/package-json.js +49 -6
- package/dist/src/utils/package-manager.d.ts +6 -0
- package/dist/src/utils/package-manager.js +10 -0
- package/dist/src/utils/plugins/plugin-capabilities.js +7 -2
- package/dist/src/utils/project-graph-utils.d.ts +2 -0
- package/dist/src/utils/project-graph-utils.js +12 -0
- package/dist/src/utils/provenance.js +20 -4
- package/dist/src/utils/serialize-overrides-into-command-line.js +2 -4
- package/dist/src/utils/workspace-context.d.ts +51 -3
- package/dist/src/utils/workspace-context.js +174 -10
- package/package.json +31 -47
- package/schemas/nx-schema.json +38 -0
- package/schemas/project-schema.json +35 -0
- package/dist/src/daemon/server/file-watching/route-workspace-changes.d.ts +0 -9
- package/dist/src/daemon/server/file-watching/route-workspace-changes.js +0 -76
- package/dist/src/daemon/server/watcher.d.ts +0 -18
- package/dist/src/daemon/server/watcher.js +0 -126
- package/dist/src/nx-cloud/utilities/axios.d.ts +0 -4
- package/dist/src/nx-cloud/utilities/axios.js +0 -17
- package/dist/src/project-graph/affected/locators/project-glob-changes.d.ts +0 -2
- package/dist/src/project-graph/affected/locators/project-glob-changes.js +0 -47
- package/dist/src/project-graph/affected/locators/workspace-json-changes.d.ts +0 -4
- package/dist/src/project-graph/affected/locators/workspace-json-changes.js +0 -47
- package/dist/src/project-graph/affected/locators/workspace-projects.d.ts +0 -3
- package/dist/src/project-graph/affected/locators/workspace-projects.js +0 -74
- package/dist/src/utils/collapse-expanded-outputs.d.ts +0 -10
- 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.
|
|
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
|
|
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.
|
|
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
|
-
|
|
302
|
-
|
|
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(
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
374
|
-
|
|
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,
|
|
441
|
-
let taskGraph =
|
|
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
|
-
//
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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
|
-
|
|
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
|
|
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
|
|
31
|
-
*
|
|
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
|
|
36
|
-
*
|
|
37
|
-
*
|
|
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
|
-
|
|
41
|
-
|
|
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
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
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
|
-
*
|
|
65
|
-
* read. Tolerates a partially-initialized capture, since it also
|
|
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
|
-
/**
|
|
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;
|