@sarj/eslint-plugin 9.17.1 → 11.0.0

package/README.md

@@ -26,11 +26,16 @@ import sarj from "@sarj/eslint-plugin";
 export default [sarj.configs.recommended];
 ```
 
-67 rules. Each source under `src/rules/` states one concise claim and links to
+66 rules. Each source under `src/rules/` states one concise claim and links to
 its paired tests. The definition and named test cases are the complete rule
 specification, and `meta.docs.url` points directly to those executable examples.
 
-Presets: `recommended` (warn-first), `strict` (every general-profile rule at its declared strict severity), `style-guide` (formatting/naming subset). Application-only rules are exported through `applicationOnlyRules` and configured by the application profile. The two-sentence comment rule warns; its three-sentence companion errors.
+Presets: `recommended` is a curated subset and `strict` contains every
+general-profile rule. Every active custom rule in both presets is an error;
+rules that cannot meet that bar are narrowed or retired instead of being left
+as permanent warning noise. Application-only rules are exported through
+`applicationOnlyRules` and are also errors when the application profile enables
+them. `style-guide` remains the formatting/naming subset.
 
 ## New in 9.8.0 — application library policy adapters
 
@@ -130,15 +135,14 @@ platform too.
 |---|---|---|
 | `no-hand-rolled-spinner` | Intrinsic elements styled as Tailwind border-ring loading spinners outside the design system. | error / error |
 | `prefer-input-group-search` | Search icons and shared Input controls composed without the shared InputGroup primitive. | error / error |
-| `prefer-shadcn-primitives` | Deterministically visible raw JSX controls used instead of shared shadcn primitives. Unknown and hidden input types are excluded. | application profile: warn |
+| `prefer-shadcn-primitives` | Deterministically visible raw JSX controls used instead of shared shadcn primitives. Unknown and hidden input types are excluded. | application profile: error |
 | `require-static-next-matcher` | Dynamic values in exported Next.js middleware and proxy matcher configuration. | error / error |
-| `no-hand-rolled-sleep` | `new Promise((r) => setTimeout(r, ms))` in any spelling, and an uncleared `Promise.race`/`Promise.any` timeout arm. Options: `checkClientModules` (default `false`), `allowIn`. | warn / error |
+| `no-hand-rolled-sleep` | `new Promise((r) => setTimeout(r, ms))` in any spelling, and an uncleared `Promise.race`/`Promise.any` timeout arm. Options: `checkClientModules` (default `false`), `allowIn`. | error / error |
 
 `prefer-shadcn-primitives` is application-only because generic plugin consumers
-may use another design system or intentionally expose native controls. It starts
-at warning with 53 measured adoption findings across four application-profile
-consumers; two additional consumers are clean. Promote it only after those
-findings are removed, and keep it disabled inside `components/ui` and
+may use another design system or intentionally expose native controls. The
+application profile enforces its measured, deterministic cases as errors while
+keeping it disabled inside `components/ui` and
 `components/design-system`, where shared primitives must wrap native elements.
 
 ## New in 2.14.0 — `no-tautological-expect`

package/dist/index.cjs

@@ -928,6 +928,8 @@ var CODE_TAIL_RE = /[;{}()]\s*$|=>\s*$|,\s*$/;
 var ASSIGN_RE = /^[A-Za-z_$][\w.$[\]]*\s*(?:=(?![=>])|\+=|-=|\*=)\s*\S.*[;)}\]]\s*$/;
 var CALL_RE = /^[A-Za-z_$][\w.$]*\([^)]*\)\s*;?\s*$/;
 var ASSERTION_CODE_RE = /^(?:await\s+)?(?:expect(?:TypeOf)?|assert(?:\.\w+)?)\s*\(/;
+var HTTP_CONTRACT_RE = /\b(?:GET|HEAD|OPTIONS|PATCH|POST|PUT|DELETE)\s+(?:https?:\/\/|\/|\{[A-Za-z_$])/;
+var PROSE_ASSIGNMENT_RE = /^[A-Za-z_$][\w.$[\]]*\s*=\s*[A-Za-z][A-Za-z '-]{2,}\s+\((?:how|what|when|where|which|who|why)\b[^)]*\)[.!]?$/i;
 var PSEUDOCODE_RE = /%\w+%|\[opt\]|(?:^|\s)<[A-Za-z]\w*>|…|\.\.\./;
 function isBanner(text) {
   const t = text.trim();
@@ -946,6 +948,7 @@ function isRegionMarker(text) {
 function looksLikeCode(text, allowCall = true) {
   const t = text.trim();
   if (!t) return false;
+  if (PROSE_ASSIGNMENT_RE.test(t)) return false;
   if (CODE_KEYWORD_RE.test(t) && CODE_TAIL_RE.test(t)) return true;
   if (ASSIGN_RE.test(t)) return true;
   if (ASSERTION_CODE_RE.test(t)) return true;
@@ -1084,6 +1087,21 @@ function runCitesAReference(comments, index) {
 function areAdjacentLineComments(a, b) {
   return a !== void 0 && b !== void 0 && a.type === "Line" && b.type === "Line" && b.loc.start.line === a.loc.end.line + 1;
 }
+function lineRunStart(comments, index) {
+  let start = index;
+  while (start > 0 && areAdjacentLineComments(comments[start - 1], comments[start])) {
+    start -= 1;
+  }
+  return start;
+}
+function runDocumentsHttpContract(comments, index) {
+  const start = lineRunStart(comments, index);
+  for (let i = start; i < comments.length; i++) {
+    if (i > start && !areAdjacentLineComments(comments[i - 1], comments[i])) break;
+    if (HTTP_CONTRACT_RE.test(stripCommentMarker(comments[i]?.value ?? ""))) return true;
+  }
+  return false;
+}
 function isInsideCommentRun(comments, index) {
   const comment = comments[index];
   return areAdjacentLineComments(comments[index - 1], comment) || areAdjacentLineComments(comment, comments[index + 1]);
@@ -1119,7 +1137,7 @@ var no_comment_cruft_default = createRule({
     schema: [],
     messages: {
       commentedOutCode: "Commented-out code \u2014 delete it; git history remembers.",
-      sectionBanner: "Section-banner / region comment \u2014 structure code with functions, not ASCII rules.",
+      sectionBanner: "Section-banner / region comment \u2014 remove the decoration or replace it with a named code boundary.",
       fileHeaderPreamble: "File-header comment preamble \u2014 use a brief doc comment for the why, not a block of `//` lines.",
       commentWall: "Statement comment wall ({{count}} narrated steps) \u2014 delete the walkthrough and name the operations in code; keep only constraints or rationale.",
       redundantNarration: "Comment narrates the code \u2014 delete it or say *why*, not *what*. Code is self-documenting.",
