@codedrifters/configulator 0.0.196 → 0.0.197

package/lib/index.d.mts

@@ -2462,88 +2462,6 @@ declare class AwsDeployWorkflow extends Component {
     preSynthesize(): void;
 }
 
-/**
- * Configuration options for AwsCdkProject.
- *
- * AwsCdkProject must be parented to a `MonorepoProject` — the constructor
- * throws otherwise. Configulator assumes a single-package repo is still a
- * monorepo (with one workspace) so all conventions hold uniformly.
- */
-interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "defaultReleaseBranch"> {
-    /**
-     * AWS deployment targets (dev / stage / prod accounts and regions). Each
-     * entry creates an `AwsDeploymentTarget` component on the project.
-     */
-    readonly deploymentTargets?: Array<AwsDeploymentTargetOptions>;
-    /**
-     * AWS deploy workflows. If omitted, one workflow is auto-generated per
-     * unique `awsStageType` present in `deploymentTargets`. Each auto-generated
-     * workflow renders to its own `.github/workflows/*.yml` file.
-     *
-     * Pass an empty array (`[]`) to opt out of auto-derivation entirely without
-     * supplying any workflows of your own — the array is truthy and short-circuits
-     * the default. Useful when you intend to attach deploy jobs to an existing
-     * build workflow yourself.
-     */
-    readonly deployWorkflows?: Array<DeployWorkflowOptions>;
-    /**
-     * Optional shared `BuildWorkflow` to attach all auto-derived deploy jobs to.
-     * When set, every workflow generated from `deploymentTargets` re-uses this
-     * build workflow instead of creating its own. Default behavior (omit) is one
-     * separate yml file per stage type.
-     *
-     * Distinct from `buildWorkflow: boolean` inherited from
-     * `AwsCdkTypeScriptAppOptions`, which toggles whether the projen-managed
-     * build workflow is generated at all.
-     */
-    readonly sharedBuildWorkflow?: BuildWorkflow;
-    /**
-     * Test runner to use.
-     *
-     * @default TestRunner.JEST
-     */
-    readonly testRunner?: TestRunner;
-    /**
-     * Options for Vitest (only used when testRunner is 'vitest').
-     */
-    readonly vitestOptions?: VitestOptions;
-    /**
-     * Enable the reset task that deletes all build artifacts.
-     *
-     * @default true
-     */
-    readonly resetTask?: boolean;
-    /**
-     * Options for the reset task.
-     */
-    readonly resetTaskOptions?: ResetTaskOptions;
-    /**
-     * AI agent configuration (Cursor, Claude Code rules). Opt-in per project;
-     * not inherited from the parent `MonorepoProject`.
-     *
-     * @default false
-     */
-    readonly agentConfig?: AgentConfigOptions | boolean;
-}
-/**
- * AWS CDK TypeScript application with CodeDrifters conventions baked in.
- *
- * Always creates an `AwsDeploymentConfig` component (even with zero deployment
- * targets) so the `synth` task is consistently rewritten to emit into
- * `dist/<project-path>/cdk.out`. This is intentional and not opt-out: it
- * funnels every package's CDK output into one root-level `dist/` tree so
- * GitHub Actions workflows can pass artifacts between jobs uniformly.
- */
-declare class AwsCdkProject extends awscdk.AwsCdkTypeScriptApp {
-    constructor(userOptions: AwsCdkProjectOptions);
-    /**
-     * Add an AWS deployment target to this project after construction. The
-     * target is registered on the existing `AwsDeploymentConfig` and immediately
-     * available for `AwsDeployWorkflow` consumption.
-     */
-    addDeploymentTarget(options: AwsDeploymentTargetOptions): AwsDeploymentTarget;
-}
-
 /**
  * Each of the below options corresponds to a task property found here:
  *  * https://turborepo.com/docs/reference/configuration#defining-tasks
@@ -3150,6 +3068,140 @@ declare class MonorepoProject extends TypeScriptAppProject {
     postSynthesize(): void;
 }
 
+/**
+ * Default branch-delete patterns that trigger the teardown workflow.
+ */
+declare const DEFAULT_TEARDOWN_BRANCH_PATTERNS: ReadonlyArray<string>;
+/**
+ * Options for {@link AwsTeardownWorkflow}.
+ */
+interface AwsTeardownWorkflowOptions {
+    /**
+     * Targets to scan for orphaned CloudFormation stacks.
+     */
+    readonly awsDestructionTargets: Array<AwsDeploymentTarget>;
+    /**
+     * Name of the tag containing the repo name. Used to find CloudFormation
+     * stacks associated with this repo.
+     */
+    readonly repoTagName: string;
+    /**
+     * Name of the tag containing the stage type (e.g. dev, stage, prod).
+     */
+    readonly stageTypeTagName: string;
+    /**
+     * Name of the tag containing the environment type (e.g. primary, secondary).
+     */
+    readonly environmentTypeTagName: string;
+    /**
+     * Name of the tag where branch names are stored. Used to determine if a
+     * stack is orphaned (no matching branch).
+     */
+    readonly branchNameTagName: string;
+    /**
+     * Branch patterns whose deletion triggers the teardown workflow.
+     *
+     * @default ["feat/*", "fix/*", "feature/*"]
+     */
+    readonly deleteBranchPatterns?: Array<string>;
+}
+/**
+ * Scheduled GitHub Actions workflow that tears down orphaned CloudFormation
+ * stacks whose associated branch no longer exists.
+ */
+declare class AwsTeardownWorkflow extends Component {
+    rootProject: MonorepoProject;
+    constructor(rootProject: MonorepoProject, options: AwsTeardownWorkflowOptions);
+}
+
+/**
+ * Configuration options for AwsCdkProject.
+ *
+ * AwsCdkProject must be parented to a `MonorepoProject` — the constructor
+ * throws otherwise. Configulator assumes a single-package repo is still a
+ * monorepo (with one workspace) so all conventions hold uniformly.
+ */
+interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "defaultReleaseBranch"> {
+    /**
+     * AWS deployment targets (dev / stage / prod accounts and regions). Each
+     * entry creates an `AwsDeploymentTarget` component on the project.
+     */
+    readonly deploymentTargets?: Array<AwsDeploymentTargetOptions>;
+    /**
+     * AWS deploy workflows. If omitted, one workflow is auto-generated per
+     * unique `awsStageType` present in `deploymentTargets`. Each auto-generated
+     * workflow renders to its own `.github/workflows/*.yml` file.
+     *
+     * Pass an empty array (`[]`) to opt out of auto-derivation entirely without
+     * supplying any workflows of your own — the array is truthy and short-circuits
+     * the default. Useful when you intend to attach deploy jobs to an existing
+     * build workflow yourself.
+     */
+    readonly deployWorkflows?: Array<DeployWorkflowOptions>;
+    /**
+     * Optional shared `BuildWorkflow` to attach all auto-derived deploy jobs to.
+     * When set, every workflow generated from `deploymentTargets` re-uses this
+     * build workflow instead of creating its own. Default behavior (omit) is one
+     * separate yml file per stage type.
+     *
+     * Distinct from `buildWorkflow: boolean` inherited from
+     * `AwsCdkTypeScriptAppOptions`, which toggles whether the projen-managed
+     * build workflow is generated at all.
+     */
+    readonly sharedBuildWorkflow?: BuildWorkflow;
+    /**
+     * Test runner to use.
+     *
+     * @default TestRunner.JEST
+     */
+    readonly testRunner?: TestRunner;
+    /**
+     * Options for Vitest (only used when testRunner is 'vitest').
+     */
+    readonly vitestOptions?: VitestOptions;
+    /**
+     * Enable the reset task that deletes all build artifacts.
+     *
+     * @default true
+     */
+    readonly resetTask?: boolean;
+    /**
+     * Options for the reset task.
+     */
+    readonly resetTaskOptions?: ResetTaskOptions;
+    /**
+     * AI agent configuration (Cursor, Claude Code rules). Opt-in per project;
+     * not inherited from the parent `MonorepoProject`.
+     *
+     * @default false
+     */
+    readonly agentConfig?: AgentConfigOptions | boolean;
+    /**
+     * Scheduled teardown workflow options. When provided, an `AwsTeardownWorkflow`
+     * is attached to the parent `MonorepoProject` that periodically deletes
+     * orphaned CloudFormation stacks whose branch no longer exists.
+     */
+    readonly teardownWorkflow?: AwsTeardownWorkflowOptions;
+}
+/**
+ * AWS CDK TypeScript application with CodeDrifters conventions baked in.
+ *
+ * Always creates an `AwsDeploymentConfig` component (even with zero deployment
+ * targets) so the `synth` task is consistently rewritten to emit into
+ * `dist/<project-path>/cdk.out`. This is intentional and not opt-out: it
+ * funnels every package's CDK output into one root-level `dist/` tree so
+ * GitHub Actions workflows can pass artifacts between jobs uniformly.
+ */
+declare class AwsCdkProject extends awscdk.AwsCdkTypeScriptApp {
+    constructor(userOptions: AwsCdkProjectOptions);
+    /**
+     * Add an AWS deployment target to this project after construction. The
+     * target is registered on the existing `AwsDeploymentConfig` and immediately
+     * available for `AwsDeployWorkflow` consumption.
+     */
+    addDeploymentTarget(options: AwsDeploymentTargetOptions): AwsDeploymentTarget;
+}
+
 /**
  * Provides structured project metadata consumed by AgentConfig, skills,
  * and other configulator features at synthesis time.
@@ -3218,4 +3270,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };

package/lib/index.d.ts

@@ -3,7 +3,7 @@ import { Project as Project$1, Task, Component as Component$1 } from 'projen/lib
 import { NodeProject } from 'projen/lib/javascript';
 import { AwsCdkTypeScriptApp } from 'projen/lib/awscdk';
 import * as spec from '@jsii/spec';
-import { TypeScriptProject as TypeScriptProject$1, TypeScriptAppProject, TypeScriptProjectOptions as TypeScriptProjectOptions$1 } from 'projen/lib/typescript';
+import { TypeScriptAppProject, TypeScriptProjectOptions as TypeScriptProjectOptions$1, TypeScriptProject as TypeScriptProject$1 } from 'projen/lib/typescript';
 import { ValueOf } from 'type-fest';
 import { BuildWorkflow, BuildWorkflowOptions } from 'projen/lib/build';
 import { JobStep } from 'projen/lib/github/workflows-model';
@@ -2511,88 +2511,6 @@ declare class AwsDeployWorkflow extends Component {
     preSynthesize(): void;
 }
 
-/**
- * Configuration options for AwsCdkProject.
- *
- * AwsCdkProject must be parented to a `MonorepoProject` — the constructor
- * throws otherwise. Configulator assumes a single-package repo is still a
- * monorepo (with one workspace) so all conventions hold uniformly.
- */
-interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "defaultReleaseBranch"> {
-    /**
-     * AWS deployment targets (dev / stage / prod accounts and regions). Each
-     * entry creates an `AwsDeploymentTarget` component on the project.
-     */
-    readonly deploymentTargets?: Array<AwsDeploymentTargetOptions>;
-    /**
-     * AWS deploy workflows. If omitted, one workflow is auto-generated per
-     * unique `awsStageType` present in `deploymentTargets`. Each auto-generated
-     * workflow renders to its own `.github/workflows/*.yml` file.
-     *
-     * Pass an empty array (`[]`) to opt out of auto-derivation entirely without
-     * supplying any workflows of your own — the array is truthy and short-circuits
-     * the default. Useful when you intend to attach deploy jobs to an existing
-     * build workflow yourself.
-     */
-    readonly deployWorkflows?: Array<DeployWorkflowOptions>;
-    /**
-     * Optional shared `BuildWorkflow` to attach all auto-derived deploy jobs to.
-     * When set, every workflow generated from `deploymentTargets` re-uses this
-     * build workflow instead of creating its own. Default behavior (omit) is one
-     * separate yml file per stage type.
-     *
-     * Distinct from `buildWorkflow: boolean` inherited from
-     * `AwsCdkTypeScriptAppOptions`, which toggles whether the projen-managed
-     * build workflow is generated at all.
-     */
-    readonly sharedBuildWorkflow?: BuildWorkflow;
-    /**
-     * Test runner to use.
-     *
-     * @default TestRunner.JEST
-     */
-    readonly testRunner?: TestRunner;
-    /**
-     * Options for Vitest (only used when testRunner is 'vitest').
-     */
-    readonly vitestOptions?: VitestOptions;
-    /**
-     * Enable the reset task that deletes all build artifacts.
-     *
-     * @default true
-     */
-    readonly resetTask?: boolean;
-    /**
-     * Options for the reset task.
-     */
-    readonly resetTaskOptions?: ResetTaskOptions;
-    /**
-     * AI agent configuration (Cursor, Claude Code rules). Opt-in per project;
-     * not inherited from the parent `MonorepoProject`.
-     *
-     * @default false
-     */
-    readonly agentConfig?: AgentConfigOptions | boolean;
-}
-/**
- * AWS CDK TypeScript application with CodeDrifters conventions baked in.
- *
- * Always creates an `AwsDeploymentConfig` component (even with zero deployment
- * targets) so the `synth` task is consistently rewritten to emit into
- * `dist/<project-path>/cdk.out`. This is intentional and not opt-out: it
- * funnels every package's CDK output into one root-level `dist/` tree so
- * GitHub Actions workflows can pass artifacts between jobs uniformly.
- */
-declare class AwsCdkProject extends awscdk.AwsCdkTypeScriptApp {
-    constructor(userOptions: AwsCdkProjectOptions);
-    /**
-     * Add an AWS deployment target to this project after construction. The
-     * target is registered on the existing `AwsDeploymentConfig` and immediately
-     * available for `AwsDeployWorkflow` consumption.
-     */
-    addDeploymentTarget(options: AwsDeploymentTargetOptions): AwsDeploymentTarget;
-}
-
 /**
  * Each of the below options corresponds to a task property found here:
  *  * https://turborepo.com/docs/reference/configuration#defining-tasks
@@ -3199,6 +3117,140 @@ declare class MonorepoProject extends TypeScriptAppProject {
     postSynthesize(): void;
 }
 
+/**
+ * Default branch-delete patterns that trigger the teardown workflow.
+ */
+declare const DEFAULT_TEARDOWN_BRANCH_PATTERNS: ReadonlyArray<string>;
+/**
+ * Options for {@link AwsTeardownWorkflow}.
+ */
+interface AwsTeardownWorkflowOptions {
+    /**
+     * Targets to scan for orphaned CloudFormation stacks.
+     */
+    readonly awsDestructionTargets: Array<AwsDeploymentTarget>;
+    /**
+     * Name of the tag containing the repo name. Used to find CloudFormation
+     * stacks associated with this repo.
+     */
+    readonly repoTagName: string;
+    /**
+     * Name of the tag containing the stage type (e.g. dev, stage, prod).
+     */
+    readonly stageTypeTagName: string;
+    /**
+     * Name of the tag containing the environment type (e.g. primary, secondary).
+     */
+    readonly environmentTypeTagName: string;
+    /**
+     * Name of the tag where branch names are stored. Used to determine if a
+     * stack is orphaned (no matching branch).
+     */
+    readonly branchNameTagName: string;
+    /**
+     * Branch patterns whose deletion triggers the teardown workflow.
+     *
+     * @default ["feat/*", "fix/*", "feature/*"]
+     */
+    readonly deleteBranchPatterns?: Array<string>;
+}
+/**
+ * Scheduled GitHub Actions workflow that tears down orphaned CloudFormation
+ * stacks whose associated branch no longer exists.
+ */
+declare class AwsTeardownWorkflow extends Component {
+    rootProject: MonorepoProject;
+    constructor(rootProject: MonorepoProject, options: AwsTeardownWorkflowOptions);
+}
+
+/**
+ * Configuration options for AwsCdkProject.
+ *
+ * AwsCdkProject must be parented to a `MonorepoProject` — the constructor
+ * throws otherwise. Configulator assumes a single-package repo is still a
+ * monorepo (with one workspace) so all conventions hold uniformly.
+ */
+interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "defaultReleaseBranch"> {
+    /**
+     * AWS deployment targets (dev / stage / prod accounts and regions). Each
+     * entry creates an `AwsDeploymentTarget` component on the project.
+     */
+    readonly deploymentTargets?: Array<AwsDeploymentTargetOptions>;
+    /**
+     * AWS deploy workflows. If omitted, one workflow is auto-generated per
+     * unique `awsStageType` present in `deploymentTargets`. Each auto-generated
+     * workflow renders to its own `.github/workflows/*.yml` file.
+     *
+     * Pass an empty array (`[]`) to opt out of auto-derivation entirely without
+     * supplying any workflows of your own — the array is truthy and short-circuits
+     * the default. Useful when you intend to attach deploy jobs to an existing
+     * build workflow yourself.
+     */
+    readonly deployWorkflows?: Array<DeployWorkflowOptions>;
+    /**
+     * Optional shared `BuildWorkflow` to attach all auto-derived deploy jobs to.
+     * When set, every workflow generated from `deploymentTargets` re-uses this
+     * build workflow instead of creating its own. Default behavior (omit) is one
+     * separate yml file per stage type.
+     *
+     * Distinct from `buildWorkflow: boolean` inherited from
+     * `AwsCdkTypeScriptAppOptions`, which toggles whether the projen-managed
+     * build workflow is generated at all.
+     */
+    readonly sharedBuildWorkflow?: BuildWorkflow;
+    /**
+     * Test runner to use.
+     *
+     * @default TestRunner.JEST
+     */
+    readonly testRunner?: TestRunner;
+    /**
+     * Options for Vitest (only used when testRunner is 'vitest').
+     */
+    readonly vitestOptions?: VitestOptions;
+    /**
+     * Enable the reset task that deletes all build artifacts.
+     *
+     * @default true
+     */
+    readonly resetTask?: boolean;
+    /**
+     * Options for the reset task.
+     */
+    readonly resetTaskOptions?: ResetTaskOptions;
+    /**
+     * AI agent configuration (Cursor, Claude Code rules). Opt-in per project;
+     * not inherited from the parent `MonorepoProject`.
+     *
+     * @default false
+     */
+    readonly agentConfig?: AgentConfigOptions | boolean;
+    /**
+     * Scheduled teardown workflow options. When provided, an `AwsTeardownWorkflow`
+     * is attached to the parent `MonorepoProject` that periodically deletes
+     * orphaned CloudFormation stacks whose branch no longer exists.
+     */
+    readonly teardownWorkflow?: AwsTeardownWorkflowOptions;
+}
+/**
+ * AWS CDK TypeScript application with CodeDrifters conventions baked in.
+ *
+ * Always creates an `AwsDeploymentConfig` component (even with zero deployment
+ * targets) so the `synth` task is consistently rewritten to emit into
+ * `dist/<project-path>/cdk.out`. This is intentional and not opt-out: it
+ * funnels every package's CDK output into one root-level `dist/` tree so
+ * GitHub Actions workflows can pass artifacts between jobs uniformly.
+ */
+declare class AwsCdkProject extends awscdk.AwsCdkTypeScriptApp {
+    constructor(userOptions: AwsCdkProjectOptions);
+    /**
+     * Add an AWS deployment target to this project after construction. The
+     * target is registered on the existing `AwsDeploymentConfig` and immediately
+     * available for `AwsDeployWorkflow` consumption.
+     */
+    addDeploymentTarget(options: AwsDeploymentTargetOptions): AwsDeploymentTarget;
+}
+
 /**
  * Provides structured project metadata consumed by AgentConfig, skills,
  * and other configulator features at synthesis time.
@@ -3267,5 +3319,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
-export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };