@praeko/studio 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+Segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/) e [SemVer](https://semver.org/lang/pt-BR/). Na série 0.x uma mudança incompatível pode sair em versão menor, sempre registrada aqui.
+
+## [0.1.0] - 2026-11-07
+
+Primeira versão publicada. O Praeko Studio nasceu dentro de um projeto de divulgação e foi extraído para qualquer pessoa usar com o seu próprio agente de código.
+
+- Comando `praeko-studio` (também por `praeko studio …`, pelo `@praeko/cli`): `init`, `novo`, `voz`, `compilar`, `corte`, `prever`, `render`, `capa`, `folha`, `checar`, `pacote`, `agendar`, e os novos `doctor`, `licencas`, `skill install` e `docs`.
+- `init` cria projetos que dependem de pacotes publicados por semver (`@praeko/studio-core`, `@praeko/studio-kit`); `--dev <studio>` mantém o modo por caminho local para quem contribui.
+- `skill install` grava as instruções para Claude Code, Codex, Gemini CLI, Cursor, opencode, Cline e Windsurf (pt-BR e en), com a regra de dois passos para publicar por MCP, o envio de arquivo local (`create_media_upload`) e a declaração de IA.
+- Voz: `vozes.json` por projeto e por usuário (sem ids de ninguém no pacote); chaves por variável de ambiente, cofre do macOS ou arquivo `~/.config/praeko/segredos.json` (permissão 600); a chave do Praeko é a mesma da `praeko` CLI.
+- Publicação padrão pelo Praeko (`--via praeko`); `links` do `marca.json` virou opcional; `publicacao.json` ganhou `ia.sintetico` (conferido por `checar` e `pacote`; vai ao YouTube como `containsSyntheticMedia` na publicação direta).
+- Remotion **não é MIT**: veja `LICENSES.md` e `praeko studio licencas`.
+- Removido: o alias `bardo`, o serviço antigo do cofre e `~/.config/bardo`. `fila instalar/remover` (launchd) só existe no macOS.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcone Santos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSES.md

@@ -0,0 +1,38 @@
+# Licenças do Praeko Studio / Licenses
+
+Conferido em 07/11/2026 (verified on 2026-11-07). Este arquivo não é aconselhamento jurídico; vale o texto de cada fornecedor.
+
+## O código do Praeko Studio
+Os pacotes `@praeko/studio`, `@praeko/studio-core` e `@praeko/studio-kit` são **MIT** (ver `LICENSE`, Copyright (c) 2026 Marcone Santos), como `@praeko/sdk` e `@praeko/cli`. Os efeitos sonoros (`pop`, `ding`, `thump`, `whoosh`) e o `avatar.png` do modelo de projeto foram criados para o Studio (sons sintetizados por `scripts/gerar-sfx.mjs`, sem amostras de terceiros) e seguem a mesma licença MIT. O pacote não traz fontes, músicas, imagens de banco nem arte de terceiros.
+
+## Aviso que você precisa ver (Remotion NÃO é MIT)
+> **Remotion.** O Remotion é *source-available*, não open source. É **grátis** para pessoas físicas, organizações sem fins lucrativos, avaliação e empresas com **até 3 funcionários** (uso comercial incluído). Empresas com **4 ou mais pessoas** precisam da **Company License** (remotion.pro/license). Quem instala e roda o Remotion é **você**: a licença é sua, não do Praeko. O Remotion também vende planos para quem **automatiza renders por programa ou agente** (Creators, Automators); o FAQ deles não diz expressamente se um agente local que roda `remotion render` entra: **pergunte ao Remotion** antes de usar em escala. O Praeko Studio não copia nem modifica código do Remotion: usa-o como dependência (peer) instalada por você.
+>
+> **Remotion** is source-available, not open source. Free for individuals, non-profits, evaluation and companies of up to 3 employees (commercial use included); companies of 4+ need the Company License (remotion.pro/license). You install and run Remotion, so the license is yours. They also sell plans for programmatic/agent-driven rendering; their FAQ does not say whether a local agent running `remotion render` counts: ask Remotion before using at scale. Praeko Studio does not copy or modify Remotion code; it uses it as a dependency you install.
+
+Este aviso aparece no `README`, na instalação (`praeko studio init`), em `praeko studio doctor` e em `praeko studio licencas` (`--aceitar` registra a leitura em `~/.config/praeko/studio/licencas.json`).
+
+**Capas** são renderizadas com `remotion still`, mesmo com `--motor hyperframes`: hoje não existe projeto 100% livre de Remotion. Uma capa sem Remotion está no roteiro de trabalho (`docs/studio-produto.md`, item 9) e não foi prometida.
+
+**Não prometemos "grátis para sempre":** as condições do Remotion podem mudar (a própria página avisa que a licença muda no Remotion 5.0). Reveja a licença ao subir de versão.
+
+## Dependências de terceiros
+| Componente | Onde | Licença | Fonte |
+|---|---|---|---|
+| `remotion`, `@remotion/cli` (4.0.539) | instalados no **projeto** do usuário (peer de core/kit) | Remotion License (ver acima), não MIT | remotion.pro/license; github.com/remotion-dev/remotion (LICENSE.md) |
+| `react`, `react-dom` (19.2.3) | projeto do usuário (peer) | MIT | package.json de cada pacote |
+| `@praeko/studio-core`, `-kit` | projeto do usuário | MIT | LICENSE |
+| `yaml` (2.9.1) | embutido no bundle de `@praeko/studio` | ISC | package.json |
+| `@elevenlabs/elevenlabs-js` (2.x) | dependência de `@praeko/studio` | MIT | package.json |
+| `hyperframes` (0.9.13, motor opcional) | baixado por `npx` na primeira vez que você usa `--motor hyperframes` | Apache-2.0 | github.com/heygen-com/hyperframes |
+| `typescript`, `esbuild`, `@types/*` | só desenvolvimento/build | Apache-2.0 / MIT | package.json |
+| ffmpeg / ffprobe | você instala | LGPL ou GPL, conforme a compilação | ffmpeg.org/legal.html |
+| Chrome Headless Shell / Chromium | o Remotion baixa no primeiro render | licenças do Chromium/Google | remotion.dev/docs/miscellaneous/chrome-headless-shell |
+
+## Serviços e modelos (você contrata)
+- **ElevenLabs**: seus termos e seu plano (clonagem de voz só com direito sobre a voz). A chave é sua; o Studio nunca a imprime.
+- **VoiceStudio local** (opcional): o modelo OmniVoice é **CC-BY-NC (uso não comercial)**. Não é padrão em nenhuma configuração do Studio e **não deve ser usado em conteúdo monetizado**. Confira a licença de qualquer modelo local que usar.
+- **YouTube, Instagram, TikTok**: termos e regras de conteúdo sintético de cada rede (veja `praeko studio docs publicar`).
+
+## Fontes e mídia
+Nenhuma fonte é distribuída. O modelo de projeto usa fontes do sistema (`Arial Black`, `Menlo`) que o `doctor` confere; troque-as no `marca.json` por fontes abertas (OFL) se quiser que o vídeo saia igual em todos os sistemas. Música, imagens e clipes que você adicionar são responsabilidade sua (direitos e licenças).

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @praeko/studio
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Praeko Studio faz vídeos curtos (9:16) e longos (16:9) a partir de um roteiro: voz, legenda palavra a palavra, cenas, capa e textos de publicação. Você opera com o **seu próprio agente de código** (Claude Code, Codex, Gemini CLI, Cursor, opencode…) na **sua máquina**: o agente escreve o roteiro e o `episodio.yaml`, roda os comandos e, só depois do seu sim, publica pelo [Praeko](https://praeko.app/docs). Voz, render e agente são por sua conta; o Studio não chama nenhum modelo de linguagem e nenhum roteiro seu sai da máquina até você publicar.
+
+> **Licenças.** O código do Praeko Studio é MIT. O **Remotion** (motor padrão, necessário para capas) **não é MIT**: grátis para pessoas, organizações sem fins lucrativos e empresas de até 3 funcionários; empresas com 4 ou mais pessoas precisam da Company License ([remotion.pro/license](https://www.remotion.pro/license)). A licença é de quem instala e roda o Remotion. O HyperFrames (`--motor hyperframes`) é Apache-2.0. Detalhes: [LICENSES.md](./LICENSES.md) ou `praeko studio licencas`.
+>
+> **Licenses.** Praeko Studio's own code is MIT. **Remotion** (the default engine, required for covers) is **not MIT**: free for individuals, non-profits and companies of up to 3 employees; companies of 4+ need the Company License. The license is yours as the person installing and running it. HyperFrames (`--motor hyperframes`) is Apache-2.0. See [LICENSES.md](./LICENSES.md).
+
+## Requisitos
+Node 22 ou mais novo, `ffmpeg` e `ffprobe` no PATH, e um Chrome (o Remotion baixa o Chrome Headless Shell sozinho no primeiro render; precisa de internet nesse momento). macOS e Linux são suportados; Windows é melhor esforço e não foi testado. `praeko studio doctor` confere tudo.
+
+## Instalar
+```sh
+# npm
+npm install -g @praeko/studio
+# yarn
+yarn global add @praeko/studio
+# pnpm
+pnpm add -g @praeko/studio
+# bun
+bun add -g @praeko/studio
+# sem instalar
+npx @praeko/studio init meu-canal
+```
+Também funciona por `praeko studio <comando>` quando o `@praeko/cli` está instalado (ele entrega ao Studio).
+
+## Primeiro vídeo
+```sh
+praeko-studio init meu-canal --nome "Meu Canal" --agent claude   # projeto + instruções para o seu agente
+cd meu-canal
+praeko-studio doctor
+praeko-studio novo meu-primeiro --titulo "Meu primeiro vídeo"
+praeko-studio voz meu-primeiro --qualidade rascunho              # voz estimada e muda: grátis, sem rede
+praeko-studio checar meu-primeiro
+praeko-studio render meu-primeiro && praeko-studio folha meu-primeiro && praeko-studio capa meu-primeiro && praeko-studio pacote meu-primeiro
+```
+Abra o seu agente na pasta do projeto e peça o vídeo: as instruções (`CLAUDE.md`/`AGENTS.md`/`GEMINI.md`/`.cursor/rules`…) já estão lá (`praeko studio skill install --agent all` regrava). Documentação da versão instalada: `praeko studio docs`.
+
+## Publicar
+`praeko studio agendar <slug> --via praeko --quando "dd/mm hh:mm"` só simula; `--enviar` publica de verdade. Pelo MCP do Praeko o envio do arquivo local usa `create_media_upload` e a publicação é sempre em dois passos (prévia e código de confirmação). Declare conteúdo de IA em `publicacao.json` (`"ia": { "sintetico": true }`). Veja `praeko studio docs publicar`.
+
+## Licença
+MIT (o código deste pacote). Veja também [LICENSES.md](./LICENSES.md).