@codedrifters/configulator 0.0.317 → 0.0.319

package/lib/index.d.mts

@@ -32,7 +32,7 @@ declare const AGENT_PLATFORM: {
 type AgentPlatform = (typeof AGENT_PLATFORM)[keyof typeof AGENT_PLATFORM];
 /**
  * Render target for Claude Code rules.
- * - SCOPED_FILE: .claude/rules/{name}.md (default — supports paths frontmatter for conditional activation)
+ * - SCOPED_FILE: `.claude/rules/{name}.md` (default — supports paths frontmatter for conditional activation)
  * - AGENTS_MD: AGENTS.md (always-active, shared with Codex)
  * - CLAUDE_MD: CLAUDE.md (always-active, Claude-only content not consumed by other agents)
  */
@@ -82,7 +82,7 @@ interface AgentPlatformOverrides {
     readonly claude?: {
         /**
          * Where to render this rule for Claude Code.
-         * - SCOPED_FILE: .claude/rules/{name}.md (default — supports paths frontmatter)
+         * - SCOPED_FILE: `.claude/rules/{name}.md` (default — supports paths frontmatter)
          * - AGENTS_MD: AGENTS.md (always-active, shared with Codex)
          * - CLAUDE_MD: CLAUDE.md (always-active, Claude-only)
          */
@@ -220,10 +220,12 @@ interface AgentSkill {
      * files for that platform alongside the SKILL.md.
      *
      * @example
+     * ```ts
      * referenceFiles: [
      *   { path: '_references/templates/_template-FR.md', content: '# Functional Requirement\n...' },
      *   { path: '_references/standards-and-frameworks.md', content: '# Standards\n...' },
      * ]
+     * ```
      */
     readonly referenceFiles?: ReadonlyArray<{
         /** Path relative to the skill directory (e.g., `_references/templates/_template-FR.md`). */
@@ -403,7 +405,7 @@ interface AgentCommand {
 }
 /**
  * An executable procedure (shell script) that ships with a bundle.
- * Rendered to .claude/procedures/{name} as an executable file.
+ * Rendered to `.claude/procedures/{name}` as an executable file.
  */
 interface AgentProcedure {
     /**
@@ -531,7 +533,7 @@ interface AgentRuleBundle {
      * Function that inspects the Projen project and returns true if this
      * bundle should be automatically included. Receives the root project
      * as input and can check for sibling components, dependencies, etc.
-     * @example (project) => Vitest.of(project) !== undefined
+     * @example `(project) => Vitest.of(project) !== undefined`
      */
     readonly appliesWhen: (project: Project) => boolean;
     /**
@@ -544,7 +546,7 @@ interface AgentRuleBundle {
      * TypeScript-adjacent code (e.g. typescript, aws-cdk, vitest, jest) should
      * implement this so their rules only activate for files in the packages
      * that actually use them.
-     * @example (project) => findProjectsWithFile(project, 'tsconfig.json')
+     * @example `(project) => findProjectsWithFile(project, 'tsconfig.json')`
      */
     readonly findApplicableProjects?: (project: Project) => ReadonlyArray<Project>;
     /** Rules included in this bundle. */
@@ -1331,11 +1333,11 @@ interface MeetingType {
  * edits on that meeting (see the `meeting-analyst` agent's
  * **Areas filtering** section for the full gating contract).
  *
- * Example: declaring `{ id: 'product-engineering', label: 'Product &
- * Engineering', docRoot: 'product' }` tells the `meeting-analysis`
- * bundle that a meeting whose frontmatter carries
- * `areas: [product-engineering]` should have its direct edits routed
- * under `<docsRoot>/product/`.
+ * Example: declaring
+ * `{ id: 'product-engineering', label: 'Product & Engineering', docRoot: 'product' }`
+ * tells the `meeting-analysis` bundle that a meeting whose frontmatter
+ * carries `areas: [product-engineering]` should have its direct edits
+ * routed under `<docsRoot>/product/`.
  *
  * When `AgentConfigOptions.meetings.meetingAreas` is non-empty, the
  * `meeting-analysis` bundle renders an "Area → doc-root mapping"
@@ -2828,7 +2830,7 @@ interface AgentConfigOptions {
      * match one of the six tier-aware bundle names — typos or
      * deprecated bundle names would otherwise be silently ignored.
      *
-     * @default {}
+     * @default `{}`
      */
     readonly bundleAgentTiers?: Readonly<Record<string, "powerful" | "balanced" | "fast">>;
     /**
@@ -4418,7 +4420,7 @@ interface ResolvedScheduledTask {
     readonly typeLabel: string;
     /**
      * Exact `type:*` label values (without the `type:` prefix) the
-     * worker picks up. When set (length >= 1), represents a
+     * worker picks up. When set (`length >= 1`), represents a
      * multi-type filter (e.g. routing-bucket `worker-issue`). When
      * unset, the `typeLabel` single-value filter applies.
      */
@@ -4432,7 +4434,7 @@ interface ResolvedScheduledTask {
     readonly phasePrefix?: string;
     /**
      * Exact phase-label values the worker filters on (e.g.
-     * `["req:write"]`). When set (length >= 1), takes precedence over
+     * `["req:write"]`). When set (`length >= 1`), takes precedence over
      * `phasePrefix`. When unset, the `phasePrefix` prefix-match
      * applies.
      */
@@ -4885,10 +4887,10 @@ declare function validateAgentTierConfig(config?: AgentTierConfig): ReadonlyArra
  *
  * When `excludeBundles` is non-empty, rows whose `type:*` label is
  * owned by an excluded bundle are dropped before rendering. Tiers
- * that end up with no surviving rows render an empty `_(none
- * registered)_` cell for consistency with the existing render — the
- * tier itself stays in the table so the dispatch ordering is still
- * documented end-to-end.
+ * that end up with no surviving rows render an empty
+ * `_(none registered)_` cell for consistency with the existing
+ * render — the tier itself stays in the table so the dispatch
+ * ordering is still documented end-to-end.
  */
 declare function renderAgentTierSection(tiers: ReadonlyArray<ResolvedAgentTier>, excludeBundles?: ReadonlyArray<string>): string;
 /**
@@ -6367,7 +6369,7 @@ interface GitHubProjectMetadata {
     readonly sprints?: GitHubSprintMetadata;
     /**
      * Kanban column (status field) definitions.
-     * @example [{ name: 'To Do', id: 'status_1' }, { name: 'In Progress', id: 'status_2' }]
+     * @example `[{ name: 'To Do', id: 'status_1' }, { name: 'In Progress', id: 'status_2' }]`
      */
     readonly columns?: ReadonlyArray<{
         readonly name: string;
@@ -6416,7 +6418,7 @@ interface SlackMetadata {
     readonly alertsChannel?: string;
     /**
      * Additional named channels. Keys are purpose identifiers.
-     * @example { releases: '#releases', support: '#customer-support' }
+     * @example `{ releases: '#releases', support: '#customer-support' }`
      */
     readonly channels?: Readonly<Record<string, string>>;
 }
@@ -6441,7 +6443,7 @@ interface DeploymentMetadata {
     readonly awsRegion?: string;
     /**
      * Named environments.
-     * @example { dev: { accountId: '111', region: 'us-east-1' }, prod: { accountId: '222', region: 'us-east-1' } }
+     * @example `{ dev: { accountId: '111', region: 'us-east-1' }, prod: { accountId: '222', region: 'us-east-1' } }`
      */
     readonly environments?: Readonly<Record<string, {
         readonly accountId?: string;
@@ -6714,7 +6716,7 @@ interface AstroIntegrationSpec {
      */
     readonly name: string;
     /**
-     * Module to import from, e.g. "@astrojs/react".
+     * Module to import from, e.g. `@astrojs/react`.
      */
     readonly importPath: string;
     /**
@@ -6787,265 +6789,1672 @@ declare class AstroConfig extends Component {
 
 /*******************************************************************************
  *
- * Git configs for this repo. This venn diagram has a great deal of overlap
- * with GitHub config options but is not a perfect circle.
+ * AWS CDK CLI Enums
+ *
+ * `as const` enums for the `cdk` CLI surface. Phase 1 covered `cdk deploy`;
+ * Phase 2 adds the enum needed by `cdk diff`; Phase 3 adds the enums needed by
+ * `cdk gc`; Phase 4 adds the enums needed by `cdk init` (and reused by `cdk
+ * migrate`).
  *
  ******************************************************************************/
-interface GitBranch {
-    /**
-     * The name of the branch pattern.
-     *
-     * @example "main" or "feature/*"
-     */
-    branch: string;
-    /**
-     * Description for this branch's purpose, used for generated documentation.
-     */
-    description?: Array<string>;
-}
+/**
+ * `--require-approval` values accepted by `cdk deploy`.
+ */
+declare const CDK_REQUIRE_APPROVAL: {
+    readonly Never: "never";
+    readonly AnyChange: "any-change";
+    readonly Broadening: "broadening";
+};
+/**
+ * Type for {@link CDK_REQUIRE_APPROVAL} values.
+ */
+type CdkRequireApproval = (typeof CDK_REQUIRE_APPROVAL)[keyof typeof CDK_REQUIRE_APPROVAL];
+/**
+ * `--method` values accepted by `cdk deploy`.
+ */
+declare const CDK_DEPLOY_METHOD: {
+    readonly ChangeSet: "change-set";
+    readonly Direct: "direct";
+    readonly PrepareChangeSet: "prepare-change-set";
+    readonly ExecuteChangeSet: "execute-change-set";
+};
+/**
+ * Type for {@link CDK_DEPLOY_METHOD} values.
+ */
+type CdkDeployMethod = (typeof CDK_DEPLOY_METHOD)[keyof typeof CDK_DEPLOY_METHOD];
+/**
+ * `--progress` values accepted by `cdk deploy`.
+ */
+declare const CDK_PROGRESS: {
+    readonly Bar: "bar";
+    readonly Events: "events";
+};
+/**
+ * Type for {@link CDK_PROGRESS} values.
+ */
+type CdkProgress = (typeof CDK_PROGRESS)[keyof typeof CDK_PROGRESS];
+/**
+ * `--method` values accepted by `cdk diff`.
+ */
+declare const CDK_DIFF_METHOD: {
+    readonly Auto: "auto";
+    readonly ChangeSet: "change-set";
+    readonly Template: "template";
+};
+/**
+ * Type for {@link CDK_DIFF_METHOD} values.
+ */
+type CdkDiffMethod = (typeof CDK_DIFF_METHOD)[keyof typeof CDK_DIFF_METHOD];
+/**
+ * `--action` values accepted by `cdk gc`.
+ */
+declare const CDK_GC_ACTION: {
+    readonly DeleteTagged: "delete-tagged";
+    readonly Full: "full";
+    readonly Print: "print";
+    readonly Tag: "tag";
+};
+/**
+ * Type for {@link CDK_GC_ACTION} values.
+ */
+type CdkGcAction = (typeof CDK_GC_ACTION)[keyof typeof CDK_GC_ACTION];
+/**
+ * `--type` values accepted by `cdk gc`.
+ */
+declare const CDK_GC_TYPE: {
+    readonly All: "all";
+    readonly Ecr: "ecr";
+    readonly S3: "s3";
+};
+/**
+ * Type for {@link CDK_GC_TYPE} values.
+ */
+type CdkGcType = (typeof CDK_GC_TYPE)[keyof typeof CDK_GC_TYPE];
+/**
+ * Positional `<template>` values accepted by `cdk init`.
+ */
+declare const CDK_INIT_TEMPLATE: {
+    readonly App: "app";
+    readonly Lib: "lib";
+    readonly SampleApp: "sample-app";
+};
+/**
+ * Type for {@link CDK_INIT_TEMPLATE} values.
+ */
+type CdkInitTemplate = (typeof CDK_INIT_TEMPLATE)[keyof typeof CDK_INIT_TEMPLATE];
+/**
+ * `--language` values accepted by `cdk init`. Also reused by `cdk migrate`'s
+ * `--language` flag, which accepts the same set of language identifiers.
+ */
+declare const CDK_INIT_LANGUAGE: {
+    readonly CSharp: "csharp";
+    readonly FSharp: "fsharp";
+    readonly Go: "go";
+    readonly Java: "java";
+    readonly JavaScript: "javascript";
+    readonly Python: "python";
+    readonly TypeScript: "typescript";
+};
+/**
+ * Type for {@link CDK_INIT_LANGUAGE} values.
+ */
+type CdkInitLanguage = (typeof CDK_INIT_LANGUAGE)[keyof typeof CDK_INIT_LANGUAGE];
 
 /*******************************************************************************
  *
- * AWS Deployment Configuration
+ * AWS CDK CLI Options
  *
- * A single deployment target that CDK applications can be deployed into.
+ * Typed coverage of the `cdk` CLI surface. Phase 1 covered `deploy`; Phase 2
+ * adds `synth`, `watch`, `destroy`, `diff`, `bootstrap`, and `list`; Phase 3
+ * adds the maintenance / lifecycle commands `rollback`, `import`, `gc`,
+ * `drift`, `refactor`, `publish-assets`, and `orphan`; Phase 4 adds the
+ * inspection / scaffolding commands `init`, `migrate`, `context`, `metadata`,
+ * `flags`, `acknowledge`, `notices`, `doctor`, and `docs`. Every
+ * command-specific interface inherits {@link CdkGlobalOptions} so it carries
+ * the same global flag surface.
+ *
+ * Every boolean field is tri-state (`boolean | undefined`):
+ *   - `undefined` → the renderer emits nothing, and the CLI's own default
+ *     applies.
+ *   - `true` → renders as `--flag`.
+ *   - `false` → renders as `--no-flag`.
  *
  ******************************************************************************/
 /**
- * Represents the configuration for local deployment in AWS.
+ * Global CLI flags accepted by every `cdk` subcommand. Command-specific option
+ * interfaces extend this base so the global flag surface stays in lock-step
+ * across commands.
  */
-interface AwsLocalDeploymentConfig {
-    /**
-     * The AWS profile (in ~/.aws/config) to use for local deployment.
+interface CdkGlobalOptions {
+    /*****************************************************************************
      *
-     * @default generated dynamically based role name, account and region
+     * Global CLI flags
+     *
+     ****************************************************************************/
+    /**
+     * `--app` — path to the CDK cloud assembly (or the synth command).
+     */
+    readonly app?: string;
+    /**
+     * `--profile` — named AWS profile from `~/.aws/credentials`.
      */
     readonly profile?: string;
     /**
-     * Named Role used to conduct local deployments.
-     *
-     * @default "poweruseraccess"
+     * `--lookups` — whether the CLI may perform context lookups against the
+     * target environment.
      */
-    readonly roleName?: string;
+    readonly lookups?: boolean;
     /**
-     * The pattern used to identify stacks to deploy in CI deployments.
-     *
-     * @default *-${account}-${region}
+     * `--context` — CDK context values. Repeats one `--context` flag per
+     * `KEY=VALUE` entry.
      */
-    readonly stackPattern?: string;
-}
-interface CiDeploymentConfig {
+    readonly context?: Record<string, string>;
     /**
-     * The OIDC IAM Role to assume for CI deployments.
+     * `--output` — directory to read the cloud assembly from.
      */
-    readonly roleArn: string;
+    readonly output?: string;
     /**
-     * The pattern used to identify stacks to deploy in CI deployments.
-     *
-     * @default *-${account}-${region}
+     * `--verbose` (`-v`) — verbosity level. The renderer emits `-v` repeated N
+     * times.
      */
-    readonly stackPattern?: string;
-}
-/**
- * Represents a deployment target in AWS, including account and region, and
- * branches allowed to deploy to this target.
- */
-interface AwsDeploymentTargetOptions {
+    readonly verbose?: number;
     /**
-     * The account name for the deployment target.
+     * `--debug` — enable debug output.
      */
-    readonly account: string;
+    readonly debug?: boolean;
     /**
-     * The AWS region for the deployment target.
+     * `--ci` — non-interactive CI mode.
      */
-    readonly region: string;
+    readonly ci?: boolean;
     /**
-     * AWS deployment type, such as dev, stage, or prod.
-     *
-     * @default 'dev'
+     * `--yes` — auto-confirm prompts.
      */
-    readonly awsStageType?: AwsStageType;
+    readonly yes?: boolean;
     /**
-     * Deployment target role: whether this (account, region) is the primary or
-     * secondary deployment target (e.g. primary vs replica region).
-     *
-     * @default 'primary'
+     * `--role-arn` — IAM role to assume for CloudFormation deployments.
      */
-    readonly deploymentTargetRole?: DeploymentTargetRoleType;
+    readonly roleArn?: string;
     /**
-     * AWS environment type, such as primary or secondary.
-     *
-     * @deprecated Use `deploymentTargetRole` instead. This property is maintained for backward compatibility.
-     * @default 'primary'
+     * `--proxy` — HTTP/HTTPS proxy URL.
      */
-    readonly awsEnvironmentType?: AwsEnvironmentType;
+    readonly proxy?: string;
     /**
-     * The AWS profile to use for this deployment target.
-     *
-     * @default ['main'] when prod release type, ['feature/*'] when dev type
+     * `--ca-bundle-path` — path to a CA bundle for TLS verification.
      */
-    readonly branches?: Array<GitBranch>;
+    readonly caBundlePath?: string;
     /**
-     * Can this deployment target be used for local development?
-     *
-     * @default true for dev environments, false for prod environments
+     * `--ec2creds` — force the SDK to obtain credentials from the EC2 instance
+     * metadata service.
      */
-    readonly localDeployment?: boolean;
+    readonly ec2creds?: boolean;
     /**
-     * Configuration when deploying to this target locally.
+     * `--version-reporting` — include CDK library version reporting in the
+     * synthesised template metadata.
      */
-    readonly localDeploymentConfig?: AwsLocalDeploymentConfig;
+    readonly versionReporting?: boolean;
     /**
-     * Can this deployment target be used in CI deployments?
-     *
-     * @default false
+     * `--path-metadata` — include path metadata in the synthesised template.
      */
-    readonly ciDeployment?: boolean;
-    readonly ciDeploymentConfig?: CiDeploymentConfig;
-}
-declare class AwsDeploymentTarget extends Component {
+    readonly pathMetadata?: boolean;
     /**
-     * Static method to discovert targets in a project.
+     * `--asset-metadata` — include asset metadata in the synthesised template.
      */
-    static of(project: AwsCdkTypeScriptApp): Array<AwsDeploymentTarget> | undefined;
+    readonly assetMetadata?: boolean;
     /**
-     * The account name for the deployment target.
+     * `--staging` — copy assets to `cdk.out` for staging.
      */
-    account: string;
+    readonly staging?: boolean;
     /**
-     * The AWS region for the deployment target.
+     * `--notices` — show CDK notices.
      */
-    region: string;
-    /**'
-     * AWS stage type, such as dev, stage, or prod.
-     *
-     * @default 'dev'
+    readonly notices?: boolean;
+    /**
+     * `--color` — force-enable coloured output.
      */
-    awsStageType: AwsStageType;
+    readonly color?: boolean;
     /**
-     * Deployment target role: whether this (account, region) is the primary or
-     * secondary deployment target (e.g. primary vs replica region).
-     *
-     * @default 'primary'
+     * `--no-color` — disable coloured output.
      */
-    deploymentTargetRole: DeploymentTargetRoleType;
+    readonly noColor?: boolean;
     /**
-     * AWS environment type, such as primary or secondary.
-     *
-     * @deprecated Use `deploymentTargetRole` instead. This property is maintained for backward compatibility.
-     * @default 'primary'
+     * `--unstable` — opt into named unstable CLI features. Repeats one
+     * `--unstable` flag per entry.
      */
-    awsEnvironmentType: AwsEnvironmentType;
+    readonly unstable?: Array<string>;
     /**
-     * The AWS profile to use for this deployment target.
-     *
-     * @default ['main'] when prod release type, ['feature/*'] when dev type
+     * `--telemetry-file` — write CDK telemetry to the given path.
      */
-    branches: Array<GitBranch>;
+    readonly telemetryFile?: string;
     /**
-     * Can this deployment target be used for local development?
-     *
-     * @default true for dev environments, false for prod environments
+     * `--trace` — print stack traces on errors.
      */
-    localDeployment?: boolean;
+    readonly trace?: boolean;
     /**
-     * Configuration when deploying to this target locally.
+     * `--strict` — promote certain warnings to errors.
      */
-    localDeploymentConfig?: AwsLocalDeploymentConfig;
+    readonly strict?: boolean;
     /**
-     * Can this deployment target be used in CI deployments?
-     *
-     * @default false
+     * `--ignore-errors` — proceed past non-fatal errors.
      */
-    ciDeployment?: boolean;
-    ciDeploymentConfig?: Required<CiDeploymentConfig>;
+    readonly ignoreErrors?: boolean;
     /**
-     * Configuration for the CDK output directory for this deployment target.
+     * `--json` — emit JSON-formatted output.
      */
-    awsDeploymentConfig: AwsDeploymentConfig;
-    constructor(project: AwsCdkTypeScriptApp, options: AwsDeploymentTargetOptions);
+    readonly json?: boolean;
+    /**
+     * `--plugin` — register one or more CDK CLI plugins. Repeats one `--plugin`
+     * flag per entry.
+     */
+    readonly plugin?: Array<string>;
+    /**
+     * `--build` — command to build the CDK app before deploy.
+     */
+    readonly build?: string;
     /*****************************************************************************
      *
-     * Deploy Tasks
-     *
-     * - If local deploy, add a deploy task.
+     * Trailing positional arguments
      *
      ****************************************************************************/
-    private configureDeployTask;
+    /**
+     * Stack patterns passed as trailing positional arguments. Quoted by the
+     * renderer to preserve glob characters across shells.
+     */
+    readonly stackPatterns?: Array<string>;
+}
+/**
+ * Options for the `cdk deploy` command.
+ */
+interface CdkDeployOptions extends CdkGlobalOptions {
     /*****************************************************************************
      *
-     * Watch tasks
-     *
-     * - Configure watch task to use the branch name
-     * - configure watch task to use the correct synth output location.
+     * Deploy-specific flags
      *
      ****************************************************************************/
-    private configureWatchTask;
-}
-
-/*******************************************************************************
- *
- * AWS Deployment Configuration
- *
- * This component allows configuration of multiple AWS deployment
- * targets, each with its own account, region, and deployment type
- * (dev, stage, prod). It supports both local and CI deployments,
- * with customizable settings for each target.
- *
- ******************************************************************************/
-declare class AwsDeploymentConfig extends Component {
-    static of(project: AwsCdkTypeScriptApp): AwsDeploymentConfig | undefined;
     /**
-     * Environment variables to be injected into all tasks.
+     * Deploy all stacks in the application.
      */
-    readonly env: Record<string, string>;
+    readonly all?: boolean;
     /**
-     * The relative path to the project directory from the root of the project.
+     * `--require-approval` — when to prompt for security-related approvals.
      */
-    readonly projectPath: string;
+    readonly requireApproval?: CdkRequireApproval;
     /**
-     * The relative path to the root of the project from the output directory.
+     * `--rollback` / `--no-rollback` — roll back the stack on failure.
+     *
+     * Tri-state: `true` enables rollback, `false` disables it (useful in dev for
+     * fast iteration), `undefined` defers to the CLI default.
      */
-    readonly rootPath: string;
+    readonly rollback?: boolean;
     /**
-     * The output directory for the CDK synthesis, from the root directory.
+     * `--hotswap` — apply changes directly to running resources without going
+     * through CloudFormation when possible.
+     *
+     * @deprecated AWS recommends `--hotswap` strictly for development use; it
+     * introduces drift relative to the deployed CloudFormation template and
+     * should never be used in production deployments.
      */
-    readonly rootCdkOut: string;
+    readonly hotswap?: boolean;
     /**
-     * The output directory for the CDK synthesis.
+     * `--hotswap-fallback` — fall back to a full CloudFormation deployment when a
+     * hotswap is not possible.
      */
-    readonly cdkOut: string;
+    readonly hotswapFallback?: boolean;
     /**
-     * Array of targets for deployment.
+     * `--method` — how the deployment is performed (change-set vs direct).
      */
-    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
-    constructor(project: AwsCdkTypeScriptApp);
-    /*****************************************************************************
-     *
-     * Target filter helpers
-     *
-     * Return various targets for deployment scripts to use.
-     *
-     ****************************************************************************/
+    readonly method?: CdkDeployMethod;
     /**
-     * @returns All production deployment targets.
+     * `--change-set-name` — name of the change set to create/execute.
      */
-    get prodTargets(): Array<AwsDeploymentTarget>;
-    get prodTargetsForCI(): Array<AwsDeploymentTarget>;
-    get prodTargetsForLocal(): Array<AwsDeploymentTarget>;
+    readonly changeSetName?: string;
     /**
-     *
-     * @returns All stage deployment targets.
+     * `--force` — always deploy even if no changes are detected.
      */
-    get stageTargets(): Array<AwsDeploymentTarget>;
-    get stageTargetsForCI(): Array<AwsDeploymentTarget>;
-    get stageTargetsForLocal(): Array<AwsDeploymentTarget>;
+    readonly force?: boolean;
+    /**
+     * `--exclusively` — deploy only the requested stacks; do not include
+     * dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
+     * environment bootstrap.
+     */
+    readonly toolkitStackName?: string;
+    /**
+     * `--parameters` — CloudFormation parameters to pass to the stack. Each
+     * entry is a `KEY=VALUE` string. Repeats one `--parameters` flag per entry.
+     */
+    readonly parameters?: Array<string>;
+    /**
+     * `--outputs-file` — write CloudFormation outputs to a JSON file at the
+     * given path.
+     */
+    readonly outputsFile?: string;
+    /**
+     * `--previous-parameters` — use previous parameter values for any parameters
+     * not explicitly supplied.
+     */
+    readonly previousParameters?: boolean;
+    /**
+     * `--concurrency` — number of stacks to deploy in parallel.
+     */
+    readonly concurrency?: number;
+    /**
+     * `--asset-parallelism` — upload assets in parallel.
+     */
+    readonly assetParallelism?: boolean;
+    /**
+     * `--asset-prebuild` — pre-build assets before deploying.
+     */
+    readonly assetPrebuild?: boolean;
+    /**
+     * `--watch` — continue watching for changes after the initial deploy.
+     */
+    readonly watch?: boolean;
+    /**
+     * `--logs` — stream CloudWatch logs for resources updated by the deploy.
+     */
+    readonly logs?: boolean;
+    /**
+     * `--build-exclude` — names of asset bundlers/build steps to skip. Repeats
+     * one `--build-exclude` flag per entry.
+     */
+    readonly buildExclude?: Array<string>;
+    /**
+     * `--notification-arns` — SNS topic ARNs to notify on stack events. Repeats
+     * one `--notification-arns` flag per entry.
+     */
+    readonly notificationArns?: Array<string>;
     /**
+     * `--tags` — tags to apply to all stack resources. Repeats one `--tags` flag
+     * per `KEY=VALUE` entry.
      *
-     * @returns All dev deployment targets.
+     * @deprecated Tag declarations belong in the cloud assembly via
+     * `Tags.of(scope).add(...)` rather than the CLI. The flag is modelled for
+     * completeness, but consumers should prefer in-stack tagging.
      */
-    get devTargets(): Array<AwsDeploymentTarget>;
-    get devTargetsForCI(): Array<AwsDeploymentTarget>;
+    readonly tags?: Record<string, string>;
+    /**
+     * `--progress` — progress reporting style.
+     */
+    readonly progress?: CdkProgress;
+    /**
+     * `--ignore-no-stacks` — succeed (with a warning) when no stacks match the
+     * supplied pattern.
+     */
+    readonly ignoreNoStacks?: boolean;
+    /**
+     * `--import-existing-resources` — generate a change set that imports
+     * existing AWS resources into the stack.
+     */
+    readonly importExistingResources?: boolean;
+    /**
+     * `--revert-drift` — revert any drift detected on the target stacks before
+     * applying the new deployment.
+     */
+    readonly revertDrift?: boolean;
+    /**
+     * `--execute` — execute the prepared change set immediately.
+     *
+     * @deprecated Replaced by `--method=prepare-change-set` and
+     * `--method=execute-change-set`. Surfaced here only for completeness.
+     */
+    readonly execute?: boolean;
+}
+/**
+ * Options for the `cdk synth` command.
+ */
+interface CdkSynthOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Synth-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--exclusively` — synthesize only the requested stacks; do not include
+     * dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--quiet` (`-q`) — suppress the template output on stdout.
+     */
+    readonly quiet?: boolean;
+    /**
+     * `--validation` — run additional cloud-assembly validation.
+     */
+    readonly validation?: boolean;
+}
+/**
+ * Options for the `cdk watch` command.
+ */
+interface CdkWatchOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Watch-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--build-exclude` — names of asset bundlers/build steps to skip. Repeats
+     * one `--build-exclude` flag per entry.
+     */
+    readonly buildExclude?: Array<string>;
+    /**
+     * `--change-set-name` — name of the change set to create/execute.
+     */
+    readonly changeSetName?: string;
+    /**
+     * `--concurrency` — number of stacks to deploy in parallel.
+     */
+    readonly concurrency?: number;
+    /**
+     * `--exclusively` — deploy only the requested stacks; do not include
+     * dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--force` — always deploy even if no changes are detected.
+     */
+    readonly force?: boolean;
+    /**
+     * `--hotswap` — apply changes directly to running resources without going
+     * through CloudFormation when possible. The CLI default for `cdk watch` is
+     * `true`; supply `false` to disable.
+     */
+    readonly hotswap?: boolean;
+    /**
+     * `--hotswap-fallback` — fall back to a full CloudFormation deployment when
+     * a hotswap is not possible.
+     */
+    readonly hotswapFallback?: boolean;
+    /**
+     * `--logs` — stream CloudWatch logs for resources updated by the deploy.
+     */
+    readonly logs?: boolean;
+    /**
+     * `--progress` — progress reporting style.
+     */
+    readonly progress?: CdkProgress;
+    /**
+     * `--rollback` / `--no-rollback` — roll back the stack on failure.
+     *
+     * Tri-state: `true` enables rollback, `false` disables it (useful in dev for
+     * fast iteration), `undefined` defers to the CLI default.
+     */
+    readonly rollback?: boolean;
+    /**
+     * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
+     * environment bootstrap.
+     */
+    readonly toolkitStackName?: string;
+}
+/**
+ * Options for the `cdk destroy` command.
+ */
+interface CdkDestroyOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Destroy-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--all` — destroy all stacks in the application.
+     */
+    readonly all?: boolean;
+    /**
+     * `--concurrency` — number of stacks to destroy in parallel.
+     */
+    readonly concurrency?: number;
+    /**
+     * `--exclusively` — destroy only the requested stacks; do not include
+     * dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--force` — skip the confirmation prompt before destroying.
+     */
+    readonly force?: boolean;
+}
+/**
+ * Options for the `cdk diff` command.
+ */
+interface CdkDiffOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Diff-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--change-set` — use a CloudFormation change set to compute the diff.
+     *
+     * @deprecated Prefer the `--method` flag (e.g. `--method=change-set`).
+     */
+    readonly changeSet?: boolean;
+    /**
+     * `--context-lines` — number of context lines to print around each change.
+     */
+    readonly contextLines?: number;
+    /**
+     * `--exclusively` — diff only the requested stacks; do not include
+     * dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--fail` — fail with a non-zero exit code when differences are detected.
+     */
+    readonly fail?: boolean;
+    /**
+     * `--method` — how the diff is computed.
+     */
+    readonly method?: CdkDiffMethod;
+    /**
+     * `--processed` — compare against the processed (CDK-augmented) template
+     * rather than the raw user input.
+     */
+    readonly processed?: boolean;
+    /**
+     * `--quiet` — suppress unchanged-resource output.
+     */
+    readonly quiet?: boolean;
+    /**
+     * `--security-only` — restrict the diff to security-relevant changes only.
+     */
+    readonly securityOnly?: boolean;
+    /**
+     * `--template` — diff against a specific template file path.
+     */
+    readonly template?: string;
+}
+/**
+ * Options for the `cdk bootstrap` command.
+ */
+interface CdkBootstrapOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Bootstrap-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--bootstrap-bucket-name` / `--toolkit-bucket-name` — name of the S3
+     * bucket used by the bootstrap stack to stage assets.
+     */
+    readonly bootstrapBucketName?: string;
+    /**
+     * `--bootstrap-customer-key` — opt into a customer-managed KMS key for the
+     * bootstrap bucket (creates the key as part of bootstrap).
+     */
+    readonly bootstrapCustomerKey?: boolean;
+    /**
+     * `--bootstrap-kms-key-id` — supply an existing KMS key ID for the
+     * bootstrap bucket.
+     */
+    readonly bootstrapKmsKeyId?: string;
+    /**
+     * `--cloudformation-execution-policies` — managed-policy ARNs to attach to
+     * the CloudFormation execution role. Repeats one
+     * `--cloudformation-execution-policies` flag per entry.
+     */
+    readonly cloudformationExecutionPolicies?: Array<string>;
+    /**
+     * `--custom-permissions-boundary` — name of an IAM permissions boundary to
+     * attach to the bootstrap roles.
+     */
+    readonly customPermissionsBoundary?: string;
+    /**
+     * `--example-permissions-boundary` — install the example permissions
+     * boundary shipped with the CDK.
+     */
+    readonly examplePermissionsBoundary?: boolean;
+    /**
+     * `--execute` — execute the bootstrap change set immediately.
+     */
+    readonly execute?: boolean;
+    /**
+     * `--force` — force re-bootstrap even when the bootstrap stack is current.
+     */
+    readonly force?: boolean;
+    /**
+     * `--previous-parameters` — use previous parameter values for any parameters
+     * not explicitly supplied.
+     */
+    readonly previousParameters?: boolean;
+    /**
+     * `--public-access-block-configuration` — enable S3 public access block on
+     * the bootstrap bucket.
+     */
+    readonly publicAccessBlockConfiguration?: boolean;
+    /**
+     * `--qualifier` — qualifier appended to bootstrap resource names so multiple
+     * bootstraps can coexist in the same account/region.
+     */
+    readonly qualifier?: string;
+    /**
+     * `--show-template` — emit the bootstrap template to stdout instead of
+     * deploying it.
+     */
+    readonly showTemplate?: boolean;
+    /**
+     * `--tags` — tags to apply to the bootstrap stack. Repeats one `--tags`
+     * flag per `KEY=VALUE` entry.
+     */
+    readonly tags?: Record<string, string>;
+    /**
+     * `--template` — bootstrap from a custom template file path.
+     */
+    readonly template?: string;
+    /**
+     * `--termination-protection` — enable CloudFormation termination protection
+     * on the bootstrap stack.
+     */
+    readonly terminationProtection?: boolean;
+    /**
+     * `--toolkit-stack-name` — name of the CDK toolkit (bootstrap) stack.
+     */
+    readonly toolkitStackName?: string;
+    /**
+     * `--trust` — AWS account IDs trusted to deploy into this bootstrap
+     * environment. Repeats one `--trust` flag per entry.
+     */
+    readonly trust?: Array<string>;
+    /**
+     * `--trust-for-lookup` — AWS account IDs trusted to perform context lookups
+     * against this bootstrap environment. Repeats one `--trust-for-lookup` flag
+     * per entry.
+     */
+    readonly trustForLookup?: Array<string>;
+}
+/**
+ * Options for the `cdk list` / `cdk ls` command.
+ */
+interface CdkListOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * List-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--long` — include extra columns (account, region, etc.) in the listing.
+     */
+    readonly long?: boolean;
+    /**
+     * `--show-dependencies` — emit each stack's inter-stack dependencies.
+     */
+    readonly showDependencies?: boolean;
+}
+/**
+ * Options for the `cdk rollback` command.
+ */
+interface CdkRollbackOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Rollback-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--all` — roll back every stack in the application.
+     */
+    readonly all?: boolean;
+    /**
+     * `--force` — force the rollback even when CloudFormation reports the stack
+     * is already in a stable state.
+     */
+    readonly force?: boolean;
+    /**
+     * `--orphan` — logical IDs of resources to orphan (skip) during rollback.
+     * Repeats one `--orphan` flag per entry.
+     */
+    readonly orphan?: Array<string>;
+    /**
+     * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
+     * environment bootstrap.
+     */
+    readonly toolkitStackName?: string;
+    /**
+     * `--validate-bootstrap-version` — require the bootstrap stack version on
+     * the target environment to match the version the CLI was built against.
+     */
+    readonly validateBootstrapVersion?: boolean;
+}
+/**
+ * Options for the `cdk import` command.
+ */
+interface CdkImportOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Import-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--change-set-name` — name of the import change set to create/execute.
+     */
+    readonly changeSetName?: string;
+    /**
+     * `--execute` — execute the prepared import change set immediately.
+     */
+    readonly execute?: boolean;
+    /**
+     * `--force` — proceed with the import even when CloudFormation warnings
+     * would normally block it.
+     */
+    readonly force?: boolean;
+    /**
+     * `--record-resource-mapping` — write the resolved logical-id → physical-id
+     * mapping to the given path for later reuse.
+     */
+    readonly recordResourceMapping?: string;
+    /**
+     * `--resource-mapping` — read the logical-id → physical-id mapping from the
+     * given path instead of prompting interactively.
+     */
+    readonly resourceMapping?: string;
+    /**
+     * `--rollback` / `--no-rollback` — roll back the stack on failure.
+     *
+     * Tri-state: `true` enables rollback, `false` disables it, `undefined`
+     * defers to the CLI default.
+     */
+    readonly rollback?: boolean;
+    /**
+     * `--toolkit-stack-name` — name of the CDK toolkit stack used as the
+     * environment bootstrap.
+     */
+    readonly toolkitStackName?: string;
+}
+/**
+ * Options for the `cdk gc` command.
+ *
+ * `cdk gc` is gated behind the global `--unstable=gc` flag. Callers MUST
+ * include `"gc"` in {@link CdkGlobalOptions.unstable} (modelled on this
+ * interface as the inherited `unstable` field) for the CLI to accept the
+ * command; the renderer surfaces `unstable` as a regular global flag and does
+ * not validate the gate itself.
+ */
+interface CdkGcOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * GC-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--action` — which garbage-collection action to perform.
+     */
+    readonly action?: CdkGcAction;
+    /**
+     * `--bootstrap-stack-name` — name of the bootstrap stack whose assets are
+     * being garbage collected.
+     */
+    readonly bootstrapStackName?: string;
+    /**
+     * `--confirm` / `--no-confirm` — prompt before deleting tagged assets.
+     */
+    readonly confirm?: boolean;
+    /**
+     * `--created-buffer-days` — only consider assets created more than N days
+     * ago for tagging.
+     */
+    readonly createdBufferDays?: number;
+    /**
+     * `--rollback-buffer-days` — keep tagged assets for at least N days before
+     * deleting them so a rollback can recover them.
+     */
+    readonly rollbackBufferDays?: number;
+    /**
+     * `--type` — restrict garbage collection to a particular asset type.
+     */
+    readonly type?: CdkGcType;
+}
+/**
+ * Options for the `cdk drift` command.
+ */
+interface CdkDriftOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Drift-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--fail` — exit with a non-zero status when drift is detected.
+     */
+    readonly fail?: boolean;
+}
+/**
+ * Options for the `cdk refactor` command.
+ */
+interface CdkRefactorOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Refactor-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--additional-stack-name` — additional stack names to include in the
+     * refactor scope. Repeats one `--additional-stack-name` flag per entry.
+     */
+    readonly additionalStackName?: Array<string>;
+    /**
+     * `--dry-run` — preview the refactor plan without applying it.
+     */
+    readonly dryRun?: boolean;
+    /**
+     * `--override-file` — path to a refactor override file that pins specific
+     * resource moves.
+     */
+    readonly overrideFile?: string;
+    /**
+     * `--revert` — apply the inverse of the refactor (undo a previous refactor
+     * plan).
+     */
+    readonly revert?: boolean;
+    /**
+     * `--force` — proceed even when the refactor planner would normally bail
+     * out.
+     */
+    readonly force?: boolean;
+}
+/**
+ * Options for the `cdk publish-assets` command.
+ */
+interface CdkPublishAssetsOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Publish-assets-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--all` — publish assets for every stack in the application.
+     */
+    readonly all?: boolean;
+    /**
+     * `--exclusively` — publish only the requested stacks' assets; do not
+     * include dependencies.
+     */
+    readonly exclusively?: boolean;
+    /**
+     * `--force` — re-upload assets even when the target already has them.
+     */
+    readonly force?: boolean;
+    /**
+     * `--concurrency` — number of asset uploads to run in parallel.
+     */
+    readonly concurrency?: number;
+}
+/**
+ * Options for the `cdk orphan` command.
+ *
+ * `cdk orphan` takes only positional `<logicalId>` arguments — there are no
+ * command-specific flags beyond the inherited globals.
+ */
+interface CdkOrphanOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Orphan-specific positional arguments
+     *
+     ****************************************************************************/
+    /**
+     * Logical resource IDs to orphan. Rendered as quoted, space-separated
+     * positional arguments after the command name.
+     */
+    readonly logicalIds?: Array<string>;
+}
+/**
+ * Options for the `cdk init` command.
+ *
+ * `cdk init` accepts a positional `<template>` argument and the
+ * `--language` flag. Both are typed via the {@link CdkInitTemplate} and
+ * {@link CdkInitLanguage} enums.
+ */
+interface CdkInitOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Init-specific positional arguments
+     *
+     ****************************************************************************/
+    /**
+     * Positional `<template>` argument — `app`, `lib`, or `sample-app`.
+     * Rendered after the command name and any command-specific flags, before
+     * the trailing tokens.
+     */
+    readonly template?: CdkInitTemplate;
+    /*****************************************************************************
+     *
+     * Init-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--language` — language to scaffold the new CDK project in.
+     */
+    readonly language?: CdkInitLanguage;
+    /**
+     * `--list` — print the available templates and exit instead of
+     * scaffolding.
+     */
+    readonly list?: boolean;
+    /**
+     * `--generate-only` — generate the project files without performing
+     * post-scaffold steps (e.g. `git init`, dependency install).
+     */
+    readonly generateOnly?: boolean;
+}
+/**
+ * Options for the `cdk migrate` command.
+ */
+interface CdkMigrateOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Migrate-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--stack-name` — name of the CDK stack created from the migrated
+     * resources.
+     */
+    readonly stackName?: string;
+    /**
+     * `--language` — language to generate the migrated CDK app in. Reuses the
+     * same enum as `cdk init`.
+     */
+    readonly language?: CdkInitLanguage;
+    /**
+     * `--account` — AWS account ID hosting the source resources.
+     */
+    readonly account?: string;
+    /**
+     * `--region` — AWS region hosting the source resources.
+     */
+    readonly region?: string;
+    /**
+     * `--from-path` — path to a CloudFormation template file to migrate from.
+     */
+    readonly fromPath?: string;
+    /**
+     * `--from-stack` — migrate from an existing CloudFormation stack by name.
+     */
+    readonly fromStack?: boolean;
+    /**
+     * `--from-scan` — migrate by initiating a CloudFormation resource scan.
+     */
+    readonly fromScan?: boolean;
+    /**
+     * `--output-path` — directory to write the generated CDK app into.
+     */
+    readonly outputPath?: string;
+    /**
+     * `--filter` — resource filter expressions that narrow which resources
+     * are included in the migration. Repeats one `--filter` flag per entry.
+     */
+    readonly filter?: Array<string>;
+    /**
+     * `--compress` — compress the generated CDK app into a zip archive.
+     */
+    readonly compress?: boolean;
+}
+/**
+ * Options for the `cdk context` command.
+ */
+interface CdkContextOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Context-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--clear` — clear all cached context values.
+     */
+    readonly clear?: boolean;
+    /**
+     * `--force` — perform context operations without prompting.
+     */
+    readonly force?: boolean;
+    /**
+     * `--reset=KEY` — clear a single cached context value by key. The CLI's
+     * `--reset` flag is value-taking (it accepts the context key to reset),
+     * so this field is typed as `string | undefined` rather than as a
+     * tri-state boolean.
+     */
+    readonly reset?: string;
+}
+/**
+ * Options for the `cdk metadata` command.
+ *
+ * `cdk metadata` takes a single positional `<stack>` argument and has no
+ * command-specific flags beyond the inherited globals.
+ */
+interface CdkMetadataOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Metadata-specific positional arguments
+     *
+     ****************************************************************************/
+    /**
+     * Positional `<stack>` argument naming the stack whose metadata to print.
+     * Rendered after the command name and any command-specific flags, before
+     * the trailing tokens.
+     */
+    readonly stack?: string;
+}
+/**
+ * Options for the `cdk flags` command.
+ */
+interface CdkFlagsOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Flags-specific flags
+     *
+     ****************************************************************************/
+    /**
+     * `--value=FLAG` — print the configured value of a single feature flag.
+     * The CLI's `--value` flag is value-taking, so this field is typed as
+     * `string | undefined`.
+     */
+    readonly value?: string;
+    /**
+     * `--set=FLAG=VALUE` — set a feature flag to the given value. The CLI's
+     * `--set` flag is value-taking, so this field is typed as
+     * `string | undefined`.
+     */
+    readonly set?: string;
+    /**
+     * `--all` — include every known feature flag in the output.
+     */
+    readonly all?: boolean;
+    /**
+     * `--unconfigured` — include feature flags that have not been configured
+     * yet.
+     */
+    readonly unconfigured?: boolean;
+    /**
+     * `--recommended` — set feature flags to their recommended values.
+     */
+    readonly recommended?: boolean;
+    /**
+     * `--default` — set feature flags to their default values.
+     */
+    readonly default?: boolean;
+    /**
+     * `--interactive` — prompt interactively to confirm each flag change.
+     */
+    readonly interactive?: boolean;
+    /**
+     * `--safe` — only apply changes that are safe (no resource replacement,
+     * no destructive updates).
+     */
+    readonly safe?: boolean;
+    /**
+     * `--concurrency` — number of concurrent operations to run when applying
+     * flag changes.
+     */
+    readonly concurrency?: number;
+}
+/**
+ * Options for the `cdk acknowledge` (`ack`) command.
+ *
+ * `cdk acknowledge` takes a single positional `<id>` argument identifying
+ * the notice to acknowledge. It has no command-specific flags beyond the
+ * inherited globals.
+ */
+interface CdkAcknowledgeOptions extends CdkGlobalOptions {
+    /*****************************************************************************
+     *
+     * Acknowledge-specific positional arguments
+     *
+     ****************************************************************************/
+    /**
+     * Positional `<id>` argument — the notice ID to acknowledge. Rendered
+     * after the command name and any command-specific flags, before the
+     * trailing tokens.
+     */
+    readonly id?: string;
+}
+/**
+ * Options for the `cdk notices` command.
+ *
+ * `cdk notices` has no command-specific flags beyond the inherited globals.
+ * Surfaced as an empty interface so the renderer signature stays uniform
+ * with the rest of the command surface.
+ */
+interface CdkNoticesOptions extends CdkGlobalOptions {
+}
+/**
+ * Options for the `cdk doctor` command.
+ *
+ * `cdk doctor` has no command-specific flags beyond the inherited globals.
+ * Surfaced as an empty interface so the renderer signature stays uniform
+ * with the rest of the command surface.
+ */
+interface CdkDoctorOptions extends CdkGlobalOptions {
+}
+/**
+ * Options for the `cdk docs` (`doc`) command.
+ *
+ * `cdk docs` has no command-specific flags beyond the inherited globals.
+ * Surfaced as an empty interface so the renderer signature stays uniform
+ * with the rest of the command surface.
+ */
+interface CdkDocsOptions extends CdkGlobalOptions {
+}
+/**
+ * Per-target / per-account override bundle for the `CdkCli` component.
+ *
+ * Used in two distinct positions in the override stack:
+ *
+ * - **Per-account** on `CdkCliOptions.accountOverrides[accountId]` —
+ *   applies to every {@link AwsDeploymentTarget} that resolves to the same
+ *   AWS account ID.
+ * - **Per-target** on `AwsDeploymentTargetOptions.cdkOptions` — applies
+ *   only to that specific deployment target.
+ *
+ * Both layers slot into the precedence chain documented on {@link CdkCli};
+ * per-target wins on collisions because it is the more specific layer.
+ *
+ * Every command field is optional so consumers can override one command
+ * (e.g. just `deploy`) without restating the others.
+ */
+interface CdkTargetOverrides {
+    /**
+     * Overrides applied to `cdk deploy` invocations against the matching
+     * target / account.
+     */
+    readonly deploy?: Partial<CdkDeployOptions>;
+    /**
+     * Overrides applied to `cdk synth` invocations against the matching
+     * target / account.
+     */
+    readonly synth?: Partial<CdkSynthOptions>;
+    /**
+     * Overrides applied to `cdk watch` invocations against the matching
+     * target / account.
+     */
+    readonly watch?: Partial<CdkWatchOptions>;
+    /**
+     * Overrides applied to `cdk destroy` invocations against the matching
+     * target / account.
+     */
+    readonly destroy?: Partial<CdkDestroyOptions>;
+    /**
+     * Overrides applied to `cdk diff` invocations against the matching
+     * target / account.
+     */
+    readonly diff?: Partial<CdkDiffOptions>;
+    /**
+     * Overrides applied to `cdk bootstrap` invocations against the matching
+     * target / account.
+     */
+    readonly bootstrap?: Partial<CdkBootstrapOptions>;
+}
+
+/*******************************************************************************
+ *
+ * Git configs for this repo. This venn diagram has a great deal of overlap
+ * with GitHub config options but is not a perfect circle.
+ *
+ ******************************************************************************/
+interface GitBranch {
+    /**
+     * The name of the branch pattern.
+     *
+     * @example "main" or "feature/*"
+     */
+    branch: string;
+    /**
+     * Description for this branch's purpose, used for generated documentation.
+     */
+    description?: Array<string>;
+}
+
+/*******************************************************************************
+ *
+ * AWS Deployment Configuration
+ *
+ * A single deployment target that CDK applications can be deployed into.
+ *
+ ******************************************************************************/
+/**
+ * Represents the configuration for local deployment in AWS.
+ */
+interface AwsLocalDeploymentConfig {
+    /**
+     * The AWS profile (in ~/.aws/config) to use for local deployment.
+     *
+     * @default generated dynamically based role name, account and region
+     */
+    readonly profile?: string;
+    /**
+     * Named Role used to conduct local deployments.
+     *
+     * @default "poweruseraccess"
+     */
+    readonly roleName?: string;
+    /**
+     * The pattern used to identify stacks to deploy in CI deployments.
+     *
+     * @default `*-${account}-${region}`
+     */
+    readonly stackPattern?: string;
+}
+interface CiDeploymentConfig {
+    /**
+     * The OIDC IAM Role to assume for CI deployments.
+     */
+    readonly roleArn: string;
+    /**
+     * The pattern used to identify stacks to deploy in CI deployments.
+     *
+     * @default `*-${account}-${region}`
+     */
+    readonly stackPattern?: string;
+}
+/**
+ * Represents a deployment target in AWS, including account and region, and
+ * branches allowed to deploy to this target.
+ */
+interface AwsDeploymentTargetOptions {
+    /**
+     * The account name for the deployment target.
+     */
+    readonly account: string;
+    /**
+     * The AWS region for the deployment target.
+     */
+    readonly region: string;
+    /**
+     * AWS deployment type, such as dev, stage, or prod.
+     *
+     * @default 'dev'
+     */
+    readonly awsStageType?: AwsStageType;
+    /**
+     * Deployment target role: whether this (account, region) is the primary or
+     * secondary deployment target (e.g. primary vs replica region).
+     *
+     * @default 'primary'
+     */
+    readonly deploymentTargetRole?: DeploymentTargetRoleType;
+    /**
+     * AWS environment type, such as primary or secondary.
+     *
+     * @deprecated Use `deploymentTargetRole` instead. This property is maintained for backward compatibility.
+     * @default 'primary'
+     */
+    readonly awsEnvironmentType?: AwsEnvironmentType;
+    /**
+     * The AWS profile to use for this deployment target.
+     *
+     * @default ['main'] when prod release type, ['feature/*'] when dev type
+     */
+    readonly branches?: Array<GitBranch>;
+    /**
+     * Can this deployment target be used for local development?
+     *
+     * @default true for dev environments, false for prod environments
+     */
+    readonly localDeployment?: boolean;
+    /**
+     * Configuration when deploying to this target locally.
+     */
+    readonly localDeploymentConfig?: AwsLocalDeploymentConfig;
+    /**
+     * Can this deployment target be used in CI deployments?
+     *
+     * @default false
+     */
+    readonly ciDeployment?: boolean;
+    readonly ciDeploymentConfig?: CiDeploymentConfig;
+    /**
+     * Per-target overrides for `cdk` CLI options.
+     *
+     * Layered on top of the per-stage defaults and any per-account overrides
+     * configured on {@link CdkCli}. See {@link CdkCli} for the full precedence
+     * chain.
+     */
+    readonly cdkOptions?: CdkTargetOverrides;
+}
+declare class AwsDeploymentTarget extends Component {
+    /**
+     * Static method to discovert targets in a project.
+     */
+    static of(project: AwsCdkTypeScriptApp): Array<AwsDeploymentTarget> | undefined;
+    /**
+     * The account name for the deployment target.
+     */
+    account: string;
+    /**
+     * The AWS region for the deployment target.
+     */
+    region: string;
+    /**'
+     * AWS stage type, such as dev, stage, or prod.
+     *
+     * @default 'dev'
+     */
+    awsStageType: AwsStageType;
+    /**
+     * Deployment target role: whether this (account, region) is the primary or
+     * secondary deployment target (e.g. primary vs replica region).
+     *
+     * @default 'primary'
+     */
+    deploymentTargetRole: DeploymentTargetRoleType;
+    /**
+     * AWS environment type, such as primary or secondary.
+     *
+     * @deprecated Use `deploymentTargetRole` instead. This property is maintained for backward compatibility.
+     * @default 'primary'
+     */
+    awsEnvironmentType: AwsEnvironmentType;
+    /**
+     * The AWS profile to use for this deployment target.
+     *
+     * @default ['main'] when prod release type, ['feature/*'] when dev type
+     */
+    branches: Array<GitBranch>;
+    /**
+     * Can this deployment target be used for local development?
+     *
+     * @default true for dev environments, false for prod environments
+     */
+    localDeployment?: boolean;
+    /**
+     * Configuration when deploying to this target locally.
+     */
+    localDeploymentConfig?: AwsLocalDeploymentConfig;
+    /**
+     * Can this deployment target be used in CI deployments?
+     *
+     * @default false
+     */
+    ciDeployment?: boolean;
+    ciDeploymentConfig?: Required<CiDeploymentConfig>;
+    /**
+     * Configuration for the CDK output directory for this deployment target.
+     */
+    awsDeploymentConfig: AwsDeploymentConfig;
+    /**
+     * Per-target overrides for `cdk` CLI options.
+     *
+     * Read by `CdkCli.*OptionsFor(target)` as the second-highest layer in the
+     * precedence chain (below call-site explicit options, above per-account
+     * overrides). See {@link CdkCli} for the full chain.
+     */
+    cdkOptions?: CdkTargetOverrides;
+    constructor(project: AwsCdkTypeScriptApp, options: AwsDeploymentTargetOptions);
+    /*****************************************************************************
+     *
+     * Deploy Tasks
+     *
+     * - If local deploy, add a deploy task.
+     *
+     ****************************************************************************/
+    private configureDeployTask;
+    /*****************************************************************************
+     *
+     * Watch tasks
+     *
+     * - Configure watch task to use the branch name
+     * - configure watch task to use the correct synth output location.
+     *
+     ****************************************************************************/
+    private configureWatchTask;
+}
+
+/*******************************************************************************
+ *
+ * AWS CDK CLI Component
+ *
+ * Owns the per-project options that get layered into every `cdk` CLI
+ * invocation the generated project makes. Phase 1 covered `cdk deploy`; Phase
+ * 2 extended the component with `synth`, `watch`, `destroy`, `diff`, and
+ * `bootstrap`. Phase 5 (this revision) wires in the full per-target /
+ * per-account override surface and the generic {@link mergeCdkOptions} folder.
+ *
+ * ## Override precedence
+ *
+ * Each `*OptionsFor(target)` accessor folds the layers below in
+ * **lowest-precedence-first** order; the rightmost (highest) layer wins on
+ * scalar collisions, arrays concat-and-dedupe across layers, and record-valued
+ * fields merge one level deep with the higher layer winning on key collisions.
+ *
+ * 1. **Per-stage built-in default** — from `CDK_*_DEFAULTS_BY_STAGE` for the
+ *    target's {@link AwsDeploymentTarget.awsStageType}.
+ * 2. **Per-stage consumer override** — from this component's
+ *    `<command>Defaults[stage]` map.
+ * 3. **Per-account override** — from `accountOverrides[target.account][<command>]`.
+ * 4. **Per-target override** — from `target.cdkOptions.<command>`.
+ * 5. **Call-site explicit option** — passed by the caller into the renderer
+ *    directly, after the accessor returns. The accessor does not see this
+ *    layer; the caller is responsible for spreading the accessor result first
+ *    and then the call-site option on top.
+ *
+ * Auto-instantiated by {@link AwsDeploymentConfig} when absent; consumers can
+ * pre-instantiate it via `new CdkCli(project, options)` to register custom
+ * per-stage defaults and per-account overrides.
+ *
+ ******************************************************************************/
+/**
+ * Options accepted by {@link CdkCli}.
+ */
+interface CdkCliOptions {
+    /**
+     * Consumer-supplied overrides for the built-in per-stage deploy defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_DEPLOY_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly deployDefaults?: Partial<Record<AwsStageType, Partial<CdkDeployOptions>>>;
+    /**
+     * Consumer-supplied overrides for the built-in per-stage synth defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_SYNTH_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly synthDefaults?: Partial<Record<AwsStageType, Partial<CdkSynthOptions>>>;
+    /**
+     * Consumer-supplied overrides for the built-in per-stage watch defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_WATCH_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly watchDefaults?: Partial<Record<AwsStageType, Partial<CdkWatchOptions>>>;
+    /**
+     * Consumer-supplied overrides for the built-in per-stage destroy defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_DESTROY_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly destroyDefaults?: Partial<Record<AwsStageType, Partial<CdkDestroyOptions>>>;
+    /**
+     * Consumer-supplied overrides for the built-in per-stage diff defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_DIFF_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly diffDefaults?: Partial<Record<AwsStageType, Partial<CdkDiffOptions>>>;
+    /**
+     * Consumer-supplied overrides for the built-in per-stage bootstrap defaults.
+     *
+     * Each entry is merged on top of
+     * {@link CDK_BOOTSTRAP_DEFAULTS_BY_STAGE} for the matching stage via
+     * {@link mergeCdkOptions}.
+     */
+    readonly bootstrapDefaults?: Partial<Record<AwsStageType, Partial<CdkBootstrapOptions>>>;
+    /**
+     * Per-account overrides keyed by AWS account ID.
+     *
+     * Each value is a {@link CdkTargetOverrides} bundle that applies to every
+     * {@link AwsDeploymentTarget} whose `account` matches the key. Sits in the
+     * precedence chain between per-stage overrides and per-target overrides —
+     * see {@link CdkCli} for the full layer order.
+     *
+     * Example: pin `--no-rollback` on every deploy into a sandbox account
+     * regardless of the target's stage:
+     *
+     * ```typescript
+     * new CdkCli(project, {
+     *   accountOverrides: {
+     *     "111122223333": { deploy: { rollback: false } },
+     *   },
+     * });
+     * ```
+     */
+    readonly accountOverrides?: Record<string, CdkTargetOverrides>;
+}
+declare class CdkCli extends Component {
+    /**
+     * Find the {@link CdkCli} component already attached to the project, if any.
+     */
+    static of(project: AwsCdkTypeScriptApp): CdkCli | undefined;
+    /**
+     * The consumer-supplied per-stage deploy default overrides.
+     */
+    readonly deployDefaults: Partial<Record<AwsStageType, Partial<CdkDeployOptions>>>;
+    /**
+     * The consumer-supplied per-stage synth default overrides.
+     */
+    readonly synthDefaults: Partial<Record<AwsStageType, Partial<CdkSynthOptions>>>;
+    /**
+     * The consumer-supplied per-stage watch default overrides.
+     */
+    readonly watchDefaults: Partial<Record<AwsStageType, Partial<CdkWatchOptions>>>;
+    /**
+     * The consumer-supplied per-stage destroy default overrides.
+     */
+    readonly destroyDefaults: Partial<Record<AwsStageType, Partial<CdkDestroyOptions>>>;
+    /**
+     * The consumer-supplied per-stage diff default overrides.
+     */
+    readonly diffDefaults: Partial<Record<AwsStageType, Partial<CdkDiffOptions>>>;
+    /**
+     * The consumer-supplied per-stage bootstrap default overrides.
+     */
+    readonly bootstrapDefaults: Partial<Record<AwsStageType, Partial<CdkBootstrapOptions>>>;
+    /**
+     * The consumer-supplied per-account overrides, keyed by AWS account ID.
+     */
+    readonly accountOverrides: Record<string, CdkTargetOverrides>;
+    constructor(project: AwsCdkTypeScriptApp, options?: CdkCliOptions);
+    /**
+     * Resolve the `cdk deploy` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. The call-site explicit layer is applied by the caller after
+     * this method returns. See {@link CdkCli} for the full chain.
+     */
+    deployOptionsFor(target: AwsDeploymentTarget): CdkDeployOptions;
+    /**
+     * Resolve the `cdk synth` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. See {@link CdkCli} for the full chain.
+     */
+    synthOptionsFor(target: AwsDeploymentTarget): CdkSynthOptions;
+    /**
+     * Resolve the `cdk watch` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. See {@link CdkCli} for the full chain.
+     */
+    watchOptionsFor(target: AwsDeploymentTarget): CdkWatchOptions;
+    /**
+     * Resolve the `cdk destroy` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. See {@link CdkCli} for the full chain.
+     */
+    destroyOptionsFor(target: AwsDeploymentTarget): CdkDestroyOptions;
+    /**
+     * Resolve the `cdk diff` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. See {@link CdkCli} for the full chain.
+     */
+    diffOptionsFor(target: AwsDeploymentTarget): CdkDiffOptions;
+    /**
+     * Resolve the `cdk bootstrap` options to use against a given target.
+     *
+     * Folds the precedence chain via {@link mergeCdkOptions}: per-stage built-in
+     * → per-stage consumer override → per-account override → per-target
+     * override. See {@link CdkCli} for the full chain.
+     */
+    bootstrapOptionsFor(target: AwsDeploymentTarget): CdkBootstrapOptions;
+}
+
+/*******************************************************************************
+ *
+ * AWS Deployment Configuration
+ *
+ * This component allows configuration of multiple AWS deployment
+ * targets, each with its own account, region, and deployment type
+ * (dev, stage, prod). It supports both local and CI deployments,
+ * with customizable settings for each target.
+ *
+ ******************************************************************************/
+declare class AwsDeploymentConfig extends Component {
+    static of(project: AwsCdkTypeScriptApp): AwsDeploymentConfig | undefined;
+    /**
+     * Environment variables to be injected into all tasks.
+     */
+    readonly env: Record<string, string>;
+    /**
+     * The relative path to the project directory from the root of the project.
+     */
+    readonly projectPath: string;
+    /**
+     * The relative path to the root of the project from the output directory.
+     */
+    readonly rootPath: string;
+    /**
+     * The output directory for the CDK synthesis, from the root directory.
+     */
+    readonly rootCdkOut: string;
+    /**
+     * The output directory for the CDK synthesis.
+     */
+    readonly cdkOut: string;
+    /**
+     * Array of targets for deployment.
+     */
+    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
+    /**
+     * The CDK CLI component that owns shared `cdk` invocation options for this
+     * project.
+     */
+    readonly cdkCli: CdkCli;
+    constructor(project: AwsCdkTypeScriptApp);
+    /*****************************************************************************
+     *
+     * Target filter helpers
+     *
+     * Return various targets for deployment scripts to use.
+     *
+     ****************************************************************************/
+    /**
+     * @returns All production deployment targets.
+     */
+    get prodTargets(): Array<AwsDeploymentTarget>;
+    get prodTargetsForCI(): Array<AwsDeploymentTarget>;
+    get prodTargetsForLocal(): Array<AwsDeploymentTarget>;
+    /**
+     *
+     * @returns All stage deployment targets.
+     */
+    get stageTargets(): Array<AwsDeploymentTarget>;
+    get stageTargetsForCI(): Array<AwsDeploymentTarget>;
+    get stageTargetsForLocal(): Array<AwsDeploymentTarget>;
+    /**
+     *
+     * @returns All dev deployment targets.
+     */
+    get devTargets(): Array<AwsDeploymentTarget>;
+    get devTargetsForCI(): Array<AwsDeploymentTarget>;
     get devTargetsForLocal(): Array<AwsDeploymentTarget>;
     /*****************************************************************************
      *
@@ -7123,6 +8532,226 @@ interface AwsOrganization {
     accounts: Array<AwsAccount>;
 }
 
+/*******************************************************************************
+ *
+ * AWS CDK CLI Defaults
+ *
+ * Per-stage default option sets the `CdkCli` component layers in when a
+ * consumer asks for the options to use against a given deployment target.
+ * Phase 1 registered defaults for `cdk deploy`; Phase 2 registers defaults for
+ * `synth`, `watch`, `destroy`, `diff`, and `bootstrap`.
+ *
+ ******************************************************************************/
+/**
+ * Per-stage defaults for `cdk deploy`.
+ *
+ * - `dev` opts into `--no-rollback` for fast iteration.
+ * - `stage` and `prod` deliberately omit `rollback` so the CLI default
+ *   (`true`, i.e. atomic deploys with rollback) applies — this is what allows
+ *   replacement-style updates to succeed in stage/prod.
+ * - `prod` pins `--method=change-set` to leave a reviewable change-set trail.
+ */
+declare const CDK_DEPLOY_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDeployOptions>>;
+/**
+ * Per-stage defaults for `cdk synth`.
+ *
+ * Every stage runs synth with `--quiet` so the synthesised template stays out
+ * of normal task logs.
+ */
+declare const CDK_SYNTH_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkSynthOptions>>;
+/**
+ * Per-stage defaults for `cdk watch`.
+ *
+ * Every stage uses `--progress=events` to stream CloudFormation events line by
+ * line. The CLI default for `cdk watch --hotswap` is already `true`, so the
+ * record leaves it unset.
+ */
+declare const CDK_WATCH_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkWatchOptions>>;
+/**
+ * Per-stage defaults for `cdk destroy`.
+ *
+ * `dev` opts into `--force` so local teardown does not prompt; `stage` and
+ * `prod` deliberately omit `force` so the CLI's confirmation prompt fires.
+ */
+declare const CDK_DESTROY_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDestroyOptions>>;
+/**
+ * Per-stage defaults for `cdk diff`.
+ *
+ * Empty by default — diff has no flags whose stage-by-stage value is obvious.
+ * Reserved for consumer overrides.
+ */
+declare const CDK_DIFF_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkDiffOptions>>;
+/**
+ * Per-stage defaults for `cdk bootstrap`.
+ *
+ * `prod` opts into `--termination-protection` so the bootstrap stack cannot be
+ * accidentally deleted; `dev` and `stage` omit it.
+ */
+declare const CDK_BOOTSTRAP_DEFAULTS_BY_STAGE: Record<AwsStageType, Partial<CdkBootstrapOptions>>;
+
+/*******************************************************************************
+ *
+ * AWS CDK CLI Option Merge
+ *
+ * Generic helper that folds a precedence-ordered list of `CdkXxxOptions`
+ * fragments into a single resolved option set. Used by every
+ * `CdkCli.*OptionsFor(target)` accessor to assemble the documented 5-level
+ * override stack (per-stage default → per-account override → per-target
+ * override → consumer override → call-site explicit) without per-command merge
+ * logic.
+ *
+ * Merge semantics (see also the `CdkCli` JSDoc):
+ *
+ * - **Scalars** (booleans, strings, numbers, enums): a non-`undefined` value in
+ *   a later (higher-precedence) layer overwrites the previous value. An
+ *   `undefined` value in a later layer is treated as "no opinion" and falls
+ *   through to whatever lower layers contributed.
+ * - **Arrays**: concatenated low → high precedence, then deduplicated preserving
+ *   document order (first occurrence wins). This lets a per-stage default seed
+ *   a list and per-target/per-account layers append to it without losing the
+ *   seeded entries.
+ * - **Records / maps** (plain object values, including `tags` and `context`
+ *   when modelled as `Record<string, string>`): merged one level deep; later
+ *   layers win on key collisions, earlier layers' keys survive otherwise.
+ * - **`undefined` layers** and **`undefined` field values** short-circuit — no
+ *   field on the output is touched by a missing layer or a `undefined` entry.
+ *
+ ******************************************************************************/
+/**
+ * Fold a precedence-ordered list of partial CDK CLI option layers into a
+ * single resolved option set.
+ *
+ * Layers are supplied in **lowest-precedence-first** order. Each subsequent
+ * layer's non-`undefined` values overwrite the previous accumulator for
+ * scalars; arrays are concatenated and deduped; record-valued fields are
+ * merged one level deep.
+ *
+ * `undefined` layers are skipped entirely. `undefined` field values within a
+ * layer are skipped per-field — they never clobber a previously set value.
+ *
+ * @typeParam TOptions - The fully resolved option interface (e.g.
+ *   `CdkDeployOptions`). The function returns `TOptions`, but the caller is
+ *   responsible for ensuring every field its consumers depend on is supplied
+ *   by at least one layer — the helper does not validate completeness.
+ */
+declare const mergeCdkOptions: <TOptions>(...layers: Array<Partial<TOptions> | undefined>) => TOptions;
+
+/**
+ * Render a `cdk deploy ...` command from the supplied options. Returns the
+ * full command string (starting with `deploy`).
+ */
+declare const renderCdkDeploy: (opts: CdkDeployOptions) => string;
+/**
+ * Render a `cdk synth ...` command from the supplied options.
+ */
+declare const renderCdkSynth: (opts: CdkSynthOptions) => string;
+/**
+ * Render a `cdk watch ...` command from the supplied options.
+ */
+declare const renderCdkWatch: (opts: CdkWatchOptions) => string;
+/**
+ * Render a `cdk destroy ...` command from the supplied options.
+ */
+declare const renderCdkDestroy: (opts: CdkDestroyOptions) => string;
+/**
+ * Render a `cdk diff ...` command from the supplied options.
+ */
+declare const renderCdkDiff: (opts: CdkDiffOptions) => string;
+/**
+ * Render a `cdk bootstrap ...` command from the supplied options.
+ */
+declare const renderCdkBootstrap: (opts: CdkBootstrapOptions) => string;
+/**
+ * Render a `cdk list ...` command from the supplied options.
+ */
+declare const renderCdkList: (opts: CdkListOptions) => string;
+/**
+ * Render a `cdk rollback ...` command from the supplied options.
+ */
+declare const renderCdkRollback: (opts: CdkRollbackOptions) => string;
+/**
+ * Render a `cdk import ...` command from the supplied options.
+ */
+declare const renderCdkImport: (opts: CdkImportOptions) => string;
+/**
+ * Render a `cdk gc ...` command from the supplied options.
+ *
+ * The CLI requires the global `--unstable=gc` flag for this command; callers
+ * are responsible for including `"gc"` in {@link CdkGlobalOptions.unstable}.
+ */
+declare const renderCdkGc: (opts: CdkGcOptions) => string;
+/**
+ * Render a `cdk drift ...` command from the supplied options.
+ */
+declare const renderCdkDrift: (opts: CdkDriftOptions) => string;
+/**
+ * Render a `cdk refactor ...` command from the supplied options.
+ */
+declare const renderCdkRefactor: (opts: CdkRefactorOptions) => string;
+/**
+ * Render a `cdk publish-assets ...` command from the supplied options.
+ */
+declare const renderCdkPublishAssets: (opts: CdkPublishAssetsOptions) => string;
+/**
+ * Render a `cdk orphan ...` command from the supplied options. Positional
+ * `logicalIds` render after the command name as quoted, space-separated
+ * arguments.
+ */
+declare const renderCdkOrphan: (opts: CdkOrphanOptions) => string;
+/**
+ * Render a `cdk init ...` command from the supplied options. The positional
+ * `template` argument renders after the command-specific flags, before the
+ * trailing tokens.
+ */
+declare const renderCdkInit: (opts: CdkInitOptions) => string;
+/**
+ * Render a `cdk migrate ...` command from the supplied options.
+ */
+declare const renderCdkMigrate: (opts: CdkMigrateOptions) => string;
+/**
+ * Render a `cdk context ...` command from the supplied options. The CLI's
+ * `--reset` flag takes a context key as its value, so `reset` is rendered
+ * as `--reset=KEY` rather than as a tri-state boolean.
+ */
+declare const renderCdkContext: (opts: CdkContextOptions) => string;
+/**
+ * Render a `cdk metadata ...` command from the supplied options. The
+ * positional `stack` argument renders after the command-specific flags
+ * (there are none beyond the inherited globals), before the trailing
+ * tokens.
+ */
+declare const renderCdkMetadata: (opts: CdkMetadataOptions) => string;
+/**
+ * Render a `cdk flags ...` command from the supplied options. `--value` and
+ * `--set` are value-taking string flags per the CLI surface; the remaining
+ * flags are tri-state booleans.
+ */
+declare const renderCdkFlags: (opts: CdkFlagsOptions) => string;
+/**
+ * Render a `cdk acknowledge ...` command from the supplied options. The
+ * positional `id` argument renders after the command-specific flags (there
+ * are none beyond the inherited globals), before the trailing tokens.
+ */
+declare const renderCdkAcknowledge: (opts: CdkAcknowledgeOptions) => string;
+/**
+ * Render a `cdk notices ...` command from the supplied options. `notices`
+ * has no command-specific flags; only the inherited globals and trailing
+ * tokens contribute output.
+ */
+declare const renderCdkNotices: (opts: CdkNoticesOptions) => string;
+/**
+ * Render a `cdk doctor ...` command from the supplied options. `doctor` has
+ * no command-specific flags; only the inherited globals and trailing tokens
+ * contribute output.
+ */
+declare const renderCdkDoctor: (opts: CdkDoctorOptions) => string;
+/**
+ * Render a `cdk docs ...` command from the supplied options. `docs` has no
+ * command-specific flags; only the inherited globals and trailing tokens
+ * contribute output.
+ */
+declare const renderCdkDocs: (opts: CdkDocsOptions) => string;
+
 /**
  * One row in the doc reference-extraction report — describes a single
  * inline-code symbol mention found in a markdown page and whether
@@ -7492,7 +9121,7 @@ declare const AuditCategory: {
     readonly LinkFailures: "linkFailures";
     /**
      * Findings produced by the fenced-sample compilation check that
-     * flags ` ```ts ` / ` ```typescript ` / ` ```tsx ` blocks in the
+     * flags `ts`, `typescript`, and `tsx` fenced code blocks in the
      * docs that fail `tsc`. Wired in by child issue #520.
      */
     readonly SampleFailures: "sampleFailures";
@@ -8418,7 +10047,7 @@ declare const VERSION: {
      */
     readonly SHARP_VERSION: "0.34.5";
     /**
-     * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
+     * Version of `@astrojs/starlight` to pin for StarlightProject scaffolding.
      */
     readonly STARLIGHT_VERSION: "0.39.2";
     /**
@@ -8426,7 +10055,7 @@ declare const VERSION: {
      */
     readonly TURBO_VERSION: "2.9.14";
     /**
-     * Version of @types/node to use across all packages (pnpm catalog).
+     * Version of `@types/node` to use across all packages (pnpm catalog).
      */
     readonly TYPES_NODE_VERSION: "25.8.0";
     /**
@@ -8790,8 +10419,8 @@ declare class PnpmWorkspace extends Component {
      * Get the pnpm workspace component of a project. If it does not exist,
      * return undefined.
      *
-     * @param project
-     * @returns
+     * @param project - The project to query.
+     * @returns The PnpmWorkspace component if present, otherwise undefined.
      */
     static of(project: Project$1): PnpmWorkspace | undefined;
     /**
@@ -9157,7 +10786,7 @@ interface VitestConfigOptions {
     /**
      * Glob patterns for test files.
      *
-     * @default ["**\/*.{test,spec}.?(c|m)[jt]s?(x)"]
+     * @default `["**\/*.{test,spec}.?(c|m)[jt]s?(x)"]`
      */
     readonly include?: string[];
     /**
@@ -9299,7 +10928,7 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * `.api-extractor/` and are gitignored). Set to `false` to opt a
      * package out of drift detection entirely.
      *
-     * @default {}
+     * @default `{}`
      */
     readonly apiExtractor?: ApiExtractorOptions | false;
     /**
@@ -9318,7 +10947,7 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * `internal` tag — even when the token sits inside a backtick code span
      * — and that strips this field from the published `.d.ts` rollup.
      *
-     * @default {}
+     * @default `{}`
      */
     readonly tsdocConfig?: TsdocConfigOptions | false;
     /**
@@ -9460,7 +11089,7 @@ declare class AwsDeployWorkflow extends Component {
      * Handles both exact matches (e.g., "main") and glob patterns (e.g., "feature/*").
      * Also allows workflow_dispatch (manual runs) to proceed.
      *
-     * @param branches Array of GitBranch objects with branch patterns
+     * @param branches - Array of GitBranch objects with branch patterns
      * @returns Condition string or empty string if no branches provided
      */
     private buildBranchFilterCondition;
@@ -9667,7 +11296,7 @@ interface TurboRepoOptions {
     /**
      * Version of turborepo to use.
      *
-     * @default: specified in versions file
+     * @default specified in versions file
      */
     readonly turboVersion?: string;
     /**
@@ -9716,7 +11345,7 @@ interface TurboRepoOptions {
      */
     readonly globalPassThroughEnv?: Array<string>;
     /**
-     * @default: "stream"
+     * @default "stream"
      *
      * Select a terminal UI for the repository.
      *
@@ -9727,7 +11356,7 @@ interface TurboRepoOptions {
      */
     readonly ui?: "tui" | "stream";
     /**
-     * @default: false
+     * @default false
      *
      * Turborepo uses your repository's lockfile to determine caching behavior,
      * Package Graphs, and more. Because of this, we use the packageManager field
@@ -9744,7 +11373,7 @@ interface TurboRepoOptions {
      */
     readonly dangerouslyDisablePackageManagerCheck?: boolean;
     /**
-     * @default: ".turbo/cache"
+     * @default ".turbo/cache"
      *
      * Specify the filesystem cache directory.
      *
@@ -9761,7 +11390,7 @@ interface TurboRepoOptions {
      */
     readonly daemon?: boolean;
     /**
-     * @default: "strict"
+     * @default "strict"
      *
      * Turborepo's Environment Modes allow you to control which environment
      * variables are available to a task at runtime:
@@ -9786,7 +11415,7 @@ interface TurboRepoOptions {
     /**
      * Env Args that will bre added to turbo's build:all task
      *
-     * @default: {}
+     * @default `{}`
      */
     readonly buildAllTaskEnvVars?: Record<string, string>;
     /*****************************************************************************
@@ -9798,31 +11427,31 @@ interface TurboRepoOptions {
     /**
      * Pre compile task
      *
-     * @default: "pre-compile"
+     * @default "pre-compile"
      */
     readonly preCompileTask?: Task;
     /**
      * Compile task
      *
-     * @default: "compile"
+     * @default "compile"
      */
     readonly compileTask?: Task;
     /**
      * Post compile task
      *
-     * @default: "post-compile"
+     * @default "post-compile"
      */
     readonly postCompileTask?: Task;
     /**
      * Test task
      *
-     * @default: "test"
+     * @default "test"
      */
     readonly testTask?: Task;
     /**
      * Package task
      *
-     * @default: "package"
+     * @default "package"
      */
     readonly packageTask?: Task;
 }
@@ -9883,7 +11512,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly globalPassThroughEnv: Array<string>;
     /**
-     * @default: "stream"
+     * @default "stream"
      *
      * Select a terminal UI for the repository.
      *
@@ -9894,7 +11523,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly ui: "tui" | "stream";
     /**
-     * @default: false
+     * @default false
      *
      * Turborepo uses your repository's lockfile to determine caching behavior,
      * Package Graphs, and more. Because of this, we use the packageManager field
@@ -9911,7 +11540,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly dangerouslyDisablePackageManagerCheck: boolean;
     /**
-     * @default: ".turbo/cache"
+     * @default ".turbo/cache"
      *
      * Specify the filesystem cache directory.
      *
@@ -9927,7 +11556,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly daemon: boolean;
     /**
-     * @default: "strict"
+     * @default "strict"
      *
      * Turborepo's Environment Modes allow you to control which environment
      * variables are available to a task at runtime:
@@ -10144,7 +11773,7 @@ interface MonorepoProjectOptions extends Omit<TypeScriptProjectOptions$1, "defau
         /**
          * The version of PNPM to use in the monorepo.
          * @default VERSION.PNPM_VERSION
-         * @see {@link src/versions.ts}
+         * @see `src/versions.ts`
          */
         version?: string;
         /**
@@ -10162,7 +11791,7 @@ interface MonorepoProjectOptions extends Omit<TypeScriptProjectOptions$1, "defau
      */
     readonly approveMergeUpgradeOptions?: ApproveMergeUpgradeOptions;
     /**
-     * Whether this monorepo consumes @codedrifters/configulator from a registry (npm).
+     * Whether this monorepo consumes `@codedrifters/configulator` from a registry (npm).
      * When true, the upgrade workflow adds steps to sync configulator and synthesize.
      * Set to false when configulator is developed in this repo (e.g. workspace dependency).
      *
@@ -10178,7 +11807,7 @@ interface MonorepoProjectOptions extends Omit<TypeScriptProjectOptions$1, "defau
      * - `ProjectMetadataOptions`: explicit metadata configuration
      * - `false`: disable ProjectMetadata entirely
      *
-     * @default {} (auto-detect from package.json)
+     * @default `{}` (auto-detect from package.json)
      */
     readonly projectMetadata?: ProjectMetadataOptions | false;
     /**
@@ -10452,8 +12081,8 @@ declare class ProjectMetadata extends Component {
     /**
      * Return the maintainer-seed addendum for the `project-context`
      * bundle, or an empty string when the root project either has no
-     * layout-enforcement opinion or has opted out (`layoutEnforcement:
-     * "off"`).
+     * layout-enforcement opinion or has opted out
+     * (`layoutEnforcement: "off"`).
      *
      * Uses duck-typing on the root project's `layoutEnforcement`
      * property to avoid a circular import with `MonorepoProject`. The
@@ -10678,7 +12307,7 @@ interface StarlightProjectOptions extends AstroProjectOptions {
      */
     readonly editLink?: StarlightEditLink;
     /**
-     * @astrojs/starlight package version.
+     * `@astrojs/starlight` package version.
      *
      * @default VERSION.STARLIGHT_VERSION
      */
@@ -10730,7 +12359,7 @@ declare const COMPLETE_JOB_ID = "complete";
  * Call this for the default build workflow and for any build workflow created
  * by Configulator (e.g. AwsDeployWorkflow).
  *
- * @param buildWorkflow The Projen BuildWorkflow to append the complete job to.
+ * @param buildWorkflow - The Projen BuildWorkflow to append the complete job to.
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
@@ -10758,7 +12387,7 @@ declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
  *    (e.g. the upgrade workflow). Steps held inside lazy closures
  *    are skipped — those are reached via pass 1.
  *
- * @param project The project whose GitHub workflows should be patched.
+ * @param project - The project whose GitHub workflows should be patched.
  */
 declare function pinPnpmActionSetup(project: Project$1): void;
 
@@ -10806,8 +12435,8 @@ declare function pinPnpmActionSetup(project: Project$1): void;
  * untouched. The step's `uses` field is also left alone — this
  * helper pins the input, not the action version pin.
  *
- * @param project The project whose GitHub workflows should be patched.
+ * @param project - The project whose GitHub workflows should be patched.
  */
 declare function pinSetupNodeVersion(project: Project$1): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, type ActivateBranchNameEnvVarOptions, type AddStorybookOptions, type AgentCommand, AgentConfig, type AgentConfigOptions, type AgentExpansionRules, type AgentFeaturesConfig, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRegistryEntry, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, type ApiDiffCheckOptions, type ApiDiffFinding, type ApiDiffResult, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApiSurfaceEntry, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, type BundleOwnership, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudeMdConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, 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, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type EffectiveScopeThresholds, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueDefaultsConfig, type IssueDefaultsOverride, type IssueDefaultsPriority, type IssueDefaultsStatus, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, Nvmrc, type OrganizationMetadata, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, type ReactViteSiteProjectOptions, type ReferenceMismatchCheckOptions, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueDefaults, type ResolvedIssueDefaultsEntry, type ResolvedIssueTemplates, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedScopeGateBundleOverride, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedTemporalFraming, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateBundleOverride, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, TEMPORAL_FRAMING_CATEGORY_VALUES, type TemplateResolveResult, type TemporalFramingCategory, type TemporalFramingConfig, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, TsdocConfig, type TsdocConfigOptions, type TsdocCoverageCheckOptions, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, type UpstreamConfigulatorConfig, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, 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 };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, type ActivateBranchNameEnvVarOptions, type AddStorybookOptions, type AgentCommand, AgentConfig, type AgentConfigOptions, type AgentExpansionRules, type AgentFeaturesConfig, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRegistryEntry, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type AgentTier, type AgentTierConfig, type AgentTierEntry, type AnalyzeTsDocCoverageOptions, type ApiDiffCheckOptions, type ApiDiffFinding, type ApiDiffResult, ApiExtractor, type ApiExtractorOptions, type ApiExtractorReportOptions, type ApiSurfaceEntry, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, AuditCategory, type AuditCheckRunner, type AuditCheckRunnerContext, type AuditFinding, type AuditFindingBase, type AuditLocation, AuditMode, type AuditReport, AuditSeverity, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, type BundleOwnership, 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, type CdkAcknowledgeOptions, type CdkBootstrapOptions, CdkCli, type CdkCliOptions, type CdkContextOptions, type CdkDeployMethod, type CdkDeployOptions, type CdkDestroyOptions, type CdkDiffMethod, type CdkDiffOptions, type CdkDocsOptions, type CdkDoctorOptions, type CdkDriftOptions, type CdkFlagsOptions, type CdkGcAction, type CdkGcOptions, type CdkGcType, type CdkGlobalOptions, type CdkImportOptions, type CdkInitLanguage, type CdkInitOptions, type CdkInitTemplate, type CdkListOptions, type CdkMetadataOptions, type CdkMigrateOptions, type CdkNoticesOptions, type CdkOrphanOptions, type CdkProgress, type CdkPublishAssetsOptions, type CdkRefactorOptions, type CdkRequireApproval, type CdkRollbackOptions, type CdkSynthOptions, type CdkTargetOverrides, type CdkWatchOptions, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudeMdConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CompileFencedSamplesOptions, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type CustomDocSection, 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, type DeployWorkflowOptions, type DeploymentMetadata, type DocReferenceRecord, type EffectiveScopeThresholds, type ExtractDocReferencesOptions, type ExtractFencedSamplesOptions, type FencedSampleRecord, type FocusArea, type FocusAreaMatch, type FocusConfig, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, type IssueDefaultsConfig, type IssueDefaultsOverride, type IssueDefaultsPriority, type IssueDefaultsStatus, type IssueTemplatesConfig, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, type LinkFailureFinding, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MeetingArea, type MeetingScope, type MeetingType, type MeetingTypeKind, type MeetingsConfig, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, Nvmrc, type OrganizationMetadata, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, type PnpmWorkspaceOptions, type PriorityRule, type ProgressFilesConfig, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, type ReactViteSiteProjectOptions, type ReferenceMismatchCheckOptions, type ReferenceMismatchFinding, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedAgentTier, type ResolvedIssueDefaults, type ResolvedIssueDefaultsEntry, type ResolvedIssueTemplates, type ResolvedProgressFiles, type ResolvedProjectMetadata, type ResolvedRunRatio, type ResolvedScheduledTask, type ResolvedScheduledTasks, type ResolvedScopeGate, type ResolvedScopeGateBundleOverride, type ResolvedSharedEditing, type ResolvedSkillEvals, type ResolvedTemporalFraming, type ResolvedUnblockDependents, type RunRatioConfig, type RunScanOptions, type RunScanResult, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, type SampleCompilationFailure, type SampleFailureFinding, SampleLang, type ScheduledTaskEntry, type ScheduledTaskModel, type ScheduledTaskOverride, type ScheduledTasksConfig, type ScopeClass, type ScopeGateBundleOverride, type ScopeGateConfig, type ScopeGateThresholds, type SharedEditingConfig, type SkillEvalsConfig, type SlackMetadata, type SourceTierExamples, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, TEMPORAL_FRAMING_CATEGORY_VALUES, type TemplateResolveResult, type TemporalFramingCategory, type TemporalFramingConfig, TestRunner, TsDocCoverageKind, type TsDocCoverageRecord, TsdocConfig, type TsdocConfigOptions, type TsdocCoverageCheckOptions, type TsdocCoverageFinding, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, UNKNOWN_TYPE_FALLBACK_TIER, type UnblockDependentsConfig, type UpstreamConfigulatorConfig, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, 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, 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 };