calabasas 0.16.1 → 0.17.1

package/dist/index.js

@@ -2594,7 +2594,7 @@ async function generate(options) {
 import * as fs5 from "fs";
 import * as path5 from "path";
 import * as p6 from "@clack/prompts";
-var SECTION_HEADER = "## Calabasas Guidelines";
+var SKILL_PATH = ".claude/skills/calabasas/SKILL.md";
 async function fetchSkillContent(env) {
   const apiUrl = getApiUrlForEnv(env);
   const response = await fetch(`${apiUrl}/api/skill`);
@@ -2603,28 +2603,6 @@ async function fetchSkillContent(env) {
   }
   return response.text();
 }
-var SEARCH_PATHS = [
-  "CLAUDE.md",
-  "AGENTS.md",
-  ".claude/CLAUDE.md",
-  ".cursor/AGENTS.md",
-  "docs/CLAUDE.md",
-  "docs/AGENTS.md"
-];
-function detectExistingFiles(cwd) {
-  const found = [];
-  for (const searchPath of SEARCH_PATHS) {
-    const fullPath = path5.resolve(cwd, searchPath);
-    if (fs5.existsSync(fullPath)) {
-      const type = searchPath.includes("CLAUDE") ? "CLAUDE.md" : "AGENTS.md";
-      found.push({ path: searchPath, fullPath, type });
-    }
-  }
-  return found;
-}
-function hasCalabsasSection(content) {
-  return content.includes(SECTION_HEADER) || content.includes("## Calabasas Guidelines");
-}
 async function skill(options) {
   const env = resolveEnv(options);
   p6.intro("calabasas skill");
@@ -2640,110 +2618,13 @@ async function skill(options) {
   }
   s.stop("Guidelines fetched");
   const cwd = process.cwd();
-  const detectedFiles = detectExistingFiles(cwd);
-  if (detectedFiles.length === 0) {
-    let createPath;
-    if (options.file) {
-      createPath = options.file;
-    } else {
-      const selected = await p6.select({
-        message: "No CLAUDE.md or AGENTS.md found. Where should we create one?",
-        options: [
-          { value: "CLAUDE.md", label: "CLAUDE.md (project root)" },
-          { value: "AGENTS.md", label: "AGENTS.md (project root)" },
-          { value: ".claude/CLAUDE.md", label: ".claude/CLAUDE.md" }
-        ]
-      });
-      if (p6.isCancel(selected)) {
-        p6.cancel("Cancelled.");
-        return;
-      }
-      createPath = selected;
-    }
-    const fullPath = path5.resolve(cwd, createPath);
-    const dir = path5.dirname(fullPath);
-    if (!fs5.existsSync(dir)) {
-      fs5.mkdirSync(dir, { recursive: true });
-    }
-    const projectName = path5.basename(cwd);
-    const initialContent = `# ${projectName}
-
-${skillContent}`;
-    fs5.writeFileSync(fullPath, initialContent);
-    p6.outro(`Created ${createPath} with Calabasas guidelines`);
-    return;
-  }
-  let selectedFile;
-  if (options.file) {
-    const match = detectedFiles.find((f) => f.path === options.file);
-    if (match) {
-      selectedFile = match;
-    } else {
-      const fullPath = path5.resolve(cwd, options.file);
-      const dir = path5.dirname(fullPath);
-      if (!fs5.existsSync(dir)) {
-        fs5.mkdirSync(dir, { recursive: true });
-      }
-      if (fs5.existsSync(fullPath)) {
-        selectedFile = {
-          path: options.file,
-          fullPath,
-          type: options.file.includes("CLAUDE") ? "CLAUDE.md" : "AGENTS.md"
-        };
-      } else {
-        const projectName = path5.basename(cwd);
-        const initialContent = `# ${projectName}
-
-${skillContent}`;
-        fs5.writeFileSync(fullPath, initialContent);
-        p6.outro(`Created ${options.file} with Calabasas guidelines`);
-        return;
-      }
-    }
-  } else if (detectedFiles.length === 1) {
-    selectedFile = detectedFiles[0];
-  } else {
-    const selected = await p6.select({
-      message: "Which file should receive the Calabasas guidelines?",
-      options: detectedFiles.map((file) => ({
-        value: file.path,
-        label: file.path
-      }))
-    });
-    if (p6.isCancel(selected)) {
-      p6.cancel("Cancelled.");
-      return;
-    }
-    selectedFile = detectedFiles.find((f) => f.path === selected);
-  }
-  const existingContent = fs5.readFileSync(selectedFile.fullPath, "utf8");
-  if (hasCalabsasSection(existingContent)) {
-    if (!options.yes) {
-      const update = await p6.confirm({
-        message: `Calabasas guidelines already exist in ${selectedFile.path}. Replace?`
-      });
-      if (p6.isCancel(update) || !update) {
-        p6.cancel("Cancelled.");
-        return;
-      }
-    }
-    const sectionRegex = /## Calabasas Guidelines[\s\S]*?(?=\n## |\n# |$)/;
-    const contentWithoutSection = existingContent.replace(sectionRegex, "").trimEnd();
-    const newContent = `${contentWithoutSection}
-
-${skillContent}`;
-    fs5.writeFileSync(selectedFile.fullPath, newContent);
-    p6.outro(`Updated Calabasas guidelines in ${selectedFile.path}`);
-  } else {
-    const separator = existingContent.endsWith(`
-`) ? `
-` : `
-
-`;
-    const newContent = `${existingContent}${separator}${skillContent}`;
-    fs5.writeFileSync(selectedFile.fullPath, newContent);
-    p6.outro(`Added Calabasas guidelines to ${selectedFile.path}`);
+  const fullPath = path5.resolve(cwd, SKILL_PATH);
+  const dir = path5.dirname(fullPath);
+  if (!fs5.existsSync(dir)) {
+    fs5.mkdirSync(dir, { recursive: true });
   }
+  fs5.writeFileSync(fullPath, skillContent);
+  p6.outro(`Wrote Calabasas skill to ${SKILL_PATH}`);
 }
 
 // src/commands/add.ts
@@ -5741,6 +5622,652 @@ export const listAppEmojis = query({
 });`
 };
 
+// src/lib/registry/components/role-creator.ts
+var roleCreator = {
+  name: "role-creator",
+  kind: "component",
+  description: "Discord-style role creation dialog with color picker, member assignment, and position ordering",
+  requiredSyncTypes: ["roles", "members"],
+  requiredShadcnComponents: ["dialog", "button", "popover", "command"],
+  generateReactComponent: () => `"use client";
+
+import { useState, useMemo } from "react";
+import { useQuery } from "convex/react";
+import { api } from "@/convex/_generated/api";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/components/ui/dialog";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
+import {
+  Command,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+} from "@/components/ui/command";
+import { Button } from "@/components/ui/button";
+import { cn } from "@/lib/utils";
+import {
+  Check,
+  X,
+  ChevronsUpDown,
+  User,
+  Plus,
+  ChevronUp,
+  ChevronDown,
+} from "lucide-react";
+
+/**
+ * Discord's 20 preset role colors arranged in two rows:
+ * Row 1 — lighter tones, Row 2 — darker counterparts.
+ */
+const PRESET_COLORS: number[] = [
+  0x1abc9c, 0x2ecc71, 0x3498db, 0x9b59b6, 0xe91e63,
+  0xf1c40f, 0xe67e22, 0xe74c3c, 0x95a5a6, 0x607d8b,
+  0x11806a, 0x1f8b4c, 0x206694, 0x71368a, 0xad1457,
+  0xc27c0e, 0xa84300, 0x992d22, 0x979c9f, 0x546e7a,
+];
+
+/** Convert Discord integer color to hex CSS string */
+function colorToHex(color: number): string {
+  if (color === 0) return "#99AAB5";
+  return "#" + color.toString(16).padStart(6, "0");
+}
+
+/** Convert hex string to Discord integer color */
+function hexToColor(hex: string): number {
+  const clean = hex.replace("#", "");
+  const parsed = parseInt(clean, 16);
+  return isNaN(parsed) ? 0 : parsed;
+}
+
+/** Convert Discord integer color to rgba string */
+function colorToRgba(color: number, alpha: number): string {
+  if (color === 0) return \`rgba(153, 170, 181, \${alpha})\`;
+  const r = (color >> 16) & 0xff;
+  const g = (color >> 8) & 0xff;
+  const b = color & 0xff;
+  return \`rgba(\${r}, \${g}, \${b}, \${alpha})\`;
+}
+
+/** Build Discord CDN avatar URL */
+function avatarUrl(
+  userId: string,
+  avatar: string | undefined,
+): string | null {
+  if (!avatar) return null;
+  return \`https://cdn.discordapp.com/avatars/\${userId}/\${avatar}.png?size=32\`;
+}
+
+// ── Types ────────────────────────────────────────────────────────────────────
+
+type RoleCreatorData = {
+  name: string;
+  color: number;
+  memberIds: string[];
+  position: number;
+};
+
+type RoleCreatorProps = {
+  guildDiscordId: string;
+  defaultMemberIds?: string[];
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  onCreate?: (data: RoleCreatorData) => void;
+  trigger?: React.ReactNode;
+  className?: string;
+};
+
+// ── Component ────────────────────────────────────────────────────────────────
+
+export function RoleCreator({
+  guildDiscordId,
+  defaultMemberIds = [],
+  open: controlledOpen,
+  onOpenChange,
+  onCreate,
+  trigger,
+  className,
+}: RoleCreatorProps) {
+  const [internalOpen, setInternalOpen] = useState(false);
+  const isControlled = controlledOpen !== undefined;
+  const open = isControlled ? controlledOpen : internalOpen;
+
+  // Form state
+  const [name, setName] = useState("new role");
+  const [color, setColor] = useState(0);
+  const [customHex, setCustomHex] = useState("");
+  const [usingCustom, setUsingCustom] = useState(false);
+  const [selectedMembers, setSelectedMembers] = useState<string[]>(defaultMemberIds);
+  const [memberPickerOpen, setMemberPickerOpen] = useState(false);
+  const [positionIndex, setPositionIndex] = useState(0);
+
+  // Data
+  const roles = useQuery(api.calabasas.queries.listRolesForCreator, {
+    guildDiscordId,
+  });
+  const members = useQuery(api.calabasas.queries.listMembersForCreator, {
+    guildDiscordId,
+  });
+
+  // Sort roles highest-position first, exclude @everyone
+  const sortedRoles = useMemo(() => {
+    if (!roles) return [];
+    return roles
+      .filter((r) => r.name !== "@everyone")
+      .sort((a, b) => b.position - a.position);
+  }, [roles]);
+
+  // Calculate the position value from the insertion index
+  const calculatedPosition = useMemo(() => {
+    if (sortedRoles.length === 0) return 1;
+    if (positionIndex === 0) return sortedRoles[0].position + 1;
+    if (positionIndex >= sortedRoles.length) return 1;
+    return sortedRoles[positionIndex - 1].position;
+  }, [sortedRoles, positionIndex]);
+
+  const reset = () => {
+    setName("new role");
+    setColor(0);
+    setCustomHex("");
+    setUsingCustom(false);
+    setSelectedMembers(defaultMemberIds);
+    setMemberPickerOpen(false);
+    setPositionIndex(0);
+  };
+
+  const setOpen = (v: boolean) => {
+    if (!v) reset();
+    if (!isControlled) setInternalOpen(v);
+    onOpenChange?.(v);
+  };
+
+  const handleCreate = () => {
+    onCreate?.({
+      name,
+      color,
+      memberIds: selectedMembers,
+      position: calculatedPosition,
+    });
+    setOpen(false);
+  };
+
+  const toggleMember = (userId: string) => {
+    setSelectedMembers((prev) =>
+      prev.includes(userId)
+        ? prev.filter((id) => id !== userId)
+        : [...prev, userId],
+    );
+  };
+
+  const selectPreset = (c: number) => {
+    setColor(c);
+    setUsingCustom(false);
+    setCustomHex("");
+  };
+
+  const moveUp = () => setPositionIndex((i) => Math.max(0, i - 1));
+  const moveDown = () =>
+    setPositionIndex((i) => Math.min(sortedRoles.length, i + 1));
+
+  // ── Render ───────────────────────────────────────────────────────────────
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        {trigger ?? (
+          <Button variant="outline" className={className}>
+            <Plus className="mr-2 h-4 w-4" />
+            Create Role
+          </Button>
+        )}
+      </DialogTrigger>
+
+      <DialogContent className="sm:max-w-[520px] p-0 gap-0 overflow-hidden">
+        {/* ── Header ──────────────────────────────────────────────── */}
+        <DialogHeader className="px-6 pt-6 pb-2">
+          <DialogTitle>Create Role</DialogTitle>
+          <DialogDescription>
+            Configure the role's appearance, assign members, and set its
+            position in the hierarchy.
+          </DialogDescription>
+        </DialogHeader>
+
+        {/* ── Live preview ────────────────────────────────────────── */}
+        <div className="px-6 py-3">
+          <div className="flex items-center gap-3 rounded-lg border bg-muted/40 px-4 py-3">
+            <span
+              className="h-3.5 w-3.5 rounded-full shrink-0 transition-colors duration-200"
+              style={{ backgroundColor: colorToHex(color) }}
+            />
+            <span className="text-sm font-medium truncate">
+              {name || "new role"}
+            </span>
+            <span
+              className="ml-auto text-[11px] font-medium px-2.5 py-0.5 rounded-full transition-colors duration-200"
+              style={{
+                backgroundColor: colorToRgba(color, 0.12),
+                color: colorToHex(color),
+                border: \`1px solid \${colorToRgba(color, 0.25)}\`,
+              }}
+            >
+              Preview
+            </span>
+          </div>
+        </div>
+
+        {/* ── Scrollable body ─────────────────────────────────────── */}
+        <div className="overflow-y-auto max-h-[60vh] px-6 pb-2 space-y-5">
+          {/* ROLE NAME --------------------------------------------------- */}
+          <fieldset>
+            <legend className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground mb-2">
+              Role Name
+            </legend>
+            <input
+              type="text"
+              value={name}
+              onChange={(e) => setName(e.target.value)}
+              placeholder="new role"
+              className="w-full rounded-md border border-input bg-background px-3 py-2 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+            />
+          </fieldset>
+
+          {/* ROLE COLOR -------------------------------------------------- */}
+          <fieldset>
+            <legend className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground mb-2">
+              Role Color
+            </legend>
+
+            {/* Default (no color) toggle */}
+            <button
+              onClick={() => selectPreset(0)}
+              className={cn(
+                "mb-3 inline-flex items-center gap-2 rounded-md border px-3 py-1.5 text-sm transition-colors",
+                color === 0
+                  ? "border-primary bg-primary/10 text-primary"
+                  : "border-input text-muted-foreground hover:bg-accent",
+              )}
+            >
+              <span
+                className="h-4 w-4 rounded-full border-2 transition-colors"
+                style={{
+                  borderColor: "#99AAB5",
+                  backgroundColor: color === 0 ? "#99AAB5" : "transparent",
+                }}
+              />
+              Default
+            </button>
+
+            {/* Preset grid (2 rows of 10) */}
+            <div className="grid grid-cols-10 gap-2 mb-3">
+              {PRESET_COLORS.map((c) => (
+                <button
+                  key={c}
+                  onClick={() => selectPreset(c)}
+                  className={cn(
+                    "h-7 w-7 rounded-full transition-all duration-150 hover:scale-110 focus-visible:outline-none relative",
+                    color === c &&
+                      "ring-2 ring-offset-2 ring-offset-background ring-primary scale-110",
+                  )}
+                  style={{ backgroundColor: colorToHex(c) }}
+                  title={colorToHex(c)}
+                >
+                  {color === c && (
+                    <Check className="h-3 w-3 text-white absolute inset-0 m-auto drop-shadow-[0_1px_2px_rgba(0,0,0,0.5)]" />
+                  )}
+                </button>
+              ))}
+            </div>
+
+            {/* Custom color */}
+            <div className="flex items-center gap-2">
+              <div className="relative">
+                <input
+                  type="color"
+                  value={color !== 0 ? colorToHex(color) : "#000000"}
+                  onChange={(e) => {
+                    const hex = e.target.value;
+                    setColor(hexToColor(hex));
+                    setCustomHex(hex);
+                    setUsingCustom(true);
+                  }}
+                  className="absolute inset-0 w-full h-full opacity-0 cursor-pointer"
+                />
+                <div
+                  className={cn(
+                    "h-7 w-7 rounded-full border-2 flex items-center justify-center cursor-pointer transition-colors",
+                    usingCustom
+                      ? "border-primary"
+                      : "border-dashed border-muted-foreground/40 hover:border-muted-foreground",
+                  )}
+                  style={
+                    usingCustom && color !== 0
+                      ? { backgroundColor: colorToHex(color), borderStyle: "solid" }
+                      : {}
+                  }
+                >
+                  {!usingCustom && (
+                    <Plus className="h-3 w-3 text-muted-foreground" />
+                  )}
+                </div>
+              </div>
+              <input
+                type="text"
+                value={customHex}
+                onChange={(e) => {
+                  const v = e.target.value;
+                  setCustomHex(v);
+                  if (v.match(/^#?[0-9a-fA-F]{6}$/)) {
+                    setColor(hexToColor(v));
+                    setUsingCustom(true);
+                  }
+                }}
+                placeholder="#000000"
+                maxLength={7}
+                className="w-[88px] rounded-md border border-input bg-background px-2 py-1 text-sm font-mono shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+              />
+            </div>
+          </fieldset>
+
+          {/* ADD MEMBERS ------------------------------------------------- */}
+          <fieldset>
+            <legend className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground mb-2">
+              Add Members
+              {selectedMembers.length > 0 && (
+                <span className="ml-1.5 text-[11px] font-normal">
+                  ({selectedMembers.length})
+                </span>
+              )}
+            </legend>
+
+            {/* Selected member chips */}
+            {selectedMembers.length > 0 && (
+              <div className="flex flex-wrap gap-1.5 mb-2">
+                {selectedMembers.map((userId) => {
+                  const member = members?.find(
+                    (m) => m.discordUserId === userId,
+                  );
+                  if (!member) return null;
+                  const url = avatarUrl(member.discordUserId, member.avatar);
+                  return (
+                    <span
+                      key={userId}
+                      className="inline-flex items-center gap-1.5 rounded-full bg-primary/10 text-primary pl-1 pr-1.5 py-0.5 text-xs font-medium"
+                    >
+                      {url ? (
+                        <img
+                          src={url}
+                          alt=""
+                          className="h-4 w-4 rounded-full shrink-0 object-cover"
+                        />
+                      ) : (
+                        <div className="h-4 w-4 rounded-full bg-primary/20 flex items-center justify-center shrink-0">
+                          <User className="h-2.5 w-2.5" />
+                        </div>
+                      )}
+                      {member.displayName ?? member.username}
+                      <button
+                        onClick={() => toggleMember(userId)}
+                        className="rounded-full p-0.5 hover:bg-primary/20 transition-colors"
+                      >
+                        <X className="h-3 w-3" />
+                      </button>
+                    </span>
+                  );
+                })}
+              </div>
+            )}
+
+            {/* Member combobox */}
+            <Popover open={memberPickerOpen} onOpenChange={setMemberPickerOpen}>
+              <PopoverTrigger asChild>
+                <Button
+                  variant="outline"
+                  role="combobox"
+                  aria-expanded={memberPickerOpen}
+                  className="w-full justify-between font-normal"
+                >
+                  <span className="text-muted-foreground">
+                    Search by name or ID...
+                  </span>
+                  <ChevronsUpDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
+                </Button>
+              </PopoverTrigger>
+              <PopoverContent className="w-[--radix-popover-trigger-width] p-0" align="start">
+                <Command>
+                  <CommandInput placeholder="Search members..." />
+                  <CommandList>
+                    <CommandEmpty>No members found.</CommandEmpty>
+                    <CommandGroup>
+                      {members?.map((member) => {
+                        const checked = selectedMembers.includes(
+                          member.discordUserId,
+                        );
+                        const url = avatarUrl(
+                          member.discordUserId,
+                          member.avatar,
+                        );
+                        return (
+                          <CommandItem
+                            key={member.discordUserId}
+                            value={\`\${member.discordUserId} \${member.username} \${member.displayName ?? ""} \${member.nick ?? ""}\`}
+                            onSelect={() => toggleMember(member.discordUserId)}
+                          >
+                            {url ? (
+                              <img
+                                src={url}
+                                alt=""
+                                className="mr-2 h-5 w-5 rounded-full shrink-0 object-cover"
+                              />
+                            ) : (
+                              <div className="mr-2 h-5 w-5 rounded-full bg-muted flex items-center justify-center shrink-0">
+                                <User className="h-3 w-3 text-muted-foreground" />
+                              </div>
+                            )}
+                            <span className="truncate">
+                              {member.displayName ?? member.username}
+                            </span>
+                            <Check
+                              className={cn(
+                                "ml-auto h-4 w-4",
+                                checked ? "opacity-100" : "opacity-0",
+                              )}
+                            />
+                          </CommandItem>
+                        );
+                      })}
+                    </CommandGroup>
+                  </CommandList>
+                </Command>
+              </PopoverContent>
+            </Popover>
+          </fieldset>
+
+          {/* ROLE POSITION ------------------------------------------------ */}
+          <fieldset>
+            <div className="flex items-center justify-between mb-2">
+              <legend className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground">
+                Role Position
+              </legend>
+              <div className="flex items-center gap-0.5">
+                <button
+                  onClick={moveUp}
+                  disabled={positionIndex === 0}
+                  className="rounded-md p-1 hover:bg-accent disabled:opacity-25 disabled:pointer-events-none transition-colors"
+                  title="Move up"
+                >
+                  <ChevronUp className="h-4 w-4" />
+                </button>
+                <button
+                  onClick={moveDown}
+                  disabled={positionIndex >= sortedRoles.length}
+                  className="rounded-md p-1 hover:bg-accent disabled:opacity-25 disabled:pointer-events-none transition-colors"
+                  title="Move down"
+                >
+                  <ChevronDown className="h-4 w-4" />
+                </button>
+              </div>
+            </div>
+
+            <div className="max-h-[200px] overflow-y-auto rounded-md border border-input">
+              {sortedRoles.length === 0 && roles !== undefined ? (
+                <>
+                  <NewRoleEntry
+                    name={name}
+                    color={color}
+                  />
+                  <EveryoneEntry />
+                </>
+              ) : sortedRoles.length === 0 ? (
+                <div className="px-3 py-8 text-center text-sm text-muted-foreground">
+                  Loading roles...
+                </div>
+              ) : (
+                <>
+                  {sortedRoles.map((role, i) => (
+                    <div key={role.discordId}>
+                      {positionIndex === i && (
+                        <NewRoleEntry
+                          name={name}
+                          color={color}
+                        />
+                      )}
+                      <div className="flex items-center gap-2.5 px-3 py-2 text-sm">
+                        <span
+                          className="h-3 w-3 rounded-full shrink-0"
+                          style={{ backgroundColor: colorToHex(role.color) }}
+                        />
+                        <span className="truncate flex-1">{role.name}</span>
+                        <span className="text-[11px] tabular-nums text-muted-foreground">
+                          {role.position}
+                        </span>
+                      </div>
+                    </div>
+                  ))}
+                  {positionIndex >= sortedRoles.length && (
+                    <NewRoleEntry
+                      name={name}
+                      color={color}
+                    />
+                  )}
+                  <EveryoneEntry />
+                </>
+              )}
+            </div>
+          </fieldset>
+        </div>
+
+        {/* ── Footer ──────────────────────────────────────────────── */}
+        <div className="flex items-center justify-end gap-3 border-t px-6 py-4 mt-1">
+          <Button variant="ghost" onClick={() => setOpen(false)}>
+            Cancel
+          </Button>
+          <Button
+            onClick={handleCreate}
+            disabled={!name.trim()}
+            className="transition-colors duration-200"
+            style={
+              color !== 0
+                ? { backgroundColor: colorToHex(color), color: "#fff" }
+                : undefined
+            }
+          >
+            Create Role
+          </Button>
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+// ── Sub-components ─────────────────────────────────────────────────────────
+
+function NewRoleEntry({ name, color }: { name: string; color: number }) {
+  return (
+    <div className="flex items-center gap-2.5 px-3 py-2 bg-primary/[0.08] border-l-2 border-l-primary">
+      <span
+        className="h-3 w-3 rounded-full shrink-0 transition-colors duration-200"
+        style={{ backgroundColor: colorToHex(color) }}
+      />
+      <span className="text-sm font-medium truncate flex-1">
+        {name || "new role"}
+      </span>
+      <span className="text-[11px] font-semibold text-primary">NEW</span>
+    </div>
+  );
+}
+
+function EveryoneEntry() {
+  return (
+    <div className="flex items-center gap-2.5 px-3 py-2 opacity-40">
+      <span className="h-3 w-3 rounded-full shrink-0 bg-muted-foreground/50" />
+      <span className="text-sm truncate">@everyone</span>
+      <span className="ml-auto text-[11px] tabular-nums">0</span>
+    </div>
+  );
+}
+`,
+  generateConvexQueries: () => `export const listRolesForCreator = query({
+  args: { guildDiscordId: v.string() },
+  returns: v.array(
+    v.object({
+      discordId: v.string(),
+      name: v.string(),
+      color: v.number(),
+      position: v.number(),
+    })
+  ),
+  handler: async (ctx, { guildDiscordId }) => {
+    const roles = await ctx.db
+      .query("calabasasRoles")
+      .withIndex("by_guild", (q) => q.eq("guildDiscordId", guildDiscordId))
+      .collect();
+    return roles.map((r) => ({
+      discordId: r.discordId,
+      name: r.name,
+      color: r.color,
+      position: r.position,
+    }));
+  },
+});
+
+export const listMembersForCreator = query({
+  args: { guildDiscordId: v.string() },
+  returns: v.array(
+    v.object({
+      discordUserId: v.string(),
+      username: v.string(),
+      displayName: v.optional(v.string()),
+      avatar: v.optional(v.string()),
+      nick: v.optional(v.string()),
+    })
+  ),
+  handler: async (ctx, { guildDiscordId }) => {
+    const members = await ctx.db
+      .query("calabasasMembers")
+      .withIndex("by_guild", (q) => q.eq("guildDiscordId", guildDiscordId))
+      .collect();
+    return members.map((m) => ({
+      discordUserId: m.discordUserId,
+      username: m.username,
+      displayName: m.displayName,
+      avatar: m.avatar,
+      nick: m.nick,
+    }));
+  },
+});`
+};
+
 // src/lib/registry/index.ts
 var REGISTRY = [
   channelSelect,
@@ -5754,7 +6281,8 @@ var REGISTRY = [
   channelTree,
   memberRoster,
   useOnlineCount,
-  emojiPicker
+  emojiPicker,
+  roleCreator
 ];
 function getComponent(name) {
   return REGISTRY.find((c) => c.name === name);
@@ -7187,7 +7715,7 @@ program2.command("logout").description("Clear stored credentials").option("--dev
 program2.command("init").description("Initialize Calabasas config in your Convex project").action(init);
 program2.command("push").description("Push your Calabasas config to the server").option("-c, --config <path>", "Path to config file", "convex/calabasas/config.ts").option("-b, --bot <botId>", "Bot ID to configure (prompts if not specified)").option("--dev", "Push to development environment").option("--prod", "Push to production environment").action(push);
 program2.command("generate").description("Generate type-safe Discord handlers and helpers").option("-o, --output <path>", "Output path", "convex/calabasas/_generated/discord.ts").option("--dev", "Use development environment").option("--prod", "Use production environment").action(generate);
-program2.command("skill").description("Generate Calabasas documentation for AI assistants").option("--dev", "Use development environment").option("--prod", "Use production environment").option("-f, --file <path>", "Target file path (e.g. CLAUDE.md)").option("-y, --yes", "Auto-confirm replacing existing guidelines").action(skill);
+program2.command("skill").description("Generate Calabasas skill for AI assistants").option("--dev", "Use development environment").option("--prod", "Use production environment").action(skill);
 program2.command("add [components...]").description("Add Discord UI components to your project").action(add);
 program2.command("migrate [name]").description("Run a codemod migration (list available if no name given)").action(migrate);
 program2.command("config").description("View and modify your Calabasas config").option("-c, --config <path>", "Path to config file", "convex/calabasas/config.ts").option("-l, --list", "List current and available config options").option("--add-event <events...>", "Enable event handlers").option("--remove-event <events...>", "Disable event handlers").option("--add-sync <properties...>", "Enable sync properties").option("--remove-sync <properties...>", "Disable sync properties").action(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "calabasas",
-  "version": "0.16.1",
+  "version": "0.17.1",
   "description": "CLI for Calabasas - Discord Gateway as a Service for Convex",
   "type": "module",
   "bin": {