@codedrifters/configulator 0.0.318 → 0.0.320

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.ts CHANGED
@@ -6836,6 +6836,1201 @@ declare class AstroConfig extends Component {
6836
6836
  private synthesizeConfig;
6837
6837
  }
6838
6838
 
6839
+ /*******************************************************************************
6840
+ *
6841
+ * AWS CDK CLI Enums
6842
+ *
6843
+ * `as const` enums for the `cdk` CLI surface. Phase 1 covered `cdk deploy`;
6844
+ * Phase 2 adds the enum needed by `cdk diff`; Phase 3 adds the enums needed by
6845
+ * `cdk gc`; Phase 4 adds the enums needed by `cdk init` (and reused by `cdk
6846
+ * migrate`).
6847
+ *
6848
+ ******************************************************************************/
6849
+ /**
6850
+ * `--require-approval` values accepted by `cdk deploy`.
6851
+ */
6852
+ declare const CDK_REQUIRE_APPROVAL: {
6853
+ readonly Never: "never";
6854
+ readonly AnyChange: "any-change";
6855
+ readonly Broadening: "broadening";
6856
+ };
6857
+ /**
6858
+ * Type for {@link CDK_REQUIRE_APPROVAL} values.
6859
+ */
6860
+ type CdkRequireApproval = (typeof CDK_REQUIRE_APPROVAL)[keyof typeof CDK_REQUIRE_APPROVAL];
6861
+ /**
6862
+ * `--method` values accepted by `cdk deploy`.
6863
+ */
6864
+ declare const CDK_DEPLOY_METHOD: {
6865
+ readonly ChangeSet: "change-set";
6866
+ readonly Direct: "direct";
6867
+ readonly PrepareChangeSet: "prepare-change-set";
6868
+ readonly ExecuteChangeSet: "execute-change-set";
6869
+ };
6870
+ /**
6871
+ * Type for {@link CDK_DEPLOY_METHOD} values.
6872
+ */
6873
+ type CdkDeployMethod = (typeof CDK_DEPLOY_METHOD)[keyof typeof CDK_DEPLOY_METHOD];
6874
+ /**
6875
+ * `--progress` values accepted by `cdk deploy`.
6876
+ */
6877
+ declare const CDK_PROGRESS: {
6878
+ readonly Bar: "bar";
6879
+ readonly Events: "events";
6880
+ };
6881
+ /**
6882
+ * Type for {@link CDK_PROGRESS} values.
6883
+ */
6884
+ type CdkProgress = (typeof CDK_PROGRESS)[keyof typeof CDK_PROGRESS];
6885
+ /**
6886
+ * `--method` values accepted by `cdk diff`.
6887
+ */
6888
+ declare const CDK_DIFF_METHOD: {
6889
+ readonly Auto: "auto";
6890
+ readonly ChangeSet: "change-set";
6891
+ readonly Template: "template";
6892
+ };
6893
+ /**
6894
+ * Type for {@link CDK_DIFF_METHOD} values.
6895
+ */
6896
+ type CdkDiffMethod = (typeof CDK_DIFF_METHOD)[keyof typeof CDK_DIFF_METHOD];
6897
+ /**
6898
+ * `--action` values accepted by `cdk gc`.
6899
+ */
6900
+ declare const CDK_GC_ACTION: {
6901
+ readonly DeleteTagged: "delete-tagged";
6902
+ readonly Full: "full";
6903
+ readonly Print: "print";
6904
+ readonly Tag: "tag";
6905
+ };
6906
+ /**
6907
+ * Type for {@link CDK_GC_ACTION} values.
6908
+ */
6909
+ type CdkGcAction = (typeof CDK_GC_ACTION)[keyof typeof CDK_GC_ACTION];
6910
+ /**
6911
+ * `--type` values accepted by `cdk gc`.
6912
+ */
6913
+ declare const CDK_GC_TYPE: {
6914
+ readonly All: "all";
6915
+ readonly Ecr: "ecr";
6916
+ readonly S3: "s3";
6917
+ };
6918
+ /**
6919
+ * Type for {@link CDK_GC_TYPE} values.
6920
+ */
6921
+ type CdkGcType = (typeof CDK_GC_TYPE)[keyof typeof CDK_GC_TYPE];
6922
+ /**
6923
+ * Positional `<template>` values accepted by `cdk init`.
6924
+ */
6925
+ declare const CDK_INIT_TEMPLATE: {
6926
+ readonly App: "app";
6927
+ readonly Lib: "lib";
6928
+ readonly SampleApp: "sample-app";
6929
+ };
6930
+ /**
6931
+ * Type for {@link CDK_INIT_TEMPLATE} values.
6932
+ */
6933
+ type CdkInitTemplate = (typeof CDK_INIT_TEMPLATE)[keyof typeof CDK_INIT_TEMPLATE];
6934
+ /**
6935
+ * `--language` values accepted by `cdk init`. Also reused by `cdk migrate`'s
6936
+ * `--language` flag, which accepts the same set of language identifiers.
6937
+ */
6938
+ declare const CDK_INIT_LANGUAGE: {
6939
+ readonly CSharp: "csharp";
6940
+ readonly FSharp: "fsharp";
6941
+ readonly Go: "go";
6942
+ readonly Java: "java";
6943
+ readonly JavaScript: "javascript";
6944
+ readonly Python: "python";
6945
+ readonly TypeScript: "typescript";
6946
+ };
6947
+ /**
6948
+ * Type for {@link CDK_INIT_LANGUAGE} values.
6949
+ */
6950
+ type CdkInitLanguage = (typeof CDK_INIT_LANGUAGE)[keyof typeof CDK_INIT_LANGUAGE];
6951
+
6952
+ /*******************************************************************************
6953
+ *
6954
+ * AWS CDK CLI Options
6955
+ *
6956
+ * Typed coverage of the `cdk` CLI surface. Phase 1 covered `deploy`; Phase 2
6957
+ * adds `synth`, `watch`, `destroy`, `diff`, `bootstrap`, and `list`; Phase 3
6958
+ * adds the maintenance / lifecycle commands `rollback`, `import`, `gc`,
6959
+ * `drift`, `refactor`, `publish-assets`, and `orphan`; Phase 4 adds the
6960
+ * inspection / scaffolding commands `init`, `migrate`, `context`, `metadata`,
6961
+ * `flags`, `acknowledge`, `notices`, `doctor`, and `docs`. Every
6962
+ * command-specific interface inherits {@link CdkGlobalOptions} so it carries
6963
+ * the same global flag surface.
6964
+ *
6965
+ * Every boolean field is tri-state (`boolean | undefined`):
6966
+ * - `undefined` → the renderer emits nothing, and the CLI's own default
6967
+ * applies.
6968
+ * - `true` → renders as `--flag`.
6969
+ * - `false` → renders as `--no-flag`.
6970
+ *
6971
+ ******************************************************************************/
6972
+ /**
6973
+ * Global CLI flags accepted by every `cdk` subcommand. Command-specific option
6974
+ * interfaces extend this base so the global flag surface stays in lock-step
6975
+ * across commands.
6976
+ */
6977
+ interface CdkGlobalOptions {
6978
+ /*****************************************************************************
6979
+ *
6980
+ * Global CLI flags
6981
+ *
6982
+ ****************************************************************************/
6983
+ /**
6984
+ * `--app` — path to the CDK cloud assembly (or the synth command).
6985
+ */
6986
+ readonly app?: string;
6987
+ /**
6988
+ * `--profile` — named AWS profile from `~/.aws/credentials`.
6989
+ */
6990
+ readonly profile?: string;
6991
+ /**
6992
+ * `--lookups` — whether the CLI may perform context lookups against the
6993
+ * target environment.
6994
+ */
6995
+ readonly lookups?: boolean;
6996
+ /**
6997
+ * `--context` — CDK context values. Repeats one `--context` flag per
6998
+ * `KEY=VALUE` entry.
6999
+ */
7000
+ readonly context?: Record<string, string>;
7001
+ /**
7002
+ * `--output` — directory to read the cloud assembly from.
7003
+ */
7004
+ readonly output?: string;
7005
+ /**
7006
+ * `--verbose` (`-v`) — verbosity level. The renderer emits `-v` repeated N
7007
+ * times.
7008
+ */
7009
+ readonly verbose?: number;
7010
+ /**
7011
+ * `--debug` — enable debug output.
7012
+ */
7013
+ readonly debug?: boolean;
7014
+ /**
7015
+ * `--ci` — non-interactive CI mode.
7016
+ */
7017
+ readonly ci?: boolean;
7018
+ /**
7019
+ * `--yes` — auto-confirm prompts.
7020
+ */
7021
+ readonly yes?: boolean;
7022
+ /**
7023
+ * `--role-arn` — IAM role to assume for CloudFormation deployments.
7024
+ */
7025
+ readonly roleArn?: string;
7026
+ /**
7027
+ * `--proxy` — HTTP/HTTPS proxy URL.
7028
+ */
7029
+ readonly proxy?: string;
7030
+ /**
7031
+ * `--ca-bundle-path` — path to a CA bundle for TLS verification.
7032
+ */
7033
+ readonly caBundlePath?: string;
7034
+ /**
7035
+ * `--ec2creds` — force the SDK to obtain credentials from the EC2 instance
7036
+ * metadata service.
7037
+ */
7038
+ readonly ec2creds?: boolean;
7039
+ /**
7040
+ * `--version-reporting` — include CDK library version reporting in the
7041
+ * synthesised template metadata.
7042
+ */
7043
+ readonly versionReporting?: boolean;
7044
+ /**
7045
+ * `--path-metadata` — include path metadata in the synthesised template.
7046
+ */
7047
+ readonly pathMetadata?: boolean;
7048
+ /**
7049
+ * `--asset-metadata` — include asset metadata in the synthesised template.
7050
+ */
7051
+ readonly assetMetadata?: boolean;
7052
+ /**
7053
+ * `--staging` — copy assets to `cdk.out` for staging.
7054
+ */
7055
+ readonly staging?: boolean;
7056
+ /**
7057
+ * `--notices` — show CDK notices.
7058
+ */
7059
+ readonly notices?: boolean;
7060
+ /**
7061
+ * `--color` — force-enable coloured output.
7062
+ */
7063
+ readonly color?: boolean;
7064
+ /**
7065
+ * `--no-color` — disable coloured output.
7066
+ */
7067
+ readonly noColor?: boolean;
7068
+ /**
7069
+ * `--unstable` — opt into named unstable CLI features. Repeats one
7070
+ * `--unstable` flag per entry.
7071
+ */
7072
+ readonly unstable?: Array<string>;
7073
+ /**
7074
+ * `--telemetry-file` — write CDK telemetry to the given path.
7075
+ */
7076
+ readonly telemetryFile?: string;
7077
+ /**
7078
+ * `--trace` — print stack traces on errors.
7079
+ */
7080
+ readonly trace?: boolean;
7081
+ /**
7082
+ * `--strict` — promote certain warnings to errors.
7083
+ */
7084
+ readonly strict?: boolean;
7085
+ /**
7086
+ * `--ignore-errors` — proceed past non-fatal errors.
7087
+ */
7088
+ readonly ignoreErrors?: boolean;
7089
+ /**
7090
+ * `--json` — emit JSON-formatted output.
7091
+ */
7092
+ readonly json?: boolean;
7093
+ /**
7094
+ * `--plugin` — register one or more CDK CLI plugins. Repeats one `--plugin`
7095
+ * flag per entry.
7096
+ */
7097
+ readonly plugin?: Array<string>;
7098
+ /**
7099
+ * `--build` — command to build the CDK app before deploy.
7100
+ */
7101
+ readonly build?: string;
7102
+ /*****************************************************************************
7103
+ *
7104
+ * Trailing positional arguments
7105
+ *
7106
+ ****************************************************************************/
7107
+ /**
7108
+ * Stack patterns passed as trailing positional arguments. Quoted by the
7109
+ * renderer to preserve glob characters across shells.
7110
+ */
7111
+ readonly stackPatterns?: Array<string>;
7112
+ }
7113
+ /**
7114
+ * Options for the `cdk deploy` command.
7115
+ */
7116
+ interface CdkDeployOptions extends CdkGlobalOptions {
7117
+ /*****************************************************************************
7118
+ *
7119
+ * Deploy-specific flags
7120
+ *
7121
+ ****************************************************************************/
7122
+ /**
7123
+ * Deploy all stacks in the application.
7124
+ */
7125
+ readonly all?: boolean;
7126
+ /**
7127
+ * `--require-approval` — when to prompt for security-related approvals.
7128
+ */
7129
+ readonly requireApproval?: CdkRequireApproval;
7130
+ /**
7131
+ * `--rollback` / `--no-rollback` — roll back the stack on failure.
7132
+ *
7133
+ * Tri-state: `true` enables rollback, `false` disables it (useful in dev for
7134
+ * fast iteration), `undefined` defers to the CLI default.
7135
+ */
7136
+ readonly rollback?: boolean;
7137
+ /**
7138
+ * `--hotswap` — apply changes directly to running resources without going
7139
+ * through CloudFormation when possible.
7140
+ *
7141
+ * @deprecated AWS recommends `--hotswap` strictly for development use; it
7142
+ * introduces drift relative to the deployed CloudFormation template and
7143
+ * should never be used in production deployments.
7144
+ */
7145
+ readonly hotswap?: boolean;
7146
+ /**
7147
+ * `--hotswap-fallback` — fall back to a full CloudFormation deployment when a
7148
+ * hotswap is not possible.
7149
+ */
7150
+ readonly hotswapFallback?: boolean;
7151
+ /**
7152
+ * `--method` — how the deployment is performed (change-set vs direct).
7153
+ */
7154
+ readonly method?: CdkDeployMethod;
7155
+ /**
7156
+ * `--change-set-name` — name of the change set to create/execute.
7157
+ */
7158
+ readonly changeSetName?: string;
7159
+ /**
7160
+ * `--force` — always deploy even if no changes are detected.
7161
+ */
7162
+ readonly force?: boolean;
7163
+ /**
7164
+ * `--exclusively` — deploy only the requested stacks; do not include
7165
+ * dependencies.
7166
+ */
7167
+ readonly exclusively?: boolean;
7168
+ /**
7169
+ * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
7170
+ * environment bootstrap.
7171
+ */
7172
+ readonly toolkitStackName?: string;
7173
+ /**
7174
+ * `--parameters` — CloudFormation parameters to pass to the stack. Each
7175
+ * entry is a `KEY=VALUE` string. Repeats one `--parameters` flag per entry.
7176
+ */
7177
+ readonly parameters?: Array<string>;
7178
+ /**
7179
+ * `--outputs-file` — write CloudFormation outputs to a JSON file at the
7180
+ * given path.
7181
+ */
7182
+ readonly outputsFile?: string;
7183
+ /**
7184
+ * `--previous-parameters` — use previous parameter values for any parameters
7185
+ * not explicitly supplied.
7186
+ */
7187
+ readonly previousParameters?: boolean;
7188
+ /**
7189
+ * `--concurrency` — number of stacks to deploy in parallel.
7190
+ */
7191
+ readonly concurrency?: number;
7192
+ /**
7193
+ * `--asset-parallelism` — upload assets in parallel.
7194
+ */
7195
+ readonly assetParallelism?: boolean;
7196
+ /**
7197
+ * `--asset-prebuild` — pre-build assets before deploying.
7198
+ */
7199
+ readonly assetPrebuild?: boolean;
7200
+ /**
7201
+ * `--watch` — continue watching for changes after the initial deploy.
7202
+ */
7203
+ readonly watch?: boolean;
7204
+ /**
7205
+ * `--logs` — stream CloudWatch logs for resources updated by the deploy.
7206
+ */
7207
+ readonly logs?: boolean;
7208
+ /**
7209
+ * `--build-exclude` — names of asset bundlers/build steps to skip. Repeats
7210
+ * one `--build-exclude` flag per entry.
7211
+ */
7212
+ readonly buildExclude?: Array<string>;
7213
+ /**
7214
+ * `--notification-arns` — SNS topic ARNs to notify on stack events. Repeats
7215
+ * one `--notification-arns` flag per entry.
7216
+ */
7217
+ readonly notificationArns?: Array<string>;
7218
+ /**
7219
+ * `--tags` — tags to apply to all stack resources. Repeats one `--tags` flag
7220
+ * per `KEY=VALUE` entry.
7221
+ *
7222
+ * @deprecated Tag declarations belong in the cloud assembly via
7223
+ * `Tags.of(scope).add(...)` rather than the CLI. The flag is modelled for
7224
+ * completeness, but consumers should prefer in-stack tagging.
7225
+ */
7226
+ readonly tags?: Record<string, string>;
7227
+ /**
7228
+ * `--progress` — progress reporting style.
7229
+ */
7230
+ readonly progress?: CdkProgress;
7231
+ /**
7232
+ * `--ignore-no-stacks` — succeed (with a warning) when no stacks match the
7233
+ * supplied pattern.
7234
+ */
7235
+ readonly ignoreNoStacks?: boolean;
7236
+ /**
7237
+ * `--import-existing-resources` — generate a change set that imports
7238
+ * existing AWS resources into the stack.
7239
+ */
7240
+ readonly importExistingResources?: boolean;
7241
+ /**
7242
+ * `--revert-drift` — revert any drift detected on the target stacks before
7243
+ * applying the new deployment.
7244
+ */
7245
+ readonly revertDrift?: boolean;
7246
+ /**
7247
+ * `--execute` — execute the prepared change set immediately.
7248
+ *
7249
+ * @deprecated Replaced by `--method=prepare-change-set` and
7250
+ * `--method=execute-change-set`. Surfaced here only for completeness.
7251
+ */
7252
+ readonly execute?: boolean;
7253
+ }
7254
+ /**
7255
+ * Options for the `cdk synth` command.
7256
+ */
7257
+ interface CdkSynthOptions extends CdkGlobalOptions {
7258
+ /*****************************************************************************
7259
+ *
7260
+ * Synth-specific flags
7261
+ *
7262
+ ****************************************************************************/
7263
+ /**
7264
+ * `--exclusively` — synthesize only the requested stacks; do not include
7265
+ * dependencies.
7266
+ */
7267
+ readonly exclusively?: boolean;
7268
+ /**
7269
+ * `--quiet` (`-q`) — suppress the template output on stdout.
7270
+ */
7271
+ readonly quiet?: boolean;
7272
+ /**
7273
+ * `--validation` — run additional cloud-assembly validation.
7274
+ */
7275
+ readonly validation?: boolean;
7276
+ }
7277
+ /**
7278
+ * Options for the `cdk watch` command.
7279
+ */
7280
+ interface CdkWatchOptions extends CdkGlobalOptions {
7281
+ /*****************************************************************************
7282
+ *
7283
+ * Watch-specific flags
7284
+ *
7285
+ ****************************************************************************/
7286
+ /**
7287
+ * `--build-exclude` — names of asset bundlers/build steps to skip. Repeats
7288
+ * one `--build-exclude` flag per entry.
7289
+ */
7290
+ readonly buildExclude?: Array<string>;
7291
+ /**
7292
+ * `--change-set-name` — name of the change set to create/execute.
7293
+ */
7294
+ readonly changeSetName?: string;
7295
+ /**
7296
+ * `--concurrency` — number of stacks to deploy in parallel.
7297
+ */
7298
+ readonly concurrency?: number;
7299
+ /**
7300
+ * `--exclusively` — deploy only the requested stacks; do not include
7301
+ * dependencies.
7302
+ */
7303
+ readonly exclusively?: boolean;
7304
+ /**
7305
+ * `--force` — always deploy even if no changes are detected.
7306
+ */
7307
+ readonly force?: boolean;
7308
+ /**
7309
+ * `--hotswap` — apply changes directly to running resources without going
7310
+ * through CloudFormation when possible. The CLI default for `cdk watch` is
7311
+ * `true`; supply `false` to disable.
7312
+ */
7313
+ readonly hotswap?: boolean;
7314
+ /**
7315
+ * `--hotswap-fallback` — fall back to a full CloudFormation deployment when
7316
+ * a hotswap is not possible.
7317
+ */
7318
+ readonly hotswapFallback?: boolean;
7319
+ /**
7320
+ * `--logs` — stream CloudWatch logs for resources updated by the deploy.
7321
+ */
7322
+ readonly logs?: boolean;
7323
+ /**
7324
+ * `--progress` — progress reporting style.
7325
+ */
7326
+ readonly progress?: CdkProgress;
7327
+ /**
7328
+ * `--rollback` / `--no-rollback` — roll back the stack on failure.
7329
+ *
7330
+ * Tri-state: `true` enables rollback, `false` disables it (useful in dev for
7331
+ * fast iteration), `undefined` defers to the CLI default.
7332
+ */
7333
+ readonly rollback?: boolean;
7334
+ /**
7335
+ * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
7336
+ * environment bootstrap.
7337
+ */
7338
+ readonly toolkitStackName?: string;
7339
+ }
7340
+ /**
7341
+ * Options for the `cdk destroy` command.
7342
+ */
7343
+ interface CdkDestroyOptions extends CdkGlobalOptions {
7344
+ /*****************************************************************************
7345
+ *
7346
+ * Destroy-specific flags
7347
+ *
7348
+ ****************************************************************************/
7349
+ /**
7350
+ * `--all` — destroy all stacks in the application.
7351
+ */
7352
+ readonly all?: boolean;
7353
+ /**
7354
+ * `--concurrency` — number of stacks to destroy in parallel.
7355
+ */
7356
+ readonly concurrency?: number;
7357
+ /**
7358
+ * `--exclusively` — destroy only the requested stacks; do not include
7359
+ * dependencies.
7360
+ */
7361
+ readonly exclusively?: boolean;
7362
+ /**
7363
+ * `--force` — skip the confirmation prompt before destroying.
7364
+ */
7365
+ readonly force?: boolean;
7366
+ }
7367
+ /**
7368
+ * Options for the `cdk diff` command.
7369
+ */
7370
+ interface CdkDiffOptions extends CdkGlobalOptions {
7371
+ /*****************************************************************************
7372
+ *
7373
+ * Diff-specific flags
7374
+ *
7375
+ ****************************************************************************/
7376
+ /**
7377
+ * `--change-set` — use a CloudFormation change set to compute the diff.
7378
+ *
7379
+ * @deprecated Prefer the `--method` flag (e.g. `--method=change-set`).
7380
+ */
7381
+ readonly changeSet?: boolean;
7382
+ /**
7383
+ * `--context-lines` — number of context lines to print around each change.
7384
+ */
7385
+ readonly contextLines?: number;
7386
+ /**
7387
+ * `--exclusively` — diff only the requested stacks; do not include
7388
+ * dependencies.
7389
+ */
7390
+ readonly exclusively?: boolean;
7391
+ /**
7392
+ * `--fail` — fail with a non-zero exit code when differences are detected.
7393
+ */
7394
+ readonly fail?: boolean;
7395
+ /**
7396
+ * `--method` — how the diff is computed.
7397
+ */
7398
+ readonly method?: CdkDiffMethod;
7399
+ /**
7400
+ * `--processed` — compare against the processed (CDK-augmented) template
7401
+ * rather than the raw user input.
7402
+ */
7403
+ readonly processed?: boolean;
7404
+ /**
7405
+ * `--quiet` — suppress unchanged-resource output.
7406
+ */
7407
+ readonly quiet?: boolean;
7408
+ /**
7409
+ * `--security-only` — restrict the diff to security-relevant changes only.
7410
+ */
7411
+ readonly securityOnly?: boolean;
7412
+ /**
7413
+ * `--template` — diff against a specific template file path.
7414
+ */
7415
+ readonly template?: string;
7416
+ }
7417
+ /**
7418
+ * Options for the `cdk bootstrap` command.
7419
+ */
7420
+ interface CdkBootstrapOptions extends CdkGlobalOptions {
7421
+ /*****************************************************************************
7422
+ *
7423
+ * Bootstrap-specific flags
7424
+ *
7425
+ ****************************************************************************/
7426
+ /**
7427
+ * `--bootstrap-bucket-name` / `--toolkit-bucket-name` — name of the S3
7428
+ * bucket used by the bootstrap stack to stage assets.
7429
+ */
7430
+ readonly bootstrapBucketName?: string;
7431
+ /**
7432
+ * `--bootstrap-customer-key` — opt into a customer-managed KMS key for the
7433
+ * bootstrap bucket (creates the key as part of bootstrap).
7434
+ */
7435
+ readonly bootstrapCustomerKey?: boolean;
7436
+ /**
7437
+ * `--bootstrap-kms-key-id` — supply an existing KMS key ID for the
7438
+ * bootstrap bucket.
7439
+ */
7440
+ readonly bootstrapKmsKeyId?: string;
7441
+ /**
7442
+ * `--cloudformation-execution-policies` — managed-policy ARNs to attach to
7443
+ * the CloudFormation execution role. Repeats one
7444
+ * `--cloudformation-execution-policies` flag per entry.
7445
+ */
7446
+ readonly cloudformationExecutionPolicies?: Array<string>;
7447
+ /**
7448
+ * `--custom-permissions-boundary` — name of an IAM permissions boundary to
7449
+ * attach to the bootstrap roles.
7450
+ */
7451
+ readonly customPermissionsBoundary?: string;
7452
+ /**
7453
+ * `--example-permissions-boundary` — install the example permissions
7454
+ * boundary shipped with the CDK.
7455
+ */
7456
+ readonly examplePermissionsBoundary?: boolean;
7457
+ /**
7458
+ * `--execute` — execute the bootstrap change set immediately.
7459
+ */
7460
+ readonly execute?: boolean;
7461
+ /**
7462
+ * `--force` — force re-bootstrap even when the bootstrap stack is current.
7463
+ */
7464
+ readonly force?: boolean;
7465
+ /**
7466
+ * `--previous-parameters` — use previous parameter values for any parameters
7467
+ * not explicitly supplied.
7468
+ */
7469
+ readonly previousParameters?: boolean;
7470
+ /**
7471
+ * `--public-access-block-configuration` — enable S3 public access block on
7472
+ * the bootstrap bucket.
7473
+ */
7474
+ readonly publicAccessBlockConfiguration?: boolean;
7475
+ /**
7476
+ * `--qualifier` — qualifier appended to bootstrap resource names so multiple
7477
+ * bootstraps can coexist in the same account/region.
7478
+ */
7479
+ readonly qualifier?: string;
7480
+ /**
7481
+ * `--show-template` — emit the bootstrap template to stdout instead of
7482
+ * deploying it.
7483
+ */
7484
+ readonly showTemplate?: boolean;
7485
+ /**
7486
+ * `--tags` — tags to apply to the bootstrap stack. Repeats one `--tags`
7487
+ * flag per `KEY=VALUE` entry.
7488
+ */
7489
+ readonly tags?: Record<string, string>;
7490
+ /**
7491
+ * `--template` — bootstrap from a custom template file path.
7492
+ */
7493
+ readonly template?: string;
7494
+ /**
7495
+ * `--termination-protection` — enable CloudFormation termination protection
7496
+ * on the bootstrap stack.
7497
+ */
7498
+ readonly terminationProtection?: boolean;
7499
+ /**
7500
+ * `--toolkit-stack-name` — name of the CDK toolkit (bootstrap) stack.
7501
+ */
7502
+ readonly toolkitStackName?: string;
7503
+ /**
7504
+ * `--trust` — AWS account IDs trusted to deploy into this bootstrap
7505
+ * environment. Repeats one `--trust` flag per entry.
7506
+ */
7507
+ readonly trust?: Array<string>;
7508
+ /**
7509
+ * `--trust-for-lookup` — AWS account IDs trusted to perform context lookups
7510
+ * against this bootstrap environment. Repeats one `--trust-for-lookup` flag
7511
+ * per entry.
7512
+ */
7513
+ readonly trustForLookup?: Array<string>;
7514
+ }
7515
+ /**
7516
+ * Options for the `cdk list` / `cdk ls` command.
7517
+ */
7518
+ interface CdkListOptions extends CdkGlobalOptions {
7519
+ /*****************************************************************************
7520
+ *
7521
+ * List-specific flags
7522
+ *
7523
+ ****************************************************************************/
7524
+ /**
7525
+ * `--long` — include extra columns (account, region, etc.) in the listing.
7526
+ */
7527
+ readonly long?: boolean;
7528
+ /**
7529
+ * `--show-dependencies` — emit each stack's inter-stack dependencies.
7530
+ */
7531
+ readonly showDependencies?: boolean;
7532
+ }
7533
+ /**
7534
+ * Options for the `cdk rollback` command.
7535
+ */
7536
+ interface CdkRollbackOptions extends CdkGlobalOptions {
7537
+ /*****************************************************************************
7538
+ *
7539
+ * Rollback-specific flags
7540
+ *
7541
+ ****************************************************************************/
7542
+ /**
7543
+ * `--all` — roll back every stack in the application.
7544
+ */
7545
+ readonly all?: boolean;
7546
+ /**
7547
+ * `--force` — force the rollback even when CloudFormation reports the stack
7548
+ * is already in a stable state.
7549
+ */
7550
+ readonly force?: boolean;
7551
+ /**
7552
+ * `--orphan` — logical IDs of resources to orphan (skip) during rollback.
7553
+ * Repeats one `--orphan` flag per entry.
7554
+ */
7555
+ readonly orphan?: Array<string>;
7556
+ /**
7557
+ * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
7558
+ * environment bootstrap.
7559
+ */
7560
+ readonly toolkitStackName?: string;
7561
+ /**
7562
+ * `--validate-bootstrap-version` — require the bootstrap stack version on
7563
+ * the target environment to match the version the CLI was built against.
7564
+ */
7565
+ readonly validateBootstrapVersion?: boolean;
7566
+ }
7567
+ /**
7568
+ * Options for the `cdk import` command.
7569
+ */
7570
+ interface CdkImportOptions extends CdkGlobalOptions {
7571
+ /*****************************************************************************
7572
+ *
7573
+ * Import-specific flags
7574
+ *
7575
+ ****************************************************************************/
7576
+ /**
7577
+ * `--change-set-name` — name of the import change set to create/execute.
7578
+ */
7579
+ readonly changeSetName?: string;
7580
+ /**
7581
+ * `--execute` — execute the prepared import change set immediately.
7582
+ */
7583
+ readonly execute?: boolean;
7584
+ /**
7585
+ * `--force` — proceed with the import even when CloudFormation warnings
7586
+ * would normally block it.
7587
+ */
7588
+ readonly force?: boolean;
7589
+ /**
7590
+ * `--record-resource-mapping` — write the resolved logical-id → physical-id
7591
+ * mapping to the given path for later reuse.
7592
+ */
7593
+ readonly recordResourceMapping?: string;
7594
+ /**
7595
+ * `--resource-mapping` — read the logical-id → physical-id mapping from the
7596
+ * given path instead of prompting interactively.
7597
+ */
7598
+ readonly resourceMapping?: string;
7599
+ /**
7600
+ * `--rollback` / `--no-rollback` — roll back the stack on failure.
7601
+ *
7602
+ * Tri-state: `true` enables rollback, `false` disables it, `undefined`
7603
+ * defers to the CLI default.
7604
+ */
7605
+ readonly rollback?: boolean;
7606
+ /**
7607
+ * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
7608
+ * environment bootstrap.
7609
+ */
7610
+ readonly toolkitStackName?: string;
7611
+ }
7612
+ /**
7613
+ * Options for the `cdk gc` command.
7614
+ *
7615
+ * `cdk gc` is gated behind the global `--unstable=gc` flag. Callers MUST
7616
+ * include `"gc"` in {@link CdkGlobalOptions.unstable} (modelled on this
7617
+ * interface as the inherited `unstable` field) for the CLI to accept the
7618
+ * command; the renderer surfaces `unstable` as a regular global flag and does
7619
+ * not validate the gate itself.
7620
+ */
7621
+ interface CdkGcOptions extends CdkGlobalOptions {
7622
+ /*****************************************************************************
7623
+ *
7624
+ * GC-specific flags
7625
+ *
7626
+ ****************************************************************************/
7627
+ /**
7628
+ * `--action` — which garbage-collection action to perform.
7629
+ */
7630
+ readonly action?: CdkGcAction;
7631
+ /**
7632
+ * `--bootstrap-stack-name` — name of the bootstrap stack whose assets are
7633
+ * being garbage collected.
7634
+ */
7635
+ readonly bootstrapStackName?: string;
7636
+ /**
7637
+ * `--confirm` / `--no-confirm` — prompt before deleting tagged assets.
7638
+ */
7639
+ readonly confirm?: boolean;
7640
+ /**
7641
+ * `--created-buffer-days` — only consider assets created more than N days
7642
+ * ago for tagging.
7643
+ */
7644
+ readonly createdBufferDays?: number;
7645
+ /**
7646
+ * `--rollback-buffer-days` — keep tagged assets for at least N days before
7647
+ * deleting them so a rollback can recover them.
7648
+ */
7649
+ readonly rollbackBufferDays?: number;
7650
+ /**
7651
+ * `--type` — restrict garbage collection to a particular asset type.
7652
+ */
7653
+ readonly type?: CdkGcType;
7654
+ }
7655
+ /**
7656
+ * Options for the `cdk drift` command.
7657
+ */
7658
+ interface CdkDriftOptions extends CdkGlobalOptions {
7659
+ /*****************************************************************************
7660
+ *
7661
+ * Drift-specific flags
7662
+ *
7663
+ ****************************************************************************/
7664
+ /**
7665
+ * `--fail` — exit with a non-zero status when drift is detected.
7666
+ */
7667
+ readonly fail?: boolean;
7668
+ }
7669
+ /**
7670
+ * Options for the `cdk refactor` command.
7671
+ */
7672
+ interface CdkRefactorOptions extends CdkGlobalOptions {
7673
+ /*****************************************************************************
7674
+ *
7675
+ * Refactor-specific flags
7676
+ *
7677
+ ****************************************************************************/
7678
+ /**
7679
+ * `--additional-stack-name` — additional stack names to include in the
7680
+ * refactor scope. Repeats one `--additional-stack-name` flag per entry.
7681
+ */
7682
+ readonly additionalStackName?: Array<string>;
7683
+ /**
7684
+ * `--dry-run` — preview the refactor plan without applying it.
7685
+ */
7686
+ readonly dryRun?: boolean;
7687
+ /**
7688
+ * `--override-file` — path to a refactor override file that pins specific
7689
+ * resource moves.
7690
+ */
7691
+ readonly overrideFile?: string;
7692
+ /**
7693
+ * `--revert` — apply the inverse of the refactor (undo a previous refactor
7694
+ * plan).
7695
+ */
7696
+ readonly revert?: boolean;
7697
+ /**
7698
+ * `--force` — proceed even when the refactor planner would normally bail
7699
+ * out.
7700
+ */
7701
+ readonly force?: boolean;
7702
+ }
7703
+ /**
7704
+ * Options for the `cdk publish-assets` command.
7705
+ */
7706
+ interface CdkPublishAssetsOptions extends CdkGlobalOptions {
7707
+ /*****************************************************************************
7708
+ *
7709
+ * Publish-assets-specific flags
7710
+ *
7711
+ ****************************************************************************/
7712
+ /**
7713
+ * `--all` — publish assets for every stack in the application.
7714
+ */
7715
+ readonly all?: boolean;
7716
+ /**
7717
+ * `--exclusively` — publish only the requested stacks' assets; do not
7718
+ * include dependencies.
7719
+ */
7720
+ readonly exclusively?: boolean;
7721
+ /**
7722
+ * `--force` — re-upload assets even when the target already has them.
7723
+ */
7724
+ readonly force?: boolean;
7725
+ /**
7726
+ * `--concurrency` — number of asset uploads to run in parallel.
7727
+ */
7728
+ readonly concurrency?: number;
7729
+ }
7730
+ /**
7731
+ * Options for the `cdk orphan` command.
7732
+ *
7733
+ * `cdk orphan` takes only positional `<logicalId>` arguments — there are no
7734
+ * command-specific flags beyond the inherited globals.
7735
+ */
7736
+ interface CdkOrphanOptions extends CdkGlobalOptions {
7737
+ /*****************************************************************************
7738
+ *
7739
+ * Orphan-specific positional arguments
7740
+ *
7741
+ ****************************************************************************/
7742
+ /**
7743
+ * Logical resource IDs to orphan. Rendered as quoted, space-separated
7744
+ * positional arguments after the command name.
7745
+ */
7746
+ readonly logicalIds?: Array<string>;
7747
+ }
7748
+ /**
7749
+ * Options for the `cdk init` command.
7750
+ *
7751
+ * `cdk init` accepts a positional `<template>` argument and the
7752
+ * `--language` flag. Both are typed via the {@link CdkInitTemplate} and
7753
+ * {@link CdkInitLanguage} enums.
7754
+ */
7755
+ interface CdkInitOptions extends CdkGlobalOptions {
7756
+ /*****************************************************************************
7757
+ *
7758
+ * Init-specific positional arguments
7759
+ *
7760
+ ****************************************************************************/
7761
+ /**
7762
+ * Positional `<template>` argument — `app`, `lib`, or `sample-app`.
7763
+ * Rendered after the command name and any command-specific flags, before
7764
+ * the trailing tokens.
7765
+ */
7766
+ readonly template?: CdkInitTemplate;
7767
+ /*****************************************************************************
7768
+ *
7769
+ * Init-specific flags
7770
+ *
7771
+ ****************************************************************************/
7772
+ /**
7773
+ * `--language` — language to scaffold the new CDK project in.
7774
+ */
7775
+ readonly language?: CdkInitLanguage;
7776
+ /**
7777
+ * `--list` — print the available templates and exit instead of
7778
+ * scaffolding.
7779
+ */
7780
+ readonly list?: boolean;
7781
+ /**
7782
+ * `--generate-only` — generate the project files without performing
7783
+ * post-scaffold steps (e.g. `git init`, dependency install).
7784
+ */
7785
+ readonly generateOnly?: boolean;
7786
+ }
7787
+ /**
7788
+ * Options for the `cdk migrate` command.
7789
+ */
7790
+ interface CdkMigrateOptions extends CdkGlobalOptions {
7791
+ /*****************************************************************************
7792
+ *
7793
+ * Migrate-specific flags
7794
+ *
7795
+ ****************************************************************************/
7796
+ /**
7797
+ * `--stack-name` — name of the CDK stack created from the migrated
7798
+ * resources.
7799
+ */
7800
+ readonly stackName?: string;
7801
+ /**
7802
+ * `--language` — language to generate the migrated CDK app in. Reuses the
7803
+ * same enum as `cdk init`.
7804
+ */
7805
+ readonly language?: CdkInitLanguage;
7806
+ /**
7807
+ * `--account` — AWS account ID hosting the source resources.
7808
+ */
7809
+ readonly account?: string;
7810
+ /**
7811
+ * `--region` — AWS region hosting the source resources.
7812
+ */
7813
+ readonly region?: string;
7814
+ /**
7815
+ * `--from-path` — path to a CloudFormation template file to migrate from.
7816
+ */
7817
+ readonly fromPath?: string;
7818
+ /**
7819
+ * `--from-stack` — migrate from an existing CloudFormation stack by name.
7820
+ */
7821
+ readonly fromStack?: boolean;
7822
+ /**
7823
+ * `--from-scan` — migrate by initiating a CloudFormation resource scan.
7824
+ */
7825
+ readonly fromScan?: boolean;
7826
+ /**
7827
+ * `--output-path` — directory to write the generated CDK app into.
7828
+ */
7829
+ readonly outputPath?: string;
7830
+ /**
7831
+ * `--filter` — resource filter expressions that narrow which resources
7832
+ * are included in the migration. Repeats one `--filter` flag per entry.
7833
+ */
7834
+ readonly filter?: Array<string>;
7835
+ /**
7836
+ * `--compress` — compress the generated CDK app into a zip archive.
7837
+ */
7838
+ readonly compress?: boolean;
7839
+ }
7840
+ /**
7841
+ * Options for the `cdk context` command.
7842
+ */
7843
+ interface CdkContextOptions extends CdkGlobalOptions {
7844
+ /*****************************************************************************
7845
+ *
7846
+ * Context-specific flags
7847
+ *
7848
+ ****************************************************************************/
7849
+ /**
7850
+ * `--clear` — clear all cached context values.
7851
+ */
7852
+ readonly clear?: boolean;
7853
+ /**
7854
+ * `--force` — perform context operations without prompting.
7855
+ */
7856
+ readonly force?: boolean;
7857
+ /**
7858
+ * `--reset=KEY` — clear a single cached context value by key. The CLI's
7859
+ * `--reset` flag is value-taking (it accepts the context key to reset),
7860
+ * so this field is typed as `string | undefined` rather than as a
7861
+ * tri-state boolean.
7862
+ */
7863
+ readonly reset?: string;
7864
+ }
7865
+ /**
7866
+ * Options for the `cdk metadata` command.
7867
+ *
7868
+ * `cdk metadata` takes a single positional `<stack>` argument and has no
7869
+ * command-specific flags beyond the inherited globals.
7870
+ */
7871
+ interface CdkMetadataOptions extends CdkGlobalOptions {
7872
+ /*****************************************************************************
7873
+ *
7874
+ * Metadata-specific positional arguments
7875
+ *
7876
+ ****************************************************************************/
7877
+ /**
7878
+ * Positional `<stack>` argument naming the stack whose metadata to print.
7879
+ * Rendered after the command name and any command-specific flags, before
7880
+ * the trailing tokens.
7881
+ */
7882
+ readonly stack?: string;
7883
+ }
7884
+ /**
7885
+ * Options for the `cdk flags` command.
7886
+ */
7887
+ interface CdkFlagsOptions extends CdkGlobalOptions {
7888
+ /*****************************************************************************
7889
+ *
7890
+ * Flags-specific flags
7891
+ *
7892
+ ****************************************************************************/
7893
+ /**
7894
+ * `--value=FLAG` — print the configured value of a single feature flag.
7895
+ * The CLI's `--value` flag is value-taking, so this field is typed as
7896
+ * `string | undefined`.
7897
+ */
7898
+ readonly value?: string;
7899
+ /**
7900
+ * `--set=FLAG=VALUE` — set a feature flag to the given value. The CLI's
7901
+ * `--set` flag is value-taking, so this field is typed as
7902
+ * `string | undefined`.
7903
+ */
7904
+ readonly set?: string;
7905
+ /**
7906
+ * `--all` — include every known feature flag in the output.
7907
+ */
7908
+ readonly all?: boolean;
7909
+ /**
7910
+ * `--unconfigured` — include feature flags that have not been configured
7911
+ * yet.
7912
+ */
7913
+ readonly unconfigured?: boolean;
7914
+ /**
7915
+ * `--recommended` — set feature flags to their recommended values.
7916
+ */
7917
+ readonly recommended?: boolean;
7918
+ /**
7919
+ * `--default` — set feature flags to their default values.
7920
+ */
7921
+ readonly default?: boolean;
7922
+ /**
7923
+ * `--interactive` — prompt interactively to confirm each flag change.
7924
+ */
7925
+ readonly interactive?: boolean;
7926
+ /**
7927
+ * `--safe` — only apply changes that are safe (no resource replacement,
7928
+ * no destructive updates).
7929
+ */
7930
+ readonly safe?: boolean;
7931
+ /**
7932
+ * `--concurrency` — number of concurrent operations to run when applying
7933
+ * flag changes.
7934
+ */
7935
+ readonly concurrency?: number;
7936
+ }
7937
+ /**
7938
+ * Options for the `cdk acknowledge` (`ack`) command.
7939
+ *
7940
+ * `cdk acknowledge` takes a single positional `<id>` argument identifying
7941
+ * the notice to acknowledge. It has no command-specific flags beyond the
7942
+ * inherited globals.
7943
+ */
7944
+ interface CdkAcknowledgeOptions extends CdkGlobalOptions {
7945
+ /*****************************************************************************
7946
+ *
7947
+ * Acknowledge-specific positional arguments
7948
+ *
7949
+ ****************************************************************************/
7950
+ /**
7951
+ * Positional `<id>` argument — the notice ID to acknowledge. Rendered
7952
+ * after the command name and any command-specific flags, before the
7953
+ * trailing tokens.
7954
+ */
7955
+ readonly id?: string;
7956
+ }
7957
+ /**
7958
+ * Options for the `cdk notices` command.
7959
+ *
7960
+ * `cdk notices` has no command-specific flags beyond the inherited globals.
7961
+ * Surfaced as an empty interface so the renderer signature stays uniform
7962
+ * with the rest of the command surface.
7963
+ */
7964
+ interface CdkNoticesOptions extends CdkGlobalOptions {
7965
+ }
7966
+ /**
7967
+ * Options for the `cdk doctor` command.
7968
+ *
7969
+ * `cdk doctor` has no command-specific flags beyond the inherited globals.
7970
+ * Surfaced as an empty interface so the renderer signature stays uniform
7971
+ * with the rest of the command surface.
7972
+ */
7973
+ interface CdkDoctorOptions extends CdkGlobalOptions {
7974
+ }
7975
+ /**
7976
+ * Options for the `cdk docs` (`doc`) command.
7977
+ *
7978
+ * `cdk docs` has no command-specific flags beyond the inherited globals.
7979
+ * Surfaced as an empty interface so the renderer signature stays uniform
7980
+ * with the rest of the command surface.
7981
+ */
7982
+ interface CdkDocsOptions extends CdkGlobalOptions {
7983
+ }
7984
+ /**
7985
+ * Per-target / per-account override bundle for the `CdkCli` component.
7986
+ *
7987
+ * Used in two distinct positions in the override stack:
7988
+ *
7989
+ * - **Per-account** on `CdkCliOptions.accountOverrides[accountId]` —
7990
+ * applies to every {@link AwsDeploymentTarget} that resolves to the same
7991
+ * AWS account ID.
7992
+ * - **Per-target** on `AwsDeploymentTargetOptions.cdkOptions` — applies
7993
+ * only to that specific deployment target.
7994
+ *
7995
+ * Both layers slot into the precedence chain documented on {@link CdkCli};
7996
+ * per-target wins on collisions because it is the more specific layer.
7997
+ *
7998
+ * Every command field is optional so consumers can override one command
7999
+ * (e.g. just `deploy`) without restating the others.
8000
+ */
8001
+ interface CdkTargetOverrides {
8002
+ /**
8003
+ * Overrides applied to `cdk deploy` invocations against the matching
8004
+ * target / account.
8005
+ */
8006
+ readonly deploy?: Partial<CdkDeployOptions>;
8007
+ /**
8008
+ * Overrides applied to `cdk synth` invocations against the matching
8009
+ * target / account.
8010
+ */
8011
+ readonly synth?: Partial<CdkSynthOptions>;
8012
+ /**
8013
+ * Overrides applied to `cdk watch` invocations against the matching
8014
+ * target / account.
8015
+ */
8016
+ readonly watch?: Partial<CdkWatchOptions>;
8017
+ /**
8018
+ * Overrides applied to `cdk destroy` invocations against the matching
8019
+ * target / account.
8020
+ */
8021
+ readonly destroy?: Partial<CdkDestroyOptions>;
8022
+ /**
8023
+ * Overrides applied to `cdk diff` invocations against the matching
8024
+ * target / account.
8025
+ */
8026
+ readonly diff?: Partial<CdkDiffOptions>;
8027
+ /**
8028
+ * Overrides applied to `cdk bootstrap` invocations against the matching
8029
+ * target / account.
8030
+ */
8031
+ readonly bootstrap?: Partial<CdkBootstrapOptions>;
8032
+ }
8033
+
6839
8034
  /*******************************************************************************
6840
8035
  *
6841
8036
  * Git configs for this repo. This venn diagram has a great deal of overlap
@@ -6953,6 +8148,14 @@ interface AwsDeploymentTargetOptions {
6953
8148
  */
