@greatstore/cli 0.0.22 → 0.0.24

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to `@greatstore/cli` are recorded here. The format
 follows [Keep a Changelog](https://keepachangelog.com/).
 
+## 0.0.24 — 2026-06-03
+
+### Changed
+- `gs init` in an existing project now fills in any scaffold files that
+  are missing (for example, the `AGENTS.md` design guide added in
+  0.0.23) and leaves your own files alone. Pass `--force` to refresh
+  every scaffold file to the latest version. Your pinned store
+  (`.gsrc`) is never rewritten either way.
+
+## 0.0.23 — 2026-06-03
+
+### Added
+- `gs init` now scaffolds an `AGENTS.md` (with `CLAUDE.md` and
+  `GEMINI.md` symlinked to it) documenting the design rules every
+  component should follow — use `em` rather than `rem` for sizing, and
+  style from the provided brand CSS variables so components match the
+  store's theme. It doubles as guidance for AI coding agents.
+
 ## 0.0.22 — 2026-06-02
 
 ### Added

package/dist/cli.js

@@ -1111,6 +1111,38 @@ function prompt(question) {
 // src/commands/init.ts
 import * as fs6 from "fs";
 import * as path6 from "path";
+
+// src/template.ts
+import { readdirSync as readdirSync2, readFileSync as readFileSync5 } from "fs";
+import { fileURLToPath } from "url";
+var cache = null;
+function loadTemplate() {
+  if (cache) return cache;
+  cache = true ? JSON.parse('{"component/component.tsx":"import React from \\"react\\";\\n\\n// Add your tool args (matching manifest.json#inputSchema.properties)\\n// alongside the GreatStore-injected lifecycle props. See AGENTS.md for\\n// what each lifecycle prop does.\\ninterface Props {\\n  onSendMessage: (text: string) => void;\\n  onCallTool: (name: string, args: Record<string, unknown>) => void;\\n  onClose: () => void;\\n}\\n\\n// See AGENTS.md for the design rules (em-based sizing, brand CSS\\n// variables), the lifecycle props, and how to write an async,\\n// backend-backed component.\\nexport default function __GS_PASCAL__(_props: Props): React.ReactElement {\\n  return (\\n    <div\\n      style={{\\n        padding: \\"1em\\",\\n        border: \\"1px solid var(--color-border-default)\\",\\n        borderRadius: \\"var(--radius-lg)\\",\\n        background: \\"var(--color-surface)\\",\\n        color: \\"var(--color-foreground)\\",\\n        fontFamily: \\"var(--font-sans)\\",\\n      }}\\n    >\\n      <strong>__GS_NAME__</strong> \u2014 hello from your component!\\n    </div>\\n  );\\n}\\n","component/manifest.json":"{\\n  \\"name\\": \\"__GS_NAME__\\",\\n  \\"displayName\\": \\"__GS_DISPLAY_NAME__\\",\\n  \\"description\\": \\"Renders the __GS_NAME__ widget.\\",\\n  \\"displayMode\\": \\"inline\\",\\n  \\"inputSchema\\": {\\n    \\"type\\": \\"object\\",\\n    \\"properties\\": {}\\n  }\\n}\\n","root/.gitignore":"node_modules/\\ncomponents/*/bundle.js\\ncomponents/*/.gssync.json\\n*.tsbuildinfo\\n.DS_Store\\n","root/.gsrc":"{\\n  \\"store\\": \\"__GS_STORE__\\"\\n}\\n","root/AGENTS.md":"# AGENTS.md\\n\\nGuidance for AI coding agents working on the components in this project.\\n`CLAUDE.md` and `GEMINI.md` are symlinks to this file.\\n\\nThese components render inside arbitrary publisher websites (the embed\\nwidget mounts on a host page) as well as the GreatStore storefront. You\\ncontrol neither the host page\'s base font size nor its color scheme, and\\nthe store owner controls the look from GreatStore theme settings. The\\nrules below keep components portable across both.\\n\\n## Design requirements\\n\\n### Never use `rem` for fonts and sizing \u2014 always use `em`\\n\\n`rem` resolves against the host page\'s root font size, which is\\narbitrary and outside our control. A host that sets `html { font-size:\\n8px }` (or 200%) will shrink or blow up every `rem`-based dimension.\\n`em` resolves against the component\'s own font size, so it stays\\nself-consistent wherever the component is mounted.\\n\\nUse `em` for font sizes, padding, margins, gaps, widths, heights,\\nand any other length. Borders may stay in `px` (hairlines should not\\nscale with text).\\n\\n```tsx\\n// Bad \u2014 breaks on hosts with a non-default root font size\\n<div style={{ padding: \\"1rem\\", fontSize: \\"0.875rem\\" }} />\\n\\n// Good\\n<div style={{ padding: \\"1em\\", fontSize: \\"0.875em\\" }} />\\n```\\n\\n### Don\'t hardcode colors, fonts, or corner radius \u2014 use GreatStore brand variables\\n\\nThe store owner themes the assistant from GreatStore settings. Hardcoded\\nvalues ignore that and make the component clash with the rest of the\\nstore. Read from the CSS variables GreatStore injects on the surface\\ninstead, so the component restyles itself when the theme changes.\\n\\nAvailable variables:\\n\\n| Purpose | Variable |\\n| --- | --- |\\n| Surface background | `--color-surface` |\\n| Secondary surface | `--color-surface-secondary` |\\n| Accent surface | `--color-surface-accent` |\\n| Hover surface | `--color-surface-hover` |\\n| Foreground text | `--color-foreground` |\\n| Secondary text | `--color-foreground-secondary` |\\n| Muted text | `--color-foreground-muted` |\\n| Accent text | `--color-foreground-accent` |\\n| Border | `--color-border-default` |\\n| Focus border | `--color-border-focus` |\\n| Primary / brand | `--color-primary` |\\n| Text on primary | `--color-primary-foreground` |\\n| Primary hover | `--color-primary-hover` |\\n| Primary muted | `--color-primary-muted` |\\n| Text on primary muted | `--color-primary-muted-foreground` |\\n| Primary tint | `--color-primary-tint` |\\n| Link | `--color-link` |\\n| Font family | `--font-sans` |\\n| Corner radius (scale) | `--radius-xs` \u2026 `--radius-4xl`, `--radius-pill` |\\n\\n```tsx\\n// Bad \u2014 hardcoded, ignores the store\'s theme\\n<button style={{ background: \\"#4f46e5\\", borderRadius: 8, fontFamily: \\"Inter\\" }} />\\n\\n// Good\\n<button\\n  style={{\\n    background: \\"var(--color-primary)\\",\\n    color: \\"var(--color-primary-foreground)\\",\\n    borderRadius: \\"var(--radius-lg)\\",\\n    fontFamily: \\"var(--font-sans)\\",\\n  }}\\n/>\\n```\\n\\nProvide a sensible fallback only when a value might be absent, e.g.\\n`var(--color-primary, currentColor)`.\\n\\n## Component props\\n\\nEach component receives its tool args (the fields you declare in\\n`manifest.json#inputSchema.properties`) plus these GreatStore-injected\\nlifecycle props, which are always present:\\n\\n| Prop | What it does |\\n| --- | --- |\\n| `onSendMessage(text)` | Send text into the chat as if the shopper typed it. |\\n| `onCallTool(name, args)` | Chain into another remote-component tool by name. |\\n| `onClose()` | Dismiss the host slot. Over-input clears the overlay, fullscreen reverts the pane, inline is a no-op. |\\n\\n## Async components (backend-backed, render-blocking data)\\n\\nIf a component must load data from a backend/API before it can render\\ncorrectly, make it async \u2014 don\'t render an empty shell and fetch in a\\n`useEffect`. Set `\\"async\\": true` in `manifest.json` and export an async\\ndefault. GreatStore waits for your promise (showing a normal loading\\nstate, so you don\'t render your own placeholder), then renders what it\\nresolves to. Components that render purely from their props stay\\nsynchronous.\\n\\nA thrown error is a **retry signal**: the in-store AI sees it and\\nusually re-calls the tool. So only throw when a *different* call could\\nhelp:\\n\\n1. `await` the backend call, then return the finished JSX.\\n2. Validate the AI-passed props first and throw on bad input \u2014 the AI\\n   can fix the args and retry. (Don\'t validate the API\'s *output* and\\n   throw: the AI can\'t fix the backend, it\'ll just loop.)\\n3. Broadcast a backend failure ONLY when retrying differently could\\n   succeed, and say what to change (e.g. empty search \u2192 \\"try a broader\\n   keyword\\"). For idempotent failures (500, timeout, missing record)\\n   re-running the same call changes nothing \u2014 render a graceful fallback\\n   instead of throwing.\\n\\n```tsx\\nexport default async function Example(props: Props) {\\n  if (!props.query?.trim()) throw new Error(\\"missing required prop: query\\");\\n  const res = await fetch(`/api/search?q=${encodeURIComponent(props.query)}`);\\n  if (res.ok) {\\n    const { results } = await res.json();\\n    if (results.length === 0)\\n      throw new Error(`no results for \\"${props.query}\\" \u2014 try a broader keyword`);\\n    return <ul>{/* render results */}</ul>;\\n  }\\n  return <p>Couldn\'t load results right now.</p>; // idempotent: don\'t throw\\n}\\n```\\n","root/README.md":"# GreatStore components\\n\\nCustom React components published to your GreatStore tenant. Each\\ncomponent lives in its own folder under `components/`.\\n\\n```\\nnpm install\\ngs init <component_name>      # add a new component\\ngs build                      # builds every components/<name>/bundle.js\\ngs push                       # uploads every changed component as a draft\\ngs publish <component_name>   # promote a specific component to live\\n```\\n\\n- `gs push` (no args) hashes each component and only uploads the ones\\n  that have changed since the last sync.\\n- `gs pull` (no args) refreshes every remote component into\\n  `components/<name>/`. Components with unsaved local edits are skipped\\n  with a warning; pass `--force` to overwrite.\\n\\nSee `AGENTS.md` for the design rules every component must follow\\n(em-based sizing, brand CSS variables) \u2014 it doubles as guidance for AI\\ncoding agents (`CLAUDE.md` / `GEMINI.md` symlink to it).\\n","root/package.json":"{\\n  \\"name\\": \\"greatstore-components\\",\\n  \\"version\\": \\"0.0.1\\",\\n  \\"private\\": true,\\n  \\"type\\": \\"module\\",\\n  \\"scripts\\": {\\n    \\"build\\": \\"gs build\\",\\n    \\"push\\": \\"gs build && gs push\\"\\n  },\\n  \\"dependencies\\": {\\n    \\"react\\": \\"^19.0.0\\",\\n    \\"react-dom\\": \\"^19.0.0\\"\\n  },\\n  \\"devDependencies\\": {\\n    \\"@types/react\\": \\"^19.0.0\\",\\n    \\"@types/react-dom\\": \\"^19.0.0\\",\\n    \\"@vitejs/plugin-react\\": \\"^4.3.0\\",\\n    \\"typescript\\": \\"^5.6.0\\",\\n    \\"vite\\": \\"^5.4.0\\"\\n  }\\n}\\n","root/tsconfig.json":"{\\n  \\"compilerOptions\\": {\\n    \\"target\\": \\"ES2022\\",\\n    \\"module\\": \\"ESNext\\",\\n    \\"moduleResolution\\": \\"Bundler\\",\\n    \\"jsx\\": \\"react-jsx\\",\\n    \\"lib\\": [\\"ES2022\\", \\"DOM\\"],\\n    \\"strict\\": true,\\n    \\"esModuleInterop\\": true,\\n    \\"skipLibCheck\\": true,\\n    \\"isolatedModules\\": true,\\n    \\"noEmit\\": true\\n  },\\n  \\"include\\": [\\"components/**/component.tsx\\", \\"vite.config.ts\\"]\\n}\\n","root/vite.config.ts":"import { defineConfig } from \\"vite\\";\\nimport react from \\"@vitejs/plugin-react\\";\\n\\n// Real builds happen in `gs build` (one Vite invocation per\\n// component, externals + runtime shim paths owned by the CLI). This\\n// file exists only so editors / language servers can resolve the\\n// React plugin when inspecting components/*/component.tsx.\\nexport default defineConfig({\\n  plugins: [react()],\\n});\\n"}') : readTemplateFromDisk(new URL("../template/", import.meta.url));
+  return cache;
+}
+var TOKENS = {
+  name: "__GS_NAME__",
+  pascalName: "__GS_PASCAL__",
+  displayName: "__GS_DISPLAY_NAME__",
+  store: "__GS_STORE__"
+};
+function applyTemplate(content, vars) {
+  let out = content;
+  for (const key of Object.keys(TOKENS)) {
+    const value = vars[key];
+    if (value !== void 0) out = out.split(TOKENS[key]).join(value);
+  }
+  const leftover = out.match(/__GS_[A-Z_]+__/);
+  if (leftover) {
+    throw new Error(
+      `internal: template placeholder ${leftover[0]} was not provided`
+    );
+  }
+  return out;
+}
+
+// src/commands/init.ts
 var NAME_REGEX = /^[a-z][a-z0-9_]*$/;
 function initCommand(args) {
   const name = args.positional[0];
@@ -1134,20 +1166,28 @@ function initCommand(args) {
       `--store <slug> is required when scaffolding a new project root. Run \`${example}\`.`
     );
   }
-  ensureRoot(root, rootExisted, force, { store: storeFlag });
+  const writtenRootFiles = ensureRoot(root, rootExisted, force, { store: storeFlag });
   if (!name) {
-    const created = rootExisted ? "Updated" : "Scaffolded";
-    process.stdout.write(
-      [
-        `${created} GreatStore project root in ${root}.`,
-        "",
-        "Next steps:",
-        `  cd ${path6.relative(process.cwd(), root) || "."}`,
-        "  npm install",
-        "  gs init <component_name>     # add your first component",
-        ""
-      ].join("\n")
+    const lines = [];
+    if (rootExisted) {
+      lines.push(`Updated GreatStore project root in ${root}.`);
+      if (writtenRootFiles.length > 0) {
+        lines.push("", `Added: ${writtenRootFiles.join(", ")}`);
+      } else {
+        lines.push("", "Already up to date \u2014 nothing to add.");
+      }
+    } else {
+      lines.push(`Scaffolded GreatStore project root in ${root}.`);
+    }
+    lines.push(
+      "",
+      "Next steps:",
+      `  cd ${path6.relative(process.cwd(), root) || "."}`,
+      "  npm install",
+      "  gs init <component_name>     # add your first component",
+      ""
     );
+    process.stdout.write(lines.join("\n"));
     return;
   }
   const componentDir = path6.join(root, "components", name);
@@ -1156,6 +1196,7 @@ function initCommand(args) {
   process.stdout.write(
     [
       `Added component "${name}" at components/${name}/.`,
+      ...rootExisted && writtenRootFiles.length > 0 ? ["", `Also added to the project root: ${writtenRootFiles.join(", ")}`] : [],
       "",
       "Next steps:",
       ...rootExisted ? [] : [`  cd ${projectLabel}`, "  npm install"],
@@ -1171,11 +1212,7 @@ function hasRootScaffold(dir) {
 }
 function ensureRoot(root, rootExisted, force, opts) {
   fs6.mkdirSync(root, { recursive: true });
-  if (rootExisted) {
-    fs6.mkdirSync(path6.join(root, "components"), { recursive: true });
-    return;
-  }
-  if (!force) {
+  if (!rootExisted && !force) {
     const entries = fs6.readdirSync(root).filter((e) => e !== ".gsrc");
     if (entries.length > 0) {
       throw new Error(
@@ -1183,14 +1220,38 @@ function ensureRoot(root, rootExisted, force, opts) {
       );
     }
   }
-  for (const [relPath, content] of rootFiles({ store: opts.store })) {
+  const files = rootExisted ? existingRootFiles() : rootFiles({ store: opts.store });
+  const written = writeRootFiles(root, files, force);
+  fs6.mkdirSync(path6.join(root, "components"), { recursive: true });
+  return written;
+}
+function writeRootFiles(root, files, force) {
+  const written = [];
+  for (const [relPath, content] of files) {
     const full = path6.join(root, relPath);
     fs6.mkdirSync(path6.dirname(full), { recursive: true });
     if (force || !fs6.existsSync(full)) {
       fs6.writeFileSync(full, content);
+      written.push(relPath);
     }
   }
-  fs6.mkdirSync(path6.join(root, "components"), { recursive: true });
+  for (const link of ["CLAUDE.md", "GEMINI.md"]) {
+    const linkPath = path6.join(root, link);
+    if (force && pathExists(linkPath)) fs6.rmSync(linkPath);
+    if (!pathExists(linkPath)) {
+      fs6.symlinkSync("AGENTS.md", linkPath);
+      written.push(link);
+    }
+  }
+  return written;
+}
+function pathExists(p) {
+  try {
+    fs6.lstatSync(p);
+    return true;
+  } catch {
+    return false;
+  }
 }
 function ensureComponent(componentDir, name, force) {
   if (fs6.existsSync(componentDir) && !force) {
@@ -1206,40 +1267,25 @@ function ensureComponent(componentDir, name, force) {
     fs6.writeFileSync(path6.join(componentDir, relPath), content);
   }
 }
+function templateFiles(prefix, vars, exclude = /* @__PURE__ */ new Set()) {
+  const tree = loadTemplate();
+  return Object.entries(tree).filter(([rel]) => rel.startsWith(prefix)).map(([rel, content]) => [rel.slice(prefix.length), content]).filter(([dest]) => !exclude.has(dest)).map(([dest, content]) => [dest, applyTemplate(content, vars)]);
+}
 function rootFiles(opts) {
   if (!opts.store) {
     throw new Error("internal: rootFiles called without a store slug");
   }
-  return [
-    ["package.json", rootPackageJson()],
-    ["vite.config.ts", viteEditorConfig()],
-    ["tsconfig.json", rootTsconfig()],
-    [".gsrc", gsrc(opts.store)],
-    [".gitignore", gitignore()],
-    ["README.md", rootReadme()]
-  ];
+  return templateFiles("root/", { store: opts.store });
 }
-function componentFiles(name) {
-  return [
-    ["manifest.json", manifest(name)],
-    ["component.tsx", component(name)]
-  ];
+function existingRootFiles() {
+  return templateFiles("root/", {}, /* @__PURE__ */ new Set([".gsrc"]));
 }
-function manifest(name) {
-  return JSON.stringify(
-    {
-      name,
-      displayName: defaultDisplayName(name),
-      description: `Renders the ${name} widget.`,
-      displayMode: "inline",
-      inputSchema: {
-        type: "object",
-        properties: {}
-      }
-    },
-    null,
-    2
-  ) + "\n";
+function componentFiles(name) {
+  return templateFiles("component/", {
+    name,
+    pascalName: pascal(name),
+    displayName: defaultDisplayName(name)
+  });
 }
 function defaultDisplayName(name) {
   const words = name.split("_").filter(Boolean);
@@ -1247,161 +1293,6 @@ function defaultDisplayName(name) {
   const first = words[0];
   return first.charAt(0).toUpperCase() + first.slice(1) + (words.length > 1 ? " " + words.slice(1).join(" ") : "");
 }
-function component(name) {
-  return `import React from "react";
-
-interface Props {
-  // ---- Your tool args ----
-  // Add fields here matching manifest.json#inputSchema.properties.
-
-  // ---- GreatStore-injected lifecycle props (always present) ----
-  // Send text into the chat as if the shopper typed it.
-  onSendMessage: (text: string) => void;
-  // Chain into another remote-component tool by name.
-  onCallTool: (name: string, args: Record<string, unknown>) => void;
-  // Dismiss the host slot (over-input clears the overlay, fullscreen
-  // reverts the pane, inline is a no-op).
-  onClose: () => void;
-}
-
-export default function ${pascal(name)}(_props: Props): React.ReactElement {
-  return (
-    <div style={{ padding: "1rem", border: "1px solid #ddd", borderRadius: 8 }}>
-      <strong>${name}</strong> \u2014 hello from your component!
-    </div>
-  );
-}
-
-// ---- Async components (backend-backed, render-blocking data) ----
-// If this component must load data from a backend/API before it can
-// render correctly, make it async \u2014 don't render an empty shell and
-// fetch in a useEffect. Set "async": true in manifest.json and export
-// an async default. GreatStore waits for your promise (showing a normal
-// loading state, so you don't render your own placeholder), then renders
-// what it resolves to.
-//
-// A thrown error is a RETRY SIGNAL: the in-store AI sees it and usually
-// re-calls the tool. So only throw when a *different* call could help.
-//   1. await the backend call, then return the finished JSX.
-//   2. Validate the AI-passed props first and throw on bad input \u2014 the
-//      AI can fix the args and retry. (Don't validate the API's output
-//      and throw: the AI can't fix the backend, it'll just loop.)
-//   3. Broadcast a backend failure ONLY when retrying differently could
-//      succeed, and say what to change (e.g. empty search \u2192 "try a
-//      broader keyword"). For idempotent failures (500, timeout, missing
-//      record) re-running the same call changes nothing \u2014 render a
-//      graceful fallback instead of throwing.
-//
-//   export default async function ${pascal(name)}(props: Props) {
-//     if (!props.query?.trim()) throw new Error("missing required prop: query");
-//     const res = await fetch(\`/api/search?q=\${encodeURIComponent(props.query)}\`);
-//     if (res.ok) {
-//       const { results } = await res.json();
-//       if (results.length === 0)
-//         throw new Error(\`no results for "\${props.query}" \u2014 try a broader keyword\`);
-//       return <ul>{/* render results */}</ul>;
-//     }
-//     return <p>Couldn't load results right now.</p>; // idempotent: don't throw
-//   }
-//
-// Components that render purely from their props stay synchronous.
-`;
-}
-function viteEditorConfig() {
-  return `import { defineConfig } from "vite";
-import react from "@vitejs/plugin-react";
-
-// Real builds happen in \`gs build\` (one Vite invocation per
-// component, externals + runtime shim paths owned by the CLI). This
-// file exists only so editors / language servers can resolve the
-// React plugin when inspecting components/*/component.tsx.
-export default defineConfig({
-  plugins: [react()],
-});
-`;
-}
-function rootTsconfig() {
-  return JSON.stringify(
-    {
-      compilerOptions: {
-        target: "ES2022",
-        module: "ESNext",
-        moduleResolution: "Bundler",
-        jsx: "react-jsx",
-        lib: ["ES2022", "DOM"],
-        strict: true,
-        esModuleInterop: true,
-        skipLibCheck: true,
-        isolatedModules: true,
-        noEmit: true
-      },
-      include: ["components/**/component.tsx", "vite.config.ts"]
-    },
-    null,
-    2
-  ) + "\n";
-}
-function rootPackageJson() {
-  return JSON.stringify(
-    {
-      name: "greatstore-components",
-      version: "0.0.1",
-      private: true,
-      type: "module",
-      scripts: {
-        build: "gs build",
-        push: "gs build && gs push"
-      },
-      dependencies: {
-        react: "^19.0.0",
-        "react-dom": "^19.0.0"
-      },
-      devDependencies: {
-        "@types/react": "^19.0.0",
-        "@types/react-dom": "^19.0.0",
-        "@vitejs/plugin-react": "^4.3.0",
-        typescript: "^5.6.0",
-        vite: "^5.4.0"
-      }
-    },
-    null,
-    2
-  ) + "\n";
-}
-function gsrc(store) {
-  return JSON.stringify({ store }, null, 2) + "\n";
-}
-function gitignore() {
-  return [
-    "node_modules/",
-    "components/*/bundle.js",
-    "components/*/.gssync.json",
-    "*.tsbuildinfo",
-    ".DS_Store",
-    ""
-  ].join("\n");
-}
-function rootReadme() {
-  return `# GreatStore components
-
-Custom React components published to your GreatStore tenant. Each
-component lives in its own folder under \`components/\`.
-
-\`\`\`
-npm install
-gs init <component_name>      # add a new component
-gs build                      # builds every components/<name>/bundle.js
-gs push                       # uploads every changed component as a draft
-gs publish <component_name>   # promote a specific component to live
-\`\`\`
-
-- \`gs push\` (no args) hashes each component and only uploads the ones
-  that have changed since the last sync.
-- \`gs pull\` (no args) refreshes every remote component into
-  \`components/<name>/\`. Components with unsaved local edits are skipped
-  with a warning; pass \`--force\` to overwrite.
-`;
-}
 function pascal(name) {
   return name.split(/[_-]/).filter(Boolean).map((part) => part[0]?.toUpperCase() + part.slice(1)).join("");
 }
@@ -1677,11 +1568,11 @@ function readCache(home) {
   }
   return null;
 }
-function writeCache(home, cache) {
+function writeCache(home, cache2) {
   try {
     const file = cachePath(home);
     fs8.mkdirSync(path8.dirname(file), { recursive: true });
-    fs8.writeFileSync(file, JSON.stringify(cache));
+    fs8.writeFileSync(file, JSON.stringify(cache2));
   } catch {
   }
 }
@@ -1703,8 +1594,8 @@ function parseVer(v) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.0.22" : "0.0.0-dev";
-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.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 VERSION = true ? "0.0.24" : "0.0.0-dev";
+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.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${VERSION})
 
 Usage:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatstore/cli",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "CLI for authoring and shipping GreatStore custom components.",
   "license": "UNLICENSED",
   "type": "module",