@omnizap-system/omnizap 2.6.0 → 2.6.2

package/scripts/generate-commands-catalog.mjs

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
+import { now as __timeNow, nowIso as __timeNowIso, toUnixMs as __timeNowMs } from '#time';
 
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import prettier from 'prettier';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -58,6 +60,143 @@ const resolveCategoryMeta = (key) => {
   return { label, icon: '🧩' };
 };
 
+const pickFirstText = (...values) => {
+  for (const value of values) {
+    const text = String(value || '').trim();
+    if (text) return text;
+  }
+  return '';
+};
+
+const ensureSentence = (value) => {
+  const text = String(value || '')
+    .trim()
+    .replace(/\s+/g, ' ');
+  if (!text) return '';
+  if (/[.!?]$/.test(text)) return text;
+  return `${text}.`;
+};
+
+const parseOptionalBoolean = (value) => {
+  if (value === true) return true;
+  if (value === false) return false;
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
+  if (!normalized) return null;
+  if (['1', 'true', 'yes', 'sim'].includes(normalized)) return true;
+  if (['0', 'false', 'no', 'nao', 'não'].includes(normalized)) return false;
+  return null;
+};
+
+const normalizeUserList = (value) => unique(ensureArray(value).map((item) => String(item || '').trim()));
+
+const normalizeExampleCommand = (value, fallback = '') => {
+  const raw = String(value || '').trim();
+  if (!raw) return String(fallback || '').trim();
+  return raw.replaceAll('<prefix>', '/');
+};
+
+const normalizeUserExample = (value, { fallbackSituation = '', fallbackCommand = '', fallbackExpected = '', fallbackVariation = '' } = {}) => {
+  if (!value) return null;
+
+  if (typeof value === 'string') {
+    const commandText = normalizeExampleCommand(value, fallbackCommand);
+    if (!commandText) return null;
+    return {
+      situacao: ensureSentence(fallbackSituation || 'Exemplo real de uso do comando'),
+      comando: commandText,
+      resposta_esperada: ensureSentence(fallbackExpected || 'O bot confirma a execução'),
+      variacao: ensureSentence(fallbackVariation || ''),
+    };
+  }
+
+  if (typeof value === 'object' && !Array.isArray(value)) {
+    const situacao = pickFirstText(value.situacao, value.cenario, value.contexto, fallbackSituation);
+    const comando = normalizeExampleCommand(pickFirstText(value.comando, value.command, value.uso), fallbackCommand);
+    const respostaEsperada = pickFirstText(value.resposta_esperada, value.expected_response, value.resposta, fallbackExpected);
+    const variacao = pickFirstText(value.variacao, value.outcome_variation, fallbackVariation);
+
+    if (!comando) return null;
+
+    return {
+      situacao: ensureSentence(situacao || 'Exemplo real de uso do comando'),
+      comando,
+      resposta_esperada: ensureSentence(respostaEsperada || 'O bot confirma a execução'),
+      variacao: ensureSentence(variacao || ''),
+    };
+  }
+
+  return null;
+};
+
+const buildUserExperienceContract = ({ commandName = '', description = '', docsSummary = '', usageMethods = [], responses = {}, requirements = {}, premium = false, rawUserExperience = {} } = {}) => {
+  const explicitSummary = pickFirstText(rawUserExperience.resumo_usuario, rawUserExperience.summary, rawUserExperience.resumo_ia);
+  const explicitSummaryOrigin = pickFirstText(rawUserExperience.resumo_usuario_origem, rawUserExperience.summary_origin);
+  const normalizedSummaryOrigin = explicitSummaryOrigin === 'manual' || explicitSummaryOrigin === 'auto_ia_assistida' ? explicitSummaryOrigin : '';
+  const summaryBase = pickFirstText(explicitSummary, docsSummary, description, `Use /${commandName} para executar esta ação no bot`);
+  const resumoUsuario = ensureSentence(summaryBase);
+  const summaryOrigin = normalizedSummaryOrigin || (explicitSummary ? 'manual' : 'auto_ia_assistida');
+  const explicitReviewPending = parseOptionalBoolean(rawUserExperience.resumo_usuario_revisao_pendente);
+
+  const explicitWhenToUse = normalizeUserList(rawUserExperience.quando_usar || rawUserExperience.when_to_use);
+  const descriptionNoPunctuation = String(description || '')
+    .trim()
+    .replace(/[.!?]+$/, '');
+  const descriptionSentence = ensureSentence(descriptionNoPunctuation);
+  const derivedWhenToUse = unique([descriptionSentence ? `Use quando você precisa desta ação: ${descriptionSentence}` : '', requirements.group ? 'Funciona dentro de grupos.' : 'Pode ser usado no privado e em grupo.', requirements.admin ? 'Você precisa ser admin para executar.' : '', requirements.owner ? 'Esse comando é restrito ao admin principal do sistema.' : '', requirements.google_login ? 'É necessário estar logado no sistema para usar.' : '', premium ? 'Disponível para usuários Premium.' : ''].filter(Boolean));
+  const quandoUsar = explicitWhenToUse.length ? explicitWhenToUse : derivedWhenToUse.slice(0, 5);
+
+  const successResponse = ensureSentence(pickFirstText(rawUserExperience.resposta_sucesso, responses.success, responses.sucesso, 'O bot confirma que executou o comando'));
+  const usageErrorResponse = ensureSentence(pickFirstText(rawUserExperience.resposta_uso_incorreto, responses.usage_error, responses.erro_uso, 'Se o formato estiver incorreto, o bot mostra como usar corretamente'));
+  const permissionResponse = ensureSentence(pickFirstText(rawUserExperience.resposta_sem_permissao, responses.permission_error, responses.erro_permissao, premium ? 'Sem plano Premium ativo, o bot informa a restrição de acesso' : 'Sem permissão suficiente, o bot informa o motivo'));
+
+  const explicitExpectedResponses = normalizeUserList(rawUserExperience.resposta_esperada || rawUserExperience.expected_response);
+  const respostaEsperada = explicitExpectedResponses.length ? explicitExpectedResponses : unique([`Sucesso: ${successResponse}`, `Uso incorreto: ${usageErrorResponse}`, `Permissão: ${permissionResponse}`]);
+
+  const explicitExamples = ensureArray(rawUserExperience.exemplos_reais || rawUserExperience.real_examples);
+  const defaultSituation = descriptionSentence ? `Cenário comum: ${descriptionSentence}` : `Cenário comum: você quer usar /${commandName} no dia a dia.`;
+  const fallbackUsageMethods = usageMethods.length ? usageMethods : [`/${commandName}`];
+  let exemplosReais = explicitExamples
+    .map((example) =>
+      normalizeUserExample(example, {
+        fallbackSituation: defaultSituation,
+        fallbackCommand: fallbackUsageMethods[0] || `/${commandName}`,
+        fallbackExpected: successResponse,
+        fallbackVariation: usageErrorResponse,
+      }),
+    )
+    .filter(Boolean);
+
+  if (!exemplosReais.length) {
+    exemplosReais = fallbackUsageMethods.slice(0, 3).map((usageMethod, index) => ({
+      situacao: ensureSentence(index === 0 ? defaultSituation : `Variação ${index + 1} de uso do comando no mesmo contexto`),
+      comando: normalizeExampleCommand(usageMethod, `/${commandName}`),
+      resposta_esperada: successResponse,
+      variacao: usageErrorResponse,
+    }));
+  }
+
+  const explicitCommonErrors = normalizeUserList(rawUserExperience.erros_comuns_usuario || rawUserExperience.common_user_errors);
+  const derivedCommonErrors = unique(['Digitar o comando fora do formato esperado.', requirements.group ? 'Tentar executar fora de um grupo.' : '', requirements.admin ? 'Tentar executar sem ser admin.' : '', requirements.owner ? 'Tentar executar sem ser admin principal do sistema.' : '', requirements.google_login ? 'Tentar usar sem estar logado no sistema.' : '', premium ? 'Tentar usar sem acesso Premium ativo.' : ''].filter(Boolean));
+  const errosComunsUsuario = explicitCommonErrors.length ? explicitCommonErrors : derivedCommonErrors.slice(0, 5);
+
+  const explicitErrorSteps = normalizeUserList(rawUserExperience.passos_se_der_erro || rawUserExperience.error_steps);
+  const fallbackErrorSteps = ['Copie e teste um exemplo pronto desta página.', 'Confira se você está no local certo (grupo/privado) e com a permissão necessária.', premium ? 'Verifique se seu acesso Premium está ativo.' : '', 'Se ainda falhar, fale com o admin do sistema no privado.'].filter(Boolean);
+  const passosSeDerErro = explicitErrorSteps.length ? explicitErrorSteps : fallbackErrorSteps;
+
+  return {
+    resumo_usuario: resumoUsuario,
+    quando_usar: quandoUsar,
+    exemplos_reais: exemplosReais,
+    resposta_esperada: respostaEsperada,
+    erros_comuns_usuario: errosComunsUsuario,
+    passos_se_der_erro: passosSeDerErro,
+    resumo_usuario_origem: summaryOrigin,
+    resumo_usuario_revisao_pendente: explicitReviewPending ?? summaryOrigin !== 'manual',
+  };
+};
+
 const deepMerge = (target, source) => {
   if (!source) return target;
   const output = { ...target };
@@ -160,6 +299,23 @@ const sanitizeCommand = ({ command: rawCommand, moduleDefaults, moduleDirName, m
   const sideEffects = unique([...ensureArray(command?.efeitos_colaterais), ...ensureArray(command?.side_effects)]);
 
   const responses = deepMerge(moduleDefaults?.responses || moduleDefaults?.respostas_padrao || {}, command?.responses || command?.respostas_padrao || {});
+  const userExperienceSeed = deepMerge(moduleDefaults?.user_experience || moduleDefaults?.experiencia_usuario || {}, command?.user_experience || command?.experiencia_usuario || {});
+  if (command?.resumo_usuario !== undefined) userExperienceSeed.resumo_usuario = command.resumo_usuario;
+  if (command?.quando_usar !== undefined) userExperienceSeed.quando_usar = command.quando_usar;
+  if (command?.exemplos_reais !== undefined) userExperienceSeed.exemplos_reais = command.exemplos_reais;
+  if (command?.resposta_esperada !== undefined) userExperienceSeed.resposta_esperada = command.resposta_esperada;
+  if (command?.erros_comuns_usuario !== undefined) userExperienceSeed.erros_comuns_usuario = command.erros_comuns_usuario;
+  if (command?.passos_se_der_erro !== undefined) userExperienceSeed.passos_se_der_erro = command.passos_se_der_erro;
+  const userExperience = buildUserExperienceContract({
+    commandName,
+    description: String(command?.description || command?.descricao || '').trim(),
+    docsSummary: String(command?.docs?.summary || '').trim(),
+    usageMethods,
+    responses,
+    requirements,
+    premium,
+    rawUserExperience: userExperienceSeed,
+  });
 
   const observability = deepMerge(moduleDefaults?.observability || {}, command?.observability || {});
   const privacy = deepMerge(moduleDefaults?.privacy || {}, command?.privacy || {});
@@ -183,6 +339,7 @@ const sanitizeCommand = ({ command: rawCommand, moduleDefaults, moduleDirName, m
     subcomandos: unique(ensureArray(command?.subcomandos).map((item) => String(item).trim())),
     metodos_de_uso: usageMethods,
     mensagens_uso: normalizedUsageVariants,
+    ...userExperience,
     arguments: args,
     responses,
     technical: {
@@ -283,7 +440,7 @@ const buildCatalog = async () => {
 
   return {
     schema_version: '3.0.0',
-    generated_at: new Date().toISOString(),
+    generated_at: __timeNowIso(),
     totals: {
       modules: sortedModules.length,
       categories: categories.length,
@@ -297,7 +454,14 @@ const buildCatalog = async () => {
 const writeCatalog = async () => {
   const payload = await buildCatalog();
   await fs.mkdir(path.dirname(outputPath), { recursive: true });
-  await fs.writeFile(outputPath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+  const serialized = `${JSON.stringify(payload, null, 2)}\n`;
+  const prettierConfig = (await prettier.resolveConfig(outputPath)) || {};
+  const formatted = await prettier.format(serialized, {
+    ...prettierConfig,
+    parser: 'json',
+    filepath: outputPath,
+  });
+  await fs.writeFile(outputPath, formatted, 'utf8');
 
   console.log(`Catalogo de comandos atualizado: ${path.relative(repoRoot, outputPath)} (${payload.totals.commands} comandos)`);
 };

package/scripts/generate-module-agents.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { now as __timeNow, nowIso as __timeNowIso, toUnixMs as __timeNowMs } from '#time';
 
 import fs from 'node:fs/promises';
 import path from 'node:path';
@@ -8,7 +9,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const repoRoot = path.resolve(__dirname, '..');
 const modulesRoot = path.join(repoRoot, 'app', 'modules');
-const nowIso = new Date().toISOString();
+const nowIso = __timeNowIso();
 
 const normalizeBoolLabel = (value) => (value ? 'sim' : 'nao');
 

package/scripts/generate-seo-satellite-pages.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { now as __timeNow, nowIso as __timeNowIso, toUnixMs as __timeNowMs } from '#time';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
@@ -173,7 +174,7 @@ const renderPageHtml = (page, generatedAt, { slugSet, prefix }) => {
     url: canonicalUrl,
     isPartOf: {
       '@type': 'WebSite',
-      name: 'OmniZap System',
+      name: 'Omnizap',
       url: SITE_ORIGIN,
     },
   };
@@ -205,7 +206,7 @@ const renderPageHtml = (page, generatedAt, { slugSet, prefix }) => {
 
   <meta property="og:type" content="article" />
   <meta property="og:locale" content="pt_BR" />
-  <meta property="og:site_name" content="OmniZap System" />
+  <meta property="og:site_name" content="Omnizap" />
   <meta property="og:title" content="${escapeHtml(page.title)}" />
   <meta property="og:description" content="${escapeHtml(page.description)}" />
   <meta property="og:url" content="${escapeHtml(canonicalUrl)}" />
@@ -349,7 +350,7 @@ const renderPageHtml = (page, generatedAt, { slugSet, prefix }) => {
     </main>
 
     <footer class="footer-meta">
-      © 2026 OMNIZAP SYSTEM · SEO SATELLITE V2 · ATUALIZADO EM ${escapeHtml(generatedAt)}
+      © 2026 OMNIZAP · SEO SATELLITE V2 · ATUALIZADO EM ${escapeHtml(generatedAt)}
     </footer>
   </div>
 </body>
@@ -364,7 +365,7 @@ const run = async () => {
   const rawConfig = await fs.readFile(absoluteConfigPath, 'utf8');
   const parsedConfig = JSON.parse(rawConfig);
   const pages = Array.isArray(parsedConfig?.pages) ? parsedConfig.pages : [];
-  const generatedAt = String(parsedConfig?.generated_at || new Date().toISOString().slice(0, 10)).trim();
+  const generatedAt = String(parsedConfig?.generated_at || __timeNowIso().slice(0, 10)).trim();
 
   if (!pages.length) {
     throw new Error('config sem paginas');

package/scripts/github-deploy-notify.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { now as __timeNow, nowIso as __timeNowIso, toUnixMs as __timeNowMs } from '#time';
 
 import { execSync } from 'node:child_process';
 import path from 'node:path';
@@ -128,7 +129,7 @@ const run = async () => {
   const baseUrl = `https://api.github.com/repos/${encodeURIComponent(repoOwner)}/${encodeURIComponent(repoName)}`;
 
   if (action === 'start') {
-    const startDescription = description || `Deploy OmniZap ${buildId || new Date().toISOString()}`;
+    const startDescription = description || `Deploy OmniZap ${buildId || __timeNowIso()}`;
     const deployment = await request(`${baseUrl}/deployments`, 'POST', {
       ref: currentRef(),
       task: 'deploy',

package/scripts/github-release-notify.mjs

@@ -1,7 +1,6 @@
 #!/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';
@@ -99,13 +98,16 @@ const target = getArg('--target');
 const name = getArg('--name', tag);
 const bodyArg = getArg('--body', '');
 const bodyFile = getArg('--body-file', '');
+const bodyStdin = toBool(getArg('--body-stdin', 'false'), false);
 const generateNotes = toBool(getArg('--generate-notes', 'true'), true);
 const prerelease = toBool(getArg('--prerelease', 'false'), false);
 const draft = toBool(getArg('--draft', 'false'), false);
 const latestArg = getArg('--latest', '');
 
 const parseMakeLatest = (value) => {
-  const normalized = String(value || '').trim().toLowerCase();
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
   if (!normalized) return '';
   if (['1', 'true', 'yes', 'on'].includes(normalized)) return 'true';
   if (['0', 'false', 'no', 'off'].includes(normalized)) return 'false';
@@ -114,17 +116,28 @@ const parseMakeLatest = (value) => {
 };
 const makeLatest = parseMakeLatest(latestArg);
 
-let body = bodyArg;
-if (!body && bodyFile) {
-  try {
+const readBodyFromStdin = async () => {
+  if (process.stdin.isTTY) return '';
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString('utf8');
+};
+
+const resolveReleaseBody = async () => {
+  if (bodyArg) return sanitizeReleaseBody(bodyArg);
+  if (bodyStdin) {
+    const stdinBody = await readBodyFromStdin();
+    return sanitizeReleaseBody(stdinBody);
+  }
+  if (bodyFile) {
     const resolvedBodyFile = resolveBodyFilePath(bodyFile);
-    body = fs.readFileSync(resolvedBodyFile, 'utf8');
-  } catch (error) {
-    console.error(`Falha ao ler --body-file (${bodyFile}): ${error?.message || error}`);
+    console.error(`Parâmetro --body-file não é suportado neste script. Envie o conteúdo via stdin com --body-stdin true (arquivo: ${resolvedBodyFile}).`);
     process.exit(1);
   }
-}
-body = sanitizeReleaseBody(body);
+  return '';
+};
 
 if (!tag) {
   console.error('Parâmetro obrigatório ausente: --tag');
@@ -140,6 +153,7 @@ const headers = {
 };
 
 const request = async (url, method, payload) => {
+  // lgtm[js/file-access-to-http]
   const response = await fetch(url, {
     method,
     headers,
@@ -169,6 +183,7 @@ const failFromResponse = (response, fallbackPrefix = 'GitHub API') => {
 };
 
 const run = async () => {
+  const body = await resolveReleaseBody();
   const baseUrl = `https://api.github.com/repos/${encodeURIComponent(repoOwner)}/${encodeURIComponent(repoName)}`;
 
   const byTag = await request(`${baseUrl}/releases/tags/${encodeURIComponent(tag)}`, 'GET');

package/scripts/new-whatsapp-session.sh

@@ -0,0 +1,317 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+ENV_FILE="${ENV_FILE:-$PROJECT_ROOT/.env}"
+
+SESSION_ID_PATTERN='^[a-zA-Z0-9:_-]+$'
+SESSION_ID_MAX_LENGTH=64
+
+SESSION_ID=""
+SESSION_PREFIX="work"
+SESSION_WEIGHT=1
+SET_PRIMARY=0
+CONNECT_NOW=1
+RESET_AUTH=0
+CLEAR_AUTH_FILES=0
+ALLOW_REUSE=0
+
+log() {
+  printf '[new-whatsapp-session] %s\n' "$*"
+}
+
+fail() {
+  printf '[new-whatsapp-session] erro: %s\n' "$*" >&2
+  exit 1
+}
+
+require_cmd() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    fail "comando ausente: $1"
+  fi
+}
+
+usage() {
+  cat <<'EOF'
+Uso:
+  bash scripts/new-whatsapp-session.sh [opcoes]
+
+Opcoes:
+  --session <id>           Define o session_id manualmente.
+  --prefix <valor>         Prefixo para gerar session_id automatico (padrao: work).
+  --weight <1-1000>        Peso da sessao em BAILEYS_SESSION_WEIGHTS (padrao: 1).
+  --primary                Define a nova sessao como BAILEYS_PRIMARY_SESSION_ID.
+  --reuse                  Permite usar um session_id ja existente.
+  --reset-auth             Limpa credenciais atuais da sessao no MySQL antes do QR.
+  --clear-auth-files       Junto com --reset-auth, remove app/connection/auth/*.json.
+  --no-connect             Apenas atualiza .env (nao abre conexao para QR agora).
+  --help                   Mostra esta ajuda.
+
+Exemplos:
+  npm run new:work
+  npm run new:work -- --session suporte_2 --primary
+  bash scripts/new-whatsapp-session.sh --prefix operador --no-connect
+EOF
+}
+
+strip_wrapping_quotes() {
+  local value="${1:-}"
+  if [[ "$value" == \"*\" && "$value" == *\" ]]; then
+    value="${value:1:${#value}-2}"
+  elif [[ "$value" == \'*\' && "$value" == *\' ]]; then
+    value="${value:1:${#value}-2}"
+  fi
+  printf '%s' "$value"
+}
+
+read_env_value() {
+  local key="$1"
+  local raw=""
+
+  if [[ -f "$ENV_FILE" ]]; then
+    raw="$(grep -E "^${key}=" "$ENV_FILE" | tail -n 1 | cut -d'=' -f2- || true)"
+  fi
+
+  raw="${raw//$'\r'/}"
+  strip_wrapping_quotes "$raw"
+}
+
+split_entries() {
+  printf '%s' "${1:-}" | tr ',;\n' '\n' | sed -E 's/^[[:space:]]+//; s/[[:space:]]+$//' | awk 'NF'
+}
+
+validate_session_id() {
+  local value="$1"
+  [[ -n "$value" ]] || return 1
+  [[ "${#value}" -le "$SESSION_ID_MAX_LENGTH" ]] || return 1
+  [[ "$value" =~ $SESSION_ID_PATTERN ]] || return 1
+  return 0
+}
+
+upsert_env_value() {
+  local key="$1"
+  local value="$2"
+  local temp_file
+  temp_file="$(mktemp)"
+
+  awk -v key="$key" -v value="$value" '
+    BEGIN {
+      replaced = 0;
+      prefix = key "=";
+    }
+    index($0, prefix) == 1 {
+      if (replaced == 0) {
+        print prefix value;
+        replaced = 1;
+      }
+      next;
+    }
+    { print; }
+    END {
+      if (replaced == 0) {
+        print prefix value;
+      }
+    }
+  ' "$ENV_FILE" >"$temp_file"
+
+  mv "$temp_file" "$ENV_FILE"
+}
+
+is_valid_weight() {
+  local value="$1"
+  [[ "$value" =~ ^[0-9]+$ ]] || return 1
+  ((value >= 1 && value <= 1000)) || return 1
+  return 0
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --session)
+      [[ $# -ge 2 ]] || fail "faltou valor para --session"
+      SESSION_ID="$2"
+      shift 2
+      ;;
+    --prefix)
+      [[ $# -ge 2 ]] || fail "faltou valor para --prefix"
+      SESSION_PREFIX="$2"
+      shift 2
+      ;;
+    --weight)
+      [[ $# -ge 2 ]] || fail "faltou valor para --weight"
+      SESSION_WEIGHT="$2"
+      shift 2
+      ;;
+    --primary)
+      SET_PRIMARY=1
+      shift
+      ;;
+    --reuse)
+      ALLOW_REUSE=1
+      shift
+      ;;
+    --reset-auth)
+      RESET_AUTH=1
+      shift
+      ;;
+    --clear-auth-files)
+      CLEAR_AUTH_FILES=1
+      shift
+      ;;
+    --no-connect)
+      CONNECT_NOW=0
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      fail "opcao invalida: $1 (use --help)"
+      ;;
+  esac
+done
+
+[[ -f "$ENV_FILE" ]] || fail "arquivo .env nao encontrado em: $ENV_FILE"
+is_valid_weight "$SESSION_WEIGHT" || fail "peso invalido em --weight: $SESSION_WEIGHT (use 1..1000)"
+
+if [[ -n "$SESSION_ID" ]]; then
+  validate_session_id "$SESSION_ID" || fail "session_id invalido: \"$SESSION_ID\""
+else
+  validate_session_id "$SESSION_PREFIX" || fail "prefixo invalido para session_id: \"$SESSION_PREFIX\""
+fi
+
+declare -A SEEN_SESSION_IDS=()
+declare -a SESSION_IDS=()
+
+existing_session_ids_raw="$(read_env_value BAILEYS_SESSION_IDS)"
+legacy_session_id_raw="$(read_env_value BAILEYS_AUTH_SESSION_ID)"
+if [[ -z "$existing_session_ids_raw" ]]; then
+  existing_session_ids_raw="$legacy_session_id_raw"
+fi
+if [[ -z "$existing_session_ids_raw" ]]; then
+  existing_session_ids_raw="default"
+fi
+
+while IFS= read -r candidate; do
+  [[ -n "$candidate" ]] || continue
+  if ! validate_session_id "$candidate"; then
+    log "ignorado session_id invalido no .env: $candidate"
+    continue
+  fi
+  if [[ -z "${SEEN_SESSION_IDS[$candidate]+x}" ]]; then
+    SEEN_SESSION_IDS["$candidate"]=1
+    SESSION_IDS+=("$candidate")
+  fi
+done < <(split_entries "$existing_session_ids_raw")
+
+if [[ "${#SESSION_IDS[@]}" -eq 0 ]]; then
+  SESSION_IDS=("default")
+  SEEN_SESSION_IDS["default"]=1
+fi
+
+if [[ -z "$SESSION_ID" ]]; then
+  base_id="${SESSION_PREFIX}-$(date -u +%Y%m%d%H%M%S)"
+  generated_id="$base_id"
+  suffix=1
+  while [[ -n "${SEEN_SESSION_IDS[$generated_id]+x}" ]]; do
+    suffix=$((suffix + 1))
+    generated_id="${base_id}-${suffix}"
+  done
+  SESSION_ID="$generated_id"
+fi
+
+if [[ -n "${SEEN_SESSION_IDS[$SESSION_ID]+x}" && "$ALLOW_REUSE" != "1" ]]; then
+  fail "session_id \"$SESSION_ID\" ja existe. Use --reuse para permitir reutilizacao."
+fi
+
+if [[ -z "${SEEN_SESSION_IDS[$SESSION_ID]+x}" ]]; then
+  SESSION_IDS+=("$SESSION_ID")
+  SEEN_SESSION_IDS["$SESSION_ID"]=1
+fi
+
+current_primary_session_id="$(read_env_value BAILEYS_PRIMARY_SESSION_ID)"
+if ! validate_session_id "$current_primary_session_id"; then
+  current_primary_session_id="${SESSION_IDS[0]}"
+fi
+if [[ -z "${SEEN_SESSION_IDS[$current_primary_session_id]+x}" ]]; then
+  current_primary_session_id="${SESSION_IDS[0]}"
+fi
+
+if [[ "$SET_PRIMARY" == "1" ]]; then
+  current_primary_session_id="$SESSION_ID"
+fi
+
+declare -A SESSION_WEIGHTS=()
+weights_raw="$(read_env_value BAILEYS_SESSION_WEIGHTS)"
+while IFS= read -r raw_entry; do
+  [[ -n "$raw_entry" ]] || continue
+  separator='='
+  if [[ "$raw_entry" == *":"* && "$raw_entry" != *"="* ]]; then
+    separator=':'
+  fi
+  if [[ "$raw_entry" != *"$separator"* ]]; then
+    continue
+  fi
+
+  raw_session="${raw_entry%%"$separator"*}"
+  raw_weight="${raw_entry#*"$separator"}"
+  if ! validate_session_id "$raw_session"; then
+    continue
+  fi
+  if is_valid_weight "$raw_weight"; then
+    SESSION_WEIGHTS["$raw_session"]="$raw_weight"
+  fi
+done < <(split_entries "$weights_raw")
+
+SESSION_WEIGHTS["$SESSION_ID"]="$SESSION_WEIGHT"
+for existing_session in "${SESSION_IDS[@]}"; do
+  if [[ -z "${SESSION_WEIGHTS[$existing_session]+x}" ]]; then
+    SESSION_WEIGHTS["$existing_session"]=1
+  fi
+done
+
+session_ids_value="$(IFS=,; printf '%s' "${SESSION_IDS[*]}")"
+declare -a weight_entries=()
+for listed_session in "${SESSION_IDS[@]}"; do
+  weight_entries+=("${listed_session}=${SESSION_WEIGHTS[$listed_session]}")
+done
+weights_value="$(IFS=,; printf '%s' "${weight_entries[*]}")"
+
+upsert_env_value "BAILEYS_SESSION_IDS" "$session_ids_value"
+upsert_env_value "BAILEYS_PRIMARY_SESSION_ID" "$current_primary_session_id"
+upsert_env_value "BAILEYS_SESSION_WEIGHTS" "$weights_value"
+
+legacy_auth_session_id="$(read_env_value BAILEYS_AUTH_SESSION_ID)"
+if [[ -z "$legacy_auth_session_id" || "$SET_PRIMARY" == "1" ]]; then
+  upsert_env_value "BAILEYS_AUTH_SESSION_ID" "$current_primary_session_id"
+fi
+
+if [[ "$RESET_AUTH" == "1" ]]; then
+  reset_args=(--session "$SESSION_ID")
+  if [[ "$CLEAR_AUTH_FILES" == "1" ]]; then
+    reset_args+=(--clear-auth-files)
+  fi
+  bash "$PROJECT_ROOT/scripts/clear-whatsapp-session.sh" "${reset_args[@]}"
+fi
+
+log "Sessao preparada com sucesso."
+log "session_id: $SESSION_ID"
+log "BAILEYS_SESSION_IDS: $session_ids_value"
+log "BAILEYS_PRIMARY_SESSION_ID: $current_primary_session_id"
+
+if [[ "$CONNECT_NOW" == "1" ]]; then
+  require_cmd node
+  log "Inicializando schema do banco..."
+  node "$PROJECT_ROOT/database/init.js"
+
+  log "Abrindo conexao da sessao '$SESSION_ID' para leitura do QR Code..."
+  export BAILEYS_SESSION_IDS="$SESSION_ID"
+  export BAILEYS_PRIMARY_SESSION_ID="$SESSION_ID"
+  export BAILEYS_AUTH_SESSION_ID="$SESSION_ID"
+
+  log "Apos conectar no WhatsApp, use Ctrl+C para encerrar."
+  exec node "$PROJECT_ROOT/app/connection/socketController.js"
+fi
+
+log "Concluido sem abrir conexao. Para abrir QR agora use:"
+log "  BAILEYS_SESSION_IDS=$SESSION_ID BAILEYS_PRIMARY_SESSION_ID=$SESSION_ID BAILEYS_AUTH_SESSION_ID=$SESSION_ID node app/connection/socketController.js"