@yasainet/eslint 0.0.74 → 0.0.76

package/README.md

@@ -9,113 +9,13 @@ Shared ESLint configuration for Next.js, Node.js and Deno.
 - `@yasainet/eslint/node` — Common rules for CLI scripts
   - Feature Root: `scripts/features/`
   - Entry Points: `scripts/commands/*.ts`
-- `@yasainet/eslint/deno` — Common rules for Edge Functions
-  - Feature Root: `supabase/functions/features/`
-
-## Architecture
-
-`feature-based architecture` を ESLint で機械的に enforce する設定集。詳細な命名規約・directory 構造・各 layer の責務は [CLAUDE.md](./CLAUDE.md) を参照。consuming project の Claude Code は CLAUDE.md を読んで自動的に規約に従う。
+- `@yasainet/eslint/deno` — Common rules for Supabase Edge Functions
+  - Feature Root: `supabase/functions/_features/`
 
 ## Setup
 
-### Next.js + Node.js + Deno
-
-```sh
-npm install -D @yasainet/eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig as nextEslintConfig } from "@yasainet/eslint/next";
-import { eslintConfig as nodeEslintConfig } from "@yasainet/eslint/node";
-import { eslintConfig as denoEslintConfig } from "@yasainet/eslint/deno";
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-export default defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    ".vercel/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-  ...nextEslintConfig,
-  ...nodeEslintConfig,
-  ...denoEslintConfig,
-]);
-```
-
-### Next.js
-
-```sh
-npm install -D @yasainet/eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/next";
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-export default defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    ".vercel/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-  ...eslintConfig,
-]);
-```
-
-### Node.js
-
-```sh
-npm install -D @yasainet/eslint eslint typescript-eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/node";
-
-export default [...eslintConfig];
-```
-
-### Deno
-
-```sh
-npm install -D @yasainet/eslint eslint typescript-eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/deno";
-
-export default [...eslintConfig];
-```
+利用 entry 別の install / config template は [`docs/setup.md`](./docs/setup.md) を参照。
 
 ## Release
 
-Version は Git tag から派生する。CI が自動で `package.json` の version を設定して publish する。
-
-1. `main` にコミット & push
-2. tag を作成 & push:
-
-   ```sh
-   git tag v1.0.0
-   git push --tags
-   ```
-
-3. GitHub Actions が npm に publish する
+Git tag (`vX.Y.Z`) を push すると GitHub Actions が npm に publish する。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasainet/eslint",
-  "version": "0.0.74",
+  "version": "0.0.76",
   "description": "ESLint",
   "type": "module",
   "exports": {
@@ -17,6 +17,9 @@
       "default": "./src/deno/index.mjs"
     }
   },
+  "bin": {
+    "test-audit": "./src/cli/test-audit.mjs"
+  },
   "files": [
     "src"
   ],
@@ -32,6 +35,10 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "docs": "node scripts/generate-rules-catalog.mjs",
+    "check": "node scripts/check-layer-selectors.mjs"
+  },
   "dependencies": {
     "@stylistic/eslint-plugin": "^5.9.0",
     "eslint-plugin-better-tailwindcss": "^4.1.1",
@@ -42,5 +49,9 @@
   "peerDependencies": {
     "eslint": "^9",
     "typescript-eslint": "^8"
+  },
+  "devDependencies": {
+    "eslint": "^9",
+    "typescript-eslint": "^8"
   }
 }

