@softize/opus 11.1.1 → 12.0.1

package/src/ui/docs/content/getting-started.md

@@ -23,25 +23,35 @@ base versionada.
 > Projeto novo não se monta à mão: o esqueleto canônico sai do `opus create`, com os
 > pré-requisitos do protocolo, da UI e do preview já plugados — e os gates verdes.
 
+O Opus e a Base ficam no npm público: leitura não exige token nem configuração de escopo.
+Crie o projeto e materialize as duas camadas antes dos gates:
+
 ```bash
 pnpm dlx @softize/opus create meu-app
-cd meu-app && git init && pnpm install && pnpm test
+cd meu-app && git init && pnpm install && pnpm run setup && pnpm test
 ```
 
-O comando cria a estrutura inicial e instala a versão estável disponível. Para experimentar
-uma versão específica, acrescente-a ao pacote: `pnpm dlx @softize/opus@<versão> create meu-app`.
-Se o pnpm informar que o diretório global de binários não está no `PATH`, execute `pnpm setup`
-e abra uma nova sessão do terminal antes de tentar novamente.
+O comando cria a estrutura inicial e instala a versão estável disponível. Em uma máquina nova,
+se o `dlx` informar que o diretório global de binários não está no `PATH`, execute `pnpm setup`
+e abra outra sessão do terminal. Se o setup encontrar uma seção antiga do pnpm no arquivo de
+inicialização do shell (`ERR_PNPM_BAD_SHELL_SECTION`), `pnpm setup --force` substitui somente
+esse bloco.
+
+Durante as primeiras 24 horas de uma release, a quarentena do pnpm pode resolver silenciosamente
+uma versão anterior. Se o CLI responder com “Comando desconhecido”, informe a versão explicitamente
+com `pnpm dlx @softize/opus@<versão> create meu-app` ou desative a quarentena apenas nessa chamada
+com `pnpm --config.minimum-release-age=0 dlx …`. Dentro do projeto, o workspace exclui Opus e Base
+da quarentena para preservar o par validado.
 
 Nasce com: `opus.config.ts` + domínio-exemplo canônico (0 violações, spec documentada),
 vite + react + tema do Opus (Tailwind v4 CSS-first), dev server na porta que o Maestro
-injeta no preview, `opus.json` (pin), `CLAUDE.md` (bloco gerenciado), `.claude/memory/`
-e o CI de fábrica.
+injeta no preview, `opus.json` (pin), instruções, skills e hooks gerenciados. A Base é
+dona do método geral, memória e revisão; o Opus acrescenta somente o conhecimento do SDK.
 
 **Monorepo:** a raiz nasce do `--monorepo` e cada app nasce dentro dela — o create
-detecta o `pnpm-workspace.yaml` e gera só o que é do app (nada de `.npmrc`/workspace
-yaml aninhado), **avisando** o que a raiz precisa ter (glob de packages, escopo do
-registry, allowBuilds) sem tocar nos seus arquivos:
+detecta o `pnpm-workspace.yaml` e gera só o que é do app (sem workspace yaml aninhado),
+**avisando** o que a raiz precisa ter (glob de packages, allowBuilds e exclusões de
+quarentena para Opus/Base) sem tocar nos seus arquivos:
 
 ```bash
 pnpm dlx @softize/opus create meu-cliente --monorepo   # a raiz do workspace
@@ -54,14 +64,17 @@ pnpm dlx @softize/opus create apps/portal              # o app (modo detectado)
 > O `opus.json` registra a versão usada pelo projeto. Se o arquivo ainda não existe, o setup
 > cria a estrutura necessária antes das demais etapas.
 
-A versão do Opus fica pinada em `opus.json`. O `opus setup` é per-app: grava o `opus.json`,
-mantém o bloco gerenciado do `CLAUDE.md` (fora dele o arquivo é seu) e semeia o dia zero
-(`.claude/memory/`, CI) se faltarem. Os componentes e hooks vêm do barrel
-`@softize/opus/ui/react`; o tema, por CSS.
+A versão do Opus fica pinada em `opus.json`. O `opus setup` é per-app: grava o marcador,
+o inventário de copy e as projeções específicas do SDK. O `base setup` materializa o
+método geral, memória, agentes e revisão na raiz do repositório. Os componentes vêm do
+barrel `@softize/opus/ui/react`; o tema, por CSS.
 
 ```bash
-# Bootstrap per-app (idempotente): pin + bloco do CLAUDE.md + dia zero.
-npx @softize/opus setup
+# Bootstrap idempotente de um projeto existente.
+pnpm add @softize/opus
+pnpm add -D @softize/base
+pnpm exec opus setup
+pnpm exec base setup
 
 # index.css do app — o tema canônico + os componentes do Opus no scan do Tailwind.
 @import '@softize/opus/ui/theme.css';

package/src/ui/docs/content/split.md

@@ -1,6 +1,6 @@
 ## Split & Pane
 
