@softize/opus 8.6.6

package/docs/releasing.md

@@ -0,0 +1,110 @@
+---
+title: Publicar o pacote
+order: 6
+---
+
+# Publicar o @softize/opus
+
+O Opus é publicado no **registry compartilhado da Softize** (`registry.softize.com.br`),
+**não** no npm público. Os clientes consomem de lá.
+
+> O `publishConfig` do `package.json` já aponta pra lá — `pnpm publish` "só funciona",
+> sem `--registry`. Não precisa decorar a URL.
+
+## Release pela estação (o caminho normal)
+
+```bash
+pnpm release            # patch bump + publica no registry.softize.com.br
+pnpm release minor      # minor
+pnpm release major      # major
+pnpm release 2.9.0      # versão explícita
+pnpm release none       # publica sem bump
+```
+
+Auth: o token do registry no `~/.npmrc` global (`//registry.softize.com.br/:_authToken=…`),
+NÃO commitado.
+
+## Não existe caminho pela CI (29/jul)
+
+A camada de GitHub Actions foi **removida** deste repo — `.github/` não existe mais. Saíram
+o `release.yml` (publicava por tag `v*`), o `deploy.yml` (doc, já reserva) e o `check.yml`
+(typecheck+test em push/PR). É a mesma decisão do monorepo (ADR 0008 do softize): um
+caminho só, na estação, com os gates junto. Não há gatilho de reserva.
+
+O secret **`OPUS_REGISTRY_TOKEN`** ficou órfão — nada mais o lê. Apague no GitHub. O que
+autentica hoje é o token do registry no seu `~/.npmrc` global.
+
+**O que o `release.sh` absorveu**, porque sem CI ficaria sem dono:
+
+- **Procedência** — as três guardas que só o `deploy-docs.sh` tinha: precisa estar na
+  `main`, com árvore limpa (`--porcelain`, que pega não-rastreado) e igual a `origin/main`.
+  Rodam ANTES do bump, que suja a árvore de propósito. Antes isso vinha de graça: a release
+  nascia de um checkout limpo da tag, e a árvore do dev nunca entrava no tarball.
+- **Bump na main, automático** — a guarda `tag=versão` do CI existia pra impedir registry e
+  main divergindo em silêncio. Como aqui o bump acontece DEPOIS (o script versiona e
+  publica), a proteção equivalente é o script commitar e empurrar o bump sozinho ao fim. Se
+  o push falhar depois de o publish ter ido, ele grita e sai 1 — a versão existe pro cliente
+  e não existe no repo, e isso não pode passar como aviso no meio do log.
+- **Smoke do esqueleto** — já tinha descido pro script antes (ver abaixo).
+
+`--local` (Verdaccio) não passa pelas guardas de procedência: é sandbox, e exigir main limpa
+pra testar publicação seria a guarda atrapalhando quem está experimentando.
+
+**Gate de qualidade**: antes de bumpar/publicar roda `pnpm typecheck`
++ `pnpm test` e **aborta a release se qualquer um falhar**. Como o Opus **ship source** (`.ts`,
+sem build), essa é a última barreira antes do tarball — sem ela, um `tsc` vermelho vaza pro
+cliente. Emergência (evite): `pnpm release --skip-checks`.
+
+**Smoke do esqueleto**: depois do bump e antes do publish, o `release.sh` gera um app com
+`opus create`, instala o **tarball exato** que vai ser publicado e roda os gates dele
+(typecheck · test · `opus check` · manifest · build). É o que pega o que typecheck+test não
+alcançam — `files` mal recortado, export que só resolve por caminho relativo, template
+pinado numa versão que ainda não existe no registry. Ele vivia só no `release.yml`; como as
+últimas releases saíram pela estação (sem tag), passou tempo sem rodar, e foi assim que o
+template chegou a quebrar o `tsc` de um app recém-criado. `--skip-checks` pula junto.
+
+O script bumpa, publica **e leva o bump pra `origin/main`** — não sobra passo manual. Em
+`--local` ele não commita nada (Verdaccio é sandbox), e com `pnpm release none` não há bump
+pra commitar.
+
+## Verificar
+
+```bash
+npm view @softize/opus version --registry https://registry.softize.com.br/
+# ou
+curl -s https://registry.softize.com.br/@softize%2fopus | node -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>console.log(JSON.parse(d)['dist-tags'].latest))"
+```
+
+## Testar localmente (sem tocar no compartilhado)
+
+Para validar uma mudança de API em consumidores locais, publique uma **prerelease** no
+Verdaccio e instale exatamente essa versão. Isso reproduz o pacote como será consumido —
+sem `link:`/`file:`, que podem mascarar exports e peers.
+
+```bash
+# terminal 1 — uma vez por máquina/sessão
+pnpm registry:up                              # Verdaccio em 127.0.0.1:6873
+
+# terminal 2 — no Opus
+pnpm version 8.7.0-rc.0 --no-git-tag-version # escolha uma versão ainda não publicada
+# adicione a seção "## 8.7.0-rc.0" ao CHANGELOG.md
+pnpm release:local none                       # gates + publish SOMENTE local
+
+# em cada consumidor
+pnpm add @softize/opus@8.7.0-rc.0 --registry http://127.0.0.1:6873/
+```
+
+Valide o app normalmente. Ao encerrar a sessão, restaure o intervalo de versão do
+consumidor para o registry compartilhado e rode `pnpm install`; a prerelease local nunca
+é enviada para `registry.softize.com.br`. Para publicar outra tentativa, incremente o
+sucesso (`8.6.0-rc.1`, por exemplo) e repita o mesmo fluxo.
+
+## Auth
+
+O publish no compartilhado exige o token no **`~/.npmrc` global** do dev:
+
+```
+//registry.softize.com.br/:_authToken=<token>
+```
+
+Não vai no repo. Leitura (install) é aberta — não precisa de token.

