make channel required and update docs

docs/channels/twitch.md

@@ -50,7 +50,7 @@ Minimal config:
       username: "clawdbot",              // Bot's Twitch account
       accessToken: "oauth:abc123...",    // OAuth Access Token (or use CLAWDBOT_TWITCH_ACCESS_TOKEN env var)
       clientId: "xyz789...",             // Client ID from Token Generator
-      channel: "vevisk",                 // Which Twitch channel's chat to join
+      channel: "vevisk",                 // Which Twitch channel's chat to join (required)
       allowFrom: ["123456789"]           // (recommended) Your Twitch user ID only
     }
   }
@@ -279,7 +279,7 @@ If you see "token refresh disabled (no refresh token)":
 - `username` - Bot username
 - `accessToken` - OAuth access token with `chat:read` and `chat:write`
 - `clientId` - Twitch Client ID (from Token Generator or your app)
-- `channel` - Channel to join
+- `channel` - Channel to join (required)
 - `enabled` - Enable this account (default: `true`)
 - `clientSecret` - Optional: For automatic token refresh
 - `refreshToken` - Optional: For automatic token refresh

extensions/twitch/README.md

@@ -30,7 +30,7 @@ Minimal config (simplified single-account):
       username: "clawdbot",
       accessToken: "oauth:abc123...", // OAuth Access Token (add oauth: prefix)
       clientId: "xyz789...", // Client ID from Token Generator
-      channel: "vevisk", // Channel to join
+      channel: "vevisk", // Channel to join (required)
       allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-%20to-user-id/)
     },
   },

extensions/twitch/src/config-schema.ts

@@ -16,8 +16,8 @@ const TwitchAccountSchema = z.object({
   accessToken: z.string(),
   /** Twitch client ID (from Twitch Developer Portal or twitchtokengenerator.com) */
   clientId: z.string().optional(),
-  /** Channel name to join (defaults to username) */
+  /** Channel name to join */
-  channel: z.string().optional(),
+  channel: z.string().min(1),
   /** Enable this account */
   enabled: z.boolean().optional(),
   /** Allowlist of Twitch user IDs who can interact with the bot (use IDs for safety, not usernames) */

extensions/twitch/src/onboarding.test.ts

@@ -189,24 +189,17 @@ describe("onboarding helpers", () => {
       expect(result).toBe("#mychannel");
     });
 
-    it("should return undefined when empty string provided", async () => {
+    it("should require a non-empty channel name", async () => {
       const { promptChannelName } = await import("./onboarding.js");
 
       mockPromptText.mockResolvedValue("");
 
-      const result = await promptChannelName(mockPrompter, null);
+      await promptChannelName(mockPrompter, null);
 
-      expect(result).toBeUndefined();
+      const { validate } = mockPromptText.mock.calls[0]?.[0] ?? {};
-    });
+      expect(validate?.("")).toBe("Required");
-
+      expect(validate?.("   ")).toBe("Required");
-    it("should return undefined when whitespace only", async () => {
+      expect(validate?.("#chan")).toBeUndefined();
-      const { promptChannelName } = await import("./onboarding.js");
-
-      mockPromptText.mockResolvedValue("   ");
-
-      const result = await promptChannelName(mockPrompter, null);
-
-      expect(result).toBeUndefined();
     });
   });
 

extensions/twitch/src/onboarding.ts

@@ -153,14 +153,15 @@ async function promptClientId(
 async function promptChannelName(
   prompter: WizardPrompter,
   account: TwitchAccountConfig | null,
-): Promise<string | undefined> {
+): Promise<string> {
   const channelName = String(
     await prompter.text({
-      message: "Channel to join (default: bot username)",
+      message: "Channel to join",
       initialValue: account?.channel ?? "",
+      validate: (value) => (value?.trim() ? undefined : "Required"),
     }),
   ).trim();
-  return channelName || undefined;
+  return channelName;
 }
 
 /**