popii-framework 0.6.1-beta.0

package/dist/cli.js

@@ -0,0 +1,1710 @@
+#!/usr/bin/env bun
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/cli/commands.ts
+import { intro, text, multiselect, confirm, outro, isCancel, spinner, select } from "@clack/prompts";
+import { mkdir as mkdir2 } from "node:fs/promises";
+import { join as join2, dirname } from "node:path";
+import { pathToFileURL } from "node:url";
+import { existsSync, watch, readdirSync, readFileSync } from "node:fs";
+
+// src/cli/scaffold.ts
+import { mkdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+var BUILTIN_PLUGIN_FIELDS = {
+  webPlugin: [
+    { configKey: "port", type: "number", default: "3000" },
+    { configKey: "publicUrl", type: "string" },
+    { configKey: "dashboard", type: "bool" },
+    { configKey: "dashboardPassword", envKey: "WEB_DASHBOARD_PASSWORD", type: "string" },
+    { configKey: "oauth2.clientId", envKey: "DISCORD_CLIENT_ID", type: "string" },
+    { configKey: "oauth2.clientSecret", envKey: "DISCORD_CLIENT_SECRET", type: "string" },
+    { configKey: "oauth2.redirectUri", envKey: "REDIRECT_URI", type: "string" }
+  ],
+  mongoosePlugin: [{ configKey: "uri", envKey: "MONGODB_URI", type: "string" }],
+  sqlitePlugin: [{ configKey: "filename", type: "string", default: "db.sqlite" }],
+  popiiAiPlugin: [
+    { configKey: "provider", type: "string", default: "anthropic" },
+    { configKey: "apiKey", envKey: "AI_API_KEY", type: "string" },
+    { configKey: "model", type: "string" }
+  ],
+  commandLoggerPlugin: [
+    { configKey: "logExecution", type: "bool", default: "false" },
+    { configKey: "logCompletion", type: "bool", default: "false" },
+    { configKey: "logErrors", type: "bool", default: "true" }
+  ],
+  economyPlugin: [
+    { configKey: "currencyName", type: "string", default: "Coins" },
+    { configKey: "cooldownMs", type: "number", default: "60000" }
+  ],
+  captchaPlugin: [
+    { configKey: "siteKey", envKey: "HCAPTCHA_SITE_KEY", type: "string" },
+    { configKey: "secretKey", envKey: "HCAPTCHA_SECRET_KEY", type: "string" },
+    { configKey: "port", type: "number", default: "3001" },
+    { configKey: "publicUrl", type: "string" }
+  ],
+  activityRotatorPlugin: [
+    { configKey: "intervalMs", type: "number", default: "60000" }
+  ],
+  payPlugin: [
+    { configKey: "patreon.webhookSecret", envKey: "PATREON_WEBHOOK_SECRET", type: "string", enabledBy: "patreon.enabled" },
+    { configKey: "kofi.verificationToken", envKey: "KOFI_VERIFICATION_TOKEN", type: "string", enabledBy: "kofi.enabled" }
+  ]
+};
+function buildPluginOptionsStr(pluginName, cfg) {
+  if (pluginName === "payPlugin") {
+    const parts = [];
+    if (cfg["patreon.enabled"] === "true" && cfg["patreon.webhookSecret"]) {
+      const port = parseInt(cfg["patreon.port"] || "8080");
+      parts.push(`patreon: { webhookSecret: process.env.PATREON_WEBHOOK_SECRET || "", port: ${port} }`);
+    }
+    if (cfg["kofi.enabled"] === "true" && cfg["kofi.verificationToken"]) {
+      const port = parseInt(cfg["kofi.port"] || "8081");
+      parts.push(`kofi: { verificationToken: process.env.KOFI_VERIFICATION_TOKEN || "", port: ${port} }`);
+    }
+    return parts.join(", ");
+  }
+  if (pluginName === "activityRotatorPlugin") {
+    const intervalMs = parseInt(cfg["intervalMs"] || "60000");
+    const name = cfg["activity.name"] || "with popii";
+    const typeMap = { Playing: 0, Streaming: 1, Listening: 2, Watching: 3, Competing: 5 };
+    const type = typeMap[cfg["activity.type"] ?? "Playing"] ?? 0;
+    return `intervalMs: ${intervalMs}, activities: [{ name: "${name}", type: ${type} }]`;
+  }
+  const specs = BUILTIN_PLUGIN_FIELDS[pluginName];
+  if (!specs)
+    return "";
+  const top = [];
+  const nested = {};
+  for (const spec of specs) {
+    const raw = cfg[spec.configKey] ?? spec.default ?? "";
+    if (!raw)
+      continue;
+    let code;
+    if (spec.envKey) {
+      if (!cfg[spec.configKey])
+        continue;
+      code = `process.env.${spec.envKey} || ""`;
+    } else if (spec.type === "number") {
+      code = String(parseInt(raw) || 0);
+    } else if (spec.type === "bool") {
+      code = raw === "true" ? "true" : "false";
+    } else {
+      code = `"${raw}"`;
+    }
+    const parts = spec.configKey.split(".");
+    if (parts.length === 1)
+      top.push(`${spec.configKey}: ${code}`);
+    else {
+      const [parent, ...rest] = parts;
+      (nested[parent] ??= []).push(`${rest.join(".")}: ${code}`);
+    }
+  }
+  for (const [k, entries] of Object.entries(nested))
+    if (entries.length)
+      top.push(`${k}: { ${entries.join(", ")} }`);
+  return top.join(", ");
+}
+async function scaffoldProject(opts) {
+  const { botName, plugins, communityPlugins = [], botToken, installDeps, genDocker, pluginConfig, communityPluginConfig } = opts;
+  let djsVersion = "^14.26.3";
+  try {
+    const djsRes = await fetch("https://registry.npmjs.org/discord.js/latest");
+    if (djsRes.ok) {
+      const djsData = await djsRes.json();
+      if (djsData.version)
+        djsVersion = `^${djsData.version}`;
+    }
+  } catch {}
+  const targetDir = join(process.cwd(), botName);
+  console.log(`  Scaffolding project at: ${targetDir}`);
+  await mkdir(targetDir, { recursive: true });
+  try {
+    await mkdir(join(targetDir, "src", "commands"), { recursive: true });
+    await mkdir(join(targetDir, "src", "events"), { recursive: true });
+    await mkdir(join(targetDir, "src", "snaps"), { recursive: true });
+    await mkdir(join(targetDir, "src", "middlewares"), { recursive: true });
+    await mkdir(join(targetDir, "src", "tasks"), { recursive: true });
+    const communityDeps = {};
+    for (const cp of communityPlugins)
+      communityDeps[cp.npmName] = "latest";
+    const pluginPeerDeps = {
+      voicePlugin: { "@discordjs/voice": "latest" },
+      canvasPlugin: { "@napi-rs/canvas": "latest" },
+      lastFmPlugin: { "@discordjs/voice": "latest" },
+      webPlugin: { ejs: "latest" },
+      mongoosePlugin: { mongoose: "latest" }
+    };
+    const builtinDeps = {};
+    for (const p of plugins)
+      Object.assign(builtinDeps, pluginPeerDeps[p] ?? {});
+    const pkgJson = {
+      name: botName,
+      version: "1.0.0",
+      private: true,
+      scripts: { dev: "popii dev", start: "bun src/index.ts" },
+      dependencies: { popii: "latest", "discord.js": djsVersion, ...builtinDeps, ...communityDeps },
+      devDependencies: { "@types/bun": "latest" }
+    };
+    await Bun.write(join(targetDir, "package.json"), JSON.stringify(pkgJson, null, 2));
+    const tsConfig = {
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "Bundler",
+        strict: true,
+        skipLibCheck: true,
+        types: ["bun"]
+      }
+    };
+    await Bun.write(join(targetDir, "tsconfig.json"), JSON.stringify(tsConfig, null, 2));
+    const envLines = [`DISCORD_TOKEN=${botToken}`];
+    for (const p of plugins) {
+      const cfg = pluginConfig?.[p] ?? {};
+      for (const spec of BUILTIN_PLUGIN_FIELDS[p] ?? []) {
+        if (!spec.envKey)
+          continue;
+        if (spec.enabledBy && cfg[spec.enabledBy] !== "true")
+          continue;
+        const val = cfg[spec.configKey] ?? "";
+        envLines.push(`${spec.envKey}=${val}`);
+      }
+    }
+    for (const fields of Object.values(communityPluginConfig ?? {}))
+      for (const [k, v] of Object.entries(fields))
+        envLines.push(`${k}=${v}`);
+    await Bun.write(join(targetDir, ".env"), envLines.join(`
+`) + `
+`);
+    if (genDocker) {
+      const dockerfile = `FROM oven/bun:latest
+WORKDIR /app
+RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg python3 && apt-get clean && rm -rf /var/lib/apt/lists/*
+COPY package.json bun.lockb* ./
+RUN bun install --production
+COPY . .
+USER bun
+HEALTHCHECK --interval=30s --timeout=5s CMD wget -qO- http://localhost:3000/health || exit 1
+CMD ["bun", "run", "start"]
+`;
+      await Bun.write(join(targetDir, "Dockerfile"), dockerfile);
+      await Bun.write(join(targetDir, "docker-compose.yml"), `version: '3.8'
+services:
+  bot:
+    build: .
+    env_file: .env
+    restart: unless-stopped
+`);
+    }
+    const builtinImport = plugins.length > 0 ? `import { popiiClient, ${plugins.join(", ")} } from "popii";` : `import { popiiClient } from "popii";`;
+    const communityImportLines = communityPlugins.map((cp) => `import { ${cp.exportName} } from "${cp.npmName}";`).join(`
+`);
+    const imports = communityImportLines ? `${builtinImport}
+${communityImportLines}` : builtinImport;
+    const pluginInit = [
+      ...plugins.map((p) => {
+        const cfg = pluginConfig?.[p] ?? {};
+        const opts2 = buildPluginOptionsStr(p, cfg);
+        return `    ${p}(${opts2 ? `{ ${opts2} }` : ""}),`;
+      }),
+      ...communityPlugins.map((cp) => `    ${cp.exportName}({ /* options */ }),`)
+    ].join(`
+`);
+    const indexTs = `${imports}
+
+const client = popiiClient({
+  token: process.env.DISCORD_TOKEN || "",
+  prefix: "!",
+  owners: [],
+  plugins: [
+${pluginInit}
+  ]
+});
+
+client.start().then(() => console.log("Bot is online!")).catch(console.error);
+
+process.on("SIGINT", async () => {
+  console.log("\\nShutting down...");
+  await client.stop();
+  process.exit(0);
+});
+`;
+    await Bun.write(join(targetDir, "src", "index.ts"), indexTs);
+    const pingTs = `import { command } from "popii";
+
+export default command({
+  name: "ping",
+  description: "Replies with pong!",
+  slash: true,
+  text: true,
+  async do(pop) {
+    await pop.reply(\`Pong! Latency: \${pop.client.discord.ws.ping}ms\`);
+  }
+});
+`;
+    await Bun.write(join(targetDir, "src", "commands", "ping.ts"), pingTs);
+    if (installDeps) {
+      const proc = Bun.spawn(["bun", "install"], { cwd: targetDir, stdout: "ignore", stderr: "pipe" });
+      const exitCode = await proc.exited;
+      if (exitCode !== 0) {
+        const errText = await new Response(proc.stderr).text();
+        throw new Error(`bun install failed:
+${errText}`);
+      }
+    }
+  } catch (err) {
+    await rm(targetDir, { recursive: true, force: true });
+    throw err;
+  }
+}
+
+// src/cli/pages.ts
+function openBrowser(url) {
+  if (process.platform === "win32")
+    Bun.spawn(["cmd", "/c", "start", "", url]);
+  else if (process.platform === "darwin")
+    Bun.spawn(["open", url]);
+  else
+    Bun.spawn(["xdg-open", url]);
+}
+function setupPageHtml() {
+  const pluginDefs = [
+    ["uiPlugin", "UI", ".paginate(), .prompt(), .form()"],
+    ["sqlitePlugin", "SQLite", "Bun SQLite database in context"],
+    ["errorHandlerPlugin", "Error Handler", "Catches PopiiErrors gracefully"],
+    ["commandLoggerPlugin", "Command Logger", "Logs command executions"],
+    ["commandAnalyticPlugin", "Analytics", "Tracks command usage stats"],
+    ["permissionGuardPlugin", "Permissions", "Enforces permissions automatically"],
+    ["reloadPlugin", "Hot Reload", "Adds a /reload command"],
+    ["webPlugin", "Web Server", "/health and /metrics endpoints"],
+    ["telemetryPlugin", "Telemetry", "Performance monitoring"],
+    ["voicePlugin", "Voice", "Voice channel support"],
+    ["mongoosePlugin", "Mongoose", "MongoDB via Mongoose ODM"],
+    ["deskPlugin", "Desk", "Support ticket system"],
+    ["popiiAiPlugin", "AI", "Claude AI integration"],
+    ["payPlugin", "Pay", "Payment processing"],
+    ["autoModPlugin", "AutoMod", "Automated moderation"],
+    ["economyPlugin", "Economy", "Virtual currency system"],
+    ["giveawayPlugin", "Giveaway", "Run giveaways in channels"],
+    ["activityRotatorPlugin", "Activity Rotator", "Rotates bot status messages"],
+    ["captchaPlugin", "Captcha", "Verification captchas"],
+    ["canvasPlugin", "Canvas", "Image generation"],
+    ["lastFmPlugin", "Last.fm", "Last.fm music integration"]
+  ];
+  const pluginCards = pluginDefs.map(([value, name, desc]) => `
+        <div class="plugin-card" onclick="toggleCard(this)">
+          <input type="checkbox" name="plugins" value="${value}">
+          <div class="check-box"><svg width="10" height="8" viewBox="0 0 10 8" fill="none"><path d="M1 4L3.5 6.5L9 1" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg></div>
+          <div class="plugin-info"><div class="name">${name}</div><div class="desc">${desc}</div></div>
+        </div>`).join("");
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Popii Setup</title>
+  <style>
+    :root {
+      color-scheme: dark;
+      --accent: #F04F96; --accent-glow: rgba(240,79,150,0.45); --accent-light: #FF80BA;
+      --bg-dark: #0D0610; --bg-mid: #1a0920; --bg-light: #2a1030;
+      --card-bg: rgba(220,80,140,0.055); --card-border: rgba(240,79,150,0.12);
+      --card-highlight: rgba(255,160,200,0.08); --text-main: #fdf0f6;
+      --text-muted: rgba(255,195,220,0.6);
+    }
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      background: radial-gradient(ellipse 80% 60% at 15% 10%, var(--bg-light), transparent),
+                  radial-gradient(ellipse 55% 45% at 85% 90%, #200d2e, transparent),
+                  var(--bg-dark);
+      background-attachment: fixed;
+      color: var(--text-main);
+      font-family: 'Inter', system-ui, -apple-system, sans-serif;
+      min-height: 100vh;
+      display: flex; flex-direction: column; align-items: center;
+      padding: 3.5rem 1rem 5rem;
+    }
+    header { text-align: center; margin-bottom: 2.5rem; }
+    header h1 {
+      font-size: 2.8rem; font-weight: 800; letter-spacing: -0.05em;
+      background: linear-gradient(135deg, var(--accent), var(--accent-light));
+      -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text;
+      margin-bottom: 0.4rem;
+    }
+    header p { color: var(--text-muted); font-size: 1rem; }
+    form, #success { width: 100%; max-width: 580px; }
+    form { display: flex; flex-direction: column; gap: 1.75rem; }
+    .field { display: flex; flex-direction: column; gap: 0.5rem; }
+    .field > label { font-weight: 600; font-size: 0.9rem; }
+    .hint { color: var(--text-muted); font-weight: 400; margin-left: 0.35rem; }
+    input[type="text"], input[type="password"] {
+      background: rgba(255,255,255,0.04); border: 1px solid var(--card-border);
+      border-radius: 12px; color: var(--text-main); font-family: inherit;
+      font-size: 1rem; padding: 0.75rem 1rem; outline: none; width: 100%;
+      transition: border-color 0.2s, box-shadow 0.2s;
+    }
+    input[type="text"]:focus, input[type="password"]:focus {
+      border-color: var(--accent); box-shadow: 0 0 0 3px rgba(240,79,150,0.2);
+    }
+    .token-wrap { position: relative; }
+    .token-wrap input { padding-right: 3rem; }
+    .token-toggle {
+      position: absolute; right: 0.75rem; top: 50%; transform: translateY(-50%);
+      background: none; border: none; color: var(--text-muted); cursor: pointer; padding: 0.25rem;
+    }
+    .plugins-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 0.6rem; max-height: 380px; overflow-y: auto; padding-right: 4px; }
+    .plugins-grid::-webkit-scrollbar { width: 4px; }
+    .plugins-grid::-webkit-scrollbar-track { background: transparent; }
+    .plugins-grid::-webkit-scrollbar-thumb { background: var(--card-border); border-radius: 4px; }
+    .plugin-card, .opt-card {
+      background: var(--card-bg); border: 1px solid var(--card-border);
+      border-radius: 14px; padding: 0.85rem 1rem; cursor: pointer;
+      transition: all 0.15s; display: flex; align-items: flex-start; gap: 0.65rem;
+      user-select: none;
+    }
+    .plugin-card:hover, .opt-card:hover { border-color: rgba(240,79,150,0.3); background: rgba(240,79,150,0.07); }
+    .plugin-card.selected, .opt-card.selected {
+      border-color: var(--accent); background: rgba(240,79,150,0.12);
+      box-shadow: 0 0 0 1px rgba(240,79,150,0.2);
+    }
+    .plugin-card input, .opt-card input { display: none; }
+    .check-box {
+      width: 18px; height: 18px; border-radius: 5px; border: 2px solid var(--card-border);
+      flex-shrink: 0; margin-top: 1px; display: flex; align-items: center; justify-content: center;
+      transition: all 0.15s;
+    }
+    .plugin-card.selected .check-box, .opt-card.selected .check-box {
+      background: var(--accent); border-color: var(--accent);
+    }
+    .check-box svg { display: none; }
+    .plugin-card.selected .check-box svg, .opt-card.selected .check-box svg { display: block; }
+    .plugin-info .name, .opt-info .name { font-weight: 600; font-size: 0.88rem; }
+    .plugin-info .desc, .opt-info .desc { color: var(--text-muted); font-size: 0.77rem; margin-top: 0.2rem; line-height: 1.3; }
+    .opts-row { display: flex; gap: 0.75rem; }
+    .opt-card { flex: 1; align-items: center; }
+    .opt-card .check-box { margin-top: 0; }
+    .submit-btn {
+      width: 100%; background: linear-gradient(135deg, var(--accent), var(--accent-light));
+      color: #fff; border: none; border-radius: 14px; padding: 0.9rem;
+      font-size: 1rem; font-weight: 700; font-family: inherit; cursor: pointer;
+      transition: all 0.2s; box-shadow: 0 6px 20px rgba(240,79,150,0.35); letter-spacing: 0.01em;
+    }
+    .submit-btn:hover:not(:disabled) { box-shadow: 0 8px 28px rgba(240,79,150,0.5); transform: translateY(-2px); }
+    .submit-btn:disabled { opacity: 0.6; cursor: not-allowed; }
+    .field-error { color: #ED4245; font-size: 0.83rem; padding-top: 0.25rem; min-height: 1.1rem; }
+    .creating { text-align: center; padding: 3rem 0; }
+    .spinner { width: 40px; height: 40px; border: 3px solid var(--card-border); border-top-color: var(--accent); border-radius: 50%; animation: spin 0.8s linear infinite; margin: 0 auto 1rem; }
+    @keyframes spin { to { transform: rotate(360deg); } }
+    .config-group { background: var(--card-bg); border: 1px solid var(--card-border); border-radius: 14px; padding: 1rem 1.25rem; margin-bottom: 0.65rem; }
+    .config-group:last-child { margin-bottom: 0; }
+    .config-group-label { font-weight: 700; font-size: 0.78rem; color: var(--accent-light); text-transform: uppercase; letter-spacing: 0.07em; margin-bottom: 0.75rem; }
+    .config-fields { display: flex; flex-direction: column; gap: 0.6rem; }
+    .config-field { display: flex; flex-direction: column; gap: 0.3rem; }
+    .config-field > label { font-size: 0.83rem; font-weight: 500; }
+    .config-input, .config-select { background: rgba(255,255,255,0.04); border: 1px solid var(--card-border); border-radius: 8px; color: var(--text-main); font-family: inherit; font-size: 0.88rem; padding: 0.5rem 0.75rem; outline: none; width: 100%; transition: border-color 0.2s; }
+    .config-input:focus, .config-select:focus { border-color: var(--accent); box-shadow: 0 0 0 2px rgba(240,79,150,0.15); }
+    .config-select option { background: var(--bg-dark); }
+    .config-check-label { display: flex; align-items: center; gap: 0.5rem; cursor: pointer; font-size: 0.83rem; font-weight: 500; }
+    .config-check-label input[type="checkbox"] { display: revert; accent-color: var(--accent); width: 15px; height: 15px; cursor: pointer; }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>popii</h1>
+    <p>Let's set up your new bot</p>
+  </header>
+
+  <form id="setup-form">
+    <div class="field">
+      <label for="bot-name">Bot name<span class="hint">— used as the project folder name</span></label>
+      <input type="text" id="bot-name" placeholder="my-popii-bot" autocomplete="off" spellcheck="false">
+      <div class="field-error" id="name-error"></div>
+    </div>
+
+    <div class="field">
+      <label>Plugins<span class="hint">— optional, can be added later</span></label>
+      <div class="plugins-grid">${pluginCards}
+      </div>
+    </div>
+
+    <div class="field" id="community-section" style="display:none">
+      <label>Community plugins<span class="hint">— from the Popii registry</span></label>
+      <div id="community-loading" style="color:var(--text-muted);font-size:0.85rem;padding:0.5rem 0">Loading registry...</div>
+      <div class="plugins-grid" id="community-grid"></div>
+    </div>
+
+    <div class="field" id="plugin-config-section" style="display:none">
+      <label>Plugin configuration<span class="hint">— can be changed in src/index.ts and .env later</span></label>
+      <div id="plugin-config-container"></div>
+    </div>
+
+    <div class="field">
+      <label for="bot-token">Discord bot token<span class="hint">— leave blank to add later</span></label>
+      <div class="token-wrap">
+        <input type="password" id="bot-token" placeholder="MTAx..." autocomplete="off" spellcheck="false">
+        <button type="button" class="token-toggle" id="token-toggle" title="Show/hide token">
+          <svg id="eye-icon" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/>
+          </svg>
+        </button>
+      </div>
+    </div>
+
+    <div class="field">
+      <label>Options</label>
+      <div class="opts-row">
+        <div class="opt-card selected" onclick="toggleCard(this)">
+          <input type="checkbox" id="install-deps" checked>
+          <div class="check-box"><svg width="10" height="8" viewBox="0 0 10 8" fill="none"><path d="M1 4L3.5 6.5L9 1" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg></div>
+          <div class="opt-info"><div class="name">Install deps</div><div class="desc">Run bun install</div></div>
+        </div>
+        <div class="opt-card" onclick="toggleCard(this)">
+          <input type="checkbox" id="gen-docker">
+          <div class="check-box"><svg width="10" height="8" viewBox="0 0 10 8" fill="none"><path d="M1 4L3.5 6.5L9 1" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg></div>
+          <div class="opt-info"><div class="name">Docker files</div><div class="desc">Dockerfile + compose</div></div>
+        </div>
+      </div>
+    </div>
+
+    <div>
+      <button type="submit" class="submit-btn" id="submit-btn">Create bot project</button>
+      <div class="field-error" id="submit-error"></div>
+    </div>
+  </form>
+
+  <div id="creating" class="creating" style="display:none">
+    <div class="spinner"></div>
+    <p style="color:var(--text-muted)">Creating your project…</p>
+  </div>
+
+  <script>
+    var PLUGIN_CONFIG_SCHEMA = {
+      webPlugin: { label: 'Web Server', fields: [
+        { key: 'port', label: 'Port', type: 'number', default: '3000' },
+        { key: 'publicUrl', label: 'Public URL', type: 'text', placeholder: 'https://bot.example.com' },
+        { key: 'dashboard', label: 'Enable dashboard', type: 'checkbox' },
+        { key: 'dashboardPassword', label: 'Dashboard password', type: 'password', showIf: 'dashboard' },
+        { key: 'oauth2.clientId', label: 'Client ID', type: 'text', showIf: 'dashboard', hint: 'Developer Portal → OAuth2' },
+        { key: 'oauth2.clientSecret', label: 'Client secret', type: 'password', showIf: 'dashboard' },
+        { key: 'oauth2.redirectUri', label: 'Redirect URI', type: 'text', showIf: 'dashboard' },
+      ]},
+      mongoosePlugin: { label: 'Mongoose', fields: [
+        { key: 'uri', label: 'MongoDB URI', type: 'text', placeholder: 'mongodb://localhost:27017/mybot' },
+      ]},
+      sqlitePlugin: { label: 'SQLite', fields: [
+        { key: 'filename', label: 'Database filename', type: 'text', default: 'db.sqlite' },
+      ]},
+      popiiAiPlugin: { label: 'AI', fields: [
+        { key: 'provider', label: 'Provider', type: 'select', options: ['anthropic', 'openai', 'gemini'] },
+        { key: 'apiKey', label: 'API Key', type: 'password' },
+        { key: 'model', label: 'Model (optional)', type: 'text' },
+      ]},
+      commandLoggerPlugin: { label: 'Command Logger', fields: [
+        { key: 'logExecution', label: 'Log execution', type: 'checkbox' },
+        { key: 'logCompletion', label: 'Log completion', type: 'checkbox' },
+        { key: 'logErrors', label: 'Log errors', type: 'checkbox', default: true },
+      ]},
+      economyPlugin: { label: 'Economy', fields: [
+        { key: 'currencyName', label: 'Currency name', type: 'text', default: 'Coins' },
+        { key: 'cooldownMs', label: 'Daily cooldown (ms)', type: 'number', default: '60000' },
+      ]},
+      captchaPlugin: { label: 'Captcha', fields: [
+        { key: 'siteKey', label: 'hCaptcha site key', type: 'text', hint: 'dashboard.hcaptcha.com' },
+        { key: 'secretKey', label: 'hCaptcha secret key', type: 'password' },
+        { key: 'port', label: 'Verification server port', type: 'number', default: '3001' },
+        { key: 'publicUrl', label: 'Public URL (optional)', type: 'text', placeholder: 'https://verify.example.com' },
+      ]},
+      activityRotatorPlugin: { label: 'Activity Rotator', fields: [
+        { key: 'intervalMs', label: 'Rotation interval (ms)', type: 'number', default: '60000' },
+        { key: 'activity.name', label: 'Status text', type: 'text', default: 'with popii' },
+        { key: 'activity.type', label: 'Activity type', type: 'select', options: ['Playing', 'Listening', 'Watching', 'Competing', 'Streaming'] },
+      ]},
+      payPlugin: { label: 'Pay', fields: [
+        { key: 'patreon.enabled', label: 'Enable Patreon', type: 'checkbox' },
+        { key: 'patreon.webhookSecret', label: 'Patreon webhook secret', type: 'password', showIf: 'patreon.enabled' },
+        { key: 'patreon.port', label: 'Patreon webhook port', type: 'number', default: '8080', showIf: 'patreon.enabled' },
+        { key: 'kofi.enabled', label: 'Enable Ko-fi', type: 'checkbox' },
+        { key: 'kofi.verificationToken', label: 'Ko-fi verification token', type: 'password', showIf: 'kofi.enabled' },
+        { key: 'kofi.port', label: 'Ko-fi webhook port', type: 'number', default: '8081', showIf: 'kofi.enabled' },
+      ]},
+    };
+
+    var communityConfigCache = {};
+
+    function renderConfigField(namePrefix, field) {
+      var name = namePrefix + '[' + field.key + ']';
+      var showIf = field.showIf ? ' data-show-if="' + field.showIf + '"' : '';
+      var hide = field.showIf ? ' style="display:none"' : '';
+      if (field.type === 'checkbox') {
+        var chk = field.default ? ' checked' : '';
+        return '<div class="config-field"' + showIf + hide + '><label class="config-check-label"><input type="checkbox" name="' + name + '" value="true"' + chk + '><span>' + field.label + '</span></label></div>';
+      }
+      if (field.type === 'select') {
+        var opts = (field.options || []).map(function(o) { return '<option value="' + o + '">' + o + '</option>'; }).join('');
+        return '<div class="config-field"' + showIf + hide + '><label>' + field.label + '</label><select name="' + name + '" class="config-select">' + opts + '</select></div>';
+      }
+      var hint = field.hint ? '<span class="hint"> — ' + field.hint + '</span>' : '';
+      var ph = field.placeholder ? ' placeholder="' + field.placeholder + '"' : '';
+      var val = field.default ? ' value="' + field.default + '"' : '';
+      return '<div class="config-field"' + showIf + hide + '><label>' + field.label + hint + '</label><input type="' + (field.type || 'text') + '" name="' + name + '" class="config-input"' + ph + val + '></div>';
+    }
+
+    function wireShowIf(group, namePrefix) {
+      group.querySelectorAll('[data-show-if]').forEach(function(el) {
+        var cb = group.querySelector('input[name="' + namePrefix + '[' + el.getAttribute('data-show-if') + ']"]');
+        if (!cb) return;
+        function update() { el.style.display = cb.checked ? '' : 'none'; }
+        cb.addEventListener('change', update);
+        update();
+      });
+    }
+
+    function addBuiltinConfigGroup(pluginName) {
+      var schema = PLUGIN_CONFIG_SCHEMA[pluginName];
+      if (!schema) return;
+      var container = document.getElementById('plugin-config-container');
+      if (container.querySelector('[data-plugin="' + pluginName + '"]')) return;
+      var prefix = 'pluginConfig[' + pluginName + ']';
+      var html = schema.fields.map(function(f) { return renderConfigField(prefix, f); }).join('');
+      var group = document.createElement('div');
+      group.className = 'config-group';
+      group.dataset.plugin = pluginName;
+      group.innerHTML = '<div class="config-group-label">' + schema.label + '</div><div class="config-fields">' + html + '</div>';
+      container.appendChild(group);
+      wireShowIf(group, prefix);
+      updateConfigSectionVisibility();
+    }
+
+    function removeConfigGroup(key) {
+      var el = document.querySelector('#plugin-config-container [data-plugin="' + key + '"]');
+      if (el) { el.remove(); updateConfigSectionVisibility(); }
+    }
+
+    function updateConfigSectionVisibility() {
+      var c = document.getElementById('plugin-config-container');
+      document.getElementById('plugin-config-section').style.display = c.children.length ? '' : 'none';
+    }
+
+    async function fetchCommunityPluginConfig(npmName) {
+      var key = 'community:' + npmName;
+      var container = document.getElementById('plugin-config-container');
+      if (container.querySelector('[data-plugin="' + key + '"]')) return;
+      if (!(npmName in communityConfigCache)) {
+        try {
+          var r = await fetch('https://registry.npmjs.org/' + encodeURIComponent(npmName) + '/latest');
+          communityConfigCache[npmName] = r.ok ? (((await r.json()).popii) || {}).configSchema || null : null;
+        } catch(e) { communityConfigCache[npmName] = null; }
+      }
+      var schema = communityConfigCache[npmName];
+      if (!schema) return;
+      var envFields = Object.entries(schema).filter(function(e) { return e[1] && e[1].env; });
+      if (!envFields.length) return;
+      var prefix = 'communityPluginConfig[' + npmName + ']';
+      var html = envFields.map(function(entry) {
+        var envKey = entry[0], spec = entry[1];
+        return renderConfigField(prefix, { key: envKey, label: spec.label || envKey, type: spec.secret ? 'password' : 'text', placeholder: spec.placeholder || '', default: spec.default != null ? String(spec.default) : '' });
+      }).join('');
+      var group = document.createElement('div');
+      group.className = 'config-group';
+      group.dataset.plugin = key;
+      group.innerHTML = '<div class="config-group-label">' + npmName.replace('popii-plugin-', '') + '</div><div class="config-fields">' + html + '</div>';
+      container.appendChild(group);
+      updateConfigSectionVisibility();
+    }
+
+    function collectPluginConfig() {
+      var pluginConfig = {}, communityPluginConfig = {};
+      document.querySelectorAll('#plugin-config-container .config-group').forEach(function(group) {
+        var plugin = group.dataset.plugin;
+        var isCommunity = plugin.startsWith('community:');
+        var cfg = {};
+        group.querySelectorAll('input[name], select[name]').forEach(function(el) {
+          var lastOpen = el.name.lastIndexOf('[');
+          var lastClose = el.name.lastIndexOf(']');
+          if (lastOpen === -1 || lastClose === -1) return;
+          var k = el.name.slice(lastOpen + 1, lastClose);
+          cfg[k] = el.type === 'checkbox' ? (el.checked ? 'true' : 'false') : el.value;
+        });
+        if (isCommunity) communityPluginConfig[plugin.slice(10)] = cfg;
+        else pluginConfig[plugin] = cfg;
+      });
+      return { pluginConfig: pluginConfig, communityPluginConfig: communityPluginConfig };
+    }
+
+    function toggleCard(card) {
+      var cb = card.querySelector('input[type="checkbox"]');
+      cb.checked = !cb.checked;
+      card.classList.toggle('selected', cb.checked);
+      if (cb.name === 'plugins') {
+        if (cb.checked) addBuiltinConfigGroup(cb.value);
+        else removeConfigGroup(cb.value);
+      } else if (cb.name === 'community-plugins') {
+        var npm = cb.value.split(':')[0];
+        if (cb.checked) fetchCommunityPluginConfig(npm);
+        else removeConfigGroup('community:' + npm);
+      }
+    }
+
+    var tokenInput = document.getElementById('bot-token');
+    document.getElementById('token-toggle').addEventListener('click', function() {
+      var show = tokenInput.type === 'password';
+      tokenInput.type = show ? 'text' : 'password';
+      document.getElementById('eye-icon').innerHTML = show
+        ? '<path d="M17.94 17.94A10.07 10.07 0 0 1 12 20c-7 0-11-8-11-8a18.45 18.45 0 0 1 5.06-5.94M9.9 4.24A9.12 9.12 0 0 1 12 4c7 0 11 8 11 8a18.5 18.5 0 0 1-2.16 3.19m-6.72-1.07a3 3 0 1 1-4.24-4.24"></path><line x1="1" y1="1" x2="23" y2="23"></line>'
+        : '<path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/>';
+    });
+
+    document.getElementById('setup-form').addEventListener('submit', async function(e) {
+      e.preventDefault();
+      var name = document.getElementById('bot-name').value.trim();
+      var nameErr = document.getElementById('name-error');
+      var submitErr = document.getElementById('submit-error');
+      var btn = document.getElementById('submit-btn');
+      nameErr.textContent = '';
+      submitErr.textContent = '';
+
+      if (!name) { nameErr.textContent = 'Name is required.'; return; }
+      if (name.toLowerCase() === 'popii') { nameErr.textContent = "Cannot be named 'popii' — causes a dependency loop."; return; }
+
+      var plugins = Array.from(document.querySelectorAll('input[name="plugins"]:checked')).map(function(el) { return el.value; });
+      var communityPlugins = Array.from(document.querySelectorAll('input[name="community-plugins"]:checked')).map(function(el) {
+        var parts = el.value.split(':');
+        return { npmName: parts[0], exportName: parts[1] };
+      });
+      var cfg = collectPluginConfig();
+      var body = {
+        botName: name,
+        plugins: plugins,
+        communityPlugins: communityPlugins,
+        botToken: document.getElementById('bot-token').value.trim(),
+        installDeps: document.getElementById('install-deps').checked,
+        genDocker: document.getElementById('gen-docker').checked,
+        pluginConfig: cfg.pluginConfig,
+        communityPluginConfig: cfg.communityPluginConfig,
+      };
+
+      btn.disabled = true;
+      document.getElementById('setup-form').style.display = 'none';
+      document.getElementById('creating').style.display = 'block';
+
+      try {
+        var res = await fetch('/setup', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+        if (!res.ok) throw new Error(await res.text());
+        window.location.href = '/done?name=' + encodeURIComponent(name);
+      } catch(err) {
+        document.getElementById('setup-form').style.display = 'flex';
+        document.getElementById('creating').style.display = 'none';
+        btn.disabled = false;
+        submitErr.textContent = 'Setup failed: ' + (err.message || err);
+      }
+    });
+    var CHECK_SVG = '<svg width="10" height="8" viewBox="0 0 10 8" fill="none"><path d="M1 4L3.5 6.5L9 1" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg>';
+    var REGISTRY_URL = 'https://raw.githubusercontent.com/popii-dev/registry/main/plugins.json';
+
+    async function loadCommunityPlugins() {
+      var section = document.getElementById('community-section');
+      var grid = document.getElementById('community-grid');
+      var loading = document.getElementById('community-loading');
+      try {
+        var res = await fetch(REGISTRY_URL);
+        if (!res.ok) throw new Error('unavailable');
+        var data = await res.json();
+        var plugins = (data.plugins || []).filter(function(p) { return p.npm && p.displayName; });
+        loading.style.display = 'none';
+        if (plugins.length === 0) return;
+        for (var i = 0; i < plugins.length; i++) {
+          var p = plugins[i];
+          var exportName = p.export || (p.npm.replace('popii-plugin-', '').replace(/-([a-z])/g, function(_, c) { return c.toUpperCase(); }) + 'Plugin');
+          var card = document.createElement('div');
+          card.className = 'plugin-card';
+          card.onclick = (function(c) { return function() { toggleCard(c); }; })(card);
+          var badge = p.verified ? ' <span style="color:var(--accent);font-size:0.72rem;font-weight:700;">✓</span>' : '';
+          card.innerHTML = '<input type="checkbox" name="community-plugins" value="' + p.npm + ':' + exportName + '">' +
+            '<div class="check-box">' + CHECK_SVG + '</div>' +
+            '<div class="plugin-info"><div class="name">' + p.displayName + badge + '</div><div class="desc">' + (p.description || '') + '</div></div>';
+          grid.appendChild(card);
+        }
+        section.style.display = '';
+      } catch (e) {
+        section.style.display = 'none';
+      }
+    }
+
+    loadCommunityPlugins();
+  </script>
+</body>
+</html>`;
+}
+function donePageHtml(botName) {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${botName} is ready!</title>
+  <style>
+    :root { color-scheme: dark; --accent: #F04F96; --accent-light: #FF80BA; --bg-dark: #0D0610; --bg-light: #2a1030; --card-bg: rgba(220,80,140,0.055); --card-border: rgba(240,79,150,0.12); --text-main: #fdf0f6; --text-muted: rgba(255,195,220,0.6); }
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body { background: radial-gradient(ellipse 80% 60% at 15% 10%, var(--bg-light), transparent), var(--bg-dark); min-height: 100vh; display: flex; flex-direction: column; align-items: center; justify-content: center; font-family: 'Inter', system-ui, sans-serif; color: var(--text-main); padding: 2rem; }
+    .card { background: var(--card-bg); border: 1px solid var(--card-border); border-radius: 24px; padding: 3rem 2.5rem; text-align: center; max-width: 480px; width: 100%; }
+    .icon { font-size: 3.5rem; margin-bottom: 1.25rem; }
+    h1 { font-size: 1.8rem; font-weight: 800; margin-bottom: 0.5rem; }
+    .sub { color: var(--text-muted); margin-bottom: 2rem; }
+    pre { background: rgba(0,0,0,0.35); border: 1px solid var(--card-border); border-radius: 12px; padding: 1rem 1.25rem; font-size: 0.95rem; color: var(--accent-light); font-family: monospace; line-height: 1.7; text-align: left; white-space: pre; }
+    .note { color: var(--text-muted); font-size: 0.82rem; margin-top: 1.5rem; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="icon">✨</div>
+    <h1>${botName} is ready!</h1>
+    <p class="sub">Your project has been scaffolded. Get started:</p>
+    <pre>cd ${botName}
+bun run dev</pre>
+    <p class="note">This window can be closed.</p>
+  </div>
+</body>
+</html>`;
+}
+async function initViaWeb() {
+  return new Promise((resolve) => {
+    const server = Bun.serve({
+      port: 0,
+      async fetch(req) {
+        const url = new URL(req.url);
+        if (url.pathname === "/" && req.method === "GET") {
+          return new Response(setupPageHtml(), { headers: { "Content-Type": "text/html; charset=utf-8" } });
+        }
+        if (url.pathname === "/setup" && req.method === "POST") {
+          try {
+            const body = await req.json();
+            await scaffoldProject(body);
+            return new Response(JSON.stringify({ ok: true }), { headers: { "Content-Type": "application/json" } });
+          } catch (err) {
+            console.error(`
+  Setup error:`, err?.message ?? err);
+            return new Response(err?.message ?? "Setup failed", { status: 500 });
+          }
+        }
+        if (url.pathname === "/done" && req.method === "GET") {
+          const name = url.searchParams.get("name") ?? "your-bot";
+          setTimeout(() => {
+            server.stop();
+            resolve();
+          }, 3000);
+          return new Response(donePageHtml(name), { headers: { "Content-Type": "text/html; charset=utf-8" } });
+        }
+        return new Response("Not found", { status: 404 });
+      }
+    });
+    console.log(`
+  Opening setup page → http://localhost:${server.port}`);
+    console.log(`  Paste that URL manually if your browser doesn't open.
+`);
+    openBrowser(`http://localhost:${server.port}`);
+  });
+}
+
+// src/cli/commands.ts
+async function runDev(args) {
+  console.log("Starting Popii in dev mode with HMR enabled...");
+  globalThis.__POPII_DEV_REGISTER = (client) => {
+    const watchDir = (dir, callback) => {
+      if (existsSync(dir)) {
+        let timeout;
+        watch(dir, { recursive: true }, () => {
+          clearTimeout(timeout);
+          timeout = setTimeout(callback, 200);
+        });
+      }
+    };
+    const reload = () => client.reload().catch(console.error);
+    watchDir(client.config.commands?.dir ?? "./src/commands", reload);
+    watchDir(client.config.snaps?.dir ?? "./src/snaps", reload);
+    watchDir(client.config.middlewares?.dir ?? "./src/middlewares", reload);
+    watchDir(client.config.events?.dir ?? "./src/events", reload);
+    watchDir(client.config.tasks?.dir ?? "./src/tasks", reload);
+  };
+  const entryFile = args[1] || join2("src", "index.ts");
+  await import(pathToFileURL(join2(process.cwd(), entryFile)).href);
+}
+async function runSync(args) {
+  console.log("\uD83D\uDD04 Syncing Popii commands to Discord...");
+  globalThis.__POPII_SYNC_REGISTER = (client) => {
+    client.__syncOnly = true;
+  };
+  const entryFile = args[1] || join2("src", "index.ts");
+  await import(pathToFileURL(join2(process.cwd(), entryFile)).href);
+}
+async function runConsole(args) {
+  console.log("Starting Popii Interactive Console...");
+  globalThis.__POPII_DEV_REGISTER = (client) => {
+    client.discord.once("ready", () => {
+      const repl = __require("node:repl");
+      console.log(`
+[Popii Console] Bot is ready! 'client', 'popii', and 'discord' are available in scope.`);
+      const r = repl.start("popii> ");
+      r.context.client = client;
+      r.context.popii = client;
+      r.context.discord = client.discord;
+    });
+  };
+  const entryFile = args[1] || join2("src", "index.ts");
+  await import(pathToFileURL(join2(process.cwd(), entryFile)).href);
+}
+async function runMigrate(args) {
+  const action = args[1];
+  const fs = __require("node:fs");
+  const path = __require("node:path");
+  const migrationsDir = path.join(process.cwd(), "migrations");
+  if (!fs.existsSync(migrationsDir))
+    fs.mkdirSync(migrationsDir);
+  if (action === "create") {
+    const name = args[2] || "migration";
+    const timestamp = Date.now();
+    const filename = `${timestamp}-${name}.sql`;
+    fs.writeFileSync(path.join(migrationsDir, filename), `-- Write your SQL migration here
+`);
+    console.log(`✅ Created migration: migrations/${filename}`);
+    return;
+  } else if (action === "up") {
+    const { Database } = __require("bun:sqlite");
+    const db = new Database("popii.db");
+    db.exec("CREATE TABLE IF NOT EXISTS migrations (filename TEXT PRIMARY KEY, run_at INTEGER);");
+    const files = fs.readdirSync(migrationsDir).filter((f) => f.endsWith(".sql")).sort();
+    let count = 0;
+    for (const file of files) {
+      const exists = db.query("SELECT filename FROM migrations WHERE filename = ?").get(file);
+      if (!exists) {
+        console.log(`Running migration: ${file}...`);
+        const sql = fs.readFileSync(path.join(migrationsDir, file), "utf8");
+        try {
+          db.transaction(() => {
+            db.exec(sql);
+            db.query("INSERT INTO migrations (filename, run_at) VALUES (?, ?)").run(file, Date.now());
+          })();
+          count++;
+        } catch (e) {
+          console.error(`❌ Migration ${file} failed: ${e.message}`);
+          db.close();
+          process.exit(1);
+        }
+      }
+    }
+    console.log(`✅ Applied ${count} new migrations.`);
+    db.close();
+    return;
+  } else {
+    console.log("Usage: bunx popii migrate <create|up> [name]");
+  }
+}
+async function runInstall(args) {
+  const repoArg = args[1];
+  if (!repoArg || !repoArg.includes("/")) {
+    console.log("Usage: bunx popii install <user/repo[@tag]>");
+    process.exit(1);
+  }
+  const atIdx = repoArg.indexOf("@");
+  const repoPath = atIdx !== -1 ? repoArg.slice(0, atIdx) : repoArg;
+  const tag = atIdx !== -1 ? repoArg.slice(atIdx + 1) : "main";
+  const [user, name] = repoPath.split("/");
+  const baseUrl = `https://raw.githubusercontent.com/${user}/${name}/${tag}`;
+  const pluginUrl = `${baseUrl}/index.ts`;
+  const manifestUrl = `${baseUrl}/popii.plugin.json`;
+  let manifest = null;
+  try {
+    const mRes = await fetch(manifestUrl);
+    if (mRes.ok)
+      manifest = await mRes.json();
+  } catch {}
+  console.warn(`
+⚠️  WARNING: You are about to download and install code from an external source:`);
+  console.warn(`   ${pluginUrl}`);
+  if (manifest) {
+    console.log(`
+\uD83D\uDCE6 ${manifest.name ?? name} v${manifest.version ?? "?"}`);
+    if (manifest.description)
+      console.log(`   ${manifest.description}`);
+    if (manifest.requiredEnvVars?.length) {
+      console.log(`
+   Required env vars:`);
+      for (const v of manifest.requiredEnvVars)
+        console.log(`     • ${v}`);
+    }
+    if (manifest.conflicts?.length) {
+      console.log(`
+   Conflicts with: ${manifest.conflicts.join(", ")}`);
+    }
+  } else {
+    console.warn(`   No popii.plugin.json found — this plugin is unverified.`);
+  }
+  console.warn(`
+   Only install plugins from authors you trust.
+`);
+  const { confirm: confirmInstall, isCancel: isInstallCancel } = await import("@clack/prompts");
+  const ok = await confirmInstall({ message: "Proceed with installation?" });
+  if (isInstallCancel(ok) || !ok) {
+    console.log("Installation cancelled.");
+    process.exit(0);
+  }
+  const res = await fetch(pluginUrl);
+  if (!res.ok) {
+    console.error(`❌ Failed to download plugin from ${pluginUrl}`);
+    process.exit(1);
+  }
+  const dest = join2(process.cwd(), "src", "plugins", `${name}.ts`);
+  await mkdir2(dirname(dest), { recursive: true });
+  await Bun.write(dest, await res.text());
+  console.log(`✅ Installed plugin to ${dest}`);
+  if (manifest?.requiredEnvVars?.length) {
+    console.log(`
+\uD83D\uDCDD Add these to your .env file:`);
+    for (const v of manifest.requiredEnvVars)
+      console.log(`   ${v}=`);
+    console.log();
+  }
+}
+async function runAdd(args) {
+  const rawName = args[1];
+  if (!rawName) {
+    console.log("Usage: bunx popii add <plugin-name>");
+    process.exit(1);
+  }
+  const pkgName = rawName.includes("/") || rawName.startsWith("popii-plugin-") ? rawName : `popii-plugin-${rawName}`;
+  const s = spinner();
+  s.start(`Looking up ${pkgName} on npm...`);
+  let npmMeta = null;
+  let pkgVersion = "";
+  let pkgDescription = "";
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkgName)}/latest`);
+    if (res.ok) {
+      const data = await res.json();
+      npmMeta = data.popii ?? null;
+      pkgVersion = data.version ?? "";
+      pkgDescription = data.description ?? "";
+      s.stop(`Found ${pkgName}@${pkgVersion}`);
+      if (pkgDescription)
+        console.log(`  ${pkgDescription}`);
+      if (npmMeta?.category)
+        console.log(`  Category: ${npmMeta.category}`);
+      if (npmMeta?.requires?.length)
+        console.log(`  Requires: ${npmMeta.requires.join(", ")}`);
+    } else {
+      s.stop(`Package "${pkgName}" not found on npm.`);
+      process.exit(1);
+    }
+  } catch {
+    s.stop("Could not reach npm registry.");
+    process.exit(1);
+  }
+  if (!npmMeta) {
+    console.warn(`
+⚠️  This package has no "popii" field — it may not be a valid Popii plugin.
+`);
+    const ok = await confirm({ message: "Install anyway?" });
+    if (isCancel(ok) || !ok) {
+      console.log("Cancelled.");
+      process.exit(0);
+    }
+  }
+  const installS = spinner();
+  installS.start(`Installing ${pkgName}...`);
+  const proc = Bun.spawn(["bun", "add", pkgName], { cwd: process.cwd(), stdout: "ignore", stderr: "pipe" });
+  await proc.exited;
+  if (proc.exitCode !== 0) {
+    const errText = await new Response(proc.stderr).text();
+    installS.stop(`Failed to install ${pkgName}.`);
+    if (errText)
+      console.error(errText);
+    process.exit(1);
+  }
+  installS.stop(`Installed ${pkgName}!`);
+  if (npmMeta?.configSchema) {
+    const envFields = Object.entries(npmMeta.configSchema).filter(([, f]) => f.env);
+    if (envFields.length > 0) {
+      const envPath = join2(process.cwd(), ".env");
+      let envContent = existsSync(envPath) ? await Bun.file(envPath).text() : "";
+      let wrote = false;
+      console.log(`
+  Configure environment variables:`);
+      for (const [, field] of envFields) {
+        const envKey = field.env;
+        if (envContent.includes(`${envKey}=`))
+          continue;
+        const label = `${envKey}${field.required ? "" : " (optional)"}`;
+        const val = await text({ message: label, placeholder: field.default != null ? String(field.default) : "" });
+        if (!isCancel(val) && val !== "") {
+          envContent += `
+${envKey}=${val}`;
+          wrote = true;
+        }
+      }
+      if (wrote) {
+        await Bun.write(envPath, envContent.trimStart());
+        console.log("  Written to .env");
+      }
+    }
+  }
+  const exportName = npmMeta?.export ?? `${rawName.replace(/[-_]([a-z])/g, (_, c) => c.toUpperCase())}Plugin`;
+  console.log(`
+  Add to your bot:
+`);
+  console.log(`    import { ${exportName} } from "${pkgName}";`);
+  console.log(`    // plugins: [ ${exportName}({ /* options */ }) ]
+`);
+}
+async function runRemove(args) {
+  const rawName = args[1];
+  if (!rawName) {
+    console.log("Usage: bunx popii remove <plugin-name>");
+    process.exit(1);
+  }
+  const pkgName = rawName.includes("/") || rawName.startsWith("popii-plugin-") ? rawName : `popii-plugin-${rawName}`;
+  const s = spinner();
+  s.start(`Removing ${pkgName}...`);
+  const proc = Bun.spawn(["bun", "remove", pkgName], { cwd: process.cwd(), stdout: "ignore", stderr: "ignore" });
+  await proc.exited;
+  if (proc.exitCode === 0) {
+    s.stop(`Removed ${pkgName}.`);
+  } else {
+    s.stop(`Failed to remove ${pkgName}. Is it installed?`);
+    process.exit(1);
+  }
+}
+async function runSearch(args) {
+  const query = args.slice(1).join(" ");
+  if (!query) {
+    console.log("Usage: bunx popii search <query>");
+    process.exit(1);
+  }
+  const REGISTRY_URL = "https://raw.githubusercontent.com/popii-dev/registry/main/plugins.json";
+  const s = spinner();
+  s.start("Searching...");
+  const [npmResult, registryResult] = await Promise.allSettled([
+    fetch(`https://registry.npmjs.org/-/v1/search?text=keywords:popii-plugin+${encodeURIComponent(query)}&size=15`).then((r) => r.json()),
+    fetch(REGISTRY_URL).then((r) => r.json())
+  ]);
+  s.stop("");
+  const verified = new Set;
+  if (registryResult.status === "fulfilled") {
+    for (const p of registryResult.value.plugins ?? []) {
+      if (p.verified)
+        verified.add(p.npm);
+    }
+  }
+  if (npmResult.status !== "fulfilled") {
+    console.error("Could not reach npm registry.");
+    process.exit(1);
+  }
+  const objects = npmResult.value.objects ?? [];
+  if (objects.length === 0) {
+    console.log(`No plugins found for "${query}". Try a different keyword.`);
+    return;
+  }
+  console.log(`
+  Results for "${query}":
+`);
+  for (const { package: pkg } of objects) {
+    const badge = verified.has(pkg.name) ? " ✓" : "";
+    console.log(`  ${pkg.name}@${pkg.version}${badge}`);
+    if (pkg.description)
+      console.log(`    ${pkg.description}`);
+  }
+  console.log(`
+  Install: bunx popii add <name>
+`);
+}
+async function runList(args) {
+  const nmDir = join2(process.cwd(), "node_modules");
+  if (!existsSync(nmDir)) {
+    console.log("No node_modules found. Run bun install first.");
+    return;
+  }
+  const found = [];
+  const scanDir = (dir) => {
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (!entry.startsWith("popii-plugin-"))
+        continue;
+      const pkgJsonPath = join2(dir, entry, "package.json");
+      if (!existsSync(pkgJsonPath))
+        continue;
+      try {
+        const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+        if (!pkg.popii)
+          continue;
+        found.push({
+          name: pkg.name ?? entry,
+          version: pkg.version ?? "?",
+          description: pkg.description ?? pkg.popii?.displayName ?? ""
+        });
+      } catch {}
+    }
+  };
+  scanDir(nmDir);
+  for (const entry of readdirSync(nmDir)) {
+    if (entry.startsWith("@"))
+      scanDir(join2(nmDir, entry));
+  }
+  if (found.length === 0) {
+    console.log(`
+  No Popii plugins installed.
+  Run: bunx popii search <query>
+`);
+    return;
+  }
+  console.log(`
+  Installed Popii plugins:
+`);
+  for (const p of found) {
+    console.log(`  ${p.name}@${p.version}`);
+    if (p.description)
+      console.log(`    ${p.description}`);
+  }
+  console.log();
+}
+async function runGenerate(args) {
+  const type = args[1];
+  const name = args[2];
+  if (!type || !name) {
+    console.log("Usage: bunx popii g <command|event|snap|middleware|task|test> <name>");
+    process.exit(1);
+  }
+  if (type === "command") {
+    const path = join2(process.cwd(), "src", "commands", `${name}.ts`);
+    const content = `import { command } from "popii";
+
+export default command({
+  name: "${name.split("/").pop() ?? name}",
+  description: "Description for ${name}",
+  slash: true,
+  do(pop) {
+    pop.reply("Hello from ${name}!");
+  }
+});
+`;
+    await mkdir2(dirname(path), { recursive: true });
+    await Bun.write(path, content);
+    console.log(`✅ Created command: ${path}`);
+  } else if (type === "event") {
+    const path = join2(process.cwd(), "src", "events", `${name}.ts`);
+    const content = `import { event } from "popii";
+
+export default event<"${name}">(async (pop, ...args) => {
+  // Event logic here
+});
+`;
+    await mkdir2(dirname(path), { recursive: true });
+    await Bun.write(path, content);
+    console.log(`✅ Created event: ${path}`);
+  } else if (type === "snap") {
+    const path = join2(process.cwd(), "src", "snaps", `${name}.ts`);
+    const content = `import { snap } from "popii";
+
+export default snap({
+  customId: "${name}",
+  do(pop) {
+    pop.reply("Snap triggered!");
+  }
+});
+`;
+    await mkdir2(dirname(path), { recursive: true });
+    await Bun.write(path, content);
+    console.log(`✅ Created snap: ${path}`);
+  } else if (type === "middleware") {
+    const path = join2(process.cwd(), "src", "middlewares", `${name}.ts`);
+    const content = `import { middleware } from "popii";
+
+export default middleware(async (pop, next) => {
+  await next();
+});
+`;
+    await mkdir2(dirname(path), { recursive: true });
+    await Bun.write(path, content);
+    console.log(`✅ Created middleware: ${path}`);
+  } else if (type === "task") {
+    const path = join2(process.cwd(), "src", "tasks", `${name}.ts`);
+    const content = `import { task } from "popii";
+
+export default task({
+  name: "${name}",
+  schedule: "* * * * *",
+  async run(client, payload) {
+  }
+});
+`;
+    await mkdir2(dirname(path), { recursive: true });
+    await Bun.write(path, content);
+    console.log(`✅ Created task: ${path}`);
+  } else if (type === "test") {
+    const parts = name.split("/");
+    const prefix = "../".repeat(parts.length);
+    const commandPath = join2(process.cwd(), "src", "commands", `${name}.ts`);
+    const snapPath = join2(process.cwd(), "src", "snaps", `${name}.ts`);
+    const isSnap = !existsSync(commandPath) && existsSync(snapPath);
+    const label = parts[parts.length - 1];
+    const testPath = join2(process.cwd(), "test", `${name}.test.ts`);
+    let content;
+    if (isSnap) {
+      content = `import { describe, it, expect } from "bun:test";
+import { createMockPop } from "popii/testing";
+import snap from "${prefix}src/snaps/${name}";
+
+describe("${label} snap", () => {
+  it("replies when triggered", async () => {
+    const { pop, replies } = createMockPop();
+    await snap.do(pop as any);
+    expect(replies.length).toBeGreaterThan(0);
+  });
+});
+`;
+    } else {
+      content = `import { describe, it, expect } from "bun:test";
+import { createMockPop } from "popii/testing";
+import command from "${prefix}src/commands/${name}";
+
+describe("/${label}", () => {
+  it("replies when invoked", async () => {
+    const { pop, replies } = createMockPop();
+    await command.do(pop);
+    expect(replies.length).toBeGreaterThan(0);
+  });
+
+  it("handles options", async () => {
+    const { pop, replies } = createMockPop({
+      // strings: { name: "value" },
+      // integers: { amount: 5 },
+    });
+    await command.do(pop);
+    expect(replies.length).toBeGreaterThan(0);
+  });
+});
+`;
+    }
+    await mkdir2(dirname(testPath), { recursive: true });
+    await Bun.write(testPath, content);
+    console.log(`✅ Created test: ${testPath}`);
+  } else {
+    console.log(`Unknown generator type: ${type}`);
+  }
+}
+async function runDoctor(args) {
+  const fs = __require("node:fs");
+  const path = __require("node:path");
+  console.log(`
+\uD83E\uDE7A Popii Doctor — Checking your environment
+`);
+  let allOk = true;
+  const check = (label, ok, hint) => {
+    console.log(`  ${ok ? "✅" : "❌"} ${label}`);
+    if (!ok && hint)
+      console.log(`     → ${hint}`);
+    if (!ok)
+      allOk = false;
+  };
+  const envPath = path.join(process.cwd(), ".env");
+  const hasEnv = fs.existsSync(envPath);
+  check(".env file exists", hasEnv, "Create a .env file — run: bunx popii init");
+  let envVars = {};
+  if (hasEnv) {
+    for (const line of fs.readFileSync(envPath, "utf8").split(`
+`)) {
+      const eqIdx = line.indexOf("=");
+      if (eqIdx > 0)
+        envVars[line.slice(0, eqIdx).trim()] = line.slice(eqIdx + 1).trim();
+    }
+  }
+  const token = process.env.DISCORD_TOKEN || envVars["DISCORD_TOKEN"];
+  check("DISCORD_TOKEN is set", !!token, "Add DISCORD_TOKEN=<your-token> to your .env file");
+  if (token) {
+    const sp = spinner();
+    sp.start("Validating Discord token...");
+    try {
+      const res = await fetch("https://discord.com/api/v10/users/@me", {
+        headers: { Authorization: `Bot ${token}` }
+      });
+      sp.stop("");
+      if (res.ok) {
+        const data = await res.json();
+        check(`Token is valid (bot: ${data.username})`, true);
+      } else {
+        check("Token is valid", false, `Discord API returned ${res.status} — verify the token in the Developer Portal`);
+      }
+    } catch {
+      sp.stop("");
+      check("Discord API is reachable", false, "Could not reach discord.com — check your internet connection");
+    }
+  }
+  const entryFile = args[1] || path.join("src", "index.ts");
+  check(`Entry file exists (${entryFile})`, fs.existsSync(path.join(process.cwd(), entryFile)), `Create ${entryFile} or specify a path: popii doctor <entry>`);
+  for (const dir of ["src/commands", "src/events", "src/snaps", "src/middlewares", "src/tasks"]) {
+    if (!fs.existsSync(path.join(process.cwd(), dir))) {
+      check(`Directory ${dir} exists`, false, `Create it: mkdir -p ${dir}`);
+    }
+  }
+  const pkgPath = path.join(process.cwd(), "package.json");
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    check("popii is in package.json", !!(pkg.dependencies?.popii || pkg.devDependencies?.popii), "Run: bun add popii");
+  } else {
+    check("package.json exists", false, "Run: bunx popii init");
+  }
+  const bunVersion = process.versions.bun;
+  if (bunVersion) {
+    const [major = 0, minor = 0] = bunVersion.split(".").map(Number);
+    check(`Bun >= 1.1.0 (found ${bunVersion})`, major > 1 || major === 1 && minor >= 1, "Upgrade: bun upgrade");
+  }
+  console.log();
+  if (allOk) {
+    console.log(`✨ All checks passed. Your bot is ready to run.
+`);
+  } else {
+    console.log(`⚠️  Some checks failed. Fix the issues above and re-run popii doctor.
+`);
+    process.exit(1);
+  }
+}
+async function runDeploy(args) {
+  const fs = __require("node:fs");
+  const path = __require("node:path");
+  let target = args[1];
+  if (!target) {
+    const choice = await select({
+      message: "Choose a deployment target:",
+      options: [
+        { value: "railway", label: "Railway", hint: "generates railway.json" },
+        { value: "fly", label: "Fly.io", hint: "generates fly.toml" },
+        { value: "vps", label: "VPS / systemd", hint: "generates a systemd service unit" }
+      ]
+    });
+    if (isCancel(choice))
+      process.exit(0);
+    target = choice;
+  }
+  let pkg = {};
+  try {
+    pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), "package.json"), "utf8"));
+  } catch {}
+  const appName = pkg.name ?? "popii-bot";
+  if (target === "railway") {
+    const config = {
+      $schema: "https://railway.app/railway.schema.json",
+      build: { builder: "DOCKERFILE" },
+      deploy: { restartPolicyType: "ON_FAILURE", restartPolicyMaxRetries: 10 }
+    };
+    await Bun.write(path.join(process.cwd(), "railway.json"), JSON.stringify(config, null, 2) + `
+`);
+    console.log(`✅ Created railway.json
+`);
+    console.log("Next steps:");
+    console.log("  1. npm i -g @railway/cli && railway login");
+    console.log("  2. railway link  (or railway init)");
+    console.log("  3. railway variables set DISCORD_TOKEN=xxx");
+    console.log(`  4. railway up
+`);
+  } else if (target === "fly") {
+    const toml = `# Generated by popii deploy
+app = "${appName}"
+primary_region = "iad"
+
+[build]
+  dockerfile = "Dockerfile"
+
+[env]
+  PORT = "3000"
+`;
+    await Bun.write(path.join(process.cwd(), "fly.toml"), toml);
+    console.log(`✅ Created fly.toml
+`);
+    console.log("Next steps:");
+    console.log("  1. curl -L https://fly.io/install.sh | sh && fly auth login");
+    console.log("  2. fly launch --no-deploy");
+    console.log("  3. fly secrets set DISCORD_TOKEN=xxx");
+    console.log(`  4. fly deploy
+`);
+  } else if (target === "vps") {
+    const service = `[Unit]
+Description=${appName} Discord Bot
+After=network.target
+
+[Service]
+Type=simple
+User=popii
+WorkingDirectory=/opt/${appName}
+ExecStart=/usr/local/bin/bun run start
+EnvironmentFile=/opt/${appName}/.env
+Restart=always
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=multi-user.target
+`;
+    await Bun.write(path.join(process.cwd(), `${appName}.service`), service);
+    console.log(`✅ Created ${appName}.service
+`);
+    console.log("Next steps:");
+    console.log(`  1. scp -r . user@host:/opt/${appName}`);
+    console.log(`  2. On the VPS: curl -fsSL https://bun.sh/install | bash`);
+    console.log(`  3. sudo cp ${appName}.service /etc/systemd/system/`);
+    console.log(`     sudo systemctl daemon-reload`);
+    console.log(`     sudo systemctl enable --now ${appName}`);
+    console.log(`  4. journalctl -u ${appName} -f
+`);
+  } else {
+    console.log(`Unknown target: ${target}. Valid options: railway, fly, vps`);
+    process.exit(1);
+  }
+}
+async function runDashboard(args) {
+  const fs = __require("node:fs");
+  const path = __require("node:path");
+  let envVars = {};
+  const envPath = path.join(process.cwd(), ".env");
+  if (fs.existsSync(envPath)) {
+    for (const line of fs.readFileSync(envPath, "utf8").split(`
+`)) {
+      const eqIdx = line.indexOf("=");
+      if (eqIdx > 0)
+        envVars[line.slice(0, eqIdx).trim()] = line.slice(eqIdx + 1).trim();
+    }
+  }
+  const clientId = process.env.DISCORD_CLIENT_ID || envVars["DISCORD_CLIENT_ID"];
+  const port = args[1] ? parseInt(args[1]) : 3000;
+  const dashPath = args[2] ?? "/dashboard";
+  const redirectUri = `http://localhost:${port}${dashPath}/callback`;
+  console.log(`
+\uD83D\uDCCB Dashboard Setup
+`);
+  console.log("1. Discord Developer Portal → Your App → OAuth2 → Redirects");
+  console.log(`   Add: ${redirectUri}`);
+  console.log(`   (Replace localhost with your domain in production)
+`);
+  console.log("2. Required .env variables:");
+  console.log(`   DISCORD_CLIENT_ID      = <OAuth2 General → Client ID>`);
+  console.log(`   DISCORD_CLIENT_SECRET  = <OAuth2 General → Client Secret>`);
+  console.log(`   REDIRECT_URI           = ${redirectUri}
+`);
+  if (clientId) {
+    const scopes = "bot%20applications.commands";
+    console.log("3. Bot invite URL (Administrator):");
+    console.log(`   https://discord.com/api/oauth2/authorize?client_id=${clientId}&permissions=8&scope=${scopes}
+`);
+    const oauthScopes = "identify%20guilds";
+    console.log("4. Dashboard login URL (test in browser):");
+    console.log(`   https://discord.com/api/oauth2/authorize?client_id=${clientId}&redirect_uri=${encodeURIComponent(redirectUri)}&response_type=code&scope=${oauthScopes}
+`);
+  } else {
+    console.log(`3. Set DISCORD_CLIENT_ID in .env to generate invite and login URLs.
+`);
+  }
+  console.log("5. webPlugin config:");
+  console.log(`   webPlugin({`);
+  console.log(`     port: ${port},`);
+  console.log(`     dashboard: true,`);
+  console.log(`     oauth2: {`);
+  console.log(`       clientId: process.env.DISCORD_CLIENT_ID!,`);
+  console.log(`       clientSecret: process.env.DISCORD_CLIENT_SECRET!,`);
+  console.log(`       redirectUri: process.env.REDIRECT_URI!,`);
+  console.log(`     },`);
+  console.log(`   })
+`);
+  console.log("Tip: pass a custom port and path: popii dashboard <port> <dashPath>");
+  console.log(`     e.g. popii dashboard 6767 /dashboard
+`);
+}
+async function runInit(args) {
+  if (!args.includes("--no-browser") && process.stdout.isTTY) {
+    await initViaWeb();
+    return;
+  }
+  intro("Welcome to Popii loader! Let's set up your new bot.");
+  const botName = await text({
+    message: "What is the name of your bot?",
+    placeholder: "my-popii-bot",
+    validate(value) {
+      if (!value || value.trim().length === 0)
+        return "Name is required!";
+      if (value.trim().toLowerCase() === "popii")
+        return "Your bot cannot be named 'popii' as it causes a dependency loop!";
+    }
+  });
+  if (isCancel(botName))
+    process.exit(1);
+  if (botName === "popii") {
+    console.error("Your bot cannot be named 'popii' as it causes a dependency loop!");
+    process.exit(1);
+  }
+  const selectedPlugins = await multiselect({
+    message: "Which built-in plugins would you like to enable?",
+    options: [
+      { value: "uiPlugin", label: "UI Plugin", hint: ".paginate(), .prompt(), .form()" },
+      { value: "sqlitePlugin", label: "SQLite", hint: "Bun SQLite database in context" },
+      { value: "errorHandlerPlugin", label: "Error Handler", hint: "Catches PopiiErrors gracefully" },
+      { value: "commandLoggerPlugin", label: "Command Logger", hint: "Logs command executions" },
+      { value: "commandAnalyticPlugin", label: "Analytics", hint: "Tracks command usage stats" },
+      { value: "permissionGuardPlugin", label: "Permission Guard", hint: "Enforces permissions automatically" },
+      { value: "reloadPlugin", label: "Hot Reload", hint: "Adds a /reload command" },
+      { value: "webPlugin", label: "Web Server", hint: "/health and /metrics endpoints" },
+      { value: "telemetryPlugin", label: "Telemetry", hint: "Performance monitoring" },
+      { value: "voicePlugin", label: "Voice", hint: "Voice channel support" },
+      { value: "mongoosePlugin", label: "Mongoose", hint: "MongoDB via Mongoose ODM" },
+      { value: "deskPlugin", label: "Desk", hint: "Support ticket system" },
+      { value: "popiiAiPlugin", label: "AI", hint: "Claude AI integration" },
+      { value: "payPlugin", label: "Pay", hint: "Payment processing" },
+      { value: "autoModPlugin", label: "AutoMod", hint: "Automated moderation" },
+      { value: "economyPlugin", label: "Economy", hint: "Virtual currency system" },
+      { value: "giveawayPlugin", label: "Giveaway", hint: "Run giveaways in channels" },
+      { value: "activityRotatorPlugin", label: "Activity Rotator", hint: "Rotates bot status messages" },
+      { value: "captchaPlugin", label: "Captcha", hint: "Verification captchas" },
+      { value: "canvasPlugin", label: "Canvas", hint: "Image generation" },
+      { value: "lastFmPlugin", label: "Last.fm", hint: "Last.fm music integration" }
+    ],
+    required: false
+  });
+  if (isCancel(selectedPlugins))
+    process.exit(1);
+  const botToken = await text({
+    message: "Discord bot token (Leave blank to add later)",
+    placeholder: "MTAx..."
+  });
+  if (isCancel(botToken))
+    process.exit(1);
+  const installDeps = await confirm({
+    message: "Would you like to install dependencies via Bun now?",
+    initialValue: true
+  });
+  if (isCancel(installDeps))
+    process.exit(1);
+  const genDocker = await confirm({
+    message: "Would you like to generate Docker deployment files for production?",
+    initialValue: false
+  });
+  if (isCancel(genDocker))
+    process.exit(1);
+  const s = spinner();
+  s.start("Scaffolding your project...");
+  await scaffoldProject({
+    botName,
+    plugins: selectedPlugins,
+    botToken,
+    installDeps,
+    genDocker
+  });
+  s.stop("All done!");
+  outro(`Your project is ready!
+
+  cd ${botName}
+  bun run dev`);
+}
+
+// src/cli.ts
+async function main() {
+  const args = process.argv.slice(2);
+  if (args[0] === "dev") {
+    await runDev(args);
+    return;
+  }
+  if (args[0] === "sync") {
+    await runSync(args);
+    return;
+  }
+  if (args[0] === "console") {
+    await runConsole(args);
+    return;
+  }
+  if (args[0] === "migrate") {
+    await runMigrate(args);
+    return;
+  }
+  if (args[0] === "install") {
+    await runInstall(args);
+    return;
+  }
+  if (args[0] === "add") {
+    await runAdd(args);
+    return;
+  }
+  if (args[0] === "remove") {
+    await runRemove(args);
+    return;
+  }
+  if (args[0] === "search") {
+    await runSearch(args);
+    return;
+  }
+  if (args[0] === "list") {
+    await runList(args);
+    return;
+  }
+  if (args[0] === "g" || args[0] === "generate") {
+    await runGenerate(args);
+    return;
+  }
+  if (args[0] === "doctor") {
+    await runDoctor(args);
+    return;
+  }
+  if (args[0] === "deploy") {
+    await runDeploy(args);
+    return;
+  }
+  if (args[0] === "dashboard") {
+    await runDashboard(args);
+    return;
+  }
+  if (args[0] !== "init") {
+    console.log(`Usage:
+  bunx popii init
+  bunx popii dev
+  bunx popii sync
+  bunx popii console
+  bunx popii doctor
+  bunx popii deploy [railway|fly|vps]
+  bunx popii dashboard [port] [path]
+  bunx popii install <user/repo[@tag]>
+  bunx popii migrate <create|up> [name]
+  bunx popii g <command|event|snap|middleware|task|test> <name>
+  bunx popii add <plugin-name>
+  bunx popii remove <plugin-name>
+  bunx popii search <query>
+  bunx popii list`);
+    process.exit(1);
+  }
+  await runInit(args);
+}
+main().catch(console.error);