@a8techads/cli 0.4.2 → 0.4.4

package/dist/a8techads.js

@@ -4096,7 +4096,8 @@ function printSectionedCampaignDetail(campaign) {
         supplyProductCount: campaign.supplyProductCount ?? (Array.isArray(campaign.supplyProductIds) ? campaign.supplyProductIds.length : 0),
         supplyProducts: formatSupplyProducts(campaign.supplyProducts),
         sspPartnerIds: formatScalar(campaign.sspPartnerIds),
-        sourceMasking: formatScalar(campaign.sourceMasking)
+        sourceMasking: formatScalar(campaign.sourceMasking),
+        bidderAlgorithmId: campaign.bidderAlgorithmId
       }
     },
     {
@@ -4217,7 +4218,7 @@ Examples:
     }
     console.log(`Campaign created: ${json.data?.id ?? json.id}`);
   });
-  cmd.command("update").description("Update an existing campaign.").argument("<id>", "Campaign ID").option("--name <name>", "New name").option("--budget <amount>", "New daily budget").option("--max-bid <amount>", "Set priceSettings.maxBid without overwriting existing price settings").option("--clear-max-bid", "Remove priceSettings.maxBid without overwriting other price settings").option("--supply-products <ids>", "Comma-separated supply product bindings").option("--preferred-supply <ids>", "Deprecated alias for --supply-products").option("--clear-supply-products", "Remove all supply product bindings").option("--clear-preferred-supply", "Deprecated alias for --clear-supply-products").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
+  cmd.command("update").description("Update an existing campaign.").argument("<id>", "Campaign ID").option("--name <name>", "New name").option("--budget <amount>", "New daily budget").option("--max-bid <amount>", "Set priceSettings.maxBid without overwriting existing price settings").option("--clear-max-bid", "Remove priceSettings.maxBid without overwriting other price settings").option("--supply-products <ids>", "Comma-separated supply product bindings").option("--preferred-supply <ids>", "Deprecated alias for --supply-products").option("--clear-supply-products", "Remove all supply product bindings").option("--clear-preferred-supply", "Deprecated alias for --clear-supply-products").option("--bidder-algorithm <id>", "Bind a bidder algorithm").option("--bidder-algorithm-id <id>", "Bind a bidder algorithm").option("--clear-bidder-algorithm", "Remove bidder algorithm binding").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
     let body;
     if (opts.fromJson) {
       const { readFileSync: readFileSync4 } = await import("fs");
@@ -4238,14 +4239,22 @@ Examples:
         console.error("Error: use either --supply-products or --clear-supply-products, not both.");
         process.exit(1);
       }
+      const bidderAlgorithmId = opts.bidderAlgorithm ?? opts.bidderAlgorithmId;
+      if (bidderAlgorithmId && opts.clearBidderAlgorithm) {
+        console.error("Error: use either --bidder-algorithm or --clear-bidder-algorithm, not both.");
+        process.exit(1);
+      }
       const updatesSupplyBindings = Boolean(supplyProducts || clearSupplyProducts);
-      if (updatesSupplyBindings) {
+      const updatesBidderAlgorithm = Boolean(bidderAlgorithmId || opts.clearBidderAlgorithm);
+      if (updatesSupplyBindings || updatesBidderAlgorithm) {
         const campaign = await fetchCampaign(id);
         if (String(campaign.status || "").toUpperCase() === "ACTIVE") {
-          console.error("Error: active campaigns cannot change supply product bindings via update.");
+          const field = updatesSupplyBindings ? "supply product bindings" : "bidder algorithm binding";
+          const updateArg = updatesSupplyBindings ? supplyProducts ? `--supply-products ${supplyProducts}` : "--clear-supply-products" : bidderAlgorithmId ? `--bidder-algorithm ${bidderAlgorithmId}` : "--clear-bidder-algorithm";
+          console.error(`Error: active campaigns cannot change ${field} via update.`);
           console.error(`Next steps:`);
           console.error(`  a8techads campaigns pause ${id}`);
-          console.error(`  a8techads campaigns update ${id} ${supplyProducts ? `--supply-products ${supplyProducts}` : "--clear-supply-products"}`);
+          console.error(`  a8techads campaigns update ${id} ${updateArg}`);
           console.error(`  a8techads campaigns resume ${id}`);
           process.exit(1);
         }
@@ -4263,6 +4272,10 @@ Examples:
         body.supplyProductIds = parseCsvList(supplyProducts);
       if (clearSupplyProducts)
         body.supplyProductIds = [];
+      if (bidderAlgorithmId)
+        body.bidderAlgorithmId = bidderAlgorithmId;
+      if (opts.clearBidderAlgorithm)
+        body.bidderAlgorithmId = null;
     }
     const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/campaigns/${id}`, body });
     if (!resp.ok) {
@@ -5129,7 +5142,16 @@ Examples:
     }
     console.log(`Zone ${id} deleted.`);
   });
-  cmd.command("tag").description("Get the ad tag code for a zone (JS or VAST).").argument("<id>", "Zone ID").action(async (id) => {
+  cmd.command("tag").description("Get or generate the ad tag code for a zone.").argument("<id>", "Zone ID").option("--local", "Generate tag locally without calling the API").option("--variant <variant>", "Tag variant: js or iframe", "js").option("--format <format>", "Zone format: banner, popunder, offerwall, rewarded_video, native, video").option("--ad-server <url>", "Bidder/ad server URL", "https://bidder.a8.tech").option("--loader-url <url>", "Loader script URL", "https://assets.a8.tech/tags/v1/loader.js").option("--sizes <sizes>", "Comma-separated sizes for display tags, e.g. 728x90,300x250").option("--theme <theme>", "Theme for offerwall/rewarded tags, e.g. light or dark").option("--sub <sub>", "Publisher player/user identifier macro", "{YOUR_PLAYER_ID}").option("--keywords <keywords>", "Comma-separated targeting keywords").option("--limit <n>", "Offerwall max offers", "20").option("--button-text <text>", "Rewarded video button text", "Watch and earn reward").addHelpText("after", `
+Examples:
+  $ a8techads zones tag <id>
+  $ a8techads zones tag <id> --local --format offerwall --theme dark --sub player-123
+  $ a8techads zones tag <id> --local --format rewarded_video --button-text "Watch ad"
+  $ a8techads zones tag <id> --local --variant iframe --format banner --sizes 728x90`).action(async (id, opts) => {
+    if (shouldGenerateLocalTag(opts)) {
+      console.log(buildZoneTag(id, opts));
+      return;
+    }
     const resp = await apiRequest({ path: `${sspPrefix()}/zones/${id}/tag` });
     const json = await resp.json();
     if (!resp.ok) {
@@ -5140,6 +5162,111 @@ Examples:
   });
   return cmd;
 }
+function shouldGenerateLocalTag(opts) {
+  return Boolean(opts.local || opts.variant !== "js" || opts.format || opts.theme || opts.sub !== "{YOUR_PLAYER_ID}" || opts.keywords || opts.sizes || opts.limit !== "20" || opts.buttonText !== "Watch and earn reward");
+}
+function buildZoneTag(zoneId, opts) {
+  const format = normalizeFormat(opts.format);
+  if (!format) {
+    console.error("Error: --format is required when generating a local tag.");
+    process.exit(1);
+  }
+  const variant = String(opts.variant).trim().toLowerCase();
+  if (variant === "iframe")
+    return buildIframeTag(zoneId, format, opts);
+  if (variant !== "js") {
+    console.error("Error: --variant must be js or iframe.");
+    process.exit(1);
+  }
+  return buildJavascriptTag(zoneId, format, opts);
+}
+function buildJavascriptTag(zoneId, format, opts) {
+  const divId = `alpineads-${zoneId.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 20)}`;
+  const attrs = {
+    id: divId,
+    "data-zone": zoneId,
+    "data-format": format,
+    "data-ad-server": cleanUrl(opts.adServer)
+  };
+  if (opts.sizes)
+    attrs["data-sizes"] = opts.sizes;
+  if (format === "offerwall") {
+    attrs["data-limit"] = String(opts.limit ?? "20");
+    attrs["data-theme"] = opts.theme ?? "dark";
+    attrs["data-sub"] = opts.sub;
+  }
+  if (format === "rewarded_video") {
+    attrs["data-theme"] = opts.theme ?? "dark";
+    attrs["data-sub"] = opts.sub;
+    attrs["data-button-text"] = opts.buttonText;
+  }
+  if (opts.keywords)
+    attrs["data-keywords"] = opts.keywords;
+  const attrLines = Object.entries(attrs).map(([key, value], index) => `${index === 0 ? "" : "     "}${key}="${escapeHtml(String(value ?? ""))}"`).join(`
+`);
+  return `<!-- AlpineAds Zone: ${zoneId} -->
+<div ${attrLines}>
+</div>
+<script async src="${escapeHtml(cleanUrl(opts.loaderUrl))}"></script>`;
+}
+function buildIframeTag(zoneId, format, opts) {
+  const params = new URLSearchParams;
+  params.set("format", format);
+  if (opts.sizes)
+    params.set("sizes", opts.sizes);
+  if (shouldIncludeSub(format, opts.sub))
+    params.set("sub", opts.sub);
+  if (opts.keywords)
+    params.set("keywords", opts.keywords);
+  if (format === "offerwall") {
+    params.set("limit", String(opts.limit ?? "20"));
+    params.set("theme", opts.theme ?? "dark");
+  }
+  if (format === "rewarded_video") {
+    params.set("theme", opts.theme ?? "dark");
+  }
+  const size = iframeSize(format, opts.sizes);
+  const src = `${cleanUrl(opts.adServer)}/ad/${encodeURIComponent(zoneId)}?${params.toString()}`;
+  return `<!-- AlpineAds Zone: ${zoneId} -->
+<iframe src="${escapeHtml(src)}"
+        width="${size.width}" height="${size.height}"
+        frameborder="0" scrolling="no"
+        style="border:none;overflow:hidden"></iframe>`;
+}
+function normalizeFormat(value) {
+  if (!value)
+    return null;
+  const normalized = String(value).trim().toLowerCase().replace(/-/g, "_");
+  if (normalized === "rewarded" || normalized === "rewardedvideo")
+    return "rewarded_video";
+  if (normalized === "offer_wall")
+    return "offerwall";
+  return normalized;
+}
+function shouldIncludeSub(format, sub) {
+  if (!sub)
+    return false;
+  if (format === "offerwall" || format === "rewarded_video")
+    return true;
+  return String(sub) !== "{YOUR_PLAYER_ID}";
+}
+function iframeSize(format, sizes) {
+  const firstSize = String(sizes ?? "").split(",")[0]?.trim();
+  const match = firstSize?.match(/^(\d+)x(\d+)$/);
+  if (match)
+    return { width: match[1], height: match[2] };
+  if (format === "offerwall")
+    return { width: "320", height: "480" };
+  if (format === "rewarded_video")
+    return { width: "640", height: "360" };
+  return { width: "300", height: "250" };
+}
+function cleanUrl(value) {
+  return String(value).replace(/\/+$/, "");
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
 
 // src/commands/reports.ts
 function createReportsCommand() {
@@ -5148,6 +5275,7 @@ function createReportsCommand() {
 Routes based on current capability (DSP or SSP).`).addHelpText("after", `
 Examples:
   $ a8techads reports query --metrics spend,impressions --dimensions date
+  $ a8techads reports ssp-pull --from 2026-06-14 --to 2026-06-15 --group-by zone,day,country
   $ a8techads reports list
   $ a8techads reports templates`);
   addFormatOption(cmd.command("query").description(`Execute an ad-hoc analytics query.
@@ -5195,6 +5323,54 @@ Summary:`);
       }
     }
   });
+  addFormatOption(cmd.command("ssp-pull").description(`Pull authoritative SSP reporting data for reconciliation.
+
+Requires: PUBLISHER capability and an SSP tenant context.`).requiredOption("--from <date>", "Start date/time, e.g. 2026-06-14 or 2026-06-14T00:00:00Z").requiredOption("--to <date>", "End date/time, e.g. 2026-06-15 or 2026-06-15T00:00:00Z").option("--group-by <list>", "Comma-separated group dimensions", "zone,day").option("--metrics <list>", "Comma-separated metrics", "requests,fills,impressions,clicks,revenue").option("--timezone <tz>", "Report timezone", "UTC").option("--zone <id>", "Filter by zone ID").option("--site <id>", "Filter by site ID").option("--country <code>", "Filter by ISO country code").option("--device <type>", "Filter by device type").option("--campaign <id>", "Filter by campaign ID").option("--variation <id>", "Filter by variation ID").option("--format-type <format>", "Filter by ad format/zone type").option("--sub-id1 <value>", "Filter by sub_id1").option("--limit <n>", "Max rows", "500").option("--offset <n>", "Result offset", "0").addHelpText("after", `
+Examples:
+  $ a8techads reports ssp-pull --from 2026-06-14 --to 2026-06-15 --group-by zone,day,country
+  $ a8techads reports ssp-pull --from 2026-06-14 --to 2026-06-15 --zone <zone-id> --metrics impressions,clicks,revenue --format json`)).action(async (opts) => {
+    const params = new URLSearchParams;
+    params.set("from", opts.from);
+    params.set("to", opts.to);
+    params.set("group_by", opts.groupBy);
+    params.set("metrics", opts.metrics);
+    params.set("timezone", opts.timezone);
+    params.set("limit", opts.limit);
+    params.set("offset", opts.offset);
+    const filters = [
+      ["zone_id", opts.zone],
+      ["site_id", opts.site],
+      ["country", opts.country],
+      ["device", opts.device],
+      ["campaign_id", opts.campaign],
+      ["variation_id", opts.variation],
+      ["format", opts.formatType],
+      ["sub_id1", opts.subId1]
+    ];
+    for (const [key, value] of filters) {
+      if (value !== undefined && value !== null && String(value) !== "")
+        params.set(key, String(value));
+    }
+    const resp = await apiRequest({ path: `${sspPrefix()}/reports?${params}` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.message ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const data = json.data ?? json;
+    const rows = data.rows ?? data.results ?? data;
+    if (opts.format === "json") {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!Array.isArray(rows) || rows.length === 0) {
+      console.log("No results.");
+      return;
+    }
+    const keys = Object.keys(rows[0]);
+    const columns = keys.map((k) => ({ key: k, header: k.toUpperCase(), width: Math.max(k.length, 12) }));
+    printData(rows, columns, opts.format);
+  });
   addFormatOption(cmd.command("list").description("List saved reports.")).action(async (opts) => {
     const resp = await apiRequest({ path: `${getApiPrefix()}/reports/saved` });
     const json = await resp.json();
@@ -5614,7 +5790,7 @@ Examples:
     }
     printDetail(json.data ?? json, opts.format);
   });
-  tenants.command("create").description("Create a new tenant with admin user.").option("--name <name>", "Company name (required)").option("--email <email>", "Admin email (required)").option("--admin-name <name>", "Admin user name").option("--capabilities <caps>", "Comma-separated capabilities: ADVERTISER,PUBLISHER", "ADVERTISER").addHelpText("after", `
+  tenants.command("create").description("Create a new tenant with admin user.").option("--name <name>", "Company name (required)").option("--email <email>", "Admin email (required unless --tenant-type is INTERNAL_SSP or EXTERNAL_SSP)").option("--admin-name <name>", "Admin user name").option("--tenant-type <type>", "Tenant type: ADVERTISER, PUBLISHER, INTERNAL_SSP, EXTERNAL_SSP").option("--capabilities <caps>", "Comma-separated capabilities: ADVERTISER,PUBLISHER", "ADVERTISER").addHelpText("after", `
 Examples:
   $ a8techads admin tenants create --name "Acme Corp" --email admin@acme.com
   $ a8techads admin tenants create --name "MediaCo" --email admin@media.co --capabilities ADVERTISER,PUBLISHER`).action(async (opts) => {
@@ -5622,17 +5798,20 @@ Examples:
       console.error("Error: --name is required.");
       process.exit(1);
     }
-    if (!opts.email) {
+    const tenantType = opts.tenantType ? String(opts.tenantType).trim().toUpperCase() : undefined;
+    const isSupplyPartner = tenantType === "INTERNAL_SSP" || tenantType === "EXTERNAL_SSP";
+    if (!opts.email && !isSupplyPartner) {
       console.error("Error: --email is required.");
       process.exit(1);
     }
-    const capabilities = opts.capabilities.split(",").map((c) => c.trim().toUpperCase());
+    const capabilities = isSupplyPartner ? [] : opts.capabilities.split(",").map((c) => c.trim().toUpperCase());
     const body = {
       tenant: {
         companyName: opts.name,
+        tenantType,
         capabilities
       },
-      admin: {
+      admin: isSupplyPartner ? undefined : {
         email: opts.email,
         name: opts.adminName ?? undefined
       }
@@ -5764,11 +5943,104 @@ Examples:
       { key: "time", header: "TIME", width: 22 }
     ], opts.format);
   });
+  const rateLimits = cmd.command("rate-limits").description("Business rate-limit configuration.").addHelpText("after", `
+Examples:
+  $ a8techads admin rate-limits list --format table
+  $ a8techads admin rate-limits upsert-partner PROPELLERADS --qps 500 --yes
+  $ a8techads admin rate-limits upsert-partner HILLTOPADS --qps 100 --yes`);
+  function normalizeRateLimit(config) {
+    return {
+      id: config.id,
+      name: config.name ?? config.targetName ?? config.target_name,
+      configType: config.configType ?? config.config_type,
+      targetId: config.targetId ?? config.target_id,
+      qpsLimit: config.qpsLimit ?? config.qps_limit,
+      windowSizeMs: config.windowSizeMs ?? config.window_size_ms,
+      burstAllowance: config.burstAllowance ?? config.burst_allowance,
+      strategy: config.strategy,
+      isEnabled: config.isEnabled ?? config.is_enabled,
+      updatedAt: config.updatedAt ?? config.updated_at
+    };
+  }
+  addFormatOption(rateLimits.command("list").description("List business rate-limit configs.").option("--type <type>", "Filter by config type, e.g. global or partner").option("--limit <n>", "Max results", "100")).action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit });
+    if (opts.type)
+      params.set("configType", opts.type);
+    const resp = await apiRequest({ path: `${consolePrefix()}/rate-limits/config?${params}` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const rows = (json.data ?? json).map(normalizeRateLimit);
+    printData(rows, [
+      { key: "id", header: "ID", width: 36 },
+      { key: "configType", header: "TYPE", width: 10 },
+      { key: "name", header: "NAME", width: 20 },
+      { key: "qpsLimit", header: "QPS", width: 8 },
+      { key: "windowSizeMs", header: "WINDOW", width: 8 },
+      { key: "burstAllowance", header: "BURST", width: 8 },
+      { key: "strategy", header: "STRATEGY", width: 10 },
+      { key: "isEnabled", header: "ENABLED", width: 8 }
+    ], opts.format);
+  });
+  addFormatOption(rateLimits.command("upsert-partner").description("Create or update a partner business QPS limit by partner code.").argument("<partner-code>", "Partner code, e.g. PROPELLERADS or HILLTOPADS").requiredOption("--qps <n>", "QPS limit").option("--window-ms <n>", "Window size in milliseconds", "1000").option("--burst <n>", "Burst allowance multiplier", "1.5").option("--strategy <strategy>", "Limit strategy", "drop").option("--disable", "Create/update as disabled", false).option("--yes", "Skip confirmation", false)).action(async (partnerCode, opts) => {
+    const normalizedPartner = String(partnerCode).trim().toUpperCase();
+    const qps = Number.parseInt(opts.qps, 10);
+    const windowMs = Number.parseInt(opts.windowMs, 10);
+    const burst = Number.parseFloat(opts.burst);
+    if (!normalizedPartner) {
+      console.error("Error: partner code is required.");
+      process.exit(1);
+    }
+    if (!Number.isFinite(qps) || qps < 0) {
+      console.error("Error: --qps must be a non-negative integer.");
+      process.exit(1);
+    }
+    if (!Number.isFinite(windowMs) || windowMs <= 0) {
+      console.error("Error: --window-ms must be a positive integer.");
+      process.exit(1);
+    }
+    if (!Number.isFinite(burst) || burst <= 0) {
+      console.error("Error: --burst must be a positive number.");
+      process.exit(1);
+    }
+    await confirmAction(`Set business rate limit for ${normalizedPartner} to ${qps} QPS?`, opts.yes);
+    const listResp = await apiRequest({ path: `${consolePrefix()}/rate-limits/config?configType=partner&limit=100` });
+    const listJson = await listResp.json();
+    if (!listResp.ok) {
+      console.error(`Error: ${listJson.error ?? listJson.errors ?? listResp.statusText}`);
+      process.exit(1);
+    }
+    const existing = (listJson.data ?? listJson).find((config) => {
+      const name = String(config.name ?? config.targetName ?? config.target_name ?? "").trim().toUpperCase();
+      return name === normalizedPartner;
+    });
+    const body = {
+      configType: "partner",
+      name: normalizedPartner,
+      targetName: normalizedPartner,
+      qpsLimit: qps,
+      windowSizeMs: windowMs,
+      burstAllowance: burst,
+      strategy: opts.strategy,
+      dailyRequestLimit: 0,
+      isEnabled: !opts.disable
+    };
+    const resp = existing ? await apiRequest({ method: "PATCH", path: `${consolePrefix()}/rate-limits/${existing.id}`, body }) : await apiRequest({ method: "POST", path: `${consolePrefix()}/rate-limits`, body });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      process.exit(1);
+    }
+    printDetail(normalizeRateLimit(json.data ?? json), opts.format);
+  });
   const campaignReviews = cmd.command("campaign-reviews").description("Campaign review operations (Console).").addHelpText("after", `
 Examples:
   $ a8techads admin campaign-reviews pending
   $ a8techads admin campaign-reviews show <campaign-id>
   $ a8techads admin campaign-reviews approve-all <campaign-id> --yes
+  $ a8techads admin campaign-reviews approve-variation <variation-id> --yes
   $ a8techads admin campaign-reviews decline <campaign-id> --reason-code policy --feedback "Needs changes" --yes`);
   const reviewColumns = [
     { key: "id", header: "ID", width: 36 },
@@ -5845,6 +6117,16 @@ Variations`);
     }
     printDetail(json.data ?? json, opts.format);
   });
