@series-a/cli 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to `@series-a/cli` (and the paired `@series-a/mcp` server).
 
+## 1.2.0 — booking links and full profile-settings editing
+
+### Added
+- `practice update` / `dentist update` `--booking <url>` and `--website <url>` shortcuts for setting the booking and website links without `--set`
+- `--set-enrichment path=value` for nested practice profile values (positioning summary/archetype/marketing descriptions, amenities, default currency), so every field on the practice profile settings screen is editable from the CLI
+- `--fields` now also lists the available `--set-enrichment` paths
+- MCP `setu_profile_update` accepts `enrichment_set`
+
+## 1.1.0 — editing, pricing and media
+
+### Added
+- `practice update` / `dentist update` — edit whitelisted fields on unclaimed seeded profiles (`--set field=value`, repeatable; `--fields` lists what's allowed)
+- `practice images` / `dentist images` — add, remove (by URL or index), reorder, replace or clear gallery photos, and set the logo / main photo
+- `practice pricing` / `dentist pricing` — read, set, remove or clear treatment prices
+- `dentist delete` / `dentist delete --unpublish`
+- Much wider field allowlists, including services, all private fee columns, specialties, languages and matching fields
+- MCP tools `setu_profile_update`, `setu_profile_images` and `setu_profile_pricing`
+
 ## 1.0.0 — first stable release
 
 First release marked stable for internal team use.

package/README.md

@@ -88,11 +88,64 @@ setu practice import practices.csv --resume results.json # retry failures only
 Rows need either a `website`/`url`, or a `name` plus `town`/`city`; anything
 else is reported and skipped before any API call is made.
 
+## Editing seeded profiles
+
+```bash
+setu practice update <practice-id> --fields                     # what you can set
+setu practice update <practice-id> --set tagline="Gentle care" --set emergency_available=true
+setu dentist  update <dentist-id>  --set bio="20 years in implants"
+
+# Booking / website link shortcuts
+setu practice update <practice-id> --booking https://clinic.co.uk/book
+setu dentist  update <dentist-id>  --booking https://clinic.co.uk/book --website https://clinic.co.uk
+```
+
+Lists take comma-separated values, e.g. `--set services="Implants,Whitening"`.
+
+Everything on the practice profile settings screen is settable. The few values that
+live in the nested profile record — positioning, amenities, default currency — use
+`--set-enrichment`:
+
+```bash
+setu practice update <practice-id> --set-enrichment positioning.summary="Calm, modern care in Leeds"
+setu practice update <practice-id> --set-enrichment amenities="Wi-Fi,Free parking,Step-free access"
+setu practice update <practice-id> --set-enrichment positioning.archetype=boutique
+setu practice update <practice-id> --set parking_info="Two-hour free bay on site" \
+  --set accessibility="Step-free,Hearing loop" --set languages="English,Polish"
+```
+
+## Photos and logos
+
+```bash
+setu practice images <practice-id> --list
+setu practice images <practice-id> --add https://.../photo.jpg
+setu practice images <practice-id> --remove 2                   # by index, or pass the URL
+setu practice images <practice-id> --order "https://.../hero.jpg"   # move these to the front
+setu practice images <practice-id> --replace "https://a.jpg,https://b.jpg"
+setu practice images <practice-id> --logo https://.../logo.png
+setu dentist  images <dentist-id>  --logo https://.../headshot.jpg  # main photo
+```
+
+## Prices and services
+
+```bash
+setu practice pricing <practice-id> --list
+setu practice pricing <practice-id> --set "Dental implant=1200" --set "Whitening=300-450"
+setu practice pricing <practice-id> --remove "Whitening"
+setu dentist  pricing <dentist-id>  --set "Hygiene visit=75"
+setu practice update <practice-id> --set services="Implants,Whitening,Invisalign"
+```
+
+Practice prices update the practice's treatment list too. Dentist prices are
+saved as individual treatment rows shown on the clinician's profile.
+
 ## Removing seeded profiles
 
 ```bash
 setu practice delete <practice-id> --unpublish   # hide from patients
 setu practice delete <practice-id>               # delete (unclaimed only)
+setu dentist  delete <dentist-id> --unpublish
+setu dentist  delete <dentist-id>
 ```
 
 Claimed or user-owned profiles are always refused.

package/bin/setu.mjs

@@ -32,8 +32,12 @@ function parseArgs(argv) {
     if (a.startsWith("--")) {
       const key = a.slice(2);
       const next = argv[i + 1];
-      if (!next || next.startsWith("--")) flags[key] = true;
-      else { flags[key] = next; i++; }
+      let value = true;
+      if (next && !next.startsWith("--")) { value = next; i++; }
+      // Repeatable flags (--set, --add, --remove) collect into arrays.
+      if (key in flags) {
+        flags[key] = Array.isArray(flags[key]) ? [...flags[key], value] : [flags[key], value];
+      } else flags[key] = value;
     } else positional.push(a);
   }
   return { positional, flags };
@@ -65,8 +69,23 @@ ${c.bold("Commands")}
       [--rotate]
   practice delete <practice-id>          Remove an unclaimed seeded profile
       [--unpublish] [--yes]
+  practice update <practice-id>          Edit fields on a seeded profile
+      --set field=value                    repeatable, e.g. --set tagline="Gentle care"
+      --set-enrichment path=value          e.g. --set-enrichment amenities="Wi-Fi|Parking"
+      [--booking <url>] [--website <url>]  shortcuts for the booking / website links
+      [--fields]                           list the fields you can set
+  practice images <practice-id>          Manage photos on a seeded profile
+      [--add <url>] [--remove <url|index>] [--order "url1,url2"]
+      [--logo <url>] [--replace "url1,url2"] [--clear] [--list]
+  practice pricing <practice-id>         Manage treatment prices
+      [--set "Implant=1200"] [--remove "Implant"] [--clear] [--list]
   dentist create --name "Dr Jane Roe"    Seed one clinician
       [--practice <id>] [--profile-url <url>] [--town <town>]
+  dentist update <dentist-id>            Edit fields on a seeded clinician
+  dentist images <dentist-id>            Manage a clinician's photos
+  dentist pricing <dentist-id>           Manage a clinician's treatment prices
+  dentist delete <dentist-id>            Remove an unclaimed seeded clinician
+      [--unpublish] [--yes]
   status [<practice-id>]                 List or inspect seeded profiles
 
 ${c.bold("Global")}  --json  --yes  --verbose  --operator <name>  --version
@@ -88,7 +107,7 @@ function cmdLogout() {
   ok(`Signed out — removed ${configPath()}`);
 }
 
-async function cmdPracticeDelete(id) {
+async function cmdPracticeDelete(id, type = "practice") {
   if (!id) { fail("Usage: setu practice delete <practice-id> [--unpublish]"); process.exit(1); }
   const unpublishOnly = !!flags.unpublish;
   if (!JSON_OUT && !flags.yes) {
@@ -101,13 +120,152 @@ async function cmdPracticeDelete(id) {
   }
   const res = await call("cli-profile-delete", {
     id,
-    profile_type: flags.dentist ? "dentist" : "practice",
+    profile_type: type === "dentist" || flags.dentist ? "dentist" : "practice",
     unpublish_only: unpublishOnly,
   });
   if (JSON_OUT) return out(res);
   ok(`${res.name} — ${res.action}`);
 }
 
+const asList = (v) => (v === undefined || v === true ? [] : Array.isArray(v) ? v : [v]);
+const splitList = (v) =>
+  asList(v).flatMap((item) => String(item).split(",").map((s) => s.trim()).filter(Boolean));
+
+async function cmdProfileUpdate(type, id) {
+  if (flags.fields) {
+    // The server answers with the whitelist when nothing valid is sent.
+    try {
+      const r = await call("cli-profile-update", { id: id || "00000000-0000-0000-0000-000000000000", profile_type: type, read: true });
+      if (JSON_OUT) return out({ fields: r.allowed_fields, enrichment_paths: r.allowed_enrichment_paths ?? [] });
+      heading(`Fields you can set on a ${type}`);
+      log("  " + r.allowed_fields.join(", "));
+      if (r.allowed_enrichment_paths?.length) {
+        heading("Extra fields (use --set-enrichment path=value)");
+        log("  " + r.allowed_enrichment_paths.join(", "));
+      }
+      return;
+    } catch (e) {
+      const fields = e.data?.allowed_fields;
+      if (fields) {
+        if (JSON_OUT) return out({ fields });
+        heading(`Fields you can set on a ${type}`);
+        log("  " + fields.join(", "));
+        return;
+      }
+      throw e;
+    }
+    return;
+  }
+  if (!id) { fail(`Usage: setu ${type} update <id> [--set field=value] [--booking <url>] [--website <url>]`); process.exit(1); }
+
+  const set = {};
+  const pairs = asList(flags.set);
+  for (const pair of pairs) {
+    const raw = String(pair);
+    const eq = raw.indexOf("=");
+    if (eq < 1) { fail(`Bad --set value: "${raw}". Use field=value.`); process.exit(1); }
+    set[raw.slice(0, eq).trim()] = raw.slice(eq + 1);
+  }
+  const enrichmentSet = {};
+  for (const pair of asList(flags["set-enrichment"])) {
+    const raw = String(pair);
+    const eq = raw.indexOf("=");
+    if (eq < 1) { fail(`Bad --set-enrichment value: "${raw}". Use path=value.`); process.exit(1); }
+    enrichmentSet[raw.slice(0, eq).trim()] = raw.slice(eq + 1);
+  }
+  if (flags.booking !== undefined) set.booking_url = flags.booking === true ? "" : String(flags.booking);
+  if (flags.website !== undefined) set[type === "dentist" ? "website_url" : "website"] = flags.website === true ? "" : String(flags.website);
+  if (!Object.keys(set).length && !Object.keys(enrichmentSet).length) { fail("Pass at least one --set field=value, --set-enrichment path=value, --booking <url> or --website <url> (or --fields to see what you can set)."); process.exit(1); }
+
+  const res = await call("cli-profile-update", {
+    id,
+    profile_type: type,
+    set,
+    ...(Object.keys(enrichmentSet).length ? { enrichment_set: enrichmentSet } : {}),
+  });
+  if (JSON_OUT) return out(res);
+  ok(`${res.name} — updated ${res.updated.join(", ")}`);
+  if (res.rejected?.length) warn(`Ignored unknown field(s): ${res.rejected.join(", ")}`);
+}
+
+async function cmdProfileImages(type, id) {
+  if (!id) { fail(`Usage: setu ${type} images <id> [--add <url>] [--remove <url|index>] [--order "a,b"] [--logo <url>]`); process.exit(1); }
+
+  const images = {};
+  if (splitList(flags.add).length) images.add = splitList(flags.add);
+  if (splitList(flags.remove).length) images.remove = splitList(flags.remove);
+  if (splitList(flags.order).length) images.order = splitList(flags.order);
+  if (splitList(flags.replace).length) images.replace = splitList(flags.replace);
+  if (flags.clear === true) images.clear = true;
+  if (flags.logo !== undefined) images.logo = flags.logo === true ? null : String(flags.logo);
+
+  if (!Object.keys(images).length || flags.list) {
+    // Listing is a no-op update: ask the server for the current state.
+    const res = await call("cli-profile-update", { id, profile_type: type, read: true });
+    if (JSON_OUT) return out(res);
+    heading(`${res.name} — photos (${res.gallery.length})`);
+    res.gallery.forEach((url, i) => log(`  ${String(i).padEnd(3)} ${url}`));
+    log(`  ${c.dim(type === "dentist" ? "main photo" : "logo")}: ${res.logo ?? c.dim("none")}`);
+    return;
+  }
+
+  if (images.clear && !JSON_OUT && !flags.yes) {
+    const proceed = await confirm("Remove every photo from this profile?");
+    if (!proceed) { warn("Cancelled."); return; }
+  }
+
+  const res = await call("cli-profile-update", { id, profile_type: type, images });
+  if (JSON_OUT) return out(res);
+  ok(`${res.name} — ${res.gallery.length} photo(s)${res.logo ? ", logo set" : ""}`);
+  res.gallery.forEach((url, i) => log(`  ${String(i).padEnd(3)} ${c.dim(url)}`));
+}
+
+async function cmdProfilePricing(type, id) {
+  if (!id) { fail(`Usage: setu ${type} pricing <id> [--set "Implant=1200"] [--remove "Implant"] [--clear] [--list]`); process.exit(1); }
+
+  const setPairs = asList(flags.set);
+  const removals = splitList(flags.remove);
+  const wantsWrite = setPairs.length || removals.length || flags.clear === true;
+
+  if (!wantsWrite || flags.list) {
+    const res = await call("cli-profile-update", { id, profile_type: type, read: true });
+    if (JSON_OUT) return out({ id, pricing: res.pricing ?? [] });
+    const rows = res.pricing ?? [];
+    heading(`${res.name} — prices (${rows.length})`);
+    if (!rows.length) log(c.dim("  none yet — add with --set \"Implant=1200\""));
+    rows.forEach((r) => {
+      const range = r.amount_to ? `${r.amount}–${r.amount_to}` : r.amount;
+      log(`  ${String(r.label).padEnd(34)} £${range ?? "?"}`);
+    });
+    return;
+  }
+
+  const pricing = {};
+  if (setPairs.length) {
+    pricing.set = {};
+    for (const pair of setPairs) {
+      const raw = String(pair);
+      const eq = raw.indexOf("=");
+      if (eq < 1) { fail(`Bad --set value: "${raw}". Use "Treatment=amount" (or "Treatment=800-1200").`); process.exit(1); }
+      pricing.set[raw.slice(0, eq).trim()] = raw.slice(eq + 1).trim();
+    }
+  }
+  if (removals.length) pricing.remove = removals;
+  if (flags.clear === true) {
+    if (!JSON_OUT && !flags.yes) {
+      const proceed = await confirm("Remove every price from this profile?");
+      if (!proceed) { warn("Cancelled."); return; }
+    }
+    pricing.clear = true;
+  }
+
+  const res = await call("cli-profile-update", { id, profile_type: type, pricing });
+  if (JSON_OUT) return out(res);
+  const rows = res.pricing ?? [];
+  ok(`${res.name} — ${rows.length} price(s) on file`);
+  rows.forEach((r) => log(`  ${String(r.label).padEnd(34)} ${c.dim(`£${r.amount_to ? `${r.amount}–${r.amount_to}` : r.amount}`)}`));
+}
+
 async function cmdWhoami() {
   const res = await call("cli-auth", {});
   const cfg = loadConfig();
@@ -344,7 +502,7 @@ async function cmdClaimLink(id) {
   if (!id) { fail("Usage: setu practice claim-link <practice-id>"); process.exit(1); }
   const res = await call("cli-claim-link", {
     id,
-    profile_type: flags.dentist ? "dentist" : "practice",
+    profile_type: type === "dentist" || flags.dentist ? "dentist" : "practice",
     rotate: !!flags.rotate,
   });
   if (JSON_OUT) return out(res);
@@ -414,6 +572,9 @@ async function main() {
         case "import": return cmdPracticeImport(arg);
         case "claim-link": return cmdClaimLink(arg);
         case "delete": return cmdPracticeDelete(arg);
+        case "update": return cmdProfileUpdate("practice", arg);
+        case "images": return cmdProfileImages("practice", arg);
+        case "pricing": return cmdProfilePricing("practice", arg);
         default:
           fail(`Unknown command: practice ${sub ?? ""}`.trim());
           usage();
@@ -422,6 +583,10 @@ async function main() {
       }
     case "dentist":
       if (sub === "create") return cmdDentistCreate();
+      if (sub === "update") return cmdProfileUpdate("dentist", arg);
+      if (sub === "images") return cmdProfileImages("dentist", arg);
+      if (sub === "pricing") return cmdProfilePricing("dentist", arg);
+      if (sub === "delete") return cmdPracticeDelete(arg, "dentist");
       fail(`Unknown command: dentist ${sub ?? ""}`.trim());
       usage();
       process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-a/cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "private": false,
   "description": "Setu CLI — build, review and publish claimable practice and dentist profiles.",
   "type": "module",