@codedrifters/configulator 0.0.406 → 0.0.408

package/lib/index.mjs

@@ -1830,12 +1830,111 @@ var awsCdkBundle = {
   ]
 };
 
+// src/agent/bundles/issue-defaults.ts
+var VALID_STATUS_VALUES = [
+  "ready",
+  "blocked",
+  "in-progress",
+  "ready-for-review",
+  "needs-attention",
+  "done",
+  "deferred"
+];
+var VALID_PRIORITY_VALUES = [
+  "critical",
+  "high",
+  "medium",
+  "low",
+  "trivial"
+];
+var DEFAULT_ISSUE_STATUS = "ready";
+var DEFAULT_ISSUE_PRIORITY = "medium";
+var DEFAULT_RESOLVED_ISSUE_DEFAULTS = {
+  defaults: {
+    status: DEFAULT_ISSUE_STATUS,
+    priority: DEFAULT_ISSUE_PRIORITY
+  },
+  overrides: {}
+};
+function resolveIssueDefaults(config) {
+  if (config === void 0) {
+    return DEFAULT_RESOLVED_ISSUE_DEFAULTS;
+  }
+  const overrides = {};
+  for (const [phaseLabel, override] of Object.entries(config)) {
+    assertValidPhaseLabel(phaseLabel);
+    assertValidOverride(phaseLabel, override);
+    overrides[phaseLabel] = {
+      status: override.status ?? DEFAULT_ISSUE_STATUS,
+      priority: override.priority ?? DEFAULT_ISSUE_PRIORITY
+    };
+  }
+  return {
+    defaults: {
+      status: DEFAULT_ISSUE_STATUS,
+      priority: DEFAULT_ISSUE_PRIORITY
+    },
+    overrides
+  };
+}
+function validateIssueDefaultsConfig(config) {
+  return resolveIssueDefaults(config);
+}
+function labelsForPhase(resolved, phaseLabel) {
+  return resolved.overrides[phaseLabel] ?? resolved.defaults;
+}
+function assertValidPhaseLabel(phaseLabel) {
+  if (typeof phaseLabel !== "string" || phaseLabel.trim() === "") {
+    throw new Error(
+      "AgentConfigOptions.issueDefaults: phase-label keys must be non-empty strings (e.g. `people:research`)."
+    );
+  }
+}
+function assertValidOverride(phaseLabel, override) {
+  if (override === null || typeof override !== "object" || Array.isArray(override)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must be an object with optional \`status\` and \`priority\` fields.`
+    );
+  }
+  const { status, priority } = override;
+  if (status === void 0 && priority === void 0) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must declare at least one of \`status\` or \`priority\`. Empty entries are rejected because they are almost always a typo on the field name.`
+    );
+  }
+  if (status !== void 0 && !VALID_STATUS_VALUES.includes(status)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"].status="${status}" is not a recognised status value. Allowed values: ${VALID_STATUS_VALUES.join(", ")}.`
+    );
+  }
+  if (priority !== void 0 && !VALID_PRIORITY_VALUES.includes(priority)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"].priority="${priority}" is not a recognised priority value. Allowed values: ${VALID_PRIORITY_VALUES.join(", ")}.`
+    );
+  }
+}
+
 // src/agent/bundles/issue-templates.ts
 var DEFAULT_ISSUE_TEMPLATES_ENABLED = true;
 var DEFAULT_ISSUE_TEMPLATES_PATH = "docs/src/content/docs/agents/issue-templates.md";
 var DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS = [".claude/agents/**/*.md", ".claude/skills/**/*.md"];
 var DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER = false;
 var DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER = false;
