@codedrifters/configulator 0.0.177 → 0.0.178

package/README.md

@@ -1255,44 +1255,42 @@ const project = new MonorepoProject({
 });
 ```
 
-**Monorepo with per-package overrides:**
+**Monorepo with per-package opt-in:**
+
+`AgentConfig` is **not** auto-inherited by sub-projects. Agent rule files are
+rendered only on projects that explicitly opt in, so the monorepo root's
+`AgentConfig` does not duplicate `.cursor/`, `.claude/`, or `CLAUDE.md` into
+each sub-project's `outdir`. Sub-projects that opt in do still resolve
+`ProjectMetadata` from the root, so template tokens like
+`{{repository.owner}}` work without redeclaring metadata.
 
 ```typescript
 const root = new MonorepoProject({
   name: "my-monorepo",
   agentConfig: {
-    // Root-level config applies to all sub-projects
+    // Root-level config — renders into the monorepo root only
     rules: [{ name: "monorepo-rule", description: "...", scope: AGENT_RULE_SCOPE.ALWAYS, content: "..." }],
   },
 });
 
-// Sub-project inherits parent config by default
+// Sub-project with no agent config — nothing rendered into packages/api/
 const api = new TypeScriptProject({
   parent: root,
   name: "@my-org/api",
   outdir: "packages/api",
-  // Inherits agentConfig from root
 });
 
-// Sub-project with explicit overrides
+// Sub-project that explicitly opts into its own agent config
 const frontend = new TypeScriptProject({
   parent: root,
   name: "@my-org/frontend",
   outdir: "packages/frontend",
   agentConfig: {
-    // Override: only generate Claude config for this package
+    // Only generate Claude config for this package
     platforms: [AGENT_PLATFORM.CLAUDE],
     excludeBundles: ["jest"], // This package uses Vitest, not Jest
   },
 });
-
-// Sub-project with agent config disabled
-const scripts = new TypeScriptProject({
-  parent: root,
-  name: "@my-org/scripts",
-  outdir: "packages/scripts",
-  agentConfig: false, // No agent config for this package
-});
 ```
 
 ## Troubleshooting

package/lib/index.d.mts

@@ -2561,8 +2561,10 @@ declare class MonorepoProject extends TypeScriptAppProject {
  */
 declare class ProjectMetadata extends Component {
     /**
-     * Returns the ProjectMetadata instance for a project, or undefined
-     * if the component has not been added.
+     * Returns the ProjectMetadata instance for a project. Walks up the parent
+     * chain so sub-projects resolve the metadata declared on a root
+     * `MonorepoProject` without needing a duplicate declaration of their own.
+     * Returns `undefined` if no ancestor has a `ProjectMetadata` component.
      */
     static of(project: Project$1): ProjectMetadata | undefined;
     /** Resolved metadata with auto-detected values filled in. */
@@ -2718,8 +2720,10 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * - `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.
+     * Sub-projects do not inherit `AgentConfig` from their parent
+     * `MonorepoProject`. Agent rule files are rendered only on projects that
+     * explicitly opt in, so a monorepo's root `AgentConfig` does not duplicate
+     * `.cursor/`, `.claude/`, or `CLAUDE.md` into each sub-project's `outdir`.
      *
      * @default false
      */

package/lib/index.d.ts

@@ -2610,8 +2610,10 @@ declare class MonorepoProject extends TypeScriptAppProject {
  */
 declare class ProjectMetadata extends Component {
     /**
-     * Returns the ProjectMetadata instance for a project, or undefined
-     * if the component has not been added.
+     * Returns the ProjectMetadata instance for a project. Walks up the parent
+     * chain so sub-projects resolve the metadata declared on a root
+     * `MonorepoProject` without needing a duplicate declaration of their own.
+     * Returns `undefined` if no ancestor has a `ProjectMetadata` component.
      */
     static of(project: Project): ProjectMetadata | undefined;
     /** Resolved metadata with auto-detected values filled in. */
@@ -2767,8 +2769,10 @@ interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOpti
      * - `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.
+     * Sub-projects do not inherit `AgentConfig` from their parent
+     * `MonorepoProject`. Agent rule files are rendered only on projects that
+     * explicitly opt in, so a monorepo's root `AgentConfig` does not duplicate
+     * `.cursor/`, `.claude/`, or `CLAUDE.md` into each sub-project's `outdir`.
      *
      * @default false
      */

package/lib/index.js

@@ -2001,12 +2001,22 @@ function parseGitHubUrl(url) {
 }
 var ProjectMetadata = class _ProjectMetadata extends import_projen5.Component {
   /**
-   * Returns the ProjectMetadata instance for a project, or undefined
-   * if the component has not been added.
+   * Returns the ProjectMetadata instance for a project. Walks up the parent
+   * chain so sub-projects resolve the metadata declared on a root
+   * `MonorepoProject` without needing a duplicate declaration of their own.
+   * Returns `undefined` if no ancestor has a `ProjectMetadata` component.
    */
   static of(project) {
     const isProjectMetadata = (c) => c instanceof _ProjectMetadata;
-    return project.components.find(isProjectMetadata);
+    let current = project;
+    while (current) {
+      const found = current.components.find(isProjectMetadata);
+      if (found) {
+        return found;
+      }
+      current = current.parent;
+    }
+    return void 0;
   }
   constructor(project, options = {}) {
     super(project);
@@ -3502,15 +3512,11 @@ var TypeScriptProject = class extends import_projen12.typescript.TypeScriptProje
       turbo.compileTask?.outputs.push("dist/**");
       turbo.compileTask?.outputs.push("lib/**");
     }
-    const parentHasAgentConfig = userOptions.parent instanceof MonorepoProject && AgentConfig.of(userOptions.parent) !== void 0;
-    if (options.agentConfig !== false) {
-      const shouldEnable = typeof options.agentConfig === "object" || options.agentConfig === true || parentHasAgentConfig;
-      if (shouldEnable) {
-        new AgentConfig(
-          this,
-          typeof options.agentConfig === "object" ? options.agentConfig : {}
-        );
-      }
+    if (options.agentConfig === true || typeof options.agentConfig === "object") {
+      new AgentConfig(
+        this,
+        typeof options.agentConfig === "object" ? options.agentConfig : {}
+      );
     }
     if (options.resetTask !== false) {
       const defaultResetTaskOptions = {