@grayhaven/nerve-rules 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -56,4 +56,37 @@ declare const isShieldSignal: (signal: string) => boolean;
  */
 declare const differentialPartner: (signal: string) => string | undefined;
 
-export { AMPACITY_BY_AWG, branchMissingLabel, builtinRules, differentialPairNotTwisted, differentialPartner, gaugeCurrentMismatch, gaugeOutsideConnectorRange, isGroundSignal, isPowerSignal, isShieldSignal, missingGroundReturn, missingRevision, missingSeal, missingWireColor, missingWireGauge, missingWireLength, parseAwg, requireApprovedParts, requiredAwgForCurrent, sealIncompatible, shieldDrainUnconnected, spliceMissingNotes, terminalIncompatible, twistGroupTooSmall, unconnectedAssignedPin, wireSignalMismatch };
+/**
+ * Numeric view of rule codes, for computation: sorting, bitsets, category
+ * math, compact storage. Derived — not a registry — so it can never drift
+ * from the codes and never needs maintenance when rules are added.
+ *
+ * Scheme: HK-<CATEGORY>-<NNN> → band(category) + NNN.
+ *   HK-DOC-001  → 1001
+ *   HK-MFG-004  → 2004
+ *   HK-WIRE-004 → 3004
+ *   HK-ELEC-003 → 4003
+ *   HK-CONN-011 → 5011
+ *
+ * The string code remains the public contract (CI gates, waivers, docs);
+ * numbers are an internal computational view. Custom rule codes (ORG-*,
+ * SHOP-*) deliberately return undefined — callers fall back to strings.
+ */
+declare const RULE_CATEGORY_BANDS: {
+    readonly DOC: 1000;
+    readonly MFG: 2000;
+    readonly WIRE: 3000;
+    readonly ELEC: 4000;
+    readonly CONN: 5000;
+};
+type RuleCategory = keyof typeof RULE_CATEGORY_BANDS;
+/** `"HK-CONN-011"` → `5011`. Undefined for non-HK codes. */
+declare const ruleCodeNumber: (code: string) => number | undefined;
+/** `5011` → `"HK-CONN-011"`. Undefined for numbers outside the bands. */
+declare const ruleCodeFromNumber: (n: number) => string | undefined;
+/** Category of a code (or its number): `"HK-MFG-004"` / `2004` → `"MFG"`. */
+declare const ruleCategory: (code: string | number) => RuleCategory | undefined;
+/** Compact set of fired rules for telemetry / waiver storage. */
+declare const codesToNumbers: (codes: ReadonlyArray<string>) => ReadonlyArray<number>;
+
+export { AMPACITY_BY_AWG, RULE_CATEGORY_BANDS, type RuleCategory, branchMissingLabel, builtinRules, codesToNumbers, differentialPairNotTwisted, differentialPartner, gaugeCurrentMismatch, gaugeOutsideConnectorRange, isGroundSignal, isPowerSignal, isShieldSignal, missingGroundReturn, missingRevision, missingSeal, missingWireColor, missingWireGauge, missingWireLength, parseAwg, requireApprovedParts, requiredAwgForCurrent, ruleCategory, ruleCodeFromNumber, ruleCodeNumber, sealIncompatible, shieldDrainUnconnected, spliceMissingNotes, terminalIncompatible, twistGroupTooSmall, unconnectedAssignedPin, wireSignalMismatch };

package/dist/index.js

@@ -32,7 +32,7 @@ var requiredAwgForCurrent = (current) => {
   return candidates.length > 0 ? Math.max(...candidates) : void 0;
 };
 var POWER_SIGNAL = /^(VBAT|VCC|VDD|VIN|VSYS|PWR|\+?\d+(\.\d+)?V)/i;
-var GROUND_SIGNAL = /^(GND|GROUND|0V|RTN|RETURN|VSS)/i;
+var GROUND_SIGNAL = /(^|_)([ADPSC]?GND|GROUND|0V|RTN|RETURN|VSS)(_|$)/i;
 var SHIELD_SIGNAL = /(SHIELD|DRAIN|SHLD)/i;
 var isPowerSignal = (signal) => POWER_SIGNAL.test(signal);
 var isGroundSignal = (signal) => GROUND_SIGNAL.test(signal);