+var ISSUE_TEMPLATES_GENERATED_SUFFIX = "-generated";
+function issueTemplatesGeneratedPath(templatesPath) {
+  const slash = templatesPath.lastIndexOf("/");
+  const dot = templatesPath.lastIndexOf(".");
+  if (dot > slash) {
+    return `${templatesPath.slice(0, dot)}${ISSUE_TEMPLATES_GENERATED_SUFFIX}${templatesPath.slice(dot)}`;
+  }
+  return `${templatesPath}${ISSUE_TEMPLATES_GENERATED_SUFFIX}`;
+}
+function issueTemplatesChildGlob(templatesPath) {
+  const slash = templatesPath.lastIndexOf("/");
+  const dot = templatesPath.lastIndexOf(".");
+  const stem = dot > slash ? templatesPath.slice(0, dot) : templatesPath;
+  return `${stem}/*.md`;
+}
 var DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE = true;
 function resolveIssueTemplates(config) {
   const templatesPath = config?.templatesPath ?? DEFAULT_ISSUE_TEMPLATES_PATH;
@@ -1919,7 +2018,40 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "issue kind appends one section; retiring a kind removes one. The",
     "label taxonomy, body template shape, and placeholder conventions",
     "are shared across every section.",
-    "",
+    ""
+  ];
+  if (it.emitStarterDoc) {
+    lines.push(
+      "## Scaffolded Starting Point",
+      "",
+      "The page is hand-authored, but it does not start empty. Two files",
+      "ship together:",
+      "",
+      `1. \`${it.templatesPath}\` \u2014 **written once**, then yours. Titles,`,
+      "   bodies, and the callers list are hand-authored here and never",
+      "   overwritten.",
+      `2. \`${issueTemplatesGeneratedPath(it.templatesPath)}\` \u2014`,
+      "   **regenerated on every synth**. One",
+      "   `## Template: <phase-label>` stub per phase label the active",
+      "   bundles contribute to the label registry, with the phase label,",
+      "   the `type:<bundle>` label its owning bundle declares, and the",
+      "   configured `status:*` / `priority:*` defaults pre-filled.",
+      "",
+      "Only the **label set** is generated. Title and body stay",
+      "angle-bracket placeholders, so the scaffold answers *which labels*",
+      "without dictating *what the issue says*. Copy a stub into the",
+      "hand-authored page, flesh out its body, and leave the label block",
+      "as generated.",
+      "",
+      "The split is load-bearing. A write-once scaffold alone freezes",
+      "every consumer on whatever skeleton shipped the day they adopted",
+      "the convention \u2014 a new phase label minted upstream never reaches",
+      "them. Regenerating the label half fixes that without ever",
+      "clobbering an authored body.",
+      ""
+    );
+  }
+  lines.push(
     "## Reference-Don't-Inline Rule",
     "",
     `Every bundle rule, agent prompt, or skill instruction that files a`,
@@ -1990,8 +2122,12 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "   placeholders (`<Organization Name>`, `<slug>`) that match",
     "   existing templates. Consistency across sections lets callers",
     "   substitute without re-reading the body every time.",
+    "5. **Does the recipe assign a GitHub issue type?** `gh issue",
+    "   create` cannot set it and the `type:*` label does not either, so",
+    "   every section ends with the follow-up call. An issue that skips",
+    "   it stays untyped forever.",
     ""
-  ];
+  );
   if (it.emitChecker) {
     lines.push(
       "## Automated Lint",
@@ -2022,6 +2158,33 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
       "(which documents the conventional `gh issue create` call shape",
       "as taxonomy, not a downstream template). All other bundle",
       "files in the pattern set are in scope.",
+      "",
+      "### Recipe label correctness",
+      "",
+      "A companion lint,",
+      "`.claude/procedures/check-issue-template-labels.sh`, checks the",
+      "recipes themselves rather than where they live. It walks the",
+      "templates page, its router-style child pages, and the generated",
+      "label-set companion, and fails non-zero when a",
+      "`## Template: <phase-label>` section:",
+      "",
+      "- never passes `--label <phase-label>` \u2014 the heading and the",
+      "  command disagree;",
+      "- carries no `type:*` label, more than one, or one that is not",
+      "  the `type:<bundle>` label the phase label's owning bundle",
+      "  declares;",
+      "- has no GitHub issue-type assignment step.",
+      "",
+      "```bash",
+      ".claude/procedures/check-issue-template-labels.sh",
+      "```",
+      "",
+      "The phase-label \u2192 type-label pairing is generated from the same",
+      "bundle-ownership map that drives `.github/labels.yml` and the",
+      "orchestrator's invariant sweep, so a hand-edit can never",
+      "reintroduce a mismatch the registry has already ruled out.",
+      "Sections whose heading matches no bundle-owned phase label are",
+      "skipped \u2014 consumer-specific labels are deliberately not policed.",
       ""
     );
   }
@@ -2030,8 +2193,10 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "",
     "The convention intentionally does not:",
     "",
-    "- Auto-generate the templates page \u2014 repo-specific phase labels",
-    "  and body conventions are too varied for a one-size template.",
+    "- Auto-generate recipe **bodies**. Only the label set is",
+    "  scaffolded, because labels are derivable from the bundle",
+    "  registry and bodies are not \u2014 repo-specific objectives,",
+    "  acceptance criteria, and callers lists stay hand-authored.",
     "- Prescribe a fixed body shape across templates. Each section",
     "  may carry its own `## Acceptance Criteria`, `## Scope Size`,",
     "  or `## Output Path` fields as the downstream agent requires;",
@@ -2062,7 +2227,8 @@ function renderIssueTemplatesBundleHook(it, bundleLabel) {
     "as an inline template vs. a prose mention."
   ].join("\n");
 }
