feat(issues): add orthogonal area labels for triage

Map template Area fields and light heuristics to additive labels
(provider, account-pool, catalog, gui, cli, proxy, platform, streaming,
tools, install, service) beside existing kind/process labels, with open
issue backfill via workflow_dispatch.

Author: Wibias

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -35,8 +35,12 @@ body:
         - Dashboard
         - Provider adapter
         - Authentication and account pool
+        - Catalog / models
+        - Streaming
+        - Tools / MCP / web search
         - Installation or packaging
         - Service lifecycle
+        - Platform (Windows / macOS / Linux)
         - Documentation
         - Other
     validations:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -19,8 +19,12 @@ body:
         - Dashboard
         - Provider adapters
         - Authentication and account pool
+        - Catalog / models
+        - Streaming
+        - Tools / MCP / web search
         - Installation or packaging
         - Service lifecycle
+        - Platform (Windows / macOS / Linux)
         - Documentation
         - Multiple areas
         - Other

.github/ISSUE_TEMPLATE/provider_compatibility.yml

@@ -2,6 +2,7 @@ name: Provider or API compatibility
 description: Report an incompatible provider, endpoint, request shape, response shape, or client integration.
 labels:
   - provider-compatibility
+  - provider
 body:
   - type: markdown
     attributes:

.github/scripts/issue-quality.cjs

@@ -250,6 +250,125 @@ const KIND_TO_LABEL = {
   "provider-compatibility": "provider-compatibility",
 };
 
+/**
+ * Orthogonal product-area labels (additive beside kind/process labels).
+ * Colors/descriptions are used when the workflow ensures labels exist.
+ */
+const AREA_LABELS = {
+  provider: {
+    color: "1D76DB",
+    description: "Provider adapters, OpenAI-compat presets, upstream API quirks",
+  },
+  "account-pool": {
+    color: "5319E7",
+    description: "OAuth, credentials, Codex pool, quota, failover, plans",
+  },
+  catalog: {
+    color: "006B75",
+    description: "Model catalog, slugs, visibility, routed entries",
+  },
+  gui: {
+    color: "D93F0B",
+    description: "Dashboard, tray, settings UI",
+  },
+  cli: {
+    color: "FBCA04",
+    description: "CLI, config inject, packaging flags",
+  },
+  proxy: {
+    color: "0E8A16",
+    description: "HTTP proxy, routing, reverse-proxy / management auth",
+  },
+  platform: {
+    color: "BFDADC",
+    description: "OS/service/tray/ACL (Windows-heavy, not Windows-only)",
+  },
+  streaming: {
+    color: "C5DEF5",
+    description: "SSE, WebSocket, terminal stream frames",
+  },
+  tools: {
+    color: "F9D0C4",
+    description: "tool_calls, MCP, web-search / sidecar tools",
+  },
+  install: {
+    color: "EDEDED",
+    description: "Installation or packaging",
+  },
+  service: {
+    color: "EDEDED",
+    description: "Service lifecycle (WinSW/launchd/scheduler)",
+  },
+};
+
+/** Canonical Area dropdown text → area label(s). Keys are lowercased. */
+const AREA_FIELD_TO_LABELS = {
+  cli: ["cli"],
+  "proxy and routing": ["proxy"],
+  dashboard: ["gui"],
+  "provider adapter": ["provider"],
+  "provider adapters": ["provider"],
+  "authentication and account pool": ["account-pool"],
+  "catalog / models": ["catalog"],
+  streaming: ["streaming"],
+  "tools / mcp / web search": ["tools"],
+  "installation or packaging": ["install"],
+  "service lifecycle": ["service"],
+  "service lifecycle (config injection)": ["service"],
+  "platform (windows / macos / linux)": ["platform"],
+  documentation: ["documentation"],
+  // No dedicated label; heuristics still run in detectAreaLabels.
+  "multiple areas": [],
+  other: [],
+};
+
+const AREA_HEURISTICS = [
+  {
+    label: "account-pool",
+    re: /\b(oauth|reauth|needsreauth|quota|account pool|codex.?auth|auto[- ]?switch|failover|refresh token|plan_type|chatgpt[- ]account|reset credit)\b/i,
+  },
+  {
+    label: "catalog",
+    re: /\b(catalog|model list|model visibility|virtual model|routed (catalog|entries|slug)|model slug)\b/i,
+  },
+  {
+    label: "gui",
+    re: /\b(dashboard|\bgui\b|tray|sidebar|settings tab)\b/i,
+  },
+  {
+    label: "cli",
+    re: /\b(ocx\b|config\.toml|config inject)\b/i,
+  },
+  {
+    label: "proxy",
+    re: /\b(reverse[- ]proxy|management api|admin[- ]token|\/api\/\*|bind(s)? the (old )?port|proxy running)\b/i,
+  },
+  {
+    label: "platform",
+    re: /\b(windows|macos|mac os|win32|darwin|wsl|winsw|launchd|systemd|icacls|\bacl\b)\b/i,
+  },
+  {
+    label: "streaming",
+    re: /\b(sse|websocket|\bws\b|stream(ing)?\b.{0,40}\b(truncat|terminal)|terminal (sse )?frame|without a terminal)\b/i,
+  },
+  {
+    label: "tools",
+    re: /\b(tool_calls?|tool[- ]calls?|\bmcp\b|web[- ]search|tool[- ]recall)\b/i,
+  },
+  {
+    label: "install",
+    re: /\b(npm (global )?install|packaging|release asset|npx ocx)\b/i,
+  },
+  {
+    label: "service",
+    re: /\b(ocx service|winsw|scheduler backend|launchd service)\b/i,
+  },
+  {
+    label: "provider",
+    re: /\b(provider adapter|openai[- ]compatible|provider[- ]compat|adapter quirk|upstream api|built[- ]in provider|provider preset)\b/i,
+  },
+];
+
 /**
  * Map a detected issue kind to its triage label. Returns null when unknown.
  */
