@codedrifters/configulator 0.0.178 → 0.0.179

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;
     /**

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;
     /**

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");
@@ -2565,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") {
@@ -2807,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);
           }
         }
@@ -2817,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);
           }
         }
@@ -2857,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) {
@@ -3570,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;
@@ -3886,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: {
@@ -3960,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);
@@ -4169,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}'`);
         }