-`Split` é o primitive espacial da UI. A ordem dos `Pane` define esquerda→direita (ou cima→baixo); o pane não sabe onde está. Sem `resizable`, é flex simples. Com ele, a fronteira vira arrastável sem trocar o modelo do componente.
+`Split` organiza áreas lado a lado ou uma sobre a outra. A ordem dos `Pane` define a posição de cada área. Sem `resizable`, o layout usa flex; com essa opção, a pessoa também pode ajustar as divisórias com ponteiro ou teclado.
 
 ```tsx preview
 render(
@@ -23,11 +23,51 @@ O `Pane` traz `inset="md"` por default. Use `none` para chrome, navegação e co
 
 ## Rail
 
-Um rail não é uma prop especial: é só o último pane.
+Quando uma área precisa continuar legível em telas largas, use uma unidade absoluta para o tamanho inicial ou mínimo. Números continuam representando porcentagens; strings aceitam `%`, `rem`, `em`, `vh`, `vw` e `px`. Prefira `rem` para acompanhar a escala tipográfica configurada pela aplicação.
 
 ```tsx
 <Split resizable>
   <Pane grow inset="none"><Main /></Pane>
-  <Pane initialSize={28} minSize={20} inset="none"><Inspector /></Pane>
+  <Pane initialSize="28rem" minSize="20rem" inset="none"><Inspector /></Pane>
 </Split>
 ```
+
+## Persistência
+
+Um layout pode ser restaurado sem acoplar `Split` a um mecanismo específico de armazenamento. Dê um `id` estável a cada `Pane`, leia o valor salvo para formar `defaultLayout` e persista apenas mudanças concluídas pela pessoa.
+
+```tsx
+function readLayout(key: string): SplitLayout | undefined {
+  if (typeof window === 'undefined') return undefined
+
+  try {
+    const parsed: unknown = JSON.parse(localStorage.getItem(key) ?? 'null')
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return undefined
+    const entries = Object.entries(parsed)
+    const valid = entries.every(([id, size]) =>
+      id !== '' && typeof size === 'number' && Number.isFinite(size) && size >= 0 && size <= 100,
+    )
+    return valid ? Object.fromEntries(entries) : undefined
+  } catch {
+    return undefined
+  }
+}
+
+const defaultLayout = readLayout('workspace-layout')
+
+<Split
+  id="workspace"
+  resizable
+  defaultLayout={defaultLayout}
+  onLayoutChanged={(layout, meta) => {
+    if (meta.isUserInteraction) {
+      localStorage.setItem('workspace-layout', JSON.stringify(layout))
+    }
+  }}
+>
+  <Pane id="navigation" initialSize="28rem" minSize="28rem"><Navigation /></Pane>
+  <Pane id="content" grow><Content /></Pane>
+</Split>
+```
+
+Em aplicações renderizadas no servidor, leia o armazenamento somente no cliente. `onLayoutChanged` também permite usar `sessionStorage` ou uma camada própria quando o layout precisa acompanhar outro escopo.

package/src/ui/react.tsx

@@ -207,7 +207,7 @@ export type { PageProps } from './components/patterns/page.tsx'
 
 // Layout composicional: Split decide a relação espacial; Pane carrega conteúdo com inset.
 export { Split, Pane } from './components/patterns/split.tsx'
-export type { SplitProps, PaneProps } from './components/patterns/split.tsx'
+export type { SplitProps, PaneProps, PaneSize, SplitLayout, SplitLayoutChange } from './components/patterns/split.tsx'
 
 // Barra lateral composicional: header/conteúdo/footer e navegação, sem possuir o layout.
 export { PaneHeader, PaneContent, PaneFooter, Sidebar, SidebarItem, SidebarNav } from './components/patterns/sidebar.tsx'

package/registry/skills/write-product-communication/SKILL.md

@@ -1,28 +0,0 @@
----
-name: write-product-communication
-description: Escreve e revisa comunicação de produto clara, humana e orientada ao leitor. Usar ao criar ou alterar documentação, mensagens de erro, textos de interface, CLI, onboarding, ajuda, explicações, comentários ou qualquer conteúdo que uma pessoa precise compreender.
----
-
-# Escrever comunicação de produto
-
-## Resultado
-
-Entregar uma comunicação que parte da situação do leitor, oferece o contexto necessário e
-permite que a pessoa compreenda ou prossiga sem decodificar a linguagem interna da equipe.
-
-## Procedimento
-
-1. Identificar quem lerá o texto, o que essa pessoa tenta fazer e o que precisa compreender ou
-   decidir em seguida.
-2. Ler a comunicação no fluxo completo em que aparecerá, incluindo estados anteriores e
-   posteriores.
-3. Escrever a partir do problema e do efeito percebido; introduzir mecanismos e termos técnicos
-   somente quando acrescentarem precisão.
-4. Distinguir princípios, regras, recomendações, comportamentos, verificações e exceções.
-5. Revisar o texto fora do contexto da implementação e remover pressupostos, slogans,
-   advertências desnecessárias e detalhes internos.
-6. Confirmar que erros explicam o ocorrido, o impacto e uma próxima ação real quando ela existir.
-
-## Referência canônica
-
-<!-- opus-doc: communication.md -->

package/registry/skills/write-product-communication/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Comunicação de produto"
-  short_description: "Escreva textos claros, humanos e úteis"
-  default_prompt: "Use $write-product-communication para revisar esta comunicação pelo ponto de vista do leitor."

package/registry/templates/app/_npmrc

@@ -1 +0,0 @@
-@softize:registry=https://registry.softize.com.br/

package/registry/templates/monorepo/_npmrc

@@ -1 +0,0 @@
-@softize:registry=https://registry.softize.com.br/