@semacode/cli 1.5.26 → 1.5.27

package/docs/deploy.md

@@ -1,258 +0,0 @@
-# Deploy
-
-<!-- sema:i18n -->
-> EN: English first.
-> PT: Português depois, com acentos preservados.
-> ES: Español al final.
-
-## EN
-
-This runbook covers two different deploy surfaces for Sema:
-
-- Sema public website and private MCP server at `https://sema.otimitare.online`.
-- Public package releases for CLI/VSIX/NPM/GitHub.
-
-The production website/MCP target is the **Sema VPS**, not the OtimiTare application VPS.
-
-### Sema Production VPS
-
-Operational facts:
-
-- Domain: `sema.otimitare.online`
-- Current public DNS target: resolve the domain before deploy, do not trust an old IP.
-- SSH user: use the operational server user configured outside this repository.
-- SSH identity: resolve it from local SSH config or a secret manager outside this repository.
-- Static site root: `/srv/sema/site`
-- Caddy config in this repo: `deploy/caddy/sema-site.Caddyfile`
-- MCP service: `sema-mcp.service`
-- MCP upstream: `127.0.0.1:3010`
-
-Do not use the stale `otimitare` SSH alias for Sema deploy. It points to an old host/key pair and is not the source of truth.
-
-Never commit private key content, private-key filenames, local key paths, IPs that are not already public DNS, or secret inventory details.
-
-### Website Deploy
-
-Before publishing:
-
-```powershell
-node pacotes\cli\dist\index.js validar contratos\sema\site_publico.sema --json
-node pacotes\cli\dist\index.js drift contratos\sema\site_publico.sema --escopo modulo --json
-npm run build
-npm run format:check
-```
-
-Confirm the target:
-
-```powershell
-Resolve-DnsName sema.otimitare.online
-ssh sema-vps "hostname; systemctl is-active sema-mcp.service; ls -ld /srv/sema/site"
-```
-
-Create a remote backup and publish static files:
-
-```powershell
-$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
-ssh sema-vps "mkdir -p /srv/sema/backups/site-$stamp && cp -a /srv/sema/site/. /srv/sema/backups/site-$stamp/"
-scp -r site\sema\* sema-vps:/srv/sema/site/
-```
-
-Validate after deploy:
-
-```powershell
-curl.exe -k -fsS https://sema.otimitare.online/healthz
-curl.exe -k -fsS https://sema.otimitare.online/painel.html
-curl.exe -k -fsS -D - https://sema.otimitare.online/mcp -o NUL
-```
-
-Expected result:
-
-- `/healthz` returns healthy.
-- `/painel.html` serves the current static panel.
-- `/mcp` without token does not expose data; it should return an auth challenge or unauthorized response.
-
-### Public Package Release
-
-Before publishing a CLI or VSIX release:
-
-```bash
-npm run build
-npm run format:check
-npm run status:check
-node --import tsx --test --test-name-pattern "docs operacionais|ajuda de ia" testes/integracao/cli-json-e-editor.test.ts
-sema validar contratos/sema/governanca_ia.sema --json
-sema drift contratos/sema/governanca_ia.sema --escopo modulo --json
-npm run release:verificar-versao
-```
-
-Then:
-
-```bash
-npm run release:preparar-publica
-npm run release:publicar-npm
-npm view @semacode/cli version
-npm install -g @semacode/cli@<versao>
-sema --version
-npm run release:verificar-publica
-```
-
-Stop if NPM already has the version, `gh auth status` fails, `npm whoami` fails, Sema validation fails, or release verification finds a mismatch.
-
-## PT
-
-Este runbook cobre duas superfícies diferentes de deploy da Sema:
-
-- site público e servidor MCP privado em `https://sema.otimitare.online`;
-- releases públicos de CLI/VSIX/NPM/GitHub.
-
-O alvo de produção do site/MCP é a **VPS da Sema**, não a VPS da aplicação OtimiTare.
-
-### VPS de Produção da Sema
-
-Fatos operacionais:
-
-- Domínio: `sema.otimitare.online`
-- DNS público atual: resolva o domínio antes do deploy; não confie em IP antigo.
-- Usuário SSH: use o usuário operacional do servidor configurado fora deste repositório.
-- Identidade SSH: resolva pelo SSH config local ou secret manager fora deste repositório.
-- Raiz do site estático: `/srv/sema/site`
-- Configuração Caddy neste repositório: `deploy/caddy/sema-site.Caddyfile`
-- Serviço MCP: `sema-mcp.service`
-- Upstream MCP: `127.0.0.1:3010`
-
-Não use o alias SSH antigo `otimitare` para deploy da Sema. Ele aponta para host/chave antigos e não é fonte da verdade.
-
-Nunca commite conteúdo de chave privada, nomes de arquivos de chave privada, caminhos locais de chave, IPs que não sejam DNS público ou detalhes do inventário de segredos.
-
-### Deploy do Site
-
-Antes de publicar:
-
-```powershell
-node pacotes\cli\dist\index.js validar contratos\sema\site_publico.sema --json
-node pacotes\cli\dist\index.js drift contratos\sema\site_publico.sema --escopo modulo --json
-npm run build
-npm run format:check
-```
-
-Confirme o alvo:
-
-```powershell
-Resolve-DnsName sema.otimitare.online
-ssh sema-vps "hostname; systemctl is-active sema-mcp.service; ls -ld /srv/sema/site"
-```
-
-Crie backup remoto e publique os arquivos estáticos:
-
-```powershell
-$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
-ssh sema-vps "mkdir -p /srv/sema/backups/site-$stamp && cp -a /srv/sema/site/. /srv/sema/backups/site-$stamp/"
-scp -r site\sema\* sema-vps:/srv/sema/site/
-```
-
-Valide depois do deploy:
-
-```powershell
-curl.exe -k -fsS https://sema.otimitare.online/healthz
-curl.exe -k -fsS https://sema.otimitare.online/painel.html
-curl.exe -k -fsS -D - https://sema.otimitare.online/mcp -o NUL
-```
-
-Resultado esperado:
-
-- `/healthz` responde saudável.
-- `/painel.html` serve o painel estático atual.
-- `/mcp` sem token não expõe dados; deve devolver desafio de autenticação ou não autorizado.
-
-### Release Público
-
-Antes de publicar CLI ou VSIX:
-
-```bash
-npm run build
-npm run format:check
-npm run status:check
-node --import tsx --test --test-name-pattern "docs operacionais|ajuda de ia" testes/integracao/cli-json-e-editor.test.ts
-sema validar contratos/sema/governanca_ia.sema --json
-sema drift contratos/sema/governanca_ia.sema --escopo modulo --json
-npm run release:verificar-versao
-```
-
-Depois:
-
-```bash
-npm run release:preparar-publica
-npm run release:publicar-npm
-npm view @semacode/cli version
-npm install -g @semacode/cli@<versao>
-sema --version
-npm run release:verificar-publica
-```
-
-Pare se a versão já existir no NPM, `gh auth status` falhar, `npm whoami` falhar, a validação Sema falhar ou a verificação de release encontrar desalinhamento.
-
-## ES
-
-Este runbook cubre dos superficies distintas de despliegue de Sema:
-
-- sitio público y servidor MCP privado en `https://sema.otimitare.online`;
-- releases públicos de CLI/VSIX/NPM/GitHub.
-
-El destino de producción del sitio/MCP es la **VPS de Sema**, no la VPS de la aplicación OtimiTare.
-
-### VPS de Producción de Sema
-
-Datos operativos:
-
-- Dominio: `sema.otimitare.online`
-- DNS público actual: resuelve el dominio antes del despliegue; no confíes en una IP antigua.
-- Usuario SSH: usa el usuario operativo del servidor configurado fuera de este repositorio.
-- Identidad SSH: resuélvela desde el SSH config local o secret manager fuera de este repositorio.
-- Raíz del sitio estático: `/srv/sema/site`
-- Configuración Caddy en este repositorio: `deploy/caddy/sema-site.Caddyfile`
-- Servicio MCP: `sema-mcp.service`
-- Upstream MCP: `127.0.0.1:3010`
-
-No uses el alias SSH antiguo `otimitare` para desplegar Sema. Apunta a un host/par de llaves antiguo y no es la fuente de verdad.
-
-Nunca hagas commit del contenido de la llave privada, nombres de archivos de llave privada, rutas locales de llaves, IPs que no sean DNS público o detalles del inventario de secretos.
-
-### Despliegue del Sitio
-
-Antes de publicar:
-
-```powershell
-node pacotes\cli\dist\index.js validar contratos\sema\site_publico.sema --json
-node pacotes\cli\dist\index.js drift contratos\sema\site_publico.sema --escopo modulo --json
-npm run build
-npm run format:check
-```
-
-Confirma el destino:
-
-```powershell
-Resolve-DnsName sema.otimitare.online
-ssh sema-vps "hostname; systemctl is-active sema-mcp.service; ls -ld /srv/sema/site"
-```
-
-Crea backup remoto y publica los archivos estáticos:
-
-```powershell
-$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
-ssh sema-vps "mkdir -p /srv/sema/backups/site-$stamp && cp -a /srv/sema/site/. /srv/sema/backups/site-$stamp/"
-scp -r site\sema\* sema-vps:/srv/sema/site/
-```
-
-Valida después del despliegue:
-
-```powershell
-curl.exe -k -fsS https://sema.otimitare.online/healthz
-curl.exe -k -fsS https://sema.otimitare.online/painel.html
-curl.exe -k -fsS -D - https://sema.otimitare.online/mcp -o NUL
-```
-
-Resultado esperado:
-
-- `/healthz` responde saludable.
-- `/painel.html` sirve el panel estático actual.
-- `/mcp` sin token no expone datos; debe devolver desafío de autenticación o no autorizado.