@codedrifters/configulator 0.0.406 → 0.0.407

package/lib/index.js

@@ -277,6 +277,7 @@ __export(index_exports, {
   DOCS_SYNC_AUDIT_SCHEMA_VERSION: () => DOCS_SYNC_AUDIT_SCHEMA_VERSION,
   GITHUB_ISSUE_TYPES: () => GITHUB_ISSUE_TYPES,
   GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX: () => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
+  ISSUE_TEMPLATES_GENERATED_SUFFIX: () => ISSUE_TEMPLATES_GENERATED_SUFFIX,
   JsiiFaker: () => JsiiFaker,
   LAYOUT_ENFORCEMENT: () => LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE: () => LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -372,6 +373,7 @@ __export(index_exports, {
   checkLinksProcedure: () => checkLinksProcedure,
   classifyIssueScope: () => classifyIssueScope,
   classifyRun: () => classifyRun,
+  collectIssueTemplateRecipeStubs: () => collectIssueTemplateRecipeStubs,
   companyProfileBundle: () => companyProfileBundle,
   compileFencedSamples: () => compileFencedSamples,
   createApiDiffCheck: () => createApiDiffCheck,
@@ -397,6 +399,8 @@ __export(index_exports, {
   isScheduledTaskOwnedByExcluded: () => isScheduledTaskOwnedByExcluded,
   isSuppressedWorkflowRule: () => isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded: () => isTypeLabelOwnedByExcluded,
+  issueTemplatesChildGlob: () => issueTemplatesChildGlob,
+  issueTemplatesGeneratedPath: () => issueTemplatesGeneratedPath,
   jestBundle: () => jestBundle,
   labelsForPhase: () => labelsForPhase,
   maintenanceAuditBundle: () => maintenanceAuditBundle,
@@ -447,8 +451,10 @@ __export(index_exports, {
   renderFocusSection: () => renderFocusSection,
   renderGithubIssueTypeSection: () => renderGithubIssueTypeSection,
   renderGithubIssueTypeSectionLines: () => renderGithubIssueTypeSectionLines,
+  renderIssueTemplateLabelsCheckerScript: () => renderIssueTemplateLabelsCheckerScript,
   renderIssueTemplatesBundleHook: () => renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript: () => renderIssueTemplatesCheckerScript,
+  renderIssueTemplatesGeneratedPage: () => renderIssueTemplatesGeneratedPage,
   renderIssueTemplatesRuleContent: () => renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage: () => renderIssueTemplatesStarterPage,
   renderIssueTypeAssignmentBlanket: () => renderIssueTypeAssignmentBlanket,
@@ -2199,12 +2205,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;
@@ -2288,7 +2393,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`,
@@ -2359,8 +2497,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",
@@ -2391,6 +2533,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.",
       ""
     );
   }
@@ -2399,8 +2568,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;",
@@ -2431,7 +2602,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",
@@ -2466,6 +2638,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",
@@ -2505,6 +2691,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 [
@@ -2693,6 +2988,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(
@@ -5695,90 +6141,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 {
@@ -33025,6 +33387,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",
@@ -35201,11 +35565,34 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
           ).split("\n"),
           executable: true
         });
+        new import_projen8.TextFile(
+          this,
+          ".claude/procedures/check-issue-template-labels.sh",
+          {
+            lines: renderIssueTemplateLabelsCheckerScript(
+              resolvedIssueTemplates
+            ).split("\n"),
+            executable: true
+          }
+        );
       }
       if (resolvedIssueTemplates.emitStarterDoc) {
         new import_projen8.SampleFile(this.project, resolvedIssueTemplates.templatesPath, {
           contents: renderIssueTemplatesStarterPage(resolvedIssueTemplates)
         });
+        new import_projen8.TextFile(
+          this,
+          issueTemplatesGeneratedPath(resolvedIssueTemplates.templatesPath),
+          {
+            lines: renderIssueTemplatesGeneratedPage(
+              resolvedIssueTemplates,
+              collectIssueTemplateRecipeStubs(
+                this.activeBundles,
+                resolveIssueDefaults(this.options.issueDefaults)
+              )
+            ).split("\n")
+          }
+        );
       }
     }
     const resolvedTemporalFraming = validateTemporalFramingConfig(
@@ -41860,6 +42247,7 @@ export const collections = {
   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,
@@ -41955,6 +42343,7 @@ export const collections = {
   checkLinksProcedure,
   classifyIssueScope,
   classifyRun,
+  collectIssueTemplateRecipeStubs,
   companyProfileBundle,
   compileFencedSamples,
   createApiDiffCheck,
@@ -41980,6 +42369,8 @@ export const collections = {
   isScheduledTaskOwnedByExcluded,
   isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded,
+  issueTemplatesChildGlob,
+  issueTemplatesGeneratedPath,
   jestBundle,
   labelsForPhase,
   maintenanceAuditBundle,
@@ -42030,8 +42421,10 @@ export const collections = {
   renderFocusSection,
   renderGithubIssueTypeSection,
   renderGithubIssueTypeSectionLines,
+  renderIssueTemplateLabelsCheckerScript,
   renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript,
+  renderIssueTemplatesGeneratedPage,
   renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage,
   renderIssueTypeAssignmentBlanket,