@codedrifters/configulator 0.0.158 → 0.0.160

package/lib/index.d.mts

@@ -213,6 +213,19 @@ interface AgentSkill {
 /**
  * Platform-specific overrides for a sub-agent definition.
  */
+/**
+ * Copilot handoff definition for sub-agent delegation.
+ */
+interface CopilotHandoff {
+    /** Display label for the handoff action. */
+    readonly label: string;
+    /** Target agent name. */
+    readonly agent: string;
+    /** Optional prompt to pass to the target agent. */
+    readonly prompt?: string;
+    /** Whether to auto-send the handoff without user confirmation. */
+    readonly send?: boolean;
+}
 interface AgentSubAgentPlatformOverrides {
     /** Claude Code-specific overrides */
     readonly claude?: {
@@ -220,8 +233,12 @@ interface AgentSubAgentPlatformOverrides {
         readonly permissionMode?: string;
         /** Run in isolated git worktree */
         readonly isolation?: string;
-        /** Reasoning effort level */
+        /** Run as a background task */
+        readonly background?: boolean;
+        /** Reasoning effort level (Opus): low, medium, high, max */
         readonly effort?: string;
+        /** Persistent memory scope: user, project, local */
+        readonly memory?: string;
         /** Exclude this sub-agent from Claude Code output entirely */
         readonly exclude?: boolean;
     };
@@ -236,11 +253,23 @@ interface AgentSubAgentPlatformOverrides {
     };
     /** Codex-specific overrides (future) */
     readonly codex?: {
+        /** Sandbox mode: read-only or full */
+        readonly sandboxMode?: string;
+        /** Model reasoning effort */
+        readonly modelReasoningEffort?: string;
         /** Exclude this sub-agent from Codex output entirely */
         readonly exclude?: boolean;
     };
     /** Copilot-specific overrides (future) */
     readonly copilot?: {
+        /** Target environment: vscode or github-copilot */
+        readonly target?: string;
+        /** Whether the user can invoke this sub-agent directly */
+        readonly userInvocable?: boolean;
+        /** Prevent auto-invocation of this sub-agent */
+        readonly disableModelInvocation?: boolean;
+        /** Handoff definitions for agent-to-agent delegation */
+        readonly handoffs?: ReadonlyArray<CopilotHandoff>;
         /** Exclude this sub-agent from Copilot output entirely */
         readonly exclude?: boolean;
     };
@@ -273,8 +302,28 @@ interface AgentSubAgent {
      * @example ['Read', 'Glob', 'Grep']
      */
     readonly tools?: ReadonlyArray<string>;
+    /**
+     * Tool denylist. Applied before the allowlist.
+     * @example ['Bash', 'Write']
+     */
+    readonly disallowedTools?: ReadonlyArray<string>;
     /** Maximum agentic turns before the sub-agent stops. */
     readonly maxTurns?: number;
+    /**
+     * Skills to preload for this sub-agent.
+     * @example ['commit', 'review-pr']
+     */
+    readonly skills?: ReadonlyArray<string>;
+    /**
+     * MCP servers available to this sub-agent.
+     * Rendered to the platform-specific sub-agent config.
+     */
+    readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
+    /**
+     * Sub-agents this agent can invoke/delegate to.
+     * @example ['test-writer', 'code-reviewer']
+     */
+    readonly canDelegateToAgents?: ReadonlyArray<string>;
     /** Optional per-platform overrides for this sub-agent. */
     readonly platforms?: AgentSubAgentPlatformOverrides;
 }
@@ -294,8 +343,21 @@ interface McpServerConfig {
     readonly args?: ReadonlyArray<string>;
     /** URL for HTTP/SSE remote servers. */
     readonly url?: string;
+    /** HTTP headers for HTTP/SSE connections. */
+    readonly headers?: Readonly<Record<string, string>>;
     /** Environment variables for the server process. */
     readonly env?: Readonly<Record<string, string>>;
+    /**
+     * Tool allowlist — only these tools from the server will be available.
+     * @example ['read_file', 'search']
+     */
+    readonly enabledTools?: ReadonlyArray<string>;
+    /**
+     * Tool denylist — these tools from the server will be blocked.
+     * Applied before enabledTools.
+     * @example ['delete_file', 'execute']
+     */
+    readonly disabledTools?: ReadonlyArray<string>;
 }
 
 /*******************************************************************************
@@ -361,22 +423,58 @@ interface CursorHooksConfig {
      * Fires before a shell command executes. Blocking — can deny execution.
      */
     readonly beforeShellExecution?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after a shell command executes. Non-blocking (informational).
+     */
+    readonly afterShellExecution?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires before an MCP tool is invoked. Blocking — can deny execution.
      */
     readonly beforeMCPExecution?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after an MCP tool is invoked. Non-blocking (informational).
+     */
+    readonly afterMCPExecution?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires before a file is read by the AI. Blocking — can rewrite content.
      */
     readonly beforeReadFile?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires before a tab file is read. Blocking — can rewrite content.
+     */
+    readonly beforeTabFileRead?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires after a file is edited. Non-blocking (informational).
      */
     readonly afterFileEdit?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after a tab file is edited. Non-blocking (informational).
+     */
+    readonly afterTabFileEdit?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires when the agent stops. Non-blocking (informational).
      */
     readonly stop?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires when a session starts. Non-blocking (informational).
+     */
+    readonly sessionStart?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires when a session ends. Non-blocking (informational).
+     */
+    readonly sessionEnd?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires before context compaction. Non-blocking (informational).
+     */
+    readonly preCompact?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after the agent produces a response. Non-blocking (informational).
+     */
+    readonly afterAgentResponse?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after the agent produces a thought. Non-blocking (informational).
+     */
+    readonly afterAgentThought?: ReadonlyArray<CursorHookAction>;
 }
 /**
  * Cursor-specific configuration options.
@@ -556,6 +654,8 @@ interface ClaudeSettingsConfig {
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
     /** MCP servers to explicitly allow. */
     readonly allowedMcpServers?: ReadonlyArray<string>;
+    /** MCP servers to explicitly deny. */
+    readonly deniedMcpServers?: ReadonlyArray<string>;
     /** Environment variables passed to Claude's shell. */
     readonly env?: Readonly<Record<string, string>>;
     /** Sandbox configuration. */
@@ -573,6 +673,16 @@ interface ClaudeSettingsConfig {
      * @example ['**\/.env', '**\/*.key', '**\/secrets/**']
      */
     readonly excludeSensitivePatterns?: ReadonlyArray<string>;
+    /**
+     * Default model ID for the project.
+     * @example 'claude-opus-4-6'
+     */
+    readonly model?: string;
+    /**
+     * Default reasoning effort level.
+     * @example 'high'
+     */
+    readonly effortLevel?: string;
     /** Attribution configuration for commits and PRs created by Claude. */
     readonly attribution?: {
         /** Attribution mode: 'inherit', 'always', 'never'. */
@@ -583,6 +693,16 @@ interface ClaudeSettingsConfig {
             readonly email?: string;
         };
     };
+    /**
+     * Glob patterns to exclude from CLAUDE.md file search.
+     * @example ['vendor/**', 'generated/**']
+     */
+    readonly claudeMdExcludes?: ReadonlyArray<string>;
+    /**
+     * Whether to respect .gitignore when indexing files.
+     * @default true
+     */
+    readonly respectGitignore?: boolean;
 }
 /*******************************************************************************
  *
@@ -2344,17 +2464,17 @@ interface MonorepoProjectOptions extends Omit<TypeScriptProjectOptions$1, "defau
      */
     readonly projectMetadata?: ProjectMetadataOptions | false;
     /**
-     * Enable AI agent configuration (Cursor, Claude Code rules).
-     * When true, generates rule files at the monorepo root with auto-detected
-     * bundles based on project and subproject introspection.
+     * AI agent configuration (Cursor, Claude Code rules).
+     * Generates rule files at the monorepo root with auto-detected bundles
+     * based on project and subproject introspection.
+     *
+     * - `true` or `{}`: enable with auto-detected defaults
+     * - `AgentConfigOptions`: enable with explicit configuration
+     * - `false` or `undefined`: disabled (default)
      *
      * @default false
      */
-    readonly agentConfig?: boolean;
-    /**
-     * Options for the AgentConfig component. Only used when `agentConfig` is true.
-     */
-    readonly agentConfigOptions?: AgentConfigOptions;
+    readonly agentConfig?: AgentConfigOptions | boolean;
 }
 declare class MonorepoProject extends TypeScriptAppProject {
     /**
@@ -2539,6 +2659,20 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * Options for the reset task.
      */
     readonly resetTaskOptions?: ResetTaskOptions;
+    /**
+     * AI agent configuration (Cursor, Claude Code rules).
+     * Generates rule files with auto-detected bundles based on project tooling.
+     *
+     * - `true` or `{}`: enable with auto-detected defaults
+     * - `AgentConfigOptions`: enable with explicit configuration
+     * - `false` or `undefined`: disabled (default)
+     *
+     * When the parent is a MonorepoProject with AgentConfig enabled and this
+     * option is not explicitly set, the sub-project inherits enablement.
+     *
+     * @default false
+     */
+    readonly agentConfig?: AgentConfigOptions | boolean;
 }
 declare class TypeScriptProject extends typescript.TypeScriptProject {
     constructor(userOptions: TypeScriptProjectOptions);
@@ -2659,4 +2793,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 AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, 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 CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_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 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, awsCdkBundle, baseBundle, getLatestEligibleVersion, jestBundle, pnpmBundle, projenBundle, resolveTemplateVariables, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, 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, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_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 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, awsCdkBundle, baseBundle, getLatestEligibleVersion, jestBundle, pnpmBundle, projenBundle, resolveTemplateVariables, turborepoBundle, typescriptBundle, vitestBundle };

package/lib/index.d.ts

@@ -262,6 +262,19 @@ interface AgentSkill {
 /**
  * Platform-specific overrides for a sub-agent definition.
  */
+/**
+ * Copilot handoff definition for sub-agent delegation.
+ */
+interface CopilotHandoff {
+    /** Display label for the handoff action. */
+    readonly label: string;
+    /** Target agent name. */
+    readonly agent: string;
+    /** Optional prompt to pass to the target agent. */
+    readonly prompt?: string;
+    /** Whether to auto-send the handoff without user confirmation. */
+    readonly send?: boolean;
+}
 interface AgentSubAgentPlatformOverrides {
     /** Claude Code-specific overrides */
     readonly claude?: {
@@ -269,8 +282,12 @@ interface AgentSubAgentPlatformOverrides {
         readonly permissionMode?: string;
         /** Run in isolated git worktree */
         readonly isolation?: string;
-        /** Reasoning effort level */
+        /** Run as a background task */
+        readonly background?: boolean;
+        /** Reasoning effort level (Opus): low, medium, high, max */
         readonly effort?: string;
+        /** Persistent memory scope: user, project, local */
+        readonly memory?: string;
         /** Exclude this sub-agent from Claude Code output entirely */
         readonly exclude?: boolean;
     };
@@ -285,11 +302,23 @@ interface AgentSubAgentPlatformOverrides {
     };
     /** Codex-specific overrides (future) */
     readonly codex?: {
+        /** Sandbox mode: read-only or full */
+        readonly sandboxMode?: string;
+        /** Model reasoning effort */
+        readonly modelReasoningEffort?: string;
         /** Exclude this sub-agent from Codex output entirely */
         readonly exclude?: boolean;
     };
     /** Copilot-specific overrides (future) */
     readonly copilot?: {
+        /** Target environment: vscode or github-copilot */
+        readonly target?: string;
+        /** Whether the user can invoke this sub-agent directly */
+        readonly userInvocable?: boolean;
+        /** Prevent auto-invocation of this sub-agent */
+        readonly disableModelInvocation?: boolean;
+        /** Handoff definitions for agent-to-agent delegation */
+        readonly handoffs?: ReadonlyArray<CopilotHandoff>;
         /** Exclude this sub-agent from Copilot output entirely */
         readonly exclude?: boolean;
     };
@@ -322,8 +351,28 @@ interface AgentSubAgent {
      * @example ['Read', 'Glob', 'Grep']
      */
     readonly tools?: ReadonlyArray<string>;
+    /**
+     * Tool denylist. Applied before the allowlist.
+     * @example ['Bash', 'Write']
+     */
+    readonly disallowedTools?: ReadonlyArray<string>;
     /** Maximum agentic turns before the sub-agent stops. */
     readonly maxTurns?: number;
+    /**
+     * Skills to preload for this sub-agent.
+     * @example ['commit', 'review-pr']
+     */
+    readonly skills?: ReadonlyArray<string>;
+    /**
+     * MCP servers available to this sub-agent.
+     * Rendered to the platform-specific sub-agent config.
+     */
+    readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
+    /**
+     * Sub-agents this agent can invoke/delegate to.
+     * @example ['test-writer', 'code-reviewer']
+     */
+    readonly canDelegateToAgents?: ReadonlyArray<string>;
     /** Optional per-platform overrides for this sub-agent. */
     readonly platforms?: AgentSubAgentPlatformOverrides;
 }
@@ -343,8 +392,21 @@ interface McpServerConfig {
     readonly args?: ReadonlyArray<string>;
     /** URL for HTTP/SSE remote servers. */
     readonly url?: string;
+    /** HTTP headers for HTTP/SSE connections. */
+    readonly headers?: Readonly<Record<string, string>>;
     /** Environment variables for the server process. */
     readonly env?: Readonly<Record<string, string>>;
+    /**
+     * Tool allowlist — only these tools from the server will be available.
+     * @example ['read_file', 'search']
+     */
+    readonly enabledTools?: ReadonlyArray<string>;
+    /**
+     * Tool denylist — these tools from the server will be blocked.
+     * Applied before enabledTools.
+     * @example ['delete_file', 'execute']
+     */
+    readonly disabledTools?: ReadonlyArray<string>;
 }
 
 /*******************************************************************************
@@ -410,22 +472,58 @@ interface CursorHooksConfig {
      * Fires before a shell command executes. Blocking — can deny execution.
      */
     readonly beforeShellExecution?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after a shell command executes. Non-blocking (informational).
+     */
+    readonly afterShellExecution?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires before an MCP tool is invoked. Blocking — can deny execution.
      */
     readonly beforeMCPExecution?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after an MCP tool is invoked. Non-blocking (informational).
+     */
+    readonly afterMCPExecution?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires before a file is read by the AI. Blocking — can rewrite content.
      */
     readonly beforeReadFile?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires before a tab file is read. Blocking — can rewrite content.
+     */
+    readonly beforeTabFileRead?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires after a file is edited. Non-blocking (informational).
      */
     readonly afterFileEdit?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after a tab file is edited. Non-blocking (informational).
+     */
+    readonly afterTabFileEdit?: ReadonlyArray<CursorHookAction>;
     /**
      * Fires when the agent stops. Non-blocking (informational).
      */
     readonly stop?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires when a session starts. Non-blocking (informational).
+     */
+    readonly sessionStart?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires when a session ends. Non-blocking (informational).
+     */
+    readonly sessionEnd?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires before context compaction. Non-blocking (informational).
+     */
+    readonly preCompact?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after the agent produces a response. Non-blocking (informational).
+     */
+    readonly afterAgentResponse?: ReadonlyArray<CursorHookAction>;
+    /**
+     * Fires after the agent produces a thought. Non-blocking (informational).
+     */
+    readonly afterAgentThought?: ReadonlyArray<CursorHookAction>;
 }
 /**
  * Cursor-specific configuration options.
@@ -605,6 +703,8 @@ interface ClaudeSettingsConfig {
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
     /** MCP servers to explicitly allow. */
     readonly allowedMcpServers?: ReadonlyArray<string>;
+    /** MCP servers to explicitly deny. */
+    readonly deniedMcpServers?: ReadonlyArray<string>;
     /** Environment variables passed to Claude's shell. */
     readonly env?: Readonly<Record<string, string>>;
     /** Sandbox configuration. */
@@ -622,6 +722,16 @@ interface ClaudeSettingsConfig {
      * @example ['**\/.env', '**\/*.key', '**\/secrets/**']
      */
     readonly excludeSensitivePatterns?: ReadonlyArray<string>;
+    /**
+     * Default model ID for the project.
+     * @example 'claude-opus-4-6'
+     */
+    readonly model?: string;
+    /**
+     * Default reasoning effort level.
+     * @example 'high'
+     */
+    readonly effortLevel?: string;
     /** Attribution configuration for commits and PRs created by Claude. */
     readonly attribution?: {
         /** Attribution mode: 'inherit', 'always', 'never'. */
@@ -632,6 +742,16 @@ interface ClaudeSettingsConfig {
             readonly email?: string;
         };
     };
+    /**
+     * Glob patterns to exclude from CLAUDE.md file search.
+     * @example ['vendor/**', 'generated/**']
+     */
+    readonly claudeMdExcludes?: ReadonlyArray<string>;
+    /**
+     * Whether to respect .gitignore when indexing files.
+     * @default true
+     */
+    readonly respectGitignore?: boolean;
 }
 /*******************************************************************************
  *
@@ -2393,17 +2513,17 @@ interface MonorepoProjectOptions extends Omit<TypeScriptProjectOptions$1, "defau
      */
     readonly projectMetadata?: ProjectMetadataOptions | false;
     /**
-     * Enable AI agent configuration (Cursor, Claude Code rules).
-     * When true, generates rule files at the monorepo root with auto-detected
-     * bundles based on project and subproject introspection.
+     * AI agent configuration (Cursor, Claude Code rules).
+     * Generates rule files at the monorepo root with auto-detected bundles
+     * based on project and subproject introspection.
+     *
+     * - `true` or `{}`: enable with auto-detected defaults
+     * - `AgentConfigOptions`: enable with explicit configuration
+     * - `false` or `undefined`: disabled (default)
      *
      * @default false
      */
-    readonly agentConfig?: boolean;
-    /**
-     * Options for the AgentConfig component. Only used when `agentConfig` is true.
-     */
-    readonly agentConfigOptions?: AgentConfigOptions;
+    readonly agentConfig?: AgentConfigOptions | boolean;
 }
 declare class MonorepoProject extends TypeScriptAppProject {
     /**
@@ -2588,6 +2708,20 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * Options for the reset task.
      */
     readonly resetTaskOptions?: ResetTaskOptions;
+    /**
+     * AI agent configuration (Cursor, Claude Code rules).
+     * Generates rule files with auto-detected bundles based on project tooling.
+     *
+     * - `true` or `{}`: enable with auto-detected defaults
+     * - `AgentConfigOptions`: enable with explicit configuration
+     * - `false` or `undefined`: disabled (default)
+     *
+     * When the parent is a MonorepoProject with AgentConfig enabled and this
+     * option is not explicitly set, the sub-project inherits enablement.
+     *
+     * @default false
+     */
+    readonly agentConfig?: AgentConfigOptions | boolean;
 }
 declare class TypeScriptProject extends typescript.TypeScriptProject {
     constructor(userOptions: TypeScriptProjectOptions);
@@ -2709,4 +2843,4 @@ declare const COMPLETE_JOB_ID = "complete";
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
 export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_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, awsCdkBundle, baseBundle, getLatestEligibleVersion, jestBundle, pnpmBundle, projenBundle, resolveTemplateVariables, turborepoBundle, typescriptBundle, vitestBundle };
-export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AwsAccount, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
+export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, 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, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };