@greatstore/cli 0.0.23 → 0.0.24

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 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

package/dist/cli.js

@@ -1166,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);
@@ -1188,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"],
@@ -1203,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(
@@ -1215,19 +1220,30 @@ 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);
     }
   }
   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);
+    if (!pathExists(linkPath)) {
+      fs6.symlinkSync("AGENTS.md", linkPath);
+      written.push(link);
+    }
   }
-  fs6.mkdirSync(path6.join(root, "components"), { recursive: true });
+  return written;
 }
 function pathExists(p) {
   try {
@@ -1251,12 +1267,9 @@ function ensureComponent(componentDir, name, force) {
     fs6.writeFileSync(path6.join(componentDir, relPath), content);
   }
 }
-function templateFiles(prefix, vars) {
+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),
-    applyTemplate(content, vars)
-  ]);
+  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) {
@@ -1264,6 +1277,9 @@ function rootFiles(opts) {
   }
   return templateFiles("root/", { store: opts.store });
 }
+function existingRootFiles() {
+  return templateFiles("root/", {}, /* @__PURE__ */ new Set([".gsrc"]));
+}
 function componentFiles(name) {
   return templateFiles("component/", {
     name,
@@ -1578,8 +1594,8 @@ function parseVer(v) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.0.23" : "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.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 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.23",
+  "version": "0.0.24",
   "description": "CLI for authoring and shipping GreatStore custom components.",
   "license": "UNLICENSED",
   "type": "module",