@@ -258,6 +377,70 @@ function labelForKind(kind) {
   return KIND_TO_LABEL[kind] || null;
 }
 
+/**
+ * Map a template Area dropdown value to orthogonal area label names.
+ * Returns [] for Other / Multiple areas / unknown / empty.
+ *
+ * @param {unknown} areaText
+ * @returns {string[]}
+ */
+function mapAreaFieldToLabels(areaText) {
+  if (typeof areaText !== "string") return [];
+  const key = areaText.replace(/\s+/g, " ").trim().toLowerCase();
+  if (!key) return [];
+  return AREA_FIELD_TO_LABELS[key] ? [...AREA_FIELD_TO_LABELS[key]] : [];
+}
+
+/**
+ * Conservative title/body heuristics for orthogonal area labels.
+ *
+ * @param {string} title
+ * @param {string} body
+ * @returns {string[]}
+ */
+function heuristicAreaLabels(title, body) {
+  const text = `${title || ""}\n${body || ""}`;
+  const out = [];
+  for (const { label, re } of AREA_HEURISTICS) {
+    if (re.test(text)) out.push(label);
+  }
+  return out;
+}
+
+/**
+ * Detect additive product-area labels from Area field, form defaults, and
+ * title/body heuristics. Never invents per-provider labels.
+ *
+ * @param {{ title?: string, body?: string, labels?: string[] }} issue
+ * @returns {string[]}
+ */
+function detectAreaLabels(issue) {
+  const title = typeof issue?.title === "string" ? issue.title : "";
+  const body = typeof issue?.body === "string" ? issue.body : "";
+  const labels = Array.isArray(issue?.labels) ? issue.labels : [];
+
+  const areaSection = extractSection(body, "Area");
+  const fromArea = mapAreaFieldToLabels(areaSection);
+  const fromHeur = heuristicAreaLabels(title, body);
+  const fromForm = [];
+  if (labels.includes("provider-compatibility")) fromForm.push("provider");
+  // Provider-compat form uses this heading instead of Area.
+  if (extractSection(body, "Provider or upstream service") !== null) {
+    fromForm.push("provider");
+  }
+
+  const seen = new Set();
+  const out = [];
+  for (const label of [...fromArea, ...fromForm, ...fromHeur]) {
+    if (!label || seen.has(label)) continue;
+    // `documentation` is a kind label and also an Area mapping target.
+    if (label !== "documentation" && !AREA_LABELS[label]) continue;
+    seen.add(label);
+    out.push(label);
+  }
+  return out;
+}
+
 function countHeadings(body, headings) {
   let n = 0;
   for (const h of headings) {
@@ -952,6 +1135,11 @@ module.exports = {
   hasConcreteDetail,
   labelForKind,
   KIND_TO_LABEL,
+  AREA_LABELS,
+  AREA_FIELD_TO_LABELS,
+  mapAreaFieldToLabels,
+  heuristicAreaLabels,
+  detectAreaLabels,
   hasSubstantialStructuredContent,
   rejectsWorkflowDispatchPullRequest,
   rejectsWorkflowDispatchNonDefaultBranch,

.github/scripts/issue-quality.test.cjs

@@ -13,6 +13,9 @@ const {
   shouldReopen,
   shouldEnforceClosure,
   labelForKind,
+  AREA_LABELS,
+  mapAreaFieldToLabels,
+  detectAreaLabels,
   isPlaceholderOnlyValue,
   isPlaceholder,
   isRawPlaceholder,
@@ -1650,3 +1653,108 @@ describe("rejectsWorkflowDispatchNonDefaultBranch", () => {
     );
   });
 });
+
+// ---------------------------------------------------------------------------
+// Orthogonal area labels
+// ---------------------------------------------------------------------------
+
+describe("mapAreaFieldToLabels", () => {
+  it("maps canonical Area dropdown values", () => {
+    assert.deepEqual(mapAreaFieldToLabels("CLI"), ["cli"]);
+    assert.deepEqual(mapAreaFieldToLabels("Proxy and routing"), ["proxy"]);
+    assert.deepEqual(mapAreaFieldToLabels("Dashboard"), ["gui"]);
+    assert.deepEqual(mapAreaFieldToLabels("Provider adapter"), ["provider"]);
+    assert.deepEqual(mapAreaFieldToLabels("Provider adapters"), ["provider"]);
+    assert.deepEqual(mapAreaFieldToLabels("Authentication and account pool"), ["account-pool"]);
+    assert.deepEqual(mapAreaFieldToLabels("Catalog / models"), ["catalog"]);
+    assert.deepEqual(mapAreaFieldToLabels("Streaming"), ["streaming"]);
+    assert.deepEqual(mapAreaFieldToLabels("Tools / MCP / web search"), ["tools"]);
+    assert.deepEqual(mapAreaFieldToLabels("Installation or packaging"), ["install"]);
+    assert.deepEqual(mapAreaFieldToLabels("Service lifecycle"), ["service"]);
+    assert.deepEqual(mapAreaFieldToLabels("Platform (Windows / macOS / Linux)"), ["platform"]);
+    assert.deepEqual(mapAreaFieldToLabels("Documentation"), ["documentation"]);
+  });
+
+  it("maps legacy Service lifecycle wording and ignores Other / Multiple areas", () => {
+    assert.deepEqual(mapAreaFieldToLabels("Service lifecycle (config injection)"), ["service"]);
+    assert.deepEqual(mapAreaFieldToLabels("Other"), []);
+    assert.deepEqual(mapAreaFieldToLabels("Multiple areas"), []);
+    assert.deepEqual(mapAreaFieldToLabels(""), []);
+    assert.deepEqual(mapAreaFieldToLabels(null), []);
+  });
+
+  it("exposes metadata for every non-documentation area label", () => {
+    for (const name of Object.keys(AREA_LABELS)) {
+      assert.ok(AREA_LABELS[name].color, name);
+      assert.ok(AREA_LABELS[name].description, name);
+    }
+  });
+});
+
+describe("detectAreaLabels", () => {
+  it("applies Area mapping plus orthogonal heuristics", () => {
+    const labels = detectAreaLabels({
+      title: "Pool failover stalls on SSE without terminal frame",
+      body: [
+        "### Area",
+        "Authentication and account pool",
+        "### Summary",
+        "Account pool failover waits forever when the upstream SSE stream ends without a terminal frame.",
+      ].join("\n"),
+      labels: ["bug"],
+    });
+    assert.ok(labels.includes("account-pool"));
+    assert.ok(labels.includes("streaming"));
+  });
+
+  it("adds provider for provider-compatibility form and label", () => {
+    const fromLabel = detectAreaLabels({
+      title: "AgentRouter Anthropic streams can end without terminal SSE frames",
+      body: "### Summary\nStream ends early.",
+      labels: ["provider-compatibility"],
+    });
+    assert.ok(fromLabel.includes("provider"));
+    assert.ok(fromLabel.includes("streaming"));
+
+    const fromHeading = detectAreaLabels({
+      title: "Custom relay rejects tool_calls",
+      body: [
+        "### Provider or upstream service",
+        "Volcengine Ark",
+        "### Current behaviour",
+        "tool_calls with empty content return 400.",
+      ].join("\n"),
+      labels: [],
+    });
+    assert.ok(fromHeading.includes("provider"));
+    assert.ok(fromHeading.includes("tools"));
+  });
+
+  it("runs heuristics for Multiple areas / Other without inventing per-provider labels", () => {
+    const labels = detectAreaLabels({
+      title: "Dashboard ACL hardening blocks management API on Windows",
+      body: [
+        "### Area",
+        "Multiple areas",
+        "### Summary",
+        "OpenCodex dashboard shows no data when ACL/icacls hardening cannot be verified.",
+      ].join("\n"),
+      labels: ["bug"],
+    });
+    assert.ok(labels.includes("gui"));
+    assert.ok(labels.includes("platform"));
+    assert.equal(labels.includes("kiro"), false);
+    assert.equal(labels.includes("gemini"), false);
+    assert.equal(labels.includes("windows"), false);
+  });
+
+  it("maps Documentation Area to documentation and does not invent docs", () => {
+    const labels = detectAreaLabels({
+      title: "Codex Auth UI/docs conflate usage-based switching",
+      body: ["### Area", "Documentation", "### Summary", "Docs misdefine new session."].join("\n"),
+      labels: [],
+    });
+    assert.ok(labels.includes("documentation"));
+    assert.equal(labels.includes("docs"), false);
+  });
+});