@cerkel/cli 0.0.0-stage → 1.0.1

package/dist/commands/draft.js

@@ -0,0 +1,101 @@
+import { bool, str } from "../command.js";
+import { READ_HELP, READ_OPTIONS, WRITE_HELP, WRITE_OPTIONS, flagsOf, moneyFlag, runRead, runWrite, show } from "../commerce.js";
+import { CliError } from "../errors.js";
+import { table } from "../format.js";
+import { discountFlag, listFlag, need, pairsFlag } from "./order-args.js";
+const draftLines = (d) => [
+    `Draft ${d.id} — ${d.status}`,
+    `Customer: ${d.customer.name ?? "—"} ${d.customer.phone ?? ""} · ${[d.address.governorate, d.address.city, d.address.address].filter(Boolean).join(", ") || "no address"}`,
+    ...table([["Item", "SKU", "Qty", "Total"], ...d.items.map((l) => [l.title, l.sku ?? "—", String(l.quantity), l.total.formatted])]),
+    `Subtotal ${show(d.totals.subtotal)} · delivery ${show(d.totals.delivery)}${d.totals.deliveryZone ? ` (${d.totals.deliveryZone})` : ""} · discount ${show(d.totals.discount)} · total ${show(d.totals.total)}`,
+    ...(d.problem ? [`Cannot be placed yet: ${d.problem}`] : []),
+];
+export const DRAFT_COMMANDS = {
+    "draft list": {
+        usage: "cerkel draft list [--status open|completed|cancelled] [--store <slug>] [--json]",
+        summary: "List the store's draft orders",
+        help: [READ_HELP],
+        options: { ...READ_OPTIONS, status: { type: "string" } },
+        run: (s, v) => runRead(s, flagsOf(v), "list_draft_orders", { ...(str(v, "status") ? { status: str(v, "status") } : {}) }, (d) => d.drafts.length
+            ? table([["Id", "Created", "Customer", "Total"], ...d.drafts.map((x) => [x.id, x.createdAt.slice(0, 16).replace("T", " "), x.customer.name ?? "—", show(x.totals.total)])])
+            : ["No drafts."]),
+    },
+    "draft get": {
+        usage: "cerkel draft get <id> [--store <slug>] [--json]",
+        summary: "Show one draft order, priced",
+        help: [READ_HELP],
+        options: READ_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => {
+            need(pos, 1, "cerkel draft get <id>");
+            return runRead(s, flagsOf(v), "list_draft_orders", { draft: pos[0] }, draftLines);
+        },
+    },
+    "draft create": {
+        usage: "cerkel draft create --name <name> --phone <phone> --governorate <code> --address <text> --item <sku>=<n>… [--offer <id>=<n>]… [--addon <id>=<n>]… [--city …] [--district …] [--landmark …] [--phone-alt …] [--email …] [--discount <amount|n%>] [--promo <code>] [--delivery-fee <amount>] [--note …] [--tag <t>]… [--whatsapp] [--locale ar|en|ckb] [--store <slug>] [--yes] [--dry-run] [--json]",
+        summary: "Build a draft order for a phone or WhatsApp sale",
+        help: [
+            "The governorate is an ISO code (JO-AM for Amman, IQ-BG for Baghdad): it decides the delivery fee.",
+            "Nothing is sold until `cerkel draft complete <id>`. --whatsapp sends the customer the order-received message then.",
+            WRITE_HELP,
+        ],
+        options: {
+            ...WRITE_OPTIONS,
+            name: { type: "string" }, phone: { type: "string" }, "phone-alt": { type: "string" }, email: { type: "string" },
+            governorate: { type: "string" }, city: { type: "string" }, district: { type: "string" }, landmark: { type: "string" }, address: { type: "string" },
+            item: { type: "string", multiple: true }, offer: { type: "string", multiple: true }, addon: { type: "string", multiple: true },
+            discount: { type: "string" }, promo: { type: "string" }, "delivery-fee": { type: "string" }, note: { type: "string" },
+            tag: { type: "string", multiple: true }, whatsapp: { type: "boolean" }, locale: { type: "string" },
+        },
+        run: (s, v) => {
+            for (const k of ["name", "phone", "governorate", "address"])
+                if (!str(v, k))
+                    throw new CliError(`--${k} is required. See cerkel draft create --help.`);
+            const items = [
+                ...pairsFlag(v, "item", "<sku>").map((p) => ({ variant: p.key, quantity: p.quantity })),
+                ...pairsFlag(v, "offer", "<offer id>").map((p) => ({ offer: p.key, quantity: p.quantity })),
+                ...pairsFlag(v, "addon", "<add-on id>").map((p) => ({ addon: p.key, quantity: p.quantity })),
+            ];
+            if (!items.length)
+                throw new CliError("Add at least one --item <sku>=<quantity>.");
+            const discount = discountFlag(v);
+            const fee = moneyFlag(str(v, "delivery-fee"));
+            return runWrite(s, flagsOf(v), "create_draft_order", {
+                customer: { name: str(v, "name"), phone: str(v, "phone"), ...(str(v, "phone-alt") ? { phone_alt: str(v, "phone-alt") } : {}), ...(str(v, "email") ? { email: str(v, "email") } : {}) },
+                address: {
+                    governorate: str(v, "governorate"), address: str(v, "address"),
+                    ...(str(v, "city") ? { city: str(v, "city") } : {}), ...(str(v, "district") ? { district: str(v, "district") } : {}), ...(str(v, "landmark") ? { landmark: str(v, "landmark") } : {}),
+                },
+                items,
+                ...(discount ? { discount } : {}),
+                ...(str(v, "promo") ? { promo_code: str(v, "promo") } : {}),
+                ...(fee ? { delivery_fee: fee } : {}),
+                ...(str(v, "note") ? { note: str(v, "note") } : {}),
+                ...(listFlag(v, "tag") ? { tags: listFlag(v, "tag") } : {}),
+                ...(bool(v, "whatsapp") ? { send_whatsapp: true } : {}),
+                ...(str(v, "locale") ? { locale: str(v, "locale") } : {}),
+            }, {
+                after: (a) => {
+                    const r = a.result;
+                    return [`Done: ${a.summary}`, ...(r?.id ? [`Draft id: ${r.id} — place it with: cerkel draft complete ${r.id}`] : [])];
+                },
+            });
+        },
+    },
+    "draft complete": {
+        usage: "cerkel draft complete <id> [--store <slug>] [--yes] [--dry-run] [--json]",
+        summary: "Place a draft as a real order (number, stock, cash-on-delivery checks)",
+        help: ["Needs permission to edit and to confirm orders.", WRITE_HELP],
+        options: WRITE_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => {
+            need(pos, 1, "cerkel draft complete <id>");
+            return runWrite(s, flagsOf(v), "complete_draft_order", { draft: pos[0] }, {
+                after: (a) => {
+                    const r = a.result;
+                    return [`Done: order ${r?.number ?? "?"} placed.`];
+                },
+            });
+        },
+    },
+};

