@rushstack/rush-sdk 5.112.2-pr4485.1 → 5.112.2-pr4485.3

package/dist/rush-lib.d.ts

@@ -1155,6 +1155,12 @@ export declare interface ICreateOperationsContext {
      * The Rush configuration
      */
     readonly rushConfiguration: RushConfiguration;
+    /**
+     * Marks an operation's result as invalid, potentially triggering a new build. Only applicable in watch mode.
+     * @param operation - The operation to invalidate
+     * @param reason - The reason for invalidating the operation
+     */
+    readonly invalidateOperation?: ((operation: Operation, reason: string) => void) | undefined;
 }
 
 /**
@@ -1333,6 +1339,12 @@ export declare interface IExperimentsJson {
      * If true, Rush will not allow node_modules in the repo folder or in parent folders.
      */
     forbidPhantomResolvableNodeModulesFolders?: boolean;
+    /**
+     * If true, when running in watch mode, Rush will check for phase scripts named `_phase:<name>:ipc` and run them instead
+     * of `_phase:<name>` if they exist. The created child process will be provided with an IPC channel and expected to persist
+     * across invocations.
+     */
+    useIPCScriptsInWatchMode?: boolean;
 }
 
 /**
@@ -1661,10 +1673,6 @@ export declare interface IOperationRunnerContext {
      * Defaults to `true`. Will be `false` if Rush was invoked with `--verbose`.
      */
     quietMode: boolean;
-    /**
-     * Object used to report a summary at the end of the Rush invocation.
-     */
-    stdioSummarizer: StdioSummarizer;
     /**
      * Object used to manage metadata of the operation.
      *
@@ -1687,13 +1695,6 @@ export declare interface IOperationRunnerContext {
      * it later (for example to re-print errors at end of execution).
      */
     error?: Error;
-    /**
-     * Normally the incremental build logic will rebuild changed projects as well as
-     * any projects that directly or indirectly depend on a changed project.
-     * If true, then the incremental build logic will only rebuild changed projects and
-     * ignore dependent projects.
-     */
-    readonly changedProjectsOnly: boolean;
     /**
      * Invokes the specified callback with a terminal that is associated with this operation.
      *
@@ -1748,13 +1749,6 @@ export declare interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
-    /**
-     * When running this operation in watch mode, enable IPC functionality. This allows reusing a long-lived child
-     * process instead of spawning a new child process for each incremental build.
-     *
-     * Implicitly disables the build cache for this operation.
-     */
-    useIPCInWatchMode?: boolean;
 }
 
 /**
@@ -2873,6 +2867,10 @@ export declare class PhasedCommandHooks {
     readonly afterExecuteOperation: AsyncSeriesHook<[
     IOperationRunnerContext & IOperationExecutionResult
     ]>;
+    /**
+     * Hook invoked to shutdown long-lived work in plugins.
+     */
+    readonly shutdown: SyncHook<void>;
     /**
      * Hook invoked after a run has finished and the command is watching for changes.
      * May be used to display additional relevant data to the user.

package/lib/api/ExperimentsConfiguration.d.ts

@@ -59,6 +59,12 @@ export interface IExperimentsJson {
      * If true, Rush will not allow node_modules in the repo folder or in parent folders.
      */
     forbidPhantomResolvableNodeModulesFolders?: boolean;
+    /**
+     * If true, when running in watch mode, Rush will check for phase scripts named `_phase:<name>:ipc` and run them instead
+     * of `_phase:<name>` if they exist. The created child process will be provided with an IPC channel and expected to persist
+     * across invocations.
+     */
+    useIPCScriptsInWatchMode?: boolean;
 }
 /**
  * Use this class to load the "common/config/rush/experiments.json" config file.

package/lib/api/RushProjectConfiguration.d.ts

@@ -73,13 +73,6 @@ export interface IOperationSettings {
      * calculating final hash value when reading and writing the build cache
      */
     dependsOnAdditionalFiles?: string[];
-    /**
-     * When running this operation in watch mode, enable IPC functionality. This allows reusing a long-lived child
-     * process instead of spawning a new child process for each incremental build.
-     *
-     * Implicitly disables the build cache for this operation.
-     */
-    useIPCInWatchMode?: boolean;
 }
 /**
  * Use this class to load the "config/rush-project.json" config file.

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

@@ -50,6 +50,7 @@ export declare class PhasedScriptAction extends BaseScriptAction<IPhasedCommandC
     private readonly _watchParameter;
     private readonly _timelineParameter;
     private readonly _installParameter;
+    private readonly _noIPCParameter;
     constructor(options: IPhasedScriptActionOptions);
     runAsync(): Promise<void>;
     private _runInitialPhases;

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

@@ -1,4 +1,3 @@
-import type { StdioSummarizer } from '@rushstack/terminal';
 import type { CollatedWriter } from '@rushstack/stream-collator';
 import type { ITerminal, ITerminalProvider } from '@rushstack/node-core-library';
 import type { OperationStatus } from './OperationStatus';
@@ -22,10 +21,6 @@ export interface IOperationRunnerContext {
      * Defaults to `true`. Will be `false` if Rush was invoked with `--verbose`.
      */
     quietMode: boolean;
