@sarj/eslint-plugin 15.17.6 → 15.17.8

package/dist/index.cjs

@@ -6869,22 +6869,23 @@ var no_restated_comment_default = createRule({
 // src/rules/no-restated-jsdoc.ts
 var import_utils39 = require("@typescript-eslint/utils");
 var NO_RESTATED_JSDOC_DOCUMENTATION = {
-  summary: "Flag a JSDoc block whose description and tags only re-spell the signature they document.",
+  summary: "Flag JSDoc prose that appears to repeat declaration names without adding behavioral information.",
   rationale: "Signature-only JSDoc duplicates type information and drifts without helping callers.",
   remediation: "Delete the block or document behavior, constraints, failures, or context the signature cannot express.",
   category: "maintainability",
   aliases: ["jsdoc-restates-signature"],
   autofix: "suggestion",
-  limitations: ["Generated files, detached blocks, unknown tags, empty blocks, and JSDoc with information absent from the signature are excluded."],
+  limitations: ["Generated files, detached blocks, intervening comments, unknown tags, explicit JSDoc type payloads, empty blocks, and JSDoc with information absent from the signature are excluded.", "Negation, conditions, constraints, sentinel values, numeric details, and quoted text conservatively preserve the block, even when a declaration name contains the same words."],
   examples: [
     { id: "behavioral-jsdoc", title: "Document behavior absent from the signature", outcome: "no-match", files: [{ path: "src/users.ts", source: "/** Get the user while bypassing the read replica. */\nexport function getUser(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 0, public: true },
-    { id: "signature-jsdoc", title: "Remove JSDoc that only repeats the signature", outcome: "match", files: [{ path: "src/users.ts", source: "/** Get the user by id. */\nexport function getUserById(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true }
+    { id: "signature-jsdoc", title: "Remove JSDoc that only repeats the signature", outcome: "match", files: [{ path: "src/users.ts", source: "/** Get the user by id. */\nexport function getUserById(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true },
+    { id: "negated-behavior", scenarioId: "negation", title: "Keep behavior even when its words resemble the declaration", outcome: "no-match", files: [{ path: "src/users.ts", source: "/** Does not cache the user. */\nexport function cacheUser(user: unknown) { return user; }" }], focusPath: "src/users.ts", expectedCount: 0, public: true },
+    { id: "repeated-behavior-name", scenarioId: "negation", title: "Review prose that merely repeats the declaration name", outcome: "match", files: [{ path: "src/users.ts", source: "/** Cache the user. */\nexport function cacheUser(user: unknown) { return user; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true }
   ]
 };
 var MODELLED_TAGS = /* @__PURE__ */ new Set([
   "arg",
   "argument",
-  "async",
   "description",
   "param",
   "return",
@@ -6903,7 +6904,8 @@ var STOPWORDS2 = new Set(
    returns returning result optional required default true false null undefined
    string number boolean array list promise`.split(/\s+/)
 );
-var WORD_RE2 = /[A-Za-z]+/g;
+var WORD_RE2 = new RegExp("\\p{L}+", "gu");
+var BEHAVIORAL_PROSE_RE = /\b(?:not|no|never|if|when|unless|must|should|may|can|could|would|optional|required|default|true|false|null|undefined|before|after|until|once|again|only|always)\b|\d|["'`<>=+*/%&|!~^-]/i;
 function parseJsDoc(value) {
   const lines = value.replace(/^\*/, "").split("\n").map((line) => line.replace(/^\s*\*?\s?/, ""));
   const description = [];
@@ -6923,12 +6925,13 @@ function parseJsDoc(value) {
   return { description: description.join("\n").trim(), tags };
 }
 function covered(text, known) {
+  if (BEHAVIORAL_PROSE_RE.test(text)) return false;
   const stems = /* @__PURE__ */ new Set();
   for (const token of known) stems.add(stem(token));
   return proseTokens(text).every((word) => known.has(word) || stems.has(stem(word)));
 }
 function proseTokens(text) {
-  return (text.match(WORD_RE2) ?? []).map((word) => word.toLowerCase()).filter((word) => word.length > 1 && !STOPWORDS2.has(word));
+  return (text.match(WORD_RE2) ?? []).map((word) => word.toLowerCase()).filter((word) => !STOPWORDS2.has(word));
 }
 function declarationNames(node) {
   switch (node.type) {
@@ -6985,11 +6988,11 @@ var no_restated_jsdoc_default = createRule({
     type: "suggestion",
     hasSuggestions: true,
     docs: {
-      description: "Flag a JSDoc block whose description and tags only re-spell the signature they document."
+      description: "Flag JSDoc prose that appears to repeat declaration names without adding behavioral information."
     },
     schema: [],
     messages: {
-      restatesSignature: "JSDoc only re-spells the signature \u2014 delete it; if the signature still needs explanation, improve its names or types. Keep constraints, failures, and rationale.",
+      restatesSignature: "JSDoc appears to repeat declaration names \u2014 consider removing repetition. Keep type contracts, constraints, failures, and rationale.",
       deleteBlock: "Delete the JSDoc block."
     }
   },
@@ -7012,8 +7015,9 @@ var no_restated_jsdoc_default = createRule({
           const tagNames = new Set(tags.map((tag) => tag.name));
           if ([...tagNames].some((name) => !MODELLED_TAGS.has(name))) continue;
           if (isProtected(describedText)) continue;
-          const token = sourceCode.getTokenAfter(comment, { includeComments: false });
+          const token = sourceCode.getTokenAfter(comment, { includeComments: true });
           if (token === null || token.loc.start.line !== comment.loc.end.line + 1) continue;
+          if (token.type === "Line" || token.type === "Block") continue;
           let node = sourceCode.getNodeByRangeIndex(token.range[0]);
           let declaration = null;
           while (node != null && node.type !== import_utils39.AST_NODE_TYPES.Program) {
@@ -7024,6 +7028,8 @@ var no_restated_jsdoc_default = createRule({
           if (declaration === null) continue;
           const paramTags = tags.filter((tag) => PARAM_TAGS.has(tag.name));
           const returnTags = tags.filter((tag) => RETURN_TAGS.has(tag.name));
+          if ([...paramTags, ...returnTags].some((tag) => /^\s*\{/.test(tag.text))) continue;
+          if (paramTags.some((tag) => /^\s*(?:\[|[A-Za-z_$][\w$]*\.)/.test(tag.text))) continue;
           if (describedText.length === 0 && paramTags.length === 0 && returnTags.length === 0) {
             continue;
           }
@@ -10074,8 +10080,8 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
   rationale: "Wrapping a TypeScript enum preserves its emitted runtime object and duplicates the schema's value definition across two constructs.",
   remediation: "Pass string literals directly to `z.enum` and derive the TypeScript type with `z.infer`.",
   category: "maintainability",
-  autofix: "safe",
-  limitations: ["Automatic fixes are limited to inline object literals whose unique values are all string literals."],
+  autofix: "none",
+  limitations: ["Migration is manual: replacing an enum-like object with a value array changes the public schema.enum keys and can affect consumers."],
   examples: [
     {
       id: "zod-literal-enum",
@@ -10093,8 +10099,7 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
       files: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.nativeEnum({ Active: "active", Inactive: "inactive" });' }],
       focusPath: "src/status.ts",
       expectedCount: 1,
-      public: true,
-      fixedFiles: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.enum(["active", "inactive"]);' }]
+      public: true
     }
   ]
 };
@@ -10119,26 +10124,6 @@ function unwrap2(node) {
   }
   return node;
 }
-function stringValueTexts(node, sourceCode) {
-  const texts = [];
-  for (const prop of node.properties) {
-    if (prop.type !== import_utils56.AST_NODE_TYPES.Property) {
-      return null;
-    }
-    if (prop.computed || prop.shorthand || prop.method || prop.kind !== "init") {
-      return null;
-    }
-    const value = prop.value;
-    if (value.type !== import_utils56.AST_NODE_TYPES.Literal || typeof value.value !== "string") {
-      return null;
-    }
-    const text = sourceCode.getText(value);
-    if (!texts.includes(text)) {
-      texts.push(text);
-    }
-  }
-  return texts.length > 0 ? texts : null;
-}
 function resolvesToLocalEnum(node, scope) {
   let current = scope;
   while (current !== null) {
@@ -10170,7 +10155,6 @@ var no_zod_native_enum_default = createRule({
   documentation: NO_ZOD_NATIVE_ENUM_DOCUMENTATION,
   meta: {
     type: "suggestion",
-    fixable: "code",
     docs: {
       description: 'Disallow `z.nativeEnum()` (and `z.enum()` over a TypeScript enum); use `z.enum(["a", "b"])` with a string-literal union instead.'
     },
@@ -10215,30 +10199,6 @@ var no_zod_native_enum_default = createRule({
       }
       return false;
     }
-    function buildFix(node) {
-      const callee = node.callee;
-      if (callee.type !== import_utils56.AST_NODE_TYPES.MemberExpression || callee.property.type !== import_utils56.AST_NODE_TYPES.Identifier) {
-        return null;
-      }
-      const arg = node.arguments[0];
-      if (arg === void 0 || node.arguments.length !== 1 || arg.type === import_utils56.AST_NODE_TYPES.SpreadElement) {
-        return null;
-      }
-      const inner = unwrap2(arg);
-      if (inner.type !== import_utils56.AST_NODE_TYPES.ObjectExpression) {
-        return null;
-      }
-      const values = stringValueTexts(inner, sourceCode);
-      if (values === null) {
-        return null;
-      }
-      const property = callee.property;
-      const replacementArg = `[${values.join(", ")}]`;
-      return (fixer) => [
-        fixer.replaceText(property, "enum"),
-        fixer.replaceText(arg, replacementArg)
-      ];
-    }
     return {
       ImportDeclaration(node) {
         if (!isZodModule2(node.source.value)) {
@@ -10259,11 +10219,9 @@ var no_zod_native_enum_default = createRule({
       },
       CallExpression(node) {
         if (isZodMemberCall(node, "nativeEnum")) {
-          const fix = buildFix(node);
           context.report({
             node,
-            messageId: "nativeEnum",
-            ...fix === null ? {} : { fix }
+            messageId: "nativeEnum"
           });
           return;
         }
@@ -12870,11 +12828,11 @@ var PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION = {
   rationale: "One multi-value literal expresses the same closed value domain without repeated schema wrappers.",
   remediation: "Replace the union with z.literal([value1, value2, ...]).",
   category: "maintainability",
-  autofix: "safe",
+  autofix: "none",
   limitations: [
     "Bare zod imports are analyzed only when the rule option explicitly declares zodMajorVersion: 4; explicit zod/v4 entrypoints are self-declaring.",
     "All-string domains are left to zod/prefer-enum-over-literal-union.",
-    "A finding containing comments is not autofixed because moving its trivia is ambiguous."
+    "Migration is manual: ZodLiteral and ZodUnion expose different introspection APIs and validation error shapes even when they accept the same values."
   ],
   examples: [
     {
@@ -12897,10 +12855,6 @@ var PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION = {
         path: "src/schema.ts",
         source: "import { z } from 'zod'; export const Version = z.union([z.literal(1), z.literal(2), z.literal(3)]);"
       }],
-      fixedFiles: [{
-        path: "src/schema.ts",
-        source: "import { z } from 'zod'; export const Version = z.literal([1, 2, 3]);"
-      }],
       focusPath: "src/schema.ts",
       expectedCount: 1,
       public: true
@@ -12930,7 +12884,6 @@ var prefer_multi_value_zod_literal_default = createRule({
   documentation: PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION,
   meta: {
     type: "suggestion",
-    fixable: "code",
     docs: {
       description: "Use the Zod 4 multi-value literal API instead of a union of literal schemas."
     },
@@ -12994,15 +12947,10 @@ var prefer_multi_value_zod_literal_default = createRule({
         }
         if (values.every(isStaticString)) return;
         const namespace = node.callee.object.name;
-        const hasComments = context.sourceCode.getCommentsInside(node).length > 0;
         context.report({
           node,
           messageId: "useMultiValueLiteral",
-          data: { zod: namespace },
-          fix: hasComments ? null : (fixer) => fixer.replaceText(
-            node,
-            `${namespace}.literal([${values.map((value) => context.sourceCode.getText(value)).join(", ")}])`
-          )
+          data: { zod: namespace }
         });
       }
     };
@@ -15433,13 +15381,14 @@ var MIN_RUN_LENGTH = 2;
 var PREFER_WHOLE_OBJECT_ASSERTION_DOCUMENTATION = {
   summary: "Collapse consecutive assertions on one object into a whole-object assertion so related mismatches are reported together.",
   rationale: "One whole-object assertion presents related expectations together and produces a complete structural diff.",
-  remediation: "Replace consecutive member assertions with one `toMatchObject` assertion.",
+  remediation: "Consider one `toMatchObject` assertion for ordinary data objects. Preserve missing-property checks, identity, and getter or proxy behavior when deciding whether to combine assertions.",
   category: "testing",
   aliases: ["strict-test-assertions"],
-  autofix: "safe",
+  autofix: "none",
+  limitations: ["No automatic rewrite: whole-object matching can require previously absent properties and change observable getter or proxy reads."],
   examples: [
     { id: "whole-object", title: "Assert the object once", outcome: "no-match", files: [{ path: "src/user.test.ts", source: "expect(user).toMatchObject({ id: 1, name: 'Ada' });" }], focusPath: "src/user.test.ts", expectedCount: 0, public: true },
-    { id: "member-run", title: "Do not split one object across assertions", outcome: "match", files: [{ path: "src/user.test.ts", source: "expect(user.id).toBe(1);\nexpect(user.name).toBe('Ada');" }], focusPath: "src/user.test.ts", expectedCount: 1, public: true, fixedFiles: [{ path: "src/user.test.ts", source: "expect(user).toMatchObject({ id: 1, name: 'Ada' });\n" }] }
+    { id: "member-run", title: "Consider grouping related data properties", outcome: "match", files: [{ path: "src/user.test.ts", source: "expect(user.id).toBe(1);\nexpect(user.name).toBe('Ada');" }], focusPath: "src/user.test.ts", expectedCount: 1, public: true }
   ]
 };
 function literalText(node, getText) {
@@ -15495,9 +15444,8 @@ var prefer_whole_object_assertion_default = createRule({
     docs: {
       description: "Collapse consecutive assertions on one object into a whole-object assertion so related mismatches are reported together."
     },
-    fixable: "code",
     messages: {
-      combineAssertions: "These {{count}} assertions each check one property of `{{receiver}}` against a literal, so the first mismatch hides the rest. Assert the object once: `expect({{receiver}}).toMatchObject({ \u2026 })`.",
+      combineAssertions: "Consider combining these {{count}} assertions on `{{receiver}}` with `toMatchObject` when structural matching preserves property presence and getter or proxy behavior.",
       assertArrayOnce: "These {{count}} assertions check `{{receiver}}[0]`\u2026`{{receiver}}[{{last}}]` one at a time, which never checks how long `{{receiver}}` is \u2014 extra elements pass unnoticed. Assert the array once: `expect({{receiver}}).{{matcher}}([ \u2026 ])`."
     },
     schema: []
@@ -15568,11 +15516,6 @@ var prefer_whole_object_assertion_default = createRule({
         expectedIsLiteral: literal !== null
       };
     }
-    function hasInterveningComment(run) {
-      return run.some(
-        (assertion, index) => sourceCode.getCommentsInside(assertion.statement).length > 0 || index > 0 && sourceCode.getCommentsBefore(assertion.statement).length > 0
-      );
-    }
     function reportPropertyRun(run) {
       const tree = /* @__PURE__ */ new Map();
       const paths = [];
@@ -15619,16 +15562,10 @@ var prefer_whole_object_assertion_default = createRule({
         return;
       }
       const receiverText = `${sourceCode.getText(first.receiver)}${commonPrefix.map((name) => `.${name}`).join("")}`;
-      const renderTree = (value) => [...value.entries()].map(([name, child]) => `${name}: ${child instanceof Map ? `{ ${renderTree(child)} }` : child}`).join(", ");
-      const properties = renderTree(tree);
       context.report({
         node: first.statement,
         messageId: "combineAssertions",
-        data: { count: String(run.length), receiver: receiverText },
-        fix: hasInterveningComment(run) ? null : (fixer) => [
-          fixer.replaceText(first.statement, `expect(${receiverText}).toMatchObject({ ${properties} });`),
-          ...run.slice(1).map((assertion) => fixer.remove(assertion.statement))
-        ]
+        data: { count: String(run.length), receiver: receiverText }
       });
     }
     function reportIndexRun(run) {
@@ -19752,7 +19689,7 @@ var RULES = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.17.6"
+  version: "15.17.8"
 };
 var APPLICATION_ONLY_RULES = [];
 var LIBRARY_IMPORT_POLICY = ["error", {
@@ -19763,6 +19700,7 @@ var ADVISORY_RULES = [
   "@sarj/excessive-commentary",
   "@sarj/no-bespoke-api-case-conversion",
   "@sarj/no-restated-comment",
+  "@sarj/no-restated-jsdoc",
   "@sarj/prefer-millisecond-control-duration-schema",
   "@sarj/prefer-module-level-refined-schema",
   "@sarj/prefer-multi-value-zod-literal",
@@ -19773,6 +19711,7 @@ var ADVISORY_RULES = [
   "@sarj/prefer-nullish-filter-predicate",
   "@sarj/prefer-shared-zod-enum",
   "@sarj/prefer-switch-for-repeated-equality",
+  "@sarj/prefer-whole-object-assertion",
   "@sarj/require-interface-for-exported-class",
   "@sarj/require-sql-access-class",
   "@sarj/sole-export-matches-filename"
@@ -19811,7 +19750,7 @@ var RECOMMENDED_RULES = {
   "@sarj/no-repeated-string-literal": "error",
   "@sarj/no-router-refresh-polling": "error",
   "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-restated-jsdoc": "warn",
   "@sarj/no-secret-in-log": "error",
   "@sarj/no-server-env-in-client-component": "error",
   "@sarj/no-select-star": "error",
@@ -19851,7 +19790,7 @@ var RECOMMENDED_RULES = {
   "@sarj/prefer-switch-for-repeated-equality": "warn",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-whole-object-assertion": "warn",
   "@sarj/repeated-static-call-cases": "error",
   "@sarj/prefer-zod-infer": "error",
   "@sarj/require-assert-never": "error",
@@ -19907,7 +19846,7 @@ var STRICT_RULES = {
   "@sarj/no-repeated-string-literal": "error",
   "@sarj/no-router-refresh-polling": "error",
   "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-restated-jsdoc": "warn",
   "@sarj/no-secret-in-log": "error",
   "@sarj/no-server-env-in-client-component": "error",
   "@sarj/no-select-star": "error",
@@ -19948,7 +19887,7 @@ var STRICT_RULES = {
   "@sarj/prefer-switch-for-repeated-equality": "warn",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-whole-object-assertion": "warn",
   "@sarj/repeated-static-call-cases": "error",
   "@sarj/prefer-zod-infer": "error",
   "@sarj/require-assert-never": "error",

package/dist/index.d.cts

@@ -320,7 +320,7 @@ declare const RULES: {
 /** @deprecated All repositories use one policy; retained for import compatibility. */
 declare const APPLICATION_ONLY_RULES: readonly [];
 /** Rules staged as non-blocking warnings while corpus adoption evidence accumulates. */
-declare const ADVISORY_RULES: readonly ["@sarj/excessive-commentary", "@sarj/no-bespoke-api-case-conversion", "@sarj/no-restated-comment", "@sarj/prefer-millisecond-control-duration-schema", "@sarj/prefer-module-level-refined-schema", "@sarj/prefer-multi-value-zod-literal", "@sarj/prefer-named-callback-domain", "@sarj/prefer-named-complex-return-type", "@sarj/prefer-node-crypto-hash", "@sarj/prefer-node-fs-promises", "@sarj/prefer-nullish-filter-predicate", "@sarj/prefer-shared-zod-enum", "@sarj/prefer-switch-for-repeated-equality", "@sarj/require-interface-for-exported-class", "@sarj/require-sql-access-class", "@sarj/sole-export-matches-filename"];
+declare const ADVISORY_RULES: readonly ["@sarj/excessive-commentary", "@sarj/no-bespoke-api-case-conversion", "@sarj/no-restated-comment", "@sarj/no-restated-jsdoc", "@sarj/prefer-millisecond-control-duration-schema", "@sarj/prefer-module-level-refined-schema", "@sarj/prefer-multi-value-zod-literal", "@sarj/prefer-named-callback-domain", "@sarj/prefer-named-complex-return-type", "@sarj/prefer-node-crypto-hash", "@sarj/prefer-node-fs-promises", "@sarj/prefer-nullish-filter-predicate", "@sarj/prefer-shared-zod-enum", "@sarj/prefer-switch-for-repeated-equality", "@sarj/prefer-whole-object-assertion", "@sarj/require-interface-for-exported-class", "@sarj/require-sql-access-class", "@sarj/sole-export-matches-filename"];
 declare const RECOMMENDED_RULES: {
     readonly "no-restricted-imports": readonly ["error", {
         readonly paths: {
@@ -538,7 +538,7 @@ declare const RECOMMENDED_RULES: {
     readonly "@sarj/no-repeated-string-literal": "error";
     readonly "@sarj/no-router-refresh-polling": "error";
     readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-restated-jsdoc": "warn";
     readonly "@sarj/no-secret-in-log": "error";
     readonly "@sarj/no-server-env-in-client-component": "error";
     readonly "@sarj/no-select-star": "error";
@@ -582,7 +582,7 @@ declare const RECOMMENDED_RULES: {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "warn";
     readonly "@sarj/repeated-static-call-cases": "error";
     readonly "@sarj/prefer-zod-infer": "error";
     readonly "@sarj/require-assert-never": "error";
@@ -821,7 +821,7 @@ declare const STRICT_RULES: {
     readonly "@sarj/no-repeated-string-literal": "error";
     readonly "@sarj/no-router-refresh-polling": "error";
     readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-restated-jsdoc": "warn";
     readonly "@sarj/no-secret-in-log": "error";
     readonly "@sarj/no-server-env-in-client-component": "error";
     readonly "@sarj/no-select-star": "error";
@@ -866,7 +866,7 @@ declare const STRICT_RULES: {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "warn";
     readonly "@sarj/repeated-static-call-cases": "error";
     readonly "@sarj/prefer-zod-infer": "error";
     readonly "@sarj/require-assert-never": "error";
@@ -893,7 +893,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.17.6";
+        readonly version: "15.17.8";
     };
     readonly rules: {
         readonly "excessive-commentary": DocumentedRule<readonly [], "excessive">;

package/dist/index.d.ts

@@ -320,7 +320,7 @@ declare const RULES: {
 /** @deprecated All repositories use one policy; retained for import compatibility. */
 declare const APPLICATION_ONLY_RULES: readonly [];
 /** Rules staged as non-blocking warnings while corpus adoption evidence accumulates. */
-declare const ADVISORY_RULES: readonly ["@sarj/excessive-commentary", "@sarj/no-bespoke-api-case-conversion", "@sarj/no-restated-comment", "@sarj/prefer-millisecond-control-duration-schema", "@sarj/prefer-module-level-refined-schema", "@sarj/prefer-multi-value-zod-literal", "@sarj/prefer-named-callback-domain", "@sarj/prefer-named-complex-return-type", "@sarj/prefer-node-crypto-hash", "@sarj/prefer-node-fs-promises", "@sarj/prefer-nullish-filter-predicate", "@sarj/prefer-shared-zod-enum", "@sarj/prefer-switch-for-repeated-equality", "@sarj/require-interface-for-exported-class", "@sarj/require-sql-access-class", "@sarj/sole-export-matches-filename"];
+declare const ADVISORY_RULES: readonly ["@sarj/excessive-commentary", "@sarj/no-bespoke-api-case-conversion", "@sarj/no-restated-comment", "@sarj/no-restated-jsdoc", "@sarj/prefer-millisecond-control-duration-schema", "@sarj/prefer-module-level-refined-schema", "@sarj/prefer-multi-value-zod-literal", "@sarj/prefer-named-callback-domain", "@sarj/prefer-named-complex-return-type", "@sarj/prefer-node-crypto-hash", "@sarj/prefer-node-fs-promises", "@sarj/prefer-nullish-filter-predicate", "@sarj/prefer-shared-zod-enum", "@sarj/prefer-switch-for-repeated-equality", "@sarj/prefer-whole-object-assertion", "@sarj/require-interface-for-exported-class", "@sarj/require-sql-access-class", "@sarj/sole-export-matches-filename"];
 declare const RECOMMENDED_RULES: {
     readonly "no-restricted-imports": readonly ["error", {
         readonly paths: {
@@ -538,7 +538,7 @@ declare const RECOMMENDED_RULES: {
     readonly "@sarj/no-repeated-string-literal": "error";
     readonly "@sarj/no-router-refresh-polling": "error";
     readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-restated-jsdoc": "warn";
     readonly "@sarj/no-secret-in-log": "error";
     readonly "@sarj/no-server-env-in-client-component": "error";
     readonly "@sarj/no-select-star": "error";
@@ -582,7 +582,7 @@ declare const RECOMMENDED_RULES: {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "warn";
     readonly "@sarj/repeated-static-call-cases": "error";
     readonly "@sarj/prefer-zod-infer": "error";
     readonly "@sarj/require-assert-never": "error";
@@ -821,7 +821,7 @@ declare const STRICT_RULES: {
     readonly "@sarj/no-repeated-string-literal": "error";
     readonly "@sarj/no-router-refresh-polling": "error";
     readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-restated-jsdoc": "warn";
     readonly "@sarj/no-secret-in-log": "error";
     readonly "@sarj/no-server-env-in-client-component": "error";
     readonly "@sarj/no-select-star": "error";
@@ -866,7 +866,7 @@ declare const STRICT_RULES: {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "warn";
     readonly "@sarj/repeated-static-call-cases": "error";
     readonly "@sarj/prefer-zod-infer": "error";
     readonly "@sarj/require-assert-never": "error";
@@ -893,7 +893,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.17.6";
+        readonly version: "15.17.8";
     };
     readonly rules: {
         readonly "excessive-commentary": DocumentedRule<readonly [], "excessive">;

package/dist/index.js

@@ -6828,22 +6828,23 @@ var no_restated_comment_default = createRule({
 // src/rules/no-restated-jsdoc.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES29 } from "@typescript-eslint/utils";
 var NO_RESTATED_JSDOC_DOCUMENTATION = {
-  summary: "Flag a JSDoc block whose description and tags only re-spell the signature they document.",
+  summary: "Flag JSDoc prose that appears to repeat declaration names without adding behavioral information.",
   rationale: "Signature-only JSDoc duplicates type information and drifts without helping callers.",
   remediation: "Delete the block or document behavior, constraints, failures, or context the signature cannot express.",
   category: "maintainability",
   aliases: ["jsdoc-restates-signature"],
   autofix: "suggestion",
-  limitations: ["Generated files, detached blocks, unknown tags, empty blocks, and JSDoc with information absent from the signature are excluded."],
+  limitations: ["Generated files, detached blocks, intervening comments, unknown tags, explicit JSDoc type payloads, empty blocks, and JSDoc with information absent from the signature are excluded.", "Negation, conditions, constraints, sentinel values, numeric details, and quoted text conservatively preserve the block, even when a declaration name contains the same words."],
   examples: [
     { id: "behavioral-jsdoc", title: "Document behavior absent from the signature", outcome: "no-match", files: [{ path: "src/users.ts", source: "/** Get the user while bypassing the read replica. */\nexport function getUser(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 0, public: true },
-    { id: "signature-jsdoc", title: "Remove JSDoc that only repeats the signature", outcome: "match", files: [{ path: "src/users.ts", source: "/** Get the user by id. */\nexport function getUserById(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true }
+    { id: "signature-jsdoc", title: "Remove JSDoc that only repeats the signature", outcome: "match", files: [{ path: "src/users.ts", source: "/** Get the user by id. */\nexport function getUserById(id: string) { return id; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true },
+    { id: "negated-behavior", scenarioId: "negation", title: "Keep behavior even when its words resemble the declaration", outcome: "no-match", files: [{ path: "src/users.ts", source: "/** Does not cache the user. */\nexport function cacheUser(user: unknown) { return user; }" }], focusPath: "src/users.ts", expectedCount: 0, public: true },
+    { id: "repeated-behavior-name", scenarioId: "negation", title: "Review prose that merely repeats the declaration name", outcome: "match", files: [{ path: "src/users.ts", source: "/** Cache the user. */\nexport function cacheUser(user: unknown) { return user; }" }], focusPath: "src/users.ts", expectedCount: 1, public: true }
   ]
 };
 var MODELLED_TAGS = /* @__PURE__ */ new Set([
   "arg",
   "argument",
-  "async",
   "description",
   "param",
   "return",
@@ -6862,7 +6863,8 @@ var STOPWORDS2 = new Set(
    returns returning result optional required default true false null undefined
    string number boolean array list promise`.split(/\s+/)
 );
-var WORD_RE2 = /[A-Za-z]+/g;
+var WORD_RE2 = new RegExp("\\p{L}+", "gu");
+var BEHAVIORAL_PROSE_RE = /\b(?:not|no|never|if|when|unless|must|should|may|can|could|would|optional|required|default|true|false|null|undefined|before|after|until|once|again|only|always)\b|\d|["'`<>=+*/%&|!~^-]/i;
 function parseJsDoc(value) {
   const lines = value.replace(/^\*/, "").split("\n").map((line) => line.replace(/^\s*\*?\s?/, ""));
   const description = [];
@@ -6882,12 +6884,13 @@ function parseJsDoc(value) {
   return { description: description.join("\n").trim(), tags };
 }
 function covered(text, known) {
+  if (BEHAVIORAL_PROSE_RE.test(text)) return false;
   const stems = /* @__PURE__ */ new Set();
   for (const token of known) stems.add(stem(token));
   return proseTokens(text).every((word) => known.has(word) || stems.has(stem(word)));
 }
 function proseTokens(text) {
-  return (text.match(WORD_RE2) ?? []).map((word) => word.toLowerCase()).filter((word) => word.length > 1 && !STOPWORDS2.has(word));
+  return (text.match(WORD_RE2) ?? []).map((word) => word.toLowerCase()).filter((word) => !STOPWORDS2.has(word));
 }
 function declarationNames(node) {
   switch (node.type) {
@@ -6944,11 +6947,11 @@ var no_restated_jsdoc_default = createRule({
     type: "suggestion",
     hasSuggestions: true,
     docs: {
-      description: "Flag a JSDoc block whose description and tags only re-spell the signature they document."
+      description: "Flag JSDoc prose that appears to repeat declaration names without adding behavioral information."
     },
     schema: [],
     messages: {
-      restatesSignature: "JSDoc only re-spells the signature \u2014 delete it; if the signature still needs explanation, improve its names or types. Keep constraints, failures, and rationale.",
+      restatesSignature: "JSDoc appears to repeat declaration names \u2014 consider removing repetition. Keep type contracts, constraints, failures, and rationale.",
       deleteBlock: "Delete the JSDoc block."
     }
   },
@@ -6971,8 +6974,9 @@ var no_restated_jsdoc_default = createRule({
           const tagNames = new Set(tags.map((tag) => tag.name));
           if ([...tagNames].some((name) => !MODELLED_TAGS.has(name))) continue;
           if (isProtected(describedText)) continue;
-          const token = sourceCode.getTokenAfter(comment, { includeComments: false });
+          const token = sourceCode.getTokenAfter(comment, { includeComments: true });
           if (token === null || token.loc.start.line !== comment.loc.end.line + 1) continue;
+          if (token.type === "Line" || token.type === "Block") continue;
           let node = sourceCode.getNodeByRangeIndex(token.range[0]);
           let declaration = null;
           while (node != null && node.type !== AST_NODE_TYPES29.Program) {
@@ -6983,6 +6987,8 @@ var no_restated_jsdoc_default = createRule({
           if (declaration === null) continue;
           const paramTags = tags.filter((tag) => PARAM_TAGS.has(tag.name));
           const returnTags = tags.filter((tag) => RETURN_TAGS.has(tag.name));
+          if ([...paramTags, ...returnTags].some((tag) => /^\s*\{/.test(tag.text))) continue;
+          if (paramTags.some((tag) => /^\s*(?:\[|[A-Za-z_$][\w$]*\.)/.test(tag.text))) continue;
           if (describedText.length === 0 && paramTags.length === 0 && returnTags.length === 0) {
             continue;
           }
@@ -10040,8 +10046,8 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
   rationale: "Wrapping a TypeScript enum preserves its emitted runtime object and duplicates the schema's value definition across two constructs.",
   remediation: "Pass string literals directly to `z.enum` and derive the TypeScript type with `z.infer`.",
   category: "maintainability",
-  autofix: "safe",
-  limitations: ["Automatic fixes are limited to inline object literals whose unique values are all string literals."],
+  autofix: "none",
+  limitations: ["Migration is manual: replacing an enum-like object with a value array changes the public schema.enum keys and can affect consumers."],
   examples: [
     {
       id: "zod-literal-enum",
@@ -10059,8 +10065,7 @@ var NO_ZOD_NATIVE_ENUM_DOCUMENTATION = {
       files: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.nativeEnum({ Active: "active", Inactive: "inactive" });' }],
       focusPath: "src/status.ts",
       expectedCount: 1,
-      public: true,
-      fixedFiles: [{ path: "src/status.ts", source: 'import { z } from "zod"; const S = z.enum(["active", "inactive"]);' }]
+      public: true
     }
   ]
 };
@@ -10085,26 +10090,6 @@ function unwrap2(node) {
   }
   return node;
 }
-function stringValueTexts(node, sourceCode) {
-  const texts = [];
-  for (const prop of node.properties) {
-    if (prop.type !== AST_NODE_TYPES41.Property) {
-      return null;
-    }
-    if (prop.computed || prop.shorthand || prop.method || prop.kind !== "init") {
-      return null;
-    }
-    const value = prop.value;
-    if (value.type !== AST_NODE_TYPES41.Literal || typeof value.value !== "string") {
-      return null;
-    }
-    const text = sourceCode.getText(value);
-    if (!texts.includes(text)) {
-      texts.push(text);
-    }
-  }
-  return texts.length > 0 ? texts : null;
-}
 function resolvesToLocalEnum(node, scope) {
   let current = scope;
   while (current !== null) {
@@ -10136,7 +10121,6 @@ var no_zod_native_enum_default = createRule({
   documentation: NO_ZOD_NATIVE_ENUM_DOCUMENTATION,
   meta: {
     type: "suggestion",
-    fixable: "code",
     docs: {
       description: 'Disallow `z.nativeEnum()` (and `z.enum()` over a TypeScript enum); use `z.enum(["a", "b"])` with a string-literal union instead.'
     },
@@ -10181,30 +10165,6 @@ var no_zod_native_enum_default = createRule({
       }
       return false;
     }
-    function buildFix(node) {
-      const callee = node.callee;
-      if (callee.type !== AST_NODE_TYPES41.MemberExpression || callee.property.type !== AST_NODE_TYPES41.Identifier) {
-        return null;
-      }
-      const arg = node.arguments[0];
-      if (arg === void 0 || node.arguments.length !== 1 || arg.type === AST_NODE_TYPES41.SpreadElement) {
-        return null;
-      }
-      const inner = unwrap2(arg);
-      if (inner.type !== AST_NODE_TYPES41.ObjectExpression) {
-        return null;
-      }
-      const values = stringValueTexts(inner, sourceCode);
-      if (values === null) {
-        return null;
-      }
-      const property = callee.property;
-      const replacementArg = `[${values.join(", ")}]`;
-      return (fixer) => [
-        fixer.replaceText(property, "enum"),
-        fixer.replaceText(arg, replacementArg)
-      ];
-    }
     return {
       ImportDeclaration(node) {
         if (!isZodModule2(node.source.value)) {
@@ -10225,11 +10185,9 @@ var no_zod_native_enum_default = createRule({
       },
       CallExpression(node) {
         if (isZodMemberCall(node, "nativeEnum")) {
-          const fix = buildFix(node);
           context.report({
             node,
-            messageId: "nativeEnum",
-            ...fix === null ? {} : { fix }
+            messageId: "nativeEnum"
           });
           return;
         }
@@ -12848,11 +12806,11 @@ var PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION = {
   rationale: "One multi-value literal expresses the same closed value domain without repeated schema wrappers.",
   remediation: "Replace the union with z.literal([value1, value2, ...]).",
   category: "maintainability",
-  autofix: "safe",
+  autofix: "none",
   limitations: [
     "Bare zod imports are analyzed only when the rule option explicitly declares zodMajorVersion: 4; explicit zod/v4 entrypoints are self-declaring.",
     "All-string domains are left to zod/prefer-enum-over-literal-union.",
-    "A finding containing comments is not autofixed because moving its trivia is ambiguous."
+    "Migration is manual: ZodLiteral and ZodUnion expose different introspection APIs and validation error shapes even when they accept the same values."
   ],
   examples: [
     {
@@ -12875,10 +12833,6 @@ var PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION = {
         path: "src/schema.ts",
         source: "import { z } from 'zod'; export const Version = z.union([z.literal(1), z.literal(2), z.literal(3)]);"
       }],
-      fixedFiles: [{
-        path: "src/schema.ts",
-        source: "import { z } from 'zod'; export const Version = z.literal([1, 2, 3]);"
-      }],
       focusPath: "src/schema.ts",
       expectedCount: 1,
       public: true
@@ -12908,7 +12862,6 @@ var prefer_multi_value_zod_literal_default = createRule({
   documentation: PREFER_MULTI_VALUE_ZOD_LITERAL_DOCUMENTATION,
   meta: {
     type: "suggestion",
-    fixable: "code",
     docs: {
       description: "Use the Zod 4 multi-value literal API instead of a union of literal schemas."
     },
@@ -12972,15 +12925,10 @@ var prefer_multi_value_zod_literal_default = createRule({
         }
         if (values.every(isStaticString)) return;
         const namespace = node.callee.object.name;
-        const hasComments = context.sourceCode.getCommentsInside(node).length > 0;
         context.report({
           node,
           messageId: "useMultiValueLiteral",
-          data: { zod: namespace },
-          fix: hasComments ? null : (fixer) => fixer.replaceText(
-            node,
-            `${namespace}.literal([${values.map((value) => context.sourceCode.getText(value)).join(", ")}])`
-          )
+          data: { zod: namespace }
         });
       }
     };
@@ -15419,13 +15367,14 @@ var MIN_RUN_LENGTH = 2;
 var PREFER_WHOLE_OBJECT_ASSERTION_DOCUMENTATION = {
   summary: "Collapse consecutive assertions on one object into a whole-object assertion so related mismatches are reported together.",
   rationale: "One whole-object assertion presents related expectations together and produces a complete structural diff.",
-  remediation: "Replace consecutive member assertions with one `toMatchObject` assertion.",
+  remediation: "Consider one `toMatchObject` assertion for ordinary data objects. Preserve missing-property checks, identity, and getter or proxy behavior when deciding whether to combine assertions.",
   category: "testing",
   aliases: ["strict-test-assertions"],
-  autofix: "safe",
+  autofix: "none",
+  limitations: ["No automatic rewrite: whole-object matching can require previously absent properties and change observable getter or proxy reads."],
   examples: [
     { id: "whole-object", title: "Assert the object once", outcome: "no-match", files: [{ path: "src/user.test.ts", source: "expect(user).toMatchObject({ id: 1, name: 'Ada' });" }], focusPath: "src/user.test.ts", expectedCount: 0, public: true },
-    { id: "member-run", title: "Do not split one object across assertions", outcome: "match", files: [{ path: "src/user.test.ts", source: "expect(user.id).toBe(1);\nexpect(user.name).toBe('Ada');" }], focusPath: "src/user.test.ts", expectedCount: 1, public: true, fixedFiles: [{ path: "src/user.test.ts", source: "expect(user).toMatchObject({ id: 1, name: 'Ada' });\n" }] }
+    { id: "member-run", title: "Consider grouping related data properties", outcome: "match", files: [{ path: "src/user.test.ts", source: "expect(user.id).toBe(1);\nexpect(user.name).toBe('Ada');" }], focusPath: "src/user.test.ts", expectedCount: 1, public: true }
   ]
 };
 function literalText(node, getText) {
@@ -15481,9 +15430,8 @@ var prefer_whole_object_assertion_default = createRule({
     docs: {
       description: "Collapse consecutive assertions on one object into a whole-object assertion so related mismatches are reported together."
     },
-    fixable: "code",
     messages: {
-      combineAssertions: "These {{count}} assertions each check one property of `{{receiver}}` against a literal, so the first mismatch hides the rest. Assert the object once: `expect({{receiver}}).toMatchObject({ \u2026 })`.",
+      combineAssertions: "Consider combining these {{count}} assertions on `{{receiver}}` with `toMatchObject` when structural matching preserves property presence and getter or proxy behavior.",
       assertArrayOnce: "These {{count}} assertions check `{{receiver}}[0]`\u2026`{{receiver}}[{{last}}]` one at a time, which never checks how long `{{receiver}}` is \u2014 extra elements pass unnoticed. Assert the array once: `expect({{receiver}}).{{matcher}}([ \u2026 ])`."
     },
     schema: []
@@ -15554,11 +15502,6 @@ var prefer_whole_object_assertion_default = createRule({
         expectedIsLiteral: literal !== null
       };
     }
-    function hasInterveningComment(run) {
-      return run.some(
-        (assertion, index) => sourceCode.getCommentsInside(assertion.statement).length > 0 || index > 0 && sourceCode.getCommentsBefore(assertion.statement).length > 0
-      );
-    }
     function reportPropertyRun(run) {
       const tree = /* @__PURE__ */ new Map();
       const paths = [];
@@ -15605,16 +15548,10 @@ var prefer_whole_object_assertion_default = createRule({
         return;
       }
       const receiverText = `${sourceCode.getText(first.receiver)}${commonPrefix.map((name) => `.${name}`).join("")}`;
-      const renderTree = (value) => [...value.entries()].map(([name, child]) => `${name}: ${child instanceof Map ? `{ ${renderTree(child)} }` : child}`).join(", ");
-      const properties = renderTree(tree);
       context.report({
         node: first.statement,
         messageId: "combineAssertions",
-        data: { count: String(run.length), receiver: receiverText },
-        fix: hasInterveningComment(run) ? null : (fixer) => [
-          fixer.replaceText(first.statement, `expect(${receiverText}).toMatchObject({ ${properties} });`),
-          ...run.slice(1).map((assertion) => fixer.remove(assertion.statement))
-        ]
+        data: { count: String(run.length), receiver: receiverText }
       });
     }
     function reportIndexRun(run) {
@@ -19747,7 +19684,7 @@ var RULES = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.17.6"
+  version: "15.17.8"
 };
 var APPLICATION_ONLY_RULES = [];
 var LIBRARY_IMPORT_POLICY = ["error", {
@@ -19758,6 +19695,7 @@ var ADVISORY_RULES = [
   "@sarj/excessive-commentary",
   "@sarj/no-bespoke-api-case-conversion",
   "@sarj/no-restated-comment",
+  "@sarj/no-restated-jsdoc",
   "@sarj/prefer-millisecond-control-duration-schema",
   "@sarj/prefer-module-level-refined-schema",
   "@sarj/prefer-multi-value-zod-literal",
@@ -19768,6 +19706,7 @@ var ADVISORY_RULES = [
   "@sarj/prefer-nullish-filter-predicate",
   "@sarj/prefer-shared-zod-enum",
   "@sarj/prefer-switch-for-repeated-equality",
+  "@sarj/prefer-whole-object-assertion",
   "@sarj/require-interface-for-exported-class",
   "@sarj/require-sql-access-class",
   "@sarj/sole-export-matches-filename"
@@ -19806,7 +19745,7 @@ var RECOMMENDED_RULES = {
   "@sarj/no-repeated-string-literal": "error",
   "@sarj/no-router-refresh-polling": "error",
   "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-restated-jsdoc": "warn",
   "@sarj/no-secret-in-log": "error",
   "@sarj/no-server-env-in-client-component": "error",
   "@sarj/no-select-star": "error",
@@ -19846,7 +19785,7 @@ var RECOMMENDED_RULES = {
   "@sarj/prefer-switch-for-repeated-equality": "warn",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-whole-object-assertion": "warn",
   "@sarj/repeated-static-call-cases": "error",
   "@sarj/prefer-zod-infer": "error",
   "@sarj/require-assert-never": "error",
@@ -19902,7 +19841,7 @@ var STRICT_RULES = {
   "@sarj/no-repeated-string-literal": "error",
   "@sarj/no-router-refresh-polling": "error",
   "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-restated-jsdoc": "warn",
   "@sarj/no-secret-in-log": "error",
   "@sarj/no-server-env-in-client-component": "error",
   "@sarj/no-select-star": "error",
@@ -19943,7 +19882,7 @@ var STRICT_RULES = {
   "@sarj/prefer-switch-for-repeated-equality": "warn",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-whole-object-assertion": "warn",
   "@sarj/repeated-static-call-cases": "error",
   "@sarj/prefer-zod-infer": "error",
   "@sarj/require-assert-never": "error",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "15.17.6",
+  "version": "15.17.8",
   "packageManager": "npm@12.0.2",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",