package/dist/commands/file.js

@@ -0,0 +1,53 @@
+import { str } from "../command.js";
+import { READ_HELP, READ_OPTIONS, WRITE_HELP, WRITE_OPTIONS, flagsOf, runRead, runWrite } from "../commerce.js";
+import { CliError } from "../errors.js";
+import { table } from "../format.js";
+const size = (b) => (b == null ? "—" : b >= 1_048_576 ? `${(b / 1_048_576).toFixed(1)} MB` : `${Math.max(1, Math.round(b / 1024))} KB`);
+/** `cerkel file …` — the store's media library (list_files, upload_file, delete_file). */
+export const FILE_COMMANDS = {
+    "file list": {
+        usage: "cerkel file list [--kind image|video|document] [--search <text>] [--store <slug>] [--json]",
+        summary: "List the files in the store's media library",
+        help: [READ_HELP],
+        options: { ...READ_OPTIONS, kind: { type: "string" }, search: { type: "string" } },
+        run: (s, v) => {
+            const kind = str(v, "kind");
+            if (kind && !["image", "video", "document"].includes(kind))
+                throw new CliError("--kind is image, video or document.");
+            return runRead(s, flagsOf(v), "list_files", { limit: 200, ...(kind ? { kind } : {}), ...(str(v, "search") ? { q: str(v, "search") } : {}) }, (d) => [
+                ...table([["ID", "NAME", "SIZE", "STATUS", "USED BY", "URL"], ...d.files.map((f) => [f.id, f.filename ?? "—", size(f.bytes), f.status, String(f.usedBy), f.url ?? f.sourceUrl ?? "—"])]),
+                ...(d.total > d.files.length ? [`… ${d.total - d.files.length} more (use --search)`] : []),
+            ]);
+        },
+    },
+    "file upload": {
+        usage: "cerkel file upload <https-url> [--name <filename>] [--store <slug>] [--yes] [--dry-run] [--json]",
+        summary: "Copy an image, video or PDF from a public URL into the store's media library",
+        help: ["Up to 25 MB. Prints the file's permanent URL to use in pages, products and theme settings.", WRITE_HELP],
+        options: { ...WRITE_OPTIONS, name: { type: "string" } },
+        positionals: true,
+        run: (s, v, pos) => {
+            if (pos.length !== 1)
+                throw new CliError("Usage: cerkel file upload <https-url> [--name <filename>]");
+            return runWrite(s, flagsOf(v), "upload_file", { url: pos[0], ...(str(v, "name") ? { filename: str(v, "name") } : {}) }, {
+                after: (o) => [
+                    `Done: ${o.summary}`,
+                    ...(o.file ? [`${o.file.status === "mirrored" ? "Ready" : `Status: ${o.file.status}`}: ${o.file.url ?? o.file.sourceUrl ?? ""}${o.file.error ? ` (${o.file.error})` : ""}`] : []),
+                    ...(o.note ? [o.note] : []),
+                ],
+            });
+        },
+    },
+    "file delete": {
+        usage: "cerkel file delete <file-id> [--store <slug>] [--yes] [--dry-run] [--json]",
+        summary: "Delete a file from the media library (refused while something shows it)",
+        help: [WRITE_HELP],
+        options: WRITE_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => {
+            if (pos.length !== 1)
+                throw new CliError("Usage: cerkel file delete <file-id>");
+            return runWrite(s, flagsOf(v), "delete_file", { file: pos[0] });
+        },
+    },
+};