package/src/cli/test-audit.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+
+// pure layer (schemas / utils) の unit test presence を機械チェックする:
+//
+// - 各 source に 兄弟 *.test.ts が存在するか、`@unit-exempt:` marker を持つことを要求
+// - schemas は定義上 pure。utils は impure 混在のため marker で opt-out できる
+// - ESLint の per-file モデルと噛み合わない「存在強制」を全ツリー一括監査で担う
+
+const REQUIRE_DIRS = new Set(["schemas", "utils"]);
+const EXEMPT_RE = /@unit-exempt:/;
+
+function getFlag(argv, name) {
+  const i = argv.indexOf(name);
+  return i !== -1 && argv[i + 1] ? argv[i + 1] : null;
+}
+
+function* walk(dir) {
+  if (!fs.existsSync(dir)) {
+    return;
+  }
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      yield* walk(full);
+    } else if (entry.isFile()) {
+      yield full;
+    }
+  }
+}
+
+function isTarget(file) {
+  if (!file.endsWith(".ts")) {
+    return false;
+  }
+  if (file.endsWith(".test.ts") || file.endsWith(".d.ts")) {
+    return false;
+  }
+  return REQUIRE_DIRS.has(path.basename(path.dirname(file)));
+}
+
+function isSatisfied(file) {
+  const testFile = file.replace(/\.ts$/, ".test.ts");
+  if (fs.existsSync(testFile)) {
+    return true;
+  }
+  return EXEMPT_RE.test(fs.readFileSync(file, "utf8"));
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(
+      "test-audit — pure layer (schemas/utils) の unit test presence を検査\n\n" +
+        "Usage: test-audit [--feature-root <path>]\n\n" +
+        "  --feature-root <path>  feature root (default: src/features)\n\n" +
+        "各 schemas/*.ts と utils/*.ts に 兄弟 *.test.ts または\n" +
+        "`// @unit-exempt: <理由>` marker を要求する。",
+    );
+    process.exit(0);
+  }
+
+  const projectRoot = process.cwd();
+  const featureRoot = getFlag(argv, "--feature-root") ?? "src/features";
+  const roots = [path.join(projectRoot, featureRoot)];
+
+  const violations = [];
+  for (const root of roots) {
+    for (const file of walk(root)) {
+      if (isTarget(file) && !isSatisfied(file)) {
+        violations.push(path.relative(projectRoot, file));
+      }
+    }
+  }
+
+  if (violations.length > 0) {
+    console.error(
+      `✗ test-audit: ${violations.length} 件の pure layer に unit test も @unit-exempt marker もありません:\n`,
+    );
+    for (const v of violations.sort()) {
+      console.error(`  ${v}`);
+    }
+    console.error(
+      "\n対応: 兄弟 *.test.ts を追加するか、impure な場合は\n" +
+        "`// @unit-exempt: <理由>` を記載する。",
+    );
+    process.exit(1);
+  }
+
+  console.log(
+    "✓ test-audit: schemas / utils はすべて unit test または @unit-exempt が揃っています。",
+  );
+}
+
+main();

package/src/common/CLAUDE.md

@@ -0,0 +1,19 @@
+# src/common/CLAUDE.md
+
+全 entry で共有する rule の置き場所判断 (target 基準):
+
+- `_internal/` — private 実装詳細 (constants / plugins / selectors / import-patterns)。consumer から見えない
+- `base/` — 全ファイル対象の generic rule (TypeScript syntactic / type-aware)
+- `boundaries/<surface>.mjs` — 外界 → features の入口で enforce する契約
+- `cross-cutting/` — 複数 layer に跨る規約
+  - 例 (naming): feature-name / namespace-import / form-state
+  - 例 (rule): logger / jsdoc / no-any-return / supabase-columns-satisfies
+- `layers/<layer>.mjs` — features 内部の階層単位
+  - 種類: queries / services / entries / utils / constants / schemas / types
+  - 1 layer の全制約 (naming + syntax + imports + local rules) を 1 file に集約
+- `layers/top-level/<layer>.mjs` — features と同階層 (top-level) のディレクトリ単位
+  - 種類: lib / utils
+- `local-plugins/` — ESLint local plugin の実装本体
+- `index.mjs` — common entry。上記 file を合成して export
+
+新規 rule の glob が単一 layer に閉じるなら `layers/`、跨ぐなら `cross-cutting/`、外界の caller surface なら `boundaries/` に置く。

package/src/common/_internal/constants.mjs

@@ -20,7 +20,7 @@ function findProjectRoot() {
 
 const PROJECT_ROOT = findProjectRoot();
 
-const EXCLUDE_LIST = ["types.ts", "type.ts", "proxy.ts"];
+const EXCLUDE_LIST = ["type.ts", "proxy.ts"];
 
 export function generatePrefixLibMapping(featureRoot) {
   const libRoot = featureRoot.replace(/features$/, "lib");

package/src/common/_internal/import-patterns.mjs

@@ -2,7 +2,7 @@ export const LIB_BOUNDARY_PATTERNS = [
   {
     group: ["@/lib/*", "@/lib/**"],
     message:
-      "lib/* can only be imported from queries (lib-boundary violation)",
+      "lib/* は queries からのみ import 可。他層は queries 経由で使う。",
   },
 ];
 
@@ -11,6 +11,6 @@ export const MAPPING_PATTERNS = [
     group: ["@/utils/mapping.util"],
     importNames: ["mapSnakeToCamel", "mapCamelToSnake"],
     message:
-      "Mapping functions are only allowed in services. Snake/camel conversion belongs at the service boundary.",
+      "mapping 関数は services のみ許可。snake/camel 変換は service 境界で行う。",
   },
 ];

package/src/common/_internal/selectors.mjs

@@ -1,10 +1,12 @@
 export const loggerSelector = "CallExpression[callee.object.name='logger']";
 
 export const loggerMessage =
-  "logger is not allowed outside entries. Logging belongs in entries.";
+  "logger は entries 以外で禁止。ログ出力は entries に集約する。";
 
 export const aliasDynamicImportSelector =
   "ImportExpression[source.type='Literal'][source.value=/^@\\//]";
 
 export const aliasDynamicImportMessage =
-  "Dynamic imports of `@/` aliased paths are not allowed in features layers. They bypass prefix-lib and lateral cardinality (e.g. `await import('@/lib/supabase/admin')` from queries/server.ts escapes the lib-boundary check). Create the correct queries/<prefix>.ts or services/<prefix>.ts file instead. External npm packages can still be lazy-loaded for cold-start optimization.";
+  "features layers で `@/` パスの動的 import は禁止 (prefix-lib / lateral 制約を迂回する):\n" +
+  "- 内部依存は queries/<prefix>.ts か services/<prefix>.ts を作る\n" +
+  "- 外部 npm は cold-start 最適化の遅延 import なら可";

package/src/common/base/typescript.mjs

@@ -8,7 +8,10 @@ import { simpleImportSortPlugin, stylistic } from "../_internal/plugins.mjs";
 const findProjectRoot = (start) => {
   let dir = start;
   while (dir !== dirname(dir)) {
-    if (!dir.split(sep).includes("node_modules") && existsSync(join(dir, "tsconfig.json"))) {
+    if (
+      !dir.split(sep).includes("node_modules") &&
+      existsSync(join(dir, "tsconfig.json"))
+    ) {
       return dir;
     }
     dir = dirname(dir);
@@ -26,6 +29,7 @@ const sharedRulesConfig = {
   },
   rules: {
     "no-console": "warn",
+
     "no-irregular-whitespace": [
       "warn",
       {
@@ -35,19 +39,21 @@ const sharedRulesConfig = {
         skipTemplates: false,
       },
     ],
-    "simple-import-sort/imports": "warn",
-    "simple-import-sort/exports": "warn",
-    "@stylistic/quotes": ["warn", "double", { avoidEscape: true }],
     "no-unreachable": "error",
-    "no-unreachable-loop": "error",
-    "no-useless-return": "error",
     "no-constant-condition": "error",
     "no-constant-binary-expression": "error",
     "no-dupe-else-if": "error",
     "no-self-assign": "error",
-    "no-self-compare": "error",
     "no-useless-catch": "error",
     "no-fallthrough": "error",
+
+    "no-unreachable-loop": "error",
+    "no-useless-return": "error",
+    "no-self-compare": "error",
+
+    "simple-import-sort/imports": "warn",
+    "simple-import-sort/exports": "warn",
+    "@stylistic/quotes": ["warn", "double", { avoidEscape: true }],
   },
 };
 

package/src/common/boundaries/entry-point.mjs

@@ -10,7 +10,7 @@ export function createEntryPointConfigs(entryPointFiles, entryPointIgnores = [])
           {
             selector: "ImportDeclaration:has(ImportNamespaceSpecifier)",
             message:
-              "Entry points must use named imports instead of `import * as`. This makes dependencies explicit.",
+              "entry point は `import * as` 禁止。named import で依存を明示する。",
           },
         ],
       },

package/src/common/cross-cutting/ban-alias.mjs

@@ -11,7 +11,7 @@ export function createBanAliasConfigs({ featureRoot }) {
               {
                 group: ["@/*", "@/**"],
                 message:
-                  "Alias imports (@/) are not available in this environment. Use relative paths.",
+                  "この環境では alias import (@/) は使えない。相対パスを使う。",
               },
             ],
           },

package/src/common/cross-cutting/features-ts-only.mjs

@@ -11,7 +11,7 @@ export function createFeaturesTsOnlyConfigs({ featureRoot }) {
           {
             selector: "Program",
             message:
-              "features/ must only contain .ts files. Components belong in src/components/.",
+              "features/ は .ts のみ。component は src/components/ に置く。",
           },
         ],
       },

