@vitrine-kit/vitrine 0.3.0 → 0.4.0

package/dist/index.js

@@ -18,7 +18,7 @@ function preflightNode(min = 20) {
   const major = Number(process.versions.node.split(".")[0]);
   if (Number.isFinite(major) && major < min) {
     throw new Error(
-      `[vitrine] \u043D\u0443\u0436\u0435\u043D Node >= ${min} (\u0442\u0435\u043A\u0443\u0449\u0438\u0439 ${process.versions.node}). \u0423\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0442\u0435 Node ${min} LTS: https://nodejs.org`
+      `[vitrine] Node >= ${min} required (current ${process.versions.node}). Install Node ${min} LTS: https://nodejs.org`
     );
   }
 }
@@ -46,7 +46,7 @@ function safeJoin(root, ...segs) {
   const target = resolve(base, ...segs);
   const rel = relative(base, target);
   if (rel.startsWith("..") || isAbsolute(rel)) {
-    throw new Error(`[vitrine] \u043F\u0443\u0442\u044C "${join(...segs)}" \u0432\u044B\u0445\u043E\u0434\u0438\u0442 \u0437\u0430 \u043F\u0440\u0435\u0434\u0435\u043B\u044B "${root}"`);
+    throw new Error(`[vitrine] path "${join(...segs)}" escapes "${root}"`);
   }
   return target;
 }