package/dist/commands/index.js

@@ -0,0 +1,43 @@
+import { COLLECTION_COMMANDS } from "./collection.js";
+import { INVENTORY_COMMANDS } from "./inventory.js";
+import { OFFER_COMMANDS } from "./offer.js";
+import { CUSTOMER_COMMANDS } from "./customer.js";
+import { DRAFT_COMMANDS } from "./draft.js";
+import { ORDER_COMMANDS } from "./order.js";
+import { PRICE_COMMANDS } from "./price.js";
+import { PRODUCT_COMMANDS } from "./product.js";
+import { CALL_COMMANDS } from "./call.js";
+import { CONTENT_COMMANDS } from "./content.js";
+import { FILE_COMMANDS } from "./file.js";
+import { PROMO_COMMANDS } from "./promo.js";
+import { REDIRECT_COMMANDS } from "./redirect.js";
+import { REPORT_COMMANDS } from "./report.js";
+import { STORE_COMMANDS } from "./store.js";
+import { ZONE_COMMANDS } from "./zone.js";
+import { WHATSAPP_COMMANDS } from "./whatsapp.js";
+/**
+ * Every commerce command group (`cerkel store …`, `cerkel price …`, …), each in its own file built on
+ * ../commerce.ts (runRead / runWrite). cli.ts merges these after the theme commands; a new group is
+ * one import and one spread here.
+ */
+export const COMMERCE_COMMANDS = {
+    ...STORE_COMMANDS,
+    ...PRODUCT_COMMANDS,
+    ...PRICE_COMMANDS,
+    ...OFFER_COMMANDS,
+    ...INVENTORY_COMMANDS,
+    ...COLLECTION_COMMANDS,
+    ...CONTENT_COMMANDS,
+    ...REDIRECT_COMMANDS,
+    ...FILE_COMMANDS,
+    ...PROMO_COMMANDS,
+    ...ZONE_COMMANDS,
+    ...REPORT_COMMANDS,
+    ...CALL_COMMANDS,
+    // Phase C: orders, draft orders, customers and reviews.
+    ...ORDER_COMMANDS,
+    ...DRAFT_COMMANDS,
+    ...CUSTOMER_COMMANDS,
+    // WhatsApp template tests.
+    ...WHATSAPP_COMMANDS,
+};

