synthesisui 0.16.496 → 0.16.497

package/dist/claude-md.js

@@ -463,6 +463,12 @@ written now** - read the code before you edit it, never a remembered signature.`
      * as duas portas e a regra que as mantém fechadas no dia a dia: quem cria sem pedir continua livre.
      * Basta o servidor registrado - a preferência não depende do sistema instalado.
      */
+    /**
+     * O PEDIDO LIVRE SAI MASTIGADO (jornada "o pedido livre sai mastigado", E03, 15/10): uma landing pedida em palavras
+     * livres passa pelo `landing` antes de qualquer linha - ele lista as seções do catálogo e devolve o prompt da pilha, com
+     * as decisões tomadas. Sem servidor também: o `landing` fala com o registro direto.
+     */
+    const landingLine = '\n\n**A landing asked in free words:** run `npx synthesisui@latest landing <slug> "<their words>"` first, and follow it.';
     const preferencesLine = recall.available
         ? `
 
@@ -523,7 +529,7 @@ If nothing covers it, say which indexed entry you considered and why it did not
 project's OWN custom properties, exactly as the guide lists them. Do not write raw colours,
 spacings or radii that a token already covers, and do not invent a new token silently - say so
 instead, because a new token is a decision for a person to make. There is no component
-manifest for an adopted system - the tokens ARE the contract.${theirsLine}${selfCheck}`
+manifest for an adopted system - the tokens ARE the contract.${theirsLine}${landingLine}${selfCheck}`
             : `**When creating or editing components, read the system's GUIDE.md and follow it:** use the
 vocabulary it lists - every name in it is a name THIS project already declares, written exactly as
 you would write it. Do not use raw values outside the system's scale, and never a name from a
@@ -559,7 +565,7 @@ still yours: the \`request_component\` MCP tool, or \`npx synthesisui@latest req
 what the system's author works from - a refusal said only in chat evaporates. If you want to eyeball a
 component on its own, an isolated scratch page is optional and never required - and if you make
 one, put it somewhere that does not become a route in this app, and delete it when you are done.
-Do not apply a component to real production pages unless asked.${selfCheck}`;
+Do not apply a component to real production pages unless asked.${landingLine}${selfCheck}`;
     const locale = await readInterfaceLanguage(projectRoot);
     const language = locale === null
         ? ""

package/dist/commands/landing.js

@@ -0,0 +1,47 @@
+import { resolveRegistry } from "../config.js";
+import { fetchLandingParts, fetchLandingPrompt } from "../registry.js";
+/**
+ * `synthesisui landing <slug> "<pedido>"` - O PEDIDO LIVRE SAI MASTIGADO (jornada "o pedido livre sai mastigado", 15/10).
+ *
+ * Em dois passos, e o agente faz os dois:
+ *
+ *   sem --sections   a lista das seções de landing do catálogo, com o lugar, o tipo e o nome, e o que fazer em seguida
+ *   com --sections   o MESMO prompt do "Copy prompt" da pilha para essas seções - um template por seção, fontes, menu do
+ *                    celular -, com o conteúdo vindo do pedido
+ *
+ * A única decisão que fica com o agente é escolher da lista; o resto é regra nossa, já tomada. Fala com o registro
+ * (a mesma fonte do site), por isso não é o `use`, que promete não usar a rede (`architecture/no-network.spec.ts`).
+ */
+export async function landing(slug, requestText, opts) {
+    const base = resolveRegistry(opts.registry);
+    const request = requestText.trim() || "a landing page";
+    const chosen = (opts.sections ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (chosen.length === 0) {
+        const parts = await fetchLandingParts(base, slug);
+        const byPlace = (place) => parts.filter((p) => p.place === place);
+        const line = (p) => `  ${p.id.padEnd(20)} ${p.type} · ${p.name}${p.note ? ` (${p.note})` : ""}`;
+        const out = [
+            `The landing sections of "${slug}". Pick one navigation, one hero, the body sections in order, and one footer -`,
+            "the ones that fit this request:",
+            `  "${request}"`,
+            "",
+            "Top",
+            ...byPlace("nav").map(line),
+            "Hero",
+            ...byPlace("hero").map(line),
+            "Body",
+            ...byPlace("body").map(line),
+            "Bottom",
+            ...byPlace("footer").map(line),
+            "",
+            "Then run, with your picks in page order, and follow the prompt it prints:",
+            `  npx synthesisui@latest landing ${slug} --sections <nav>,<hero>,<body...>,<footer> "${request}"`,
+        ];
+        console.log(out.join("\n"));
+        return;
+    }
+    console.log(await fetchLandingPrompt(base, slug, chosen, request));
+}

package/dist/commands/mcp.js

@@ -1966,7 +1966,18 @@ cli) {
             const prefs = await fetchPreferences({ base: resolveRegistry(), token }, kind, section, await installedSlug(root));
             if ("failed" in prefs)
                 return fromContract(`Their preferences could not be read: ${prefs.failed}. Build with the system as usual and say so in one line.`);
-            return preferencesAnswer(kind, prefs, await readSelection(root), await readOff(root));
+            const answer = preferencesAnswer(kind, prefs, await readSelection(root), await readOff(root));
+            /**
+             * O PEDIDO LIVRE SAI MASTIGADO (jornada "o pedido livre sai mastigado", E03, 15/10): a landing inteira passa pelo
+             * `landing`, que escolhe do catálogo e devolve o prompt com as decisões tomadas. Mora AQUI, e não no CLAUDE.md, porque
+             * com o servidor o bloco tem orçamento (`claude-md.f0.spec.ts`) e esta é a ferramenta que o agente já chama antes de
+             * uma página. Uma parte só (`section`) não passa por ele: é uma seção, e o pedido é dela.
+             */
+            if (kind === "landing" && section === undefined) {
+                const slug = (await installedSlug(root)) ?? "<slug>";
+                answer.body = `For the whole landing, first run \`npx synthesisui@latest landing ${slug} "<their words>"\`: pick the sections it lists, run it again with \`--sections\`, and build from the prompt it prints - every decision in it is already made. Apply what follows on top of it.\n\n${answer.body}`;
+            }
+            return answer;
         }
         case "remember_preference": {
             const { kind, layer } = args;

package/dist/commands/use.js

@@ -97,9 +97,20 @@ export async function use(slug, intent, opts) {
             `(\`npx synthesisui component ${slug} <name>\`) and use this project's own Tailwind utilities ` +
             `(${utilities}…). Never use raw hex/px outside the system's scale.`;
     const task = intent.trim() || "build the UI I describe next";
+    /**
+     * UMA LANDING TEM CAMINHO PRÓPRIO (jornada "o pedido livre sai mastigado", E01, 15/10): o `landing` devolve as seções do
+     * catálogo e o prompt com as decisões tomadas. O `use` não busca nada - ele promete não usar a rede -, só aponta.
+     */
+    const isLanding = /\blanding\b|\bhome ?page\b/i.test(task);
     const prompt = [
         `Use the "${name}" design system (slug: ${slug}, v${version}) to: ${task}`,
         "",
+        ...(isLanding
+            ? [
+                `This is a landing page: before writing anything, run \`npx synthesisui@latest landing ${slug} "${task.replace(/"/g, "'")}"\` - it lists the catalog's sections for you to pick, then prints the full prompt with every decision made. Follow that prompt instead of the rest of this one.`,
+                "",
+            ]
+            : []),
         "Read these files in the project first (highest authority first):",
         ...readFirst,
         "",

package/dist/index.js

@@ -20,6 +20,7 @@ import { generate } from "./commands/generate.js";
 import { hook } from "./commands/hook.js";
 import { runImport } from "./commands/import.js";
 import { init } from "./commands/init.js";
+import { landing } from "./commands/landing.js";
 import { list } from "./commands/list.js";
 import { login } from "./commands/login.js";
 import { logout } from "./commands/logout.js";
@@ -61,6 +62,7 @@ Usage - deterministic, FREE:
   synthesisui upgrade <slug>               update an installed DS + regenerate your components + migration brief
   synthesisui colours [slug]               write the colours you chose on the site into your CSS, in your names (asks first)
   synthesisui use <slug> "<intent>"        print a ready-to-paste agent prompt to build/modify on-system
+  synthesisui landing <slug> "<request>"   the catalog's landing sections, then (--sections a,b,c) the prompt with every decision made
   synthesisui clean [--force]              strip create-next-app boilerplate (dry run without --force)
 
 Usage - governance (deterministic, FREE):
@@ -719,6 +721,19 @@ async function main() {
             });
             break;
         }
+        case "landing": {
+            const slug = args[0];
+            if (!slug) {
+                console.error('error: provide the slug and your request - `synthesisui landing <slug> "<request>"`');
+                process.exitCode = 1;
+                return;
+            }
+            await landing(slug, args.slice(1).join(" "), {
+                sections: typeof flags.sections === "string" ? flags.sections : undefined,
+                registry: typeof flags.registry === "string" ? flags.registry : undefined,
+            });
+            break;
+        }
         case "use": {
             const slug = args[0];
             if (!slug) {

package/dist/install-marks.js

@@ -328,7 +328,12 @@
  * 0.16.492 -> 0.16.493 em 06/10, e o passo 1 dá **SIM** ("a galeria aprende", E02): o `init` declara as durações do
  * sistema no @theme (`--duration-fast`), e o blueprint as escreve pelo nome. Um componente escrito antes traz `100ms`.
  */
-export const MATERIALISER_SINCE = "0.16.494";
+/**
+ * 0.16.494 -> 0.16.497 em 15/10, e o passo 1 dá **SIM** (o pedido livre sai mastigado, E03): o bloco do `CLAUDE.md` sem o
+ * servidor diz que uma landing pedida em palavras livres passa primeiro pelo `landing`. Uma pasta escrita antes deixa o
+ * agente decidir a página inteira sozinho.
+ */
+export const MATERIALISER_SINCE = "0.16.497";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/registry.js

@@ -230,3 +230,27 @@ export async function postSaveComponent(base, payload) {
     }
     return (await res.json());
 }
+/**
+ * O PEDIDO LIVRE SAI MASTIGADO (jornada "o pedido livre sai mastigado", 15/10): a lista de seções de landing do catálogo
+ * e o prompt da pilha para as escolhidas. Os dois saem do registro - a mesma fonte do site -, e nunca de uma cópia aqui.
+ */
+export async function fetchLandingParts(base, slug) {
+    const url = new URL(`${base}/api/registry/ds/${encodeURIComponent(slug)}`);
+    url.searchParams.set("landing", "parts");
+    const res = await request(url.toString());
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok || !body.parts)
+        throw new RegistryError(body.message ?? `Registry responded ${res.status} for "${slug}".`);
+    return body.parts;
+}
+export async function fetchLandingPrompt(base, slug, sections, requestText) {
+    const url = new URL(`${base}/api/registry/ds/${encodeURIComponent(slug)}`);
+    url.searchParams.set("landing", "prompt");
+    url.searchParams.set("sections", sections.join(","));
+    url.searchParams.set("request", requestText);
+    const res = await request(url.toString());
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok || !body.prompt)
+        throw new RegistryError(body.message ?? `Registry responded ${res.status} for "${slug}".`);
+    return body.prompt;
+}

package/package.json

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