@series-a/cli 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to `@series-a/cli` (and the paired `@series-a/mcp` server).
 
+## Unreleased — claims review dashboard
+
+### Added
+- `setu claims` — review dashboard showing pending claim requests, counts by status and unclaimed profiles scored for readiness (with what's still missing)
+- `setu claims show|approve|decline <claim-id>` (`--reason`, `--yes`), plus `setu claims --status approved|rejected|all`
+- MCP tools `setu_claims_dashboard`, `setu_claims_list`, `setu_claim_detail` and `setu_claim_decide`
+
+## 1.3.0 — lists, full profiles and image uploads
+
+### Added
+- `practice list` and `dentist list` — browse seeded profiles, with `--limit`, `--search` and (for clinicians) `--practice`
+- `setu status <id> --full` and `setu status --dentist` — the complete enriched profile including photos, prices, services and attached clinicians
+- `setu <type> images --upload <file|url>` and `--upload-logo <file|url>` — upload photos straight into Setu storage with your CLI key, no third-party hosting needed
+- `dentist create` now honours `--photo`, `--gallery`, `--phone`, `--website`, `--booking` and `--bio`
+- MCP tool `setu_profile_upload_image`; `setu_profile_status` gained `full`, `list`, `limit`, `search` and `practice_id`; `setu_dentist_create` gained photo/gallery/contact fields
+
+## 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

package/README.md

@@ -48,6 +48,8 @@ are listed at the end so you can retry them.
 setu practice claim-link <practice-id>
 setu status                       # every seeded profile and its claim state
 setu status <practice-id>         # one profile plus its claim attempts
+setu status <profile-id> --full   # every field, photos, prices, services, clinicians
+setu status --dentist             # list clinicians instead of practices
 ```
 
 Send the claim link in outreach. The practice signs in, and is verified either
@@ -56,10 +58,31 @@ contact address on their Google listing. On success the profile transfers to
 them, pre-filled, and they continue through the normal onboarding and
 subscription flow.
 
+## Reviewing claims
+
+```bash
+setu claims                        # pending claims + unclaimed profiles by readiness
+setu claims --ready                # only profiles ready to promote
+setu claims --status all           # every claim, any status
+setu claims show <claim-id>        # claimant, method, attempts, target profile
+setu claims approve <claim-id>     # transfer the profile to the claimant
+setu claims decline <claim-id> --reason "Not the practice owner"
+```
+
+Approving a practice claim makes the claimant the owner, adds an owner
+membership and marks the practice's clinicians as claimed. A claim can only be
+approved once the claimant has signed in, so there's an account to transfer to.
+
 ## Clinicians
 
 ```bash
-setu dentist create --name "Dr Jane Roe" --practice <id> --profile-url https://…/team/jane
+setu dentist create --name "Dr Jane Roe" --practice <id> --profile-url https://…/team/jane \
+  --photo https://…/jane.jpg --gallery "https://…/a.jpg,https://…/b.jpg" \
+  --phone 02392000000 --website https://… --booking https://…/book
+
+setu practice list --limit 100 --search "smile"
+setu dentist  list --practice <practice-id>
+setu dentist  status <dentist-id> --full
 ```
 
 ## Flags
@@ -94,10 +117,26 @@ else is reported and skipped before any API call is made.
 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
@@ -110,6 +149,15 @@ setu practice images <practice-id> --logo https://.../logo.png
 setu dentist  images <dentist-id>  --logo https://.../headshot.jpg  # main photo
 ```
 
+Upload from your machine (or copy a remote image into Setu storage) instead of
+linking to someone else's server:
+
+```bash
+setu practice images <practice-id> --upload ./reception.jpg
+setu practice images <practice-id> --upload-logo ./logo.png
+setu dentist  images <dentist-id>  --upload-logo https://.../headshot.jpg
+```
+
 ## Prices and services
 
 ```bash

package/bin/setu.mjs

@@ -71,20 +71,35 @@ ${c.bold("Commands")}
       [--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]
+      [--upload <file|url>] [--upload-logo <file|url>]
   practice pricing <practice-id>         Manage treatment prices
       [--set "Implant=1200"] [--remove "Implant"] [--clear] [--list]
+  practice list                          List seeded practices
+      [--limit 50] [--search <name>]
   dentist create --name "Dr Jane Roe"    Seed one clinician
       [--practice <id>] [--profile-url <url>] [--town <town>]
+      [--photo <url>] [--gallery "url1,url2"] [--phone <n>]
+      [--website <url>] [--booking <url>] [--bio "..."]
+  dentist list                           List seeded clinicians
+      [--limit 50] [--search <name>] [--practice <id>]
   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
+  status [<profile-id>]                  List or inspect seeded profiles
+      [--dentist] [--full] [--limit 50] [--search <name>]
+  claims                                 Review dashboard: pending claims + ready profiles
+      [--status pending|approved|rejected|all] [--dentist] [--ready] [--limit 50]
+  claims show <claim-id>                 Full detail for one claim
+  claims approve <claim-id>              Hand the profile to the claimant
+  claims decline <claim-id>              Decline a claim [--reason "..."]
 
 ${c.bold("Global")}  --json  --yes  --verbose  --operator <name>  --version
 `);