+  addFormatOption(campaignReviews.command("approve-variation").description("Approve one pending variation without changing the parent campaign status.").argument("<id>", "Variation ID").option("--yes", "Skip confirmation", false)).action(async (id, opts) => {
+    await confirmAction(`Approve variation ${id}?`, opts.yes);
+    const resp = await apiRequest({ method: "PATCH", path: `${consolePrefix()}/variations/${id}/approve` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      process.exit(1);
+    }
+    printDetail(json.data ?? json, opts.format);
+  });
   addFormatOption(campaignReviews.command("decline").description("Decline all pending variations for a campaign atomically.").argument("<id>", "Campaign ID").option("--feedback <text>", "Review feedback").option("--reason-code <code>", "Review reason code").option("--yes", "Skip confirmation", false)).action(async (id, opts) => {
     await confirmAction(`Decline campaign ${id}?`, opts.yes);
     const body = {};
@@ -6910,9 +7192,11 @@ Examples:
 var COLUMNS9 = [
   { key: "id", header: "ID", width: 36 },
   { key: "name", header: "NAME", width: 24 },
+  { key: "codes", header: "CODES", width: 24 },
   { key: "goalOrder", header: "G#", width: 4 },
   { key: "conversionType", header: "TYPE", width: 20 },
   { key: "valueType", header: "VALUE", width: 10 },
+  { key: "signatureRequired", header: "HMAC", width: 8 },
   { key: "status", header: "STATUS", width: 10 }
 ];
 function createConversionGoalsCommand() {
@@ -6923,6 +7207,7 @@ Examples:
   $ a8techads conversion-goals list
   $ a8techads conversion-goals get <id>
   $ a8techads conversion-goals create --name "Purchase" --conversion-type PURCHASE_CC --goal-order 1
+  $ a8techads conversion-goals integration <id> --status install
   $ a8techads conversion-goals pause <id>`);
   addFormatOption(cmd.command("list").description("List conversion goals.").option("--status <status>", "Filter by status (ACTIVE, PAUSED, ARCHIVED)").option("--limit <n>", "Max results", "20")).action(async (opts) => {
     const params = new URLSearchParams;
@@ -6939,8 +7224,10 @@ Examples:
       id: g.id,
       name: g.name,
       goalOrder: `G${g.goalOrder ?? g.goal_order}`,
+      codes: Array.isArray(g.codes) ? g.codes.join(",") : "",
       conversionType: g.conversionType ?? g.conversion_type,
       valueType: g.valueType ?? g.value_type,
+      signatureRequired: g.signatureRequired ?? g.signature_required ? "required" : "optional",
       status: g.status
     }));
     printData(rows, COLUMNS9, opts.format);
@@ -6954,10 +7241,45 @@ Examples:
     }
     printDetail(json.data ?? json, opts.format);
   });
+  cmd.command("integration").description("Print S2S postback and pixel integration examples for a conversion goal.").argument("<id>", "Goal ID").option("--base-url <url>", "Bidder/conversion base URL", "https://bidder.a8.tech").option("--click-id <macro>", "Click ID macro or test click ID", "{click_id}").option("--status <code>", "External code/status sample, e.g. install or registration").option("--value <amount>", "Conversion value sample").action(async (id, opts) => {
+    const resp = await apiRequest({ path: `${dspPrefix()}/conversion-goals/${id}` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const goal = json.data ?? json;
+    const goalId = goal.goalId ?? goal.goal_id ?? goal.id ?? id;
+    const codes = Array.isArray(goal.codes) ? goal.codes : [];
+    const base = cleanBaseUrl(opts.baseUrl);
+    const baseUrl = buildConversionUrl(base, goalId, opts.clickId, undefined, opts.value);
+    const statusUrl = opts.status ? buildConversionUrl(base, goalId, opts.clickId, opts.status, opts.value) : null;
+    const pixelUrl = `${base}/conversion.gif?${conversionParams(goalId, opts.clickId, opts.status, opts.value)}`;
+    console.log(`Goal: ${goal.name ?? id}`);
+    console.log(`Goal ID: ${goalId}`);
+    console.log(`External codes: ${codes.length > 0 ? codes.join(", ") : "(none)"}`);
+    console.log("");
+    console.log("S2S postback:");
+    console.log(baseUrl);
+    if (statusUrl) {
+      console.log("");
+      console.log(`Status/code postback sample (${opts.status}):`);
+      console.log(statusUrl);
+    }
+    console.log("");
+    console.log("Browser pixel sample:");
+    console.log(`<!-- AlpineAds Conversion Pixel -->`);
+    console.log(`<img src="${pixelUrl}" width="1" height="1" style="display:none" alt="" />`);
+    console.log("");
+    console.log("Notes:");
+    console.log("- Replace {click_id} with the click ID captured from the campaign tracking URL.");
+    console.log("- status=<code> is matched against this goal external codes, for tracker integrations such as install or registration.");
+    console.log("- DYNAMIC value goals should use signed server-to-server postbacks; browser pixels are only for validation or lightweight fixed/no-value goals.");
+  });
   cmd.command("create").description(`Create a conversion goal.
 
 Conversion types: APP_INSTALL, LEAD_SOI, LEAD_DOI, PURCHASE_CC, PURCHASE_COD,
-  PURCHASE_CARRIER, SUBSCRIPTION_CC, SUBSCRIPTION_CARRIER, WEBSITE_INTERACTION, MULTIPLE, OTHER`).option("--name <name>", "Goal name (required)").option("--conversion-type <type>", "Conversion type (required)").option("--goal-order <n>", "Priority 1-10, maps to G1-G10 (required)").option("--value-type <type>", "NO_VALUE, FIXED, or DYNAMIC", "NO_VALUE").option("--fixed-value <amount>", "Fixed value per conversion (when value-type is FIXED)").option("--count-type <type>", "ONE per user or EVERY conversion", "EVERY").option("--window <hours>", "Attribution window in hours", "720").option("--description <text>", "Goal description").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
+  PURCHASE_CARRIER, SUBSCRIPTION_CC, SUBSCRIPTION_CARRIER, WEBSITE_INTERACTION, MULTIPLE, OTHER`).option("--name <name>", "Goal name (required)").option("--code <code>", "Single external tracker alias/status for this goal").option("--codes <codes>", "Comma-separated external tracker aliases/statuses for this goal").option("--conversion-type <type>", "Conversion type (required)").option("--goal-order <n>", "Priority 1-10, maps to G1-G10 (required)").option("--value-type <type>", "NO_VALUE, FIXED, or DYNAMIC", "NO_VALUE").option("--fixed-value <amount>", "Fixed value per conversion (when value-type is FIXED)").option("--signature-required <bool>", "Require HMAC signature for DYNAMIC goals (true/false)", "false").option("--count-type <type>", "ONE per user or EVERY conversion", "EVERY").option("--window <hours>", "Attribution window in hours", "720").option("--description <text>", "Goal description").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
     let body;
     if (opts.fromJson) {
       const { readFileSync: readFileSync5 } = await import("fs");
@@ -6977,9 +7299,11 @@ Conversion types: APP_INSTALL, LEAD_SOI, LEAD_DOI, PURCHASE_CC, PURCHASE_COD,
       }
       body = {
         name: opts.name,
+        codes: parseCodes(opts.codes ?? opts.code),
         conversionType: opts.conversionType,
         goalOrder: Number(opts.goalOrder),
         valueType: opts.valueType,
+        signatureRequired: parseBoolOption(opts.signatureRequired),
         countType: opts.countType,
         conversionWindowHours: Number(opts.window)
       };
@@ -6999,7 +7323,7 @@ Conversion types: APP_INSTALL, LEAD_SOI, LEAD_DOI, PURCHASE_CC, PURCHASE_COD,
     console.log(`  Goal ID: ${goal.goalId ?? goal.goal_id}`);
     console.log(`  Postback URL: ${goal.postbackUrl ?? goal.postback_url ?? "(see get)"}`);
   });
-  cmd.command("update").description("Update a conversion goal.").argument("<id>", "Goal ID").option("--name <name>", "New name").option("--description <text>", "New description").option("--value-type <type>", "NO_VALUE, FIXED, or DYNAMIC").option("--fixed-value <amount>", "Fixed value").option("--count-type <type>", "ONE or EVERY").option("--window <hours>", "Attribution window").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
+  cmd.command("update").description("Update a conversion goal.").argument("<id>", "Goal ID").option("--name <name>", "New name").option("--code <code>", "Replace external tracker aliases with one code").option("--codes <codes>", "Replace external tracker aliases with comma-separated codes").option("--description <text>", "New description").option("--value-type <type>", "NO_VALUE, FIXED, or DYNAMIC").option("--fixed-value <amount>", "Fixed value").option("--signature-required <bool>", "Require HMAC signature for DYNAMIC goals (true/false)").option("--count-type <type>", "ONE or EVERY").option("--window <hours>", "Attribution window").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
     let body;
     if (opts.fromJson) {
       const { readFileSync: readFileSync5 } = await import("fs");
@@ -7008,12 +7332,16 @@ Conversion types: APP_INSTALL, LEAD_SOI, LEAD_DOI, PURCHASE_CC, PURCHASE_COD,
       body = {};
       if (opts.name)
         body.name = opts.name;
+      if (opts.codes !== undefined || opts.code !== undefined)
+        body.codes = parseCodes(opts.codes ?? opts.code);
       if (opts.description)
         body.description = opts.description;
       if (opts.valueType)
         body.valueType = opts.valueType;
       if (opts.fixedValue)
         body.fixedValue = Number(opts.fixedValue);
+      if (opts.signatureRequired !== undefined)
+        body.signatureRequired = parseBoolOption(opts.signatureRequired);
       if (opts.countType)
         body.countType = opts.countType;
       if (opts.window)
@@ -7063,6 +7391,40 @@ Conversion types: APP_INSTALL, LEAD_SOI, LEAD_DOI, PURCHASE_CC, PURCHASE_COD,
   });
   return cmd;
 }
