@omniharmonic/openspace-cli 0.1.5 → 0.1.7

package/dist/{agents-md-PVK5NBFF.js → agents-md-A4JWPOMG.js}

@@ -1,9 +1,9 @@
 import { createRequire as __osCreateRequire } from "node:module"; const require = __osCreateRequire(import.meta.url);
 import {
   generateAgentsMd
-} from "./chunk-UQXJVMUV.js";
+} from "./chunk-KAJOS2YV.js";
 import "./chunk-26AZCID5.js";
 export {
   generateAgentsMd
 };
-//# sourceMappingURL=agents-md-PVK5NBFF.js.map
+//# sourceMappingURL=agents-md-A4JWPOMG.js.map

package/dist/bin.js

@@ -3,9 +3,9 @@ import { createRequire as __osCreateRequire } from "node:module"; const require
 import {
   processIo,
   run
-} from "./chunk-RG7S2MUH.js";
+} from "./chunk-ANGZMFLZ.js";
 import "./chunk-WE4QCL3R.js";
-import "./chunk-UQXJVMUV.js";
+import "./chunk-KAJOS2YV.js";
 import "./chunk-26AZCID5.js";
 
 // src/bin.ts

package/dist/{chunk-RG7S2MUH.js → chunk-ANGZMFLZ.js}

@@ -50,6 +50,7 @@ import {
   MediaMetaSchema,
   MediaPathSchema,
   NavItemSchema,
+  PLACEHOLDER_RE,
   PRESET_CATEGORIES,
   PageIdSchema,
   PageSchema,
@@ -92,17 +93,19 @@ import {
   parseColor,
   plainText,
   presetCatalog,
+  presetSampleStrings,
   presetSection,
   presetsIn,
   registerAll,
   renderPageHtml,
   resolve,
   responsive,
+  sampleMatches,
   starterRef,
   toHex,
   toJsonSchema,
   toMarkdown
-} from "./chunk-UQXJVMUV.js";
+} from "./chunk-KAJOS2YV.js";
 import {
   __commonJS,
   __require,
@@ -8546,7 +8549,7 @@ async function runCheck(root, options = {}) {
         rule: "gating",
         file,
         path: "access",
-        message: `Page "${page.title}" is ${kinds}: it is only published with Cloudflare hosting.`
+        message: `Page "${page.title}" is ${kinds}: until you switch on members and password pages (Studio \u2192 Finish setting up), visitors don't see it and the rest of the site publishes as usual.`
       });
   }
   const errors2 = findings.filter((f) => f.severity === "error").length;