package/src/common/cross-cutting/no-colocated-test.mjs

@@ -0,0 +1,18 @@
+import { localPlugin } from "../local-plugins/index.mjs";
+
+export function createNoColocatedTestConfigs({ featureRoot }) {
+  return [
+    {
+      name: "test/no-colocated-test",
+      files: [
+        `${featureRoot}/**/services/**/*.test.{ts,tsx}`,
+        `${featureRoot}/**/queries/**/*.test.{ts,tsx}`,
+        `${featureRoot}/**/entries/**/*.test.{ts,tsx}`,
+      ],
+      plugins: { local: localPlugin },
+      rules: {
+        "local/no-colocated-test": "error",
+      },
+    },
+  ];
+}

package/src/common/index.mjs

@@ -9,14 +9,15 @@ import { createJsdocConfigs } from "./cross-cutting/jsdoc.mjs";
 import { createLoggerConfigs } from "./cross-cutting/logger.mjs";
 import { createNamespaceImportConfigs } from "./cross-cutting/namespace-import.mjs";
 import { createNoAnyReturnConfigs } from "./cross-cutting/no-any-return.mjs";
+import { createNoColocatedTestConfigs } from "./cross-cutting/no-colocated-test.mjs";
 import { createSupabaseColumnsSatisfiesConfigs } from "./cross-cutting/supabase-columns-satisfies.mjs";
 import { createConstantsConfigs } from "./layers/constants.mjs";
 import { createEntriesConfigs } from "./layers/entries.mjs";
-import { createLibLayerConfigs } from "./layers/lib.mjs";
+import { createTopLevelLibConfigs } from "./layers/top-level/lib.mjs";
 import { createQueriesConfigs } from "./layers/queries.mjs";
 import { createSchemasConfigs } from "./layers/schemas.mjs";
 import { createServicesConfigs } from "./layers/services.mjs";
-import { createTopLevelUtilsConfigs } from "./layers/top-level-utils.mjs";
+import { createTopLevelUtilsConfigs } from "./layers/top-level/utils.mjs";
 import { createTypesConfigs } from "./layers/types.mjs";
 import { createUtilsConfigs } from "./layers/utils.mjs";
 