package/docs/shellnav.md

@@ -0,0 +1,131 @@
+# Proposta: `ShellNav` — o menu como primitivo pivotável
+
+> **Status: EM DISCUSSÃO.** Desenhado com o João (2026-07-22), a partir do trabalho na
+> cabine do Maestro (a nav do projeto virou `SectionShell`; a sidebar ganhou Início +
+> Configurações). Pendente de aprovação e de uma versão do Opus. Refina o
+> [`ownership-vs-shadcn-lock`](ownership-vs-shadcn-lock.md): o item de menu é o próximo
+> primitivo a sair do "cada app copia ad-hoc".
+
+## O problema
+
+O `AppShell` entrega a **moldura** da sidebar (o slot `sidebarNav`) e o `SectionShell`
+entrega a **nav de seção** (nav + painel, dentro do conteúdo). Mas o **item de menu** — a
+linha com ícone + label + estado ativo + badge — não é primitivo de ninguém: cada app
+escreve o `<button className="…">` na mão. Resultado, medido (não suposto):
+
+| Menu | Onde | Como é feito hoje |
+|---|---|---|
+| Aplicação (sidebar) | `AppShell.sidebarNav` | `<button>` à mão — sem primitivo |
+| Configurações | dentro do conteúdo | `SectionShell` (primitivo) ✓ |
+| Relatórios | dentro do conteúdo | `<aside>`/`<nav>` à mão — **não usa o SectionShell**, mesmo sendo a mesma forma |
+
+E isso se repete em **três produtos** (`softize/apps/maestro`, `softize/apps/main/web`,
+`empresa-x/apps/main`), cada um com a própria cópia do item — e, dentro de cada um, o
+markup ainda se repete por estado (ativo/inativo/recolhido) e nível (pai/filho).
+
+Dois fatos que calibram a urgência:
+
+- **Não é drift visível — é duplicação + risco.** Diff token a token: mesma versão do Opus
+  (2.37), mesmo `--radius` (0.625rem), classes de forma **byte-a-byte iguais**
+  (`rounded-md px-2.5 py-1.5 gap-2.5`). Só continuam iguais porque um humano copia; nada
+  cobra. A "sensação de divergência" (item mais retangular numa app que noutra) vem de
+  comparar **componentes diferentes** (nav de app × nav de seção × switcher), não de drift
+  do mesmo componente.
+- **Já há uma inconsistência viva:** o menu de Relatórios do GB é uma nav-dentro-do-conteúdo
+  — a MESMA forma do Configurações — e mesmo assim hand-rola em vez de usar o `SectionShell`.
+
+## A proposta
+
+Um primitivo só: **`ShellNav`** — **pivotável e controlado** (presentacional, como o
+`SectionShell` já é). O app passa **dados**, não markup, e o mesmo componente serve os dois
+lares sem flag de "modo app" vs "modo seção":
+
+- Na **sidebar do AppShell** (`sidebarNav={<ShellNav …/>}`): lê o estado de recolhido do
+  contexto `useAppShell` e vira ícone-só sozinho.
+- **Dentro do conteúdo** (o que o `SectionShell` faz): sem esse contexto, renderiza
+  expandido. O `SectionShell` **passa a compor** `ShellNav` (a nav) + o painel — um nav,
+  dois lares.
+
+Isto é o "tanto faz onde, mesmo comportamento": o componente **se adapta ao contexto** via
+`useAppShell`, sem o consumidor configurar nada.
+
+### Heading com espaço pra botão
+
+Slot `heading` — título + ação opcional. É o "+" de novo relatório, o título da seção, a
+marca na sidebar. Trivial e resolve o gesto que hoje mora à mão em cada nav.
+
+### Árvore embutida; DnD composto (a régua)
+
+- **Aninhamento/árvore → dentro do `ShellNav`.** Não é feature nova: o accordion da sidebar
+  (Vendas → Leads/Propostas, no GB) já é uma árvore de um nível. Barato, já necessário.
+- **Drag-drop de reordenar → COMPOSTO por fora**, estilo `dnd-kit`: o `ShellNav` expõe a
+  costura (um wrapper de item + um slot pro indicador de drop); um companheiro
+  (`useNavReorder`) pluga o arrasto só onde se opta. O peso — estado de drag, indicadores,
+  toque e principalmente a **a11y** (nav é *landmark*; reorder é *widget de manipulação* —
+  identidades diferentes) — vive fora do primitivo.
+
+  **O critério (viaja pra próximas decisões de primitivo): embute o que a maioria
+  compartilha; compõe o que um só precisa.** Reordenar é feature de um consumidor (só o
+  Relatórios); embuti-la faria os muitos pagarem a complexidade pelo um.
+
+### GB é a aparência de referência
+
+Das três, a implementação do GB é a mais madura (tem rail/colapso, accordion, estados
+ativos, âncora inferior de Configurações). **O `ShellNav` codifica o look do GB como
+default** — nada regride: o GB migra pro primitivo e renderiza igual; a cabine (já alinhada
+às classes do GB) passa a ser *literalmente* o mesmo componente, e a "sensação de
+retangular" some. A **identidade por app** continua nos **tokens** (`--radius`, cores — o
+Opus já permite sobrescrever no `theme.css` do app), não num fork do componente: a forma é
+compartilhada; a pele é temável.
+
+## API (esboço)
+
+```tsx
+interface ShellNavItem {
+  id: string
+  label: string
+  icon?: ReactNode
+  badge?: ReactNode
+  disabled?: boolean
+  children?: ShellNavItem[]        // accordion (app) / pasta (relatórios)
+}
+interface ShellNavGroup { label?: string; items: ShellNavItem[] }
+
+interface ShellNavProps {
+  groups: ShellNavGroup[]
+  activeId?: string
+  onSelect: (id: string) => void
+  heading?: ReactNode              // título + espaço pra botão (o "+" do Relatórios)
+  footer?: ReactNode               // âncora inferior (Configurações, no app)
+  collapsed?: boolean              // override; default lê do useAppShell quando presente
+  navLabel?: string
+  reorder?: NavReorderSeam         // opt-in; sem isto, ZERO DnD (o dnd-kit/useNavReorder pluga aqui)
+}
+
+// Conveniência do heading (padroniza título + ação):
+<ShellNavHeading title="Relatórios" action={<Button size="icon" icon={Plus} …/>} />
+```
+
+O `SectionShell` reescreve por dentro pra `<ShellNav/>` + painel; sua API pública não muda
+(consumidores existentes seguem).
+
+## Hoje × proposto
+
+| Menu | Hoje | Proposto |
+|---|---|---|
+| App (sidebar) | `<button>` à mão, N cópias por estado | `AppShell sidebarNav={<ShellNav groups footer=Configurações/>}` — colapso via contexto |
+| Configurações | `SectionShell` (nav+painel à mão por dentro) | `SectionShell` compõe `ShellNav` — sem mudança pro consumidor |
+| Relatórios | `<aside>` + tree + DnD, tudo à mão | `<ShellNav heading={título+"+"} …/>` + `useNavReorder` ao lado |
+
+## Consequências / plano
+
+- **Escopo:** sessão dedicada no Opus (não é ajuste de app). Ciclo: desenhar a API →
+  publicar versão do Opus → migrar os consumidores (cada `<button>` à mão vira `groups={…}`).
+- **Custo:** baixo em código, alto em coordenação (bump + migração dos 3 produtos + gates
+  em cada). O `SectionShell` é o precedente vivo — foi o mesmo movimento, um nível abaixo.
+- **Ordem sugerida:** (1) `ShellNav` + `ShellNavHeading` no Opus com o look do GB como
+  default; (2) `SectionShell` passa a compor; (3) migrar a cabine do Maestro (primeiro
+  cliente, já alinhada); (4) migrar o back-office; (5) migrar o Relatórios do GB pra
+  `ShellNav` + `useNavReorder` (fecha a inconsistência viva).
+- **Não-objetivo:** o `ShellNav` não vira dono de DnD, tree-editor ou roteamento — segue
+  presentacional/controlado; o app é dono do roteamento e do estado.

