@sigloch/graphcode-client 1.2.0 → 1.3.1

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/dist/readiness-completeness.d.ts

@@ -56,7 +56,10 @@ export interface CompletenessLeg {
  *        no dedicated SYS→UC rule exists, R-17 is the closest twin),
  *        UC→FCHAIN = UC-03, UC→REQ = UC-01.
  *   PDR: FCHAIN→FUNC = R-15, FCHAIN-actor-bounded = FC-04 (trigger+consumer).
- *   CDR: FLOW→SCHEMA = SC-04 (sharp per-FLOW version of SC-02).
+ *   CDR: FLOW→SCHEMA = R-18 (seit CR-SM-271: die Untergrenze ist Grammatik,
+ *        `FLOW -relation-> SCHEMA [1..1]` — SC-04 existiert nicht mehr; ein
+ *        R-18-Befund am FLOW heisst "Kanten ungrammatisch", inkl. fehlendem
+ *        oder doppeltem SCHEMA).
  *   TRR: TEST.testRefs = R-19, FUNC.realRef = R-20.
  */
 export declare const COMPLETENESS_SLICES: Record<string, CompletenessLeg[]>;

package/dist/readiness-completeness.js

@@ -8,7 +8,10 @@ export const typeOf = (byId, id) => byId.get(id)?.type;
  *        no dedicated SYS→UC rule exists, R-17 is the closest twin),
  *        UC→FCHAIN = UC-03, UC→REQ = UC-01.
  *   PDR: FCHAIN→FUNC = R-15, FCHAIN-actor-bounded = FC-04 (trigger+consumer).
- *   CDR: FLOW→SCHEMA = SC-04 (sharp per-FLOW version of SC-02).
+ *   CDR: FLOW→SCHEMA = R-18 (seit CR-SM-271: die Untergrenze ist Grammatik,
+ *        `FLOW -relation-> SCHEMA [1..1]` — SC-04 existiert nicht mehr; ein
+ *        R-18-Befund am FLOW heisst "Kanten ungrammatisch", inkl. fehlendem
+ *        oder doppeltem SCHEMA).
  *   TRR: TEST.testRefs = R-19, FUNC.realRef = R-20.
  */
 export const COMPLETENESS_SLICES = {
@@ -24,8 +27,9 @@ export const COMPLETENESS_SLICES = {
         { id: 'FCHAIN-actor-bounded', sourceType: 'FCHAIN', ruleId: 'FC-04' },
     ],
     // Interfaces carry a data contract: every FLOW has a SCHEMA (CR-GC-106 schema-before-code).
+    // CR-SM-271: SC-04 entfiel — der Fall meldet als R-18 (Untergrenzen-Bein) am FLOW.
     CDR: [
-        { id: 'FLOW→SCHEMA', sourceType: 'FLOW', ruleId: 'SC-04' },
+        { id: 'FLOW→SCHEMA', sourceType: 'FLOW', ruleId: 'R-18' },
     ],
     // Binding: tests are runnable and functions carry code — concept/external exemptions
     // are R-19/R-20's own business now (single source of truth), not re-decided here.

package/package.json

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