elcrm 1.1.4 → 1.1.5

package/dist/index.js

@@ -1538,18 +1538,50 @@ function inspectPkgCss(pkgName, cwd) {
     return null;
   const pkg = readPkgJson(root);
   const exp = pkg?.exports;
-  const styleRel = exportPath(exp, "./style.css");
-  const lightRel = exportPath(exp, "./light.css");
-  const darkRel = exportPath(exp, "./dark.css");
   const abs = (rel2) => rel2 ? join6(root, rel2.replace(/^\.\//, "")) : undefined;
+  const fileIfExists = (key) => {
+    const rel2 = exportPath(exp, key);
+    const a = abs(rel2);
+    return a && existsSync6(a) ? a : undefined;
+  };
   return {
     name: pkgName,
     root,
-    style: abs(styleRel) && existsSync6(abs(styleRel)) ? abs(styleRel) : undefined,
-    light: abs(lightRel) && existsSync6(abs(lightRel)) ? abs(lightRel) : undefined,
-    dark: abs(darkRel) && existsSync6(abs(darkRel)) ? abs(darkRel) : undefined
+    style: fileIfExists("./style.css"),
+    light: fileIfExists("./light.css"),
+    dark: fileIfExists("./dark.css"),
+    tokens: fileIfExists("./tokens.css")
   };
 }
+function resolveElcrmCssImport(spec, cwd) {
+  const bare = spec.replace(/^["']|["']$/g, "").trim();
+  const m = bare.match(/^(@elcrm\/[^/]+)\/(.+)$/);
+  if (!m)
+    return null;
+  const pkgName = m[1];
+  const sub = m[2];
+  const root = resolvePkgRoot(pkgName, cwd);
+  if (!root)
+    return null;
+  const pkg = readPkgJson(root);
+  const rel2 = exportPath(pkg?.exports, `./${sub}`);
+  if (!rel2)
+    return null;
+  const abs = join6(root, rel2.replace(/^\.\//, ""));
+  return existsSync6(abs) ? abs : null;
+}
+function pruneBrokenElcrmImports(css, cwd) {
+  const removed = [];
+  const next = css.replace(/@import\s+["'](@elcrm\/[^"']+)["']\s*;[ \t]*(?:\r?\n)?/g, (full, spec) => {
+    if (resolveElcrmCssImport(spec, cwd))
+      return full;
+    removed.push(spec);
+    return "";
+  });
+  return { css: next.replace(/\n{3,}/g, `
+
+`), removed };
+}
 function addDef(acc, seen, pkg, bucket, name, value) {
   const key = `${bucket}:${name}`;
   if (seen.has(key))
@@ -1732,6 +1764,7 @@ function syncElcrmCss(options) {
     "theme-dark.css": []
   };
   const imports = [];
+  let removedImports = [];
   const fileFor = (bucket) => bucket === "geometry" ? paths.geometry : bucket === "light" ? paths.light : paths.dark;
   const labelFor = (bucket) => bucket === "geometry" ? "theme.css" : bucket === "light" ? "theme-light.css" : "theme-dark.css";
   for (const bucket of ["geometry", "light", "dark"]) {
@@ -1764,14 +1797,16 @@ function syncElcrmCss(options) {
   }
   if (existsSync6(paths.elcrm)) {
     let css = readFileSync12(paths.elcrm, "utf8");
+    const pruned = pruneBrokenElcrmImports(css, options.cwd);
+    css = pruned.css;
+    removedImports = pruned.removed;
     for (const exp of cssExports) {
       const specs = [];
       if (exp.light)
         specs.push(`${exp.name}/light.css`);
       if (exp.dark)
         specs.push(`${exp.name}/dark.css`);
-      const tokens = join6(exp.root, "dist/tokens.css");
-      if (existsSync6(tokens))
+      if (exp.tokens)
         specs.push(`${exp.name}/tokens.css`);
       for (const spec of specs) {
         const r = ensureImport(css, spec);
@@ -1780,10 +1815,11 @@ function syncElcrmCss(options) {
           imports.push(spec);
       }
     }
-    if (imports.length && !options.dry)
+    if ((imports.length || removedImports.length) && !options.dry) {
       writeFileSync4(paths.elcrm, css, "utf8");
+    }
   }
-  return { styleDir, added, imports, skippedPkgs };
+  return { styleDir, added, imports, removedImports, skippedPkgs };
 }
 
 // src/commands/test.ts
@@ -2861,7 +2897,10 @@ package.json \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D (${changed}).`);
       if (css.imports.length) {
         console.log(`  ${c.green("+")} elcrm.css @import: ${css.imports.join(", ")}`);
       }
-      if (added === 0 && css.imports.length === 0) {
+      if (css.removedImports.length) {
+        console.log(`  ${c.red("\u2212")} elcrm.css \u0431\u0438\u0442\u044B\u0435 @import: ${css.removedImports.join(", ")}`);
+      }
+      if (added === 0 && css.imports.length === 0 && css.removedImports.length === 0) {
         console.log("  \u0422\u043E\u043A\u0435\u043D\u044B \u0443\u0436\u0435 \u043D\u0430 \u043C\u0435\u0441\u0442\u0435.");
       }
       const cleaned = await migrateCssSanitize(cwd, false);
@@ -3409,10 +3448,16 @@ async function cmdCss(parsed) {
       for (const spec of result.imports)
         console.log(`      ${c.dim(spec)}`);
     }
+    if (result.removedImports.length) {
+      console.log(`  ${c.red("\u2212")} elcrm.css \u0431\u0438\u0442\u044B\u0435 @import:`);
+      for (const spec of result.removedImports) {
+        console.log(`      ${c.dim(spec)}`);
+      }
+    }
     if (result.skippedPkgs.length) {
       console.log(`  ${c.gray("\u0431\u0435\u0437 CSS-\u0442\u043E\u043A\u0435\u043D\u043E\u0432:")} ${result.skippedPkgs.join(", ")}`);
     }
-    if (total === 0 && result.imports.length === 0) {
+    if (total === 0 && result.imports.length === 0 && result.removedImports.length === 0) {
       console.log("\u0412\u0441\u0451 \u0443\u0436\u0435 \u043D\u0430 \u043C\u0435\u0441\u0442\u0435.");
     } else if (dry) {
       console.log("\u0417\u0430\u043F\u0438\u0441\u044C \u043D\u0435 \u0432\u044B\u043F\u043E\u043B\u043D\u044F\u043B\u0430\u0441\u044C (--dry).");
@@ -3572,6 +3617,21 @@ function scan(cwd) {
       fix: "elcrm css"
     });
   }
+  if (styleDir && existsSync14(join14(styleDir, "elcrm.css"))) {
+    const elcrmCss = readFileSync19(join14(styleDir, "elcrm.css"), "utf8");
+    for (const m of elcrmCss.matchAll(/@import\s+["'](@elcrm\/[^"']+)["']/g)) {
+      const spec = m[1];
+      if (!resolveElcrmCssImport(spec, cwd)) {
+        out.push({
+          level: "error",
+          code: "elcrm-import-missing",
+          message: `\u0431\u0438\u0442\u044B\u0439 @import "${spec}" \u2014 \u0444\u0430\u0439\u043B\u0430 \u043D\u0435\u0442 \u0432 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u043E\u043C \u043F\u0430\u043A\u0435\u0442\u0435`,
+          file: relative4(cwd, join14(styleDir, "elcrm.css")),
+          fix: "elcrm css"
+        });
+      }
+    }
+  }
   const depsForm = pkg.dependencies?.["@elcrm/form"] || pkg.devDependencies?.["@elcrm/form"];
   if (depsForm && styleDir) {
     const themeFiles = [
@@ -3859,90 +3919,57 @@ function showVersion() {
 function showHelp() {
   console.log(`elcrm \u2014 CLI \u0434\u043B\u044F \u044D\u043A\u043E\u0441\u0438\u0441\u0442\u0435\u043C\u044B @elcrm/*
 
-\u0418\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D\u0438\u0435:
-  elcrm <\u043A\u043E\u043C\u0430\u043D\u0434\u0430> [\u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442\u044B] [\u0444\u043B\u0430\u0433\u0438]
+\u0415\u0436\u0435\u0434\u043D\u0435\u0432\u043D\u044B\u0439 \u0446\u0438\u043A\u043B:
+  elcrm update --fix --test
+  elcrm css
+  elcrm docs
+  elcrm cursor
 
 \u041A\u043E\u043C\u0430\u043D\u0434\u044B:
   update [--dry] [--core] [--no-install] [--fix] [--test]
-      CLI (bun i -g elcrm@latest) + \u0432\u0441\u0435 @elcrm/* \u0432 \u043F\u0440\u043E\u0435\u043A\u0442\u0435 \u0434\u043E latest
-      --fix = migrate front; --test = elcrm test
-      \u0420\u0435\u043A\u043E\u043C\u0435\u043D\u0434\u0443\u0435\u0442\u0441\u044F: elcrm update --fix --test
+      bun i -g elcrm@latest + @elcrm/* \u2192 install
+      --fix = migrate front + sync CSS (\u0442\u043E\u043A\u0435\u043D\u044B, \u2212\u0431\u0438\u0442\u044B\u0435 @import) + css-sanitize
+      --test = elcrm test
 
-  create <name> [--template app|lib|panel] [--no-install]
-      \u0421\u043E\u0437\u0434\u0430\u0442\u044C \u043F\u0440\u043E\u0435\u043A\u0442 \u0438\u0437 \u0448\u0430\u0431\u043B\u043E\u043D\u0430 (\u043A\u0430\u043A create-react-app)
-      panel \u2192 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0438 web/ + api/ + bun run dev
+  css [--dry] [--dir=\u2026]
+      \u0422\u043E\u043A\u0435\u043D\u044B \u2192 theme*.css; elcrm.css: +\u0440\u0430\u0431\u043E\u0447\u0438\u0435 @import, \u2212\u0431\u0438\u0442\u044B\u0435 (\u043D\u0435\u0442 \u0444\u0430\u0439\u043B\u0430 \u0432 \u043F\u0430\u043A\u0435\u0442\u0435)
+      \u0417\u0430\u0442\u0435\u043C css-sanitize (\u043E\u0441\u0438\u0440\u043E\u0442\u0435\u0432\u0448\u0438\u0439 color-mix)
 
-  init [--template app|lib|panel] [--force] [--no-install]
-      \u0418\u043D\u0438\u0446\u0438\u0430\u043B\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u0442\u044C \u0442\u0435\u043A\u0443\u0449\u0438\u0439 \u043A\u0430\u0442\u0430\u043B\u043E\u0433 \u0448\u0430\u0431\u043B\u043E\u043D\u043E\u043C
+  docs [--dry] [--keep] [--dir=\u2026] [--lib]
+      docs/*.elCRM.md (\u0448\u043F\u0430\u0440\u0433\u0430\u043B\u043A\u0438 \u043F\u0430\u043A\u0435\u0442\u043E\u0432)
 
-  migrate <name> [--dry]
-  migrate --list
-      \u041C\u0438\u0433\u0440\u0430\u0446\u0438\u0438: front|ui, form-aliases, form-tokens, components, css-sanitize, size-sml, field-border, modal-create, legacy-hacks, socket-server
+  cursor [--dry] [--keep] [--dir=\u2026] [--lib|-lib]
+      .cursor/rules + .cursor/docs + AGENTS.md
+      --lib: \u0447\u0435\u043A\u043B\u0438\u0441\u0442 \u0430\u0432\u0442\u043E\u0440\u0430 @elcrm/*
 
-      audit [--fix] [--dry] [--dir=\u2026]
-      \u0423\u0441\u0442\u0430\u0440\u0435\u0432\u0448\u0438\u0439 API + CSS-\u0442\u043E\u043A\u0435\u043D\u044B form (padding-\u0430\u043B\u0438\u0430\u0441\u044B, popup-shadow, border shorthand)
-      --fix \u0437\u0430\u043F\u0443\u0441\u043A\u0430\u0435\u0442 migrate front
+  migrate <name> [--dry] | migrate --list
+      front|ui = \u043F\u0430\u043A\u0435\u0442 \u043C\u0438\u0433\u0440\u0430\u0446\u0438\u0439 (aliases, tokens, components, css-sanitize, size, \u2026)
+      \u043F\u043E \u043E\u0434\u043D\u043E\u0439: form-aliases, form-tokens, components, css-sanitize, size-sml,
+                field-border, modal-create, legacy-hacks, socket-server
+
+  audit [--fix] [--dry] [--dir=\u2026]
+      \u0421\u0442\u0430\u0440\u044B\u0435 API, \u0431\u0438\u0442\u044B\u0435 @import, orphan color-mix; --fix = migrate front
+      \u041F\u043E\u0441\u043B\u0435 --fix \u0434\u043B\u044F imports: elcrm css
 
   doctor [--fix]
-      \u041F\u0440\u043E\u0432\u0435\u0440\u0438\u0442\u044C \u043F\u0440\u043E\u0435\u043A\u0442 \u0438 \u043F\u0440\u0438 \u043D\u0435\u043E\u0431\u0445\u043E\u0434\u0438\u043C\u043E\u0441\u0442\u0438 \u043F\u0440\u0438\u0432\u0435\u0441\u0442\u0438 \u043A \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u0443
+      \u0421\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u044B; \u043D\u0430 \u0441\u0435\u0440\u0432\u0435\u0440\u0435 --fix \u2192 bunx elcrm-server update
 
   test [dir] [--front|--server] [--no-scripts]
-      \u041F\u0440\u043E\u0432\u0435\u0440\u043A\u0438: @elcrm/server \u0432 package.json \u2192 server, \u0438\u043D\u0430\u0447\u0435 \u2192 front
-      (workspaces \u2014 \u043A\u0430\u0436\u0434\u044B\u0439 \u043F\u0430\u043A\u0435\u0442 \u0441\u0432\u043E\u0438\u043C \u0440\u0435\u0436\u0438\u043C\u043E\u043C)
+      \u0421\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0430\u043D\u0430\u043B\u0438\u0437 + scripts \u043F\u0440\u043E\u0435\u043A\u0442\u0430
 
+  create <name> [--template app|lib|panel] [--no-install]
+  init [--template app|lib|panel] [--force] [--no-install]
   build [--client] [--url=\u2026] [--name=\u2026] [--dir=\u2026] [--folder=\u2026]
-      \u0421\u0431\u043E\u0440\u043A\u0430 \u0438 \u0434\u0435\u043F\u043B\u043E\u0439 (\u0438\u0437 @elcrm/deploy)
-
   postbuild [--dir=./dist]
-      \u041F\u043E\u0441\u043B\u0435 vite build lib-\u043F\u0430\u043A\u0435\u0442\u0430: \u0441\u043A\u043B\u0435\u0438\u0442\u044C CSS + \u0441\u043F\u043B\u044E\u0449\u0438\u0442\u044C .d.ts
-      (package.json: "build": "vite build && elcrm postbuild")
-
-  css [--dry] [--dir=\u2026]
-      \u0414\u0435\u0444\u043E\u043B\u0442\u043D\u044B\u0435 \u0442\u043E\u043A\u0435\u043D\u044B @elcrm/* \u2192 src/style/theme.css, theme-light/dark, elcrm.css
-      \u0423\u0436\u0435 \u0437\u0430\u0434\u0430\u043D\u043D\u044B\u0435 \u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0435 \u043D\u0435 \u0437\u0430\u0442\u0438\u0440\u0430\u044E\u0442\u0441\u044F, \u0442\u043E\u043B\u044C\u043A\u043E \u043D\u0435\u0434\u043E\u0441\u0442\u0430\u044E\u0449\u0438\u0435 (\u0433\u0440\u0443\u043F\u043F\u044B \u0447\u0435\u0440\u0435\u0437 \u043F\u0443\u0441\u0442\u0443\u044E \u0441\u0442\u0440\u043E\u043A\u0443)
-
-  docs [--dry] [--keep] [--dir=\u2026] [--lib]
-      docs/*.elCRM.md \u043F\u043E \u043F\u0430\u043A\u0435\u0442\u0430\u043C (cli, api, alert, button, modal, notice, \u2026)
-      \u0441\u0435\u0440\u0432\u0435\u0440-only \u2192 SERVER, CLI, API, SOCKET; --lib \u0438\u043B\u0438 \u043F\u0430\u043A\u0435\u0442 @elcrm/* \u2192 \u0432\u0441\u0435 \u0444\u0430\u0439\u043B\u044B
-
-  cursor [--dry] [--keep] [--dir=\u2026] [--lib|-lib]
-      .cursor/rules + .cursor/docs + AGENTS.md
-      --lib: \u0447\u0435\u043A\u043B\u0438\u0441\u0442 \u0430\u0432\u0442\u043E\u0440\u0430 \u0431\u0438\u0431\u043B\u0438\u043E\u0442\u0435\u043A\u0438 (\u043F\u043E\u0441\u043B\u0435 \u043F\u0440\u0430\u0432\u043E\u043A src \u043E\u0431\u043D\u043E\u0432\u0438\u0442\u044C CLI-\u0448\u043F\u0430\u0440\u0433\u0430\u043B\u043A\u0438)
-
   uuid
-      \u0421\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u0442\u044C UUID
-
-  help
-      \u042D\u0442\u0430 \u0441\u043F\u0440\u0430\u0432\u043A\u0430
 
-\u0424\u043B\u0430\u0433\u0438:
-  -v, --version    \u0412\u0435\u0440\u0441\u0438\u044F CLI
-  -h, --help       \u0421\u043F\u0440\u0430\u0432\u043A\u0430
+\u0424\u043B\u0430\u0433\u0438: -v/--version, -h/--help
 
 \u041F\u0440\u0438\u043C\u0435\u0440\u044B:
-  elcrm -v
-  elcrm update
-  elcrm update --dry
-  elcrm update --fix --test
-  elcrm migrate form-aliases --dry
-  elcrm migrate form-tokens --dry
-  elcrm create my-app --template app
-  elcrm init --template panel
-  elcrm init --template lib
-  elcrm migrate front --dry
-  elcrm migrate size-sml
+  elcrm update --fix --test && elcrm css && elcrm docs && elcrm cursor
+  elcrm css                 # ENOENT @elcrm/\u2026/light.css \u2192 \u0441\u043D\u0438\u043C\u0435\u0442 \u0431\u0438\u0442\u044B\u0439 import
   elcrm audit
-  elcrm audit --fix
-  elcrm doctor --fix
-  elcrm test
-  elcrm test --server
-  elcrm build --client --url=https://example.com/deploy
-  elcrm postbuild
-  elcrm css
-  elcrm css --dry
-  elcrm docs
-  elcrm cursor
-  elcrm cursor --lib
+  elcrm migrate front --dry
 `);
 }
 async function main() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elcrm",
-  "version": "1.1.4",
-  "description": "CLI @elcrm/*: update, create, migrate front/components/css-sanitize, audit, doctor, test, build, css",
+  "version": "1.1.5",
+  "description": "CLI @elcrm/*: update --fix --test, css (prune imports), docs, cursor, migrate, audit",
   "type": "module",
   "license": "MIT",
   "author": "MaSkal <dev@elcrm.online>",

package/templates/elcrm-docs/CLI.elCRM.md

@@ -1,8 +1,12 @@
-<!-- Сгенерировано `elcrm docs`. Пакет: elcrm (CLI). -->
+<!-- Источник: elCRM.cli/templates/elcrm-docs/CLI.elCRM.md. Обновить: elcrm docs. -->
 
 # `elcrm` CLI
 
-Глобально: `bun i -g elcrm`. В приложении — пакеты и CLI одной командой:
+Глобально: `bun i -g elcrm` (нужна **свежая** версия: `elcrm -v`).
+
+## Ежедневный цикл (запомнить эти 4)
+
+После смены `@elcrm/*` или если «что-то сломалось» в UI/CSS:
 
 ```bash
 elcrm update --fix --test
@@ -11,17 +15,102 @@ elcrm docs
 elcrm cursor
 ```
 
-| Команда | Зачем |
+| # | Команда | Что делает |
+| --- | --- | --- |
+| 1 | `elcrm update --fix --test` | Обновляет глобальный `elcrm` + все `@elcrm/*` в `package.json` → install → **migrate front** (API/токены/css-sanitize) → внутри `--fix` ещё раз **sync CSS** → `elcrm test` |
+| 2 | `elcrm css` | Недостающие CSS-токены → `theme.css` / `theme-light` / `theme-dark`. В `elcrm.css`: **добавляет** рабочие `@import`, **удаляет битые** (нет export/файла в установленном пакете). Затем css-sanitize |
+| 3 | `elcrm docs` | Перезаписывает `docs/*.elCRM.md` (шпаргалки пакетов) |
+| 4 | `elcrm cursor` | `.cursor/rules` + `.cursor/docs` + `AGENTS.md` для агента |
+
+Не чинит само по себе: ручные баги в компонентах, сервер без `elcrm-server`, секреты. Чинит: устаревшие API после миграций, битые `@import` в `elcrm.css`, осиротевший `color-mix`, недостающие токены.
+
+---
+
+## Все команды
+
+### `update` — зависимости
+
+```bash
+elcrm update                 # latest @elcrm/* + bun i -g elcrm@latest
+elcrm update --dry           # только отчёт
+elcrm update --core          # версии как в @elcrm/core
+elcrm update --no-install    # только package.json
+elcrm update --fix          # + migrate front + sync CSS (+ prune битых @import)
+elcrm update --test          # + elcrm test (обычно вместе: --fix --test)
+```
+
+### `css` — стили приложения
+
+```bash
+elcrm css                    # токены + починка elcrm.css
+elcrm css --dry
+elcrm css --dir=./web        # panel: web/
+```
+
+Почему Vite ругался на `@elcrm/search/light.css`: в `elcrm.css` остался `@import`, а в **установленном** `@elcrm/search@0.1.4` нет export `./light.css`. Раньше `css` только добавлял imports — теперь **снимает** такие строки. Лечение: `elcrm css` (или `update --fix`).
+
+### `docs` / `cursor` — шпаргалки
+
+```bash
+elcrm docs                   # docs/*.elCRM.md
+elcrm docs --dry | --keep | --lib | --dir=…
+elcrm cursor                 # .cursor/rules + .cursor/docs + AGENTS.md
+elcrm cursor --lib           # + чеклист автора @elcrm/* (правило elcrm-lib)
+```
+
+### `migrate` — точечные правки кода
+
+```bash
+elcrm migrate --list
+elcrm migrate front          # пакет (то же, что update/audit/doctor --fix):
+                             #   form-aliases → form-tokens → components →
+                             #   css-sanitize → size-sml → field-border →
+                             #   modal-create → socket-server
+elcrm migrate css-sanitize   # осиротевшие in srgb / transparent);
+elcrm migrate components     # Block/Row → Stack, --page-* → --shell-*
+elcrm migrate form-tokens
+elcrm migrate form-aliases
+elcrm migrate size-sml       # size sm|md → s|m|l
+elcrm migrate field-border
+elcrm migrate modal-create   # Modal.Add → Create
+elcrm migrate legacy-hacks   # только по имени, не в front
+elcrm migrate socket-server
+```
+
+Флаг у всех: `--dry`.
+
+### `audit` / `doctor` / `test` — проверки
+
+```bash
+elcrm audit                  # старые API, битые @import, orphan color-mix, …
+elcrm audit --fix            # = migrate front (+ css не вызывает — после: elcrm css)
+elcrm doctor                 # стандарты проекта
+elcrm doctor --fix          # type/engines + migrate front
+elcrm test                   # статический анализ + scripts проекта
+elcrm test --front|--server|--no-scripts
+```
+
+### Прочее
+
+```bash
+elcrm create <name> [--template app|lib|panel] [--no-install]
+elcrm init [--template …] [--force] [--no-install]
+elcrm build --client [--url=…] [--name=…] [--dir=…] [--folder=…]
+elcrm postbuild [--dir=./dist]   # lib: склейка CSS после vite build
+elcrm uuid
+elcrm -v / --help
+```
+
+---
+
+## Когда что запускать
+
+| Ситуация | Команды |
 | --- | --- |
-| `update [--dry] [--core] [--fix] [--test]` | `bun i -g elcrm@latest` + `@elcrm/*` в проекте; `--fix` = migrate front + css; `--test` = elcrm test |
-| `create` / `init` | шаблоны `app` \| `lib` \| `panel` |
-| `migrate <name> [--dry]` | `front` (пакет), `form-aliases`, `form-tokens`, `components`, `size-sml`, `field-border`, `modal-create`, `legacy-hacks`, `socket-server` |
-| `audit [--fix]` | старые API; `--fix` = migrate front |
-| `doctor [--fix]` | стандарты; сервер --fix → `bunx elcrm-server update` |
-| `test [--front\|--server] [--no-scripts]` | статический анализ + scripts |
-| `css [--dry]` | недостающие токены → theme*.css |
-| `docs` / `cursor` | шпаргалки и правила агента |
-| `cursor --lib` / `-lib` | правила автора `@elcrm/*` lib (чеклист после правок src) |
-| `build` / `postbuild` / `uuid` | деплой клиента/api; склейка CSS lib |
-
-Не выдумывать флаги — `elcrm --help` и `COMMANDS.md`.
+| Обновили пакеты / «после elcrm update всё красное» | полный цикл из 4 команд сверху |
+| Vite: `ENOENT … @elcrm/…/light.css` | `elcrm css` → при необходимости `elcrm audit` |
+| Битый theme (`in srgb` без свойства) | `elcrm migrate css-sanitize` или `update --fix` |
+| Агент врёт API | `elcrm docs && elcrm cursor` |
+| Автор правит `@elcrm/*` src | чеклист: `elcrm cursor --lib`; шпаргалки править в **elCRM.cli** |
+
+Не выдумывать флаги — `elcrm --help` и `COMMANDS.md` в репо CLI.