docs: remove legacy option refs and modernize config docs (#89)

src/config/definitions/domain-registry.test.ts

@@ -35,9 +35,7 @@ function collectConfigLeafPaths(config: ResolvedConfig): string[] {
 }
 
 // DEFAULT_CONFIG leaves that intentionally do not have a curated
-// CONFIG_OPTION_REGISTRY entry. The generated config.example.jsonc still
-// includes these paths, but their inline comments fall back to an auto-
-// humanized key name instead of a written description.
+// CONFIG_OPTION_REGISTRY entry.
 //
 // Current intentional gaps:
 //   - subtitleStyle.*: thin wrappers around standard CSS properties; the
@@ -49,6 +47,8 @@ function collectConfigLeafPaths(config: ResolvedConfig): string[] {
 // an allowlist entry. Only allowlist a path when the registry is genuinely
 // the wrong surface for it.
 const UNDOCUMENTED_LEAVES: ReadonlySet<string> = new Set([
+  'anilist.characterDictionary.evictionPolicy',
+  'anilist.characterDictionary.refreshTtlHours',
   'keybindings',
   'subtitleStyle.backdropFilter',
   'subtitleStyle.backgroundColor',
@@ -85,6 +85,13 @@ const UNDOCUMENTED_LEAVES: ReadonlySet<string> = new Set([
   'subtitleStyle.textShadow',
   'subtitleStyle.WebkitTextStroke',
   'subtitleStyle.wordSpacing',
+  'youtubeSubgen.ai.model',
+  'youtubeSubgen.ai.systemPrompt',
+  'youtubeSubgen.fixWithAi',
+  'youtubeSubgen.whisperBin',
+  'youtubeSubgen.whisperModel',
+  'youtubeSubgen.whisperThreads',
+  'youtubeSubgen.whisperVadModel',
 ]);
 
 test('config option registry includes critical paths and has unique entries', () => {

src/config/definitions/options-core.ts

@@ -188,7 +188,7 @@ export function buildCoreConfigOptionRegistry(
       kind: 'object',
       defaultValue: defaultConfig.controller.buttonIndices,
       description:
-        'Semantic button-name reference mapping used for legacy configs and debug output. Updating it does not rewrite existing raw binding descriptors.',
+        'Semantic button-name reference mapping used for debug output. Updating it does not rewrite existing raw binding descriptors.',
     },
     {
       path: 'controller.buttonIndices.select',

src/config/definitions/options-integrations.ts

@@ -304,7 +304,7 @@ export function buildIntegrationConfigOptionRegistry(
       kind: 'object',
       defaultValue: defaultConfig.ankiConnect.knownWords.decks,
       description:
-        'Decks and fields for known-word cache. Object mapping deck names to arrays of field names to extract, e.g. { "Kaishi 1.5k": ["Word", "Word Reading"] }.',
+        'Decks and expression/word fields for known-word cache. Object mapping deck names to arrays of field names to extract, e.g. { "Kaishi 1.5k": ["Word"] }.',
     },
     {
       path: 'ankiConnect.isKiku.fieldGrouping',
@@ -392,13 +392,6 @@ export function buildIntegrationConfigOptionRegistry(
       description:
         'Optional explicit AniList access token override; leave empty to use locally stored token from setup.',
     },
-    {
-      path: 'anilist.characterDictionary.refreshTtlHours',
-      kind: 'number',
-      defaultValue: defaultConfig.anilist.characterDictionary.refreshTtlHours,
-      description:
-        'Legacy setting; merged character dictionary retention is now usage-based and this value is ignored.',
-    },
     {
       path: 'anilist.characterDictionary.maxLoaded',
       kind: 'number',
@@ -406,14 +399,6 @@ export function buildIntegrationConfigOptionRegistry(
       description:
         'Maximum number of most-recently-used anime snapshots included in the merged Yomitan character dictionary.',
     },
-    {
-      path: 'anilist.characterDictionary.evictionPolicy',
-      kind: 'enum',
-      enumValues: ['disable', 'delete'],
-      defaultValue: defaultConfig.anilist.characterDictionary.evictionPolicy,
-      description:
-        'Legacy setting; merged character dictionary eviction is usage-based and this value is ignored.',
-    },
     {
       path: 'anilist.characterDictionary.profileScope',
       kind: 'enum',
@@ -665,53 +650,5 @@ export function buildIntegrationConfigOptionRegistry(
       defaultValue: defaultConfig.ai.requestTimeoutMs,
       description: 'Timeout in milliseconds for shared AI provider requests.',
     },
-    {
-      path: 'youtubeSubgen.whisperBin',
-      kind: 'string',
-      defaultValue: defaultConfig.youtubeSubgen.whisperBin,
-      description:
-        'Legacy compatibility path kept for external subtitle fallback tools; not used by default.',
-    },
-    {
-      path: 'youtubeSubgen.whisperModel',
-      kind: 'string',
-      defaultValue: defaultConfig.youtubeSubgen.whisperModel,
-      description:
-        'Legacy compatibility model path kept for external subtitle fallback tooling; not used by default.',
-    },
-    {
-      path: 'youtubeSubgen.whisperVadModel',
-      kind: 'string',
-      defaultValue: defaultConfig.youtubeSubgen.whisperVadModel,
-      description:
-        'Legacy compatibility VAD path kept for external subtitle fallback tooling; not used by default.',
-    },
-    {
-      path: 'youtubeSubgen.whisperThreads',
-      kind: 'number',
-      defaultValue: defaultConfig.youtubeSubgen.whisperThreads,
-      description: 'Legacy thread tuning for subtitle fallback tooling; not used by default.',
-    },
-    {
-      path: 'youtubeSubgen.fixWithAi',
-      kind: 'boolean',
-      defaultValue: defaultConfig.youtubeSubgen.fixWithAi,
-      description:
-        'Legacy subtitle fallback post-processing switch kept for compatibility; use is currently disabled by default.',
-    },
-    {
-      path: 'youtubeSubgen.ai.model',
-      kind: 'string',
-      defaultValue: defaultConfig.youtubeSubgen.ai.model,
-      description:
-        'Optional model override for legacy subtitle fallback post-processing; not used by default.',
-    },
-    {
-      path: 'youtubeSubgen.ai.systemPrompt',
-      kind: 'string',
-      defaultValue: defaultConfig.youtubeSubgen.ai.systemPrompt,
-      description:
-        'Optional system prompt override for legacy subtitle fallback post-processing; not used by default.',
-    },
   ];
 }