@kaikybrofc/omnizap-system 2.2.0 → 2.2.2

package/.env.example

@@ -539,6 +539,10 @@ RELEASE_GIT_BRANCH=
 RELEASE_GIT_PRE_COMMIT_MESSAGE=chore(release): auto-commit before release
 RELEASE_GIT_COMMIT_VERSION=1
 RELEASE_GIT_VERSION_COMMIT_PREFIX=chore(release): v
+# Geração automática de tag da versão no git
+RELEASE_GIT_TAG_CREATE=1
+RELEASE_GIT_TAG_PUSH=1
+RELEASE_GIT_TAG_ANNOTATED=1
 
 # Cria/atualiza GitHub Release (aba Releases) automaticamente no npm run release
 RELEASE_GITHUB_RELEASE=1
@@ -549,6 +553,10 @@ RELEASE_GITHUB_TOKEN=
 RELEASE_GITHUB_TAG_PREFIX=v
 RELEASE_GITHUB_NAME_PREFIX=v
 RELEASE_GITHUB_GENERATE_NOTES=1
+# Inclui seção markdown com arquivos alterados no corpo da release
+RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES=1
+# Limite de arquivos listados no markdown da release
+RELEASE_GITHUB_RELEASE_MAX_FILES=300
 # Opcional: 1 para prerelease, 0 para release normal, vazio = auto (detecta '-' na versao)
 RELEASE_GITHUB_PRERELEASE=
 RELEASE_GITHUB_DRAFT=0

package/README.md

@@ -26,6 +26,24 @@ O **OmniZap System** é uma plataforma de automação para WhatsApp usando **Nod
 - Termos de uso: https://omnizap.shop/termos-de-uso/
 - Licença: https://omnizap.shop/licenca/
 
+## Snapshot dinâmico para README/NPM
+
+Use as rotas abaixo para consumir o bloco já renderizado com dados do sistema:
+
+- JSON: `GET /api/sticker-packs/readme-summary`
+- Markdown: `GET /api/sticker-packs/readme-markdown`
+
+Conteúdo incluído no snapshot:
+
+- total de usuários (`lid_map`)
+- total de grupos
+- total de packs e stickers
+- total de mensagens registradas
+- tipos de mensagem mais usados
+- lista de comandos disponíveis no menu
+
+Atualização em cache: **30 minutos** por padrão (`README_SUMMARY_CACHE_SECONDS=1800`).
+
 ## Recursos principais
 
 - Gerenciamento de grupos (admin, boas-vindas, despedida, anti-link, captcha).
@@ -239,6 +257,9 @@ Variáveis do fluxo de release (git):
 - `RELEASE_GIT_PRE_COMMIT_MESSAGE` (default: `chore(release): auto-commit before release`)
 - `RELEASE_GIT_COMMIT_VERSION` (default: `1`) - commita alteração da versão após sucesso
 - `RELEASE_GIT_VERSION_COMMIT_PREFIX` (default: `chore(release): v`)
+- `RELEASE_GIT_TAG_CREATE` (default: `1`) - cria tag `vX.Y.Z` no release
+- `RELEASE_GIT_TAG_PUSH` (default: `1`) - envia a tag para o remoto
+- `RELEASE_GIT_TAG_ANNOTATED` (default: `1`) - usa tag anotada (`git tag -a`)
 - `RELEASE_GITHUB_RELEASE` (default: `1`) - cria/atualiza GitHub Release na aba Releases
 - `RELEASE_REQUIRE_GITHUB_RELEASE` (default: `1`) - falha se GitHub Release estiver desativado
 - `RELEASE_GITHUB_REPO` (opcional; ex.: `kaikybrofc/omnizap-system`)
@@ -246,6 +267,8 @@ Variáveis do fluxo de release (git):
 - `RELEASE_GITHUB_TAG_PREFIX` (default: `v`) - prefixo da tag (`v2.1.9`)
 - `RELEASE_GITHUB_NAME_PREFIX` (default: `v`) - prefixo do nome exibido na release
 - `RELEASE_GITHUB_GENERATE_NOTES` (default: `1`) - usa notas automáticas do GitHub
+- `RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES` (default: `1`) - adiciona markdown com arquivos alterados no corpo da release
+- `RELEASE_GITHUB_RELEASE_MAX_FILES` (default: `300`) - limite de arquivos listados no markdown
 - `RELEASE_GITHUB_PRERELEASE` (default: auto) - vazio detecta `-` na versão como prerelease
 - `RELEASE_GITHUB_DRAFT` (default: `0`)
 - `RELEASE_GITHUB_TARGET` (opcional; vazio usa `HEAD`)

package/app/modules/stickerPackModule/stickerPackCatalogHttp.js

@@ -63,6 +63,16 @@ import {
   buildViewerTagAffinity,
   computePackSignals,
 } from './stickerPackMarketplaceService.js';
+import {
+  buildAdminMenu,
+  buildAiMenu,
+  buildAnimeMenu,
+  buildMediaMenu,
+  buildMenuCaption,
+  buildQuoteMenu,
+  buildStatsMenu,
+  buildStickerMenu,
+} from '../menuModule/common.js';
 import { getMarketplaceDriftSnapshot } from './stickerMarketplaceDriftService.js';
 import { getStickerStorageConfig, readStickerAssetBuffer, saveStickerAssetFromBuffer } from './stickerStorageService.js';
 import { convertToWebp } from '../stickerModule/convertToWebp.js';