package/dist/commands/inventory.js

@@ -0,0 +1,103 @@
+import { bool, str } from "../command.js";
+import { READ_HELP, READ_OPTIONS, WRITE_HELP, WRITE_OPTIONS, flagsOf, runRead, runWrite } from "../commerce.js";
+import { CliError, ToolRefusal } from "../errors.js";
+import { table } from "../format.js";
+import { defined, int, onOff } from "./args.js";
+const REASONS = "correction, damage, theft, received, return, count";
+export const INVENTORY_COMMANDS = {
+    "inventory get": {
+        usage: "cerkel inventory get <product|sku> [--location <name|code|id>] [--store <slug>] [--json]",
+        summary: "Show stock per variant and location: on hand, reserved, available",
+        help: ["A product handle shows all its variants; a SKU shows that variant.", READ_HELP],
+        options: { ...READ_OPTIONS, location: { type: "string" }, sku: { type: "boolean" } },
+        positionals: true,
+        run: async (s, v, pos) => {
+            const [ref, extra] = pos;
+            if (!ref || extra !== undefined)
+                throw new CliError("Usage: cerkel inventory get <product|sku>");
+            const render = (d) => [
+                `${d.product.title} (${d.product.handle})${d.quantitiesFromShopify ? " — quantities come from the Shopify sync" : ""}`,
+                ...table([["SKU", "VARIANT", "LOCATION", "ON HAND", "RESERVED", "AVAILABLE", "TRACKED"], ...d.variants.flatMap((x) => {
+                        const rows = x.locations.length ? x.locations : [{ name: "—", onHand: 0, reserved: 0, available: 0 }];
+                        return rows.map((l) => [x.sku ?? "—", x.label, l.name ?? "—", String(l.onHand), String(l.reserved), String(l.available), x.tracked ? (x.continueSelling ? "yes, sells when out" : "yes") : "no"]);
+                    })]),
+            ];
+            const location = str(v, "location");
+            // A handle first (product), then the same text as a SKU (variant): the server says which exists.
+            if (!bool(v, "sku")) {
+                try {
+                    return await runRead(s, flagsOf(v), "get_inventory_levels", defined({ product: ref, location }), render);
+                }
+                catch (e) {
+                    if (!(e instanceof ToolRefusal) || e.code !== "not_found")
+                        throw e;
+                }
+            }
+            return runRead(s, flagsOf(v), "get_inventory_levels", defined({ variant: ref, location }), render);
+        },
+    },
+    "inventory adjust": {
+        usage: "cerkel inventory adjust <sku> <+N|-N> [--reason <reason>] [--location <name>] [--note <text>] [--yes] [--dry-run] [--json]",
+        summary: "Add or take away units of a variant at a location",
+        help: [`Reasons: ${REASONS} (default correction; received for a supplier delivery).`, WRITE_HELP],
+        options: { ...WRITE_OPTIONS, reason: { type: "string" }, location: { type: "string" }, note: { type: "string" } },
+        positionals: true,
+        run: (s, v, pos) => {
+            const [variant, qty, extra] = pos;
+            if (!variant || qty === undefined || extra !== undefined)
+                throw new CliError("Usage: cerkel inventory adjust <sku> <+N|-N> [--reason received]");
+            return runWrite(s, flagsOf(v), "adjust_inventory", defined({
+                variant, quantity: int(qty.replace(/^\+/, ""), "The quantity"), reason: str(v, "reason") ?? "correction", location: str(v, "location"), note: str(v, "note"),
+            }));
+        },
+    },
+    "inventory set": {
+        usage: "cerkel inventory set <sku> <N> [--reason <reason>] [--location <name>] [--note <text>] [--yes] [--dry-run] [--json]",
+        summary: "Set the units on hand of a variant at a location to an exact number",
+        help: [`Reasons: ${REASONS} (default correction).`, WRITE_HELP],
+        options: { ...WRITE_OPTIONS, reason: { type: "string" }, location: { type: "string" }, note: { type: "string" } },
+        positionals: true,
+        run: (s, v, pos) => {
+            const [variant, qty, extra] = pos;
+            if (!variant || qty === undefined || extra !== undefined)
+                throw new CliError("Usage: cerkel inventory set <sku> <N>");
+            return runWrite(s, flagsOf(v), "set_inventory", defined({
+                variant, quantity: int(qty, "The quantity"), reason: str(v, "reason"), location: str(v, "location"), note: str(v, "note"),
+            }));
+        },
+    },
+    "inventory tracking": {
+        usage: "cerkel inventory tracking <product> [--track on|off] [--continue-selling on|off] [--variant <sku>]… [--yes] [--dry-run] [--json]",
+        summary: "Turn Track quantity / Continue selling when out of stock on or off",
+        help: ["All the product's variants, or the ones named with --variant.", WRITE_HELP],
+        options: { ...WRITE_OPTIONS, track: { type: "string" }, "continue-selling": { type: "string" }, variant: { type: "string", multiple: true } },
+        positionals: true,
+        run: (s, v, pos) => {
+            const [product, extra] = pos;
+            if (!product || extra !== undefined)
+                throw new CliError("Usage: cerkel inventory tracking <product> --track on|off");
+            const variants = Array.isArray(v["variant"]) ? v["variant"] : undefined;
+            return runWrite(s, flagsOf(v), "set_inventory_tracking", defined({
+                product, variants: variants?.length ? variants : undefined, track: onOff(str(v, "track"), "--track"), continueSelling: onOff(str(v, "continue-selling"), "--continue-selling"),
+            }));
+        },
+    },
+    "inventory locations": {
+        usage: "cerkel inventory locations [--all] [--store <slug>] [--json]",
+        summary: "Show the store's stock locations (--all includes inactive ones)",
+        help: [READ_HELP],
+        options: { ...READ_OPTIONS, all: { type: "boolean" } },
+        run: (s, v) => runRead(s, flagsOf(v), "list_locations", bool(v, "all") ? { includeInactive: true } : {}, (d) => table([["NAME", "CODE", "TYPE", "DEFAULT", "ACTIVE", "SHARED"], ...d.locations.map((l) => [
+                l.name, l.code ?? "—", l.type, l.isDefault ? "yes" : "", l.active ? "yes" : "no", l.sharedByOrg ? "yes" : "",
+            ])])),
+    },
+    "inventory low": {
+        usage: "cerkel inventory low [--out] [--limit N] [--store <slug>] [--json]",
+        summary: "Show tracked variants that are low or out of stock",
+        help: ["--out lists only what has nothing left to sell.", READ_HELP],
+        options: { ...READ_OPTIONS, out: { type: "boolean" }, limit: { type: "string" } },
+        run: (s, v) => runRead(s, flagsOf(v), "list_low_stock", defined({ status: bool(v, "out") ? "out" : undefined, limit: int(str(v, "limit"), "--limit") }), (d) => d.variants.length === 0 ? ["Nothing is low or out of stock."] : table([["SKU", "PRODUCT", "VARIANT", "STATUS", "AVAILABLE", "REORDER AT"], ...d.variants.map((x) => [
+                x.sku ?? "—", x.product.handle, x.variant || "—", x.status, String(x.available), x.reorderPoint === null ? "—" : String(x.reorderPoint),
+            ])])),
+    },
+};