+function parseBoolOption(value) {
+  if (typeof value === "boolean")
+    return value;
+  const normalized = String(value ?? "").trim().toLowerCase();
+  if (["true", "1", "yes", "y"].includes(normalized))
+    return true;
+  if (["false", "0", "no", "n", ""].includes(normalized))
+    return false;
+  console.error(`Error: expected boolean value, got ${value}`);
+  process.exit(1);
+}
+function parseCodes(value) {
+  if (value === undefined || value === null)
+    return [];
+  const values = Array.isArray(value) ? value : String(value).split(",");
+  const normalized = values.map((item) => String(item).trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "_").replace(/^_+|_+$/g, "")).filter(Boolean);
+  return Array.from(new Set(normalized));
+}
+function cleanBaseUrl(value) {
+  return String(value).replace(/\/+$/, "");
+}
+function buildConversionUrl(baseUrl, goalId, clickId, status, value) {
+  return `${baseUrl}/conversion?${conversionParams(goalId, clickId, status, value)}`;
+}
+function conversionParams(goalId, clickId, status, value) {
+  const params = new URLSearchParams;
+  params.set("goal", goalId);
+  params.set("click_id", clickId);
+  if (status)
+    params.set("status", status);
+  if (value)
+    params.set("value", value);
+  return params.toString().replace(/%7B/g, "{").replace(/%7D/g, "}");
+}
 
 // src/commands/algorithms.ts
 var COLUMNS10 = [
@@ -7073,6 +7435,18 @@ var COLUMNS10 = [
   { key: "status", header: "STATUS", width: 10 },
   { key: "campaignCount", header: "CAMPAIGNS", width: 10 }
 ];
+var RULE_COLUMNS = [
+  { key: "id", header: "ID", width: 36 },
+  { key: "name", header: "NAME", width: 28 },
+  { key: "dimension", header: "DIMENSION", width: 14 },
+  { key: "metric", header: "METRIC", width: 12 },
+  { key: "threshold", header: "THRESHOLD", width: 10 },
+  { key: "check", header: "CHECK", width: 24 },
+  { key: "action", header: "ACTION", width: 12 },
+  { key: "bidModifier", header: "MOD", width: 8 },
+  { key: "isActive", header: "ACTIVE", width: 8 },
+  { key: "priority", header: "PRI", width: 6 }
+];
 function createAlgorithmsCommand() {
   const cmd = new Command("algorithms").description(`Bidder algorithm management (DSP)
 
@@ -7081,7 +7455,9 @@ Examples:
   $ a8techads algorithms list
   $ a8techads algorithms get <id>
   $ a8techads algorithms create --name "CPA Base" --optimization-goal CPA --target-value 5
-  $ a8techads algorithms update <id> --conversion-goal-id <goal-id>
+  $ a8techads algorithms update <id> --conversion-goal-id <goal-id> --auto-adjust-bids true --auto-block-enabled false
+  $ a8techads algorithms rules create <id> --name "Propeller source cut" --dimension source_site --metric clicks --threshold 50 --condition equals --check-metric conversions --check-value 0 --action reduce_bid --bid-modifier 0.6
+  $ a8techads algorithms progress --campaign <campaign-id> --dimensions sub_id1,quarter_hour --target-cpa 5
   $ a8techads algorithms pause <id>`);
   addFormatOption(cmd.command("list").description("List bidder algorithms.").option("--status <status>", "Filter by status (ACTIVE, PAUSED, ARCHIVED)").option("--limit <n>", "Max results", "20")).action(async (opts) => {
     const params = new URLSearchParams;
@@ -7091,7 +7467,7 @@ Examples:
     const resp = await apiRequest({ path: `${dspPrefix()}/bidder-algorithms?${params}` });
     const json = await resp.json();
     if (!resp.ok) {
-      console.error(`Error: ${json.error ?? resp.statusText}`);
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
       process.exit(1);
     }
     const rows = (json.data ?? json).map((algo) => ({
@@ -7108,27 +7484,27 @@ Examples:
     const resp = await apiRequest({ path: `${dspPrefix()}/bidder-algorithms/${id}` });
     const json = await resp.json();
     if (!resp.ok) {
-      console.error(`Error: ${json.error ?? resp.statusText}`);
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
       process.exit(1);
     }
     printDetail(json.data ?? json, opts.format);
   });
-  cmd.command("create").description("Create a bidder algorithm.").option("--name <name>", "Algorithm name (required)").option("--description <text>", "Description").option("--optimization-goal <goal>", "CPA, ROAS, CTR, or CVR").option("--target-value <number>", "Target value").option("--conversion-goal-id <id>", "Conversion goal ID").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
+  cmd.command("create").description("Create a bidder algorithm.").option("--name <name>", "Algorithm name (required)").option("--description <text>", "Description").option("--optimization-goal <goal>", "CPA, ROAS, CTR, or CVR").option("--target-value <number>", "Target value").option("--conversion-goal-id <id>", "Conversion goal ID").option("--data-period-days <n>", "Data lookback period in days").option("--max-test-budget <amount>", "Maximum test budget before reducing/blocking weak traffic").option("--min-impressions <n>", "Minimum impressions before evaluating").option("--min-clicks <n>", "Minimum clicks before evaluating").option("--auto-adjust-bids <bool>", "Enable automatic bid modifiers").option("--auto-block-enabled <bool>", "Enable automatic block actions").option("--min-bid-modifier <number>", "Minimum bid modifier, e.g. 0.6").option("--max-bid-modifier <number>", "Maximum bid modifier, e.g. 1.3").option("--block-after-impressions <n>", "Block threshold by impressions").option("--block-after-spend <amount>", "Block threshold by spend").option("--block-if-no-conversions <bool>", "Block when no conversions after thresholds").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
     const body = await buildAlgorithmBody(opts, true);
     const resp = await apiRequest({ method: "POST", path: `${dspPrefix()}/bidder-algorithms`, body });
     const json = await resp.json();
     if (!resp.ok) {
-      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
       process.exit(1);
     }
     console.log(`Algorithm created: ${json.data?.id ?? json.id}`);
   });
-  cmd.command("update").description("Update a bidder algorithm.").argument("<id>", "Algorithm ID").option("--name <name>", "Algorithm name").option("--description <text>", "Description").option("--optimization-goal <goal>", "CPA, ROAS, CTR, or CVR").option("--target-value <number>", "Target value").option("--conversion-goal-id <id>", "Conversion goal ID").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
+  cmd.command("update").description("Update a bidder algorithm.").argument("<id>", "Algorithm ID").option("--name <name>", "Algorithm name").option("--description <text>", "Description").option("--optimization-goal <goal>", "CPA, ROAS, CTR, or CVR").option("--target-value <number>", "Target value").option("--conversion-goal-id <id>", "Conversion goal ID").option("--data-period-days <n>", "Data lookback period in days").option("--max-test-budget <amount>", "Maximum test budget before reducing/blocking weak traffic").option("--min-impressions <n>", "Minimum impressions before evaluating").option("--min-clicks <n>", "Minimum clicks before evaluating").option("--auto-adjust-bids <bool>", "Enable automatic bid modifiers").option("--auto-block-enabled <bool>", "Enable automatic block actions").option("--min-bid-modifier <number>", "Minimum bid modifier, e.g. 0.6").option("--max-bid-modifier <number>", "Maximum bid modifier, e.g. 1.3").option("--block-after-impressions <n>", "Block threshold by impressions").option("--block-after-spend <amount>", "Block threshold by spend").option("--block-if-no-conversions <bool>", "Block when no conversions after thresholds").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
     const body = await buildAlgorithmBody(opts, false);
     const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/bidder-algorithms/${id}`, body });
     const json = await resp.json().catch(() => ({}));
     if (!resp.ok) {
-      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
       process.exit(1);
     }
     console.log(`Algorithm ${id} updated.`);
@@ -7145,7 +7521,7 @@ Examples:
     });
     const json = await resp.json().catch(() => ({}));
     if (!resp.ok) {
-      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
       process.exit(1);
     }
     console.log(`Algorithm ${id} archived.`);
@@ -7158,12 +7534,14 @@ Examples:
       });
       const json = await resp.json().catch(() => ({}));
       if (!resp.ok) {
-        console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+        console.error(`Error: ${formatApiError(json, resp.statusText)}`);
         process.exit(1);
       }
       console.log(`Algorithm ${id} ${action}d.`);
     });
   }
+  addRulesCommand(cmd);
+  addProgressCommand(cmd);
   return cmd;
 }
 async function buildAlgorithmBody(opts, creating) {
@@ -7177,11 +7555,22 @@ async function buildAlgorithmBody(opts, creating) {
   if (opts.description)
     body.description = opts.description;
   if (opts.optimizationGoal)
-    body.optimizationGoal = String(opts.optimizationGoal).toUpperCase();
+    body.optimizationGoal = String(opts.optimizationGoal).toLowerCase();
   if (opts.targetValue !== undefined)
     body.targetValue = Number(opts.targetValue);
   if (opts.conversionGoalId)
     body.conversionGoalId = opts.conversionGoalId;
+  putNumber(body, "dataPeriodDays", opts.dataPeriodDays);
+  putNumber(body, "maxTestBudget", opts.maxTestBudget);
+  putNumber(body, "minImpressions", opts.minImpressions);
+  putNumber(body, "minClicks", opts.minClicks);
+  putBoolean(body, "autoAdjustBids", opts.autoAdjustBids);
+  putBoolean(body, "autoBlockEnabled", opts.autoBlockEnabled);
+  putNumber(body, "minBidModifier", opts.minBidModifier);
+  putNumber(body, "maxBidModifier", opts.maxBidModifier);
+  putNumber(body, "blockAfterImpressions", opts.blockAfterImpressions);
+  putNumber(body, "blockAfterSpend", opts.blockAfterSpend);
+  putBoolean(body, "blockIfNoConversions", opts.blockIfNoConversions);
   if (creating) {
     if (!body.name) {
       console.error("Error: --name is required.");
@@ -7198,6 +7587,245 @@ async function buildAlgorithmBody(opts, creating) {
   }
   return body;
 }
+function addRulesCommand(cmd) {
+  const rules = new Command("rules").description("Manage bidder optimization rules.").addHelpText("after", `
+Examples:
+  $ a8techads algorithms rules list <algorithm-id>
+  $ a8techads algorithms rules create <algorithm-id> --name "No conversion after 50 clicks" --dimension source_site --metric clicks --threshold 50 --condition equals --check-metric conversions --check-value 0 --action reduce_bid --bid-modifier 0.6
+  $ a8techads algorithms rules update <rule-id> --bid-modifier 0.7
+  $ a8techads algorithms rules delete <rule-id> --yes`);
+  addFormatOption(rules.command("list").description("List rules for a bidder algorithm.").argument("<algorithm-id>", "Algorithm ID")).action(async (algorithmId, opts) => {
+    const resp = await apiRequest({ path: `${dspPrefix()}/bidder-algorithms/${algorithmId}/blocking-rules` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
+      process.exit(1);
+    }
+    const rows = (json.data ?? json).map(formatRuleRow);
+    printData(rows, RULE_COLUMNS, opts.format);
+  });
+  rules.command("create").description("Create an optimization rule for a bidder algorithm.").argument("<algorithm-id>", "Algorithm ID").option("--name <name>", "Rule name (required)").option("--dimension <dimension>", "zone, site, source_site, country, region, device, os, browser, language, mobile_carrier").option("--metric <metric>", "impressions, clicks, or spend").option("--threshold <number>", "Trigger threshold").option("--condition <type>", "greater_than, greater_than_or_equal, less_than, less_than_or_equal, or equals").option("--check-metric <metric>", "ctr, clicks, conversions, ecpa, roi, or profit").option("--check-value <number>", "Performance metric value to compare").option("--action <action>", "block, reduce_bid, or alert").option("--bid-modifier <number>", "Bid modifier for reduce_bid action").option("--priority <n>", "Rule priority, lower runs first").option("--active <bool>", "Whether the rule is active", "true").option("--from-json <file>", "Create from JSON file").action(async (algorithmId, opts) => {
+    const body = await buildRuleBody(opts, true);
+    const resp = await apiRequest({
+      method: "POST",
+      path: `${dspPrefix()}/bidder-algorithms/${algorithmId}/blocking-rules`,
+      body
+    });
+    const json = await resp.json().catch(() => ({}));
+    if (!resp.ok) {
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
+      process.exit(1);
+    }
+    console.log(`Rule created: ${json.data?.id ?? json.id}`);
+  });
+  rules.command("update").description("Update an optimization rule.").argument("<rule-id>", "Rule ID").option("--name <name>", "Rule name").option("--dimension <dimension>", "zone, site, source_site, country, region, device, os, browser, language, mobile_carrier").option("--metric <metric>", "impressions, clicks, or spend").option("--threshold <number>", "Trigger threshold").option("--condition <type>", "greater_than, greater_than_or_equal, less_than, less_than_or_equal, or equals").option("--check-metric <metric>", "ctr, clicks, conversions, ecpa, roi, or profit").option("--check-value <number>", "Performance metric value to compare").option("--action <action>", "block, reduce_bid, or alert").option("--bid-modifier <number>", "Bid modifier for reduce_bid action").option("--priority <n>", "Rule priority, lower runs first").option("--active <bool>", "Whether the rule is active").option("--from-json <file>", "Update from JSON file").action(async (ruleId, opts) => {
+    const body = await buildRuleBody(opts, false);
+    const resp = await apiRequest({
+      method: "PATCH",
+      path: `${dspPrefix()}/blocking-rules/${ruleId}`,
+      body
+    });
+    const json = await resp.json().catch(() => ({}));
+    if (!resp.ok) {
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
+      process.exit(1);
+    }
+    console.log(`Rule ${ruleId} updated.`);
+  });
+  rules.command("delete").description("Delete an optimization rule.").argument("<rule-id>", "Rule ID").option("--yes", "Skip confirmation").action(async (ruleId, opts) => {
+    if (!opts.yes) {
+      console.error("Add --yes to confirm deletion.");
+      process.exit(1);
+    }
+    const resp = await apiRequest({ method: "DELETE", path: `${dspPrefix()}/blocking-rules/${ruleId}` });
+    if (!resp.ok && resp.status !== 204) {
+      const json = await resp.json().catch(() => ({}));
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
+      process.exit(1);
+    }
+    console.log(`Rule ${ruleId} deleted.`);
+  });
+  cmd.addCommand(rules);
+}
+function addProgressCommand(cmd) {
+  addFormatOption(cmd.command("progress").description("Monitor optimization progress for a campaign through DSP reports.").requiredOption("--campaign <id>", "Campaign ID to filter").option("--dimensions <list>", "Comma-separated dimensions, e.g. sub_id1 or sub_id1,quarter_hour", "sub_id1").option("--from <date>", "Start date (YYYY-MM-DD)").option("--to <date>", "End date (YYYY-MM-DD)").option("--target-cpa <amount>", "Target CPA used for suggestions").option("--limit <n>", "Max rows", "100").option("--semantic-mode <mode>", "event_time or attributed", "event_time").addHelpText("after", `
+Examples:
+  $ a8techads algorithms progress --campaign <campaign-id> --dimensions sub_id1 --from 2026-06-01 --to 2026-06-02 --target-cpa 5
+  $ a8techads algorithms progress --campaign <campaign-id> --dimensions sub_id1,quarter_hour --semantic-mode event_time --limit 200`)).action(async (opts) => {
+    const dimensions = parseCsvList3(opts.dimensions);
+    const targetCpa = opts.targetCpa === undefined ? undefined : Number(opts.targetCpa);
+    const body = {
+      dimensions,
+      metrics: ["requests", "bids", "wins", "impressions", "clicks", "conversions", "spend", "ctr", "cvr", "cpa"],
+      filters: { campaign: opts.campaign },
+      limit: Number(opts.limit),
+      sortBy: "clicks",
+      sortOrder: "desc",
+      semanticMode: opts.semanticMode
+    };
+    if (opts.from)
+      body.dateRange = { ...body.dateRange ?? {}, start: opts.from };
+    if (opts.to)
+      body.dateRange = { ...body.dateRange ?? {}, end: opts.to };
+    const resp = await apiRequest({ method: "POST", path: `${dspPrefix()}/reports/query`, body });
+    const json = await resp.json().catch(() => ({}));
+    if (!resp.ok) {
+      console.error(`Error: ${formatApiError(json, resp.statusText)}`);
+      process.exit(1);
+    }
+    const data = json.data ?? json;
+    const rows = data.rows ?? data.results ?? json.rows ?? json.results ?? [];
+    if (!Array.isArray(rows) || rows.length === 0) {
+      console.log("No results.");
+      return;
+    }
+    const formatted = rows.map((row) => ({
+      ...row,
+      suggestion: suggestOptimization(row, targetCpa)
+    }));
+    if (opts.format === "json") {
+      console.log(JSON.stringify({ ...data, results: formatted }, null, 2));
+      return;
+    }
+    const columns = [
+      ...dimensions.map((dim) => ({ key: dim, header: dim.toUpperCase(), width: Math.max(dim.length, 14) })),
+      { key: "requests", header: "REQ", width: 10 },
+      { key: "bids", header: "BID", width: 10 },
+      { key: "wins", header: "WIN", width: 10 },
+      { key: "impressions", header: "IMP", width: 10 },
+      { key: "clicks", header: "CLICK", width: 10 },
+      { key: "conversions", header: "CONV", width: 8 },
+      { key: "spend", header: "SPEND", width: 10, format: money },
+      { key: "ctr", header: "CTR%", width: 8, format: pct },
+      { key: "cvr", header: "CVR%", width: 8, format: pct },
+      { key: "cpa", header: "CPA", width: 10, format: money },
+      { key: "suggestion", header: "SUGGESTION", width: 22 }
+    ];
+    printData(formatted, columns, opts.format);
+    const summary = data.summary ?? json.summary;
+    if (summary && opts.format === "table") {
+      console.log(`
+Summary:`);
+      printDetail(summary, "table");
+    }
+  });
+}
+async function buildRuleBody(opts, creating) {
+  if (opts.fromJson) {
+    const { readFileSync: readFileSync5 } = await import("fs");
+    return JSON.parse(readFileSync5(opts.fromJson, "utf-8"));
+  }
+  const body = {};
+  if (opts.name)
+    body.name = opts.name;
+  if (opts.dimension)
+    body.dimension = opts.dimension;
+  if (opts.metric)
+    body.metric = opts.metric;
+  putNumber(body, "threshold", opts.threshold);
+  if (opts.condition)
+    body.conditionType = opts.condition;
+  if (opts.checkMetric)
+    body.checkMetric = opts.checkMetric;
+  putNumber(body, "checkValue", opts.checkValue);
+  if (opts.action)
+    body.action = opts.action;
+  putNumber(body, "bidModifier", opts.bidModifier);
+  putNumber(body, "priority", opts.priority);
+  putBoolean(body, "isActive", opts.active);
+  if (creating) {
+    for (const [key, option] of [
+      ["name", "--name"],
+      ["dimension", "--dimension"],
+      ["metric", "--metric"],
+      ["threshold", "--threshold"],
+      ["conditionType", "--condition"],
+      ["checkMetric", "--check-metric"],
+      ["checkValue", "--check-value"],
+      ["action", "--action"]
+    ]) {
+      if (body[key] === undefined || body[key] === "") {
+        console.error(`Error: ${option} is required.`);
+        process.exit(1);
+      }
+    }
+  }
+  if (body.action === "reduce_bid" && body.bidModifier === undefined) {
+    console.error("Error: --bid-modifier is required when --action reduce_bid.");
+    process.exit(1);
+  }
+  return body;
+}
+function formatRuleRow(rule) {
+  return {
+    id: rule.id,
+    name: rule.name,
+    dimension: rule.dimension,
+    metric: rule.metric,
+    threshold: rule.threshold,
+    check: `${rule.checkMetric} ${rule.conditionType} ${rule.checkValue}`,
+    action: rule.action,
+    bidModifier: rule.bidModifier,
+    isActive: rule.isActive,
+    priority: rule.priority
+  };
+}
+function suggestOptimization(row, targetCpa) {
+  const clicks = asNumber(row.clicks);
+  const conversions = asNumber(row.conversions);
+  const spend = asNumber(row.spend);
+  const cpa = conversions > 0 ? spend / conversions : asNumber(row.cpa);
+  if (clicks < 30)
+    return "hold: new traffic";
+  if (clicks >= 50 && conversions === 0)
+    return "reduce bid 0.6x";
+  if (targetCpa && conversions > 0 && cpa > targetCpa)
+    return "reduce bid 0.7x";
+  if (targetCpa && conversions > 0 && cpa > 0 && cpa < targetCpa)
+    return "raise bid 1.1-1.3x";
+  return "hold";
+}
+function putNumber(body, key, value) {
+  if (value !== undefined && value !== null && value !== "")
+    body[key] = Number(value);
+}
+function putBoolean(body, key, value) {
+  if (value === undefined || value === null || value === "")
+    return;
+  body[key] = parseBoolean(String(value), key);
+}
+function parseBoolean(value, optionName) {
+  const normalized = value.trim().toLowerCase();
+  if (["true", "1", "yes", "y", "on"].includes(normalized))
+    return true;
+  if (["false", "0", "no", "n", "off"].includes(normalized))
+    return false;
+  console.error(`Error: ${optionName} must be true or false.`);
+  process.exit(1);
+}
+function parseCsvList3(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function asNumber(value) {
+  const n = Number(value ?? 0);
+  return Number.isFinite(n) ? n : 0;
+}
+function money(value) {
+  const n = Number(value ?? 0);
+  return Number.isFinite(n) ? `$${n.toFixed(4)}` : "-";
+}
+function pct(value) {
+  const n = Number(value ?? 0);
+  return Number.isFinite(n) ? n.toFixed(2) : "-";
+}
+function formatApiError(json, fallback) {
+  const value = json?.error ?? json?.errors ?? json?.message ?? json;
+  if (value === undefined || value === null || value === "")
+    return fallback;
+  if (typeof value === "string")
+    return value;
+  return JSON.stringify(value);
+}
 
 // src/commands/payouts.ts
 function createPayoutsCommand() {
@@ -8117,16 +8745,22 @@ Examples:
   addFormatOption(contracts.command("summary").description("Summarize supply contracts.").option("--limit <n>", "Max results to scan", "200").option("--region <region>", "Filter by region").option("--status <status>", "Filter by status").option("--supplier <name>", "Filter by supplier name contains").option("--type <type>", "Filter by contract type")).action(async (opts) => {
     await summarizeResource(`${consolePrefix()}/supply-contracts`, opts, "contracts");
   });
-  contracts.command("create").description("Create a supply contract.").requiredOption("--name <name>", "Contract name").requiredOption("--region <regions>", "Serving regions, comma-separated").requiredOption("--supplier-tenant-id <id>", "Supplier tenant ID").requiredOption("--supply-product-id <id>", "Traffic package ID").option("--description <text>", "Description").option("--contract-type <type>", "GUARANTEED, PREFERRED_DEAL, PRIVATE_MARKETPLACE, OPEN_AUCTION", "OPEN_AUCTION").option("--source-masking-mode <mode>", "OPAQUE, REGION_ONLY, PRODUCT_ONLY", "OPAQUE").option("--priority <n>", "Contract-level routing priority", "0").option("--match-rules <json>", 'Request match rules JSON, e.g. [{"fieldPath":"ext.alpineads.route_key","operator":"eq","value":"hilltopads-open"}]').option("--qps-cap <n>", "QPS cap").option("--target-fill-rate <n>", "Target fill rate, decimal string").option("--currency <code>", "Currency", "USD").option("--start-date <iso>", "ISO UTC datetime").option("--end-date <iso>", "ISO UTC datetime").option("--status <status>", "DRAFT, ACTIVE, PAUSED, ARCHIVED", "DRAFT").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
+  contracts.command("create").description("Create a supply contract.").requiredOption("--name <name>", "Contract name").requiredOption("--region <regions>", "Serving regions, comma-separated").requiredOption("--supply-product-id <id>", "Traffic package ID").option("--description <text>", "Description").option("--source-type <type>", "INTERNAL or EXTERNAL", "EXTERNAL").option("--supplier-tenant-id <id>", "Supplier tenant ID for EXTERNAL contracts").option("--contract-type <type>", "GUARANTEED, PREFERRED_DEAL, PRIVATE_MARKETPLACE, OPEN_AUCTION", "OPEN_AUCTION").option("--source-masking-mode <mode>", "OPAQUE, REGION_ONLY, PRODUCT_ONLY", "OPAQUE").option("--priority <n>", "Contract-level routing priority", "0").option("--match-rules <json>", 'Request match rules JSON, e.g. [{"fieldPath":"ext.alpineads.route_key","operator":"eq","value":"hilltopads-open"}]').option("--qps-cap <n>", "QPS cap").option("--target-fill-rate <n>", "Target fill rate, decimal string").option("--currency <code>", "Currency", "USD").option("--start-date <iso>", "ISO UTC datetime").option("--end-date <iso>", "ISO UTC datetime").option("--status <status>", "DRAFT, ACTIVE, PAUSED, ARCHIVED", "DRAFT").option("--from-json <file>", "Create from JSON file").action(async (opts) => {
     let body;
     if (opts.fromJson) {
       const { readFileSync: readFileSync6 } = await import("fs");
       body = JSON.parse(readFileSync6(opts.fromJson, "utf-8"));
     } else {
+      const sourceType = String(opts.sourceType || "EXTERNAL").toUpperCase();
+      if (sourceType === "EXTERNAL" && !opts.supplierTenantId) {
+        console.error("Error: --supplier-tenant-id is required for EXTERNAL contracts.");
+        process.exit(1);
+      }
       body = {
         name: opts.name,
         region: String(opts.region).split(",").map((item) => item.trim()).filter(Boolean),
-        supplierTenantId: opts.supplierTenantId,
+        sourceType,
+        supplierTenantId: sourceType === "EXTERNAL" ? opts.supplierTenantId : null,
         supplyProductId: opts.supplyProductId,
         description: opts.description,
         contractType: opts.contractType,
@@ -8149,7 +8783,7 @@ Examples:
     }
     console.log(`Supply contract created: ${json.data?.id ?? json.id}`);
   });
-  contracts.command("update").description("Update a supply contract.").argument("<id>", "Supply contract ID").option("--name <name>", "Contract name").option("--region <regions>", "Serving regions, comma-separated").option("--description <text>", "Description").option("--contract-type <type>", "GUARANTEED, PREFERRED_DEAL, PRIVATE_MARKETPLACE, OPEN_AUCTION").option("--source-masking-mode <mode>", "OPAQUE, REGION_ONLY, PRODUCT_ONLY").option("--priority <n>", "Contract-level routing priority").option("--match-rules <json>", "Request match rules JSON").option("--qps-cap <n>", "QPS cap").option("--target-fill-rate <n>", "Target fill rate, decimal string").option("--currency <code>", "Currency").option("--start-date <iso>", "ISO UTC datetime").option("--end-date <iso>", "ISO UTC datetime").option("--status <status>", "DRAFT, ACTIVE, PAUSED, ARCHIVED").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
+  contracts.command("update").description("Update a supply contract.").argument("<id>", "Supply contract ID").option("--name <name>", "Contract name").option("--region <regions>", "Serving regions, comma-separated").option("--description <text>", "Description").option("--source-type <type>", "INTERNAL or EXTERNAL").option("--supplier-tenant-id <id>", "Supplier tenant ID for EXTERNAL contracts").option("--contract-type <type>", "GUARANTEED, PREFERRED_DEAL, PRIVATE_MARKETPLACE, OPEN_AUCTION").option("--source-masking-mode <mode>", "OPAQUE, REGION_ONLY, PRODUCT_ONLY").option("--priority <n>", "Contract-level routing priority").option("--match-rules <json>", "Request match rules JSON").option("--qps-cap <n>", "QPS cap").option("--target-fill-rate <n>", "Target fill rate, decimal string").option("--currency <code>", "Currency").option("--start-date <iso>", "ISO UTC datetime").option("--end-date <iso>", "ISO UTC datetime").option("--status <status>", "DRAFT, ACTIVE, PAUSED, ARCHIVED").option("--from-json <file>", "Update from JSON file").action(async (id, opts) => {
     let body;
     if (opts.fromJson) {
       const { readFileSync: readFileSync6 } = await import("fs");
@@ -8159,6 +8793,8 @@ Examples:
         ...opts.name ? { name: opts.name } : {},
         ...opts.region ? { region: String(opts.region).split(",").map((item) => item.trim()).filter(Boolean) } : {},
         ...opts.description ? { description: opts.description } : {},
+        ...opts.sourceType ? { sourceType: String(opts.sourceType).toUpperCase() } : {},
+        ...opts.sourceType && String(opts.sourceType).toUpperCase() === "INTERNAL" ? { supplierTenantId: null } : opts.supplierTenantId ? { supplierTenantId: opts.supplierTenantId } : {},
         ...opts.contractType ? { contractType: opts.contractType } : {},
         ...opts.sourceMaskingMode ? { sourceMaskingMode: opts.sourceMaskingMode } : {},
         ...opts.priority ? { priority: Number(opts.priority) } : {},
@@ -8474,13 +9110,243 @@ Examples:
   return cmd;
 }
 
+// src/commands/oauth-clients.ts
+var COLUMNS11 = [
+  { key: "id", header: "ID", width: 36 },
+  { key: "name", header: "NAME", width: 28 },
+  { key: "clientId", header: "CLIENT ID", width: 36 },
+  { key: "tenantType", header: "CAPABILITY", width: 12 },
+  { key: "role", header: "ROLE", width: 18 },
+  { key: "isActive", header: "ACTIVE", width: 8 },
+  { key: "createdAt", header: "CREATED", width: 20 }
+];
+function createOAuthClientsCommand() {
+  const cmd = new Command("oauth-clients").description(`OAuth client_credentials management.
+
+Requires: tenant admin or platform admin role.`).addHelpText("after", `
+Examples:
+  $ a8techads oauth-clients list
+  $ a8techads oauth-clients create --name "monedita ssp" --capability PUBLISHER
+  $ a8techads oauth-clients create --name "ci bot" --capability ADVERTISER --save-profile ci-bot
+  $ a8techads oauth-clients delete <id> --yes`);
+  addFormatOption(cmd.command("list").description("List OAuth clients for the current tenant.")).action(async (opts) => {
+    const resp = await apiRequest({ path: oauthClientPath() });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.message ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const rows = asArray(json.data ?? json).map(normalizeClient);
+    printData(rows, COLUMNS11, opts.format);
+  });
+  addFormatOption(cmd.command("create").description(`Create an OAuth client bound to a tenant user.
+
+The secret is returned once. Use --save-profile to store it under ~/.alpineads/oauth-client.json.`).requiredOption("--name <name>", "Client display name").option("--user-id <id>", "Bind the client to a specific tenant user; defaults to the current actor").option("--capability <capability>", "ADVERTISER or PUBLISHER. Defaults to server-side tenant role resolution.").option("--save-profile <profile>", "Save returned client_id/client_secret as a local OAuth profile").option("--api-url <url>", "API URL saved with --save-profile", "https://api.a8.tech").option("--auth-url <url>", "Auth URL saved with --save-profile", "https://auth.a8.tech")).action(async (opts) => {
+    const body = { name: opts.name };
+    if (opts.userId)
+      body.user_id = opts.userId;
+    if (opts.capability)
+      body.capability = normalizeCapability(opts.capability);
+    const resp = await apiRequest({ method: "POST", path: oauthClientPath(), body });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.message ?? json.errors ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const client = json.data ?? json;
+    const normalized = normalizeClient(client);
+    if (opts.format === "json") {
+      console.log(JSON.stringify(client, null, 2));
+    } else {
+      printDetail(normalized, opts.format);
+      if (client.clientSecret ?? client.client_secret) {
+        console.log(`clientSecret  ${client.clientSecret ?? client.client_secret}`);
+      }
+    }
+    const clientId = client.clientId ?? client.client_id ?? client.hydraClientId ?? client.hydra_client_id;
+    const clientSecret = client.clientSecret ?? client.client_secret;
+    if (opts.saveProfile) {
+      if (!clientId || !clientSecret) {
+        console.error("Error: server response did not include clientId/clientSecret; profile was not saved.");
+        process.exit(1);
+      }
+      const saved = saveOAuthClientConfig({
+        profile: opts.saveProfile,
+        clientId,
+        clientSecret,
+        apiUrl: opts.apiUrl,
+        authUrl: opts.authUrl
+      });
+      console.log(`Saved OAuth profile: ${saved.profile}`);
+    } else {
+      console.log("Secret is shown once. Re-run with --save-profile <name> if this client should be used by CLI automation.");
+    }
+  });
+  cmd.command("delete").alias("revoke").description("Revoke an OAuth client.").argument("<id>", "OAuth client ID").option("--yes", "Skip confirmation").action(async (id, opts) => {
+    if (!opts.yes) {
+      console.error("Add --yes to confirm revoking this OAuth client.");
+      process.exit(1);
+    }
+    const resp = await apiRequest({ method: "DELETE", path: `${oauthClientPath()}/${id}` });
+    const json = await resp.json().catch(() => ({}));
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.message ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`OAuth client ${id} revoked.`);
+  });
+  return cmd;
+}
+function oauthClientPath() {
+  return `${dspPrefix()}/settings/oauth-clients`;
+}
+function normalizeClient(client) {
+  return {
+    id: client.id,
+    name: client.name,
+    clientId: client.clientId ?? client.client_id ?? client.hydraClientId ?? client.hydra_client_id,
+    tenantType: client.tenantType ?? client.tenant_type,
+    role: client.role,
+    isActive: client.isActive ?? client.is_active ?? true,
+    createdAt: client.createdAt ?? client.created_at
+  };
+}
+function normalizeCapability(value) {
+  const normalized = value.trim().toUpperCase();
+  if (!["ADVERTISER", "PUBLISHER"].includes(normalized)) {
+    console.error("Error: --capability must be ADVERTISER or PUBLISHER.");
+    process.exit(1);
+  }
+  return normalized;
+}
+function asArray(value) {
+  if (Array.isArray(value))
+    return value;
+  if (value && typeof value === "object") {
+    const maybe = value;
+    if (Array.isArray(maybe.clients))
+      return maybe.clients;
+  }
+  return [];
+}
+
+// src/commands/workflows.ts
+var WORKFLOWS = [
+  {
+    name: "profile-login",
+    area: "Auth",
+    description: "Create, switch, and validate human or client_credentials profiles.",
+    commands: [
+      "a8techads auth login --profile owner",
+      "a8techads profile use owner",
+      "a8techads context show",
+      'a8techads oauth-clients create --name "monedita ssp" --capability PUBLISHER --save-profile monedita-ssp',
+      "a8techads profile use monedita-ssp",
+      "a8techads auth token"
+    ]
+  },
+  {
+    name: "dsp-campaign",
+    area: "DSP",
+    description: "Create the assets needed for a campaign and move it through review.",
+    commands: [
+      "a8techads context dsp",
+      "a8techads media-assets upload --file ./creative.png",
+      "a8techads landing-pages list",
+      'a8techads campaigns create --name "Rewarded Offer Demo" --budget 100',
+      'a8techads variations create --campaign <campaign-id> --name "Offer A" --from-json variation.json',
+      "a8techads variations submit <variation-id>",
+      "a8techads campaigns submit <campaign-id>"
+    ]
+  },
+  {
+    name: "conversion-goals",
+    area: "DSP",
+    description: "Create tracker-compatible goals and print postback instructions.",
+    commands: [
+      "a8techads context dsp",
+      'a8techads conversion-goals create --name "Install" --code install --conversion-type APP_INSTALL --goal-order 1',
+      'a8techads conversion-goals create --name "Registration" --code registration --conversion-type LEAD_SOI --goal-order 2',
+      "a8techads conversion-goals integration <goal-id> --status install",
+      "a8techads conversion-goals integration <goal-id> --status registration"
+    ]
+  },
+  {
+    name: "ssp-inventory",
+    area: "SSP",
+    description: "Create SSP inventory and generate JavaScript or iframe tags.",
+    commands: [
+      "a8techads context ssp",
+      'a8techads sites create --name "Monedita" --domain monedita.jogabox.net',
+      'a8techads zones create --site <site-id> --name "Offerwall" --format offerwall',
+      'a8techads zones create --site <site-id> --name "Rewarded" --format rewarded_video',
+      'a8techads zones tag <offerwall-zone-id> --local --format offerwall --theme dark --sub "{PLAYER_ID}"',
+      'a8techads zones tag <rewarded-zone-id> --local --format rewarded_video --theme dark --sub "{PLAYER_ID}"'
+    ]
+  },
+  {
+    name: "ssp-reconcile",
+    area: "Reports",
+    description: "Pull authoritative SSP metrics for revenue reconciliation.",
+    commands: [
+      "a8techads context ssp",
+      "a8techads reports ssp-pull --from 2026-06-14 --to 2026-06-15 --group-by zone,day,country --metrics requests,fills,impressions,clicks,revenue",
+      "a8techads reports ssp-pull --from 2026-06-14 --to 2026-06-15 --zone <zone-id> --format json"
+    ]
+  },
+  {
+    name: "supply-ops",
+    area: "Console",
+    description: "Inspect supply products, contracts, leases, and runtime allocation state.",
+    commands: [
+      "a8techads context set-app console",
+      "a8techads supply-ops products list",
+      "a8techads supply-ops contracts list",
+      "a8techads supply-ops leases list",
+      "a8techads admin system bidding-gate show --format json"
+    ]
+  }
+];
+var COLUMNS12 = [
+  { key: "name", header: "WORKFLOW", width: 24 },
+  { key: "area", header: "AREA", width: 10 },
+  { key: "description", header: "DESCRIPTION", width: 72 }
+];
+function createWorkflowsCommand() {
+  const cmd = new Command("workflows").description("Discover page-level operating workflows and the CLI commands behind them.").addHelpText("after", `
+Examples:
+  $ a8techads workflows list
+  $ a8techads workflows show ssp-inventory
+  $ a8techads workflows show conversion-goals`);
+  cmd.command("list").description("List available workflows.").action(() => {
+    printData(WORKFLOWS.map(({ name, area, description }) => ({ name, area, description })), COLUMNS12);
+  });
+  cmd.command("show").description("Show commands for a workflow.").argument("<name>", "Workflow name").action((name) => {
+    const workflow = WORKFLOWS.find((item) => item.name === name);
+    if (!workflow) {
+      console.error(`Unknown workflow: ${name}`);
+      console.error(`Available workflows: ${WORKFLOWS.map((item) => item.name).join(", ")}`);
+      process.exit(1);
+    }
+    console.log(`${workflow.name} (${workflow.area})`);
+    console.log(workflow.description);
+    console.log("");
+    for (const command of workflow.commands) {
+      console.log(command);
+    }
+  });
+  return cmd;
+}
+
 // src/index.ts
 function createProgram() {
-  const program2 = new Command().name("a8techads").description("A8TechAds CLI — programmatic ad platform management").version("0.4.1").addHelpText("after", `
+  const program2 = new Command().name("a8techads").description("A8TechAds CLI — programmatic ad platform management").version("0.4.4").addHelpText("after", `
 Command Groups:
   auth          Authentication (login, logout, token, status)
   profile       Multi-profile management
   context       Workspace context (tenant, capability, app)
+  workflows     Page-level operating workflows and command recipes
+  oauth-clients OAuth client_credentials management
   audiences     Audience management (DSP)
   campaigns     Campaign management (DSP)
   variations    Ad variation management (DSP)
@@ -8505,12 +9371,15 @@ Command Groups:
 Getting Started:
   $ a8techads auth login                    # Authenticate
   $ a8techads context show                  # Check current context
+  $ a8techads workflows list                # Discover end-to-end workflows
   $ a8techads campaigns list                # List campaigns (DSP)
   $ a8techads sites list                    # List sites (SSP)
   $ a8techads reports query --metrics spend # Run analytics query`);
   program2.addCommand(createAuthCommand());
   program2.addCommand(createProfileCommand());
   program2.addCommand(createContextCommand());
+  program2.addCommand(createWorkflowsCommand());
+  program2.addCommand(createOAuthClientsCommand());
   program2.addCommand(createAudiencesCommand());
   program2.addCommand(createCampaignsCommand());
   program2.addCommand(createVariationsCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a8techads/cli",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "A8TechAds CLI — programmatic ad platform management",
   "type": "module",
   "bin": {