@yuu1111/quality-check 0.11.0 → 1.0.0

package/README.ja.md

@@ -42,15 +42,11 @@ export default defineConfig({
 	},
 	config: {
 		"comment-check": {
-			enable: ["japanese-period"],
 			ignore: ["another-project"],
+			rules: { "japanese-period": "on" },
 		},
-		"document-style-check": {
-			enable: ["japanese-period"],
-		},
-		"tsdoc-check": {
-			error: ["missing-doc"],
-		},
+		"document-style-check": { enable: true },
+		"tsdoc-check": { error: true },
 	},
 });
 ```
@@ -91,9 +87,9 @@ engineは `biome` → `typecheck` → `knip` → `code-style-check` → `comment
 | `typecheck` | `tsc --noEmit` | `args`、`projects` 設定は `tsconfig.json` が持つ |
 | `knip` | `knip` | `args` 設定は `knip.ts` が持つ |
 | `code-style-check` | `code-style-check --json` | `ignore`、`targets`、`args` |
-| `comment-check` | `comment-check --json` | `ignore`、`targets`、`args`、`enable`（有効にするrule名） |
-| `document-style-check` | `document-style-check lint --json` | `ignore`、`targets`、`args`、`enable`（有効にするrule名） |
-| `tsdoc-check` | `tsdoc-check --json` | `ignore`、`targets`、`args`、`enable`（有効にするrule名）、`error`（違反として扱うrule名） |
+| `comment-check` | `comment-check --json` | `ignore`、`targets`、`args`、`enable`、`rules` |
+| `document-style-check` | `document-style-check lint --json` | `ignore`、`targets`、`args`、`enable`、`rules` |
+| `tsdoc-check` | `tsdoc-check --json` | `ignore`、`targets`、`args`、`enable`、`error`、`rules` |
 
 `args` はengineの既定引数の後ろへ足す
 設定fileで表せない起動条件や、engineの引数が変わったときの逃げ道として使う
@@ -105,8 +101,13 @@ engineが受け取らない条件は渡さず、その旨をそのengineのsecti
 biome: ignore skipped (biome.json holds its settings)
 ```
 
-`enable` は `comment-check` と `document-style-check` と `tsdoc-check` の `--enable <rule>` になり、他のengineでは拒否される
-値は導入済みengineが `rule-ids` で公開するrule名で型付けするため、engineが知らない名前は起動時の失敗ではなく型errorになる
+`enable` と `error` はruleをまとめて選び、`rules` はruleを1つずつ選ぶ
+`enable: true` はengineが既定で無効にしているruleを全て有効にする
+`error: true` は `tsdoc-check` の全ruleを違反として扱い、opt-inのruleは先に有効にする 違反へ上げられるのはこのengineだけ
+`rules` はrule名をkeyにして `off`、`on`、`error` のいずれかを渡す `on` はengineの既定のまま、`error` はそのruleだけpresetと同じ扱いにする
+keyがrule名そのものなので導入済みengineのunionで型付けし、engineが知らない名前は起動時の失敗ではなく型errorになる
+`error` を取れるのは `tsdoc-check` だけ、`off` を取れるのは既定で無効のruleだけで、既定で有効なruleを無効にする引数をengineは持たない
+選んだruleは `--enable <rule>` になり、`tsdoc-check` では `--error <rule>` にもなる 他のengineはこれらのoptionを拒否する
 
 `comment-check` はbaseline差分を無効化する未作成のpathを渡して起動する
 新規と解消済みの判定はengineごとではなく統合CLIが1つのbaseline fileで行うため、既存の `comment-baseline.json` がある場合は `--update-baseline` で移す

package/README.md

@@ -43,15 +43,11 @@ export default defineConfig({
 	},
 	config: {
 		"comment-check": {
-			enable: ["japanese-period"],
 			ignore: ["another-project"],
+			rules: { "japanese-period": "on" },
 		},
-		"document-style-check": {
-			enable: ["japanese-period"],
-		},
-		"tsdoc-check": {
-			error: ["missing-doc"],
-		},
+		"document-style-check": { enable: true },
+		"tsdoc-check": { error: true },
 	},
 });
 ```
