@codedrifters/configulator 0.0.294 → 0.0.296

package/lib/index.js

@@ -195,6 +195,7 @@ __export(index_exports, {
   AwsDeploymentTarget: () => AwsDeploymentTarget,
   AwsTeardownWorkflow: () => AwsTeardownWorkflow,
   BUILT_IN_BUNDLES: () => BUILT_IN_BUNDLES,
+  BUNDLE_OWNERSHIP: () => BUNDLE_OWNERSHIP,
   CLAUDE_RULE_TARGET: () => CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID: () => COMPLETE_JOB_ID,
   DEFAULT_AC_THRESHOLDS: () => DEFAULT_AC_THRESHOLDS,
@@ -338,7 +339,12 @@ __export(index_exports, {
   formatStarlightSingletonViolation: () => formatStarlightSingletonViolation,
   getLatestEligibleVersion: () => getLatestEligibleVersion,
   githubWorkflowBundle: () => githubWorkflowBundle,
+  hasAnyDocsEmittingBundle: () => hasAnyDocsEmittingBundle,
+  hasAnyDownstreamIssueKindBundle: () => hasAnyDownstreamIssueKindBundle,
   industryDiscoveryBundle: () => industryDiscoveryBundle,
+  isPhaseLabelOwnedByExcluded: () => isPhaseLabelOwnedByExcluded,
+  isScheduledTaskOwnedByExcluded: () => isScheduledTaskOwnedByExcluded,
+  isTypeLabelOwnedByExcluded: () => isTypeLabelOwnedByExcluded,
   jestBundle: () => jestBundle,
   labelsForPhase: () => labelsForPhase,
   maintenanceAuditBundle: () => maintenanceAuditBundle,
@@ -1404,8 +1410,8 @@ function resolveIssueTemplates(config) {
 function validateIssueTemplatesConfig(config) {
   return resolveIssueTemplates(config);
 }
-function renderIssueTemplatesRuleContent(it) {
-  if (!it.enabled) {
+function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
+  if (!it.enabled || !hasDownstreamBundles) {
     return [
       "# Issue Templates",
       "",
@@ -11555,6 +11561,238 @@ function assertValidStateFilePath(stateFilePath) {
   }
 }
 
+// src/agent/bundles/bundle-ownership.ts
+var BUNDLE_OWNERSHIP = {
+  agenda: {
+    typeLabels: ["agenda"],
+    phaseLabelPrefixes: ["agenda:"],
+    scheduledTaskIds: ["worker-agenda"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "bcm-writer": {
+    typeLabels: ["bcm-document"],
+    phaseLabelPrefixes: ["bcm:"],
+    scheduledTaskIds: ["worker-bcm-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "business-models": {
+    typeLabels: ["business-model"],
+    phaseLabelPrefixes: ["business-models:"],
+    scheduledTaskIds: ["worker-business-models"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "company-profile": {
+    typeLabels: ["company-profile"],
+    phaseLabelPrefixes: ["company:"],
+    scheduledTaskIds: ["worker-company-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "customer-profile": {
+    typeLabels: ["customer-profile"],
+    phaseLabelPrefixes: ["customer:"],
+    scheduledTaskIds: ["worker-customer-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "docs-sync": {
+    typeLabels: ["docs-sync"],
+    phaseLabelPrefixes: ["docs-sync:"],
+    scheduledTaskIds: ["worker-docs-sync"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "industry-discovery": {
+    typeLabels: ["industry-discovery"],
+    phaseLabelPrefixes: ["industry:"],
+    scheduledTaskIds: ["worker-industry-discovery"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "maintenance-audit": {
+    typeLabels: ["maintenance"],
+    phaseLabelPrefixes: ["maint:"],
+    scheduledTaskIds: ["worker-maintenance"],
+    emitsDocs: false,
+    downstreamIssueKinds: true
+  },
+  "meeting-analysis": {
+    typeLabels: ["meeting-processing"],
+    phaseLabelPrefixes: ["meeting:"],
+    scheduledTaskIds: ["worker-meeting-analysis"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  orchestrator: {
+    // The orchestrator pipeline manager itself ships with the
+    // `worker-orchestrator` scheduled task. It owns no `type:*` label
+    // (it dispatches every type) and no phase-label prefix.
+    typeLabels: [],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-orchestrator"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "people-profile": {
+    typeLabels: ["people-profile"],
+    phaseLabelPrefixes: ["people:"],
+    scheduledTaskIds: ["worker-people-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "pr-review": {
+    typeLabels: ["pr-review"],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-pr-review"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "regulatory-research": {
+    typeLabels: ["regulatory-research"],
+    phaseLabelPrefixes: ["regulatory:"],
+    scheduledTaskIds: ["worker-regulatory-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-analyst": {
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:"],
+    scheduledTaskIds: ["worker-requirements-analyst"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-reviewer": {
+    // Co-owns `type:requirement` with the analyst and writer; owns
+    // the `req:review` and `req:deprecate` phase labels exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:review", "req:deprecate"],
+    scheduledTaskIds: ["worker-requirements-reviewer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-writer": {
+    // Co-owns `type:requirement` with the analyst and reviewer; owns
+    // the `req:write` phase label exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:write"],
+    scheduledTaskIds: ["worker-requirements-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "research-pipeline": {
+    typeLabels: ["research"],
+    phaseLabelPrefixes: ["research:"],
+    scheduledTaskIds: ["worker-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "software-profile": {
+    typeLabels: ["software-profile"],
+    phaseLabelPrefixes: ["software:"],
+    scheduledTaskIds: ["worker-software-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "standards-research": {
+    typeLabels: ["standards-research"],
+    phaseLabelPrefixes: ["standards:"],
+    scheduledTaskIds: ["worker-standards-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  }
+};
+function isTypeLabelOwnedByExcluded(typeLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.typeLabels.includes(typeLabel)) {
+      const owners = findOwnersOfTypeLabel(typeLabel);
+      const allExcluded = owners.every(
+        (owner) => excludedBundles.includes(owner)
+      );
+      if (allExcluded) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isPhaseLabelOwnedByExcluded(phaseLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    for (const entry of ownership.phaseLabelPrefixes) {
+      if (entry.endsWith(":")) {
+        if (phaseLabel.startsWith(entry)) {
+          return true;
+        }
+      } else if (phaseLabel === entry) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isScheduledTaskOwnedByExcluded(taskId, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.scheduledTaskIds.includes(taskId)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDocsEmittingBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.emitsDocs) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDownstreamIssueKindBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.downstreamIssueKinds) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function findOwnersOfTypeLabel(typeLabel) {
+  const owners = [];
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (ownership.typeLabels.includes(typeLabel)) {
+      owners.push(bundleName);
+    }
+  }
+  return owners;
+}
+
 // src/agent/bundles/scheduled-tasks.ts
 var SCHEDULED_TASK_MODEL_VALUES = ["opus", "sonnet", "haiku"];
 var SCHEDULED_TASK_KIND_VALUES = ["issue-worker", "pipeline"];
@@ -11819,17 +12057,23 @@ var DEFAULT_SCHEDULED_TASK_ENTRIES = [
     description: "Documentation-sync drift-detection and audit pipeline (scaffolding release \u2014 behavior carried by downstream child issues of the parent docs-sync epic)."
   }
 ];
-function resolveScheduledTasks(config) {
+function resolveScheduledTasks(config, excludeBundles = []) {
   const root = config?.root ?? DEFAULT_SCHEDULED_TASKS_ROOT;
   assertValidRoot(root);
   const merged = /* @__PURE__ */ new Map();
   for (const entry of DEFAULT_SCHEDULED_TASK_ENTRIES) {
+    if (isScheduledTaskOwnedByExcluded(entry.taskId, excludeBundles)) {
+      continue;
+    }
     merged.set(entry.taskId, entry);
   }
   if (config?.overrides) {
     for (const [taskId, override] of Object.entries(config.overrides)) {
       const existing = merged.get(taskId);
       if (!existing) {
+        if (isScheduledTaskOwnedByExcluded(taskId, excludeBundles)) {
+          continue;
+        }
         throw new Error(
           `ScheduledTasksConfig.overrides references unknown taskId ${JSON.stringify(
             taskId
@@ -11860,8 +12104,8 @@ function resolveScheduledTasks(config) {
     tasks: [...merged.values()]
   };
 }
-function validateScheduledTasksConfig(config) {
-  return resolveScheduledTasks(config);
+function validateScheduledTasksConfig(config, excludeBundles = []) {
+  return resolveScheduledTasks(config, excludeBundles);
 }
 function renderScheduledTasksSection(resolved) {
   const lines = [
@@ -12344,7 +12588,7 @@ function classifyIssueScope(body, gate, labels = []) {
     matchedLabel: effective.matchedLabel
   };
 }
-function renderScopeGateSection(gate) {
+function renderScopeGateSection(gate, excludeBundles = []) {
   const { acceptanceCriteria: ac, sources } = gate;
   const lines = [
     "## Scope gate",
@@ -12418,7 +12662,9 @@ function renderScopeGateSection(gate) {
       "   is in place."
     );
   }
-  const overrideEntries = Object.entries(gate.bundleOverrides);
+  const overrideEntries = Object.entries(gate.bundleOverrides).filter(
+    ([label]) => !isPhaseLabelOwnedByExcluded(label, excludeBundles)
+  );
   if (overrideEntries.length > 0) {
     lines.push(
       "",
@@ -12762,9 +13008,12 @@ function validateAgentTierConfig(config) {
   }
   return resolveAgentTiers(config);
 }
-function renderAgentTierSection(tiers) {
+function renderAgentTierSection(tiers, excludeBundles = []) {
+  const filtered = tiers.filter(
+    (entry) => !isTypeLabelOwnedByExcluded(entry.type, excludeBundles)
+  );
   const grouped = /* @__PURE__ */ new Map();
-  for (const entry of tiers) {
+  for (const entry of filtered) {
     const bucket = grouped.get(entry.tier) ?? [];
     bucket.push(entry);
     grouped.set(entry.tier, bucket);
@@ -14495,13 +14744,13 @@ var ORCHESTRATOR_CONVENTIONS_PREAMBLE = [
   "",
   'Practical implication for scheduled-task wiring: the `worker-orchestrator` scheduled task\'s `SKILL.md` instructs the **scheduled-task session itself** to read `.claude/agents/orchestrator.md` and execute its phase pipeline in-session, then use the `Agent` tool to delegate the picked work item to `issue-worker` (depth-1). The scheduled task does **not** call `Agent(subagent_type: "orchestrator")` \u2014 that would put the orchestrator at depth-1 and break the chain.'
 ].join("\n");
-function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio(), scheduledTasks = resolveScheduledTasks(), unblockDependents = resolveUnblockDependents()) {
+function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio(), scheduledTasks = resolveScheduledTasks(), unblockDependents = resolveUnblockDependents(), excludeBundles = []) {
   return [
     ORCHESTRATOR_CONVENTIONS_PREAMBLE,
     "",
-    renderAgentTierSection(tiers),
+    renderAgentTierSection(tiers, excludeBundles),
     "",
-    renderScopeGateSection(scopeGate),
+    renderScopeGateSection(scopeGate, excludeBundles),
     "",
     renderRunRatioSection(runRatio),
     "",
@@ -14510,11 +14759,14 @@ function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate
     renderUnblockDependentsSection(unblockDependents)
   ].join("\n");
 }
-function resolveOrchestratorAssets(tierConfig, scopeGateConfig, runRatioConfig, scheduledTasksConfig, unblockDependentsConfig) {
+function resolveOrchestratorAssets(tierConfig, scopeGateConfig, runRatioConfig, scheduledTasksConfig, unblockDependentsConfig, excludeBundles = []) {
   const tiers = resolveAgentTiers(tierConfig);
   const scopeGate = resolveScopeGate(scopeGateConfig);
   const runRatio = resolveRunRatio(runRatioConfig);
-  const scheduledTasks = resolveScheduledTasks(scheduledTasksConfig);
+  const scheduledTasks = resolveScheduledTasks(
+    scheduledTasksConfig,
+    excludeBundles
+  );
   const unblockDependentsResolved = resolveUnblockDependents(
     unblockDependentsConfig
   );
@@ -14529,7 +14781,8 @@ function resolveOrchestratorAssets(tierConfig, scopeGateConfig, runRatioConfig,
       scopeGate,
       runRatio,
       scheduledTasks,
-      unblockDependentsResolved
+      unblockDependentsResolved,
+      excludeBundles
     ),
     procedure: buildCheckBlockedProcedure(tiers, scopeGate, runRatio),
     unblockDependentsProcedure: buildUnblockDependentsProcedure(
@@ -26805,7 +27058,7 @@ var VERSION = {
   /**
    * Version of Astro to pin for AstroProject scaffolding.
    */
-  ASTRO_VERSION: "6.2.1",
+  ASTRO_VERSION: "6.2.2",
   /**
    * CDK CLI for workflows and command line operations.
    *
@@ -26834,7 +27087,7 @@ var VERSION = {
   /**
    * Version of PNPM to use in workflows at github actions.
    */
-  PNPM_VERSION: "10.33.2",
+  PNPM_VERSION: "10.33.3",
   /**
    * Version of Projen to use.
    */
@@ -26852,11 +27105,11 @@ var VERSION = {
   /**
    * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
    */
-  STARLIGHT_VERSION: "0.38.4",
+  STARLIGHT_VERSION: "0.38.5",
   /**
    * What version of the turborepo library should we use?
    */
-  TURBO_VERSION: "2.9.8",
+  TURBO_VERSION: "2.9.9",
   /**
    * Version of @types/node to use across all packages (pnpm catalog).
    */
@@ -28304,7 +28557,8 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
       this.project.gitignore.addPatterns(`/${resolvedProgressFiles.stateDir}/`);
     }
     const resolvedScheduledTasks = validateScheduledTasksConfig(
-      this.options.scheduledTasks
+      this.options.scheduledTasks,
+      this.options.excludeBundles ?? []
     );
     if (resolvedScheduledTasks.enabled) {
       for (const task of resolvedScheduledTasks.tasks) {
@@ -28512,7 +28766,8 @@ ${section}`
         }
       }
     }
-    if (this.options.tiers || this.options.scopeGate || this.options.runRatio || this.options.scheduledTasks || this.options.unblockDependents) {
+    const excludedBundleNames = this.options.excludeBundles ?? [];
+    if (this.options.tiers || this.options.scopeGate || this.options.runRatio || this.options.scheduledTasks || this.options.unblockDependents || excludedBundleNames.length > 0) {
       const orchestratorRule = ruleMap.get("orchestrator-conventions");
       if (orchestratorRule) {
         const { conventionsContent } = resolveOrchestratorAssets(
@@ -28520,7 +28775,8 @@ ${section}`
           this.options.scopeGate,
           this.options.runRatio,
           this.options.scheduledTasks,
-          this.options.unblockDependents
+          this.options.unblockDependents,
+          excludedBundleNames
         );
         if (conventionsContent !== orchestratorRule.content) {
           ruleMap.set("orchestrator-conventions", {
@@ -28653,11 +28909,13 @@ ${hook}`
     const resolvedIssueTemplatesForRules = resolveIssueTemplates(
       this.options.issueTemplates
     );
-    if (this.options.issueTemplates) {
+    const hasDownstreamBundles = hasAnyDownstreamIssueKindBundle(excludedBundleNames);
+    if (this.options.issueTemplates || !hasDownstreamBundles) {
       const issueTemplatesRule = ruleMap.get("issue-templates-convention");
       if (issueTemplatesRule) {
         const issueTemplatesContent = renderIssueTemplatesRuleContent(
-          resolvedIssueTemplatesForRules
+          resolvedIssueTemplatesForRules,
+          hasDownstreamBundles
         );
         if (issueTemplatesContent !== issueTemplatesRule.content) {
           ruleMap.set("issue-templates-convention", {
@@ -28667,7 +28925,10 @@ ${hook}`
         }
       }
     }
-    if (resolvedIssueTemplatesForRules.enabled) {
+    if (!hasAnyDocsEmittingBundle(excludedBundleNames)) {
+      ruleMap.delete("stub-index-convention");
+    }
+    if (resolvedIssueTemplatesForRules.enabled && hasDownstreamBundles) {
       for (const [ruleName, label] of ISSUE_TEMPLATES_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
         if (!existing) {
@@ -33157,6 +33418,7 @@ var TypeScriptConfig = class extends import_projen23.Component {
   AwsDeploymentTarget,
   AwsTeardownWorkflow,
   BUILT_IN_BUNDLES,
+  BUNDLE_OWNERSHIP,
   CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID,
   DEFAULT_AC_THRESHOLDS,
@@ -33300,7 +33562,12 @@ var TypeScriptConfig = class extends import_projen23.Component {
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,
   githubWorkflowBundle,
+  hasAnyDocsEmittingBundle,
+  hasAnyDownstreamIssueKindBundle,
   industryDiscoveryBundle,
+  isPhaseLabelOwnedByExcluded,
+  isScheduledTaskOwnedByExcluded,
+  isTypeLabelOwnedByExcluded,
   jestBundle,
   labelsForPhase,
   maintenanceAuditBundle,