@cluesmith/codev-core 3.1.3 → 3.1.6

package/dist/area-grouping.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Render an area name as a human-readable group-header label.
+ *
+ * Display-only. The raw `area` value (the wire string from
+ * `OverviewBacklogItem.area` / `OverviewBuilder.area`, or the
+ * `UNCATEGORIZED_AREA` sentinel) MUST continue to be used for
+ * bucketing (`groupByArea`), id stability, and `===` matchers.
+ *
+ * Rule: uppercase the entire string. Separators (`-`, `_`) are
+ * preserved as-is so the header reads as a single visual token
+ * matching VSCode's own container-label convention (EXPLORER,
+ * SOURCE CONTROL, etc.). Examples:
+ *   'vscode'        -> 'VSCODE'
+ *   'cross-cutting' -> 'CROSS-CUTTING'
+ *   'front_end'     -> 'FRONT_END'
+ *   'Uncategorized' -> 'UNCATEGORIZED'
+ *
+ * Purely structural: no hardcoded list of "known acronyms". Teams
+ * using Codev decide their own labeling semantics; a per-repo
+ * override map can be layered on top as a non-breaking extension.
+ */
+export declare function uppercaseAreaName(area: string): string;
+/**
+ * Bucket items by their resolved area, returning groups in canonical
+ * Codev order: alphabetical specific areas first, then `Uncategorized`
+ * last. Within each group, the input order is preserved (the caller
+ * has already applied any sort policy — display-order for builders,
+ * mine-first for backlog).
+ *
+ * Pure, generic over the item type. Both `views/backlog.ts` and
+ * `views/builders.ts` in the VSCode extension consume this directly,
+ * keying off each item's resolved `area` (already projected on the
+ * server via `parseArea`; see #819). Future consumers (dashboard
+ * equivalents, etc.) reuse the same function so the grouping rule
+ * stays byte-shared, not merely prose-described.
+ */
+export declare function groupByArea<T>(items: T[], getArea: (item: T) => string): Array<{
+    area: string;
+    items: T[];
+}>;
+//# sourceMappingURL=area-grouping.d.ts.map

package/dist/area-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-grouping.d.ts","sourceRoot":"","sources":["../src/area-grouping.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC,CAwBrC"}

package/dist/area-grouping.js

@@ -0,0 +1,65 @@
+import { UNCATEGORIZED_AREA } from './constants.js';
+/**
+ * Render an area name as a human-readable group-header label.
+ *
+ * Display-only. The raw `area` value (the wire string from
+ * `OverviewBacklogItem.area` / `OverviewBuilder.area`, or the
+ * `UNCATEGORIZED_AREA` sentinel) MUST continue to be used for
+ * bucketing (`groupByArea`), id stability, and `===` matchers.
+ *
+ * Rule: uppercase the entire string. Separators (`-`, `_`) are
+ * preserved as-is so the header reads as a single visual token
+ * matching VSCode's own container-label convention (EXPLORER,
+ * SOURCE CONTROL, etc.). Examples:
+ *   'vscode'        -> 'VSCODE'
+ *   'cross-cutting' -> 'CROSS-CUTTING'
+ *   'front_end'     -> 'FRONT_END'
+ *   'Uncategorized' -> 'UNCATEGORIZED'
+ *
+ * Purely structural: no hardcoded list of "known acronyms". Teams
+ * using Codev decide their own labeling semantics; a per-repo
+ * override map can be layered on top as a non-breaking extension.
+ */
+export function uppercaseAreaName(area) {
+    return area.toUpperCase();
+}
+/**
+ * Bucket items by their resolved area, returning groups in canonical
+ * Codev order: alphabetical specific areas first, then `Uncategorized`
+ * last. Within each group, the input order is preserved (the caller
+ * has already applied any sort policy — display-order for builders,
+ * mine-first for backlog).
+ *
+ * Pure, generic over the item type. Both `views/backlog.ts` and
+ * `views/builders.ts` in the VSCode extension consume this directly,
+ * keying off each item's resolved `area` (already projected on the
+ * server via `parseArea`; see #819). Future consumers (dashboard
+ * equivalents, etc.) reuse the same function so the grouping rule
+ * stays byte-shared, not merely prose-described.
+ */
+export function groupByArea(items, getArea) {
+    const buckets = new Map();
+    for (const item of items) {
+        const area = getArea(item);
+        const bucket = buckets.get(area);
+        if (bucket) {
+            bucket.push(item);
+        }
+        else {
+            buckets.set(area, [item]);
+        }
+    }
+    const result = [];
+    const uncategorized = buckets.get(UNCATEGORIZED_AREA);
+    const specifics = [...buckets.keys()]
+        .filter(a => a !== UNCATEGORIZED_AREA)
+        .sort();
+    for (const area of specifics) {
+        result.push({ area, items: buckets.get(area) });
+    }
+    if (uncategorized) {
+        result.push({ area: UNCATEGORIZED_AREA, items: uncategorized });
+    }
+    return result;
+}
+//# sourceMappingURL=area-grouping.js.map

package/dist/area-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-grouping.js","sourceRoot":"","sources":["../src/area-grouping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,KAAU,EACV,OAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAwC,EAAE,CAAC;IACvD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,kBAAkB,CAAC;SACrC,IAAI,EAAE,CAAC;IACV,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/constants.d.ts

@@ -1,3 +1,11 @@
 export declare const DEFAULT_TOWER_PORT = 4100;
 export declare const AGENT_FARM_DIR: string;
+/**
+ * Fallback `area` value emitted by the server when an issue or builder has
+ * no `area/*` label (or — for builders — no associated issue). The single
+ * source of truth so the parser default, the server-side initializer for
+ * builders pending issue-cache enrichment, and any downstream UI filter or
+ * matcher all agree on the literal.
+ */
+export declare const UNCATEGORIZED_AREA = "Uncategorized";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,cAAc,QAAoC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,cAAc,QAAoC,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}

package/dist/constants.js

@@ -2,4 +2,12 @@ import { resolve } from 'node:path';
 import { homedir } from 'node:os';
 export const DEFAULT_TOWER_PORT = 4100;
 export const AGENT_FARM_DIR = resolve(homedir(), '.agent-farm');
+/**
+ * Fallback `area` value emitted by the server when an issue or builder has
+ * no `area/*` label (or — for builders — no associated issue). The single
+ * source of truth so the parser default, the server-side initializer for
+ * builders pending issue-cache enrichment, and any downstream UI filter or
+ * matcher all agree on the literal.
+ */
+export const UNCATEGORIZED_AREA = 'Uncategorized';
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev-core",
-  "version": "3.1.3",
+  "version": "3.1.6",
   "description": "Core runtime utilities for Codev — Tower client, auth, workspace helpers, escape buffer",
   "type": "module",
   "exports": {
@@ -31,6 +31,10 @@
     "./builder-helpers": {
       "types": "./dist/builder-helpers.d.ts",
       "default": "./dist/builder-helpers.js"
+    },
+    "./area-grouping": {
+      "types": "./dist/area-grouping.d.ts",
+      "default": "./dist/area-grouping.js"
     }
   },
   "files": [
@@ -39,7 +43,7 @@
   "devDependencies": {
     "@types/node": "22.x",
     "typescript": "^5.7.0",
-    "@cluesmith/codev-types": "3.1.3"
+    "@cluesmith/codev-types": "3.1.6"
   },
   "license": "Apache-2.0",
   "scripts": {