@greatstore/cli 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to `@greatstore/cli` are recorded here. The format
 follows [Keep a Changelog](https://keepachangelog.com/).
 
+## 0.1.5 — 2026-09-12
+
+### Fixed
+- `gs apps push` says when a component's source changed but its bundle did
+  not — "did you forget to build?" — instead of reporting a successful push
+  of code that was never built.
+- A rebuilt bundle is now pushed even when the source is untouched. Such a
+  change was reported as "unchanged" and never uploaded.
+
+## 0.1.4 — 2026-09-12
+
+### Added
+- Edit one theme field at a time: `gs configure set --theme.fontFamily Manrope
+  --theme.radius sharp`. Theme writes merge into the stored theme, so a
+  one-field change no longer means retyping the whole object (and no longer
+  drops the keys you left out). `--replace` writes a theme outright.
+- `gs configure set --help` prints every field it accepts with its type and
+  legal values, and a mistyped field name or value is now rejected with the
+  valid list before anything is sent.
+
+### Changed
+- Rejected configuration writes say what was wrong with them — the field and
+  the values it accepts — instead of "Request rejected."
+- Commands no longer wait on a version check every run, which takes about half
+  a second off each one.
+
 ## 0.1.3 — 2026-09-12
 
 ### Changed

package/dist/cli.js

@@ -442,7 +442,7 @@ async function sendOnce(url, options, accessToken) {
   } catch {
   }
   const identifier = parsed.code ?? parsed.error;
-  const message = buildErrorMessage(res.status, identifier, parsed.detail);
+  const message = options.validationDetail && res.status === 400 && parsed.error ? parsed.error : buildErrorMessage(res.status, identifier, parsed.detail);
   throw new HttpError(res.status, message, parsed.code ?? parsed.error);
 }
 var KNOWN_ERROR_MESSAGES = {
@@ -711,6 +711,164 @@ function realPath(p) {
   }
 }
 
