@codedrifters/configulator 0.0.154 → 0.0.156

package/lib/index.mjs

@@ -173,14 +173,7 @@ var require_lib = __commonJS({
 });
 
 // src/agent/agent-config.ts
-import { Component as Component3 } from "projen";
-
-// src/agent/bundles/index.ts
-var BUILT_IN_BUNDLES = [];
-
-// src/agent/renderers/claude-renderer.ts
-import { JsonFile } from "projen";
-import { TextFile } from "projen/lib/textfile";
+import { Component as Component8 } from "projen";
 
 // src/agent/types.ts
 var AGENT_RULE_SCOPE = {
@@ -210,7 +203,1135 @@ var MCP_TRANSPORT = {
   SSE: "sse"
 };
 
+// src/agent/bundles/utils.ts
+function hasComponent(project, ctor) {
+  if (project.components.some((c) => c instanceof ctor)) return true;
+  return project.subprojects.some(
+    (sub) => sub.components.some((c) => c instanceof ctor)
+  );
+}
+function hasDep(project, name) {
+  if (project.deps.all.some((d) => d.name === name)) return true;
+  return project.subprojects.some(
+    (sub) => sub.deps.all.some((d) => d.name === name)
+  );
+}
+function hasFile(project, filename) {
+  if (project.tryFindFile(filename) !== void 0) return true;
+  return project.subprojects.some(
+    (sub) => sub.tryFindFile(filename) !== void 0
+  );
+}
+
+// src/agent/bundles/aws-cdk.ts
+var awsCdkBundle = {
+  name: "aws-cdk",
+  description: "AWS CDK construct patterns, L2/L3 conventions, IAM best practices",
+  appliesWhen: (project) => hasDep(project, "aws-cdk-lib"),
+  rules: [
+    {
+      name: "aws-cdk-conventions",
+      description: "AWS CDK construct patterns and best practices",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["**/*.ts"],
+      content: [
+        "# AWS CDK Conventions",
+        "",
+        "## Construct Structure",
+        "",
+        "- All constructs extend `Construct` from `constructs`",
+        "- Use `readonly` for all props interfaces",
+        "- Include minimal JSDoc for configuration options",
+        "- Follow AWS CDK best practices for resource naming and organization",
+        "- Use proper TypeScript types from `aws-cdk-lib`",
+        "- Export constructs from `index.ts` for public API",
+        "",
+        "## CDK Construct Pattern",
+        "",
+        "```typescript",
+        "export interface MyConstructProps {",
+        "  /** Brief description. */",
+        "  readonly myProperty: string;",
+        "}",
+        "",
+        "export class MyConstruct extends Construct {",
+        "  constructor(scope: Construct, id: string, props: MyConstructProps) {",
+        "    super(scope, id);",
+        "    // Implementation",
+        "  }",
+        "}",
+        "```",
+        "",
+        "## AWS Best Practices",
+        "",
+        "- Use AWS CDK v2 (`aws-cdk-lib`)",
+        "- Follow AWS best practices for security and resource configuration",
+        "- Use proper IAM permissions (principle of least privilege)",
+        "- Include proper tags and descriptions for resources",
+        "- Use SSM parameters for cross-stack references when needed",
+        "- Do not pass values between stacks; use SSM parameters instead",
+        "",
+        "## CDK Testing",
+        "",
+        "- Mock `Code.fromAsset` in any test file that synthesizes CDK stacks",
+        "- Use static S3 values (`mock-assets-bucket`, `mock-asset-key.zip`) so snapshots are stable",
+        "- Add the mock in `beforeAll` and restore in `afterAll`",
+        "- Normalize the template before snapshotting when the stack includes asset-based Lambdas"
+      ].join("\n"),
+      tags: ["infrastructure"]
+    }
+  ]
+};
+
+// src/agent/bundles/base.ts
+var baseBundle = {
+  name: "base",
+  description: "Core rules: project overview, interaction style, and general coding conventions",
+  appliesWhen: () => true,
+  rules: [
+    {
+      name: "project-overview",
+      description: "Project context and technology stack overview",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Project Overview",
+        "",
+        "**Repository:** {{repository.owner}}/{{repository.name}}",
+        "**Default branch:** {{repository.defaultBranch}}",
+        "",
+        "## Important Notes",
+        "",
+        "- **Never edit generated files** \u2014 they are marked with `// ~~ Generated by projen`",
+        "- **After modifying Projen configuration**, the user should run `npx projen` locally. The agent must not run `npx projen`, `pnpm install`, or `pnpm i`.",
+        "- **Configure dependencies through Projen** \u2014 never use `npm install`, `pnpm add`, or `yarn add`. Add them to `deps` or `devDeps` in Projen config.",
+        "- **Export from index.ts** to maintain clean public APIs"
+      ].join("\n"),
+      tags: ["project"]
+    },
+    {
+      name: "interaction-style",
+      description: "Interaction style \u2014 ask questions one at a time and wait for feedback",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Interaction Style Guidelines",
+        "",
+        "When responding to requests, follow these interaction principles.",
+        "",
+        "1. **Ask questions one at a time**: When clarification is needed, ask a single question and wait for the user's response before proceeding.",
+        "2. **Wait for feedback**: After asking a question, pause and wait for the user's answer before asking additional questions or making assumptions.",
+        "3. **Avoid question overload**: Do not ask multiple questions in a single response. If multiple clarifications are needed, prioritize the most important question first.",
+        "4. **Progressive clarification**: Once the user answers your first question, you may then ask the next most important question if needed.",
+        "5. **Confirm understanding**: After receiving feedback, acknowledge the user's response before proceeding with the next step or question.",
+        "6. **Be patient**: Do not rush ahead with assumptions. It is better to ask one clarifying question than to proceed with incorrect assumptions."
+      ].join("\n"),
+      tags: ["project"]
+    },
+    {
+      name: "general-conventions",
+      description: "Code formatting (Prettier/ESLint), import conventions (ES modules, import order), error handling (async/await, no floating promises)",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["**/*.ts", "**/*.tsx"],
+      content: [
+        "# General Conventions",
+        "",
+        "## Code Formatting",
+        "",
+        "- Use **Prettier** for formatting (runs automatically on save in VS Code)",
+        "- Always use curly braces for control flow, even single-line statements",
+        "- Prefer `const` over `let`; avoid `var`",
+        "- Use trailing commas in multi-line objects/arrays",
+        "",
+        "### ESLint Rules to Follow",
+        "",
+        "- `curly`: Always use curly braces (multi-line, consistent)",
+        "- `dot-notation`: Use dot notation over bracket notation",
+        "- `no-bitwise`: No bitwise operators",
+        "- `@typescript-eslint/no-shadow`: No variable shadowing",
+        "- `@typescript-eslint/member-ordering`: Follow member order",
+        "",
+        "## Import Conventions",
+        "",
+        "- **Always use ES modules** (`import`/`export`), never `require()`",
+        "- Import order:",
+        "  1. Built-in Node.js modules (e.g., `node:path`, `node:fs`)",
+        "  2. External dependencies (alphabetically sorted)",
+        "  3. Internal imports (relative paths)",
+        "- Group imports with blank lines between groups",
+        "- Alphabetize imports within each group (case-insensitive)",
+        "",
+        "## Error Handling",
+        "",
+        "- Always handle promises properly with `await`",
+        "- Use `@typescript-eslint/return-await` rule (always return await)",
+        "- Never leave floating promises (`@typescript-eslint/no-floating-promises`)",
+        "- Use proper error types and meaningful error messages",
+        "- Do not swallow errors or use empty catch blocks",
+        "- Prefer async/await over raw promises"
+      ].join("\n"),
+      tags: ["coding"]
+    },
+    {
+      name: "pull-request-conventions",
+      description: "Conventional commit PR titles, closing keywords, change summaries",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Pull Request Conventions",
+        "",
+        "## PR Title Prefix",
+        "",
+        "**Always** use a **conventional commit prefix** in the PR `title`. Format: `type: description` or `type(scope): description`.",
+        "",
+        "| Prefix | Use for |",
+        "|--------|---------|",
+        "| `feat:` | New features or functionality |",
+        "| `fix:` | Bug fixes |",
+        "| `docs:` | Documentation-only changes |",
+        "| `chore:` | Maintenance: deps, tooling, config |",
+        "| `refactor:` | Code restructure, no behavior change |",
+        "| `release:` | Release preparation, version bumps |",
+        "| `hotfix:` | Urgent production fixes |",
+        "",
+        "## Link to the Issue",
+        "",
+        "When the PR addresses an issue, **always** include a closing keyword in the PR body:",
+        "- `Closes #<issue>`, `Fixes #<issue>`, or `Resolves #<issue>`",
+        "",
+        "## Summary of Changes",
+        "",
+        "Every PR must include a **summary of the changes** made. Use bullet points or short paragraphs. Do not leave the description empty.",
+        "",
+        "## Commit Messages",
+        "",
+        "Use **conventional commits** for git commit messages: `type: short description`. Do not add AI co-author or attribution."
+      ].join("\n"),
+      tags: ["workflow"]
+    },
+    {
+      name: "branch-naming-conventions",
+      description: "Branch format (type/[issue-]description), create-on-GitHub-then-fetch workflow",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Branch Naming Conventions",
+        "",
+        "## Format",
+        "",
+        "```",
+        "<type>/[<issue>-]<description>",
+        "```",
+        "",
+        "- **type** (required): One of `feat`, `fix`, `docs`, `chore`, `refactor`, `release`, `hotfix`",
+        "- **issue** (optional): Issue number (e.g., `25`). Include when known.",
+        "- **description** (required): Short, lowercase, kebab-case summary",
+        "",
+        "## Examples",
+        "",
+        "- `feat/25-add-cursor-rules`",
+        "- `fix/23-rename-cursor-rules-mdc`",
+        "- `chore/upgrade-eslint`",
+        "- `docs/update-readme`"
+      ].join("\n"),
+      tags: ["workflow"]
+    },
+    {
+      name: "issue-conventions",
+      description: "Issue title prefixes, GitHub issue type mapping, prerequisite issues",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Issue Title Conventions",
+        "",
+        "## Format",
+        "",
+        "```",
+        "<type>: <description>",
+        "```",
+        "",
+        "## Types",
+        "",
+        "| Prefix | Use for |",
+        "|--------|---------|",
+        "| `epic:` | Large initiatives spanning multiple child issues |",
+        "| `feat:` | New features or functionality |",
+        "| `fix:` | Bug fixes |",
+        "| `chore:` | Maintenance: deps, tooling, config |",
+        "| `docs:` | Documentation-only work |",
+        "| `refactor:` | Code restructure, no behavior change |",
+        "| `release:` | Release preparation, version bumps |",
+        "| `hotfix:` | Urgent production fixes |",
+        "",
+        "## Prerequisite Issues",
+        "",
+        "Include any prerequisite (blocking) issues in the issue body when they exist.",
+        "Use a **Dependencies** section or `**Depends on:** #123`."
+      ].join("\n"),
+      tags: ["workflow"]
+    }
+  ]
+};
+
+// src/agent/bundles/jest.ts
+var jestBundle = {
+  name: "jest",
+  description: "Jest testing conventions and patterns",
+  appliesWhen: (project) => hasDep(project, "jest"),
+  rules: [
+    {
+      name: "jest-testing",
+      description: "Jest testing conventions and patterns",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["**/*.test.ts", "**/*.spec.ts"],
+      content: [
+        "# Jest Testing Patterns",
+        "",
+        "## Mandatory Requirements",
+        "",
+        "- **Tests MUST be created or updated whenever code functionality is added or changed**",
+        "- This applies to all code changes, including:",
+        "  - New features and functionality",
+        "  - Bug fixes",
+        "  - Refactoring that changes behavior",
+        "  - API changes",
+        "  - Configuration changes that affect functionality",
+        "- Tests should be written or updated as part of the same change that modifies the code",
+        "",
+        "## Test Structure",
+        "",
+        "- Use **Jest** with SWC for fast compilation",
+        "- Test files: `.spec.ts` or `.test.ts` (co-located with source)",
+        "- Use descriptive test names: `describe('ClassName', () => { it('should do something specific', () => {}) })`",
+        "- Prefer snapshot tests for complex object structures",
+        "- Mock external dependencies appropriately",
+        "",
+        "## Test Organization",
+        "",
+        "- Co-locate test files with source files",
+        "- Test files can use dev dependencies (ESLint rule override)",
+        "- Use `@swc/jest` for fast compilation",
+        "- Configure Jest in `jest.config.json` (not in package.json)",
+        "",
+        "## Example Test Structure",
+        "",
+        "```typescript",
+        "import { MyClass } from './my-class';",
+        "",
+        "describe('MyClass', () => {",
+        "  it('should do something specific', () => {",
+        "    // Test implementation",
+        "  });",
+        "});",
+        "```"
+      ].join("\n"),
+      tags: ["testing"]
+    }
+  ]
+};
+
+// src/pnpm/pnpm-workspace.ts
+import { relative } from "path";
+import { Component, YamlFile } from "projen";
+var MIMIMUM_RELEASE_AGE = {
+  ZERO_DAYS: 0,
+  ONE_HOUR: 60,
+  SIX_HOURS: 360,
+  TWELVE_HOURS: 720,
+  ONE_DAY: 1440,
+  TWO_DAYS: 2880,
+  THREE_DAYS: 4320,
+  FOUR_DAYS: 5760,
+  FIVE_DAYS: 7200,
+  SIX_DAYS: 8640,
+  ONE_WEEK: 10080
+};
+var PnpmWorkspace = class _PnpmWorkspace extends Component {
+  /**
+   * Get the pnpm workspace component of a project. If it does not exist,
+   * return undefined.
+   *
+   * @param project
+   * @returns
+   */
+  static of(project) {
+    const isDefined = (c) => c instanceof _PnpmWorkspace;
+    return project.root.components.find(isDefined);
+  }
+  constructor(project, options = {}) {
+    super(project);
+    project.tryFindObjectFile("package.json")?.addDeletionOverride("pnpm");
+    this.fileName = options.fileName ?? "pnpm-workspace.yaml";
+    this.minimumReleaseAge = options.minimumReleaseAge ?? MIMIMUM_RELEASE_AGE.ONE_DAY;
+    this.minimumReleaseAgeExclude = options.minimumReleaseAgeExclude ? ["@codedrifters/*", ...options.minimumReleaseAgeExclude] : ["@codedrifters/*"];
+    this.onlyBuiltDependencies = options.onlyBuiltDependencies ? options.onlyBuiltDependencies : [];
+    this.ignoredBuiltDependencies = options.ignoredBuiltDependencies ? options.ignoredBuiltDependencies : [];
+    this.subprojects = options.subprojects ?? [];
+    this.defaultCatalog = options.defaultCatalog;
+    this.namedCatalogs = options.namedCatalogs;
+    project.addPackageIgnore(this.fileName);
+    new YamlFile(this.project, this.fileName, {
+      obj: () => {
+        const pnpmConfig = {};
+        const packages = new Array();
+        for (const subproject of project.subprojects) {
+          packages.push(relative(this.project.outdir, subproject.outdir));
+        }
+        const packageSet = new Set(packages);
+        for (const subprojectPath of this.subprojects) {
+          packageSet.add(subprojectPath);
+        }
+        if (this.subprojects.length > 0) {
+          packages.length = 0;
+          packages.push(...packageSet);
+        }
+        pnpmConfig.minimumReleaseAge = this.minimumReleaseAge;
+        if (this.minimumReleaseAgeExclude.length > 0) {
+          pnpmConfig.minimumReleaseAgeExclude = this.minimumReleaseAgeExclude;
+        }
+        if (this.onlyBuiltDependencies.length > 0) {
+          pnpmConfig.onlyBuiltDependencies = this.onlyBuiltDependencies;
+        }
+        if (this.ignoredBuiltDependencies.length > 0) {
+          pnpmConfig.ignoreBuiltDependencies = this.ignoredBuiltDependencies;
+        }
+        if (this.defaultCatalog && Object.keys(this.defaultCatalog).length > 0) {
+          pnpmConfig.catalog = this.defaultCatalog;
+        }
+        if (this.namedCatalogs && Object.keys(this.namedCatalogs).length > 0) {
+          pnpmConfig.namedCatalogs = this.namedCatalogs;
+        }
+        return {
+          ...packages.length > 0 ? { packages } : {},
+          ...pnpmConfig ? { ...pnpmConfig } : {}
+        };
+      }
+    });
+  }
+};
+
+// src/agent/bundles/pnpm.ts
+var pnpmBundle = {
+  name: "pnpm",
+  description: "PNPM workspace rules and dependency management conventions",
+  appliesWhen: (project) => hasComponent(project, PnpmWorkspace),
+  rules: [
+    {
+      name: "pnpm-workspace",
+      description: "PNPM workspace and dependency management conventions",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["package.json", "pnpm-workspace.yaml", "pnpm-lock.yaml"],
+      content: [
+        "# PNPM Workspace Conventions",
+        "",
+        "## Package Management",
+        "",
+        "- Use **PNPM** for package management",
+        "- Workspace configuration in `pnpm-workspace.yaml`",
+        "- Dependencies managed through Projen, not directly in `package.json`",
+        "- **Always use workspace dependencies** (`workspace:*` or `workspace:^`) for packages within this monorepo",
+        "- Never use published NPM versions of internal packages; always reference the local workspace version",
+        "",
+        "## Dependency Management",
+        "",
+        "**DO:**",
+        "- Configure dependencies in Projen configuration files (`.projenrc.ts` or `projenrc/*.ts`)",
+        "- Add dependencies to `deps`, `devDeps`, or `peerDeps` arrays in project configuration",
+        '- Use catalog dependencies when available (e.g., `"aws-cdk-lib@catalog:"`)',
+        "- Ask the user to run `npx projen` and `pnpm install` after updating dependency configuration",
+        "",
+        "**DO NOT:**",
+        "- Run `npm install some-package`",
+        "- Run `pnpm add some-package`",
+        "- Run `yarn add some-package`",
+        "- Manually edit `package.json` dependencies",
+        "",
+        "Manual package installation creates conflicts with Projen-managed files."
+      ].join("\n"),
+      tags: ["workflow"]
+    }
+  ]
+};
+
+// src/agent/bundles/projen.ts
+var projenBundle = {
+  name: "projen",
+  description: "Projen conventions, synthesis workflow, .projenrc.ts patterns",
+  appliesWhen: (project) => hasDep(project, "projen"),
+  rules: [
+    {
+      name: "projen-conventions",
+      description: "Projen configuration patterns and best practices",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["projenrc/**/*.ts", ".projenrc.ts"],
+      content: [
+        "# Projen Conventions",
+        "",
+        "## Configuration Management",
+        "",
+        "- **Never edit generated files** (`package.json`, `tsconfig.json`, etc. marked with `// ~~ Generated by projen`)",
+        "- Edit Projen configuration in:",
+        "  - `.projenrc.ts` (root)",
+        "  - `projenrc/*.ts` (package-specific)",
+        "- After making Projen changes, ask the user to run `npx projen` locally (agent must not run it)",
+        "",
+        "## Custom Projen Components",
+        "",
+        "All custom components must extend `Component` from Projen and use a static `.of()` factory for discovery:",
+        "",
+        "```typescript",
+        "export class MyComponent extends Component {",
+        "  public static of(project: Project): MyComponent | undefined {",
+        "    const isDefined = (c: Component): c is MyComponent =>",
+        "      c instanceof MyComponent;",
+        "    return project.components.find(isDefined);",
+        "  }",
+        "",
+        "  constructor(project: Project, options: MyComponentOptions) {",
+        "    super(project);",
+        "    // Implementation",
+        "  }",
+        "}",
+        "```",
+        "",
+        "## Component Authoring",
+        "",
+        "- Export project types and utilities from `index.ts`",
+        "- Follow Projen's component lifecycle patterns",
+        "- Use `merge` from `ts-deepmerge` for deep merging configuration objects",
+        "- Components should be reusable and configurable; use TypeScript interfaces for component options",
+        "- Provide sensible defaults while allowing customization",
+        "- Document public APIs with minimal JSDoc; put extended documentation in markdown",
+        "",
+        "## Dependencies",
+        "",
+        "- Dependencies managed through Projen configuration, not directly in `package.json`",
+        '- Use catalog dependencies when available (e.g., `"projen": "catalog:"`)',
+        "- Peer dependencies for shared libraries (e.g., `constructs`, `projen`, `aws-cdk-lib`)",
+        '- Use workspace protocol for internal packages: `"@org/pkg@workspace:*"`'
+      ].join("\n"),
+      tags: ["workflow"]
+    }
+  ]
+};
+
+// src/turbo/turbo-repo.ts
+import { Component as Component3, FileBase, JsonFile } from "projen/lib";
+import { JobPermission } from "projen/lib/github/workflows-model";
+
+// src/turbo/turbo-repo-task.ts
+import { Component as Component2 } from "projen/lib";
+var TurboRepoTask = class extends Component2 {
+  constructor(project, options) {
+    super(project);
+    this.project = project;
+    this.name = options.name;
+    this.dependsOn = options.dependsOn ?? [];
+    this.env = options.env ?? [];
+    this.passThroughEnv = options.passThroughEnv ?? [];
+    this.outputs = options.outputs ?? [];
+    this.cache = options.cache ?? true;
+    this.inputs = [
+      ...options.inputs ?? [],
+      // rerun if projen config changes
+      ".projen/**",
+      // ignore mac files
+      "!.DS_Store",
+      "!**/.DS_Store"
+    ];
+    this.outputLogs = options.outputLogs ?? "new-only";
+    this.persistent = options.persistent ?? false;
+    this.interactive = options.interactive ?? false;
+    this.isActive = true;
+  }
+  taskConfig() {
+    return {
+      dependsOn: this.dependsOn,
+      env: this.env,
+      passThroughEnv: this.passThroughEnv,
+      outputs: this.outputs,
+      cache: this.cache,
+      inputs: this.inputs,
+      outputLogs: this.outputLogs,
+      persistent: this.persistent,
+      interactive: this.interactive
+    };
+  }
+};
+
+// src/turbo/turbo-repo.ts
+var ROOT_TURBO_TASK_NAME = "turbo:build";
+var ROOT_CI_TASK_NAME = "build:all";
+var _TurboRepo = class _TurboRepo extends Component3 {
+  constructor(project, options = {}) {
+    super(project);
+    this.project = project;
+    /**
+     * Sub-Tasks to run
+     */
+    this.tasks = [];
+    this.turboVersion = options.turboVersion ?? "catalog:";
+    this.isRootProject = project === project.root;
+    if (this.isRootProject) {
+      project.addDevDeps(`turbo@${this.turboVersion}`);
+    }
+    project.gitignore.addPatterns("/.turbo");
+    project.npmignore?.addPatterns("/.turbo/");
+    this.extends = options.extends ?? (this.isRootProject ? [] : ["//"]);
+    this.globalDependencies = options.globalDependencies ?? [];
+    this.globalEnv = options.globalEnv ?? [];
+    this.globalPassThroughEnv = options.globalPassThroughEnv ?? [];
+    this.ui = options.ui ?? "stream";
+    this.dangerouslyDisablePackageManagerCheck = options.dangerouslyDisablePackageManagerCheck ?? false;
+    this.cacheDir = options.cacheDir ?? ".turbo/cache";
+    this.daemon = options.daemon ?? true;
+    this.envMode = options.envMode ?? "strict";
+    this.remoteCacheOptions = options.remoteCacheOptions;
+    this.buildAllTaskEnvVars = options.buildAllTaskEnvVars ?? {};
+    const rootGeneratedFiles = this.isRootProject ? this.project.components.filter((c) => c instanceof FileBase).map((c) => c.path) : [];
+    this.buildTask = new TurboRepoTask(this.project, {
+      name: ROOT_TURBO_TASK_NAME,
+      dependsOn: this.isRootProject ? [`^${ROOT_TURBO_TASK_NAME}`] : [],
+      ...rootGeneratedFiles.length > 0 && { inputs: rootGeneratedFiles }
+    });
+    if (this.isRootProject) {
+      this.buildAllTask = this.project.tasks.addTask(ROOT_CI_TASK_NAME, {
+        description: "Root build followed by sub-project builds. Mimics the CI build process in one step."
+      });
+      this.buildAllTask.exec("turbo telemetry disable");
+      if (this.buildAllTaskEnvVars) {
+        Object.entries(this.buildAllTaskEnvVars).forEach(([name, value]) => {
+          this.addGlobalEnvVar(name, value);
+        });
+      }
+      if (!this.remoteCacheOptions) {
+        this.buildAllTask.exec(
+          `turbo ${ROOT_TURBO_TASK_NAME} --summarize --concurrency=10`
+        );
+      } else {
+        this.buildAllTask.exec(
+          `turbo turbo:build --summarize --concurrency=10 --cache=remote:rw --api=$TURBO_ENDPOINT --token=$TURBO_TOKEN --team=${this.remoteCacheOptions.teamName}`,
+          {
+            condition: '[ ! -n "$CI" ]',
+            env: {
+              TURBO_ENDPOINT: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.endpointParamName} --query Parameter.Value --output text --profile ${this.remoteCacheOptions.profileName})`,
+              TURBO_TOKEN: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.tokenParamName} --query Parameter.Value --output text --profile ${this.remoteCacheOptions.profileName})`
+            }
+          }
+        );
+        this.buildAllTask.exec(
+          `turbo turbo:build --summarize --concurrency=10 --cache=remote:rw --api=$TURBO_ENDPOINT --token=$TURBO_TOKEN --team=${this.remoteCacheOptions.teamName}`,
+          {
+            condition: '[ -n "$CI" ]',
+            env: {
+              TURBO_ENDPOINT: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.endpointParamName} --query Parameter.Value --output text)`,
+              TURBO_TOKEN: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.tokenParamName} --query Parameter.Value --output text)`
+            }
+          }
+        );
+      }
+    }
+    if (!this.isRootProject) {
+      const generatedFiles = this.project.components.filter((c) => c instanceof FileBase).map((c) => c.path);
+      this.preCompileTask = new TurboRepoTask(project, {
+        name: options.preCompileTask?.name ?? "pre-compile",
+        inputs: ["src/**", ...generatedFiles]
+      });
+      this.compileTask = new TurboRepoTask(project, {
+        name: options.compileTask?.name ?? "compile",
+        inputs: ["src/**", ...generatedFiles]
+      });
+      this.postCompileTask = new TurboRepoTask(project, {
+        name: options.postCompileTask?.name ?? "post-compile",
+        inputs: ["src/**", ...generatedFiles]
+      });
+      this.testTask = new TurboRepoTask(project, {
+        name: options.testTask?.name ?? "test"
+      });
+      this.packageTask = new TurboRepoTask(project, {
+        name: options.packageTask?.name ?? "package",
+        inputs: [".npmignore"]
+      });
+      this.tasks.push(
+        this.preCompileTask,
+        this.compileTask,
+        this.postCompileTask,
+        this.testTask,
+        this.packageTask
+      );
+    }
+  }
+  /**
+   * Static method to discovert turbo in a project.
+   */
+  static of(project) {
+    const isDefined = (c) => c instanceof _TurboRepo;
+    return project.components.find(isDefined);
+  }
+  /**
+   * Add an env var to the global env vars for all tasks.
+   * This will also become an input for the build:all task cache at the root.
+   */
+  addGlobalEnvVar(name, value) {
+    this.buildAllTask?.env(name, value);
+    if (this.isRootProject) {
+      this.globalEnv.push(name);
+    }
+  }
+  /**
+   * Sets GIT_BRANCH_NAME so root tasks (e.g. build:all) pass the current branch.
+   * Value must be exactly $(...) so Projen's task runtime expands it; the shell
+   * then expands ${GIT_BRANCH_NAME:-$(git rev-parse --abbrev-ref HEAD)}.
+   */
+  activateBranchNameEnvVar() {
+    this.addGlobalEnvVar(
+      "GIT_BRANCH_NAME",
+      '$(echo "${GIT_BRANCH_NAME:-$(git rev-parse --abbrev-ref HEAD)}")'
+    );
+  }
+  preSynthesize() {
+    let nextDependsOn = this.project.deps.all.filter((d) => d.version === "workspace:*").map((d) => [d.name, ROOT_TURBO_TASK_NAME].join("#"));
+    if (!this.isRootProject) {
+      [
+        [this.project.preCompileTask, this.preCompileTask],
+        [this.project.compileTask, this.compileTask],
+        [this.project.postCompileTask, this.postCompileTask],
+        [this.project.testTask, this.testTask],
+        [this.project.packageTask, this.packageTask]
+      ].forEach(([pjTask, turboTask]) => {
+        if (pjTask && turboTask && pjTask.steps.length > 0) {
+          if (nextDependsOn.length > 0) {
+            turboTask.dependsOn.push(...nextDependsOn);
+          }
+          nextDependsOn = [turboTask.name];
+        } else {
+          turboTask.isActive = false;
+        }
+      });
+      this.buildTask.dependsOn.push(...nextDependsOn);
+    }
+    const fileName = "turbo.json";
+    this.project.addPackageIgnore(fileName);
+    new JsonFile(this.project, fileName, {
+      obj: {
+        extends: this.extends.length ? this.extends : void 0,
+        globalDependencies: this.isRootProject && this.globalDependencies.length ? this.globalDependencies : void 0,
+        globalEnv: this.isRootProject && this.globalEnv.length ? this.globalEnv : void 0,
+        globalPassThroughEnv: this.isRootProject && this.globalPassThroughEnv.length ? this.globalPassThroughEnv : void 0,
+        ui: this.isRootProject ? this.ui : void 0,
+        dangerouslyDisablePackageManagerCheck: this.isRootProject ? this.dangerouslyDisablePackageManagerCheck : void 0,
+        cacheDir: this.isRootProject ? this.cacheDir : void 0,
+        daemon: this.isRootProject ? this.daemon : void 0,
+        envMode: this.isRootProject ? this.envMode : void 0,
+        /**
+         * All tasks
+         */
+        tasks: this.tasks.filter((task) => task.isActive).reduce(
+          (acc, task) => {
+            acc[task.name] = {
+              ...task.taskConfig()
+            };
+            return acc;
+          },
+          {
+            [this.buildTask.name]: { ...this.buildTask.taskConfig() }
+          }
+        )
+      }
+    });
+    super.preSynthesize();
+  }
+};
+_TurboRepo.buildWorkflowOptions = (remoteCacheOptions) => {
+  return {
+    env: {
+      GIT_BRANCH_NAME: "${{ github.head_ref || github.ref_name }}"
+    },
+    permissions: {
+      contents: JobPermission.WRITE,
+      idToken: JobPermission.WRITE
+    },
+    preBuildSteps: [
+      {
+        name: "AWS Creds for SSM",
+        uses: "aws-actions/configure-aws-credentials@v4",
+        with: {
+          ["role-to-assume"]: remoteCacheOptions.oidcRole,
+          ["aws-region"]: "us-east-1",
+          ["role-duration-seconds"]: "900"
+        }
+      }
+    ]
+  };
+};
+var TurboRepo = _TurboRepo;
+
+// src/agent/bundles/turborepo.ts
+var turborepoBundle = {
+  name: "turborepo",
+  description: "Turborepo workspace rules and task pipeline conventions",
+  appliesWhen: (project) => hasComponent(project, TurboRepo),
+  rules: [
+    {
+      name: "turborepo-conventions",
+      description: "Turborepo build system and task pipeline conventions",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["turbo.json", "package.json"],
+      content: [
+        "# Turborepo Conventions",
+        "",
+        "## Build System",
+        "",
+        "- **Build**: `pnpm build:all` (uses Turborepo)",
+        "- **Test**: `pnpm test` or `pnpm test:watch`",
+        "- **Lint**: `pnpm eslint`",
+        "",
+        "## Task Pipeline",
+        "",
+        "- Uses remote caching (requires AWS credentials)",
+        "- Only rebuilds changed packages",
+        "- Cache key based on file hashes and dependency graph",
+        "- Configured in `turbo.json`",
+        "",
+        "## Workspace Rules",
+        "",
+        "- Source files: `src/` directory",
+        "- Tests: Co-located with source files (`.spec.ts` or `.test.ts`)",
+        "- Exports: Use `index.ts` files for clean public APIs",
+        "- Configuration: Managed by Projen (edit `.projenrc.ts` or `projenrc/*.ts`)"
+      ].join("\n"),
+      tags: ["workflow"]
+    }
+  ]
+};
+
+// src/agent/bundles/typescript.ts
+var typescriptBundle = {
+  name: "typescript",
+  description: "TypeScript conventions, type safety, naming, JSDoc, member ordering",
+  appliesWhen: (project) => hasFile(project, "tsconfig.json"),
+  rules: [
+    {
+      name: "typescript-conventions",
+      description: "TypeScript coding conventions and style guide",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["**/*.ts", "**/*.tsx"],
+      content: [
+        "# TypeScript Conventions",
+        "",
+        "## Type Safety",
+        "",
+        "- Use **strict TypeScript** with all strict checks enabled",
+        "- Always use explicit types; avoid `any` unless absolutely necessary",
+        "- Use `readonly` for immutable properties",
+        "- Prefer interfaces over types for object shapes",
+        "- Use proper TypeScript types from libraries",
+        "",
+        "## Code Organization",
+        "",
+        "- Follow the member ordering rule:",
+        "  1. Public static fields/methods",
+        "  2. Protected static fields/methods",
+        "  3. Private static fields/methods",
+        "  4. Instance fields",
+        "  5. Constructor",
+        "  6. Methods",
+        "",
+        "## Documentation",
+        "",
+        "- **Keep JSDoc minimal** so that the code remains human-readable. Use brief summaries only.",
+        "- Use JSDoc for:",
+        "  - Public classes and interfaces (short description)",
+        "  - Public methods and properties (brief purpose; parameter and return when not obvious)",
+        "  - Configuration options (one-line description)",
+        "- **Extended documentation** belongs in **markdown** files. Link from JSDoc via `@see` or an inline link.",
+        "",
+        "## Naming Conventions",
+        "",
+        "- **Classes**: PascalCase (e.g., `TypeScriptProject`, `StaticHosting`)",
+        "- **Interfaces**: PascalCase, often with `Props` suffix for configuration (e.g., `StaticHostingProps`)",
+        "- **Functions/Methods**: camelCase (e.g., `configureProject`)",
+        "- **Constants**: UPPER_SNAKE_CASE (e.g., `VERSION`, `AWS_STAGE_TYPE`)",
+        "- **Files**: kebab-case for multi-word files (e.g., `aws-deployment-config.ts`)",
+        "- **Private members**: No prefix needed (TypeScript handles visibility)"
+      ].join("\n"),
+      tags: ["coding"]
+    }
+  ]
+};
+
+// src/vitest/vitest-component.ts
+import { Component as Component4 } from "projen";
+import { Jest } from "projen/lib/javascript";
+import { TextFile } from "projen/lib/textfile";
+
+// src/versions.ts
+var VERSION = {
+  /**
+   * CDK CLI for workflows and command line operations.
+   *
+   * CLI and lib are versioned separately, so this is the CLI version.
+   */
+  AWS_CDK_CLI_VERSION: "2.1117.0",
+  /**
+   * CDK Version to use for construct projects.
+   *
+   * CLI and lib are versioned separately, so this is the lib version.
+   */
+  AWS_CDK_LIB_VERSION: "2.248.0",
+  /**
+   * Version of the AWS Constructs library to use.
+   */
+  AWS_CONSTRUCTS_VERSION: "10.6.0",
+  /**
+   * Version of Node.js to use in CI workflows at github actions.
+   */
+  NODE_WORKFLOWS: "24",
+  /**
+   * Version of PNPM to use in workflows at github actions.
+   */
+  PNPM_VERSION: "10.33.0",
+  /**
+   * Version of Projen to use.
+   */
+  PROJEN_VERSION: "0.99.34",
+  /**
+   * What version of the turborepo library should we use?
+   */
+  TURBO_VERSION: "2.9.4",
+  /**
+   * What version of Vite to use (pnpm override). Pinned to 5.x so Vitest 4.x
+   * can load config (Vite 6+/7+ are ESM-only; see issue #142). Remove override
+   * when moving to ESM-only test setup.
+   */
+  VITE_VERSION: "5.4.11",
+  /**
+   * What version of Vitest to use when testRunner is 'vitest'.
+   * Pinned to 3.x so it works with Vite 5 (Vitest 4 requires Vite 6). See issue #142.
+   */
+  VITEST_VERSION: "3.2.4"
+};
+
+// src/vitest/vitest-component.ts
+var Vitest = class _Vitest extends Component4 {
+  constructor(project, options = {}) {
+    super(project);
+    this.project = project;
+    this.configFilePath = options.configFilePath ?? "vitest.config.ts";
+    const config = options.config ?? {};
+    this.include = config.include ?? ["**/*.{test,spec}.?(c|m)[jt]s?(x)"];
+    this.exclude = config.exclude ?? [
+      "**/node_modules/**",
+      "**/dist/**",
+      "**/lib/**",
+      "**/.?*"
+    ];
+    this.environment = config.environment ?? "node";
+    this.passWithNoTests = config.passWithNoTests ?? true;
+    this.coverageEnabled = config.coverageEnabled ?? true;
+    this.coverageDirectory = config.coverageDirectory ?? "coverage";
+    this.coverageReporters = config.coverageReporters ?? ["text", "lcov"];
+    this.version = options.vitestVersion ?? VERSION.VITEST_VERSION;
+    project.addDevDeps(`vitest@${this.version}`);
+    if (this.coverageEnabled) {
+      project.addDevDeps(`@vitest/coverage-v8@${this.version}`);
+    }
+    const coveragePath = `/${this.coverageDirectory}/`;
+    project.gitignore.addPatterns(coveragePath);
+    project.npmignore?.exclude(coveragePath);
+    this.addTestTasks();
+    this.synthesizeConfig();
+  }
+  /**
+   * Find the Vitest component on a project.
+   */
+  static of(project) {
+    const isVitest = (c) => c instanceof _Vitest;
+    return project.components.find(isVitest);
+  }
+  preSynthesize() {
+    super.preSynthesize();
+    for (const component of this.project.components) {
+      if (component instanceof Jest) {
+        throw new Error("Vitest cannot be used together with Jest");
+      }
+    }
+  }
+  addTestTasks() {
+    this.project.testTask.exec("vitest run --update");
+    if (!this.project.tasks.tryFind("test:watch")) {
+      this.project.addTask("test:watch", {
+        description: "Run tests in watch mode",
+        exec: "vitest watch",
+        receiveArgs: true
+      });
+    }
+  }
+  synthesizeConfig() {
+    this.project.tryRemoveFile(this.configFilePath);
+    new TextFile(this, this.configFilePath, {
+      lines: this.renderConfig()
+    });
+  }
+  renderConfig() {
+    return [
+      'import { defineConfig } from "vitest/config";',
+      "",
+      "export default defineConfig({",
+      "  test: {",
+      `    include: ${JSON.stringify(this.include)},`,
+      `    exclude: ${JSON.stringify(this.exclude)},`,
+      `    environment: "${this.environment}",`,
+      `    passWithNoTests: ${this.passWithNoTests},`,
+      "    coverage: {",
+      `      enabled: ${this.coverageEnabled},`,
+      `      provider: "v8",`,
+      `      reportsDirectory: "${this.coverageDirectory}",`,
+      `      reporter: ${JSON.stringify(this.coverageReporters)},`,
+      "    },",
+      "  },",
+      "});"
+    ];
+  }
+};
+
+// src/agent/bundles/vitest.ts
+var vitestBundle = {
+  name: "vitest",
+  description: "Vitest testing conventions, patterns, and file scoping",
+  appliesWhen: (project) => hasComponent(project, Vitest),
+  rules: [
+    {
+      name: "vitest-testing",
+      description: "Vitest testing conventions and patterns",
+      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+      filePatterns: ["**/*.test.ts", "**/*.spec.ts"],
+      content: [
+        "# Vitest Testing Patterns",
+        "",
+        "## Mandatory Requirements",
+        "",
+        "- **Tests MUST be created or updated whenever code functionality is added or changed**",
+        "- This applies to all code changes, including:",
+        "  - New features and functionality",
+        "  - Bug fixes",
+        "  - Refactoring that changes behavior",
+        "  - API changes",
+        "  - Configuration changes that affect functionality",
+        "- Tests should be written or updated as part of the same change that modifies the code",
+        "",
+        "## Test Structure",
+        "",
+        "- Use **Vitest** as the test runner",
+        "- Test files: `.spec.ts` or `.test.ts` (co-located with source)",
+        "- Use descriptive test names: `describe('ClassName', () => { it('should do something specific', () => {}) })`",
+        "- Prefer snapshot tests for complex object structures",
+        "- Mock external dependencies appropriately",
+        "",
+        "## Test Organization",
+        "",
+        "- Co-locate test files with source files",
+        "- Test files can use dev dependencies (ESLint rule override)",
+        "- Import from `vitest`: `import { describe, expect, it } from 'vitest'`",
+        "",
+        "## Example Test Structure",
+        "",
+        "```typescript",
+        "import { describe, expect, it } from 'vitest';",
+        "import { MyClass } from './my-class';",
+        "",
+        "describe('MyClass', () => {",
+        "  it('should do something specific', () => {",
+        "    // Test implementation",
+        "  });",
+        "});",
+        "```"
+      ].join("\n"),
+      tags: ["testing"]
+    }
+  ]
+};
+
+// src/agent/bundles/index.ts
+var BUILT_IN_BUNDLES = [
+  baseBundle,
+  typescriptBundle,
+  vitestBundle,
+  jestBundle,
+  turborepoBundle,
+  pnpmBundle,
+  awsCdkBundle,
+  projenBundle
+];
+
+// src/projects/project-metadata.ts
+import { Component as Component5 } from "projen";
+import { NodeProject as NodeProject2 } from "projen/lib/javascript";
+var GITHUB_HTTPS_RE = /(?:https?:\/\/|git\+https:\/\/)github\.com\/([^/]+)\/([^/.]+)(?:\.git)?/;
+var GITHUB_SSH_RE = /git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?/;
+function parseGitHubUrl(url) {
+  const httpsMatch = url.match(GITHUB_HTTPS_RE);
+  if (httpsMatch) {
+    return { owner: httpsMatch[1], name: httpsMatch[2] };
+  }
+  const sshMatch = url.match(GITHUB_SSH_RE);
+  if (sshMatch) {
+    return { owner: sshMatch[1], name: sshMatch[2] };
+  }
+  return { owner: void 0, name: void 0 };
+}
+var ProjectMetadata = class _ProjectMetadata extends Component5 {
+  /**
+   * Returns the ProjectMetadata instance for a project, or undefined
+   * if the component has not been added.
+   */
+  static of(project) {
+    const isProjectMetadata = (c) => c instanceof _ProjectMetadata;
+    return project.components.find(isProjectMetadata);
+  }
+  constructor(project, options = {}) {
+    super(project);
+    this.metadata = this.resolveMetadata(options);
+  }
+  /**
+   * Merges explicit options with auto-detected values.
+   * Auto-detection reads the repository URL from package.json
+   * (via Projen's NodePackage manifest) and parses GitHub owner/name.
+   * Explicit options always take precedence over auto-detected values.
+   */
+  resolveMetadata(options) {
+    const autoDetected = this.autoDetectRepository();
+    return {
+      repository: {
+        owner: options.repository?.owner ?? autoDetected.owner,
+        name: options.repository?.name ?? autoDetected.name,
+        defaultBranch: options.repository?.defaultBranch ?? "main"
+      },
+      githubProject: options.githubProject,
+      organization: options.organization,
+      slack: options.slack,
+      labels: options.labels,
+      milestones: options.milestones,
+      docsPath: options.docsPath,
+      deployment: options.deployment
+    };
+  }
+  /**
+   * Attempts to auto-detect repository owner and name from the Projen
+   * project's package.json repository field.
+   */
+  autoDetectRepository() {
+    if (!(this.project instanceof NodeProject2)) {
+      return { owner: void 0, name: void 0 };
+    }
+    const manifest = this.project.package.manifest;
+    const repoField = manifest.repository;
+    if (!repoField) {
+      return { owner: void 0, name: void 0 };
+    }
+    const url = typeof repoField === "string" ? repoField : repoField.url ?? "";
+    return parseGitHubUrl(url);
+  }
+};
+
 // src/agent/renderers/claude-renderer.ts
