@codedrifters/configulator 0.0.254 → 0.0.256

package/lib/index.js

@@ -243,6 +243,8 @@ __export(index_exports, {
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
+  renderFocusSection: () => renderFocusSection,
+  renderPriorityRulesSection: () => renderPriorityRulesSection,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
   requirementsReviewerBundle: () => requirementsReviewerBundle,
   requirementsWriterBundle: () => requirementsWriterBundle,
@@ -14580,6 +14582,165 @@ var vitestBundle = {
   }
 };
 
+// src/agent/bundles/focus.ts
+var DEFAULT_FOCUS_FILE_PATH = ".claude/focus.json";
+var DEFAULT_SCHEMA_VERSION = 1;
+function renderFocusSection(focus) {
+  if (!focus) {
+    return "";
+  }
+  const focusFilePath = focus.focusFilePath ?? DEFAULT_FOCUS_FILE_PATH;
+  const schemaVersion = focus.schemaVersion ?? DEFAULT_SCHEMA_VERSION;
+  const lines = [
+    "## Focus scoring",
+    "",
+    "This project runs a **focus-scoring engine** alongside the generic",
+    "`priority:*` inference above. Focus scoring boosts the priority of",
+    "issues that match the project's currently-declared focus areas \u2014",
+    "named customers, segments, organizations, software products,",
+    "regulations, or people the project cares about right now.",
+    "",
+    "### Reading `focus.json`",
+    "",
+    `The focus file lives at \`${focusFilePath}\` and conforms to schema`,
+    `version \`${schemaVersion}\`. Each entry declares a match predicate`,
+    "(any combination of `labels`, `titleKeywords`, `bodyKeywords`) and",
+    "a positive integer `weight`. At triage time:",
+    "",
+    `1. Read \`${focusFilePath}\`. If the file is missing or empty,`,
+    "   skip focus scoring entirely \u2014 the generic priority heuristics",
+    "   apply unchanged.",
+    "2. For each focus area, test its match predicate against the",
+    "   issue's labels, title, and body. A match on **any** sub-field",
+    "   (labels / title keywords / body keywords) fires the area and",
+    "   contributes its `weight` to the issue's focus score.",
+    "3. Keyword matching is case-insensitive substring matching \u2014",
+    '   `titleKeywords: ["Acme"]` matches an issue titled',
+    "   `feat: onboard acme corp`.",
+    "4. Sum all matched weights to produce the issue's **focus score**.",
+    ""
+  ];
+  lines.push("### How focus score interacts with `priority:*`");
+  lines.push("");
+  if (focus.thresholds) {
+    const { high, medium } = focus.thresholds;
+    lines.push(`A focus score of \`${high}\` or more boosts the`);
+    const mediumBand = high - medium === 1 ? `A focus score of \`${medium}\` keeps` : `A focus score of \`${medium}\` up to \`${high - 1}\` keeps`;
+    lines.push(
+      "issue to `priority:high`.",
+      `${mediumBand} the issue at \`priority:medium\`. Scores below`,
+      `\`${medium}\` do **not** alter the priority that`,
+      "the generic heuristics would otherwise infer."
+    );
+  } else {
+    lines.push(
+      "This project has not declared explicit focus-score thresholds.",
+      "Treat any non-zero focus score as a soft signal to lift one",
+      "priority tier (never above `priority:high`) unless the generic",
+      "heuristics already pin a higher tier."
+    );
+  }
+  lines.push("");
+  lines.push(
+    "Focus scoring **never lowers** an issue's priority \u2014 the generic",
+    "heuristics set the floor, and focus weight can only lift it.",
+    "`priority:critical` is never set by focus scoring alone; the",
+    "generic heuristics own that tier."
+  );
+  lines.push("");
+  lines.push("### Agent-driven expansion");
+  lines.push("");
+  if (focus.agentExpansionRules) {
+    const rules = focus.agentExpansionRules;
+    const allowedList = rules.allowedTypes.map((t) => `\`${t}\``).join(", ");
+    const forbiddenList = rules.forbiddenTypes.map((t) => `\`${t}\``).join(", ");
+    lines.push(
+      `Agents may **append** new focus areas to \`${focusFilePath}\``,
+      "when they discover a relevant entity during work, subject to",
+      "these guard-rails:"
+    );
+    lines.push("");
+    lines.push(
+      `- **Max weight.** Agent-appended entries must set \`weight\` to`,
+      `  \`${rules.maxWeight}\` or less. Higher weights require a human.`
+    );
+    lines.push(
+      "- **Allowed types.** Agents may only introduce entries whose",
+      `  \`type\` is one of: ${allowedList || "(none)"}.`
+    );
+    if (rules.forbiddenTypes.length > 0) {
+      lines.push(
+        "- **Forbidden types.** Even inside `allowedTypes`, agents must",
+        `  never introduce entries whose \`type\` is one of: ${forbiddenList}.`
+      );
+    }
+    if (rules.maxKeywords !== void 0) {
+      lines.push(
+        "- **Max keywords per match field.** Agent-appended entries",
+        `  may list at most \`${rules.maxKeywords}\` items in each of`,
+        "  `match.labels`, `match.titleKeywords`, and `match.bodyKeywords`."
+      );
+    }
+    lines.push(
+      '- **Provenance.** Agent-appended entries must set `source: "agent"`',
+      '  and `discoveredIn: "#<issue>"` referencing the issue that',
+      "  surfaced the focus area."
+    );
+    lines.push(
+      "- **Append-only.** Never modify or remove existing entries.",
+      "  Human curators own edits and deletions."
+    );
+  } else {
+    lines.push(
+      `Agents must **not** append to \`${focusFilePath}\`. This project`,
+      "has not declared agent-expansion rules \u2014 all focus-area curation",
+      "is performed by humans. If you discover a relevant entity that",
+      "is not covered by an existing focus area, raise it in the issue",
+      "or PR discussion instead of editing the focus file."
+    );
+  }
+  return lines.join("\n");
+}
+
+// src/agent/bundles/priority-rules.ts
+function renderPriorityRulesSection(rules) {
+  if (rules.length === 0) {
+    return "";
+  }
+  const lines = [
+    "## Project-specific priority rules",
+    "",
+    "These rules are supplied by this project through",
+    "`AgentConfigOptions.priorityRules` and override the generic inference",
+    "heuristics above. Rules evaluate in the order listed; **first match",
+    "wins**. The bundle's default heuristics apply only when no rule below",
+    "matches.",
+    ""
+  ];
+  rules.forEach((rule, index) => {
+    const matchDetails = [];
+    if (rule.match.labels && rule.match.labels.length > 0) {
+      const labelList = rule.match.labels.map((l) => `\`${l}\``).join(", ");
+      matchDetails.push(`labels: ${labelList}`);
+    }
+    if (rule.match.titleRegex) {
+      matchDetails.push(`title regex: \`${rule.match.titleRegex}\``);
+    }
+    if (rule.match.bodyRegex) {
+      matchDetails.push(`body regex: \`${rule.match.bodyRegex}\``);
+    }
+    if (rule.match.issueNumbers && rule.match.issueNumbers.length > 0) {
+      const numberList = rule.match.issueNumbers.map((n) => `#${n}`).join(", ");
+      matchDetails.push(`issue numbers: ${numberList}`);
+    }
+    const matchSummary = matchDetails.length > 0 ? matchDetails.join("; ") : "(no match fields)";
+    lines.push(
+      `${index + 1}. **\`priority:${rule.priority}\`** when ${matchSummary} \u2014 ${rule.rationale}`
+    );
+  });
+  return lines.join("\n");
+}
+
 // src/agent/bundles/index.ts
 var BUILT_IN_BUNDLES = [
   baseBundle,
@@ -15500,6 +15661,36 @@ ${extra}`
         }
       }
     }
+    if (this.options.priorityRules && this.options.priorityRules.length > 0) {
+      const issueLabelRule = ruleMap.get("issue-label-conventions");
+      if (issueLabelRule) {
+        const section = renderPriorityRulesSection(this.options.priorityRules);
+        ruleMap.set("issue-label-conventions", {
+          ...issueLabelRule,
+          content: `${issueLabelRule.content}
+
+---
+
+${section}`
+        });
+      }
+    }
+    if (this.options.focus) {
+      const issueLabelRule = ruleMap.get("issue-label-conventions");
+      if (issueLabelRule) {
+        const section = renderFocusSection(this.options.focus);
+        if (section.length > 0) {
+          ruleMap.set("issue-label-conventions", {
+            ...issueLabelRule,
+            content: `${issueLabelRule.content}
+
+---
+
+${section}`
+          });
+        }
+      }
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -18311,6 +18502,8 @@ var TypeScriptConfig = class extends import_projen22.Component {
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  renderFocusSection,
+  renderPriorityRulesSection,
   requirementsAnalystBundle,
   requirementsReviewerBundle,
   requirementsWriterBundle,