@@ -94,9 +90,9 @@ Each engine runs:
 | `typecheck` | `tsc --noEmit` | `args`, `projects`; `tsconfig.json` holds the settings |
 | `knip` | `knip` | `args`; `knip.ts` holds the settings |
 | `code-style-check` | `code-style-check --json` | `ignore`, `targets`, `args` |
-| `comment-check` | `comment-check --json` | `ignore`, `targets`, `args`, `enable` (rule names to turn on) |
-| `document-style-check` | `document-style-check lint --json` | `ignore`, `targets`, `args`, `enable` (rule names to turn on) |
-| `tsdoc-check` | `tsdoc-check --json` | `ignore`, `targets`, `args`, `enable` (rule names to turn on), `error` (rule names to fail on) |
+| `comment-check` | `comment-check --json` | `ignore`, `targets`, `args`, `enable`, `rules` |
+| `document-style-check` | `document-style-check lint --json` | `ignore`, `targets`, `args`, `enable`, `rules` |
+| `tsdoc-check` | `tsdoc-check --json` | `ignore`, `targets`, `args`, `enable`, `error`, `rules` |
 
 `args` is appended after the engine defaults, for conditions the config cannot express and for the case where an engine changes its arguments.
 
@@ -107,8 +103,13 @@ A condition that an engine does not take is not passed on, and the section says
 biome: ignore skipped (biome.json holds its settings)
 ```
 
-`enable` becomes `--enable <rule>` on `comment-check`, `document-style-check`, and `tsdoc-check`, and the other engines reject the field.
-Each value is typed with the rule names the installed engine publishes from its `rule-ids` entry, so a name that engine does not know is a type error rather than a start-up failure.
+`enable` and `error` pick rules in bulk, and `rules` picks one rule at a time.
+`enable: true` turns on every rule the engine keeps off by default.
+`error: true` turns every rule of `tsdoc-check` into an error, enabling the opt-in ones first; it is the only condition that raises a rule.
+A `rules` entry names one rule and gives it `off`, `on`, or `error`, where `on` keeps the engine default and `error` means the same as the `error` preset for that rule.
+The `rules` key is the rule name itself, so the installed engine's union types it and a name that engine does not know is a type error rather than a start-up failure.
+Only `tsdoc-check` takes `error` in `rules`, and only rules that are off by default take `off`, because no engine can turn off a rule that is on by default.
+Each selected rule becomes `--enable <rule>` and, on `tsdoc-check`, `--error <rule>`; the other engines reject the fields.
 
 `comment-check` runs with an unwritten baseline path so that it reports every finding.
 The new-and-resolved diff is done by this CLI from a single baseline file, so an existing `comment-baseline.json` is moved over with `--update-baseline`.

package/dist/cli.js

@@ -194,6 +194,18 @@ function colorEnabled(stream, env) {
 import { existsSync as existsSync2 } from "fs";
 import { resolve } from "path";
 import { pathToFileURL } from "url";
+import {
+  OPT_IN_RULE_IDS as COMMENT_CHECK_OPT_IN_RULE_IDS,
+  RULE_IDS as COMMENT_CHECK_RULE_IDS
+} from "@yuu1111/comment-check/rule-ids";
+import {
+  OPT_IN_RULE_IDS as DOCUMENT_STYLE_CHECK_OPT_IN_RULE_IDS,
+  RULE_IDS as DOCUMENT_STYLE_CHECK_RULE_IDS
+} from "@yuu1111/document-style-check/rule-ids";
+import {
+  OPT_IN_RULE_IDS as TSDOC_CHECK_OPT_IN_RULE_IDS,
+  KNOWN_RULE_NAMES as TSDOC_CHECK_RULE_NAMES
+} from "@yuu1111/tsdoc-check/rule-ids";
 var ENGINE_NAMES = [
   "biome",
   "typecheck",
@@ -203,6 +215,27 @@ var ENGINE_NAMES = [
   "document-style-check",
   "tsdoc-check"
 ];
+var RULE_VOCABULARY = {
+  biome: { all: [], optIn: [], promotes: false },
+  typecheck: { all: [], optIn: [], promotes: false },
+  knip: { all: [], optIn: [], promotes: false },
+  "code-style-check": { all: [], optIn: [], promotes: false },
+  "comment-check": {
+    all: COMMENT_CHECK_RULE_IDS,
+    optIn: COMMENT_CHECK_OPT_IN_RULE_IDS,
+    promotes: false
+  },
+  "document-style-check": {
+    all: DOCUMENT_STYLE_CHECK_RULE_IDS,
+    optIn: DOCUMENT_STYLE_CHECK_OPT_IN_RULE_IDS,
+    promotes: false
+  },
+  "tsdoc-check": {
+    all: TSDOC_CHECK_RULE_NAMES,
+    optIn: TSDOC_CHECK_OPT_IN_RULE_IDS,
+    promotes: true
+  }
+};
 var DEFAULT_CONFIG_FILES = [
   "quality.config.ts",
   "quality.config.mts",
@@ -221,9 +254,9 @@ var ENGINE_OPTION_KEYS = {
   typecheck: ["args", "ignore", "projects", "targets"],
   knip: ["args", "ignore", "targets"],
   "code-style-check": ["args", "ignore", "targets"],
-  "comment-check": ["args", "enable", "ignore", "targets"],
-  "document-style-check": ["args", "enable", "ignore", "targets"],
-  "tsdoc-check": ["args", "enable", "error", "ignore", "targets"]
+  "comment-check": ["args", "enable", "ignore", "rules", "targets"],
+  "document-style-check": ["args", "enable", "ignore", "rules", "targets"],
+  "tsdoc-check": ["args", "enable", "error", "ignore", "rules", "targets"]
 };
 function readStringArray(value, field) {
   if (value === undefined) {
@@ -234,6 +267,41 @@ function readStringArray(value, field) {
   }
   return [...value];
 }
+function readBoolean(value, field) {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new Error(`${field} must be a boolean`);
+  }
+  return value;
+}
+function readRuleStates(value, field, name) {
+  if (value === undefined) {
+    return;
+  }
+  if (!isJsonObject2(value)) {
+    throw new Error(`${field} must be an object`);
+  }
+  const vocabulary = RULE_VOCABULARY[name];
+  const states = {};
+  for (const [rule, state] of Object.entries(value)) {
+    if (!vocabulary.all.includes(rule)) {
+      throw new Error(`${field} has an unknown rule: ${rule}`);
+    }
+    if (state !== "off" && state !== "on" && state !== "error") {
+      throw new Error(`${field}.${rule} must be "off", "on" or "error"`);
+    }
+    if (state === "error" && !vocabulary.promotes) {
+      throw new Error(`${field}.${rule}: ${name} cannot treat a rule as an error`);
+    }
+    if (state === "off" && !vocabulary.optIn.includes(rule)) {
+      throw new Error(`${field}.${rule}: ${name} cannot turn off a rule that is on by default`);
+    }
+    states[rule] = state;
+  }
+  return states;
+}
 function readBaseline2(value, source) {
   if (value === undefined || value === false) {
     return value;
@@ -265,13 +333,17 @@ function parseEngines(value, source) {
 function parseEngineExtras(value, source, name) {
   const extras = {};
   if (name === "comment-check" || name === "document-style-check" || name === "tsdoc-check") {
-    const enable = readStringArray(value.enable, `${source}: config.${name}.enable`);
+    const enable = readBoolean(value.enable, `${source}: config.${name}.enable`);
     if (enable !== undefined) {
       extras.enable = enable;
     }
+    const rules = readRuleStates(value.rules, `${source}: config.${name}.rules`, name);
+    if (rules !== undefined) {
+      extras.rules = rules;
+    }
   }
   if (name === "tsdoc-check") {
-    const error = readStringArray(value.error, `${source}: config.${name}.error`);
+    const error = readBoolean(value.error, `${source}: config.${name}.error`);
     if (error !== undefined) {
       extras.error = error;
     }
@@ -460,19 +532,54 @@ function buildTypecheckCommand(executable, context, project) {
     ...options.args ?? []
   ];
 }
-function enableArguments(options) {
-  return (options?.enable ?? []).flatMap((rule) => ["--enable", rule]);
+function applyRuleState(vocabulary, selected, rule, state) {
+  if (state === "off") {
+    selected.enable.delete(rule);
+    selected.error.delete(rule);
+    return;
+  }
+  if (state === "on") {
+    selected.error.delete(rule);
+  } else {
+    selected.error.add(rule);
+  }
+  if (vocabulary.optIn.includes(rule)) {
+    selected.enable.add(rule);
+  }
+}
+function selectRules(name, options) {
+  const selection = options ?? {};
+  const vocabulary = RULE_VOCABULARY[name];
+  const selected = { enable: new Set, error: new Set };
+  if (selection.enable === true) {
+    for (const rule of vocabulary.optIn) {
+      selected.enable.add(rule);
+    }
+  }
+  if (selection.error === true) {
+    for (const rule of vocabulary.all) {
+      applyRuleState(vocabulary, selected, rule, "error");
+    }
+  }
+  for (const [rule, state] of Object.entries(selection.rules ?? {})) {
+    applyRuleState(vocabulary, selected, rule, state);
+  }
+  return { enable: [...selected.enable], error: [...selected.error] };
 }
 function buildEngineCommand(name, executable, context) {
   const options = engineConfig(context.config, name) ?? {};
   const limits = ENGINE_LIMITS[name];
+  const selection = selectRules(name, options);
+  const enableArguments = selection.enable.flatMap((rule) => [
+    "--enable",
+    rule
+  ]);
+  const errorArguments = selection.error.flatMap((rule) => ["--error", rule]);
   const extra = options.args ?? [];
   const ignores = limits.ignore === undefined ? [...options.ignore ?? [], ...context.overrides.ignore] : [];
   const requested = context.overrides.targets.length > 0 ? context.overrides.targets : options.targets ?? ["."];
   const targets = limits.targets === undefined ? requested : [];
   const ignoreArguments = ignores.flatMap((ignore) => ["--ignore", ignore]);
-  const rules = engineConfig(context.config, "tsdoc-check")?.error ?? [];
-  const errorArguments = rules.flatMap((rule) => ["--error", rule]);
   if (name === "biome") {
     return [
       executable,
@@ -494,7 +601,7 @@ function buildEngineCommand(name, executable, context) {
       "--json",
       "--baseline",
       context.rawBaseline,
-      ...enableArguments(engineConfig(context.config, "comment-check")),
+      ...enableArguments,
       ...targets,
       ...ignoreArguments,
       ...extra
@@ -505,7 +612,7 @@ function buildEngineCommand(name, executable, context) {
       executable,
       "lint",
       "--json",
-      ...enableArguments(engineConfig(context.config, "document-style-check")),
+      ...enableArguments,
       ...targets,
       ...ignoreArguments,
       ...extra
@@ -517,7 +624,7 @@ function buildEngineCommand(name, executable, context) {
   return [
     executable,
     "--json",
-    ...enableArguments(engineConfig(context.config, "tsdoc-check")),
+    ...enableArguments,
     ...errorArguments,
     ...targets,
     ...ignoreArguments,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@yuu1111/quality-check",
-	"version": "0.11.0",
+	"version": "1.0.0",
 	"description": "Integrated quality check runner",
 	"repository": {
 		"type": "git",
@@ -23,7 +23,7 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "bun build src/cli.ts --target=bun --outdir=dist"
+		"build": "bun build src/cli.ts --target=bun --outdir=dist --external @yuu1111/comment-check/rule-ids --external @yuu1111/document-style-check/rule-ids --external @yuu1111/tsdoc-check/rule-ids"
 	},
 	"keywords": [
 		"quality",

package/src/config.ts

@@ -1,11 +1,20 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-import type { OptInRuleId as CommentCheckRuleName } from "@yuu1111/comment-check/rule-ids";
-import type { OptInRuleId as DocumentStyleCheckRuleName } from "@yuu1111/document-style-check/rule-ids";
-import type {
-	OptInRuleId as TsdocCheckRuleName,
-	TsdocRule,
+import {
+	OPT_IN_RULE_IDS as COMMENT_CHECK_OPT_IN_RULE_IDS,
+	RULE_IDS as COMMENT_CHECK_RULE_IDS,
+	type OptInRuleId as CommentCheckRuleName,
+} from "@yuu1111/comment-check/rule-ids";
+import {
+	OPT_IN_RULE_IDS as DOCUMENT_STYLE_CHECK_OPT_IN_RULE_IDS,
+	RULE_IDS as DOCUMENT_STYLE_CHECK_RULE_IDS,
+	type OptInRuleId as DocumentStyleCheckRuleName,
+} from "@yuu1111/document-style-check/rule-ids";
+import {
+	OPT_IN_RULE_IDS as TSDOC_CHECK_OPT_IN_RULE_IDS,
+	KNOWN_RULE_NAMES as TSDOC_CHECK_RULE_NAMES,
+	type TsdocRule,
 } from "@yuu1111/tsdoc-check/rule-ids";
 
 /**
@@ -42,26 +51,32 @@ export interface EngineOptions {
  * comment-checkへ渡す起動条件
  */
 export interface CommentCheckOptions extends EngineOptions {
-	/** 既定で無効のopt-in ruleのうち有効にするrule名 comment-checkが公開するunionで縛る */
-	enable?: CommentCheckRuleName[];
+	/** 既定で無効のopt-in ruleを全て有効にする */
+	enable?: boolean;
+	/** rule名ごとの状態 offで無効 onで有効 省略したruleはengineの既定に従う */
+	rules?: Partial<Record<CommentCheckRuleName, "off" | "on">>;
 }
 
 /**
  * document-style-checkへ渡す起動条件
  */
 export interface DocumentStyleCheckOptions extends EngineOptions {
-	/** 既定で無効のopt-in ruleのうち有効にするrule名 document-style-checkが公開するunionで縛る */
-	enable?: DocumentStyleCheckRuleName[];
+	/** 既定で無効のopt-in ruleを全て有効にする */
+	enable?: boolean;
+	/** rule名ごとの状態 offで無効 onで有効 省略したruleはengineの既定に従う */
+	rules?: Partial<Record<DocumentStyleCheckRuleName, "off" | "on">>;
 }
 
 /**
  * TSDoc検査へ渡す起動条件
  */
 export interface TsdocCheckOptions extends EngineOptions {
-	/** 既定で無効のopt-in ruleのうち有効にするrule名 tsdoc-checkが公開するunionで縛る */
-	enable?: TsdocCheckRuleName[];
-	/** 違反として扱うrule名 tsdoc-checkが公開するunionで縛る */
-	error?: TsdocRule[];
+	/** 既定で無効のopt-in ruleを全て有効にする */
+	enable?: boolean;
+	/** 全てのruleを違反として扱う opt-in ruleは有効にしてから上げる */
+	error?: boolean;
+	/** rule名ごとの状態 offで無効 onで既定のseverity errorで違反として扱う */
+	rules?: Partial<Record<TsdocRule, "off" | "on" | "error">>;
 }
 
 /**
@@ -85,6 +100,39 @@ export interface EngineConfigMap {
 	"tsdoc-check": TsdocCheckOptions;
 }
 
+/**
+ * rule名ごとの状態
+ */
+export type RuleState = "off" | "on" | "error";
+
+/**
+ * engineが公開するrule語彙 全ruleと既定で無効のopt-in ruleを持つ
+ */
+export const RULE_VOCABULARY: Record<
+	EngineName,
+	{ all: readonly string[]; optIn: readonly string[]; promotes: boolean }
+> = {
+	biome: { all: [], optIn: [], promotes: false },
+	typecheck: { all: [], optIn: [], promotes: false },
+	knip: { all: [], optIn: [], promotes: false },
+	"code-style-check": { all: [], optIn: [], promotes: false },
+	"comment-check": {
+		all: COMMENT_CHECK_RULE_IDS,
+		optIn: COMMENT_CHECK_OPT_IN_RULE_IDS,
+		promotes: false,
+	},
+	"document-style-check": {
+		all: DOCUMENT_STYLE_CHECK_RULE_IDS,
+		optIn: DOCUMENT_STYLE_CHECK_OPT_IN_RULE_IDS,
+		promotes: false,
+	},
+	"tsdoc-check": {
+		all: TSDOC_CHECK_RULE_NAMES,
+		optIn: TSDOC_CHECK_OPT_IN_RULE_IDS,
+		promotes: true,
+	},
+};
+
 /**
  * quality.config.tsが受け付ける統合検査の設定
  */
@@ -137,9 +185,9 @@ const ENGINE_OPTION_KEYS: Record<EngineName, readonly string[]> = {
 	typecheck: ["args", "ignore", "projects", "targets"],
 	knip: ["args", "ignore", "targets"],
 	"code-style-check": ["args", "ignore", "targets"],
-	"comment-check": ["args", "enable", "ignore", "targets"],
-	"document-style-check": ["args", "enable", "ignore", "targets"],
-	"tsdoc-check": ["args", "enable", "error", "ignore", "targets"],
+	"comment-check": ["args", "enable", "ignore", "rules", "targets"],
+	"document-style-check": ["args", "enable", "ignore", "rules", "targets"],
+	"tsdoc-check": ["args", "enable", "error", "ignore", "rules", "targets"],
 };
 
 function readStringArray(value: unknown, field: string): string[] | undefined {
@@ -155,6 +203,54 @@ function readStringArray(value: unknown, field: string): string[] | undefined {
 	return [...value] as string[];
 }
 
+function readBoolean(value: unknown, field: string): boolean | undefined {
+	if (value === undefined) {
+		return undefined;
+	}
+	if (typeof value !== "boolean") {
+		throw new Error(`${field} must be a boolean`);
+	}
+	return value;
+}
+
+/**
+ * rule名ごとの状態を読み取る engineが公開する語彙とengineが受け付ける状態で検証する
+ */
+function readRuleStates(
+	value: unknown,
+	field: string,
+	name: EngineName,
+): Record<string, RuleState> | undefined {
+	if (value === undefined) {
+		return undefined;
+	}
+	if (!isJsonObject(value)) {
+		throw new Error(`${field} must be an object`);
+	}
+	const vocabulary = RULE_VOCABULARY[name];
+	const states: Record<string, RuleState> = {};
+	for (const [rule, state] of Object.entries(value)) {
+		if (!vocabulary.all.includes(rule)) {
+			throw new Error(`${field} has an unknown rule: ${rule}`);
+		}
+		if (state !== "off" && state !== "on" && state !== "error") {
+			throw new Error(`${field}.${rule} must be "off", "on" or "error"`);
+		}
+		if (state === "error" && !vocabulary.promotes) {
+			throw new Error(
+				`${field}.${rule}: ${name} cannot treat a rule as an error`,
+			);
+		}
+		if (state === "off" && !vocabulary.optIn.includes(rule)) {
+			throw new Error(
+				`${field}.${rule}: ${name} cannot turn off a rule that is on by default`,
+			);
+		}
+		states[rule] = state;
+	}
+	return states;
+}
+
 function readBaseline(
 	value: unknown,
 	source: string,
@@ -194,9 +290,10 @@ function parseEngines(
 }
 
 type ParsedEngineOptions = EngineOptions & {
-	enable?: string[];
-	error?: string[];
+	enable?: boolean;
+	error?: boolean;
 	projects?: string[];
+	rules?: Record<string, RuleState>;
 };
 
 /**
@@ -213,19 +310,24 @@ function parseEngineExtras(
 		name === "document-style-check" ||
 		name === "tsdoc-check"
 	) {
-		const enable = readStringArray(
+		const enable = readBoolean(
 			value.enable,
 			`${source}: config.${name}.enable`,
 		);
 		if (enable !== undefined) {
 			extras.enable = enable;
 		}
+		const rules = readRuleStates(
+			value.rules,
+			`${source}: config.${name}.rules`,
+			name,
+		);
+		if (rules !== undefined) {
+			extras.rules = rules;
+		}
 	}
 	if (name === "tsdoc-check") {
-		const error = readStringArray(
-			value.error,
-			`${source}: config.${name}.error`,
-		);
+		const error = readBoolean(value.error, `${source}: config.${name}.error`);
 		if (error !== undefined) {
 			extras.error = error;
 		}

package/src/engines.ts

@@ -5,6 +5,8 @@ import {
 	type EngineOptions,
 	engineConfig,
 	type QualityConfig,
+	RULE_VOCABULARY,
+	type RuleState,
 } from "./config";
 
 /**
@@ -194,12 +196,76 @@ function buildTypecheckCommand(
 }
 
 /**
- * opt-in ruleを有効にするコマンド引数へ展開する
+ * 設定fileが持つruleの指定
  */
-function enableArguments(
-	options: { enable?: string[] } | null | undefined,
-): string[] {
-	return (options?.enable ?? []).flatMap((rule) => ["--enable", rule]);
+interface RuleSelection {
+	enable?: boolean;
+	error?: boolean;
+	rules?: Record<string, RuleState>;
+}
+
+/**
+ * engineが公開するrule語彙
+ */
+type RuleVocabulary = (typeof RULE_VOCABULARY)[EngineName];
+
+/**
+ * 選んだruleを有効の一覧と違反の一覧へ反映する
+ *
+ * @param vocabulary - 反映先engineのrule語彙
+ * @param selected - 反映先のrule名の集合
+ * @param rule - 反映するrule名
+ * @param state - 反映する状態
+ */
+function applyRuleState(
+	vocabulary: RuleVocabulary,
+	selected: { enable: Set<string>; error: Set<string> },
+	rule: string,
+	state: RuleState,
+): void {
+	if (state === "off") {
+		selected.enable.delete(rule);
+		selected.error.delete(rule);
+		return;
+	}
+	if (state === "on") {
+		selected.error.delete(rule);
+	} else {
+		selected.error.add(rule);
+	}
+	if (vocabulary.optIn.includes(rule)) {
+		selected.enable.add(rule);
+	}
+}
+
+/**
+ * ruleの一括指定と個別指定をengineへ渡すruleの一覧へ展開する
+ *
+ * @param name - 展開するengine名
+ * @param options - engineへ渡す起動条件
+ * @returns --enableへ渡すrule名と--errorへ渡すrule名の組
+ */
+function selectRules(
+	name: EngineName,
+	options: EngineOptions | null | undefined,
+): { enable: string[]; error: string[] } {
+	const selection = (options ?? {}) as RuleSelection;
+	const vocabulary = RULE_VOCABULARY[name];
+	const selected = { enable: new Set<string>(), error: new Set<string>() };
+	if (selection.enable === true) {
+		for (const rule of vocabulary.optIn) {
+			selected.enable.add(rule);
+		}
+	}
+	if (selection.error === true) {
+		for (const rule of vocabulary.all) {
+			applyRuleState(vocabulary, selected, rule, "error");
+		}
+	}
+	for (const [rule, state] of Object.entries(selection.rules ?? {})) {
+		applyRuleState(vocabulary, selected, rule, state);
+	}
+	return { enable: [...selected.enable], error: [...selected.error] };
 }
 
 /**
@@ -217,6 +283,12 @@ export function buildEngineCommand(
 ): string[] {
 	const options: EngineOptions = engineConfig(context.config, name) ?? {};
 	const limits = ENGINE_LIMITS[name];
+	const selection = selectRules(name, options);
+	const enableArguments = selection.enable.flatMap((rule) => [
+		"--enable",
+		rule,
+	]);
+	const errorArguments = selection.error.flatMap((rule) => ["--error", rule]);
 	const extra = options.args ?? [];
 	const ignores =
 		limits.ignore === undefined
@@ -228,8 +300,6 @@ export function buildEngineCommand(
 			: (options.targets ?? ["."]);
 	const targets = limits.targets === undefined ? requested : [];
 	const ignoreArguments = ignores.flatMap((ignore) => ["--ignore", ignore]);
-	const rules = engineConfig(context.config, "tsdoc-check")?.error ?? [];
-	const errorArguments = rules.flatMap((rule) => ["--error", rule]);
 	if (name === "biome") {
 		return [
 			executable,
@@ -251,7 +321,7 @@ export function buildEngineCommand(
 			"--json",
 			"--baseline",
 			context.rawBaseline,
-			...enableArguments(engineConfig(context.config, "comment-check")),
+			...enableArguments,
 			...targets,
 			...ignoreArguments,
 			...extra,
@@ -262,7 +332,7 @@ export function buildEngineCommand(
 			executable,
 			"lint",
 			"--json",
-			...enableArguments(engineConfig(context.config, "document-style-check")),
+			...enableArguments,
 			...targets,
 			...ignoreArguments,
 			...extra,
@@ -274,7 +344,7 @@ export function buildEngineCommand(
 	return [
 		executable,
 		"--json",
-		...enableArguments(engineConfig(context.config, "tsdoc-check")),
+		...enableArguments,
 		...errorArguments,
 		...targets,
 		...ignoreArguments,