@yuu1111/quality-check 0.10.0 → 1.0.0

package/README.ja.md

@@ -10,7 +10,10 @@ Projectごとのscriptから個別に呼んでいたBiome、型検査、Knip、c
 bun add -D @yuu1111/quality-check
 ```
 
-engineのbinaryは利用Projectの `node_modules/.bin` から実行時に解決する engineを自分のscriptから呼ばないProjectではKnipが `@yuu1111/comment-check` などを未使用依存として報告するため `knip.ts` の `ignoreDependencies` で理由付きに宣言する
+このCLIは `comment-check`、`document-style-check`、`tsdoc-check` を、configの型がengineの公開するrule名を取り込むためpeer dependencyとして持つ
+package managerはこのCLIと一緒に導入し、engineのbinaryは利用Projectの `node_modules/.bin` から実行時に解決する
+
+`@yuu1111/code-style-check` を宣言するProjectではKnipが未使用依存として報告するため `knip.ts` の `ignoreDependencies` で理由付きに宣言する
 
 ## Usage
 
@@ -39,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 },
 	},
 });
 ```
@@ -88,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の引数が変わったときの逃げ道として使う
@@ -102,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では拒否される
-このCLIはengineを同梱しないため、opt-in ruleを有効にするProjectは対応するengine packageも同じ変更で更新する
+`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

@@ -11,8 +11,10 @@ The baseline diff lives here too.
 bun add -D @yuu1111/quality-check
 ```
 
-An engine binary is resolved at run time from the project's `node_modules/.bin`.
-A project that never calls an engine from its own scripts therefore sees Knip report `@yuu1111/comment-check` and its siblings as unused dependencies, so it declares them in `ignoreDependencies` with the reason.
+`comment-check`, `document-style-check`, and `tsdoc-check` are peer dependencies of this CLI, because the config types embed the rule names those engines publish.
+A package manager installs them with this CLI, and each engine binary is resolved at run time from the project's `node_modules/.bin`.
+
+A project that declares `@yuu1111/code-style-check` sees Knip report it as an unused dependency, so it names it in `ignoreDependencies` with the reason.
 
 ## Usage
 
@@ -41,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 },
 	},
 });
 ```
@@ -92,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.
 
@@ -105,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.
-This CLI ships no engine of its own, so a project that turns an opt-in rule on updates the matching engine package in the same change.
+`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.10.0",
+	"version": "1.0.0",
 	"description": "Integrated quality check runner",
 	"repository": {
 		"type": "git",
@@ -23,12 +23,17 @@
 		"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",
 		"lint"
 	],
+	"peerDependencies": {
+		"@yuu1111/comment-check": ">=2.3.0",
+		"@yuu1111/document-style-check": ">=0.5.0",
+		"@yuu1111/tsdoc-check": ">=2.2.0"
+	},
 	"devDependencies": {
 		"@yuu1111/shared": "workspace:*"
 	}

package/src/config.ts

@@ -1,6 +1,21 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+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";
 
 /**
  * 統合CLIが起動できるengineの名前 並び順が実行順になる
@@ -36,26 +51,32 @@ export interface EngineOptions {
  * comment-checkへ渡す起動条件
  */
 export interface CommentCheckOptions extends EngineOptions {
-	/** 既定で無効のopt-in ruleのうち有効にするrule名 */
-	enable?: string[];
+	/** 既定で無効の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名 */
-	enable?: string[];
+	/** 既定で無効の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名 */
-	enable?: string[];
-	/** 違反として扱うrule名 */
-	error?: string[];
+	/** 既定で無効のopt-in ruleを全て有効にする */
+	enable?: boolean;
+	/** 全てのruleを違反として扱う opt-in ruleは有効にしてから上げる */
+	error?: boolean;
+	/** rule名ごとの状態 offで無効 onで既定のseverity errorで違反として扱う */
+	rules?: Partial<Record<TsdocRule, "off" | "on" | "error">>;
 }
 
 /**
@@ -79,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が受け付ける統合検査の設定
  */
@@ -131,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 {
@@ -149,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,
@@ -188,9 +290,10 @@ function parseEngines(
 }
 
 type ParsedEngineOptions = EngineOptions & {
-	enable?: string[];
-	error?: string[];
+	enable?: boolean;
+	error?: boolean;
 	projects?: string[];
+	rules?: Record<string, RuleState>;
 };
 
 /**
@@ -207,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;
 		}
@@ -284,7 +392,7 @@ function parseEngineConfig(
 	if (!isJsonObject(value)) {
 		throw new Error(`${source}: config must be an object`);
 	}
-	const config: Partial<EngineConfigMap> = {};
+	const config: Partial<Record<EngineName, ParsedEngineOptions>> = {};
 	for (const [name, options] of Object.entries(value)) {
 		if (!isEngineName(name)) {
 			throw new Error(`${source}: unknown engine in config: ${name}`);
@@ -294,7 +402,9 @@ function parseEngineConfig(
 		}
 		config[name] = parseEngineOptions(options, source, name);
 	}
-	return config;
+
+	// rule名はengineが公開するunionで縛る 実行時の入力は文字列として届くため検証済みの値をここで型へ寄せる
+	return config as Partial<EngineConfigMap>;
 }
 
 /**

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,