package/dist/commands/offer.js

@@ -0,0 +1,92 @@
+import { str } from "../command.js";
+import { READ_HELP, READ_OPTIONS, WRITE_HELP, WRITE_OPTIONS, flagsOf, moneyFlag, runRead, runWrite, show } from "../commerce.js";
+import { CliError } from "../errors.js";
+import { table } from "../format.js";
+import { LANG_OPTION, TEXT_HELP, defined, int, lines, localized, pairs, textOf } from "./args.js";
+const activeFlag = (v) => (v["active"] === true ? true : v["inactive"] === true ? false : undefined);
+export const OFFER_COMMANDS = {
+    "offer list": {
+        usage: "cerkel offer list [product] [--store <slug>] [--json]",
+        summary: "Show bundle tiers and add-ons (of one product, or the whole store)",
+        help: [READ_HELP],
+        options: READ_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => runRead(s, flagsOf(v), "list_offers", defined({ product: pos[0] }), (d) => [
+            ...(d.offers.length
+                ? table([["PRODUCT", "KEY", "LABEL", "PRICE", "COMPARE-AT", "PIECES", "ACTIVE"], ...d.offers.map((o) => [
+                        o.product, o.key, textOf(o.label), show(o.price), show(o.compareAt), String(o.lines.reduce((n, l) => n + l.quantity, 0)), o.active ? "yes" : "no",
+                    ])])
+                : ["No bundle tiers."]),
+            "",
+            ...(d.addons.length
+                ? table([["PRODUCT", "ADD-ON", "PRICE", "ACTIVE"], ...d.addons.map((a) => [a.product, a.variant.label ?? a.variant.sku ?? "—", show(a.price), a.active ? "yes" : "no"])])
+                : ["No add-ons."]),
+        ]),
+    },
+    "offer set": {
+        usage: "cerkel offer set <product> [<key>] [--label …] [--badge …] [--description …] [--price <amount>] [--compare-at <amount|none>] [--line <sku>:<qty>]… [--composition name=N]… [--position N] [--active|--inactive] [--yes] [--dry-run] [--json]",
+        summary: "Create a bundle tier, or change one (name it by its key)",
+        help: [
+            "New tier: --label, --price and at least one --line (e.g. --line JL-SQ:5 --line JL-CYL:1). Existing tier: only what you pass changes.",
+            "Amounts are in the store's currency (IQD in steps of 250). --new-key sets the key of a new tier (else one is generated).",
+            TEXT_HELP, WRITE_HELP,
+        ],
+        options: {
+            ...WRITE_OPTIONS, ...LANG_OPTION, label: { type: "string", multiple: true }, badge: { type: "string", multiple: true }, description: { type: "string", multiple: true },
+            price: { type: "string" }, "compare-at": { type: "string" }, line: { type: "string", multiple: true }, composition: { type: "string", multiple: true },
+            position: { type: "string" }, active: { type: "boolean" }, inactive: { type: "boolean" }, "new-key": { type: "string" },
+        },
+        positionals: true,
+        run: (s, v, pos) => {
+            const [product, offer, extra] = pos;
+            if (!product || extra !== undefined)
+                throw new CliError("Usage: cerkel offer set <product> [<key>] [flags]");
+            return runWrite(s, flagsOf(v), "upsert_offer", defined({
+                product, offer, key: str(v, "new-key"), label: localized(v, "label"), badge: localized(v, "badge"), description: localized(v, "description"),
+                price: str(v, "price"), compareAt: moneyFlag(str(v, "compare-at")), lines: lines(v, "line"), composition: pairs(v, "composition"),
+                position: int(str(v, "position"), "--position"), active: activeFlag(v),
+            }));
+        },
+    },
+    "offer delete": {
+        usage: "cerkel offer delete <product> <key> [--yes] [--dry-run] [--json]",
+        summary: "Delete a bundle tier (or hide it with offer set --inactive)",
+        help: [WRITE_HELP],
+        options: WRITE_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => {
+            const [product, offer, extra] = pos;
+            if (!product || !offer || extra !== undefined)
+                throw new CliError("Usage: cerkel offer delete <product> <key>");
+            return runWrite(s, flagsOf(v), "delete_offer", { product, offer });
+        },
+    },
+    "addon set": {
+        usage: "cerkel addon set <product> <addon-sku> [--price <amount>] [--compare-at <amount|none>] [--position N] [--active|--inactive] [--yes] [--dry-run] [--json]",
+        summary: "Offer a variant as an add-on with a product's order, or change it",
+        help: ["A new add-on needs --price (0 = a free gift). Only what you pass changes.", WRITE_HELP],
+        options: { ...WRITE_OPTIONS, price: { type: "string" }, "compare-at": { type: "string" }, position: { type: "string" }, active: { type: "boolean" }, inactive: { type: "boolean" } },
+        positionals: true,
+        run: (s, v, pos) => {
+            const [product, variant, extra] = pos;
+            if (!product || !variant || extra !== undefined)
+                throw new CliError("Usage: cerkel addon set <product> <addon-sku> [--price <amount>]");
+            return runWrite(s, flagsOf(v), "upsert_addon", defined({
+                product, variant, price: str(v, "price"), compareAt: moneyFlag(str(v, "compare-at")), position: int(str(v, "position"), "--position"), active: activeFlag(v),
+            }));
+        },
+    },
+    "addon delete": {
+        usage: "cerkel addon delete <product> <addon-sku> [--yes] [--dry-run] [--json]",
+        summary: "Stop offering a variant as an add-on with a product",
+        help: [WRITE_HELP],
+        options: WRITE_OPTIONS,
+        positionals: true,
+        run: (s, v, pos) => {
+            const [product, variant, extra] = pos;
+            if (!product || !variant || extra !== undefined)
+                throw new CliError("Usage: cerkel addon delete <product> <addon-sku>");
+            return runWrite(s, flagsOf(v), "delete_addon", { product, variant });
+        },
+    },
+};

