synthesisui 0.16.278 → 0.16.280

package/dist/commands/sync.js

@@ -1,3 +1,4 @@
+import { existsSync } from "node:fs";
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { isOlderCli } from "../cli-version.js";
@@ -98,7 +99,26 @@ export async function sync(opts) {
     }
     if (!slug) {
         console.log(section("Sync"));
-        console.log(body("No installed system here, so there is nowhere to sync to."));
+        /**
+         * UM BECO SEM SAÍDA CUSTA UMA SESSÃO - e este custou uma, medido em 22/08.
+         *
+         * A frase dizia só que não havia sistema instalado. Ela é verdadeira e não diz o que fazer, e o
+         * dono rodou o comando em dois repositórios diferentes tentando descobrir - nos dois havia um
+         * `census.json`, que é o que faz alguém concluir que o sistema está ali.
+         *
+         * A DISTINÇÃO QUE ELA PRECISAVA FAZER: um repositório que rodou `import` tem censo e NÃO tem
+         * sistema instalado. Ele criou o sistema na plataforma e nunca o trouxe de volta - e o `sync` é
+         * um canal de mão dupla, então ele precisa do `.lock` para saber qual slug este repositório
+         * alimenta.
+         *
+         * Com o censo em mão a frase pode nomear o próximo comando em vez de descrever o estado.
+         */
+        const measured = existsSync(join(root, "_synthesisui", "census.json"));
+        console.log(body(measured
+            ? "This repo has a census but no installed system, so there is nowhere to send it. `import` created the system on the platform; bringing it back is what tells sync which one this repo feeds:"
+            : "No installed system here, so there is nowhere to sync to. Install one first:"));
+        console.log(body(paint.blue("    npx synthesisui@latest add <slug>")));
+        console.log(body(paint.faint("    npx synthesisui@latest list --mine    # the slugs you own")));
         return;
     }
     /**

package/dist/index.js

@@ -44,8 +44,8 @@ Usage - deterministic, FREE:
   synthesisui list [options]               list the published design systems
   synthesisui list --mine                  your own systems, with their group
   synthesisui add <slug> [options]         materialize a DS into _synthesisui/ds/<slug>/
-  synthesisui bp  <slug> [options]         the same command, short for blueprint
   synthesisui component <slug> <name>      bring one EXISTING component in as YOUR <Pascal>.tsx
+  synthesisui bp <slug> <name>             the same command, short for blueprint
   synthesisui template <slug> <name>       materialize a whole page from a DS template
                                            (--as landing-home names the output - multi-page safe)
   synthesisui upgrade <slug>               update an installed DS + regenerate your components + migration brief
@@ -349,15 +349,6 @@ async function main() {
              */
             await list({ registry, mine: flags.mine === true });
             break;
-        /**
-         * `bp` É O MESMO COMANDO QUE `add`, e o apelido existe porque `blueprint` é o nome público do
-         * que a plataforma produz.
-         *
-         * Apelido e não substituição: `add` está escrito em toda mensagem que o CLI já imprimiu, em
-         * todo GUIDE.md já materializado e na cabeça de quem usa. Trocá-lo faria um comando que a pessoa
-         * digitou ontem parar de existir hoje.
-         */
-        case "bp":
         case "add": {
             const slug = args[0];
             if (!slug) {
@@ -463,6 +454,20 @@ async function main() {
             });
             break;
         }
+        /**
+         * `bp` É O MESMO COMANDO QUE `component`, e é AQUI que ele pertence.
+         *
+         * O apelido nasceu em 22/08 pendurado no `add`, e estava errado: `add` instala o SISTEMA
+         * inteiro - tokens, receitas, GUIDE - e `blueprint` é um COMPONENTE. A tela do Studio lista
+         * `componentNames + blockNames` sob a frase "No blueprints yet", e a ferramenta MCP
+         * `add_blueprint` materializa exatamente um.
+         *
+         * O custo do erro apareceu na primeira vez que alguém leu: o dono viu
+         * `npx synthesisui bp codelevel-ui` e entendeu "gerar um componente novo", que é o que a
+         * palavra promete - e o comando instalava o sistema. Um apelido que promete outra coisa é pior
+         * que apelido nenhum.
+         */
+        case "bp":
         case "component": {
             const slug = args[0];
             const name = args[1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.278",
+  "version": "0.16.280",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {