feat: add descriptions to plugin host enable toggles

src/backend/plugins/settings.ts

@@ -175,6 +175,7 @@ export function declaredFields(
           key: host.enableKey,
           type: "boolean",
           labelKey: host.enableLabelKey,
+          descriptionKey: host.enableDescriptionKey,
           default: host.enableDefault ?? false,
         },
       ]

src/backend/tests/plugins/settings-manifest.test.ts

@@ -301,6 +301,21 @@ describe("contributes.settings", () => {
     expect(errors.join(" ")).toContain("enableLabelKey");
   });
 
+  it("accepts an enableDescriptionKey and rejects an empty one", () => {
+    const host = { enableKey: "enableThing", enableLabelKey: "k", fields: [] };
+
+    expect(
+      validateManifest(
+        withSettings({ host: { ...host, enableDescriptionKey: "d" } }),
+      ),
+    ).toEqual([]);
+    expect(
+      validateManifest(
+        withSettings({ host: { ...host, enableDescriptionKey: "" } }),
+      ).join(" "),
+    ).toContain("enableDescriptionKey");
+  });
+
   it("rejects a key that would not be index-safe", () => {
     const errors = validateManifest(
       withSettings({

src/backend/tests/plugins/settings.test.ts

@@ -183,13 +183,18 @@ describe("declaredFields", () => {
       host: {
         enableKey: "enableThing",
         enableLabelKey: "k",
+        enableDescriptionKey: "d",
         fields: [{ key: "port", type: "number", labelKey: "k" }],
       },
     });
 
     const fields = declaredFields(withHost, "host");
     expect(fields.map((f) => f.key)).toEqual(["enableThing", "port"]);
-    expect(fields[0]).toMatchObject({ type: "boolean", default: false });
+    expect(fields[0]).toMatchObject({
+      type: "boolean",
+      default: false,
+      descriptionKey: "d",
+    });
   });
 
   it("finds a field by key", () => {

src/ui/api/plugins-api.ts

@@ -41,6 +41,7 @@ export interface PluginSettingsField {
 export interface PluginHostSettingsContribution {
   enableKey?: string;
   enableLabelKey?: string;
+  enableDescriptionKey?: string;
   enableDefault?: boolean;
   editorGroup?: "top" | "ssh";
   editorOrder?: number;

src/ui/settings/HostPluginSections.tsx

@@ -192,6 +192,7 @@ function HostPluginSection({
             key: enableKey,
             type: "boolean",
             labelKey: host.enableLabelKey,
+            descriptionKey: host.enableDescriptionKey,
           }}
           values={shown}
           setValue={setValue}