@rushstack/operation-graph 0.5.5 → 0.6.0

package/CHANGELOG.json

@@ -1,6 +1,50 @@
 {
   "name": "@rushstack/operation-graph",
   "entries": [
+    {
+      "version": "0.6.0",
+      "tag": "@rushstack/operation-graph_v0.6.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.5.7",
+      "tag": "@rushstack/operation-graph_v0.5.7",
+      "date": "Wed, 07 Jan 2026 01:12:24 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.21.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.5.6",
+      "tag": "@rushstack/operation-graph_v0.5.6",
+      "date": "Mon, 05 Jan 2026 16:12:49 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.20.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.5.5",
       "tag": "@rushstack/operation-graph_v0.5.5",

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Change Log - @rushstack/operation-graph
 
-This log was last generated on Sat, 06 Dec 2025 01:12:29 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 0.6.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
+
+## 0.5.7
+Wed, 07 Jan 2026 01:12:24 GMT
+
+_Version update only_
+
+## 0.5.6
+Mon, 05 Jan 2026 16:12:49 GMT
+
+_Version update only_
 
 ## 0.5.5
 Sat, 06 Dec 2025 01:12:29 GMT

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.54.0"
+      "packageVersion": "7.55.2"
     }
   ]
 }

package/lib-esm/IOperationRunner.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=IOperationRunner.js.map

package/lib-esm/IOperationRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOperationRunner.js","sourceRoot":"","sources":["../src/IOperationRunner.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { OperationStatus } from './OperationStatus';\nimport type { OperationError } from './OperationError';\nimport type { Stopwatch } from './Stopwatch';\n\n/**\n * Information passed to the executing `IOperationRunner`\n *\n * @beta\n */\nexport interface IOperationRunnerContext {\n  /**\n   * An abort signal for the overarching execution. Runners should do their best to gracefully abort\n   * as soon as possible if the signal is aborted.\n   */\n  abortSignal: AbortSignal;\n\n  /**\n   * If this is the first time this operation has been executed.\n   */\n  isFirstRun: boolean;\n\n  /**\n   * A callback to the overarching orchestrator to request that the operation be invoked again.\n   * Used in watch mode to signal that inputs have changed.\n   *\n   * @param detail - Optional detail about why the rerun is requested, e.g. the name of a changed file.\n   */\n  requestRun?: (detail?: string) => void;\n}\n\n/**\n * Interface contract for a single state of an operation.\n *\n * @beta\n */\nexport interface IOperationState {\n  /**\n   * The status code for the operation.\n   */\n  status: OperationStatus;\n  /**\n   * Whether the operation has been run at least once.\n   */\n  hasBeenRun: boolean;\n  /**\n   * The error, if the status is `OperationStatus.Failure`.\n   */\n  error: OperationError | undefined;\n  /**\n   * Timing information for the operation.\n   */\n  stopwatch: Stopwatch;\n}\n\n/**\n * Interface contract for the current and past state of an operation.\n *\n * @beta\n */\nexport interface IOperationStates {\n  /**\n   * The current state of the operation.\n   */\n  readonly state: Readonly<IOperationState> | undefined;\n  /**\n   * The previous state of the operation.\n   */\n  readonly lastState: Readonly<IOperationState> | undefined;\n}\n\n/**\n * The `Operation` class is a node in the dependency graph of work that needs to be scheduled by the\n * `OperationExecutionManager`. Each `Operation` has a `runner` member of type `IOperationRunner`, whose\n * implementation manages the actual process for running a single operation.\n *\n * @beta\n */\nexport interface IOperationRunner {\n  /**\n   * Name of the operation, for logging.\n   */\n  readonly name: string;\n\n  /**\n   * Indicates that this runner is architectural and should not be reported on.\n   */\n  silent: boolean;\n\n  /**\n   * Method to be executed for the operation.\n   */\n  executeAsync(context: IOperationRunnerContext): Promise<OperationStatus>;\n}\n"]}

package/lib-esm/Operation.js