@@ -30,11 +31,14 @@ export function createCommonConfigs(
     ...createTypescriptConfigs({ typeAware, ...(rulesFiles && { files: rulesFiles }) }),
     ...createFeatureNameConfigs(ctx),
     ...createNamespaceImportConfigs(ctx),
+    // logger は features/**\/*.ts 全体に no-restricted-syntax を設定するため、
+    // 同 rule を持つ services/queries より前に置く (flat config は後勝ちで完全置換)。
+    ...createLoggerConfigs(ctx),
     ...createServicesConfigs(ctx),
     ...createQueriesConfigs(ctx),
     ...createFormStateConfigs(ctx),
     ...createSupabaseColumnsSatisfiesConfigs(ctx),
-    ...createLibLayerConfigs(ctx),
+    ...createTopLevelLibConfigs(ctx),
     ...createTopLevelUtilsConfigs(ctx),
     ...createTypesConfigs(ctx),
     ...createSchemasConfigs(ctx),
@@ -42,7 +46,7 @@ export function createCommonConfigs(
     ...createConstantsConfigs(ctx),
     ...createEntriesConfigs(ctx),
     ...createFeaturesTsOnlyConfigs(ctx),
-    ...createLoggerConfigs(ctx),
+    ...createNoColocatedTestConfigs(ctx),
     ...createNoAnyReturnConfigs(ctx),
     ...createFeatureDefaultImportsConfigs(ctx),
     ...createJsdocConfigs(ctx),

package/src/common/layers/entries.mjs

@@ -13,19 +13,19 @@ import { localPlugin } from "../local-plugins/index.mjs";
 const LAYER_PATTERNS = [
   {
     group: ["**/queries/*", "**/queries"],
-    message: "entries cannot import queries (layer violation)",
+    message:
+      "entries は queries を import 不可。queries は service 経由で使う。",
   },
   {
     group: ["**/hooks/*", "**/hooks"],
-    message: "entries cannot import hooks (layer violation)",
+    message: "entries は hooks を import 不可。依存は単方向に保つ。",
   },
 ];
 
 const LATERAL_PATTERNS = [
   {
     group: ["@/features/*/entries/*", "@/features/*/entries"],
-    message:
-      "entries cannot import other feature's entries (lateral violation)",
+    message: "他 feature の entries は import 不可。feature を跨ぐ依存は禁止。",
   },
   {
     group: [
@@ -35,7 +35,9 @@ const LATERAL_PATTERNS = [
       "!@/features/shared/services",
     ],
     message:
-      "entries cannot import other feature's services. Use the same feature's service (1:1) or move orchestration into the service layer. `shared/services/*` is exempt for cross-cutting side effects (notifications etc.).",
+      "他 feature の services は import 不可:\n" +
+      "- 同一 feature の service を 1:1 で使うか、orchestration を service 層へ移す\n" +
+      "- `shared/services/*` は横断的な副作用 (通知等) のため例外",
   },
 ];
 
@@ -44,21 +46,21 @@ const CARDINALITY_PATTERNS = {
     {
       group: ["**/services/client", "**/services/admin"],
       message:
-        "server entry can only import server service (cardinality violation)",
+        "server entry は server service のみ import 可。context を跨ぐ呼び出しは禁止。",
     },
   ],
   client: [
     {
       group: ["**/services/server", "**/services/admin"],
       message:
-        "client entry can only import client service (cardinality violation)",
+        "client entry は client service のみ import 可。context を跨ぐ呼び出しは禁止。",
     },
   ],
   admin: [
     {
       group: ["**/services/server", "**/services/client"],
       message:
-        "admin entry can only import admin service (cardinality violation)",
+        "admin entry は admin service のみ import 可。context を跨ぐ呼び出しは禁止。",
     },
   ],
 };
@@ -75,7 +77,10 @@ export function createEntriesConfigs({ featureRoot, prefixLibMapping }) {
     {
       name: "naming/entries",
       files: featuresGlob(featureRoot, "**/entries/*.ts"),
-      ignores: featuresGlob(featureRoot, "shared/entries/*.ts"),
+      ignores: [
+        ...featuresGlob(featureRoot, "shared/entries/*.ts"),
+        "**/*.test.ts",
+      ],
       plugins: { "check-file": checkFile },
       rules: {
         "check-file/filename-naming-convention": [
@@ -87,6 +92,7 @@ export function createEntriesConfigs({ featureRoot, prefixLibMapping }) {
     {
       name: "naming/entries-shared",
       files: featuresGlob(featureRoot, "shared/entries/*.ts"),
+      ignores: ["**/*.test.ts"],
       plugins: { "check-file": checkFile },
       rules: {
         "check-file/filename-naming-convention": [

package/src/common/layers/queries.mjs

@@ -12,15 +12,15 @@ import { localPlugin } from "../local-plugins/index.mjs";
 const LAYER_PATTERNS = [
   {
     group: ["**/services/*", "**/services"],
-    message: "queries cannot import services (layer violation)",
+    message: "queries は services を import 不可。ロジックは services へ。",
   },
   {
     group: ["**/entries/*", "**/entries"],
-    message: "queries cannot import entries (layer violation)",
+    message: "queries は entries を import 不可。依存は単方向に保つ。",
   },
   {
     group: ["**/hooks/*", "**/hooks"],
-    message: "queries cannot import hooks (layer violation)",
+    message: "queries は hooks を import 不可。依存は単方向に保つ。",
   },
 ];
 
@@ -28,7 +28,7 @@ const LATERAL_PATTERNS = [
   {
     group: ["@/features/*/queries/*", "@/features/*/queries"],
     message:
-      "queries cannot import other feature's queries (lateral violation)",
+      "他 feature の queries は import 不可。feature を跨ぐ依存は禁止。",
   },
 ];
 
@@ -39,7 +39,7 @@ function prefixLibPatterns(prefix, mapping) {
     .filter((p) => p !== prefix)
     .map((p) => ({
       group: [`**/lib/${mapping[p]}`, `**/lib/${mapping[p]}/*`],
-      message: `queries/${prefix}.ts can only import from lib/${allowedLib}. Use the correct query file for this lib.`,
+      message: `queries/${prefix}.ts は lib/${allowedLib} のみ import 可。lib ごとに対応する query file を使う。`,
     }));
 }
 
@@ -55,7 +55,10 @@ export function createQueriesConfigs({ featureRoot, prefixLibMapping }) {
     {
       name: "naming/queries",
       files: featuresGlob(featureRoot, "**/queries/*.ts"),
-      ignores: featuresGlob(featureRoot, "shared/queries/*.ts"),
+      ignores: [
+        ...featuresGlob(featureRoot, "shared/queries/*.ts"),
+        "**/*.test.ts",
+      ],
       plugins: { "check-file": checkFile },
       rules: {
         "check-file/filename-naming-convention": [
@@ -67,6 +70,7 @@ export function createQueriesConfigs({ featureRoot, prefixLibMapping }) {
     {
       name: "naming/queries-shared",
       files: featuresGlob(featureRoot, "shared/queries/*.ts"),
+      ignores: ["**/*.test.ts"],
       plugins: { "check-file": checkFile },
       rules: {
         "check-file/filename-naming-convention": [
@@ -100,42 +104,42 @@ export function createQueriesConfigs({ featureRoot, prefixLibMapping }) {
           {
             selector: "TryStatement",
             message:
-              "try-catch is not allowed in queries. Error handling belongs in entries.",
+              "queries では try-catch 禁止。エラーは `{ data, error }` で返す。",
           },
           {
             selector: "IfStatement",
             message:
-              "if statements are not allowed in queries. Conditional logic belongs in services.",
+              "queries で if 文は禁止。条件分岐は services に置く。",
           },
           {
             selector: "ForStatement",
             message:
-              "Loops are not allowed in queries. Queries should be thin CRUD wrappers — iteration belongs in services.",
+              "queries でループは禁止。queries は薄い CRUD ラッパー、反復は services に置く。",
           },
           {
             selector: "ForOfStatement",
             message:
-              "Loops are not allowed in queries. Queries should be thin CRUD wrappers — iteration belongs in services.",
+              "queries でループは禁止。queries は薄い CRUD ラッパー、反復は services に置く。",
           },
           {
             selector: "ForInStatement",
             message:
-              "Loops are not allowed in queries. Queries should be thin CRUD wrappers — iteration belongs in services.",
+              "queries でループは禁止。queries は薄い CRUD ラッパー、反復は services に置く。",
           },
           {
             selector: "WhileStatement",
             message:
-              "Loops are not allowed in queries. Queries should be thin CRUD wrappers — iteration belongs in services.",
+              "queries でループは禁止。queries は薄い CRUD ラッパー、反復は services に置く。",
           },
           {
             selector: "DoWhileStatement",
             message:
-              "Loops are not allowed in queries. Queries should be thin CRUD wrappers — iteration belongs in services.",
+              "queries でループは禁止。queries は薄い CRUD ラッパー、反復は services に置く。",
           },
           {
             selector: "ThrowStatement",
             message:
-              "throw is not allowed in queries. Queries must return Supabase's { data, error } shape as-is. Error handling belongs in entries.",
+              "queries で throw は禁止。Supabase の `{ data, error }` をそのまま返す。",
           },
           { selector: loggerSelector, message: loggerMessage },
           {