@@ -12045,6 +12048,42 @@ var Ctx = class {
       this.primaryActions(page, section);
       this.copyLength(page, section);
       this.background(page, section);
+      this.sampleContent(page, section);
+      this.placeholders(page, section);
+    }
+  }
+  /** Unedited preset sample content: made-up people, quotes, prices and contact details. */
+  sampleContent(page, section) {
+    if (!section.preset) return;
+    const matches = sampleMatches(section, presetSampleStrings(section.preset));
+    const first = matches[0];
+    if (!first) return;
+    const examples = matches.flatMap((m) => m.found).slice(0, 2).map((s2) => `\u201C${s2.length > 48 ? `${s2.slice(0, 47)}\u2026` : s2}\u201D`).join(", ");
+    this.add({
+      rule: "sample-content",
+      severity: "warning",
+      page,
+      section: section.id,
+      block: first.blockId,
+      message: `This section still has sample content from its design (${examples}): people, quotes, prices or details that aren't about your site.`,
+      fix: "Edit it with your own words, people and numbers \u2014 or delete the section. Never publish made-up reviews or names."
+    });
+  }
+  /** Placeholder text left in: "[PLACEHOLDER]", "[Your name]", "Lorem ipsum". */
+  placeholders(page, section) {
+    for (const b of section.blocks) {
+      if (b.hidden) continue;
+      const m = PLACEHOLDER_RE.exec(blockText(b));
+      if (!m) continue;
+      this.add({
+        rule: "placeholder-text",
+        severity: "warning",
+        page,
+        section: section.id,
+        block: b.id,
+        message: `This block still has placeholder text (\u201C${m[0]}\u201D).`,
+        fix: "Edit it to say what you mean, or remove it before publishing."
+      });
     }
   }
   headings(page, sections) {
@@ -25029,6 +25068,8 @@ var getSite = defineTool({
         media: Object.keys(doc.media).length,
         capabilities: {
           ...ctx.store.capabilities,
+          // Same answer as list_sites: publishing needs both the store and this connection.
+          canPublish: ctx.grant.publish && ctx.store.capabilities.canPublish,
           grantPublish: ctx.grant.publish
         }
       }
@@ -25662,7 +25703,7 @@ var DEVICE_WIDTH = {
 var screenshot = defineTool({
   name: "screenshot",
   title: "Screenshot",
-  description: 'PNG screenshot of a draft page or one section at desktop (1440), tablet (834) or mobile (390) width \u2014 or "all" three \u2014 so you can see the design and iterate. Returns the preview URL as well. Needs a screenshot provider (Playwright locally).',
+  description: 'Screenshot of a draft page or one section at desktop (1440), tablet (834) or mobile (390) width \u2014 or "all" three \u2014 so you can see the design and iterate. Tall pages may come back as several images, top to bottom. Returns the preview URL as well. Needs a screenshot provider (Playwright locally, Cloudflare Browser Rendering on the Hub).',
   input: external_exports.object({
     site: siteArg,
     page: external_exports.string(),
@@ -25687,6 +25728,7 @@ var screenshot = defineTool({
     const devices = input.device === "all" ? ["desktop", "tablet", "mobile"] : [input.device ?? "desktop"];
     const images = [];
     const shots = [];
+    const notes = [];
     for (const device of devices) {
       const shot = await ctx.store.screenshot(siteId, {
         pageId: id,
@@ -25701,10 +25743,14 @@ var screenshot = defineTool({
         mimeType: shot.mimeType,
         caption: `${device} ${shot.width}px`
       });
+      for (const [i, part] of (shot.more ?? []).entries())
+        images.push({ ...part, caption: `${device} ${shot.width}px (part ${i + 2})` });
       shots.push({ device, width: shot.width, height: shot.height });
+      if (shot.note) notes.push(`${device}: ${shot.note}`);
     }
     return {
-      text: `Screenshot${shots.length > 1 ? "s" : ""} of ${page?.title ?? id}${input.section ? ` (section ${input.section})` : ""}: ${shots.map((s2) => `${s2.device} ${s2.width}\xD7${s2.height ?? "?"}`).join(", ")}.${url ? ` Preview: ${url}` : ""}`,
+      text: `Screenshot${shots.length > 1 ? "s" : ""} of ${page?.title ?? id}${input.section ? ` (section ${input.section})` : ""}: ${shots.map((s2) => `${s2.device} ${s2.width}\xD7${s2.height ?? "?"}`).join(", ")}.${url ? ` Preview: ${url}` : ""}${notes.length ? `
+${notes.join("\n")}` : ""}`,
       data: { url, shots },
       images
     };
@@ -26626,7 +26672,7 @@ var publish = defineTool({
     const siteId = await ctx.siteId(input.site);
     if (!ctx.grant.publish)
       throw new ToolError(
-        "This connection isn't allowed to publish. The owner can publish from Studio, or allow publishing for this connection.",
+        "This connection isn't allowed to publish. Publish from Studio, or ask the site owner to allow publishing for this connection in Studio \u2192 Settings \u2192 Connect your AI.",
         "forbidden"
       );
     if (!ctx.store.capabilities.canPublish)
@@ -28227,7 +28273,7 @@ async function renderAgentsMd(root, siteTitle) {
     } catch {
     }
   }
-  const { generateAgentsMd: generateAgentsMd2 } = await import("./agents-md-PVK5NBFF.js");
+  const { generateAgentsMd: generateAgentsMd2 } = await import("./agents-md-A4JWPOMG.js");
   return generateAgentsMd2(title ? { siteTitle: title } : {});
 }
 async function writeAgentsMd(root, siteTitle) {
@@ -28262,6 +28308,11 @@ function compareVersions(a, b) {
 
 // src/dev.ts
 var ASTRO_MIN_NODE = "22.23.4";
+function astroNodeProblem(nodeVersion) {
+  if (compareVersions(nodeVersion, ASTRO_MIN_NODE) >= 0) return null;
+  return `Astro needs Node ${ASTRO_MIN_NODE} or newer (Node 24 recommended), but this is Node ${nodeVersion}.
+Install Node 24 (for example with nvm: "nvm install 24 && nvm use 24").`;
+}
 function findAstroBin(cwd) {
   try {
     const req = createRequire(join5(cwd, "package.json"));
@@ -28276,11 +28327,9 @@ function findAstroBin(cwd) {
   }
 }
 async function runDev(io, args, spawner = (c, a, o) => spawn(c, a, { ...o, stdio: "inherit" }), findBin = findAstroBin) {
-  if (compareVersions(io.nodeVersion, ASTRO_MIN_NODE) < 0)
-    throw new CliError(
-      `Astro needs Node ${ASTRO_MIN_NODE} or newer, but this is Node ${io.nodeVersion}.
-Install a newer Node 22 (for example with nvm: "nvm install 22 && nvm use 22") and run "openspace dev" again.`
-    );
+  const tooOld = astroNodeProblem(io.nodeVersion);
+  if (tooOld) throw new CliError(`${tooOld}
+Then run "openspace dev" again.`);
   if (!existsSync(join5(io.cwd, "openspace.json")))
     throw new CliError('No openspace.json here. Run "openspace dev" from the root of your site.');
   const bin = findBin(io.cwd);
@@ -28554,7 +28603,7 @@ async function runGatedSync(io, opts = {}, deps = {}) {
   }
   if (config.deploy?.target !== "cloudflare")
     throw new CliError(
-      "Members-only and password pages need Cloudflare hosting (Studio \u2192 Settings \u2192 Hosting)."
+      "Members-only and password pages are switched on in Studio \u2192 Finish setting up (it moves the site to Cloudflare for you)."
     );
   const bucket = opts.bucket ?? gatedBucketName(root);
   if (!bucket)
@@ -29267,7 +29316,9 @@ function importSiteTool(opts) {
       exportFile: external_exports.string().optional().describe(
         "Path to a WordPress export (WXR XML): a WordPress site's full export, or Squarespace's blog export."
       ),
-      target: external_exports.enum(["github-pages", "cloudflare"]).optional().describe("cloudflare to sell products or gate pages"),
+      target: external_exports.enum(["github-pages"]).optional().describe(
+        "Always github-pages (the default): every import goes live on free GitHub Pages first. Shops, donations, member areas and password pages are switched on afterwards in Studio \u2192 Finish setting up."
+      ),
       confirm: external_exports.boolean().optional().describe("Must be true: the owner agreed to fetch the site and create the folder.")
     }),
     annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: false },
@@ -29448,6 +29499,30 @@ async function loadPlaywright(importer = defaultImporter) {
     error: "Playwright is not installed. Run `npm i -D playwright && npx playwright install chromium` in the site folder and restart `openspace mcp`."
   };
 }
+function prepareScript(sectionId) {
+  return `(async () => {
+  const imgs = Array.from(document.images);
+  for (const img of imgs) { img.loading = "eager"; img.decoding = "sync"; }
+  const step = Math.max(200, Math.floor(window.innerHeight * 0.8));
+  for (let y = 0; y < document.documentElement.scrollHeight; y += step) {
+    window.scrollTo(0, y);
+    await new Promise((r) => setTimeout(r, 30));
+  }
+  window.scrollTo(0, 0);
+  const done = Promise.all(Array.from(document.images).map((img) => img.complete ? null :
+    new Promise((r) => { img.addEventListener("load", r, { once: true }); img.addEventListener("error", r, { once: true }); })));
+  await Promise.race([done, new Promise((r) => setTimeout(r, 5000))]);
+  const id = ${JSON.stringify(sectionId ?? null)};
+  if (id) {
+    const target = document.querySelector('[data-os-id="' + id + '"]');
+    for (const el of Array.from(document.body.querySelectorAll("*"))) {
+      if (target && (el.contains(target) || target.contains(el))) continue;
+      const pos = getComputedStyle(el).position;
+      if (pos === "fixed" || pos === "sticky") el.style.setProperty("visibility", "hidden", "important");
+    }
+  }
+})()`;
+}
 function createScreenshotter(chromium) {
   let browser;
   const launch = async () => {
@@ -29481,6 +29556,7 @@ function createScreenshotter(chromium) {
         await page.goto(url, { waitUntil: "load", timeout: 3e4 });
         await page.waitForLoadState("networkidle", { timeout: 5e3 }).catch(() => void 0);
         await page.evaluate("document.fonts && document.fonts.ready").catch(() => void 0);
+        await page.evaluate(prepareScript(req.sectionId)).catch(() => void 0);
         let png;
         if (req.sectionId) {
           png = await page.locator(`[data-os-id="${req.sectionId}"]`).first().screenshot({ type: "png" });
@@ -29742,7 +29818,11 @@ async function scaffold(templateId, dir, tpl, opts) {
       search: true
     }
   };
-  if (opts.title) doc.site = { ...doc.site, title: opts.title };
+  if (opts.title) {
+    const from = doc.site.title.trim();
+    const footer = from && from !== opts.title ? rebrand(doc.site.footer, from, opts.title) : null;
+    doc.site = { ...doc.site, title: opts.title, ...footer ? { footer } : {} };
+  }
   await writeSiteDocument(dir, doc);
   await writeAgentsMd(dir, doc.site.title);
   return {
@@ -29754,6 +29834,32 @@ async function scaffold(templateId, dir, tpl, opts) {
     files: Object.keys(files).length
   };
 }
+var NOT_TEXT = /^(?:src|url|href|link|id|type|variant|icon|target|kind|style|preset)$/;
+function rebrand(value, from, to) {
+  let changed = false;
+  const walk5 = (v, key) => {
+    if (typeof v === "string") {
+      if (key && NOT_TEXT.test(key) || !v.includes(from)) return v;
+      changed = true;
+      return v.split(from).join(to);
+    }
+    if (Array.isArray(v)) return v.map((x) => walk5(x));
+    if (v && typeof v === "object")
+      return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, walk5(x, k)]));
+    return v;
+  };
+  const out = walk5(value);
+  return changed ? out : null;
+}
+
+// src/wow-first.ts
+var WOW_FIRST_MESSAGE = "New and imported sites always start on free GitHub Pages, so the first version goes live without any extra accounts. Shops, donations, member areas and password pages show a friendly \u201Copening soon\u201D note until you switch them on in Studio \u2192 Finish setting up (it moves the site to Cloudflare for you, with no downtime).";
+function assertGitHubPagesStart(target) {
+  if (target && target !== "github-pages")
+    throw new CliError(
+      `--target ${target} isn't available when creating a site. ${WOW_FIRST_MESSAGE}`
+    );
+}
 
 // src/import.ts
 function defaultFolder(url) {
@@ -29822,7 +29928,8 @@ async function loadRenderer() {
   };
 }
 async function runImportSite(io, url, dirArg, opts = {}) {
-  const target = opts.target ?? "github-pages";
+  assertGitHubPagesStart(opts.target);
+  const target = "github-pages";
   const dir = resolve5(io.cwd, dirArg ?? defaultFolder(url));
   if (!await isEmptyDir(dir))
     throw new CliError(`${dir} already exists and is not empty. Choose a new folder.`);
@@ -29978,6 +30085,9 @@ function createProgram(io, setExit, deps = {}) {
         io.out(formatReport(report, (code2, s2) => paint(color, code2, s2)));
       }
       if (!report.ok) setExit(1);
+      const tooOld = astroNodeProblem(io.nodeVersion);
+      if (tooOld && !opts.json) io.err(`Note: ${tooOld}
+The site won't build until you do.`);
     }
   );
   program.command("dev").description("Start the local preview (astro dev) in this site.").allowUnknownOption().argument("[astroArgs...]", "extra arguments passed to astro dev").action(async (args) => {
@@ -29997,11 +30107,14 @@ function createProgram(io, setExit, deps = {}) {
     for (const f of r.written) io.out(`  ${f}`);
     for (const f of r.removed) io.out(`  ${opts.dryRun ? "would remove" : "removed"} ${f}`);
   });
-  program.command("new").description("Create a new site from a template.").argument("<template>", "template id (for example: meadow)").argument("<dir>", "folder to create").option("--target <target>", "github-pages or cloudflare", "github-pages").option("--repo <owner/name>", "GitHub repository, used for the Pages address").option("--url <url>", "address the site is served from before a custom domain").option("--domain <hostname>", "custom domain").option("--title <title>", "site title").option("--hub <url>", "Hub address").option("--templates-dir <dir>", "folder holding template directories").action(
+  program.command("new").description("Create a new site from a template.").argument("<template>", "template id (for example: meadow)").argument("<dir>", "folder to create").option(
+    "--target <target>",
+    "always github-pages (Cloudflare is switched on later in Studio)",
+    "github-pages"
+  ).option("--repo <owner/name>", "GitHub repository, used for the Pages address").option("--url <url>", "address the site is served from before a custom domain").option("--domain <hostname>", "custom domain").option("--title <title>", "site title").option("--hub <url>", "Hub address").option("--templates-dir <dir>", "folder holding template directories").action(
     async (template, dir, opts) => {
-      if (opts.target !== "github-pages" && opts.target !== "cloudflare")
-        throw new CliError(`--target must be github-pages or cloudflare, not "${opts.target}".`);
-      const r = await runNew(io, template, dir, { ...opts, target: opts.target });
+      assertGitHubPagesStart(opts.target);
+      const r = await runNew(io, template, dir, { ...opts, target: "github-pages" });
       if (r.usedFallback)
         io.out(
           `Note: template "${template}" has no content of its own yet, so the Meadow sample site (${r.contentFrom}) was used instead.`
@@ -30014,6 +30127,9 @@ function createProgram(io, setExit, deps = {}) {
       io.out("  npm install");
       io.out("  npx openspace check");
       io.out("  npx openspace dev");
+      const tooOld = astroNodeProblem(io.nodeVersion);
+      if (tooOld) io.err(`Warning: ${tooOld}
+The site won't preview or build until you do.`);
       if (opts.url === void 0 && opts.repo === void 0 && !opts.domain)
         io.out("Set deploy.url in openspace.json to where the site will be published.");
     }
@@ -30044,13 +30160,12 @@ function createProgram(io, setExit, deps = {}) {
       );
     return c.option(
       "--target <target>",
-      "github-pages or cloudflare (use cloudflare to sell products)",
+      "always github-pages: shops and member areas are switched on later in Studio",
       "github-pages"
     ).option("--repo <owner/name>", "GitHub repository, used for the Pages address").option("--url <url>", "address the new site is served from before a custom domain").option("--domain <hostname>", "custom domain (set it when you move the domain)").option("--title <title>", "site title (default: the original site's title)").option("--hub <url>", "Hub address").option("--max-pages <n>", "most pages and items to read (default 400)", Number).option("--delay <ms>", "pause between requests to the site (default 300)", Number).option("--no-media", "don't download images and files (a quick structural preview)");
   };
   const runImportCommand = async (url, dir, opts, platform) => {
-    if (opts.target !== "github-pages" && opts.target !== "cloudflare")
-      throw new CliError(`--target must be github-pages or cloudflare, not "${opts.target}".`);
+    assertGitHubPagesStart(opts.target);
     let chosen = platform;
     if (opts.platform) {
       const p = parsePlatform(opts.platform);
@@ -30066,7 +30181,7 @@ function createProgram(io, setExit, deps = {}) {
     const { platform: _p, ...rest } = opts;
     const r = await runImportSite(io, url, dir, {
       ...rest,
-      target: opts.target,
+      target: "github-pages",
       platform: chosen,
       ...deps.fetch ? { fetch: deps.fetch } : {}
     });
@@ -30176,4 +30291,4 @@ export {
   createProgram,
   run
 };
-//# sourceMappingURL=chunk-RG7S2MUH.js.map
+//# sourceMappingURL=chunk-ANGZMFLZ.js.map