@@ -1142,6 +1160,17 @@ var no_comment_cruft_default = createRule({
     function isJsDoc(comment) {
       return comment.type === "Block" && /^\*/.test(comment.value);
     }
+    function isJsxOnlyComment(comment) {
+      for (let node = sourceCode.getNodeByRangeIndex(
+        comment.range[0]
+      ); node != null; node = node.parent) {
+        if (node.type === import_utils7.AST_NODE_TYPES.JSXExpressionContainer) {
+          return node.expression.type === import_utils7.AST_NODE_TYPES.JSXEmptyExpression;
+        }
+        if (node.type === import_utils7.AST_NODE_TYPES.Program) return false;
+      }
+      return false;
+    }
     function findCommentWalls(comments) {
       const attached = /* @__PURE__ */ new Map();
       for (const comment of comments) {
@@ -1223,6 +1252,8 @@ var no_comment_cruft_default = createRule({
         const enumerated = comments.filter(
           (c) => c.type === "Line" && ENUMERATION_RE.test(stripCommentMarker(c.value))
         );
+        const reportedBannerRuns = /* @__PURE__ */ new Set();
+        const reportedCodeRuns = /* @__PURE__ */ new Set();
         for (let i = 0; i < comments.length; i++) {
           const comment = comments[i];
           if (comment === void 0) continue;
@@ -1242,9 +1273,14 @@ var no_comment_cruft_default = createRule({
             }
             continue;
           }
-          if (!isStandalone(comment)) continue;
           if (LICENSE_RE.test(comment.value)) continue;
           const texts = comment.value.split("\n").map(stripCommentMarker).filter((l) => l.length > 0 && !isDirective(l));
+          if (!isStandalone(comment)) {
+            if (isJsxOnlyComment(comment) && texts.some(isBanner)) {
+              context.report({ node: comment, messageId: "sectionBanner" });
+            }
+            continue;
+          }
           const firstText = texts[0];
           if (firstText !== void 0 && /^(?:todo|fixme)\b/i.test(firstText)) {
             if (!runCitesAReference(comments, i)) {
@@ -1259,16 +1295,23 @@ var no_comment_cruft_default = createRule({
             context.report({ node: comment, messageId: "placeholderImplementation" });
             continue;
           }
+          const runStart = lineRunStart(comments, i);
           if (texts.some(isBanner)) {
-            context.report({ node: comment, messageId: "sectionBanner" });
+            if (!reportedBannerRuns.has(runStart)) {
+              context.report({ node: comment, messageId: "sectionBanner" });
+              reportedBannerRuns.add(runStart);
+            }
             continue;
           }
           const prev = comments[i - 1];
           const precedingProse = prev !== void 0 && prev.type === "Line" && prev.loc.end.line === comment.loc.start.line - 1 && isProse(stripCommentMarker(prev.value));
           const container = sourceCode.getNodeByRangeIndex(comment.range[0]);
           const inTypeMembers = container !== null && TYPE_MEMBER_CONTAINERS.has(container.type);
-          if (hasCommentedOutCode(texts, precedingProse, !inTypeMembers) && !hasIllustrationLeadInAbove(comments, i)) {
-            context.report({ node: comment, messageId: "commentedOutCode" });
+          if (hasCommentedOutCode(texts, precedingProse, !inTypeMembers) && !hasIllustrationLeadInAbove(comments, i) && !runDocumentsHttpContract(comments, i)) {
+            if (!reportedCodeRuns.has(runStart)) {
+              context.report({ node: comment, messageId: "commentedOutCode" });
+              reportedCodeRuns.add(runStart);
+            }
             continue;
           }
           if (comment.type === "Line" && texts.length === 1) {
@@ -9759,31 +9802,6 @@ var prefer_server_actions_default = createRule({
   }
 });
 
-// src/rules/prefer-single-sentence-comment.ts
-var prefer_single_sentence_comment_default = createRule({
-  name: "prefer-single-sentence-comment",
-  meta: {
-    type: "suggestion",
-    docs: { description: "Prefer one sentence and self-documenting code over a two-sentence comment." },
-    schema: [],
-    messages: {
-      preferOneSentence: "Two-sentence comment \u2014 prefer one sentence and self-documenting code."
-    }
-  },
-  defaultOptions: [],
-  create(context) {
-    return {
-      Program() {
-        for (const group of proseGroups(context.filename, context.sourceCode)) {
-          if (!group.hasTypedTags && sentenceUnits(group.text) === 2) {
-            context.report({ node: group.comment, messageId: "preferOneSentence" });
-          }
-        }
-      }
-    };
-  }
-});
-
 // src/rules/prefer-string-literal-union.ts
 var import_utils62 = require("@typescript-eslint/utils");
 var ts2 = __toESM(require("typescript"), 1);
@@ -12271,6 +12289,10 @@ var retiredRules = {
     removedIn: "3.0.0",
     reason: "Delete the retired entry; application-profile consumers can separately adopt `@sarj/prefer-shadcn-primitives`."
   },
+  "prefer-single-sentence-comment": {
+    removedIn: "10.0.0",
+    reason: "Delete the config entry and suppressions; use the narrower no-comment-cruft, no-restated-comment, and no-long-comment rules."
+  },
   "primary-export-file-name": {
     removedIn: "4.0.0",
     reason: "Delete the config entry and suppressions; there is no replacement."
@@ -12345,7 +12367,6 @@ var rules = {
   "prefer-schema-for-api-payload": prefer_schema_for_api_payload_default,
   "prefer-semantic-colors": prefer_semantic_colors_default,
   "prefer-server-actions": prefer_server_actions_default,
-  "prefer-single-sentence-comment": prefer_single_sentence_comment_default,
   "prefer-string-literal-union": prefer_string_literal_union_default,
   "prefer-whole-object-assertion": prefer_whole_object_assertion_default,
   "prefer-zod-enum": prefer_zod_enum_default,
@@ -12361,7 +12382,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.17.1"
+  version: "11.0.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",
@@ -12369,69 +12390,68 @@ var applicationOnlyRules = [
   "prefer-shadcn-primitives"
 ];
 var recommendedRules = {
-  "@sarj/duplicate-test-body": "warn",
-  "@sarj/enforce-file-structure": "warn",
-  "@sarj/no-async-callback-in-wait-for": "warn",
-  "@sarj/no-client-side-data-fetching": "warn",
-  "@sarj/no-comment-cruft": "warn",
-  "@sarj/no-conditional-in-test": "warn",
-  "@sarj/no-cors-wildcard-with-credentials": "warn",
-  "@sarj/no-dynamic-sql": "warn",
-  "@sarj/no-fat-try-blocks": "warn",
-  "@sarj/no-hand-rolled-sleep": "warn",
+  "@sarj/duplicate-test-body": "error",
+  "@sarj/enforce-file-structure": "error",
+  "@sarj/no-async-callback-in-wait-for": "error",
+  "@sarj/no-client-side-data-fetching": "error",
+  "@sarj/no-comment-cruft": "error",
+  "@sarj/no-conditional-in-test": "error",
+  "@sarj/no-cors-wildcard-with-credentials": "error",
+  "@sarj/no-dynamic-sql": "error",
+  "@sarj/no-fat-try-blocks": "error",
+  "@sarj/no-hand-rolled-sleep": "error",
   "@sarj/no-hand-rolled-spinner": "error",
-  "@sarj/no-insecure-random-id": "warn",
-  "@sarj/no-json-stringify-error": "warn",
-  "@sarj/no-log-only-catch": "warn",
-  "@sarj/no-long-comment": "warn",
-  "@sarj/no-generic-single-export-module": "warn",
-  "@sarj/no-offset-pagination": "warn",
-  "@sarj/no-positional-tuple-return": "warn",
-  "@sarj/no-repeated-string-literal": "warn",
-  "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "warn",
-  "@sarj/no-secret-in-log": "warn",
-  "@sarj/no-select-star": "warn",
-  "@sarj/no-sentinel-return-on-catch": "warn",
-  "@sarj/no-silent-promise-catch": "warn",
-  "@sarj/no-sleep-in-test-body": "warn",
-  "@sarj/no-string-concat-in-loop": "warn",
-  "@sarj/no-tautological-expect": "warn",
-  "@sarj/no-typed-doc-sections": "warn",
-  "@sarj/no-trailing-value-narration": "warn",
-  "@sarj/no-declaration-comment-wall": "warn",
-  "@sarj/no-union-in-comment": "warn",
-  "@sarj/no-type-member-comment-wall": "warn",
-  "@sarj/no-unnecessary-use-client": "warn",
-  "@sarj/no-unsafe-mock-casting": "warn",
-  "@sarj/no-zod-native-enum": "warn",
-  "@sarj/test-loops-over-literal-cases": "warn",
+  "@sarj/no-insecure-random-id": "error",
+  "@sarj/no-json-stringify-error": "error",
+  "@sarj/no-log-only-catch": "error",
+  "@sarj/no-long-comment": "error",
+  "@sarj/no-generic-single-export-module": "error",
+  "@sarj/no-offset-pagination": "error",
+  "@sarj/no-positional-tuple-return": "error",
+  "@sarj/no-repeated-string-literal": "error",
+  "@sarj/no-restated-comment": "error",
+  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-secret-in-log": "error",
+  "@sarj/no-select-star": "error",
+  "@sarj/no-sentinel-return-on-catch": "error",
+  "@sarj/no-silent-promise-catch": "error",
+  "@sarj/no-sleep-in-test-body": "error",
+  "@sarj/no-string-concat-in-loop": "error",
+  "@sarj/no-tautological-expect": "error",
+  "@sarj/no-typed-doc-sections": "error",
+  "@sarj/no-trailing-value-narration": "error",
+  "@sarj/no-declaration-comment-wall": "error",
+  "@sarj/no-union-in-comment": "error",
+  "@sarj/no-type-member-comment-wall": "error",
+  "@sarj/no-unnecessary-use-client": "error",
+  "@sarj/no-unsafe-mock-casting": "error",
+  "@sarj/no-zod-native-enum": "error",
+  "@sarj/test-loops-over-literal-cases": "error",
   "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-discriminated-union": "warn",
+  "@sarj/prefer-discriminated-union": "error",
   "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-immutable-module-constant": "warn",
-  "@sarj/prefer-module-level-constant": "warn",
-  "@sarj/prefer-module-level-schema": "warn",
-  "@sarj/prefer-non-nullable-collection": "warn",
-  "@sarj/prefer-schema-for-api-payload": "warn",
-  "@sarj/prefer-semantic-colors": ["warn", { requireSemanticTokens: true }],
-  "@sarj/prefer-server-actions": "warn",
-  "@sarj/prefer-single-sentence-comment": "warn",
-  "@sarj/prefer-string-literal-union": "warn",
-  "@sarj/prefer-whole-object-assertion": "warn",
-  "@sarj/prefer-zod-enum": "warn",
-  "@sarj/prefer-zod-infer": "warn",
-  "@sarj/require-assert-never": "warn",
-  "@sarj/require-fetch-timeout": "warn",
-  "@sarj/require-interface-for-injected-service": "warn",
+  "@sarj/prefer-immutable-module-constant": "error",
+  "@sarj/prefer-module-level-constant": "error",
+  "@sarj/prefer-module-level-schema": "error",
+  "@sarj/prefer-non-nullable-collection": "error",
+  "@sarj/prefer-schema-for-api-payload": "error",
+  "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
+  "@sarj/prefer-server-actions": "error",
+  "@sarj/prefer-string-literal-union": "error",
+  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-zod-enum": "error",
+  "@sarj/prefer-zod-infer": "error",
+  "@sarj/require-assert-never": "error",
+  "@sarj/require-fetch-timeout": "error",
+  "@sarj/require-interface-for-injected-service": "error",
   "@sarj/require-static-next-matcher": "error",
   "@sarj/require-zod-form-validation": "error",
-  "@sarj/store-insert-requires-on-conflict": "warn",
-  "@sarj/stepdown": "warn",
-  "@sarj/zod-naming-convention": "warn"
+  "@sarj/store-insert-requires-on-conflict": "error",
+  "@sarj/stepdown": "error",
+  "@sarj/zod-naming-convention": "error"
 };
 var strictRules = {
-  "@sarj/duplicate-test-body": "warn",
+  "@sarj/duplicate-test-body": "error",
   "@sarj/enforce-file-structure": "error",
   "@sarj/no-async-callback-in-wait-for": "error",
   "@sarj/no-client-side-data-fetching": "error",
@@ -12447,7 +12467,7 @@ var strictRules = {
   "@sarj/no-json-stringify-error": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
-  "@sarj/no-generic-single-export-module": "warn",
+  "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
   "@sarj/no-raw-env": "error",
@@ -12471,29 +12491,28 @@ var strictRules = {
   "@sarj/no-unnecessary-use-client": "error",
   "@sarj/no-unsafe-mock-casting": "error",
   "@sarj/no-zod-native-enum": "error",
-  "@sarj/test-loops-over-literal-cases": "warn",
+  "@sarj/test-loops-over-literal-cases": "error",
   "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-discriminated-union": "warn",
+  "@sarj/prefer-discriminated-union": "error",
   "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-immutable-module-constant": "warn",
+  "@sarj/prefer-immutable-module-constant": "error",
   "@sarj/prefer-module-level-constant": "error",
   "@sarj/prefer-module-level-schema": "error",
-  "@sarj/prefer-non-nullable-collection": "warn",
+  "@sarj/prefer-non-nullable-collection": "error",
   "@sarj/prefer-schema-for-api-payload": "error",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-single-sentence-comment": "warn",
   "@sarj/prefer-string-literal-union": "error",
   "@sarj/prefer-whole-object-assertion": "error",
   "@sarj/prefer-zod-enum": "error",
   "@sarj/prefer-zod-infer": "error",
-  "@sarj/require-assert-never": "warn",
+  "@sarj/require-assert-never": "error",
   "@sarj/require-fetch-timeout": "error",
-  "@sarj/require-interface-for-injected-service": "warn",
+  "@sarj/require-interface-for-injected-service": "error",
   "@sarj/require-static-next-matcher": "error",
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
-  "@sarj/stepdown": "warn",
+  "@sarj/stepdown": "error",
   "@sarj/zod-naming-convention": "error"
 };
 var plugin = {

package/dist/index.d.cts

@@ -267,9 +267,6 @@ declare const rules: {
     readonly "prefer-server-actions": _typescript_eslint_utils_ts_eslint.RuleModule<"preferServerAction", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
-    readonly "prefer-single-sentence-comment": _typescript_eslint_utils_ts_eslint.RuleModule<"preferOneSentence", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-        name: string;
-    };
     readonly "prefer-string-literal-union": _typescript_eslint_utils_ts_eslint.RuleModule<"bareChoiceField" | "comparisonCluster", readonly [{
         ignoreFields?: readonly string[];
     }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
@@ -319,71 +316,70 @@ declare const rules: {
 /** 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"];
 declare const recommendedRules: {
-    readonly "@sarj/duplicate-test-body": "warn";
-    readonly "@sarj/enforce-file-structure": "warn";
-    readonly "@sarj/no-async-callback-in-wait-for": "warn";
-    readonly "@sarj/no-client-side-data-fetching": "warn";
-    readonly "@sarj/no-comment-cruft": "warn";
-    readonly "@sarj/no-conditional-in-test": "warn";
-    readonly "@sarj/no-cors-wildcard-with-credentials": "warn";
-    readonly "@sarj/no-dynamic-sql": "warn";
-    readonly "@sarj/no-fat-try-blocks": "warn";
-    readonly "@sarj/no-hand-rolled-sleep": "warn";
+    readonly "@sarj/duplicate-test-body": "error";
+    readonly "@sarj/enforce-file-structure": "error";
+    readonly "@sarj/no-async-callback-in-wait-for": "error";
+    readonly "@sarj/no-client-side-data-fetching": "error";
+    readonly "@sarj/no-comment-cruft": "error";
+    readonly "@sarj/no-conditional-in-test": "error";
+    readonly "@sarj/no-cors-wildcard-with-credentials": "error";
+    readonly "@sarj/no-dynamic-sql": "error";
+    readonly "@sarj/no-fat-try-blocks": "error";
+    readonly "@sarj/no-hand-rolled-sleep": "error";
     readonly "@sarj/no-hand-rolled-spinner": "error";
-    readonly "@sarj/no-insecure-random-id": "warn";
-    readonly "@sarj/no-json-stringify-error": "warn";
-    readonly "@sarj/no-log-only-catch": "warn";
-    readonly "@sarj/no-long-comment": "warn";
-    readonly "@sarj/no-generic-single-export-module": "warn";
-    readonly "@sarj/no-offset-pagination": "warn";
-    readonly "@sarj/no-positional-tuple-return": "warn";
-    readonly "@sarj/no-repeated-string-literal": "warn";
-    readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "warn";
-    readonly "@sarj/no-secret-in-log": "warn";
-    readonly "@sarj/no-select-star": "warn";
-    readonly "@sarj/no-sentinel-return-on-catch": "warn";
-    readonly "@sarj/no-silent-promise-catch": "warn";
-    readonly "@sarj/no-sleep-in-test-body": "warn";
-    readonly "@sarj/no-string-concat-in-loop": "warn";
-    readonly "@sarj/no-tautological-expect": "warn";
-    readonly "@sarj/no-typed-doc-sections": "warn";
-    readonly "@sarj/no-trailing-value-narration": "warn";
-    readonly "@sarj/no-declaration-comment-wall": "warn";
-    readonly "@sarj/no-union-in-comment": "warn";
-    readonly "@sarj/no-type-member-comment-wall": "warn";
-    readonly "@sarj/no-unnecessary-use-client": "warn";
-    readonly "@sarj/no-unsafe-mock-casting": "warn";
-    readonly "@sarj/no-zod-native-enum": "warn";
-    readonly "@sarj/test-loops-over-literal-cases": "warn";
+    readonly "@sarj/no-insecure-random-id": "error";
+    readonly "@sarj/no-json-stringify-error": "error";
+    readonly "@sarj/no-log-only-catch": "error";
+    readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-generic-single-export-module": "error";
+    readonly "@sarj/no-offset-pagination": "error";
+    readonly "@sarj/no-positional-tuple-return": "error";
+    readonly "@sarj/no-repeated-string-literal": "error";
+    readonly "@sarj/no-restated-comment": "error";
+    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-secret-in-log": "error";
+    readonly "@sarj/no-select-star": "error";
+    readonly "@sarj/no-sentinel-return-on-catch": "error";
+    readonly "@sarj/no-silent-promise-catch": "error";
+    readonly "@sarj/no-sleep-in-test-body": "error";
+    readonly "@sarj/no-string-concat-in-loop": "error";
+    readonly "@sarj/no-tautological-expect": "error";
+    readonly "@sarj/no-typed-doc-sections": "error";
+    readonly "@sarj/no-trailing-value-narration": "error";
+    readonly "@sarj/no-declaration-comment-wall": "error";
+    readonly "@sarj/no-union-in-comment": "error";
+    readonly "@sarj/no-type-member-comment-wall": "error";
+    readonly "@sarj/no-unnecessary-use-client": "error";
+    readonly "@sarj/no-unsafe-mock-casting": "error";
+    readonly "@sarj/no-zod-native-enum": "error";
+    readonly "@sarj/test-loops-over-literal-cases": "error";
     readonly "@sarj/prefer-constant-time-secret-compare": "error";
-    readonly "@sarj/prefer-discriminated-union": "warn";
+    readonly "@sarj/prefer-discriminated-union": "error";
     readonly "@sarj/prefer-input-group-search": "error";
-    readonly "@sarj/prefer-immutable-module-constant": "warn";
-    readonly "@sarj/prefer-module-level-constant": "warn";
-    readonly "@sarj/prefer-module-level-schema": "warn";
-    readonly "@sarj/prefer-non-nullable-collection": "warn";
-    readonly "@sarj/prefer-schema-for-api-payload": "warn";
-    readonly "@sarj/prefer-semantic-colors": readonly ["warn", {
+    readonly "@sarj/prefer-immutable-module-constant": "error";
+    readonly "@sarj/prefer-module-level-constant": "error";
+    readonly "@sarj/prefer-module-level-schema": "error";
+    readonly "@sarj/prefer-non-nullable-collection": "error";
+    readonly "@sarj/prefer-schema-for-api-payload": "error";
+    readonly "@sarj/prefer-semantic-colors": readonly ["error", {
         readonly requireSemanticTokens: true;
     }];
-    readonly "@sarj/prefer-server-actions": "warn";
-    readonly "@sarj/prefer-single-sentence-comment": "warn";
-    readonly "@sarj/prefer-string-literal-union": "warn";
-    readonly "@sarj/prefer-whole-object-assertion": "warn";
-    readonly "@sarj/prefer-zod-enum": "warn";
-    readonly "@sarj/prefer-zod-infer": "warn";
-    readonly "@sarj/require-assert-never": "warn";
-    readonly "@sarj/require-fetch-timeout": "warn";
-    readonly "@sarj/require-interface-for-injected-service": "warn";
+    readonly "@sarj/prefer-server-actions": "error";
+    readonly "@sarj/prefer-string-literal-union": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-zod-enum": "error";
+    readonly "@sarj/prefer-zod-infer": "error";
+    readonly "@sarj/require-assert-never": "error";
+    readonly "@sarj/require-fetch-timeout": "error";
+    readonly "@sarj/require-interface-for-injected-service": "error";
     readonly "@sarj/require-static-next-matcher": "error";
     readonly "@sarj/require-zod-form-validation": "error";
-    readonly "@sarj/store-insert-requires-on-conflict": "warn";
-    readonly "@sarj/stepdown": "warn";
-    readonly "@sarj/zod-naming-convention": "warn";
+    readonly "@sarj/store-insert-requires-on-conflict": "error";
+    readonly "@sarj/stepdown": "error";
+    readonly "@sarj/zod-naming-convention": "error";
 };
 declare const strictRules: {
-    readonly "@sarj/duplicate-test-body": "warn";
+    readonly "@sarj/duplicate-test-body": "error";
     readonly "@sarj/enforce-file-structure": "error";
     readonly "@sarj/no-async-callback-in-wait-for": "error";
     readonly "@sarj/no-client-side-data-fetching": "error";
@@ -399,7 +395,7 @@ declare const strictRules: {
     readonly "@sarj/no-json-stringify-error": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
-    readonly "@sarj/no-generic-single-export-module": "warn";
+    readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
     readonly "@sarj/no-raw-env": "error";
@@ -423,31 +419,30 @@ declare const strictRules: {
     readonly "@sarj/no-unnecessary-use-client": "error";
     readonly "@sarj/no-unsafe-mock-casting": "error";
     readonly "@sarj/no-zod-native-enum": "error";
-    readonly "@sarj/test-loops-over-literal-cases": "warn";
+    readonly "@sarj/test-loops-over-literal-cases": "error";
     readonly "@sarj/prefer-constant-time-secret-compare": "error";
-    readonly "@sarj/prefer-discriminated-union": "warn";
+    readonly "@sarj/prefer-discriminated-union": "error";
     readonly "@sarj/prefer-input-group-search": "error";
-    readonly "@sarj/prefer-immutable-module-constant": "warn";
+    readonly "@sarj/prefer-immutable-module-constant": "error";
     readonly "@sarj/prefer-module-level-constant": "error";
     readonly "@sarj/prefer-module-level-schema": "error";
-    readonly "@sarj/prefer-non-nullable-collection": "warn";
+    readonly "@sarj/prefer-non-nullable-collection": "error";
     readonly "@sarj/prefer-schema-for-api-payload": "error";
     readonly "@sarj/prefer-semantic-colors": readonly ["error", {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-single-sentence-comment": "warn";
     readonly "@sarj/prefer-string-literal-union": "error";
     readonly "@sarj/prefer-whole-object-assertion": "error";
     readonly "@sarj/prefer-zod-enum": "error";
     readonly "@sarj/prefer-zod-infer": "error";
-    readonly "@sarj/require-assert-never": "warn";
+    readonly "@sarj/require-assert-never": "error";
     readonly "@sarj/require-fetch-timeout": "error";
-    readonly "@sarj/require-interface-for-injected-service": "warn";
+    readonly "@sarj/require-interface-for-injected-service": "error";
     readonly "@sarj/require-static-next-matcher": "error";
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
-    readonly "@sarj/stepdown": "warn";
+    readonly "@sarj/stepdown": "error";
     readonly "@sarj/zod-naming-convention": "error";
 };
 type FlatPreset = {
@@ -458,7 +453,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.17.1";
+        readonly version: "11.0.0";
     };
     readonly rules: {
         readonly "duplicate-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"duplicateTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
@@ -640,9 +635,6 @@ declare const plugin: {
         readonly "prefer-server-actions": _typescript_eslint_utils_ts_eslint.RuleModule<"preferServerAction", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
-        readonly "prefer-single-sentence-comment": _typescript_eslint_utils_ts_eslint.RuleModule<"preferOneSentence", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-            name: string;
-        };
         readonly "prefer-string-literal-union": _typescript_eslint_utils_ts_eslint.RuleModule<"bareChoiceField" | "comparisonCluster", readonly [{
             ignoreFields?: readonly string[];
         }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.d.ts

@@ -267,9 +267,6 @@ declare const rules: {
     readonly "prefer-server-actions": _typescript_eslint_utils_ts_eslint.RuleModule<"preferServerAction", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
-    readonly "prefer-single-sentence-comment": _typescript_eslint_utils_ts_eslint.RuleModule<"preferOneSentence", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-        name: string;
-    };
     readonly "prefer-string-literal-union": _typescript_eslint_utils_ts_eslint.RuleModule<"bareChoiceField" | "comparisonCluster", readonly [{
         ignoreFields?: readonly string[];
     }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
@@ -319,71 +316,70 @@ declare const rules: {
 /** 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"];
 declare const recommendedRules: {
-    readonly "@sarj/duplicate-test-body": "warn";
-    readonly "@sarj/enforce-file-structure": "warn";
-    readonly "@sarj/no-async-callback-in-wait-for": "warn";
-    readonly "@sarj/no-client-side-data-fetching": "warn";
-    readonly "@sarj/no-comment-cruft": "warn";
-    readonly "@sarj/no-conditional-in-test": "warn";
-    readonly "@sarj/no-cors-wildcard-with-credentials": "warn";
-    readonly "@sarj/no-dynamic-sql": "warn";
-    readonly "@sarj/no-fat-try-blocks": "warn";
-    readonly "@sarj/no-hand-rolled-sleep": "warn";
+    readonly "@sarj/duplicate-test-body": "error";
+    readonly "@sarj/enforce-file-structure": "error";
+    readonly "@sarj/no-async-callback-in-wait-for": "error";
+    readonly "@sarj/no-client-side-data-fetching": "error";
+    readonly "@sarj/no-comment-cruft": "error";
+    readonly "@sarj/no-conditional-in-test": "error";
+    readonly "@sarj/no-cors-wildcard-with-credentials": "error";
+    readonly "@sarj/no-dynamic-sql": "error";
+    readonly "@sarj/no-fat-try-blocks": "error";
+    readonly "@sarj/no-hand-rolled-sleep": "error";
     readonly "@sarj/no-hand-rolled-spinner": "error";
-    readonly "@sarj/no-insecure-random-id": "warn";
-    readonly "@sarj/no-json-stringify-error": "warn";
-    readonly "@sarj/no-log-only-catch": "warn";
-    readonly "@sarj/no-long-comment": "warn";
-    readonly "@sarj/no-generic-single-export-module": "warn";
-    readonly "@sarj/no-offset-pagination": "warn";
-    readonly "@sarj/no-positional-tuple-return": "warn";
-    readonly "@sarj/no-repeated-string-literal": "warn";
-    readonly "@sarj/no-restated-comment": "warn";
-    readonly "@sarj/no-restated-jsdoc": "warn";
-    readonly "@sarj/no-secret-in-log": "warn";
-    readonly "@sarj/no-select-star": "warn";
-    readonly "@sarj/no-sentinel-return-on-catch": "warn";
-    readonly "@sarj/no-silent-promise-catch": "warn";
-    readonly "@sarj/no-sleep-in-test-body": "warn";
-    readonly "@sarj/no-string-concat-in-loop": "warn";
-    readonly "@sarj/no-tautological-expect": "warn";
-    readonly "@sarj/no-typed-doc-sections": "warn";
-    readonly "@sarj/no-trailing-value-narration": "warn";
-    readonly "@sarj/no-declaration-comment-wall": "warn";
-    readonly "@sarj/no-union-in-comment": "warn";
-    readonly "@sarj/no-type-member-comment-wall": "warn";
-    readonly "@sarj/no-unnecessary-use-client": "warn";
-    readonly "@sarj/no-unsafe-mock-casting": "warn";
-    readonly "@sarj/no-zod-native-enum": "warn";
-    readonly "@sarj/test-loops-over-literal-cases": "warn";
+    readonly "@sarj/no-insecure-random-id": "error";
+    readonly "@sarj/no-json-stringify-error": "error";
+    readonly "@sarj/no-log-only-catch": "error";
+    readonly "@sarj/no-long-comment": "error";
+    readonly "@sarj/no-generic-single-export-module": "error";
+    readonly "@sarj/no-offset-pagination": "error";
+    readonly "@sarj/no-positional-tuple-return": "error";
+    readonly "@sarj/no-repeated-string-literal": "error";
+    readonly "@sarj/no-restated-comment": "error";
+    readonly "@sarj/no-restated-jsdoc": "error";
+    readonly "@sarj/no-secret-in-log": "error";
+    readonly "@sarj/no-select-star": "error";
+    readonly "@sarj/no-sentinel-return-on-catch": "error";
+    readonly "@sarj/no-silent-promise-catch": "error";
+    readonly "@sarj/no-sleep-in-test-body": "error";
+    readonly "@sarj/no-string-concat-in-loop": "error";
+    readonly "@sarj/no-tautological-expect": "error";
+    readonly "@sarj/no-typed-doc-sections": "error";
+    readonly "@sarj/no-trailing-value-narration": "error";
+    readonly "@sarj/no-declaration-comment-wall": "error";
+    readonly "@sarj/no-union-in-comment": "error";
+    readonly "@sarj/no-type-member-comment-wall": "error";
+    readonly "@sarj/no-unnecessary-use-client": "error";
+    readonly "@sarj/no-unsafe-mock-casting": "error";
+    readonly "@sarj/no-zod-native-enum": "error";
+    readonly "@sarj/test-loops-over-literal-cases": "error";
     readonly "@sarj/prefer-constant-time-secret-compare": "error";
-    readonly "@sarj/prefer-discriminated-union": "warn";
+    readonly "@sarj/prefer-discriminated-union": "error";
     readonly "@sarj/prefer-input-group-search": "error";
-    readonly "@sarj/prefer-immutable-module-constant": "warn";
-    readonly "@sarj/prefer-module-level-constant": "warn";
-    readonly "@sarj/prefer-module-level-schema": "warn";
-    readonly "@sarj/prefer-non-nullable-collection": "warn";
-    readonly "@sarj/prefer-schema-for-api-payload": "warn";
-    readonly "@sarj/prefer-semantic-colors": readonly ["warn", {
+    readonly "@sarj/prefer-immutable-module-constant": "error";
+    readonly "@sarj/prefer-module-level-constant": "error";
+    readonly "@sarj/prefer-module-level-schema": "error";
+    readonly "@sarj/prefer-non-nullable-collection": "error";
+    readonly "@sarj/prefer-schema-for-api-payload": "error";
+    readonly "@sarj/prefer-semantic-colors": readonly ["error", {
         readonly requireSemanticTokens: true;
     }];
-    readonly "@sarj/prefer-server-actions": "warn";
-    readonly "@sarj/prefer-single-sentence-comment": "warn";
-    readonly "@sarj/prefer-string-literal-union": "warn";
-    readonly "@sarj/prefer-whole-object-assertion": "warn";
-    readonly "@sarj/prefer-zod-enum": "warn";
-    readonly "@sarj/prefer-zod-infer": "warn";
-    readonly "@sarj/require-assert-never": "warn";
-    readonly "@sarj/require-fetch-timeout": "warn";
-    readonly "@sarj/require-interface-for-injected-service": "warn";
+    readonly "@sarj/prefer-server-actions": "error";
+    readonly "@sarj/prefer-string-literal-union": "error";
+    readonly "@sarj/prefer-whole-object-assertion": "error";
+    readonly "@sarj/prefer-zod-enum": "error";
+    readonly "@sarj/prefer-zod-infer": "error";
+    readonly "@sarj/require-assert-never": "error";
+    readonly "@sarj/require-fetch-timeout": "error";
+    readonly "@sarj/require-interface-for-injected-service": "error";
     readonly "@sarj/require-static-next-matcher": "error";
     readonly "@sarj/require-zod-form-validation": "error";
-    readonly "@sarj/store-insert-requires-on-conflict": "warn";
-    readonly "@sarj/stepdown": "warn";
-    readonly "@sarj/zod-naming-convention": "warn";
+    readonly "@sarj/store-insert-requires-on-conflict": "error";
+    readonly "@sarj/stepdown": "error";
+    readonly "@sarj/zod-naming-convention": "error";
 };
 declare const strictRules: {
-    readonly "@sarj/duplicate-test-body": "warn";
+    readonly "@sarj/duplicate-test-body": "error";
     readonly "@sarj/enforce-file-structure": "error";
     readonly "@sarj/no-async-callback-in-wait-for": "error";
     readonly "@sarj/no-client-side-data-fetching": "error";
@@ -399,7 +395,7 @@ declare const strictRules: {
     readonly "@sarj/no-json-stringify-error": "error";
     readonly "@sarj/no-log-only-catch": "error";
     readonly "@sarj/no-long-comment": "error";
-    readonly "@sarj/no-generic-single-export-module": "warn";
+    readonly "@sarj/no-generic-single-export-module": "error";
     readonly "@sarj/no-offset-pagination": "error";
     readonly "@sarj/no-positional-tuple-return": "error";
     readonly "@sarj/no-raw-env": "error";
@@ -423,31 +419,30 @@ declare const strictRules: {
     readonly "@sarj/no-unnecessary-use-client": "error";
     readonly "@sarj/no-unsafe-mock-casting": "error";
     readonly "@sarj/no-zod-native-enum": "error";
-    readonly "@sarj/test-loops-over-literal-cases": "warn";
+    readonly "@sarj/test-loops-over-literal-cases": "error";
     readonly "@sarj/prefer-constant-time-secret-compare": "error";
-    readonly "@sarj/prefer-discriminated-union": "warn";
+    readonly "@sarj/prefer-discriminated-union": "error";
     readonly "@sarj/prefer-input-group-search": "error";
-    readonly "@sarj/prefer-immutable-module-constant": "warn";
+    readonly "@sarj/prefer-immutable-module-constant": "error";
     readonly "@sarj/prefer-module-level-constant": "error";
     readonly "@sarj/prefer-module-level-schema": "error";
-    readonly "@sarj/prefer-non-nullable-collection": "warn";
+    readonly "@sarj/prefer-non-nullable-collection": "error";
     readonly "@sarj/prefer-schema-for-api-payload": "error";
     readonly "@sarj/prefer-semantic-colors": readonly ["error", {
         readonly requireSemanticTokens: true;
     }];
     readonly "@sarj/prefer-server-actions": "error";
-    readonly "@sarj/prefer-single-sentence-comment": "warn";
     readonly "@sarj/prefer-string-literal-union": "error";
     readonly "@sarj/prefer-whole-object-assertion": "error";
     readonly "@sarj/prefer-zod-enum": "error";
     readonly "@sarj/prefer-zod-infer": "error";
-    readonly "@sarj/require-assert-never": "warn";
+    readonly "@sarj/require-assert-never": "error";
     readonly "@sarj/require-fetch-timeout": "error";
-    readonly "@sarj/require-interface-for-injected-service": "warn";
+    readonly "@sarj/require-interface-for-injected-service": "error";
     readonly "@sarj/require-static-next-matcher": "error";
     readonly "@sarj/require-zod-form-validation": "error";
     readonly "@sarj/store-insert-requires-on-conflict": "error";
-    readonly "@sarj/stepdown": "warn";
+    readonly "@sarj/stepdown": "error";
     readonly "@sarj/zod-naming-convention": "error";
 };
 type FlatPreset = {
@@ -458,7 +453,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.17.1";
+        readonly version: "11.0.0";
     };
     readonly rules: {
         readonly "duplicate-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"duplicateTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
@@ -640,9 +635,6 @@ declare const plugin: {
         readonly "prefer-server-actions": _typescript_eslint_utils_ts_eslint.RuleModule<"preferServerAction", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
-        readonly "prefer-single-sentence-comment": _typescript_eslint_utils_ts_eslint.RuleModule<"preferOneSentence", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
-            name: string;
-        };
         readonly "prefer-string-literal-union": _typescript_eslint_utils_ts_eslint.RuleModule<"bareChoiceField" | "comparisonCluster", readonly [{
             ignoreFields?: readonly string[];
         }?], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.js

@@ -886,6 +886,8 @@ var CODE_TAIL_RE = /[;{}()]\s*$|=>\s*$|,\s*$/;
 var ASSIGN_RE = /^[A-Za-z_$][\w.$[\]]*\s*(?:=(?![=>])|\+=|-=|\*=)\s*\S.*[;)}\]]\s*$/;
 var CALL_RE = /^[A-Za-z_$][\w.$]*\([^)]*\)\s*;?\s*$/;
 var ASSERTION_CODE_RE = /^(?:await\s+)?(?:expect(?:TypeOf)?|assert(?:\.\w+)?)\s*\(/;
+var HTTP_CONTRACT_RE = /\b(?:GET|HEAD|OPTIONS|PATCH|POST|PUT|DELETE)\s+(?:https?:\/\/|\/|\{[A-Za-z_$])/;
+var PROSE_ASSIGNMENT_RE = /^[A-Za-z_$][\w.$[\]]*\s*=\s*[A-Za-z][A-Za-z '-]{2,}\s+\((?:how|what|when|where|which|who|why)\b[^)]*\)[.!]?$/i;
 var PSEUDOCODE_RE = /%\w+%|\[opt\]|(?:^|\s)<[A-Za-z]\w*>|…|\.\.\./;
 function isBanner(text) {
   const t = text.trim();
@@ -904,6 +906,7 @@ function isRegionMarker(text) {
 function looksLikeCode(text, allowCall = true) {
   const t = text.trim();
   if (!t) return false;
+  if (PROSE_ASSIGNMENT_RE.test(t)) return false;
   if (CODE_KEYWORD_RE.test(t) && CODE_TAIL_RE.test(t)) return true;
   if (ASSIGN_RE.test(t)) return true;
   if (ASSERTION_CODE_RE.test(t)) return true;
@@ -1042,6 +1045,21 @@ function runCitesAReference(comments, index) {
 function areAdjacentLineComments(a, b) {
   return a !== void 0 && b !== void 0 && a.type === "Line" && b.type === "Line" && b.loc.start.line === a.loc.end.line + 1;
 }
+function lineRunStart(comments, index) {
+  let start = index;
+  while (start > 0 && areAdjacentLineComments(comments[start - 1], comments[start])) {
+    start -= 1;
+  }
+  return start;
+}
+function runDocumentsHttpContract(comments, index) {
+  const start = lineRunStart(comments, index);
+  for (let i = start; i < comments.length; i++) {
+    if (i > start && !areAdjacentLineComments(comments[i - 1], comments[i])) break;
+    if (HTTP_CONTRACT_RE.test(stripCommentMarker(comments[i]?.value ?? ""))) return true;
+  }
+  return false;
+}
 function isInsideCommentRun(comments, index) {
   const comment = comments[index];
   return areAdjacentLineComments(comments[index - 1], comment) || areAdjacentLineComments(comment, comments[index + 1]);
@@ -1077,7 +1095,7 @@ var no_comment_cruft_default = createRule({
     schema: [],
     messages: {
       commentedOutCode: "Commented-out code \u2014 delete it; git history remembers.",
-      sectionBanner: "Section-banner / region comment \u2014 structure code with functions, not ASCII rules.",
+      sectionBanner: "Section-banner / region comment \u2014 remove the decoration or replace it with a named code boundary.",
       fileHeaderPreamble: "File-header comment preamble \u2014 use a brief doc comment for the why, not a block of `//` lines.",
       commentWall: "Statement comment wall ({{count}} narrated steps) \u2014 delete the walkthrough and name the operations in code; keep only constraints or rationale.",
       redundantNarration: "Comment narrates the code \u2014 delete it or say *why*, not *what*. Code is self-documenting.",
@@ -1100,6 +1118,17 @@ var no_comment_cruft_default = createRule({
     function isJsDoc(comment) {
       return comment.type === "Block" && /^\*/.test(comment.value);
     }
+    function isJsxOnlyComment(comment) {
+      for (let node = sourceCode.getNodeByRangeIndex(
+        comment.range[0]
+      ); node != null; node = node.parent) {
+        if (node.type === AST_NODE_TYPES6.JSXExpressionContainer) {
+          return node.expression.type === AST_NODE_TYPES6.JSXEmptyExpression;
+        }
+        if (node.type === AST_NODE_TYPES6.Program) return false;
+      }
+      return false;
+    }
     function findCommentWalls(comments) {
       const attached = /* @__PURE__ */ new Map();
       for (const comment of comments) {
@@ -1181,6 +1210,8 @@ var no_comment_cruft_default = createRule({
         const enumerated = comments.filter(
           (c) => c.type === "Line" && ENUMERATION_RE.test(stripCommentMarker(c.value))
         );
+        const reportedBannerRuns = /* @__PURE__ */ new Set();
+        const reportedCodeRuns = /* @__PURE__ */ new Set();
         for (let i = 0; i < comments.length; i++) {
           const comment = comments[i];
           if (comment === void 0) continue;
@@ -1200,9 +1231,14 @@ var no_comment_cruft_default = createRule({
             }
             continue;
           }
-          if (!isStandalone(comment)) continue;
           if (LICENSE_RE.test(comment.value)) continue;
           const texts = comment.value.split("\n").map(stripCommentMarker).filter((l) => l.length > 0 && !isDirective(l));
+          if (!isStandalone(comment)) {
+            if (isJsxOnlyComment(comment) && texts.some(isBanner)) {
+              context.report({ node: comment, messageId: "sectionBanner" });
+            }
+            continue;
+          }
           const firstText = texts[0];
           if (firstText !== void 0 && /^(?:todo|fixme)\b/i.test(firstText)) {
             if (!runCitesAReference(comments, i)) {
@@ -1217,16 +1253,23 @@ var no_comment_cruft_default = createRule({
             context.report({ node: comment, messageId: "placeholderImplementation" });
             continue;
           }
+          const runStart = lineRunStart(comments, i);
           if (texts.some(isBanner)) {
-            context.report({ node: comment, messageId: "sectionBanner" });
+            if (!reportedBannerRuns.has(runStart)) {
+              context.report({ node: comment, messageId: "sectionBanner" });
+              reportedBannerRuns.add(runStart);
+            }
             continue;
           }
           const prev = comments[i - 1];
           const precedingProse = prev !== void 0 && prev.type === "Line" && prev.loc.end.line === comment.loc.start.line - 1 && isProse(stripCommentMarker(prev.value));
           const container = sourceCode.getNodeByRangeIndex(comment.range[0]);
           const inTypeMembers = container !== null && TYPE_MEMBER_CONTAINERS.has(container.type);
-          if (hasCommentedOutCode(texts, precedingProse, !inTypeMembers) && !hasIllustrationLeadInAbove(comments, i)) {
-            context.report({ node: comment, messageId: "commentedOutCode" });
+          if (hasCommentedOutCode(texts, precedingProse, !inTypeMembers) && !hasIllustrationLeadInAbove(comments, i) && !runDocumentsHttpContract(comments, i)) {
+            if (!reportedCodeRuns.has(runStart)) {
+              context.report({ node: comment, messageId: "commentedOutCode" });
+              reportedCodeRuns.add(runStart);
+            }
             continue;
           }
           if (comment.type === "Line" && texts.length === 1) {
@@ -9720,31 +9763,6 @@ var prefer_server_actions_default = createRule({
   }
 });
 
-// src/rules/prefer-single-sentence-comment.ts
-var prefer_single_sentence_comment_default = createRule({
-  name: "prefer-single-sentence-comment",
-  meta: {
-    type: "suggestion",
-    docs: { description: "Prefer one sentence and self-documenting code over a two-sentence comment." },
-    schema: [],
-    messages: {
-      preferOneSentence: "Two-sentence comment \u2014 prefer one sentence and self-documenting code."
-    }
-  },
-  defaultOptions: [],
-  create(context) {
-    return {
-      Program() {
-        for (const group of proseGroups(context.filename, context.sourceCode)) {
-          if (!group.hasTypedTags && sentenceUnits(group.text) === 2) {
-            context.report({ node: group.comment, messageId: "preferOneSentence" });
-          }
-        }
-      }
-    };
-  }
-});
-
 // src/rules/prefer-string-literal-union.ts
 import {
   ESLintUtils as ESLintUtils3,
@@ -12235,6 +12253,10 @@ var retiredRules = {
     removedIn: "3.0.0",
     reason: "Delete the retired entry; application-profile consumers can separately adopt `@sarj/prefer-shadcn-primitives`."
   },
+  "prefer-single-sentence-comment": {
+    removedIn: "10.0.0",
+    reason: "Delete the config entry and suppressions; use the narrower no-comment-cruft, no-restated-comment, and no-long-comment rules."
+  },
   "primary-export-file-name": {
     removedIn: "4.0.0",
     reason: "Delete the config entry and suppressions; there is no replacement."
@@ -12309,7 +12331,6 @@ var rules = {
   "prefer-schema-for-api-payload": prefer_schema_for_api_payload_default,
   "prefer-semantic-colors": prefer_semantic_colors_default,
   "prefer-server-actions": prefer_server_actions_default,
-  "prefer-single-sentence-comment": prefer_single_sentence_comment_default,
   "prefer-string-literal-union": prefer_string_literal_union_default,
   "prefer-whole-object-assertion": prefer_whole_object_assertion_default,
   "prefer-zod-enum": prefer_zod_enum_default,
@@ -12325,7 +12346,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.17.1"
+  version: "11.0.0"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",
@@ -12333,69 +12354,68 @@ var applicationOnlyRules = [
   "prefer-shadcn-primitives"
 ];
 var recommendedRules = {
-  "@sarj/duplicate-test-body": "warn",
-  "@sarj/enforce-file-structure": "warn",
-  "@sarj/no-async-callback-in-wait-for": "warn",
-  "@sarj/no-client-side-data-fetching": "warn",
-  "@sarj/no-comment-cruft": "warn",
-  "@sarj/no-conditional-in-test": "warn",
-  "@sarj/no-cors-wildcard-with-credentials": "warn",
-  "@sarj/no-dynamic-sql": "warn",
-  "@sarj/no-fat-try-blocks": "warn",
-  "@sarj/no-hand-rolled-sleep": "warn",
+  "@sarj/duplicate-test-body": "error",
+  "@sarj/enforce-file-structure": "error",
+  "@sarj/no-async-callback-in-wait-for": "error",
+  "@sarj/no-client-side-data-fetching": "error",
+  "@sarj/no-comment-cruft": "error",
+  "@sarj/no-conditional-in-test": "error",
+  "@sarj/no-cors-wildcard-with-credentials": "error",
+  "@sarj/no-dynamic-sql": "error",
+  "@sarj/no-fat-try-blocks": "error",
+  "@sarj/no-hand-rolled-sleep": "error",
   "@sarj/no-hand-rolled-spinner": "error",
-  "@sarj/no-insecure-random-id": "warn",
-  "@sarj/no-json-stringify-error": "warn",
-  "@sarj/no-log-only-catch": "warn",
-  "@sarj/no-long-comment": "warn",
-  "@sarj/no-generic-single-export-module": "warn",
-  "@sarj/no-offset-pagination": "warn",
-  "@sarj/no-positional-tuple-return": "warn",
-  "@sarj/no-repeated-string-literal": "warn",
-  "@sarj/no-restated-comment": "warn",
-  "@sarj/no-restated-jsdoc": "warn",
-  "@sarj/no-secret-in-log": "warn",
-  "@sarj/no-select-star": "warn",
-  "@sarj/no-sentinel-return-on-catch": "warn",
-  "@sarj/no-silent-promise-catch": "warn",
-  "@sarj/no-sleep-in-test-body": "warn",
-  "@sarj/no-string-concat-in-loop": "warn",
-  "@sarj/no-tautological-expect": "warn",
-  "@sarj/no-typed-doc-sections": "warn",
-  "@sarj/no-trailing-value-narration": "warn",
-  "@sarj/no-declaration-comment-wall": "warn",
-  "@sarj/no-union-in-comment": "warn",
-  "@sarj/no-type-member-comment-wall": "warn",
-  "@sarj/no-unnecessary-use-client": "warn",
-  "@sarj/no-unsafe-mock-casting": "warn",
-  "@sarj/no-zod-native-enum": "warn",
-  "@sarj/test-loops-over-literal-cases": "warn",
+  "@sarj/no-insecure-random-id": "error",
+  "@sarj/no-json-stringify-error": "error",
+  "@sarj/no-log-only-catch": "error",
+  "@sarj/no-long-comment": "error",
+  "@sarj/no-generic-single-export-module": "error",
+  "@sarj/no-offset-pagination": "error",
+  "@sarj/no-positional-tuple-return": "error",
+  "@sarj/no-repeated-string-literal": "error",
+  "@sarj/no-restated-comment": "error",
+  "@sarj/no-restated-jsdoc": "error",
+  "@sarj/no-secret-in-log": "error",
+  "@sarj/no-select-star": "error",
+  "@sarj/no-sentinel-return-on-catch": "error",
+  "@sarj/no-silent-promise-catch": "error",
+  "@sarj/no-sleep-in-test-body": "error",
+  "@sarj/no-string-concat-in-loop": "error",
+  "@sarj/no-tautological-expect": "error",
+  "@sarj/no-typed-doc-sections": "error",
+  "@sarj/no-trailing-value-narration": "error",
+  "@sarj/no-declaration-comment-wall": "error",
+  "@sarj/no-union-in-comment": "error",
+  "@sarj/no-type-member-comment-wall": "error",
+  "@sarj/no-unnecessary-use-client": "error",
+  "@sarj/no-unsafe-mock-casting": "error",
+  "@sarj/no-zod-native-enum": "error",
+  "@sarj/test-loops-over-literal-cases": "error",
   "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-discriminated-union": "warn",
+  "@sarj/prefer-discriminated-union": "error",
   "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-immutable-module-constant": "warn",
-  "@sarj/prefer-module-level-constant": "warn",
-  "@sarj/prefer-module-level-schema": "warn",
-  "@sarj/prefer-non-nullable-collection": "warn",
-  "@sarj/prefer-schema-for-api-payload": "warn",
-  "@sarj/prefer-semantic-colors": ["warn", { requireSemanticTokens: true }],
-  "@sarj/prefer-server-actions": "warn",
-  "@sarj/prefer-single-sentence-comment": "warn",
-  "@sarj/prefer-string-literal-union": "warn",
-  "@sarj/prefer-whole-object-assertion": "warn",
-  "@sarj/prefer-zod-enum": "warn",
-  "@sarj/prefer-zod-infer": "warn",
-  "@sarj/require-assert-never": "warn",
-  "@sarj/require-fetch-timeout": "warn",
-  "@sarj/require-interface-for-injected-service": "warn",
+  "@sarj/prefer-immutable-module-constant": "error",
+  "@sarj/prefer-module-level-constant": "error",
+  "@sarj/prefer-module-level-schema": "error",
+  "@sarj/prefer-non-nullable-collection": "error",
+  "@sarj/prefer-schema-for-api-payload": "error",
+  "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
+  "@sarj/prefer-server-actions": "error",
+  "@sarj/prefer-string-literal-union": "error",
+  "@sarj/prefer-whole-object-assertion": "error",
+  "@sarj/prefer-zod-enum": "error",
+  "@sarj/prefer-zod-infer": "error",
+  "@sarj/require-assert-never": "error",
+  "@sarj/require-fetch-timeout": "error",
+  "@sarj/require-interface-for-injected-service": "error",
   "@sarj/require-static-next-matcher": "error",
   "@sarj/require-zod-form-validation": "error",
-  "@sarj/store-insert-requires-on-conflict": "warn",
-  "@sarj/stepdown": "warn",
-  "@sarj/zod-naming-convention": "warn"
+  "@sarj/store-insert-requires-on-conflict": "error",
+  "@sarj/stepdown": "error",
+  "@sarj/zod-naming-convention": "error"
 };
 var strictRules = {
-  "@sarj/duplicate-test-body": "warn",
+  "@sarj/duplicate-test-body": "error",
   "@sarj/enforce-file-structure": "error",
   "@sarj/no-async-callback-in-wait-for": "error",
   "@sarj/no-client-side-data-fetching": "error",
@@ -12411,7 +12431,7 @@ var strictRules = {
   "@sarj/no-json-stringify-error": "error",
   "@sarj/no-log-only-catch": "error",
   "@sarj/no-long-comment": "error",
-  "@sarj/no-generic-single-export-module": "warn",
+  "@sarj/no-generic-single-export-module": "error",
   "@sarj/no-offset-pagination": "error",
   "@sarj/no-positional-tuple-return": "error",
   "@sarj/no-raw-env": "error",
@@ -12435,29 +12455,28 @@ var strictRules = {
   "@sarj/no-unnecessary-use-client": "error",
   "@sarj/no-unsafe-mock-casting": "error",
   "@sarj/no-zod-native-enum": "error",
-  "@sarj/test-loops-over-literal-cases": "warn",
+  "@sarj/test-loops-over-literal-cases": "error",
   "@sarj/prefer-constant-time-secret-compare": "error",
-  "@sarj/prefer-discriminated-union": "warn",
+  "@sarj/prefer-discriminated-union": "error",
   "@sarj/prefer-input-group-search": "error",
-  "@sarj/prefer-immutable-module-constant": "warn",
+  "@sarj/prefer-immutable-module-constant": "error",
   "@sarj/prefer-module-level-constant": "error",
   "@sarj/prefer-module-level-schema": "error",
-  "@sarj/prefer-non-nullable-collection": "warn",
+  "@sarj/prefer-non-nullable-collection": "error",
   "@sarj/prefer-schema-for-api-payload": "error",
   "@sarj/prefer-semantic-colors": ["error", { requireSemanticTokens: true }],
   "@sarj/prefer-server-actions": "error",
-  "@sarj/prefer-single-sentence-comment": "warn",
   "@sarj/prefer-string-literal-union": "error",
   "@sarj/prefer-whole-object-assertion": "error",
   "@sarj/prefer-zod-enum": "error",
   "@sarj/prefer-zod-infer": "error",
-  "@sarj/require-assert-never": "warn",
+  "@sarj/require-assert-never": "error",
   "@sarj/require-fetch-timeout": "error",
-  "@sarj/require-interface-for-injected-service": "warn",
+  "@sarj/require-interface-for-injected-service": "error",
   "@sarj/require-static-next-matcher": "error",
   "@sarj/require-zod-form-validation": "error",
   "@sarj/store-insert-requires-on-conflict": "error",
-  "@sarj/stepdown": "warn",
+  "@sarj/stepdown": "error",
   "@sarj/zod-naming-convention": "error"
 };
 var plugin = {

package/package.json

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