@codedrifters/configulator 0.0.195 → 0.0.197

package/lib/index.d.mts

@@ -1,4 +1,4 @@
-import { Component, Project as Project$1, typescript } from 'projen';
+import { Component, Project as Project$1, typescript, awscdk } from 'projen';
 import { Project, Component as Component$1, Task } from 'projen/lib';
 import { NodeProject } from 'projen/lib/javascript';
 import { AwsCdkTypeScriptApp } from 'projen/lib/awscdk';
@@ -6,7 +6,7 @@ import { AwsStageType, DeploymentTargetRoleType, AwsEnvironmentType, AWS_STAGE_T
 import * as spec from '@jsii/spec';
 import { TypeScriptProject as TypeScriptProject$1, TypeScriptAppProject, TypeScriptProjectOptions as TypeScriptProjectOptions$1 } from 'projen/lib/typescript';
 import { ValueOf } from 'type-fest';
-import { BuildWorkflowOptions, BuildWorkflow } from 'projen/lib/build';
+import { BuildWorkflow, BuildWorkflowOptions } from 'projen/lib/build';
 import { JobStep } from 'projen/lib/github/workflows-model';
 
 /**
@@ -2381,6 +2381,87 @@ declare class AstroProject extends TypeScriptProject {
     constructor(userOptions: AstroProjectOptions);
 }
 
+declare const PROD_DEPLOY_NAME = "prod-deploy";
+interface DeployWorkflowOptions {
+    /**
+     * What type of deploy is this workflow for?
+     *
+     * @default AWS_STAGE_TYPE.DEV
+     */
+    readonly awsStageType?: ValueOf<typeof AWS_STAGE_TYPE>;
+    /**
+     * Optionally feed a list of targets to deploy to.
+     *
+     * @default discovers all targets using stageType
+     */
+    readonly awsDeploymentTargets?: Array<AwsDeploymentTarget>;
+    /**
+     * Existing workflow, useful if we're tacking deployments onto an existing
+     * build workflow
+     */
+    readonly buildWorkflow?: BuildWorkflow;
+    /**
+     * Options for the build workflow, if no build workflow is provided.
+     */
+    readonly buildWorkflowOptions?: Partial<BuildWorkflowOptions>;
+    /**
+     * Projects that should complete deployment before this one starts.
+     */
+    readonly deployAfterTargets?: Array<AwsDeploymentTarget>;
+}
+declare class AwsDeployWorkflow extends Component {
+    project: AwsCdkTypeScriptApp;
+    options: DeployWorkflowOptions;
+    static of(project: AwsCdkTypeScriptApp, buildWorkflow: BuildWorkflow): AwsDeployWorkflow | undefined;
+    /**
+     * The root project for this deploy workflow. Must be a monorepo project.
+     */
+    private rootProject;
+    /**
+     * What type of deploy is this workflow for?
+     */
+    awsStageType: AwsStageType;
+    /**
+     * AWS environment type, such as primary or secondary.
+     *
+     * @deprecated Use deployment target role terminology elsewhere. This property is maintained for backward compatibility.
+     * @default 'primary' (this is the only type supported currently)
+     */
+    awsEnvironmentType: DeploymentTargetRoleType;
+    /**
+     * The list of targets to deploy to.
+     */
+    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
+    /**
+     * Hold the deploy workflow so we can add to it in preSynth
+     */
+    buildWorkflow: BuildWorkflow;
+    /**
+     * Was this workflow created externally?
+     */
+    externalWorkflow: boolean;
+    /**
+     * Projects that should complete deployment before this one starts.
+     */
+    deployAfterTargets: Array<AwsDeploymentTarget>;
+    constructor(project: AwsCdkTypeScriptApp, options?: DeployWorkflowOptions);
+    setupNode: () => Array<JobStep>;
+    setupPnpm: () => Array<JobStep>;
+    /**
+     * Builds a GitHub Actions condition string that checks if the current branch
+     * matches any of the provided branch patterns.
+     *
+     * 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
+     * @returns Condition string or empty string if no branches provided
+     */
+    private buildBranchFilterCondition;
+    private deploySteps;
+    preSynthesize(): void;
+}
+
 /**
  * Each of the below options corresponds to a task property found here:
  *  * https://turborepo.com/docs/reference/configuration#defining-tasks
@@ -2987,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.
@@ -3042,87 +3257,6 @@ declare class VSCodeConfig extends Component {
     constructor(project: TypeScriptAppProject);
 }
 
-declare const PROD_DEPLOY_NAME = "prod-deploy";
-interface DeployWorkflowOptions {
-    /**
-     * What type of deploy is this workflow for?
-     *
-     * @default AWS_STAGE_TYPE.DEV
-     */
-    readonly awsStageType?: ValueOf<typeof AWS_STAGE_TYPE>;
-    /**
-     * Optionally feed a list of targets to deploy to.
-     *
-     * @default discovers all targets using stageType
-     */
-    readonly awsDeploymentTargets?: Array<AwsDeploymentTarget>;
-    /**
-     * Existing workflow, useful if we're tacking deployments onto an existing
-     * build workflow
-     */
-    readonly buildWorkflow?: BuildWorkflow;
-    /**
-     * Options for the build workflow, if no build workflow is provided.
-     */
-    readonly buildWorkflowOptions?: Partial<BuildWorkflowOptions>;
-    /**
-     * Projects that should complete deployment before this one starts.
-     */
-    readonly deployAfterTargets?: Array<AwsDeploymentTarget>;
-}
-declare class AwsDeployWorkflow extends Component {
-    project: AwsCdkTypeScriptApp;
-    options: DeployWorkflowOptions;
-    static of(project: AwsCdkTypeScriptApp, buildWorkflow: BuildWorkflow): AwsDeployWorkflow | undefined;
-    /**
-     * The root project for this deploy workflow. Must be a monorepo project.
-     */
-    private rootProject;
-    /**
-     * What type of deploy is this workflow for?
-     */
-    awsStageType: AwsStageType;
-    /**
-     * AWS environment type, such as primary or secondary.
-     *
-     * @deprecated Use deployment target role terminology elsewhere. This property is maintained for backward compatibility.
-     * @default 'primary' (this is the only type supported currently)
-     */
-    awsEnvironmentType: DeploymentTargetRoleType;
-    /**
-     * The list of targets to deploy to.
-     */
-    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
-    /**
-     * Hold the deploy workflow so we can add to it in preSynth
-     */
-    buildWorkflow: BuildWorkflow;
-    /**
-     * Was this workflow created externally?
-     */
-    externalWorkflow: boolean;
-    /**
-     * Projects that should complete deployment before this one starts.
-     */
-    deployAfterTargets: Array<AwsDeploymentTarget>;
-    constructor(project: AwsCdkTypeScriptApp, options?: DeployWorkflowOptions);
-    setupNode: () => Array<JobStep>;
-    setupPnpm: () => Array<JobStep>;
-    /**
-     * Builds a GitHub Actions condition string that checks if the current branch
-     * matches any of the provided branch patterns.
-     *
-     * 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
-     * @returns Condition string or empty string if no branches provided
-     */
-    private buildBranchFilterCondition;
-    private deploySteps;
-    preSynthesize(): void;
-}
-
 /** Name of the gate job appended to build workflows (ADR 0004). */
 declare const COMPLETE_JOB_ID = "complete";
 /**
@@ -3136,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, 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

@@ -1,9 +1,9 @@
-import { Component, Project, typescript } from 'projen';
+import { Component, Project, typescript, awscdk } from 'projen';
 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';
@@ -2430,6 +2430,87 @@ declare class AstroProject extends TypeScriptProject {
     constructor(userOptions: AstroProjectOptions);
 }
 
+declare const PROD_DEPLOY_NAME = "prod-deploy";
+interface DeployWorkflowOptions {
+    /**
+     * What type of deploy is this workflow for?
+     *
+     * @default AWS_STAGE_TYPE.DEV
+     */
+    readonly awsStageType?: ValueOf<typeof AWS_STAGE_TYPE>;
+    /**
+     * Optionally feed a list of targets to deploy to.
+     *
+     * @default discovers all targets using stageType
+     */
+    readonly awsDeploymentTargets?: Array<AwsDeploymentTarget>;
+    /**
+     * Existing workflow, useful if we're tacking deployments onto an existing
+     * build workflow
+     */
+    readonly buildWorkflow?: BuildWorkflow;
+    /**
+     * Options for the build workflow, if no build workflow is provided.
+     */
+    readonly buildWorkflowOptions?: Partial<BuildWorkflowOptions>;
+    /**
+     * Projects that should complete deployment before this one starts.
+     */
+    readonly deployAfterTargets?: Array<AwsDeploymentTarget>;
+}
+declare class AwsDeployWorkflow extends Component {
+    project: AwsCdkTypeScriptApp;
+    options: DeployWorkflowOptions;
+    static of(project: AwsCdkTypeScriptApp, buildWorkflow: BuildWorkflow): AwsDeployWorkflow | undefined;
+    /**
+     * The root project for this deploy workflow. Must be a monorepo project.
+     */
+    private rootProject;
+    /**
+     * What type of deploy is this workflow for?
+     */
+    awsStageType: AwsStageType;
+    /**
+     * AWS environment type, such as primary or secondary.
+     *
+     * @deprecated Use deployment target role terminology elsewhere. This property is maintained for backward compatibility.
+     * @default 'primary' (this is the only type supported currently)
+     */
+    awsEnvironmentType: DeploymentTargetRoleType;
+    /**
+     * The list of targets to deploy to.
+     */
+    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
+    /**
+     * Hold the deploy workflow so we can add to it in preSynth
+     */
+    buildWorkflow: BuildWorkflow;
+    /**
+     * Was this workflow created externally?
+     */
+    externalWorkflow: boolean;
+    /**
+     * Projects that should complete deployment before this one starts.
+     */
+    deployAfterTargets: Array<AwsDeploymentTarget>;
+    constructor(project: AwsCdkTypeScriptApp, options?: DeployWorkflowOptions);
+    setupNode: () => Array<JobStep>;
+    setupPnpm: () => Array<JobStep>;
+    /**
+     * Builds a GitHub Actions condition string that checks if the current branch
+     * matches any of the provided branch patterns.
+     *
+     * 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
+     * @returns Condition string or empty string if no branches provided
+     */
+    private buildBranchFilterCondition;
+    private deploySteps;
+    preSynthesize(): void;
+}
+
 /**
  * Each of the below options corresponds to a task property found here:
  *  * https://turborepo.com/docs/reference/configuration#defining-tasks
@@ -3036,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.
@@ -3091,87 +3306,6 @@ declare class VSCodeConfig extends Component {
     constructor(project: TypeScriptAppProject);
 }
 
-declare const PROD_DEPLOY_NAME = "prod-deploy";
-interface DeployWorkflowOptions {
-    /**
-     * What type of deploy is this workflow for?
-     *
-     * @default AWS_STAGE_TYPE.DEV
-     */
-    readonly awsStageType?: ValueOf<typeof AWS_STAGE_TYPE>;
-    /**
-     * Optionally feed a list of targets to deploy to.
-     *
-     * @default discovers all targets using stageType
-     */
-    readonly awsDeploymentTargets?: Array<AwsDeploymentTarget>;
-    /**
-     * Existing workflow, useful if we're tacking deployments onto an existing
-     * build workflow
-     */
-    readonly buildWorkflow?: BuildWorkflow;
-    /**
-     * Options for the build workflow, if no build workflow is provided.
-     */
-    readonly buildWorkflowOptions?: Partial<BuildWorkflowOptions>;
-    /**
-     * Projects that should complete deployment before this one starts.
-     */
-    readonly deployAfterTargets?: Array<AwsDeploymentTarget>;
-}
-declare class AwsDeployWorkflow extends Component {
-    project: AwsCdkTypeScriptApp;
-    options: DeployWorkflowOptions;
-    static of(project: AwsCdkTypeScriptApp, buildWorkflow: BuildWorkflow): AwsDeployWorkflow | undefined;
-    /**
-     * The root project for this deploy workflow. Must be a monorepo project.
-     */
-    private rootProject;
-    /**
-     * What type of deploy is this workflow for?
-     */
-    awsStageType: AwsStageType;
-    /**
-     * AWS environment type, such as primary or secondary.
-     *
-     * @deprecated Use deployment target role terminology elsewhere. This property is maintained for backward compatibility.
-     * @default 'primary' (this is the only type supported currently)
-     */
-    awsEnvironmentType: DeploymentTargetRoleType;
-    /**
-     * The list of targets to deploy to.
-     */
-    readonly awsDeploymentTargets: Array<AwsDeploymentTarget>;
-    /**
-     * Hold the deploy workflow so we can add to it in preSynth
-     */
-    buildWorkflow: BuildWorkflow;
-    /**
-     * Was this workflow created externally?
-     */
-    externalWorkflow: boolean;
-    /**
-     * Projects that should complete deployment before this one starts.
-     */
-    deployAfterTargets: Array<AwsDeploymentTarget>;
-    constructor(project: AwsCdkTypeScriptApp, options?: DeployWorkflowOptions);
-    setupNode: () => Array<JobStep>;
-    setupPnpm: () => Array<JobStep>;
-    /**
-     * Builds a GitHub Actions condition string that checks if the current branch
-     * matches any of the provided branch patterns.
-     *
-     * 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
-     * @returns Condition string or empty string if no branches provided
-     */
-    private buildBranchFilterCondition;
-    private deploySteps;
-    preSynthesize(): void;
-}
-
 /** Name of the gate job appended to build workflows (ADR 0004). */
 declare const COMPLETE_JOB_ID = "complete";
 /**
@@ -3185,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, 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, 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 };