@@ -134,9 +149,13 @@ async function cmdProfileUpdate(type, id) {
     // 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 });
+      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;
@@ -150,26 +169,77 @@ async function cmdProfileUpdate(type, id) {
     }
     return;
   }
-  if (!id) { fail(`Usage: setu ${type} update <id> --set field=value`); process.exit(1); }
+  if (!id) { fail(`Usage: setu ${type} update <id> [--set field=value] [--booking <url>] [--website <url>]`); process.exit(1); }
 
-  const pairs = asList(flags.set);
-  if (!pairs.length) { fail("Pass at least one --set field=value (or --fields to see what you can set)."); 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 });
+  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(", ")}`);
 }
 
+const MIME_BY_EXT = {
+  jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png",
+  webp: "image/webp", svg: "image/svg+xml", gif: "image/gif",
+};
+
+/** A local path becomes base64; a URL is fetched server-side. */
+function uploadPayload(src) {
+  const value = String(src);
+  if (/^https?:\/\//i.test(value)) return { source_url: value };
+  const ext = value.split(".").pop().toLowerCase();
+  return {
+    data: readFileSync(value).toString("base64"),
+    content_type: MIME_BY_EXT[ext] || "image/jpeg",
+    filename: value.split(/[\\/]/).pop(),
+  };
+}
+
+async function uploadImages(type, id, sources, attach) {
+  const urls = [];
+  for (const src of sources) {
+    const s = spinner(`Uploading ${src}`);
+    try {
+      const res = await call("cli-profile-upload", { id, profile_type: type, attach, ...uploadPayload(src) });
+      s.stop();
+      urls.push(res.url);
+      if (!JSON_OUT) ok(`${attach === "logo" ? "Logo" : "Photo"} uploaded — ${c.dim(res.url)}`);
+    } catch (e) { s.stop(); throw e; }
+  }
+  return urls;
+}
+
 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); }
+  if (!id) { fail(`Usage: setu ${type} images <id> [--add <url>] [--upload <file>] [--remove <url|index>] [--order "a,b"] [--logo <url>] [--upload-logo <file>]`); process.exit(1); }
+
+  const uploads = splitList(flags.upload);
+  const logoUploads = splitList(flags["upload-logo"]);
+  const uploaded = [];
+  if (uploads.length) uploaded.push(...await uploadImages(type, id, uploads, "gallery"));
+  if (logoUploads.length) await uploadImages(type, id, logoUploads.slice(0, 1), "logo");
 
   const images = {};
   if (splitList(flags.add).length) images.add = splitList(flags.add);
@@ -501,34 +571,170 @@ async function cmdDentistCreate() {
       town: typeof flags.town === "string" ? flags.town : undefined,
       postcode: typeof flags.postcode === "string" ? flags.postcode : undefined,
       email: typeof flags.email === "string" ? flags.email : undefined,
+      phone: typeof flags.phone === "string" ? flags.phone : undefined,
+      website_url: typeof flags.website === "string" ? flags.website : undefined,
+      booking_url: typeof flags.booking === "string" ? flags.booking : undefined,
+      bio: typeof flags.bio === "string" ? flags.bio : undefined,
+      photo_url: typeof flags.photo === "string" ? flags.photo : undefined,
+      gallery: splitList(flags.gallery),
     });
     s.stop();
     if (JSON_OUT) return out(res);
     ok("Clinician seeded as unclaimed");
-    table([["Dentist", res.dentist_id], ["AI enriched", res.enriched ? "yes" : "no"], ["Claim link", res.claim_url]]);
+    table([
+      ["Dentist", res.dentist_id],
+      ["AI enriched", res.enriched ? "yes" : "no"],
+      ["Photo", res.photo_url ?? "—"],
+      ["Claim link", res.claim_url],
+    ]);
   } catch (e) { s.stop(); throw e; }
 }
 
-async function cmdStatus(id) {
-  const res = await call("cli-profile-status", id ? { id } : { list: true, limit: flags.limit });
+function printProfileList(res) {
+  heading(`Seeded ${res.profile_type === "dentist" ? "clinicians" : "practices"} (${res.items.length})`);
+  for (const p of res.items) {
+    const state = p.claim_status === "claimed" ? c.green("claimed") : p.is_live ? c.green("live") : c.yellow(p.claim_status);
+    log(`  ${state.padEnd(20)} ${String(p.name).slice(0, 38).padEnd(40)} ${c.dim(p.id)}`);
+  }
+}
+
+async function cmdProfileList(type) {
+  const res = await call("cli-profile-status", {
+    list: true,
+    profile_type: type,
+    limit: flags.limit,
+    search: typeof flags.search === "string" ? flags.search : undefined,
+    practice_id: type === "dentist" && typeof flags.practice === "string" ? flags.practice : undefined,
+  });
+  if (JSON_OUT) return out(res);
+  printProfileList(res);
+}
+
+async function cmdStatus(id, type = flags.dentist ? "dentist" : "practice") {
+  const res = await call(
+    "cli-profile-status",
+    id
+      ? { id, profile_type: type, full: !!flags.full }
+      : { list: true, profile_type: type, limit: flags.limit, search: typeof flags.search === "string" ? flags.search : undefined },
+  );
   if (JSON_OUT) return out(res);
-  if (res.items) {
-    heading(`Seeded profiles (${res.items.length})`);
-    for (const p of res.items) {
-      const state = p.claim_status === "claimed" ? c.green("claimed") : p.is_live ? c.green("live") : c.yellow(p.claim_status);
-      log(`  ${state.padEnd(20)} ${String(p.name).slice(0, 38).padEnd(40)} ${c.dim(p.id)}`);
+  if (res.items) return printProfileList(res);
+
+  const p = res.profile ?? res.practice;
+  heading(p.name);
+  table([
+    ["Type", res.profile_type],
+    ["Status", p.claim_status],
+    ["Live", p.is_live ? "yes" : "no"],
+    ["Source", `${p.source} (${p.created_by_operator ?? "—"})`],
+    ["Claim link", p.claim_url],
+  ]);
+
+  if (flags.full) {
+    const gallery = res.gallery ?? [];
+    heading(`Photos (${gallery.length})`);
+    gallery.forEach((url, i) => log(`  ${String(i).padEnd(3)} ${c.dim(url)}`));
+    log(`  ${c.dim(res.profile_type === "dentist" ? "main photo" : "logo")}: ${res.logo ?? c.dim("none")}`);
+
+    const pricing = res.pricing ?? [];
+    heading(`Prices (${pricing.length})`);
+    for (const row of pricing) {
+      const amount = row.amount_to ? `${row.amount}–${row.amount_to}` : row.amount ?? "—";
+      log(`  ${String(row.label).slice(0, 38).padEnd(40)} ${amount}`);
+    }
+
+    if (res.dentists) {
+      heading(`Clinicians (${res.dentists.length})`);
+      for (const d of res.dentists) log(`  ${String(d.name).slice(0, 38).padEnd(40)} ${c.dim(d.id)}`);
     }
+  }
+
+  heading(`Claims (${res.claims.length})`);
+  for (const cl of res.claims) log(`  ${cl.status.padEnd(10)} ${cl.claimant_email} ${c.dim(cl.method)}`);
+}
+
+function printClaimRow(cl) {
+  const who = String(cl.claimant_email ?? "—").slice(0, 30).padEnd(32);
+  const name = String(cl.profile?.name ?? cl.profile_type ?? "—").slice(0, 26).padEnd(28);
+  const flag = cl.awaiting_signin ? c.yellow(" (not signed in)") : "";
+  log(`  ${String(cl.status).padEnd(9)} ${who} ${name} ${c.dim(cl.method ?? "")}${flag}`);
+  log(`  ${c.dim(cl.id)}`);
+}
+
+async function cmdClaims(sub, arg) {
+  if (sub === "show") {
+    if (!arg) throw new Error("Usage: setu claims show <claim-id>");
+    const res = await call("cli-claims", { action: "detail", claim_id: arg });
+    if (JSON_OUT) return out(res);
+    heading(`Claim ${res.claim.id}`);
+    table([
+      ["Status", res.claim.status],
+      ["Claimant", res.claim.claimant_email],
+      ["Method", res.claim.method],
+      ["Attempts", res.claim.attempts],
+      ["Signed in", res.claim.claimant_user_id ? "yes" : "no"],
+      ["Profile", res.profile ? `${res.profile.name} (${res.claim.profile_type})` : "—"],
+      ["Readiness", res.profile ? `${res.profile.score}%` : "—"],
+      ["Missing", res.profile?.missing?.join(", ")],
+      ["Claim link", res.profile?.claim_url],
+    ]);
+    return;
+  }
+
+  if (sub === "approve" || sub === "decline" || sub === "reject") {
+    if (!arg) throw new Error(`Usage: setu claims ${sub} <claim-id>`);
+    if (!flags.yes && !JSON_OUT) {
+      const go = await confirm(`${sub === "approve" ? "Approve" : "Decline"} claim ${arg}?`);
+      if (!go) return warn("Cancelled.");
+    }
+    const res = await call("cli-claims", {
+      action: sub === "approve" ? "approve" : "decline",
+      claim_id: arg,
+      reason: typeof flags.reason === "string" ? flags.reason : undefined,
+    });
+    if (JSON_OUT) return out(res);
+    return ok(`Claim ${res.status} — ${res.claim_id}`);
+  }
+
+  if (sub && sub !== "list") throw new Error(`Unknown command: claims ${sub}`);
+
+  const status = typeof flags.status === "string" ? flags.status : "pending";
+  const profileType = flags.dentist ? "dentist" : undefined;
+  if (sub === "list" || (typeof flags.status === "string" && flags.status !== "pending")) {
+    const res = await call("cli-claims", { action: "list", status, profile_type: profileType, limit: flags.limit });
+    if (JSON_OUT) return out(res);
+    heading(`Claims — ${status} (${res.claims.length})`);
+    res.claims.forEach(printClaimRow);
+    if (!res.claims.length) log(c.dim("  none"));
     return;
   }
-  heading(res.practice.name);
+
+  const res = await call("cli-claims", {
+    action: "dashboard",
+    profile_type: profileType,
+    ready_only: !!flags.ready,
+    limit: flags.limit,
+  });
+  if (JSON_OUT) return out(res);
+
+  heading("Claims");
   table([
-    ["Status", res.practice.claim_status],
-    ["Live", res.practice.is_live ? "yes" : "no"],
-    ["Source", `${res.practice.source} (${res.practice.created_by_operator ?? "—"})`],
-    ["Claim link", res.practice.claim_url],
+    ["Pending", res.counts.pending],
+    ["Approved", res.counts.approved],
+    ["Rejected", res.counts.rejected],
   ]);
-  heading(`Claims (${res.claims.length})`);
-  for (const cl of res.claims) log(`  ${cl.status.padEnd(10)} ${cl.claimant_email} ${c.dim(cl.method)}`);
+
+  heading(`Pending review (${res.pending_claims.length})`);
+  res.pending_claims.forEach(printClaimRow);
+  if (!res.pending_claims.length) log(c.dim("  nothing waiting"));
+
+  heading(`Unclaimed profiles — ${res.unclaimed.ready}/${res.unclaimed.total} ready, ${res.unclaimed.not_live} ready but offline`);
+  for (const u of res.unclaimed.items) {
+    const badge = u.ready ? c.green("ready") : c.yellow("gaps ");
+    log(`  ${badge} ${String(u.readiness_score + "%").padStart(4)} ${String(u.name).slice(0, 30).padEnd(32)} ${c.dim(u.profile_type)}${u.is_live ? "" : c.dim(" offline")}`);
+    if (u.missing.length) log(`         ${c.dim("missing: " + u.missing.join(", "))}`);
+  }
+  if (!res.unclaimed.items.length) log(c.dim("  none"));
 }
 
 async function main() {
@@ -544,6 +750,7 @@ async function main() {
     case "logout": return cmdLogout();
     case "whoami": return cmdWhoami();
     case "status": return cmdStatus(sub);
+    case "claims": return cmdClaims(sub, arg);
     case "practice":
       switch (sub) {
         case "create": return cmdPracticeCreate();
@@ -555,6 +762,7 @@ async function main() {
         case "update": return cmdProfileUpdate("practice", arg);
         case "images": return cmdProfileImages("practice", arg);
         case "pricing": return cmdProfilePricing("practice", arg);
+        case "list": return cmdProfileList("practice");
         default:
           fail(`Unknown command: practice ${sub ?? ""}`.trim());
           usage();
@@ -563,6 +771,8 @@ async function main() {
       }
     case "dentist":
       if (sub === "create") return cmdDentistCreate();
+      if (sub === "list") return cmdProfileList("dentist");
+      if (sub === "status") return cmdStatus(arg, "dentist");
       if (sub === "update") return cmdProfileUpdate("dentist", arg);
       if (sub === "images") return cmdProfileImages("dentist", arg);
       if (sub === "pricing") return cmdProfilePricing("dentist", arg);

package/package.json

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