package/package.json

@@ -0,0 +1,338 @@
+{
+  "name": "@softize/opus",
+  "version": "8.6.6",
+  "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "exports": {
+    ".": {
+      "types": "./src/core/index.ts",
+      "default": "./src/core/index.ts"
+    },
+    "./package.json": "./package.json",
+    "./check": {
+      "default": "./bin/lib/check.mjs"
+    },
+    "./introspect": {
+      "default": "./bin/lib/introspect.mjs"
+    },
+    "./init": {
+      "default": "./bin/lib/init.mjs"
+    },
+    "./docs-include": "./bin/lib/docs-include.mjs",
+    "./core": {
+      "types": "./src/core/index.ts",
+      "default": "./src/core/index.ts"
+    },
+    "./audit": {
+      "types": "./src/audit/index.ts",
+      "default": "./src/audit/index.ts"
+    },
+    "./audit/console": {
+      "types": "./src/audit/drivers/console.ts",
+      "default": "./src/audit/drivers/console.ts"
+    },
+    "./audit/pg": {
+      "types": "./src/audit/drivers/pg.ts",
+      "default": "./src/audit/drivers/pg.ts"
+    },
+    "./auth": {
+      "types": "./src/auth/index.ts",
+      "default": "./src/auth/index.ts"
+    },
+    "./auth/jwt": {
+      "types": "./src/auth/drivers/jwt.ts",
+      "default": "./src/auth/drivers/jwt.ts"
+    },
+    "./auth/better-auth": {
+      "types": "./src/auth/drivers/better-auth.ts",
+      "default": "./src/auth/drivers/better-auth.ts"
+    },
+    "./client": {
+      "types": "./src/client/index.ts",
+      "default": "./src/client/index.ts"
+    },
+    "./client/fetch": {
+      "types": "./src/client/drivers/fetch.ts",
+      "default": "./src/client/drivers/fetch.ts"
+    },
+    "./data": {
+      "types": "./src/data/index.ts",
+      "default": "./src/data/index.ts"
+    },
+    "./data/kysely": {
+      "types": "./src/data/drivers/kysely.ts",
+      "default": "./src/data/drivers/kysely.ts"
+    },
+    "./data/readonly-pool": {
+      "types": "./src/data/readonly-pool.ts",
+      "default": "./src/data/readonly-pool.ts"
+    },
+    "./dsl": {
+      "types": "./src/dsl/index.ts",
+      "default": "./src/dsl/index.ts"
+    },
+    "./events": {
+      "types": "./src/events/index.ts",
+      "default": "./src/events/index.ts"
+    },
+    "./events/mitt": {
+      "types": "./src/events/drivers/mitt.ts",
+      "default": "./src/events/drivers/mitt.ts"
+    },
+    "./log": {
+      "types": "./src/log/index.ts",
+      "default": "./src/log/index.ts"
+    },
+    "./log/pino": {
+      "types": "./src/log/drivers/pino.ts",
+      "default": "./src/log/drivers/pino.ts"
+    },
+    "./queue": {
+      "types": "./src/queue/index.ts",
+      "default": "./src/queue/index.ts"
+    },
+    "./queue/bullmq": {
+      "types": "./src/queue/drivers/bullmq.ts",
+      "default": "./src/queue/drivers/bullmq.ts"
+    },
+    "./scheduler": {
+      "types": "./src/scheduler/index.ts",
+      "default": "./src/scheduler/index.ts"
+    },
+    "./scheduler/node-cron": {
+      "types": "./src/scheduler/drivers/node-cron.ts",
+      "default": "./src/scheduler/drivers/node-cron.ts"
+    },
+    "./storage": "./src/storage/index.ts",
+    "./storage/fs": "./src/storage/drivers/fs.ts",
+    "./storage/s3": "./src/storage/drivers/s3.ts",
+    "./ai": "./src/ai/index.ts",
+    "./ai/anthropic": "./src/ai/drivers/anthropic.ts",
+    "./mcp": "./src/mcp/index.ts",
+    "./testing": {
+      "types": "./src/testing/index.ts",
+      "default": "./src/testing/index.ts"
+    },
+    "./schema": {
+      "types": "./src/schema/index.ts",
+      "default": "./src/schema/index.ts"
+    },
+    "./schema/zod": {
+      "types": "./src/schema/drivers/zod.ts",
+      "default": "./src/schema/drivers/zod.ts"
+    },
+    "./schema/openapi": {
+      "types": "./src/schema/openapi.ts",
+      "default": "./src/schema/openapi.ts"
+    },
+    "./server": {
+      "types": "./src/server/index.ts",
+      "default": "./src/server/index.ts"
+    },
+    "./server/fastify": {
+      "types": "./src/server/drivers/fastify.ts",
+      "default": "./src/server/drivers/fastify.ts"
+    },
+    "./server/node": {
+      "types": "./src/server/drivers/node.ts",
+      "default": "./src/server/drivers/node.ts"
+    },
+    "./ui": {
+      "types": "./src/ui/index.ts",
+      "default": "./src/ui/index.ts"
+    },
+    "./ui/react": {
+      "types": "./src/ui/react.tsx",
+      "default": "./src/ui/react.tsx"
+    },
+    "./ui/meta": {
+      "types": "./src/ui/meta.ts",
+      "default": "./src/ui/meta.ts"
+    },
+    "./ui/docs": {
+      "types": "./src/ui/docs/index.ts",
+      "default": "./src/ui/docs/index.ts"
+    },
+    "./ui/docs/standalone": {
+      "types": "./src/ui/docs/standalone.tsx",
+      "default": "./src/ui/docs/standalone.tsx"
+    },
+    "./ui/docs/plugin": {
+      "types": "./src/ui/docs/plugin.ts",
+      "default": "./src/ui/docs/plugin.ts"
+    },
+    "./vite": {
+      "types": "./src/vite/index.ts",
+      "default": "./src/vite/index.ts"
+    },
+    "./ui/theme.css": "./src/ui/theme.css"
+  },
+  "files": [
+    "src",
+    "registry",
+    "bin",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "bin": {
+    "opus": "./bin/cli.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@radix-ui/react-checkbox": "^1.1.3",
+    "@radix-ui/react-dialog": "^1.1.4",
+    "@radix-ui/react-dropdown-menu": "^2.1.4",
+    "@radix-ui/react-label": "^2.1.1",
+    "@radix-ui/react-popover": "^1.1.4",
+    "@radix-ui/react-separator": "^1.1.2",
+    "@radix-ui/react-slot": "^1.1.1",
+    "@radix-ui/react-tabs": "^1.1.2",
+    "@radix-ui/react-tooltip": "^1.1.6",
+    "@tailwindcss/typography": "^0.5.20",
+    "@types/markdown-it": "^14.1.2",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.4.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.460.0",
+    "markdown-it": "^14.2.0",
+    "mitt": "^3.0.1",
+    "prism-react-renderer": "^2.4.1",
+    "radix-ui": "^1.6.0",
+    "react-day-picker": "^10.0.1",
+    "react-resizable-panels": "^4.11.2",
+    "sonner": "^1.7.1",
+    "sucrase": "^3.35.1",
+    "tailwind-merge": "^3.3.1",
+    "tw-animate-css": "^1.2.5",
+    "typescript": "^5.6.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.35.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/s3-request-presigner": "^3.0.0",
+    "@hookform/resolvers": "^3.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "bullmq": "^5.0.0",
+    "fastify": "^5.0.0",
+    "jsonwebtoken": "^9.0.0",
+    "kysely": "^0.27.0",
+    "node-cron": "^3.0.0",
+    "pg": "^8.0.0",
+    "pino": "^9.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-hook-form": "^7.0.0",
+    "vite": "^5.0.0 || ^6.0.0",
+    "zod": "^3.24.0"
+  },
+  "peerDependenciesMeta": {
+    "@hookform/resolvers": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "jsonwebtoken": {
+      "optional": true
+    },
+    "kysely": {
+      "optional": true
+    },
+    "node-cron": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "react-hook-form": {
+      "optional": true
+    },
+    "pino": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": ">=0.35.0",
+    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/s3-request-presigner": "^3.0.0",
+    "@hookform/resolvers": "^3.10.0",
+    "@tanstack/react-query": "^5.62.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.0",
+    "@types/pg": "^8.11.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "better-sqlite3": "^11.0.0",
+    "bullmq": "^5.0.0",
+    "fastify": "^5.0.0",
+    "happy-dom": "^15.11.0",
+    "jsonwebtoken": "^9.0.2",
+    "kysely": "^0.27.0",
+    "node-cron": "^3.0.3",
+    "pg": "^8.13.0",
+    "pino": "^9.5.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-hook-form": "^7.54.0",
+    "tsx": "^4.19.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.1.0",
+    "zod": "^3.24.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/softize-dev/opus.git",
+    "directory": "packages/opus"
+  },
+  "homepage": "https://opus.softize.com.br",
+  "scripts": {
+    "postinstall": "node ./bin/lib/postinstall.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "registry:up": "npx -y verdaccio --config ~/.config/verdaccio/config.yaml",
+    "release": "bash ./scripts/release.sh",
+    "release:local": "bash ./scripts/release.sh --local"
+  }
+}

