Portabilidade pública, instalação e apresentação do SHOGUN

[dgreych]

Objetivo

Fechar o repositório público do SHOGUN como distribuição realmente utilizável e apresentável: clone limpo, instalação coerente com o runtime atual, suporte documentado a Windows/Linux/macOS/Termux e uma página pública que explique o produto sem depender de conhecimento prévio do projeto.

Funcionalidade e portabilidade

• adiciona/ajusta instaladores para Termux, Linux, macOS e Windows;
• corrige o preflight do Termux sem executar wake lock como teste e sem exigir Termux:API;
• inclui módulos de runtime que estavam ausentes do snapshot público;
• corrige imports residuais do store antigo (gyomeiStore) para o store atual (shogunStore) nas integrações publicadas;
• corrige a validação da autoria/identidade atual;
• amplia o CI para Linux, Windows e macOS em Node 20.19/22/24 e adiciona contrato específico Termux/Android;
• mantém os gates de build, domínio, regressão e validação de release do projeto.

Apresentação

• README substancialmente refeito com banner, badges, navegação, cards de recursos, screenshots, arquitetura Mermaid, primeira execução, segurança, portabilidade e FAQ;
• guias de Termux, Windows, Linux e macOS refeitos com hierarquia visual, rota de instalação, sinais de sucesso, troubleshooting e fluxo real de QR/pareamento;
• documentação alinhada aos scripts e ao requisito Node 20.19+.

Critério de aceite

Mesclar somente com a matriz pública e o job de qualidade completos em verde. Depois do merge, a publicação pública ainda será tratada como distribuição; o deploy operacional do bot continua separado e ocorre no laboratório local a partir do repositório privado.