@@ -84,7 +84,7 @@ function replaceBetween(content, startMarker, endMarker, replacement) {
   const si = content.indexOf(startMarker);
   const ei = content.indexOf(endMarker);
   if (si === -1 || ei === -1 || ei < si) {
-    throw new Error(`[vitrine] \u043C\u0430\u0440\u043A\u0435\u0440\u044B "${startMarker}"/"${endMarker}" \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u044B`);
+    throw new Error(`[vitrine] markers "${startMarker}"/"${endMarker}" not found`);
   }
   const afterStartLine = content.indexOf("\n", si) + 1;
   const endLineStart = content.lastIndexOf("\n", ei) + 1;
@@ -121,25 +121,36 @@ function loadProject(root) {
 }
 
 // src/registry.ts
-import { existsSync as existsSync4 } from "fs";
-import { dirname as dirname3, join as join4, resolve as resolve4 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { dirname as dirname4, join as join5, resolve as resolve4 } from "path";
 import { featureManifestSchema } from "@vitrine-kit/contracts";
 
+// src/bundled-kit.ts
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname3, join as join3 } from "path";
+import { fileURLToPath } from "url";
+function bundledKitRoot() {
+  const distDir = dirname3(fileURLToPath(import.meta.url));
+  const candidate = join3(distDir, "..", "kit");
+  if (existsSync3(join3(candidate, "registry", "_index.json"))) return candidate;
+  return null;
+}
+
 // src/cache.ts
-import { cpSync, existsSync as existsSync3, rmSync } from "fs";
-import { join as join3, resolve as resolve3 } from "path";
+import { cpSync, existsSync as existsSync4, rmSync } from "fs";
+import { join as join4, resolve as resolve3 } from "path";
 function vitrineHome() {
   if (process.env.VITRINE_HOME) return resolve3(process.env.VITRINE_HOME);
   const home = process.env.USERPROFILE ?? process.env.HOME;
-  if (!home) throw new Error("[vitrine] \u043D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u0438\u0442\u044C \u0434\u043E\u043C\u0430\u0448\u043D\u0438\u0439 \u043A\u0430\u0442\u0430\u043B\u043E\u0433 (HOME/USERPROFILE)");
-  return join3(home, ".vitrine");
+  if (!home) throw new Error("[vitrine] could not determine the home directory (HOME/USERPROFILE)");
+  return join4(home, ".vitrine");
 }
 function cachePaths(home = vitrineHome()) {
   return {
     root: home,
-    registry: join3(home, "registry"),
-    templates: join3(home, "templates"),
-    meta: join3(home, "kit.json")
+    registry: join4(home, "registry"),
+    templates: join4(home, "templates"),
+    meta: join4(home, "kit.json")
   };
 }
 function readKitMeta(home = vitrineHome()) {
@@ -151,7 +162,7 @@ function writeKitMeta(home, meta) {
 `);
 }
 function readIndex(registryRoot) {
-  const file = join3(registryRoot, "_index.json");
+  const file = join4(registryRoot, "_index.json");
   return exists(file) ? readJson(file) : null;
 }
 function computeChangelog(oldIndex, newIndex) {
@@ -171,7 +182,7 @@ function computeChangelog(oldIndex, newIndex) {
   return entries;
 }
 function formatChangelog(entries) {
-  if (entries.length === 0) return "\u0431\u0435\u0437 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439 \u043D\u0430\u0431\u043E\u0440\u0430 \u0444\u0438\u0447";
+  if (entries.length === 0) return "no changes to the feature set";
   return entries.map((e) => {
     if (e.kind === "added") return `+ ${e.name}${e.to ? ` ${e.to}` : ""}`;
     if (e.kind === "removed") return `- ${e.name}`;
@@ -180,16 +191,16 @@ function formatChangelog(entries) {
 }
 function populateCache(fromDir, opts = {}) {
   const home = opts.home ?? vitrineHome();
-  const srcRegistry = join3(fromDir, "registry");
-  const srcTemplates = join3(fromDir, "templates");
-  if (!existsSync3(join3(srcRegistry, "_index.json"))) {
-    throw new Error(`[vitrine] \u0432 "${fromDir}" \u043D\u0435\u0442 registry/_index.json \u2014 \u044D\u0442\u043E \u043D\u0435 \u0434\u0435\u0440\u0435\u0432\u043E kit`);
+  const srcRegistry = join4(fromDir, "registry");
+  const srcTemplates = join4(fromDir, "templates");
+  if (!existsSync4(join4(srcRegistry, "_index.json"))) {
+    throw new Error(`[vitrine] "${fromDir}" has no registry/_index.json \u2014 not a kit tree`);
   }
   const paths = cachePaths(home);
   const oldIndex = readIndex(paths.registry);
   rmSync(paths.registry, { recursive: true, force: true });
   cpSync(srcRegistry, paths.registry, { recursive: true });
-  if (existsSync3(srcTemplates)) {
+  if (existsSync4(srcTemplates)) {
     rmSync(paths.templates, { recursive: true, force: true });
     cpSync(srcTemplates, paths.templates, { recursive: true });
   }
@@ -207,9 +218,9 @@ function populateCache(fromDir, opts = {}) {
 function findUpRegistry(start) {
   let dir = resolve4(start);
   for (; ; ) {
-    const candidate = join4(dir, "registry");
-    if (existsSync4(join4(candidate, "_index.json"))) return candidate;
-    const parent = dirname3(dir);
+    const candidate = join5(dir, "registry");
+    if (existsSync5(join5(candidate, "_index.json"))) return candidate;
+    const parent = dirname4(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -224,60 +235,62 @@ function resolveRegistryRoot(explicit) {
     home = null;
   }
   if (home) {
-    const cache = join4(home, "registry");
-    if (existsSync4(join4(cache, "_index.json"))) return cache;
+    const cache = join5(home, "registry");
+    if (existsSync5(join5(cache, "_index.json"))) return cache;
   }
   const dev = findUpRegistry(process.cwd());
   if (dev) return dev;
-  throw new Error('[vitrine] \u0440\u0435\u0435\u0441\u0442\u0440 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D. \u0417\u0430\u043F\u0443\u0441\u0442\u0438 "vitrine kit update" \u0438\u043B\u0438 \u0443\u043A\u0430\u0436\u0438 --registry.');
+  const bundled = bundledKitRoot();
+  if (bundled) return join5(bundled, "registry");
+  throw new Error('[vitrine] registry not found. Run "vitrine kit update" or pass --registry.');
 }
 function createRegistrySource(explicitRoot) {
   const root = resolveRegistryRoot(explicitRoot);
   const cache = /* @__PURE__ */ new Map();
-  const featureDir = (name) => join4(root, name);
-  const hasFeature = (name) => existsSync4(join4(featureDir(name), "feature.json"));
+  const featureDir = (name) => join5(root, name);
+  const hasFeature = (name) => existsSync5(join5(featureDir(name), "feature.json"));
   const loadManifest = (name) => {
     const cached = cache.get(name);
     if (cached) return cached;
-    const file = join4(featureDir(name), "feature.json");
-    if (!existsSync4(file)) throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0440\u0435\u0435\u0441\u0442\u0440\u0435`);
+    const file = join5(featureDir(name), "feature.json");
+    if (!existsSync5(file)) throw new Error(`[vitrine] feature "${name}" not found in the registry`);
     const manifest = featureManifestSchema.parse(JSON.parse(readText(file)));
     cache.set(name, manifest);
     return manifest;
   };
   const listFeatures2 = () => {
-    const index = JSON.parse(readText(join4(root, "_index.json")));
+    const index = JSON.parse(readText(join5(root, "_index.json")));
     return Object.keys(index.features ?? {});
   };
   return { root, featureDir, hasFeature, loadManifest, listFeatures: listFeatures2 };
 }
 
 // src/install.ts
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/transaction.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname4 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname5 } from "path";
 var FsTransaction = class {
   backups = [];
   snapshot(path) {
     if (this.backups.some((b) => b.path === path)) return;
-    if (existsSync5(path)) this.backups.push({ path, existed: true, prev: readFileSync2(path, "utf8") });
+    if (existsSync6(path)) this.backups.push({ path, existed: true, prev: readFileSync2(path, "utf8") });
     else this.backups.push({ path, existed: false });
   }
   write(path, content) {
     this.snapshot(path);
-    mkdirSync2(dirname4(path), { recursive: true });
+    mkdirSync2(dirname5(path), { recursive: true });
     writeFileSync2(path, content, "utf8");
   }
   remove(path) {
     this.snapshot(path);
-    if (existsSync5(path)) rmSync2(path);
+    if (existsSync6(path)) rmSync2(path);
   }
   rollback() {
     for (const b of [...this.backups].reverse()) {
       if (b.existed) writeFileSync2(b.path, b.prev, "utf8");
-      else if (existsSync5(b.path)) rmSync2(b.path);
+      else if (existsSync6(b.path)) rmSync2(b.path);
     }
     this.backups = [];
   }
@@ -326,7 +339,7 @@ function assertNoPascalCollisions(features) {
     const id = pascalCase(f.name);
     const prev = byPascal.get(id);
     if (prev && prev !== f.name) {
-      throw new Error(`[vitrine] \u0444\u0438\u0447\u0438 "${prev}" \u0438 "${f.name}" \u0434\u0430\u044E\u0442 \u043E\u0434\u0438\u043D \u0438\u0434\u0435\u043D\u0442\u0438\u0444\u0438\u043A\u0430\u0442\u043E\u0440 "${id}" \u2014 \u043F\u0435\u0440\u0435\u0438\u043C\u0435\u043D\u0443\u0439\u0442\u0435 \u043E\u0434\u043D\u0443`);
+      throw new Error(`[vitrine] features "${prev}" and "${f.name}" produce the same identifier "${id}" \u2014 rename one`);
     }
     byPascal.set(id, f.name);
   }
@@ -339,11 +352,13 @@ function renderSlotsFile(features) {
   );
   const calls = withSlots.map((f) => `  register${pascalCase(f.name)}Slots();`);
   return [
-    "// vitrine:generated \u2014 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u0441\u043B\u043E\u0442\u043E\u0432 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0445 \u0444\u0438\u0447. \u041D\u0435 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0432\u0440\u0443\u0447\u043D\u0443\u044E.",
+    "// vitrine:generated \u2014 slot registration for installed features. Do not edit by hand.",
+    "import { slotRegistry } from '@vitrine-kit/core';",
     ...imports,
     "",
     "export function registerSlots(): void {",
-    ...calls.length ? calls : ["  // \u043D\u0435\u0442 \u0444\u0438\u0447 \u0441\u043E \u0441\u043B\u043E\u0442\u0430\u043C\u0438"],
+    "  slotRegistry.clear();",
+    ...calls.length ? calls : ["  // no slot features"],
     "}",
     ""
   ].join("\n");
@@ -356,11 +371,13 @@ function renderPaymentsFile(features) {
   );
   const calls = withPayment.map((f) => `  register${pascalCase(f.name)}Provider();`);
   return [
-    "// vitrine:generated \u2014 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044F \u043F\u043B\u0430\u0442\u0451\u0436\u043D\u044B\u0445 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440\u043E\u0432 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0445 \u0444\u0438\u0447. \u041D\u0435 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0432\u0440\u0443\u0447\u043D\u0443\u044E.",
+    "// vitrine:generated \u2014 payment-provider registration for installed features. Do not edit by hand.",
+    "import { payments } from '@vitrine-kit/core';",
     ...imports,
     "",
     "export function registerPayments(): void {",
-    ...calls.length ? calls : ["  // \u043D\u0435\u0442 \u043F\u043B\u0430\u0442\u0451\u0436\u043D\u044B\u0445 \u0444\u0438\u0447"],
+    "  payments.clear();",
+    ...calls.length ? calls : ["  // no payment features"],
     "}",
     ""
   ].join("\n");
@@ -373,7 +390,7 @@ function renderBlueprintFile(features) {
   );
   const calls = withBp.map((f) => `  extend${pascalCase(f.name)}Blueprint(blueprint);`);
   return [
-    "// vitrine:generated \u2014 blueprint \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0445 \u0444\u0438\u0447. \u041D\u0435 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0432\u0440\u0443\u0447\u043D\u0443\u044E.",
+    "// vitrine:generated \u2014 blueprint of installed features. Do not edit by hand.",
     "import { createBlueprint } from '@vitrine-kit/payload-blueprint';",
     ...imports,
     "",
@@ -385,9 +402,9 @@ function renderBlueprintFile(features) {
   ].join("\n");
 }
 function renderClaudeFeaturesTable(features) {
-  if (features.length === 0) return "_\u0424\u0438\u0447\u0438 \u0435\u0449\u0451 \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u044B._";
+  if (features.length === 0) return "_No features installed yet._";
   const rows = features.slice().sort((a, b) => a.name.localeCompare(b.name)).map((f) => `| \`${f.name}\` | ${f.manifest.title} | ${f.version} |`).join("\n");
-  return ["| \u0424\u0438\u0447\u0430 | \u041E\u043F\u0438\u0441\u0430\u043D\u0438\u0435 | \u0412\u0435\u0440\u0441\u0438\u044F |", "|---|---|---|", rows].join("\n");
+  return ["| Feature | Description | Version |", "|---|---|---|", rows].join("\n");
 }
 function mergeEnvExample(existing, features) {
   const present = parseEnvKeys(existing);
@@ -439,7 +456,7 @@ function renderNeutralTheme() {
   };
   const lines = TOKEN_CSS_VARS.map((v) => `  ${v}: ${neutral[v] ?? "initial"};`).join("\n");
   return [
-    "/* vitrine: \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0442\u043E\u043A\u0435\u043D\u043E\u0432 \u043A\u043B\u0438\u0435\u043D\u0442\u0430. \u0414\u0438\u0437\u0430\u0439\u043D-\u0448\u0430\u0433 (vitrine design apply) \u043F\u0435\u0440\u0435\u043F\u0438\u0441\u044B\u0432\u0430\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u044D\u0442\u043E. */",
+    "/* vitrine: client token values. The design step (vitrine design apply) rewrites only this. */",
     ":root {",
     lines,
     "}",
@@ -448,14 +465,14 @@ function renderNeutralTheme() {
 }
 
 // src/feature-files.ts
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 function* eachFeatureFile(featDir, map) {
-  const src = join5(featDir, map.from);
+  const src = join6(featDir, map.from);
   if (!exists(src)) return;
   const rels = isDir(src) ? walkRelFiles(src) : [""];
   for (const rel of rels) {
-    const srcAbs = rel ? join5(src, rel) : src;
-    const repoRel = rel ? join5(map.to, rel) : map.to;
+    const srcAbs = rel ? join6(src, rel) : src;
+    const repoRel = rel ? join6(map.to, rel) : map.to;
     yield { srcAbs, repoRel, toRel: toPosix(repoRel) };
   }
 }
@@ -467,7 +484,7 @@ function resolveOrder(names, registry) {
   const visit = (name) => {
     if (seen.has(name)) return;
     if (!registry.hasFeature(name)) {
-      throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0440\u0435\u0435\u0441\u0442\u0440\u0435`);
+      throw new Error(`[vitrine] feature "${name}" not found in the registry`);
     }
     seen.add(name);
     const manifest = registry.loadManifest(name);
@@ -480,21 +497,21 @@ function resolveOrder(names, registry) {
 function validate(name, manifest, project) {
   if (!manifest.tier.includes(project.lock.tier)) {
     throw new Error(
-      `[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u0443\u0440\u043E\u0432\u0435\u043D\u044C "${project.lock.tier}" (\u0442\u043E\u043B\u044C\u043A\u043E ${manifest.tier.join(", ")})`
+      `[vitrine] feature "${name}" does not support tier "${project.lock.tier}" (only ${manifest.tier.join(", ")})`
     );
   }
   for (const conflict of manifest.conflicts ?? []) {
     if (project.lock.features[conflict]) {
-      throw new Error(`[vitrine] \u043A\u043E\u043D\u0444\u043B\u0438\u043A\u0442: "${name}" \u043D\u0435\u0441\u043E\u0432\u043C\u0435\u0441\u0442\u0438\u043C\u0430 \u0441 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u043E\u0439 "${conflict}"`);
+      throw new Error(`[vitrine] conflict: "${name}" is incompatible with the installed "${conflict}"`);
     }
   }
 }
 function copyFeatureFiles(project, name, manifest, registry, tx) {
   const featDir = registry.featureDir(name);
-  const originalsBase = join6(projectPaths(project.root).originals, `${name}@${manifest.kitVersion}`);
+  const originalsBase = join7(projectPaths(project.root).originals, `${name}@${manifest.kitVersion}`);
   for (const map of manifest.files) {
-    if (!exists(join6(featDir, map.from))) {
-      throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}": \u043D\u0435\u0442 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430 "${map.from}"`);
+    if (!exists(join7(featDir, map.from))) {
+      throw new Error(`[vitrine] feature "${name}": no source "${map.from}"`);
     }
     for (const file of eachFeatureFile(featDir, map)) {
       const content = readText(file.srcAbs);
@@ -581,19 +598,19 @@ function installFeatures(project, names, registry) {
 }
 function removeFeature(project, name, registry) {
   const removed = project.lock.features[name];
-  if (!removed) throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u0430`);
+  if (!removed) throw new Error(`[vitrine] feature "${name}" is not installed`);
   const manifest = registry.loadManifest(name);
   if (!manifest.removable) {
-    throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u0443\u0434\u0430\u043B\u044F\u0435\u043C\u0430 (removable: false)`);
+    throw new Error(`[vitrine] feature "${name}" is not removable (removable: false)`);
   }
   for (const other of Object.keys(project.lock.features)) {
     if (other === name) continue;
     const deps = registry.loadManifest(other).registryDependencies ?? [];
     if (deps.includes(name)) {
-      throw new Error(`[vitrine] \u043D\u0435\u043B\u044C\u0437\u044F \u0443\u0434\u0430\u043B\u0438\u0442\u044C "${name}": \u043E\u0442 \u043D\u0435\u0451 \u0437\u0430\u0432\u0438\u0441\u0438\u0442 "${other}"`);
+      throw new Error(`[vitrine] cannot remove "${name}": "${other}" depends on it`);
     }
   }
-  const originalsDir = join6(projectPaths(project.root).originals, `${name}@${removed.version}`);
+  const originalsDir = join7(projectPaths(project.root).originals, `${name}@${removed.version}`);
   const featDir = registry.featureDir(name);
   const targets = /* @__PURE__ */ new Set();
   if (isDir(originalsDir)) for (const rel of walkRelFiles(originalsDir)) targets.add(rel);
@@ -616,30 +633,30 @@ function removeFeature(project, name, registry) {
 
 // src/design.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync6, readdirSync as readdirSync2 } from "fs";
-import { delimiter, join as join7 } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync2 } from "fs";
+import { delimiter, join as join8 } from "path";
 import { TOKEN_CSS_VARS as TOKEN_CSS_VARS2 } from "@vitrine-kit/contracts";
-var DESIGN_HEADING = "## \u0418\u041D\u0421\u0422\u0420\u0423\u041A\u0426\u0418\u042F: \u043F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D \u0438\u0437 /design";
+var DESIGN_HEADING = "## INSTRUCTION: apply the design from /design";
 function findClaudeBin(explicit) {
   const pinned = explicit ?? process.env.VITRINE_CLAUDE_BIN;
   if (pinned) {
-    if (existsSync6(pinned)) return pinned;
-    throw new Error(`[vitrine] Claude Code \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D \u043F\u043E \u043F\u0443\u0442\u0438 "${pinned}"`);
+    if (existsSync7(pinned)) return pinned;
+    throw new Error(`[vitrine] Claude Code not found at path "${pinned}"`);
   }
   const names = process.platform === "win32" ? ["claude.cmd", "claude.exe", "claude.ps1", "claude"] : ["claude"];
   for (const dir of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {
     for (const name of names) {
-      const full = join7(dir, name);
-      if (existsSync6(full)) return full;
+      const full = join8(dir, name);
+      if (existsSync7(full)) return full;
     }
   }
   throw new Error(
-    "[vitrine] Claude Code CLI \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D \u0432 PATH. \u0423\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0442\u0435 \u0435\u0433\u043E (npm i -g @anthropic-ai/claude-code) \u0438\u043B\u0438 \u0443\u043A\u0430\u0436\u0438\u0442\u0435 \u043F\u0443\u0442\u044C \u0447\u0435\u0440\u0435\u0437 --bin / VITRINE_CLAUDE_BIN. design apply \u2014 \u043E\u0431\u0451\u0440\u0442\u043A\u0430 \u043D\u0430\u0434 Claude Code, \u0441\u0432\u043E\u0435\u0433\u043E \u043A\u043B\u044E\u0447\u0430 Anthropic \u043D\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442."
+    "[vitrine] Claude Code CLI not found in PATH. Install it (npm i -g @anthropic-ai/claude-code) or pass the path via --bin / VITRINE_CLAUDE_BIN. design apply is a wrapper over Claude Code; it needs no Anthropic key of its own."
   );
 }
 function designHasInput(root) {
-  const dir = join7(root, "design");
-  if (!existsSync6(dir)) return false;
+  const dir = join8(root, "design");
+  if (!existsSync7(dir)) return false;
   return readdirSync2(dir).some((entry) => !/^readme\.md$/i.test(entry));
 }
 function extractDesignInstruction(claudeMd) {
@@ -649,20 +666,20 @@ function extractDesignInstruction(claudeMd) {
   return claudeMd.slice(start, next === -1 ? void 0 : next).trim();
 }
 function buildDesignPrompt(project) {
-  const claudeMd = existsSync6(join7(project.root, "CLAUDE.md")) ? readText(join7(project.root, "CLAUDE.md")) : "";
+  const claudeMd = existsSync7(join8(project.root, "CLAUDE.md")) ? readText(join8(project.root, "CLAUDE.md")) : "";
   const instruction = extractDesignInstruction(claudeMd) ?? DESIGN_HEADING;
   const tokens = TOKEN_CSS_VARS2.map((v) => `  ${v}`).join("\n");
   return [
     instruction,
     "",
-    "\u041A\u043E\u043D\u0442\u0435\u043A\u0441\u0442 \u043F\u0440\u0438\u043C\u0435\u043D\u0435\u043D\u0438\u044F:",
-    "- \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u0434\u0438\u0437\u0430\u0439\u043D\u0430: \u043F\u0430\u043F\u043A\u0430 `design/` (\u044D\u043A\u0441\u043F\u043E\u0440\u0442 \u0438\u0437 Claude Design).",
-    "- \u0415\u0434\u0438\u043D\u0441\u0442\u0432\u0435\u043D\u043D\u044B\u0439 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u0443\u0435\u043C\u044B\u0439 \u0444\u0430\u0439\u043B: `theme/client.css` \u2014 \u0437\u0430\u0434\u0430\u0439\u0442\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F CSS-\u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0445.",
-    "- \u0417\u0430\u043C\u043A\u043D\u0443\u0442\u044B\u0439 \u043D\u0430\u0431\u043E\u0440 \u0438\u043C\u0451\u043D \u0442\u043E\u043A\u0435\u043D\u043E\u0432 (\u0434\u0440\u0443\u0433\u0438\u0445 \u043D\u0435 \u0432\u0432\u043E\u0434\u0438\u0442\u044C):",
+    "Application context:",
+    "- Design source: the `design/` folder (export from Claude Design).",
+    "- The only editable file: `theme/client.css` \u2014 set the CSS variable values.",
+    "- Closed set of token names (do not introduce others):",
     tokens,
     "",
-    "\u041D\u0415 \u0440\u0435\u0434\u0430\u043A\u0442\u0438\u0440\u043E\u0432\u0430\u0442\u044C: \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u044B, \u0430\u0434\u0430\u043F\u0442\u0435\u0440\u044B, \u0440\u043E\u0443\u0442\u044B, site.config, lib/*. \u0422\u043E\u043B\u044C\u043A\u043E \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F",
-    "\u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0445 \u0432 theme/client.css. \u0418\u0434\u0435\u043C\u043F\u043E\u0442\u0435\u043D\u0442\u043D\u043E\u0441\u0442\u044C: \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u044B\u0439 \u043F\u0440\u043E\u0433\u043E\u043D \u043D\u0435 \u043D\u0430\u043A\u0430\u043F\u043B\u0438\u0432\u0430\u0435\u0442 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u044F."
+    "Do NOT edit: components, adapters, routes, site.config, lib/*. Only the variable",
+    "values in theme/client.css. Idempotency: re-running does not accumulate changes."
   ].join("\n");
 }
 var defaultRunner = ({ bin, args, cwd }) => {
@@ -679,19 +696,19 @@ function planDesignApply(project, opts = {}) {
 function designApply(project, opts = {}, runner = defaultRunner) {
   if (!designHasInput(project.root)) {
     throw new Error(
-      "[vitrine] \u043F\u0430\u043F\u043A\u0430 design/ \u043F\u0443\u0441\u0442\u0430 \u2014 \u043F\u043E\u043B\u043E\u0436\u0438\u0442\u0435 \u044D\u043A\u0441\u043F\u043E\u0440\u0442 \u0438\u0437 Claude Design \u0438 \u043F\u043E\u0432\u0442\u043E\u0440\u0438\u0442\u0435."
+      "[vitrine] the design/ folder is empty \u2014 add an export from Claude Design and retry."
     );
   }
   const cmd = planDesignApply(project, opts);
   if (opts.dryRun) {
-    console.log(`[vitrine] dry-run: ${cmd.bin} -p <\u043F\u0440\u043E\u043C\u043F\u0442 ${cmd.prompt.length} \u0441\u0438\u043C\u0432.> --permission-mode acceptEdits`);
+    console.log(`[vitrine] dry-run: ${cmd.bin} -p <prompt ${cmd.prompt.length} chars> --permission-mode acceptEdits`);
     return 0;
   }
   return runner(cmd);
 }
 
 // src/doctor.ts
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 function runDoctor(project, registry) {
   const paths = projectPaths(project.root);
   const issues = [];
@@ -704,21 +721,21 @@ function runDoctor(project, registry) {
   const paymentsText = exists(paths.payments) ? readText(paths.payments) : "";
   for (const core of ["@vitrine-kit/contracts", "@vitrine-kit/core"]) {
     if (!deps[core]) {
-      add({ severity: "error", scope: "packages", message: `\u043D\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043C\u043E\u0441\u0442\u0438 ${core}`, fix: "\u0434\u043E\u0431\u0430\u0432\u044C\u0442\u0435 \u0432 package.json" });
+      add({ severity: "error", scope: "packages", message: `missing dependency ${core}`, fix: "add it to package.json" });
     }
   }
-  if (exists(paths.claude) && !readText(paths.claude).includes("\u0418\u041D\u0421\u0422\u0420\u0423\u041A\u0426\u0418\u042F: \u043F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D")) {
+  if (exists(paths.claude) && !readText(paths.claude).includes("INSTRUCTION: apply the design")) {
     add({
       severity: "warn",
       scope: "design",
-      message: "\u0432 CLAUDE.md \u043D\u0435\u0442 \u0431\u043B\u043E\u043A\u0430 \u0434\u0438\u0437\u0430\u0439\u043D-\u0438\u043D\u0441\u0442\u0440\u0443\u043A\u0446\u0438\u0438",
-      fix: "\u043E\u0431\u043D\u043E\u0432\u0438\u0442\u0435 CLAUDE.md (kit update \u043F\u0440\u0438\u043D\u043E\u0441\u0438\u0442 \u0441\u0432\u0435\u0436\u0443\u044E \u0438\u043D\u0441\u0442\u0440\u0443\u043A\u0446\u0438\u044E)"
+      message: "CLAUDE.md has no design-instruction block",
+      fix: "update CLAUDE.md (kit update brings a fresh instruction)"
     });
   }
   for (const [name, pin] of Object.entries(project.lock.features)) {
     const scope = `feature:${name}`;
     if (!registry.hasFeature(name)) {
-      add({ severity: "error", scope, message: `\u0444\u0438\u0447\u0430 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0440\u0435\u0435\u0441\u0442\u0440\u0435`, fix: "vitrine kit update" });
+      add({ severity: "error", scope, message: `feature not found in the registry`, fix: "vitrine kit update" });
       continue;
     }
     const manifest = registry.loadManifest(name);
@@ -726,19 +743,19 @@ function runDoctor(project, registry) {
       add({
         severity: "warn",
         scope,
-        message: `\u0432\u0435\u0440\u0441\u0438\u044F \u0432 \u0440\u0435\u043F\u043E ${pin.version}, \u0440\u0435\u0435\u0441\u0442\u0440 \u043F\u0440\u0435\u0434\u043B\u0430\u0433\u0430\u0435\u0442 ${manifest.kitVersion}`,
+        message: `repo version ${pin.version}, registry offers ${manifest.kitVersion}`,
         fix: `vitrine update ${name}`
       });
     }
     const featDir = registry.featureDir(name);
     for (const map of manifest.files) {
       for (const file of eachFeatureFile(featDir, map)) {
-        if (!exists(join8(project.root, file.repoRel))) {
+        if (!exists(join9(project.root, file.repoRel))) {
           add({
             severity: "error",
             scope,
-            message: `\u043D\u0435\u0442 \u0444\u0430\u0439\u043B\u0430 "${file.toRel}"`,
-            fix: `vitrine add ${name} (\u043F\u0435\u0440\u0435\u0443\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0442)`
+            message: `missing file "${file.toRel}"`,
+            fix: `vitrine add ${name} (reinstalls)`
           });
         }
       }
@@ -748,33 +765,33 @@ function runDoctor(project, registry) {
         add({
           severity: e.required ? "error" : "warn",
           scope,
-          message: `\u043D\u0435\u0442 \u043A\u043B\u044E\u0447\u0430 env "${e.key}"${e.required ? " (\u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u0435\u043D)" : ""}`,
-          fix: "\u0434\u043E\u0431\u0430\u0432\u044C\u0442\u0435 \u0432 .env.example/.env"
+          message: `missing env key "${e.key}"${e.required ? " (required)" : ""}`,
+          fix: "add it to .env.example/.env"
         });
       }
     }
     const need = [...Object.keys(manifest.corePackages ?? {}), ...(manifest.npm ?? []).map((s) => parseNpmSpec(s).name)];
     for (const dep of need) {
       if (!deps[dep]) {
-        add({ severity: "error", scope, message: `\u043D\u0435\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043C\u043E\u0441\u0442\u0438 ${dep}`, fix: `vitrine add ${name} (\u0434\u043E\u043C\u0435\u0440\u0436\u0438\u0442 deps)` });
+        add({ severity: "error", scope, message: `missing dependency ${dep}`, fix: `vitrine add ${name} (merges deps)` });
       }
     }
     if ((manifest.slots?.length ?? 0) > 0) {
       const fn = `register${pascalCase(name)}Slots`;
       if (!slotsText.includes(fn)) {
-        add({ severity: "error", scope, message: `lib/slots.ts \u043D\u0435 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442 ${fn}`, fix: `vitrine add ${name} (\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442 slots)` });
+        add({ severity: "error", scope, message: `lib/slots.ts does not call ${fn}`, fix: `vitrine add ${name} (regenerates slots)` });
       }
     }
     if (!configText.includes(`"${name}": true`)) {
-      add({ severity: "warn", scope, message: `\u0432 site.config \u043D\u0435\u0442 \u0444\u043B\u0430\u0433\u0430 features.${name}`, fix: `vitrine add ${name} (\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u0444\u043B\u0430\u0433\u0438)` });
+      add({ severity: "warn", scope, message: `site.config has no features.${name} flag`, fix: `vitrine add ${name} (regenerates flags)` });
     }
     if (manifest.payment) {
       const fn = `register${pascalCase(name)}Provider`;
       if (!paymentsText.includes(fn)) {
-        add({ severity: "error", scope, message: `lib/payments.ts \u043D\u0435 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442 ${fn}`, fix: `vitrine add ${name} (\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442 payments)` });
+        add({ severity: "error", scope, message: `lib/payments.ts does not call ${fn}`, fix: `vitrine add ${name} (regenerates payments)` });
       }
       if (!configText.includes(`payments: ${JSON.stringify(manifest.payment.provider)}`)) {
-        add({ severity: "warn", scope, message: `\u0432 site.config integrations.payments \u2260 "${manifest.payment.provider}"`, fix: `vitrine add ${name} (\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442 integrations)` });
+        add({ severity: "warn", scope, message: `site.config integrations.payments \u2260 "${manifest.payment.provider}"`, fix: `vitrine add ${name} (regenerates integrations)` });
       }
     }
   }
@@ -783,7 +800,7 @@ function runDoctor(project, registry) {
 
 // src/update.ts
 import { rmSync as rmSync3 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/merge.ts
 function splitLines(s) {
@@ -851,8 +868,8 @@ function merge3(base, ours, theirs, labels = {}) {
   const B = splitLines(base);
   const O = splitLines(ours);
   const T = splitLines(theirs);
-  const ourLabel = labels.ours ?? "ours (\u0440\u0435\u043F\u043E \u043A\u043B\u0438\u0435\u043D\u0442\u0430)";
-  const theirLabel = labels.theirs ?? "theirs (\u0440\u0435\u0435\u0441\u0442\u0440)";
+  const ourLabel = labels.ours ?? "ours (client repo)";
+  const theirLabel = labels.theirs ?? "theirs (registry)";
   if (B.length * Math.max(O.length, T.length) > MAX_LCS_CELLS) {
     if (ours === theirs || theirs === base) return { text: ours, clean: true, conflicts: 0 };
     if (ours === base) return { text: theirs, clean: true, conflicts: 0 };
@@ -921,19 +938,19 @@ function merge3(base, ours, theirs, labels = {}) {
 // src/update.ts
 function planUpdate(project, name, registry) {
   const pin = project.lock.features[name];
-  if (!pin) throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u0430`);
-  if (!registry.hasFeature(name)) throw new Error(`[vitrine] \u0444\u0438\u0447\u0430 "${name}" \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0440\u0435\u0435\u0441\u0442\u0440\u0435`);
+  if (!pin) throw new Error(`[vitrine] feature "${name}" is not installed`);
+  if (!registry.hasFeature(name)) throw new Error(`[vitrine] feature "${name}" not found in the registry`);
   const manifest = registry.loadManifest(name);
   const fromVersion = pin.version;
   const toVersion = manifest.kitVersion;
   const featDir = registry.featureDir(name);
-  const originalsBase = join9(projectPaths(project.root).originals, `${name}@${fromVersion}`);
+  const originalsBase = join10(projectPaths(project.root).originals, `${name}@${fromVersion}`);
   const files = [];
   for (const map of manifest.files) {
     for (const file of eachFeatureFile(featDir, map)) {
       const theirs = readText(file.srcAbs);
-      const oursPath = join9(project.root, file.repoRel);
-      const basePath = join9(originalsBase, file.repoRel);
+      const oursPath = join10(project.root, file.repoRel);
+      const basePath = join10(originalsBase, file.repoRel);
       const ours = exists(oursPath) ? readText(oursPath) : null;
       const base = exists(basePath) ? readText(basePath) : null;
       if (ours === null) {
@@ -961,8 +978,8 @@ function applyUpdate(project, plan, registry) {
   const manifest = registry.loadManifest(plan.feature);
   const featDir = registry.featureDir(plan.feature);
   const paths = projectPaths(project.root);
-  const newOriginals = join9(paths.originals, `${plan.feature}@${plan.toVersion}`);
-  const oldOriginals = join9(paths.originals, `${plan.feature}@${plan.fromVersion}`);
+  const newOriginals = join10(paths.originals, `${plan.feature}@${plan.toVersion}`);
+  const oldOriginals = join10(paths.originals, `${plan.feature}@${plan.fromVersion}`);
   const tx = new FsTransaction();
   try {
     for (const f of plan.files) {
@@ -987,17 +1004,17 @@ function applyUpdate(project, plan, registry) {
 function renderPlan(plan) {
   const head = plan.fromVersion === plan.toVersion ? `${plan.feature} @ ${plan.toVersion}` : `${plan.feature} ${plan.fromVersion} \u2192 ${plan.toVersion}`;
   const lines = plan.files.filter((f) => f.status !== "unchanged").map((f) => {
-    const mark = f.status === "conflict" ? "\u2717 \u043A\u043E\u043D\u0444\u043B\u0438\u043A\u0442" : f.status === "new" ? "+ \u043D\u043E\u0432\u044B\u0439  " : "~ \u0441\u043B\u0438\u044F\u043D\u0438\u0435";
-    return `  ${mark} ${f.to}${f.conflicts ? ` (\u043A\u043E\u043D\u0444\u043B\u0438\u043A\u0442\u043E\u0432: ${f.conflicts})` : ""}`;
+    const mark = f.status === "conflict" ? "\u2717 conflict" : f.status === "new" ? "+ new     " : "~ merge   ";
+    return `  ${mark} ${f.to}${f.conflicts ? ` (conflicts: ${f.conflicts})` : ""}`;
   });
-  return lines.length === 0 ? `${head}: \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439 \u043D\u0435\u0442` : [head, ...lines].join("\n");
+  return lines.length === 0 ? `${head}: no changes` : [head, ...lines].join("\n");
 }
 
 // src/commands.ts
 function requireProject() {
   const root = findProjectRoot();
   if (!root) {
-    throw new Error("[vitrine] \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D vitrine.json \u2014 \u044D\u0442\u043E \u043D\u0435 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u0439 \u043A\u043B\u0438\u0435\u043D\u0442\u0430 Vitrine");
+    throw new Error("[vitrine] vitrine.json not found \u2014 not a Vitrine client repository");
   }
   return loadProject(root);
 }
@@ -1037,32 +1054,34 @@ function diffFeatureCmd(name, registryRoot) {
 
 // src/init.ts
 import { readdirSync as readdirSync3 } from "fs";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
-// src/kit.ts
-var KIT_VERSION = "0.0.0";
+// src/kit-versions.generated.ts
+var KIT_VERSION = "0.4.0";
 var CONTRACTS_VERSION = "1.0.0";
 var CONTRACTS_RANGE = "^1.0.0";
-var CORE_RANGE = "^0.1.0";
-var BLUEPRINT_RANGE = "^0.1.0";
+var CORE_RANGE = "^0.2.0";
+var BLUEPRINT_RANGE = "^0.2.0";
+
+// src/kit.ts
 var REACT_RANGE = "^18.3.1";
 var CLIENT_REACT_RANGE = "^19.0.0";
 var NEXT_RANGE = "^15.1.0";
 var PAYLOAD_RANGE = "^3.0.0";
 
 // src/templates.ts
-import { existsSync as existsSync7 } from "fs";
-import { dirname as dirname5, join as join10 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { dirname as dirname6, join as join11 } from "path";
 function templatesRoot(registryRoot) {
-  return join10(dirname5(registryRoot), "templates");
+  return join11(dirname6(registryRoot), "templates");
 }
 function hasTemplate(root, name) {
-  return existsSync7(join10(root, name, "files"));
+  return existsSync8(join11(root, name, "files"));
 }
 function copyTemplate(root, name, destRoot) {
-  const filesDir = join10(root, name, "files");
+  const filesDir = join11(root, name, "files");
   const rels = walkRelFiles(filesDir);
-  for (const rel of rels) writeText(join10(destRoot, rel), readText(join10(filesDir, rel)));
+  for (const rel of rels) writeText(join11(destRoot, rel), readText(join11(filesDir, rel)));
   return rels;
 }
 
@@ -1077,7 +1096,7 @@ var PAYMENT_PROVIDER_FEATURES = [
 ];
 function suggestFeatures(tier, registry, backend = defaultBackend(tier)) {
   const core = ["catalog", "product-page", "seo"];
-  const shop = backend === "vendure" ? ["cart"] : ["cart", "checkout-stripe", "reviews"];
+  const shop = backend === "vendure" ? ["cart"] : ["cart", "checkout-stripe"];
   const desired = tier === "catalog" ? core : [...core, ...shop];
   return desired.filter((name) => registry.hasFeature(name));
 }
@@ -1160,44 +1179,44 @@ function clientPackageJson(name, backend) {
 function clientEnvExample(backend) {
   if (backend === "vendure") {
     return [
-      "# \u041E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u0435 \u043F\u0440\u043E\u0435\u043A\u0442\u0430.",
+      "# Project environment.",
       "",
-      "# \u0411\u0414. \u041F\u0443\u0441\u0442\u043E \u0432 dev \u2014 \u0432\u0441\u0442\u0440\u043E\u0435\u043D\u043D\u044B\u0439 SQLite (.vitrine/vendure.sqlite).",
+      "# DB. Empty in dev \u2014 built-in SQLite (.vitrine/vendure.sqlite).",
       "DATABASE_URL=",
       "",
-      "# Vendure Shop API (\u0432\u0438\u0442\u0440\u0438\u043D\u0430 \u2192 \u0441\u0435\u0440\u0432\u0435\u0440).",
+      "# Vendure Shop API (storefront \u2192 server).",
       "VENDURE_SHOP_API_URL=http://localhost:3001/shop-api",
       "",
-      "# \u0421\u0443\u043F\u0435\u0440\u0430\u0434\u043C\u0438\u043D Vendure (dev-\u0434\u0435\u0444\u043E\u043B\u0442 superadmin/superadmin; \u0441\u043C\u0435\u043D\u0438\u0442\u0435 \u0434\u043B\u044F \u043F\u0440\u043E\u0434\u0430).",
+      "# Vendure superadmin (dev default superadmin/superadmin; change it for prod).",
       "VENDURE_SUPERADMIN_USERNAME=",
       "VENDURE_SUPERADMIN_PASSWORD=",
       "VENDURE_COOKIE_SECRET=",
       "",
-      "# \u0411\u0430\u0437\u043E\u0432\u044B\u0439 URL \u0432\u0438\u0442\u0440\u0438\u043D\u044B.",
+      "# Storefront base URL.",
       "NEXT_PUBLIC_SITE_URL=http://localhost:3000",
       ""
     ].join("\n");
   }
   if (backend !== "payload") {
-    return "# \u041E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u0435 \u043F\u0440\u043E\u0435\u043A\u0442\u0430.\nDATABASE_URL=\n";
+    return "# Project environment.\nDATABASE_URL=\n";
   }
   return [
-    "# \u041E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u0435 \u043F\u0440\u043E\u0435\u043A\u0442\u0430.",
+    "# Project environment.",
     "",
-    "# \u0411\u0414. \u0414\u043B\u044F \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u0433\u043E dev \u043C\u043E\u0436\u043D\u043E \u043E\u0441\u0442\u0430\u0432\u0438\u0442\u044C \u043F\u0443\u0441\u0442\u044B\u043C \u2014 \u0431\u0443\u0434\u0435\u0442 SQLite-fallback (.vitrine/dev.sqlite).",
+    "# DB. For local dev you can leave it empty \u2014 a SQLite fallback is used (.vitrine/dev.sqlite).",
     "DATABASE_URL=",
     "",
-    "# \u0421\u0435\u043A\u0440\u0435\u0442 Payload (\u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u0435\u043D; \u0441\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0439\u0442\u0435 \u0441\u043B\u0443\u0447\u0430\u0439\u043D\u044B\u0439 \u0434\u043B\u044F \u043F\u0440\u043E\u0434\u0430).",
+    "# Payload secret (required; generate a random one for prod).",
     "PAYLOAD_SECRET=",
     "",
-    "# Dev-\u0430\u0434\u043C\u0438\u043D (\u0441\u043E\u0437\u0434\u0430\u0451\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E \u0432 dev \u043F\u0440\u0438 \u043F\u0443\u0441\u0442\u043E\u0439 \u0411\u0414; \u043F\u0430\u0440\u043E\u043B\u044C \u043F\u0435\u0447\u0430\u0442\u0430\u0435\u0442\u0441\u044F \u0432 \u043A\u043E\u043D\u0441\u043E\u043B\u044C).",
+    "# Dev admin (created only in dev when the DB is empty; the password is printed to the console).",
     "DEV_ADMIN_EMAIL=",
     "DEV_ADMIN_PASSWORD=",
     "",
-    "# \u0411\u0430\u0437\u043E\u0432\u044B\u0439 URL \u0441\u0430\u0439\u0442\u0430 (canonical, OG).",
+    "# Site base URL (canonical, OG).",
     "NEXT_PUBLIC_SITE_URL=http://localhost:3000",
     "",
-    "# \u041E\u0442\u043A\u043B\u044E\u0447\u0438\u0442\u044C SQLite-fallback \u0434\u0430\u0436\u0435 \u0432 dev (\u043B\u043E\u0432\u0438\u0442\u044C \u043E\u043F\u0435\u0447\u0430\u0442\u043A\u0438 \u043A\u043E\u043D\u0444\u0438\u0433\u0430):",
+    "# Disable the SQLite fallback even in dev (to catch config typos):",
     "# VITRINE_DB_STRICT=1",
     ""
   ].join("\n");
@@ -1207,13 +1226,13 @@ function clientReadme(name, backend, tier) {
     "```bash",
     "pnpm install",
     "cp .env.example .env",
-    "pnpm vendure   # Vendure-\u0441\u0435\u0440\u0432\u0435\u0440 (Shop API \u043D\u0430 :3001) \u2014 \u0432 \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u043E\u043C \u0442\u0435\u0440\u043C\u0438\u043D\u0430\u043B\u0435",
-    "pnpm dev       # \u0432\u0438\u0442\u0440\u0438\u043D\u0430 \u043D\u0430 :3000",
+    "pnpm vendure   # Vendure server (Shop API on :3001) \u2014 in a separate terminal",
+    "pnpm dev       # storefront on :3000",
     "```",
     "",
-    "\u0411\u0435\u0437 Postgres dev \u043F\u043E\u0434\u043D\u0438\u043C\u0430\u0435\u0442 \u0432\u0441\u0442\u0440\u043E\u0435\u043D\u043D\u044B\u0439 SQLite (`.vitrine/vendure.sqlite`) \u0438",
-    "populate-\u0441\u0438\u0434. \u0421\u0443\u043F\u0435\u0440\u0430\u0434\u043C\u0438\u043D \u2014 \u0438\u0437 `VENDURE_SUPERADMIN_*` (dev-\u0434\u0435\u0444\u043E\u043B\u0442",
-    "superadmin/superadmin; \u0441\u043C\u0435\u043D\u0438\u0442\u0435 \u0434\u043B\u044F \u043F\u0440\u043E\u0434\u0430)."
+    "Without Postgres, dev starts a built-in SQLite (`.vitrine/vendure.sqlite`) and",
+    "the populate seed. The superadmin comes from `VENDURE_SUPERADMIN_*` (dev default",
+    "superadmin/superadmin; change it for prod)."
   ].join("\n") : [
     "```bash",
     "pnpm install",
@@ -1221,69 +1240,69 @@ function clientReadme(name, backend, tier) {
     "pnpm dev",
     "```",
     "",
-    "- \u0412\u0438\u0442\u0440\u0438\u043D\u0430: http://localhost:3000",
-    "- \u0410\u0434\u043C\u0438\u043D\u043A\u0430: http://localhost:3000/admin",
+    "- Storefront: http://localhost:3000",
+    "- Admin: http://localhost:3000/admin",
     "",
-    "\u0411\u0435\u0437 Postgres dev \u043F\u043E\u0434\u043D\u0438\u043C\u0430\u0435\u0442 \u0432\u0441\u0442\u0440\u043E\u0435\u043D\u043D\u044B\u0439 SQLite (`.vitrine/dev.sqlite`), \u0437\u0430\u043F\u043E\u043B\u043D\u044F\u0435\u0442",
-    "\u0434\u0435\u043C\u043E-\u043A\u0430\u0442\u0430\u043B\u043E\u0433 (5 \u0442\u043E\u0432\u0430\u0440\u043E\u0432, 2 \u043A\u0430\u0442\u0435\u0433\u043E\u0440\u0438\u0438) \u0438 \u0437\u0430\u0432\u043E\u0434\u0438\u0442 dev-\u0430\u0434\u043C\u0438\u043D\u0430 (\u043B\u043E\u0433\u0438\u043D/\u043F\u0430\u0440\u043E\u043B\u044C \u043F\u0435\u0447\u0430\u0442\u0430\u044E\u0442\u0441\u044F",
-    "\u0432 \u043A\u043E\u043D\u0441\u043E\u043B\u044C \u043E\u0434\u0438\u043D \u0440\u0430\u0437). \u041E\u0442\u043A\u043B\u044E\u0447\u0438\u0442\u044C fallback \u0438 \u0432 dev \u2014 `VITRINE_DB_STRICT=1`."
+    "Without Postgres, dev starts a built-in SQLite (`.vitrine/dev.sqlite`), seeds a",
+    "demo catalog (5 products, 2 categories) and creates a dev admin (login/password printed",
+    "to the console once). Disable the fallback in dev too with `VITRINE_DB_STRICT=1`."
   ].join("\n");
-  const deploySecret = backend === "vendure" ? "export VENDURE_COOKIE_SECRET=...  # \u0441\u0435\u043A\u0440\u0435\u0442 cookie Vendure" : "export PAYLOAD_SECRET=...         # \u0441\u043B\u0443\u0447\u0430\u0439\u043D\u044B\u0439 \u0441\u0435\u043A\u0440\u0435\u0442 Payload";
+  const deploySecret = backend === "vendure" ? "export VENDURE_COOKIE_SECRET=...  # Vendure cookie secret" : "export PAYLOAD_SECRET=...         # random Payload secret";
   return `# ${name}
 
-\u041A\u043B\u0438\u0435\u043D\u0442\u0441\u043A\u0438\u0439 \u043F\u0440\u043E\u0435\u043A\u0442 \u043D\u0430 Vitrine. Backend: \`${backend}\`, \u0443\u0440\u043E\u0432\u0435\u043D\u044C: \`${tier}\`.
-Next.js + Tailwind; \u0444\u0438\u0447\u0438 \u0441\u043A\u043E\u043F\u0438\u0440\u043E\u0432\u0430\u043D\u044B \u0438\u0437 \u0440\u0435\u0435\u0441\u0442\u0440\u0430 Vitrine \u2014 \u0432\u044B \u0432\u043B\u0430\u0434\u0435\u0435\u0442\u0435 \u043A\u043E\u0434\u043E\u043C \u0438
-\u0441\u0442\u0438\u043B\u0438\u0437\u0443\u0435\u0442\u0435 \u0435\u0433\u043E \u0442\u043E\u043A\u0435\u043D\u0430\u043C\u0438 (\`theme/client.css\`), \u043D\u0435 \u043C\u0435\u043D\u044F\u044F \u043B\u043E\u0433\u0438\u043A\u0443.
+A client project on Vitrine. Backend: \`${backend}\`, tier: \`${tier}\`.
+Next.js + Tailwind; features are copied from the Vitrine registry \u2014 you own the code and
+style it with tokens (\`theme/client.css\`) without changing the logic.
 
-## 1. \u041F\u0440\u0435\u0434\u0443\u0441\u043B\u043E\u0432\u0438\u044F
+## 1. Prerequisites
 
-Node >= 20 (LTS) \u0438 \`pnpm\`. \u041F\u0430\u043A\u0435\u0442\u044B \`@vitrine-kit/*\` \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u044B \u0432 npm \u2014
-\u0442\u043E\u043A\u0435\u043D \u0434\u043B\u044F \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0438 \u043D\u0435 \u043D\u0443\u0436\u0435\u043D.
+Node >= 20 (LTS) and \`pnpm\`. The \`@vitrine-kit/*\` packages are public on npm \u2014
+no token is needed to install them.
 
-## 2. \u041B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u0437\u0430\u043F\u0443\u0441\u043A (zero-config)
+## 2. Local run (zero-config)
 
 ${run}
 
-## 3. \u041F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D \u043A\u043B\u0438\u0435\u043D\u0442\u0430
+## 3. Apply the client design
 
-1. \u041F\u043E\u043B\u043E\u0436\u0438\u0442\u0435 \u044D\u043A\u0441\u043F\u043E\u0440\u0442 \u0431\u0440\u0435\u043D\u0434\u0430 (Figma export, \u0441\u043A\u0440\u0438\u043D\u0448\u043E\u0442\u044B, \u0430\u0441\u0441\u0435\u0442\u044B) \u0432 \`/design\`.
-2. \`vitrine design apply\` \u2014 \u0418\u0418 \u0437\u0430\u0434\u0430\u0451\u0442 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0442\u043E\u043A\u0435\u043D\u043E\u0432 \u0432 \`theme/client.css\`
-   (\u043B\u043E\u0433\u0438\u043A\u0443/\u0434\u0430\u043D\u043D\u044B\u0435/\u0440\u043E\u0443\u0442\u0438\u043D\u0433/a11y \u043D\u0435 \u0442\u0440\u043E\u0433\u0430\u0435\u0442). \u0428\u0430\u0433 \u0438\u0434\u0435\u043C\u043F\u043E\u0442\u0435\u043D\u0442\u0435\u043D.
+1. Put the brand export (Figma export, screenshots, assets) in \`/design\`.
+2. \`vitrine design apply\` \u2014 the AI sets token values in \`theme/client.css\`
+   (doesn't touch logic/data/routing/a11y). The step is idempotent.
 
-## 4. \u0424\u0438\u0447\u0438: \u0434\u043E\u0431\u0430\u0432\u0438\u0442\u044C, \u0443\u0431\u0440\u0430\u0442\u044C, \u043F\u043E\u0441\u043C\u043E\u0442\u0440\u0435\u0442\u044C
+## 4. Features: add, remove, view
 
 \`\`\`bash
-vitrine list             # \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0435 + \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B\u0435
-vitrine add reviews      # \u0441\u043A\u043E\u043F\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0444\u0438\u0447\u0443: \u0444\u043B\u0430\u0433, \u0441\u043B\u043E\u0442\u044B, blueprint, env
-vitrine remove reviews   # \u0443\u0431\u0440\u0430\u0442\u044C (\u0435\u0441\u043B\u0438 \u0444\u0438\u0447\u0430 removable)
-vitrine design apply     # \u0441\u0442\u0438\u043B\u0438\u0437\u043E\u0432\u0430\u0442\u044C \u043D\u043E\u0432\u0443\u044E \u0444\u0438\u0447\u0443
+vitrine list             # installed + available
+vitrine add cart         # copy a feature: flag, slots, blueprint, env
+vitrine remove cart      # remove (if the feature is removable)
+vitrine design apply     # style the new feature
 \`\`\`
 
-\`add\` \u0438\u0434\u0435\u043C\u043F\u043E\u0442\u0435\u043D\u0442\u0435\u043D \u0438 \u0442\u0440\u0430\u043D\u0437\u0430\u043A\u0446\u0438\u043E\u043D\u0435\u043D (\u043E\u0442\u043A\u0430\u0442 \u043F\u0440\u0438 \u043E\u0448\u0438\u0431\u043A\u0435); \u043E\u0440\u0438\u0433\u0438\u043D\u0430\u043B\u044B \u0432\u0435\u0440\u0441\u0438\u0439 \u043F\u0438\u0448\u0443\u0442\u0441\u044F \u0432
-\`.vitrine/originals/\` \u2014 \u043E\u0441\u043D\u043E\u0432\u0430 \u0434\u043B\u044F 3-way merge \u043F\u0440\u0438 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0438.
+\`add\` is idempotent and transactional (rollback on error); version originals are written to
+\`.vitrine/originals/\` \u2014 the basis for 3-way merge on update.
 
-## 5. \u041E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u044F \u0438 \u043F\u0440\u043E\u0432\u0435\u0440\u043A\u0430
+## 5. Updates and checks
 
 \`\`\`bash
-vitrine kit update       # \u043E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u043A\u044D\u0448 \u0440\u0435\u0435\u0441\u0442\u0440\u0430/\u0448\u0430\u0431\u043B\u043E\u043D\u043E\u0432 \u0441 GitHub
-vitrine diff <feature>   # \u043F\u0440\u0435\u0434\u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u044F \u0444\u0438\u0447\u0438
-vitrine update [feature] # 3-way merge \u043D\u043E\u0432\u043E\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u0444\u0438\u0447\u0438 (\u0431\u0430\u0437\u0430 = \u0432\u0430\u0448 \u0441\u043D\u0430\u043F\u0448\u043E\u0442)
-vitrine doctor           # \u043A\u043E\u043D\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0441\u0442\u044C vitrine.json \u2194 \u0444\u0430\u0439\u043B\u044B \u2194 \u043F\u0430\u043A\u0435\u0442\u044B \u2194 env
+vitrine kit update       # update the local registry/templates cache from GitHub
+vitrine diff <feature>   # preview a feature update
+vitrine update [feature] # 3-way merge of the new feature version (base = your snapshot)
+vitrine doctor           # consistency: vitrine.json \u2194 files \u2194 packages \u2194 env
 \`\`\`
 
-\u041F\u0430\u043A\u0435\u0442\u044B \`@vitrine-kit/*\` \u0432\u0435\u0440\u0441\u0438\u043E\u043D\u0438\u0440\u0443\u044E\u0442\u0441\u044F \u043D\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043C\u043E: \u0444\u0438\u043A\u0441 \u0432 \`core\` \u043F\u043E\u0434\u043D\u0438\u043C\u0430\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E
-\`@vitrine-kit/core\`, \u0430 \`@vitrine-kit/contracts\` \u043E\u0441\u0442\u0430\u0451\u0442\u0441\u044F \u043D\u0430 \u0441\u0432\u043E\u0435\u0439 \u0441\u0442\u0430\u0431\u0438\u043B\u044C\u043D\u043E\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u2014
-\u043E\u0431\u043D\u043E\u0432\u043B\u044F\u0439\u0442\u0435 \u0432\u0435\u0440\u0441\u0438\u0438 \u0432 \`package.json\` \u0442\u043E\u0447\u0435\u0447\u043D\u043E.
+The \`@vitrine-kit/*\` packages are versioned independently: a fix in \`core\` bumps only
+\`@vitrine-kit/core\`, while \`@vitrine-kit/contracts\` stays at its stable version \u2014
+update versions in \`package.json\` selectively.
 
-## 6. \u0414\u0435\u043F\u043B\u043E\u0439 (VPS + Docker)
+## 6. Deploy (VPS + Docker)
 
 \`\`\`bash
 ${deploySecret}
 docker compose up --build
 \`\`\`
 
-Production \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0440\u0435\u0430\u043B\u044C\u043D\u044B\u0439 \`DATABASE_URL\` \u2014 \u0431\u0435\u0437 \u043D\u0435\u0433\u043E \u0441\u0442\u0430\u0440\u0442 \u043F\u0440\u0435\u0440\u044B\u0432\u0430\u0435\u0442\u0441\u044F
-(SQLite-fallback \u0442\u043E\u043B\u044C\u043A\u043E \u0432 dev).
+Production requires a real \`DATABASE_URL\` \u2014 without it the start aborts
+(the SQLite fallback is dev-only).
 `;
 }
 function scaffoldBase(opts) {
@@ -1294,10 +1313,10 @@ function scaffoldBase(opts) {
   const backendTemplate = `backend-${backend}`;
   if (hasTemplate(tRoot, backendTemplate)) copyTemplate(tRoot, backendTemplate, root);
   if (!baseCopied) {
-    writeText(join11(root, ".gitignore"), "node_modules/\n.next/\ndist/\n.env\n.env.local\n.vitrine/\n");
+    writeText(join12(root, ".gitignore"), "node_modules/\n.next/\ndist/\n.env\n.env.local\n.vitrine/\n");
   }
   writeText(
-    join11(root, "vitrine.json"),
+    join12(root, "vitrine.json"),
     `${JSON.stringify(
       { kitVersion: KIT_VERSION, contracts: CONTRACTS_VERSION, backend, tier, features: {} },
       null,
@@ -1306,7 +1325,7 @@ function scaffoldBase(opts) {
 `
   );
   writeText(
-    join11(root, "site.config.ts"),
+    join12(root, "site.config.ts"),
     `import type { SiteConfig } from '@vitrine-kit/contracts';
 
 export const siteConfig: SiteConfig = {
@@ -1320,90 +1339,90 @@ export const siteConfig: SiteConfig = {
   // vitrine:integrations:start
   integrations: {},
   // vitrine:integrations:end
-  i18n: { defaultLocale: 'ru', locales: ['ru'], currency: 'RUB' },
+  i18n: { defaultLocale: 'en', locales: ['en'], currency: 'USD' },
 };
 
 export default siteConfig;
 `
   );
   writeText(
-    join11(root, "CLAUDE.md"),
+    join12(root, "CLAUDE.md"),
     `# ${name}
 
-\u041F\u0440\u043E\u0435\u043A\u0442 \u043D\u0430 Vitrine. Backend: \`${backend}\`, \u0443\u0440\u043E\u0432\u0435\u043D\u044C: \`${tier}\`.
-\u042D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B \u2014 \u043E\u043F\u0435\u0440\u0430\u0446\u0438\u043E\u043D\u043D\u044B\u0439 \u0433\u0430\u0439\u0434 \u0434\u043B\u044F \u0418\u0418-\u0430\u0433\u0435\u043D\u0442\u0430 (Claude Code) \u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0430. \u0412\u0441\u0435 \u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0438 \u0441\u043E
-\u0441\u0442\u0430\u0440\u0442\u0435\u0440-\u043A\u0438\u0442\u043E\u043C \u0432\u044B\u043F\u043E\u043B\u043D\u044F\u044E\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 CLI \`vitrine\`; \u0433\u043E\u0442\u043E\u0432\u044B\u0435 \u043F\u043E\u0442\u043E\u043A\u0438 \u2014 \u0441\u043B\u044D\u0448-\u043A\u043E\u043C\u0430\u043D\u0434\u0430\u043C\u0438 \u0432 \`.claude/commands/\`.
+A Vitrine project. Backend: \`${backend}\`, tier: \`${tier}\`.
+This file is the operational guide for the AI agent (Claude Code) and the developer. All
+starter-kit operations go through the \`vitrine\` CLI; ready-made flows are the slash commands in \`.claude/commands/\`.
 
-## \u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0435 \u0444\u0438\u0447\u0438
+## Installed features
 <!-- vitrine:features:start -->
-_\u0424\u0438\u0447\u0438 \u0435\u0449\u0451 \u043D\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u044B._
+_No features installed yet._
 <!-- vitrine:features:end -->
 
-## \u041A\u043E\u043C\u0430\u043D\u0434\u044B vitrine CLI
+## vitrine CLI commands
 
-| \u041A\u043E\u043C\u0430\u043D\u0434\u0430 | \u041D\u0430\u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 | \u041A\u043E\u0433\u0434\u0430 \u0437\u0432\u0430\u0442\u044C | \u0424\u043B\u0430\u0433\u0438 |
+| Command | Purpose | When to use | Flags |
 |---|---|---|---|
-| \`vitrine list\` | \u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0435 \u0438 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B\u0435 \u0444\u0438\u0447\u0438 | \u043F\u0435\u0440\u0435\u0434 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u0435\u043C \u0444\u0438\u0447\u0438 | \u2014 |
-| \`vitrine add <features\u2026>\` | \u0421\u043A\u043E\u043F\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0444\u0438\u0447\u0443(\u0438): \u0444\u0430\u0439\u043B\u044B, \u0444\u043B\u0430\u0433, \u0441\u043B\u043E\u0442\u044B, blueprint, env, deps | \xAB\u0434\u043E\u0431\u0430\u0432\u044C \u0444\u0438\u0447\u0443 X\xBB | \`--registry\` |
-| \`vitrine remove <feature>\` | \u0423\u0431\u0440\u0430\u0442\u044C \u0444\u0438\u0447\u0443 (\u0435\u0441\u043B\u0438 \`removable\`) | \xAB\u0443\u0431\u0435\u0440\u0438 \u0444\u0438\u0447\u0443 X\xBB | \`--registry\` |
-| \`vitrine update [features\u2026]\` | \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0444\u0438\u0447\u0438 3-way merge (\u0431\u0435\u0437 \u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u2014 \u0432\u0441\u0435) | \u043F\u043E\u0441\u043B\u0435 \`kit update\` | \`--dry-run\`, \`--registry\` |
-| \`vitrine diff <feature>\` | \u041F\u0440\u0435\u0434\u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u044F (\u0431\u0435\u0437 \u0437\u0430\u043F\u0438\u0441\u0438) | \u043F\u0435\u0440\u0435\u0434 \`update\` | \`--registry\` |
-| \`vitrine doctor\` | \u041A\u043E\u043D\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0441\u0442\u044C: \`vitrine.json\` \u2194 \u0444\u0430\u0439\u043B\u044B \u2194 \u043F\u0430\u043A\u0435\u0442\u044B \u2194 env | \u043F\u043E\u0441\u043B\u0435 \u043F\u0440\u0430\u0432\u043E\u043A, \u043F\u0440\u0438 \u0441\u043E\u043C\u043D\u0435\u043D\u0438\u044F\u0445 | \`--registry\` |
-| \`vitrine design apply\` | \u041F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D \u0438\u0437 \`/design\` \u043A \u0442\u043E\u043A\u0435\u043D\u0430\u043C (\u0447\u0435\u0440\u0435\u0437 Claude Code) | \u043F\u043E\u0441\u043B\u0435 \`add\` \u0438\u043B\u0438 \u0441\u043C\u0435\u043D\u044B \u0431\u0440\u0435\u043D\u0434\u0430 | \`--bin\`, \`--dry-run\` |
-| \`vitrine kit update\` | \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u043A\u044D\u0448 \u0440\u0435\u0435\u0441\u0442\u0440\u0430/\u0448\u0430\u0431\u043B\u043E\u043D\u043E\u0432 \u0441 GitHub | \u043F\u0435\u0440\u0435\u0434 \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435\u043C \u0444\u0438\u0447 | \`--from\`, \`--version\`, \`--channel\` |
-| \`vitrine kit status\` | \u0412\u0435\u0440\u0441\u0438\u044F \u043A\u044D\u0448\u0430 vs \u043E\u0436\u0438\u0434\u0430\u0435\u043C\u0430\u044F CLI | \u0434\u0438\u0430\u0433\u043D\u043E\u0441\u0442\u0438\u043A\u0430 | \u2014 |
-| \`vitrine self-update\` | \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0441\u0430\u043C CLI | \u0440\u0435\u0434\u043A\u043E | \`--dry-run\` |
+| \`vitrine list\` | Installed and available features | before adding a feature | \u2014 |
+| \`vitrine add <features\u2026>\` | Copy feature(s): files, flag, slots, blueprint, env, deps | "add feature X" | \`--registry\` |
+| \`vitrine remove <feature>\` | Remove a feature (if \`removable\`) | "remove feature X" | \`--registry\` |
+| \`vitrine update [features\u2026]\` | Update features via 3-way merge (all if no arguments) | after \`kit update\` | \`--dry-run\`, \`--registry\` |
+| \`vitrine diff <feature>\` | Preview an update (without writing) | before \`update\` | \`--registry\` |
+| \`vitrine doctor\` | Consistency: \`vitrine.json\` \u2194 files \u2194 packages \u2194 env | after edits, when in doubt | \`--registry\` |
+| \`vitrine design apply\` | Apply the design from \`/design\` to tokens (via Claude Code) | after \`add\` or a rebrand | \`--bin\`, \`--dry-run\` |
+| \`vitrine kit update\` | Update the local registry/templates cache from GitHub | before updating features | \`--from\`, \`--version\`, \`--channel\` |
+| \`vitrine kit status\` | Cache version vs the CLI's expected one | diagnostics | \u2014 |
+| \`vitrine self-update\` | Update the CLI itself | rarely | \`--dry-run\` |
 
-\`init\` \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F \u043E\u0434\u0438\u043D \u0440\u0430\u0437 \u043F\u0440\u0438 \u0441\u043E\u0437\u0434\u0430\u043D\u0438\u0438 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044F (\u0432\u0438\u0437\u0430\u0440\u0434 \`vitrine init\`). \`add\`/\`update\`
-\u0438\u0434\u0435\u043C\u043F\u043E\u0442\u0435\u043D\u0442\u043D\u044B \u0438 \u0442\u0440\u0430\u043D\u0437\u0430\u043A\u0446\u0438\u043E\u043D\u043D\u044B (\u043E\u0442\u043A\u0430\u0442 \u043F\u0440\u0438 \u043E\u0448\u0438\u0431\u043A\u0435); \u043E\u0440\u0438\u0433\u0438\u043D\u0430\u043B\u044B \u0432\u0435\u0440\u0441\u0438\u0439 \u043F\u0438\u0448\u0443\u0442\u0441\u044F \u0432 \`.vitrine/originals/\`
-\u2014 \u0431\u0430\u0437\u0430 \u0434\u043B\u044F 3-way merge.
+\`init\` runs once when the repository is created (the \`vitrine init\` wizard). \`add\`/\`update\`
+are idempotent and transactional (rollback on error); version originals are written to \`.vitrine/originals/\`
+\u2014 the base for 3-way merge.
 
-## \u0422\u0438\u043F\u043E\u0432\u044B\u0435 \u0441\u0446\u0435\u043D\u0430\u0440\u0438\u0438
+## Common scenarios
 
-- **\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0430 \u043F\u0440\u043E\u0435\u043A\u0442\u0430** \u2192 \`/setup\`: \u0437\u0430\u0432\u0438\u0441\u0438\u043C\u043E\u0441\u0442\u0438, GitHub PAT, \`.env\`, \u0437\u0430\u043F\u0443\u0441\u043A dev-\u0441\u0435\u0440\u0432\u0435\u0440\u0430.
-- **\u0414\u043E\u0431\u0430\u0432\u0438\u0442\u044C \u0438 \u0441\u0442\u0438\u043B\u0438\u0437\u043E\u0432\u0430\u0442\u044C \u0444\u0438\u0447\u0443** \u2192 \`/add-feature <\u0438\u043C\u044F>\`: \`list\` \u2192 \`add\` \u2192 \`design apply\` \u2192 \u043F\u0440\u043E\u0432\u0435\u0440\u043A\u0430.
-- **\u041F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C/\u043E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D** \u2192 \`/design\`: \u043F\u043E\u043B\u043E\u0436\u0438\u0442\u044C \u044D\u043A\u0441\u043F\u043E\u0440\u0442 \u0432 \`/design\`, \`design apply\`.
-- **\u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0444\u0438\u0447\u0438** \u2192 \`/update\`: \`kit update\` \u2192 \`diff\` \u2192 \`update\` \u2192 \u0440\u0430\u0437\u0440\u0443\u043B\u0438\u0442\u044C \u043A\u043E\u043D\u0444\u043B\u0438\u043A\u0442\u044B \u2192 \`doctor\`.
-- **\u041F\u0440\u043E\u0432\u0435\u0440\u0438\u0442\u044C \u043A\u043E\u043D\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0441\u0442\u044C** \u2192 \`/doctor\`.
+- **Project setup** \u2192 \`/setup\`: dependencies, \`.env\`, start the dev server.
+- **Add and style a feature** \u2192 \`/add-feature <name>\`: \`list\` \u2192 \`add\` \u2192 \`design apply\` \u2192 check.
+- **Apply/update the design** \u2192 \`/design\`: put the export in \`/design\`, \`design apply\`.
+- **Update features** \u2192 \`/update\`: \`kit update\` \u2192 \`diff\` \u2192 \`update\` \u2192 resolve conflicts \u2192 \`doctor\`.
+- **Check consistency** \u2192 \`/doctor\`.
 
-\u041F\u043E\u043B\u043D\u044B\u0439 \u0433\u0430\u0439\u0434 \u0434\u043B\u044F \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0430 \u2014 \u0432 \`README.md\`.
+The full human guide is in \`README.md\`.
 
-## \u0418\u041D\u0421\u0422\u0420\u0423\u041A\u0426\u0418\u042F: \u043F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D \u0438\u0437 /design
-\u0412\u0445\u043E\u0434: \u0432\u0441\u0451 \u0432 \`/design\`.
-\u0417\u0430\u0434\u0430\u0447\u0430: \u0438\u0437\u0432\u043B\u0435\u0447\u044C \u0432\u0438\u0437\u0443\u0430\u043B\u044C\u043D\u044B\u0439 \u044F\u0437\u044B\u043A (\u043F\u0430\u043B\u0438\u0442\u0440\u0430, \u0442\u0438\u043F\u043E\u0433\u0440\u0430\u0444\u0438\u043A\u0430, \u043E\u0442\u0441\u0442\u0443\u043F\u044B, \u0440\u0430\u0434\u0438\u0443\u0441\u044B, \u0442\u0435\u043D\u0438,
-\u0432\u0438\u0434 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u044B\u0445 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043E\u0432) \u0438 \u043F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u043A \u043F\u0440\u043E\u0435\u043A\u0442\u0443.
-\u041F\u0440\u0438\u043C\u0435\u043D\u044F\u0442\u044C \u0442\u0430\u043A:
-  1) \u0437\u0430\u0434\u0430\u0442\u044C \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0442\u043E\u043A\u0435\u043D\u043E\u0432 \u0432 \`theme/client.css\` \u2014 \u043E\u0441\u043D\u043E\u0432\u043D\u043E\u0439 \u0440\u044B\u0447\u0430\u0433;
-  2) \u0442\u043E\u043B\u044C\u043A\u043E \u0435\u0441\u043B\u0438 \u0442\u043E\u043A\u0435\u043D \u043D\u0435 \u0432\u044B\u0440\u0430\u0436\u0430\u0435\u0442 \u043D\u0443\u0436\u043D\u043E\u0435 \u2014 \u0434\u043E\u0431\u0430\u0432\u0438\u0442\u044C \u043F\u0440\u0435\u0437\u0435\u043D\u0442\u0430\u0446\u0438\u043E\u043D\u043D\u044B\u0435 \u043A\u043B\u0430\u0441\u0441\u044B
-     \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u043C\u0443 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u0443, \u041D\u0415 \u043C\u0435\u043D\u044F\u044F \u0435\u0433\u043E \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443.
-\u041D\u0415 \u043C\u0435\u043D\u044F\u0442\u044C: \u043B\u043E\u0433\u0438\u043A\u0443 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043E\u0432, \u0432\u044B\u0431\u043E\u0440\u043A\u0443 \u0434\u0430\u043D\u043D\u044B\u0445, \u0432\u044B\u0437\u043E\u0432\u044B \u0430\u0434\u0430\u043F\u0442\u0435\u0440\u0430, \u0440\u043E\u0443\u0442\u0438\u043D\u0433,
-a11y-\u0440\u043E\u043B\u0438/\u043B\u0435\u0439\u0431\u043B\u044B, \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u044B\u0435 \u043F\u0440\u043E\u043F\u0441\u044B. \u0422\u043E\u043A\u0435\u043D\u044B \u2014 \u044D\u0442\u043E \u0438\u043D\u0442\u0435\u0440\u0444\u0435\u0439\u0441.
-\u0415\u0441\u043B\u0438 \u0434\u0438\u0437\u0430\u0439\u043D \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0438\u043D\u043E\u0439 \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u044B \u0441\u0435\u043A\u0446\u0438\u0438 \u2014 \u0441\u043E\u0437\u0434\u0430\u0442\u044C override \u0441\u0435\u043A\u0446\u0438\u0438 \u0432 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u0438
-(\u043A\u043E\u043C\u043F\u043E\u0437\u0438\u0446\u0438\u044F), \u0430 \u043D\u0435 \u043F\u0440\u0430\u0432\u0438\u0442\u044C \u043E\u0431\u0449\u0438\u0439 wireframe.
-\u0428\u0430\u0433 \u0438\u0434\u0435\u043C\u043F\u043E\u0442\u0435\u043D\u0442\u0435\u043D: \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u044B\u0439 \u043F\u0440\u043E\u0433\u043E\u043D \u0441\u0445\u043E\u0434\u0438\u0442\u0441\u044F, \u043D\u0435 \u043D\u0430\u043A\u0430\u043F\u043B\u0438\u0432\u0430\u0435\u0442 \u043C\u0443\u0441\u043E\u0440.
+## INSTRUCTION: apply the design from /design
+Input: everything in \`/design\`.
+Task: extract the visual language (palette, typography, spacing, radii, shadows,
+the look of specific components) and apply it to the project.
+Apply it like this:
+  1) set token values in \`theme/client.css\` \u2014 the main lever;
+  2) only if a token can't express what's needed \u2014 add presentational classes
+     to a specific component WITHOUT changing its structure.
+Do NOT change: component logic, data fetching, adapter calls, routing,
+a11y roles/labels, public props. Tokens are the interface.
+If the design requires a different section structure \u2014 create a section override in the repo
+(composition) rather than editing the shared wireframe.
+The step is idempotent: re-running converges and doesn't accumulate cruft.
 
-## \u0413\u0440\u0430\u043D\u0438\u0446\u044B (\u0447\u0442\u043E \u0430\u0433\u0435\u043D\u0442\u0443 \u043D\u0435\u043B\u044C\u0437\u044F \u0442\u0440\u043E\u0433\u0430\u0442\u044C)
-- **\u0413\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u043C\u044B\u0435/\u0443\u043F\u0440\u0430\u0432\u043B\u044F\u0435\u043C\u044B\u0435 \u0444\u0430\u0439\u043B\u044B \u2014 \u0440\u0443\u043A\u0430\u043C\u0438 \u043D\u0435 \u043F\u0440\u0430\u0432\u0438\u0442\u044C** (CLI \u043F\u0435\u0440\u0435\u0437\u0430\u0442\u0440\u0451\u0442 \u0438\u0437 \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u044F):
-  \`lib/slots.ts\`, \`lib/payments.ts\`, \`lib/blueprint.ts\`, \u0443\u043F\u0440\u0430\u0432\u043B\u044F\u0435\u043C\u044B\u0435 \u0440\u0435\u0433\u0438\u043E\u043D\u044B \`site.config.ts\`
-  (\`features\`/\`integrations\`), \`vitrine.json\`, \u0442\u0430\u0431\u043B\u0438\u0446\u0430 \u0444\u0438\u0447 \u0432 \u044D\u0442\u043E\u043C \`CLAUDE.md\`, \`.env*\`.
-  \u041D\u0430\u0431\u043E\u0440 \u0444\u0438\u0447/\u0438\u043D\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0439 \u043C\u0435\u043D\u044F\u0435\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 \`vitrine add/remove\`, \u0430 \u043D\u0435 \u043F\u0440\u0430\u0432\u043A\u043E\u0439 \u0444\u0430\u0439\u043B\u043E\u0432.
-- **\u0414\u0438\u0437\u0430\u0439\u043D \u2014 \u0442\u043E\u043B\u044C\u043A\u043E \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0442\u043E\u043A\u0435\u043D\u043E\u0432** \u0432 \`theme/client.css\` (\u0447\u0435\u0440\u0435\u0437 \`vitrine design apply\`):
-  \u043B\u043E\u0433\u0438\u043A\u0443/\u0434\u0430\u043D\u043D\u044B\u0435/\u0440\u043E\u0443\u0442\u0438\u043D\u0433/a11y/\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043E\u0432 \u043D\u0435 \u043C\u0435\u043D\u044F\u0442\u044C.
-- **\u041A\u043E\u043D\u0442\u0440\u0430\u043A\u0442\u044B \u0440\u0430\u0441\u0448\u0438\u0440\u044F\u044E\u0442\u0441\u044F \u0430\u0434\u0434\u0438\u0442\u0438\u0432\u043D\u043E** (\`@vitrine-kit/contracts\`): \u043B\u043E\u043C\u0430\u0442\u044C \u0444\u043E\u0440\u043C\u0443 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044E\u0449\u0438\u0445 \u043F\u043E\u043B\u0435\u0439 \u043D\u0435\u043B\u044C\u0437\u044F.
-- **\u041A\u043E\u043C\u043C\u0438\u0442\u044B \u0434\u0435\u043B\u0430\u0435\u0442 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044C** \u2014 \u043D\u0435 \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0439 \`git commit\`/\`git push\` \u0431\u0435\u0437 \u044F\u0432\u043D\u043E\u0439 \u043F\u0440\u043E\u0441\u044C\u0431\u044B.
+## Boundaries (what the agent must not touch)
+- **Generated/managed files \u2014 do not edit by hand** (the CLI overwrites them from state):
+  \`lib/slots.ts\`, \`lib/payments.ts\`, \`lib/blueprint.ts\`, the managed regions of \`site.config.ts\`
+  (\`features\`/\`integrations\`), \`vitrine.json\`, the feature table in this \`CLAUDE.md\`, \`.env*\`.
+  The set of features/integrations is changed via \`vitrine add/remove\`, not by editing files.
+- **Design \u2014 token values only** in \`theme/client.css\` (via \`vitrine design apply\`):
+  don't change logic/data/routing/a11y/component structure.
+- **Contracts are extended additively** (\`@vitrine-kit/contracts\`): you must not break the shape of existing fields.
+- **The user makes commits** \u2014 don't run \`git commit\`/\`git push\` without an explicit request.
 `
   );
-  writeText(join11(root, "README.md"), clientReadme(name, backend, tier));
-  writeText(join11(root, "lib", "slots.ts"), renderSlotsFile([]));
-  writeText(join11(root, "lib", "blueprint.ts"), renderBlueprintFile([]));
-  writeText(join11(root, "theme", "client.css"), renderNeutralTheme());
-  writeText(join11(root, ".env.example"), clientEnvExample(backend));
-  writeText(join11(root, "package.json"), `${JSON.stringify(clientPackageJson(name, backend), null, 2)}
+  writeText(join12(root, "README.md"), clientReadme(name, backend, tier));
+  writeText(join12(root, "lib", "slots.ts"), renderSlotsFile([]));
+  writeText(join12(root, "lib", "blueprint.ts"), renderBlueprintFile([]));
+  writeText(join12(root, "theme", "client.css"), renderNeutralTheme());
+  writeText(join12(root, ".env.example"), clientEnvExample(backend));
+  writeText(join12(root, "package.json"), `${JSON.stringify(clientPackageJson(name, backend), null, 2)}
 `);
 }
 function initProject(opts) {
   if (exists(opts.root) && readdirSync3(opts.root).length > 0) {
-    throw new Error(`[vitrine] \u043A\u0430\u0442\u0430\u043B\u043E\u0433 "${opts.root}" \u043D\u0435 \u043F\u0443\u0441\u0442\u043E\u0439`);
+    throw new Error(`[vitrine] directory "${opts.root}" is not empty`);
   }
   scaffoldBase(opts);
   const project = loadProject(opts.root);
@@ -1412,9 +1431,9 @@ function initProject(opts) {
 
 // src/kit-update.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync8, mkdtempSync, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
+import { existsSync as existsSync9, mkdtempSync, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
 import { tmpdir } from "os";
-import { join as join12, resolve as resolve5 } from "path";
+import { join as join13, resolve as resolve5 } from "path";
 var REPO = "vitrine-kit/vitrine";
 function hasBin(bin) {
   const probe = process.platform === "win32" ? "where" : "which";
@@ -1422,27 +1441,27 @@ function hasBin(bin) {
 }
 function acquireFromGh(version) {
   if (!hasBin("gh")) {
-    throw new Error("[vitrine] \u0434\u043B\u044F \u0441\u0435\u0442\u0435\u0432\u043E\u0433\u043E \u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u044F \u043D\u0443\u0436\u0435\u043D gh (GitHub CLI), \u043B\u0438\u0431\u043E \u0443\u043A\u0430\u0436\u0438\u0442\u0435 --from <dir>");
+    throw new Error("[vitrine] network update needs gh (GitHub CLI), or pass --from <dir>");
   }
   if (!hasBin("tar")) {
-    throw new Error("[vitrine] \u0434\u043B\u044F \u0440\u0430\u0441\u043F\u0430\u043A\u043E\u0432\u043A\u0438 \u043D\u0443\u0436\u0435\u043D tar, \u043B\u0438\u0431\u043E \u0443\u043A\u0430\u0436\u0438\u0442\u0435 --from <dir>");
+    throw new Error("[vitrine] unpacking needs tar, or pass --from <dir>");
   }
-  const tmp = mkdtempSync(join12(tmpdir(), "vitrine-kit-"));
+  const tmp = mkdtempSync(join13(tmpdir(), "vitrine-kit-"));
   const dl = spawnSync2(
     "gh",
     ["release", "download", ...version ? [version] : [], "--repo", REPO, "--archive=tar.gz", "--dir", tmp, "--clobber"],
     { stdio: "inherit" }
   );
   if (dl.status !== 0) {
-    throw new Error("[vitrine] gh release download \u043D\u0435 \u0443\u0434\u0430\u043B\u0441\u044F (\u043F\u0440\u043E\u0432\u0435\u0440\u044C\u0442\u0435 \u0434\u043E\u0441\u0442\u0443\u043F/\u0430\u0432\u0442\u043E\u0440\u0438\u0437\u0430\u0446\u0438\u044E: gh auth status, \u043F\u0440\u0438 \u043D\u0435\u043E\u0431\u0445\u043E\u0434\u0438\u043C\u043E\u0441\u0442\u0438 gh auth login)");
+    throw new Error("[vitrine] gh release download failed (check access/auth: gh auth status, and gh auth login if needed)");
   }
   const tarball = readdirSync4(tmp).find((f) => f.endsWith(".tar.gz"));
-  if (!tarball) throw new Error("[vitrine] release-tarball \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D \u043F\u043E\u0441\u043B\u0435 \u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0438");
-  if (spawnSync2("tar", ["-xzf", join12(tmp, tarball), "-C", tmp], { stdio: "inherit" }).status !== 0) {
-    throw new Error("[vitrine] \u0440\u0430\u0441\u043F\u0430\u043A\u043E\u0432\u043A\u0430 tarball \u043D\u0435 \u0443\u0434\u0430\u043B\u0430\u0441\u044C");
+  if (!tarball) throw new Error("[vitrine] release tarball not found after download");
+  if (spawnSync2("tar", ["-xzf", join13(tmp, tarball), "-C", tmp], { stdio: "inherit" }).status !== 0) {
+    throw new Error("[vitrine] tarball extraction failed");
   }
-  const root = readdirSync4(tmp).map((f) => join12(tmp, f)).find((p2) => statSync2(p2).isDirectory() && existsSync8(join12(p2, "registry", "_index.json")));
-  if (!root) throw new Error("[vitrine] \u0432 \u0440\u0430\u0441\u043F\u0430\u043A\u043E\u0432\u0430\u043D\u043D\u043E\u043C tarball \u043D\u0435\u0442 registry/_index.json");
+  const root = readdirSync4(tmp).map((f) => join13(tmp, f)).find((p2) => statSync2(p2).isDirectory() && existsSync9(join13(p2, "registry", "_index.json")));
+  if (!root) throw new Error("[vitrine] the unpacked tarball has no registry/_index.json");
   return root;
 }
 function kitUpdate(opts = {}) {
@@ -1451,7 +1470,7 @@ function kitUpdate(opts = {}) {
 }
 function kitStatus(home = vitrineHome()) {
   const meta = readKitMeta(home);
-  const idxFile = join12(cachePaths(home).registry, "_index.json");
+  const idxFile = join13(cachePaths(home).registry, "_index.json");
   const idx = exists(idxFile) ? readJson(idxFile) : null;
   return {
     cached: meta !== null,
@@ -1477,93 +1496,93 @@ function selfUpdate(opts = {}) {
 var pkg = JSON.parse(readFileSync3(new URL("../package.json", import.meta.url), "utf8"));
 var program = new Command();
 program.name("vitrine").description("Vitrine CLI").version(pkg.version);
-program.command("add").description("\u0414\u043E\u0431\u0430\u0432\u0438\u0442\u044C \u0444\u0438\u0447\u0443(\u0438) \u0432 \u0442\u0435\u043A\u0443\u0449\u0438\u0439 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u0439").argument("<features...>", "\u0438\u043C\u0435\u043D\u0430 \u0444\u0438\u0447").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").action((features, opts) => {
+program.command("add").description("Add feature(s) to the current repository").argument("<features...>", "feature names").option("--registry <path>", "path to the registry").action((features, opts) => {
   const res = addFeatures(features, opts.registry);
-  console.log(res.installed.length ? `\u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043E: ${res.installed.join(", ")}` : "\u0423\u0436\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043E \u2014 \u043D\u0435\u0442 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439.");
+  console.log(res.installed.length ? `Installed: ${res.installed.join(", ")}` : "Already installed \u2014 no changes.");
 });
-program.command("remove").description("\u0423\u0434\u0430\u043B\u0438\u0442\u044C \u0444\u0438\u0447\u0443 (\u0435\u0441\u043B\u0438 removable)").argument("<feature>", "\u0438\u043C\u044F \u0444\u0438\u0447\u0438").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").action((feature, opts) => {
+program.command("remove").description("Remove a feature (if removable)").argument("<feature>", "feature name").option("--registry <path>", "path to the registry").action((feature, opts) => {
   removeFeatureCmd(feature, opts.registry);
-  console.log(`\u0423\u0434\u0430\u043B\u0435\u043D\u043E: ${feature}`);
+  console.log(`Removed: ${feature}`);
 });
-program.command("update").description("\u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u0443\u044E \u0444\u0438\u0447\u0443 (3-way merge); \u0431\u0435\u0437 \u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u2014 \u0432\u0441\u0435").argument("[features...]", "\u0438\u043C\u0435\u043D\u0430 \u0444\u0438\u0447").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").option("--dry-run", "\u043F\u043E\u043A\u0430\u0437\u0430\u0442\u044C \u043F\u043B\u0430\u043D \u0431\u0435\u0437 \u0437\u0430\u043F\u0438\u0441\u0438").action((features, opts) => {
+program.command("update").description("Update an installed feature (3-way merge); all if no arguments").argument("[features...]", "feature names").option("--registry <path>", "path to the registry").option("--dry-run", "show the plan without writing").action((features, opts) => {
   const outcomes = updateFeaturesCmd(features, opts.registry, { dryRun: opts.dryRun });
   let conflicts = 0;
   for (const { plan, applied } of outcomes) {
     console.log(renderPlan(plan));
-    if (applied) console.log("  \u2192 \u043F\u0440\u0438\u043C\u0435\u043D\u0435\u043D\u043E");
+    if (applied) console.log("  \u2192 applied");
     conflicts += plan.files.reduce((n, f) => n + f.conflicts, 0);
   }
   if (conflicts > 0) {
     console.log(`
-\u26A0 \u043A\u043E\u043D\u0444\u043B\u0438\u043A\u0442\u043E\u0432: ${conflicts}. \u0420\u0430\u0437\u0440\u0435\u0448\u0438\u0442\u0435 git-\u043C\u0430\u0440\u043A\u0435\u0440\u044B (<<<<<<< / >>>>>>>) \u0432\u0440\u0443\u0447\u043D\u0443\u044E.`);
+\u26A0 conflicts: ${conflicts}. Resolve the git markers (<<<<<<< / >>>>>>>) by hand.`);
   }
 });
-program.command("diff").description("\u041F\u0440\u0435\u0434\u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440 \u0438\u0437\u043C\u0435\u043D\u0435\u043D\u0438\u0439 update (\u0431\u0435\u0437 \u0437\u0430\u043F\u0438\u0441\u0438)").argument("<feature>", "\u0438\u043C\u044F \u0444\u0438\u0447\u0438").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").action((feature, opts) => {
+program.command("diff").description("Preview update changes (without writing)").argument("<feature>", "feature name").option("--registry <path>", "path to the registry").action((feature, opts) => {
   console.log(renderPlan(diffFeatureCmd(feature, opts.registry)));
 });
-program.command("list").description("\u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044B\u0435 \u0438 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B\u0435 \u0444\u0438\u0447\u0438").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").action((opts) => {
+program.command("list").description("Installed and available features").option("--registry <path>", "path to the registry").action((opts) => {
   const { installed, available } = listFeatures(opts.registry);
-  console.log("\u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u044B:", installed.join(", ") || "\u2014");
-  console.log("\u0414\u043E\u0441\u0442\u0443\u043F\u043D\u044B:  ", available.join(", ") || "\u2014");
+  console.log("Installed:", installed.join(", ") || "\u2014");
+  console.log("Available:", available.join(", ") || "\u2014");
 });
-var design = program.command("design").description("\u0418\u0418-\u0448\u0430\u0433 \u0434\u0438\u0437\u0430\u0439\u043D\u0430 (\u043E\u0431\u0451\u0440\u0442\u043A\u0430 \u043D\u0430\u0434 Claude Code)");
-design.command("apply").description("\u041F\u0440\u0438\u043C\u0435\u043D\u0438\u0442\u044C \u0434\u0438\u0437\u0430\u0439\u043D \u0438\u0437 /design \u043A \u0442\u043E\u043A\u0435\u043D\u0430\u043C (\u0447\u0435\u0440\u0435\u0437 Claude Code)").option("--bin <path>", "\u043F\u0443\u0442\u044C \u043A Claude Code (\u0438\u043D\u0430\u0447\u0435 VITRINE_CLAUDE_BIN / PATH)").option("--dry-run", "\u043F\u043E\u043A\u0430\u0437\u0430\u0442\u044C \u043A\u043E\u043C\u0430\u043D\u0434\u0443 \u0431\u0435\u0437 \u0437\u0430\u043F\u0443\u0441\u043A\u0430").action((opts) => {
+var design = program.command("design").description("AI design step (wrapper over Claude Code)");
+design.command("apply").description("Apply the design from /design to the tokens (via Claude Code)").option("--bin <path>", "path to Claude Code (otherwise VITRINE_CLAUDE_BIN / PATH)").option("--dry-run", "show the command without running").action((opts) => {
   const code = designApplyCmd({ bin: opts.bin, dryRun: opts.dryRun });
   if (code !== 0) process.exit(code);
 });
-var kit = program.command("kit").description("\u041B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0439 (\u043A\u044D\u0448 \u0440\u0435\u0435\u0441\u0442\u0440\u0430 ~/.vitrine)");
-kit.command("update").description("\u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u043A\u044D\u0448 \u0440\u0435\u0435\u0441\u0442\u0440\u0430/\u0448\u0430\u0431\u043B\u043E\u043D\u043E\u0432 \u0441 GitHub (\u0438\u043B\u0438 --from <dir>)").option("--from <path>", "\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u0435 \u0434\u0435\u0440\u0435\u0432\u043E kit (\u043A\u043B\u043E\u043D / \u0440\u0430\u0441\u043F\u0430\u043A\u043E\u0432\u0430\u043D\u043D\u044B\u0439 tarball) \u0432\u043C\u0435\u0441\u0442\u043E \u0441\u0435\u0442\u0438").option("--version <tag>", "\u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u044B\u0439 \u0440\u0435\u043B\u0438\u0437").option("--channel <channel>", "stable | main", "stable").action((opts) => {
+var kit = program.command("kit").description("Local tooling (the ~/.vitrine registry cache)");
+kit.command("update").description("Update the local registry/templates cache from GitHub (or --from <dir>)").option("--from <path>", "local kit tree (clone / unpacked tarball) instead of the network").option("--version <tag>", "a specific release").option("--channel <channel>", "stable | main", "stable").action((opts) => {
   const res = kitUpdate({ from: opts.from, version: opts.version, channel: opts.channel });
-  console.log(`\u041A\u044D\u0448 \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D \u0434\u043E kit ${res.kitVersion}.`);
+  console.log(`Cache updated to kit ${res.kitVersion}.`);
   console.log(formatChangelog(res.changelog));
 });
-kit.command("status").description("\u0412\u0435\u0440\u0441\u0438\u044F \u043A\u044D\u0448\u0430 \u0438 \u0447\u0442\u043E \u043D\u043E\u0432\u0435\u0435 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u043E\u0433\u043E CLI").action(() => {
+kit.command("status").description("Cache version and what is newer than the installed CLI").action(() => {
   const s = kitStatus();
   if (!s.cached) {
-    console.log('\u041A\u044D\u0448 \u043F\u0443\u0441\u0442. \u0417\u0430\u043F\u0443\u0441\u0442\u0438 "vitrine kit update".');
+    console.log('Cache is empty. Run "vitrine kit update".');
     return;
   }
-  console.log(`\u041A\u044D\u0448: kit ${s.kitVersion} (${s.channel}), \u0444\u0438\u0447: ${s.featureCount ?? "\u2014"}, \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D ${s.updatedAt}.`);
-  console.log(`CLI \u043E\u0436\u0438\u0434\u0430\u0435\u0442 kit ${s.cliKitVersion}.`);
+  console.log(`Cache: kit ${s.kitVersion} (${s.channel}), features: ${s.featureCount ?? "\u2014"}, updated ${s.updatedAt}.`);
+  console.log(`CLI expects kit ${s.cliKitVersion}.`);
 });
-program.command("self-update").description("\u041E\u0431\u043D\u043E\u0432\u0438\u0442\u044C \u0441\u0430\u043C CLI (@vitrine-kit/vitrine)").option("--dry-run", "\u043F\u043E\u043A\u0430\u0437\u0430\u0442\u044C \u043A\u043E\u043C\u0430\u043D\u0434\u0443 \u0431\u0435\u0437 \u0437\u0430\u043F\u0443\u0441\u043A\u0430").action((opts) => {
+program.command("self-update").description("Update the CLI itself (@vitrine-kit/vitrine)").option("--dry-run", "show the command without running").action((opts) => {
   const code = selfUpdate({ dryRun: opts.dryRun });
   if (code !== 0) process.exit(code);
 });
-program.command("doctor").description("\u041F\u0440\u043E\u0432\u0435\u0440\u0438\u0442\u044C \u043A\u043E\u043D\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0441\u0442\u044C: vitrine.json \u2194 \u0444\u0430\u0439\u043B\u044B \u2194 \u043F\u0430\u043A\u0435\u0442\u044B \u2194 env").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").action((opts) => {
+program.command("doctor").description("Check consistency: vitrine.json \u2194 files \u2194 packages \u2194 env").option("--registry <path>", "path to the registry").action((opts) => {
   const report = doctorCmd(opts.registry);
   if (report.issues.length === 0) {
-    console.log("\u2713 \u041F\u0440\u043E\u0431\u043B\u0435\u043C \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u043E.");
+    console.log("\u2713 No issues found.");
     return;
   }
   for (const i of report.issues) {
-    const tag = i.severity === "error" ? "\u041E\u0428\u0418\u0411\u041A\u0410" : "\u043F\u0440\u0435\u0434\u0443\u043F\u0440.";
+    const tag = i.severity === "error" ? "ERROR" : "warn";
     console.log(`[${tag}] ${i.scope}: ${i.message}${i.fix ? ` \u2192 ${i.fix}` : ""}`);
   }
   if (!report.ok) process.exit(1);
 });
-program.command("init").description("\u0421\u043E\u0437\u0434\u0430\u0442\u044C \u043D\u043E\u0432\u044B\u0439 \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u0439 \u043A\u043B\u0438\u0435\u043D\u0442\u0430").argument("[name]", "\u0438\u043C\u044F \u043F\u0440\u043E\u0435\u043A\u0442\u0430").option("--dir <path>", "\u0440\u043E\u0434\u0438\u0442\u0435\u043B\u044C\u0441\u043A\u0438\u0439 \u043A\u0430\u0442\u0430\u043B\u043E\u0433", process.cwd()).option("--tier <tier>", "catalog | simple-store | full-store").option("--backend <backend>", "payload | vendure").option("--features <list>", "\u0441\u043F\u0438\u0441\u043E\u043A \u0447\u0435\u0440\u0435\u0437 \u0437\u0430\u043F\u044F\u0442\u0443\u044E").option("--registry <path>", "\u043F\u0443\u0442\u044C \u043A \u0440\u0435\u0435\u0441\u0442\u0440\u0443").option("--yes", "\u0431\u0435\u0437 \u0438\u043D\u0442\u0435\u0440\u0430\u043A\u0442\u0438\u0432\u043D\u044B\u0445 \u0432\u043E\u043F\u0440\u043E\u0441\u043E\u0432").action(async (nameArg, opts) => {
+program.command("init").description("Create a new client repository").argument("[name]", "project name").option("--dir <path>", "parent directory", process.cwd()).option("--tier <tier>", "catalog | simple-store | full-store").option("--backend <backend>", "payload | vendure").option("--features <list>", "comma-separated list").option("--registry <path>", "path to the registry").option("--yes", "skip interactive questions").action(async (nameArg, opts) => {
   const registry = createRegistrySource(opts.registry);
   let name = nameArg;
   let tier = opts.tier;
   let features = opts.features ? String(opts.features).split(",") : void 0;
   if (!opts.yes && (!name || !tier)) {
     p.intro("vitrine init");
-    if (!name) name = String(await p.text({ message: "\u0418\u043C\u044F \u043F\u0440\u043E\u0435\u043A\u0442\u0430", placeholder: "my-shop" }));
+    if (!name) name = String(await p.text({ message: "Project name", placeholder: "my-shop" }));
     if (!tier) {
       tier = await p.select({
-        message: "\u0423\u0440\u043E\u0432\u0435\u043D\u044C",
+        message: "Tier",
         options: [
-          { value: "catalog", label: "\u041A\u0430\u0442\u0430\u043B\u043E\u0433" },
-          { value: "simple-store", label: "\u041F\u0440\u043E\u0441\u0442\u043E\u0439 \u043C\u0430\u0433\u0430\u0437\u0438\u043D" },
-          { value: "full-store", label: "\u041F\u043E\u043B\u043D\u044B\u0439 \u043C\u0430\u0433\u0430\u0437\u0438\u043D" }
+          { value: "catalog", label: "Catalog" },
+          { value: "simple-store", label: "Simple store" },
+          { value: "full-store", label: "Full store" }
         ]
       });
     }
     const suggested = suggestFeatures(tier, registry);
     const baseline = suggested.filter((f) => !PAYMENT_PROVIDER_FEATURES.includes(f));
     const picked = await p.multiselect({
-      message: "\u0424\u0438\u0447\u0438",
+      message: "Features",
       options: baseline.map((f) => ({ value: f, label: f })),
       initialValues: baseline,
       required: false
@@ -1574,14 +1593,14 @@ program.command("init").description("\u0421\u043E\u0437\u0434\u0430\u0442\u044C
       const labels = {
         "checkout-stripe": "Stripe",
         "checkout-paddle": "Paddle",
-        "checkout-yookassa": "\u042EKassa"
+        "checkout-yookassa": "YooKassa"
       };
       const available = PAYMENT_PROVIDER_FEATURES.filter((f) => registry.hasFeature(f));
       if (available.length > 0) {
         const provider = await p.select({
-          message: "\u041F\u043B\u0430\u0442\u0451\u0436\u043D\u044B\u0439 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440",
+          message: "Payment provider",
           options: [
-            { value: "none", label: "\u041D\u0435\u0442 (\u0434\u043E\u0431\u0430\u0432\u0438\u0442\u044C \u043F\u043E\u0437\u0436\u0435: vitrine add checkout-<provider>)" },
+            { value: "none", label: "None (add later: vitrine add checkout-<provider>)" },
             ...available.map((f) => ({ value: f, label: labels[f] ?? f }))
           ],
           initialValue: available[0]
@@ -1589,16 +1608,16 @@ program.command("init").description("\u0421\u043E\u0437\u0434\u0430\u0442\u044C
         if (typeof provider === "string" && provider !== "none") features.push(provider);
       }
     }
-    p.outro("\u041F\u043E\u0435\u0445\u0430\u043B\u0438");
+    p.outro("Ready");
   }
-  if (!name) throw new Error("[vitrine] \u043D\u0443\u0436\u043D\u043E \u0438\u043C\u044F \u043F\u0440\u043E\u0435\u043A\u0442\u0430");
+  if (!name) throw new Error("[vitrine] a project name is required");
   const finalTier = tier ?? "catalog";
   const backend = opts.backend ?? defaultBackend(finalTier);
   const finalFeatures = features ?? suggestFeatures(finalTier, registry, backend);
   const root = resolve6(String(opts.dir ?? process.cwd()), name);
   const res = initProject({ root, name, backend, tier: finalTier, features: finalFeatures, registry });
-  console.log(`\u0421\u043E\u0437\u0434\u0430\u043D \u043F\u0440\u043E\u0435\u043A\u0442 "${name}" \u2192 ${root}`);
-  console.log(`\u0423\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043E: ${res.installed.join(", ") || "\u2014"}`);
+  console.log(`Created project "${name}" \u2192 ${root}`);
+  console.log(`Installed: ${res.installed.join(", ") || "\u2014"}`);
 });
 async function main() {
   preflightNode();