@cmo-so/cli 0.7.6 → 0.7.7

package/dist/cmo.mjs

@@ -8145,9 +8145,9 @@ function domainApi(api2, domain) {
     /** The last time posts delivered by API pull were found in the website's sitemap (gives them their address). */
     sitemapMatch: () => api2.request(`${base}/rewrites/sitemap-match`),
     /** Read the sitemap (found on its own when blank) and match API-pull posts to their live address. */
-    runSitemapMatch: (sitemapUrl) => post(
+    runSitemapMatch: (sitemapUrl2) => post(
       `${base}/rewrites/sitemap-match`,
-      sitemapUrl ? { sitemap_url: sitemapUrl } : {}
+      sitemapUrl2 ? { sitemap_url: sitemapUrl2 } : {}
     ),
     rewritePolicy: () => api2.request(`${base}/rewrite-policy`),
     setRewritePolicy: (p) => put(`${base}/rewrite-policy`, p),
@@ -8284,6 +8284,75 @@ function createSession({ oauth: oauth2, store, skewMs = 6e4, now = Date.now, onS
   };
 }
 
+// ../../packages/api-client/src/sitemaps.ts
+var SITEMAPS_MAX = 20;
+var SITEMAP_LABEL_MAX = 80;
+var SITEMAP_OWNERS = ["own", "competitor", "other"];
+var SITEMAP_USES = {
+  own: ["post_ideas", "channel_ideas", "internal_links", "post_matching"],
+  competitor: ["post_ideas", "channel_ideas"],
+  other: ["post_ideas", "channel_ideas"]
+};
+function sitemapUrl(input) {
+  let v = input.trim();
+  if (!v || /^[a-z][a-z0-9+.-]*:(?!\/\/|\d)/i.test(v)) return null;
+  if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(v)) v = `https://${v}`;
+  let u;
+  try {
+    u = new URL(v);
+  } catch {
+    return null;
+  }
+  if (u.protocol !== "http:" && u.protocol !== "https:" || u.username || u.password) return null;
+  if (!u.hostname.includes(".") || /\s/.test(v)) return null;
+  u.protocol = "https:";
+  return u.toString();
+}
+function sitemapUses(owner, uses) {
+  const allowed2 = SITEMAP_USES[owner];
+  const kept = allowed2.filter((u) => uses?.includes(u));
+  return kept.length ? kept : [...allowed2];
+}
+function onWebsite(url, domain) {
+  let host;
+  try {
+    host = new URL(url).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  const d = domain.trim().toLowerCase().replace(/^https?:\/\//, "").replace(/\/.*$/, "").replace(/^www\./, "");
+  return Boolean(d) && (host === d || host.endsWith(`.${d}`));
+}
+function cleanSitemap(entry, domain) {
+  const url = sitemapUrl(entry.url ?? "");
+  if (!url) return "The sitemap must be a web address starting with http:// or https://.";
+  let owner = SITEMAP_OWNERS.includes(entry.owner) ? entry.owner : "other";
+  if (owner === "own" && domain && !onWebsite(url, domain)) owner = "other";
+  const label = (entry.label ?? "").trim().slice(0, SITEMAP_LABEL_MAX);
+  const out = { ...entry, url, owner, label: label || null, uses: sitemapUses(owner, entry.uses) };
+  if (!out.id) delete out.id;
+  return out;
+}
+function checkSitemaps(list2) {
+  if (list2.length > SITEMAPS_MAX) return `Up to ${SITEMAPS_MAX} sitemaps. Remove one first.`;
+  const seen = /* @__PURE__ */ new Set();
+  for (const s of list2) {
+    const k = s.url.trim().toLowerCase();
+    if (seen.has(k)) return `${s.url} is already in the list.`;
+    seen.add(k);
+  }
+  return null;
+}
+function sitemapCheckLine(check) {
+  if (!check || check.status === "unchecked") return "Checked when you save";
+  if (check.status === "error") return check.error?.trim() || "Couldn't read this sitemap.";
+  const n = check.url_count;
+  const found = n == null ? "Read" : `Found ${n.toLocaleString("en-GB")} ${n === 1 ? "page" : "pages"}`;
+  const at = check.checked_at ? new Date(check.checked_at) : null;
+  const when = at && !Number.isNaN(at.getTime()) ? at.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" }) : null;
+  return when ? `${found} \xB7 checked ${when}` : found;
+}
+
 // ../../packages/domain/src/copy/maggie.ts
 var q = (s) => `\u201C${String(s ?? "").slice(0, 120)}\u201D`;
 var named = (title, id) => {
@@ -8371,6 +8440,22 @@ var confirmCopy = {
     en: (a) => `Remove the competitor ${q(a.name)}.`,
     "zh-Hant": (a) => `\u522A\u9664\u7AF6\u722D\u5C0D\u624B ${q(a.name)}\u3002`
   },
+  sitemap_upsert: {
+    en: (a) => {
+      const whose = { own: "your site's ", competitor: "a competitor's ", other: "another site's " }[a.owner];
+      const label = a.label ? ` (${q(a.label)})` : "";
+      return a.url ? `Save ${whose ?? "the "}sitemap ${a.url}${label}.` : `Change the sitemap${label}: ${keys(a).filter((k) => k !== "id").join(", ")}.`;
+    },
+    "zh-Hant": (a) => {
+      const whose = { own: "\u81EA\u5DF1\u7DB2\u7AD9\u7684", competitor: "\u7AF6\u722D\u5C0D\u624B\u7684", other: "\u5176\u4ED6\u7DB2\u7AD9\u7684" }[a.owner];
+      const label = a.label ? `\uFF08${q(a.label)}\uFF09` : "";
+      return a.url ? `\u5132\u5B58${whose ?? ""} sitemap ${a.url}${label}\u3002` : `\u4FEE\u6539 sitemap${label}\uFF1A${keys(a).filter((k) => k !== "id").join("\u3001")}\u3002`;
+    }
+  },
+  sitemap_remove: {
+    en: (a) => a.url ?? a.id ? `Remove the sitemap ${a.url ?? a.id}.` : "Remove a sitemap.",
+    "zh-Hant": (a) => a.url ?? a.id ? `\u522A\u9664 sitemap ${a.url ?? a.id}\u3002` : "\u522A\u9664\u4E00\u500B sitemap\u3002"
+  },
   brand_research_update: {
     en: (a) => `Update your market notes: ${keys(a).join(", ") || "nothing"}.`,
     "zh-Hant": (a) => `\u66F4\u65B0\u5E02\u5834\u8CC7\u6599\uFF1A${keys(a).join("\u3001") || "\u6C92\u6709"}\u3002`
@@ -9823,6 +9908,85 @@ var brandTools = [
       return { found: out.found, suggestions: out.items.map(({ id, name, website }) => ({ id, name, website })) };
     }
   }),
+  tool({
+    name: "sitemap_list",
+    description: "The sitemaps saved in the business profile: the website's own, competitors' and other sites' (industry sites, partners), each with what it is used for (post_ideas = blog post ideas, channel_ideas = social post ideas, internal_links and post_matching = own sitemaps only) and its last check (pages found or the error). Max 20.",
+    parameters: none,
+    group: "brand",
+    need: { resource: "overview", level: "read" },
+    risk: "R0",
+    run: async (ctx) => {
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      return { max: SITEMAPS_MAX, sitemaps: list2.map(sitemapResult) };
+    }
+  }),
+  tool({
+    name: "sitemap_upsert",
+    description: "Add a sitemap to the business profile, or change one (found by id from sitemap_list, else by url). owner: own (the website's own; its host must be the website or a subdomain, otherwise it is saved as other), competitor, or other. uses: own may have post_ideas, channel_ideas, internal_links, post_matching; competitor/other only post_ideas, channel_ideas; leave out for all allowed. A new sitemap needs url and owner. Only sitemap addresses the user gives or confirms (never guess one). Saving checks the sitemap; an unreachable one is still saved with the error. Max 20.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "The sitemap to change (from sitemap_list)" },
+        url: { type: "string", description: "The sitemap's http(s) address; with id, its new address" },
+        owner: { type: "string", enum: ["own", "competitor", "other"] },
+        label: { type: "string", description: "A short name, up to 80 characters" },
+        uses: {
+          type: "array",
+          items: { type: "string", enum: ["post_ideas", "channel_ideas", "internal_links", "post_matching"] }
+        }
+      }
+    },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, args) => {
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      const i = findSitemap(list2, args.id, args.id ? void 0 : args.url);
+      if (args.id && i < 0) throw new Error(`No sitemap with id ${args.id}. Use sitemap_list.`);
+      const old = i >= 0 ? list2[i] : void 0;
+      if (!old && (!args.url || !args.owner)) throw new Error("A new sitemap needs url and owner.");
+      const owner = args.owner ?? old?.owner ?? "other";
+      const entry = cleanSitemap(
+        {
+          ...old,
+          url: args.url ?? old?.url ?? "",
+          owner,
+          label: args.label ?? old?.label ?? null,
+          // A new owner without uses gets that owner's defaults.
+          uses: args.uses ?? (args.owner && args.owner !== old?.owner ? [] : old?.uses ?? [])
+        },
+        ctx.domain ?? void 0
+      );
+      if (typeof entry === "string") throw new Error(entry);
+      if (old && sitemapUrl(old.url) !== entry.url) delete entry.check;
+      const next = old ? list2.map((x, n) => n === i ? entry : x) : [...list2, entry];
+      const problem = checkSitemaps(next);
+      if (problem) throw new Error(problem);
+      const saved = (await ws(ctx).updateBrand({ sitemaps: next })).sitemaps ?? next;
+      const mine = saved[findSitemap(saved, void 0, entry.url)];
+      return {
+        saved: mine ? sitemapResult(mine) : sitemapResult(entry),
+        ...(mine?.owner ?? entry.owner) !== owner ? { note: "Not on this website, so it was saved as another site's sitemap (owner other)." } : {},
+        sitemaps: saved.length
+      };
+    }
+  }),
+  tool({
+    name: "sitemap_remove",
+    description: "Remove a sitemap from the business profile (by id from sitemap_list, or by url). Maggie stops reading it; ideas already found stay.",
+    parameters: { type: "object", properties: { id: { type: "string" }, url: { type: "string" } } },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, { id, url }) => {
+      if (!id && !url) throw new Error("Say which sitemap: id or url.");
+      const list2 = (await ws(ctx).brand()).sitemaps ?? [];
+      const i = findSitemap(list2, id, url);
+      if (i < 0) throw new Error(`No sitemap ${id ?? url} was found. Use sitemap_list.`);
+      const saved = (await ws(ctx).updateBrand({ sitemaps: list2.filter((_, n) => n !== i) })).sitemaps ?? [];
+      return { removed: list2[i]?.url, sitemaps: saved.map((s) => s.url) };
+    }
+  }),
   tool({
     name: "brand_research_update",
     description: "Change the profile's market notes: market_research (text), additional_information (anything else Maggie should know) or the SWOT list (each {name: Strengths|Weaknesses|Opportunities|Threats, description}). A list replaces the whole list.",
@@ -9958,6 +10122,22 @@ function brandGaps(b) {
   check("industries", b.industries, "the industry, for examples and wording");
   return { complete: gaps.length === 0, gaps };
 }
+function findSitemap(list2, id, url) {
+  if (id) return list2.findIndex((s) => s.id === id);
+  const u = url ? (sitemapUrl(url) ?? url).toLowerCase() : "";
+  return u ? list2.findIndex((s) => (sitemapUrl(s.url) ?? s.url).toLowerCase() === u) : -1;
+}
+function sitemapResult(s) {
+  return {
+    id: s.id ?? null,
+    url: s.url,
+    owner: s.owner,
+    label: s.label ?? null,
+    uses: s.uses,
+    check: s.check?.status ?? "unchecked",
+    status: sitemapCheckLine(s.check)
+  };
+}
 
 // ../../packages/tools/src/feedback.ts
 var account = { resource: "account", level: "read" };
@@ -15711,7 +15891,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.7.6",
+  version: "0.7.7",
   description: "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
   type: "module",
   license: "MIT",
@@ -25943,7 +26123,9 @@ var OPEN_WORLD = /* @__PURE__ */ new Set([
   "seo_audit_run",
   "ai_visibility_prompt_check",
   "idea_add",
-  "competitor_suggestions_find"
+  "competitor_suggestions_find",
+  // Saving makes CMO.so fetch the sitemap from its website.
+  "sitemap_upsert"
 ]);
 var OVERWRITES = /* @__PURE__ */ new Set([
   "ai_visibility_keywords_set",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/cli",
-	"version": "0.7.6",
+	"version": "0.7.7",
 	"description": "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
 	"type": "module",
 	"license": "MIT",