@@ -193,6 +203,9 @@ const MARKETPLACE_GLOBAL_STATS_API_PATH = '/api/marketplace/stats';
 const MARKETPLACE_GLOBAL_STATS_CACHE_SECONDS = clampInt(process.env.MARKETPLACE_GLOBAL_STATS_CACHE_SECONDS, 45, 30, 60);
 const HOME_MARKETPLACE_STATS_CACHE_SECONDS = clampInt(process.env.HOME_MARKETPLACE_STATS_CACHE_SECONDS, 45, 10, 300);
 const SYSTEM_SUMMARY_CACHE_SECONDS = clampInt(process.env.SYSTEM_SUMMARY_CACHE_SECONDS, 20, 5, 120);
+const README_SUMMARY_CACHE_SECONDS = clampInt(process.env.README_SUMMARY_CACHE_SECONDS, 60 * 30, 60, 60 * 60 * 6);
+const README_MESSAGE_TYPE_SAMPLE_LIMIT = clampInt(process.env.README_MESSAGE_TYPE_SAMPLE_LIMIT, 25000, 500, 250000);
+const README_COMMAND_PREFIX = String(process.env.README_COMMAND_PREFIX || PACK_COMMAND_PREFIX).trim() || PACK_COMMAND_PREFIX;
 const SITE_CANONICAL_HOST = String(process.env.SITE_CANONICAL_HOST || 'omnizap.shop').trim().toLowerCase() || 'omnizap.shop';
 const SITE_CANONICAL_SCHEME = String(process.env.SITE_CANONICAL_SCHEME || 'https').trim().toLowerCase() === 'http'
   ? 'http'
@@ -283,6 +296,11 @@ const SYSTEM_SUMMARY_CACHE = {
   value: null,
   pending: null,
 };
