@codedrifters/configulator 0.0.404 → 0.0.406

package/lib/index.mjs

@@ -280,6 +280,603 @@ function renderClaimVerificationSection() {
   ];
 }
 
+// src/agent/bundles/bundle-ownership.ts
+var BUNDLE_OWNERSHIP = {
+  agenda: {
+    typeLabels: ["agenda"],
+    phaseLabelPrefixes: ["agenda:"],
+    scheduledTaskIds: ["worker-agenda"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "bcm-writer": {
+    typeLabels: ["bcm-document"],
+    phaseLabelPrefixes: ["bcm:"],
+    scheduledTaskIds: ["worker-bcm-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "business-models": {
+    typeLabels: ["business-model"],
+    phaseLabelPrefixes: ["business-models:"],
+    scheduledTaskIds: ["worker-business-models"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "company-profile": {
+    typeLabels: ["company-profile"],
+    phaseLabelPrefixes: ["company:"],
+    scheduledTaskIds: ["worker-company-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "customer-profile": {
+    typeLabels: ["customer-profile"],
+    phaseLabelPrefixes: ["customer:"],
+    scheduledTaskIds: ["worker-customer-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "docs-sync": {
+    typeLabels: ["docs-sync"],
+    phaseLabelPrefixes: ["docs-sync:"],
+    scheduledTaskIds: ["worker-docs-sync"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "industry-discovery": {
+    typeLabels: ["industry-discovery"],
+    phaseLabelPrefixes: ["industry:"],
+    scheduledTaskIds: ["worker-industry-discovery"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "maintenance-audit": {
+    typeLabels: ["maintenance"],
+    phaseLabelPrefixes: ["maint:"],
+    scheduledTaskIds: ["worker-maintenance"],
+    emitsDocs: false,
+    downstreamIssueKinds: true
+  },
+  "meeting-analysis": {
+    typeLabels: ["meeting-processing"],
+    phaseLabelPrefixes: ["meeting:"],
+    scheduledTaskIds: ["worker-meeting-analysis"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  orchestrator: {
+    // The orchestrator pipeline manager itself ships with the
+    // `worker-orchestrator` scheduled task. It owns no `type:*` label
+    // (it dispatches every type) and no phase-label prefix.
+    typeLabels: [],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-orchestrator"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "people-profile": {
+    typeLabels: ["people-profile"],
+    phaseLabelPrefixes: ["people:"],
+    scheduledTaskIds: ["worker-people-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "pr-review": {
+    typeLabels: ["pr-review"],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-pr-review"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "regulatory-research": {
+    typeLabels: ["regulatory-research"],
+    phaseLabelPrefixes: ["regulatory:"],
+    scheduledTaskIds: ["worker-regulatory-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-analyst": {
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:"],
+    scheduledTaskIds: ["worker-requirements-analyst"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-reviewer": {
+    // Co-owns `type:requirement` with the analyst and writer; owns
+    // the `req:review` and `req:deprecate` phase labels exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:review", "req:deprecate"],
+    scheduledTaskIds: ["worker-requirements-reviewer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-writer": {
+    // Co-owns `type:requirement` with the analyst and reviewer; owns
+    // the `req:write` phase label exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:write"],
+    scheduledTaskIds: ["worker-requirements-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "research-pipeline": {
+    typeLabels: ["research"],
+    phaseLabelPrefixes: ["research:"],
+    scheduledTaskIds: ["worker-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "software-profile": {
+    typeLabels: ["software-profile"],
+    phaseLabelPrefixes: ["software:"],
+    scheduledTaskIds: ["worker-software-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "standards-research": {
+    typeLabels: ["standards-research"],
+    phaseLabelPrefixes: ["standards:"],
+    scheduledTaskIds: ["worker-standards-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  }
+};
+var CONVENTIONAL_COMMIT_TYPE_LABELS = [
+  "type:chore",
+  "type:docs",
+  "type:feat",
+  "type:fix",
+  "type:hotfix",
+  "type:refactor",
+  "type:release"
+];
+var PHASE_LABEL_TYPE_MAP = buildPhaseLabelTypeMap();
+function typeLabelForPhaseLabel(phaseLabel) {
+  const exact = PHASE_LABEL_TYPE_MAP[phaseLabel];
+  if (exact !== void 0 && !phaseLabel.endsWith(":")) {
+    return exact;
+  }
+  let bestMatcher;
+  for (const matcher of Object.keys(PHASE_LABEL_TYPE_MAP)) {
+    if (!matcher.endsWith(":")) {
+      continue;
+    }
+    if (!phaseLabel.startsWith(matcher)) {
+      continue;
+    }
+    if (bestMatcher === void 0 || matcher.length > bestMatcher.length) {
+      bestMatcher = matcher;
+    }
+  }
+  return bestMatcher === void 0 ? void 0 : PHASE_LABEL_TYPE_MAP[bestMatcher];
+}
+function resolveTypeLabelForLabels(labels) {
+  const phaseLabels = [];
+  const candidates = /* @__PURE__ */ new Set();
+  for (const label of labels) {
+    const typeLabel = typeLabelForPhaseLabel(label);
+    if (typeLabel === void 0) {
+      continue;
+    }
+    phaseLabels.push(label);
+    candidates.add(typeLabel);
+  }
+  const candidateTypeLabels = Array.from(candidates).sort();
+  if (candidateTypeLabels.length === 0) {
+    return { outcome: "none", candidateTypeLabels: [], phaseLabels: [] };
+  }
+  if (candidateTypeLabels.length === 1) {
+    return {
+      outcome: "match",
+      typeLabel: candidateTypeLabels[0],
+      candidateTypeLabels,
+      phaseLabels
+    };
+  }
+  return { outcome: "ambiguous", candidateTypeLabels, phaseLabels };
+}
+function renderPhaseTypeInvariantSection(excludeBundles = []) {
+  const rows = Object.keys(PHASE_LABEL_TYPE_MAP).filter(
+    (matcher) => !isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles)
+  ).sort().map((matcher) => {
+    const display = matcher.endsWith(":") ? `${matcher}*` : matcher;
+    const kind = matcher.endsWith(":") ? "prefix" : "exact";
+    return `| \`${display}\` | ${kind} | \`${PHASE_LABEL_TYPE_MAP[matcher]}\` |`;
+  });
+  return [
+    "## Phase-label \u2192 `type:<bundle>` invariant",
+    "",
+    "Every phased-pipeline bundle pairs its `<bundle>:<phase>` labels",
+    "with exactly one `type:<bundle>` label. That type label is the",
+    "**dedup + dispatch signal**: agents de-duplicate downstream work",
+    'with `gh issue list --label "type:<bundle>"`, and Phase E derives',
+    "its funnel-tier sort key from the issue's `type:*` label. An issue",
+    "that carries the phase label but a conventional-commit `type:*`",
+    "(`type:feat`, `type:docs`, \u2026, stamped from its title prefix by the",
+    "generic create-issue workflow) is invisible to that dedup query and",
+    "mis-tiers in dispatch.",
+    "",
+    "The pairing below is derived from the canonical bundle-ownership",
+    "map \u2014 the same source of truth that generates the label registry.",
+    "Matchers ending in `*` match by prefix; the rest match exactly, and",
+    "an exact match always beats a prefix match.",
+    "",
+    "| Phase label | Match | Required type label |",
+    "|-------------|-------|---------------------|",
+    ...rows,
+    "",
+    "### Enforcement",
+    "",
+    "The Phase D maintenance sweep runs the invariant in auto-correct",
+    "mode and emits one summary line:",
+    "",
+    "```",
+    "LABEL_INVARIANT_DONE mode=fix checked=<N> ok=<O> violations=<V> corrected=<C> flagged=<F>",
+    "```",
+    "",
+    "A **report-only** audit is available for repos that prefer",
+    "report-then-fix over auto-correct \u2014 same sweep, no mutations:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh label-invariant        # report only",
+    ".claude/procedures/check-blocked.sh label-invariant --fix  # apply",
+    "```",
+    "",
+    "### Correction policy",
+    "",
+    "An issue must carry **exactly one** `type:*` label. Merely *adding*",
+    "the required type label to an issue that already carries a",
+    "conventional-commit one would leave two, making the funnel-tier sort",
+    "key (which reads the **first** `type:*` label) non-deterministic and",
+    "violating the label conventions. The correction therefore",
+    "**replaces**, in a single atomic `gh issue edit`, so the issue is",
+    "never observable carrying two `type:*` labels:",
+    "",
+    "| Issue state | Action |",
+    "|-------------|--------|",
+    "| Required type label present, nothing else | none \u2014 compliant, left untouched |",
+    "| No `type:*` label at all | **add** the required label |",
+    "| Only conventional-commit `type:*` label(s) | **replace** \u2014 remove them, add the required label |",
+    "| Required label present **plus** a stray conventional-commit one | **remove** the stray, leaving exactly one |",
+    "| A `type:*` label owned by a **different** bundle | **flag** `status:needs-attention` \u2014 never guessed at |",
+    "| Phase labels imply **two or more** type labels | **flag** `status:needs-attention` \u2014 never auto-corrected |",
+    "",
+    "Only a conventional-commit `type:*` label is ever removed. A",
+    "`type:*` label owned by another bundle carries real routing",
+    "information, so the sweep refuses to guess and hands the issue to a",
+    "human instead. Ambiguity is narrower than it looks: all three",
+    "requirements bundles declare `type:requirement`, so every `req:*`",
+    "phase label resolves to the same type label \u2014 genuine ambiguity",
+    "needs phase labels from two bundles with *different* type labels.",
+    "",
+    "`status:needs-attention` is applied **additively** \u2014 the base",
+    "`status:*` label always stays, per the additive-flag rule. Flagging",
+    "is idempotent: an issue already carrying the flag is reported but",
+    "not re-flagged."
+  ].join("\n");
+}
+function isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles) {
+  if (excludeBundles.length === 0) {
+    return false;
+  }
+  let owned = false;
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.phaseLabelPrefixes.includes(matcher)) {
+      continue;
+    }
+    owned = true;
+    if (!excludeBundles.includes(bundleName)) {
+      return false;
+    }
+  }
+  return owned;
+}
+function renderPhaseTypeInvariantShellHelpers() {
+  const matchers = Object.keys(PHASE_LABEL_TYPE_MAP);
+  const exactMatchers = matchers.filter((m) => !m.endsWith(":")).sort();
+  const prefixMatchers = matchers.filter((m) => m.endsWith(":")).sort((a, b) => b.length - a.length || a.localeCompare(b));
+  const lines = [
+    "# Resolve ONE phase label to the `type:<bundle>` label its owning",
+    "# bundle declares. Echoes the label (with the `type:` prefix) or",
+    "# nothing when no bundle owns it. Exact-match branches come first,",
+    "# so `req:write` (requirements-writer) beats the `req:` prefix",
+    "# (requirements-analyst). Generated from BUNDLE_OWNERSHIP \u2014 do not",
+    "# hand-edit.",
+    "phase_label_type_of() {",
+    '  case "${1:-}" in'
+  ];
+  for (const matcher of exactMatchers) {
+    lines.push(`    ${matcher}) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
+  }
+  for (const matcher of prefixMatchers) {
+    lines.push(`    ${matcher}*) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
+  }
+  lines.push(
+    "    *) : ;;",
+    "  esac",
+    "}",
+    "",
+    "# Return 0 when the argument is a conventional-commit `type:*`",
+    "# label \u2014 the ONLY type labels the invariant correction may remove.",
+    "# A `type:*` label owned by another bundle is never removed; the",
+    "# issue is flagged for human triage instead.",
+    "is_conventional_type_label() {",
+    `  case "\${1:-}" in`,
+    `    ${CONVENTIONAL_COMMIT_TYPE_LABELS.join("|")}) return 0 ;;`,
+    "    *) return 1 ;;",
+    "  esac",
+    "}",
+    "",
+    "# Resolve an issue's FULL label list (one label per line on stdin)",
+    "# to the type label the phase-label invariant requires. Emits",
+    "# KEY=VALUE assignments the caller parses:",
+    "#   OUTCOME=none      \u2014 no recognised phase label; invariant N/A",
+    "#   OUTCOME=match     \u2014 plus TYPE_LABEL=<type:bundle>",
+    "#   OUTCOME=ambiguous \u2014 plus CANDIDATE_TYPE_LABELS=<space-separated>",
+    "#   PHASE_LABELS=<space-separated recognised phase labels>",
+    "phase_type_of() {",
+    "  local label resolved",
+    '  local matched_types=""',
+    '  local matched_phase=""',
+    "  while IFS= read -r label; do",
+    '    [ -z "$label" ] && continue',
+    '    resolved=$(phase_label_type_of "$label")',
+    '    [ -z "$resolved" ] && continue',
+    '    matched_phase="${matched_phase}${label} "',
+    '    case " ${matched_types} " in',
+    '      *" ${resolved} "*) ;;',
+    '      *) matched_types="${matched_types}${resolved} " ;;',
+    "    esac",
+    "  done",
+    "  local count=0",
+    "  for resolved in $matched_types; do",
+    "    count=$((count + 1))",
+    "  done",
+    '  if [ "$count" -eq 0 ]; then',
+    '    echo "OUTCOME=none"',
+    '  elif [ "$count" -eq 1 ]; then',
+    '    echo "OUTCOME=match"',
+    '    echo "TYPE_LABEL=${matched_types% }"',
+    "  else",
+    '    echo "OUTCOME=ambiguous"',
+    '    echo "CANDIDATE_TYPE_LABELS=${matched_types% }"',
+    "  fi",
+    '  echo "PHASE_LABELS=${matched_phase% }"',
+    "}"
+  );
+  return lines.join("\n");
+}
+function buildPhaseLabelTypeMap() {
+  const map = {};
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (ownership.phaseLabelPrefixes.length === 0) {
+      continue;
+    }
+    if (ownership.typeLabels.length !== 1) {
+      throw new Error(
+        `BUNDLE_OWNERSHIP["${bundleName}"] declares ${ownership.phaseLabelPrefixes.length} phase-label matcher(s) but ${ownership.typeLabels.length} type label(s); a phase label must pair with exactly one type label`
+      );
+    }
+    const typeLabel = `type:${ownership.typeLabels[0]}`;
+    for (const matcher of ownership.phaseLabelPrefixes) {
+      const existing = map[matcher];
+      if (existing !== void 0 && existing !== typeLabel) {
+        throw new Error(
+          `Phase-label matcher "${matcher}" resolves to both "${existing}" and "${typeLabel}"; a matcher must imply exactly one type label`
+        );
+      }
+      map[matcher] = typeLabel;
+    }
+  }
+  return map;
+}
+function isTypeLabelOwnedByExcluded(typeLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.typeLabels.includes(typeLabel)) {
+      const owners = findOwnersOfTypeLabel(typeLabel);
+      const allExcluded = owners.every(
+        (owner) => excludedBundles.includes(owner)
+      );
+      if (allExcluded) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isPhaseLabelOwnedByExcluded(phaseLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    for (const entry of ownership.phaseLabelPrefixes) {
+      if (entry.endsWith(":")) {
+        if (phaseLabel.startsWith(entry)) {
+          return true;
+        }
+      } else if (phaseLabel === entry) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isScheduledTaskOwnedByExcluded(taskId, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.scheduledTaskIds.includes(taskId)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDocsEmittingBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.emitsDocs) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDownstreamIssueKindBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.downstreamIssueKinds) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function findOwnersOfTypeLabel(typeLabel) {
+  const owners = [];
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (ownership.typeLabels.includes(typeLabel)) {
+      owners.push(bundleName);
+    }
+  }
+  return owners;
+}
+
+// src/agent/bundles/issue-type.ts
+var GITHUB_ISSUE_TYPES = ["Epic", "Feature", "Bug", "Task"];
+var DEFAULT_GITHUB_ISSUE_TYPE = "Task";
+var NON_DEFAULT_TITLE_PREFIX_TYPES = {
+  "epic:": "Epic",
+  "feat:": "Feature",
+  "fix:": "Bug"
+};
+var GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX = buildTitlePrefixTypeMap();
+function githubIssueTypeForTitle(title) {
+  const colon = title.indexOf(":");
+  if (colon === -1) {
+    return DEFAULT_GITHUB_ISSUE_TYPE;
+  }
+  const prefix2 = title.slice(0, colon + 1).trim().toLowerCase();
+  return GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] ?? DEFAULT_GITHUB_ISSUE_TYPE;
+}
+var SET_ISSUE_TYPE_HELPER_PATH = ".claude/procedures/set-issue-type.sh";
+function renderSetIssueTypeFallbackLines() {
+  return [
+    "```bash",
+    "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=<owner> -f repo=<repo>",
+    "gh issue view <issue-number> --json id --jq '.id'",
+    "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+    "```"
+  ];
+}
+function renderGithubIssueTypeSectionLines() {
+  const defaultPrefixes = Object.keys(GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX).filter(
+    (prefix2) => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] === DEFAULT_GITHUB_ISSUE_TYPE
+  ).sort().map((prefix2) => `\`${prefix2}\``).join(", ");
+  return [
+    "## GitHub Issue Type",
+    "",
+    "A GitHub **issue type** is a distinct field from the `type:*` **label**:",
+    "the label routes and dedups, the issue type drives triage and Epic",
+    "tracking. Setting one does not set the other. Derive it from the",
+    "**title prefix**:",
+    "",
+    "| Prefix | GitHub Issue Type |",
+    "|--------|------------------|",
+    "| `epic:` | Epic |",
+    "| `feat:` | Feature |",
+    "| `fix:` | Bug |",
+    `| ${defaultPrefixes} | ${DEFAULT_GITHUB_ISSUE_TYPE} |`,
+    "| any bundle-phase prefix (`company:`, `req:`, \u2026), or no prefix | Task |",
+    "",
+    "### Assigning the GitHub issue type",
+    "",
+    "`gh issue create` **cannot** set the issue type \u2014 there is no `--type`",
+    "flag \u2014 so assign it in a follow-up call immediately after creation, for",
+    "every issue an agent files (auto-enqueued downstream issues included).",
+    "An issue that skips that call stays untyped forever. The",
+    "`github-workflow` bundle ships a one-step helper:",
+    "",
+    "```bash",
+    `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> <${GITHUB_ISSUE_TYPES.join("|")}>`,
+    "```",
+    "",
+    "When that helper is absent (the bundle is excluded), run the",
+    "`updateIssueIssueType` GraphQL flow it wraps:",
+    "",
+    ...renderSetIssueTypeFallbackLines()
+  ];
+}
+function renderTitlePrefixTypeBullets(indent = "   ") {
+  const nonDefault = Object.entries(NON_DEFAULT_TITLE_PREFIX_TYPES).map(
+    ([prefix2, issueType]) => `${indent}- \`${prefix2}\` \u2192 ${issueType}`
+  );
+  const defaults = Object.keys(GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX).filter(
+    (prefix2) => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] === DEFAULT_GITHUB_ISSUE_TYPE
+  ).sort().map((prefix2) => `\`${prefix2}\``).join(", ");
+  return [
+    ...nonDefault,
+    `${indent}- ${defaults} \u2192 ${DEFAULT_GITHUB_ISSUE_TYPE}`,
+    `${indent}- any bundle-phase prefix (\`company:\`, \`req:\`, \`bcm:\`, \u2026) \u2192 ${DEFAULT_GITHUB_ISSUE_TYPE}`
+  ];
+}
+function renderGithubIssueTypeSection() {
+  return renderGithubIssueTypeSectionLines().join("\n");
+}
+function renderIssueTypeAssignmentStep(options = {}) {
+  const indent = options.indent ?? "   ";
+  const issueType = options.issueType ?? DEFAULT_GITHUB_ISSUE_TYPE;
+  const lead = options.bullet ? `${indent}- ` : indent;
+  const cont = options.bullet ? `${indent}  ` : indent;
+  return [
+    `${lead}Then assign the new issue's **GitHub issue type** (\`${issueType}\`) \u2014`,
+    `${cont}the \`type:*\` label does not set it:`,
+    `${cont}\`${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${issueType}\`. See`,
+    `${cont}**Assigning the GitHub issue type** for the no-helper fallback.`
+  ];
+}
+function renderIssueTypeAssignmentBlanket(indent = "", issueType = DEFAULT_GITHUB_ISSUE_TYPE) {
+  return [
+    `${indent}**Every** issue this phase files needs a **GitHub issue type**`,
+    `${indent}assigned right after creation \u2014 the \`type:*\` label does not set`,
+    `${indent}it, and \`gh issue create\` cannot:`,
+    `${indent}\`${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${issueType}\`. See`,
+    `${indent}**Assigning the GitHub issue type** for the prefix table (nearly`,
+    `${indent}every downstream issue is a \`${issueType}\`) and the no-helper fallback.`
+  ];
+}
+function buildTitlePrefixTypeMap() {
+  const map = {};
+  for (const label of CONVENTIONAL_COMMIT_TYPE_LABELS) {
+    map[`${label.slice("type:".length)}:`] = DEFAULT_GITHUB_ISSUE_TYPE;
+  }
+  for (const [prefix2, issueType] of Object.entries(
+    NON_DEFAULT_TITLE_PREFIX_TYPES
+  )) {
+    map[prefix2] = issueType;
+  }
+  return map;
+}
+
 // src/agent/bundles/project-context.ts
 var PROJECT_CONTEXT_PATH = "docs/src/content/docs/project-context.md";
 var SUBPROJECT_ROLE_GUIDANCE = [
@@ -872,6 +1469,9 @@ var draftAgendaSkill = {
     '   - `desired_outcomes` \u2014 1\u20133 bullets describing "done"',
     "   - `pre_reads` \u2014 relative paths to existing docs (optional)",
     "   - `related_docs` \u2014 relative paths for context (optional)",
+    "",
+    ...renderIssueTypeAssignmentStep(),
+    "",
     "2. Execute Phase 1 (Draft) of the agenda-analyst agent.",
     "3. If the draft phase inline-finalizes (default path), no",
     "   downstream issues are created.",
@@ -936,6 +1536,9 @@ var finalizeAgendaSkill = {
     "   - Path to the draft agenda",
     "     (`<meetingsRoot>/<YYYY-MM-DD>-<slug>/agenda.md`)",
     "   - Any late-added items to incorporate",
+    "",
+    ...renderIssueTypeAssignmentStep(),
+    "",
     "2. Execute Phase 2 (Finalize) of the agenda-analyst agent.",
     "",
     "## Output",
@@ -1481,6 +2084,14 @@ function renderIssueTemplatesStarterPage(_it) {
     "`status:*` label from the conventions documented in the",
     "`issue-label-conventions` rule.",
     "",
+    "Every recipe also ends with a **GitHub issue type** assignment.",
+    "`gh issue create` cannot set the issue type, so it takes a second",
+    "call \u2014 an issue that skips it stays untyped forever. Derive the type",
+    "from the title prefix (`epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192",
+    "Bug, everything else \u2014 including every bundle-phase prefix \u2014 \u2192",
+    "Task); see **Assigning the GitHub issue type** in the",
+    "`issue-conventions` rule for the command and its fallback.",
+    "",
     "Before creating any profile-style issue (people, companies,",
     "software), run the duplicate check documented in the owning",
     "bundle's rule \u2014 the issue-templates page is a recipe catalogue,",
@@ -1515,6 +2126,13 @@ function renderIssueTemplatesStarterPage(_it) {
     "- [ ] <criterion 1>",
     "- [ ] <criterion 2>",
     '"',
+    "```",
+    "",
+    "Then assign the GitHub issue type (`Task` for a phase-labelled",
+    "title):",
+    "",
+    "```bash",
+    `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${DEFAULT_GITHUB_ISSUE_TYPE}`,
     "```"
   ].join("\n");
 }
@@ -4619,16 +5237,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
           "| `release:` | Release preparation, version bumps |",
           "| `hotfix:` | Urgent production fixes |",
           "",
-          "## GitHub Issue Type",
-          "",
-          "When creating issues, always assign the appropriate **GitHub issue type** based on the title prefix:",
-          "",
-          "| Prefix | GitHub Issue Type |",
-          "|--------|------------------|",
-          "| `epic:` | Epic |",
-          "| `feat:` | Feature |",
-          "| `fix:` | Bug |",
-          "| `chore:`, `docs:`, `refactor:`, `release:`, `hotfix:` | Task |",
+          ...renderGithubIssueTypeSectionLines(),
           "",
           "## Prerequisite Issues",
           "",
@@ -5318,6 +5927,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   **Unfamiliar company (enabling vendor, partner, competitor).**",
       "   Hand off to the `company-profile` bundle by creating a",
       "   `company:research` issue. The issue must carry:",
@@ -5327,6 +5938,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   **Missing research topic (value stream, market sizing, etc.).**",
       "   Hand off to the `research-pipeline` bundle by creating a",
       "   `research:scope` issue. The issue must carry:",
@@ -5336,6 +5949,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "research:scope").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "research:scope").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   This phase assumes the `people-profile`, `company-profile`, and",
       "   `research-pipeline` bundles are enabled in the consuming project.",
       "   If a bundle is not enabled, flag the connect issue with",
@@ -5458,6 +6073,8 @@ function buildWriteBcmSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "bcm:outline").priority}\`, and \`status:${labelsForPhase(issueDefaults, "bcm:outline").status}\`. Body must include the`,
       "   verbatim capability name and any overrides.",
       "",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Outline) of the bcm-writer agent.",
       "",
       "3. Phase 1 creates a `bcm:scaffold` issue, which Phase 2 follows with",
@@ -6744,6 +7361,8 @@ function buildScanBusinessModelsSkill(paths, issueDefaults) {
       "1. Create a `business-models:scan` issue with `type:business-model`,",
       `   \`priority:${labelsForPhase(issueDefaults, "business-models:scan").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:scan").status}\`. The body must include the`,
       "   industry slug, the source plan path (if any), and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the business-models-analyst agent.",
       "3. Phase 1 creates one `business-models:canvas` issue per in-scope",
       "   segment. Each canvas issue declares its `Depends on:`",
@@ -6818,6 +7437,8 @@ function buildCanvasBusinessModelSkill(paths, issueDefaults) {
       `   \`type:business-model\`, \`priority:${labelsForPhase(issueDefaults, "business-models:canvas").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:canvas").status}\`.`,
       "   The body must include the industry slug, segment slug, and any",
       "   scan-report reference.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Canvas) of the business-models-analyst agent.",
       "3. Phase 2 writes the nine-block canvas and creates a",
       "   `business-models:complete` issue for the downstream Phase 3.",
@@ -6877,6 +7498,8 @@ function buildCompleteBusinessModelSkill(paths, issueDefaults) {
       "1. Create a `business-models:complete` issue with",
       `   \`type:business-model\`, \`priority:${labelsForPhase(issueDefaults, "business-models:complete").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:complete").status}\`.`,
       "   Body must include the canvas document path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Complete) of the business-models-analyst agent.",
       "",
       "## Output",
@@ -7401,6 +8024,8 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this company profile",
       "     (`Discovered while profiling: <company name>`)",
@@ -7418,6 +8043,8 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "software:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this company profile",
       "     (`Discovered while profiling: <company name>`)",
@@ -7969,6 +8596,8 @@ function buildProfileCompanySkill(paths, issueDefaults) {
       "1. Create a `company:research` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:research").status}\`. Body must include the`,
       "   company name, selected type, framing, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the company-profile-analyst agent.",
       "3. Phase 1 creates the `company:draft` issue. Phase 2 may create a",
       "   `company:followup` issue **and** a `company:match` issue. Each",
@@ -8043,6 +8672,8 @@ function buildMatchCompanySkill(paths, issueDefaults) {
       "1. Create a `company:match` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:match").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:match").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Match) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8116,6 +8747,8 @@ function buildRefreshCompanySkill(paths, issueDefaults) {
       "1. Create a `company:refresh` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:refresh").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:refresh").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 5 (Refresh) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8189,6 +8822,8 @@ function buildAnalyzeSegmentSkill(paths, issueDefaults) {
       "1. Create a `company:analyze` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:analyze").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:analyze").status}\`. Body must include the`,
       "   segment slug and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 6 (Analyze) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8777,6 +9412,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Create `people:research` issues** for notable contacts",
       "   (economic buyers, technical buyers, user champions) surfaced in",
       "   sources. Keep the list small \u2014 at most three individuals per",
@@ -8788,6 +9425,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "10. **Verify all handoffs were created** before committing.",
       "",
       "11. **Commit and push** the archetype page. Close the profile issue.",
@@ -8889,6 +9528,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "req:scan").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must also:",
       "   - Link back to the archetype page and the competitor page",
       "   - Cite the specific unmet-need row and the originating job",
@@ -8905,6 +9546,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Create `people:research` issues** for notable competitor",
       "   leadership or customer-advocacy figures surfaced in the analysis.",
       "   Keep this list small \u2014 at most three individuals per competitors",
@@ -8916,6 +9559,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "10. **Commit and push** the competitor-analysis page and the",
       "    updated archetype page. Close the competitors issue.",
       "",
@@ -9102,6 +9747,8 @@ function buildDiscoverCustomersSkill(paths, issueDefaults) {
       "1. Create a `customer:discover` issue with `type:customer-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "customer:discover").priority}\`, and \`status:${labelsForPhase(issueDefaults, "customer:discover").status}\`. The body must include the`,
       "   scope slug and any known archetypes to include or exclude.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Discover) of the customer-profile-analyst agent.",
       "3. Phase 1 writes the discovery report and creates one",
       "   `customer:profile` issue per prioritized archetype.",
@@ -9177,6 +9824,8 @@ function buildProfileCustomerSkill(paths, issueDefaults) {
       "1. Create a `customer:profile` issue with `type:customer-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "customer:profile").priority}\`, and \`status:${labelsForPhase(issueDefaults, "customer:profile").status}\`. The body must include the`,
       "   archetype slug and (optionally) the segment slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Profile) of the customer-profile-analyst agent.",
       "   The agent runs 4\u20138 targeted web searches and populates the",
       "   archetype page.",
@@ -9253,6 +9902,8 @@ function buildAnalyzeCustomerCompetitorsSkill(paths, issueDefaults) {
       `   \`status:${labelsForPhase(issueDefaults, "customer:competitors").status}\` (or \`status:blocked\` when still dependent on a`,
       "   Phase 2 profile issue). Body must include the archetype page",
       "   path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Competitors) of the customer-profile-analyst",
       "   agent. The agent reads `<MATRIX_FILE>` and runs up to 4\u20138 web",
       "   searches only to close competitor-coverage gaps the matrix does",
@@ -10962,10 +11613,7 @@ function buildGithubWorkflowBundle(buildPolicy = DEFAULT_BUILD_POLICY) {
           "   - If unclear, ask the user which type applies",
           "2. **Compose the issue title** in the format: `<type>: <short description>`",
           "3. **Determine the GitHub issue type** based on the prefix:",
-          "   - `epic:` \u2192 Epic",
-          "   - `feat:` \u2192 Feature",
-          "   - `fix:` \u2192 Bug",
-          "   - `chore:`, `docs:`, `refactor:`, `release:`, `hotfix:` \u2192 Task",
+          ...renderTitlePrefixTypeBullets(),
           "4. **Identify prerequisite issues** \u2014 if the user mentions dependencies or blockers, include a **Dependencies** section in the body with `Depends on: #<issue-number>`",
           "5. **Determine labels** \u2014 every issue must be created with the following labels:",
           "   - **`type:*`** \u2014 derived from the issue title prefix:",
@@ -11451,6 +12099,7 @@ function buildIndustryDiscoveryAnalystSubAgent(paths, issueDefaults) {
       "     downstream research needs to answer)",
       "   - Cite the evaluation row that justified advancing the vertical",
       "   - Reference the plan file path for traceability",
+      ...renderIssueTypeAssignmentStep({ indent: "   ", bullet: true }),
       "",
       "5. **Cross-link** \u2014 update the plan file's `## Cleared Verticals`",
       "   table so each row references its newly-created `research:scope`",
@@ -11541,6 +12190,8 @@ function buildDiscoverIndustriesSkill(paths, issueDefaults) {
       "1. Create an `industry:discover` issue with `type:industry-discovery`,",
       `   \`priority:${labelsForPhase(issueDefaults, "industry:discover").priority}\`, and \`status:${labelsForPhase(issueDefaults, "industry:discover").status}\`. Body must include the`,
       "   verbatim scope, authorized sources, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Discover) of the industry-discovery-analyst",
       "   agent.",
       "3. Phase 1 creates an `industry:evaluate` issue, which Phase 2 follows",
@@ -11819,6 +12470,8 @@ function buildMaintenanceAuditSubAgent(paths, tier) {
       "4. Commit, push, open a PR (if applicable), and close the issue per",
       "   your project's PR workflow.",
       "",
+      ...renderIssueTypeAssignmentBlanket(),
+      "",
       "---",
       "",
       ...renderClaimVerificationSection(),
@@ -12251,6 +12904,8 @@ function buildMaintenanceAuditSkill(paths, issueDefaults) {
       "   - `<AUDIT_ROOT>` \u2014 where to write the audit report",
       "   - `<AUDIT_SLUG>` \u2014 short identifier for this audit",
       "   - The audit checks to run (defaults to the full check catalog)",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the maintenance-audit agent.",
       "3. If auto-fixable findings exist, a `maint:fix` issue is created",
       "   automatically.",
@@ -12315,6 +12970,8 @@ function buildMaintenanceVerifySkill(issueDefaults) {
       "   - The Phase 2 fix report path (if one exists)",
       "   - The `Paths Touched` list (copied from the fix report)",
       "   - The audit check catalog (copied from the scan issue)",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Verify) of the maintenance-audit agent.",
       "",
       "## Output",
@@ -12824,6 +13481,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
       "     was created, otherwise blocked on the notes issue",
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit the extraction content first.** Stage and commit",
       "   the `insights/{type}/<basename>.md` file (and any newly",
       "   created `insights/index.md` / `insights/{type}/index.md`",
@@ -13023,6 +13682,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "### Steps",
       "",
+      ...renderIssueTypeAssignmentBlanket(),
+      "",
       "1. Read the drafts from Phase 3 (if they exist) and the extraction",
       "   from Phase 1 at `<meetingsRoot>/insights/{type}/<basename>.md`.",
       "   Re-read the extraction frontmatter for `meeting_kind` and `areas`,",
@@ -13185,6 +13846,8 @@ var processMeetingSkill = {
     "   - `meeting:notes` issue (always)",
     "   - `meeting:draft` issue (if requirements or decisions were found)",
     "   - `meeting:link` issue (always)",
+    "",
+    ...renderIssueTypeAssignmentStep(),
     "5. Each downstream issue includes `Depends on:` linking to its predecessor",
     "6. Commit and push the extraction file",
     "",
@@ -13482,238 +14145,6 @@ function assertValidStateFilePath(stateFilePath) {
   }
 }
 
-// src/agent/bundles/bundle-ownership.ts
-var BUNDLE_OWNERSHIP = {
-  agenda: {
-    typeLabels: ["agenda"],
-    phaseLabelPrefixes: ["agenda:"],
-    scheduledTaskIds: ["worker-agenda"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "bcm-writer": {
-    typeLabels: ["bcm-document"],
-    phaseLabelPrefixes: ["bcm:"],
-    scheduledTaskIds: ["worker-bcm-writer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "business-models": {
-    typeLabels: ["business-model"],
-    phaseLabelPrefixes: ["business-models:"],
-    scheduledTaskIds: ["worker-business-models"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "company-profile": {
-    typeLabels: ["company-profile"],
-    phaseLabelPrefixes: ["company:"],
-    scheduledTaskIds: ["worker-company-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "customer-profile": {
-    typeLabels: ["customer-profile"],
-    phaseLabelPrefixes: ["customer:"],
-    scheduledTaskIds: ["worker-customer-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "docs-sync": {
-    typeLabels: ["docs-sync"],
-    phaseLabelPrefixes: ["docs-sync:"],
-    scheduledTaskIds: ["worker-docs-sync"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "industry-discovery": {
-    typeLabels: ["industry-discovery"],
-    phaseLabelPrefixes: ["industry:"],
-    scheduledTaskIds: ["worker-industry-discovery"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "maintenance-audit": {
-    typeLabels: ["maintenance"],
-    phaseLabelPrefixes: ["maint:"],
-    scheduledTaskIds: ["worker-maintenance"],
-    emitsDocs: false,
-    downstreamIssueKinds: true
-  },
-  "meeting-analysis": {
-    typeLabels: ["meeting-processing"],
-    phaseLabelPrefixes: ["meeting:"],
-    scheduledTaskIds: ["worker-meeting-analysis"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  orchestrator: {
-    // The orchestrator pipeline manager itself ships with the
-    // `worker-orchestrator` scheduled task. It owns no `type:*` label
-    // (it dispatches every type) and no phase-label prefix.
-    typeLabels: [],
-    phaseLabelPrefixes: [],
-    scheduledTaskIds: ["worker-orchestrator"],
-    emitsDocs: false,
-    downstreamIssueKinds: false
-  },
-  "people-profile": {
-    typeLabels: ["people-profile"],
-    phaseLabelPrefixes: ["people:"],
-    scheduledTaskIds: ["worker-people-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "pr-review": {
-    typeLabels: ["pr-review"],
-    phaseLabelPrefixes: [],
-    scheduledTaskIds: ["worker-pr-review"],
-    emitsDocs: false,
-    downstreamIssueKinds: false
-  },
-  "regulatory-research": {
-    typeLabels: ["regulatory-research"],
-    phaseLabelPrefixes: ["regulatory:"],
-    scheduledTaskIds: ["worker-regulatory-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-analyst": {
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:"],
-    scheduledTaskIds: ["worker-requirements-analyst"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-reviewer": {
-    // Co-owns `type:requirement` with the analyst and writer; owns
-    // the `req:review` and `req:deprecate` phase labels exactly.
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:review", "req:deprecate"],
-    scheduledTaskIds: ["worker-requirements-reviewer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-writer": {
-    // Co-owns `type:requirement` with the analyst and reviewer; owns
-    // the `req:write` phase label exactly.
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:write"],
-    scheduledTaskIds: ["worker-requirements-writer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "research-pipeline": {
-    typeLabels: ["research"],
-    phaseLabelPrefixes: ["research:"],
-    scheduledTaskIds: ["worker-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "software-profile": {
-    typeLabels: ["software-profile"],
-    phaseLabelPrefixes: ["software:"],
-    scheduledTaskIds: ["worker-software-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "standards-research": {
-    typeLabels: ["standards-research"],
-    phaseLabelPrefixes: ["standards:"],
-    scheduledTaskIds: ["worker-standards-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  }
-};
-function isTypeLabelOwnedByExcluded(typeLabel, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    if (ownership.typeLabels.includes(typeLabel)) {
-      const owners = findOwnersOfTypeLabel(typeLabel);
-      const allExcluded = owners.every(
-        (owner) => excludedBundles.includes(owner)
-      );
-      if (allExcluded) {
-        return true;
-      }
-    }
-  }
-  return false;
-}
-function isPhaseLabelOwnedByExcluded(phaseLabel, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    for (const entry of ownership.phaseLabelPrefixes) {
-      if (entry.endsWith(":")) {
-        if (phaseLabel.startsWith(entry)) {
-          return true;
-        }
-      } else if (phaseLabel === entry) {
-        return true;
-      }
-    }
-  }
-  return false;
-}
-function isScheduledTaskOwnedByExcluded(taskId, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    if (ownership.scheduledTaskIds.includes(taskId)) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasAnyDocsEmittingBundle(excludedBundles) {
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (!ownership.emitsDocs) {
-      continue;
-    }
-    if (!excludedBundles.includes(bundleName)) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasAnyDownstreamIssueKindBundle(excludedBundles) {
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (!ownership.downstreamIssueKinds) {
-      continue;
-    }
-    if (!excludedBundles.includes(bundleName)) {
-      return true;
-    }
-  }
-  return false;
-}
-function findOwnersOfTypeLabel(typeLabel) {
-  const owners = [];
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (ownership.typeLabels.includes(typeLabel)) {
-      owners.push(bundleName);
-    }
-  }
-  return owners;
-}
-
 // src/agent/bundles/scheduled-tasks.ts
 var SCHEDULED_TASK_MODEL_VALUES = ["opus", "sonnet", "haiku"];
 var SCHEDULED_TASK_KIND_VALUES = ["issue-worker", "pipeline"];
@@ -15669,6 +16100,7 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
     "#   .claude/procedures/check-blocked.sh maintenance",
     "#   .claude/procedures/check-blocked.sh prs",
     "#   .claude/procedures/check-blocked.sh scope <issue-number>",
+    "#   .claude/procedures/check-blocked.sh label-invariant [--fix]",
     "",
     "set -uo pipefail",
     "",
@@ -15718,6 +16150,8 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
     "",
     scopeHelperIndented,
     "",
+    renderPhaseTypeInvariantShellHelpers(),
+    "",
     ...renderDelegationActiveSignalsHelper(),
     "",
     "# \u2500\u2500 subcommands \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
@@ -16353,16 +16787,43 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
     "    esac",
     '  done <<< "$lease_output"',
     "",
+    "  # \u2500\u2500 phase-label \u2192 type:<bundle> invariant (MUTATING) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "  # Run the label-invariant sweep in --fix mode and surface its",
+    "  # per-issue lines for log visibility. cmd_label_invariant applies",
+    "  # the label edits itself (a single atomic remove+add per issue, so",
+    "  # an issue is never observable carrying two type:* labels) and",
+    "  # flags the cases it must not guess at. Its terminal",
+    "  # LABEL_INVARIANT_DONE line is captured and re-emitted alongside",
+    "  # MAINTENANCE_DONE so the orchestrator reads every summary from",
+    "  # one maintenance invocation.",
+    "  local label_output",
+    "  label_output=$(cmd_label_invariant --fix)",
+    '  local label_summary="LABEL_INVARIANT_DONE mode=fix checked=0 ok=0 violations=0 corrected=0 flagged=0"',
+    "",
+    "  while IFS= read -r line; do",
+    '    [[ -z "$line" ]] && continue',
+    '    case "$line" in',
+    "      'LABEL_INVARIANT_DONE '*)",
+    '        label_summary="$line"',
+    "        ;;",
+    "      *)",
+    '        echo "$line"',
+    "        ;;",
+    "    esac",
+    '  done <<< "$label_output"',
+    "",
     "  # \u2500\u2500 needs-attention total \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
     "  local needs_attention_total",
     '  needs_attention_total=$(gh issue list --label "status:needs-attention" --state open \\',
     "    --json number --limit 100 2>/dev/null | jq 'length' 2>/dev/null || echo 0)",
     "  needs_attention_total=${needs_attention_total:-0}",
     "",
-    "  # Two summary lines consumed by the orchestrator: the issue/orphan",
-    "  # MAINTENANCE_DONE line and the PR-lease LEASE_RECONCILE line.",
+    "  # Three summary lines consumed by the orchestrator: the",
+    "  # issue/orphan MAINTENANCE_DONE line, the PR-lease LEASE_RECONCILE",
+    "  # line, and the LABEL_INVARIANT_DONE line.",
     '  echo "MAINTENANCE_DONE flagged_stale=${flagged_stale_count} flagged_blocked=${flagged_blocked_count} orphan_branches=${orphan_branches_count} orphan_prs=${orphan_prs_count} needs_attention_total=${needs_attention_total}"',
     '  echo "$lease_summary"',
+    '  echo "$label_summary"',
     "}",
     "",
     "cmd_prs() {",
@@ -16428,6 +16889,196 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
     '  done <<< "$eligible"',
     "}",
     "",
+    "cmd_label_invariant() {",
+    "  # Phase-label \u2192 type:<bundle> invariant sweep.",
+    "  #",
+    "  # Every phased-pipeline bundle pairs its <bundle>:<phase> labels",
+    "  # with exactly one type:<bundle> label. An agent that reconstructs",
+    "  # a gh issue create call from prose can stamp a conventional-commit",
+    "  # type label derived from the title prefix instead, producing an",
+    "  # issue that carries the phase label but the WRONG type label \u2014",
+    "  # invisible to the --label type:<bundle> duplicate-check idiom and",
+    "  # mis-tiered by the funnel-tier sort in cmd_eligible.",
+    "  #",
+    "  # Default mode is REPORT-ONLY (the consumer-runnable audit); pass",
+    "  # --fix to apply corrections. cmd_maintenance runs the --fix mode",
+    "  # as part of the Phase D sweep.",
+    "  #",
+    "  # CORRECTION POLICY. An issue must carry EXACTLY ONE type:* label",
+    "  # (cmd_eligible derives its funnel-tier sort key from the FIRST",
+    "  # one, and the label conventions mandate exactly one), so the",
+    "  # correction REPLACES rather than merely adds:",
+    "  #",
+    "  #   no type:* at all              \u2192 add the implied type label",
+    "  #   only conventional-commit      \u2192 remove them, add the implied",
+    "  #     type labels present           label (single atomic edit)",
+    "  #   implied label already there   \u2192 remove the stray conventional",
+    "  #     alongside a conventional one   label, leaving exactly one",
+    "  #   a type:* owned by ANOTHER     \u2192 FLAG status:needs-attention;",
+    "  #     bundle                         never guess which to drop",
+    "  #   phase labels imply 2+ types   \u2192 FLAG status:needs-attention",
+    "  #",
+    "  # Only a conventional-commit type label is ever removed \u2014 the set",
+    "  # is_conventional_type_label() recognises. A type:* label owned by",
+    "  # a different bundle is a genuine conflict a human must resolve.",
+    "  # status:needs-attention is applied ADDITIVELY; the base status:*",
+    "  # label always stays (see the additive-flag rule).",
+    "  local apply=0",
+    '  if [[ "${1:-}" == "--fix" ]]; then',
+    "    apply=1",
+    "  fi",
+    '  local mode="report"',
+    '  [[ "$apply" -eq 1 ]] && mode="fix"',
+    "",
+    "  local issues",
+    "  issues=$(gh issue list --state open --json number,labels \\",
+    '    --limit 1000 2>/dev/null || echo "[]")',
+    "",
+    "  # Filter jq-side and emit a TWO-field record. The label list is",
+    "  # last AND guaranteed non-empty by the select, so no field can",
+    "  # collapse under IFS=tab and shift the record left (#884). The",
+    "  # title is deliberately not threaded through \u2014 every output line",
+    "  # keys off the issue number.",
+    "  local issue_data",
+    `  issue_data=$(echo "$issues" | jq -r '`,
+    "    .[] |",
+    "    (.labels | map(.name)) as $names |",
+    "    select($names | length > 0) |",
+    '    "\\(.number)\\t\\($names | join(","))"',
+    "  ' 2>/dev/null)",
+    "",
+    "  local checked_count=0",
+    "  local ok_count=0",
+    "  local corrected_count=0",
+    "  local flagged_count=0",
+    "",
+    "  while IFS=$'\\t' read -r num labels_csv; do",
+    '    [[ -z "$num" ]] && continue',
+    "",
+    "    local labels_nl",
+    `    labels_nl=$(printf '%s' "$labels_csv" | tr ',' '\\n')`,
+    "",
+    "    local resolution assignment",
+    "    local outcome='' type_label='' phase_labels='' candidates=''",
+    `    resolution=$(printf '%s\\n' "$labels_nl" | phase_type_of)`,
+    "    while IFS= read -r assignment; do",
+    '      case "$assignment" in',
+    "        OUTCOME=*) outcome=${assignment#OUTCOME=} ;;",
+    "        TYPE_LABEL=*) type_label=${assignment#TYPE_LABEL=} ;;",
+    "        CANDIDATE_TYPE_LABELS=*) candidates=${assignment#CANDIDATE_TYPE_LABELS=} ;;",
+    "        PHASE_LABELS=*) phase_labels=${assignment#PHASE_LABELS=} ;;",
+    "      esac",
+    '    done <<< "$resolution"',
+    "",
+    "    # No recognised phase label \u2014 the invariant does not apply.",
+    "    # Consumer-specific `foo:bar` labels are deliberately not policed.",
+    '    [[ "$outcome" == "none" ]] && continue',
+    "    checked_count=$((checked_count + 1))",
+    "",
+    "    # Idempotent flagging: read the existing flag off the labels we",
+    "    # already fetched rather than spending another API call.",
+    "    local already_flagged=0",
+    '    case ",${labels_csv}," in',
+    '      *",status:needs-attention,"*) already_flagged=1 ;;',
+    "    esac",
+    "",
+    '    if [[ "$outcome" == "ambiguous" ]]; then',
+    '      echo "LABEL_AMBIGUOUS #${num} phase=\\"${phase_labels}\\" candidates=\\"${candidates}\\""',
+    "      flagged_count=$((flagged_count + 1))",
+    '      if [[ "$apply" -eq 1 && "$already_flagged" -eq 0 ]]; then',
+    '        if gh issue edit "$num" --add-label "status:needs-attention" >/dev/null 2>&1; then',
+    '          gh issue comment "$num" \\',
+    '            --body "Label invariant: phase label(s) ${phase_labels} imply more than one bundle type label (${candidates}). Flagged for human triage \u2014 an ambiguous pairing is never auto-corrected." >/dev/null 2>&1 || true',
+    '          echo "LABEL_FLAGGED #${num} \u2014 added status:needs-attention (ambiguous)"',
+    "        else",
+    '          echo "LABEL_FLAG_FAILED #${num} \u2014 could not add status:needs-attention (ambiguous)"',
+    "        fi",
+    "      fi",
+    "      continue",
+    "    fi",
+    "",
+    "    # Partition the issue's existing type:* labels against the",
+    "    # implied one.",
+    "    local label",
+    "    local has_expected=0",
+    "    local conv_types=''",
+    "    local foreign_types=''",
+    "    while IFS= read -r label; do",
+    '      [ -z "$label" ] && continue',
+    '      case "$label" in',
+    "        type:*) ;;",
+    "        *) continue ;;",
+    "      esac",
+    '      if [ "$label" = "$type_label" ]; then',
+    "        has_expected=1",
+    "        continue",
+    "      fi",
+    '      if is_conventional_type_label "$label"; then',
+    '        conv_types="${conv_types}${label} "',
+    "      else",
+    '        foreign_types="${foreign_types}${label} "',
+    "      fi",
+    '    done <<< "$labels_nl"',
+    "",
+    '    if [[ "$has_expected" -eq 1 && -z "${conv_types}${foreign_types}" ]]; then',
+    '      echo "LABEL_OK #${num} type=${type_label}"',
+    "      ok_count=$((ok_count + 1))",
+    "      continue",
+    "    fi",
+    "",
+    "    # A type:* label owned by a DIFFERENT bundle is a conflict the",
+    "    # sweep must not guess at: removing it would destroy routing",
+    "    # information, and adding alongside it would leave two bundle",
+    "    # type labels and a non-deterministic funnel tier.",
+    '    if [[ -n "$foreign_types" ]]; then',
+    '      echo "LABEL_CONFLICT #${num} phase=\\"${phase_labels}\\" expected=${type_label} foreign=\\"${foreign_types% }\\""',
+    "      flagged_count=$((flagged_count + 1))",
+    '      if [[ "$apply" -eq 1 && "$already_flagged" -eq 0 ]]; then',
+    '        if gh issue edit "$num" --add-label "status:needs-attention" >/dev/null 2>&1; then',
+    '          gh issue comment "$num" \\',
+    '            --body "Label invariant: phase label(s) ${phase_labels} require ${type_label}, but this issue carries ${foreign_types% }, which is owned by another bundle. Flagged for human triage \u2014 the sweep only removes conventional-commit type labels." >/dev/null 2>&1 || true',
+    '          echo "LABEL_FLAGGED #${num} \u2014 added status:needs-attention (conflicting bundle type)"',
+    "        else",
+    '          echo "LABEL_FLAG_FAILED #${num} \u2014 could not add status:needs-attention (conflict)"',
+    "        fi",
+    "      fi",
+    "      continue",
+    "    fi",
+    "",
+    "    # Correctable: add the implied label and/or drop the",
+    "    # conventional-commit label(s) shadowing it, in ONE edit so the",
+    "    # issue is never observable carrying two type:* labels.",
+    '    local removing="${conv_types% }"',
+    "    local adding=''",
+    '    [[ "$has_expected" -eq 0 ]] && adding="$type_label"',
+    '    echo "LABEL_VIOLATION #${num} phase=\\"${phase_labels}\\" expected=${type_label} add=\\"${adding}\\" remove=\\"${removing}\\""',
+    '    if [[ "$apply" -eq 0 ]]; then',
+    "      continue",
+    "    fi",
+    "",
+    "    local -a edit_args=()",
+    "    local stray",
+    "    for stray in $removing; do",
+    '      edit_args+=(--remove-label "$stray")',
+    "    done",
+    '    [[ -n "$adding" ]] && edit_args+=(--add-label "$adding")',
+    '    if [[ "${#edit_args[@]}" -eq 0 ]]; then',
+    "      continue",
+    "    fi",
+    '    if gh issue edit "$num" "${edit_args[@]}" >/dev/null 2>&1; then',
+    '      gh issue comment "$num" \\',
+    '        --body "Label invariant: phase label(s) ${phase_labels} require ${type_label}. Corrected \u2014 added: ${adding:-(none)}; removed: ${removing:-(none)}." >/dev/null 2>&1 || true',
+    '      echo "LABEL_CORRECTED #${num} added=\\"${adding}\\" removed=\\"${removing}\\""',
+    "      corrected_count=$((corrected_count + 1))",
+    "    else",
+    '      echo "LABEL_CORRECT_FAILED #${num} \u2014 label edit failed"',
+    "    fi",
+    '  done <<< "$issue_data"',
+    "",
+    "  local violations_count=$((checked_count - ok_count))",
+    '  echo "LABEL_INVARIANT_DONE mode=${mode} checked=${checked_count} ok=${ok_count} violations=${violations_count} corrected=${corrected_count} flagged=${flagged_count}"',
+    "}",
+    "",
     "cmd_scope() {",
     '  local issue_num="${1:-}"',
     '  if [[ -z "$issue_num" ]]; then',
@@ -16514,8 +17165,9 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
     '  maintenance) shift; cmd_maintenance "$@" ;;',
     '  prs)         shift; cmd_prs "$@" ;;',
     '  scope)       shift; cmd_scope "$@" ;;',
+    '  label-invariant) shift; cmd_label_invariant "$@" ;;',
     "  help|*)",
-    '    echo "Usage: check-blocked.sh <unblock|eligible|stale|orphaned|lease-reconcile|maintenance|prs|scope>"',
+    '    echo "Usage: check-blocked.sh <unblock|eligible|stale|orphaned|lease-reconcile|maintenance|prs|scope|label-invariant>"',
     "    exit 1",
     "    ;;",
     "esac"
@@ -16524,7 +17176,7 @@ function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
 function buildCheckBlockedProcedure(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio()) {
   return {
     name: "check-blocked.sh",
-    description: "Token-efficient issue triage script with subcommands: eligible, unblock, stale, orphaned, lease-reconcile, maintenance, prs, scope. Sorts eligible issues by priority desc \u2192 funnel tier asc \u2192 issue number asc, excluding issues carrying `status:needs-attention` or `status:deferred`; the scope subcommand classifies a single issue against the scope-gate thresholds; the unblock subcommand applies the `status:blocked` \u2192 `status:ready` label flip itself, posts the canned unblock comment, skips human-parked `status:deferred` candidates with a `SKIP_DEFERRED` line, and emits a single `TRIAGE_DONE unblocked=N still_blocked=M deferred_skipped=K` summary line; the lease-reconcile subcommand auto-reconciles stuck `review:fixing` PR leases \u2014 re-applying `review:needs-worker` on an orphaned lease (fix-list stale, no worker report) so the Phase B1 drain retries, and removing `review:needs-worker` on a consumed-but-uncleared wedge (branch HEAD advanced past the fix-list, marker still set, no worker report) so the reviewer confirm pass can merge, always posting an audit-trail note comment and emitting a single `LEASE_RECONCILE orphaned=N consumed_uncleared=M` summary line; the maintenance subcommand flags stale issues with `status:needs-attention` (never auto-resets to `status:ready`), counts orphan branches/PRs, folds in the lease-reconcile sweep, and emits a `MAINTENANCE_DONE flagged_stale=N flagged_blocked=M orphan_branches=A orphan_prs=B needs_attention_total=T` summary line followed by the `LEASE_RECONCILE` line.",
+    description: "Token-efficient issue triage script with subcommands: eligible, unblock, stale, orphaned, lease-reconcile, maintenance, prs, scope, label-invariant. Sorts eligible issues by priority desc \u2192 funnel tier asc \u2192 issue number asc, excluding issues carrying `status:needs-attention` or `status:deferred`; the scope subcommand classifies a single issue against the scope-gate thresholds; the unblock subcommand applies the `status:blocked` \u2192 `status:ready` label flip itself, posts the canned unblock comment, skips human-parked `status:deferred` candidates with a `SKIP_DEFERRED` line, and emits a single `TRIAGE_DONE unblocked=N still_blocked=M deferred_skipped=K` summary line; the lease-reconcile subcommand auto-reconciles stuck `review:fixing` PR leases \u2014 re-applying `review:needs-worker` on an orphaned lease (fix-list stale, no worker report) so the Phase B1 drain retries, and removing `review:needs-worker` on a consumed-but-uncleared wedge (branch HEAD advanced past the fix-list, marker still set, no worker report) so the reviewer confirm pass can merge, always posting an audit-trail note comment and emitting a single `LEASE_RECONCILE orphaned=N consumed_uncleared=M` summary line; the maintenance subcommand flags stale issues with `status:needs-attention` (never auto-resets to `status:ready`), counts orphan branches/PRs, folds in the lease-reconcile sweep and the label-invariant auto-correction, and emits a `MAINTENANCE_DONE flagged_stale=N flagged_blocked=M orphan_branches=A orphan_prs=B needs_attention_total=T` summary line followed by the `LEASE_RECONCILE` and `LABEL_INVARIANT_DONE` lines; the label-invariant subcommand enforces the phase-label \u2192 `type:<bundle>` pairing derived from the canonical `BUNDLE_OWNERSHIP` map \u2014 report-only by default, auto-correcting with `--fix` (replacing a shadowing conventional-commit `type:*` rather than merely adding, so the issue keeps exactly one `type:*`) and flagging `status:needs-attention` when the pairing is ambiguous or collides with another bundle's type label, emitting a single `LABEL_INVARIANT_DONE mode=M checked=N ok=O violations=V corrected=C flagged=F` summary line.",
     content: buildCheckBlockedScript(tiers, scopeGate, runRatio)
   };
 }
@@ -17240,32 +17892,36 @@ var orchestratorSubAgent = {
     "## Phase D: Maintenance",
     "",
     "Run the bundled `check-blocked.sh maintenance` procedure and read",
-    "**only** the two summary lines it emits \u2014 `MAINTENANCE_DONE` and",
-    "`LEASE_RECONCILE`. The procedure folds the stale-detection,",
-    "orphan-detection, needs-attention summary, and PR-lease",
-    "auto-reconcile that earlier revisions split across D1, D2, and D3",
-    "into a single sweep \u2014 applying the `status:needs-attention` label",
-    "and posting the canned flag comment for each stale / stale-blocked",
-    "issue itself, and reconciling stuck `review:fixing` PR leases",
-    "itself, mirroring the discipline of Phase B (`pr-sweep.sh`) and",
-    "Phase C (`check-blocked.sh unblock`).",
+    "**only** the three summary lines it emits \u2014 `MAINTENANCE_DONE`,",
+    "`LEASE_RECONCILE`, and `LABEL_INVARIANT_DONE`. The procedure folds",
+    "the stale-detection, orphan-detection, needs-attention summary,",
+    "PR-lease auto-reconcile, and phase-label invariant sweep that",
+    "earlier revisions split across D1, D2, and D3 into a single sweep \u2014",
+    "applying the `status:needs-attention` label and posting the canned",
+    "flag comment for each stale / stale-blocked issue itself,",
+    "reconciling stuck `review:fixing` PR leases itself, and correcting",
+    "mislabeled pipeline issues itself, mirroring the discipline of",
+    "Phase B (`pr-sweep.sh`) and Phase C (`check-blocked.sh unblock`).",
     "",
     "```bash",
     ".claude/procedures/check-blocked.sh maintenance",
     "```",
     "",
-    "The script emits two summary lines in this shape:",
+    "The script emits three summary lines in this shape:",
     "",
     "```",
     "MAINTENANCE_DONE flagged_stale=<N> flagged_blocked=<M> orphan_branches=<A> orphan_prs=<B> needs_attention_total=<T>",
     "LEASE_RECONCILE orphaned=<N> consumed_uncleared=<M>",
+    "LABEL_INVARIANT_DONE mode=fix checked=<N> ok=<O> violations=<V> corrected=<C> flagged=<F>",
     "```",
     "",
     "Per-issue / per-orphan / per-PR informational lines (`FLAGGED_STALE",
     "#N`, `FLAGGED_BLOCKED #N`, `STALE #N \u2014 \u2026`, `STALE_BLOCKED #N \u2014 \u2026`,",
     "`ORPHAN_BRANCH \u2026`, `ORPHAN_PR #N \u2014 \u2026`, `FLAG_FAILED #N \u2014 \u2026`,",
     "`LEASE_ORPHANED PR #N \u2014 \u2026`, `LEASE_CONSUMED_UNCLEARED PR #N \u2014 \u2026`,",
-    "`LEASE_RECONCILE_FAILED PR #N \u2014 \u2026`) are emitted for log visibility",
+    "`LEASE_RECONCILE_FAILED PR #N \u2014 \u2026`, `LABEL_VIOLATION #N \u2014 \u2026`,",
+    "`LABEL_CORRECTED #N \u2014 \u2026`, `LABEL_AMBIGUOUS #N \u2014 \u2026`,",
+    "`LABEL_CONFLICT #N \u2014 \u2026`) are emitted for log visibility",
     "but are **not** load-bearing for the orchestrator \u2014 partial failures",
     "(one bad `gh` call) do not abort the sweep, they are simply omitted",
     "from the counters.",
@@ -17305,9 +17961,24 @@ var orchestratorSubAgent = {
     "is never silently force-released. The `review:fixing` lease itself",
     "is always left for the reviewer confirm pass to release.",
     "",
-    "Log both summary lines and continue to Phase E regardless of",
-    "outcomes \u2014 a non-zero `flagged_*`, `orphan_*`, `orphaned`, or",
-    "`consumed_uncleared` count is informational, not a failure.",
+    "**Phase-label invariant (`LABEL_INVARIANT_DONE`).** The sweep also",
+    "enforces the phase-label \u2192 `type:<bundle>` pairing on every open",
+    "issue, so a pipeline issue filed with a conventional-commit",
+    "`type:*` (derived from its title prefix) cannot stay invisible to",
+    'the `--label "type:<bundle>"` duplicate-check idiom or mis-tier in',
+    "Phase E's funnel-tier sort. The script mutates the labels itself \u2014",
+    "the orchestrator only reads the summary line. See the **Phase-label",
+    "\u2192 `type:<bundle>` invariant** section in `CLAUDE.md` for the full",
+    "correction policy; in short, a shadowing conventional-commit type",
+    "label is **replaced** (never merely supplemented, so the issue",
+    "keeps exactly one `type:*`), and an ambiguous or cross-bundle",
+    "collision is **flagged** `status:needs-attention` rather than",
+    "guessed at.",
+    "",
+    "Log all three summary lines and continue to Phase E regardless of",
+    "outcomes \u2014 a non-zero `flagged_*`, `orphan_*`, `orphaned`,",
+    "`consumed_uncleared`, `corrected`, or `flagged` count is",
+    "informational, not a failure.",
     "",
     "## Phase E: Queue Scan",
     "",
@@ -18309,6 +18980,7 @@ var ORCHESTRATOR_CONVENTIONS_PREAMBLE = [
   "- Stale thresholds: 72h for in-progress, 168h for blocked",
   "- Flagged issues get `status:needs-attention` \u2014 they are not auto-reset",
   "- **Phase D auto-reconciles stuck PR leases.** The maintenance sweep's `check-blocked.sh maintenance` invocation folds in a PR-lease reconcile that unwedges `review:fixing` PRs the Phase B1 drain and the worker hand-off left stuck, emitting a `LEASE_RECONCILE orphaned=<N> consumed_uncleared=<M>` line alongside `MAINTENANCE_DONE`. An **orphaned lease** (`review:fixing` without `review:needs-worker`, fix-list older than the 72h stale threshold, no worker-report newer than the fix-list) is **re-armed** \u2014 the sweep re-applies `review:needs-worker` so the Phase B1 drain retries the delegation, leaving the lease untouched. A **consumed-but-uncleared wedge** (both labels present, branch HEAD newer than the fix-list, no worker-report \u2014 the worker pushed but skipped the hand-off) is **auto-reconciled** \u2014 the sweep removes `review:needs-worker` so the reviewer confirm pass can merge. Both paths post an audit-trail note comment; a lease is never silently force-released, and the `review:fixing` lease itself is always left for the reviewer confirm pass to release.",
+  "- **Phase D enforces the phase-label \u2192 `type:<bundle>` invariant.** The same maintenance sweep folds in a label-invariant pass that auto-corrects open issues carrying a pipeline phase label without the matching `type:<bundle>` label, emitting a `LABEL_INVARIANT_DONE mode=fix checked=<N> ok=<O> violations=<V> corrected=<C> flagged=<F>` line alongside `MAINTENANCE_DONE`. The correction **replaces** a shadowing conventional-commit `type:*` rather than merely adding the bundle type, so the issue keeps exactly one `type:*` and Phase E's funnel-tier sort key stays deterministic. Ambiguous pairings and collisions with another bundle's `type:*` label are **flagged** `status:needs-attention` (additively) instead of guessed at. See the **Phase-label \u2192 `type:<bundle>` invariant** section below for the matcher table and the full correction policy.",
   "",
   "## Depth-0 invocation requirement",
   "",
@@ -18324,6 +18996,8 @@ function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate
     "",
     renderScopeGateSection(scopeGate, excludeBundles),
     "",
+    renderPhaseTypeInvariantSection(excludeBundles),
+    "",
     renderScheduledTasksSection(scheduledTasks),
     "",
     renderUnblockDependentsSection(unblockDependents)
@@ -18924,6 +19598,8 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this person profile",
       "     (`Discovered while profiling: <person name>`)",
@@ -18944,6 +19620,8 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "software:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this person profile",
       "     (`Discovered while profiling: <person name>`)",
@@ -19226,6 +19904,8 @@ function buildProfilePersonSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "people:research").status}\`. Body must include the`,
       "   person's name, selected role, primary company, framing, and any",
       "   overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the people-profile-analyst agent.",
       "3. Phase 1 creates the `people:draft` issue. Phase 2 may create a",
       "   `people:followup` issue. Each downstream issue declares its",
@@ -19317,6 +19997,8 @@ function buildRefreshPersonSkill(paths, issueDefaults) {
       "1. Create a `people:refresh` issue with `type:people-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "people:refresh").priority}\`, and \`status:${labelsForPhase(issueDefaults, "people:refresh").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Refresh) of the people-profile-analyst agent.",
       "",
       "## Output",
@@ -23013,6 +23695,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Verify all handoffs were created** before committing.",
       "",
       "10. **Commit and push** the regulation page. Close the research",
@@ -23123,6 +23807,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "req:scan").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must also:",
       "   - Identify the target category as **SEC** (security & compliance)",
       "     in the body so the downstream writer phase picks up the right",
@@ -23142,6 +23828,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Create `people:research` issues** for notable regulatory",
       "   leaders (commissioners, agency directors, lead policy authors)",
       "   mentioned on the regulation page. Keep this list small \u2014 at most",
@@ -23153,6 +23841,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit and push** the updated regulation page. Close the",
       "   impact issue.",
       "",
@@ -23320,6 +24010,8 @@ function buildScanRegulatoryLandscapeSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "regulatory:scan").priority}\`, and \`status:${labelsForPhase(issueDefaults, "regulatory:scan").status}\`. The body must include the`,
       "   scope slug, the scope type, and any known regulations to include",
       "   or exclude.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the regulatory-research-analyst agent.",
       "3. Phase 1 writes the scan report and creates one",
       "   `regulatory:research` issue per prioritized regulation.",
@@ -23396,6 +24088,8 @@ function buildResearchRegulationSkill(paths, issueDefaults) {
       `   \`type:regulatory-research\`, \`priority:${labelsForPhase(issueDefaults, "regulatory:research").priority}\`, and`,
       `   \`status:${labelsForPhase(issueDefaults, "regulatory:research").status}\`. The body must include the scope slug and the`,
       "   regulation slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Research) of the regulatory-research-analyst",
       "   agent. The agent runs 6\u201312 targeted web searches and populates",
       "   the regulation page.",
@@ -23463,6 +24157,8 @@ function buildImpactRegulationSkill(paths, issueDefaults) {
       `   \`status:${labelsForPhase(issueDefaults, "regulatory:impact").status}\` (or \`status:blocked\` when still dependent on a`,
       "   Phase 2 research issue). Body must include the regulation page",
       "   path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Impact) of the regulatory-research-analyst",
       "   agent. No web searches \u2014 pure synthesis from the regulation",
       "   page and project context.",
@@ -26298,6 +26994,8 @@ function buildWriteRequirementSkill(paths, issueDefaults) {
       "   Body must include the category, tier, output path, and a pointer",
       "   to the upstream proposal (or a direct user description if no",
       "   proposals file exists).",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the write phase of the requirements-writer agent.",
       "3. The agent writes one requirement document, updates the category",
       "   index, opens a PR, and closes the issue.",
@@ -26887,6 +27585,8 @@ function buildRequirementsAnalystSubAgent(paths, issueDefaults) {
       `   \`--label "tier:<tier-slug>"\`, \`--label "status:${labelsForPhase(issueDefaults, "req:write").status}"\`, and`,
       `   \`--label "priority:${labelsForPhase(issueDefaults, "req:write").priority}"\`.`,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must carry the three writer-required fields in an",
       "   `## Objective` block, written as bold-prefixed lines so the",
       "   writer's intake parser can pull them out, plus the reserved-ID",
@@ -27033,6 +27733,8 @@ function buildScanRequirementsSkill(issueDefaults) {
       "",
       `1. Create a \`req:scan\` issue with \`type:requirement\`, \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\`,`,
       `   and \`status:${labelsForPhase(issueDefaults, "req:scan").status}\`. Body must list the files to read and the scan scope.`,
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the requirements-analyst agent.",
       "3. If gaps are found, a `req:draft-trace` issue is created automatically.",
       "",
@@ -28081,6 +28783,7 @@ function buildRequirementsReviewerSubAgent(paths, issueDefaults) {
       "- Labels: `type:requirement`, `req:write`, the matching",
       "  `tier:*` label derived from the referencing document's Tier,",
       `  \`priority:${labelsForPhase(issueDefaults, "req:write").priority}\`, \`status:${labelsForPhase(issueDefaults, "req:write").status}\`.`,
+      ...renderIssueTypeAssignmentStep({ indent: "", bullet: true }),
       "- If any of Category / Tier / Output Path cannot be derived from",
       "  the referencing document, open the follow-up with",
       "  `status:needs-attention` and a `Missing:` line, per the same",
@@ -28236,6 +28939,8 @@ function buildReviewRequirementsSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "req:review").priority}\`, and \`status:${labelsForPhase(issueDefaults, "req:review").status}\`. Body must include the`,
       "   scope, the requirements root (or accept the default), and the",
       "   output path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the review phase of the requirements-reviewer agent.",
       "3. The agent runs the 12-check audit, writes a structured report",
       "   grouped by Critical / Warning / Info (plus a separate",
@@ -28338,6 +29043,8 @@ function buildDeprecateRequirementSkill(_paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "req:deprecate").priority}\`, and \`status:${labelsForPhase(issueDefaults, "req:deprecate").status}\`. Body must include the`,
       "   Targets, Transition, and Reason sections above (optionally",
       "   `Pre-approved: yes`).",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the deprecation phase of the requirements-reviewer",
       "   agent.",
       "3. The agent verifies inputs, pauses for human confirmation (or",
@@ -28912,6 +29619,8 @@ function buildResearchSkill(paths, issueDefaults) {
       "1. Create a `research:scope` issue with `type:research`,",
       `   \`priority:${labelsForPhase(issueDefaults, "research:scope").priority}\`, and \`status:${labelsForPhase(issueDefaults, "research:scope").status}\`. Body must include the`,
       "   verbatim question, authorized sources, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scope) of the research-analyst agent.",
       "3. Phase 1 creates `research:slice` issues (one per slice) and a",
       "   single `research:verify` issue. Each downstream issue declares",
@@ -29727,6 +30436,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "bcm:outline").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "bcm:outline").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while mapping: <product name>`)",
@@ -29795,6 +30506,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "   `software:research` phase with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:research").status}\`.`,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "3. **Enqueue a `company:research` issue for the vendor company** if",
       "   no matching profile already exists under `<COMPANY_PROFILES_DIR>/`.",
       "   The vendor (the company that builds or maintains the product)",
@@ -29807,6 +30520,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while profiling: <product name>`)",
@@ -29826,6 +30541,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while profiling: <product name>`)",
@@ -30016,6 +30733,8 @@ function buildProfileSoftwareSkill(paths, issueDefaults) {
       "1. Create a `software:research` issue with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:research").status}\`. Body must include the`,
       "   product name, selected type, framing, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the software-profile-analyst",
       "   agent.",
       "3. Phase 1 creates the `software:profile` issue. Phase 2 creates",
@@ -30104,6 +30823,8 @@ function buildMapSoftwareSkill(paths, issueDefaults) {
       "1. Create a `software:map` issue with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:map").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:map").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Map) of the software-profile-analyst agent.",
       "3. Phase 4 writes the `## Capability Mapping` section, enqueues",
       "   `bcm:outline` issues for unmapped features above the threshold,",
@@ -30716,6 +31437,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Create `people:research` issues** for every entry in *People of",
       "   Interest* that does not already have a canonical person profile",
       "   or an open `people:research` issue. The `people-profile` bundle",
@@ -30727,6 +31450,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Verify all handoffs were created** before committing. For each",
       "   entity in both tables, confirm an existing profile or a fresh",
       "   handoff issue exists. Do not commit with missing handoffs.",
@@ -31020,6 +31745,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Hand off canonical people profiles** by creating one",
       "   `people:research` issue per leadership entry that does not",
       "   already have a canonical profile or an open `people:research`",
@@ -31031,6 +31758,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit and push** the organization page. Close the",
       "   organizations issue.",
       "",
@@ -31205,6 +31934,8 @@ function buildScopeStandardsResearchSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "standards:scope").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:scope").status}\`. The body must include the`,
       "   standard slug, the list of target versions (or a request to",
       "   enumerate), and any known governance bodies.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scope) of the standards-research-analyst agent.",
       "3. Phase 1 writes the query plan and creates one `standards:research`",
       "   issue per target version, one `standards:compare` issue (blocked",
@@ -31269,6 +32000,8 @@ function buildResearchStandardSkill(paths, issueDefaults) {
       "1. Create a `standards:research` issue with",
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:research").status}\`.`,
       "   The body must include the standard slug and the version slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Research) of the standards-research-analyst",
       "   agent. The agent runs 6\u201310 targeted web searches and populates",
       "   the version page.",
@@ -31342,6 +32075,8 @@ function buildCompareStandardsSkill(paths, issueDefaults) {
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:compare").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:compare").status}\`.`,
       "   Body must include the standard slug and the list of version",
       "   pages under comparison.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Compare) of the standards-research-analyst",
       "   agent. No web searches \u2014 pure synthesis from the version pages.",
       "",
@@ -31410,6 +32145,8 @@ function buildExtensionStandardSkill(paths, issueDefaults) {
       "   The body must include the standard slug, the entity slug, the",
       "   closest resource, and a link to the source BCM or canvas",
       "   document.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Extension) of the standards-research-analyst",
       "   agent. The agent runs 4\u20138 targeted web searches against",
       "   community registries, implementation guides, and working-group",
@@ -31475,6 +32212,8 @@ function buildOrganizationsStandardSkill(paths, issueDefaults) {
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:organizations").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:organizations").status}\`.`,
       "   Body must include the standard slug, the organization slug, and",
       "   the organization's governance role.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 5 (Organizations) of the",
       "   standards-research-analyst agent. The agent runs 4\u20138 targeted",
       "   web searches.",
@@ -31784,6 +32523,14 @@ var UPSTREAM_CONFIGULATOR_DOCS_SUMMARY = [
   "",
   "Pick the `type:*` and matching prefix that describes the work (`feat:`, `fix:`, `chore:`, `docs:`, `refactor:`). Set `priority:*` from the urgency and use `status:blocked` instead of `status:ready` if the issue depends on another open issue.",
   "",
+  "Then set the new issue's **GitHub issue type** \u2014 a separate field from the `type:*` label, which `gh issue create` cannot set. Derive it from the title prefix (`epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192 Bug, everything else \u2192 Task). The local `.claude/procedures/set-issue-type.sh` helper resolves owner/repo from the **current** checkout, so a cross-repo filing needs the `updateIssueIssueType` GraphQL flow with an explicit owner/repo:",
+  "",
+  "```sh",
+  "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=codedrifters -f repo=packages",
+  "gh issue view <issue-number> --repo codedrifters/packages --json id --jq '.id'",
+  "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+  "```",
+  "",
   "See `.claude/rules/upstream-configulator-docs-detail.md` for the full reference \u2014 extended `gh` recipes, common pitfalls (rate limits, base64 decoding, search vs. browse), and a complete issue-creation walkthrough."
 ].join("\n");
 var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
@@ -31892,6 +32639,16 @@ var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
   "- `priority:*` \u2014 pick exactly one of `priority:critical`, `priority:high`, `priority:medium`, `priority:low`, `priority:trivial`. Default to `priority:medium` when nothing in the request signals urgency. Use `priority:high` for blockers and `priority:critical` only for outages or release-blocking work.",
   "- `status:*` \u2014 `status:ready` for self-contained issues, `status:blocked` when the issue declares `Depends on: #<n>` against another open issue.",
   "",
+  "### GitHub issue type",
+  "",
+  "The GitHub **issue type** (Epic / Feature / Bug / Task) is a separate field from the `type:*` label, and `gh issue create` cannot set it. Derive it from the title prefix \u2014 `epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192 Bug, everything else \u2192 Task \u2014 and apply it in a follow-up call. The bundled `.claude/procedures/set-issue-type.sh` helper resolves owner/repo from the **current** checkout, so a cross-repo filing against `codedrifters/packages` uses the `updateIssueIssueType` GraphQL flow with an explicit owner/repo instead:",
+  "",
+  "```sh",
+  "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=codedrifters -f repo=packages",
+  "gh issue view <issue-number> --repo codedrifters/packages --json id --jq '.id'",
+  "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+  "```",
+  "",
   "### Worked example",
   "",
   "Suppose configulator's `software-profile-analyst` agent prompt is missing a step you need. Instead of forking the prompt locally:",
@@ -40688,6 +41445,7 @@ export {
   CDK_WATCH_DEFAULTS_BY_STAGE,
   CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID,
+  CONVENTIONAL_COMMIT_TYPE_LABELS,
   CdkCli,
   DEFAULT_AC_THRESHOLDS,
   DEFAULT_AGENT_PATHS,
@@ -40702,6 +41460,7 @@ export {
   DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
+  DEFAULT_GITHUB_ISSUE_TYPE,
   DEFAULT_HOUSEKEEPING_MODEL,
   DEFAULT_ISSUE_PRIORITY,
   DEFAULT_ISSUE_STATUS,
@@ -40748,6 +41507,8 @@ export {
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
   DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION,
+  GITHUB_ISSUE_TYPES,
+  GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
   JsiiFaker,
   LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -40759,6 +41520,7 @@ export {
   MONOREPO_LAYOUT,
   MonorepoProject,
   Nvmrc,
+  PHASE_LABEL_TYPE_MAP,
   PROD_DEPLOY_NAME,
   PROGRESS_FILES_FORMAT_VALUES,
   PnpmWorkspace,
@@ -40771,6 +41533,7 @@ export {
   ResetTask,
   SCHEDULED_TASK_MODEL_VALUES,
   SCOPE_CLASS_VALUES,
+  SET_ISSUE_TYPE_HELPER_PATH,
   SHARED_EDITING_CONFLICT_STRATEGY_VALUES,
   STARLIGHT_ROLE,
   SUPPRESSED_WORKFLOW_RULE_NAMES,
@@ -40856,6 +41619,7 @@ export {
   formatLayoutViolation,
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,
+  githubIssueTypeForTitle,
   githubWorkflowBundle,
   hasAnyDocsEmittingBundle,
   hasAnyDownstreamIssueKindBundle,
@@ -40913,12 +41677,18 @@ export {
   renderCustomDocSections,
   renderExtractApiProcedure,
   renderFocusSection,
+  renderGithubIssueTypeSection,
+  renderGithubIssueTypeSectionLines,
   renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript,
   renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage,
+  renderIssueTypeAssignmentBlanket,
+  renderIssueTypeAssignmentStep,
   renderMeetingTypesSection,
   renderNextRequirementIdProcedure,
+  renderPhaseTypeInvariantSection,
+  renderPhaseTypeInvariantShellHelpers,
   renderPriorityRulesSection,
   renderProgressFileName,
   renderProgressFilePath,
@@ -40931,6 +41701,7 @@ export {
   renderScheduledTasksSection,
   renderScopeGateSection,
   renderScopeGateShellHelpers,
+  renderSetIssueTypeFallbackLines,
   renderSharedEditingBundleHook,
   renderSharedEditingHelperScript,
   renderSharedEditingRuleContent,
@@ -40941,6 +41712,7 @@ export {
   renderStripToolArtifactTagsProcedure,
   renderTemporalFramingCheckerScript,
   renderTemporalFramingRuleContent,
+  renderTitlePrefixTypeBullets,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,
@@ -40970,6 +41742,7 @@ export {
   resolveSkillEvals,
   resolveTemplateVariables,
   resolveTemporalFraming,
+  resolveTypeLabelForLabels,
   resolveTypeScriptProjectOutdir,
   resolveUnblockDependents,
   runScan,
@@ -40979,6 +41752,7 @@ export {
   stripToolArtifactTagsProcedure,
   tsdocRecordToFindings,
   turborepoBundle,
+  typeLabelForPhaseLabel,
   typescriptBundle,
   upstreamConfigulatorDocsBundle,
   validateAgentTierConfig,