+import { JsonFile as JsonFile2 } from "projen";
+import { TextFile as TextFile2 } from "projen/lib/textfile";
 var GENERATED_MARKER = "<!-- ~~ Generated by @codedrifters/configulator. Edits welcome \u2014 please contribute improvements back. ~~ -->";
 var ClaudeRenderer = class _ClaudeRenderer {
   /**
@@ -235,7 +1356,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
       if (i > 0) lines.push("", "---", "");
       lines.push(...claudeMdRules[i].content.split("\n"));
     }
-    new TextFile(component, "CLAUDE.md", { lines });
+    new TextFile2(component, "CLAUDE.md", { lines });
   }
   static renderScopedRules(component, rules) {
     const scopedRules = rules.filter((r) => {
@@ -255,7 +1376,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
         lines.push("");
       }
       lines.push(...rule.content.split("\n"));
-      new TextFile(component, `.claude/rules/${rule.name}.md`, { lines });
+      new TextFile2(component, `.claude/rules/${rule.name}.md`, { lines });
     }
   }
   static renderSettings(component, mcpServers, settings) {
@@ -370,7 +1491,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
       hasContent = true;
     }
     if (!hasContent) return;
-    new JsonFile(component, ".claude/settings.json", { obj });
+    new JsonFile2(component, ".claude/settings.json", { obj });
   }
   static buildSandboxObj(sandbox) {
     const obj = {};
@@ -446,7 +1567,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
       lines.push("---");
       lines.push("");
       lines.push(...skill.instructions.split("\n"));
-      new TextFile(component, `.claude/skills/${skill.name}/SKILL.md`, {
+      new TextFile2(component, `.claude/skills/${skill.name}/SKILL.md`, {
         lines
       });
     }
@@ -483,7 +1604,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
       lines.push("---");
       lines.push("");
       lines.push(...agent.prompt.split("\n"));
-      new TextFile(component, `.claude/agents/${agent.name}.md`, { lines });
+      new TextFile2(component, `.claude/agents/${agent.name}.md`, { lines });
     }
   }
   /**
@@ -508,8 +1629,8 @@ var CopilotRenderer = class {
 };
 
 // src/agent/renderers/cursor-renderer.ts
-import { JsonFile as JsonFile2 } from "projen";
-import { TextFile as TextFile2 } from "projen/lib/textfile";
+import { JsonFile as JsonFile3 } from "projen";
+import { TextFile as TextFile3 } from "projen/lib/textfile";
 var GENERATED_MARKER2 = "# ~~ Generated by @codedrifters/configulator. Edits welcome \u2014 please contribute improvements back. ~~";
 var CursorRenderer = class _CursorRenderer {
   /**
@@ -538,7 +1659,7 @@ var CursorRenderer = class _CursorRenderer {
       lines.push("---");
       lines.push("");
       lines.push(...rule.content.split("\n"));
-      new TextFile2(component, `.cursor/rules/${rule.name}.mdc`, { lines });
+      new TextFile3(component, `.cursor/rules/${rule.name}.mdc`, { lines });
     }
   }
   static renderSkills(component, skills) {
@@ -562,7 +1683,7 @@ var CursorRenderer = class _CursorRenderer {
       lines.push("---");
       lines.push("");
       lines.push(...skill.instructions.split("\n"));
-      new TextFile2(component, `.cursor/skills/${skill.name}/SKILL.md`, {
+      new TextFile3(component, `.cursor/skills/${skill.name}/SKILL.md`, {
         lines
       });
     }
@@ -587,7 +1708,7 @@ var CursorRenderer = class _CursorRenderer {
       lines.push("---");
       lines.push("");
       lines.push(...agent.prompt.split("\n"));
-      new TextFile2(component, `.cursor/agents/${agent.name}.md`, { lines });
+      new TextFile3(component, `.cursor/agents/${agent.name}.md`, { lines });
     }
   }
   static renderMcpServers(component, mcpServers) {
@@ -603,7 +1724,7 @@ var CursorRenderer = class _CursorRenderer {
       if (config.env) server.env = { ...config.env };
       servers[name] = server;
     }
-    new JsonFile2(component, ".cursor/mcp.json", { obj });
+    new JsonFile3(component, ".cursor/mcp.json", { obj });
   }
   static renderHooks(component, settings) {
     if (!settings?.hooks) return;
@@ -641,26 +1762,75 @@ var CursorRenderer = class _CursorRenderer {
     }
     if (stop?.length) hooks.stop = stop.map((h) => ({ command: h.command }));
     if (Object.keys(hooks).length === 0) return;
-    new JsonFile2(component, ".cursor/hooks.json", {
+    new JsonFile3(component, ".cursor/hooks.json", {
       obj: { version: 1, hooks }
     });
   }
   static renderIgnoreFiles(component, settings) {
     if (settings?.ignorePatterns && settings.ignorePatterns.length > 0) {
-      new TextFile2(component, ".cursorignore", {
+      new TextFile3(component, ".cursorignore", {
         lines: [GENERATED_MARKER2, "", ...settings.ignorePatterns]
       });
     }
     if (settings?.indexingIgnorePatterns && settings.indexingIgnorePatterns.length > 0) {
-      new TextFile2(component, ".cursorindexingignore", {
+      new TextFile3(component, ".cursorindexingignore", {
         lines: [GENERATED_MARKER2, "", ...settings.indexingIgnorePatterns]
       });
     }
   }
 };
 
+// src/agent/template-resolver.ts
+var FALLBACKS = {
+  "repository.owner": "<owner>",
+  "repository.name": "<repo>",
+  "repository.defaultBranch": "main",
+  "organization.name": "<organization>",
+  "organization.githubOrg": "<org>",
+  "githubProject.name": "<project-name>",
+  "githubProject.number": "<project-number>",
+  "githubProject.nodeId": "<project-node-id>",
+  docsPath: "<docs-path>"
+};
+var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
+function getNestedValue(obj, path) {
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") {
+      return void 0;
+    }
+    current = current[part];
+  }
+  if (current == null) {
+    return void 0;
+  }
+  return String(current);
+}
+function resolveTemplateVariables(template, metadata) {
+  if (!TEMPLATE_RE.test(template)) {
+    return { resolved: template, unresolvedKeys: [] };
+  }
+  const unresolvedKeys = [];
+  TEMPLATE_RE.lastIndex = 0;
+  const resolved = template.replace(TEMPLATE_RE, (_match, key) => {
+    if (metadata) {
+      const value = getNestedValue(
+        metadata,
+        key
+      );
+      if (value !== void 0) {
+        return value;
+      }
+    }
+    unresolvedKeys.push(key);
+    return FALLBACKS[key] ?? `<${key}>`;
+  });
+  return { resolved, unresolvedKeys };
+}
+
 // src/agent/agent-config.ts
-var AgentConfig = class _AgentConfig extends Component3 {
+var AgentConfig = class _AgentConfig extends Component8 {
   /**
    * Find the AgentConfig component on a project.
    */
@@ -679,12 +1849,20 @@ var AgentConfig = class _AgentConfig extends Component3 {
     const skills = this.resolveSkills();
     const subAgents = this.resolveSubAgents();
     const mcpServers = this.options.mcpServers ?? {};
+    const projectMetadata = ProjectMetadata.of(this.project);
+    const metadata = projectMetadata?.metadata;
+    const resolvedRules = this.resolveTemplates(rules, metadata);
+    const resolvedSkills = this.resolveSkillTemplates(skills, metadata);
+    const resolvedSubAgents = this.resolveSubAgentTemplates(
+      subAgents,
+      metadata
+    );
     if (platforms.includes(AGENT_PLATFORM.CURSOR)) {
       CursorRenderer.render(
         this,
-        rules,
-        skills,
-        subAgents,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents,
         mcpServers,
         this.options.cursorSettings
       );
@@ -692,18 +1870,28 @@ var AgentConfig = class _AgentConfig extends Component3 {
     if (platforms.includes(AGENT_PLATFORM.CLAUDE)) {
       ClaudeRenderer.render(
         this,
-        rules,
-        skills,
-        subAgents,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents,
         mcpServers,
         this.options.claudeSettings
       );
     }
     if (platforms.includes(AGENT_PLATFORM.CODEX)) {
-      CodexRenderer.render(this, rules, skills, subAgents);
+      CodexRenderer.render(
+        this,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents
+      );
     }
     if (platforms.includes(AGENT_PLATFORM.COPILOT)) {
-      CopilotRenderer.render(this, rules, skills, subAgents);
+      CopilotRenderer.render(
+        this,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents
+      );
     }
   }
   resolvePlatforms() {
@@ -714,6 +1902,9 @@ var AgentConfig = class _AgentConfig extends Component3 {
     if (this.options.autoDetectBundles !== false) {
       for (const bundle of BUILT_IN_BUNDLES) {
         if (this.options.excludeBundles?.includes(bundle.name)) continue;
+        if (bundle.name === "base" && this.options.includeBaseRules === false) {
+          continue;
+        }
         if (bundle.appliesWhen(this.project)) {
           for (const rule of bundle.rules) {
             ruleMap.set(rule.name, rule);
@@ -741,6 +1932,21 @@ var AgentConfig = class _AgentConfig extends Component3 {
         ruleMap.delete(name);
       }
     }
+    if (this.options.ruleExtensions) {
+      for (const [name, extra] of Object.entries(this.options.ruleExtensions)) {
+        const existing = ruleMap.get(name);
+        if (existing) {
+          ruleMap.set(name, {
+            ...existing,
+            content: `${existing.content}
+
+---
+
+${extra}`
+          });
+        }
+      }
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -788,264 +1994,65 @@ var AgentConfig = class _AgentConfig extends Component3 {
     }
     return [...agentMap.values()];
   }
-};
-
-// src/aws/aws-deployment-config.ts
-var import_utils = __toESM(require_lib());
-import { join, relative } from "path";
-import { Component as Component6 } from "projen";
-
-// src/turbo/turbo-repo-task.ts
-import { Component as Component4 } from "projen/lib";
-var TurboRepoTask = class extends Component4 {
-  constructor(project, options) {
-    super(project);
-    this.project = project;
-    this.name = options.name;
-    this.dependsOn = options.dependsOn ?? [];
-    this.env = options.env ?? [];
-    this.passThroughEnv = options.passThroughEnv ?? [];
-    this.outputs = options.outputs ?? [];
-    this.cache = options.cache ?? true;
-    this.inputs = [
-      ...options.inputs ?? [],
-      // rerun if projen config changes
-      ".projen/**",
-      // ignore mac files
-      "!.DS_Store",
-      "!**/.DS_Store"
-    ];
-    this.outputLogs = options.outputLogs ?? "new-only";
-    this.persistent = options.persistent ?? false;
-    this.interactive = options.interactive ?? false;
-    this.isActive = true;
-  }
-  taskConfig() {
-    return {
-      dependsOn: this.dependsOn,
-      env: this.env,
-      passThroughEnv: this.passThroughEnv,
-      outputs: this.outputs,
-      cache: this.cache,
-      inputs: this.inputs,
-      outputLogs: this.outputLogs,
-      persistent: this.persistent,
-      interactive: this.interactive
-    };
-  }
-};
-
-// src/turbo/turbo-repo.ts
-import { Component as Component5, FileBase, JsonFile as JsonFile3 } from "projen/lib";
-import { JobPermission } from "projen/lib/github/workflows-model";
-var ROOT_TURBO_TASK_NAME = "turbo:build";
-var ROOT_CI_TASK_NAME = "build:all";
-var _TurboRepo = class _TurboRepo extends Component5 {
-  constructor(project, options = {}) {
-    super(project);
-    this.project = project;
-    /**
-     * Sub-Tasks to run
-     */
-    this.tasks = [];
-    this.turboVersion = options.turboVersion ?? "catalog:";
-    this.isRootProject = project === project.root;
-    if (this.isRootProject) {
-      project.addDevDeps(`turbo@${this.turboVersion}`);
-    }
-    project.gitignore.addPatterns("/.turbo");
-    project.npmignore?.addPatterns("/.turbo/");
-    this.extends = options.extends ?? (this.isRootProject ? [] : ["//"]);
-    this.globalDependencies = options.globalDependencies ?? [];
-    this.globalEnv = options.globalEnv ?? [];
-    this.globalPassThroughEnv = options.globalPassThroughEnv ?? [];
-    this.ui = options.ui ?? "stream";
-    this.dangerouslyDisablePackageManagerCheck = options.dangerouslyDisablePackageManagerCheck ?? false;
-    this.cacheDir = options.cacheDir ?? ".turbo/cache";
-    this.daemon = options.daemon ?? true;
-    this.envMode = options.envMode ?? "strict";
-    this.remoteCacheOptions = options.remoteCacheOptions;
-    this.buildAllTaskEnvVars = options.buildAllTaskEnvVars ?? {};
-    const rootGeneratedFiles = this.isRootProject ? this.project.components.filter((c) => c instanceof FileBase).map((c) => c.path) : [];
-    this.buildTask = new TurboRepoTask(this.project, {
-      name: ROOT_TURBO_TASK_NAME,
-      dependsOn: this.isRootProject ? [`^${ROOT_TURBO_TASK_NAME}`] : [],
-      ...rootGeneratedFiles.length > 0 && { inputs: rootGeneratedFiles }
-    });
-    if (this.isRootProject) {
-      this.buildAllTask = this.project.tasks.addTask(ROOT_CI_TASK_NAME, {
-        description: "Root build followed by sub-project builds. Mimics the CI build process in one step."
-      });
-      this.buildAllTask.exec("turbo telemetry disable");
-      if (this.buildAllTaskEnvVars) {
-        Object.entries(this.buildAllTaskEnvVars).forEach(([name, value]) => {
-          this.addGlobalEnvVar(name, value);
-        });
-      }
-      if (!this.remoteCacheOptions) {
-        this.buildAllTask.exec(
-          `turbo ${ROOT_TURBO_TASK_NAME} --summarize --concurrency=10`
-        );
-      } else {
-        this.buildAllTask.exec(
-          `turbo turbo:build --summarize --concurrency=10 --cache=remote:rw --api=$TURBO_ENDPOINT --token=$TURBO_TOKEN --team=${this.remoteCacheOptions.teamName}`,
-          {
-            condition: '[ ! -n "$CI" ]',
-            env: {
-              TURBO_ENDPOINT: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.endpointParamName} --query Parameter.Value --output text --profile ${this.remoteCacheOptions.profileName})`,
-              TURBO_TOKEN: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.tokenParamName} --query Parameter.Value --output text --profile ${this.remoteCacheOptions.profileName})`
-            }
-          }
-        );
-        this.buildAllTask.exec(
-          `turbo turbo:build --summarize --concurrency=10 --cache=remote:rw --api=$TURBO_ENDPOINT --token=$TURBO_TOKEN --team=${this.remoteCacheOptions.teamName}`,
-          {
-            condition: '[ -n "$CI" ]',
-            env: {
-              TURBO_ENDPOINT: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.endpointParamName} --query Parameter.Value --output text)`,
-              TURBO_TOKEN: `$(aws ssm get-parameter --name ${this.remoteCacheOptions.tokenParamName} --query Parameter.Value --output text)`
-            }
-          }
-        );
-      }
-    }
-    if (!this.isRootProject) {
-      const generatedFiles = this.project.components.filter((c) => c instanceof FileBase).map((c) => c.path);
-      this.preCompileTask = new TurboRepoTask(project, {
-        name: options.preCompileTask?.name ?? "pre-compile",
-        inputs: ["src/**", ...generatedFiles]
-      });
-      this.compileTask = new TurboRepoTask(project, {
-        name: options.compileTask?.name ?? "compile",
-        inputs: ["src/**", ...generatedFiles]
-      });
-      this.postCompileTask = new TurboRepoTask(project, {
-        name: options.postCompileTask?.name ?? "post-compile",
-        inputs: ["src/**", ...generatedFiles]
-      });
-      this.testTask = new TurboRepoTask(project, {
-        name: options.testTask?.name ?? "test"
-      });
-      this.packageTask = new TurboRepoTask(project, {
-        name: options.packageTask?.name ?? "package",
-        inputs: [".npmignore"]
-      });
-      this.tasks.push(
-        this.preCompileTask,
-        this.compileTask,
-        this.postCompileTask,
-        this.testTask,
-        this.packageTask
-      );
-    }
-  }
-  /**
-   * Static method to discovert turbo in a project.
-   */
-  static of(project) {
-    const isDefined = (c) => c instanceof _TurboRepo;
-    return project.components.find(isDefined);
-  }
-  /**
-   * Add an env var to the global env vars for all tasks.
-   * This will also become an input for the build:all task cache at the root.
-   */
-  addGlobalEnvVar(name, value) {
-    this.buildAllTask?.env(name, value);
-    if (this.isRootProject) {
-      this.globalEnv.push(name);
-    }
-  }
-  /**
-   * Sets GIT_BRANCH_NAME so root tasks (e.g. build:all) pass the current branch.
-   * Value must be exactly $(...) so Projen's task runtime expands it; the shell
-   * then expands ${GIT_BRANCH_NAME:-$(git rev-parse --abbrev-ref HEAD)}.
-   */
-  activateBranchNameEnvVar() {
-    this.addGlobalEnvVar(
-      "GIT_BRANCH_NAME",
-      '$(echo "${GIT_BRANCH_NAME:-$(git rev-parse --abbrev-ref HEAD)}")'
-    );
-  }
-  preSynthesize() {
-    let nextDependsOn = this.project.deps.all.filter((d) => d.version === "workspace:*").map((d) => [d.name, ROOT_TURBO_TASK_NAME].join("#"));
-    if (!this.isRootProject) {
-      [
-        [this.project.preCompileTask, this.preCompileTask],
-        [this.project.compileTask, this.compileTask],
-        [this.project.postCompileTask, this.postCompileTask],
-        [this.project.testTask, this.testTask],
-        [this.project.packageTask, this.packageTask]
-      ].forEach(([pjTask, turboTask]) => {
-        if (pjTask && turboTask && pjTask.steps.length > 0) {
-          if (nextDependsOn.length > 0) {
-            turboTask.dependsOn.push(...nextDependsOn);
-          }
-          nextDependsOn = [turboTask.name];
-        } else {
-          turboTask.isActive = false;
-        }
-      });
-      this.buildTask.dependsOn.push(...nextDependsOn);
-    }
-    const fileName = "turbo.json";
-    this.project.addPackageIgnore(fileName);
-    new JsonFile3(this.project, fileName, {
-      obj: {
-        extends: this.extends.length ? this.extends : void 0,
-        globalDependencies: this.isRootProject && this.globalDependencies.length ? this.globalDependencies : void 0,
-        globalEnv: this.isRootProject && this.globalEnv.length ? this.globalEnv : void 0,
-        globalPassThroughEnv: this.isRootProject && this.globalPassThroughEnv.length ? this.globalPassThroughEnv : void 0,
-        ui: this.isRootProject ? this.ui : void 0,
-        dangerouslyDisablePackageManagerCheck: this.isRootProject ? this.dangerouslyDisablePackageManagerCheck : void 0,
-        cacheDir: this.isRootProject ? this.cacheDir : void 0,
-        daemon: this.isRootProject ? this.daemon : void 0,
-        envMode: this.isRootProject ? this.envMode : void 0,
-        /**
-         * All tasks
-         */
-        tasks: this.tasks.filter((task) => task.isActive).reduce(
-          (acc, task) => {
-            acc[task.name] = {
-              ...task.taskConfig()
-            };
-            return acc;
-          },
-          {
-            [this.buildTask.name]: { ...this.buildTask.taskConfig() }
-          }
-        )
+  /**
+   * Resolves template variables in rule content using project metadata.
+   * Emits synthesis warnings for rules with unresolved variables.
+   */
+  resolveTemplates(rules, metadata) {
+    return rules.map((rule) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        rule.content,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; rule '${rule.name}' using default values`
+        );
       }
+      return resolved !== rule.content ? { ...rule, content: resolved } : rule;
     });
-    super.preSynthesize();
   }
-};
-_TurboRepo.buildWorkflowOptions = (remoteCacheOptions) => {
-  return {
-    env: {
-      GIT_BRANCH_NAME: "${{ github.head_ref || github.ref_name }}"
-    },
-    permissions: {
-      contents: JobPermission.WRITE,
-      idToken: JobPermission.WRITE
-    },
-    preBuildSteps: [
-      {
-        name: "AWS Creds for SSM",
-        uses: "aws-actions/configure-aws-credentials@v4",
-        with: {
-          ["role-to-assume"]: remoteCacheOptions.oidcRole,
-          ["aws-region"]: "us-east-1",
-          ["role-duration-seconds"]: "900"
-        }
+  /**
+   * Resolves template variables in skill instructions using project metadata.
+   */
+  resolveSkillTemplates(skills, metadata) {
+    return skills.map((skill) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        skill.instructions,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; skill '${skill.name}' using default values`
+        );
       }
-    ]
-  };
+      return resolved !== skill.instructions ? { ...skill, instructions: resolved } : skill;
+    });
+  }
+  /**
+   * Resolves template variables in sub-agent prompts using project metadata.
+   */
+  resolveSubAgentTemplates(subAgents, metadata) {
+    return subAgents.map((agent) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        agent.prompt,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; sub-agent '${agent.name}' using default values`
+        );
+      }
+      return resolved !== agent.prompt ? { ...agent, prompt: resolved } : agent;
+    });
+  }
 };
-var TurboRepo = _TurboRepo;
 
 // src/aws/aws-deployment-config.ts
-var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
+var import_utils8 = __toESM(require_lib());
+import { join, relative as relative2 } from "path";
+import { Component as Component9 } from "projen";
+var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component9 {
   constructor(project) {
     super(project);
     /**
@@ -1069,8 +2076,8 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
     this.env = {
       GIT_BRANCH_NAME: '$(echo "${GIT_BRANCH_NAME:-$(git branch --show-current)}")'
     };
-    this.projectPath = relative(project.root.outdir, project.outdir);
-    this.rootPath = relative(project.outdir, project.root.outdir);
+    this.projectPath = relative2(project.root.outdir, project.outdir);
+    this.rootPath = relative2(project.outdir, project.root.outdir);
     this.rootCdkOut = join("dist", this.projectPath, "cdk.out");
     this.cdkOut = join(this.rootPath, "dist", this.projectPath, "cdk.out");
     ["deploy", "watch"].forEach((taskName) => {
@@ -1100,17 +2107,17 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
    */
   get prodTargets() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.PROD
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.PROD
     );
   }
   get prodTargetsForCI() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.PROD && target.ciDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.PROD && target.ciDeployment
     );
   }
   get prodTargetsForLocal() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.PROD && target.localDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.PROD && target.localDeployment
     );
   }
   /**
@@ -1119,17 +2126,17 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
    */
   get stageTargets() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.STAGE
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.STAGE
     );
   }
   get stageTargetsForCI() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.STAGE && target.ciDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.STAGE && target.ciDeployment
     );
   }
   get stageTargetsForLocal() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.STAGE && target.localDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.STAGE && target.localDeployment
     );
   }
   /**
@@ -1138,17 +2145,17 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
    */
   get devTargets() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.DEV
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.DEV
     );
   }
   get devTargetsForCI() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.DEV && target.ciDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.DEV && target.ciDeployment
     );
   }
   get devTargetsForLocal() {
     return this.awsDeploymentTargets.filter(
-      (target) => target.awsStageType === import_utils.AWS_STAGE_TYPE.DEV && target.localDeployment
+      (target) => target.awsStageType === import_utils8.AWS_STAGE_TYPE.DEV && target.localDeployment
     );
   }
   preSynthesize() {
@@ -1161,9 +2168,9 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends Component6 {
 };
 
 // src/aws/aws-deployment-target.ts
-var import_utils2 = __toESM(require_lib());
-import { Component as Component7 } from "projen";
-var AwsDeploymentTarget = class _AwsDeploymentTarget extends Component7 {
+var import_utils9 = __toESM(require_lib());
+import { Component as Component10 } from "projen";
+var AwsDeploymentTarget = class _AwsDeploymentTarget extends Component10 {
   constructor(project, options) {
     super(project);
     /**
@@ -1228,11 +2235,11 @@ var AwsDeploymentTarget = class _AwsDeploymentTarget extends Component7 {
     };
     this.account = options.account;
     this.region = options.region;
-    this.awsStageType = options.awsStageType || import_utils2.AWS_STAGE_TYPE.DEV;
-    const role = options.deploymentTargetRole ?? options.awsEnvironmentType ?? import_utils2.DEPLOYMENT_TARGET_ROLE.PRIMARY;
+    this.awsStageType = options.awsStageType || import_utils9.AWS_STAGE_TYPE.DEV;
+    const role = options.deploymentTargetRole ?? options.awsEnvironmentType ?? import_utils9.DEPLOYMENT_TARGET_ROLE.PRIMARY;
     this.deploymentTargetRole = role;
     this.awsEnvironmentType = role;
-    this.branches = options.branches ?? (this.awsStageType === import_utils2.AWS_STAGE_TYPE.PROD ? [
+    this.branches = options.branches ?? (this.awsStageType === import_utils9.AWS_STAGE_TYPE.PROD ? [
       {
         branch: "main"
       }
@@ -1241,7 +2248,7 @@ var AwsDeploymentTarget = class _AwsDeploymentTarget extends Component7 {
         branch: "feature/*"
       }
     ]);
-    this.localDeployment = options.localDeployment ?? this.awsStageType === import_utils2.AWS_STAGE_TYPE.DEV;
+    this.localDeployment = options.localDeployment ?? this.awsStageType === import_utils9.AWS_STAGE_TYPE.DEV;
     if (this.localDeployment) {
       const roleName = options.localDeploymentConfig?.roleName?.toLowerCase() || "poweruseraccess";
       const profile = options.localDeploymentConfig?.profile || `${roleName}-${this.awsStageType}-${this.account}-${this.region}`;
@@ -1376,61 +2383,14 @@ var VERSION_KEYS_SKIP = [
   // Pinned to 3.x for Vite 5 compatibility; skip until ESM-only (issue #142)
 ];
 
-// src/versions.ts
-var VERSION = {
-  /**
-   * CDK CLI for workflows and command line operations.
-   *
-   * CLI and lib are versioned separately, so this is the CLI version.
-   */
-  AWS_CDK_CLI_VERSION: "2.1117.0",
-  /**
-   * CDK Version to use for construct projects.
-   *
-   * CLI and lib are versioned separately, so this is the lib version.
-   */
-  AWS_CDK_LIB_VERSION: "2.248.0",
-  /**
-   * Version of the AWS Constructs library to use.
-   */
-  AWS_CONSTRUCTS_VERSION: "10.6.0",
-  /**
-   * Version of Node.js to use in CI workflows at github actions.
-   */
-  NODE_WORKFLOWS: "24",
-  /**
-   * Version of PNPM to use in workflows at github actions.
-   */
-  PNPM_VERSION: "10.33.0",
-  /**
-   * Version of Projen to use.
-   */
-  PROJEN_VERSION: "0.99.34",
-  /**
-   * What version of the turborepo library should we use?
-   */
-  TURBO_VERSION: "2.9.4",
-  /**
-   * What version of Vite to use (pnpm override). Pinned to 5.x so Vitest 4.x
-   * can load config (Vite 6+/7+ are ESM-only; see issue #142). Remove override
-   * when moving to ESM-only test setup.
-   */
-  VITE_VERSION: "5.4.11",
-  /**
-   * What version of Vitest to use when testRunner is 'vitest'.
-   * Pinned to 3.x so it works with Vite 5 (Vitest 4 requires Vite 6). See issue #142.
-   */
-  VITEST_VERSION: "3.2.4"
-};
-
 // src/jsii/jsii-faker.ts
 import * as spec from "@jsii/spec";
-import { Component as Component8, JsonFile as JsonFile4 } from "projen";
+import { Component as Component11, JsonFile as JsonFile4 } from "projen";
 var ProjenBaseFqn = {
   TYPESCRIPT_PROJECT: "projen.typescript.TypeScriptProject",
   TYPESCRIPT_PROJECT_OPTIONS: "projen.typescript.TypeScriptProjectOptions"
 };
-var JsiiFaker = class _JsiiFaker extends Component8 {
+var JsiiFaker = class _JsiiFaker extends Component11 {
   constructor(project) {
     super(project);
     this.project = project;
@@ -1478,86 +2438,6 @@ var JsiiFaker = class _JsiiFaker extends Component8 {
   }
 };
 
-// src/pnpm/pnpm-workspace.ts
-import { relative as relative2 } from "path";
-import { Component as Component9, YamlFile } from "projen";
-var MIMIMUM_RELEASE_AGE = {
-  ZERO_DAYS: 0,
-  ONE_HOUR: 60,
-  SIX_HOURS: 360,
-  TWELVE_HOURS: 720,
-  ONE_DAY: 1440,
-  TWO_DAYS: 2880,
-  THREE_DAYS: 4320,
-  FOUR_DAYS: 5760,
-  FIVE_DAYS: 7200,
-  SIX_DAYS: 8640,
-  ONE_WEEK: 10080
-};
-var PnpmWorkspace = class _PnpmWorkspace extends Component9 {
-  /**
-   * Get the pnpm workspace component of a project. If it does not exist,
-   * return undefined.
-   *
-   * @param project
-   * @returns
-   */
-  static of(project) {
-    const isDefined = (c) => c instanceof _PnpmWorkspace;
-    return project.root.components.find(isDefined);
-  }
-  constructor(project, options = {}) {
-    super(project);
-    project.tryFindObjectFile("package.json")?.addDeletionOverride("pnpm");
-    this.fileName = options.fileName ?? "pnpm-workspace.yaml";
-    this.minimumReleaseAge = options.minimumReleaseAge ?? MIMIMUM_RELEASE_AGE.ONE_DAY;
-    this.minimumReleaseAgeExclude = options.minimumReleaseAgeExclude ? ["@codedrifters/*", ...options.minimumReleaseAgeExclude] : ["@codedrifters/*"];
-    this.onlyBuiltDependencies = options.onlyBuiltDependencies ? options.onlyBuiltDependencies : [];
-    this.ignoredBuiltDependencies = options.ignoredBuiltDependencies ? options.ignoredBuiltDependencies : [];
-    this.subprojects = options.subprojects ?? [];
-    this.defaultCatalog = options.defaultCatalog;
-    this.namedCatalogs = options.namedCatalogs;
-    project.addPackageIgnore(this.fileName);
-    new YamlFile(this.project, this.fileName, {
-      obj: () => {
-        const pnpmConfig = {};
-        const packages = new Array();
-        for (const subproject of project.subprojects) {
-          packages.push(relative2(this.project.outdir, subproject.outdir));
-        }
-        const packageSet = new Set(packages);
-        for (const subprojectPath of this.subprojects) {
-          packageSet.add(subprojectPath);
-        }
-        if (this.subprojects.length > 0) {
-          packages.length = 0;
-          packages.push(...packageSet);
-        }
-        pnpmConfig.minimumReleaseAge = this.minimumReleaseAge;
-        if (this.minimumReleaseAgeExclude.length > 0) {
-          pnpmConfig.minimumReleaseAgeExclude = this.minimumReleaseAgeExclude;
-        }
-        if (this.onlyBuiltDependencies.length > 0) {
-          pnpmConfig.onlyBuiltDependencies = this.onlyBuiltDependencies;
-        }
-        if (this.ignoredBuiltDependencies.length > 0) {
-          pnpmConfig.ignoreBuiltDependencies = this.ignoredBuiltDependencies;
-        }
-        if (this.defaultCatalog && Object.keys(this.defaultCatalog).length > 0) {
-          pnpmConfig.catalog = this.defaultCatalog;
-        }
-        if (this.namedCatalogs && Object.keys(this.namedCatalogs).length > 0) {
-          pnpmConfig.namedCatalogs = this.namedCatalogs;
-        }
-        return {
-          ...packages.length > 0 ? { packages } : {},
-          ...pnpmConfig ? { ...pnpmConfig } : {}
-        };
-      }
-    });
-  }
-};
-
 // src/projects/monorepo-project.ts
 import {
   NodePackageManager as NodePackageManager2,
@@ -1569,7 +2449,7 @@ import {
 import { merge as merge2 } from "ts-deepmerge";
 
 // src/tasks/reset-task.ts
-import { Component as Component11 } from "projen";
+import { Component as Component12 } from "projen";
 
 // src/projects/typescript-project.ts
 import { typescript } from "projen";
@@ -1580,94 +2460,6 @@ import {
 } from "projen/lib/javascript";
 import { ReleaseTrigger } from "projen/lib/release";
 import { merge } from "ts-deepmerge";
-
-// src/vitest/vitest-component.ts
-import { Component as Component10 } from "projen";
-import { Jest } from "projen/lib/javascript";
-import { TextFile as TextFile3 } from "projen/lib/textfile";
-var Vitest = class _Vitest extends Component10 {
-  constructor(project, options = {}) {
-    super(project);
-    this.project = project;
-    this.configFilePath = options.configFilePath ?? "vitest.config.ts";
-    const config = options.config ?? {};
-    this.include = config.include ?? ["**/*.{test,spec}.?(c|m)[jt]s?(x)"];
-    this.exclude = config.exclude ?? [
-      "**/node_modules/**",
-      "**/dist/**",
-      "**/lib/**",
-      "**/.?*"
-    ];
-    this.environment = config.environment ?? "node";
-    this.passWithNoTests = config.passWithNoTests ?? true;
-    this.coverageEnabled = config.coverageEnabled ?? true;
-    this.coverageDirectory = config.coverageDirectory ?? "coverage";
-    this.coverageReporters = config.coverageReporters ?? ["text", "lcov"];
-    this.version = options.vitestVersion ?? VERSION.VITEST_VERSION;
-    project.addDevDeps(`vitest@${this.version}`);
-    if (this.coverageEnabled) {
-      project.addDevDeps(`@vitest/coverage-v8@${this.version}`);
-    }
-    const coveragePath = `/${this.coverageDirectory}/`;
-    project.gitignore.addPatterns(coveragePath);
-    project.npmignore?.exclude(coveragePath);
-    this.addTestTasks();
-    this.synthesizeConfig();
-  }
-  /**
-   * Find the Vitest component on a project.
-   */
-  static of(project) {
-    const isVitest = (c) => c instanceof _Vitest;
-    return project.components.find(isVitest);
-  }
-  preSynthesize() {
-    super.preSynthesize();
-    for (const component of this.project.components) {
-      if (component instanceof Jest) {
-        throw new Error("Vitest cannot be used together with Jest");
-      }
-    }
-  }
-  addTestTasks() {
-    this.project.testTask.exec("vitest run --update");
-    if (!this.project.tasks.tryFind("test:watch")) {
-      this.project.addTask("test:watch", {
-        description: "Run tests in watch mode",
-        exec: "vitest watch",
-        receiveArgs: true
-      });
-    }
-  }
-  synthesizeConfig() {
-    this.project.tryRemoveFile(this.configFilePath);
-    new TextFile3(this, this.configFilePath, {
-      lines: this.renderConfig()
-    });
-  }
-  renderConfig() {
-    return [
-      'import { defineConfig } from "vitest/config";',
-      "",
-      "export default defineConfig({",
-      "  test: {",
-      `    include: ${JSON.stringify(this.include)},`,
-      `    exclude: ${JSON.stringify(this.exclude)},`,
-      `    environment: "${this.environment}",`,
-      `    passWithNoTests: ${this.passWithNoTests},`,
-      "    coverage: {",
-      `      enabled: ${this.coverageEnabled},`,
-      `      provider: "v8",`,
-      `      reportsDirectory: "${this.coverageDirectory}",`,
-      `      reporter: ${JSON.stringify(this.coverageReporters)},`,
-      "    },",
-      "  },",
-      "});"
-    ];
-  }
-};
-
-// src/projects/typescript-project.ts
 var TestRunner = {
   JEST: "jest",
   VITEST: "vitest"
@@ -1832,7 +2624,7 @@ var TypeScriptProject = class extends typescript.TypeScriptProject {
 };
 
 // src/tasks/reset-task.ts
-var ResetTask = class _ResetTask extends Component11 {
+var ResetTask = class _ResetTask extends Component12 {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -1905,8 +2697,8 @@ var ResetTask = class _ResetTask extends Component11 {
 };
 
 // src/vscode/vscode.ts
-import { Component as Component12, vscode } from "projen";
-var VSCodeConfig = class extends Component12 {
+import { Component as Component13, vscode } from "projen";
+var VSCodeConfig = class extends Component13 {
   constructor(project) {
     super(project);
     const vsConfig = new vscode.VsCode(project);
@@ -2282,6 +3074,15 @@ var MonorepoProject = class extends TypeScriptAppProject {
     if (options.approveMergeUpgradeOptions) {
       addApproveMergeUpgradeWorkflow(this, options.approveMergeUpgradeOptions);
     }
+    if (options.projectMetadata !== false) {
+      new ProjectMetadata(
+        this,
+        typeof options.projectMetadata === "object" ? options.projectMetadata : {}
+      );
+    }
+    if (options.agentConfig) {
+      new AgentConfig(this, options.agentConfigOptions);
+    }
     if (this.buildWorkflow) {
       addBuildCompleteJob(this.buildWorkflow);
     }
@@ -2340,9 +3141,9 @@ var MonorepoProject = class extends TypeScriptAppProject {
 
 // src/typescript/typescript-config.ts
 import { relative as relative3 } from "path";
-import { Component as Component13 } from "projen";
+import { Component as Component14 } from "projen";
 import { ensureRelativePathStartsWithDot } from "projen/lib/util/path";
-var TypeScriptConfig = class extends Component13 {
+var TypeScriptConfig = class extends Component14 {
   constructor(project) {
     super(project);
     let tsPaths = {};
@@ -2369,13 +3170,13 @@ var TypeScriptConfig = class extends Component13 {
 };
 
 // src/workflows/aws-deploy-workflow.ts
-var import_utils3 = __toESM(require_lib());
-import { Component as Component14 } from "projen";
+var import_utils10 = __toESM(require_lib());
+import { Component as Component15 } from "projen";
 import { BuildWorkflow } from "projen/lib/build";
 import { GitHub } from "projen/lib/github";
 import { JobPermission as JobPermission4 } from "projen/lib/github/workflows-model";
 var PROD_DEPLOY_NAME = "prod-deploy";
-var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component14 {
+var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component15 {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -2386,7 +3187,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component14 {
      * @deprecated Use deployment target role terminology elsewhere. This property is maintained for backward compatibility.
      * @default 'primary' (this is the only type supported currently)
      */
-    this.awsEnvironmentType = import_utils3.DEPLOYMENT_TARGET_ROLE.PRIMARY;
+    this.awsEnvironmentType = import_utils10.DEPLOYMENT_TARGET_ROLE.PRIMARY;
     this.setupNode = () => {
       return [
         {
@@ -2496,7 +3297,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component14 {
     }
     const turbo = TurboRepo.of(this.rootProject);
     const buildWorkflowOptions = turbo?.remoteCacheOptions ? TurboRepo.buildWorkflowOptions(turbo.remoteCacheOptions) : {};
-    this.awsStageType = options.awsStageType ?? import_utils3.AWS_STAGE_TYPE.DEV;
+    this.awsStageType = options.awsStageType ?? import_utils10.AWS_STAGE_TYPE.DEV;
     this.awsDeploymentTargets = options.awsDeploymentTargets ?? AwsDeploymentConfig.of(project)?.awsDeploymentTargets.filter(
       (target) => target.awsStageType === this.awsStageType && target.ciDeployment
     ) ?? [];
@@ -2656,6 +3457,7 @@ export {
   MonorepoProject,
   PROD_DEPLOY_NAME,
   PnpmWorkspace,
+  ProjectMetadata,
   ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME,
   ResetTask,
@@ -2671,6 +3473,15 @@ export {
   Vitest,
   addApproveMergeUpgradeWorkflow,
   addBuildCompleteJob,
-  getLatestEligibleVersion
+  awsCdkBundle,
+  baseBundle,
+  getLatestEligibleVersion,
+  jestBundle,
+  pnpmBundle,
+  projenBundle,
+  resolveTemplateVariables,
+  turborepoBundle,
+  typescriptBundle,
+  vitestBundle
 };
 //# sourceMappingURL=index.mjs.map