@sarj/eslint-plugin 2.13.0 → 2.14.0

package/dist/index.d.cts

@@ -343,6 +343,9 @@ declare const rules: {
     "trailing-value-narration": _typescript_eslint_utils_ts_eslint.RuleModule<"narratesValue", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "no-tautological-expect": _typescript_eslint_utils_ts_eslint.RuleModule<"tautologicalComparison" | "tautologicalMatcher", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
 };
 declare const plugin: {
     meta: {
@@ -496,6 +499,9 @@ declare const plugin: {
         "trailing-value-narration": _typescript_eslint_utils_ts_eslint.RuleModule<"narratesValue", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "no-tautological-expect": _typescript_eslint_utils_ts_eslint.RuleModule<"tautologicalComparison" | "tautologicalMatcher", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
     };
     configs: {
         recommended: {
@@ -542,6 +548,7 @@ declare const plugin: {
                 "@sarj/no-restated-comment": string;
                 "@sarj/jsdoc-restates-signature": string;
                 "@sarj/trailing-value-narration": string;
+                "@sarj/no-tautological-expect": string;
             };
         };
         strict: {
@@ -593,6 +600,7 @@ declare const plugin: {
                 "@sarj/no-restated-comment": string;
                 "@sarj/jsdoc-restates-signature": string;
                 "@sarj/trailing-value-narration": string;
+                "@sarj/no-tautological-expect": string;
             };
         };
     };

package/dist/index.d.ts

@@ -343,6 +343,9 @@ declare const rules: {
     "trailing-value-narration": _typescript_eslint_utils_ts_eslint.RuleModule<"narratesValue", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "no-tautological-expect": _typescript_eslint_utils_ts_eslint.RuleModule<"tautologicalComparison" | "tautologicalMatcher", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
 };
 declare const plugin: {
     meta: {
@@ -496,6 +499,9 @@ declare const plugin: {
         "trailing-value-narration": _typescript_eslint_utils_ts_eslint.RuleModule<"narratesValue", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "no-tautological-expect": _typescript_eslint_utils_ts_eslint.RuleModule<"tautologicalComparison" | "tautologicalMatcher", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
     };
     configs: {
         recommended: {
@@ -542,6 +548,7 @@ declare const plugin: {
                 "@sarj/no-restated-comment": string;
                 "@sarj/jsdoc-restates-signature": string;
                 "@sarj/trailing-value-narration": string;
+                "@sarj/no-tautological-expect": string;
             };
         };
         strict: {
@@ -593,6 +600,7 @@ declare const plugin: {
                 "@sarj/no-restated-comment": string;
                 "@sarj/jsdoc-restates-signature": string;
                 "@sarj/trailing-value-narration": string;
+                "@sarj/no-tautological-expect": string;
             };
         };
     };

package/dist/index.js

@@ -7157,6 +7157,107 @@ var trailing_value_narration_default = ESLintUtils44.RuleCreator(
   }
 });
 
+// src/rules/no-tautological-expect.ts
+import { AST_NODE_TYPES as AST_NODE_TYPES32, ESLintUtils as ESLintUtils45 } from "@typescript-eslint/utils";
+var EQUALITY_MATCHERS = /* @__PURE__ */ new Set(["toBe", "toEqual", "toStrictEqual"]);
+var ZERO_ARG_MATCHERS = /* @__PURE__ */ new Set([
+  "toBeDefined",
+  "toBeUndefined",
+  "toBeNull",
+  "toBeTruthy",
+  "toBeFalsy",
+  "toBeNaN"
+]);
+var OPERAND_PREVIEW_CHARS = 40;
+var NUMERIC_SIGNS = /* @__PURE__ */ new Set(["-", "+"]);
+function isLiteral(node) {
+  switch (node.type) {
+    case AST_NODE_TYPES32.Literal:
+      return true;
+    case AST_NODE_TYPES32.TemplateLiteral:
+      return node.expressions.length === 0;
+    case AST_NODE_TYPES32.UnaryExpression:
+      return NUMERIC_SIGNS.has(node.operator) && isLiteral(node.argument);
+    case AST_NODE_TYPES32.ArrayExpression:
+      return node.elements.every((element) => element !== null && isLiteral(element));
+    case AST_NODE_TYPES32.ObjectExpression:
+      return node.properties.every(
+        (property) => property.type === AST_NODE_TYPES32.Property && !property.computed && isLiteral(property.value)
+      );
+    default:
+      return false;
+  }
+}
+function expectOperand(callee) {
+  const receiver = callee.object;
+  if (receiver.type !== AST_NODE_TYPES32.CallExpression || receiver.callee.type !== AST_NODE_TYPES32.Identifier || receiver.callee.name !== "expect" || receiver.arguments.length !== 1) {
+    return null;
+  }
+  return receiver.arguments[0] ?? null;
+}
+var no_tautological_expect_default = ESLintUtils45.RuleCreator(
+  (name) => `https://github.com/sarj-ai/standards/blob/main/packages/typescript/src/rules/${name}.ts`
+)({
+  name: "no-tautological-expect",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow an assertion whose operands are all literals; its outcome is fixed before the code runs, so it can never fail."
+    },
+    schema: [],
+    messages: {
+      tautologicalComparison: "`expect({{operand}}).{{matcher}}({{operand}})` compares a literal with an identical literal \u2014 it passes even if the code under test is deleted. Assert on a value the code produced, or delete the test.",
+      tautologicalMatcher: "`expect({{operand}}).{{matcher}}()` asserts on a literal, so its outcome is fixed before the code runs. Assert on a value the code produced, or delete the test."
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    if (!isTestFile(context.filename)) {
+      return {};
+    }
+    const preview2 = (node) => {
+      const text = context.sourceCode.getText(node).replaceAll(/\s+/gu, " ");
+      return text.length > OPERAND_PREVIEW_CHARS ? `${text.slice(0, OPERAND_PREVIEW_CHARS)}\u2026` : text;
+    };
+    return {
+      CallExpression(node) {
+        const callee = node.callee;
+        if (callee.type !== AST_NODE_TYPES32.MemberExpression || callee.computed) {
+          return;
+        }
+        if (callee.property.type !== AST_NODE_TYPES32.Identifier) {
+          return;
+        }
+        const matcher = callee.property.name;
+        const operand = expectOperand(callee);
+        if (operand === null || !isLiteral(operand)) {
+          return;
+        }
+        if (ZERO_ARG_MATCHERS.has(matcher) && node.arguments.length === 0) {
+          context.report({
+            node,
+            messageId: "tautologicalMatcher",
+            data: { operand: preview2(operand), matcher }
+          });
+          return;
+        }
+        const expected = node.arguments[0];
+        if (!EQUALITY_MATCHERS.has(matcher) || node.arguments.length !== 1 || expected === void 0 || !isLiteral(expected)) {
+          return;
+        }
+        if (context.sourceCode.getText(operand) !== context.sourceCode.getText(expected)) {
+          return;
+        }
+        context.report({
+          node,
+          messageId: "tautologicalComparison",
+          data: { operand: preview2(operand), matcher }
+        });
+      }
+    };
+  }
+});
+
 // src/index.ts
 var rules = {
   "enforce-file-structure": enforce_file_structure_default,
@@ -7202,12 +7303,13 @@ var rules = {
   "prefer-module-level-constant": prefer_module_level_constant_default,
   "jsdoc-restates-signature": jsdoc_restates_signature_default,
   "no-restated-comment": no_restated_comment_default,
-  "trailing-value-narration": trailing_value_narration_default
+  "trailing-value-narration": trailing_value_narration_default,
+  "no-tautological-expect": no_tautological_expect_default
 };
 var plugin = {
   meta: {
     name: "@sarj/eslint-plugin",
-    version: "2.13.0"
+    version: "2.14.0"
   },
   rules,
   configs: {
@@ -7274,7 +7376,15 @@ var plugin = {
         // wrong deletion is silent information loss.
         "@sarj/no-restated-comment": "warn",
         "@sarj/jsdoc-restates-signature": "warn",
-        "@sarj/trailing-value-narration": "warn"
+        "@sarj/trailing-value-narration": "warn",
+        // The TS half of SARJ057 (2026-07). Python has caught the
+        // assertion-FREE test since 0.15.0 (SARJ043) and had no TS
+        // counterpart, which is how `expect(true).toBe(true); // placeholder`
+        // survived in internal-automations: the file HAS an assertion.
+        // Measured across 5,819 .ts/.tsx files (1,003 of them test files) in
+        // six internal repos plus got / hono / swr / trpc: 3 hits, 3 true
+        // positives, 0 false positives.
+        "@sarj/no-tautological-expect": "warn"
       }
     },
     strict: {
@@ -7342,7 +7452,9 @@ var plugin = {
         // for the measured hit counts and false-positive rates.
         "@sarj/no-restated-comment": "error",
         "@sarj/jsdoc-restates-signature": "error",
-        "@sarj/trailing-value-narration": "error"
+        "@sarj/trailing-value-narration": "error",
+        // TS half of SARJ057 — see the `recommended` block for the measurement.
+        "@sarj/no-tautological-expect": "error"
       }
     }
   }