gate-stack-cli 1.0.4

package/README.md

@@ -0,0 +1,114 @@
+# GateStack
+
+Backend agora padronizado em **NestJS + Prisma + PostgreSQL + Zod + BullMQ/Redis**, com observabilidade em **Pino + Prometheus + Grafana** e infra com **Docker + Nginx**.
+
+`QUEUE_ENABLED` e `QUEUE_WORKER_ENABLED` ficam desabilitados por padrao em ambiente local (fail-open) para evitar falha da API quando Redis estiver indisponivel ou com credencial incorreta.
+
+## Stack
+
+- Backend: NestJS (TypeScript)
+- ORM: Prisma
+- Banco: PostgreSQL
+- Filas: BullMQ + Redis
+- Validação: Zod
+- Logging: Pino (`nestjs-pino`)
+- Métricas: Prometheus (`/metrics`)
+- Dashboard: Grafana
+- Dev tools: `tsx`, ESLint, Prettier
+- Testes: Jest + Playwright
+
+## Backend local
+
+```bash
+npm --prefix backend install
+npm --prefix backend run prisma:generate
+npm --prefix backend run dev
+```
+
+API principal:
+
+- `POST /api/auth/login`
+- `GET /health`
+- `GET /api/releases`
+- `POST /api/releases`
+- `POST /api/releases/:releaseId/publish`
+- `POST /api/releases/:releaseId/rollback`
+- `GET /metrics` (protegido por token)
+
+## Infra completa (Docker)
+
+```bash
+docker compose up --build
+```
+
+Serviços:
+
+- Backend: `http://localhost:5000`
+- Nginx (reverse proxy): `http://localhost`
+- PostgreSQL: `localhost:5432`
+- Redis: `localhost:6379`
+- Prometheus: `http://localhost:9090`
+- Grafana: `http://localhost:3001`
+
+Grafana já sobe com:
+
+- datasource Prometheus provisionado automaticamente
+- dashboard `GateStack Overview` provisionado automaticamente
+
+## Segurança aplicada
+
+- JWT + RBAC (`admin`, `writer`, `reader`)
+- hardening com `helmet`
+- rate limiting global com `@nestjs/throttler`
+- endpoint `/metrics` protegido por `METRICS_TOKEN`
+- Snyk com bloqueio por severidade alta no CI
+- Prometheus configurado para enviar token bearer em `infra/prometheus/prometheus.yml`
+
+## Prisma
+
+```bash
+npm --prefix backend run prisma:migrate:dev
+npm --prefix backend run prisma:generate
+npm --prefix backend run prisma:migrate:deploy
+npm --prefix backend run prisma:seed
+```
+
+Login inicial:
+
+- usa `ADMIN_EMAIL` e `ADMIN_PASSWORD` configurados no ambiente
+- usuário admin é criado/atualizado automaticamente no bootstrap
+
+## Qualidade
+
+```bash
+npm --prefix backend run lint
+npm --prefix backend run type-check
+npm --prefix backend run test
+npm --prefix backend run test:e2e
+```
+
+## CLI `gate` (alias para git)
+
+Use `gate clone` em vez de `git clone` apontando para o Git HTTP do backend.
+
+1. Dê permissão de execução ao wrapper:
+   ```bash
+   chmod +x scripts/gate
+   ```
+2. Adicione `scripts/` ao PATH ou chame direto:
+   ```bash
+   scripts/gate clone http://localhost:5000/git/<slug>
+   ```
+3. Você pode usar só o slug; o host vem de `GATE_HOST` (default `http://localhost:5000`):
+   ```bash
+   GATE_HOST=https://gatestack.local scripts/gate clone meu-projeto
+   ```
+
+Comandos suportados:
+- `gate clone <slug|url> [dir]` (transforma slug em `<GATE_HOST>/git/<slug>`)
+- `gate init`, `gate pull`, `gate push`, `gate status`
+- qualquer outro comando git funciona: `gate checkout -b feature/x`
+
+Variáveis:
+- `GATE_HOST`: base do Git HTTP.
+- `GIT_BIN`: caminho do binário git (default `git`).

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "gate-stack-cli",
+  "version": "1.0.4",
+  "private": false,
+  "description": "Gate CLI wrapper for git (gate clone/init/push/pull/status)",
+  "bin": {
+    "gate": "scripts/gate"
+  },
+  "files": [
+    "scripts/gate"
+  ],
+  "scripts": {
+    "dev": "make dev",
+    "dev:backend": "npm --prefix backend run dev",
+    "dev:tauri": "make dev-tauri",
+    "build": "make build",
+    "build:backend": "npm --prefix backend run build",
+    "start:backend": "npm --prefix backend run start",
+    "install:all": "make install"
+  },
+  "dependencies": {}
+}

package/scripts/gate

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# Gate CLI — wrapper sobre git com convenções da GateStack
+# Suporta:
+#   gate clone <slug|url> [dir]
+#   gate init [dir]
+#   gate pull [args...]
+#   gate push [args...]
+#   gate status [args...]
+#   gate <qualquer-comando-git> [...]
+
+set -euo pipefail
+
+GATE_HOST="${GATE_HOST:-http://localhost:5000}"
+GIT_BIN="${GIT_BIN:-git}"
+
+usage() {
+  cat <<'EOF'
+Gate CLI (wrapper para git)
+Usage:
+  gate clone <slug|url> [dir]
+  gate init [dir]
+  gate pull [args...]
+  gate push [args...]
+  gate status [args...]
+  gate <comando-git> [...]
+
+Env vars:
+  GATE_HOST   Base URL para o Git HTTP (default: http://localhost:5000)
+  GIT_BIN     Caminho do binário git (default: git)
+EOF
+}
+
+ensure_args() {
+  local count=$1
+  shift
+  if [ $# -lt "$count" ]; then
+    usage
+    exit 1
+  fi
+}
+
+normalize_clone_url() {
+  local target=$1
+  if [[ "$target" =~ ^https?:// ]] || [[ "$target" =~ ^git@ ]] || [[ "$target" =~ ^ssh:// ]]; then
+    echo "$target"
+  else
+    echo "${GATE_HOST%/}/git/${target}"
+  fi
+}
+
+cmd="${1:-}"
+if [ -z "$cmd" ]; then
+  usage
+  exit 1
+fi
+shift || true
+
+case "$cmd" in
+  clone)
+    ensure_args 1 "$@"
+    url=$(normalize_clone_url "$1"); shift
+    exec "$GIT_BIN" clone "$url" "$@"
+    ;;
+  init)
+    exec "$GIT_BIN" init "$@"
+    ;;
+  pull)
+    exec "$GIT_BIN" pull "$@"
+    ;;
+  push)
+    exec "$GIT_BIN" push "$@"
+    ;;
+  status)
+    exec "$GIT_BIN" status "$@"
+    ;;
+  -h|--help|help)
+    usage
+    ;;
+  *)
+    exec "$GIT_BIN" "$cmd" "$@"
+    ;;
+esac