List each AI enhancement against the script it enhances

Declared in PHP rather than in each bash header, against scriptinfo's usual rule
that the header next to the code is authoritative: it is authoritative about what
the script does, and an enhancement is something else reading its output, gated
by a flag the script has never heard of. A description of PHP inside a file that
cannot enforce it would drift the first time either changed.

Shown with its switch, so "there is an enhancement" and "it is running" are never
the same claim. Discovery is listed even though nothing acts on its output — it
takes the first accessible root folder with no regard for content, and the
classification scan is what notices that night. That relationship explains where
misfiled series come from and was written down nowhere.

Plugin/unraid/include/ai_repair.php

@@ -974,6 +974,64 @@ function vv_ai_watchdog_findings(?array $payload = null): array {
     return $found;
 }
 
+// ── What the AI adds to which script ──────────────────────────────────────────────────────────
+// Declared here rather than in each script's header, and that is a deliberate departure from
+// api/scriptinfo.php's usual rule that the header next to the code is authoritative. It is
+// authoritative about what the script does. An enhancement is not the script's behaviour — it is
+// something else reading the script's output afterwards, implemented in PHP, gated by a flag the
+// script has never heard of. Writing it into the bash header would put a description of PHP inside
+// a file that cannot enforce it, and the two would drift the first time either changed.
+//
+// A script may appear here without the enhancement being about its output. sonarr discovery is
+// listed because the triage is its safety net: discovery takes the first accessible root folder
+// (playback_aware_sonarr_discovery.sh:750) with no regard for whether the show is anime, kids or
+// general, and the classification scan is what notices the next night. That relationship is real,
+// it explains where misfiled series come from, and until now it was written down nowhere.
+const VV_AI_SCRIPT_ENHANCEMENTS = [
+    'Arrs_Stack/sonarr_classification_scan.sh' => [
+        'name' => 'Classification triage',
+        'flag' => 'AI_ASSIST_DISCOVERY',
+        'what' => 'This scan reports reverse-anime leaks and deliberately does not act on them — '
+                . 'its own header calls them genuine judgement calls, because no metadata field '
+                . 'separates a misfile from a deliberate choice. The triage sorts that bucket into '
+                . 'misfiled, donghua, anime-adjacent or uncertain.',
+        'acts' => 'Files a finding for misfiled and uncertain only. A misfiled series carries a '
+                . 'Move action, which relocates the files — pressed by a person, never automatic.',
+    ],
+    'Arrs_Stack/playback_aware_sonarr_discovery.sh' => [
+        'name' => 'Classification triage (safety net)',
+        'flag' => 'AI_ASSIST_DISCOVERY',
+        'what' => 'Discovery adds every show it finds to the first accessible root folder, without '
+                . 'classifying it. Anything it places wrongly is caught by the classification scan '
+                . 'that night, and the triage is what turns that scan\'s count into named titles.',
+        'acts' => 'Nothing here. The enhancement runs against the classification scan\'s output, '
+                . 'not against this script.',
+    ],
+    'Orchestrators/watchdog_orchestrator.sh' => [
+        'name' => 'Watchdog findings',
+        'flag' => 'AI_ASSIST_WATCHDOG',
+        'what' => 'Turns the counters the watchdogs keep — skip lists, strikes past their limit, '
+                . 'repeated restarts, unattended reboots, sustained pressure — into named findings '
+                . 'instead of numbers on a card.',
+        'acts' => 'Files findings only. The kind is not conf-bound, so it cannot autofix by '
+                . 'construction rather than by a setting.',
+    ],
+];
+
+function vv_ai_script_enhancements(string $id = ''): array {
+    if ($id === '') return VV_AI_SCRIPT_ENHANCEMENTS;
+    $id = ltrim(trim($id), '/');
+    if (!str_ends_with($id, '.sh')) $id .= '.sh';
+    $e = VV_AI_SCRIPT_ENHANCEMENTS[$id] ?? null;
+    if (!$e) return [];
+    // The flag state travels with it. An enhancement listed against a script without saying
+    // whether it is switched on is the same trap AI_ASSIST_WATCHDOG was for months: a name that
+    // looks like a feature and does nothing.
+    $e['enabled'] = strtolower(trim((string)(vv_conf_vars()[$e['flag']] ?? 'false'))) === 'true'
+                    && vv_ai_repair_enabled();
+    return $e;
+}
+
 // ── Classification triage ─────────────────────────────────────────────────────────────────────
 // The one place in the media stack where a model beats the rule it is helping.
 //