@blumintinc/eslint-plugin-blumint 1.19.8 → 1.19.9

package/lib/index.js

@@ -222,7 +222,7 @@ function noFrontendImportsFromFunctionsPatterns(pattern) {
 module.exports = {
     meta: {
         name: '@blumintinc/eslint-plugin-blumint',
-        version: '1.19.8',
+        version: '1.19.9',
     },
     parseOptions: {
         ecmaVersion: 2020,

package/lib/rules/no-harness-coupled-disables.js

@@ -43,6 +43,29 @@ const SESSION_MATCHER = {
 function isDirectiveComment(comment) {
     return DIRECTIVE_PREFIX.test(comment.value.trim());
 }
+/**
+ * Pointer phrasing by which a directive DEFERS its rationale to an adjacent
+ * comment: "see above", "per the note below", "as noted in the comment".
+ * Up to two intervening words ("the note", "the preceding") are tolerated so
+ * natural phrasings still register as deferrals.
+ */
+const DEFERRAL_PATTERN = /\b(?:see|per|as)\s+(?:\w+\s+){0,2}(?:above|below|note|comment|preceding)\b/i;
+/**
+ * A directive defers to its preceding comment only when its own `--` text is a
+ * mere pointer to that comment ("see above") or carries no substantive words at
+ * all (a bare "^" gesture). This is the discriminating signal for #1296's
+ * split-justification support: a directive that already states a substantive,
+ * self-contained reason owns its rationale outright, so an unrelated docblock or
+ * line comment that merely sits above it — documenting the declaration, not the
+ * suppression — must never contribute its incidental harness keywords (#1312).
+ */
+function defersToPreceding(justification) {
+    const text = justification.trim();
+    if (DEFERRAL_PATTERN.test(text)) {
+        return true;
+    }
+    return text.replace(/[^a-z]/gi, '') === '';
+}
 /**
  * Isolates the justification text of a directive comment: everything after the
  * first `--` separator, spanning every line of a multi-line block body. The
@@ -109,12 +132,16 @@ exports.noHarnessCoupledDisables = (0, createRule_1.createRule)({
                     }
                     // Split-justification style: an immediately-adjacent preceding
                     // non-directive comment (no intervening blank line or code) is part
-                    // of the directive's rationale when the directive defers to it.
+                    // of the directive's rationale ONLY when the directive defers to it.
+                    // Without the deferral gate, an unrelated docblock above the
+                    // declaration bleeds its incidental harness words into a directive
+                    // that already carries a self-contained code-level reason (#1312).
                     let scanned = justification;
                     const previous = comments[index - 1];
                     if (previous &&
                         !isDirectiveComment(previous) &&
-                        comment.loc.start.line - previous.loc.end.line <= 1) {
+                        comment.loc.start.line - previous.loc.end.line <= 1 &&
+                        defersToPreceding(justification)) {
                         scanned = `${previous.value}\n${scanned}`;
                     }
                     const matchedTerm = findHarnessTerm(scanned);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blumintinc/eslint-plugin-blumint",
-  "version": "1.19.8",
+  "version": "1.19.9",
   "description": "Custom eslint rules for use within BluMint",
   "author": {
     "name": "Brodie McGuire",

package/release-manifest.json

@@ -1,4 +1,18 @@
 [
+  {
+    "version": "1.19.9",
+    "date": "2026-07-17T01:27:12.035Z",
+    "rules": [
+      {
+        "name": "no-harness-coupled-disables",
+        "changeType": "fix",
+        "issues": [
+          1312
+        ],
+        "summary": "only merge preceding comment when directive defers to it (closes #1312)"
+      }
+    ]
+  },
   {
     "version": "1.19.8",
     "date": "2026-07-17T00:25:07.461Z",