@@ -40,8 +40,9 @@ var isShieldSignal = (signal) => SHIELD_SIGNAL.test(signal);
 var differentialPartner = (signal) => {
   const s = signal.toUpperCase();
   const table = [
-    [/^(.*)CAN_?H$/, (m) => m.replace(/CAN_?H$/, (h) => h.replace("H", "L"))],
-    [/^(.*)CAN_?L$/, (m) => m.replace(/CAN_?L$/, (l) => l.replace("L", "H"))],
+    // Bus index allowed: CAN_H, CANH, CAN1_H, MOTOR_CAN2_H all pair.
+    [/^(.*)CAN\d*_?H$/, (m) => m.slice(0, -1) + "L"],
+    [/^(.*)CAN\d*_?L$/, (m) => m.slice(0, -1) + "H"],
     [/^(.*)RS485_?A$/, (m) => m.slice(0, -1) + "B"],
     [/^(.*)RS485_?B$/, (m) => m.slice(0, -1) + "A"],
     [/^(.*)_P$/, (m) => m.slice(0, -2) + "_N"],
@@ -419,10 +420,45 @@ var builtinRules = [
   missingSeal,
   sealIncompatible
 ];
+
+// src/code-numbers.ts
+var RULE_CATEGORY_BANDS = {
+  DOC: 1e3,
+  MFG: 2e3,
+  WIRE: 3e3,
+  ELEC: 4e3,
+  CONN: 5e3
+};
+var CODE_PATTERN = /^HK-(DOC|MFG|WIRE|ELEC|CONN)-(\d{3})$/;
+var ruleCodeNumber = (code) => {
+  const m = CODE_PATTERN.exec(code);
+  if (m === null) return void 0;
+  return RULE_CATEGORY_BANDS[m[1]] + Number(m[2]);
+};
+var ruleCodeFromNumber = (n) => {
+  if (!Number.isInteger(n)) return void 0;
+  const band = Math.floor(n / 1e3) * 1e3;
+  const suffix = n - band;
+  if (suffix < 1 || suffix > 999) return void 0;
+  const category = Object.entries(RULE_CATEGORY_BANDS).find(([, b]) => b === band)?.[0];
+  if (category === void 0) return void 0;
+  return `HK-${category}-${String(suffix).padStart(3, "0")}`;
+};
+var ruleCategory = (code) => {
+  const n = typeof code === "number" ? code : ruleCodeNumber(code);
+  if (n === void 0) return void 0;
+  const band = Math.floor(n / 1e3) * 1e3;
+  return Object.entries(RULE_CATEGORY_BANDS).find(([, b]) => b === band)?.[0];
+};
+var codesToNumbers = (codes) => [...new Set(codes.map(ruleCodeNumber).filter((n) => n !== void 0))].sort(
+  (a, b) => a - b
+);
 export {
   AMPACITY_BY_AWG,
+  RULE_CATEGORY_BANDS,
   branchMissingLabel,
   builtinRules,
+  codesToNumbers,
   differentialPairNotTwisted,
   differentialPartner,
   gaugeCurrentMismatch,
@@ -439,6 +475,9 @@ export {
   parseAwg,
   requireApprovedParts,
   requiredAwgForCurrent,
+  ruleCategory,
+  ruleCodeFromNumber,
+  ruleCodeNumber,
   sealIncompatible,
   shieldDrainUnconnected,
   spliceMissingNotes,

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@grayhaven/nerve-rules",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "Built-in validation and linting rules for Grayhaven Nerve.",
   "exports": {
     ".": "./src/index.ts"
   },
   "dependencies": {
-    "@grayhaven/nerve": "0.2.0"
+    "@grayhaven/nerve": "0.2.1"
   },
   "devDependencies": {
-    "@grayhaven/nerve-connectors": "0.2.0",
+    "@grayhaven/nerve-connectors": "0.2.1",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"
   },