@rushstack/rush-sdk 5.157.0 → 5.158.1-pr5355.0

package/dist/rush-lib.d.ts

@@ -1428,6 +1428,10 @@ export declare interface IExecuteOperationsContext extends ICreateOperationsCont
      * Not part of the creation context to avoid the overhead of Git calls when initializing the graph.
      */
     readonly inputsSnapshot?: IInputsSnapshot;
+    /**
+     * An abort controller that can be used to abort the current set of queued operations.
+     */
+    readonly abortController: AbortController;
 }
 
 /**
@@ -1612,7 +1616,12 @@ export declare interface IGetChangedProjectsOptions {
 export declare interface IGlobalCommand extends IRushCommand {
 }
 
-declare interface IIndividualVersionJson extends IVersionPolicyJson {
+/**
+ * This interface represents the raw individual version policy JSON object which extends the base version policy
+ * with additional fields specific to individual versioning.
+ * @public
+ */
+export declare interface IIndividualVersionJson extends IVersionPolicyJson {
     lockedMajor?: number;
 }
 
@@ -1697,7 +1706,12 @@ declare interface ILocalBuildCacheJson extends IBaseBuildCacheJson {
     readonly cacheProvider: 'local-only';
 }
 
-declare interface ILockStepVersionJson extends IVersionPolicyJson {
+/**
+ * This interface represents the raw lock-step version policy JSON object which extends the base version policy
+ * with additional fields specific to lock-step versioning.
+ * @public
+ */
+export declare interface ILockStepVersionJson extends IVersionPolicyJson {
     version: string;
     nextBump?: string;
     mainProject?: string;
@@ -1756,19 +1770,17 @@ export declare interface ILogger {
  */
 export declare class IndividualVersionPolicy extends VersionPolicy {
     /**
-     * The major version that has been locked
+     * @internal
      */
-    readonly lockedMajor: number | undefined;
+    readonly _json: IIndividualVersionJson;
     /**
-     * @internal
+     * The major version that has been locked
      */
-    constructor(versionPolicyJson: IIndividualVersionJson);
+    get lockedMajor(): number | undefined;
     /**
-     * Serialized json for this policy
-     *
      * @internal
      */
-    get _json(): IIndividualVersionJson;
+    constructor(versionPolicyJson: IIndividualVersionJson);
     /**
      * Returns an updated package json that satisfies the version policy.
      *
@@ -2181,6 +2193,12 @@ export declare interface IPhasedCommand extends IRushCommand {
      * @alpha
      */
     readonly hooks: PhasedCommandHooks;
+    /**
+     * An abort controller that can be used to abort the command.
+     * Long-lived plugins should listen to the signal to handle any cleanup logic.
+     * @alpha
+     */
+    readonly sessionAbortController: AbortController;
 }
 
 /**
@@ -2765,12 +2783,24 @@ export declare interface ITryFindRushJsonLocationOptions {
     startingFolder?: string;
 }
 
+/**
+ * This interface represents the `dependencies` field in a version policy JSON object,
+ * allowing repo maintainers to specify how dependencies' versions should be handled
+ * during publishing and committing.
+ * @public
+ */
 declare interface IVersionPolicyDependencyJson {
     versionFormatForPublish?: VersionFormatForPublish;
     versionFormatForCommit?: VersionFormatForCommit;
 }
 
-declare interface IVersionPolicyJson {
+/**
+ * This interface represents the raw version policy JSON object which allows repo
+ * maintainers to define how different groups of projects will be published by Rush,
+ * and how their version numbers will be determined.
+ * @public
+ */
+export declare interface IVersionPolicyJson {
     policyName: string;
     definitionName: string;
     dependencies?: IVersionPolicyDependencyJson;
@@ -2798,18 +2828,22 @@ export declare interface _IYarnOptionsJson extends IPackageManagerOptionsJsonBas
  * @public
  */
 export declare class LockStepVersionPolicy extends VersionPolicy {
+    /**
+     * @internal
+     */
+    readonly _json: ILockStepVersionJson;
     private _version;
     /**
      * The type of bump for next bump.
      */
-    readonly nextBump: BumpType | undefined;
+    get nextBump(): BumpType | undefined;
     /**
      * The main project for the version policy.
      *
      * If the value is provided, change logs will only be generated in that project.
      * If the value is not provided, change logs will be hosted in each project associated with the policy.
      */
-    readonly mainProject: string | undefined;
+    get mainProject(): string | undefined;
     /**
      * @internal
      */
@@ -2818,12 +2852,6 @@ export declare class LockStepVersionPolicy extends VersionPolicy {
      * The value of the lockstep version
      */
     get version(): string;
-    /**
-     * Serialized json for this policy
-     *
-     * @internal
-     */
-    get _json(): ILockStepVersionJson;
     /**
      * Returns an updated package json that satisfies the version policy.
      *
@@ -3085,7 +3113,11 @@ export declare enum OperationStatus {
     /**
      * The Operation was a no-op (for example, it had an empty script)
      */
-    NoOp = "NO OP"
+    NoOp = "NO OP",
+    /**
+     * The Operation was aborted before it could execute.
+     */
+    Aborted = "ABORTED"
 }
 
 /**
@@ -4926,7 +4958,10 @@ export declare class Subspace {
      * Returns the full path of the folder containing this subspace's variant-dependent configuration files
      * such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace` or `common/config/subspaces/my-subspace/variants/my-variant`
+     * Example (variants):               `C:\MyRepo\common\config\rush\variants\my-variant`
+     * Example (variants and subspaces): `C:\MyRepo\common\config\subspaces\my-subspace\variants\my-variant`
+     * Example (subspaces):              `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (neither):                `C:\MyRepo\common\config\rush`
      * @beta
      *
      * @remarks
@@ -4939,22 +4974,24 @@ export declare class Subspace {
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush`
      * @beta
      */
     getSubspaceConfigFolderPath(): string;
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace/pnpm-patches` (subspaces feature enabled)
-     * Example: `common/config/pnpm-patches` (subspaces feature disabled)
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-patches`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\pnpm-patches`
      * @beta
      */
     getSubspacePnpmPatchesFolderPath(): string;
     /**
-     * The folder where the subspace's node_modules and other temporary files will be stored.
+     * The full path of the folder where the subspace's node_modules and other temporary files will be stored.
      *
-     * Example: `common/temp/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\temp\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\temp`
      * @beta
      */
     getSubspaceTempFolderPath(): string;
@@ -4986,16 +5023,18 @@ export declare class Subspace {
      */
     getTempShrinkwrapPreinstallFilePath(): string;
     /**
-     * Gets the path to the common-versions.json config file for this subspace.
+     * Gets the full path to the common-versions.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\common-versions.json`
      * @beta
      */
     getCommonVersionsFilePath(variant?: string): string;
     /**
-     * Gets the path to the pnpm-config.json config file for this subspace.
+     * Gets the full path to the pnpm-config.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\pnpm-config.json`
      * @beta
      */
     getPnpmConfigFilePath(): string;
@@ -5096,39 +5135,45 @@ export declare class SubspacesConfiguration {
     static tryLoadFromDefaultLocation(rushConfiguration: RushConfiguration): SubspacesConfiguration | undefined;
 }
 
-declare enum VersionFormatForCommit {
-    wildcard = "wildcard",
-    original = "original"
-}
+/**
+ * @public
+ */
+declare type VersionFormatForCommit = 'wildcard' | 'original';
 
-declare enum VersionFormatForPublish {
-    original = "original",
-    exact = "exact"
-}
+/**
+ * @public
+ */
+declare type VersionFormatForPublish = 'original' | 'exact';
 
 /**
  * This is the base class for version policy which controls how versions get bumped.
  * @public
  */
 export declare abstract class VersionPolicy {
-    private _versionFormatForCommit;
-    private _versionFormatForPublish;
+    /**
+     * Serialized json for the policy
+     *
+     * @internal
+     */
+    readonly _json: IVersionPolicyJson;
+    private get _versionFormatForCommit();
+    private get _versionFormatForPublish();
     /**
      * Version policy name
      */
-    readonly policyName: string;
+    get policyName(): string;
     /**
      * Version policy definition name
      */
-    readonly definitionName: VersionPolicyDefinitionName;
+    get definitionName(): VersionPolicyDefinitionName;
     /**
      * Determines if a version policy wants to opt out of changelog files.
      */
-    readonly exemptFromRushChange: boolean;
+    get exemptFromRushChange(): boolean;
     /**
      * Determines if a version policy wants to opt in to including email.
      */
-    readonly includeEmailInChangeFile: boolean;
+    get includeEmailInChangeFile(): boolean;
     /**
      * @internal
      */
@@ -5159,12 +5204,6 @@ export declare abstract class VersionPolicy {
      * @param identifier - (optional) override prerelease Id
      */
     abstract bump(bumpType?: BumpType, identifier?: string): void;
-    /**
-     * Serialized json for the policy
-     *
-     * @internal
-     */
-    abstract get _json(): IVersionPolicyJson;
     /**
      * Validates the specified version and throws if the version does not satisfy the policy.
      *

package/dist/tsdoc-metadata.json

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

package/lib/api/CommandLineJson.d.ts

@@ -19,6 +19,7 @@ export interface IBaseCommandJson {
 export interface IBulkCommandJson extends IBaseCommandJson {
     commandKind: 'bulk';
     enableParallelism: boolean;
+    allowOversubscription?: boolean;
     ignoreDependencyOrder?: boolean;
     ignoreMissingScript?: boolean;
     incremental?: boolean;
@@ -33,6 +34,7 @@ export interface IBulkCommandJson extends IBaseCommandJson {
 export interface IPhasedCommandWithoutPhasesJson extends IBaseCommandJson {
     commandKind: 'phased';
     enableParallelism: boolean;
+    allowOversubscription?: boolean;
     incremental?: boolean;
 }
 /**

package/lib/api/Subspace.d.ts

@@ -41,7 +41,10 @@ export declare class Subspace {
      * Returns the full path of the folder containing this subspace's variant-dependent configuration files
      * such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace` or `common/config/subspaces/my-subspace/variants/my-variant`
+     * Example (variants):               `C:\MyRepo\common\config\rush\variants\my-variant`
+     * Example (variants and subspaces): `C:\MyRepo\common\config\subspaces\my-subspace\variants\my-variant`
+     * Example (subspaces):              `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (neither):                `C:\MyRepo\common\config\rush`
      * @beta
      *
      * @remarks
@@ -54,22 +57,24 @@ export declare class Subspace {
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush`
      * @beta
      */
     getSubspaceConfigFolderPath(): string;
     /**
      * Returns the full path of the folder containing this subspace's configuration files such as `pnpm-lock.yaml`.
      *
-     * Example: `common/config/subspaces/my-subspace/pnpm-patches` (subspaces feature enabled)
-     * Example: `common/config/pnpm-patches` (subspaces feature disabled)
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-patches`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\pnpm-patches`
      * @beta
      */
     getSubspacePnpmPatchesFolderPath(): string;
     /**
-     * The folder where the subspace's node_modules and other temporary files will be stored.
+     * The full path of the folder where the subspace's node_modules and other temporary files will be stored.
      *
-     * Example: `common/temp/subspaces/my-subspace`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\temp\subspaces\my-subspace`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\temp`
      * @beta
      */
     getSubspaceTempFolderPath(): string;
@@ -101,16 +106,18 @@ export declare class Subspace {
      */
     getTempShrinkwrapPreinstallFilePath(): string;
     /**
-     * Gets the path to the common-versions.json config file for this subspace.
+     * Gets the full path to the common-versions.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\common-versions.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\common-versions.json`
      * @beta
      */
     getCommonVersionsFilePath(variant?: string): string;
     /**
-     * Gets the path to the pnpm-config.json config file for this subspace.
+     * Gets the full path to the pnpm-config.json config file for this subspace.
      *
-     * Example: `C:\MyRepo\common\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature enabled):   `C:\MyRepo\common\config\subspaces\my-subspace\pnpm-config.json`
+     * Example (subspaces feature disabled):  `C:\MyRepo\common\config\rush\pnpm-config.json`
      * @beta
      */
     getPnpmConfigFilePath(): string;

package/lib/api/VersionPolicy.d.ts

@@ -1,5 +1,5 @@
 import { type IPackageJson } from '@rushstack/node-core-library';
-import { type IVersionPolicyJson, type ILockStepVersionJson, type IIndividualVersionJson } from './VersionPolicyConfiguration';
+import type { IVersionPolicyJson, ILockStepVersionJson, IIndividualVersionJson } from './VersionPolicyConfiguration';
 import type { RushConfiguration } from './RushConfiguration';
 /**
  * Type of version bumps
@@ -33,24 +33,30 @@ export declare enum VersionPolicyDefinitionName {
  * @public
  */
 export declare abstract class VersionPolicy {
-    private _versionFormatForCommit;
-    private _versionFormatForPublish;
+    /**
+     * Serialized json for the policy
+     *
+     * @internal
+     */
+    readonly _json: IVersionPolicyJson;
+    private get _versionFormatForCommit();
+    private get _versionFormatForPublish();
     /**
      * Version policy name
      */
-    readonly policyName: string;
+    get policyName(): string;
     /**
      * Version policy definition name
      */
-    readonly definitionName: VersionPolicyDefinitionName;
+    get definitionName(): VersionPolicyDefinitionName;
     /**
      * Determines if a version policy wants to opt out of changelog files.
      */
-    readonly exemptFromRushChange: boolean;
+    get exemptFromRushChange(): boolean;
     /**
      * Determines if a version policy wants to opt in to including email.
      */
-    readonly includeEmailInChangeFile: boolean;
+    get includeEmailInChangeFile(): boolean;
     /**
      * @internal
      */
@@ -81,12 +87,6 @@ export declare abstract class VersionPolicy {
      * @param identifier - (optional) override prerelease Id
      */
     abstract bump(bumpType?: BumpType, identifier?: string): void;
-    /**
-     * Serialized json for the policy
-     *
-     * @internal
-     */
-    abstract get _json(): IVersionPolicyJson;
     /**
      * Validates the specified version and throws if the version does not satisfy the policy.
      *
@@ -110,18 +110,22 @@ export declare abstract class VersionPolicy {
  * @public
  */
 export declare class LockStepVersionPolicy extends VersionPolicy {
+    /**
+     * @internal
+     */
+    readonly _json: ILockStepVersionJson;
     private _version;
     /**
      * The type of bump for next bump.
      */
-    readonly nextBump: BumpType | undefined;
+    get nextBump(): BumpType | undefined;
     /**
      * The main project for the version policy.
      *
      * If the value is provided, change logs will only be generated in that project.
      * If the value is not provided, change logs will be hosted in each project associated with the policy.
      */
-    readonly mainProject: string | undefined;
+    get mainProject(): string | undefined;
     /**
      * @internal
      */
@@ -130,12 +134,6 @@ export declare class LockStepVersionPolicy extends VersionPolicy {
      * The value of the lockstep version
      */
     get version(): string;
-    /**
-     * Serialized json for this policy
-     *
-     * @internal
-     */
-    get _json(): ILockStepVersionJson;
     /**
      * Returns an updated package json that satisfies the version policy.
      *
@@ -171,19 +169,17 @@ export declare class LockStepVersionPolicy extends VersionPolicy {
  */
 export declare class IndividualVersionPolicy extends VersionPolicy {
     /**
-     * The major version that has been locked
+     * @internal
      */
-    readonly lockedMajor: number | undefined;
+    readonly _json: IIndividualVersionJson;
     /**
-     * @internal
+     * The major version that has been locked
      */
-    constructor(versionPolicyJson: IIndividualVersionJson);
+    get lockedMajor(): number | undefined;
     /**
-     * Serialized json for this policy
-     *
      * @internal
      */
-    get _json(): IIndividualVersionJson;
+    constructor(versionPolicyJson: IIndividualVersionJson);
     /**
      * Returns an updated package json that satisfies the version policy.
      *

package/lib/api/VersionPolicyConfiguration.d.ts

@@ -1,5 +1,11 @@
 import { VersionPolicy, type BumpType } from './VersionPolicy';
 import type { RushConfigurationProject } from './RushConfigurationProject';
+/**
+ * This interface represents the raw version policy JSON object which allows repo
+ * maintainers to define how different groups of projects will be published by Rush,
+ * and how their version numbers will be determined.
+ * @public
+ */
 export interface IVersionPolicyJson {
     policyName: string;
     definitionName: string;
@@ -7,22 +13,38 @@ export interface IVersionPolicyJson {
     exemptFromRushChange?: boolean;
     includeEmailInChangeFile?: boolean;
 }
+/**
+ * This interface represents the raw lock-step version policy JSON object which extends the base version policy
+ * with additional fields specific to lock-step versioning.
+ * @public
+ */
 export interface ILockStepVersionJson extends IVersionPolicyJson {
     version: string;
     nextBump?: string;
     mainProject?: string;
 }
+/**
+ * This interface represents the raw individual version policy JSON object which extends the base version policy
+ * with additional fields specific to individual versioning.
+ * @public
+ */
 export interface IIndividualVersionJson extends IVersionPolicyJson {
     lockedMajor?: number;
 }
-export declare enum VersionFormatForPublish {
-    original = "original",
-    exact = "exact"
-}
-export declare enum VersionFormatForCommit {
-    wildcard = "wildcard",
-    original = "original"
-}
+/**
+ * @public
+ */
+export type VersionFormatForPublish = 'original' | 'exact';
+/**
+ * @public
+ */
+export type VersionFormatForCommit = 'wildcard' | 'original';
+/**
+ * This interface represents the `dependencies` field in a version policy JSON object,
+ * allowing repo maintainers to specify how dependencies' versions should be handled
+ * during publishing and committing.
+ * @public
+ */
 export interface IVersionPolicyDependencyJson {
     versionFormatForPublish?: VersionFormatForPublish;
     versionFormatForCommit?: VersionFormatForCommit;

package/lib/cli/scriptActions/PhasedScriptAction.d.ts

@@ -1,3 +1,4 @@
+import type { IPhasedCommand } from '../../pluginFramework/RushLifeCycle';
 import { PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
 import { BaseScriptAction, type IBaseScriptActionOptions } from './BaseScriptAction';
 import type { IPhase, IPhasedCommandConfig } from '../../api/CommandLineConfiguration';
@@ -6,6 +7,7 @@ import type { IPhase, IPhasedCommandConfig } from '../../api/CommandLineConfigur
  */
 export interface IPhasedScriptActionOptions extends IBaseScriptActionOptions<IPhasedCommandConfig> {
     enableParallelism: boolean;
+    allowOversubscription: boolean;
     incremental: boolean;
     disableBuildCache: boolean;
     originalPhases: Set<IPhase>;
@@ -25,13 +27,15 @@ export interface IPhasedScriptActionOptions extends IBaseScriptActionOptions<IPh
  * and "rebuild" commands are also modeled as phased commands with a single phase that invokes the npm
  * "build" script for each project.
  */
-export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandConfig> {
+export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandConfig> implements IPhasedCommand {
     /**
      * @internal
      */
     _runsBeforeInstall: boolean | undefined;
     readonly hooks: PhasedCommandHooks;
+    readonly sessionAbortController: AbortController;
     private readonly _enableParallelism;
+    private readonly _allowOversubscription;
     private readonly _isIncrementalBuildAllowed;
     private readonly _disableBuildCache;
     private readonly _originalPhases;
@@ -43,6 +47,7 @@ export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandC
     private readonly _knownPhases;
     private readonly _terminal;
     private _changedProjectsOnly;
+    private _executionAbortController;
     private readonly _changedProjectsOnlyParameter;
     private readonly _selectionParameters;
     private readonly _verboseParameter;

package/lib/index.d.ts

@@ -32,7 +32,7 @@ export { EventHooks, Event } from './api/EventHooks';
 export { ChangeManager } from './api/ChangeManager';
 export { FlagFile as _FlagFile } from './api/FlagFile';
 export { VersionPolicyDefinitionName, BumpType, LockStepVersionPolicy, IndividualVersionPolicy, VersionPolicy } from './api/VersionPolicy';
-export { VersionPolicyConfiguration } from './api/VersionPolicyConfiguration';
+export { VersionPolicyConfiguration, type ILockStepVersionJson, type IIndividualVersionJson, type IVersionPolicyJson } from './api/VersionPolicyConfiguration';
 export { type ILaunchOptions, Rush } from './api/Rush';
 export { RushInternals as _RushInternals } from './api/RushInternals';
 export { ExperimentsConfiguration, type IExperimentsJson } from './api/ExperimentsConfiguration';

package/lib/logic/DependencySpecifier.d.ts

@@ -65,6 +65,17 @@ export declare class DependencySpecifier {
      */
     readonly aliasTarget: DependencySpecifier | undefined;
     constructor(packageName: string, versionSpecifier: string);
+    /**
+     * Clears the dependency specifier parse cache.
+     */
+    static clearCache(): void;
+    /**
+     * Parses a dependency specifier with caching.
+     * @param packageName - The name of the package the version specifier corresponds to
+     * @param versionSpecifier - The version specifier to parse
+     * @returns The parsed dependency specifier
+     */
+    static parseWithCache(packageName: string, versionSpecifier: string): DependencySpecifier;
     static getDependencySpecifierType(specifierType: string): DependencySpecifierType;
 }
 //# sourceMappingURL=DependencySpecifier.d.ts.map

package/lib/logic/operations/IPCOperationRunner.d.ts

@@ -1,3 +1,4 @@
+import type { OperationRequestRunCallback } from '@rushstack/operation-graph';
 import type { IPhase } from '../../api/CommandLineConfiguration';
 import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IOperationRunner, IOperationRunnerContext } from './IOperationRunner';
@@ -9,7 +10,7 @@ export interface IIPCOperationRunnerOptions {
     commandToRun: string;
     commandForHash: string;
     persist: boolean;
-    requestRun: (requestor?: string) => void;
+    requestRun: OperationRequestRunCallback;
 }
 /**
  * Runner that hosts a long-lived process to which it communicates via IPC.

package/lib/logic/operations/OperationExecutionManager.d.ts

@@ -9,6 +9,7 @@ export interface IOperationExecutionManagerOptions {
     quietMode: boolean;
     debugMode: boolean;
     parallelism: number;
+    allowOversubscription: boolean;
     inputsSnapshot?: IInputsSnapshot;
     destination?: TerminalWritable;
     beforeExecuteOperationAsync?: (operation: OperationExecutionRecord) => Promise<OperationStatus | undefined>;
@@ -27,6 +28,7 @@ export declare class OperationExecutionManager {
     private readonly _executionRecords;
     private readonly _quietMode;
     private readonly _parallelism;
+    private readonly _allowOversubscription;
     private readonly _totalOperations;
     private readonly _outputWritable;
     private readonly _colorsNewlinesTransform;
@@ -39,6 +41,7 @@ export declare class OperationExecutionManager {
     private readonly _createEnvironmentForOperation?;
     private _hasAnyFailures;
     private _hasAnyNonAllowedWarnings;
+    private _hasAnyAborted;
     private _completedOperations;
     private _executionQueue;
     constructor(operations: Set<Operation>, options: IOperationExecutionManagerOptions);
@@ -47,7 +50,7 @@ export declare class OperationExecutionManager {
      * 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.
      */
-    executeAsync(): Promise<IExecutionResult>;
+    executeAsync(abortController: AbortController): Promise<IExecutionResult>;
     private _reportOperationErrorIfAny;
     /**
      * Handles the result of the operation and propagates any relevant effects.

package/lib/logic/operations/OperationStatus.d.ts

@@ -46,7 +46,11 @@ export declare enum OperationStatus {
     /**
      * The Operation was a no-op (for example, it had an empty script)
      */
-    NoOp = "NO OP"
+    NoOp = "NO OP",
+    /**
+     * The Operation was aborted before it could execute.
+     */
+    Aborted = "ABORTED"
 }
 /**
  * The set of statuses that are considered terminal.

package/lib/logic/pnpm/PnpmShrinkwrapFile.d.ts

@@ -89,7 +89,6 @@ export declare function parsePnpm9DependencyKey(dependencyName: string, versionS
 export declare function parsePnpmDependencyKey(dependencyName: string, versionSpecifier: IPnpmVersionSpecifier): DependencySpecifier | undefined;
 export declare function normalizePnpmVersionSpecifier(versionSpecifier: IPnpmVersionSpecifier): string;
 export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
-    private static _cacheByLockfilePath;
     readonly shrinkwrapFileMajorVersion: number;
     readonly isWorkspaceCompatible: boolean;
     readonly registry: string;
@@ -99,12 +98,17 @@ export declare class PnpmShrinkwrapFile extends BaseShrinkwrapFile {
     readonly packages: ReadonlyMap<string, IPnpmShrinkwrapDependencyYaml>;
     readonly overrides: ReadonlyMap<string, string>;
     readonly packageExtensionsChecksum: undefined | string;
+    readonly hash: string;
     private readonly _shrinkwrapJson;
     private readonly _integrities;
     private _pnpmfileConfiguration;
     private constructor();
     static getLockfileV9PackageId(name: string, version: string): string;
-    static loadFromFile(shrinkwrapYamlFilePath: string, { withCaching }?: ILoadFromFileOptions): PnpmShrinkwrapFile | undefined;
+    /**
+     * Clears the cache of PnpmShrinkwrapFile instances to free up memory.
+     */
+    static clearCache(): void;
+    static loadFromFile(shrinkwrapYamlFilePath: string, options?: ILoadFromFileOptions): PnpmShrinkwrapFile | undefined;
     static loadFromString(shrinkwrapContent: string): PnpmShrinkwrapFile;
     getShrinkwrapHash(experimentsConfig?: IExperimentsJson): string;
     /**

package/lib/pluginFramework/PhasedCommandHooks.d.ts

@@ -114,6 +114,10 @@ export interface IExecuteOperationsContext extends ICreateOperationsContext {
      * Not part of the creation context to avoid the overhead of Git calls when initializing the graph.
      */
     readonly inputsSnapshot?: IInputsSnapshot;
+    /**
+     * An abort controller that can be used to abort the current set of queued operations.
+     */
+    readonly abortController: AbortController;
 }
 /**
  * Hooks into the execution process for phased commands

package/lib/pluginFramework/RushLifeCycle.d.ts

@@ -28,6 +28,12 @@ export interface IPhasedCommand extends IRushCommand {
      * @alpha
      */
     readonly hooks: PhasedCommandHooks;
+    /**
+     * An abort controller that can be used to abort the command.
+     * Long-lived plugins should listen to the signal to handle any cleanup logic.
+     * @alpha
+     */
+    readonly sessionAbortController: AbortController;
 }
 /**
  * Hooks into the lifecycle of the Rush process invocation that plugins may tap into.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.157.0",
+  "version": "5.158.1-pr5355.0",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -36,23 +36,23 @@
   "dependencies": {
     "@pnpm/lockfile.types": "~1.0.3",
     "tapable": "2.2.1",
-    "@rushstack/package-deps-hash": "4.4.3",
-    "@rushstack/lookup-by-path": "0.7.2",
-    "@rushstack/node-core-library": "5.14.0",
-    "@rushstack/terminal": "0.15.4"
+    "@rushstack/lookup-by-path": "0.7.6",
+    "@rushstack/node-core-library": "5.14.0-pr5355.0",
+    "@rushstack/terminal": "0.16.0",
+    "@rushstack/package-deps-hash": "4.4.7"
   },
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.8",
     "eslint": "~9.25.1",
     "webpack": "~5.98.0",
-    "@microsoft/rush-lib": "5.157.0",
-    "@rushstack/heft-webpack5-plugin": "0.11.35",
-    "@rushstack/heft": "0.74.1",
-    "@rushstack/stream-collator": "4.1.105",
-    "@rushstack/ts-command-line": "5.0.2",
-    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.104",
-    "local-node-rig": "1.0.0"
+    "@rushstack/heft": "0.74.5",
+    "@microsoft/rush-lib": "5.158.1-pr5355.0",
+    "@rushstack/heft-webpack5-plugin": "0.11.42",
+    "@rushstack/stream-collator": "4.1.109",
+    "@rushstack/ts-command-line": "5.0.3",
+    "local-node-rig": "1.0.0",
+    "@rushstack/webpack-preserve-dynamic-require-plugin": "0.11.108"
   },
   "scripts": {
     "build": "heft build --clean",