6954
8149
  readonly ciDeployment?: boolean;
6955
8150
  readonly ciDeploymentConfig?: CiDeploymentConfig;
8151
+ /**
8152
+ * Per-target overrides for `cdk` CLI options.
8153
+ *
8154
+ * Layered on top of the per-stage defaults and any per-account overrides
8155
+ * configured on {@link CdkCli}. See {@link CdkCli} for the full precedence
8156
+ * chain.
8157
+ */
8158
+ readonly cdkOptions?: CdkTargetOverrides;
6956
8159
  }
6957
8160
  declare class AwsDeploymentTarget extends Component {
6958
8161
  /**
@@ -7014,6 +8217,14 @@ declare class AwsDeploymentTarget extends Component {
7014
8217
  * Configuration for the CDK output directory for this deployment target.
7015
8218
  */
7016
8219
  awsDeploymentConfig: AwsDeploymentConfig;
8220
+ /**
8221
+ * Per-target overrides for `cdk` CLI options.
8222
+ *
8223
+ * Read by `CdkCli.*OptionsFor(target)` as the second-highest layer in the
8224
+ * precedence chain (below call-site explicit options, above per-account
8225
+ * overrides). See {@link CdkCli} for the full chain.
8226
+ */
8227
+ cdkOptions?: CdkTargetOverrides;
7017
8228
  constructor(project: AwsCdkTypeScriptApp, options: AwsDeploymentTargetOptions);
7018
8229
  /*****************************************************************************
7019
8230
  *
@@ -7034,6 +8245,197 @@ declare class AwsDeploymentTarget extends Component {
7034
8245
  private configureWatchTask;
7035
8246
  }
7036
8247
 
8248
+ /*******************************************************************************
8249
+ *
8250
+ * AWS CDK CLI Component
8251
+ *
8252
+ * Owns the per-project options that get layered into every `cdk` CLI
8253
+ * invocation the generated project makes. Phase 1 covered `cdk deploy`; Phase
8254
+ * 2 extended the component with `synth`, `watch`, `destroy`, `diff`, and
8255
+ * `bootstrap`. Phase 5 (this revision) wires in the full per-target /
8256
+ * per-account override surface and the generic {@link mergeCdkOptions} folder.
8257
+ *
8258
+ * ## Override precedence
8259
+ *
8260
+ * Each `*OptionsFor(target)` accessor folds the layers below in
8261
+ * **lowest-precedence-first** order; the rightmost (highest) layer wins on
8262
+ * scalar collisions, arrays concat-and-dedupe across layers, and record-valued
8263
+ * fields merge one level deep with the higher layer winning on key collisions.
8264
+ *
8265
+ * 1. **Per-stage built-in default** — from `CDK_*_DEFAULTS_BY_STAGE` for the
8266
+ * target's {@link AwsDeploymentTarget.awsStageType}.
8267
+ * 2. **Per-stage consumer override** — from this component's
8268
+ * `<command>Defaults[stage]` map.
8269
+ * 3. **Per-account override** — from `accountOverrides[target.account][<command>]`.
8270
+ * 4. **Per-target override** — from `target.cdkOptions.<command>`.
8271
+ * 5. **Call-site explicit option** — passed by the caller into the renderer
8272
+ * directly, after the accessor returns. The accessor does not see this
8273
+ * layer; the caller is responsible for spreading the accessor result first
8274
+ * and then the call-site option on top.
8275
+ *
8276
+ * Auto-instantiated by {@link AwsDeploymentConfig} when absent; consumers can
8277
+ * pre-instantiate it via `new CdkCli(project, options)` to register custom
8278
+ * per-stage defaults and per-account overrides.
8279
+ *
8280
+ ******************************************************************************/
8281
+ /**
8282
+ * Options accepted by {@link CdkCli}.
8283
+ */
8284
+ interface CdkCliOptions {
8285
+ /**
8286
+ * Consumer-supplied overrides for the built-in per-stage deploy defaults.
8287
+ *
8288
+ * Each entry is merged on top of
8289
+ * {@link CDK_DEPLOY_DEFAULTS_BY_STAGE} for the matching stage via
8290
+ * {@link mergeCdkOptions}.
8291
+ */
8292
+ readonly deployDefaults?: Partial<Record<AwsStageType, Partial<CdkDeployOptions>>>;
8293
+ /**
8294
+ * Consumer-supplied overrides for the built-in per-stage synth defaults.
8295
+ *
8296
+ * Each entry is merged on top of
8297
+ * {@link CDK_SYNTH_DEFAULTS_BY_STAGE} for the matching stage via
8298
+ * {@link mergeCdkOptions}.
8299
+ */
8300
+ readonly synthDefaults?: Partial<Record<AwsStageType, Partial<CdkSynthOptions>>>;
8301
+ /**
8302
+ * Consumer-supplied overrides for the built-in per-stage watch defaults.
8303
+ *
8304
+ * Each entry is merged on top of
8305
+ * {@link CDK_WATCH_DEFAULTS_BY_STAGE} for the matching stage via
8306
+ * {@link mergeCdkOptions}.
8307
+ */
8308
+ readonly watchDefaults?: Partial<Record<AwsStageType, Partial<CdkWatchOptions>>>;
8309
+ /**
8310
+ * Consumer-supplied overrides for the built-in per-stage destroy defaults.
8311
+ *
8312
+ * Each entry is merged on top of
8313
+ * {@link CDK_DESTROY_DEFAULTS_BY_STAGE} for the matching stage via
8314
+ * {@link mergeCdkOptions}.
8315
+ */
8316
+ readonly destroyDefaults?: Partial<Record<AwsStageType, Partial<CdkDestroyOptions>>>;
8317
+ /**
8318
+ * Consumer-supplied overrides for the built-in per-stage diff defaults.
8319
+ *
8320
+ * Each entry is merged on top of
8321
+ * {@link CDK_DIFF_DEFAULTS_BY_STAGE} for the matching stage via
8322
+ * {@link mergeCdkOptions}.
8323
+ */
8324
+ readonly diffDefaults?: Partial<Record<AwsStageType, Partial<CdkDiffOptions>>>;
8325
+ /**
8326
+ * Consumer-supplied overrides for the built-in per-stage bootstrap defaults.
8327
+ *
8328
+ * Each entry is merged on top of
8329
+ * {@link CDK_BOOTSTRAP_DEFAULTS_BY_STAGE} for the matching stage via
8330
+ * {@link mergeCdkOptions}.
8331
+ */
8332
+ readonly bootstrapDefaults?: Partial<Record<AwsStageType, Partial<CdkBootstrapOptions>>>;
8333
+ /**
8334
+ * Per-account overrides keyed by AWS account ID.
8335
+ *
8336
+ * Each value is a {@link CdkTargetOverrides} bundle that applies to every
8337
+ * {@link AwsDeploymentTarget} whose `account` matches the key. Sits in the
8338
+ * precedence chain between per-stage overrides and per-target overrides —
8339
+ * see {@link CdkCli} for the full layer order.
8340
+ *
8341
+ * Example: pin `--no-rollback` on every deploy into a sandbox account
8342
+ * regardless of the target's stage:
8343
+ *
8344
+ * ```typescript
8345
+ * new CdkCli(project, {
8346
+ * accountOverrides: {
8347
+ * "111122223333": { deploy: { rollback: false } },
8348
+ * },
8349
+ * });
8350
+ * ```
8351
+ */
8352
+ readonly accountOverrides?: Record<string, CdkTargetOverrides>;
8353
+ }
8354
+ declare class CdkCli extends Component {
8355
+ /**
8356
+ * Find the {@link CdkCli} component already attached to the project, if any.
8357
+ */
8358
+ static of(project: AwsCdkTypeScriptApp): CdkCli | undefined;
8359
+ /**
8360
+ * The consumer-supplied per-stage deploy default overrides.
8361
+ */
8362
+ readonly deployDefaults: Partial<Record<AwsStageType, Partial<CdkDeployOptions>>>;
8363
+ /**
8364
+ * The consumer-supplied per-stage synth default overrides.
8365
+ */
8366
+ readonly synthDefaults: Partial<Record<AwsStageType, Partial<CdkSynthOptions>>>;
8367
+ /**
8368
+ * The consumer-supplied per-stage watch default overrides.
8369
+ */
8370
+ readonly watchDefaults: Partial<Record<AwsStageType, Partial<CdkWatchOptions>>>;
8371
+ /**
8372
+ * The consumer-supplied per-stage destroy default overrides.
8373
+ */
8374
+ readonly destroyDefaults: Partial<Record<AwsStageType, Partial<CdkDestroyOptions>>>;
8375
+ /**
8376
+ * The consumer-supplied per-stage diff default overrides.
8377
+ */
8378
+ readonly diffDefaults: Partial<Record<AwsStageType, Partial<CdkDiffOptions>>>;
8379
+ /**
8380
+ * The consumer-supplied per-stage bootstrap default overrides.
8381
+ */
8382
+ readonly bootstrapDefaults: Partial<Record<AwsStageType, Partial<CdkBootstrapOptions>>>;
8383
+ /**
8384
+ * The consumer-supplied per-account overrides, keyed by AWS account ID.
8385
+ */
8386
+ readonly accountOverrides: Record<string, CdkTargetOverrides>;
8387
+ constructor(project: AwsCdkTypeScriptApp, options?: CdkCliOptions);
8388
+ /**
8389
+ * Resolve the `cdk deploy` options to use against a given target.
8390
+ *
8391
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8392
+ * → per-stage consumer override → per-account override → per-target
8393
+ * override. The call-site explicit layer is applied by the caller after
8394
+ * this method returns. See {@link CdkCli} for the full chain.
8395
+ */
8396
+ deployOptionsFor(target: AwsDeploymentTarget): CdkDeployOptions;
8397
+ /**
8398
+ * Resolve the `cdk synth` options to use against a given target.
8399
+ *
8400
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8401
+ * → per-stage consumer override → per-account override → per-target
8402
+ * override. See {@link CdkCli} for the full chain.
8403
+ */
8404
+ synthOptionsFor(target: AwsDeploymentTarget): CdkSynthOptions;
8405
+ /**
8406
+ * Resolve the `cdk watch` options to use against a given target.
8407
+ *
8408
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8409
+ * → per-stage consumer override → per-account override → per-target
8410
+ * override. See {@link CdkCli} for the full chain.
8411
+ */
8412
+ watchOptionsFor(target: AwsDeploymentTarget): CdkWatchOptions;
8413
+ /**
8414
+ * Resolve the `cdk destroy` options to use against a given target.
8415
+ *
8416
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8417
+ * → per-stage consumer override → per-account override → per-target
8418
+ * override. See {@link CdkCli} for the full chain.
8419
+ */
8420
+ destroyOptionsFor(target: AwsDeploymentTarget): CdkDestroyOptions;
8421
+ /**
8422
+ * Resolve the `cdk diff` options to use against a given target.
8423
+ *
8424
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8425
+ * → per-stage consumer override → per-account override → per-target
8426
+ * override. See {@link CdkCli} for the full chain.
8427
+ */
8428
+ diffOptionsFor(target: AwsDeploymentTarget): CdkDiffOptions;
8429
+ /**
8430
+ * Resolve the `cdk bootstrap` options to use against a given target.
8431
+ *
8432
+ * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
8433
+ * → per-stage consumer override → per-account override → per-target
8434
+ * override. See {@link CdkCli} for the full chain.
8435
+ */
8436
+ bootstrapOptionsFor(target: AwsDeploymentTarget): CdkBootstrapOptions;
8437
+ }
8438
+
7037
8439
  /*******************************************************************************
7038
8440
  *
7039
8441
  * AWS Deployment Configuration
@@ -7070,6 +8472,11 @@ declare class AwsDeploymentConfig extends Component {
7070
8472
  * Array of targets for deployment.
7071
8473
  */
7072
8474
  readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
8475
+ /**
8476
+ * The CDK CLI component that owns shared `cdk` invocation options for this
8477
+ * project.
8478
+ */
8479
+ readonly cdkCli: CdkCli;
7073
8480
  constructor(project: AwsCdkTypeScriptApp);
7074
8481
  /*****************************************************************************
7075
8482
  *
@@ -7174,6 +8581,226 @@ interface AwsOrganization {
7174
8581
  accounts: Array<AwsAccount>;
7175
8582
  }
7176
8583
 
8584
+ /*******************************************************************************
8585
+ *
8586
+ * AWS CDK CLI Defaults
8587
+ *
8588
+ * Per-stage default option sets the `CdkCli` component layers in when a
8589
+ * consumer asks for the options to use against a given deployment target.
8590
+ * Phase 1 registered defaults for `cdk deploy`; Phase 2 registers defaults for
8591
+ * `synth`, `watch`, `destroy`, `diff`, and `bootstrap`.
8592
+ *
8593
+ ******************************************************************************/
8594
+ /**
8595
+ * Per-stage defaults for `cdk deploy`.
8596
+ *
8597
+ * - `dev` opts into `--no-rollback` for fast iteration.
8598
+ * - `stage` and `prod` deliberately omit `rollback` so the CLI default
8599
+ * (`true`, i.e. atomic deploys with rollback) applies — this is what allows
8600
+ * replacement-style updates to succeed in stage/prod.
8601
+ * - `prod` pins `--method=change-set` to leave a reviewable change-set trail.
8602
+ */
8603
+ declare const CDK_DEPLOY_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDeployOptions>>;
8604
+ /**
8605
+ * Per-stage defaults for `cdk synth`.
8606
+ *
8607
+ * Every stage runs synth with `--quiet` so the synthesised template stays out
8608
+ * of normal task logs.
8609
+ */
8610
+ declare const CDK_SYNTH_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkSynthOptions>>;
8611
+ /**
8612
+ * Per-stage defaults for `cdk watch`.
8613
+ *
8614
+ * Every stage uses `--progress=events` to stream CloudFormation events line by
8615
+ * line. The CLI default for `cdk watch --hotswap` is already `true`, so the
8616
+ * record leaves it unset.
8617
+ */
8618
+ declare const CDK_WATCH_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkWatchOptions>>;
8619
+ /**
8620
+ * Per-stage defaults for `cdk destroy`.
8621
+ *
8622
+ * `dev` opts into `--force` so local teardown does not prompt; `stage` and
8623
+ * `prod` deliberately omit `force` so the CLI's confirmation prompt fires.
8624
+ */
8625
+ declare const CDK_DESTROY_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDestroyOptions>>;
8626
+ /**
8627
+ * Per-stage defaults for `cdk diff`.
8628
+ *
8629
+ * Empty by default — diff has no flags whose stage-by-stage value is obvious.
8630
+ * Reserved for consumer overrides.
8631
+ */
8632
+ declare const CDK_DIFF_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDiffOptions>>;
8633
+ /**
8634
+ * Per-stage defaults for `cdk bootstrap`.
8635
+ *
8636
+ * `prod` opts into `--termination-protection` so the bootstrap stack cannot be
8637
+ * accidentally deleted; `dev` and `stage` omit it.
8638
+ */
8639
+ declare const CDK_BOOTSTRAP_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkBootstrapOptions>>;
8640
+
8641
+ /*******************************************************************************
8642
+ *
8643
+ * AWS CDK CLI Option Merge
8644
+ *
8645
+ * Generic helper that folds a precedence-ordered list of `CdkXxxOptions`
8646
+ * fragments into a single resolved option set. Used by every
8647
+ * `CdkCli.*OptionsFor(target)` accessor to assemble the documented 5-level
8648
+ * override stack (per-stage default → per-account override → per-target
8649
+ * override → consumer override → call-site explicit) without per-command merge
8650
+ * logic.
8651
+ *
8652
+ * Merge semantics (see also the `CdkCli` JSDoc):
8653
+ *
8654
+ * - **Scalars** (booleans, strings, numbers, enums): a non-`undefined` value in
8655
+ * a later (higher-precedence) layer overwrites the previous value. An
8656
+ * `undefined` value in a later layer is treated as "no opinion" and falls
8657
+ * through to whatever lower layers contributed.
8658
+ * - **Arrays**: concatenated low → high precedence, then deduplicated preserving
8659
+ * document order (first occurrence wins). This lets a per-stage default seed
8660
+ * a list and per-target/per-account layers append to it without losing the
8661
+ * seeded entries.
8662
+ * - **Records / maps** (plain object values, including `tags` and `context`
8663
+ * when modelled as `Record<string, string>`): merged one level deep; later
8664
+ * layers win on key collisions, earlier layers' keys survive otherwise.
8665
+ * - **`undefined` layers** and **`undefined` field values** short-circuit — no
8666
+ * field on the output is touched by a missing layer or a `undefined` entry.
8667
+ *
8668
+ ******************************************************************************/
8669
+ /**
8670
+ * Fold a precedence-ordered list of partial CDK CLI option layers into a
8671
+ * single resolved option set.
8672
+ *
8673
+ * Layers are supplied in **lowest-precedence-first** order. Each subsequent
8674
+ * layer's non-`undefined` values overwrite the previous accumulator for
8675
+ * scalars; arrays are concatenated and deduped; record-valued fields are
8676
+ * merged one level deep.
8677
+ *
8678
+ * `undefined` layers are skipped entirely. `undefined` field values within a
8679
+ * layer are skipped per-field — they never clobber a previously set value.
8680
+ *
8681
+ * @typeParam TOptions - The fully resolved option interface (e.g.
8682
+ * `CdkDeployOptions`). The function returns `TOptions`, but the caller is
8683
+ * responsible for ensuring every field its consumers depend on is supplied
8684
+ * by at least one layer — the helper does not validate completeness.
8685
+ */
8686
+ declare const mergeCdkOptions: <TOptions>(...layers: Array<Partial<TOptions> | undefined>) => TOptions;
8687
+
8688
+ /**
8689
+ * Render a `cdk deploy ...` command from the supplied options. Returns the
8690
+ * full command string (starting with `deploy`).
8691
+ */
8692
+ declare const renderCdkDeploy: (opts: CdkDeployOptions) => string;
8693
+ /**
8694
+ * Render a `cdk synth ...` command from the supplied options.
8695
+ */
8696
+ declare const renderCdkSynth: (opts: CdkSynthOptions) => string;
8697
+ /**
8698
+ * Render a `cdk watch ...` command from the supplied options.
8699
+ */
8700
+ declare const renderCdkWatch: (opts: CdkWatchOptions) => string;
8701
+ /**
8702
+ * Render a `cdk destroy ...` command from the supplied options.
8703
+ */
8704
+ declare const renderCdkDestroy: (opts: CdkDestroyOptions) => string;
8705
+ /**
8706
+ * Render a `cdk diff ...` command from the supplied options.
8707
+ */
8708
+ declare const renderCdkDiff: (opts: CdkDiffOptions) => string;
8709
+ /**
8710
+ * Render a `cdk bootstrap ...` command from the supplied options.
8711
+ */
8712
+ declare const renderCdkBootstrap: (opts: CdkBootstrapOptions) => string;
8713
+ /**
8714
+ * Render a `cdk list ...` command from the supplied options.
8715
+ */
8716
+ declare const renderCdkList: (opts: CdkListOptions) => string;
8717
+ /**
8718
+ * Render a `cdk rollback ...` command from the supplied options.
8719
+ */
8720
+ declare const renderCdkRollback: (opts: CdkRollbackOptions) => string;
8721
+ /**
8722
+ * Render a `cdk import ...` command from the supplied options.
8723
+ */
8724
+ declare const renderCdkImport: (opts: CdkImportOptions) => string;
8725
+ /**
8726
+ * Render a `cdk gc ...` command from the supplied options.
8727
+ *
8728
+ * The CLI requires the global `--unstable=gc` flag for this command; callers
8729
+ * are responsible for including `"gc"` in {@link CdkGlobalOptions.unstable}.
8730
+ */
8731
+ declare const renderCdkGc: (opts: CdkGcOptions) => string;
8732
+ /**
8733
+ * Render a `cdk drift ...` command from the supplied options.
8734
+ */
8735
+ declare const renderCdkDrift: (opts: CdkDriftOptions) => string;
8736
+ /**
8737
+ * Render a `cdk refactor ...` command from the supplied options.
8738
+ */
8739
+ declare const renderCdkRefactor: (opts: CdkRefactorOptions) => string;
8740
+ /**
8741
+ * Render a `cdk publish-assets ...` command from the supplied options.
8742
+ */
8743
+ declare const renderCdkPublishAssets: (opts: CdkPublishAssetsOptions) => string;
8744
+ /**
8745
+ * Render a `cdk orphan ...` command from the supplied options. Positional
8746
+ * `logicalIds` render after the command name as quoted, space-separated
8747
+ * arguments.
8748
+ */
8749
+ declare const renderCdkOrphan: (opts: CdkOrphanOptions) => string;
8750
+ /**
8751
+ * Render a `cdk init ...` command from the supplied options. The positional
8752
+ * `template` argument renders after the command-specific flags, before the
8753
+ * trailing tokens.
8754
+ */
8755
+ declare const renderCdkInit: (opts: CdkInitOptions) => string;
8756
+ /**
8757
+ * Render a `cdk migrate ...` command from the supplied options.
8758
+ */
8759
+ declare const renderCdkMigrate: (opts: CdkMigrateOptions) => string;
8760
+ /**
8761
+ * Render a `cdk context ...` command from the supplied options. The CLI's
8762
+ * `--reset` flag takes a context key as its value, so `reset` is rendered
8763
+ * as `--reset=KEY` rather than as a tri-state boolean.
8764
+ */
8765
+ declare const renderCdkContext: (opts: CdkContextOptions) => string;
8766
+ /**
8767
+ * Render a `cdk metadata ...` command from the supplied options. The
8768
+ * positional `stack` argument renders after the command-specific flags
8769
+ * (there are none beyond the inherited globals), before the trailing
8770
+ * tokens.
8771
+ */
8772
+ declare const renderCdkMetadata: (opts: CdkMetadataOptions) => string;
8773
+ /**
8774
+ * Render a `cdk flags ...` command from the supplied options. `--value` and
8775
+ * `--set` are value-taking string flags per the CLI surface; the remaining
8776
+ * flags are tri-state booleans.
8777
+ */
8778
+ declare const renderCdkFlags: (opts: CdkFlagsOptions) => string;
8779
+ /**
8780
+ * Render a `cdk acknowledge ...` command from the supplied options. The
8781
+ * positional `id` argument renders after the command-specific flags (there
8782
+ * are none beyond the inherited globals), before the trailing tokens.
8783
+ */
8784
+ declare const renderCdkAcknowledge: (opts: CdkAcknowledgeOptions) => string;
8785
+ /**
8786
+ * Render a `cdk notices ...` command from the supplied options. `notices`
8787
+ * has no command-specific flags; only the inherited globals and trailing
8788
+ * tokens contribute output.
8789
+ */
8790
+ declare const renderCdkNotices: (opts: CdkNoticesOptions) => string;
8791
+ /**
8792
+ * Render a `cdk doctor ...` command from the supplied options. `doctor` has
8793
+ * no command-specific flags; only the inherited globals and trailing tokens
8794
+ * contribute output.
8795
+ */
8796
+ declare const renderCdkDoctor: (opts: CdkDoctorOptions) => string;
8797
+ /**
8798
+ * Render a `cdk docs ...` command from the supplied options. `docs` has no
8799
+ * command-specific flags; only the inherited globals and trailing tokens
8800
+ * contribute output.
8801
+ */
8802
+ declare const renderCdkDocs: (opts: CdkDocsOptions) => string;
8803
+
7177
8804
  /**
7178
8805
  * One row in the doc reference-extraction report — describes a single
7179
8806
  * inline-code symbol mention found in a markdown page and whether
@@ -10785,6 +12412,78 @@ declare const COMPLETE_JOB_ID = "complete";
10785
12412
  */
10786
12413
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
10787
12414
 
12415
+ /**
12416
+ * Sets `with["include-hidden-files"] = true` on every build-artifact
12417
+ * `Upload artifact` step generated by projen's
12418
+ * {@code BuildWorkflow.renderBuildSteps()}.
12419
+ *
12420
+ * **Why this exists.** Projen's build workflow brackets the
12421
+ * `Upload artifact` step (for the `dist` build artifact) with a pair
12422
+ * of permission backup/restore steps:
12423
+ *
12424
+ * 1. `Backup artifact permissions` — runs
12425
+ * `cd dist && getfacl -R . > permissions-backup.acl` and captures
12426
+ * ACLs for **every** entry under `dist/`, including dotfiles
12427
+ * (`.pnpm`, `.travis.yml`, etc.).
12428
+ * 2. `Upload artifact` — uploads `dist` using `actions/upload-artifact`.
12429
+ * In `actions/upload-artifact` v4+, the default value of the
12430
+ * `include-hidden-files` input is `false`, so every hidden entry is
12431
+ * silently dropped from the artifact zip.
12432
+ * 3. `Restore build artifact permissions` (in each deploy job) — runs
12433
+ * `setfacl --restore=permissions-backup.acl`. The ACL backup
12434
+ * references hidden paths that no longer exist in the downloaded
12435
+ * artifact, so `setfacl` exits non-zero, producing a failure
12436
+ * annotation on every deploy job (`continue-on-error: true` masks
12437
+ * the job result but does not suppress the annotation).
12438
+ *
12439
+ * Setting `include-hidden-files: true` on the upload keeps the artifact
12440
+ * faithful to what `getfacl -R .` captured, eliminating the
12441
+ * `setfacl --restore` errors and preserving hidden files that CDK
12442
+ * assets legitimately depend on (e.g. the `.pnpm` store layout in a
12443
+ * bundled `node_modules/`).
12444
+ *
12445
+ * **Why this is a configulator patch instead of an upstream projen
12446
+ * change.** Projen exposed the `includeHiddenFiles` opt-in in
12447
+ * `actions/upload-artifact` via
12448
+ * [projen#3827](https://github.com/projen/projen/pull/3827) but never
12449
+ * plumbed it into its own `BuildWorkflow.renderBuildSteps()`
12450
+ * build-artifact upload. Until projen patches its own helper, this
12451
+ * helper is the downstream fix.
12452
+ *
12453
+ * **Why this is a separate helper.** Projen's BuildWorkflow stores
12454
+ * the build job's `steps` as a **lazy closure**
12455
+ * (`steps: () => this.renderBuildSteps(...)`), not an eager array, so
12456
+ * the `Upload artifact` step does not exist anywhere at
12457
+ * `preSynthesize` time. The two existing sibling helpers
12458
+ * ({@code pinPnpmActionSetup}, {@code pinSetupNodeVersion}) reach
12459
+ * lazy-closure steps by patching the component-level
12460
+ * `preBuildSteps` / `postBuildSteps` arrays the closure later
12461
+ * concatenates — that path does not work here because the build-
12462
+ * artifact upload is emitted **inside** `renderBuildSteps()` and is
12463
+ * never added to either component-level array.
12464
+ *
12465
+ * Instead, this helper wraps each job's `steps` closure: it replaces
12466
+ * the original `() => JobStep[]` with a new closure that invokes the
12467
+ * original and post-processes the rendered array to set
12468
+ * `with["include-hidden-files"] = true` on every matching step.
12469
+ * Eager (already-array) step lists are patched in place.
12470
+ *
12471
+ * **Matching rule.** A step is patched only when all three of the
12472
+ * following are true:
12473
+ *
12474
+ * - `step.name === "Upload artifact"`
12475
+ * - `step.uses` starts with `actions/upload-artifact@`
12476
+ * - `step.with.name === "build-artifact"`
12477
+ *
12478
+ * This deliberately misses other `actions/upload-artifact` steps in
12479
+ * the same workflow (e.g. the `turbo-runs` artifact, the `repo.patch`
12480
+ * self-mutation artifact) — those uploads do not source hidden files
12481
+ * and do not pair with a `setfacl --restore` restore step.
12482
+ *
12483
+ * @param project - The project whose GitHub workflows should be patched.
12484
+ */
12485
+ declare function includeHiddenFilesInBuildArtifact(project: Project): void;
12486
+
10788
12487
  /**
10789
12488
  * Rewrites every `pnpm/action-setup@vX` step `uses` field reachable from
10790
12489
  * a project's GitHub component (and its sub-projects) to the version
@@ -10861,5 +12560,5 @@ declare function pinPnpmActionSetup(project: Project): void;
10861
12560
  */
10862
12561
  declare function pinSetupNodeVersion(project: Project): void;
10863
12562
 
10864
- export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_BUNDLE_OVERRIDES, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_PRIORITY, DEFAULT_ISSUE_STATUS, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_RESOLVED_ISSUE_DEFAULTS, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TEMPORAL_FRAMING_CADENCES, DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER, DEFAULT_TEMPORAL_FRAMING_ENABLED, DEFAULT_TEMPORAL_FRAMING_PATHS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, Nvmrc, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, SampleLang, StarlightProject, TEMPORAL_FRAMING_CATEGORY_VALUES, TestRunner, TsDocCoverageKind, TsdocConfig, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addPlaywright, addStorybook, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildAgentRegistryRule, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildMeetingAnalysisBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, bundleNameForWorkflowRule, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, hasAnyDocsEmittingBundle, hasAnyDownstreamIssueKindBundle, industryDiscoveryBundle, isPhaseLabelOwnedByExcluded, isScheduledTaskOwnedByExcluded, isSuppressedWorkflowRule, isTypeLabelOwnedByExcluded, jestBundle, labelsForPhase, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pinPnpmActionSetup, pinSetupNodeVersion, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderStubIndexConventionRuleContent, renderTemporalFramingCheckerScript, renderTemporalFramingRuleContent, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueDefaults, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolveOverrideForLabels, resolveProgressFiles, resolveReactViteSiteProjectOutdir, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTemporalFraming, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, tsdocRecordToFindings, turborepoBundle, typescriptBundle, upstreamConfigulatorDocsBundle, validateAgentTierConfig, validateIssueDefaultsConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateTemporalFramingConfig, validateUnblockDependentsConfig, vitestBundle };
10865
- export type { ActivateBranchNameEnvVarOptions, AddStorybookOptions, AgentCommand, AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRegistryEntry, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffCheckOptions, ApiDiffFinding, ApiDiffResult, ApiExtractorOptions, ApiExtractorReportOptions, ApiSurfaceEntry, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, BundleOwnership, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudeMdConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, EffectiveScopeThresholds, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueDefaultsConfig, IssueDefaultsOverride, IssueDefaultsPriority, IssueDefaultsStatus, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReactViteSiteProjectOptions, ReferenceMismatchCheckOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueDefaults, ResolvedIssueDefaultsEntry, ResolvedIssueTemplates, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedScopeGateBundleOverride, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedTemporalFraming, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateBundleOverride, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TemporalFramingCategory, TemporalFramingConfig, TsDocCoverageRecord, TsdocConfigOptions, TsdocCoverageCheckOptions, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, UpstreamConfigulatorConfig, VersionKey, VitestConfigOptions, VitestOptions };
12563
+ export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, CDK_BOOTSTRAP_DEFAULTS_BY_STAGE, CDK_DEPLOY_DEFAULTS_BY_STAGE, CDK_DEPLOY_METHOD, CDK_DESTROY_DEFAULTS_BY_STAGE, CDK_DIFF_DEFAULTS_BY_STAGE, CDK_DIFF_METHOD, CDK_GC_ACTION, CDK_GC_TYPE, CDK_INIT_LANGUAGE, CDK_INIT_TEMPLATE, CDK_PROGRESS, CDK_REQUIRE_APPROVAL, CDK_SYNTH_DEFAULTS_BY_STAGE, CDK_WATCH_DEFAULTS_BY_STAGE, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, CdkCli, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_BUNDLE_OVERRIDES, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_PRIORITY, DEFAULT_ISSUE_STATUS, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_RESOLVED_ISSUE_DEFAULTS, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TEMPORAL_FRAMING_CADENCES, DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER, DEFAULT_TEMPORAL_FRAMING_ENABLED, DEFAULT_TEMPORAL_FRAMING_PATHS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, Nvmrc, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, SampleLang, StarlightProject, TEMPORAL_FRAMING_CATEGORY_VALUES, TestRunner, TsDocCoverageKind, TsdocConfig, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addPlaywright, addStorybook, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildAgentRegistryRule, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildMeetingAnalysisBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, bundleNameForWorkflowRule, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, hasAnyDocsEmittingBundle, hasAnyDownstreamIssueKindBundle, includeHiddenFilesInBuildArtifact, industryDiscoveryBundle, isPhaseLabelOwnedByExcluded, isScheduledTaskOwnedByExcluded, isSuppressedWorkflowRule, isTypeLabelOwnedByExcluded, jestBundle, labelsForPhase, maintenanceAuditBundle, meetingAnalysisBundle, mergeCdkOptions, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pinPnpmActionSetup, pinSetupNodeVersion, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCdkAcknowledge, renderCdkBootstrap, renderCdkContext, renderCdkDeploy, renderCdkDestroy, renderCdkDiff, renderCdkDocs, renderCdkDoctor, renderCdkDrift, renderCdkFlags, renderCdkGc, renderCdkImport, renderCdkInit, renderCdkList, renderCdkMetadata, renderCdkMigrate, renderCdkNotices, renderCdkOrphan, renderCdkPublishAssets, renderCdkRefactor, renderCdkRollback, renderCdkSynth, renderCdkWatch, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderStubIndexConventionRuleContent, renderTemporalFramingCheckerScript, renderTemporalFramingRuleContent, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueDefaults, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolveOverrideForLabels, resolveProgressFiles, resolveReactViteSiteProjectOutdir, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTemporalFraming, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, tsdocRecordToFindings, turborepoBundle, typescriptBundle, upstreamConfigulatorDocsBundle, validateAgentTierConfig, validateIssueDefaultsConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateTemporalFramingConfig, validateUnblockDependentsConfig, vitestBundle };
12564
+ export type { ActivateBranchNameEnvVarOptions, AddStorybookOptions, AgentCommand, AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRegistryEntry, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffCheckOptions, ApiDiffFinding, ApiDiffResult, ApiExtractorOptions, ApiExtractorReportOptions, ApiSurfaceEntry, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, BundleOwnership, CdkAcknowledgeOptions, CdkBootstrapOptions, CdkCliOptions, CdkContextOptions, CdkDeployMethod, CdkDeployOptions, CdkDestroyOptions, CdkDiffMethod, CdkDiffOptions, CdkDocsOptions, CdkDoctorOptions, CdkDriftOptions, CdkFlagsOptions, CdkGcAction, CdkGcOptions, CdkGcType, CdkGlobalOptions, CdkImportOptions, CdkInitLanguage, CdkInitOptions, CdkInitTemplate, CdkListOptions, CdkMetadataOptions, CdkMigrateOptions, CdkNoticesOptions, CdkOrphanOptions, CdkProgress, CdkPublishAssetsOptions, CdkRefactorOptions, CdkRequireApproval, CdkRollbackOptions, CdkSynthOptions, CdkTargetOverrides, CdkWatchOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudeMdConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, EffectiveScopeThresholds, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueDefaultsConfig, IssueDefaultsOverride, IssueDefaultsPriority, IssueDefaultsStatus, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReactViteSiteProjectOptions, ReferenceMismatchCheckOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueDefaults, ResolvedIssueDefaultsEntry, ResolvedIssueTemplates, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedScopeGateBundleOverride, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedTemporalFraming, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateBundleOverride, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TemporalFramingCategory, TemporalFramingConfig, TsDocCoverageRecord, TsdocConfigOptions, TsdocCoverageCheckOptions, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, UpstreamConfigulatorConfig, VersionKey, VitestConfigOptions, VitestOptions };