package/dist/commands/order-args.js

@@ -0,0 +1,37 @@
+import { str } from "../command.js";
+import { CliError } from "../errors.js";
+// Argument helpers for the phase C groups (order, draft, customer, review); args.ts holds the catalogue ones.
+/** A repeatable flag (`--tag a --tag b`) or a comma list (`--tag a,b`), trimmed, empties dropped. */
+export function listFlag(v, k) {
+    const raw = v[k];
+    if (raw === undefined)
+        return undefined;
+    const parts = (Array.isArray(raw) ? raw : [raw]).filter((x) => typeof x === "string");
+    return parts.flatMap((p) => p.split(",")).map((p) => p.trim()).filter(Boolean);
+}
+/** `KEY=N` pairs (`--add JL-90=2`), the number a whole quantity. */
+export function pairsFlag(v, k, what) {
+    return (listFlag(v, k) ?? []).map((p) => {
+        const m = /^(.+?)=(\d{1,3})$/.exec(p);
+        if (!m)
+            throw new CliError(`--${k} takes ${what}=<quantity>, e.g. --${k} JL-90=2 (got "${p}").`);
+        return { key: m[1].trim(), quantity: Number(m[2]) };
+    });
+}
+/** `--discount 10%` → percent, `--discount 2.500` → amount (as typed; the server parses money), `none` → null. */
+export function discountFlag(v, k = "discount") {
+    const raw = str(v, k);
+    if (raw === undefined)
+        return undefined;
+    const t = raw.trim();
+    if (["none", "null", "-", ""].includes(t.toLowerCase()))
+        return null;
+    return t.endsWith("%") ? { type: "percent", value: t.slice(0, -1).trim() } : { type: "amount", value: t };
+}
+/** The rest of the positionals as one text (`cerkel order note JL-1001 Customer called back`). */
+export const textOf = (pos, from) => pos.slice(from).join(" ").trim();
+/** Fails with the usage line when a positional is missing. */
+export function need(pos, n, usage) {
+    if (pos.length < n || pos.slice(0, n).some((p) => !p?.trim()))
+        throw new CliError(`Usage: ${usage}`);
+}