@sarj/eslint-plugin 15.6.7 → 15.6.9

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  advisoryRules: () => advisoryRules,
   applicationOnlyRules: () => applicationOnlyRules,
   default: () => index_default,
   publicDocumentation: () => publicDocumentation,
@@ -4291,6 +4292,87 @@ var no_long_comment_default = createRule({
   }
 });
 
+// src/rules/no-vague-suppression-description.ts
+var DIRECTIVE_RE3 = /(?:eslint-(?:disable|disable-next-line|disable-line)|@ts-(?:expect-error|ignore))\b/iu;
+var DESCRIPTION_RE = /(?::|--)\s*(.+?)\s*$/u;
+var VAGUE_RE = /^(?:needed|required|intentional(?:ly)?|ignore(?:d)?|false positive|type error|typescript|to satisfy (?:the )?(?:linter|typescript|type checker))\.?$/iu;
+var noVagueSuppressionDescriptionDocumentation = {
+  summary: "Require suppression descriptions to name the concrete mismatch or invariant instead of a generic non-reason.",
+  rationale: "Generic phrases satisfy require-description mechanically while leaving reviewers unable to audit the risk or remove stale debt.",
+  remediation: "Name the exact type/runtime mismatch, external contract, or safety invariant that makes this suppression acceptable.",
+  category: "maintainability",
+  limitations: [
+    "Only ESLint disable comments and TypeScript expect-error/ignore directives are checked.",
+    "The rule uses a small anchored vocabulary and does not score prose quality generally.",
+    "Generated files and descriptions containing any concrete context are excluded."
+  ],
+  examples: [
+    {
+      id: "concrete-runtime-mismatch",
+      title: "Explain the concrete runtime contract",
+      outcome: "no-match",
+      files: [
+        {
+          path: "src/adapter.ts",
+          source: "// @ts-expect-error -- vendor types omit the runtime requestId field\nreturn response.requestId;"
+        }
+      ],
+      focusPath: "src/adapter.ts",
+      expectedCount: 0,
+      public: true
+    },
+    {
+      id: "generic-suppression-reason",
+      title: "Reject a suppression with no auditable reason",
+      outcome: "match",
+      files: [
+        {
+          path: "src/adapter.ts",
+          source: "// @ts-expect-error -- false positive\nreturn response.requestId;"
+        }
+      ],
+      focusPath: "src/adapter.ts",
+      expectedCount: 1,
+      public: true
+    }
+  ]
+};
+var no_vague_suppression_description_default = createRule({
+  name: "no-vague-suppression-description",
+  documentation: noVagueSuppressionDescriptionDocumentation,
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Require suppression descriptions to name the concrete mismatch or invariant instead of a generic non-reason."
+    },
+    schema: [],
+    messages: {
+      vagueDescription: "Suppression description `{{description}}` does not explain why the suppressed diagnostic is safe here. Name the concrete type/runtime mismatch, external contract, or invariant."
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    if (isGeneratedFile(context.filename, context.sourceCode.text)) {
+      return {};
+    }
+    return {
+      Program() {
+        for (const comment of context.sourceCode.getAllComments()) {
+          const text = comment.value.trim();
+          if (!DIRECTIVE_RE3.test(text)) continue;
+          const description = DESCRIPTION_RE.exec(text)?.[1]?.trim();
+          if (description === void 0 || !VAGUE_RE.test(description)) continue;
+          context.report({
+            loc: comment.loc,
+            messageId: "vagueDescription",
+            data: { description }
+          });
+        }
+      }
+    };
+  }
+});
+
 // src/rules/no-generic-single-export-module.ts
 var import_utils21 = require("@typescript-eslint/utils");
 var noGenericSingleExportModuleDocumentation = {
@@ -5430,7 +5512,7 @@ var no_repeated_string_literal_default = createRule({
 var import_utils28 = require("@typescript-eslint/utils");
 var MAX_WORDS = 8;
 var MIN_CONTENT_TOKENS = 2;
-var DIRECTIVE_RE3 = /^(eslint\b|eslint-|sarj-noqa\b|@ts-|prettier-ignore|prettier\b|biome-|c8\b|v8\b|istanbul\b|@type\b|@vite|webpack|<reference|<amd|global\b|noinspection|todo\b|fixme\b|hack\b|xxx\b)/i;
+var DIRECTIVE_RE4 = /^(eslint\b|eslint-|sarj-noqa\b|@ts-|prettier-ignore|prettier\b|biome-|c8\b|v8\b|istanbul\b|@type\b|@vite|webpack|<reference|<amd|global\b|noinspection|todo\b|fixme\b|hack\b|xxx\b)/i;
 var CODEY_RE = /^[\w.$[\]'"]+\s*[:=]\s*\S|^[\w.$]+\s*\(|^(?:return|throw|await|import|export|const|let|var)\b.*[=()[\]{}]/;
 var BANNERISH_RE = /[=\-─-╿*#~_.]{3,}|^[A-Z0-9 _:-]+$/;
 var MODALITY_RE = /\b(?:can|could|should|shall|may|might|must|will|would|cannot)\b/i;
@@ -5529,7 +5611,7 @@ var no_restated_comment_default = createRule({
           }
           const body2 = comment.value.replace(/^\/*/, "").trim();
           if (body2.length === 0 || body2.endsWith("?")) continue;
-          if (DIRECTIVE_RE3.test(body2) || CODEY_RE.test(body2) || BANNERISH_RE.test(body2)) continue;
+          if (DIRECTIVE_RE4.test(body2) || CODEY_RE.test(body2) || BANNERISH_RE.test(body2)) continue;
           if (NON_ASCII_LETTER_RE.test(body2) || isProtected(body2)) continue;
           if (MODALITY_RE.test(body2) || LEAD_IN_RE.test(body2) || EMPHASIS_RE.test(body2)) continue;
           if (NEGATION_WORD_RE.test(body2)) continue;
@@ -5577,7 +5659,7 @@ var MODELLED_TAGS = /* @__PURE__ */ new Set([
 ]);
 var PARAM_TAGS = /* @__PURE__ */ new Set(["arg", "argument", "param"]);
 var RETURN_TAGS = /* @__PURE__ */ new Set(["return", "returns"]);
-var DIRECTIVE_RE4 = /^\s*(?:eslint\b|eslint-|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|@vite|webpack|@jsx|@jest-environment|@vitest-environment|#__)/i;
+var DIRECTIVE_RE5 = /^\s*(?:eslint\b|eslint-|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|@vite|webpack|@jsx|@jest-environment|@vitest-environment|#__)/i;
 var STOPWORDS2 = new Set(
   `the a an of to for in on with and or as at by is are was be been being
    this that it its if whether when where which what will would can could should
@@ -5693,7 +5775,7 @@ var no_restated_jsdoc_default = createRule({
             description,
             ...tags.filter((tag) => tag.name === "description").map((tag) => tag.text)
           ].filter((text) => text.length > 0).join("\n");
-          if (DIRECTIVE_RE4.test(describedText)) continue;
+          if (DIRECTIVE_RE5.test(describedText)) continue;
           const tagNames = new Set(tags.map((tag) => tag.name));
           if ([...tagNames].some((name) => !MODELLED_TAGS.has(name))) continue;
           if (isProtected(describedText)) continue;
@@ -7655,10 +7737,10 @@ var STOPWORDS3 = /* @__PURE__ */ new Set([
   "we",
   "with"
 ]);
-var DIRECTIVE_RE5 = /^\s*(?:eslint\b|eslint-|sarj-noqa\b|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|todo\b|fixme\b|hack\b|xxx\b)/i;
+var DIRECTIVE_RE6 = /^\s*(?:eslint\b|eslint-|sarj-noqa\b|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|todo\b|fixme\b|hack\b|xxx\b)/i;
 var UNIT_NAME_SUFFIX_RE = /(?:_(?:NS|US|MS|S|SEC|SECS|SECOND|SECONDS|MIN|MINS|MINUTE|MINUTES|HOUR|HOURS|DAY|DAYS|BYTE|BYTES|KB|MB|GB|HZ|KHZ|MHZ|PX)|(?:Ns|Us|Ms|Sec|Secs|Second|Seconds|Min|Mins|Minute|Minutes|Hour|Hours|Day|Days|Byte|Bytes|Kb|Mb|Gb|Hz|Khz|Mhz|Px))$/u;
 function narratesValue(body2, code) {
-  if (body2.length === 0 || DIRECTIVE_RE5.test(body2) || hasExternalReference(body2)) return false;
+  if (body2.length === 0 || DIRECTIVE_RE6.test(body2) || hasExternalReference(body2)) return false;
   const codeNumbers = numbersIn(code);
   if (codeNumbers.size === 0) return false;
   const words2 = (body2.match(WORD_RE3) ?? []).map((word) => word.toLowerCase());
@@ -14784,8 +14866,290 @@ var stepdown_default = createRule({
   }
 });
 
-// src/rules/zod-naming-convention.ts
+// src/rules/source-coupled-test.ts
 var import_utils70 = require("@typescript-eslint/utils");
+var SOURCE_SUFFIX_RE = /\.(?:bash|hcl|sh|tf|tfvars|ya?ml|py|[cm]?[jt]s)$/iu;
+var FS_MODULES = /* @__PURE__ */ new Set(["fs", "node:fs", "fs/promises", "node:fs/promises"]);
+var FS_READERS = /* @__PURE__ */ new Set(["readFile", "readFileSync"]);
+var TEXT_TRANSFORMS = /* @__PURE__ */ new Set([
+  "slice",
+  "substring",
+  "substr",
+  "toLowerCase",
+  "toString",
+  "toUpperCase",
+  "trim",
+  "trimEnd",
+  "trimStart",
+  "replace",
+  "replaceAll"
+]);
+var TEXT_PREDICATES = /* @__PURE__ */ new Set(["endsWith", "includes", "indexOf", "lastIndexOf", "match", "matchAll", "search", "startsWith"]);
+var REGEXP_PREDICATES = /* @__PURE__ */ new Set(["exec", "test"]);
+var EXPECT_MATCHERS = /* @__PURE__ */ new Set([
+  "toBe",
+  "toBeFalsy",
+  "toBeGreaterThan",
+  "toBeGreaterThanOrEqual",
+  "toBeLessThan",
+  "toBeLessThanOrEqual",
+  "toBeNull",
+  "toBeTruthy",
+  "toContain",
+  "toEqual",
+  "toHaveLength",
+  "toMatch",
+  "toMatchSnapshot",
+  "toStrictEqual"
+]);
+var EXPECT_MODIFIERS = /* @__PURE__ */ new Set(["not", "rejects", "resolves"]);
+var ASSERT_MATCHERS = /* @__PURE__ */ new Set(["deepEqual", "doesNotMatch", "equal", "match", "notDeepEqual", "notEqual", "notStrictEqual", "ok", "strictEqual"]);
+var sourceCoupledTestDocumentation = {
+  summary: "Disallow raw repository source text as a test oracle; parse or execute the artifact instead.",
+  rationale: "Substring and regex checks can pass on comments or unreachable configuration and fail after behavior-preserving formatting changes.",
+  remediation: "Parse the artifact, execute its validator, or assert on Terraform plan JSON or another runtime contract.",
+  category: "testing",
+  limitations: [
+    "The rule follows lexical aliases, source-path collections, awaited reads, and common text operations; interprocedural flows remain unreported.",
+    "When raw representation is genuinely the contract (for example a golden or compatibility sentinel), use an exact line suppression with the reason."
+  ],
+  examples: [
+    {
+      id: "parsed-policy-contract",
+      title: "Assert on parsed policy behavior",
+      outcome: "no-match",
+      files: [{ path: "src/policy.test.ts", source: "import { readFileSync } from 'node:fs'; test('policy', () => { const policy = JSON.parse(readFileSync('policy.json', 'utf8')); expect(validate(policy)).toEqual([]); });" }],
+      focusPath: "src/policy.test.ts",
+      expectedCount: 0,
+      public: true
+    },
+    {
+      id: "terraform-substring-contract",
+      title: "Do not prove Terraform behavior with a regex",
+      outcome: "match",
+      files: [{ path: "src/policy.test.ts", source: "import { readFileSync } from 'node:fs'; test('policy', () => { const source = readFileSync('main.tf', 'utf8'); expect(source).toMatch(/prevent_destroy/); });" }],
+      focusPath: "src/policy.test.ts",
+      expectedCount: 1,
+      public: true
+    }
+  ]
+};
+function staticMemberName5(node) {
+  if (!node.computed && node.property.type === import_utils70.AST_NODE_TYPES.Identifier) return node.property.name;
+  if (node.computed && node.property.type === import_utils70.AST_NODE_TYPES.Literal && typeof node.property.value === "string") return node.property.value;
+  return null;
+}
+function unwrap5(node) {
+  if (node.type === import_utils70.AST_NODE_TYPES.AwaitExpression) return unwrap5(node.argument);
+  if (node.type === import_utils70.AST_NODE_TYPES.ChainExpression) return unwrap5(node.expression);
+  if (node.type === import_utils70.AST_NODE_TYPES.TSAsExpression || node.type === import_utils70.AST_NODE_TYPES.TSNonNullExpression || node.type === import_utils70.AST_NODE_TYPES.TSTypeAssertion) return unwrap5(node.expression);
+  return node;
+}
+function stringValue(node) {
+  const current = unwrap5(node);
+  if (current.type === import_utils70.AST_NODE_TYPES.Literal && typeof current.value === "string") return current.value;
+  if (current.type === import_utils70.AST_NODE_TYPES.TemplateLiteral && current.expressions.length === 0) return current.quasis[0]?.value.cooked ?? null;
+  return null;
+}
+function importSource(node) {
+  return typeof node.source.value === "string" ? node.source.value : null;
+}
+function requireSource(node) {
+  const current = unwrap5(node);
+  if (current.type !== import_utils70.AST_NODE_TYPES.CallExpression || current.callee.type !== import_utils70.AST_NODE_TYPES.Identifier || current.callee.name !== "require" || current.arguments.length !== 1 || current.arguments[0]?.type === import_utils70.AST_NODE_TYPES.SpreadElement) return null;
+  return stringValue(current.arguments[0]);
+}
+function newScope() {
+  return { collections: /* @__PURE__ */ new Set(), declared: /* @__PURE__ */ new Set(), fsObjects: /* @__PURE__ */ new Set(), fsReaders: /* @__PURE__ */ new Set(), paths: /* @__PURE__ */ new Set(), rawOrigins: /* @__PURE__ */ new Map() };
+}
+var source_coupled_test_default = createRule({
+  name: "source-coupled-test",
+  documentation: sourceCoupledTestDocumentation,
+  meta: {
+    type: "suggestion",
+    docs: { description: sourceCoupledTestDocumentation.summary },
+    schema: [],
+    messages: { rawSourceOracle: "Raw repository source text is the oracle. Parse or execute the artifact so comments, formatting, and unreachable blocks cannot satisfy the contract." }
+  },
+  defaultOptions: [],
+  create(context) {
+    if (!isTestFile(context.filename) || isGeneratedFile(context.filename, context.sourceCode.text)) return {};
+    const scopes = [newScope()];
+    const reportedOrigins = /* @__PURE__ */ new Set();
+    const currentScope = () => scopes.at(-1) ?? scopes[0];
+    const visible = (kind, name) => {
+      for (let index = scopes.length - 1; index >= 0; index--) {
+        const scope = scopes[index];
+        if (scope.declared.has(name)) return scope[kind].has(name);
+      }
+      return false;
+    };
+    const visibleRawOrigins = (name) => {
+      for (let index = scopes.length - 1; index >= 0; index--) {
+        const scope = scopes[index];
+        if (scope.declared.has(name)) return scope.rawOrigins.get(name) ?? /* @__PURE__ */ new Set();
+      }
+      return /* @__PURE__ */ new Set();
+    };
+    const sourcePath = (node) => {
+      const current = unwrap5(node);
+      const value = stringValue(current);
+      if (value !== null) return SOURCE_SUFFIX_RE.test(value);
+      if (current.type === import_utils70.AST_NODE_TYPES.Identifier) return visible("paths", current.name);
+      if (current.type === import_utils70.AST_NODE_TYPES.BinaryExpression && current.operator === "+") {
+        return sourcePath(current.left) || sourcePath(current.right);
+      }
+      if (current.type === import_utils70.AST_NODE_TYPES.TemplateLiteral) return current.expressions.some(sourcePath);
+      if (current.type === import_utils70.AST_NODE_TYPES.CallExpression || current.type === import_utils70.AST_NODE_TYPES.NewExpression) {
+        return current.arguments.some((argument) => argument.type !== import_utils70.AST_NODE_TYPES.SpreadElement && sourcePath(argument));
+      }
+      if (current.type === import_utils70.AST_NODE_TYPES.MemberExpression) return sourcePath(current.object);
+      return false;
+    };
+    const rawRead = (node) => {
+      const current = unwrap5(node);
+      if (current.type !== import_utils70.AST_NODE_TYPES.CallExpression || current.arguments.length === 0) return false;
+      const callee = unwrap5(current.callee);
+      if (callee.type === import_utils70.AST_NODE_TYPES.Identifier) {
+        return visible("fsReaders", callee.name) && sourcePath(current.arguments[0]);
+      }
+      if (callee.type !== import_utils70.AST_NODE_TYPES.MemberExpression) return false;
+      const name = staticMemberName5(callee);
+      const object = unwrap5(callee.object);
+      return name !== null && FS_READERS.has(name) && object.type === import_utils70.AST_NODE_TYPES.Identifier && visible("fsObjects", object.name) && sourcePath(current.arguments[0]);
+    };
+    const rawOrigins = (node) => {
+      const current = unwrap5(node);
+      if (current.type === import_utils70.AST_NODE_TYPES.Identifier) return visibleRawOrigins(current.name);
+      if (rawRead(current)) return /* @__PURE__ */ new Set([`${current.range[0]}:${current.range[1]}`]);
+      if (current.type === import_utils70.AST_NODE_TYPES.BinaryExpression && current.operator === "+") return /* @__PURE__ */ new Set([...rawOrigins(current.left), ...rawOrigins(current.right)]);
+      if (current.type !== import_utils70.AST_NODE_TYPES.CallExpression) return /* @__PURE__ */ new Set();
+      const callee = unwrap5(current.callee);
+      if (callee.type !== import_utils70.AST_NODE_TYPES.MemberExpression) return /* @__PURE__ */ new Set();
+      const name = staticMemberName5(callee);
+      return name !== null && TEXT_TRANSFORMS.has(name) ? rawOrigins(callee.object) : /* @__PURE__ */ new Set();
+    };
+    const evidenceOrigins = (node) => {
+      const current = unwrap5(node);
+      const direct = rawOrigins(current);
+      if (direct.size > 0) return direct;
+      if (current.type === import_utils70.AST_NODE_TYPES.BinaryExpression || current.type === import_utils70.AST_NODE_TYPES.LogicalExpression) return /* @__PURE__ */ new Set([...evidenceOrigins(current.left), ...evidenceOrigins(current.right)]);
+      if (current.type === import_utils70.AST_NODE_TYPES.UnaryExpression) return evidenceOrigins(current.argument);
+      if (current.type !== import_utils70.AST_NODE_TYPES.CallExpression) return /* @__PURE__ */ new Set();
+      const callee = unwrap5(current.callee);
+      if (callee.type !== import_utils70.AST_NODE_TYPES.MemberExpression) return /* @__PURE__ */ new Set();
+      const name = staticMemberName5(callee);
+      if (name !== null && TEXT_PREDICATES.has(name)) return rawOrigins(callee.object);
+      if (name !== null && REGEXP_PREDICATES.has(name)) return new Set(current.arguments.flatMap((argument) => argument.type === import_utils70.AST_NODE_TYPES.SpreadElement ? [] : [...rawOrigins(argument)]));
+      return /* @__PURE__ */ new Set();
+    };
+    const rawAssertionOrigins = (node) => {
+      const callee = unwrap5(node.callee);
+      if (callee.type === import_utils70.AST_NODE_TYPES.Identifier && callee.name === "assert") {
+        return new Set(node.arguments.flatMap((argument) => argument.type === import_utils70.AST_NODE_TYPES.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+      }
+      if (callee.type !== import_utils70.AST_NODE_TYPES.MemberExpression) return /* @__PURE__ */ new Set();
+      const matcher = staticMemberName5(callee);
+      if (matcher === null) return /* @__PURE__ */ new Set();
+      let receiver = unwrap5(callee.object);
+      while (receiver.type === import_utils70.AST_NODE_TYPES.MemberExpression && EXPECT_MODIFIERS.has(staticMemberName5(receiver) ?? "")) receiver = unwrap5(receiver.object);
+      if (receiver.type === import_utils70.AST_NODE_TYPES.CallExpression && receiver.callee.type === import_utils70.AST_NODE_TYPES.Identifier && receiver.callee.name === "expect") {
+        if (!EXPECT_MATCHERS.has(matcher)) return /* @__PURE__ */ new Set();
+        return new Set([...receiver.arguments, ...node.arguments].flatMap((argument) => argument.type === import_utils70.AST_NODE_TYPES.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+      }
+      if (receiver.type !== import_utils70.AST_NODE_TYPES.Identifier || receiver.name !== "assert" || !ASSERT_MATCHERS.has(matcher)) return /* @__PURE__ */ new Set();
+      return new Set(node.arguments.flatMap((argument) => argument.type === import_utils70.AST_NODE_TYPES.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+    };
+    const declare = (name, state) => {
+      const scope = currentScope();
+      scope.declared.add(name);
+      scope.collections.delete(name);
+      scope.fsObjects.delete(name);
+      scope.fsReaders.delete(name);
+      scope.paths.delete(name);
+      scope.rawOrigins.delete(name);
+      if (state.collection === true) scope.collections.add(name);
+      if (state.fsObject === true) scope.fsObjects.add(name);
+      if (state.fsReader === true) scope.fsReaders.add(name);
+      if (state.path === true) scope.paths.add(name);
+      if (state.rawOrigins !== void 0 && state.rawOrigins.size > 0) {
+        scope.rawOrigins.set(name, state.rawOrigins);
+      }
+    };
+    const sourceCollection = (node) => {
+      const current = unwrap5(node);
+      return current.type === import_utils70.AST_NODE_TYPES.ArrayExpression && current.elements.length > 0 && current.elements.every((element) => element !== null && element.type !== import_utils70.AST_NODE_TYPES.SpreadElement && sourcePath(element));
+    };
+    const declaredNames2 = (node) => {
+      const current = unwrap5(node);
+      if (current.type === import_utils70.AST_NODE_TYPES.Identifier) return [current.name];
+      if (current.type === import_utils70.AST_NODE_TYPES.AssignmentPattern) return declaredNames2(current.left);
+      if (current.type === import_utils70.AST_NODE_TYPES.RestElement) return declaredNames2(current.argument);
+      if (current.type === import_utils70.AST_NODE_TYPES.ArrayPattern) return current.elements.flatMap((element) => element === null ? [] : declaredNames2(element));
+      if (current.type === import_utils70.AST_NODE_TYPES.ObjectPattern) return current.properties.flatMap((property) => property.type === import_utils70.AST_NODE_TYPES.RestElement ? declaredNames2(property.argument) : declaredNames2(property.value));
+      return [];
+    };
+    const enterFunction = (node) => {
+      scopes.push(newScope());
+      for (const parameter of node.params) for (const name of declaredNames2(parameter)) declare(name, {});
+    };
+    const exitFunction = () => {
+      scopes.pop();
+    };
+    return {
+      ImportDeclaration(node) {
+        const source = importSource(node);
+        if (source === null || !FS_MODULES.has(source)) return;
+        for (const specifier of node.specifiers) {
+          if (specifier.type === import_utils70.AST_NODE_TYPES.ImportSpecifier) {
+            const imported = specifier.imported.type === import_utils70.AST_NODE_TYPES.Identifier ? specifier.imported.name : String(specifier.imported.value);
+            if (FS_READERS.has(imported)) declare(specifier.local.name, { fsReader: true });
+          } else {
+            declare(specifier.local.name, { fsObject: true });
+          }
+        }
+      },
+      ":function": enterFunction,
+      ":function:exit": exitFunction,
+      VariableDeclarator(node) {
+        if (node.init === null) return;
+        const required = requireSource(node.init);
+        if (required !== null && FS_MODULES.has(required) && node.id.type === import_utils70.AST_NODE_TYPES.Identifier) {
+          declare(node.id.name, { fsObject: true });
+          return;
+        }
+        if (node.id.type === import_utils70.AST_NODE_TYPES.ObjectPattern && required !== null && FS_MODULES.has(required)) {
+          for (const property of node.id.properties) {
+            if (property.type !== import_utils70.AST_NODE_TYPES.Property || property.value.type !== import_utils70.AST_NODE_TYPES.Identifier) continue;
+            const key = property.key.type === import_utils70.AST_NODE_TYPES.Identifier ? property.key.name : property.key.type === import_utils70.AST_NODE_TYPES.Literal ? String(property.key.value) : "";
+            if (FS_READERS.has(key)) declare(property.value.name, { fsReader: true });
+          }
+          return;
+        }
+        if (node.id.type !== import_utils70.AST_NODE_TYPES.Identifier) return;
+        declare(node.id.name, { collection: sourceCollection(node.init), path: sourcePath(node.init), rawOrigins: rawOrigins(node.init) });
+      },
+      AssignmentExpression(node) {
+        if (node.left.type === import_utils70.AST_NODE_TYPES.Identifier) declare(node.left.name, { path: sourcePath(node.right), rawOrigins: rawOrigins(node.right) });
+      },
+      ForOfStatement(node) {
+        const right = unwrap5(node.right);
+        const collection = right.type === import_utils70.AST_NODE_TYPES.Identifier && visible("collections", right.name);
+        const left = node.left.type === import_utils70.AST_NODE_TYPES.VariableDeclaration ? node.left.declarations[0]?.id : node.left;
+        if (collection && left?.type === import_utils70.AST_NODE_TYPES.Identifier) declare(left.name, { path: true });
+      },
+      CallExpression(node) {
+        const origins = rawAssertionOrigins(node);
+        if (origins.size === 0 || [...origins].every((origin) => reportedOrigins.has(origin))) return;
+        for (const origin of origins) reportedOrigins.add(origin);
+        context.report({ node, messageId: "rawSourceOracle" });
+      }
+    };
+  }
+});
+
+// src/rules/zod-naming-convention.ts
+var import_utils71 = require("@typescript-eslint/utils");
 var zodNamingConventionDocumentation = {
   summary: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default.",
   rationale: "A recognizable schema name distinguishes runtime validators from ordinary values at each use site.",
@@ -14826,18 +15190,18 @@ var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "prettifyError",
   "treeifyError"
 ]);
-var terminalMethodName = (callee) => !callee.computed && callee.property.type === import_utils70.AST_NODE_TYPES.Identifier ? callee.property.name : null;
+var terminalMethodName = (callee) => !callee.computed && callee.property.type === import_utils71.AST_NODE_TYPES.Identifier ? callee.property.name : null;
 var calleeChainRoot = (node) => {
   let current = node;
   for (; ; ) {
-    if (current.type === import_utils70.AST_NODE_TYPES.Identifier) {
+    if (current.type === import_utils71.AST_NODE_TYPES.Identifier) {
       return current;
     }
-    if (current.type === import_utils70.AST_NODE_TYPES.MemberExpression) {
+    if (current.type === import_utils71.AST_NODE_TYPES.MemberExpression) {
       current = current.object;
       continue;
     }
-    if (current.type === import_utils70.AST_NODE_TYPES.CallExpression) {
+    if (current.type === import_utils71.AST_NODE_TYPES.CallExpression) {
       current = current.callee;
       continue;
     }
@@ -14877,7 +15241,7 @@ var zod_naming_convention_default = createRule({
     const acceptsSchemaWord = convention !== "prefix";
     const zodBindings = /* @__PURE__ */ new Set();
     function resolvedBinding(identifier) {
-      return import_utils70.ASTUtils.findVariable(
+      return import_utils71.ASTUtils.findVariable(
         context.sourceCode.getScope(identifier),
         identifier.name
       );
@@ -14899,7 +15263,7 @@ var zod_naming_convention_default = createRule({
       ImportDeclaration(node) {
         if (!isZodModule(node.source.value)) return;
         for (const specifier of node.specifiers) {
-          if (specifier.type === import_utils70.AST_NODE_TYPES.ImportNamespaceSpecifier || specifier.type === import_utils70.AST_NODE_TYPES.ImportDefaultSpecifier || specifier.type === import_utils70.AST_NODE_TYPES.ImportSpecifier && (specifier.imported.type === import_utils70.AST_NODE_TYPES.Identifier ? specifier.imported.name === "z" : specifier.imported.value === "z")) {
+          if (specifier.type === import_utils71.AST_NODE_TYPES.ImportNamespaceSpecifier || specifier.type === import_utils71.AST_NODE_TYPES.ImportDefaultSpecifier || specifier.type === import_utils71.AST_NODE_TYPES.ImportSpecifier && (specifier.imported.type === import_utils71.AST_NODE_TYPES.Identifier ? specifier.imported.name === "z" : specifier.imported.value === "z")) {
             recordZodBinding(specifier.local);
           }
         }
@@ -14907,13 +15271,13 @@ var zod_naming_convention_default = createRule({
       VariableDeclarator(node) {
         const init = node.init;
         if (init === null || init === void 0) return;
-        if (init.type !== import_utils70.AST_NODE_TYPES.CallExpression) return;
+        if (init.type !== import_utils71.AST_NODE_TYPES.CallExpression) return;
         const callee = init.callee;
-        if (callee.type !== import_utils70.AST_NODE_TYPES.MemberExpression) return;
+        if (callee.type !== import_utils71.AST_NODE_TYPES.MemberExpression) return;
         if (!isZodChain(callee)) return;
         const terminal = terminalMethodName(callee);
         if (terminal !== null && NON_SCHEMA_TERMINALS.has(terminal)) return;
-        if (node.id.type !== import_utils70.AST_NODE_TYPES.Identifier) return;
+        if (node.id.type !== import_utils71.AST_NODE_TYPES.Identifier) return;
         if (test.test(node.id.name)) return;
         if (acceptsSchemaWord && CONTAINS_SCHEMA_RE.test(node.id.name)) return;
         context.report({
@@ -15022,6 +15386,7 @@ var rules = {
   "no-impossible-zod-literal-bounds": no_impossible_zod_literal_bounds_default,
   "no-log-only-catch": no_log_only_catch_default,
   "no-long-comment": no_long_comment_default,
+  "no-vague-suppression-description": no_vague_suppression_description_default,
   "no-generic-single-export-module": no_generic_single_export_module_default,
   "no-offset-pagination": no_offset_pagination_default,
   "no-positional-tuple-return": no_positional_tuple_return_default,
@@ -15070,17 +15435,19 @@ var rules = {
   "require-zod-form-validation": require_zod_form_validation_default,
   "store-insert-requires-on-conflict": store_insert_requires_on_conflict_default,
   "stepdown": stepdown_default,
+  "source-coupled-test": source_coupled_test_default,
   "zod-naming-convention": zod_naming_convention_default
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.6.7"
+  version: "15.6.9"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",
   "prefer-native-random-uuid",
   "prefer-shadcn-primitives"
 ];
+var advisoryRules = ["no-vague-suppression-description", "source-coupled-test"];
 var recommendedRules = {
   "@sarj/duplicate-test-body": "error",
   "@sarj/enforce-file-structure": "error",
@@ -15096,6 +15463,7 @@ var recommendedRules = {
   "@sarj/no-impossible-zod-literal-bounds": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
+  "@sarj/no-vague-suppression-description": "warn",
   "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
@@ -15138,6 +15506,7 @@ var recommendedRules = {
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
   "@sarj/stepdown": "error",
+  "@sarj/source-coupled-test": "warn",
   "@sarj/zod-naming-convention": "error"
 };
 var strictRules = {
@@ -15156,6 +15525,7 @@ var strictRules = {
   "@sarj/no-impossible-zod-literal-bounds": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
+  "@sarj/no-vague-suppression-description": "warn",
   "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
@@ -15201,6 +15571,7 @@ var strictRules = {
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
   "@sarj/stepdown": "error",
+  "@sarj/source-coupled-test": "warn",
   "@sarj/zod-naming-convention": "error"
 };
 var plugin = {
@@ -15225,6 +15596,7 @@ var plugin = {
 var index_default = plugin;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  advisoryRules,
   applicationOnlyRules,
   publicDocumentation,
   recommendedRules,

package/dist/index.d.cts

@@ -208,6 +208,7 @@ declare const rules: {
     readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [], "impossibleBounds">;
     readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
     readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
+    readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
     readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
     readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
     readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
@@ -274,12 +275,15 @@ declare const rules: {
     readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
     readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
     readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
+    readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
     readonly "zod-naming-convention": DocumentedRule<readonly [{
         convention?: "prefix" | "suffix" | "either";
     }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
 };
 /** Rules registered for application-profile configs but intentionally absent from general presets. */
 declare const applicationOnlyRules: readonly ["no-restricted-library-load", "prefer-native-random-uuid", "prefer-shadcn-primitives"];
+/** Calibrated rules that intentionally remain warnings until consumer-corpus precision is proven. */
+declare const advisoryRules: readonly ["no-vague-suppression-description", "source-coupled-test"];
 declare const recommendedRules: {
     readonly "@sarj/duplicate-test-body": "error";
     readonly "@sarj/enforce-file-structure": "error";
@@ -297,6 +301,7 @@ declare const recommendedRules: {
     readonly "@sarj/no-impossible-zod-literal-bounds": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-vague-suppression-description": "warn";
     readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
@@ -341,6 +346,7 @@ declare const recommendedRules: {
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
     readonly "@sarj/stepdown": "error";
+    readonly "@sarj/source-coupled-test": "warn";
     readonly "@sarj/zod-naming-convention": "error";
 };
 declare const strictRules: {
@@ -361,6 +367,7 @@ declare const strictRules: {
     readonly "@sarj/no-impossible-zod-literal-bounds": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-vague-suppression-description": "warn";
     readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
@@ -408,6 +415,7 @@ declare const strictRules: {
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
     readonly "@sarj/stepdown": "error";
+    readonly "@sarj/source-coupled-test": "warn";
     readonly "@sarj/zod-naming-convention": "error";
 };
 type FlatPreset = {
@@ -418,7 +426,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.6.7";
+        readonly version: "15.6.9";
     };
     readonly rules: {
         readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;
@@ -441,6 +449,7 @@ declare const plugin: {
         readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [], "impossibleBounds">;
         readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
         readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
+        readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
         readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
         readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
         readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
@@ -507,6 +516,7 @@ declare const plugin: {
         readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
         readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
         readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
+        readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
         readonly "zod-naming-convention": DocumentedRule<readonly [{
             convention?: "prefix" | "suffix" | "either";
         }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
@@ -518,4 +528,4 @@ declare const plugin: {
     };
 };
 
-export { type RetiredRule, applicationOnlyRules, plugin as default, publicDocumentation, recommendedRules, renamedRules, retiredRules, rules, strictRules };
+export { type RetiredRule, advisoryRules, applicationOnlyRules, plugin as default, publicDocumentation, recommendedRules, renamedRules, retiredRules, rules, strictRules };

package/dist/index.d.ts

@@ -208,6 +208,7 @@ declare const rules: {
     readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [], "impossibleBounds">;
     readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
     readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
+    readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
     readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
     readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
     readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
@@ -274,12 +275,15 @@ declare const rules: {
     readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
     readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
     readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
+    readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
     readonly "zod-naming-convention": DocumentedRule<readonly [{
         convention?: "prefix" | "suffix" | "either";
     }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
 };
 /** Rules registered for application-profile configs but intentionally absent from general presets. */
 declare const applicationOnlyRules: readonly ["no-restricted-library-load", "prefer-native-random-uuid", "prefer-shadcn-primitives"];
+/** Calibrated rules that intentionally remain warnings until consumer-corpus precision is proven. */
+declare const advisoryRules: readonly ["no-vague-suppression-description", "source-coupled-test"];
 declare const recommendedRules: {
     readonly "@sarj/duplicate-test-body": "error";
     readonly "@sarj/enforce-file-structure": "error";
@@ -297,6 +301,7 @@ declare const recommendedRules: {
     readonly "@sarj/no-impossible-zod-literal-bounds": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-vague-suppression-description": "warn";
     readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
@@ -341,6 +346,7 @@ declare const recommendedRules: {
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
     readonly "@sarj/stepdown": "error";
+    readonly "@sarj/source-coupled-test": "warn";
     readonly "@sarj/zod-naming-convention": "error";
 };
 declare const strictRules: {
@@ -361,6 +367,7 @@ declare const strictRules: {
     readonly "@sarj/no-impossible-zod-literal-bounds": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-vague-suppression-description": "warn";
     readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
@@ -408,6 +415,7 @@ declare const strictRules: {
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
     readonly "@sarj/stepdown": "error";
+    readonly "@sarj/source-coupled-test": "warn";
     readonly "@sarj/zod-naming-convention": "error";
 };
 type FlatPreset = {
@@ -418,7 +426,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.6.7";
+        readonly version: "15.6.9";
     };
     readonly rules: {
         readonly "duplicate-test-body": DocumentedRule<readonly [], "duplicateTestBody">;
@@ -441,6 +449,7 @@ declare const plugin: {
         readonly "no-impossible-zod-literal-bounds": DocumentedRule<readonly [], "impossibleBounds">;
         readonly "no-log-only-catch": DocumentedRule<readonly [LoggingOptions?], "noLogOnlyCatch" | "emptyCatch">;
         readonly "no-long-comment": DocumentedRule<readonly [], "tooLong">;
+        readonly "no-vague-suppression-description": DocumentedRule<readonly [], "vagueDescription">;
         readonly "no-generic-single-export-module": DocumentedRule<[], "genericSingleExport">;
         readonly "no-offset-pagination": DocumentedRule<readonly [], "noOffsetPagination">;
         readonly "no-positional-tuple-return": DocumentedRule<readonly [], "noPositionalTupleReturn">;
@@ -507,6 +516,7 @@ declare const plugin: {
         readonly "require-zod-form-validation": DocumentedRule<readonly [], "missingZodValidation">;
         readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
         readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
+        readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
         readonly "zod-naming-convention": DocumentedRule<readonly [{
             convention?: "prefix" | "suffix" | "either";
         }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
@@ -518,4 +528,4 @@ declare const plugin: {
     };
 };
 
-export { type RetiredRule, applicationOnlyRules, plugin as default, publicDocumentation, recommendedRules, renamedRules, retiredRules, rules, strictRules };
+export { type RetiredRule, advisoryRules, applicationOnlyRules, plugin as default, publicDocumentation, recommendedRules, renamedRules, retiredRules, rules, strictRules };

package/dist/index.js

@@ -4253,6 +4253,87 @@ var no_long_comment_default = createRule({
   }
 });
 
+// src/rules/no-vague-suppression-description.ts
+var DIRECTIVE_RE3 = /(?:eslint-(?:disable|disable-next-line|disable-line)|@ts-(?:expect-error|ignore))\b/iu;
+var DESCRIPTION_RE = /(?::|--)\s*(.+?)\s*$/u;
+var VAGUE_RE = /^(?:needed|required|intentional(?:ly)?|ignore(?:d)?|false positive|type error|typescript|to satisfy (?:the )?(?:linter|typescript|type checker))\.?$/iu;
+var noVagueSuppressionDescriptionDocumentation = {
+  summary: "Require suppression descriptions to name the concrete mismatch or invariant instead of a generic non-reason.",
+  rationale: "Generic phrases satisfy require-description mechanically while leaving reviewers unable to audit the risk or remove stale debt.",
+  remediation: "Name the exact type/runtime mismatch, external contract, or safety invariant that makes this suppression acceptable.",
+  category: "maintainability",
+  limitations: [
+    "Only ESLint disable comments and TypeScript expect-error/ignore directives are checked.",
+    "The rule uses a small anchored vocabulary and does not score prose quality generally.",
+    "Generated files and descriptions containing any concrete context are excluded."
+  ],
+  examples: [
+    {
+      id: "concrete-runtime-mismatch",
+      title: "Explain the concrete runtime contract",
+      outcome: "no-match",
+      files: [
+        {
+          path: "src/adapter.ts",
+          source: "// @ts-expect-error -- vendor types omit the runtime requestId field\nreturn response.requestId;"
+        }
+      ],
+      focusPath: "src/adapter.ts",
+      expectedCount: 0,
+      public: true
+    },
+    {
+      id: "generic-suppression-reason",
+      title: "Reject a suppression with no auditable reason",
+      outcome: "match",
+      files: [
+        {
+          path: "src/adapter.ts",
+          source: "// @ts-expect-error -- false positive\nreturn response.requestId;"
+        }
+      ],
+      focusPath: "src/adapter.ts",
+      expectedCount: 1,
+      public: true
+    }
+  ]
+};
+var no_vague_suppression_description_default = createRule({
+  name: "no-vague-suppression-description",
+  documentation: noVagueSuppressionDescriptionDocumentation,
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Require suppression descriptions to name the concrete mismatch or invariant instead of a generic non-reason."
+    },
+    schema: [],
+    messages: {
+      vagueDescription: "Suppression description `{{description}}` does not explain why the suppressed diagnostic is safe here. Name the concrete type/runtime mismatch, external contract, or invariant."
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    if (isGeneratedFile(context.filename, context.sourceCode.text)) {
+      return {};
+    }
+    return {
+      Program() {
+        for (const comment of context.sourceCode.getAllComments()) {
+          const text = comment.value.trim();
+          if (!DIRECTIVE_RE3.test(text)) continue;
+          const description = DESCRIPTION_RE.exec(text)?.[1]?.trim();
+          if (description === void 0 || !VAGUE_RE.test(description)) continue;
+          context.report({
+            loc: comment.loc,
+            messageId: "vagueDescription",
+            data: { description }
+          });
+        }
+      }
+    };
+  }
+});
+
 // src/rules/no-generic-single-export-module.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES16, ASTUtils as ASTUtils4 } from "@typescript-eslint/utils";
 var noGenericSingleExportModuleDocumentation = {
@@ -5392,7 +5473,7 @@ var no_repeated_string_literal_default = createRule({
 import { AST_NODE_TYPES as AST_NODE_TYPES21 } from "@typescript-eslint/utils";
 var MAX_WORDS = 8;
 var MIN_CONTENT_TOKENS = 2;
-var DIRECTIVE_RE3 = /^(eslint\b|eslint-|sarj-noqa\b|@ts-|prettier-ignore|prettier\b|biome-|c8\b|v8\b|istanbul\b|@type\b|@vite|webpack|<reference|<amd|global\b|noinspection|todo\b|fixme\b|hack\b|xxx\b)/i;
+var DIRECTIVE_RE4 = /^(eslint\b|eslint-|sarj-noqa\b|@ts-|prettier-ignore|prettier\b|biome-|c8\b|v8\b|istanbul\b|@type\b|@vite|webpack|<reference|<amd|global\b|noinspection|todo\b|fixme\b|hack\b|xxx\b)/i;
 var CODEY_RE = /^[\w.$[\]'"]+\s*[:=]\s*\S|^[\w.$]+\s*\(|^(?:return|throw|await|import|export|const|let|var)\b.*[=()[\]{}]/;
 var BANNERISH_RE = /[=\-─-╿*#~_.]{3,}|^[A-Z0-9 _:-]+$/;
 var MODALITY_RE = /\b(?:can|could|should|shall|may|might|must|will|would|cannot)\b/i;
@@ -5491,7 +5572,7 @@ var no_restated_comment_default = createRule({
           }
           const body2 = comment.value.replace(/^\/*/, "").trim();
           if (body2.length === 0 || body2.endsWith("?")) continue;
-          if (DIRECTIVE_RE3.test(body2) || CODEY_RE.test(body2) || BANNERISH_RE.test(body2)) continue;
+          if (DIRECTIVE_RE4.test(body2) || CODEY_RE.test(body2) || BANNERISH_RE.test(body2)) continue;
           if (NON_ASCII_LETTER_RE.test(body2) || isProtected(body2)) continue;
           if (MODALITY_RE.test(body2) || LEAD_IN_RE.test(body2) || EMPHASIS_RE.test(body2)) continue;
           if (NEGATION_WORD_RE.test(body2)) continue;
@@ -5539,7 +5620,7 @@ var MODELLED_TAGS = /* @__PURE__ */ new Set([
 ]);
 var PARAM_TAGS = /* @__PURE__ */ new Set(["arg", "argument", "param"]);
 var RETURN_TAGS = /* @__PURE__ */ new Set(["return", "returns"]);
-var DIRECTIVE_RE4 = /^\s*(?:eslint\b|eslint-|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|@vite|webpack|@jsx|@jest-environment|@vitest-environment|#__)/i;
+var DIRECTIVE_RE5 = /^\s*(?:eslint\b|eslint-|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|@vite|webpack|@jsx|@jest-environment|@vitest-environment|#__)/i;
 var STOPWORDS2 = new Set(
   `the a an of to for in on with and or as at by is are was be been being
    this that it its if whether when where which what will would can could should
@@ -5655,7 +5736,7 @@ var no_restated_jsdoc_default = createRule({
             description,
             ...tags.filter((tag) => tag.name === "description").map((tag) => tag.text)
           ].filter((text) => text.length > 0).join("\n");
-          if (DIRECTIVE_RE4.test(describedText)) continue;
+          if (DIRECTIVE_RE5.test(describedText)) continue;
           const tagNames = new Set(tags.map((tag) => tag.name));
           if ([...tagNames].some((name) => !MODELLED_TAGS.has(name))) continue;
           if (isProtected(describedText)) continue;
@@ -7617,10 +7698,10 @@ var STOPWORDS3 = /* @__PURE__ */ new Set([
   "we",
   "with"
 ]);
-var DIRECTIVE_RE5 = /^\s*(?:eslint\b|eslint-|sarj-noqa\b|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|todo\b|fixme\b|hack\b|xxx\b)/i;
+var DIRECTIVE_RE6 = /^\s*(?:eslint\b|eslint-|sarj-noqa\b|@ts-|prettier|biome-|c8\b|v8\b|istanbul\b|todo\b|fixme\b|hack\b|xxx\b)/i;
 var UNIT_NAME_SUFFIX_RE = /(?:_(?:NS|US|MS|S|SEC|SECS|SECOND|SECONDS|MIN|MINS|MINUTE|MINUTES|HOUR|HOURS|DAY|DAYS|BYTE|BYTES|KB|MB|GB|HZ|KHZ|MHZ|PX)|(?:Ns|Us|Ms|Sec|Secs|Second|Seconds|Min|Mins|Minute|Minutes|Hour|Hours|Day|Days|Byte|Bytes|Kb|Mb|Gb|Hz|Khz|Mhz|Px))$/u;
 function narratesValue(body2, code) {
-  if (body2.length === 0 || DIRECTIVE_RE5.test(body2) || hasExternalReference(body2)) return false;
+  if (body2.length === 0 || DIRECTIVE_RE6.test(body2) || hasExternalReference(body2)) return false;
   const codeNumbers = numbersIn(code);
   if (codeNumbers.size === 0) return false;
   const words2 = (body2.match(WORD_RE3) ?? []).map((word) => word.toLowerCase());
@@ -14762,9 +14843,291 @@ var stepdown_default = createRule({
   }
 });
 
+// src/rules/source-coupled-test.ts
+import { AST_NODE_TYPES as AST_NODE_TYPES56 } from "@typescript-eslint/utils";
+var SOURCE_SUFFIX_RE = /\.(?:bash|hcl|sh|tf|tfvars|ya?ml|py|[cm]?[jt]s)$/iu;
+var FS_MODULES = /* @__PURE__ */ new Set(["fs", "node:fs", "fs/promises", "node:fs/promises"]);
+var FS_READERS = /* @__PURE__ */ new Set(["readFile", "readFileSync"]);
+var TEXT_TRANSFORMS = /* @__PURE__ */ new Set([
+  "slice",
+  "substring",
+  "substr",
+  "toLowerCase",
+  "toString",
+  "toUpperCase",
+  "trim",
+  "trimEnd",
+  "trimStart",
+  "replace",
+  "replaceAll"
+]);
+var TEXT_PREDICATES = /* @__PURE__ */ new Set(["endsWith", "includes", "indexOf", "lastIndexOf", "match", "matchAll", "search", "startsWith"]);
+var REGEXP_PREDICATES = /* @__PURE__ */ new Set(["exec", "test"]);
+var EXPECT_MATCHERS = /* @__PURE__ */ new Set([
+  "toBe",
+  "toBeFalsy",
+  "toBeGreaterThan",
+  "toBeGreaterThanOrEqual",
+  "toBeLessThan",
+  "toBeLessThanOrEqual",
+  "toBeNull",
+  "toBeTruthy",
+  "toContain",
+  "toEqual",
+  "toHaveLength",
+  "toMatch",
+  "toMatchSnapshot",
+  "toStrictEqual"
+]);
+var EXPECT_MODIFIERS = /* @__PURE__ */ new Set(["not", "rejects", "resolves"]);
+var ASSERT_MATCHERS = /* @__PURE__ */ new Set(["deepEqual", "doesNotMatch", "equal", "match", "notDeepEqual", "notEqual", "notStrictEqual", "ok", "strictEqual"]);
+var sourceCoupledTestDocumentation = {
+  summary: "Disallow raw repository source text as a test oracle; parse or execute the artifact instead.",
+  rationale: "Substring and regex checks can pass on comments or unreachable configuration and fail after behavior-preserving formatting changes.",
+  remediation: "Parse the artifact, execute its validator, or assert on Terraform plan JSON or another runtime contract.",
+  category: "testing",
+  limitations: [
+    "The rule follows lexical aliases, source-path collections, awaited reads, and common text operations; interprocedural flows remain unreported.",
+    "When raw representation is genuinely the contract (for example a golden or compatibility sentinel), use an exact line suppression with the reason."
+  ],
+  examples: [
+    {
+      id: "parsed-policy-contract",
+      title: "Assert on parsed policy behavior",
+      outcome: "no-match",
+      files: [{ path: "src/policy.test.ts", source: "import { readFileSync } from 'node:fs'; test('policy', () => { const policy = JSON.parse(readFileSync('policy.json', 'utf8')); expect(validate(policy)).toEqual([]); });" }],
+      focusPath: "src/policy.test.ts",
+      expectedCount: 0,
+      public: true
+    },
+    {
+      id: "terraform-substring-contract",
+      title: "Do not prove Terraform behavior with a regex",
+      outcome: "match",
+      files: [{ path: "src/policy.test.ts", source: "import { readFileSync } from 'node:fs'; test('policy', () => { const source = readFileSync('main.tf', 'utf8'); expect(source).toMatch(/prevent_destroy/); });" }],
+      focusPath: "src/policy.test.ts",
+      expectedCount: 1,
+      public: true
+    }
+  ]
+};
+function staticMemberName5(node) {
+  if (!node.computed && node.property.type === AST_NODE_TYPES56.Identifier) return node.property.name;
+  if (node.computed && node.property.type === AST_NODE_TYPES56.Literal && typeof node.property.value === "string") return node.property.value;
+  return null;
+}
+function unwrap5(node) {
+  if (node.type === AST_NODE_TYPES56.AwaitExpression) return unwrap5(node.argument);
+  if (node.type === AST_NODE_TYPES56.ChainExpression) return unwrap5(node.expression);
+  if (node.type === AST_NODE_TYPES56.TSAsExpression || node.type === AST_NODE_TYPES56.TSNonNullExpression || node.type === AST_NODE_TYPES56.TSTypeAssertion) return unwrap5(node.expression);
+  return node;
+}
+function stringValue(node) {
+  const current = unwrap5(node);
+  if (current.type === AST_NODE_TYPES56.Literal && typeof current.value === "string") return current.value;
+  if (current.type === AST_NODE_TYPES56.TemplateLiteral && current.expressions.length === 0) return current.quasis[0]?.value.cooked ?? null;
+  return null;
+}
+function importSource(node) {
+  return typeof node.source.value === "string" ? node.source.value : null;
+}
+function requireSource(node) {
+  const current = unwrap5(node);
+  if (current.type !== AST_NODE_TYPES56.CallExpression || current.callee.type !== AST_NODE_TYPES56.Identifier || current.callee.name !== "require" || current.arguments.length !== 1 || current.arguments[0]?.type === AST_NODE_TYPES56.SpreadElement) return null;
+  return stringValue(current.arguments[0]);
+}
+function newScope() {
+  return { collections: /* @__PURE__ */ new Set(), declared: /* @__PURE__ */ new Set(), fsObjects: /* @__PURE__ */ new Set(), fsReaders: /* @__PURE__ */ new Set(), paths: /* @__PURE__ */ new Set(), rawOrigins: /* @__PURE__ */ new Map() };
+}
+var source_coupled_test_default = createRule({
+  name: "source-coupled-test",
+  documentation: sourceCoupledTestDocumentation,
+  meta: {
+    type: "suggestion",
+    docs: { description: sourceCoupledTestDocumentation.summary },
+    schema: [],
+    messages: { rawSourceOracle: "Raw repository source text is the oracle. Parse or execute the artifact so comments, formatting, and unreachable blocks cannot satisfy the contract." }
+  },
+  defaultOptions: [],
+  create(context) {
+    if (!isTestFile(context.filename) || isGeneratedFile(context.filename, context.sourceCode.text)) return {};
+    const scopes = [newScope()];
+    const reportedOrigins = /* @__PURE__ */ new Set();
+    const currentScope = () => scopes.at(-1) ?? scopes[0];
+    const visible = (kind, name) => {
+      for (let index = scopes.length - 1; index >= 0; index--) {
+        const scope = scopes[index];
+        if (scope.declared.has(name)) return scope[kind].has(name);
+      }
+      return false;
+    };
+    const visibleRawOrigins = (name) => {
+      for (let index = scopes.length - 1; index >= 0; index--) {
+        const scope = scopes[index];
+        if (scope.declared.has(name)) return scope.rawOrigins.get(name) ?? /* @__PURE__ */ new Set();
+      }
+      return /* @__PURE__ */ new Set();
+    };
+    const sourcePath = (node) => {
+      const current = unwrap5(node);
+      const value = stringValue(current);
+      if (value !== null) return SOURCE_SUFFIX_RE.test(value);
+      if (current.type === AST_NODE_TYPES56.Identifier) return visible("paths", current.name);
+      if (current.type === AST_NODE_TYPES56.BinaryExpression && current.operator === "+") {
+        return sourcePath(current.left) || sourcePath(current.right);
+      }
+      if (current.type === AST_NODE_TYPES56.TemplateLiteral) return current.expressions.some(sourcePath);
+      if (current.type === AST_NODE_TYPES56.CallExpression || current.type === AST_NODE_TYPES56.NewExpression) {
+        return current.arguments.some((argument) => argument.type !== AST_NODE_TYPES56.SpreadElement && sourcePath(argument));
+      }
+      if (current.type === AST_NODE_TYPES56.MemberExpression) return sourcePath(current.object);
+      return false;
+    };
+    const rawRead = (node) => {
+      const current = unwrap5(node);
+      if (current.type !== AST_NODE_TYPES56.CallExpression || current.arguments.length === 0) return false;
+      const callee = unwrap5(current.callee);
+      if (callee.type === AST_NODE_TYPES56.Identifier) {
+        return visible("fsReaders", callee.name) && sourcePath(current.arguments[0]);
+      }
+      if (callee.type !== AST_NODE_TYPES56.MemberExpression) return false;
+      const name = staticMemberName5(callee);
+      const object = unwrap5(callee.object);
+      return name !== null && FS_READERS.has(name) && object.type === AST_NODE_TYPES56.Identifier && visible("fsObjects", object.name) && sourcePath(current.arguments[0]);
+    };
+    const rawOrigins = (node) => {
+      const current = unwrap5(node);
+      if (current.type === AST_NODE_TYPES56.Identifier) return visibleRawOrigins(current.name);
+      if (rawRead(current)) return /* @__PURE__ */ new Set([`${current.range[0]}:${current.range[1]}`]);
+      if (current.type === AST_NODE_TYPES56.BinaryExpression && current.operator === "+") return /* @__PURE__ */ new Set([...rawOrigins(current.left), ...rawOrigins(current.right)]);
+      if (current.type !== AST_NODE_TYPES56.CallExpression) return /* @__PURE__ */ new Set();
+      const callee = unwrap5(current.callee);
+      if (callee.type !== AST_NODE_TYPES56.MemberExpression) return /* @__PURE__ */ new Set();
+      const name = staticMemberName5(callee);
+      return name !== null && TEXT_TRANSFORMS.has(name) ? rawOrigins(callee.object) : /* @__PURE__ */ new Set();
+    };
+    const evidenceOrigins = (node) => {
+      const current = unwrap5(node);
+      const direct = rawOrigins(current);
+      if (direct.size > 0) return direct;
+      if (current.type === AST_NODE_TYPES56.BinaryExpression || current.type === AST_NODE_TYPES56.LogicalExpression) return /* @__PURE__ */ new Set([...evidenceOrigins(current.left), ...evidenceOrigins(current.right)]);
+      if (current.type === AST_NODE_TYPES56.UnaryExpression) return evidenceOrigins(current.argument);
+      if (current.type !== AST_NODE_TYPES56.CallExpression) return /* @__PURE__ */ new Set();
+      const callee = unwrap5(current.callee);
+      if (callee.type !== AST_NODE_TYPES56.MemberExpression) return /* @__PURE__ */ new Set();
+      const name = staticMemberName5(callee);
+      if (name !== null && TEXT_PREDICATES.has(name)) return rawOrigins(callee.object);
+      if (name !== null && REGEXP_PREDICATES.has(name)) return new Set(current.arguments.flatMap((argument) => argument.type === AST_NODE_TYPES56.SpreadElement ? [] : [...rawOrigins(argument)]));
+      return /* @__PURE__ */ new Set();
+    };
+    const rawAssertionOrigins = (node) => {
+      const callee = unwrap5(node.callee);
+      if (callee.type === AST_NODE_TYPES56.Identifier && callee.name === "assert") {
+        return new Set(node.arguments.flatMap((argument) => argument.type === AST_NODE_TYPES56.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+      }
+      if (callee.type !== AST_NODE_TYPES56.MemberExpression) return /* @__PURE__ */ new Set();
+      const matcher = staticMemberName5(callee);
+      if (matcher === null) return /* @__PURE__ */ new Set();
+      let receiver = unwrap5(callee.object);
+      while (receiver.type === AST_NODE_TYPES56.MemberExpression && EXPECT_MODIFIERS.has(staticMemberName5(receiver) ?? "")) receiver = unwrap5(receiver.object);
+      if (receiver.type === AST_NODE_TYPES56.CallExpression && receiver.callee.type === AST_NODE_TYPES56.Identifier && receiver.callee.name === "expect") {
+        if (!EXPECT_MATCHERS.has(matcher)) return /* @__PURE__ */ new Set();
+        return new Set([...receiver.arguments, ...node.arguments].flatMap((argument) => argument.type === AST_NODE_TYPES56.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+      }
+      if (receiver.type !== AST_NODE_TYPES56.Identifier || receiver.name !== "assert" || !ASSERT_MATCHERS.has(matcher)) return /* @__PURE__ */ new Set();
+      return new Set(node.arguments.flatMap((argument) => argument.type === AST_NODE_TYPES56.SpreadElement ? [] : [...evidenceOrigins(argument)]));
+    };
+    const declare = (name, state) => {
+      const scope = currentScope();
+      scope.declared.add(name);
+      scope.collections.delete(name);
+      scope.fsObjects.delete(name);
+      scope.fsReaders.delete(name);
+      scope.paths.delete(name);
+      scope.rawOrigins.delete(name);
+      if (state.collection === true) scope.collections.add(name);
+      if (state.fsObject === true) scope.fsObjects.add(name);
+      if (state.fsReader === true) scope.fsReaders.add(name);
+      if (state.path === true) scope.paths.add(name);
+      if (state.rawOrigins !== void 0 && state.rawOrigins.size > 0) {
+        scope.rawOrigins.set(name, state.rawOrigins);
+      }
+    };
+    const sourceCollection = (node) => {
+      const current = unwrap5(node);
+      return current.type === AST_NODE_TYPES56.ArrayExpression && current.elements.length > 0 && current.elements.every((element) => element !== null && element.type !== AST_NODE_TYPES56.SpreadElement && sourcePath(element));
+    };
+    const declaredNames2 = (node) => {
+      const current = unwrap5(node);
+      if (current.type === AST_NODE_TYPES56.Identifier) return [current.name];
+      if (current.type === AST_NODE_TYPES56.AssignmentPattern) return declaredNames2(current.left);
+      if (current.type === AST_NODE_TYPES56.RestElement) return declaredNames2(current.argument);
+      if (current.type === AST_NODE_TYPES56.ArrayPattern) return current.elements.flatMap((element) => element === null ? [] : declaredNames2(element));
+      if (current.type === AST_NODE_TYPES56.ObjectPattern) return current.properties.flatMap((property) => property.type === AST_NODE_TYPES56.RestElement ? declaredNames2(property.argument) : declaredNames2(property.value));
+      return [];
+    };
+    const enterFunction = (node) => {
+      scopes.push(newScope());
+      for (const parameter of node.params) for (const name of declaredNames2(parameter)) declare(name, {});
+    };
+    const exitFunction = () => {
+      scopes.pop();
+    };
+    return {
+      ImportDeclaration(node) {
+        const source = importSource(node);
+        if (source === null || !FS_MODULES.has(source)) return;
+        for (const specifier of node.specifiers) {
+          if (specifier.type === AST_NODE_TYPES56.ImportSpecifier) {
+            const imported = specifier.imported.type === AST_NODE_TYPES56.Identifier ? specifier.imported.name : String(specifier.imported.value);
+            if (FS_READERS.has(imported)) declare(specifier.local.name, { fsReader: true });
+          } else {
+            declare(specifier.local.name, { fsObject: true });
+          }
+        }
+      },
+      ":function": enterFunction,
+      ":function:exit": exitFunction,
+      VariableDeclarator(node) {
+        if (node.init === null) return;
+        const required = requireSource(node.init);
+        if (required !== null && FS_MODULES.has(required) && node.id.type === AST_NODE_TYPES56.Identifier) {
+          declare(node.id.name, { fsObject: true });
+          return;
+        }
+        if (node.id.type === AST_NODE_TYPES56.ObjectPattern && required !== null && FS_MODULES.has(required)) {
+          for (const property of node.id.properties) {
+            if (property.type !== AST_NODE_TYPES56.Property || property.value.type !== AST_NODE_TYPES56.Identifier) continue;
+            const key = property.key.type === AST_NODE_TYPES56.Identifier ? property.key.name : property.key.type === AST_NODE_TYPES56.Literal ? String(property.key.value) : "";
+            if (FS_READERS.has(key)) declare(property.value.name, { fsReader: true });
+          }
+          return;
+        }
+        if (node.id.type !== AST_NODE_TYPES56.Identifier) return;
+        declare(node.id.name, { collection: sourceCollection(node.init), path: sourcePath(node.init), rawOrigins: rawOrigins(node.init) });
+      },
+      AssignmentExpression(node) {
+        if (node.left.type === AST_NODE_TYPES56.Identifier) declare(node.left.name, { path: sourcePath(node.right), rawOrigins: rawOrigins(node.right) });
+      },
+      ForOfStatement(node) {
+        const right = unwrap5(node.right);
+        const collection = right.type === AST_NODE_TYPES56.Identifier && visible("collections", right.name);
+        const left = node.left.type === AST_NODE_TYPES56.VariableDeclaration ? node.left.declarations[0]?.id : node.left;
+        if (collection && left?.type === AST_NODE_TYPES56.Identifier) declare(left.name, { path: true });
+      },
+      CallExpression(node) {
+        const origins = rawAssertionOrigins(node);
+        if (origins.size === 0 || [...origins].every((origin) => reportedOrigins.has(origin))) return;
+        for (const origin of origins) reportedOrigins.add(origin);
+        context.report({ node, messageId: "rawSourceOracle" });
+      }
+    };
+  }
+});
+
 // src/rules/zod-naming-convention.ts
 import {
-  AST_NODE_TYPES as AST_NODE_TYPES56,
+  AST_NODE_TYPES as AST_NODE_TYPES57,
   ASTUtils as ASTUtils16
 } from "@typescript-eslint/utils";
 var zodNamingConventionDocumentation = {
@@ -14807,18 +15170,18 @@ var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "prettifyError",
   "treeifyError"
 ]);
-var terminalMethodName = (callee) => !callee.computed && callee.property.type === AST_NODE_TYPES56.Identifier ? callee.property.name : null;
+var terminalMethodName = (callee) => !callee.computed && callee.property.type === AST_NODE_TYPES57.Identifier ? callee.property.name : null;
 var calleeChainRoot = (node) => {
   let current = node;
   for (; ; ) {
-    if (current.type === AST_NODE_TYPES56.Identifier) {
+    if (current.type === AST_NODE_TYPES57.Identifier) {
       return current;
     }
-    if (current.type === AST_NODE_TYPES56.MemberExpression) {
+    if (current.type === AST_NODE_TYPES57.MemberExpression) {
       current = current.object;
       continue;
     }
-    if (current.type === AST_NODE_TYPES56.CallExpression) {
+    if (current.type === AST_NODE_TYPES57.CallExpression) {
       current = current.callee;
       continue;
     }
@@ -14880,7 +15243,7 @@ var zod_naming_convention_default = createRule({
       ImportDeclaration(node) {
         if (!isZodModule(node.source.value)) return;
         for (const specifier of node.specifiers) {
-          if (specifier.type === AST_NODE_TYPES56.ImportNamespaceSpecifier || specifier.type === AST_NODE_TYPES56.ImportDefaultSpecifier || specifier.type === AST_NODE_TYPES56.ImportSpecifier && (specifier.imported.type === AST_NODE_TYPES56.Identifier ? specifier.imported.name === "z" : specifier.imported.value === "z")) {
+          if (specifier.type === AST_NODE_TYPES57.ImportNamespaceSpecifier || specifier.type === AST_NODE_TYPES57.ImportDefaultSpecifier || specifier.type === AST_NODE_TYPES57.ImportSpecifier && (specifier.imported.type === AST_NODE_TYPES57.Identifier ? specifier.imported.name === "z" : specifier.imported.value === "z")) {
             recordZodBinding(specifier.local);
           }
         }
@@ -14888,13 +15251,13 @@ var zod_naming_convention_default = createRule({
       VariableDeclarator(node) {
         const init = node.init;
         if (init === null || init === void 0) return;
-        if (init.type !== AST_NODE_TYPES56.CallExpression) return;
+        if (init.type !== AST_NODE_TYPES57.CallExpression) return;
         const callee = init.callee;
-        if (callee.type !== AST_NODE_TYPES56.MemberExpression) return;
+        if (callee.type !== AST_NODE_TYPES57.MemberExpression) return;
         if (!isZodChain(callee)) return;
         const terminal = terminalMethodName(callee);
         if (terminal !== null && NON_SCHEMA_TERMINALS.has(terminal)) return;
-        if (node.id.type !== AST_NODE_TYPES56.Identifier) return;
+        if (node.id.type !== AST_NODE_TYPES57.Identifier) return;
         if (test.test(node.id.name)) return;
         if (acceptsSchemaWord && CONTAINS_SCHEMA_RE.test(node.id.name)) return;
         context.report({
@@ -15003,6 +15366,7 @@ var rules = {
   "no-impossible-zod-literal-bounds": no_impossible_zod_literal_bounds_default,
   "no-log-only-catch": no_log_only_catch_default,
   "no-long-comment": no_long_comment_default,
+  "no-vague-suppression-description": no_vague_suppression_description_default,
   "no-generic-single-export-module": no_generic_single_export_module_default,
   "no-offset-pagination": no_offset_pagination_default,
   "no-positional-tuple-return": no_positional_tuple_return_default,
@@ -15051,17 +15415,19 @@ var rules = {
   "require-zod-form-validation": require_zod_form_validation_default,
   "store-insert-requires-on-conflict": store_insert_requires_on_conflict_default,
   "stepdown": stepdown_default,
+  "source-coupled-test": source_coupled_test_default,
   "zod-naming-convention": zod_naming_convention_default
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.6.7"
+  version: "15.6.9"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",
   "prefer-native-random-uuid",
   "prefer-shadcn-primitives"
 ];
+var advisoryRules = ["no-vague-suppression-description", "source-coupled-test"];
 var recommendedRules = {
   "@sarj/duplicate-test-body": "error",
   "@sarj/enforce-file-structure": "error",
@@ -15077,6 +15443,7 @@ var recommendedRules = {
   "@sarj/no-impossible-zod-literal-bounds": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
+  "@sarj/no-vague-suppression-description": "warn",
   "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
@@ -15119,6 +15486,7 @@ var recommendedRules = {
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
   "@sarj/stepdown": "error",
+  "@sarj/source-coupled-test": "warn",
   "@sarj/zod-naming-convention": "error"
 };
 var strictRules = {
@@ -15137,6 +15505,7 @@ var strictRules = {
   "@sarj/no-impossible-zod-literal-bounds": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
+  "@sarj/no-vague-suppression-description": "warn",
   "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
@@ -15182,6 +15551,7 @@ var strictRules = {
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
   "@sarj/stepdown": "error",
+  "@sarj/source-coupled-test": "warn",
   "@sarj/zod-naming-convention": "error"
 };
 var plugin = {
@@ -15205,6 +15575,7 @@ var plugin = {
 };
 var index_default = plugin;
 export {
+  advisoryRules,
   applicationOnlyRules,
   index_default as default,
   publicDocumentation,

package/package.json

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