ckweb-cli 0.3.0 → 0.5.0

package/dist/index.js

@@ -172,6 +172,16 @@ function getConfigPath() {
 
 // src/lib/api-client.ts
 var DEFAULT_TIMEOUT = 3e4;
+var RECENT_ROUTES = [
+  /^\/admin\/orders\/stats$/,
+  /^\/admin\/users\/stats$/,
+  /^\/admin\/discount-groups(\/|$)/,
+  /^\/admin\/discounts\/sync-status$/
+];
+function isRecentRoute(path2) {
+  const normalized = path2.startsWith("/") ? path2 : `/${path2}`;
+  return RECENT_ROUTES.some((re) => re.test(normalized));
+}
 async function fetchApi(method, path2, options = {}) {
   const { body, params, timeout = DEFAULT_TIMEOUT, noAuth = false, adminAuth = false } = options;
   let apiKey;
@@ -197,7 +207,7 @@ async function fetchApi(method, path2, options = {}) {
   }
   const headers = {
     "Content-Type": "application/json",
-    "User-Agent": `ckweb-cli/${"0.3.0"}`
+    "User-Agent": `ckweb-cli/${"0.5.0"}`
   };
   if (apiKey) {
     headers["x-api-key"] = apiKey;
@@ -226,6 +236,13 @@ async function fetchApi(method, path2, options = {}) {
       if (response.status === 401 || response.status === 403) {
         throw new AuthError(message);
       }
+      if (response.status === 404 && isRecentRoute(path2)) {
+        throw new ApiError(
+          `${message} \u2014 this command may require a newer claudekit-web release; the endpoint ${path2} is not yet deployed.`,
+          response.status,
+          code
+        );
+      }
       throw new ApiError(message, response.status, code);
     }
     return data;
@@ -1209,6 +1226,22 @@ function registerAdminOrdersCommand(admin) {
       handleError(err);
     }
   });
+  orders.command("search <query>").description("Search orders by query (id, user email, name)").option("--provider <name>", "Filter by payment provider").option("--limit <n>", "Number of results", "50").option("--offset <n>", "Offset for pagination", "0").action(async function(query) {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const limit = Number(opts.limit);
+      const offset = Number(opts.offset);
+      if (Number.isNaN(limit) || limit < 1) throw new CliError("--limit must be a positive integer");
+      if (Number.isNaN(offset) || offset < 0) throw new CliError("--offset must be a non-negative integer");
+      const params = { search: query, limit: String(limit), offset: String(offset) };
+      if (opts.provider) params["provider"] = opts.provider;
+      const data = await fetchApi("GET", "/admin/orders", { adminAuth: true, params });
+      formatOutput(data, getOutputOpts(this), ORDER_COLUMNS2);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   orders.command("get <id>").description("Get order details").action(async function(id) {
     try {
       ensureAdminAuth();
@@ -1304,6 +1337,28 @@ function registerAdminOrdersCommand(admin) {
       handleError(err);
     }
   });
+  orders.command("resend-github-invite <id>").description("Resend GitHub repo invite for a completed order").option("--variant <type>", "Override product variant (engineer_kit|marketing_kit|combo)").option("--github-username <name>", "Override GitHub username to invite").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "order ID");
+      const opts = this.opts();
+      if (opts.variant && !["engineer_kit", "marketing_kit", "combo"].includes(opts.variant)) {
+        throw new CliError(`--variant must be one of engineer_kit, marketing_kit, combo`);
+      }
+      const body = {};
+      if (opts.variant) body["variant"] = opts.variant;
+      if (opts.githubUsername) body["githubUsername"] = opts.githubUsername;
+      const data = await fetchApi(
+        "POST",
+        `/admin/orders/${id}/resend-github-invite`,
+        { adminAuth: true, body }
+      );
+      printSuccess(`GitHub invite resent for order ${id}.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   orders.command("export").description("Export orders as CSV").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").option("--search <text>", "Search text").option("--provider <name>", "Filter by payment provider").option("--status <status>", "Filter by status").action(async function() {
     try {
       ensureAdminAuth();
@@ -1320,6 +1375,25 @@ function registerAdminOrdersCommand(admin) {
       handleError(err);
     }
   });
+  orders.command("stats").description("Aggregate counts + revenue with optional filters").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").option("--status <status>", "Order status filter").option("--provider <polar|sepay>", "Payment provider filter").option("--vat-requested", "Only count orders with VAT invoice requested").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      if (opts.provider && opts.provider !== "polar" && opts.provider !== "sepay") {
+        throw new CliError("--provider must be 'polar' or 'sepay'");
+      }
+      const params = {};
+      if (opts.start) params["start"] = opts.start;
+      if (opts.end) params["end"] = opts.end;
+      if (opts.status) params["status"] = opts.status;
+      if (opts.provider) params["provider"] = opts.provider;
+      if (opts.vatRequested) params["vatRequested"] = "true";
+      const data = await fetchApi("GET", "/admin/orders/stats", { adminAuth: true, params });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 
 // src/commands/admin/admin-users.ts
@@ -1335,6 +1409,24 @@ function registerAdminUsersCommand(admin) {
       handleError(err);
     }
   });
+  users.command("update <id>").description("Update user name and/or email").option("--email <email>", "New email address").option("--name <name>", "New display name").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "user ID");
+      const opts = this.opts();
+      if (opts.email === void 0 && opts.name === void 0) {
+        throw new CliError("At least one of --email or --name is required.");
+      }
+      const body = {};
+      if (opts.email !== void 0) body["email"] = opts.email;
+      if (opts.name !== void 0) body["name"] = opts.name;
+      const data = await fetchApi("PATCH", `/admin/users/${id}`, { adminAuth: true, body });
+      printSuccess(`User ${id} updated.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   users.command("update-github <id>").description("Update GitHub username for a user").requiredOption("--username <name>", "New GitHub username").action(async function(id) {
     try {
       ensureAdminAuth();
@@ -1405,6 +1497,19 @@ function registerAdminUsersCommand(admin) {
       handleError(err);
     }
   });
+  users.command("stats").description("Aggregate user metrics: signups, paying users, top spenders, tiers, GitHub-linked, referrers").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const params = {};
+      if (opts.start) params["start"] = opts.start;
+      if (opts.end) params["end"] = opts.end;
+      const data = await fetchApi("GET", "/admin/users/stats", { adminAuth: true, params });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 
 // src/commands/admin/admin-referrals.ts
@@ -1423,6 +1528,24 @@ function registerAdminReferralsCommand(admin) {
       handleError(err);
     }
   });
+  referrals.command("user-stats <userId>").description("Per-referrer detailed stats (profile + KPIs + payouts)").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").action(async function(userId) {
+    try {
+      ensureAdminAuth();
+      validateId(userId, "user ID");
+      const opts = this.opts();
+      const params = {};
+      if (opts.start) params["startDate"] = opts.start;
+      if (opts.end) params["endDate"] = opts.end;
+      const data = await fetchApi(
+        "GET",
+        `/admin/referrals/${userId}/stats`,
+        { adminAuth: true, params }
+      );
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   referrals.command("tiers-stats").description("Get referral tier statistics").action(async function() {
     try {
       ensureAdminAuth();
@@ -1459,13 +1582,20 @@ function registerAdminReferralsCommand(admin) {
 // src/commands/admin/admin-revenue.ts
 function registerAdminRevenueCommand(admin) {
   const revenue = admin.command("revenue").description("Admin revenue reporting");
-  revenue.command("stats").description("Get revenue statistics").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").action(async function() {
+  revenue.command("stats").description("Get revenue statistics").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").option("--product <engineer_kit|marketing_kit|combo>", "Filter by product").option("--no-team", "Exclude team_* product variants (includeTeam=false)").action(async function() {
     try {
       ensureAdminAuth();
       const opts = this.opts();
       const params = {};
       if (opts.start) params["startDate"] = opts.start;
       if (opts.end) params["endDate"] = opts.end;
+      if (opts.product) {
+        if (!["engineer_kit", "marketing_kit", "combo"].includes(opts.product)) {
+          throw new CliError("--product must be one of: engineer_kit, marketing_kit, combo");
+        }
+        params["product"] = opts.product;
+      }
+      if (opts.team === false) params["includeTeam"] = "false";
       const data = await fetchApi("GET", "/admin/revenue", { adminAuth: true, params });
       formatOutput(data, getOutputOpts(this));
     } catch (err) {
@@ -1590,10 +1720,16 @@ var PAYOUT_COLUMNS2 = [
 ];
 function registerAdminPayoutsCommand(admin) {
   const payouts = admin.command("payouts").description("Admin payout management");
-  payouts.command("list").description("List all payout requests").action(async function() {
+  payouts.command("list").description("List all payout requests").option("--search <text>", "Search by user email").option("--status <status>", "Filter by status").option("--limit <n>", "Page size (default 50, max 100)").option("--offset <n>", "Offset for pagination (default 0)").action(async function() {
     try {
       ensureAdminAuth();
-      const data = await fetchApi("GET", "/admin/payout-requests", { adminAuth: true });
+      const opts = this.opts();
+      const params = {};
+      if (opts.search) params["search"] = opts.search;
+      if (opts.status) params["status"] = opts.status;
+      if (opts.limit !== void 0) params["limit"] = String(opts.limit);
+      if (opts.offset !== void 0) params["offset"] = String(opts.offset);
+      const data = await fetchApi("GET", "/admin/payout-requests", { adminAuth: true, params });
       formatOutput(data, getOutputOpts(this), PAYOUT_COLUMNS2);
     } catch (err) {
       handleError(err);
@@ -1714,6 +1850,267 @@ function registerAdminLoyaltyCommand(admin) {
 
 // src/commands/admin/admin-blog.ts
 import { readFileSync as readFileSync3 } from "fs";
+
+// src/commands/admin/admin-blog-categories.ts
+var CATEGORY_COLUMNS = [
+  { key: "id", header: "ID", width: 36 },
+  { key: "name", header: "Name", width: 24 },
+  { key: "slug", header: "Slug", width: 24 },
+  { key: "parentId", header: "Parent", width: 36 }
+];
+function registerAdminBlogCategoriesCommand(blog) {
+  const categories = blog.command("categories").description("Manage blog categories");
+  categories.command("list").description("List blog categories").option("--query <text>", "Filter by name or slug").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const params = {};
+      if (opts.query) params["query"] = opts.query;
+      const data = await fetchApi("GET", "/admin/blog/categories", {
+        adminAuth: true,
+        params
+      });
+      formatOutput(data.items, getOutputOpts(this), CATEGORY_COLUMNS);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  categories.command("get <id>").description("Get a blog category by ID").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "category ID");
+      const data = await fetchApi("GET", `/admin/blog/categories/${id}`, {
+        adminAuth: true
+      });
+      formatOutput(data.category, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  categories.command("create").description("Create a blog category").requiredOption("--name <name>", "Category name").option("--slug <slug>", "Slug (auto-derived from name if omitted)").option("--description <text>", "Description").option("--parent <id>", "Parent category ID").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const body = { name: opts.name };
+      if (opts.slug) body["slug"] = opts.slug;
+      if (opts.description) body["description"] = opts.description;
+      if (opts.parent) body["parentId"] = opts.parent;
+      const data = await fetchApi("POST", "/admin/blog/categories", {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`Category "${data.category.name}" created (${data.category.id}).`);
+      formatOutput(data.category, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  categories.command("update <id>").description("Update a blog category").option("--name <name>", "New name").option("--slug <slug>", "New slug").option("--description <text>", "New description").option("--parent <id>", "New parent category ID ('none' to clear)").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "category ID");
+      const opts = this.opts();
+      const body = {};
+      if (opts.name !== void 0) body["name"] = opts.name;
+      if (opts.slug !== void 0) body["slug"] = opts.slug;
+      if (opts.description !== void 0) body["description"] = opts.description;
+      if (opts.parent !== void 0) body["parentId"] = opts.parent === "none" ? null : opts.parent;
+      if (Object.keys(body).length === 0) {
+        throw new CliError("At least one field (--name, --slug, --description, --parent) is required.");
+      }
+      const data = await fetchApi("PATCH", `/admin/blog/categories/${id}`, {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`Category ${id} updated.`);
+      formatOutput(data.category, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  categories.command("delete <id>").description("Delete a blog category (refuses if articles or child categories reference it)").option("--force", "Disassociate articles before deleting (still refuses if children exist)").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "category ID");
+      const opts = this.opts();
+      const ok = await confirm(`Delete category ${id}${opts.force ? " (force)" : ""}? This cannot be undone.`);
+      if (!ok) {
+        console.log("Aborted.");
+        return;
+      }
+      const params = {};
+      if (opts.force) params["force"] = "true";
+      const data = await fetchApi("DELETE", `/admin/blog/categories/${id}`, {
+        adminAuth: true,
+        params
+      });
+      printSuccess(`Category ${id} deleted.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  const articleCats = blog.command("article-categories").description("Manage article-category associations");
+  articleCats.command("add").description("Attach a category to an article").requiredOption("--article <id>", "Article ID").requiredOption("--category <id>", "Category ID").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      validateId(opts.article, "article ID");
+      validateId(opts.category, "category ID");
+      const data = await fetchApi(
+        "POST",
+        `/admin/blog/articles/${opts.article}/categories/${opts.category}`,
+        { adminAuth: true }
+      );
+      if (data.alreadyExisted) {
+        console.log("Association already exists.");
+      } else {
+        printSuccess(`Category ${opts.category} attached to article ${opts.article}.`);
+      }
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  articleCats.command("remove").description("Detach a category from an article").requiredOption("--article <id>", "Article ID").requiredOption("--category <id>", "Category ID").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      validateId(opts.article, "article ID");
+      validateId(opts.category, "category ID");
+      const data = await fetchApi(
+        "DELETE",
+        `/admin/blog/articles/${opts.article}/categories/${opts.category}`,
+        { adminAuth: true }
+      );
+      if (data.detached) {
+        printSuccess(`Category ${opts.category} detached from article ${opts.article}.`);
+      } else {
+        console.log("No association existed.");
+      }
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/admin/admin-blog-tags.ts
+function registerAdminBlogTagsCommand(blog) {
+  blog.command("tags").description("List blog tags").option("--query <text>", "Search by name or slug").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const params = {};
+      if (opts.query) params["query"] = opts.query;
+      const data = await fetchApi("GET", "/admin/blog/tags", { adminAuth: true, params });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("tag-get <id>").description("Get a blog tag by id").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "tag ID");
+      const data = await fetchApi("GET", `/admin/blog/tags/${id}`, { adminAuth: true });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("tag-create").description("Create a blog tag").requiredOption("--name <name>", "Tag name").option("--slug <slug>", "Tag slug (auto-generated if omitted)").option("--description <text>", "Tag description").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const body = { name: opts.name };
+      if (opts.slug) body["slug"] = opts.slug;
+      if (opts.description) body["description"] = opts.description;
+      const data = await fetchApi("POST", "/admin/blog/tags", {
+        adminAuth: true,
+        body
+      });
+      printSuccess("Tag created.");
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("tag-update <id>").description("Update a blog tag").option("--name <name>", "New name").option("--slug <slug>", "New slug").option("--description <text>", "New description").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "tag ID");
+      const opts = this.opts();
+      const body = {};
+      if (opts.name !== void 0) body["name"] = opts.name;
+      if (opts.slug !== void 0) body["slug"] = opts.slug;
+      if (opts.description !== void 0) body["description"] = opts.description;
+      if (Object.keys(body).length === 0) {
+        throw new CliError("Provide at least one of --name, --slug, --description.");
+      }
+      const data = await fetchApi("PATCH", `/admin/blog/tags/${id}`, {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`Tag ${id} updated.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("tag-delete <id>").description("Delete a blog tag").option("--force", "Force delete even if articles are associated (detaches them)").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "tag ID");
+      const opts = this.opts();
+      const ok = await confirm(`Delete tag ${id}${opts.force ? " (force)" : ""}? This cannot be undone.`);
+      if (!ok) {
+        console.log("Aborted.");
+        return;
+      }
+      const params = {};
+      if (opts.force) params["force"] = "true";
+      await fetchApi("DELETE", `/admin/blog/tags/${id}`, { adminAuth: true, params });
+      printSuccess(`Tag ${id} deleted.`);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("article-tag-add <articleId> <tagId>").description("Attach a tag to an article").action(async function(articleId, tagId) {
+    try {
+      ensureAdminAuth();
+      validateId(articleId, "article ID");
+      validateId(tagId, "tag ID");
+      const data = await fetchApi(
+        "POST",
+        `/admin/blog/articles/${articleId}/tags/${tagId}`,
+        { adminAuth: true }
+      );
+      printSuccess(`Tag ${tagId} attached to article ${articleId}.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  blog.command("article-tag-remove <articleId> <tagId>").description("Detach a tag from an article").action(async function(articleId, tagId) {
+    try {
+      ensureAdminAuth();
+      validateId(articleId, "article ID");
+      validateId(tagId, "tag ID");
+      const data = await fetchApi(
+        "DELETE",
+        `/admin/blog/articles/${articleId}/tags/${tagId}`,
+        { adminAuth: true }
+      );
+      printSuccess(`Tag ${tagId} detached from article ${articleId}.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
+// src/commands/admin/admin-blog.ts
 function resolveContent(opts) {
   if (opts.file) {
     try {
@@ -1725,16 +2122,41 @@ function resolveContent(opts) {
   }
   return opts.content;
 }
+var ARTICLE_STATUSES = ["draft", "scheduled", "published", "archived"];
+function applySchedulingFields(body, opts) {
+  if (opts.status !== void 0) {
+    if (!ARTICLE_STATUSES.includes(opts.status)) {
+      throw new CliError(`--status must be one of: ${ARTICLE_STATUSES.join(", ")}`);
+    }
+    body["status"] = opts.status;
+  }
+  if (opts.scheduledFor !== void 0) {
+    const d = new Date(opts.scheduledFor);
+    if (Number.isNaN(d.getTime())) {
+      throw new CliError(`--scheduled-for must be a valid ISO 8601 datetime (got "${opts.scheduledFor}")`);
+    }
+    if (opts.status && opts.status !== "scheduled" && opts.status !== "draft") {
+      throw new CliError(
+        `--scheduled-for cannot be combined with --status ${opts.status}; use --status scheduled (or omit --status).`
+      );
+    }
+    body["scheduledFor"] = d.toISOString();
+  }
+}
 function registerAdminBlogCommand(admin) {
   const blog = admin.command("blog").description("Admin blog management");
-  blog.command("create").description("Create a new blog article").requiredOption("--title <title>", "Article title").option("--content <content>", "Article content (inline)").option("--file <filepath>", "Read content from file").action(async function() {
+  registerAdminBlogCategoriesCommand(blog);
+  registerAdminBlogTagsCommand(blog);
+  blog.command("create").description("Create a new blog article").requiredOption("--title <title>", "Article title").option("--content <content>", "Article content (inline)").option("--file <filepath>", "Read content from file").option("--status <draft|scheduled|published|archived>", "Article status").option("--scheduled-for <iso-date>", "Publish at this ISO 8601 datetime").action(async function() {
     try {
       ensureAdminAuth();
       const opts = this.opts();
       const content = resolveContent(opts);
+      const body = { title: opts.title, content };
+      applySchedulingFields(body, { status: opts.status, scheduledFor: opts.scheduledFor });
       const data = await fetchApi("POST", "/blog/articles", {
         adminAuth: true,
-        body: { title: opts.title, content }
+        body
       });
       printSuccess("Article created.");
       formatOutput(data, getOutputOpts(this));
@@ -1742,7 +2164,7 @@ function registerAdminBlogCommand(admin) {
       handleError(err);
     }
   });
-  blog.command("update <id>").description("Update an existing blog article").option("--title <title>", "New title").option("--content <content>", "New content (inline)").option("--file <filepath>", "Read new content from file").action(async function(id) {
+  blog.command("update <id>").description("Update an existing blog article").option("--title <title>", "New title").option("--content <content>", "New content (inline)").option("--file <filepath>", "Read new content from file").option("--status <draft|scheduled|published|archived>", "Article status").option("--scheduled-for <iso-date>", "Publish at this ISO 8601 datetime").action(async function(id) {
     try {
       ensureAdminAuth();
       validateId(id, "article ID");
@@ -1751,6 +2173,7 @@ function registerAdminBlogCommand(admin) {
       const body = {};
       if (opts.title) body["title"] = opts.title;
       if (content !== void 0) body["content"] = content;
+      applySchedulingFields(body, { status: opts.status, scheduledFor: opts.scheduledFor });
       const data = await fetchApi("PATCH", `/blog/articles/${id}`, {
         adminAuth: true,
         body
@@ -1846,6 +2269,16 @@ function registerAdminBlogCommand(admin) {
       handleError(err);
     }
   });
+  blog.command("run-scheduler").description("Manually trigger the blog article scheduler").action(async function() {
+    try {
+      ensureAdminAuth();
+      const data = await fetchApi("POST", "/blog/scheduler", { adminAuth: true });
+      printSuccess("Scheduler executed.");
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   blog.command("export").description("Export blog articles as CSV").option("--start <date>", "Start date (ISO 8601)").option("--end <date>", "End date (ISO 8601)").option("--status <status>", "Filter by status").action(async function() {
     try {
       ensureAdminAuth();
@@ -1889,6 +2322,23 @@ function registerAdminKeysCommand(admin) {
       handleError(err);
     }
   });
+  keys.command("search <query>").description("Search API keys by name or scope").option("--limit <n>", "Number of results", "50").option("--offset <n>", "Offset for pagination", "0").action(async function(query) {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const limit = Number(opts.limit);
+      const offset = Number(opts.offset);
+      if (Number.isNaN(limit) || limit < 1) throw new Error("--limit must be a positive number");
+      if (Number.isNaN(offset) || offset < 0) throw new Error("--offset must be a non-negative number");
+      const data = await fetchApi("GET", "/admin/keys", {
+        adminAuth: true,
+        params: { search: query, limit: String(limit), offset: String(offset) }
+      });
+      formatOutput(data, getOutputOpts(this), KEY_COLUMNS);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   keys.command("create").description("Create a new API key").requiredOption("--name <name>", "Key name").requiredOption("--scopes <scopes>", "Comma-separated list of scopes").action(async function() {
     try {
       ensureAdminAuth();
@@ -1978,6 +2428,23 @@ function registerAdminInvitesCommand(admin) {
       handleError(err);
     }
   });
+  invites.command("search <query>").description("Search invites by email").option("--limit <n>", "Number of results", "50").option("--offset <n>", "Offset for pagination", "0").action(async function(query) {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const limit = Number(opts.limit);
+      const offset = Number(opts.offset);
+      if (Number.isNaN(limit) || limit < 1) throw new CliError("--limit must be a positive integer");
+      if (Number.isNaN(offset) || offset < 0) throw new CliError("--offset must be a non-negative integer");
+      const data = await fetchApi("GET", "/admin/invites", {
+        adminAuth: true,
+        params: { search: query, limit: String(limit), offset: String(offset) }
+      });
+      formatOutput(data, getOutputOpts(this), INVITE_COLUMNS);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   invites.command("create").description("Create a new invite").requiredOption("--email <email>", "Email address to invite").action(async function() {
     try {
       ensureAdminAuth();
@@ -2069,6 +2536,35 @@ function registerAdminInvitesCommand(admin) {
   });
 }
 
+// src/commands/admin/admin-licenses.ts
+function registerAdminLicensesCommand(admin) {
+  const licenses = admin.command("licenses").description("Admin license management");
+  licenses.command("update-github <licenseId>").description("Change the GitHub username for a single license (admin override)").requiredOption("--username <name>", "New GitHub username").option("--skip-revoke", "Skip revoking the previous collaborator", false).action(async function(licenseId) {
+    try {
+      ensureAdminAuth();
+      validateId(licenseId, "license ID");
+      const { username, skipRevoke } = this.opts();
+      const ok = await confirm(
+        `Change GitHub username on license ${licenseId} to "${username}"?${skipRevoke ? " (skip revoke)" : ""}`
+      );
+      if (!ok) {
+        console.log("Aborted.");
+        return;
+      }
+      const body = { githubUsername: username };
+      if (skipRevoke) body["skipRevoke"] = true;
+      const data = await fetchApi("PATCH", `/admin/licenses/${licenseId}/github-username`, {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`License ${licenseId} GitHub username updated to ${username}.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
 // src/commands/admin/admin-admins.ts
 function registerAdminAdminsCommand(admin) {
   const admins = admin.command("admins").description("Admin role management");
@@ -2083,6 +2579,23 @@ function registerAdminAdminsCommand(admin) {
       handleError(err);
     }
   });
+  admins.command("search <query>").description("Search admins by email or name").option("--limit <n>", "Number of results", "50").option("--offset <n>", "Offset for pagination", "0").action(async function(query) {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const limit = Number(opts.limit);
+      const offset = Number(opts.offset);
+      if (Number.isNaN(limit) || limit < 1) throw new CliError("--limit must be a positive integer");
+      if (Number.isNaN(offset) || offset < 0) throw new CliError("--offset must be a non-negative integer");
+      const data = await fetchApi("GET", "/admin/admins", {
+        adminAuth: true,
+        params: { search: query, limit: String(limit), offset: String(offset) }
+      });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   admins.command("get <id>").description("Get admin details").action(async function(id) {
     try {
       ensureAdminAuth();
@@ -2212,7 +2725,7 @@ function registerAdminDiscountsCommand(admin) {
         page: String(page),
         limit: String(limit)
       };
-      if (opts.query) params["query"] = opts.query;
+      if (opts.query) params["search"] = opts.query;
       const data = await fetchApi("GET", "/admin/discounts", {
         adminAuth: true,
         params
@@ -2222,6 +2735,25 @@ function registerAdminDiscountsCommand(admin) {
       handleError(err);
     }
   });
+  discounts.command("search <query>").description("Search discounts by code or description").option("--page <n>", "Page number", "1").option("--limit <n>", "Results per page", "50").action(async function(query) {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const page = Number(opts.page);
+      const limit = Number(opts.limit);
+      if (Number.isNaN(page) || page < 1) throw new CliError("--page must be a positive integer");
+      if (Number.isNaN(limit) || limit < 1) throw new CliError("--limit must be a positive integer");
+      const params = {
+        search: query,
+        page: String(page),
+        limit: String(limit)
+      };
+      const data = await fetchApi("GET", "/admin/discounts", { adminAuth: true, params });
+      formatOutput(data, getOutputOpts(this), DISCOUNT_COLUMNS);
+    } catch (err) {
+      handleError(err);
+    }
+  });
   discounts.command("create").description("Create a discount code").requiredOption("--code <code>", "Discount code").requiredOption("--type <percentage|fixed>", "Discount type").option("--amount <n>", "Amount in cents (fixed type)").option("--basis-points <n>", "Basis points (percentage type)").option("--max-redemptions <n>", "Maximum number of redemptions").option("--starts <date>", "Start date (ISO 8601)").option("--ends <date>", "End date (ISO 8601)").action(async function() {
     try {
       ensureAdminAuth();
@@ -2272,6 +2804,15 @@ function registerAdminDiscountsCommand(admin) {
       handleError(err);
     }
   });
+  discounts.command("sync-status").description("Show Polar sync stats for all discounts").action(async function() {
+    try {
+      ensureAdminAuth();
+      const data = await fetchApi("GET", "/admin/discounts/sync-status", { adminAuth: true });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
   discounts.command("export").description("Export discounts as CSV").option("--start <date>", "Start date filter (ISO 8601)").option("--end <date>", "End date filter (ISO 8601)").option("--status <all|active|expired>", "Filter by status", "all").action(async function() {
     try {
       ensureAdminAuth();
@@ -2290,6 +2831,133 @@ function registerAdminDiscountsCommand(admin) {
   });
 }
 
+// src/commands/admin/admin-discount-groups.ts
+var GROUP_COLUMNS = [
+  { key: "id", header: "ID", width: 12 },
+  { key: "name", header: "Name", width: 24 },
+  { key: "prefix", header: "Prefix", width: 12 },
+  { key: "type", header: "Type", width: 12 },
+  { key: "codesGenerated", header: "Generated", width: 10 },
+  { key: "codesUsed", header: "Used", width: 8 },
+  { key: "createdAt", header: "Created", width: 22 }
+];
+function buildGroupBody(opts) {
+  const body = {};
+  if (opts.name !== void 0) body["name"] = opts.name;
+  if (opts.prefix !== void 0) body["prefix"] = opts.prefix;
+  if (opts.type !== void 0) {
+    if (opts.type !== "percentage" && opts.type !== "fixed") {
+      throw new CliError("--type must be 'percentage' or 'fixed'");
+    }
+    body["type"] = opts.type;
+  }
+  if (opts.amount !== void 0) {
+    const v = Number(opts.amount);
+    if (Number.isNaN(v) || v < 0) throw new CliError("--amount must be a non-negative number (cents)");
+    body["amount"] = v;
+  }
+  if (opts.basisPoints !== void 0) {
+    const v = Number(opts.basisPoints);
+    if (Number.isNaN(v) || v < 0 || v > 1e4) throw new CliError("--basis-points must be 0..10000");
+    body["basisPoints"] = v;
+  }
+  if (opts.duration !== void 0) {
+    if (!["once", "repeating", "forever"].includes(opts.duration)) {
+      throw new CliError("--duration must be one of: once, repeating, forever");
+    }
+    body["duration"] = opts.duration;
+  }
+  if (opts.durationInMonths !== void 0) {
+    const v = Number(opts.durationInMonths);
+    if (Number.isNaN(v) || v < 1 || v > 24) throw new CliError("--duration-in-months must be 1..24");
+    body["durationInMonths"] = v;
+  }
+  if (opts.maxRedemptionsPerCode !== void 0) {
+    const v = Number(opts.maxRedemptionsPerCode);
+    if (Number.isNaN(v) || v < 1) throw new CliError("--max-redemptions-per-code must be a positive integer");
+    body["maxRedemptionsPerCode"] = v;
+  }
+  if (opts.starts !== void 0) body["startsAt"] = opts.starts;
+  if (opts.ends !== void 0) body["endsAt"] = opts.ends;
+  return body;
+}
+function registerAdminDiscountGroupsCommand(admin) {
+  const groups = admin.command("discount-groups").description("Discount group management");
+  groups.command("list").description("List discount groups").option("--query <text>", "Search by name or prefix").option("--page <n>", "Page number", "1").option("--limit <n>", "Page size", "50").action(async function() {
+    try {
+      ensureAdminAuth();
+      const opts = this.opts();
+      const params = { page: String(opts.page), limit: String(opts.limit) };
+      if (opts.query) params["query"] = opts.query;
+      const data = await fetchApi("GET", "/admin/discount-groups", {
+        adminAuth: true,
+        params
+      });
+      formatOutput(data.items ?? data, getOutputOpts(this), GROUP_COLUMNS);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  groups.command("get <id>").description("Get a discount group by ID").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "discount group ID");
+      const data = await fetchApi("GET", `/admin/discount-groups/${id}`, { adminAuth: true });
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  groups.command("create").description("Create a discount group template").requiredOption("--name <name>", "Group name").requiredOption("--prefix <prefix>", "Code prefix (3-20 chars, uppercased)").requiredOption("--type <percentage|fixed>", "Discount type").option("--amount <n>", "Amount in cents (fixed type)").option("--basis-points <n>", "Basis points (percentage type, 0..10000)").option("--duration <once|repeating|forever>", "Discount duration").option("--duration-in-months <n>", "Months for repeating duration (1..24)").option("--max-redemptions-per-code <n>", "Per-code redemption cap").option("--starts <date>", "Start date (ISO 8601)").option("--ends <date>", "End date (ISO 8601)").action(async function() {
+    try {
+      ensureAdminAuth();
+      const body = buildGroupBody(this.opts());
+      const data = await fetchApi("POST", "/admin/discount-groups", {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`Discount group created: ${data?.group?.id ?? ""}`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  groups.command("update <id>").description("Update a discount group (all fields optional)").option("--name <name>", "Group name").option("--prefix <prefix>", "Code prefix").option("--type <percentage|fixed>", "Discount type").option("--amount <n>", "Amount in cents").option("--basis-points <n>", "Basis points").option("--duration <once|repeating|forever>", "Discount duration").option("--duration-in-months <n>", "Months for repeating").option("--max-redemptions-per-code <n>", "Per-code redemption cap").option("--starts <date>", "Start date (ISO 8601)").option("--ends <date>", "End date (ISO 8601)").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "discount group ID");
+      const body = buildGroupBody(this.opts());
+      if (Object.keys(body).length === 0) {
+        throw new CliError("At least one option must be provided to update.");
+      }
+      const data = await fetchApi("PATCH", `/admin/discount-groups/${id}`, {
+        adminAuth: true,
+        body
+      });
+      printSuccess(`Discount group ${id} updated.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  groups.command("delete <id>").description("Delete a discount group (soft-deletes member codes)").action(async function(id) {
+    try {
+      ensureAdminAuth();
+      validateId(id, "discount group ID");
+      const ok = await confirm(`Delete discount group ${id}? This soft-deletes all member codes.`);
+      if (!ok) {
+        console.log("Aborted.");
+        return;
+      }
+      const data = await fetchApi("DELETE", `/admin/discount-groups/${id}`, { adminAuth: true });
+      printSuccess(`Discount group ${id} deleted.`);
+      formatOutput(data, getOutputOpts(this));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+
 // src/commands/admin/admin-tiers.ts
 var TIER_COLUMNS = [
   { key: "id", header: "ID", width: 12 },
@@ -2325,15 +2993,17 @@ function registerAdminCommand(program2) {
   registerAdminBlogCommand(admin);
   registerAdminKeysCommand(admin);
   registerAdminInvitesCommand(admin);
+  registerAdminLicensesCommand(admin);
   registerAdminAdminsCommand(admin);
   registerAdminDiscountsCommand(admin);
+  registerAdminDiscountGroupsCommand(admin);
   registerAdminTiersCommand(admin);
 }
 
 // src/index.ts
 loadDotenvFiles();
 var program = new Command();
-program.name("ckweb").description("CLI for interacting with ClaudeKit.cc API").version("0.3.0");
+program.name("ckweb").description("CLI for interacting with ClaudeKit.cc API").version("0.5.0");
 program.option("--json", "Output as JSON").option("--table", "Output as table").option("--quiet", "Minimal output");
 registerAuthCommand(program);
 registerHealthCommand(program);