rankcontrol 0.2.0 → 0.7.0

package/src/cli.mjs

@@ -12,13 +12,16 @@ const fail = (err) => {
 const list = (val) => val.split(",").map((s) => s.trim()).filter(Boolean);
 
 export function runCli(argv) {
+  const pkg = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8")
+  );
   const program = new Command();
   program
     .name("rankcontrol")
     .description(
       "RankControl from the terminal. Auth: `rankcontrol login` (browser approval) or export RANKCONTROL_API_KEY=rctrl_pk_..."
     )
-    .version("0.2.0");
+    .version(pkg.version);
 
   program
     .command("mcp")
@@ -30,11 +33,10 @@ export function runCli(argv) {
 
   program
     .command("login")
-    .description("Authenticate via your browser (approves a scoped API key into ~/.rankcontrol)")
-    .option("--scopes <a,b,c>", "Scopes to request (default: reads + write:content + write:publish)")
-    .action(async (opts) => {
+    .description("Authenticate via your browser (full workspace access; billing stays in the dashboard)")
+    .action(async () => {
       const { login } = await import("./login.mjs");
-      await login({ scopes: opts.scopes ? list(opts.scopes) : undefined }).catch(fail);
+      await login().catch(fail);
     });
 
   program
@@ -50,12 +52,53 @@ export function runCli(argv) {
     .description("AI pipeline last 30 days: crawls, AI visits, AI leads")
     .action(() => api.overviewFunnel().then(out).catch(fail));
 
+  program
+    .command("leads")
+    .description("Captured leads with source attribution (AI model, query, page)")
+    .option("--limit <n>", "Max rows, up to 500", "100")
+    .action((opts) => api.leads(Number(opts.limit)).then(out).catch(fail));
+
+  program
+    .command("traffic")
+    .description("Traffic overview: page views, visitors, sessions, bounce rate, time on page")
+    .option("--days <n>", "7, 30 or 90", "30")
+    .action((opts) => api.trafficOverview(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("score")
+    .description("Composite visibility score: 50% AI citation rate + 30% Google + 20% Bing rank share, with subscores")
+    .action(() => api.visibilityScore().then(out).catch(fail));
+
   program
     .command("visibility")
     .description("Daily AI visibility score trend from the stored weekly citation checks")
     .option("--days <n>", "30, 60 or 90", "30")
     .action((opts) => api.visibilityTrend(Number(opts.days)).then(out).catch(fail));
 
+  program
+    .command("sov")
+    .description("Share of voice: your citation rate vs top competitors, plus your share of all brand appearances")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.shareOfVoice(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sources")
+    .description("Domains AI answers cite for your tracked queries, typed brand/competitive/ugc/editorial")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSources(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sentiment")
+    .description("How AI answers frame your brand when cited: positive/neutral/negative with recent receipts")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSentiment(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("optimizer")
+    .description("Published pages ranked by citability score, worst first, with their open fixes")
+    .option("--limit <n>", "Max rows", "25")
+    .action((opts) => api.optimizer(Number(opts.limit)).then(out).catch(fail));
+
   program
     .command("citations")
     .description("Recent AI citation checks")
@@ -68,11 +111,254 @@ export function runCli(argv) {
         .catch(fail)
     );
 
+  program
+    .command("queries")
+    .description("List the tracked queries checked weekly across the AI engines")
+    .action(() => api.trackedQueries().then(out).catch(fail));
+
+  program
+    .command("crawler-access")
+    .description("Daily AI-crawler reachability probe (a diagnostic, not a metric): is the site's edge or robots.txt blocking GPTBot/ClaudeBot")
+    .action(() => api.crawlerAccess().then(out).catch(fail));
+
+  program
+    .command("analytics-sources")
+    .description("Per-org analytics sources: selections, qualified options, Cloudflare/plugin/embed install state")
+    .action(() => api.analyticsSources().then(out).catch(fail));
+
+  program
+    .command("analytics-set-source")
+    .description("Select the writer for a data type (validated against what the setup supports)")
+    .argument("<dataType>", "humanTraffic or aiCrawlers")
+    .argument("<source>", "embed, wordpress_plugin, cloudflare or none")
+    .action((dataType, source) =>
+      api.setAnalyticsSource(dataType, source).then(out).catch(fail)
+    );
+
+  program
+    .command("analytics-activate")
+    .description("Turn on the Analytics or Reports screen for this workspace")
+    .argument("<screen>", "analytics or reports")
+    .action((screen) => api.activateScreen(screen).then(out).catch(fail));
+
+  program
+    .command("cloudflare-connect")
+    .description("Print the Cloudflare OAuth URL to connect read-only crawler analytics")
+    .action(() =>
+      api
+        .cloudflareConnectUrl()
+        .then((d) => out(d?.url ?? d))
+        .catch(fail)
+    );
+
+  program
+    .command("cloudflare-zones")
+    .description("List Cloudflare zones visible to the connected grant")
+    .action(() => api.cloudflareZones().then(out).catch(fail));
+
+  program
+    .command("cloudflare-zone")
+    .description("Pick the polled zone (also selects Cloudflare as the AI-crawler source and starts the first sync)")
+    .argument("<zoneId>", "Zone id from cloudflare-zones")
+    .argument("<zoneName>", "Zone name, e.g. example.com")
+    .action((zoneId, zoneName) =>
+      api.cloudflareSelectZone(zoneId, zoneName).then(out).catch(fail)
+    );
+
+  program
+    .command("framer-install-embed")
+    .description("Install site-wide tracking on the Framer project (dry run without --confirm; installing also publishes the Framer site)")
+    .option("--integration <id>", "Integration id (defaults to the org's Framer integration)")
+    .option("--confirm", "Actually install", false)
+    .action((opts) =>
+      api
+        .framerInstallEmbed({
+          ...(opts.integration ? { integrationId: opts.integration } : {}),
+          confirm: Boolean(opts.confirm),
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("webflow-custom-code")
+    .description("Install the tracking loader via Webflow's Custom Code API (dry run without --confirm; live on the customer's next site publish)")
+    .option("--integration <id>", "Integration id (defaults to the org's Webflow integration)")
+    .option("--token <token>", "New site token with CMS + Custom code scopes (replaces the stored one)")
+    .option("--confirm", "Actually install", false)
+    .action((opts) =>
+      api
+        .webflowInstallCustomCode({
+          ...(opts.integration ? { integrationId: opts.integration } : {}),
+          ...(opts.token ? { apiToken: opts.token } : {}),
+          confirm: Boolean(opts.confirm),
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("query-add")
+    .description("Add a query to the tracking pool (tracks immediately when a plan slot is free)")
+    .argument("<queryText>", "The search/AI query to track")
+    .action((queryText) => api.addQuery(queryText).then(out).catch(fail));
+
+  program
+    .command("query-remove")
+    .description("Delete a query from the tracking pool")
+    .argument("<queryId>", "Query id (from the queries command)")
+    .action((queryId) => api.removeQuery(queryId).then(out).catch(fail));
+
+  program
+    .command("query-track")
+    .description("Pause or resume weekly checks on a query. Tracking uses a plan slot; pausing frees it")
+    .argument("<queryId>", "Query id (from the queries command)")
+    .argument("<state>", "on | off")
+    .action((queryId, state) =>
+      api.setQueryTracking(queryId, state === "on").then(out).catch(fail)
+    );
+
+  program
+    .command("query-edit")
+    .description("Rewrite a tracked query's text")
+    .argument("<queryId>", "Query id (from the queries command)")
+    .argument("<queryText>", "New query text")
+    .action((queryId, queryText) =>
+      api.updateQuery(queryId, queryText).then(out).catch(fail)
+    );
+
+  program
+    .command("competitors")
+    .description("Tracked competitors used in share-of-voice and visibility comparisons")
+    .action(() => api.competitors().then(out).catch(fail));
+
+  program
+    .command("competitor-add")
+    .description("Track a competitor (max 10)")
+    .argument("<name>", "Competitor name")
+    .argument("<websiteUrl>", "Competitor website URL")
+    .action((name, websiteUrl) =>
+      api.addCompetitor(name, websiteUrl).then(out).catch(fail)
+    );
+
+  program
+    .command("competitor-remove")
+    .description("Stop tracking a competitor")
+    .argument("<competitorId>", "Competitor id (from the competitors command)")
+    .action((competitorId) =>
+      api.removeCompetitor(competitorId).then(out).catch(fail)
+    );
+
+  program
+    .command("topics")
+    .description("The pillar list (topic clusters): queries, ideas and planned articles group under these")
+    .action(() => api.topics().then(out).catch(fail));
+
+  program
+    .command("topics-set")
+    .description("Replace the full pillar list (create/dedupe/safe-delete reconcile)")
+    .argument("<topics...>", "Topic names, space-separated (quote multi-word topics)")
+    .action((topics) => api.setTopics(topics).then(out).catch(fail));
+
+  program
+    .command("delete-planned")
+    .description("Remove a planned title from the calendar; the title returns to Content Ideas")
+    .argument("<contentId>", "Planned contentPage id")
+    .action((contentId) => api.deletePlanned(contentId).then(out).catch(fail));
+
   program
     .command("capacity")
     .description("Remaining plan slots on the content calendar")
     .action(() => api.planningCapacity().then(out).catch(fail));
 
+  program
+    .command("team")
+    .description("Workspace members and pending invites (owner surface)")
+    .action(() => api.team().then(out).catch(fail));
+
+  program
+    .command("team-invite")
+    .description("Invite a member (dry-run by default; --confirm sends the email)")
+    .argument("<email>", "Invitee email")
+    .option(
+      "--perms <area=level,...>",
+      "Per-screen levels, e.g. content=write,analytics=read (unspecified screens default to none)"
+    )
+    .option("--confirm", "Actually send the invite")
+    .action((email, opts) => {
+      const screenPermissions = {};
+      for (const pair of (opts.perms ?? "").split(",").filter(Boolean)) {
+        const [area, level] = pair.split("=");
+        screenPermissions[area?.trim()] = level?.trim();
+      }
+      return api
+        .teamInvite({
+          email,
+          ...(Object.keys(screenPermissions).length ? { screenPermissions } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail);
+    });
+
+  program
+    .command("team-revoke")
+    .description("Revoke a pending invite")
+    .argument("<invitationId>", "Invitation id from `team`")
+    .action((invitationId) => api.teamRevoke(invitationId).then(out).catch(fail));
+
+  program
+    .command("team-remove")
+    .description("Remove a member (requires --confirm)")
+    .argument("<userId>", "Member user id from `team`")
+    .option("--confirm", "Actually remove the member")
+    .action((userId, opts) =>
+      api
+        .teamRemove({ userId, confirm: !!opts.confirm })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("outreach-prospects")
+    .description("Link outreach pipeline with any found contact emails")
+    .action(() => api.outreachProspects().then(out).catch(fail));
+
+  program
+    .command("outreach-find-contact")
+    .description("Find an outreach email for a prospect (scrapes their site)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachFindContact(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-draft-reply")
+    .description("AI-draft a reply to a prospect's inbound response (nothing sends)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachDraftReply(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-queue")
+    .description("Queue an outreach email to send from the connected mailbox (dry-run by default)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .option("--subject <subject>", "Override the drafted subject")
+    .option("--body <body>", "Override the drafted body")
+    .option("--confirm", "Actually queue the send")
+    .action((backlinkId, opts) =>
+      api
+        .outreachQueue({
+          backlinkId,
+          ...(opts.subject ? { subject: opts.subject } : {}),
+          ...(opts.body ? { body: opts.body } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
   program
     .command("jobs")
     .description("Recent agent runs (async job status)")
@@ -131,5 +417,362 @@ export function runCli(argv) {
       api.publishContent(contentId, !!opts.confirm).then(out).catch(fail)
     );
 
+  program
+    .command("generate <contentId>")
+    .description("Write a planned article's body now, keeping its publish slot (past-due or ≤3 days ahead; dry run unless --confirm)")
+    .option("--confirm", "Actually start generation (spends LLM budget)")
+    .action((contentId, opts) =>
+      api.generateContent(contentId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("shopify-install-url <shop>")
+    .description("Mint a Shopify app install link for your store (open it in a browser; the destination is added to the workspace automatically)")
+    .action((shop) => api.shopifyInstallUrl(shop).then(out).catch(fail));
+
+  program
+    .command("settings")
+    .description("Show the article policy: per-article defaults + flexible scheduling")
+    .action(() => api.articleSettings().then(out).catch(fail));
+
+  const onOff = (val) => {
+    if (val === "on" || val === "true") return true;
+    if (val === "off" || val === "false") return false;
+    throw new Error(`Expected on|off, got "${val}"`);
+  };
+
+  program
+    .command("settings-set")
+    .description("Merge-patch the article policy (only flags you pass change)")
+    .option("--auto-publish <on|off>")
+    .option("--auto-generate <on|off>", "Off = fully manual: write articles only on demand (generate command / Write now)")
+    .option("--images <on|off>", "AI hero + section images")
+    .option("--title-in-hero <on|off>", "Write the post title into the hero image")
+    .option("--section-infographics <on|off>", "Informational panels in 2,000+ word articles")
+    .option("--related-reading <on|off>", "Related Reading link block at the end")
+    .option("--youtube <on|off>", "Embedded video suggestions")
+    .option("--emojis <on|off>")
+    .option("--internal-links <n>", "Internal links per article (1-20)")
+    .option("--external-links <n>", "Outbound authority links per article (0-15)")
+    .option("--instructions <text>", "Global editorial instructions")
+    .option("--flexible-schedule <on|off>", "1-5 articles/day + calendar drag-and-drop")
+    .option(
+      "--image-style <set>",
+      "Image style set for all generated images: classic-editorial | print-craft | storybook-painterly | modern-saas | dark-premium | bold-poster"
+    )
+    .action((opts) => {
+      try {
+        const s = {};
+        if (opts.autoPublish !== undefined) s.autoPublish = onOff(opts.autoPublish);
+        if (opts.autoGenerate !== undefined) s.autoGenerate = onOff(opts.autoGenerate);
+        if (opts.images !== undefined) s.includeInfographics = onOff(opts.images);
+        if (opts.titleInHero !== undefined) s.titleInHeroImage = onOff(opts.titleInHero);
+        if (opts.sectionInfographics !== undefined)
+          s.includeSectionInfographics = onOff(opts.sectionInfographics);
+        if (opts.relatedReading !== undefined)
+          s.includeRelatedReading = onOff(opts.relatedReading);
+        if (opts.youtube !== undefined) s.includeYouTube = onOff(opts.youtube);
+        if (opts.emojis !== undefined) s.useEmojis = onOff(opts.emojis);
+        if (opts.internalLinks !== undefined)
+          s.internalLinksPerArticle = Number(opts.internalLinks);
+        if (opts.externalLinks !== undefined)
+          s.externalLinksPerArticle = Number(opts.externalLinks);
+        if (opts.instructions !== undefined) s.globalInstructions = opts.instructions;
+        const body = {};
+        if (Object.keys(s).length > 0) body.articleSettings = s;
+        if (opts.flexibleSchedule !== undefined)
+          body.flexibleScheduling = onOff(opts.flexibleSchedule);
+        if (opts.imageStyle !== undefined) body.styleSet = opts.imageStyle;
+        if (Object.keys(body).length === 0)
+          throw new Error("Pass at least one flag to change (see --help)");
+        return api.updateArticleSettings(body).then(out).catch(fail);
+      } catch (err) {
+        fail(err);
+      }
+    });
+
+  program
+    .command("reschedule <contentId> <date>")
+    .description("Move a planned article to a day (YYYY-MM-DD, local time; needs the flexible schedule)")
+    .action((contentId, date) => {
+      const day = new Date(`${date}T00:00:00`);
+      if (Number.isNaN(day.getTime())) return fail(new Error("Date must be YYYY-MM-DD"));
+      return api.reschedule(contentId, day.getTime()).then(out).catch(fail);
+    });
+
+  program
+    .command("internal-links <contentId>")
+    .description("Inbound and outbound internal links recorded for an article (from the publish-time link graph)")
+    .action((contentId) => api.internalLinks(contentId).then(out).catch(fail));
+
+  program
+    .command("site-pages")
+    .description("List the site pages used for in-article links and Related Reading")
+    .action(() => api.sitePages().then(out).catch(fail));
+
+  program
+    .command("detect-links <url>")
+    .description("Scan a sitemap (nested indexes too) or a blog root page for site pages")
+    .option("--blog-root", "Treat the URL as a page to crawl instead of a sitemap")
+    .action((url, opts) =>
+      api
+        .detectSiteLinks(opts.blogRoot ? "blogroot" : "sitemap", url)
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("add-pages <urls...>")
+    .description("Add site page URLs for internal linking (dedupes; titles auto-fill)")
+    .action((urls) => api.addSitePages(urls).then(out).catch(fail));
+
+  program
+    .command("repurpose [contentId]")
+    .description("Repurpose queue (published articles + draft chips), or full drafts for one article")
+    .action((contentId) =>
+      (contentId ? api.repurposeDrafts(contentId) : api.repurposeQueue())
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-generate <contentId>")
+    .description("Draft social posts for a published article (dry run unless --confirm; spends LLM budget)")
+    .option(
+      "--platforms <a,b>",
+      "Subset: linkedin,twitter,pinterest,instagram,facebook,threads,youtube,tiktok"
+    )
+    .option("--confirm", "Actually generate")
+    .action((contentId, opts) =>
+      api
+        .repurposeGenerate({
+          contentId,
+          platforms: opts.platforms ? list(opts.platforms) : undefined,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-edit <draftId>")
+    .description("Edit a repurpose draft's text/title before pushing")
+    .option("--body <text>")
+    .option("--title <text>")
+    .action((draftId, opts) =>
+      api
+        .repurposeEditDraft({ draftId, body: opts.body, title: opts.title })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-mark-posted <draftId>")
+    .description("Mark a draft as posted (you published it yourself)")
+    .action((draftId) => api.repurposeMarkPosted(draftId).then(out).catch(fail));
+
+  program
+    .command("repurpose-channels")
+    .description("Connected Postiz channels (ids needed for repurpose-push)")
+    .action(() => api.repurposeChannels().then(out).catch(fail));
+
+  program
+    .command("repurpose-push <draftId>")
+    .description("Send a draft to Postiz (dry run unless --confirm)")
+    .option("--channels <id1,id2>", "Postiz channel ids (see repurpose-channels)")
+    .option("--when <now|schedule|draft>", "Postiz mode", "now")
+    .option("--date <iso>", "ISO time for --when schedule")
+    .option("--confirm", "Actually push (publicly visible)")
+    .action((draftId, opts) =>
+      api
+        .repurposePush({
+          draftId,
+          integrationIds: opts.channels ? list(opts.channels) : undefined,
+          scheduleType: opts.when,
+          date: opts.date,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  const parseJson = (raw, label) => {
+    try {
+      return JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      fail(new Error(`--json for ${label} must be valid JSON (or @file.json)`));
+    }
+  };
+
+  program
+    .command("ideas")
+    .description("Scored content-idea backlog: uncovered queries, citation gaps, quick wins")
+    .action(() => api.contentIdeas().then(out).catch(fail));
+
+  program
+    .command("plan-idea <queryText>")
+    .description("Put an idea on the content calendar (uses its stored title, or generates one)")
+    .option("--title <title>", "Exact headline to plan")
+    .action((queryText, opts) =>
+      api.planIdea({ queryText, title: opts.title }).then(out).catch(fail)
+    );
+
+  program
+    .command("archive <contentId>")
+    .description("Archive an article (removes it from the working set)")
+    .action((contentId) => api.archiveContent(contentId).then(out).catch(fail));
+
+  program
+    .command("engagement")
+    .description("Per-page views + citations for the last 30 days, with view sparklines")
+    .action(() => api.pageEngagement().then(out).catch(fail));
+
+  program
+    .command("report")
+    .description("Executive summary: last 30 days vs the 30 before (citations, views, crawls, publishing)")
+    .action(() => api.reportSummary().then(out).catch(fail));
+
+  program
+    .command("wins")
+    .description("Biggest wins of the last 30 days: top cited page, cite-rate jump, ranking climb, best backlink")
+    .action(() => api.reportWins().then(out).catch(fail));
+
+  program
+    .command("agent-activity")
+    .description("Recent runs per agent lane (brand control, radar, forge, deploy, ...)")
+    .option("--per-agent <n>", "Runs per lane, up to 50", "15")
+    .option("--since-days <n>", "Window in days", "30")
+    .action((opts) =>
+      api
+        .agentActivity({ perAgent: Number(opts.perAgent), sinceDays: Number(opts.sinceDays) })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("backlinks")
+    .description("The backlink table, newest first")
+    .option("--status <status>", "Filter: discovered, verified, lost, identified, contacted, replied, link_placed, rejected")
+    .action((opts) => api.backlinks(opts.status).then(out).catch(fail));
+
+  program
+    .command("backlink-stats")
+    .description("Backlink totals + the outreach pipeline counts")
+    .action(() => api.backlinkStats().then(out).catch(fail));
+
+  program
+    .command("outreach-status <backlinkId> <status>")
+    .description("Move an outreach prospect through the pipeline (identified|contacted|replied|link_placed|rejected)")
+    .action((backlinkId, status) =>
+      api.outreachStatus(backlinkId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("network")
+    .description("Link Network credit stats, membership state, and hosted/received placements")
+    .action(() => api.linkNetwork().then(out).catch(fail));
+
+  program
+    .command("network-opt-in <on|off>")
+    .description("Join or leave the Link Network (dry run unless --confirm; leaving retires live links)")
+    .option("--confirm", "Actually change membership")
+    .action((state, opts) =>
+      api.linkNetworkOptIn(state === "on", !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("network-remove-placement <placementId>")
+    .description("Retire one network placement (dry run unless --confirm; visible on the partner site)")
+    .option("--confirm", "Actually remove it")
+    .action((placementId, opts) =>
+      api.linkNetworkRemovePlacement(placementId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("social")
+    .description("Social thread prospects (Reddit/X) with rules context and intent sort")
+    .option("--platform <reddit|twitter>")
+    .option("--status <status>")
+    .option("--age <ranked|new>")
+    .action((opts) =>
+      api
+        .socialThreads({ platform: opts.platform, status: opts.status, age: opts.age })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("social-stats")
+    .description("Social thread pipeline counts")
+    .action(() => api.socialStats().then(out).catch(fail));
+
+  program
+    .command("social-status <threadId> <status>")
+    .description("Move a social thread through the pipeline")
+    .action((threadId, status) =>
+      api.socialStatus(threadId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("social-draft-reply <threadId>")
+    .description("AI-draft a reply for a thread (nothing posts; the draft lands for review)")
+    .option("--mention <none|natural|founderOpen>", "Brand-mention mode")
+    .action((threadId, opts) =>
+      api.socialDraftReply(threadId, opts.mention).then(out).catch(fail)
+    );
+
+  program
+    .command("support <subject>")
+    .description("Send a message or bug report to RankControl support (emails the team, capped 3/min)")
+    .requiredOption("--message <text>", "What happened — include errors, ids, and steps")
+    .option("--page <url>", "Related dashboard or API URL")
+    .action((subject, opts) =>
+      api.support({ subject, message: opts.message, pageUrl: opts.page }).then(out).catch(fail)
+    );
+
+  program
+    .command("brand")
+    .description("Brand profile, products, and buyer profiles (ICPs) in one read")
+    .action(() => api.brand().then(out).catch(fail));
+
+  program
+    .command("brand-set")
+    .description("Update brand identity: name, industry, product description, authors, style reference URLs")
+    .option("--name <name>", "Company/brand name")
+    .option("--industry <industry>", "Industry label")
+    .option("--description <text>", "Product description")
+    .option("--json <json>", "Full patch as JSON (or @file.json): {name?, industry?, productDescription?, authors?, styleReferenceUrls?}; authors/styleReferenceUrls replace the stored list")
+    .action((opts) => {
+      const patch = opts.json ? parseJson(opts.json, "brand-set") : {};
+      if (opts.name) patch.name = opts.name;
+      if (opts.industry) patch.industry = opts.industry;
+      if (opts.description) patch.productDescription = opts.description;
+      api.brandIdentitySet(patch).then(out).catch(fail);
+    });
+
+  program
+    .command("brand-profile-set")
+    .description("Patch brand voice/style fields. --json '{\"tone\":\"...\"}' or --json @file.json")
+    .requiredOption("--json <json>", "Fields: tone, primaryColor, secondaryColor, fontFamily, metaTitle, metaDescription, metaKeywords, defaultLocale, flexibleScheduling")
+    .action((opts) =>
+      api.brandProfileSet(parseJson(opts.json, "brand-profile-set")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-product")
+    .description("Create, update, or delete a product. Create: name+description+category; update: productId + fields; delete: productId + del:true")
+    .requiredOption("--json <json>", "Product JSON (or @file.json)")
+    .action((opts) =>
+      api.brandProductWrite(parseJson(opts.json, "brand-product")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-icp")
+    .description("Create, update, or delete a buyer profile. Create: title+industry+demographics; update: profileId + fields; delete: profileId + del:true")
+    .requiredOption("--json <json>", "Buyer profile JSON (or @file.json)")
+    .action((opts) =>
+      api.brandIcpWrite(parseJson(opts.json, "brand-icp")).then(out).catch(fail)
+    );
+
   program.parseAsync(argv);
 }