+// src/commands/configure/theme-fields.ts
+var THEME_FIELDS = {
+  mode: {
+    kind: "string",
+    values: ["auto", "light", "dark", "custom"],
+    help: "Color scheme. `auto` follows the shopper's system preference.",
+    brandVisible: true
+  },
+  radius: {
+    kind: "string",
+    values: ["sharp", "default", "rounded"],
+    help: "Corner rounding preset applied to every surface.",
+    brandVisible: true
+  },
+  panelPosition: {
+    kind: "string",
+    values: ["left", "right", "middle"],
+    help: "Where the chat panel sits on desktop.",
+    brandVisible: true
+  },
+  fontFamily: {
+    kind: "string",
+    help: "Primary font family name.",
+    brandVisible: true
+  },
+  secondaryFontFamily: {
+    kind: "string",
+    help: "Font family for the assistant's chat bubbles.",
+    brandVisible: true
+  },
+  mobileBottomBar: {
+    kind: "boolean",
+    help: "Show the compact bottom bar on mobile.",
+    brandVisible: true
+  },
+  zIndex: {
+    kind: "integer",
+    help: "Stacking order of the chat panel on the host page."
+  },
+  brandColor: { kind: "color", help: "Accent color.", brandVisible: true },
+  surfaceColor: { kind: "color", help: "Background color.", brandVisible: true },
+  textColor: { kind: "color", help: "Text color.", brandVisible: true },
+  surface: { kind: "color", help: "Panel background." },
+  surfaceSecondary: { kind: "color", help: "Secondary background." },
+  surfaceAccent: { kind: "color", help: "Accented background." },
+  surfaceHover: { kind: "color", help: "Hovered background." },
+  foreground: { kind: "color", help: "Body text." },
+  foregroundSecondary: { kind: "color", help: "Secondary text." },
+  foregroundMuted: { kind: "color", help: "Muted text." },
+  foregroundAccent: { kind: "color", help: "Accented text." },
+  border: { kind: "color", help: "Border color." },
+  borderFocus: { kind: "color", help: "Focus-ring color." },
+  primary: { kind: "color", help: "Primary button background." },
+  primaryForeground: { kind: "color", help: "Primary button text." },
+  primaryHover: { kind: "color", help: "Primary button hover." },
+  primaryMuted: { kind: "color", help: "Muted primary background." },
+  primaryMutedForeground: { kind: "color", help: "Muted primary text." },
+  primaryTint: { kind: "color", help: "Primary tint wash." },
+  link: { kind: "color", help: "Link color." }
+};
+function suggestThemeFields(input) {
+  const target = input.toLowerCase();
+  return Object.keys(THEME_FIELDS).map((name) => {
+    const lower = name.toLowerCase();
+    return {
+      name,
+      distance: editDistance(target, lower),
+      prefix: commonPrefixLength(target, lower)
+    };
+  }).filter(
+    ({ name, distance, prefix }) => distance <= Math.max(2, name.length / 3) || prefix >= 4
+  ).sort((a, b) => b.prefix - a.prefix || a.distance - b.distance).slice(0, 3).map(({ name }) => name);
+}
+function commonPrefixLength(a, b) {
+  let i = 0;
+  while (i < a.length && i < b.length && a[i] === b[i]) i++;
+  return i;
+}
+function editDistance(a, b) {
+  let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    const row = [i];
+    for (let j = 1; j <= b.length; j++) {
+      row[j] = Math.min(
+        (prev[j] ?? 0) + 1,
+        (row[j - 1] ?? 0) + 1,
+        (prev[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+    }
+    prev = row;
+  }
+  return prev[b.length] ?? 0;
+}
+
+// src/commands/configure/help.ts
+var CONFIGURE_HELP = `gs configure \u2014 view and edit a store's configuration.
+
+Usage:
+  gs configure                          Show the current configuration.
+  gs configure set --<field> <value>    Save one or more fields.
+  gs configure upload <kind> <file>     Upload icon / logoLight / logoDark.
+  gs configure clear <kind>             Remove an uploaded asset.
+
+Run \`gs configure set --help\` for the full field list.
+
+Flags:
+  --store <slug>   Which store to act on (default: nearest .gsrc).
+  --json           Machine-readable output.
+`;
+function themeFieldLines() {
+  const rows = Object.entries(THEME_FIELDS).map(([name, field]) => {
+    const type = field.values ? field.values.join(" | ") : field.kind === "color" ? "<css color>" : field.kind === "boolean" ? "true | false" : field.kind === "integer" ? "<integer>" : "<name>";
+    return { flag: `  --theme.${name} ${type}`, help: field.help };
+  });
+  const width = Math.max(...rows.map((r) => r.flag.length)) + 2;
+  return rows.map((r) => `${r.flag.padEnd(width)}${r.help}`).join("\n");
+}
+function brandVisibleNames() {
+  return Object.entries(THEME_FIELDS).filter(([, field]) => field.brandVisible).map(([name]) => name).join(", ");
+}
+function configureSetHelp() {
+  return `gs configure set \u2014 save configuration fields.
+
+Only the fields you pass are written; everything else is left alone. Pass an
+empty value to clear a field (e.g. --displayName "").
+
+Store fields:
+  --displayName <text>        Store name shown to shoppers.
+  --assistantName <text>      What the assistant calls itself.
+  --storeLink <url>           Where "visit the store" points.
+  --extraOrigins <a,b,c>      Extra origins allowed to embed the widget.
+  --cspScriptHosts <a,b,c>    Extra script hosts to allow.
+  --cspConnectHosts <a,b,c>   Extra connect hosts to allow.
+
+Theme fields (merge into the stored theme):
+${themeFieldLines()}
+
+Whole-object theme writes:
+  --theme '<json>'      Merge this JSON object into the stored theme.
+  --themeFile <path>    Same, read from a file.
+  --replace             Replace the theme outright instead of merging.
+  --theme ""            Clear the theme entirely.
+
+These are shopper-visible, so confirm them with the merchant before writing:
+  ${brandVisibleNames()}
+
+Examples:
+  gs configure set --theme.fontFamily Manrope --theme.radius sharp
+  gs configure set --theme.brandColor "#1e1d66"
+  gs configure set --theme '{"mode":"dark"}' --replace
+`;
+}
+function configureHelp(sub) {
+  if (sub === void 0 || sub === "show") return CONFIGURE_HELP;
+  if (sub === "set") return configureSetHelp();
+  return void 0;
+}
+
 // src/commands/apps/init.ts
 import * as fs4 from "fs";
 import * as path5 from "path";
@@ -747,7 +905,7 @@ function applyTemplate(content, vars) {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.1.3" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.1.5" : "0.0.0-dev";
 
 // src/commands/apps/init.ts
 var NAME_REGEX = /^[a-z][a-z0-9_]*$/;
@@ -1686,7 +1844,8 @@ function computeComponentHashes(componentDir) {
   }
   return {
     manifestHash,
-    sourceHash: hashFile(path9.join(componentDir, "component.tsx"))
+    sourceHash: hashFile(path9.join(componentDir, "component.tsx")),
+    bundleHash: hashFile(path9.join(componentDir, "bundle.js"))
   };
 }
 function readSyncState(componentDir) {
@@ -1698,7 +1857,8 @@ function readSyncState(componentDir) {
       return {
         version: parsed.version,
         manifestHash: parsed.manifestHash,
-        sourceHash: parsed.sourceHash
+        sourceHash: parsed.sourceHash,
+        ...typeof parsed.bundleHash === "string" ? { bundleHash: parsed.bundleHash } : {}
       };
     }
     return null;
@@ -1853,13 +2013,15 @@ async function pullOne(opts) {
   writeSyncState(componentDir, {
     version: data.version,
     manifestHash: hashString(manifestText),
-    sourceHash
+    sourceHash,
+    bundleHash: hashString(data.bundle)
   });
   const onDisk = computeComponentHashes(componentDir);
   writeSyncState(componentDir, {
     version: data.version,
     manifestHash: onDisk.manifestHash,
-    sourceHash: onDisk.sourceHash ?? ""
+    sourceHash: onDisk.sourceHash ?? "",
+    bundleHash: onDisk.bundleHash ?? ""
   });
   return { name, status: "pulled", version: data.version, wrote };
 }
@@ -2004,10 +2166,13 @@ ${OUTCOME_INDENT}`)
     };
   }
   const manifestText = fs9.readFileSync(manifestPath, "utf8");
+  const before = computeComponentHashes(componentDir);
+  const sync = readSyncState(componentDir);
+  const staleBundle = opts.bundlePath === void 0 && sync?.bundleHash !== void 0 && sync.sourceHash !== (before.sourceHash ?? "") && sync.bundleHash === (before.bundleHash ?? "");
   if (!force) {
-    const hashes2 = computeComponentHashes(componentDir);
-    const sync = readSyncState(componentDir);
-    const unchanged = sync !== null && sync.manifestHash === hashes2.manifestHash && sync.sourceHash === (hashes2.sourceHash ?? "");
+    const unchanged = sync !== null && sync.manifestHash === before.manifestHash && sync.sourceHash === (before.sourceHash ?? "") && // An older sync file has no bundle hash; treat that as "unknown" and
+    // push, rather than assume a bundle we never recorded is current.
+    sync.bundleHash !== void 0 && sync.bundleHash === (before.bundleHash ?? "");
     if (unchanged) {
       return { name, status: "unchanged" };
     }
@@ -2047,13 +2212,15 @@ ${OUTCOME_INDENT}`)
   writeSyncState(componentDir, {
     version: data.version,
     manifestHash: hashes.manifestHash,
-    sourceHash: hashes.sourceHash ?? ""
+    sourceHash: hashes.sourceHash ?? "",
+    bundleHash: hashes.bundleHash ?? ""
   });
   return {
     name,
     status: "pushed",
     version: data.version,
-    permalink: data.permalink
+    permalink: data.permalink,
+    ...staleBundle ? { staleBundle: true } : {}
   };
 }
 function listLocalComponents(componentsDir) {
@@ -2084,6 +2251,12 @@ function printOutcome2(outcome) {
         `  pushed    ${outcome.name} v${outcome.version} \u2192 ${outcome.permalink ?? ""}
 `
       );
+      if (outcome.staleBundle) {
+        process.stdout.write(
+          `${OUTCOME_INDENT}component.tsx changed but bundle.js did not \u2014 did you forget to build? Run \`gs build ${outcome.name}\` and push again.
+`
+        );
+      }
       return;
     case "unchanged":
       process.stdout.write(`  unchanged ${outcome.name}
@@ -2309,6 +2482,7 @@ function formatList(list) {
 // src/commands/configure/set.ts
 import * as fs10 from "fs";
 import * as path12 from "path";
+var THEME_FLAG_PREFIX = "theme.";
 var TEXT_FIELDS = [
   "displayName",
   "assistantName",
@@ -2338,17 +2512,36 @@ async function setConfig(args) {
     body[field] = entries.length === 0 ? null : entries;
   }
   const themeFile = flagString(args.flags, "themeFile");
+  const perField = collectThemeFieldFlags(args.flags);
+  const replace = flagBool(args.flags, "replace");
   if ("theme" in args.flags && themeFile !== void 0) {
     throw new Error("Pass either --theme or --themeFile, not both.");
   }
+  if (perField !== null && ("theme" in args.flags || themeFile !== void 0)) {
+    throw new Error(
+      "Pass either --theme.<field> flags or a whole --theme/--themeFile object, not both."
+    );
+  }
+  let themePatch;
   if ("theme" in args.flags) {
     const v = args.flags["theme"];
     if (typeof v !== "string") {
       throw new Error('--theme requires a JSON value (use --theme "" to clear).');
     }
-    body["theme"] = v === "" ? null : parseThemeJson(v, "--theme");
+    themePatch = v === "" ? null : parseThemeJson(v, "--theme");
   } else if (themeFile !== void 0) {
-    body["theme"] = parseThemeJson(readTextFile(themeFile, "--themeFile"), "--themeFile");
+    themePatch = parseThemeJson(readTextFile(themeFile, "--themeFile"), "--themeFile");
+  } else if (perField !== null) {
+    themePatch = perField;
+  }
+  if (themePatch !== void 0) {
+    body["theme"] = themePatch === null || replace ? themePatch : { ...await readStoredTheme(slug), ...themePatch };
+    if (body["theme"] !== null) {
+      const merged = body["theme"];
+      for (const [key, value] of Object.entries(merged)) {
+        if (value === "") delete merged[key];
+      }
+    }
   }
   if (Object.keys(body).length === 0) {
     throw new Error(
@@ -2358,7 +2551,10 @@ async function setConfig(args) {
   const url = `${adminApiBase(slug)}/configure/save`;
   const data = await request(url, {
     method: "POST",
-    body
+    body,
+    // Every 400 from this endpoint names the offending field and the values
+    // it accepts — worth far more to the caller than "Request rejected."
+    validationDetail: true
   });
   if (flagBool(args.flags, "json")) {
     process.stdout.write(JSON.stringify(data.config, null, 2) + "\n");
@@ -2386,6 +2582,59 @@ function parseThemeJson(raw, flag) {
   }
   return parsed;
 }
+async function readStoredTheme(slug) {
+  const url = `${adminApiBase(slug)}/configure/config`;
+  const data = await request(url);
+  return data.brand.theme ?? {};
+}
+function collectThemeFieldFlags(flags) {
+  const patch = {};
+  for (const [flag, raw] of Object.entries(flags)) {
+    if (!flag.startsWith(THEME_FLAG_PREFIX)) continue;
+    const name = flag.slice(THEME_FLAG_PREFIX.length);
+    const field = THEME_FIELDS[name];
+    if (!field) {
+      const suggestions = suggestThemeFields(name);
+      throw new Error(
+        `Unknown theme field "${name}".
+Valid fields: ${Object.keys(THEME_FIELDS).join(", ")}.` + (suggestions.length > 0 ? `
+Did you mean: ${suggestions.join(", ")}?` : "")
+      );
+    }
+    if (typeof raw !== "string") {
+      if (field.kind === "boolean") {
+        patch[name] = true;
+        continue;
+      }
+      throw new Error(`--${flag} requires a value (use --${flag} "" to clear).`);
+    }
+    patch[name] = coerceThemeValue(flag, name, raw);
+  }
+  return Object.keys(patch).length > 0 ? patch : null;
+}
+function coerceThemeValue(flag, name, raw) {
+  const field = THEME_FIELDS[name];
+  if (!field || raw === "") return raw;
+  if (field.values && !field.values.includes(raw)) {
+    throw new Error(
+      `--${flag} must be one of: ${field.values.join(", ")} (got "${raw}").`
+    );
+  }
+  if (field.kind === "boolean") {
+    if (raw !== "true" && raw !== "false") {
+      throw new Error(`--${flag} must be true or false (got "${raw}").`);
+    }
+    return raw === "true";
+  }
+  if (field.kind === "integer") {
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isInteger(n) || String(n) !== raw.trim()) {
+      throw new Error(`--${flag} must be an integer (got "${raw}").`);
+    }
+    return n;
+  }
+  return raw;
+}
 
 // src/commands/configure/upload.ts
 import * as fs11 from "fs";
@@ -2752,6 +3001,7 @@ var REFRESH_COMMAND = "__refresh-version-cache";
 var PKG = "@greatstore/cli";
 var REGISTRY_URL = `https://registry.npmjs.org/${PKG}/latest`;
 var FETCH_TIMEOUT_MS = 5e3;
+var CACHE_TTL_MS = 10 * 60 * 1e3;
 var OutdatedCliError = class extends Error {
   constructor(current, latest) {
     super(
@@ -2773,6 +3023,7 @@ async function assertUpToDate(current, opts = {}) {
   if (cached && compareSemver(cached.latest, current) > 0) {
     throw new OutdatedCliError(current, cached.latest);
   }
+  if (cached && now() - cached.checkedAt < CACHE_TTL_MS) return;
   const fresh = await fetcher();
   if (fresh) {
     writeCache(home, { latest: fresh, checkedAt: now() });
@@ -2847,7 +3098,7 @@ function parseVer(v) {
 }
 
 // src/index.ts
-var CHANGELOG = true ? "# Changelog\n\nAll notable changes to `@greatstore/cli` are recorded here. The format\nfollows [Keep a Changelog](https://keepachangelog.com/).\n\n## 0.1.3 \u2014 2026-09-12\n\n### Changed\n- `gs skill` prints the steps for installing the GreatStore agent skill\n  instead of installing it itself, so any AI coding agent can set it up in\n  whichever skills directory it uses \u2014 no `--global` or `--dir` to pick.\n- The installed skill is a link to the copy that ships with the CLI, so\n  upgrading `@greatstore/cli` keeps it current with nothing to re-run.\n\n## 0.1.2 \u2014 2026-09-04\n\n### Fixed\n- `gs apps pull` now downloads components that aren't published yet. Pulling\n  one used to report that it wasn't found on the server.\n\n## 0.1.1 \u2014 2026-08-20\n\n### Changed\n- Signing in now asks you to authorize the store you picked before the CLI\n  gets access to it, and that access can be ended anytime from **Team \u2192 CLI\n  access** in the dashboard. Ending it there signs this computer out on its\n  next command.\n- For each store, you're signed in on one computer at a time. Signing in to\n  that store again from another machine replaces the previous one, which then\n  has to sign in again; your other stores are unaffected.\n- This release is required: earlier versions no longer work. Run\n  `npm install -g @greatstore/cli` to upgrade.\n\n## 0.1.0 \u2014 2026-08-19\n\n### Changed\n- When a component's `inputSchema` declares fields the component doesn't\n  accept, validation now reports them on a single line \u2014 naming the fields\n  (capped, with a `(+N more)` count past that) \u2014 instead of one error per\n  field. A schema/component mismatch stays readable instead of burying the\n  other diagnostics.\n\n## 0.0.48 \u2014 2026-08-19\n\n### Changed\n- Component validation now warns when a component reaches for the page-level\n  `window.GreatStore` API. Components should interact with GreatStore through\n  the lifecycle props passed into them (`onSendMessage`, `onCallTool`,\n  `onGenerateStructuredContent`, \u2026), which are wired to the surface the\n  component is mounted in; the warning points you there. It's a nudge, not a\n  build failure.\n\n## 0.0.47 \u2014 2026-08-18\n\n### Changed\n- `onGenerateStructuredContent` now takes a required third argument,\n  `fallback` \u2014 a schema-shaped object you supply. The component preview\n  renders it (there's no live store to generate against there), so a\n  generation-driven component previews as it would live. It's validated\n  against the schema and throws if the two don't line up.\n\n## 0.0.46 \u2014 2026-08-18\n\n### Added\n- Components now receive an `onGenerateStructuredContent(schema, prompt)`\n  prop: ask the store's assistant for content matching a JSON Schema (or a\n  Zod schema) and render what it returns, personalized to the shopper. It\n  works the same in the conversation on the storefront and every embed.\n  Added to the component template, the scaffolded `AGENTS.md` reference, and\n  prop validation.\n\n## 0.0.45 \u2014 2026-08-18\n\n### Changed\n- The auto-generated `AGENTS.md` banner now records the CLI version that\n  wrote it, so you can tell at a glance when it trails your installed CLI\n  and a `gs apps init` refresh is due.\n\n## 0.0.44 \u2014 2026-08-18\n\n### Added\n- New check: a component that still declares `onError` gets a warning\n  pointing at the async-component pattern that replaced it, with the\n  throw-vs-fallback caveat (a throw asks the assistant to retry, so\n  permanent failures should render a fallback rather than throw). Earlier\n  this surfaced as the generic \"prop isn't declared in the schema\"\n  warning, whose suggested fix was wrong for a former lifecycle callback.\n\n### Changed\n- `gs apps init` now always refreshes `AGENTS.md` (the agent guidance\n  file) so it tracks the installed CLI version instead of going stale.\n  The file carries a \"do not edit \u2014 auto-generated\" banner; your own\n  project files are still left untouched.\n\n## 0.0.43 \u2014 2026-08-18\n\n### Added\n- `gs apps build` and `gs apps push` now check each component before\n  building or uploading it. Findings are reported as **errors** (a\n  blocker \u2014 the component isn't built or uploaded) or **warnings** (it\n  builds and is ready to publish, but something is worth improving),\n  and a single run reports everything it found rather than stopping at\n  the first problem.\n- New check: a component's props and its `inputSchema.properties` must\n  agree. A schema field the component doesn't accept is an error; a prop\n  the schema doesn't declare is a warning, since nothing will ever pass\n  it. The props GreatStore injects (`onSendMessage`, `onCallTool`,\n  `onUpdateModelContext`, `onShowLightbox`, `onClose`, `storeData`,\n  `Image`) are exempt.\n\n## 0.0.42 \u2014 2026-08-15\n\n### Changed\n- `gs apps list` now works outside a project. With no `.gsrc` it lists the\n  components of the store you're signed in to, instead of erroring. The\n  commands that write files or change the store \u2014 `push`, `pull`, `publish`,\n  `unpublish`, `delete` \u2014 still require a project.\n\n## 0.0.41 \u2014 2026-08-14\n\n### Changed\n- Internal authentication rework. Re-run `gs login` after updating.\n\n## 0.0.40 \u2014 2026-07-24\n\n### Removed\n- `gs configure set` no longer accepts `--salesGuide` or\n  `--salesGuideFile`, and `gs configure show` no longer lists the field.\n\n## 0.0.39 \u2014 2026-07-21\n\n### Added\n- Components now receive an `Image` prop \u2014 a drop-in for `<img>` that\n  serves images at the size they're displayed. Render `<Image src=\u2026 />`\n  instead of `<img>`; pass `Image={\"img\"}` to preview a component\n  outside a store. Scaffolded into `gs apps init` and documented in\n  `AGENTS.md`.\n\n## 0.0.38 \u2014 2026-07-13\n\n### Added\n- `gs login --store <slug>` skips the store picker and signs in\n  directly to that store \u2014 fails immediately if your account doesn't\n  have access to it, instead of falling back to the picker.\n\n## 0.0.37 \u2014 2026-07-10\n\n### Added\n- Signing in now ends by choosing which store to work on \u2014 skipped\n  automatically when your account has exactly one. Commands default to\n  that store, so `--store` is rarely needed anymore.\n- `gs switch [<slug>]` changes the working store without signing in\n  again.\n- `gs apps init` no longer requires `--store` when your sign-in already\n  selected a store.\n\n### Changed\n- A `--store` flag or project `.gsrc` that names a different store than\n  the one you signed in to is now an error, so work can't accidentally\n  target the wrong store. Run `gs switch` to change stores.\n\n## 0.0.33 \u2014 2026-07-10\n\n### Changed\n- `gs apps push` now rejects a component whose `inputSchema` is too\n  complex for the assistant to call reliably: union keywords\n  (`anyOf`/`oneOf`/`allOf`/`$ref`/`not`), more than 8 KB serialized, or\n  more than 50 declared fields. Keep schemas to a small set of flat,\n  single-type fields \u2014 one canonical name per concept \u2014 and handle\n  aliases or edge cases in component code instead.\n\n## 0.0.32 \u2014 2026-06-18\n\n### Added\n- Chat components can expand an image into a full-screen, on-brand\n  lightbox via a new `onShowLightbox({ src, originRect })` prop. Wire it\n  to an image's `onClick` \u2014 pass the image URL and, for a smooth zoom,\n  the clicked element's `getBoundingClientRect()`. Use it for product\n  photos, swatches, or size charts the shopper may want to inspect up\n  close, instead of building your own overlay.\n\n## 0.0.31 \u2014 2026-06-18\n\n### Added\n- Components can read a secondary brand font from `--font-secondary`,\n  for a second layer of typography. Falls back to the primary font.\n\n### Changed\n- The brand font variable is now `--font-primary` (was `--font-sans`).\n\n## 0.0.30 \u2014 2026-06-17\n\n### Added\n- The agent skill documents a new way to give the assistant background\n  context without sending a visible message:\n  `window.GreatStore.updateModelContext(text)` on the page, and the\n  matching `onUpdateModelContext(text)` prop inside a chat component. Use\n  it to keep the assistant aware of what the shopper is doing \u2014 the\n  product they're viewing, what's in their cart, the variant they just\n  selected \u2014 so its replies stay on point. Each call replaces the previous\n  value, and nothing renders in the chat.\n\n## 0.0.29 \u2014 2026-06-12\n\n### Fixed\n- The \"update available\" notice actually fires now. It previously raced\n  a 1-second timeout against the npm registry and usually lost, so most\n  installs never saw it. The notice is now served instantly from a local\n  cache, refreshed in the background after each day's first invocation \u2014\n  it can lag one run behind a release, but it no longer adds latency or\n  goes silent on slow networks.\n\n## 0.0.28 \u2014 2026-06-12\n\n### Added\n- `gs configure` \u2014 view and edit the store configuration from the CLI:\n  display name, assistant name, sales guide, store link, extra origins,\n  theme, CSP host lists, and icon/logo uploads. Same fields and\n  behaviour as the dashboard's Configure panel.\n- `gs connectors` \u2014 manage the store's MCP connectors: list, add (with\n  a discovery probe before saving), remove, enable/disable, toggle the\n  Maker MCP, and health-check. Same behaviour as the dashboard's\n  Connectors panel.\n- `--store <slug>` on the new admin commands, so they work outside a\n  scaffolded component project (a `.gsrc` is still used when present).\n- The agent skill gains a store-administration reference: coding agents\n  can read the store's configuration and connectors to ground their\n  work, self-serve additive changes like origin allowlists and CSP\n  hosts (read-merge-write), and are told which changes need the\n  merchant's go-ahead first.\n\n### Changed\n- Component commands now live under `gs apps` (`gs apps push`,\n  `gs apps build`, \u2026), matching the dashboard's Apps panel. The old\n  top-level forms keep working as aliases, so existing scripts and\n  scaffolded projects are unaffected.\n- The skill's structured-content guide now teaches \"point, don't\n  paste\": name the SKU/product/collection and let GreatStore research\n  the catalog itself instead of inlining fetched specs; validate with\n  `gs connectors` that a connector exists for the data a prompt or\n  schema depends on (research can't exceed the wired-up connectors);\n  and never put shopper data in prompts \u2014 GreatStore already knows the\n  shopper, and identified shoppers get per-shopper cached responses.\n\n## 0.0.27 \u2014 2026-06-11\n\n### Changed\n- Skill code samples now carry an explicit reference-only disclaimer:\n  coding agents are told to re-express the logic in the host repo's\n  framework (React, Vue, Shopify Liquid, Svelte, \u2026) instead of\n  retrofitting the framework-free samples as-is.\n\n## 0.0.26 \u2014 2026-06-11\n\n### Added\n- The agent skill gains a \"GreatStore launchers\" recipe: a horizontally\n  scrollable row of AI-generated chips, each an engaging first-person\n  question about the current page that's sent to the assistant on tap.\n\n### Changed\n- Skill recipes are now one file each under `recipes/`, indexed from\n  SKILL.md by a table with description and use-case columns.\n\n## 0.0.25 \u2014 2026-06-11\n\n### Added\n- `gs skill` installs the GreatStore agent skill \u2014 a guide AI coding\n  agents use to build with GreatStore: AI content for your own UI, chat\n  entry points, page tools, custom in-chat components, push\n  notifications, and the store's MCP endpoints. Installs into\n  `./.claude/skills/`; use `--global` for `~/.claude/skills/`, or\n  `--dir <path>` for agents that read skills from somewhere else. Run\n  it again any time to update an installed copy.\n\n## 0.0.24 \u2014 2026-06-03\n\n### Changed\n- `gs init` in an existing project now fills in any scaffold files that\n  are missing (for example, the `AGENTS.md` design guide added in\n  0.0.23) and leaves your own files alone. Pass `--force` to refresh\n  every scaffold file to the latest version. Your pinned store\n  (`.gsrc`) is never rewritten either way.\n\n## 0.0.23 \u2014 2026-06-03\n\n### Added\n- `gs init` now scaffolds an `AGENTS.md` (with `CLAUDE.md` and\n  `GEMINI.md` symlinked to it) documenting the design rules every\n  component should follow \u2014 use `em` rather than `rem` for sizing, and\n  style from the provided brand CSS variables so components match the\n  store's theme. It doubles as guidance for AI coding agents.\n\n## 0.0.22 \u2014 2026-06-02\n\n### Added\n- `gs list` now shows a link to each component's page in the dashboard,\n  so you can jump straight to a component to preview or publish it. The\n  link is also included in `gs list --json`.\n\n## 0.0.21 \u2014 2026-05-31\n\n### Changed\n- The `gs init` component scaffold now shows how to write **async**\n  components that load data before they render \u2014 including validating\n  inputs up front and signalling a failure by throwing. The scaffolded\n  component no longer includes an `onError` prop; throw from an async\n  component to report a failure instead.\n\n## 0.0.20 \u2014 2026-05-29\n\n### Added\n- `gs pull`, `gs push`, and `gs publish` now accept several component\n  names at once (e.g. `gs publish header footer cart`). Each component\n  is reported on its own line and one failure no longer stops the rest.\n\n## 0.0.19 \u2014 2026-05-28\n\n### Fixed\n- `gs login` on Windows no longer opens a sign-in URL with parameters\n  stripped, which surfaced as a \"Missing redirect_uri or state\n  parameter\" page in the browser.\n\n## 0.0.18 \u2014 2026-05-28\n\n### Changed\n- Push and publish errors now name the specific reason \u2014 including\n  every failing field in `manifest.json` \u2014 instead of the previous\n  generic message.\n\n## 0.0.17 \u2014 2026-05-28\n\n### Added\n- Each command now prints a one-line upgrade notice when a newer\n  `@greatstore/cli` is available on npm.\n\n## 0.0.16 \u2014 2026-05-28\n\n### Changed\n- Simplified error messages.\n\n## 0.0.15 \u2014 2026-05-24\n\n### Added\n- Scaffolded `component.tsx` now declares the four injected lifecycle\n  props (`onSendMessage`, `onCallTool`, `onClose`, `onError`) on\n  `Props`. Use `onError(message)` to report expected failures (failed\n  fetch, host action rejected, invalid host state) so the AI can\n  recover on its next turn. Render-time crashes are reported for you.\n\n## 0.0.14 \u2014 2026-05-24\n\n### Changed\n- `gs build` output is now whitespace-minified \u2014 typically ~50% smaller.\n\n## 0.0.13 \u2014 2026-05-24\n\n### Changed\n- `gs build` prints the next-step hint (`gs push`, then `gs publish`).\n\n## 0.0.12 \u2014 2026-05-24\n\n### Fixed\n- `gs build` failing to load Vite in some setups.\n\n## 0.0.11 \u2014 2026-05-24\n\n### Added\n- Multi-component projects. `gs init` (no args) scaffolds the project\n  root; `gs init <name>` adds a component under `components/<name>/`.\n- `gs build [<name>]` \u2014 compiles every `components/<name>/bundle.js`.\n- `gs push` (no args) uploads only the components that changed.\n- `gs pull` (no args, or `*`) downloads every component. Locally\n  edited components are skipped; pass `--force` to overwrite.\n- Public `CHANGELOG.md`; `gs --version` prints recent entries.\n\n### Changed\n- A project folder ships to exactly one store. Only `gs init` accepts\n  `--store`; every other command reads the slug from `.gsrc`. The old\n  single-component layout is rejected with a migration hint.\n- `gs init` requires `--store <slug>` for a fresh root, and rejects\n  `--store` on an existing root.\n- `gs init` no longer writes `build.mjs` \u2014 scripts call `gs build`.\n\n## 0.0.10 \u2014 2026-05-23\n\n### Changed\n- The sign-in browser tab auto-closes once `gs login` finishes.\n\n## 0.0.9 \u2014 2026-05-23\n\n### Changed\n- Scaffolded manifests include a `displayName` so the admin UI has a\n  friendlier label.\n\n## 0.0.8 \u2014 2026-05-23\n\n### Changed\n- `gs push` and `gs publish` print a link to view the component.\n\n## 0.0.6 \u2014 2026-05-23\n\n### Changed\n- `gs --version` reads from the published package version.\n\n## 0.0.4 \u2014 2026-05-23\n\n### Changed\n- Scaffolded projects produce browser-ready bundles out of the box.\n\n## 0.0.3 \u2014 2026-05-23\n\n### Changed\n- Trimmed public README to the essentials.\n\n## 0.0.2 \u2014 2026-05-23\n\n### Fixed\n- Sign-in callback parameter handling.\n" : "";
+var CHANGELOG = true ? "# Changelog\n\nAll notable changes to `@greatstore/cli` are recorded here. The format\nfollows [Keep a Changelog](https://keepachangelog.com/).\n\n## 0.1.5 \u2014 2026-09-12\n\n### Fixed\n- `gs apps push` says when a component's source changed but its bundle did\n  not \u2014 \"did you forget to build?\" \u2014 instead of reporting a successful push\n  of code that was never built.\n- A rebuilt bundle is now pushed even when the source is untouched. Such a\n  change was reported as \"unchanged\" and never uploaded.\n\n## 0.1.4 \u2014 2026-09-12\n\n### Added\n- Edit one theme field at a time: `gs configure set --theme.fontFamily Manrope\n  --theme.radius sharp`. Theme writes merge into the stored theme, so a\n  one-field change no longer means retyping the whole object (and no longer\n  drops the keys you left out). `--replace` writes a theme outright.\n- `gs configure set --help` prints every field it accepts with its type and\n  legal values, and a mistyped field name or value is now rejected with the\n  valid list before anything is sent.\n\n### Changed\n- Rejected configuration writes say what was wrong with them \u2014 the field and\n  the values it accepts \u2014 instead of \"Request rejected.\"\n- Commands no longer wait on a version check every run, which takes about half\n  a second off each one.\n\n## 0.1.3 \u2014 2026-09-12\n\n### Changed\n- `gs skill` prints the steps for installing the GreatStore agent skill\n  instead of installing it itself, so any AI coding agent can set it up in\n  whichever skills directory it uses \u2014 no `--global` or `--dir` to pick.\n- The installed skill is a link to the copy that ships with the CLI, so\n  upgrading `@greatstore/cli` keeps it current with nothing to re-run.\n\n## 0.1.2 \u2014 2026-09-04\n\n### Fixed\n- `gs apps pull` now downloads components that aren't published yet. Pulling\n  one used to report that it wasn't found on the server.\n\n## 0.1.1 \u2014 2026-08-20\n\n### Changed\n- Signing in now asks you to authorize the store you picked before the CLI\n  gets access to it, and that access can be ended anytime from **Team \u2192 CLI\n  access** in the dashboard. Ending it there signs this computer out on its\n  next command.\n- For each store, you're signed in on one computer at a time. Signing in to\n  that store again from another machine replaces the previous one, which then\n  has to sign in again; your other stores are unaffected.\n- This release is required: earlier versions no longer work. Run\n  `npm install -g @greatstore/cli` to upgrade.\n\n## 0.1.0 \u2014 2026-08-19\n\n### Changed\n- When a component's `inputSchema` declares fields the component doesn't\n  accept, validation now reports them on a single line \u2014 naming the fields\n  (capped, with a `(+N more)` count past that) \u2014 instead of one error per\n  field. A schema/component mismatch stays readable instead of burying the\n  other diagnostics.\n\n## 0.0.48 \u2014 2026-08-19\n\n### Changed\n- Component validation now warns when a component reaches for the page-level\n  `window.GreatStore` API. Components should interact with GreatStore through\n  the lifecycle props passed into them (`onSendMessage`, `onCallTool`,\n  `onGenerateStructuredContent`, \u2026), which are wired to the surface the\n  component is mounted in; the warning points you there. It's a nudge, not a\n  build failure.\n\n## 0.0.47 \u2014 2026-08-18\n\n### Changed\n- `onGenerateStructuredContent` now takes a required third argument,\n  `fallback` \u2014 a schema-shaped object you supply. The component preview\n  renders it (there's no live store to generate against there), so a\n  generation-driven component previews as it would live. It's validated\n  against the schema and throws if the two don't line up.\n\n## 0.0.46 \u2014 2026-08-18\n\n### Added\n- Components now receive an `onGenerateStructuredContent(schema, prompt)`\n  prop: ask the store's assistant for content matching a JSON Schema (or a\n  Zod schema) and render what it returns, personalized to the shopper. It\n  works the same in the conversation on the storefront and every embed.\n  Added to the component template, the scaffolded `AGENTS.md` reference, and\n  prop validation.\n\n## 0.0.45 \u2014 2026-08-18\n\n### Changed\n- The auto-generated `AGENTS.md` banner now records the CLI version that\n  wrote it, so you can tell at a glance when it trails your installed CLI\n  and a `gs apps init` refresh is due.\n\n## 0.0.44 \u2014 2026-08-18\n\n### Added\n- New check: a component that still declares `onError` gets a warning\n  pointing at the async-component pattern that replaced it, with the\n  throw-vs-fallback caveat (a throw asks the assistant to retry, so\n  permanent failures should render a fallback rather than throw). Earlier\n  this surfaced as the generic \"prop isn't declared in the schema\"\n  warning, whose suggested fix was wrong for a former lifecycle callback.\n\n### Changed\n- `gs apps init` now always refreshes `AGENTS.md` (the agent guidance\n  file) so it tracks the installed CLI version instead of going stale.\n  The file carries a \"do not edit \u2014 auto-generated\" banner; your own\n  project files are still left untouched.\n\n## 0.0.43 \u2014 2026-08-18\n\n### Added\n- `gs apps build` and `gs apps push` now check each component before\n  building or uploading it. Findings are reported as **errors** (a\n  blocker \u2014 the component isn't built or uploaded) or **warnings** (it\n  builds and is ready to publish, but something is worth improving),\n  and a single run reports everything it found rather than stopping at\n  the first problem.\n- New check: a component's props and its `inputSchema.properties` must\n  agree. A schema field the component doesn't accept is an error; a prop\n  the schema doesn't declare is a warning, since nothing will ever pass\n  it. The props GreatStore injects (`onSendMessage`, `onCallTool`,\n  `onUpdateModelContext`, `onShowLightbox`, `onClose`, `storeData`,\n  `Image`) are exempt.\n\n## 0.0.42 \u2014 2026-08-15\n\n### Changed\n- `gs apps list` now works outside a project. With no `.gsrc` it lists the\n  components of the store you're signed in to, instead of erroring. The\n  commands that write files or change the store \u2014 `push`, `pull`, `publish`,\n  `unpublish`, `delete` \u2014 still require a project.\n\n## 0.0.41 \u2014 2026-08-14\n\n### Changed\n- Internal authentication rework. Re-run `gs login` after updating.\n\n## 0.0.40 \u2014 2026-07-24\n\n### Removed\n- `gs configure set` no longer accepts `--salesGuide` or\n  `--salesGuideFile`, and `gs configure show` no longer lists the field.\n\n## 0.0.39 \u2014 2026-07-21\n\n### Added\n- Components now receive an `Image` prop \u2014 a drop-in for `<img>` that\n  serves images at the size they're displayed. Render `<Image src=\u2026 />`\n  instead of `<img>`; pass `Image={\"img\"}` to preview a component\n  outside a store. Scaffolded into `gs apps init` and documented in\n  `AGENTS.md`.\n\n## 0.0.38 \u2014 2026-07-13\n\n### Added\n- `gs login --store <slug>` skips the store picker and signs in\n  directly to that store \u2014 fails immediately if your account doesn't\n  have access to it, instead of falling back to the picker.\n\n## 0.0.37 \u2014 2026-07-10\n\n### Added\n- Signing in now ends by choosing which store to work on \u2014 skipped\n  automatically when your account has exactly one. Commands default to\n  that store, so `--store` is rarely needed anymore.\n- `gs switch [<slug>]` changes the working store without signing in\n  again.\n- `gs apps init` no longer requires `--store` when your sign-in already\n  selected a store.\n\n### Changed\n- A `--store` flag or project `.gsrc` that names a different store than\n  the one you signed in to is now an error, so work can't accidentally\n  target the wrong store. Run `gs switch` to change stores.\n\n## 0.0.33 \u2014 2026-07-10\n\n### Changed\n- `gs apps push` now rejects a component whose `inputSchema` is too\n  complex for the assistant to call reliably: union keywords\n  (`anyOf`/`oneOf`/`allOf`/`$ref`/`not`), more than 8 KB serialized, or\n  more than 50 declared fields. Keep schemas to a small set of flat,\n  single-type fields \u2014 one canonical name per concept \u2014 and handle\n  aliases or edge cases in component code instead.\n\n## 0.0.32 \u2014 2026-06-18\n\n### Added\n- Chat components can expand an image into a full-screen, on-brand\n  lightbox via a new `onShowLightbox({ src, originRect })` prop. Wire it\n  to an image's `onClick` \u2014 pass the image URL and, for a smooth zoom,\n  the clicked element's `getBoundingClientRect()`. Use it for product\n  photos, swatches, or size charts the shopper may want to inspect up\n  close, instead of building your own overlay.\n\n## 0.0.31 \u2014 2026-06-18\n\n### Added\n- Components can read a secondary brand font from `--font-secondary`,\n  for a second layer of typography. Falls back to the primary font.\n\n### Changed\n- The brand font variable is now `--font-primary` (was `--font-sans`).\n\n## 0.0.30 \u2014 2026-06-17\n\n### Added\n- The agent skill documents a new way to give the assistant background\n  context without sending a visible message:\n  `window.GreatStore.updateModelContext(text)` on the page, and the\n  matching `onUpdateModelContext(text)` prop inside a chat component. Use\n  it to keep the assistant aware of what the shopper is doing \u2014 the\n  product they're viewing, what's in their cart, the variant they just\n  selected \u2014 so its replies stay on point. Each call replaces the previous\n  value, and nothing renders in the chat.\n\n## 0.0.29 \u2014 2026-06-12\n\n### Fixed\n- The \"update available\" notice actually fires now. It previously raced\n  a 1-second timeout against the npm registry and usually lost, so most\n  installs never saw it. The notice is now served instantly from a local\n  cache, refreshed in the background after each day's first invocation \u2014\n  it can lag one run behind a release, but it no longer adds latency or\n  goes silent on slow networks.\n\n## 0.0.28 \u2014 2026-06-12\n\n### Added\n- `gs configure` \u2014 view and edit the store configuration from the CLI:\n  display name, assistant name, sales guide, store link, extra origins,\n  theme, CSP host lists, and icon/logo uploads. Same fields and\n  behaviour as the dashboard's Configure panel.\n- `gs connectors` \u2014 manage the store's MCP connectors: list, add (with\n  a discovery probe before saving), remove, enable/disable, toggle the\n  Maker MCP, and health-check. Same behaviour as the dashboard's\n  Connectors panel.\n- `--store <slug>` on the new admin commands, so they work outside a\n  scaffolded component project (a `.gsrc` is still used when present).\n- The agent skill gains a store-administration reference: coding agents\n  can read the store's configuration and connectors to ground their\n  work, self-serve additive changes like origin allowlists and CSP\n  hosts (read-merge-write), and are told which changes need the\n  merchant's go-ahead first.\n\n### Changed\n- Component commands now live under `gs apps` (`gs apps push`,\n  `gs apps build`, \u2026), matching the dashboard's Apps panel. The old\n  top-level forms keep working as aliases, so existing scripts and\n  scaffolded projects are unaffected.\n- The skill's structured-content guide now teaches \"point, don't\n  paste\": name the SKU/product/collection and let GreatStore research\n  the catalog itself instead of inlining fetched specs; validate with\n  `gs connectors` that a connector exists for the data a prompt or\n  schema depends on (research can't exceed the wired-up connectors);\n  and never put shopper data in prompts \u2014 GreatStore already knows the\n  shopper, and identified shoppers get per-shopper cached responses.\n\n## 0.0.27 \u2014 2026-06-11\n\n### Changed\n- Skill code samples now carry an explicit reference-only disclaimer:\n  coding agents are told to re-express the logic in the host repo's\n  framework (React, Vue, Shopify Liquid, Svelte, \u2026) instead of\n  retrofitting the framework-free samples as-is.\n\n## 0.0.26 \u2014 2026-06-11\n\n### Added\n- The agent skill gains a \"GreatStore launchers\" recipe: a horizontally\n  scrollable row of AI-generated chips, each an engaging first-person\n  question about the current page that's sent to the assistant on tap.\n\n### Changed\n- Skill recipes are now one file each under `recipes/`, indexed from\n  SKILL.md by a table with description and use-case columns.\n\n## 0.0.25 \u2014 2026-06-11\n\n### Added\n- `gs skill` installs the GreatStore agent skill \u2014 a guide AI coding\n  agents use to build with GreatStore: AI content for your own UI, chat\n  entry points, page tools, custom in-chat components, push\n  notifications, and the store's MCP endpoints. Installs into\n  `./.claude/skills/`; use `--global` for `~/.claude/skills/`, or\n  `--dir <path>` for agents that read skills from somewhere else. Run\n  it again any time to update an installed copy.\n\n## 0.0.24 \u2014 2026-06-03\n\n### Changed\n- `gs init` in an existing project now fills in any scaffold files that\n  are missing (for example, the `AGENTS.md` design guide added in\n  0.0.23) and leaves your own files alone. Pass `--force` to refresh\n  every scaffold file to the latest version. Your pinned store\n  (`.gsrc`) is never rewritten either way.\n\n## 0.0.23 \u2014 2026-06-03\n\n### Added\n- `gs init` now scaffolds an `AGENTS.md` (with `CLAUDE.md` and\n  `GEMINI.md` symlinked to it) documenting the design rules every\n  component should follow \u2014 use `em` rather than `rem` for sizing, and\n  style from the provided brand CSS variables so components match the\n  store's theme. It doubles as guidance for AI coding agents.\n\n## 0.0.22 \u2014 2026-06-02\n\n### Added\n- `gs list` now shows a link to each component's page in the dashboard,\n  so you can jump straight to a component to preview or publish it. The\n  link is also included in `gs list --json`.\n\n## 0.0.21 \u2014 2026-05-31\n\n### Changed\n- The `gs init` component scaffold now shows how to write **async**\n  components that load data before they render \u2014 including validating\n  inputs up front and signalling a failure by throwing. The scaffolded\n  component no longer includes an `onError` prop; throw from an async\n  component to report a failure instead.\n\n## 0.0.20 \u2014 2026-05-29\n\n### Added\n- `gs pull`, `gs push`, and `gs publish` now accept several component\n  names at once (e.g. `gs publish header footer cart`). Each component\n  is reported on its own line and one failure no longer stops the rest.\n\n## 0.0.19 \u2014 2026-05-28\n\n### Fixed\n- `gs login` on Windows no longer opens a sign-in URL with parameters\n  stripped, which surfaced as a \"Missing redirect_uri or state\n  parameter\" page in the browser.\n\n## 0.0.18 \u2014 2026-05-28\n\n### Changed\n- Push and publish errors now name the specific reason \u2014 including\n  every failing field in `manifest.json` \u2014 instead of the previous\n  generic message.\n\n## 0.0.17 \u2014 2026-05-28\n\n### Added\n- Each command now prints a one-line upgrade notice when a newer\n  `@greatstore/cli` is available on npm.\n\n## 0.0.16 \u2014 2026-05-28\n\n### Changed\n- Simplified error messages.\n\n## 0.0.15 \u2014 2026-05-24\n\n### Added\n- Scaffolded `component.tsx` now declares the four injected lifecycle\n  props (`onSendMessage`, `onCallTool`, `onClose`, `onError`) on\n  `Props`. Use `onError(message)` to report expected failures (failed\n  fetch, host action rejected, invalid host state) so the AI can\n  recover on its next turn. Render-time crashes are reported for you.\n\n## 0.0.14 \u2014 2026-05-24\n\n### Changed\n- `gs build` output is now whitespace-minified \u2014 typically ~50% smaller.\n\n## 0.0.13 \u2014 2026-05-24\n\n### Changed\n- `gs build` prints the next-step hint (`gs push`, then `gs publish`).\n\n## 0.0.12 \u2014 2026-05-24\n\n### Fixed\n- `gs build` failing to load Vite in some setups.\n\n## 0.0.11 \u2014 2026-05-24\n\n### Added\n- Multi-component projects. `gs init` (no args) scaffolds the project\n  root; `gs init <name>` adds a component under `components/<name>/`.\n- `gs build [<name>]` \u2014 compiles every `components/<name>/bundle.js`.\n- `gs push` (no args) uploads only the components that changed.\n- `gs pull` (no args, or `*`) downloads every component. Locally\n  edited components are skipped; pass `--force` to overwrite.\n- Public `CHANGELOG.md`; `gs --version` prints recent entries.\n\n### Changed\n- A project folder ships to exactly one store. Only `gs init` accepts\n  `--store`; every other command reads the slug from `.gsrc`. The old\n  single-component layout is rejected with a migration hint.\n- `gs init` requires `--store <slug>` for a fresh root, and rejects\n  `--store` on an existing root.\n- `gs init` no longer writes `build.mjs` \u2014 scripts call `gs build`.\n\n## 0.0.10 \u2014 2026-05-23\n\n### Changed\n- The sign-in browser tab auto-closes once `gs login` finishes.\n\n## 0.0.9 \u2014 2026-05-23\n\n### Changed\n- Scaffolded manifests include a `displayName` so the admin UI has a\n  friendlier label.\n\n## 0.0.8 \u2014 2026-05-23\n\n### Changed\n- `gs push` and `gs publish` print a link to view the component.\n\n## 0.0.6 \u2014 2026-05-23\n\n### Changed\n- `gs --version` reads from the published package version.\n\n## 0.0.4 \u2014 2026-05-23\n\n### Changed\n- Scaffolded projects produce browser-ready bundles out of the box.\n\n## 0.0.3 \u2014 2026-05-23\n\n### Changed\n- Trimmed public README to the essentials.\n\n## 0.0.2 \u2014 2026-05-23\n\n### Fixed\n- Sign-in callback parameter handling.\n" : "";
 var HELP = `gs \u2014 GreatStore CLI (v${CLI_VERSION})
 
 Usage:
@@ -2863,6 +3114,8 @@ Account:
 Store administration:
   configure                      Show the store configuration.
   configure set --<field> <val>  Edit it (same fields as the admin Configure panel).
+                                 \`gs configure set --help\` lists every field,
+                                 including the theme fields and their values.
   configure upload <kind> <file> Upload icon / logoLight / logoDark.
   configure clear <kind>         Remove an uploaded asset.
   connectors                     List the store's MCP connectors.
@@ -2928,7 +3181,8 @@ async function main() {
     return 0;
   }
   if (flagBool(parsed.flags, "help") || parsed.command === "help" || parsed.command === null) {
-    process.stdout.write(HELP);
+    const specific = parsed.command === "configure" ? configureHelp(parsed.positional[0]) : void 0;
+    process.stdout.write(specific ?? HELP);
     return 0;
   }
   if (parsed.command !== null && APPS_ALIASES.has(parsed.command)) {

package/dist/gs-skill/references/store-admin.md

@@ -102,9 +102,19 @@ and confirm the result with a read.
 gs configure [--json]                      show configuration
 gs configure set --<field> <value>         displayName, assistantName,
                                            storeLink, extraOrigins a,b,
-                                           theme '<json>' (--themeFile <path>),
                                            cspScriptHosts a,b, cspConnectHosts a,b
                                            ("" clears a field)
+gs configure set --theme.<field> <value>   one theme field, merged into the rest:
+                                           mode auto|light|dark|custom,
+                                           radius sharp|default|rounded,
+                                           panelPosition left|right|middle,
+                                           fontFamily, secondaryFontFamily,
+                                           mobileBottomBar true|false, zIndex,
+                                           brandColor/surfaceColor/textColor and
+                                           the fine-grained color tokens
+gs configure set --theme '<json>'          merge a whole object (--themeFile <path>);
+                                           --replace overwrites instead of merging
+gs configure set --help                    every field, its type and legal values
 gs configure upload <kind> <file>          icon | logoLight | logoDark (.png/.jpg/.webp)
 gs configure clear <kind>                  remove an uploaded asset
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatstore/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI for administering GreatStore stores and authoring custom components.",
   "license": "UNLICENSED",
   "type": "module",