@codedrifters/configulator 0.0.317 → 0.0.319

package/lib/index.d.ts

@@ -81,7 +81,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)
  */
@@ -131,7 +131,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)
          */
@@ -269,10 +269,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`). */
@@ -452,7 +454,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 {
     /**
@@ -580,7 +582,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$1) => boolean;
     /**
@@ -593,7 +595,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$1) => ReadonlyArray<Project$1>;
     /** Rules included in this bundle. */
@@ -1380,11 +1382,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"
@@ -2877,7 +2879,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">>;
     /**
@@ -4467,7 +4469,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.
      */
@@ -4481,7 +4483,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.
      */
@@ -4934,10 +4936,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;
 /**
@@ -6416,7 +6418,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;
@@ -6465,7 +6467,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>>;
 }
@@ -6490,7 +6492,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;
@@ -6763,7 +6765,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;
     /**
@@ -6836,265 +6838,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>;
     /*****************************************************************************
      *
@@ -7172,6 +8581,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
@@ -7541,7 +9170,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";
@@ -8467,7 +10096,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";
     /**
@@ -8475,7 +10104,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";
     /**
@@ -8839,8 +10468,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): PnpmWorkspace | undefined;
     /**
@@ -9206,7 +10835,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[];
     /**
@@ -9348,7 +10977,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;
     /**
@@ -9367,7 +10996,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;
     /**
@@ -9509,7 +11138,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;
@@ -9716,7 +11345,7 @@ interface TurboRepoOptions {
     /**
      * Version of turborepo to use.
      *
-     * @default: specified in versions file
+     * @default specified in versions file
      */
     readonly turboVersion?: string;
     /**
@@ -9765,7 +11394,7 @@ interface TurboRepoOptions {
      */
     readonly globalPassThroughEnv?: Array<string>;
     /**
-     * @default: "stream"
+     * @default "stream"
      *
      * Select a terminal UI for the repository.
      *
@@ -9776,7 +11405,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
@@ -9793,7 +11422,7 @@ interface TurboRepoOptions {
      */
     readonly dangerouslyDisablePackageManagerCheck?: boolean;
     /**
-     * @default: ".turbo/cache"
+     * @default ".turbo/cache"
      *
      * Specify the filesystem cache directory.
      *
@@ -9810,7 +11439,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:
@@ -9835,7 +11464,7 @@ interface TurboRepoOptions {
     /**
      * Env Args that will bre added to turbo's build:all task
      *
-     * @default: {}
+     * @default `{}`
      */
     readonly buildAllTaskEnvVars?: Record<string, string>;
     /*****************************************************************************
@@ -9847,31 +11476,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;
 }
@@ -9932,7 +11561,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly globalPassThroughEnv: Array<string>;
     /**
-     * @default: "stream"
+     * @default "stream"
      *
      * Select a terminal UI for the repository.
      *
@@ -9943,7 +11572,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
@@ -9960,7 +11589,7 @@ declare class TurboRepo extends Component$1 {
      */
     readonly dangerouslyDisablePackageManagerCheck: boolean;
     /**
-     * @default: ".turbo/cache"
+     * @default ".turbo/cache"
      *
      * Specify the filesystem cache directory.
      *
@@ -9976,7 +11605,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:
@@ -10193,7 +11822,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;
         /**
@@ -10211,7 +11840,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).
      *
@@ -10227,7 +11856,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;
     /**
@@ -10501,8 +12130,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
@@ -10727,7 +12356,7 @@ interface StarlightProjectOptions extends AstroProjectOptions {
      */
     readonly editLink?: StarlightEditLink;
     /**
-     * @astrojs/starlight package version.
+     * `@astrojs/starlight` package version.
      *
      * @default VERSION.STARLIGHT_VERSION
      */
@@ -10779,7 +12408,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;
 
@@ -10807,7 +12436,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): void;
 
@@ -10855,9 +12484,9 @@ declare function pinPnpmActionSetup(project: Project): 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): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_BUNDLE_OVERRIDES, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_PRIORITY, DEFAULT_ISSUE_STATUS, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_RESOLVED_ISSUE_DEFAULTS, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TEMPORAL_FRAMING_CADENCES, DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER, DEFAULT_TEMPORAL_FRAMING_ENABLED, DEFAULT_TEMPORAL_FRAMING_PATHS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, Nvmrc, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, SampleLang, StarlightProject, TEMPORAL_FRAMING_CATEGORY_VALUES, TestRunner, TsDocCoverageKind, TsdocConfig, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addPlaywright, addStorybook, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildAgentRegistryRule, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildMeetingAnalysisBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, bundleNameForWorkflowRule, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, hasAnyDocsEmittingBundle, hasAnyDownstreamIssueKindBundle, industryDiscoveryBundle, isPhaseLabelOwnedByExcluded, isScheduledTaskOwnedByExcluded, isSuppressedWorkflowRule, isTypeLabelOwnedByExcluded, jestBundle, labelsForPhase, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, parseApiRollup, peopleProfileBundle, persistAuditReport, pinPnpmActionSetup, pinSetupNodeVersion, pnpmBundle, prReviewBundle, projenBundle, referenceRecordToFinding, regulatoryResearchBundle, renderAgentTierCaseStatement, renderAgentTierSection, renderCheckDocSamplesProcedure, renderCheckLinksProcedure, renderCustomDocSectionBlock, renderCustomDocSections, renderExtractApiProcedure, renderFocusSection, renderIssueTemplatesBundleHook, renderIssueTemplatesCheckerScript, renderIssueTemplatesRuleContent, renderIssueTemplatesStarterPage, renderMeetingTypesSection, renderPriorityRulesSection, renderProgressFileName, renderProgressFilePath, renderProgressFilesBundleHook, renderProgressFilesRuleContent, renderRunRatioSection, renderRunRatioShellHelpers, renderScheduledTaskSkillFile, renderScheduledTasksSection, renderScopeGateSection, renderScopeGateShellHelpers, renderSharedEditingBundleHook, renderSharedEditingHelperScript, renderSharedEditingRuleContent, renderSkillEvalsBundleHook, renderSkillEvalsRuleContent, renderSkillEvalsRunnerScript, renderSourceTierExamples, renderStubIndexConventionRuleContent, renderTemporalFramingCheckerScript, renderTemporalFramingRuleContent, renderUnblockDependentsScript, renderUnblockDependentsSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAgentTiers, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveIssueDefaults, resolveIssueTemplates, resolveModelAlias, resolveOrchestratorAssets, resolveOutdirFromPackageName, resolveOverrideForLabels, resolveProgressFiles, resolveReactViteSiteProjectOutdir, resolveRunRatio, resolveScheduledTasks, resolveScopeGate, resolveSharedEditing, resolveSkillEvals, resolveTemplateVariables, resolveTemporalFraming, resolveTypeScriptProjectOutdir, resolveUnblockDependents, runScan, slackBundle, softwareProfileBundle, standardsResearchBundle, tsdocRecordToFindings, turborepoBundle, typescriptBundle, upstreamConfigulatorDocsBundle, validateAgentTierConfig, validateIssueDefaultsConfig, validateIssueTemplatesConfig, validateMonorepoLayout, validateProgressFilesConfig, validateRunRatioConfig, validateScheduledTasksConfig, validateScopeGateConfig, validateSharedEditingConfig, validateSkillEvalsConfig, validateStarlightSingleton, validateTemporalFramingConfig, validateUnblockDependentsConfig, vitestBundle };
-export type { ActivateBranchNameEnvVarOptions, AddStorybookOptions, AgentCommand, AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRegistryEntry, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffCheckOptions, ApiDiffFinding, ApiDiffResult, ApiExtractorOptions, ApiExtractorReportOptions, ApiSurfaceEntry, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, BundleOwnership, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudeMdConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, EffectiveScopeThresholds, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueDefaultsConfig, IssueDefaultsOverride, IssueDefaultsPriority, IssueDefaultsStatus, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReactViteSiteProjectOptions, ReferenceMismatchCheckOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueDefaults, ResolvedIssueDefaultsEntry, ResolvedIssueTemplates, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedScopeGateBundleOverride, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedTemporalFraming, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateBundleOverride, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TemporalFramingCategory, TemporalFramingConfig, TsDocCoverageRecord, TsdocConfigOptions, TsdocCoverageCheckOptions, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, UpstreamConfigulatorConfig, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_REGISTRY_ENTRIES, AGENT_RULE_SCOPE, AGENT_TIER_ROLES, AGENT_TIER_VALUES, AUDIT_CATEGORY_ORDER, AgentConfig, ApiExtractor, AstroConfig, AstroOutput, AstroProject, AuditCategory, AuditMode, AuditSeverity, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, BUNDLE_OWNERSHIP, CDK_BOOTSTRAP_DEFAULTS_BY_STAGE, CDK_DEPLOY_DEFAULTS_BY_STAGE, CDK_DEPLOY_METHOD, CDK_DESTROY_DEFAULTS_BY_STAGE, CDK_DIFF_DEFAULTS_BY_STAGE, CDK_DIFF_METHOD, CDK_GC_ACTION, CDK_GC_TYPE, CDK_INIT_LANGUAGE, CDK_INIT_TEMPLATE, CDK_PROGRESS, CDK_REQUIRE_APPROVAL, CDK_SYNTH_DEFAULTS_BY_STAGE, CDK_WATCH_DEFAULTS_BY_STAGE, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, CdkCli, DEFAULT_AC_THRESHOLDS, DEFAULT_AGENT_PATHS, DEFAULT_AGENT_TIERS, DEFAULT_API_EXTRACTOR_CONFIG_FILE, DEFAULT_API_EXTRACTOR_ENTRY_POINT, DEFAULT_API_EXTRACTOR_REPORT_FILENAME, DEFAULT_API_EXTRACTOR_REPORT_FOLDER, DEFAULT_AUDIT_REPORT_DIR, DEFAULT_BUNDLE_OVERRIDES, DEFAULT_DECOMPOSITION_TEMPLATE, DEFAULT_DISPATCH_MODEL, DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO, DEFAULT_HOUSEKEEPING_MODEL, DEFAULT_ISSUE_PRIORITY, DEFAULT_ISSUE_STATUS, DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS, DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER, DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER, DEFAULT_ISSUE_TEMPLATES_ENABLED, DEFAULT_ISSUE_TEMPLATES_PATH, DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE, DEFAULT_OFF_PEAK_CRON_EXAMPLE, DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_PRIORITY_LABELS, DEFAULT_PRODUCT_CONTEXT_PATH, DEFAULT_PROGRESS_FILES_ENABLED, DEFAULT_PROGRESS_FILES_FILENAME_PATTERN, DEFAULT_PROGRESS_FILES_FORMAT, DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS, DEFAULT_PROGRESS_FILES_STATE_DIR, DEFAULT_REQUIRE_PRODUCT_CONTEXT, DEFAULT_RESOLVED_ISSUE_DEFAULTS, DEFAULT_SAMPLE_COMPILER_OPTIONS, DEFAULT_SCHEDULED_TASKS_ROOT, DEFAULT_SCHEDULED_TASK_ENTRIES, DEFAULT_SHARED_EDITING_CONFLICT_STRATEGY, DEFAULT_SHARED_EDITING_EMIT_HELPER, DEFAULT_SHARED_EDITING_ENABLED, DEFAULT_SHARED_EDITING_VERIFY_COMMIT, DEFAULT_SHARED_INDEX_PATHS, DEFAULT_SKILL_EVALS_EMIT_RUNNER, DEFAULT_SKILL_EVALS_ENABLED, DEFAULT_SKILL_EVALS_SKILLS_ROOT, DEFAULT_SOURCES_THRESHOLDS, DEFAULT_STATE_FILE_PATH, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TEMPORAL_FRAMING_CADENCES, DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER, DEFAULT_TEMPORAL_FRAMING_ENABLED, DEFAULT_TEMPORAL_FRAMING_PATHS, DEFAULT_TYPE_LABELS, DEFAULT_UNBLOCK_COMMENT_TEMPLATE, DEFAULT_UNBLOCK_DEPENDENTS_ENABLED, DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED, DOCS_SYNC_AUDIT_SCHEMA_VERSION, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MAX_LABEL_DESCRIPTION_LENGTH, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, Nvmrc, PROD_DEPLOY_NAME, PROGRESS_FILES_FORMAT_VALUES, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ReactViteSiteProject, ResetTask, SCHEDULED_TASK_MODEL_VALUES, SCOPE_CLASS_VALUES, SHARED_EDITING_CONFLICT_STRATEGY_VALUES, STARLIGHT_ROLE, SUPPRESSED_WORKFLOW_RULE_NAMES, SampleLang, StarlightProject, TEMPORAL_FRAMING_CATEGORY_VALUES, TestRunner, TsDocCoverageKind, TsdocConfig, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, UNKNOWN_TYPE_FALLBACK_TIER, VALID_PRIORITY_VALUES, VALID_STATUS_VALUES, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addPlaywright, addStorybook, addSyncLabelsWorkflow, agendaBundle, analyzeTsDocCoverage, auditReportJsonSchema, awsCdkBundle, baseBundle, bcmWriterBundle, buildAgentRegistryRule, buildBaseBundle, buildBcmWriterBundle, buildBuiltInBundles, buildBusinessModelsBundle, buildCheckBlockedProcedure, buildCompanyProfileBundle, buildCustomerProfileBundle, buildDocsSyncBundle, buildIndustryDiscoveryBundle, buildMaintenanceAuditBundle, buildMeetingAnalysisBundle, buildOrchestratorConventionsContent, buildPeopleProfileBundle, buildRegulatoryResearchBundle, buildReport, buildRequirementsAnalystBundle, buildRequirementsReviewerBundle, buildRequirementsWriterBundle, buildResearchPipelineBundle, buildSoftwareProfileBundle, buildStandardsResearchBundle, buildUnblockDependentsProcedure, bundleNameForWorkflowRule, businessModelsBundle, checkDocSamplesProcedure, checkLinksProcedure, classifyIssueScope, classifyRun, companyProfileBundle, compileFencedSamples, createApiDiffCheck, createReferenceMismatchCheck, createTsdocCoverageCheck, customerProfileBundle, diffApiRollups, docsSyncBundle, emptyCategoryBuckets, extractApiProcedure, extractDocReferences, extractFencedSamples, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, hasAnyDocsEmittingBundle, hasAnyDownstreamIssueKindBundle, 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 };
+export type { ActivateBranchNameEnvVarOptions, AddStorybookOptions, AgentCommand, AgentConfigOptions, AgentExpansionRules, AgentFeaturesConfig, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRegistryEntry, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, AgentTier, AgentTierConfig, AgentTierEntry, AnalyzeTsDocCoverageOptions, ApiDiffCheckOptions, ApiDiffFinding, ApiDiffResult, ApiExtractorOptions, ApiExtractorReportOptions, ApiSurfaceEntry, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AuditCheckRunner, AuditCheckRunnerContext, AuditFinding, AuditFindingBase, AuditLocation, AuditReport, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, BundleOwnership, CdkAcknowledgeOptions, CdkBootstrapOptions, CdkCliOptions, CdkContextOptions, CdkDeployMethod, CdkDeployOptions, CdkDestroyOptions, CdkDiffMethod, CdkDiffOptions, CdkDocsOptions, CdkDoctorOptions, CdkDriftOptions, CdkFlagsOptions, CdkGcAction, CdkGcOptions, CdkGcType, CdkGlobalOptions, CdkImportOptions, CdkInitLanguage, CdkInitOptions, CdkInitTemplate, CdkListOptions, CdkMetadataOptions, CdkMigrateOptions, CdkNoticesOptions, CdkOrphanOptions, CdkProgress, CdkPublishAssetsOptions, CdkRefactorOptions, CdkRequireApproval, CdkRollbackOptions, CdkSynthOptions, CdkTargetOverrides, CdkWatchOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudeMdConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CompileFencedSamplesOptions, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, CustomDocSection, DeployWorkflowOptions, DeploymentMetadata, DocReferenceRecord, EffectiveScopeThresholds, ExtractDocReferencesOptions, ExtractFencedSamplesOptions, FencedSampleRecord, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, IssueDefaultsConfig, IssueDefaultsOverride, IssueDefaultsPriority, IssueDefaultsStatus, IssueTemplatesConfig, LabelDefinition, LayoutEnforcement, LayoutViolation, LinkFailureFinding, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingTypeKind, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProgressFilesConfig, ProjectMetadataOptions, ReactViteSiteProjectOptions, ReferenceMismatchCheckOptions, ReferenceMismatchFinding, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedAgentTier, ResolvedIssueDefaults, ResolvedIssueDefaultsEntry, ResolvedIssueTemplates, ResolvedProgressFiles, ResolvedProjectMetadata, ResolvedRunRatio, ResolvedScheduledTask, ResolvedScheduledTasks, ResolvedScopeGate, ResolvedScopeGateBundleOverride, ResolvedSharedEditing, ResolvedSkillEvals, ResolvedTemporalFraming, ResolvedUnblockDependents, RunRatioConfig, RunScanOptions, RunScanResult, SampleCompilationFailure, SampleFailureFinding, ScheduledTaskEntry, ScheduledTaskModel, ScheduledTaskOverride, ScheduledTasksConfig, ScopeClass, ScopeGateBundleOverride, ScopeGateConfig, ScopeGateThresholds, SharedEditingConfig, SkillEvalsConfig, SlackMetadata, SourceTierExamples, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TemporalFramingCategory, TemporalFramingConfig, TsDocCoverageRecord, TsdocConfigOptions, TsdocCoverageCheckOptions, TsdocCoverageFinding, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, UnblockDependentsConfig, UpstreamConfigulatorConfig, VersionKey, VitestConfigOptions, VitestOptions };