@codedrifters/configulator 0.0.177 → 0.0.179

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

@@ -388,6 +388,19 @@ interface AgentRuleBundle {
      * @example (project) => Vitest.of(project) !== undefined
      */
     readonly appliesWhen: (project: Project) => boolean;
+    /**
+     * Optional. When set, returns the list of projects (root and/or
+     * subprojects) that matched this bundle's detection predicate. Enables
+     * AgentConfig to narrow each rule's `filePatterns` to the outdirs of
+     * those projects instead of the bundle's original repo-wide patterns.
+     *
+     * Bundles that provide `FILE_PATTERN`-scoped rules about TypeScript or
+     * TypeScript-adjacent code (e.g. typescript, aws-cdk, vitest, jest) should
+     * implement this so their rules only activate for files in the packages
+     * that actually use them.
+     * @example (project) => findProjectsWithFile(project, 'tsconfig.json')
+     */
+    readonly findApplicableProjects?: (project: Project) => ReadonlyArray<Project>;
     /** Rules included in this bundle. */
     readonly rules: ReadonlyArray<AgentRule>;
     /** Skills included in this bundle (cross-platform where supported). */
@@ -836,6 +849,13 @@ declare class AgentConfig extends Component {
     preSynthesize(): void;
     private resolvePlatforms;
     private resolveRules;
+    /**
+     * Return a bundle's rules with `filePatterns` narrowed to the projects
+     * that actually matched the bundle's detection predicate (when the bundle
+     * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
+     * on bundles that don't implement the hook are returned unchanged.
+     */
+    private bundleRulesFor;
     private resolveSkills;
     private resolveSubAgents;
     /**
@@ -2561,8 +2581,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 +2740,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

@@ -437,6 +437,19 @@ interface AgentRuleBundle {
      * @example (project) => Vitest.of(project) !== undefined
      */
     readonly appliesWhen: (project: Project$1) => boolean;
+    /**
+     * Optional. When set, returns the list of projects (root and/or
+     * subprojects) that matched this bundle's detection predicate. Enables
+     * AgentConfig to narrow each rule's `filePatterns` to the outdirs of
+     * those projects instead of the bundle's original repo-wide patterns.
+     *
+     * Bundles that provide `FILE_PATTERN`-scoped rules about TypeScript or
+     * TypeScript-adjacent code (e.g. typescript, aws-cdk, vitest, jest) should
+     * implement this so their rules only activate for files in the packages
+     * that actually use them.
+     * @example (project) => findProjectsWithFile(project, 'tsconfig.json')
+     */
+    readonly findApplicableProjects?: (project: Project$1) => ReadonlyArray<Project$1>;
     /** Rules included in this bundle. */
     readonly rules: ReadonlyArray<AgentRule>;
     /** Skills included in this bundle (cross-platform where supported). */
@@ -885,6 +898,13 @@ declare class AgentConfig extends Component {
     preSynthesize(): void;
     private resolvePlatforms;
     private resolveRules;
+    /**
+     * Return a bundle's rules with `filePatterns` narrowed to the projects
+     * that actually matched the bundle's detection predicate (when the bundle
+     * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
+     * on bundles that don't implement the hook are returned unchanged.
+     */
+    private bundleRulesFor;
     private resolveSkills;
     private resolveSubAgents;
     /**
@@ -2610,8 +2630,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 +2789,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

@@ -256,23 +256,50 @@ var MCP_TRANSPORT = {
 };
 
 // src/agent/bundles/utils.ts
+function findProjectsWithComponent(project, ctor) {
+  const out = [];
+  if (project.components.some((c) => c instanceof ctor)) {
+    out.push(project);
+  }
+  for (const sub of project.subprojects) {
+    if (sub.components.some((c) => c instanceof ctor)) {
+      out.push(sub);
+    }
+  }
+  return out;
+}
+function findProjectsWithDep(project, name) {
+  const out = [];
+  if (project.deps.all.some((d) => d.name === name)) {
+    out.push(project);
+  }
+  for (const sub of project.subprojects) {
+    if (sub.deps.all.some((d) => d.name === name)) {
+      out.push(sub);
+    }
+  }
+  return out;
+}
+function findProjectsWithFile(project, filename) {
+  const out = [];
+  if (project.tryFindFile(filename) !== void 0) {
+    out.push(project);
+  }
+  for (const sub of project.subprojects) {
+    if (sub.tryFindFile(filename) !== void 0) {
+      out.push(sub);
+    }
+  }
+  return out;
+}
 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)
-  );
+  return findProjectsWithComponent(project, ctor).length > 0;
 }
 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)
-  );
+  return findProjectsWithDep(project, name).length > 0;
 }
 function hasFile(project, filename) {
-  if (project.tryFindFile(filename) !== void 0) return true;
-  return project.subprojects.some(
-    (sub) => sub.tryFindFile(filename) !== void 0
-  );
+  return findProjectsWithFile(project, filename).length > 0;
 }
 
 // src/agent/bundles/aws-cdk.ts
@@ -280,6 +307,7 @@ var awsCdkBundle = {
   name: "aws-cdk",
   description: "AWS CDK construct patterns, L2/L3 conventions, IAM best practices",
   appliesWhen: (project) => hasDep(project, "aws-cdk-lib"),
+  findApplicableProjects: (project) => findProjectsWithDep(project, "aws-cdk-lib"),
   rules: [
     {
       name: "aws-cdk-conventions",
@@ -911,6 +939,7 @@ var jestBundle = {
   name: "jest",
   description: "Jest testing conventions and patterns",
   appliesWhen: (project) => hasDep(project, "jest"),
+  findApplicableProjects: (project) => findProjectsWithDep(project, "jest"),
   rules: [
     {
       name: "jest-testing",
@@ -1697,6 +1726,7 @@ var typescriptBundle = {
   name: "typescript",
   description: "TypeScript conventions, type safety, naming, JSDoc, member ordering",
   appliesWhen: (project) => hasFile(project, "tsconfig.json"),
+  findApplicableProjects: (project) => findProjectsWithFile(project, "tsconfig.json"),
   rules: [
     {
       name: "typescript-conventions",
@@ -1914,6 +1944,7 @@ var vitestBundle = {
   name: "vitest",
   description: "Vitest testing conventions, patterns, and file scoping",
   appliesWhen: (project) => hasComponent(project, Vitest),
+  findApplicableProjects: (project) => findProjectsWithComponent(project, Vitest),
   rules: [
     {
       name: "vitest-testing",
@@ -1983,6 +2014,38 @@ var BUILT_IN_BUNDLES = [
   slackBundle
 ];
 
+// src/agent/bundles/scope.ts
+var path = __toESM(require("path"));
+function scopeFilePatternsToProjects(root, detected) {
+  const patterns = /* @__PURE__ */ new Set();
+  for (const project of detected) {
+    const rel = path.relative(root.outdir, project.outdir);
+    const include = readTsconfigInclude(project);
+    if (include && include.length > 0) {
+      for (const entry of include) {
+        patterns.add(prefix(rel, entry));
+      }
+    } else {
+      const srcdir = project.srcdir ?? "src";
+      patterns.add(prefix(rel, path.posix.join(srcdir, "**/*.ts")));
+    }
+  }
+  return [...patterns].sort();
+}
+function readTsconfigInclude(project) {
+  const tsconfig = project.tsconfig;
+  if (!tsconfig) {
+    return void 0;
+  }
+  return tsconfig.include;
+}
+function prefix(rel, entry) {
+  if (!rel) {
+    return entry;
+  }
+  return path.posix.join(rel, entry);
+}
+
 // src/projects/project-metadata.ts
 var import_projen5 = require("projen");
 var import_javascript2 = require("projen/lib/javascript");
@@ -2001,12 +2064,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);
@@ -2555,8 +2628,8 @@ var FALLBACKS = {
   docsPath: "<docs-path>"
 };
 var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
-function getNestedValue(obj, path) {
-  const parts = path.split(".");
+function getNestedValue(obj, path2) {
+  const parts = path2.split(".");
   let current = obj;
   for (const part of parts) {
     if (current == null || typeof current !== "object") {
@@ -2797,7 +2870,7 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
           continue;
         }
         if (bundle.appliesWhen(this.project)) {
-          for (const rule of bundle.rules) {
+          for (const rule of this.bundleRulesFor(bundle)) {
             ruleMap.set(rule.name, rule);
           }
         }
@@ -2807,7 +2880,7 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
       for (const bundleName of this.options.includeBundles) {
         const bundle = BUILT_IN_BUNDLES.find((b) => b.name === bundleName);
         if (bundle) {
-          for (const rule of bundle.rules) {
+          for (const rule of this.bundleRulesFor(bundle)) {
             ruleMap.set(rule.name, rule);
           }
         }
@@ -2847,6 +2920,25 @@ ${extra}`
       return a.name.localeCompare(b.name);
     });
   }
+  /**
+   * Return a bundle's rules with `filePatterns` narrowed to the projects
+   * that actually matched the bundle's detection predicate (when the bundle
+   * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
+   * on bundles that don't implement the hook are returned unchanged.
+   */
+  bundleRulesFor(bundle) {
+    if (!bundle.findApplicableProjects) {
+      return bundle.rules;
+    }
+    const detected = bundle.findApplicableProjects(this.project);
+    if (detected.length === 0) {
+      return bundle.rules;
+    }
+    const scoped = scopeFilePatternsToProjects(this.project, detected);
+    return bundle.rules.map(
+      (rule) => rule.scope === AGENT_RULE_SCOPE.FILE_PATTERN ? { ...rule, filePatterns: scoped } : rule
+    );
+  }
   resolveSkills() {
     const skillMap = /* @__PURE__ */ new Map();
     if (this.options.autoDetectBundles !== false) {
@@ -3502,15 +3594,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 = {
@@ -3564,8 +3652,8 @@ var ResetTask = class _ResetTask extends import_projen13.Component {
     const resetTask = this.project.tasks.addTask(this.taskName, {
       description: "Delete build artifacts specified by pathsToRemove option, or artifactsDirectory if pathsToRemove is empty"
     });
-    this.pathsToRemove.forEach((path) => {
-      resetTask.exec(`[ -e "${path}" ] && rm -rf ${path} || true`);
+    this.pathsToRemove.forEach((path2) => {
+      resetTask.exec(`[ -e "${path2}" ] && rm -rf ${path2} || true`);
     });
     const rootHasTurbo = TurboRepo.of(this.project.root) !== void 0;
     const isSubproject = this.project !== this.project.root;
@@ -3880,7 +3968,11 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
        */
       disableTsconfigDev: true,
       /**
-       * Kill the srcdir in the root since we aren't using one.
+       * Kill the srcdir in the root since we aren't using one. Projen's
+       * default `tsconfig.include` still points at `src/**\/*.ts`, so
+       * callers that want to treat the monorepo root as a pure shell
+       * should see an empty include — consumers add their own entries via
+       * `tsconfig.addInclude(...)` (e.g. `.projenrc.ts`, `projenrc/**\/*.ts`).
        */
       tsconfig: {
         compilerOptions: {
@@ -3954,6 +4046,7 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
     );
     super({ ...options });
     postInstallDependenciesMap.set(this, []);
+    this.tsconfig?.removeInclude(`${this.srcdir}/**/*.ts`);
     this.pnpmVersion = options.pnpmVersion;
     this.configulatorRegistryConsumer = options.configulatorRegistryConsumer ?? true;
     new VSCodeConfig(this);
@@ -4163,9 +4256,9 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen16.Compone
       for (const branch of branches) {
         const branchPattern = branch.branch;
         if (branchPattern.includes("*")) {
-          const prefix = branchPattern.replace(/\*.*$/, "");
-          conditions.push(`startsWith(github.ref, 'refs/heads/${prefix}')`);
-          conditions.push(`startsWith(github.head_ref, '${prefix}')`);
+          const prefix2 = branchPattern.replace(/\*.*$/, "");
+          conditions.push(`startsWith(github.ref, 'refs/heads/${prefix2}')`);
+          conditions.push(`startsWith(github.head_ref, '${prefix2}')`);
         } else {
           conditions.push(`github.ref == 'refs/heads/${branchPattern}'`);
         }