synthesisui 0.16.499 → 0.16.501

package/dist/claude-md.js

@@ -1,9 +1,18 @@
+import { existsSync } from "node:fs";
 import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { loadRoleRules, rolesContract } from "./role-rules.js";
 import { dirname, join } from "node:path";
 import { hasHook } from "./agent-wiring.js";
 import { declaredReference } from "./group-role.js";
 import { recallAvailable } from "./memory/availability.js";
 import { readResponsiveForm, responsiveLine } from "./responsive-form.js";
+/**
+ * A LEITURA - o caminho do sistema desde a fase 1 (18/10). Escrita uma vez e usada nos dois contratos: o de quem já tem
+ * sistema sem `rules.json` e o de quem chegou pela porta e ainda não tem sistema nenhum (fase 2).
+ */
+const READ_THE_PAGE = "**Once the first screen is done, offer to read it - once.** If their next message does not take the offer up, do not offer it again; they can still ask. When the person asks you to read their page - or right after the creation of the first screen ends (with impeccable, once it has written `DESIGN.md`; never while it still asks for another round) - run `npx synthesisui read` with the dev server up, tell them in a few lines the system it found, then ask the questions in `_synthesisui/reading.json` ONE AT A TIME with your question tool (the first option is the default). Save their answers as `{ \"<question id>\": <option index> }` and run `npx synthesisui read --confirm <that file>`: their answers become the roles and breaks this project keeps.";
+/** A frase do revisor depois da criação - ver o comentário em `renderRegion`, junto dos papéis. */
+const REVIEWER_AFTER_CREATION = "\n\n**How a change closes here.** The visual world is decided - the roles and breaks above. From here on SynthesisUI's check closes a change (`check_file`, and the end-of-turn check). Impeccable's reviewer is for creating: spawn `impeccable-finish-reviewer` or run `impeccable detect` only when the person asks for a new visual direction or a large new surface with its own look - never as the routine close of a change, and never its degraded self-review in its place.";
 const START = "<!-- synthesisui:start -->";
 const END = "<!-- synthesisui:end -->";
 /** Reads the installed DSs from the .lock files in _synthesisui/ds/<slug>/. */
@@ -336,9 +345,10 @@ async function renderRegion(projectRoot, installed) {
             "This project has the synthesisui agent set up and **no design system yet** - so there is",
             "no token vocabulary to follow, and nothing here to obey.",
             "",
-            "To turn this repository into one, run `/sui-import-ds` and I will read what is",
-            "already in the code: the colours, the type, the shapes and the components. Nothing",
-            "is invented, and nothing is copied out.",
+            READ_THE_PAGE,
+            "",
+            "A system kept somewhere else - a published one, or a repository's own - comes in with",
+            "`/sui-import-ds` instead: it reads what is already in the code. Nothing is invented.",
             "",
             "The `synthesisui` MCP server is registered, so ASK it instead of guessing - it",
             "answers what exists and what does not. This block fills itself in once a system is",
@@ -468,6 +478,18 @@ written now** - read the code before you edit it, never a remembered signature.`
      * 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.
      */
+    /**
+     * O REVISOR DA CAMADA DE ESTÉTICA SÓ NA CRIAÇÃO - decisão dele, 18/10 15:23 ("só na criação"). Antes da confirmação o
+     * impeccable segue as próprias instruções, revisor incluído: o mundo ainda está sendo criado. Com o sistema confirmado,
+     * fecha a mudança a nossa checagem. Pela instrução, nunca apagando o agente dele - compor, não forkar (15:25). A medida
+     * que motivou: no fluxo com o revisor em todo turno, 52 de 103 min e metade dos tokens (estudo de 18/10, seção 12).
+     */
+    /** Os papéis e as quebras que a página dele já decidiu - ver `role-rules.ts` (18/10). Só existe com `rules.json`. */
+    const roleRules = await loadRoleRules(projectRoot).catch(() => null);
+    const rolesLine = roleRules
+        ? rolesContract(roleRules) + (existsSync(join(projectRoot, ".claude", "skills", "impeccable")) ? REVIEWER_AFTER_CREATION : "")
+        : /** Sem rules.json ainda: o agente oferece a leitura (jornada "a leitura no agente", E03, 18/10). */
+            `\n\n${READ_THE_PAGE}`;
     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
         ? `
@@ -497,7 +519,7 @@ is \`remember_preference\`.`
             ? `**These are true without asking anyone:** use the project's OWN custom properties, exactly as
 this system declares them. No raw colours, spacings or radii that a token already covers, and never a
 new token invented in silence - say so instead, because a new token is a decision for a person. There
-is no component index for an adopted system: the tokens ARE the contract.${theirsLine}
+is no component index for an adopted system: the tokens ARE the contract.${theirsLine}${rolesLine}
 
 **What the vocabulary IS is not written here.** Fetch only the piece the task requires:
 \`system_doctrine\` for the rules and the voice, \`find_token\` for a value you are about to write.${memoryLine}${preferencesLine}${selfCheck}`
@@ -529,7 +551,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}${landingLine}${selfCheck}`
+manifest for an adopted system - the tokens ARE the contract.${theirsLine}${rolesLine}${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

package/dist/commands/add.js

@@ -81,6 +81,8 @@ const IGNORED = [
      * da mesma versão, em branches separadas, darem conflito numa linha só.
      */
     ".fetched-at.json",
+    /** A oferta da leitura, feita uma vez neste clone - ver `offerTheReading` (fase 2, 18/10). */
+    ".read-offered",
 ];
 const IGNORE_HEADER = "# Managed by synthesisui. The identity and the CSS are committed so a fresh\n" +
     "# clone is governed; the measurement and the local record are not, because\n" +

package/dist/commands/connect.js

@@ -316,7 +316,10 @@ export async function connect(opts) {
      * A PERGUNTA SÓ EXISTE ONDE HÁ ALGUÉM PARA RESPONDER. Em `--ci`, num pipe ou dentro de um agente,
      * `ask` vai `null` e a pasta decide - e a linha DIZ que foi ela, porque silêncio nunca é escolha.
      */
-    const interactive = !opts.ci && Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY);
+    const interactive = !opts.ci &&
+        opts.interactive !== false &&
+        Boolean(process.stdin.isTTY) &&
+        Boolean(process.stdout.isTTY);
     const chosen = await chooseAgents({
         root,
         flag: opts.agents,
@@ -471,7 +474,7 @@ export async function connect(opts) {
      */
     if (want.hook && wired.hook !== "skipped") {
         const before = await readAutoSync(root).catch(() => null);
-        const now = before ?? (await askToSendAtTurnEnd());
+        const now = before ?? (opts.interactive === false ? null : await askToSendAtTurnEnd());
         if (before === null && now !== null)
             await writeAutoSync(root, now);
         row(before === null, now === true
@@ -784,7 +787,8 @@ export async function connect(opts) {
         }
     }
     /** A mesma versão que a fiação do editor recebe - os dois pinam no mesmo número. */
-    await offerShellHook(opts.shell === true, opts.version);
+    if (opts.interactive !== false)
+        await offerShellHook(opts.shell === true, opts.version);
     /**
      * O REINÍCIO SÓ QUANDO ELE É NECESSÁRIO - e pedi-lo sempre é o que fez o dono achar que reiniciar
      * o editor fazia parte do fluxo (07/08).

package/dist/commands/hook.js

@@ -1,6 +1,7 @@
 import { readFile, stat, writeFile } from "node:fs/promises";
 import { ourSpellingLines } from "../our-spelling.js";
-import { join, relative, resolve } from "node:path";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
 import { readAutoSync, startSync } from "../auto-sync.js";
 import { changedSince } from "../changed-files.js";
 import { emptyTally, exportedNames, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
@@ -8,6 +9,7 @@ import { checkContracts } from "../doctor/contract-check.js";
 import { componentOf } from "../doctor/component-of.js";
 import { appendEvent, ledgerPath } from "../doctor/ledger.js";
 import { describeOffScale, diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
+import { checkRoles, loadRoleRules, onlyOnce } from "../role-rules.js";
 import { declarados, falaDaPrateleira, naPrateleira } from "../doctor/shelf.js";
 import { governs, ungovernedIn } from "../governed.js";
 import { readMode } from "../mode.js";
@@ -313,6 +315,9 @@ async function report(root, filePath, mode) {
     const offScale = describeOffScale(d.files);
     /** A nossa grafia no arquivo dele - ver `our-spelling.ts`. Entra nas mesmas portas que os `phantoms`. */
     const ours = d.tokenUses;
+    /** Os papéis e as quebras que a página dele já decidiu - ver `role-rules.ts` (18/10). */
+    const roleRules = await loadRoleRules(root).catch(() => null);
+    const roles = roleRules ? await onlyOnce(root, rel, checkRoles(rel, src, roleRules, root)) : [];
     // Every check leaves one line in the ledger - INCLUDING the clean ones,
     // because a fix is itself a write, so the clean re-check of a file that was
     // just flagged is the evidence the agent read the report and acted. Without
@@ -327,6 +332,7 @@ async function report(root, filePath, mode) {
         phantoms: phantoms.length,
         unnamed: unnamed.length,
         offScale: d.files.reduce((n, f) => n + (f.offScale?.length ?? 0), 0),
+        ...(roleRules ? { roles: roles.length } : {}),
         ...(component ? { component } : {}),
     });
     /** O bloqueio de CONSUMIR é a única saída que recusa, e ele acompanha o relatório seja qual for. */
@@ -338,6 +344,7 @@ async function report(root, filePath, mode) {
         phantoms.length === 0 &&
         offScale.length === 0 &&
         unnamed.length === 0 &&
+        roles.length === 0 &&
         ours === 0) {
         const hello = await greet(root, rel);
         return hello ? say(hello) : null;
@@ -376,6 +383,7 @@ async function report(root, filePath, mode) {
         named.length === 0 &&
         phantoms.length === 0 &&
         offScale.length === 0 &&
+        roles.length === 0 &&
         ours === 0)
         return say(broke.join("\n"));
     const sample = unnamed
@@ -387,6 +395,7 @@ async function report(root, filePath, mode) {
         named.length === 0 &&
         phantoms.length === 0 &&
         offScale.length === 0 &&
+        roles.length === 0 &&
         ours === 0)
         return say([
             `${rel} - ${unnamed.length} value${unnamed.length === 1 ? "" : "s"} here ${unnamed.length === 1 ? "has" : "have"} no name in this system, and nothing to replace ${unnamed.length === 1 ? "it" : "them"} with: ${sample}${unnamed.length > 3 ? `, +${unnamed.length - 3} more` : ""}.`,
@@ -413,6 +422,9 @@ async function report(root, filePath, mode) {
         ...(broke.length > 0 ? [...broke, ""] : []),
         `${rel} - checked against ${table.name ?? table.slug}.`,
     ];
+    if (roles.length > 0) {
+        lines.push("", "Headings that leave the role this project already decided (read from its own pages):", ...roles, "", "Fix these now, while you have the file open - one role, one class.");
+    }
     if (named.length > 0) {
         lines.push("", "Values written by hand that this system already has a name for:", ...named
             .slice(0, 20)
@@ -459,8 +471,28 @@ const namedInPayload = (input) => {
         input.tool_name === "MultiEdit";
     return writes ? (input.tool_input?.file_path ?? null) : null;
 };
+/**
+ * A RAIZ É O PROJETO, NÃO A PASTA ONDE A SESSÃO PAROU - jornada "a leitura no agente", E01 (18/10).
+ *
+ * O Claude Code roda o gancho na pasta em que o terminal do agente está. Na rodada dos relógios, o agente terminou os
+ * turnos 3 e 7 com `cd .impeccable/review`; o fim do turno rodou ali, não achou `_synthesisui/` e passou calado - a
+ * página de cada relógio, o trabalho inteiro do turno 3, nunca foi conferida. A ordem: a pasta que o Claude Code
+ * declara (`CLAUDE_PROJECT_DIR`), quando ela é um projeto nosso; senão, a pasta mais próxima, subindo, que tenha
+ * `_synthesisui/`; senão, onde estamos (o comportamento de antes).
+ */
+export function projectRootFrom(cwd, env = process.env) {
+    const declared = env.CLAUDE_PROJECT_DIR;
+    if (declared && existsSync(join(declared, "_synthesisui")))
+        return resolve(declared);
+    for (let dir = resolve(cwd);; dir = dirname(dir)) {
+        if (existsSync(join(dir, "_synthesisui")))
+            return dir;
+        if (dirname(dir) === dir)
+            return resolve(cwd);
+    }
+}
 export async function hook(opts) {
-    const root = resolve(opts.dir ?? process.cwd());
+    const root = resolve(opts.dir ?? projectRootFrom(process.cwd()));
     let raw = "";
     for await (const chunk of process.stdin)
         raw += chunk;
@@ -711,7 +743,11 @@ async function endOfTurn(root, input) {
         await startSync(root).catch(() => false);
     const out = (frame) => process.stdout.write(`${JSON.stringify(frame)}\n`);
     if (input.stop_hook_active) {
-        out(pass());
+        /** A única exceção à passagem calada: a oferta que ainda não chegou à resposta final - ver `offerTheReading`. */
+        const again = existsSync(join(root, "_synthesisui", READ_OFFERED_FILE))
+            ? await offerTheReading(root, [], input.transcript_path).catch(() => null)
+            : null;
+        out(again ? { decision: "block", reason: again } : pass());
         return;
     }
     const clock = await turnClockOf(root);
@@ -731,10 +767,166 @@ async function endOfTurn(root, input) {
     const grown = await takeGrowthNote(root).catch(() => null);
     if (grown)
         said.push(grown);
+    const offer = await offerTheReading(root, changed, input.transcript_path, clock).catch(() => null);
     await moveTurnClock(root);
-    out(said.length === 0
+    out(said.length === 0 && !offer
         ? pass()
-        : { decision: "block", reason: [...said, CLOSE_THE_TURN].join("\n\n") });
+        : { decision: "block", reason: [...said, offer ?? CLOSE_THE_TURN].join("\n\n") });
+}
+/** O arquivo que lembra que a oferta já foi feita neste clone - ignorado pelo git (ver `add.ts`). */
+export const READ_OFFERED_FILE = ".read-offered";
+/** Uma tela: o que o agente escreve quando faz interface. CSS conta - a primeira tela do impeccable mexe no globals. */
+const SCREEN = /\.(tsx|jsx|vue|svelte|astro|html|css|scss)$/;
+/**
+ * A LEITURA OFERECIDA SOZINHA - E03 da jornada "um instalador, uma porta" (fase 2, 18/10). O dono: *"o agente oferece a
+ * leitura sozinho depois da primeira tela"*. A linha do contrato já dizia "depois da primeira tela, ofereça" - e o agente
+ * só oferecia quando a pessoa pedia (medido na fase 1). O fim do turno é o único momento que vê o turno inteiro, então é
+ * ele quem pede.
+ *
+ * QUANDO A CRIAÇÃO ACABOU, NÃO NO MEIO DELA - decisão dele em 19/10, depois de seis rodadas reais. O impeccable tem um
+ * fim: a última coisa que ele escreve é o `DESIGN.md` (1-2 min antes do fim nas 3 rodadas que terminaram, porta-1, 3 e 6;
+ * ausente nas 3 em que a criação ainda perguntava "outra rodada?", porta-2, 4 e 5). Oferecer antes disso punha duas
+ * perguntas na mesma resposta, e a do impeccable ganhava. Então: com o impeccable no projeto, o sinal é o `DESIGN.md`
+ * escrito; sem ele, a primeira tela.
+ *
+ * FEITA É QUANDO ESTÁ NA RESPOSTA FINAL. Enquanto a última resposta do agente não oferece a leitura, o fim do turno pede de
+ * novo - três vezes no máximo. Depois de oferecida, ela vale até a PESSOA falar: na porta-6 a oferta saiu certa e os
+ * subagentes do impeccable acordaram o agente mais 4 vezes, e a resposta final ficou sem ela. Enquanto a pessoa não falou
+ * e a última resposta não tem a oferta, ela volta no fim (cinco renovações no máximo, a trava contra laço). Quando a
+ * pessoa fala, acabou: a recusa não vira insistência.
+ *
+ * SÓ NA PORTA: projeto sem sistema nenhum. Quem já tem um (do catálogo, importado, ou o da leitura com `rules.json`)
+ * escolheu o caminho dele (achado na suíte, 18/10: o fecho do turno de um sistema instalado passou a terminar na oferta).
+ * Sem o registro da conversa não há como ler a resposta - e aí se pede uma vez só.
+ */
+const MAX_OFFERS = 3;
+const MAX_RENEWALS = 5;
+export async function offerTheReading(root, changed, transcript, since = 0) {
+    const ds = join(root, "_synthesisui", "ds");
+    if (existsSync(ds) && readdirSync(ds).some((d) => statSync(join(ds, d)).isDirectory()))
+        return null;
+    const marker = join(root, "_synthesisui", READ_OFFERED_FILE);
+    const save = (s) => writeFile(marker, `${JSON.stringify(s)}\n`);
+    if (!existsSync(marker)) {
+        if (!(await creationDone(root, changed, since)))
+            return null;
+        await save({ count: 1, at: Date.now() });
+        return OFFER;
+    }
+    let state = null;
+    try {
+        state = JSON.parse(await readFile(marker, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (!state || !transcript)
+        return null;
+    if (state.delivered) {
+        if ((state.renewals ?? 0) >= MAX_RENEWALS)
+            return null;
+        if (await lastReplyOffers(transcript))
+            return null;
+        if (typeof state.deliveredAt !== "number" || (await personSpokeAfter(transcript, state.deliveredAt))) {
+            await save({ ...state, renewals: MAX_RENEWALS });
+            return null;
+        }
+        await save({ ...state, renewals: (state.renewals ?? 0) + 1 });
+        return `You were woken up again after offering it, so it is no longer at the end of your reply. ${OFFER}`;
+    }
+    if ((state.count ?? MAX_OFFERS) >= MAX_OFFERS)
+        return null;
+    if (await lastReplyOffers(transcript)) {
+        await save({ ...state, delivered: true, deliveredAt: Date.now() });
+        return null;
+    }
+    const count = (state.count ?? 0) + 1;
+    await save({ ...state, count, at: Date.now() });
+    return `Your last reply did not offer it. ${OFFER}`;
+}
+/**
+ * A CRIAÇÃO ACABOU NESTE TURNO? Com o impeccable (a skill que o instalador DELE escreve), o `DESIGN.md` na raiz, e escrito
+ * ou acompanhado de uma tela neste turno - um `DESIGN.md` antigo, sem tela nova, não é fim de criação nenhuma. Sem o
+ * impeccable, a primeira tela.
+ */
+async function creationDone(root, changed, since) {
+    const screen = changed.some((c) => SCREEN.test(c.rel));
+    if (!existsSync(join(root, ".claude", "skills", "impeccable")))
+        return screen;
+    const design = await stat(join(root, "DESIGN.md")).catch(() => null);
+    if (!design?.isFile())
+        return false;
+    return screen || design.mtimeMs >= since;
+}
+const OFFER = "The creation of this project's first screen is done, and it has no system yet. Answer anything above in a line or two, then the summary of what this turn did - and END your reply with ONE sentence offering to read the page and turn what it already decided into their design system (about a minute, a few questions). That sentence is the LAST line, after any question of your own. If they say yes, follow the contract: `npx synthesisui read` with the dev server up. Offer it ONCE: if their next message does not take it up, that is a no - never offer it again in later turns.";
+/**
+ * A ÚLTIMA RESPOSTA DO AGENTE OFERECE A LEITURA? A última entrada `assistant` com texto, no registro. Nas quatro rodadas
+ * em que ele ofereceu, a frase tinha as duas coisas: ler a página (ou o site) e o sistema - "Want me to read the page and
+ * turn what it's already decided into your design system?". Na porta-7 (19/10) a oferta veio pelo nome do comando, sem
+ * "page": "I can run `npx synthesisui read` and ask you a few questions to lock in the design system".
+ */
+export async function lastReplyOffers(transcript) {
+    const raw = await readFile(transcript, "utf8").catch(() => null);
+    if (raw === null)
+        return false;
+    for (const line of raw.split("\n").reverse()) {
+        if (!/"type":\s*"assistant"/.test(line))
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const c = e.message?.content;
+        const text = Array.isArray(c)
+            ? c.filter((x) => x?.type === "text").map((x) => x.text ?? "").join(" ")
+            : typeof c === "string" ? c : "";
+        if (!text.trim())
+            continue;
+        if (!/\bsystem\b/i.test(text))
+            return false;
+        return /\bread\b[^.?!]{0,60}\b(page|site|landing)\b/i.test(text) || /synthesisui read\b/i.test(text);
+    }
+    return false;
+}
+/**
+ * A PESSOA FALOU DEPOIS DE `at`? No registro, a fala dela é uma entrada `user` que não é meta, não é resultado de
+ * ferramenta, não é o retorno de um gancho e não é o aviso de um subagente - os três últimos também chegam como `user`.
+ * Sem o registro, conta como falou: na dúvida, não se insiste.
+ */
+export async function personSpokeAfter(transcript, at) {
+    const raw = await readFile(transcript, "utf8").catch(() => null);
+    if (raw === null)
+        return true;
+    for (const line of raw.split("\n").reverse()) {
+        if (!/"type":\s*"user"/.test(line))
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (e.type !== "user" || e.isMeta || !e.timestamp)
+            continue;
+        if (!(Date.parse(e.timestamp) > at))
+            return false;
+        const c = e.message?.content;
+        const text = typeof c === "string"
+            ? c
+            : Array.isArray(c) && !c.some((x) => x?.type === "tool_result")
+                ? c.map((x) => x?.text ?? "").join(" ")
+                : null;
+        if (text === null)
+            continue;
+        if (/^\s*(<task-notification>|<command-|<system-reminder>|Stop hook feedback)/.test(text))
+            continue;
+        return true;
+    }
+    return false;
 }
 /**
  * A ÚLTIMA MENSAGEM É O RESUMO, NÃO O RODAPÉ - bateria ampliada, item 19 (29/09). Este bloqueio faz o agente responder

package/dist/commands/init.js

@@ -2,10 +2,12 @@ import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { DEFAULT_CONFIG, resolveRegistry, writeProjectConfig, } from "../config.js";
 import { readProjectTheme, writeBesideTheirs, writeNewProjectRoot, writeNewProjectTheme, } from "../new-project-theme.js";
+import { openTheDoor } from "../door.js";
 import { body, section, snippet } from "../output.js";
 import { fetchDesignSystem } from "../registry.js";
 import { resolveDeps, stylesFor, tailwindMajor } from "../stack.js";
 import { formMix, measuredStyle } from "../styles-flavour.js";
+import { desligarCaptura, ligarCaptura } from "../transcript.js";
 import { add } from "./add.js";
 const whereOf = (answer) => answer === "file" || answer === "1"
     ? "file"
@@ -57,6 +59,14 @@ export async function init(opts) {
      */
     if (opts.ds)
         await fetchDesignSystem(resolveRegistry(opts.registry), opts.ds);
+    /**
+     * SEM `--ds`, O `init` É A PORTA (fase 2, 18/10) - ver `door.ts`. O que ele imprimia sobre o config continua sendo
+     * calculado igual, só que guardado: a porta fecha com um resumo de cinco linhas, e o detalhe do config é o que menos
+     * importa para quem acabou de chegar.
+     */
+    const door = !opts.ds;
+    if (door)
+        ligarCaptura();
     const target = opts.target === "general" ? "general" : "next";
     const config = {
         target,
@@ -270,11 +280,14 @@ export async function init(opts) {
         console.log(body("first clean file and goes quiet after that."));
         return;
     }
-    console.log("");
-    console.log("Next steps:");
-    console.log("  • synthesisui connect                 wire your agent to the system");
-    console.log("  • synthesisui add <slug>              bring a design system in");
-    console.log("  • synthesisui template <slug> <name>  materialize a full page");
+    await openTheDoor({
+        root,
+        version: opts.cli ?? "latest",
+        ...(opts.registry ? { registry: opts.registry } : {}),
+        ...(opts.pkg ? { pkg: opts.pkg } : {}),
+        ...(opts.aesthetic ? { aesthetic: opts.aesthetic } : {}),
+        configLines: desligarCaptura(),
+    });
 }
 /**
  * O QUE O `init` ACABOU DE DECLARAR VAI PARA O `.lock` (jornada "o pedido livre sai mastigado", 15/10).