@@ -0,0 +1,218 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { InternalError } from '@rushstack/node-core-library';
+import { Stopwatch } from './Stopwatch';
+import { OperationStatus } from './OperationStatus';
+/**
+ * The `Operation` class is a node in the dependency graph of work that needs to be scheduled by the
+ * `OperationExecutionManager`. Each `Operation` has a `runner` member of type `IOperationRunner`, whose
+ * implementation manages the actual process of running a single operation.
+ *
+ * The graph of `Operation` instances will be cloned into a separate execution graph after processing.
+ *
+ * @beta
+ */
+export class Operation {
+    constructor(options) {
+        /**
+         * A set of all dependencies which must be executed before this operation is complete.
+         */
+        this.dependencies = new Set();
+        /**
+         * A set of all operations that wait for this operation.
+         */
+        this.consumers = new Set();
+        /**
+         * When the scheduler is ready to process this `Operation`, the `runner` implements the actual work of
+         * running the operation.
+         */
+        this.runner = undefined;
+        /**
+         * This number represents how far away this Operation is from the furthest "root" operation (i.e.
+         * an operation with no consumers). This helps us to calculate the critical path (i.e. the
+         * longest chain of projects which must be executed in order, thereby limiting execution speed
+         * of the entire operation tree.
+         *
+         * This number is calculated via a memoized depth-first search, and when choosing the next
+         * operation to execute, the operation with the highest criticalPathLength is chosen.
+         *
+         * Example:
+         *        (0) A
+         *             \\
+         *          (1) B     C (0)         (applications)
+         *               \\   /|\\
+         *                \\ / | \\
+         *             (2) D  |  X (1)      (utilities)
+         *                    | / \\
+         *                    |/   \\
+         *                (2) Y     Z (2)   (other utilities)
+         *
+         * All roots (A & C) have a criticalPathLength of 0.
+         * B has a score of 1, since A depends on it.
+         * D has a score of 2, since we look at the longest chain (e.g D-\>B-\>A is longer than D-\>C)
+         * X has a score of 1, since the only package which depends on it is A
+         * Z has a score of 2, since only X depends on it, and X has a score of 1
+         * Y has a score of 2, since the chain Y-\>X-\>C is longer than Y-\>C
+         *
+         * The algorithm is implemented in AsyncOperationQueue.ts as calculateCriticalPathLength()
+         */
+        this.criticalPathLength = undefined;
+        /**
+         * The state of this operation the previous time a manager was invoked.
+         */
+        this.lastState = undefined;
+        /**
+         * The current state of this operation
+         */
+        this.state = undefined;
+        /**
+         * A cached execution promise for the current OperationExecutionManager invocation of this operation.
+         */
+        this._promise = undefined;
+        /**
+         * If true, then a run of this operation is currently wanted.
+         * This is used to track state from the `requestRun` callback passed to the runner.
+         */
+        this._runPending = true;
+        this.group = options.group;
+        this.runner = options.runner;
+        this.weight = options.weight ?? 1;
+        this.name = options.name;
+        this.metadata = options.metadata || {};
+        if (this.group) {
+            this.group.addOperation(this);
+        }
+    }
+    addDependency(dependency) {
+        this.dependencies.add(dependency);
+        dependency.consumers.add(this);
+    }
+    deleteDependency(dependency) {
+        this.dependencies.delete(dependency);
+        dependency.consumers.delete(this);
+    }
+    reset() {
+        // Reset operation state
+        this.lastState = this.state;
+        this.state = {
+            status: this.dependencies.size > 0 ? OperationStatus.Waiting : OperationStatus.Ready,
+            hasBeenRun: this.lastState?.hasBeenRun ?? false,
+            error: undefined,
+            stopwatch: new Stopwatch()
+        };
+        this._promise = undefined;
+        this._runPending = true;
+    }
+    /**
+     * @internal
+     */
+    async _executeAsync(context) {
+        const { state } = this;
+        if (!state) {
+            throw new Error(`Operation state has not been initialized.`);
+        }
+        if (!this._promise) {
+            this._promise = this._executeInnerAsync(context, state);
+        }
+        return this._promise;
+    }
+    async _executeInnerAsync(context, rawState) {
+        const state = rawState;
+        const { runner } = this;
+        const dependencyResults = await Promise.allSettled(Array.from(this.dependencies, (dependency) => dependency._executeAsync(context)));
+        const { abortSignal, requestRun, queueWork } = context;
+        if (abortSignal.aborted) {
+            state.status = OperationStatus.Aborted;
+            return state.status;
+        }
+        for (const result of dependencyResults) {
+            if (result.status === 'rejected' ||
+                result.value === OperationStatus.Blocked ||
+                result.value === OperationStatus.Failure) {
+                state.status = OperationStatus.Blocked;
+                return state.status;
+            }
+        }
+        state.status = OperationStatus.Ready;
+        const innerContext = {
+            abortSignal,
+            isFirstRun: !state.hasBeenRun,
+            requestRun: requestRun
+                ? (detail) => {
+                    switch (this.state?.status) {
+                        case OperationStatus.Waiting:
+                        case OperationStatus.Ready:
+                        case OperationStatus.Executing:
+                            // If current status has not yet resolved to a fixed value,
+                            // re-executing this operation does not require a full rerun
+                            // of the operation graph. Simply mark that a run is requested.
+                            // This variable is on the Operation instead of the
+                            // containing closure to deal with scenarios in which
+                            // the runner hangs on to an old copy of the callback.
+                            this._runPending = true;
+                            return;
+                        case OperationStatus.Blocked:
+                        case OperationStatus.Aborted:
+                        case OperationStatus.Failure:
+                        case OperationStatus.NoOp:
+                        case OperationStatus.Success:
+                            // The requestRun callback is assumed to remain constant
+                            // throughout the lifetime of the process, so it is safe
+                            // to capture here.
+                            return requestRun(this.name, detail);
+                        default:
+                            // This line is here to enforce exhaustiveness
+                            const currentStatus = this.state?.status;
+                            throw new InternalError(`Unexpected status: ${currentStatus}`);
+                    }
+                }
+                : undefined
+        };
+        // eslint-disable-next-line require-atomic-updates
+        state.status = await queueWork(async () => {
+            // Redundant variable to satisfy require-atomic-updates
+            const innerState = state;
+            if (abortSignal.aborted) {
+                innerState.status = OperationStatus.Aborted;
+                return innerState.status;
+            }
+            context.beforeExecute(this, innerState);
+            innerState.stopwatch.start();
+            innerState.status = OperationStatus.Executing;
+            // Mark that the operation has been started at least once.
+            innerState.hasBeenRun = true;
+            while (this._runPending) {
+                this._runPending = false;
+                try {
+                    // We don't support aborting in the middle of a runner's execution.
+                    innerState.status = runner ? await runner.executeAsync(innerContext) : OperationStatus.NoOp;
+                }
+                catch (error) {
+                    innerState.status = OperationStatus.Failure;
+                    innerState.error = error;
+                }
+                // Since runner.executeAsync is async, a change could have occurred that requires re-execution
+                // This operation is still active, so can re-execute immediately, rather than forcing a whole
+                // new execution pass.
+                // As currently written, this does mean that if a job is scheduled with higher priority while
+                // this operation is still executing, it will still wait for this retry. This may not be desired
+                // and if it becomes a problem, the retry loop will need to be moved outside of the `queueWork` call.
+                // This introduces complexity regarding tracking of timing and start/end logging, however.
+                if (this._runPending) {
+                    if (abortSignal.aborted) {
+                        innerState.status = OperationStatus.Aborted;
+                        break;
+                    }
+                    else {
+                        context.terminal.writeLine(`Immediate rerun requested. Executing.`);
+                    }
+                }
+            }
+            state.stopwatch.stop();
+            context.afterExecute(this, state);
+            return state.status;
+        }, /* priority */ this.criticalPathLength ?? 0);
+        return state.status;
+    }
+}
+//# sourceMappingURL=Operation.js.map

package/lib-esm/Operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operation.js","sourceRoot":"","sources":["../src/Operation.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { InternalError } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\n\nimport { Stopwatch } from './Stopwatch';\nimport type {\n  IOperationRunner,\n  IOperationRunnerContext,\n  IOperationState,\n  IOperationStates\n} from './IOperationRunner';\nimport type { OperationError } from './OperationError';\nimport { OperationStatus } from './OperationStatus';\nimport type { OperationGroupRecord } from './OperationGroupRecord';\n\n/**\n * Options for constructing a new Operation.\n * @beta\n */\nexport interface IOperationOptions<TMetadata extends {} = {}, TGroupMetadata extends {} = {}> {\n  /**\n   * The name of this operation, for logging.\n   */\n  name: string;\n\n  /**\n   * The group that this operation belongs to. Will be used for logging and duration tracking.\n   */\n  group?: OperationGroupRecord<TGroupMetadata> | undefined;\n\n  /**\n   * When the scheduler is ready to process this `Operation`, the `runner` implements the actual work of\n   * running the operation.\n   */\n  runner?: IOperationRunner | undefined;\n\n  /**\n   * The weight used by the scheduler to determine order of execution.\n   */\n  weight?: number | undefined;\n\n  /**\n   * The metadata for this operation.\n   */\n  metadata?: TMetadata | undefined;\n}\n\n/**\n * Type for the `requestRun` callback.\n * @beta\n */\nexport type OperationRequestRunCallback = (requestor: string, detail?: string) => void;\n\n/**\n * Information provided to `executeAsync` by the `OperationExecutionManager`.\n *\n * @beta\n */\nexport interface IExecuteOperationContext extends Omit<IOperationRunnerContext, 'isFirstRun' | 'requestRun'> {\n  /**\n   * Function to invoke before execution of an operation, for logging.\n   */\n  beforeExecute(operation: Operation, state: IOperationState): void;\n\n  /**\n   * Function to invoke after execution of an operation, for logging.\n   */\n  afterExecute(operation: Operation, state: IOperationState): void;\n\n  /**\n   * Function used to schedule the concurrency-limited execution of an operation.\n   *\n   * Will return OperationStatus.Aborted if execution is aborted before the task executes.\n   */\n  queueWork(workFn: () => Promise<OperationStatus>, priority: number): Promise<OperationStatus>;\n\n  /**\n   * A callback to the overarching orchestrator to request that the operation be invoked again.\n   * Used in watch mode to signal that inputs have changed.\n   *\n   * @param requestor - The name of the operation requesting a rerun.\n   * @param detail - Optional detail about why the rerun is requested, e.g. the name of a changed file.\n   */\n  requestRun?: OperationRequestRunCallback;\n\n  /**\n   * Terminal to write output to.\n   */\n  terminal: ITerminal;\n}\n\n/**\n * The `Operation` class is a node in the dependency graph of work that needs to be scheduled by the\n * `OperationExecutionManager`. Each `Operation` has a `runner` member of type `IOperationRunner`, whose\n * implementation manages the actual process of running a single operation.\n *\n * The graph of `Operation` instances will be cloned into a separate execution graph after processing.\n *\n * @beta\n */\nexport class Operation<TMetadata extends {} = {}, TGroupMetadata extends {} = {}>\n  implements IOperationStates\n{\n  /**\n   * A set of all dependencies which must be executed before this operation is complete.\n   */\n  public readonly dependencies: Set<Operation<TMetadata, TGroupMetadata>> = new Set<\n    Operation<TMetadata, TGroupMetadata>\n  >();\n  /**\n   * A set of all operations that wait for this operation.\n   */\n  public readonly consumers: Set<Operation<TMetadata, TGroupMetadata>> = new Set<\n    Operation<TMetadata, TGroupMetadata>\n  >();\n  /**\n   * If specified, the name of a grouping to which this Operation belongs, for logging start and end times.\n   */\n  public readonly group: OperationGroupRecord<TGroupMetadata> | undefined;\n  /**\n   * The name of this operation, for logging.\n   */\n  public readonly name: string;\n\n  /**\n   * When the scheduler is ready to process this `Operation`, the `runner` implements the actual work of\n   * running the operation.\n   */\n  public runner: IOperationRunner | undefined = undefined;\n\n  /**\n   * This number represents how far away this Operation is from the furthest \"root\" operation (i.e.\n   * an operation with no consumers). This helps us to calculate the critical path (i.e. the\n   * longest chain of projects which must be executed in order, thereby limiting execution speed\n   * of the entire operation tree.\n   *\n   * This number is calculated via a memoized depth-first search, and when choosing the next\n   * operation to execute, the operation with the highest criticalPathLength is chosen.\n   *\n   * Example:\n   *        (0) A\n   *             \\\\\n   *          (1) B     C (0)         (applications)\n   *               \\\\   /|\\\\\n   *                \\\\ / | \\\\\n   *             (2) D  |  X (1)      (utilities)\n   *                    | / \\\\\n   *                    |/   \\\\\n   *                (2) Y     Z (2)   (other utilities)\n   *\n   * All roots (A & C) have a criticalPathLength of 0.\n   * B has a score of 1, since A depends on it.\n   * D has a score of 2, since we look at the longest chain (e.g D-\\>B-\\>A is longer than D-\\>C)\n   * X has a score of 1, since the only package which depends on it is A\n   * Z has a score of 2, since only X depends on it, and X has a score of 1\n   * Y has a score of 2, since the chain Y-\\>X-\\>C is longer than Y-\\>C\n   *\n   * The algorithm is implemented in AsyncOperationQueue.ts as calculateCriticalPathLength()\n   */\n  public criticalPathLength: number | undefined = undefined;\n\n  /**\n   * The weight for this operation. This scalar is the contribution of this operation to the\n   * `criticalPathLength` calculation above. Modify to indicate the following:\n   * - `weight` === 1: indicates that this operation has an average duration\n   * - `weight` &gt; 1: indicates that this operation takes longer than average and so the scheduler\n   *     should try to favor starting it over other, shorter operations. An example might be an operation that\n   *     bundles an entire application and runs whole-program optimization.\n   * - `weight` &lt; 1: indicates that this operation takes less time than average and so the scheduler\n   *     should favor other, longer operations over it. An example might be an operation to unpack a cached\n   *     output, or an operation using NullOperationRunner, which might use a value of 0.\n   */\n  public weight: number;\n\n  /**\n   * The state of this operation the previous time a manager was invoked.\n   */\n  public lastState: IOperationState | undefined = undefined;\n\n  /**\n   * The current state of this operation\n   */\n  public state: IOperationState | undefined = undefined;\n\n  /**\n   * A cached execution promise for the current OperationExecutionManager invocation of this operation.\n   */\n  private _promise: Promise<OperationStatus> | undefined = undefined;\n\n  /**\n   * If true, then a run of this operation is currently wanted.\n   * This is used to track state from the `requestRun` callback passed to the runner.\n   */\n  private _runPending: boolean = true;\n\n  public readonly metadata: TMetadata;\n\n  public constructor(options: IOperationOptions<TMetadata, TGroupMetadata>) {\n    this.group = options.group;\n    this.runner = options.runner;\n    this.weight = options.weight ?? 1;\n    this.name = options.name;\n    this.metadata = options.metadata || ({} as TMetadata);\n\n    if (this.group) {\n      this.group.addOperation(this);\n    }\n  }\n\n  public addDependency(dependency: Operation<TMetadata, TGroupMetadata>): void {\n    this.dependencies.add(dependency);\n    dependency.consumers.add(this);\n  }\n\n  public deleteDependency(dependency: Operation<TMetadata, TGroupMetadata>): void {\n    this.dependencies.delete(dependency);\n    dependency.consumers.delete(this);\n  }\n\n  public reset(): void {\n    // Reset operation state\n    this.lastState = this.state;\n\n    this.state = {\n      status: this.dependencies.size > 0 ? OperationStatus.Waiting : OperationStatus.Ready,\n      hasBeenRun: this.lastState?.hasBeenRun ?? false,\n      error: undefined,\n      stopwatch: new Stopwatch()\n    };\n\n    this._promise = undefined;\n    this._runPending = true;\n  }\n\n  /**\n   * @internal\n   */\n  public async _executeAsync(context: IExecuteOperationContext): Promise<OperationStatus> {\n    const { state } = this;\n    if (!state) {\n      throw new Error(`Operation state has not been initialized.`);\n    }\n\n    if (!this._promise) {\n      this._promise = this._executeInnerAsync(context, state);\n    }\n\n    return this._promise;\n  }\n\n  private async _executeInnerAsync(\n    context: IExecuteOperationContext,\n    rawState: IOperationState\n  ): Promise<OperationStatus> {\n    const state: IOperationState = rawState;\n    const { runner } = this;\n\n    const dependencyResults: PromiseSettledResult<OperationStatus>[] = await Promise.allSettled(\n      Array.from(this.dependencies, (dependency: Operation) => dependency._executeAsync(context))\n    );\n\n    const { abortSignal, requestRun, queueWork } = context;\n\n    if (abortSignal.aborted) {\n      state.status = OperationStatus.Aborted;\n      return state.status;\n    }\n\n    for (const result of dependencyResults) {\n      if (\n        result.status === 'rejected' ||\n        result.value === OperationStatus.Blocked ||\n        result.value === OperationStatus.Failure\n      ) {\n        state.status = OperationStatus.Blocked;\n        return state.status;\n      }\n    }\n\n    state.status = OperationStatus.Ready;\n\n    const innerContext: IOperationRunnerContext = {\n      abortSignal,\n      isFirstRun: !state.hasBeenRun,\n      requestRun: requestRun\n        ? (detail?: string) => {\n            switch (this.state?.status) {\n              case OperationStatus.Waiting:\n              case OperationStatus.Ready:\n              case OperationStatus.Executing:\n                // If current status has not yet resolved to a fixed value,\n                // re-executing this operation does not require a full rerun\n                // of the operation graph. Simply mark that a run is requested.\n\n                // This variable is on the Operation instead of the\n                // containing closure to deal with scenarios in which\n                // the runner hangs on to an old copy of the callback.\n                this._runPending = true;\n                return;\n\n              case OperationStatus.Blocked:\n              case OperationStatus.Aborted:\n              case OperationStatus.Failure:\n              case OperationStatus.NoOp:\n              case OperationStatus.Success:\n                // The requestRun callback is assumed to remain constant\n                // throughout the lifetime of the process, so it is safe\n                // to capture here.\n                return requestRun(this.name, detail);\n              default:\n                // This line is here to enforce exhaustiveness\n                const currentStatus: undefined = this.state?.status;\n                throw new InternalError(`Unexpected status: ${currentStatus}`);\n            }\n          }\n        : undefined\n    };\n\n    // eslint-disable-next-line require-atomic-updates\n    state.status = await queueWork(async (): Promise<OperationStatus> => {\n      // Redundant variable to satisfy require-atomic-updates\n      const innerState: IOperationState = state;\n\n      if (abortSignal.aborted) {\n        innerState.status = OperationStatus.Aborted;\n        return innerState.status;\n      }\n\n      context.beforeExecute(this, innerState);\n\n      innerState.stopwatch.start();\n      innerState.status = OperationStatus.Executing;\n      // Mark that the operation has been started at least once.\n      innerState.hasBeenRun = true;\n\n      while (this._runPending) {\n        this._runPending = false;\n        try {\n          // We don't support aborting in the middle of a runner's execution.\n          innerState.status = runner ? await runner.executeAsync(innerContext) : OperationStatus.NoOp;\n        } catch (error) {\n          innerState.status = OperationStatus.Failure;\n          innerState.error = error as OperationError;\n        }\n\n        // Since runner.executeAsync is async, a change could have occurred that requires re-execution\n        // This operation is still active, so can re-execute immediately, rather than forcing a whole\n        // new execution pass.\n\n        // As currently written, this does mean that if a job is scheduled with higher priority while\n        // this operation is still executing, it will still wait for this retry. This may not be desired\n        // and if it becomes a problem, the retry loop will need to be moved outside of the `queueWork` call.\n        // This introduces complexity regarding tracking of timing and start/end logging, however.\n\n        if (this._runPending) {\n          if (abortSignal.aborted) {\n            innerState.status = OperationStatus.Aborted;\n            break;\n          } else {\n            context.terminal.writeLine(`Immediate rerun requested. Executing.`);\n          }\n        }\n      }\n\n      state.stopwatch.stop();\n      context.afterExecute(this, state);\n\n      return state.status;\n    }, /* priority */ this.criticalPathLength ?? 0);\n\n    return state.status;\n  }\n}\n"]}

package/lib-esm/OperationError.js

@@ -0,0 +1,25 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * Encapsulates information about an error
+ *
+ * @beta
+ */
+export class OperationError extends Error {
+    constructor(type, message) {
+        super(message);
+        // Manually set the prototype, as we can no longer extend built-in classes like Error, Array, Map, etc.
+        // https://github.com/microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        //
+        // Note: the prototype must also be set on any classes which extend this one
+        Object.setPrototypeOf(this, OperationError.prototype);
+        this._type = type;
+    }
+    get message() {
+        return `[${this._type}] '${super.message}'`;
+    }
+    toString() {
+        return this.message;
+    }
+}
+//# sourceMappingURL=OperationError.js.map

package/lib-esm/OperationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationError.js","sourceRoot":"","sources":["../src/OperationError.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGvC,YAAmB,IAAY,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,uGAAuG;QACvG,+IAA+I;QAC/I,EAAE;QACF,4EAA4E;QAC5E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,IAAI,CAAC,KAAK,MAAM,KAAK,CAAC,OAAO,GAAG,CAAC;IAC9C,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * Encapsulates information about an error\n *\n * @beta\n */\nexport class OperationError extends Error {\n  protected _type: string;\n\n  public constructor(type: string, message: string) {\n    super(message);\n\n    // Manually set the prototype, as we can no longer extend built-in classes like Error, Array, Map, etc.\n    // https://github.com/microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#extending-built-ins-like-error-array-and-map-may-no-longer-work\n    //\n    // Note: the prototype must also be set on any classes which extend this one\n    Object.setPrototypeOf(this, OperationError.prototype);\n\n    this._type = type;\n  }\n\n  public get message(): string {\n    return `[${this._type}] '${super.message}'`;\n  }\n\n  public toString(): string {\n    return this.message;\n  }\n}\n"]}

package/lib-esm/OperationExecutionManager.js

@@ -0,0 +1,138 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { Async } from '@rushstack/node-core-library';
+import { OperationStatus } from './OperationStatus';
+import { calculateCriticalPathLengths } from './calculateCriticalPath';
+import { WorkQueue } from './WorkQueue';
+/**
+ * A class which manages the execution of a set of tasks with interdependencies.
+ * Initially, and at the end of each task execution, all unblocked tasks
+ * are added to a ready queue which is then executed. This is done continually until all
+ * tasks are complete, or prematurely fails if any of the tasks fail.
+ *
+ * @beta
+ */
+export class OperationExecutionManager {
+    constructor(operations) {
+        let trackedOperationCount = 0;
+        for (const operation of operations) {
+            if (!operation.runner?.silent) {
+                // Only count non-silent operations
+                trackedOperationCount++;
+            }
+        }
+        this._trackedOperationCount = trackedOperationCount;
+        this._operations = calculateCriticalPathLengths(operations);
+        this._groupRecords = new Set(Array.from(this._operations, (e) => e.group).filter((e) => e !== undefined));
+        for (const consumer of operations) {
+            for (const dependency of consumer.dependencies) {
+                if (!operations.has(dependency)) {
+                    throw new Error(`Operation ${JSON.stringify(consumer.name)} declares a dependency on operation ` +
+                        `${JSON.stringify(dependency.name)} that is not in the set of operations to execute.`);
+                }
+            }
+        }
+    }
+    /**
+     * Executes all operations which have been registered, returning a promise which is resolved when all the
+     * operations are completed successfully, or rejects when any operation fails.
+     */
+    async executeAsync(executionOptions) {
+        let hasReportedFailures = false;
+        const { abortSignal, parallelism, terminal, requestRun } = executionOptions;
+        if (abortSignal.aborted) {
+            return OperationStatus.Aborted;
+        }
+        const startedGroups = new Set();
+        const finishedGroups = new Set();
+        const maxParallelism = Math.min(this._operations.length, parallelism);
+        for (const groupRecord of this._groupRecords) {
+            groupRecord.reset();
+        }
+        for (const operation of this._operations) {
+            operation.reset();
+        }
+        terminal.writeVerboseLine(`Executing a maximum of ${maxParallelism} simultaneous tasks...`);
+        const workQueueAbortController = new AbortController();
+        const abortHandler = () => workQueueAbortController.abort();
+        abortSignal.addEventListener('abort', abortHandler, { once: true });
+        try {
+            const workQueue = new WorkQueue(workQueueAbortController.signal);
+            const executionContext = {
+                terminal,
+                abortSignal,
+                requestRun,
+                queueWork: (workFn, priority) => {
+                    return workQueue.pushAsync(workFn, priority);
+                },
+                beforeExecute: (operation) => {
+                    // Initialize group if uninitialized and log the group name
+                    const { group, runner } = operation;
+                    if (group) {
+                        if (!startedGroups.has(group)) {
+                            startedGroups.add(group);
+                            group.startTimer();
+                            terminal.writeLine(` ---- ${group.name} started ---- `);
+                            executionOptions.beforeExecuteOperationGroup?.(group);
+                        }
+                    }
+                    if (!runner?.silent) {
+                        executionOptions.beforeExecuteOperation?.(operation);
+                    }
+                },
+                afterExecute: (operation, state) => {
+                    const { group, runner } = operation;
+                    if (group) {
+                        group.setOperationAsComplete(operation, state);
+                    }
+                    if (state.status === OperationStatus.Failure) {
+                        // This operation failed. Mark it as such and all reachable dependents as blocked.
+                        // Failed operations get reported, even if silent.
+                        // Generally speaking, silent operations shouldn't be able to fail, so this is a safety measure.
+                        const message = state.error?.message;
+                        if (message) {
+                            terminal.writeErrorLine(message);
+                        }
+                        hasReportedFailures = true;
+                    }
+                    if (!runner?.silent) {
+                        executionOptions.afterExecuteOperation?.(operation);
+                    }
+                    if (group) {
+                        // Log out the group name and duration if it is the last operation in the group
+                        if (group?.finished && !finishedGroups.has(group)) {
+                            finishedGroups.add(group);
+                            const finishedLoggingWord = group.hasFailures
+                                ? 'encountered an error'
+                                : group.hasCancellations
+                                    ? 'cancelled'
+                                    : 'finished';
+                            terminal.writeLine(` ---- ${group.name} ${finishedLoggingWord} (${group.duration.toFixed(3)}s) ---- `);
+                            executionOptions.afterExecuteOperationGroup?.(group);
+                        }
+                    }
+                }
+            };
+            const workQueuePromise = Async.forEachAsync(workQueue, (workFn) => workFn(), {
+                concurrency: maxParallelism
+            });
+            await Promise.all(this._operations.map((record) => record._executeAsync(executionContext)));
+            // Terminate queue execution.
+            workQueueAbortController.abort();
+            await workQueuePromise;
+        }
+        finally {
+            // Cleanup resources
+            abortSignal.removeEventListener('abort', abortHandler);
+        }
+        const finalStatus = this._trackedOperationCount === 0
+            ? OperationStatus.NoOp
+            : abortSignal.aborted
+                ? OperationStatus.Aborted
+                : hasReportedFailures
+                    ? OperationStatus.Failure
+                    : OperationStatus.Success;
+        return finalStatus;
+    }
+}
+//# sourceMappingURL=OperationExecutionManager.js.map

package/lib-esm/OperationExecutionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationExecutionManager.js","sourceRoot":"","sources":["../src/OperationExecutionManager.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { Async } from '@rushstack/node-core-library';\nimport type { ITerminal } from '@rushstack/terminal';\n\nimport type { IOperationState } from './IOperationRunner';\nimport type { IExecuteOperationContext, Operation, OperationRequestRunCallback } from './Operation';\nimport type { OperationGroupRecord } from './OperationGroupRecord';\nimport { OperationStatus } from './OperationStatus';\nimport { calculateCriticalPathLengths } from './calculateCriticalPath';\nimport { WorkQueue } from './WorkQueue';\n\n/**\n * Options for the current run.\n *\n * @beta\n */\nexport interface IOperationExecutionOptions<\n  TOperationMetadata extends {} = {},\n  TGroupMetadata extends {} = {}\n> {\n  abortSignal: AbortSignal;\n  parallelism: number;\n  terminal: ITerminal;\n\n  requestRun?: OperationRequestRunCallback;\n\n  beforeExecuteOperation?: (operation: Operation<TOperationMetadata, TGroupMetadata>) => void;\n  afterExecuteOperation?: (operation: Operation<TOperationMetadata, TGroupMetadata>) => void;\n  beforeExecuteOperationGroup?: (operationGroup: OperationGroupRecord<TGroupMetadata>) => void;\n  afterExecuteOperationGroup?: (operationGroup: OperationGroupRecord<TGroupMetadata>) => void;\n}\n\n/**\n * A class which manages the execution of a set of tasks with interdependencies.\n * Initially, and at the end of each task execution, all unblocked tasks\n * are added to a ready queue which is then executed. This is done continually until all\n * tasks are complete, or prematurely fails if any of the tasks fail.\n *\n * @beta\n */\nexport class OperationExecutionManager<TOperationMetadata extends {} = {}, TGroupMetadata extends {} = {}> {\n  /**\n   * The set of operations that will be executed\n   */\n  private readonly _operations: Operation<TOperationMetadata, TGroupMetadata>[];\n  /**\n   * The total number of non-silent operations in the graph.\n   * Silent operations are generally used to simplify the construction of the graph.\n   */\n  private readonly _trackedOperationCount: number;\n\n  private readonly _groupRecords: Set<OperationGroupRecord<TGroupMetadata>>;\n\n  public constructor(operations: ReadonlySet<Operation<TOperationMetadata, TGroupMetadata>>) {\n    let trackedOperationCount: number = 0;\n    for (const operation of operations) {\n      if (!operation.runner?.silent) {\n        // Only count non-silent operations\n        trackedOperationCount++;\n      }\n    }\n\n    this._trackedOperationCount = trackedOperationCount;\n\n    this._operations = calculateCriticalPathLengths(operations);\n\n    this._groupRecords = new Set(Array.from(this._operations, (e) => e.group).filter((e) => e !== undefined));\n\n    for (const consumer of operations) {\n      for (const dependency of consumer.dependencies) {\n        if (!operations.has(dependency)) {\n          throw new Error(\n            `Operation ${JSON.stringify(consumer.name)} declares a dependency on operation ` +\n              `${JSON.stringify(dependency.name)} that is not in the set of operations to execute.`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Executes all operations which have been registered, returning a promise which is resolved when all the\n   * operations are completed successfully, or rejects when any operation fails.\n   */\n  public async executeAsync(\n    executionOptions: IOperationExecutionOptions<TOperationMetadata, TGroupMetadata>\n  ): Promise<OperationStatus> {\n    let hasReportedFailures: boolean = false;\n\n    const { abortSignal, parallelism, terminal, requestRun } = executionOptions;\n\n    if (abortSignal.aborted) {\n      return OperationStatus.Aborted;\n    }\n\n    const startedGroups: Set<OperationGroupRecord> = new Set();\n    const finishedGroups: Set<OperationGroupRecord> = new Set();\n\n    const maxParallelism: number = Math.min(this._operations.length, parallelism);\n\n    for (const groupRecord of this._groupRecords) {\n      groupRecord.reset();\n    }\n\n    for (const operation of this._operations) {\n      operation.reset();\n    }\n\n    terminal.writeVerboseLine(`Executing a maximum of ${maxParallelism} simultaneous tasks...`);\n\n    const workQueueAbortController: AbortController = new AbortController();\n    const abortHandler: () => void = () => workQueueAbortController.abort();\n    abortSignal.addEventListener('abort', abortHandler, { once: true });\n    try {\n      const workQueue: WorkQueue = new WorkQueue(workQueueAbortController.signal);\n\n      const executionContext: IExecuteOperationContext = {\n        terminal,\n        abortSignal,\n\n        requestRun,\n\n        queueWork: (workFn: () => Promise<OperationStatus>, priority: number): Promise<OperationStatus> => {\n          return workQueue.pushAsync(workFn, priority);\n        },\n\n        beforeExecute: (operation: Operation<TOperationMetadata, TGroupMetadata>): void => {\n          // Initialize group if uninitialized and log the group name\n          const { group, runner } = operation;\n          if (group) {\n            if (!startedGroups.has(group)) {\n              startedGroups.add(group);\n              group.startTimer();\n              terminal.writeLine(` ---- ${group.name} started ---- `);\n              executionOptions.beforeExecuteOperationGroup?.(group);\n            }\n          }\n          if (!runner?.silent) {\n            executionOptions.beforeExecuteOperation?.(operation);\n          }\n        },\n\n        afterExecute: (\n          operation: Operation<TOperationMetadata, TGroupMetadata>,\n          state: IOperationState\n        ): void => {\n          const { group, runner } = operation;\n          if (group) {\n            group.setOperationAsComplete(operation, state);\n          }\n\n          if (state.status === OperationStatus.Failure) {\n            // This operation failed. Mark it as such and all reachable dependents as blocked.\n            // Failed operations get reported, even if silent.\n            // Generally speaking, silent operations shouldn't be able to fail, so this is a safety measure.\n            const message: string | undefined = state.error?.message;\n            if (message) {\n              terminal.writeErrorLine(message);\n            }\n            hasReportedFailures = true;\n          }\n\n          if (!runner?.silent) {\n            executionOptions.afterExecuteOperation?.(operation);\n          }\n\n          if (group) {\n            // Log out the group name and duration if it is the last operation in the group\n            if (group?.finished && !finishedGroups.has(group)) {\n              finishedGroups.add(group);\n              const finishedLoggingWord: string = group.hasFailures\n                ? 'encountered an error'\n                : group.hasCancellations\n                  ? 'cancelled'\n                  : 'finished';\n              terminal.writeLine(\n                ` ---- ${group.name} ${finishedLoggingWord} (${group.duration.toFixed(3)}s) ---- `\n              );\n              executionOptions.afterExecuteOperationGroup?.(group);\n            }\n          }\n        }\n      };\n\n      const workQueuePromise: Promise<void> = Async.forEachAsync(\n        workQueue,\n        (workFn: () => Promise<void>) => workFn(),\n        {\n          concurrency: maxParallelism\n        }\n      );\n\n      await Promise.all(this._operations.map((record: Operation) => record._executeAsync(executionContext)));\n\n      // Terminate queue execution.\n      workQueueAbortController.abort();\n      await workQueuePromise;\n    } finally {\n      // Cleanup resources\n      abortSignal.removeEventListener('abort', abortHandler);\n    }\n\n    const finalStatus: OperationStatus =\n      this._trackedOperationCount === 0\n        ? OperationStatus.NoOp\n        : abortSignal.aborted\n          ? OperationStatus.Aborted\n          : hasReportedFailures\n            ? OperationStatus.Failure\n            : OperationStatus.Success;\n\n    return finalStatus;\n  }\n}\n"]}

package/lib-esm/OperationGroupRecord.js

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { InternalError } from '@rushstack/node-core-library';
+import { OperationStatus } from './OperationStatus';
+import { Stopwatch } from './Stopwatch';
+/**
+ * Meta-entity that tracks information about a group of related operations.
+ *
+ * @beta
+ */
+export class OperationGroupRecord {
+    get duration() {
+        return this._groupStopwatch ? this._groupStopwatch.duration : 0;
+    }
+    get finished() {
+        return this._remainingOperations.size === 0;
+    }
+    get hasCancellations() {
+        return this._hasCancellations;
+    }
+    get hasFailures() {
+        return this._hasFailures;
+    }
+    constructor(name, metadata = {}) {
+        this._operations = new Set();
+        this._remainingOperations = new Set();
+        this._groupStopwatch = new Stopwatch();
+        this._hasCancellations = false;
+        this._hasFailures = false;
+        this.name = name;
+        this.metadata = metadata;
+    }
+    addOperation(operation) {
+        this._operations.add(operation);
+    }
+    startTimer() {
+        // Keep this undefined until needed, then start to avoid subsequent calls to startTimer()
+        this._groupStopwatch.start();
+    }
+    setOperationAsComplete(operation, state) {
+        if (!this._remainingOperations.has(operation)) {
+            throw new InternalError(`Operation ${operation.name} is not in the group ${this.name}`);
+        }
+        if (state.status === OperationStatus.Aborted) {
+            this._hasCancellations = true;
+        }
+        else if (state.status === OperationStatus.Failure) {
+            this._hasFailures = true;
+        }
+        this._remainingOperations.delete(operation);
+        if (this._remainingOperations.size === 0) {
+            this._groupStopwatch.stop();
+        }
+    }
+    reset() {
+        this._remainingOperations = new Set(this._operations);
+        this._groupStopwatch.reset();
+        this._hasCancellations = false;
+        this._hasFailures = false;
+    }
+}
+//# sourceMappingURL=OperationGroupRecord.js.map

package/lib-esm/OperationGroupRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationGroupRecord.js","sourceRoot":"","sources":["../src/OperationGroupRecord.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAI7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAW/B,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,YAAmB,IAAY,EAAE,WAAsB,EAAe;QA1BrD,gBAAW,GAAmB,IAAI,GAAG,EAAE,CAAC;QACjD,yBAAoB,GAAmB,IAAI,GAAG,EAAE,CAAC;QAEjD,oBAAe,GAAc,IAAI,SAAS,EAAE,CAAC;QAC7C,sBAAiB,GAAY,KAAK,CAAC;QACnC,iBAAY,GAAY,KAAK,CAAC;QAsBpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,YAAY,CAAC,SAAoB;QACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAEM,UAAU;QACf,yFAAyF;QACzF,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEM,sBAAsB,CAAC,SAAoB,EAAE,KAAsB;QACxE,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,aAAa,CAAC,aAAa,SAAS,CAAC,IAAI,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,CAAC,OAAO,EAAE,CAAC;YAC7C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,CAAC,OAAO,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,oBAAoB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { InternalError } from '@rushstack/node-core-library';\n\nimport type { IOperationState } from './IOperationRunner';\nimport type { Operation } from './Operation';\nimport { OperationStatus } from './OperationStatus';\nimport { Stopwatch } from './Stopwatch';\n\n/**\n * Meta-entity that tracks information about a group of related operations.\n *\n * @beta\n */\nexport class OperationGroupRecord<TMetadata extends {} = {}> {\n  private readonly _operations: Set<Operation> = new Set();\n  private _remainingOperations: Set<Operation> = new Set();\n\n  private _groupStopwatch: Stopwatch = new Stopwatch();\n  private _hasCancellations: boolean = false;\n  private _hasFailures: boolean = false;\n\n  public readonly name: string;\n  public readonly metadata: TMetadata;\n\n  public get duration(): number {\n    return this._groupStopwatch ? this._groupStopwatch.duration : 0;\n  }\n\n  public get finished(): boolean {\n    return this._remainingOperations.size === 0;\n  }\n\n  public get hasCancellations(): boolean {\n    return this._hasCancellations;\n  }\n\n  public get hasFailures(): boolean {\n    return this._hasFailures;\n  }\n\n  public constructor(name: string, metadata: TMetadata = {} as TMetadata) {\n    this.name = name;\n    this.metadata = metadata;\n  }\n\n  public addOperation(operation: Operation): void {\n    this._operations.add(operation);\n  }\n\n  public startTimer(): void {\n    // Keep this undefined until needed, then start to avoid subsequent calls to startTimer()\n    this._groupStopwatch.start();\n  }\n\n  public setOperationAsComplete(operation: Operation, state: IOperationState): void {\n    if (!this._remainingOperations.has(operation)) {\n      throw new InternalError(`Operation ${operation.name} is not in the group ${this.name}`);\n    }\n\n    if (state.status === OperationStatus.Aborted) {\n      this._hasCancellations = true;\n    } else if (state.status === OperationStatus.Failure) {\n      this._hasFailures = true;\n    }\n\n    this._remainingOperations.delete(operation);\n    if (this._remainingOperations.size === 0) {\n      this._groupStopwatch.stop();\n    }\n  }\n\n  public reset(): void {\n    this._remainingOperations = new Set(this._operations);\n    this._groupStopwatch.reset();\n    this._hasCancellations = false;\n    this._hasFailures = false;\n  }\n}\n"]}