-    /**
-     * Object used to report a summary at the end of the Rush invocation.
-     */
-    stdioSummarizer: StdioSummarizer;
     /**
      * Object used to manage metadata of the operation.
      *
@@ -48,13 +43,6 @@ export interface IOperationRunnerContext {
      * it later (for example to re-print errors at end of execution).
      */
     error?: Error;
-    /**
-     * Normally the incremental build logic will rebuild changed projects as well as
-     * any projects that directly or indirectly depend on a changed project.
-     * If true, then the incremental build logic will only rebuild changed projects and
-     * ignore dependent projects.
-     */
-    readonly changedProjectsOnly: boolean;
     /**
      * Invokes the specified callback with a terminal that is associated with this operation.
      *

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

@@ -13,7 +13,6 @@ export interface IOperationExecutionRecordContext {
     onOperationStatusChanged?: (record: OperationExecutionRecord) => void;
     debugMode: boolean;
     quietMode: boolean;
-    changedProjectsOnly: boolean;
 }
 /**
  * Internal class representing everything about executing an operation
@@ -84,7 +83,6 @@ export declare class OperationExecutionRecord implements IOperationRunnerContext
     get name(): string;
     get debugMode(): boolean;
     get quietMode(): boolean;
-    get changedProjectsOnly(): boolean;
     get collatedWriter(): CollatedWriter;
     get nonCachedDurationMs(): number | undefined;
     get cobuildRunnerId(): string | undefined;

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

@@ -1,8 +1,18 @@
+import type { IPhase } from '../../api/CommandLineConfiguration';
+import type { RushConfigurationProject } from '../../api/RushConfigurationProject';
 import type { IPhasedCommandPlugin, PhasedCommandHooks } from '../../pluginFramework/PhasedCommandHooks';
+export declare const PLUGIN_NAME: 'ShellOperationRunnerPlugin';
 /**
  * Core phased command plugin that provides the functionality for executing an operation via shell command.
  */
 export declare class ShellOperationRunnerPlugin implements IPhasedCommandPlugin {
     apply(hooks: PhasedCommandHooks): void;
 }
+/**
+ * Memoizer for custom parameter values by phase
+ * @returns A function that returns the custom parameter values for a given phase
+ */
+export declare function getCustomParameterValuesByPhase(): (phase: IPhase) => ReadonlyArray<string>;
+export declare function formatCommand(rawCommand: string, customParameterValues: ReadonlyArray<string>): string;
+export declare function getDisplayName(phase: IPhase, project: RushConfigurationProject): string;
 //# sourceMappingURL=ShellOperationRunnerPlugin.d.ts.map

package/lib/pluginFramework/PhasedCommandHooks.d.ts

@@ -83,6 +83,12 @@ export interface ICreateOperationsContext {
      * The Rush configuration
      */
     readonly rushConfiguration: RushConfiguration;
+    /**
+     * Marks an operation's result as invalid, potentially triggering a new build. Only applicable in watch mode.
+     * @param operation - The operation to invalidate
+     * @param reason - The reason for invalidating the operation
+     */
+    readonly invalidateOperation?: ((operation: Operation, reason: string) => void) | undefined;
 }
 /**
  * Hooks into the execution process for phased commands
@@ -125,6 +131,10 @@ export declare class PhasedCommandHooks {
     readonly afterExecuteOperation: AsyncSeriesHook<[
         IOperationRunnerContext & IOperationExecutionResult
     ]>;
+    /**
+     * Hook invoked to shutdown long-lived work in plugins.
+     */
+    readonly shutdown: SyncHook<void>;
     /**
      * Hook invoked after a run has finished and the command is watching for changes.
      * May be used to display additional relevant data to the user.

package/lib/utilities/Utilities.d.ts

@@ -59,6 +59,10 @@ export interface ILifecycleCommandOptions {
      * If true, attempt to establish a NodeJS IPC channel to the child process.
      */
     ipc?: boolean;
+    /**
+     * If true, wire up SubprocessTerminator to the child process.
+     */
+    connectSubprocessTerminator?: boolean;
 }
 export interface IEnvironmentPathOptions {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-sdk",
-  "version": "5.112.2-pr4485.1",
+  "version": "5.112.2-pr4485.3",
   "description": "An API for interacting with the Rush engine",
   "repository": {
     "type": "git",
@@ -30,11 +30,11 @@
   "devDependencies": {
     "@types/semver": "7.5.0",
     "@types/webpack-env": "1.18.0",
-    "@microsoft/rush-lib": "5.112.2-pr4485.1",
-    "@rushstack/stream-collator": "4.1.18",
+    "@microsoft/rush-lib": "5.112.2-pr4485.3",
     "@rushstack/heft": "0.64.0",
-    "@rushstack/terminal": "0.7.17",
+    "@rushstack/stream-collator": "4.1.18",
     "local-node-rig": "1.0.0",
+    "@rushstack/terminal": "0.7.17",
     "@rushstack/ts-command-line": "4.17.1"
   },
   "scripts": {