@sigloch/graphcode-client 1.2.0 → 1.3.0

package/dist/panels.d.ts

@@ -57,6 +57,32 @@ export interface RecommendationsPanel {
     total: number;
 }
 export declare function recommendationsPanel(violations: RuleViolation[], limit?: number): RecommendationsPanel;
+/** One rule's firings, collapsed: the true count plus a NAMED-capped element sample. */
+export interface ViolationGroup {
+    ruleId: string;
+    severity: 'error' | 'warning' | 'info';
+    /** Firings of this rule over the UNCAPPED input — never derived from `elementIds`. */
+    count: number;
+    message: string;
+    fixHint?: string;
+    /** At most `elementLimit` element ids, in input order. */
+    elementIds: string[];
+    /** How many element ids the cap cut off — the cap is never silent. */
+    elementIdsOmitted: number;
+}
+/**
+ * Group violations by ruleId — **group first, cap after**.
+ *
+ * The counting runs over the UNCAPPED violations, never over an already-capped
+ * item list: cap-then-count reports "50×" for a rule that fired 60×, and a wrong
+ * number is worse than a long list (CR-GVE-250). `elementIds` is cut at
+ * `elementLimit` and says via `elementIdsOmitted` how many are missing — a silent
+ * cap is exactly the defect this function exists to prevent.
+ *
+ * Pure projection: the input array is not mutated, and violations without an
+ * `elementId` (graph-scoped findings) still count, they just contribute no id.
+ */
+export declare function groupViolations(violations: RuleViolation[], elementLimit?: number): ViolationGroup[];
 export type Freshness = 'live' | 'stale' | 'absent';
 /**
  * Two artifact kinds with TWO distinct staleness mechanisms (CR-GC-222):

package/dist/panels.js

@@ -27,6 +27,47 @@ export function recommendationsPanel(violations, limit = 5) {
     });
     return { items, total: violations.length };
 }
+/**
+ * Group violations by ruleId — **group first, cap after**.
+ *
+ * The counting runs over the UNCAPPED violations, never over an already-capped
+ * item list: cap-then-count reports "50×" for a rule that fired 60×, and a wrong
+ * number is worse than a long list (CR-GVE-250). `elementIds` is cut at
+ * `elementLimit` and says via `elementIdsOmitted` how many are missing — a silent
+ * cap is exactly the defect this function exists to prevent.
+ *
+ * Pure projection: the input array is not mutated, and violations without an
+ * `elementId` (graph-scoped findings) still count, they just contribute no id.
+ */
+export function groupViolations(violations, elementLimit = 10) {
+    const byRule = new Map();
+    for (const v of violations) {
+        let g = byRule.get(v.ruleId);
+        if (!g) {
+            g = {
+                ruleId: v.ruleId,
+                severity: v.severity,
+                count: 0,
+                message: v.message,
+                fixHint: v.fixHint,
+                elementIds: [],
+                elementIdsOmitted: 0,
+                allElementIds: [],
+            };
+            byRule.set(v.ruleId, g);
+        }
+        g.count += 1;
+        if (v.elementId)
+            g.allElementIds.push(v.elementId);
+    }
+    return [...byRule.values()]
+        .sort((a, b) => b.count - a.count)
+        .map(({ allElementIds, ...g }) => ({
+        ...g,
+        elementIds: allElementIds.slice(0, Math.max(0, elementLimit)),
+        elementIdsOmitted: Math.max(0, allElementIds.length - Math.max(0, elementLimit)),
+    }));
+}
 /**
  * The canonical INCOSE-tab artifact catalog (readiness-artifact-model.md §6). Renders are the
  * deterministic CR-GC-220 views; the 5 analysis ids are exactly CR-GC-221's creation keys

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigloch/graphcode-client",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,11 +37,11 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@sigloch/contracts": ">=5 <7",
+    "@sigloch/contracts": ">=5 <10",
     "@sigloch/graph-api-core": ">=5 <6"
   },
   "devDependencies": {
-    "@sigloch/contracts": "^6.0.0",
+    "@sigloch/contracts": ">=6 <10",
     "@sigloch/graph-api-core": "^5.0.0"
   }
 }