@zalify/cli 0.19.0 → 0.20.0

package/README.md

@@ -101,6 +101,7 @@ its new home under `shop`.
 | --- | --- |
 | `ads create <dir>` | Provision an Autopilot brand-instance GitHub repo (POST `/api/repos`, GitHub App), scaffold the starter locally (`identity.yaml`, `brand.yaml`, `policy/`, `campaigns/`, `media-plans/`, `signals/`, `decisions/`), and push with a short-lived repo-scoped token. Writes `.zalify/brand-repo.json` so later commands run arg-free. The directory name becomes the slug — use the workspace's store slug so the service's digest writer can find the repo |
 | `ads` / `ads list` | List the workspace's brand instances and their provisioning status |
+| `ads new <name> [--objective] [--budget] [--country] [--link]` | Scaffold a campaign FOLDER — the drag-and-drop form: `campaign.yaml` for budget/audience/copy defaults, `creatives/` for the files that become ads. Three questions when interactive, flags otherwise. `cp -r` an existing folder to duplicate a campaign |
 | `ads remove <slug>` | Deprecate a brand instance — soft-deletes the record (drops out of `ads list` and the service's repo-token minting; survives for history). The GitHub repo is deliberately untouched: deleting real campaign intent is a human-on-GitHub decision |
 | `ads status` | The instance at a glance: brand + consent, platform access and credential expiry, ingestion freshness (with per-account failures), first-party join coverage, plan and pending-proposal counts. Exits non-zero when the service reports problems |
 | `ads report [--date <YYYY-MM-DD>] [--platform <all\|meta\|google>]` | The daily report in the terminal — totals vs the day before, where the money moved, what changed in the account |

package/dist/cli.js

@@ -20118,8 +20118,9 @@ async function shopifyUploadImages(storeDir, options = {}) {
 
 // src/ads.ts
 import { spawnSync as spawnSync4 } from "node:child_process";
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync7 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync3, writeFileSync as writeFileSync7 } from "node:fs";
 import { basename as basename4, join as join8, resolve as resolve6 } from "node:path";
+import { createInterface } from "node:readline/promises";
 function apiError3(status, json) {
   if (json.code === "SLUG_TAKEN") {
     return new Error(`${json.error}
@@ -20255,6 +20256,62 @@ Next steps:
 ` + `  - flip consent: true once the brand owner has signed off
 ` + `  - the Autopilot service picks the instance up from there`);
 }
+var CAMPAIGN_NAME_RE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+function campaignsDir() {
+  const cwd = resolve6(".");
+  if (existsSync8(join8(cwd, "campaigns")))
+    return join8(cwd, "campaigns");
+  if (existsSync8(join8(cwd, ".zalify", "brand-repo.json"))) {
+    return join8(cwd, "campaigns");
+  }
+  throw new Error("Not inside a brand-instance checkout — run from the repo `zalify ads create` made.");
+}
+async function ask(question, fallback) {
+  if (!process.stdin.isTTY)
+    return fallback;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const answer = (await rl.question(`${question} [${fallback}]: `)).trim();
+  rl.close();
+  return answer || fallback;
+}
+async function adsNew(name, opts) {
+  if (!CAMPAIGN_NAME_RE.test(name) || name.length > 63) {
+    throw new Error(`"${name}" — campaign names are lowercase letters, digits, and inner hyphens.`);
+  }
+  const dir2 = join8(campaignsDir(), name);
+  if (existsSync8(dir2))
+    throw new Error(`campaigns/${name}/ already exists.`);
+  const objective = opts.objective ?? await ask("objective (sales/leads/traffic/awareness)", "sales");
+  const budget = opts.budget ?? await ask("budget", "$20/day");
+  const country = opts.country ?? await ask("country", "US");
+  const link = opts.link ?? "";
+  mkdirSync3(join8(dir2, "creatives"), { recursive: true });
+  writeFileSync7(join8(dir2, "creatives", ".gitkeep"), "");
+  writeFileSync7(join8(dir2, "campaign.yaml"), `# ${name} — drop images into creatives/, fill the copy below, then
+# \`zalify ads sync\`. Each file becomes an ad named after itself; give
+# one ad its own copy with creatives/<file>.copy.yaml.
+campaign: ${name}
+objective: ${objective}
+budget: ${budget}            # "$60/day" or "$900 total"
+
+# Copy every derived ad inherits.
+creative_defaults:
+  primary_text: ""${link ? "" : "         # ← fill me"}
+  link: ${link || '""              # ← your product URL'}
+  cta: shop_now
+
+ad_sets:
+  - name: main
+    audience:
+      countries: [${country.split(",").map((c) => c.trim().toUpperCase()).filter(Boolean).join(", ")}]
+      age: 18-65
+      advantage: true
+`);
+  console.log(`✓ campaigns/${name}/ is ready`);
+  console.log("  1. drag images into creatives/");
+  console.log("  2. fill primary_text and link in campaign.yaml");
+  console.log("  3. `zalify ads sync` when it lands — validate, diff, apply");
+}
 async function adsRemove(slug) {
   const auth = requireActive();
   const json = await request2(auth, "GET", "/api/repos");
@@ -20283,7 +20340,7 @@ async function adsList() {
 
 // src/ads-read.ts
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync8, readFileSync as readFileSync7 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:fs";
 import { join as join9, resolve as resolve7 } from "node:path";
 
 // node_modules/yaml/dist/index.js
@@ -20422,7 +20479,7 @@ account changes: ${a.byPerson} by people, ${a.byMeta} automated`);
 function adsDigest(dir2) {
   const root = resolve7(dir2 ?? ".");
   const path9 = join9(root, "signals", "latest.json");
-  if (!existsSync8(path9)) {
+  if (!existsSync9(path9)) {
     throw new Error("signals/latest.json not found — run from a brand-instance checkout " + "(and pull: the service commits a digest daily).");
   }
   const d = JSON.parse(readFileSync7(path9, "utf8"));
@@ -20473,7 +20530,7 @@ async function adsDoctor(dir2) {
   };
   const linkPath = join9(root, ".zalify", "brand-repo.json");
   let link = null;
-  if (existsSync8(linkPath)) {
+  if (existsSync9(linkPath)) {
     link = JSON.parse(readFileSync7(linkPath, "utf8"));
     ok(`checkout linked to ${link?.repo} (slug ${link?.slug})`);
   } else {
@@ -20481,7 +20538,7 @@ async function adsDoctor(dir2) {
   }
   let identity2 = null;
   const identityPath = join9(root, "identity.yaml");
-  if (existsSync8(identityPath)) {
+  if (existsSync9(identityPath)) {
     try {
       identity2 = $parse(readFileSync7(identityPath, "utf8"));
       ok("identity.yaml parses");
@@ -20549,7 +20606,7 @@ ${failed} problem${failed > 1 ? "s" : ""}.`);
 }
 
 // src/brand.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "node:fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "node:fs";
 import { basename as basename5, join as join10, resolve as resolve8 } from "node:path";
 var AUTHORING_MD = `# Brand authoring guide
 
@@ -20853,7 +20910,7 @@ var MANIFEST_JSON = JSON.stringify({
 function brandInit(dir2 = ".", opts = {}) {
   const target = resolve8(dir2);
   const slug = basename5(target).toLowerCase().replaceAll(/[^a-z0-9-]+/g, "-").replaceAll(/^-+|-+$/g, "");
-  if (existsSync9(target) && readdirSync3(target).length > 0) {
+  if (existsSync10(target) && readdirSync3(target).length > 0) {
     throw new Error(`${dir2} already exists and is not empty`);
   }
   const name = opts.name ?? slug.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
@@ -20879,7 +20936,7 @@ function brandValidate(dir2 = ".") {
   const warnings = [];
   const readJson2 = (rel) => {
     const path9 = join10(target, rel);
-    if (!existsSync9(path9)) {
+    if (!existsSync10(path9)) {
       problems.push(`missing ${rel}`);
       return null;
     }
@@ -20890,7 +20947,7 @@ function brandValidate(dir2 = ".") {
       return null;
     }
   };
-  if (!existsSync9(join10(target, "brand.md")))
+  if (!existsSync10(join10(target, "brand.md")))
     problems.push("missing brand.md");
   const store = readJson2("store.json");
   if (store && (!store.name || !store.slug))
@@ -21148,6 +21205,9 @@ ads.command("list", { isDefault: true }).description("List the workspace's brand
 ads.command("remove <slug>").description("Deprecate a brand instance (record soft-deleted; the GitHub repo is left untouched)").action(async (slug) => {
   await adsRemove(slug);
 });
+ads.command("new <name>").description("Scaffold a campaign folder — drop images into creatives/, then sync").option("--objective <o>", "sales | leads | traffic | awareness").option("--budget <b>", '"$60/day" or "$900 total"').option("--country <cc>", "comma-separated ISO codes, e.g. US,CA").option("--link <url>", "destination URL for creative_defaults").action(async (name, options) => {
+  await adsNew(name, options);
+});
 ads.command("status").description("The brand instance at a glance: access, ingestion freshness, plans, pending proposals").action(async () => {
   await adsStatus();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zalify/cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Zalify CLI - command-line interface for Zalify",
   "type": "module",
   "main": "dist/cli.js",