-function renderIssueTemplatesStarterPage(_it) {
+function renderIssueTemplatesStarterPage(it) {
+  const generatedLink = `./${basename(issueTemplatesGeneratedPath(it.templatesPath))}`;
   return [
     "---",
     "title: Issue Templates",
@@ -2097,6 +2263,20 @@ function renderIssueTemplatesStarterPage(_it) {
     "bundle's rule \u2014 the issue-templates page is a recipe catalogue,",
     "not a duplicate-check layer.",
     "",
+    "## Generated label sets",
+    "",
+    `[Generated Issue-Template Label Sets](${generatedLink}) carries one`,
+    "correct-by-construction stub per phase label the active bundles",
+    "emit \u2014 the phase label paired with the `type:<bundle>` label its",
+    "owning bundle declares, plus the configured `status:*` /",
+    "`priority:*` defaults. That page regenerates on every `projen` run,",
+    "so it never goes stale as phase labels come and go.",
+    "",
+    "This page is the opposite: written once, then owned by you. Copy a",
+    "stub across, flesh out its title and body here, and leave the label",
+    "block exactly as generated \u2014 the label-consistency lint holds both",
+    "copies to the same pairing.",
+    "",
     "## Template: example-phase",
     "",
     "Replace this example with the real templates for this repo. Each",
@@ -2136,6 +2316,115 @@ function renderIssueTemplatesStarterPage(_it) {
     "```"
   ].join("\n");
 }
+function collectIssueTemplateRecipeStubs(bundles, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+  const stubs = /* @__PURE__ */ new Map();
+  for (const bundle of bundles) {
+    for (const label of bundle.labels ?? []) {
+      const typeLabel = typeLabelForPhaseLabel(label.name);
+      if (typeLabel === void 0) {
+        continue;
+      }
+      if (stubs.has(label.name)) {
+        continue;
+      }
+      const defaults = labelsForPhase(issueDefaults, label.name);
+      stubs.set(label.name, {
+        phaseLabel: label.name,
+        typeLabel,
+        bundleName: bundle.name,
+        description: label.description ?? "",
+        status: defaults.status,
+        priority: defaults.priority,
+        issueType: githubIssueTypeForTitle(`${label.name}: placeholder`)
+      });
+    }
+  }
+  return [...stubs.values()].sort(
+    (a, b) => a.phaseLabel.localeCompare(b.phaseLabel)
+  );
+}
+function renderIssueTemplatesGeneratedPage(it, stubs) {
+  const lines = [
+    "---",
+    "title: Generated Issue-Template Label Sets",
+    "description: Auto-generated label-correct gh issue create stubs \u2014 one per phase label.",
+    "---",
+    "",
+    "**Generated file \u2014 do not edit.** Every section below is",
+    "regenerated from the active bundle set on each `projen` run; hand",
+    "edits are overwritten. The hand-authored recipes live in",
+    `[the issue-templates page](./${basename(it.templatesPath)}) \u2014 this`,
+    "page exists so the **label half** of every recipe stays",
+    "correct-by-construction as phase labels come and go.",
+    "",
+    "## How to use",
+    "",
+    "Each section carries the exact label set the phase-label invariant",
+    "requires: the phase label itself, the `type:<bundle>` label its",
+    "owning bundle declares, and the configured `status:*` / `priority:*`",
+    "defaults for that phase. Title and body are placeholders \u2014 copy the",
+    "stub into the hand-authored templates page and flesh out the body",
+    "there, or run it as-is when no repo-specific body exists yet.",
+    "",
+    "Every stub ends with the **GitHub issue type** assignment. `gh issue",
+    "create` cannot set the issue type and the `type:*` label does not",
+    "set it either, so an issue that skips the follow-up call stays",
+    "untyped forever. See **Assigning the GitHub issue type** in the",
+    "`issue-conventions` rule for the no-helper fallback.",
+    ""
+  ];
+  if (stubs.length === 0) {
+    lines.push(
+      "## No phase labels",
+      "",
+      "No active bundle contributes a phase label, so there is nothing to",
+      "scaffold. Enable a phased-pipeline bundle (or drop it from",
+      "`excludeBundles`) and re-run `projen`."
+    );
+    return lines.join("\n");
+  }
+  for (const stub of stubs) {
+    lines.push(
+      `## Template: ${stub.phaseLabel}`,
+      "",
+      ...stub.description === "" ? [] : [stub.description, ""],
+      `**Owning bundle:** \`${stub.bundleName}\` \u2014 **required type label:**`,
+      `\`${stub.typeLabel}\` (paired by the bundle-ownership map).`,
+      "",
+      "**Callers:** <name the bundles and agents that file this issue>",
+      "",
+      "```bash",
+      "gh issue create \\",
+      `  --title "${stub.phaseLabel}: <short description>" \\`,
+      `  --label "${stub.typeLabel}" \\`,
+      `  --label "${stub.phaseLabel}" \\`,
+      `  --label "priority:${stub.priority}" \\`,
+      `  --label "status:${stub.status}" \\`,
+      '  --body "## Objective',
+      "",
+      "<1-3 sentences describing the work>.",
+      "",
+      "## Context",
+      "",
+      "- **Discovered in:** <source description> (#<parent-issue>)",
+      "",
+      "## Acceptance Criteria",
+      "",
+      "- [ ] <criterion 1>",
+      '"',
+      "```",
+      "",
+      `Then assign the GitHub issue type (\`${stub.issueType}\`):`,
+      "",
+      "```bash",
+      `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${stub.issueType}`,
+      "```",
+      ""
+    );
+  }
+  lines.pop();
+  return lines.join("\n");
+}
 function renderIssueTemplatesCheckerScript(it) {
   const patternsLiteral = it.bundlePathPatterns.map((p) => `  ${JSON.stringify(p)}`).join("\n");
   return [
@@ -2324,6 +2613,157 @@ function renderIssueTemplatesCheckerScript(it) {
     "exit 0"
   ].join("\n");
 }
+function renderIssueTemplateLabelsCheckerScript(it) {
+  const generatedPath = issueTemplatesGeneratedPath(it.templatesPath);
+  const childGlob = issueTemplatesChildGlob(it.templatesPath);
+  return [
+    "#!/usr/bin/env bash",
+    "# check-issue-template-labels.sh \u2014 Enforce recipe label correctness.",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/check-issue-template-labels.sh [<file>...]",
+    "#",
+    "# With no arguments the lint walks the templates page, its",
+    "# router-style child pages, and the generated label-set companion.",
+    "# Positional arguments override that default set.",
+    "#",
+    "# For every `## Template: <phase-label>` section it asserts the",
+    "# recipe passes the heading's phase label, carries exactly one",
+    "# `type:*` label matching the phase-label invariant, and assigns a",
+    "# GitHub issue type. Sections whose heading matches no bundle-owned",
+    "# phase label are skipped \u2014 unrecognised labels are consumer-",
+    "# specific and deliberately not policed.",
+    "#",
+    "# The resolver below is generated from the canonical bundle-",
+    "# ownership map \u2014 do not edit by hand; regenerate via",
+    "# `pnpm exec projen`.",
+    "",
+    "set -uo pipefail",
+    "",
+    "err() {",
+    '  printf "check-issue-template-labels.sh: %s\\n" "$*" >&2',
+    "}",
+    "",
+    renderPhaseTypeInvariantShellHelpers(),
+    "",
+    `templates_path=${JSON.stringify(it.templatesPath)}`,
+    `generated_path=${JSON.stringify(generatedPath)}`,
+    `child_glob=${JSON.stringify(childGlob)}`,
+    "",
+    "# Emit one TAB-separated record per `## Template:` section:",
+    "#   <file>\\t<line>\\t<phase-label>\\t<comma-joined labels>\\t<0|1 typed>",
+    "# Quote characters are folded to spaces up front so a recipe written",
+    "# with single quotes, double quotes, or none at all parses the same.",
+    "# Fenced blocks are tracked so the `## Objective` heading inside a",
+    "# recipe's --body string never reads as the end of the section.",
+    "scan_file() {",
+    '  local file="$1"',
+    `  tr '\\042\\047' '  ' < "$file" | awk -v FNAME="$file" '`,
+    "    function flush() {",
+    '      if (phase != "") {',
+    '        printf "%s\\t%d\\t%s\\t%s\\t%d\\n", FNAME, start, phase, labels, hastype;',
+    "      }",
+    '      phase = ""; labels = ""; hastype = 0;',
+    "    }",
+    "    {",
+    "      if ($0 ~ /^[ \\t]*```/) {",
+    "        fence = 1 - fence;",
+    '      } else if (fence == 0 && index($0, "## ") == 1) {',
+    "        flush();",
+    '        if (index($0, "## Template: ") == 1) {',
+    "          phase = substr($0, 14);",
+    '          gsub(/[ \\t`]/, "", phase);',
+    "          start = NR;",
+    "        }",
+    "        next;",
+    "      }",
+    '      if (phase == "") next;',
+    "      if ($0 ~ /set-issue-type\\.sh/ || $0 ~ /updateIssueIssueType/) {",
+    "        hastype = 1;",
+    "      }",
+    "      line = $0;",
+    "      while (match(line, /--label[ \\t]+[^ \\t]+/)) {",
+    "        tok = substr(line, RSTART, RLENGTH);",
+    "        line = substr(line, RSTART + RLENGTH);",
+    '        sub(/^--label[ \\t]+/, "", tok);',
+    '        gsub(/[\\\\`]/, "", tok);',
+    '        labels = labels tok ",";',
+    "      }",
+    "    }",
+    "    END { flush(); }",
+    "  '",
+    "}",
+    "",
+    "# Collect the file list: positional args override the default set.",
+    "files=()",
+    "if [[ $# -gt 0 ]]; then",
+    '  files=("$@")',
+    "else",
+    '  [[ -f "$templates_path" ]] && files+=("$templates_path")',
+    '  [[ -f "$generated_path" ]] && files+=("$generated_path")',
+    "  for child in $child_glob; do",
+    '    [[ -f "$child" ]] && files+=("$child")',
+    "  done",
+    "fi",
+    "",
+    "if [[ ${#files[@]} -eq 0 ]]; then",
+    "  exit 0",
+    "fi",
+    "",
+    "violations=()",
+    "checked=0",
+    "",
+    'for file in "${files[@]}"; do',
+    '  [[ -f "$file" ]] || continue',
+    "  while IFS=$'\\t' read -r rec_file rec_line phase labels hastype; do",
+    '    [[ -z "$phase" ]] && continue',
+    '    required=$(phase_label_type_of "$phase")',
+    '    [[ -z "$required" ]] && continue',
+    "    checked=$(( checked + 1 ))",
+    '    case ",${labels}" in',
+    '      *",${phase},"*) ;;',
+    `      *) violations+=("$rec_file:$rec_line: recipe for '$phase' never passes --label $phase") ;;`,
+    "    esac",
+    '    type_labels=""',
+    "    type_count=0",
+    '    for entry in $(printf "%s" "$labels" | tr , " "); do',
+    '      case "$entry" in',
+    "        type:*)",
+    '          type_labels="${type_labels}${entry} "',
+    "          type_count=$(( type_count + 1 ))",
+    "          ;;",
+    "      esac",
+    "    done",
+    '    if [[ "$type_count" -eq 0 ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' carries no type:* label (expected $required)")`,
+    '    elif [[ "$type_count" -gt 1 ]]; then',
+    "      violations+=(\"$rec_file:$rec_line: recipe for '$phase' carries ${type_count} type:* labels (${type_labels% }); exactly one is allowed\")",
+    '    elif [[ "${type_labels% }" != "$required" ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' carries \${type_labels% } but the phase label requires $required")`,
+    "    fi",
+    '    if [[ "$hastype" != "1" ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' has no GitHub issue-type assignment step")`,
+    "    fi",
+    '  done < <(scan_file "$file")',
+    "done",
+    "",
+    "if [[ ${#violations[@]} -gt 0 ]]; then",
+    '  err "issue-template recipes disagree with the phase-label invariant:"',
+    '  for v in "${violations[@]}"; do',
+    '    err "  - $v"',
+    "  done",
+    `  err "each '## Template: <phase-label>' recipe must pass its own phase label, exactly one matching type:<bundle> label, and a set-issue-type.sh (or updateIssueIssueType) step"`,
+    "  exit 1",
+    "fi",
+    "",
+    'printf "check-issue-template-labels.sh: %d recipe(s) OK\\n" "$checked"',
+    "exit 0"
+  ].join("\n");
+}
+function basename(path8) {
+  const slash = path8.lastIndexOf("/");
+  return slash === -1 ? path8 : path8.slice(slash + 1);
+}
 function assertValidTemplatesPath(value) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(
@@ -4587,7 +5027,15 @@ var createRuleSkill = {
     "- Use `ruleExtensions` to add project-specific content to existing bundle rules instead of replacing them"
   ].join("\n")
 };
-function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
+var DEFAULT_BASE_CONVENTIONS = {
+  progressFiles: resolveProgressFiles(),
+  sharedEditing: resolveSharedEditing(),
+  temporalFraming: resolveTemporalFraming(),
+  skillEvals: resolveSkillEvals(),
+  issueTemplates: resolveIssueTemplates(),
+  hasDownstreamIssueKindBundles: true
+};
+function buildBaseBundle(paths = DEFAULT_AGENT_PATHS, conventions = DEFAULT_BASE_CONVENTIONS) {
   return {
     name: "base",
     description: "Core rules: project overview, interaction style, and general coding conventions",
@@ -5256,7 +5704,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         // them via `agentConfig.additionalRulePaths`; other consumers
         // get a clean default.
         filePatterns: [".claude/agents/*.md", ".claude/procedures/**"],
-        content: renderProgressFilesRuleContent(resolveProgressFiles()),
+        content: renderProgressFilesRuleContent(conventions.progressFiles),
         platforms: {
           cursor: { exclude: true }
         },
@@ -5267,7 +5715,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         description: "Shared-editing safety: single-entry deterministic-sort inserts on index files, commit-path verification, and the merge-conflict resolution recipe that keeps concurrent agent sessions from dropping each other's rows on shared registries and feature matrices.",
         scope: AGENT_RULE_SCOPE.FILE_PATTERN,
         filePatterns: DEFAULT_SHARED_INDEX_PATHS,
-        content: renderSharedEditingRuleContent(resolveSharedEditing()),
+        content: renderSharedEditingRuleContent(conventions.sharedEditing),
         platforms: {
           cursor: { exclude: true }
         },
@@ -5285,7 +5733,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
           "docs/src/content/docs/standards-research/**/*.md",
           "docs/src/content/docs/customer-research/**/*.md"
         ],
-        content: renderTemporalFramingRuleContent(resolveTemporalFraming()),
+        content: renderTemporalFramingRuleContent(conventions.temporalFraming),
         platforms: {
           cursor: { exclude: true }
         },
@@ -5298,7 +5746,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         // Bundle defaults exclude paths into configulator's own
         // source — see comment on progress-file-convention above.
         filePatterns: [".claude/skills/**"],
-        content: renderSkillEvalsRuleContent(resolveSkillEvals()),
+        content: renderSkillEvalsRuleContent(conventions.skillEvals),
         platforms: {
           cursor: { exclude: true }
         },
@@ -5315,7 +5763,10 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
           ".claude/agents/*.md",
           `${paths.docsRoot}/agents/issue-templates.md`
         ],
-        content: renderIssueTemplatesRuleContent(resolveIssueTemplates()),
+        content: renderIssueTemplatesRuleContent(
+          conventions.issueTemplates,
+          conventions.hasDownstreamIssueKindBundles
+        ),
         platforms: {
           cursor: { exclude: true }
         },
@@ -5326,90 +5777,6 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
 }
 var baseBundle = buildBaseBundle();
 
-// src/agent/bundles/issue-defaults.ts
-var VALID_STATUS_VALUES = [
-  "ready",
-  "blocked",
-  "in-progress",
-  "ready-for-review",
-  "needs-attention",
-  "done",
-  "deferred"
-];
-var VALID_PRIORITY_VALUES = [
-  "critical",
-  "high",
-  "medium",
-  "low",
-  "trivial"
-];
-var DEFAULT_ISSUE_STATUS = "ready";
-var DEFAULT_ISSUE_PRIORITY = "medium";
-var DEFAULT_RESOLVED_ISSUE_DEFAULTS = {
-  defaults: {
-    status: DEFAULT_ISSUE_STATUS,
-    priority: DEFAULT_ISSUE_PRIORITY
-  },
-  overrides: {}
-};
-function resolveIssueDefaults(config) {
-  if (config === void 0) {
-    return DEFAULT_RESOLVED_ISSUE_DEFAULTS;
-  }
-  const overrides = {};
-  for (const [phaseLabel, override] of Object.entries(config)) {
-    assertValidPhaseLabel(phaseLabel);
-    assertValidOverride(phaseLabel, override);
-    overrides[phaseLabel] = {
-      status: override.status ?? DEFAULT_ISSUE_STATUS,
-      priority: override.priority ?? DEFAULT_ISSUE_PRIORITY
-    };
-  }
-  return {
-    defaults: {
-      status: DEFAULT_ISSUE_STATUS,
-      priority: DEFAULT_ISSUE_PRIORITY
-    },
-    overrides
-  };
-}
-function validateIssueDefaultsConfig(config) {
-  return resolveIssueDefaults(config);
-}
-function labelsForPhase(resolved, phaseLabel) {
-  return resolved.overrides[phaseLabel] ?? resolved.defaults;
-}
-function assertValidPhaseLabel(phaseLabel) {
-  if (typeof phaseLabel !== "string" || phaseLabel.trim() === "") {
-    throw new Error(
-      "AgentConfigOptions.issueDefaults: phase-label keys must be non-empty strings (e.g. `people:research`)."
-    );
-  }
-}
-function assertValidOverride(phaseLabel, override) {
-  if (override === null || typeof override !== "object" || Array.isArray(override)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must be an object with optional \`status\` and \`priority\` fields.`
-    );
-  }
-  const { status, priority } = override;
-  if (status === void 0 && priority === void 0) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must declare at least one of \`status\` or \`priority\`. Empty entries are rejected because they are almost always a typo on the field name.`
-    );
-  }
-  if (status !== void 0 && !VALID_STATUS_VALUES.includes(status)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"].status="${status}" is not a recognised status value. Allowed values: ${VALID_STATUS_VALUES.join(", ")}.`
-    );
-  }
-  if (priority !== void 0 && !VALID_PRIORITY_VALUES.includes(priority)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"].priority="${priority}" is not a recognised priority value. Allowed values: ${VALID_PRIORITY_VALUES.join(", ")}.`
-    );
-  }
-}
-
 // src/agent/bundles/bcm-writer.ts
 function buildBcmWriterSubAgent(paths, issueDefaults) {
   return {
@@ -19106,37 +19473,7 @@ var scanCommand = {
     ""
   ].join("\n")
 };
-var orchestratorBundle = {
-  name: "orchestrator",
-  description: "Pipeline orchestrator agent for issue triage, PR review, and queue management",
-  // Always included by default
-  appliesWhen: () => true,
-  rules: [
-    {
-      name: "orchestrator-conventions",
-      description: "Guidelines for orchestrator agent behavior and pipeline management, including the funnel-tier dispatch sort, scope gate, and per-agent scheduled-task layout",
-      scope: AGENT_RULE_SCOPE.FILE_PATTERN,
-      // Bundle defaults exclude paths into configulator's own source
-      // (only meaningful when configulator is a workspace package).
-      // codedrifters/packages restores them via
-      // `agentConfig.additionalRulePaths`.
-      filePatterns: [
-        ".claude/agents/orchestrator.md",
-        ".claude/scheduled-tasks/**"
-      ],
-      content: buildOrchestratorConventionsContent(
-        DEFAULT_AGENT_TIERS,
-        resolveScopeGate(),
-        resolveRunRatio(),
-        resolveScheduledTasks(),
-        resolveUnblockDependents()
-      ),
-      platforms: {
-        cursor: { exclude: true }
-      },
-      tags: ["workflow"]
-    }
-  ],
+var ORCHESTRATOR_BUNDLE_STATIC = {
   subAgents: [orchestratorSubAgent, issueWorkerSubAgent],
   procedures: [
     checkBlockedProcedure,
@@ -19152,6 +19489,51 @@ var orchestratorBundle = {
     ]
   }
 };
+var DEFAULT_ORCHESTRATOR_CONVENTIONS = {
+  tiers: DEFAULT_AGENT_TIERS,
+  scopeGate: resolveScopeGate(),
+  runRatio: resolveRunRatio(),
+  scheduledTasks: resolveScheduledTasks(),
+  unblockDependents: resolveUnblockDependents(),
+  excludeBundles: []
+};
+function buildOrchestratorBundle(conventions = DEFAULT_ORCHESTRATOR_CONVENTIONS) {
+  return {
+    name: "orchestrator",
+    description: "Pipeline orchestrator agent for issue triage, PR review, and queue management",
+    // Always included by default
+    appliesWhen: () => true,
+    rules: [
+      {
+        name: "orchestrator-conventions",
+        description: "Guidelines for orchestrator agent behavior and pipeline management, including the funnel-tier dispatch sort, scope gate, and per-agent scheduled-task layout",
+        scope: AGENT_RULE_SCOPE.FILE_PATTERN,
+        // Bundle defaults exclude paths into configulator's own source
+        // (only meaningful when configulator is a workspace package).
+        // codedrifters/packages restores them via
+        // `agentConfig.additionalRulePaths`.
+        filePatterns: [
+          ".claude/agents/orchestrator.md",
+          ".claude/scheduled-tasks/**"
+        ],
+        content: buildOrchestratorConventionsContent(
+          conventions.tiers,
+          conventions.scopeGate,
+          conventions.runRatio,
+          conventions.scheduledTasks,
+          conventions.unblockDependents,
+          conventions.excludeBundles
+        ),
+        platforms: {
+          cursor: { exclude: true }
+        },
+        tags: ["workflow"]
+      }
+    ],
+    ...ORCHESTRATOR_BUNDLE_STATIC
+  };
+}
+var orchestratorBundle = buildOrchestratorBundle();
 
 // src/agent/bundles/people-profile.ts
 function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
@@ -32662,6 +33044,8 @@ var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
   "  --body $'## Summary\\n\\nThe `software-profile-analyst` Phase 2 prompt does not capture the vendor pricing tier (free / paid / enterprise), which downstream consumers need for segment matching.\\n\\n## Details\\n\\n- Add a `Pricing tier` field to the profile template at `docs/src/content/docs/agents/software-profile-analyst.md`\\n- Update the Phase 2 instructions to require the field before commit\\n- Add a regression test in `bundles.test.ts`'",
   "```",
   "",
+  "The call above does **not** set the GitHub issue type \u2014 `gh issue create` cannot. Assign it immediately, in the same session, with the cross-repo GraphQL flow above (`feat:` title \u2192 **Feature**; every other prefix except `epic:` / `fix:` \u2192 **Task**). Skipping it leaves the upstream issue untyped, and nobody comes back for it later.",
+  "",
   "After filing, reference the upstream issue from any local workaround so it can be reverted once the upstream fix lands:",
   "",
   "```typescript",
@@ -33623,10 +34007,14 @@ function renderPriorityRulesSection(rules) {
 }
 
 // src/agent/bundles/index.ts
-function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, defaultAgentTier = AGENT_MODEL.BALANCED, bundleAgentTiers = /* @__PURE__ */ new Map(), prReviewPolicy = resolvePrReviewPolicy(), buildPolicy = DEFAULT_BUILD_POLICY) {
+var DEFAULT_RULE_CONVENTIONS = {
+  base: DEFAULT_BASE_CONVENTIONS,
+  orchestrator: DEFAULT_ORCHESTRATOR_CONVENTIONS
+};
+function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, defaultAgentTier = AGENT_MODEL.BALANCED, bundleAgentTiers = /* @__PURE__ */ new Map(), prReviewPolicy = resolvePrReviewPolicy(), buildPolicy = DEFAULT_BUILD_POLICY, conventions = DEFAULT_RULE_CONVENTIONS) {
   const tierFor = (bundle) => bundleAgentTiers.get(bundle) ?? defaultAgentTier;
   return [
-    buildBaseBundle(paths),
+    buildBaseBundle(paths, conventions.base),
     upstreamConfigulatorDocsBundle,
     typescriptBundle,
     vitestBundle,
@@ -33639,7 +34027,7 @@ function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAUL
     slackBundle,
     buildMeetingAnalysisBundle(tierFor("meeting-analysis")),
     agendaBundle,
-    orchestratorBundle,
+    buildOrchestratorBundle(conventions.orchestrator),
     buildPrReviewBundle(prReviewPolicy),
     buildRequirementsAnalystBundle(paths, issueDefaults),
     buildRequirementsWriterBundle(paths, issueDefaults),
@@ -34727,6 +35115,13 @@ var AgentConfig = class _AgentConfig extends Component8 {
    * credential requirement when a remote cache actually exists. The
    * getter is lazy by design — `TurboRepo` must already be attached
    * to the project when the bundles are first read.
+   *
+   * Every **config-driven convention rule** is likewise resolved here
+   * and seeded into its owning bundle, so the rule enters the rule map
+   * already carrying the consumer's settings. Rewriting those rules
+   * after the map was assembled — the previous approach — silently
+   * discarded any `ruleExtensions` append or same-name `rules`
+   * override that had already been merged in.
    */
   get pathAwareBundles() {
     if (!this.cachedBundles) {
@@ -34736,11 +35131,52 @@ var AgentConfig = class _AgentConfig extends Component8 {
         resolveDefaultAgentTier(this.options),
         resolveBundleAgentTiers(this.options),
         resolvePrReviewPolicy(this.options.prReviewPolicy),
-        resolveBuildPolicy(this.project)
+        resolveBuildPolicy(this.project),
+        this.resolvedRuleConventions
       );
     }
     return this.cachedBundles;
   }
+  /**
+   * Resolved settings for every config-driven convention rule, derived
+   * from this project's options. Consumed by `buildBuiltInBundles` so
+   * the `base` and `orchestrator` bundles seed final rule content.
+   *
+   * `excludeBundles` feeds two of these: the orchestrator's rendered
+   * tier table / scope-gate overrides / scheduled-tasks registry drop
+   * rows owned by excluded bundles, and the issue-templates rule falls
+   * back to its disabled stub once every downstream-issue-kind bundle
+   * has been excluded.
+   */
+  get resolvedRuleConventions() {
+    const excludeBundles = this.options.excludeBundles ?? [];
+    const orchestratorAssets = resolveOrchestratorAssets(
+      this.options.tiers,
+      this.options.scopeGate,
+      this.options.runRatio,
+      this.options.scheduledTasks,
+      this.options.unblockDependents,
+      excludeBundles
+    );
+    return {
+      base: {
+        progressFiles: resolveProgressFiles(this.options.progressFiles),
+        sharedEditing: resolveSharedEditing(this.options.sharedEditing),
+        temporalFraming: resolveTemporalFraming(this.options.temporalFraming),
+        skillEvals: resolveSkillEvals(this.options.skillEvals),
+        issueTemplates: resolveIssueTemplates(this.options.issueTemplates),
+        hasDownstreamIssueKindBundles: hasAnyDownstreamIssueKindBundle(excludeBundles)
+      },
+      orchestrator: {
+        tiers: orchestratorAssets.tiers,
+        scopeGate: orchestratorAssets.scopeGate,
+        runRatio: orchestratorAssets.runRatio,
+        scheduledTasks: orchestratorAssets.scheduledTasks,
+        unblockDependents: orchestratorAssets.unblockDependents,
+        excludeBundles
+      }
+    };
+  }
   /**
    * Returns the bundles that are active for this project: auto-detected
    * bundles (when `autoDetectBundles !== false`) plus force-included
@@ -34838,11 +35274,34 @@ var AgentConfig = class _AgentConfig extends Component8 {
           ).split("\n"),
           executable: true
         });
+        new TextFile4(
+          this,
+          ".claude/procedures/check-issue-template-labels.sh",
+          {
+            lines: renderIssueTemplateLabelsCheckerScript(
+              resolvedIssueTemplates
+            ).split("\n"),
+            executable: true
+          }
+        );
       }
       if (resolvedIssueTemplates.emitStarterDoc) {
         new SampleFile2(this.project, resolvedIssueTemplates.templatesPath, {
           contents: renderIssueTemplatesStarterPage(resolvedIssueTemplates)
         });
+        new TextFile4(
+          this,
+          issueTemplatesGeneratedPath(resolvedIssueTemplates.templatesPath),
+          {
+            lines: renderIssueTemplatesGeneratedPage(
+              resolvedIssueTemplates,
+              collectIssueTemplateRecipeStubs(
+                this.activeBundles,
+                resolveIssueDefaults(this.options.issueDefaults)
+              )
+            ).split("\n")
+          }
+        );
       }
     }
     const resolvedTemporalFraming = validateTemporalFramingConfig(
@@ -35032,43 +35491,10 @@ ${section}`
       }
     }
     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(
-          this.options.tiers,
-          this.options.scopeGate,
-          this.options.runRatio,
-          this.options.scheduledTasks,
-          this.options.unblockDependents,
-          excludedBundleNames
-        );
-        if (conventionsContent !== orchestratorRule.content) {
-          ruleMap.set("orchestrator-conventions", {
-            ...orchestratorRule,
-            content: conventionsContent
-          });
-        }
-      }
-    }
     const injectBundleHooks = this.options.claudeMd?.injectBundleHooks ?? true;
     const resolvedProgressFiles = resolveProgressFiles(
       this.options.progressFiles
     );
-    if (this.options.progressFiles) {
-      const progressRule = ruleMap.get("progress-file-convention");
-      if (progressRule) {
-        const progressContent = renderProgressFilesRuleContent(
-          resolvedProgressFiles
-        );
-        if (progressContent !== progressRule.content) {
-          ruleMap.set("progress-file-convention", {
-            ...progressRule,
-            content: progressContent
-          });
-        }
-      }
-    }
     if (injectBundleHooks && resolvedProgressFiles.enabled) {
       for (const [ruleName, label] of PROGRESS_FILE_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
@@ -35095,20 +35521,6 @@ ${hook}`
     const resolvedSharedEditingForRules = resolveSharedEditing(
       this.options.sharedEditing
     );
-    if (this.options.sharedEditing) {
-      const sharedEditingRule = ruleMap.get("shared-editing-safety");
-      if (sharedEditingRule) {
-        const sharedEditingContent = renderSharedEditingRuleContent(
-          resolvedSharedEditingForRules
-        );
-        if (sharedEditingContent !== sharedEditingRule.content) {
-          ruleMap.set("shared-editing-safety", {
-            ...sharedEditingRule,
-            content: sharedEditingContent
-          });
-        }
-      }
-    }
     if (injectBundleHooks && resolvedSharedEditingForRules.enabled) {
       for (const [ruleName, label] of SHARED_EDITING_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
@@ -35135,20 +35547,6 @@ ${hook}`
     const resolvedSkillEvalsForRules = resolveSkillEvals(
       this.options.skillEvals
     );
-    if (this.options.skillEvals) {
-      const skillEvalsRule = ruleMap.get("skill-evals");
-      if (skillEvalsRule) {
-        const skillEvalsContent = renderSkillEvalsRuleContent(
-          resolvedSkillEvalsForRules
-        );
-        if (skillEvalsContent !== skillEvalsRule.content) {
-          ruleMap.set("skill-evals", {
-            ...skillEvalsRule,
-            content: skillEvalsContent
-          });
-        }
-      }
-    }
     if (injectBundleHooks && resolvedSkillEvalsForRules.enabled) {
       for (const [ruleName, label] of SKILL_EVALS_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
@@ -35176,21 +35574,6 @@ ${hook}`
       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,
-          hasDownstreamBundles
-        );
-        if (issueTemplatesContent !== issueTemplatesRule.content) {
-          ruleMap.set("issue-templates-convention", {
-            ...issueTemplatesRule,
-            content: issueTemplatesContent
-          });
-        }
-      }
-    }
     if (injectBundleHooks && resolvedIssueTemplatesForRules.enabled && hasDownstreamBundles) {
       for (const [ruleName, label] of ISSUE_TEMPLATES_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
@@ -35214,23 +35597,6 @@ ${hook}`
         });
       }
     }
-    const resolvedTemporalFramingForRules = resolveTemporalFraming(
-      this.options.temporalFraming
-    );
-    if (this.options.temporalFraming) {
-      const temporalFramingRule = ruleMap.get("temporal-framing-convention");
-      if (temporalFramingRule) {
-        const temporalFramingContent = renderTemporalFramingRuleContent(
-          resolvedTemporalFramingForRules
-        );
-        if (temporalFramingContent !== temporalFramingRule.content) {
-          ruleMap.set("temporal-framing-convention", {
-            ...temporalFramingRule,
-            content: temporalFramingContent
-          });
-        }
-      }
-    }
     const tierExamples = this.options.features?.sourceTierExamples;
     if (_AgentConfig.hasActiveTierExamples(tierExamples)) {
       const sourceRule = ruleMap.get("source-quality-verification");
@@ -41455,6 +41821,7 @@ export {
   DEFAULT_API_EXTRACTOR_REPORT_FILENAME,
   DEFAULT_API_EXTRACTOR_REPORT_FOLDER,
   DEFAULT_AUDIT_REPORT_DIR,
+  DEFAULT_BASE_CONVENTIONS,
   DEFAULT_BUILD_POLICY,
   DEFAULT_BUNDLE_OVERRIDES,
   DEFAULT_DECOMPOSITION_TEMPLATE,
@@ -41471,6 +41838,7 @@ export {
   DEFAULT_ISSUE_TEMPLATES_PATH,
   DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE,
   DEFAULT_OFF_PEAK_CRON_EXAMPLE,
+  DEFAULT_ORCHESTRATOR_CONVENTIONS,
   DEFAULT_PARTIAL_UNBLOCK_COMMENT_TEMPLATE,
   DEFAULT_PATHS_EXEMPT_FROM_SIZE,
   DEFAULT_PRIORITY_LABELS,
@@ -41483,6 +41851,7 @@ export {
   DEFAULT_REQUIREMENT_CATEGORY_DIRS,
   DEFAULT_REQUIRE_PRODUCT_CONTEXT,
   DEFAULT_RESOLVED_ISSUE_DEFAULTS,
+  DEFAULT_RULE_CONVENTIONS,
   DEFAULT_SAMPLE_COMPILER_OPTIONS,
   DEFAULT_SCHEDULED_TASKS_ROOT,
   DEFAULT_SCHEDULED_TASK_ENTRIES,
@@ -41509,6 +41878,7 @@ export {
   DOCS_SYNC_AUDIT_SCHEMA_VERSION,
   GITHUB_ISSUE_TYPES,
   GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
+  ISSUE_TEMPLATES_GENERATED_SUFFIX,
   JsiiFaker,
   LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -41585,6 +41955,7 @@ export {
   buildIndustryDiscoveryBundle,
   buildMaintenanceAuditBundle,
   buildMeetingAnalysisBundle,
+  buildOrchestratorBundle,
   buildOrchestratorConventionsContent,
   buildPeopleProfileBundle,
   buildPrReviewBundle,
@@ -41604,6 +41975,7 @@ export {
   checkLinksProcedure,
   classifyIssueScope,
   classifyRun,
+  collectIssueTemplateRecipeStubs,
   companyProfileBundle,
   compileFencedSamples,
   createApiDiffCheck,
@@ -41629,6 +42001,8 @@ export {
   isScheduledTaskOwnedByExcluded,
   isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded,
+  issueTemplatesChildGlob,
+  issueTemplatesGeneratedPath,
   jestBundle,
   labelsForPhase,
   maintenanceAuditBundle,
@@ -41679,8 +42053,10 @@ export {
   renderFocusSection,
   renderGithubIssueTypeSection,
   renderGithubIssueTypeSectionLines,
+  renderIssueTemplateLabelsCheckerScript,
   renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript,
+  renderIssueTemplatesGeneratedPage,
   renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage,
   renderIssueTypeAssignmentBlanket,