STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Arquitetura do Studio

Componentes

A extensão integra os comandos e painéis do VS Code. O runtime independente gerencia processos, compila TypeScript e executa os contratos do SDK. O host materializa uma árvore privada a partir do snapshot do Core e carrega módulos selecionados do workspace. O preview HTML independente foi removido; módulos são testados na interface real.

O SDK V2 embarcado mantém os contratos v1. As bibliotecas PHP e TypeScript, o mock local, a CLI e o compilador não precisam do código operacional nem de credenciais de produção.

Dois contextos de execução

Plugins externos usam uma entrada funcional e um cliente SDK com fixtures. Isso permite testar contratos e erros de autorização de forma determinística. Não há uma identidade operacional implícita.

Módulos nativos usam o Core real, a identidade local, PDO, migrações e o worker WebSocket da cópia de desenvolvimento. O banco é independente. O código-fonte do workspace é copiado, não implantado sobre a operação.

Processos e dados

HTTP, WebSocket, MySQL e backends de plugins são processos gerenciados pelo Studio. O host usa portas locais e um socket Unix privado de banco. Os comandos são executados com argumentos separados, sem interpolação por shell. Saída e tempo de execução têm limites nos runners.

Workspace Trust é obrigatório. Os processos executam com a conta do usuário; isso não impede um código confiado deliberadamente de usar as permissões dessa conta. Para plugins não confiáveis, use isolamento de SO/contêiner adequado ao seu modelo de ameaça.

Renderização

Os resultados HTML dos runners usam iframe de origem opaca e CSP restrita. O plugin não recebe a ponte de comandos do VS Code. O shell aceita apenas mensagens específicas e limita os logs encaminhados.

O host real precisa de formulários, cookies e WebSocket. Seu painel usa uma origem local/encaminhada e executa a interface real. A permissão de incorporação é ajustada somente pelo router de desenvolvimento, sem modificar os cabeçalhos do Core operacional.

Distribuição

O VSIX contém o SDK, o compilador e o cliente de licenciamento. O Core é um download privado autenticado, fora do VSIX. Plugins nativos e dados de usuários não fazem parte da base embarcada. Bibliotecas de terceiros preservam suas licenças. O FEX continua sendo o formato dos plugins; VSIX é o formato da extensão do editor.

Operação

Não há deploy, push, migração operacional nem reinício de serviços operacionais nos comandos de desenvolvimento. A publicação de um VSIX no Marketplace e a ativação de um FEX em um Titan são processos distintos. Cada um exige sua própria revisão e autorização.