package/registry/hooks/hooks.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/link-memory-on-start.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/opus-check-on-stop.mjs\"",
+            "timeout": 120
+          }
+        ]
+      }
+    ]
+  }
+}

package/registry/hooks/link-memory-on-start.mjs

@@ -0,0 +1,46 @@
+/**
+ * Hook SessionStart da base Opus: liga a memória versionada do repo
+ * (`.claude/memory`, política da skill `memory`) ao diretório que o Claude Code
+ * lê (`~/.claude/projects/<hash>/memory`). Sem isso, sessão em worktree/máquina
+ * nova roda AMNÉSICA — recall vazio e memória gravada num diretório órfão que
+ * morre com o worktree. É o `link-memory.sh` automatizado: idempotente, com
+ * backup de memória local pré-existente, e fail-open (repo sem `.claude/memory`
+ * versionado → no-op; qualquer erro → segue sem travar a sessão).
+ */
+import { existsSync, lstatSync, mkdirSync, readdirSync, readlinkSync, renameSync, rmdirSync, symlinkSync, unlinkSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+
+try {
+  const root = process.env.CLAUDE_PROJECT_DIR ?? process.cwd()
+  const memRepo = join(root, '.claude', 'memory')
+  // Sem memória versionada → o repo não adota a política; nada a ligar.
+  if (!existsSync(memRepo)) process.exit(0)
+
+  // O hash do projeto é o caminho absoluto com separadores (e pontos) virando '-',
+  // como o Claude Code nomeia ~/.claude/projects/. Espelha o link-memory.sh.
+  const hash = root.replace(/[/.]/g, '-')
+  const dest = join(homedir(), '.claude', 'projects', hash, 'memory')
+
+  let st = null
+  try {
+    st = lstatSync(dest)
+  } catch {
+    /* Não existe → segue pro link. */
+  }
+  if (st?.isSymbolicLink()) {
+    if (readlinkSync(dest) === memRepo) process.exit(0) // Já ligado.
+    unlinkSync(dest) // Aponta pra outro lugar → religa.
+  } else if (st?.isDirectory()) {
+    // Memória local pré-existente: com conteúdo → backup (nunca descarta); vazia → sai.
+    if (readdirSync(dest).length > 0) renameSync(dest, `${dest}.local-${Date.now()}`)
+    else rmdirSync(dest)
+  } else if (st !== null) {
+    unlinkSync(dest) // Arquivo solto no lugar do diretório — afasta.
+  }
+  mkdirSync(dirname(dest), { recursive: true })
+  symlinkSync(memRepo, dest)
+} catch {
+  /* Fail-open: memória desligada é degradação, não motivo pra travar a sessão. */
+}
+process.exit(0)