aws-cdk 2.1138.0 → 2.1139.0

package/README.md

@@ -9,7 +9,7 @@
 
 <!--END STABILITY BANNER-->
 
-The AWS CDK Toolkit provides the `cdk` command-line interface that can be used to work with AWS CDK applications. This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.
+The AWS CDK Toolkit CLI provides the `cdk` command-line interface that can be used to work with AWS CDK applications. This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.
 
 | Command                                     | Description                                                                       |
 | ------------------------------------------- | --------------------------------------------------------------------------------- |
@@ -199,6 +199,17 @@ $ cdk diff --app='node bin/main.js' MyStackName
 $ cdk diff --app='node bin/main.js' MyStackName --template=path/to/template.yml
 ```
 
+The stack header shows the environment the stack will be deployed to. For environment-agnostic
+stacks this is the resolved account and region, not `unknown-account`/`unknown-region`. It is
+omitted when diffing against a local template with `--template`, which does not contact AWS.
+
+```console
+$ cdk diff --app='node bin/main.js' MyStackName
+Stack MyStackName (aws://123456789012/us-east-1)
+Resources
+[~] AWS::S3::Bucket MyBucket
+```
+
 The `quiet` flag can also be passed to the `cdk diff` command. Assuming there are no differences detected the output to the console will **not** contain strings such as the *Stack* `MyStackName` and `There were no differences`.
 
 ```console
@@ -413,7 +424,10 @@ $ cdk deploy --progress errors-only
 ```
 
 The `errors-only` mode is recommended for AI agents and other automated consumers, where progress
-updates are not useful and consume tokens.
+updates are not useful and consume tokens. If the CLI detects it is being run by an AI agent
+and no progress preference is configured, it defaults to `errors-only` automatically. Pass an
+explicit `--progress`, set the `progress` key in `cdk.json`, or enable verbose logging (`-v`)
+to override the detection.
 
 Alternatively, the `progress` key can be specified in the project config (`cdk.json`).
 

package/THIRD_PARTY_LICENSES

@@ -5975,7 +5975,7 @@ Apache License
 
 ----------------
 
-** @aws-sdk/credential-providers@3.1111.0 - https://www.npmjs.com/package/@aws-sdk/credential-providers/v/3.1111.0 | Apache-2.0
+** @aws-sdk/credential-providers@3.1115.0 - https://www.npmjs.com/package/@aws-sdk/credential-providers/v/3.1115.0 | Apache-2.0
 Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -8361,7 +8361,7 @@ Apache License
 
 ----------------
 
-** @smithy/core@3.33.0 - https://www.npmjs.com/package/@smithy/core/v/3.33.0 | Apache-2.0
+** @smithy/core@3.33.3 - https://www.npmjs.com/package/@smithy/core/v/3.33.3 | Apache-2.0
                                 Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -10208,7 +10208,7 @@ Apache License
 
 ----------------
 
-** @smithy/types@4.17.0 - https://www.npmjs.com/package/@smithy/types/v/4.17.0 | Apache-2.0
+** @smithy/types@4.17.2 - https://www.npmjs.com/package/@smithy/types/v/4.17.2 | Apache-2.0
                                 Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -10936,7 +10936,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ----------------
 
-** cdk-from-cfn@0.324.0 - https://www.npmjs.com/package/cdk-from-cfn/v/0.324.0 | MIT OR Apache-2.0
+** cdk-from-cfn@0.325.0 - https://www.npmjs.com/package/cdk-from-cfn/v/0.325.0 | MIT OR Apache-2.0
 
 ----------------
 
@@ -11037,6 +11037,32 @@ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 OTHER DEALINGS IN THE SOFTWARE.
 
 
+----------------
+
+** cross-spawn@7.0.6 - https://www.npmjs.com/package/cross-spawn/v/7.0.6 | MIT
+The MIT License (MIT)
+
+Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
 ----------------
 
 ** data-uri-to-buffer@6.0.2 - https://www.npmjs.com/package/data-uri-to-buffer/v/6.0.2 | MIT
@@ -11692,6 +11718,26 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 
 
+----------------
+
+** isexe@2.0.0 - https://www.npmjs.com/package/isexe/v/2.0.0 | ISC
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
 ----------------
 
 ** json-source-map@0.6.1 - https://www.npmjs.com/package/json-source-map/v/0.6.1 | MIT
@@ -12133,6 +12179,20 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 
+----------------
+
+** path-key@3.1.1 - https://www.npmjs.com/package/path-key/v/3.1.1 | MIT
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
 ----------------
 
 ** picomatch@2.3.2 - https://www.npmjs.com/package/picomatch/v/2.3.2 | MIT
@@ -12470,6 +12530,34 @@ WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
 ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 
+----------------
+
+** shebang-command@2.0.0 - https://www.npmjs.com/package/shebang-command/v/2.0.0 | MIT
+MIT License
+
+Copyright (c) Kevin Mårtensson <kevinmartensson@gmail.com> (github.com/kevva)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+----------------
+
+** shebang-regex@3.0.0 - https://www.npmjs.com/package/shebang-regex/v/3.0.0 | MIT
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
 ----------------
 
 ** slice-ansi@4.0.0 - https://www.npmjs.com/package/slice-ansi/v/4.0.0 | MIT
@@ -12594,24 +12682,6 @@ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
-----------------
-
-** split2@4.2.0 - https://www.npmjs.com/package/split2/v/4.2.0 | ISC
-Copyright (c) 2014-2018, Matteo Collina <hello@matteocollina.com>
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
-IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
-
 ----------------
 
 ** string-width@4.2.3 - https://www.npmjs.com/package/string-width/v/4.2.3 | MIT
@@ -12848,6 +12918,26 @@ TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 THIS SOFTWARE.
 
 
+----------------
+
+** which@2.0.2 - https://www.npmjs.com/package/which/v/2.0.2 | ISC
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
 ----------------
 
 ** wrap-ansi@6.2.0 - https://www.npmjs.com/package/wrap-ansi/v/6.2.0 | MIT

package/build-info.json

@@ -1,4 +1,4 @@
 {
-  "comment": "Generated at 2026-08-19T16:14:00Z by generate.sh",
-  "commit": "a4c0282"
+  "comment": "Generated at 2026-08-26T16:06:33Z by generate.sh",
+  "commit": "d51353e"
 }

package/docs/deploy-architecture.md

@@ -15,7 +15,7 @@ graph TD
     
     %% Deploy Method
     n4["cdk-toolkit.ts: CdkToolkit.deploy()"]
-    n5["cdk-toolkit.ts: selectStacksForDeploy()"]
+    n5["cdk-toolkit.ts: CdkToolkit.deploy()<br/>stack selection"]
     n6["Check if synthesis needed"]
     
     %% Synthesis Process
@@ -31,8 +31,8 @@ graph TD
     n13["Return CloudAssembly object"]
     
     %% Stack Selection
-    n14["cloud-assembly.ts:<br/>assembly.selectStacks()"]
-    n15["cloud-assembly.ts:<br/>validateStacks()"]
+    n14["stack-assembly.ts (toolkit-lib):<br/>assembly.selectStacksV2()"]
+    n15["cdk-toolkit.ts:<br/>validateStacks()"]
     n16["Return StackCollection"]
     
     %% Asset Processing

package/lib/api/cloud-assembly.d.ts

@@ -2,4 +2,3 @@ export * from '../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly';
 export * from '../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/private';
 export * from '../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/environment';
 export * from '../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/stack-collection';
-export * from '../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/stack-assembly';

package/lib/api/cloud-assembly.js

@@ -19,5 +19,4 @@ __exportStar(require("../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly"), ex
 __exportStar(require("../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/private"), exports);
 __exportStar(require("../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/environment"), exports);
 __exportStar(require("../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/stack-collection"), exports);
-__exportStar(require("../../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/stack-assembly"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xvdWQtYXNzZW1ibHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjbG91ZC1hc3NlbWJseS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsZ0RBQWdEO0FBQ2hELHVGQUFxRTtBQUNyRSwrRkFBNkU7QUFDN0UsbUdBQWlGO0FBQ2pGLHdHQUFzRjtBQUN0RixzR0FBb0YiLCJzb3VyY2VzQ29udGVudCI6WyIvKiBlc2xpbnQtZGlzYWJsZSBpbXBvcnQvbm8tcmVsYXRpdmUtcGFja2FnZXMgKi9cbmV4cG9ydCAqIGZyb20gJy4uLy4uLy4uL0Bhd3MtY2RrL3Rvb2xraXQtbGliL2xpYi9hcGkvY2xvdWQtYXNzZW1ibHknO1xuZXhwb3J0ICogZnJvbSAnLi4vLi4vLi4vQGF3cy1jZGsvdG9vbGtpdC1saWIvbGliL2FwaS9jbG91ZC1hc3NlbWJseS9wcml2YXRlJztcbmV4cG9ydCAqIGZyb20gJy4uLy4uLy4uL0Bhd3MtY2RrL3Rvb2xraXQtbGliL2xpYi9hcGkvY2xvdWQtYXNzZW1ibHkvZW52aXJvbm1lbnQnO1xuZXhwb3J0ICogZnJvbSAnLi4vLi4vLi4vQGF3cy1jZGsvdG9vbGtpdC1saWIvbGliL2FwaS9jbG91ZC1hc3NlbWJseS9zdGFjay1jb2xsZWN0aW9uJztcbmV4cG9ydCAqIGZyb20gJy4uLy4uLy4uL0Bhd3MtY2RrL3Rvb2xraXQtbGliL2xpYi9hcGkvY2xvdWQtYXNzZW1ibHkvc3RhY2stYXNzZW1ibHknO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xvdWQtYXNzZW1ibHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjbG91ZC1hc3NlbWJseS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsZ0RBQWdEO0FBQ2hELHVGQUFxRTtBQUNyRSwrRkFBNkU7QUFDN0UsbUdBQWlGO0FBQ2pGLHdHQUFzRiIsInNvdXJjZXNDb250ZW50IjpbIi8qIGVzbGludC1kaXNhYmxlIGltcG9ydC9uby1yZWxhdGl2ZS1wYWNrYWdlcyAqL1xuZXhwb3J0ICogZnJvbSAnLi4vLi4vLi4vQGF3cy1jZGsvdG9vbGtpdC1saWIvbGliL2FwaS9jbG91ZC1hc3NlbWJseSc7XG5leHBvcnQgKiBmcm9tICcuLi8uLi8uLi9AYXdzLWNkay90b29sa2l0LWxpYi9saWIvYXBpL2Nsb3VkLWFzc2VtYmx5L3ByaXZhdGUnO1xuZXhwb3J0ICogZnJvbSAnLi4vLi4vLi4vQGF3cy1jZGsvdG9vbGtpdC1saWIvbGliL2FwaS9jbG91ZC1hc3NlbWJseS9lbnZpcm9ubWVudCc7XG5leHBvcnQgKiBmcm9tICcuLi8uLi8uLi9AYXdzLWNkay90b29sa2l0LWxpYi9saWIvYXBpL2Nsb3VkLWFzc2VtYmx5L3N0YWNrLWNvbGxlY3Rpb24nO1xuIl19

package/lib/cli/cdk-toolkit.d.ts

@@ -1,5 +1,5 @@
 import { RequireApproval } from '@aws-cdk/cloud-assembly-schema';
-import type { DeploymentMethod, DiagnoseOptions, PublishAssetsOptions, ToolkitOptions, ValidateOptions } from '@aws-cdk/toolkit-lib';
+import type { DeploymentMethod, DiagnoseOptions, PublishAssetsOptions, StackSelector, ToolkitOptions, ValidateOptions } from '@aws-cdk/toolkit-lib';
 import { Toolkit } from '@aws-cdk/toolkit-lib';
 import { CliIoHost } from './io-host';
 import type { Configuration } from './user-configuration';
@@ -7,11 +7,12 @@ import type { IoHelper } from '../../lib/api-private';
 import { CloudWatchLogEventMonitor } from '../api';
 import type { SdkProvider } from '../api/aws-auth';
 import type { BootstrapEnvironmentOptions } from '../api/bootstrap';
+import type { StackAssembly } from '../api/cloud-assembly';
 import type { Deployments } from '../api/deployments';
 import { type Tag } from '../api/tags';
 import { StackActivityProgress } from '../commands/deploy';
 import type { FromScan } from '../commands/migrate';
-import type { CloudAssembly, CloudExecutable, StackSelector } from '../cxapp';
+import type { CloudExecutable } from '../cxapp';
 export interface CdkToolkitProps {
     /**
      * The Cloud Executable
@@ -150,7 +151,7 @@ export declare class CdkToolkit {
      * OUTPUT: If more than one stack ends up being selected, an output directory
      * should be supplied, where the templates will be written.
      */
-    synth(stackNames: string[], exclusively: boolean, quiet: boolean, autoValidate?: boolean, json?: boolean): Promise<any>;
+    synth(options: SynthOptions): Promise<any>;
     /**
      * Bootstrap the CDK Toolkit stack in the accounts used by the specified stack(s).
      *
@@ -171,19 +172,32 @@ export declare class CdkToolkit {
      */
     migrate(options: MigrateOptions): Promise<void>;
     refactor(options: RefactorOptions): Promise<number>;
-    private selectStacksForList;
-    private selectStacksForDeploy;
-    private selectStacksForDiff;
+    /**
+     * Select the stacks that `synth` and `diff` operate on
+     *
+     * With patterns: match them (failing if nothing matches), expanding to
+     * upstream dependencies unless `exclusively` is set. Without patterns: all
+     * top-level stacks, exactly — the historic default selection never expands
+     * to dependencies, regardless of `exclusively`. A stage-only app has no
+     * top-level stacks, which selects nothing and is not an error — but an app
+     * without any stacks at all still is. No single selection strategy covers
+     * this combination: `MAIN_ASSEMBLY` rejects stage-only apps (as
+     * `deploy --all` must keep doing) and `ALL_STACKS` would wrongly include
+     * the stacks inside stages.
+     */
+    private selectTopLevelOrMatchingStacks;
     /**
      * Validate the stacks for errors and warnings according to the CLI's current settings
      */
     private validateStacks;
     private validateMetadataFailAt;
     /**
-     * Validate that if a user specified a stack name there exists at least 1 stack selected
+     * Converts the toolkit's `CloudExecutable` into `StackAssembly`.
+     *
+     * @param cacheCloudAssembly - to cache the assembly, defaults to `true`
+     * @returns the converted `StackAssembly`
      */
-    private validateStacksSelected;
-    assembly(cacheCloudAssembly?: boolean): Promise<CloudAssembly>;
+    assembly(cacheCloudAssembly?: boolean): Promise<StackAssembly>;
     private patternsArrayForWatch;
     private invokeDeployFromWatch;
     /**
@@ -191,6 +205,39 @@ export declare class CdkToolkit {
      */
     private removePublishedAssets;
 }
+/**
+ * Options for the synth command
+ */
+export interface SynthOptions {
+    /**
+     * Stack names to synthesize
+     */
+    readonly stackNames: string[];
+    /**
+     * Only select the given stacks, without expanding to their upstream dependencies
+     *
+     * @default false
+     */
+    readonly exclusively?: boolean;
+    /**
+     * Do not print the template to stdout
+     *
+     * @default false
+     */
+    readonly quiet?: boolean;
+    /**
+     * Additionally validate stacks that have the `validateOnSynth` flag set
+     *
+     * @default false
+     */
+    readonly autoValidate?: boolean;
+    /**
+     * Print the template as JSON instead of YAML
+     *
+     * @default false
+     */
+    readonly json?: boolean;
+}
 /**
  * Options for the diff command
  */
@@ -323,12 +370,6 @@ export interface CliValidateOptions extends ValidateOptions {
     readonly watch?: boolean;
 }
 interface WatchOptions extends Omit<CfnDeployOptions, 'execute'> {
-    /**
-     * Only select the given stack
-     *
-     * @default false
-     */
-    exclusively?: boolean;
     /**
      * Reuse the assets with the given asset IDs
      */
@@ -452,12 +493,6 @@ export interface DeployOptions extends CfnDeployOptions, WatchOptions {
      * @default AssetBuildTime.ALL_BEFORE_DEPLOY
      */
     readonly assetBuildTime?: AssetBuildTime;
-    /**
-     * Whether to deploy if the app contains no stacks.
-     *
-     * @default false
-     */
-    readonly ignoreNoStacks?: boolean;
     /**
      * Whether to use CloudFormation express mode for the current deployment
      */
@@ -547,10 +582,6 @@ export interface DestroyOptions {
      * Criteria for selecting stacks to deploy
      */
     selector: StackSelector;
-    /**
-     * Whether to exclude stacks that depend on the stacks to be deleted
-     */
-    exclusively: boolean;
     /**
      * Whether to skip prompting for confirmation
      */