@codedrifters/configulator 0.0.289 → 0.0.290

package/lib/index.js

@@ -205,6 +205,7 @@ __export(index_exports, {
   DEFAULT_API_EXTRACTOR_REPORT_FILENAME: () => DEFAULT_API_EXTRACTOR_REPORT_FILENAME,
   DEFAULT_API_EXTRACTOR_REPORT_FOLDER: () => DEFAULT_API_EXTRACTOR_REPORT_FOLDER,
   DEFAULT_AUDIT_REPORT_DIR: () => DEFAULT_AUDIT_REPORT_DIR,
+  DEFAULT_BUNDLE_OVERRIDES: () => DEFAULT_BUNDLE_OVERRIDES,
   DEFAULT_DECOMPOSITION_TEMPLATE: () => DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL: () => DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO: () => DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
@@ -390,6 +391,7 @@ __export(index_exports, {
   resolveModelAlias: () => resolveModelAlias,
   resolveOrchestratorAssets: () => resolveOrchestratorAssets,
   resolveOutdirFromPackageName: () => resolveOutdirFromPackageName,
+  resolveOverrideForLabels: () => resolveOverrideForLabels,
   resolveProgressFiles: () => resolveProgressFiles,
   resolveRunRatio: () => resolveRunRatio,
   resolveScheduledTasks: () => resolveScheduledTasks,
@@ -12011,6 +12013,14 @@ var DEFAULT_SOURCES_THRESHOLDS = {
   smallMax: 2,
   mediumMax: 5
 };
+var DEFAULT_BUNDLE_OVERRIDES = {
+  "req:write": {
+    acceptanceCriteria: { smallMax: 3, mediumMax: 20 }
+  },
+  "bcm:scaffold": {
+    acceptanceCriteria: { smallMax: 3, mediumMax: 12 }
+  }
+};
 var DEFAULT_DECOMPOSITION_TEMPLATE = [
   "## Scope gate: issue is too large to dispatch",
   "",
@@ -12050,22 +12060,58 @@ function resolveScopeGate(config) {
     DEFAULT_SOURCES_THRESHOLDS,
     "sources"
   );
+  const bundleOverrides = resolveBundleOverrides(
+    config?.bundleOverrides,
+    DEFAULT_BUNDLE_OVERRIDES
+  );
   return {
     enabled: config?.enabled ?? true,
     acceptanceCriteria: ac,
     sources,
     autoFile: config?.autoFile ?? false,
-    decompositionTemplate: config?.decompositionTemplate ?? DEFAULT_DECOMPOSITION_TEMPLATE
+    decompositionTemplate: config?.decompositionTemplate ?? DEFAULT_DECOMPOSITION_TEMPLATE,
+    bundleOverrides
+  };
+}
+function resolveOverrideForLabels(gate, labels) {
+  const overrideKeys = Object.keys(gate.bundleOverrides);
+  if (overrideKeys.length === 0 || labels.length === 0) {
+    return {
+      acceptanceCriteria: gate.acceptanceCriteria,
+      sources: gate.sources
+    };
+  }
+  const sortedLabels = [...labels].sort((a, b) => a.localeCompare(b));
+  const matchedLabel = sortedLabels.find(
+    (label) => Object.prototype.hasOwnProperty.call(gate.bundleOverrides, label)
+  );
+  if (matchedLabel === void 0) {
+    return {
+      acceptanceCriteria: gate.acceptanceCriteria,
+      sources: gate.sources
+    };
+  }
+  const override = gate.bundleOverrides[matchedLabel];
+  return {
+    acceptanceCriteria: override.acceptanceCriteria ?? gate.acceptanceCriteria,
+    sources: override.sources ?? gate.sources,
+    matchedLabel
   };
 }
 function validateScopeGateConfig(config) {
   return resolveScopeGate(config);
 }
-function classifyIssueScope(body, gate) {
+function classifyIssueScope(body, gate, labels = []) {
   const acCount = countAcceptanceCriteria(body);
   const sourcesCount = countSources(body);
-  const scope = resolveScopeClass(acCount, sourcesCount, gate);
-  return { scope, acCount, sourcesCount };
+  const effective = resolveOverrideForLabels(gate, labels);
+  const scope = resolveScopeClass(acCount, sourcesCount, effective);
+  return {
+    scope,
+    acCount,
+    sourcesCount,
+    matchedLabel: effective.matchedLabel
+  };
 }
 function renderScopeGateSection(gate) {
   const { acceptanceCriteria: ac, sources } = gate;
@@ -12141,6 +12187,38 @@ function renderScopeGateSection(gate) {
       "   is in place."
     );
   }
+  const overrideEntries = Object.entries(gate.bundleOverrides);
+  if (overrideEntries.length > 0) {
+    lines.push(
+      "",
+      "### Per-phase-label thresholds",
+      "",
+      "Issues whose `type:*` or phase label matches an entry below are",
+      "classified against the override's thresholds instead of the",
+      "global `acceptance-criteria` / `sources` defaults. This",
+      "accommodates **content-spec workflows** \u2014 issues whose AC list",
+      "is the per-section content checklist for one cohesive document,",
+      "not a phase-completion checklist that can be decomposed.",
+      "",
+      "| Phase label | AC `mediumMax` | Sources `mediumMax` |",
+      "|-------------|----------------|---------------------|"
+    );
+    const sortedKeys = overrideEntries.map(([k]) => k).sort();
+    for (const label of sortedKeys) {
+      const override = gate.bundleOverrides[label];
+      const acMax = override.acceptanceCriteria?.mediumMax;
+      const sourcesMax = override.sources?.mediumMax;
+      const acCell = acMax === void 0 ? "_(global)_" : `${acMax}`;
+      const sourcesCell = sourcesMax === void 0 ? "_(global)_" : `${sourcesMax}`;
+      lines.push(`| \`${label}\` | ${acCell} | ${sourcesCell} |`);
+    }
+    lines.push(
+      "",
+      "When an issue carries multiple labels that each match an entry",
+      "in this table, the orchestrator picks the **first match in",
+      "alphabetical order on the label name** \u2014 first-wins, deterministic."
+    );
+  }
   lines.push(
     "",
     "### Decomposition-proposal template",
@@ -12157,12 +12235,21 @@ function renderScopeGateSection(gate) {
 }
 function renderScopeGateShellHelpers(gate) {
   const { acceptanceCriteria: ac, sources } = gate;
-  return [
+  const lines = [
     "# Classify an issue body against the scope-gate thresholds.",
     "# Reads the issue body from stdin. Echoes one of 'small',",
     "# 'medium', or 'large' on stdout. Writes the observed counts to",
     "# stderr as `ac=<n> sources=<n>` so the caller can embed them in",
     "# the decomposition-proposal comment.",
+    "#",
+    "# Effective per-issue thresholds are read from the four",
+    "# `_EFFECTIVE_*` shell variables. The caller is expected to set",
+    "# them via `bundle_override_for()` before invoking scope_of();",
+    "# defaults preserve the global thresholds.",
+    `_EFFECTIVE_AC_SMALL_MAX="\${_EFFECTIVE_AC_SMALL_MAX:-${ac.smallMax}}"`,
+    `_EFFECTIVE_AC_MEDIUM_MAX="\${_EFFECTIVE_AC_MEDIUM_MAX:-${ac.mediumMax}}"`,
+    `_EFFECTIVE_SOURCES_SMALL_MAX="\${_EFFECTIVE_SOURCES_SMALL_MAX:-${sources.smallMax}}"`,
+    `_EFFECTIVE_SOURCES_MEDIUM_MAX="\${_EFFECTIVE_SOURCES_MEDIUM_MAX:-${sources.mediumMax}}"`,
     "scope_of() {",
     "  local body",
     "  body=$(cat)",
@@ -12191,15 +12278,79 @@ function renderScopeGateShellHelpers(gate) {
     "    END { print count }",
     "  ')",
     `  printf 'ac=%s sources=%s\\n' "$ac_count" "$sources_count" >&2`,
-    `  if [ "$ac_count" -le ${ac.smallMax} ] && [ "$sources_count" -le ${sources.smallMax} ]; then`,
+    '  if [ "$ac_count" -le "$_EFFECTIVE_AC_SMALL_MAX" ] && [ "$sources_count" -le "$_EFFECTIVE_SOURCES_SMALL_MAX" ]; then',
     "    echo small",
-    `  elif [ "$ac_count" -le ${ac.mediumMax} ] && [ "$sources_count" -le ${sources.mediumMax} ]; then`,
+    '  elif [ "$ac_count" -le "$_EFFECTIVE_AC_MEDIUM_MAX" ] && [ "$sources_count" -le "$_EFFECTIVE_SOURCES_MEDIUM_MAX" ]; then',
     "    echo medium",
     "  else",
     "    echo large",
     "  fi",
+    "}",
+    "",
+    "# Resolve per-phase-label threshold overrides. Reads a newline-",
+    "# separated list of label names on stdin and echoes effective",
+    "# threshold variable assignments (one per line) on stdout. The",
+    "# caller `eval`s the output to set the four `_EFFECTIVE_*`",
+    "# variables before calling `scope_of()`. Also echoes",
+    "# `MATCHED_LABEL=<label>` (or `MATCHED_LABEL=`) so the caller can",
+    "# report which override fired.",
+    "#",
+    "# Tie-breaking: when more than one label matches an override key,",
+    "# the alphabetical first-wins rule applies \u2014 the same rule the",
+    "# TypeScript classifier uses.",
+    "bundle_override_for() {",
+    `  local default_ac_small=${ac.smallMax}`,
+    `  local default_ac_medium=${ac.mediumMax}`,
+    `  local default_sources_small=${sources.smallMax}`,
+    `  local default_sources_medium=${sources.mediumMax}`,
+    "  # Sort labels alphabetically so the first match is deterministic.",
+    "  local sorted_labels",
+    "  sorted_labels=$(LC_ALL=C sort)",
+    "  local matched_label=''",
+    "  local ac_small=$default_ac_small",
+    "  local ac_medium=$default_ac_medium",
+    "  local sources_small=$default_sources_small",
+    "  local sources_medium=$default_sources_medium",
+    "  while IFS= read -r label; do",
+    '    [ -z "$label" ] && continue',
+    `    case "$label" in`
+  ];
+  const sortedKeys = Object.keys(gate.bundleOverrides).sort();
+  if (sortedKeys.length === 0) {
+    lines.push("      *) ;;");
+  } else {
+    for (const label of sortedKeys) {
+      const override = gate.bundleOverrides[label];
+      const acThresholds = override.acceptanceCriteria;
+      const sourcesThresholds = override.sources;
+      const branchLines = [`      '${label}')`];
+      if (acThresholds !== void 0) {
+        branchLines.push(`        ac_small=${acThresholds.smallMax}`);
+        branchLines.push(`        ac_medium=${acThresholds.mediumMax}`);
+      }
+      if (sourcesThresholds !== void 0) {
+        branchLines.push(`        sources_small=${sourcesThresholds.smallMax}`);
+        branchLines.push(
+          `        sources_medium=${sourcesThresholds.mediumMax}`
+        );
+      }
+      branchLines.push(`        matched_label='${label}'`);
+      branchLines.push("        break");
+      branchLines.push("        ;;");
+      lines.push(...branchLines);
+    }
+  }
+  lines.push(
+    "    esac",
+    `  done <<<"$sorted_labels"`,
+    `  printf 'MATCHED_LABEL=%s\\n' "$matched_label"`,
+    `  printf '_EFFECTIVE_AC_SMALL_MAX=%s\\n' "$ac_small"`,
+    `  printf '_EFFECTIVE_AC_MEDIUM_MAX=%s\\n' "$ac_medium"`,
+    `  printf '_EFFECTIVE_SOURCES_SMALL_MAX=%s\\n' "$sources_small"`,
+    `  printf '_EFFECTIVE_SOURCES_MEDIUM_MAX=%s\\n' "$sources_medium"`,
     "}"
-  ].join("\n");
+  );
+  return lines.join("\n");
 }
 function resolveThresholds(supplied, defaults, field) {
   const merged = {
@@ -12209,6 +12360,42 @@ function resolveThresholds(supplied, defaults, field) {
   assertValidThresholds(merged, field);
   return merged;
 }
+function resolveBundleOverrides(supplied, defaults) {
+  const out = {};
+  for (const [label, override] of Object.entries(defaults)) {
+    out[label] = override;
+  }
+  if (supplied !== void 0) {
+    for (const label of Object.keys(supplied)) {
+      const value = supplied[label];
+      if (value === void 0) {
+        delete out[label];
+        continue;
+      }
+      const resolved = {};
+      if (value.acceptanceCriteria !== void 0) {
+        resolved.acceptanceCriteria = resolveThresholds(
+          value.acceptanceCriteria,
+          DEFAULT_AC_THRESHOLDS,
+          "acceptanceCriteria"
+        );
+      }
+      if (value.sources !== void 0) {
+        resolved.sources = resolveThresholds(
+          value.sources,
+          DEFAULT_SOURCES_THRESHOLDS,
+          "sources"
+        );
+      }
+      if (resolved.acceptanceCriteria === void 0 && resolved.sources === void 0) {
+        delete out[label];
+        continue;
+      }
+      out[label] = resolved;
+    }
+  }
+  return out;
+}
 function assertValidThresholds(thresholds, field) {
   const { smallMax, mediumMax } = thresholds;
   for (const [key, value] of [
@@ -12232,8 +12419,8 @@ function assertValidThresholds(thresholds, field) {
     );
   }
 }
-function resolveScopeClass(acCount, sourcesCount, gate) {
-  const { acceptanceCriteria: ac, sources } = gate;
+function resolveScopeClass(acCount, sourcesCount, thresholds) {
+  const { acceptanceCriteria: ac, sources } = thresholds;
   if (acCount <= ac.smallMax && sourcesCount <= sources.smallMax) {
     return "small";
   }
@@ -12813,7 +13000,9 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "STALE_BLOCKED_HOURS=168",
     `SCOPE_GATE_ENABLED=${scopeGate.enabled ? "1" : "0"}`,
     `SCOPE_GATE_AUTO_FILE=${scopeGate.autoFile ? "1" : "0"}`,
+    `SCOPE_AC_SMALL_MAX=${scopeGate.acceptanceCriteria.smallMax}`,
     `SCOPE_AC_MEDIUM_MAX=${scopeGate.acceptanceCriteria.mediumMax}`,
+    `SCOPE_SOURCES_SMALL_MAX=${scopeGate.sources.smallMax}`,
     `SCOPE_SOURCES_MEDIUM_MAX=${scopeGate.sources.mediumMax}`,
     `RUN_RATIO_ENABLED=${runRatio.enabled ? "1" : "0"}`,
     `RUN_RATIO_DISPATCH_PER_HOUSEKEEPING=${runRatio.ratio}`,
@@ -13167,12 +13356,45 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     '    echo "SCOPE #${issue_num} disabled"',
     "    return 0",
     "  fi",
+    "  # Fetch the body and labels in a single API call so we resolve",
+    "  # any per-phase-label override against the issue's actual labels.",
+    "  local issue_json",
+    '  issue_json=$(gh issue view "$issue_num" --json body,labels 2>/dev/null || echo "")',
+    '  if [[ -z "$issue_json" ]]; then',
+    '    echo "SCOPE #${issue_num} unknown \u2014 could not read issue body"',
+    "    return 1",
+    "  fi",
     "  local body",
-    `  body=$(gh issue view "$issue_num" --json body --jq '.body' 2>/dev/null || echo "")`,
+    `  body=$(printf '%s' "$issue_json" | jq -r '.body // ""')`,
     '  if [[ -z "$body" ]]; then',
     '    echo "SCOPE #${issue_num} unknown \u2014 could not read issue body"',
     "    return 1",
     "  fi",
+    "  local labels",
+    `  labels=$(printf '%s' "$issue_json" | jq -r '.labels[]?.name // empty')`,
+    "  # Resolve the effective thresholds. `bundle_override_for` reads",
+    "  # labels on stdin and emits `KEY=VALUE` assignments (one per line)",
+    "  # for the four `_EFFECTIVE_*` variables plus `MATCHED_LABEL`.",
+    "  local override_output",
+    `  override_output=$(printf '%s\\n' "$labels" | bundle_override_for)`,
+    "  local matched_label=''",
+    "  local _EFFECTIVE_AC_SMALL_MAX=$SCOPE_AC_SMALL_MAX",
+    "  local _EFFECTIVE_AC_MEDIUM_MAX=$SCOPE_AC_MEDIUM_MAX",
+    "  local _EFFECTIVE_SOURCES_SMALL_MAX=$SCOPE_SOURCES_SMALL_MAX",
+    "  local _EFFECTIVE_SOURCES_MEDIUM_MAX=$SCOPE_SOURCES_MEDIUM_MAX",
+    "  while IFS= read -r assignment; do",
+    '    [ -z "$assignment" ] && continue',
+    '    case "$assignment" in',
+    "      MATCHED_LABEL=*) matched_label=${assignment#MATCHED_LABEL=} ;;",
+    "      _EFFECTIVE_AC_SMALL_MAX=*) _EFFECTIVE_AC_SMALL_MAX=${assignment#_EFFECTIVE_AC_SMALL_MAX=} ;;",
+    "      _EFFECTIVE_AC_MEDIUM_MAX=*) _EFFECTIVE_AC_MEDIUM_MAX=${assignment#_EFFECTIVE_AC_MEDIUM_MAX=} ;;",
+    "      _EFFECTIVE_SOURCES_SMALL_MAX=*) _EFFECTIVE_SOURCES_SMALL_MAX=${assignment#_EFFECTIVE_SOURCES_SMALL_MAX=} ;;",
+    "      _EFFECTIVE_SOURCES_MEDIUM_MAX=*) _EFFECTIVE_SOURCES_MEDIUM_MAX=${assignment#_EFFECTIVE_SOURCES_MEDIUM_MAX=} ;;",
+    "    esac",
+    '  done <<<"$override_output"',
+    "  # Export the effective thresholds so scope_of() picks them up.",
+    "  export _EFFECTIVE_AC_SMALL_MAX _EFFECTIVE_AC_MEDIUM_MAX",
+    "  export _EFFECTIVE_SOURCES_SMALL_MAX _EFFECTIVE_SOURCES_MEDIUM_MAX",
     "  local scope counts",
     "  # scope_of writes counts to stderr (ac=N sources=N); capture both.",
     `  scope=$(printf '%s' "$body" | scope_of 2> >(read -r counts; echo "$counts" >&2))`,
@@ -13186,9 +13408,17 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     `  sources_count=$(echo "$stderr_capture" | grep -oE 'sources=[0-9]+' | head -1 | cut -d= -f2)`,
     "  ac_count=${ac_count:-0}",
     "  sources_count=${sources_count:-0}",
-    "  printf 'SCOPE #%s %s ac=%s sources=%s ac_limit=%s sources_limit=%s auto_file=%s\\n' \\",
-    '    "$issue_num" "$scope" "$ac_count" "$sources_count" \\',
-    '    "$SCOPE_AC_MEDIUM_MAX" "$SCOPE_SOURCES_MEDIUM_MAX" "$SCOPE_GATE_AUTO_FILE"',
+    '  if [ -n "$matched_label" ]; then',
+    "    printf 'SCOPE #%s %s ac=%s sources=%s ac_limit=%s sources_limit=%s auto_file=%s matched_label=%s\\n' \\",
+    '      "$issue_num" "$scope" "$ac_count" "$sources_count" \\',
+    '      "$_EFFECTIVE_AC_MEDIUM_MAX" "$_EFFECTIVE_SOURCES_MEDIUM_MAX" \\',
+    '      "$SCOPE_GATE_AUTO_FILE" "$matched_label"',
+    "  else",
+    "    printf 'SCOPE #%s %s ac=%s sources=%s ac_limit=%s sources_limit=%s auto_file=%s\\n' \\",
+    '      "$issue_num" "$scope" "$ac_count" "$sources_count" \\',
+    '      "$_EFFECTIVE_AC_MEDIUM_MAX" "$_EFFECTIVE_SOURCES_MEDIUM_MAX" \\',
+    '      "$SCOPE_GATE_AUTO_FILE"',
+    "  fi",
     "}",
     "",
     "cmd_tick() {",
@@ -13393,9 +13623,16 @@ var orchestratorSubAgent = {
     "The output is one line of the form:",
     "",
     "```",
-    "SCOPE #<n> <small|medium|large> ac=<n> sources=<n> ac_limit=<n> sources_limit=<n> auto_file=<0|1>",
+    "SCOPE #<n> <small|medium|large> ac=<n> sources=<n> ac_limit=<n> sources_limit=<n> auto_file=<0|1> [matched_label=<label>]",
     "```",
     "",
+    "When `matched_label=<label>` is present, the scope gate applied a",
+    "per-phase-label override (e.g. `req:write` raises the AC ceiling to",
+    "20 for content-spec workflows whose AC list is the per-section",
+    "checklist for one document). The `ac_limit` / `sources_limit`",
+    "values reflect the override; the global thresholds are documented",
+    "in the **Scope gate** section in `CLAUDE.md`.",
+    "",
     "If the scope is `small` or `medium`, continue \u2014 the issue is",
     "dispatchable. Record the first `PICK` line as the next work item",
     "and proceed to Phase G:",
@@ -32676,6 +32913,7 @@ var TypeScriptConfig = class extends import_projen23.Component {
   DEFAULT_API_EXTRACTOR_REPORT_FILENAME,
   DEFAULT_API_EXTRACTOR_REPORT_FOLDER,
   DEFAULT_AUDIT_REPORT_DIR,
+  DEFAULT_BUNDLE_OVERRIDES,
   DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
@@ -32861,6 +33099,7 @@ var TypeScriptConfig = class extends import_projen23.Component {
   resolveModelAlias,
   resolveOrchestratorAssets,
   resolveOutdirFromPackageName,
+  resolveOverrideForLabels,
   resolveProgressFiles,
   resolveRunRatio,
   resolveScheduledTasks,