+const README_SUMMARY_CACHE = {
+  expiresAt: 0,
+  value: null,
+  pending: null,
+};
 const SITEMAP_CACHE = {
   expiresAt: 0,
   xml: '',
@@ -3700,6 +3718,9 @@ const invalidateStickerCatalogDerivedCaches = () => {
   SYSTEM_SUMMARY_CACHE.expiresAt = 0;
   SYSTEM_SUMMARY_CACHE.value = null;
   SYSTEM_SUMMARY_CACHE.pending = null;
+  README_SUMMARY_CACHE.expiresAt = 0;
+  README_SUMMARY_CACHE.value = null;
+  README_SUMMARY_CACHE.pending = null;
 };
 
 const sendManagedMutationStatus = (req, res, status, extra = {}, statusCode = 200) => {
@@ -5736,6 +5757,253 @@ const parseMessageTypeFromRaw = (rawMessage) => {
   }
 };
 
+const formatPtBrInteger = (value) => Number(value || 0).toLocaleString('pt-BR');
+
+const extractCommandsFromMenuLine = (line, commandPrefix) => {
+  const normalizedLine = String(line || '').trim();
+  if (!normalizedLine.startsWith('→')) return [];
+
+  const commandParts = normalizedLine
+    .replace(/^→\s*/, '')
+    .split('|')
+    .map((part) => part.trim())
+    .filter((part) => part.startsWith(commandPrefix));
+
+  return commandParts
+    .map((part) => {
+      const normalized = part.replace(/\s{2,}.*/, '').trim();
+      const withoutPrefix = normalized.slice(commandPrefix.length).trim();
+      if (!withoutPrefix) return '';
+
+      const tokens = withoutPrefix.split(/\s+/).filter(Boolean);
+      const selectedTokens = [];
+      for (const token of tokens) {
+        if (/^[<[(]/.test(token)) break;
+        selectedTokens.push(token);
+      }
+      if (!selectedTokens.length) return '';
+      return `${commandPrefix}${selectedTokens.join(' ')}`;
+    })
+    .filter(Boolean);
+};
+
+const collectAvailableMenuCommands = (commandPrefix = README_COMMAND_PREFIX) => {
+  const sections = [
+    buildMenuCaption('OmniZap', commandPrefix),
+    buildStickerMenu(commandPrefix),
+    buildMediaMenu(commandPrefix),
+    buildQuoteMenu(commandPrefix),
+    buildAnimeMenu(commandPrefix),
+    buildAiMenu(commandPrefix),
+    buildStatsMenu(commandPrefix),
+    buildAdminMenu(commandPrefix),
+  ];
+
+  const commands = new Set();
+  for (const section of sections) {
+    for (const line of String(section || '').split('\n')) {
+      const extracted = extractCommandsFromMenuLine(line, commandPrefix);
+      for (const command of extracted) {
+        commands.add(command);
+      }
+    }
+  }
+
+  return Array.from(commands).sort((left, right) => left.localeCompare(right, 'pt-BR'));
+};
+
+const renderReadmeSnapshotMarkdown = ({ generatedAt, totals, topMessageTypes, commands }) => {
+  const typeLines = topMessageTypes.length
+    ? topMessageTypes.map((entry, index) => `${index + 1}. \`${entry.type}\` - **${formatPtBrInteger(entry.total)}**`)
+    : ['1. `outros` - **0**'];
+
+  const commandLines = commands.length
+    ? commands.map((command) => `- \`${command}\``)
+    : ['- Nenhum comando identificado no menu atual.'];
+
+  return [
+    '## OmniZap System Snapshot',
+    '',
+    `Atualizado em: **${generatedAt}**`,
+    `Janela de atualização: **${README_SUMMARY_CACHE_SECONDS} segundos**`,
+    '',
+    '### Totais do sistema',
+    `- Usuários (lid_map): **${formatPtBrInteger(totals.total_users)}**`,
+    `- Grupos: **${formatPtBrInteger(totals.total_groups)}**`,
+    `- Packs: **${formatPtBrInteger(totals.total_packs)}**`,
+    `- Stickers: **${formatPtBrInteger(totals.total_stickers)}**`,
+    `- Mensagens registradas: **${formatPtBrInteger(totals.total_messages)}**`,
+    '',
+    `### Tipos de mensagem mais usados (amostra de ${formatPtBrInteger(totals.message_types_sample_size)} mensagens)`,
+    ...typeLines,
+    '',
+    '### Comandos disponíveis',
+    ...commandLines,
+    '',
+  ].join('\n');
+};
+
+const buildReadmeSummarySnapshot = async () => {
+  const [
+    lidMapTotalsRows,
+    chatsTotalsRows,
+    groupsMetadataTotalsRows,
+    packTotalsRows,
+    stickerTotalsRows,
+    messageTotalsRows,
+    messageTypeRows,
+  ] = await Promise.all([
+    executeQuery(`SELECT COUNT(*) AS total_users FROM ${TABLES.LID_MAP}`),
+    executeQuery(
+      `SELECT
+         COUNT(*) AS total_chats,
+         SUM(CASE WHEN id LIKE '%@g.us' THEN 1 ELSE 0 END) AS total_groups
+       FROM ${TABLES.CHATS}`,
+    ),
+    executeQuery(`SELECT COUNT(*) AS total_groups FROM ${TABLES.GROUPS_METADATA}`),
+    executeQuery(`SELECT COUNT(*) AS total_packs FROM ${TABLES.STICKER_PACK} WHERE deleted_at IS NULL`),
+    executeQuery(`SELECT COUNT(*) AS total_stickers FROM ${TABLES.STICKER_ASSET}`),
+    executeQuery(`SELECT COUNT(*) AS total_messages FROM ${TABLES.MESSAGES}`),
+    executeQuery(
+      `SELECT raw_message
+       FROM ${TABLES.MESSAGES}
+       WHERE raw_message IS NOT NULL
+       ORDER BY id DESC
+       LIMIT ${README_MESSAGE_TYPE_SAMPLE_LIMIT}`,
+    ),
+  ]);
+
+  const lidMapTotals = lidMapTotalsRows?.[0] || {};
+  const chatsTotals = chatsTotalsRows?.[0] || {};
+  const groupsMetadataTotals = groupsMetadataTotalsRows?.[0] || {};
+  const packTotals = packTotalsRows?.[0] || {};
+  const stickerTotals = stickerTotalsRows?.[0] || {};
+  const messageTotals = messageTotalsRows?.[0] || {};
+
+  const totalGroupsFromChats = Number(chatsTotals?.total_groups || 0);
+  const totalGroupsFromMetadata = Number(groupsMetadataTotals?.total_groups || 0);
+  const totalGroups = Math.max(totalGroupsFromChats, totalGroupsFromMetadata);
+  const totalMessages = Number(messageTotals?.total_messages || 0);
+
+  const typeCounts = new Map();
+  const sampledMessages = Array.isArray(messageTypeRows) ? messageTypeRows.length : 0;
+  for (const row of messageTypeRows || []) {
+    const type = parseMessageTypeFromRaw(row?.raw_message);
+    typeCounts.set(type, (typeCounts.get(type) || 0) + 1);
+  }
+  const topMessageTypes = Array.from(typeCounts.entries())
+    .map(([type, total]) => ({ type, total: Number(total || 0) }))
+    .sort((left, right) => Number(right.total || 0) - Number(left.total || 0))
+    .slice(0, 8);
+
+  const commands = collectAvailableMenuCommands(README_COMMAND_PREFIX);
+  const generatedAt = new Date().toISOString();
+
+  const totals = {
+    total_users: Number(lidMapTotals?.total_users || 0),
+    total_groups: totalGroups,
+    total_groups_from_chats: totalGroupsFromChats,
+    total_groups_from_metadata: totalGroupsFromMetadata,
+    total_chats: Number(chatsTotals?.total_chats || 0),
+    total_packs: Number(packTotals?.total_packs || 0),
+    total_stickers: Number(stickerTotals?.total_stickers || 0),
+    total_messages: totalMessages,
+    message_types_sample_size: sampledMessages,
+    message_types_total_coverage_percent: totalMessages > 0 ? Number(((sampledMessages / totalMessages) * 100).toFixed(2)) : 0,
+  };
+
+  const markdown = renderReadmeSnapshotMarkdown({
+    generatedAt,
+    totals,
+    topMessageTypes,
+    commands,
+  });
+
+  return {
+    data: {
+      generated_at: generatedAt,
+      cache_seconds: README_SUMMARY_CACHE_SECONDS,
+      command_prefix: README_COMMAND_PREFIX,
+      totals,
+      top_message_types: topMessageTypes,
+      commands,
+      markdown,
+    },
+  };
+};
+
+const getReadmeSummaryCached = async () => {
+  const now = Date.now();
+  const hasValue = Boolean(README_SUMMARY_CACHE.value);
+
+  if (hasValue && now < README_SUMMARY_CACHE.expiresAt) {
+    return README_SUMMARY_CACHE.value;
+  }
+
+  if (!README_SUMMARY_CACHE.pending) {
+    README_SUMMARY_CACHE.pending = withTimeout(buildReadmeSummarySnapshot(), 7000)
+      .then((payload) => {
+        README_SUMMARY_CACHE.value = payload;
+        README_SUMMARY_CACHE.expiresAt = Date.now() + README_SUMMARY_CACHE_SECONDS * 1000;
+        return payload;
+      })
+      .finally(() => {
+        README_SUMMARY_CACHE.pending = null;
+      });
+  }
+
+  if (hasValue) return README_SUMMARY_CACHE.value;
+  return README_SUMMARY_CACHE.pending;
+};
+
+const handleReadmeSummaryRequest = async (req, res) => {
+  try {
+    const payload = await getReadmeSummaryCached();
+    sendJson(req, res, 200, payload);
+  } catch (error) {
+    logger.warn('Falha ao montar resumo markdown para README.', {
+      action: 'readme_summary_error',
+      error: error?.message,
+    });
+    if (README_SUMMARY_CACHE.value) {
+      sendJson(req, res, 200, {
+        ...README_SUMMARY_CACHE.value,
+        meta: {
+          stale: true,
+          error: error?.message || 'fallback_cache',
+        },
+      });
+      return;
+    }
+    sendJson(req, res, 503, { error: 'Resumo markdown indisponível no momento.' });
+  }
+};
+
+const handleReadmeMarkdownRequest = async (req, res) => {
+  try {
+    const payload = await getReadmeSummaryCached();
+    const markdown = String(payload?.data?.markdown || '').trim();
+    res.setHeader('X-Robots-Tag', 'noindex, nofollow');
+    res.setHeader('Cache-Control', `public, max-age=${Math.min(README_SUMMARY_CACHE_SECONDS, 300)}`);
+    res.setHeader('X-Cache-Seconds', String(README_SUMMARY_CACHE_SECONDS));
+    sendText(req, res, 200, markdown ? `${markdown}\n` : '', 'text/markdown; charset=utf-8');
+  } catch (error) {
+    logger.warn('Falha ao renderizar markdown para README.', {
+      action: 'readme_markdown_error',
+      error: error?.message,
+    });
+    if (README_SUMMARY_CACHE.value) {
+      const markdown = String(README_SUMMARY_CACHE.value?.data?.markdown || '').trim();
+      res.setHeader('X-Robots-Tag', 'noindex, nofollow');
+      res.setHeader('Cache-Control', `public, max-age=${Math.min(README_SUMMARY_CACHE_SECONDS, 300)}`);
+      res.setHeader('X-Cache-Seconds', String(README_SUMMARY_CACHE_SECONDS));
+      sendText(req, res, 200, markdown ? `${markdown}\n` : '', 'text/markdown; charset=utf-8');
+      return;
+    }
+    sendText(req, res, 503, 'Resumo markdown indisponivel no momento.\n', 'text/plain; charset=utf-8');
+  }
+};
+
 const resolveBotUserCandidates = (activeSocket) => {
   const candidates = new Set();
   const botJidFromSocket = resolveBotJid(activeSocket?.user?.id);
@@ -7155,6 +7423,24 @@ const handleCatalogApiRequest = async (req, res, pathname, url) => {
     return true;
   }
 
+  if (segments.length === 1 && segments[0] === 'readme-summary') {
+    if (!['GET', 'HEAD'].includes(req.method || '')) {
+      sendJson(req, res, 405, { error: 'Metodo nao permitido.' });
+      return true;
+    }
+    await handleReadmeSummaryRequest(req, res);
+    return true;
+  }
+
+  if (segments.length === 1 && segments[0] === 'readme-markdown') {
+    if (!['GET', 'HEAD'].includes(req.method || '')) {
+      sendJson(req, res, 405, { error: 'Metodo nao permitido.' });
+      return true;
+    }
+    await handleReadmeMarkdownRequest(req, res);
+    return true;
+  }
+
   if (segments.length === 1 && segments[0] === 'support') {
     if (!['GET', 'HEAD'].includes(req.method || '')) {
       sendJson(req, res, 405, { error: 'Metodo nao permitido.' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaikybrofc/omnizap-system",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Sistema profissional de automação WhatsApp com tecnologia Baileys",
   "main": "index.js",
   "publishConfig": {

package/scripts/github-release-notify.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { execSync } from 'node:child_process';
+import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
@@ -80,11 +81,22 @@ if (!repoOwner || !repoName) {
 const tag = getArg('--tag');
 const target = getArg('--target');
 const name = getArg('--name', tag);
-const body = getArg('--body', '');
+const bodyArg = getArg('--body', '');
+const bodyFile = getArg('--body-file', '');
 const generateNotes = toBool(getArg('--generate-notes', 'true'), true);
 const prerelease = toBool(getArg('--prerelease', 'false'), false);
 const draft = toBool(getArg('--draft', 'false'), false);
 
+let body = bodyArg;
+if (!body && bodyFile) {
+  try {
+    body = fs.readFileSync(bodyFile, 'utf8');
+  } catch (error) {
+    console.error(`Falha ao ler --body-file (${bodyFile}): ${error?.message || error}`);
+    process.exit(1);
+  }
+}
+
 if (!tag) {
   console.error('Parâmetro obrigatório ausente: --tag');
   process.exit(1);

package/scripts/release.sh

@@ -13,6 +13,9 @@ RELEASE_GIT_BRANCH="${RELEASE_GIT_BRANCH:-}"
 RELEASE_GIT_PRE_COMMIT_MESSAGE="${RELEASE_GIT_PRE_COMMIT_MESSAGE:-chore(release): auto-commit before release}"
 RELEASE_GIT_COMMIT_VERSION="${RELEASE_GIT_COMMIT_VERSION:-1}"
 RELEASE_GIT_VERSION_COMMIT_PREFIX="${RELEASE_GIT_VERSION_COMMIT_PREFIX:-chore(release): v}"
+RELEASE_GIT_TAG_CREATE="${RELEASE_GIT_TAG_CREATE:-1}"
+RELEASE_GIT_TAG_PUSH="${RELEASE_GIT_TAG_PUSH:-1}"
+RELEASE_GIT_TAG_ANNOTATED="${RELEASE_GIT_TAG_ANNOTATED:-1}"
 RELEASE_GITHUB_RELEASE="${RELEASE_GITHUB_RELEASE:-1}"
 RELEASE_REQUIRE_GITHUB_RELEASE="${RELEASE_REQUIRE_GITHUB_RELEASE:-1}"
 RELEASE_GITHUB_TAG_PREFIX="${RELEASE_GITHUB_TAG_PREFIX:-v}"
@@ -21,6 +24,8 @@ RELEASE_GITHUB_GENERATE_NOTES="${RELEASE_GITHUB_GENERATE_NOTES:-1}"
 RELEASE_GITHUB_PRERELEASE="${RELEASE_GITHUB_PRERELEASE:-}"
 RELEASE_GITHUB_DRAFT="${RELEASE_GITHUB_DRAFT:-0}"
 RELEASE_GITHUB_TARGET="${RELEASE_GITHUB_TARGET:-}"
+RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES="${RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES:-1}"
+RELEASE_GITHUB_RELEASE_MAX_FILES="${RELEASE_GITHUB_RELEASE_MAX_FILES:-300}"
 RELEASE_REQUIRE_DUAL_PUBLISH="${RELEASE_REQUIRE_DUAL_PUBLISH:-1}"
 RELEASE_VERIFY_UNIFIED_VERSION="${RELEASE_VERIFY_UNIFIED_VERSION:-1}"
 RELEASE_VERIFY_PRIMARY_REGISTRY="${RELEASE_VERIFY_PRIMARY_REGISTRY:-${DEPLOY_PACKAGE_REGISTRY:-https://npm.pkg.github.com}}"
@@ -28,6 +33,7 @@ RELEASE_VERIFY_SECONDARY_REGISTRY="${RELEASE_VERIFY_SECONDARY_REGISTRY:-${DEPLOY
 RELEASE_VERIFY_PRIMARY_TOKEN_KEYS="${RELEASE_VERIFY_PRIMARY_TOKEN_KEYS:-DEPLOY_PACKAGE_TOKEN,DEPLOY_GITHUB_TOKEN,GITHUB_TOKEN,GH_TOKEN,NPM_TOKEN,NODE_AUTH_TOKEN}"
 RELEASE_VERIFY_SECONDARY_TOKEN_KEYS="${RELEASE_VERIFY_SECONDARY_TOKEN_KEYS:-DEPLOY_PACKAGE_SECONDARY_TOKEN,NPM_TOKEN,NODE_AUTH_TOKEN}"
 TMP_NPMRC_FILES=()
+TMP_MISC_FILES=()
 
 case "$RELEASE_TYPE" in
   patch|minor|major|prepatch|preminor|premajor|prerelease)
@@ -43,14 +49,19 @@ log() {
   printf '[release] %s\n' "$*"
 }
 
-cleanup_tmp_npmrcs() {
+cleanup_tmp_files() {
   for npmrc_tmp in "${TMP_NPMRC_FILES[@]:-}"; do
     if [ -n "$npmrc_tmp" ] && [ -f "$npmrc_tmp" ]; then
       rm -f "$npmrc_tmp"
     fi
   done
+  for tmp_file in "${TMP_MISC_FILES[@]:-}"; do
+    if [ -n "$tmp_file" ] && [ -f "$tmp_file" ]; then
+      rm -f "$tmp_file"
+    fi
+  done
 }
-trap cleanup_tmp_npmrcs EXIT
+trap cleanup_tmp_files EXIT
 
 require_cmd() {
   if ! command -v "$1" >/dev/null 2>&1; then
@@ -217,6 +228,119 @@ compute_target_version() {
   printf ''
 }
 
+resolve_previous_release_tag() {
+  local current_tag="$1"
+  (
+    cd "$PROJECT_ROOT" &&
+    git tag --list "${RELEASE_GITHUB_TAG_PREFIX}[0-9]*" --sort=-version:refname |
+      grep -Fvx "$current_tag" |
+      head -n 1
+  )
+}
+
+build_release_body_file() {
+  local current_tag="$1"
+  local target_ref="$2"
+  local body_file=""
+  body_file="$(mktemp /tmp/omnizap-release-body.XXXXXX.md)"
+  TMP_MISC_FILES+=("$body_file")
+
+  local previous_tag=""
+  previous_tag="$(resolve_previous_release_tag "$current_tag")"
+
+  local max_files=300
+  if [[ "$RELEASE_GITHUB_RELEASE_MAX_FILES" =~ ^[0-9]+$ ]] && [ "$RELEASE_GITHUB_RELEASE_MAX_FILES" -gt 0 ]; then
+    max_files="$RELEASE_GITHUB_RELEASE_MAX_FILES"
+  fi
+
+  local -a changed_files=()
+  if [ -n "$previous_tag" ]; then
+    mapfile -t changed_files < <(
+      cd "$PROJECT_ROOT" &&
+      git diff --name-only --diff-filter=ACMRTUXB "${previous_tag}..${target_ref}" |
+        sed '/^$/d'
+    )
+  fi
+
+  {
+    printf '## Arquivos alterados\n\n'
+    if [ -n "$previous_tag" ]; then
+      printf 'Comparação: `%s...%s`\n\n' "$previous_tag" "$current_tag"
+    else
+      printf 'Release inicial (sem tag anterior para comparação).\n\n'
+    fi
+
+    if [ "${#changed_files[@]}" -eq 0 ]; then
+      printf -- '- Nenhum arquivo alterado detectado.\n'
+    else
+      local total="${#changed_files[@]}"
+      local limit="$total"
+      if [ "$total" -gt "$max_files" ]; then
+        limit="$max_files"
+      fi
+
+      local i=0
+      while [ "$i" -lt "$limit" ]; do
+        printf -- '- `%s`\n' "${changed_files[$i]}"
+        i=$((i + 1))
+      done
+
+      if [ "$total" -gt "$max_files" ]; then
+        printf '\n_...e mais %s arquivo(s)._\n' "$((total - max_files))"
+      fi
+    fi
+  } > "$body_file"
+
+  printf '%s' "$body_file"
+}
+
+ensure_release_tag() {
+  local tag_name="$1"
+  local target_ref="$2"
+
+  local local_target_sha=""
+  local_target_sha="$(cd "$PROJECT_ROOT" && git rev-parse "${target_ref}^{}")"
+
+  if (cd "$PROJECT_ROOT" && git rev-parse --verify "refs/tags/${tag_name}" >/dev/null 2>&1); then
+    local local_tag_sha=""
+    local_tag_sha="$(cd "$PROJECT_ROOT" && git rev-parse "${tag_name}^{}")"
+    if [ "$local_tag_sha" != "$local_target_sha" ]; then
+      printf '[release] Tag %s já existe e aponta para outro commit (%s).\n' "$tag_name" "$local_tag_sha" >&2
+      exit 1
+    fi
+    log "Tag ${tag_name} já existe localmente."
+  else
+    if [ "$RELEASE_GIT_TAG_CREATE" != "1" ]; then
+      printf '[release] Tag %s não existe e RELEASE_GIT_TAG_CREATE=0.\n' "$tag_name" >&2
+      exit 1
+    fi
+    log "Criando tag ${tag_name}"
+    if [ "$RELEASE_GIT_TAG_ANNOTATED" = "1" ]; then
+      (cd "$PROJECT_ROOT" && git tag -a "$tag_name" -m "Release ${tag_name}" "$target_ref")
+    else
+      (cd "$PROJECT_ROOT" && git tag "$tag_name" "$target_ref")
+    fi
+  fi
+
+  if [ "$RELEASE_GIT_TAG_PUSH" = "1" ]; then
+    local remote_sha=""
+    remote_sha="$(cd "$PROJECT_ROOT" && git ls-remote --tags "$RELEASE_GIT_REMOTE" "refs/tags/${tag_name}^{}" | awk 'NR==1{print $1}')"
+    if [ -z "$remote_sha" ]; then
+      remote_sha="$(cd "$PROJECT_ROOT" && git ls-remote --tags "$RELEASE_GIT_REMOTE" "refs/tags/${tag_name}" | awk 'NR==1{print $1}')"
+    fi
+
+    if [ -z "$remote_sha" ]; then
+      log "Enviando tag ${tag_name} para ${RELEASE_GIT_REMOTE}"
+      (cd "$PROJECT_ROOT" && git push "$RELEASE_GIT_REMOTE" "refs/tags/${tag_name}")
+    elif [ "$remote_sha" != "$local_target_sha" ]; then
+      printf '[release] Tag remota %s já existe e aponta para outro commit (%s).\n' "$tag_name" "$remote_sha" >&2
+      exit 1
+    else
+      log "Tag ${tag_name} já existe no remoto ${RELEASE_GIT_REMOTE}."
+    fi
+  fi
+}
+
 commit_and_push_if_dirty() {
   local commit_message="$1"
 
@@ -320,6 +444,14 @@ if [ "$RELEASE_GIT_COMMIT_VERSION" = "1" ]; then
 fi
 
 release_tag="${RELEASE_GITHUB_TAG_PREFIX}${new_version}"
+release_target_ref="$(cd "$PROJECT_ROOT" && git rev-parse HEAD)"
+
+if [ -n "$(cd "$PROJECT_ROOT" && git status --porcelain --untracked-files=no)" ]; then
+  printf '[release] Working tree com alterações rastreadas antes de criar tag/release. Ajuste RELEASE_GIT_COMMIT_VERSION ou commite manualmente.\n' >&2
+  exit 1
+fi
+
+ensure_release_tag "$release_tag" "$release_target_ref"
 
 if [ "$RELEASE_GITHUB_RELEASE" = "1" ]; then
   if [ "$RELEASE_GIT_AUTO_PUSH" != "1" ]; then
@@ -330,7 +462,7 @@ if [ "$RELEASE_GITHUB_RELEASE" = "1" ]; then
   local_name="${RELEASE_GITHUB_NAME_PREFIX}${new_version}"
   local_target="$RELEASE_GITHUB_TARGET"
   if [ -z "$local_target" ]; then
-    local_target="$(cd "$PROJECT_ROOT" && git rev-parse HEAD)"
+    local_target="$release_target_ref"
   fi
 
   local_prerelease="$RELEASE_GITHUB_PRERELEASE"
@@ -342,23 +474,40 @@ if [ "$RELEASE_GITHUB_RELEASE" = "1" ]; then
     fi
   fi
 
-  local generate_notes_bool=""
+  generate_notes_bool=""
   generate_notes_bool="$(to_bool "$RELEASE_GITHUB_GENERATE_NOTES")"
-  local prerelease_bool=""
+  prerelease_bool=""
   prerelease_bool="$(to_bool "$local_prerelease")"
-  local draft_bool=""
+  draft_bool=""
   draft_bool="$(to_bool "$RELEASE_GITHUB_DRAFT")"
+  release_body_file=""
+  if [ "$RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES" = "1" ]; then
+    release_body_file="$(build_release_body_file "$release_tag" "$release_target_ref")"
+  fi
 
   log "Criando/atualizando GitHub Release ($release_tag)"
-  release_output="$(
-    cd "$PROJECT_ROOT" && node ./scripts/github-release-notify.mjs upsert \
-      --tag "$release_tag" \
-      --target "$local_target" \
-      --name "$local_name" \
-      --generate-notes "$generate_notes_bool" \
-      --prerelease "$prerelease_bool" \
-      --draft "$draft_bool"
-  )"
+  if [ -n "$release_body_file" ]; then
+    release_output="$(
+      cd "$PROJECT_ROOT" && node ./scripts/github-release-notify.mjs upsert \
+        --tag "$release_tag" \
+        --target "$local_target" \
+        --name "$local_name" \
+        --body-file "$release_body_file" \
+        --generate-notes "$generate_notes_bool" \
+        --prerelease "$prerelease_bool" \
+        --draft "$draft_bool"
+    )"
+  else
+    release_output="$(
+      cd "$PROJECT_ROOT" && node ./scripts/github-release-notify.mjs upsert \
+        --tag "$release_tag" \
+        --target "$local_target" \
+        --name "$local_name" \
+        --generate-notes "$generate_notes_bool" \
+        --prerelease "$prerelease_bool" \
+        --draft "$draft_bool"
+    )"
+  fi
   log "GitHub Release atualizado: $release_output"
 fi
 
@@ -376,6 +525,33 @@ if [ "$RELEASE_VERIFY_UNIFIED_VERSION" = "1" ]; then
   fi
   log "Verificado localmente: versão=$local_version_now"
 
+  tag_commit_now="$(cd "$PROJECT_ROOT" && git rev-parse "${release_tag}^{}" 2>/dev/null || true)"
+  if [ -z "$tag_commit_now" ]; then
+    printf '[release] Tag local ausente: %s\n' "$release_tag" >&2
+    exit 1
+  fi
+  if [ "$tag_commit_now" != "$release_target_ref" ]; then
+    printf '[release] Tag local %s aponta para commit divergente (%s).\n' "$release_tag" "$tag_commit_now" >&2
+    exit 1
+  fi
+  log "Verificada tag local: ${release_tag} -> ${tag_commit_now}"
+
+  if [ "$RELEASE_GIT_TAG_PUSH" = "1" ]; then
+    remote_tag_sha="$(cd "$PROJECT_ROOT" && git ls-remote --tags "$RELEASE_GIT_REMOTE" "refs/tags/${release_tag}^{}" | awk 'NR==1{print $1}')"
+    if [ -z "$remote_tag_sha" ]; then
+      remote_tag_sha="$(cd "$PROJECT_ROOT" && git ls-remote --tags "$RELEASE_GIT_REMOTE" "refs/tags/${release_tag}" | awk 'NR==1{print $1}')"
+    fi
+    if [ -z "$remote_tag_sha" ]; then
+      printf '[release] Tag remota ausente: %s em %s\n' "$release_tag" "$RELEASE_GIT_REMOTE" >&2
+      exit 1
+    fi
+    if [ "$remote_tag_sha" != "$release_target_ref" ]; then
+      printf '[release] Tag remota %s divergente (%s).\n' "$release_tag" "$remote_tag_sha" >&2
+      exit 1
+    fi
+    log "Verificada tag remota: ${release_tag} -> ${remote_tag_sha}"
+  fi
+
   verify_registry_version "$pkg_name" "$new_version" "$RELEASE_VERIFY_PRIMARY_REGISTRY" "$RELEASE_VERIFY_PRIMARY_TOKEN_KEYS" "1"
   verify_registry_version "$pkg_name" "$new_version" "$RELEASE_VERIFY_SECONDARY_REGISTRY" "$RELEASE_VERIFY_SECONDARY_TOKEN_KEYS" "0"
 

package/RELEASE-v2.1.2.md

@@ -1,83 +0,0 @@
-# v2.1.3
-
-Atualiza a versão para `2.1.3` e consolida o ciclo de entregas desde a `v2.1.2`.
-
-Período do ciclo: `2026-02-26` a `2026-02-27`  
-Comparação base: `v2.1.2..HEAD`  
-Escopo: **39 commits** e **71 arquivos alterados**
-
-## Destaques
-
-- Plataforma web de stickers expandida de ponta a ponta: criação de packs no browser, upload de mídia (imagem/vídeo), fluxo de publicação e dashboard de criador.
-- Marketplace e descoberta evoluídos: categorias, sorting, ranking de criadores, métricas globais, cards/UX mobile e melhorias de navegação.
-- SEO e indexação: `sitemap`, ajustes de páginas SEO por pack e controles de exposição NSFW no catálogo.
-- Classificação inteligente e curadoria automática reforçadas: pipeline CLIP/MobileCLIP/OpenCLIP, fila de reprocessamento, clustering semântico e otimizações do auto-pack por tags.
-- Admin panel consolidado com moderação: gestão de bans e role de moderador, com persistência de sessão Google Web.
-- Backend mais robusto: limpeza segura de órfãos, proteção de mutações, idempotência em uploads/publicação e novos caches para stats/sumários.
-- Runtime e resiliência: reconexão de socket aprimorada, tratamento de rejeições transitórias e ajustes de agendamento em background.
-- Banco e deploy: novas migrations para classificação/engajamento/workers/admin, e ajuste no nome do banco com sufixo por ambiente.
-
-## Banco de dados e migrations
-
-Este ciclo adiciona migrations estruturais importantes:
-
-- `20260226_0011_sticker_asset_classification.sql`
-- `20260226_0012_sticker_pack_engagement.sql`
-- `20260226_0013_sticker_marketplace_intelligence.sql`
-- `20260226_0014_sticker_pack_publish_flow.sql`
-- `20260226_0014_sticker_worker_queues.sql`
-- `20260226_0015_sticker_auto_pack_curation_integrity.sql`
-- `20260226_0016_sticker_web_google_auth_persistence.sql`
-- `20260226_0017_sticker_web_admin_ban.sql`
-- `20260226_0018_sticker_web_admin_moderator.sql`
-- `20260227_0019_sticker_classification_v2_signals.sql`
-- `20260227_0020_semantic_theme_clusters.sql`
-
-## Commits incluídos (v2.1.2..HEAD)
-
-- `b46a33f` Improve background scheduling, add cached stats and UI/status enhancements
-- `c43decb` Enable semantic clustering and improve auto-pack scheduler
-- `91f2950` Enhance socket reconnection and prioritize complete sticker packs
-- `64f8e73` Improve classification and auto-pack optimization
-- `d11d78b` Appends environment-based suffix to DB name
-- `b8ede5f` Add advanced auto-pack optimization and CLIP classification pipeline
-- `32e169f` Add SEO, sitemap and NSFW gating to sticker catalog
-- `7271a9b` Adds web links for sticker packs and sets auto-packs to unlisted
-- `7cd1151` Ignore transient rejections and force process exit
-- `5072a0e` Add admin moderator role and revamp admin panel UI
-- `84c08dd` Add admin panel and ban management
-- `27b387b` Persist Google web sessions and add client-side Google auth cache
-- `6c07feb` Improve mobile category-chip touch and scroll behavior
-- `c3ca0ea` Improve auto-pack-by-tags curation and pack metadata
-- `3f6c258` Fix mobile discover tabs behavior
-- `831c279` Adds marketplace global stats API and panel
-- `08fdafe` Add catalog sorting, creators ranking and pack UI improvements
-- `082ba82` Add safe pack management, orphan asset cleanup, and UX/network robustness
-- `d928227` Improve marketplace discovery UX
-- `97fe5f4` Bumps stickers app asset version
-- `d2d1843` Adds sticker upload API and improves creator dashboard UX
-- `be5506b` Adds creator pack management endpoints and dashboard UI
-- `589f671` Add creator profile with Google sign-in
-- `122c1e8` Switches CLIP classifier to MobileCLIP/OpenCLIP
-- `7385d30` Allow spaces in pack names and add tag typeahead
-- `2c5589c` Stops trimming input on field change
-- `067b6f9` Add web pack publish flow with Google auth and idempotent uploads
-- `6953768` Allow image/video uploads with WebP conversion
-- `b33c1b8` Add web pack creation and sticker upload UI/API
-- `2b23441` Add reprocess queue, cohesion scoring and ranking
-- `6342d2b` Add marketplace stats endpoint and homepage preview
-- `55cf8b7` Batch-scans and deduplicates catalog listings
-- `7819fe6` Adds automatic sticker pack curation by tags
-- `8ed61bc` Improve API docs and dynamic sidebar/UI for stickers
-- `d0fd86d` Adds support contact API and enhances sticker catalog UI
-- `c5cb106` Improves pack cards and mobile header UX
-- `3da0375` Adds categories filtering and pack engagement tracking
-- `d9bb604` Adds CLIP-based sticker classification
-- `fffc205` Enhances catalog and API docs UI
-
-## Notas de atualização
-
-- `package.json` atualizado para `2.1.3`.
-- `README.md` atualizado para refletir a versão atual.
-- Recomendado reiniciar o processo de produção após deploy (`pm2 restart ... --update-env`).
-- Atenção para comportamento de nome de banco por ambiente (`DB_NAME` com sufixo `_dev`/`_prod` quando aplicável).