@kaikybrofc/omnizap-system 2.2.9 → 2.3.0

package/app/modules/stickerPackModule/semanticReclassificationEngine.js

@@ -11,40 +11,15 @@ const parseEnvBool = (value, fallback) => {
 const clampNumber = (value, min, max) => Math.max(min, Math.min(max, Number(value)));
 
 const RECLASSIFICATION_ENABLED = parseEnvBool(process.env.STICKER_SEMANTIC_RECLASSIFICATION_ENABLED, true);
-const RECLASSIFICATION_BATCH_SIZE = Math.max(
-  50,
-  Math.min(2000, Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_BATCH_SIZE) || 400),
-);
-const RECLASSIFICATION_MAX_PER_CYCLE = Math.max(
-  100,
-  Math.min(20_000, Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_MAX_PER_CYCLE) || 2000),
-);
-const RECLASSIFICATION_ENTROPY_THRESHOLD = Number.isFinite(Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_ENTROPY_THRESHOLD))
-  ? Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_ENTROPY_THRESHOLD)
-  : 0.8;
-const RECLASSIFICATION_AFFINITY_THRESHOLD = Number.isFinite(Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_AFFINITY_THRESHOLD))
-  ? Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_AFFINITY_THRESHOLD)
-  : 0.3;
-
-const STOPWORDS = [
-  'image',
-  'sticker',
-  'wallpaper',
-  'social_media',
-  'internet',
-  'picture',
-];
-const GENERIC_TERMS = [
-  'cool',
-  'nice',
-  'funny',
-  'random',
-  'art',
-];
+const RECLASSIFICATION_BATCH_SIZE = Math.max(50, Math.min(2000, Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_BATCH_SIZE) || 400));
+const RECLASSIFICATION_MAX_PER_CYCLE = Math.max(100, Math.min(20_000, Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_MAX_PER_CYCLE) || 2000));
+const RECLASSIFICATION_ENTROPY_THRESHOLD = Number.isFinite(Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_ENTROPY_THRESHOLD)) ? Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_ENTROPY_THRESHOLD) : 0.8;
+const RECLASSIFICATION_AFFINITY_THRESHOLD = Number.isFinite(Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_AFFINITY_THRESHOLD)) ? Number(process.env.STICKER_SEMANTIC_RECLASSIFICATION_AFFINITY_THRESHOLD) : 0.3;
+
+const STOPWORDS = ['image', 'sticker', 'wallpaper', 'social_media', 'internet', 'picture'];
+const GENERIC_TERMS = ['cool', 'nice', 'funny', 'random', 'art'];
 const SEMANTIC_GROUPS = ['anime', 'meme', 'kawaii', 'horror', 'reaction'];
-const OPPOSITE_THEME_PAIRS = [
-  ['kawaii', 'horror'],
-];
+const OPPOSITE_THEME_PAIRS = [['kawaii', 'horror']];
 
 const DICTIONARY_MAP = {
   'cute anime girl': 'kawaii_anime_girl',
@@ -66,15 +41,13 @@ const toSnakeCase = (value) =>
 
 const STOPWORD_PHRASES = new Set(STOPWORDS.map((value) => toSnakeCase(value)).filter(Boolean));
 const STOPWORD_WORDS = new Set(
-  STOPWORDS
-    .map((value) => toSnakeCase(value))
+  STOPWORDS.map((value) => toSnakeCase(value))
     .flatMap((value) => value.split('_'))
     .filter((value) => value.length >= 3),
 );
 const GENERIC_TERM_SET = new Set(GENERIC_TERMS.map((value) => toSnakeCase(value)).filter(Boolean));
 const GENERIC_TERM_WORDS = new Set(
-  GENERIC_TERMS
-    .map((value) => toSnakeCase(value))
+  GENERIC_TERMS.map((value) => toSnakeCase(value))
     .flatMap((value) => value.split('_'))
     .filter((value) => value.length >= 3),
 );
@@ -342,9 +315,7 @@ export const reclassify = (classification = {}) => {
     dominantTokens = mappedTokens.slice();
   }
 
-  const normalizedSubtags = dominantTokens
-    .map((entry) => normalizeTokenValue(entry.token))
-    .filter(Boolean);
+  const normalizedSubtags = dominantTokens.map((entry) => normalizeTokenValue(entry.token)).filter(Boolean);
 
   const outputSubtags = Array.from(new Set(normalizedSubtags));
   const updatedAffinityWeight = Number(clampNumber(cohesionScore / 100, 0, 1).toFixed(6));
@@ -358,12 +329,7 @@ export const reclassify = (classification = {}) => {
   };
 };
 
-export const batchReprocess = async ({
-  maxItems = RECLASSIFICATION_MAX_PER_CYCLE,
-  batchSize = RECLASSIFICATION_BATCH_SIZE,
-  entropyThreshold = RECLASSIFICATION_ENTROPY_THRESHOLD,
-  affinityThreshold = RECLASSIFICATION_AFFINITY_THRESHOLD,
-} = {}) => {
+export const batchReprocess = async ({ maxItems = RECLASSIFICATION_MAX_PER_CYCLE, batchSize = RECLASSIFICATION_BATCH_SIZE, entropyThreshold = RECLASSIFICATION_ENTROPY_THRESHOLD, affinityThreshold = RECLASSIFICATION_AFFINITY_THRESHOLD } = {}) => {
   const safeMaxItems = Math.max(0, Math.min(50_000, Number(maxItems) || RECLASSIFICATION_MAX_PER_CYCLE));
   const safeBatchSize = Math.max(1, Math.min(2000, Number(batchSize) || RECLASSIFICATION_BATCH_SIZE));
 
@@ -417,10 +383,7 @@ export const batchReprocess = async ({
         const currentAmbiguous = row?.ambiguous ? 1 : 0;
         const nextAmbiguous = output.ambiguous ? 1 : 0;
 
-        const shouldUpdate =
-          currentAmbiguous !== nextAmbiguous
-          || hasNumericDifference(currentAffinity, nextAffinity)
-          || !areListsEqual(currentSubtags, nextSubtags);
+        const shouldUpdate = currentAmbiguous !== nextAmbiguous || hasNumericDifference(currentAffinity, nextAffinity) || !areListsEqual(currentSubtags, nextSubtags);
 
         if (!shouldUpdate) {
           stats.skipped += 1;

package/app/modules/stickerPackModule/semanticReclassificationEngine.test.js

@@ -1,24 +1,11 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
 
-import {
-  applyDictionaryMapping,
-  calculateCohesion,
-  detectConflict,
-  detectDominantTheme,
-  normalizeTokens,
-  reclassify,
-} from './semanticReclassificationEngine.js';
+import { applyDictionaryMapping, calculateCohesion, detectConflict, detectDominantTheme, normalizeTokens, reclassify } from './semanticReclassificationEngine.js';
 
 test('normalizeTokens deve limpar termos genéricos, stopwords e duplicatas', () => {
   const tokens = normalizeTokens({
-    llm_subtags: [
-      'Cute Anime Girl Sticker',
-      'cute anime girl',
-      'image',
-      'co',
-      'random art',
-    ],
+    llm_subtags: ['Cute Anime Girl Sticker', 'cute anime girl', 'image', 'co', 'random art'],
     llm_style_traits: ['Kawaii style'],
     llm_emotions: ['happy face'],
     llm_pack_suggestions: ['social media picture'],

package/app/modules/stickerPackModule/semanticThemeClusterService.js

@@ -4,10 +4,7 @@ import OpenAI from 'openai';
 
 import { executeQuery, TABLES } from '../../../database/index.js';
 import logger from '../../utils/logger/loggerModule.js';
-import {
-  findStickerClassificationByAssetId,
-  updateStickerClassificationSemanticCluster,
-} from './stickerAssetClassificationRepository.js';
+import { findStickerClassificationByAssetId, updateStickerClassificationSemanticCluster } from './stickerAssetClassificationRepository.js';
 
 const parseEnvBool = (value, fallback) => {
   if (value === undefined || value === null || value === '') return fallback;
@@ -19,12 +16,9 @@ const parseEnvBool = (value, fallback) => {
 
 const ENABLE_SEMANTIC_CLUSTERING = parseEnvBool(process.env.ENABLE_SEMANTIC_CLUSTERING, false);
 const OPENAI_TIMEOUT_MS = Math.max(1_000, Number(process.env.SEMANTIC_CLUSTER_OPENAI_TIMEOUT_MS) || 10_000);
-const EMBEDDING_MODEL = String(process.env.SEMANTIC_CLUSTER_EMBEDDING_MODEL || 'text-embedding-3-small').trim()
-  || 'text-embedding-3-small';
+const EMBEDDING_MODEL = String(process.env.SEMANTIC_CLUSTER_EMBEDDING_MODEL || 'text-embedding-3-small').trim() || 'text-embedding-3-small';
 const SLUG_MODEL = String(process.env.SEMANTIC_CLUSTER_SLUG_MODEL || 'gpt-4o-mini').trim() || 'gpt-4o-mini';
-const SIMILARITY_THRESHOLD = Number.isFinite(Number(process.env.SEMANTIC_CLUSTER_SIMILARITY_THRESHOLD))
-  ? Math.max(0.5, Math.min(0.99, Number(process.env.SEMANTIC_CLUSTER_SIMILARITY_THRESHOLD)))
-  : 0.87;
+const SIMILARITY_THRESHOLD = Number.isFinite(Number(process.env.SEMANTIC_CLUSTER_SIMILARITY_THRESHOLD)) ? Math.max(0.5, Math.min(0.99, Number(process.env.SEMANTIC_CLUSTER_SIMILARITY_THRESHOLD))) : 0.87;
 const MAX_CLUSTER_SCAN = Math.max(100, Math.min(20_000, Number(process.env.SEMANTIC_CLUSTER_MAX_SCAN) || 5_000));
 const MAX_SUGGESTIONS_PER_ASSET = Math.max(1, Math.min(20, Number(process.env.SEMANTIC_CLUSTER_MAX_SUGGESTIONS_PER_ASSET) || 8));
 const CLUSTERING_CONCURRENCY = Math.max(1, Math.min(8, Number(process.env.SEMANTIC_CLUSTER_CONCURRENCY) || 2));
@@ -72,13 +66,13 @@ const fallbackSlugFromSuggestion = (suggestionText) => {
 };
 
 const hashSuggestion = (normalizedSuggestion) =>
-  createHash('sha256').update(String(normalizedSuggestion || ''), 'utf8').digest('hex');
+  createHash('sha256')
+    .update(String(normalizedSuggestion || ''), 'utf8')
+    .digest('hex');
 
 const serializeEmbedding = (embedding = []) => {
   const vector = Array.isArray(embedding) ? embedding : [];
-  const clean = vector
-    .map((value) => Number(value))
-    .filter((value) => Number.isFinite(value));
+  const clean = vector.map((value) => Number(value)).filter((value) => Number.isFinite(value));
   if (!clean.length) return { dim: 0, buffer: Buffer.alloc(0) };
   const buffer = Buffer.allocUnsafe(clean.length * 4);
   for (let index = 0; index < clean.length; index += 1) {
@@ -157,14 +151,7 @@ const getSuggestionCacheRow = async (normalizedSuggestion) => {
   };
 };
 
-const upsertSuggestionCacheRow = async ({
-  suggestionText,
-  normalizedText,
-  semanticClusterId,
-  canonicalSlug,
-  embedding = [],
-  similarity = null,
-}) => {
+const upsertSuggestionCacheRow = async ({ suggestionText, normalizedText, semanticClusterId, canonicalSlug, embedding = [], similarity = null }) => {
   const normalized = normalizeSuggestion(normalizedText || suggestionText);
   if (!normalized || !semanticClusterId) return false;
   const suggestionHash = hashSuggestion(normalized);
@@ -184,16 +171,7 @@ const upsertSuggestionCacheRow = async ({
       embedding = VALUES(embedding),
       last_similarity = VALUES(last_similarity),
       updated_at = CURRENT_TIMESTAMP`,
-    [
-      suggestionHash,
-      String(suggestionText || normalized).slice(0, 512),
-      normalized,
-      semanticClusterId,
-      canonicalSlug || null,
-      dim,
-      buffer,
-      similarity !== null && Number.isFinite(Number(similarity)) ? Number(Number(similarity).toFixed(6)) : null,
-    ],
+    [suggestionHash, String(suggestionText || normalized).slice(0, 512), normalized, semanticClusterId, canonicalSlug || null, dim, buffer, similarity !== null && Number.isFinite(Number(similarity)) ? Number(Number(similarity).toFixed(6)) : null],
   );
   return true;
 };
@@ -277,9 +255,7 @@ const generateEmbedding = async (text) => {
   });
   const vector = response?.data?.[0]?.embedding;
   if (!Array.isArray(vector) || !vector.length) return null;
-  const clean = vector
-    .map((value) => Number(value))
-    .filter((value) => Number.isFinite(value));
+  const clean = vector.map((value) => Number(value)).filter((value) => Number.isFinite(value));
   return clean.length ? clean : null;
 };
 
@@ -540,19 +516,16 @@ const drainSemanticClusterQueue = async () => {
   }
 };
 
-export const enqueueSemanticClusterResolution = ({
-  assetId,
-  suggestions = [],
-  fallbackText = '',
-  force = false,
-} = {}) => {
+export const enqueueSemanticClusterResolution = ({ assetId, suggestions = [], fallbackText = '', force = false } = {}) => {
   const normalizedAssetId = String(assetId || '').trim();
   if (!normalizedAssetId || !ENABLE_SEMANTIC_CLUSTERING) return false;
 
   pendingTasksByAssetId.set(normalizedAssetId, {
     assetId: normalizedAssetId,
     suggestions: sanitizeSuggestions(suggestions),
-    fallbackText: String(fallbackText || '').trim().slice(0, 255),
+    fallbackText: String(fallbackText || '')
+      .trim()
+      .slice(0, 255),
     force: Boolean(force),
   });
   scheduleQueueDrain();

package/app/modules/stickerPackModule/stickerAssetClassificationRepository.js

@@ -71,10 +71,7 @@ const normalizeClassificationRow = (row) => {
     llm_style_traits: Array.isArray(llmStyleTraits) ? llmStyleTraits : [],
     llm_emotions: Array.isArray(llmEmotions) ? llmEmotions : [],
     llm_pack_suggestions: Array.isArray(llmPackSuggestions) ? llmPackSuggestions : [],
-    semantic_cluster_id:
-      row.semantic_cluster_id !== null && row.semantic_cluster_id !== undefined
-        ? Number(row.semantic_cluster_id)
-        : null,
+    semantic_cluster_id: row.semantic_cluster_id !== null && row.semantic_cluster_id !== undefined ? Number(row.semantic_cluster_id) : null,
     semantic_cluster_slug: row.semantic_cluster_slug || null,
     classified_at: row.classified_at,
     updated_at: row.updated_at,
@@ -82,11 +79,7 @@ const normalizeClassificationRow = (row) => {
 };
 
 export async function findStickerClassificationByAssetId(assetId, connection = null) {
-  const rows = await executeQuery(
-    `SELECT * FROM ${TABLES.STICKER_ASSET_CLASSIFICATION} WHERE asset_id = ? LIMIT 1`,
-    [assetId],
-    connection,
-  );
+  const rows = await executeQuery(`SELECT * FROM ${TABLES.STICKER_ASSET_CLASSIFICATION} WHERE asset_id = ? LIMIT 1`, [assetId], connection);
 
   return normalizeClassificationRow(rows?.[0] || null);
 }
@@ -98,11 +91,7 @@ export async function listStickerClassificationsByAssetIds(assetIds, connection
   if (!uniqueIds.length) return [];
 
   const placeholders = uniqueIds.map(() => '?').join(', ');
-  const rows = await executeQuery(
-    `SELECT * FROM ${TABLES.STICKER_ASSET_CLASSIFICATION} WHERE asset_id IN (${placeholders})`,
-    uniqueIds,
-    connection,
-  );
+  const rows = await executeQuery(`SELECT * FROM ${TABLES.STICKER_ASSET_CLASSIFICATION} WHERE asset_id IN (${placeholders})`, uniqueIds, connection);
 
   const normalized = rows.map((row) => normalizeClassificationRow(row));
   const byAssetId = new Map(normalized.map((entry) => [entry.asset_id, entry]));
@@ -138,30 +127,7 @@ export async function upsertStickerAssetClassification(payload, connection = nul
       similar_images = VALUES(similar_images),
       classified_at = CURRENT_TIMESTAMP,
       updated_at = CURRENT_TIMESTAMP`,
-    [
-      payload.asset_id,
-      payload.provider || 'clip',
-      payload.model_name || null,
-      payload.classification_version || 'v1',
-      payload.category || null,
-      payload.confidence ?? null,
-      payload.entropy ?? null,
-      payload.confidence_margin ?? null,
-      payload.nsfw_score ?? null,
-      payload.is_nsfw ? 1 : 0,
-      payload.all_scores ? JSON.stringify(payload.all_scores) : JSON.stringify({}),
-      payload.top_labels ? JSON.stringify(payload.top_labels) : JSON.stringify([]),
-      payload.affinity_weight ?? null,
-      payload.image_hash || null,
-      payload.ambiguous ? 1 : 0,
-      payload.llm_subtags ? JSON.stringify(payload.llm_subtags) : JSON.stringify([]),
-      payload.llm_style_traits ? JSON.stringify(payload.llm_style_traits) : JSON.stringify([]),
-      payload.llm_emotions ? JSON.stringify(payload.llm_emotions) : JSON.stringify([]),
-      payload.llm_pack_suggestions ? JSON.stringify(payload.llm_pack_suggestions) : JSON.stringify([]),
-      payload.semantic_cluster_id ?? null,
-      payload.semantic_cluster_slug || null,
-      payload.similar_images ? JSON.stringify(payload.similar_images) : JSON.stringify([]),
-    ],
+    [payload.asset_id, payload.provider || 'clip', payload.model_name || null, payload.classification_version || 'v1', payload.category || null, payload.confidence ?? null, payload.entropy ?? null, payload.confidence_margin ?? null, payload.nsfw_score ?? null, payload.is_nsfw ? 1 : 0, payload.all_scores ? JSON.stringify(payload.all_scores) : JSON.stringify({}), payload.top_labels ? JSON.stringify(payload.top_labels) : JSON.stringify([]), payload.affinity_weight ?? null, payload.image_hash || null, payload.ambiguous ? 1 : 0, payload.llm_subtags ? JSON.stringify(payload.llm_subtags) : JSON.stringify([]), payload.llm_style_traits ? JSON.stringify(payload.llm_style_traits) : JSON.stringify([]), payload.llm_emotions ? JSON.stringify(payload.llm_emotions) : JSON.stringify([]), payload.llm_pack_suggestions ? JSON.stringify(payload.llm_pack_suggestions) : JSON.stringify([]), payload.semantic_cluster_id ?? null, payload.semantic_cluster_slug || null, payload.similar_images ? JSON.stringify(payload.similar_images) : JSON.stringify([])],
     connection,
   );
 
@@ -187,22 +153,14 @@ export async function upsertStickerAssetClassification(payload, connection = nul
   return findStickerClassificationByAssetId(payload.asset_id, connection);
 }
 
-export async function updateStickerClassificationSemanticCluster(
-  assetId,
-  { semanticClusterId = null, semanticClusterSlug = null } = {},
-  connection = null,
-) {
+export async function updateStickerClassificationSemanticCluster(assetId, { semanticClusterId = null, semanticClusterSlug = null } = {}, connection = null) {
   if (!assetId) return null;
 
   await executeQuery(
     `UPDATE ${TABLES.STICKER_ASSET_CLASSIFICATION}
      SET semantic_cluster_id = ?, semantic_cluster_slug = ?, updated_at = CURRENT_TIMESTAMP
      WHERE asset_id = ?`,
-    [
-      semanticClusterId ?? null,
-      semanticClusterSlug || null,
-      assetId,
-    ],
+    [semanticClusterId ?? null, semanticClusterSlug || null, assetId],
     connection,
   );
 
@@ -211,9 +169,15 @@ export async function updateStickerClassificationSemanticCluster(
 
 export async function listClipImageEmbeddingsByImageHashes(imageHashes, connection = null) {
   const uniqueHashes = Array.from(
-    new Set((Array.isArray(imageHashes) ? imageHashes : [])
-      .map((value) => String(value || '').trim().toLowerCase())
-      .filter((value) => value.length === 64)),
+    new Set(
+      (Array.isArray(imageHashes) ? imageHashes : [])
+        .map((value) =>
+          String(value || '')
+            .trim()
+            .toLowerCase(),
+        )
+        .filter((value) => value.length === 64),
+    ),
   );
   if (!uniqueHashes.length) return [];
 
@@ -249,10 +213,7 @@ const clampInt = (value, fallback, min, max) => {
   return Math.max(min, Math.min(max, Math.floor(numeric)));
 };
 
-export async function listAssetsForModelUpgradeReprocess(
-  { currentVersion, limit = 150, offset = 0 } = {},
-  connection = null,
-) {
+export async function listAssetsForModelUpgradeReprocess({ currentVersion, limit = 150, offset = 0 } = {}, connection = null) {
   const normalizedVersion = String(currentVersion || '').trim();
   if (!normalizedVersion) return [];
 
@@ -276,10 +237,7 @@ export async function listAssetsForModelUpgradeReprocess(
   return rows.map((row) => row.asset_id).filter(Boolean);
 }
 
-export async function listAssetsForLowConfidenceReprocess(
-  { confidenceThreshold = 0.65, staleHours = 48, limit = 150, offset = 0 } = {},
-  connection = null,
-) {
+export async function listAssetsForLowConfidenceReprocess({ confidenceThreshold = 0.65, staleHours = 48, limit = 150, offset = 0 } = {}, connection = null) {
   const threshold = Number(confidenceThreshold);
   if (!Number.isFinite(threshold)) return [];
 
@@ -307,10 +265,7 @@ export async function listAssetsForLowConfidenceReprocess(
   return rows.map((row) => row.asset_id).filter(Boolean);
 }
 
-export async function listAssetsForPrioritySignalBackfillReprocess(
-  { limit = 200, offset = 0 } = {},
-  connection = null,
-) {
+export async function listAssetsForPrioritySignalBackfillReprocess({ limit = 200, offset = 0 } = {}, connection = null) {
   const safeLimit = clampInt(limit, 200, 1, 2000);
   const safeOffset = clampInt(offset, 0, 0, 500000);
   const rows = await executeQuery(
@@ -358,23 +313,11 @@ export async function listAssetsForPrioritySignalBackfillReprocess(
   return rows.map((row) => row.asset_id).filter(Boolean);
 }
 
-export async function listStickerClassificationsForDeterministicReprocess(
-  {
-    limit = 250,
-    cursorAssetId = '',
-    entropyThreshold = 0.8,
-    affinityThreshold = 0.3,
-  } = {},
-  connection = null,
-) {
+export async function listStickerClassificationsForDeterministicReprocess({ limit = 250, cursorAssetId = '', entropyThreshold = 0.8, affinityThreshold = 0.3 } = {}, connection = null) {
   const safeLimit = clampInt(limit, 250, 1, 2000);
   const normalizedCursor = String(cursorAssetId || '').trim();
-  const normalizedEntropyThreshold = Number.isFinite(Number(entropyThreshold))
-    ? Number(entropyThreshold)
-    : 0.8;
-  const normalizedAffinityThreshold = Number.isFinite(Number(affinityThreshold))
-    ? Number(affinityThreshold)
-    : 0.3;
+  const normalizedEntropyThreshold = Number.isFinite(Number(entropyThreshold)) ? Number(entropyThreshold) : 0.8;
+  const normalizedAffinityThreshold = Number.isFinite(Number(affinityThreshold)) ? Number(affinityThreshold) : 0.3;
 
   const params = [normalizedEntropyThreshold, normalizedAffinityThreshold];
   const cursorClause = normalizedCursor ? 'AND c.asset_id > ?' : '';
@@ -409,30 +352,17 @@ export async function listStickerClassificationsForDeterministicReprocess(
   return rows.map((row) => normalizeClassificationRow(row));
 }
 
-export async function updateStickerClassificationDeterministicSignals(
-  assetId,
-  { llmSubtags = [], affinityWeight = null, ambiguous = 0 } = {},
-  connection = null,
-) {
+export async function updateStickerClassificationDeterministicSignals(assetId, { llmSubtags = [], affinityWeight = null, ambiguous = 0 } = {}, connection = null) {
   if (!assetId) return null;
-  const normalizedAffinityWeight = Number.isFinite(Number(affinityWeight))
-    ? Math.max(0, Math.min(1, Number(affinityWeight)))
-    : null;
+  const normalizedAffinityWeight = Number.isFinite(Number(affinityWeight)) ? Math.max(0, Math.min(1, Number(affinityWeight))) : null;
   const normalizedAmbiguous = ambiguous === 1 || ambiguous === true ? 1 : 0;
-  const normalizedSubtags = Array.isArray(llmSubtags)
-    ? llmSubtags.map((value) => String(value || '').trim()).filter(Boolean)
-    : [];
+  const normalizedSubtags = Array.isArray(llmSubtags) ? llmSubtags.map((value) => String(value || '').trim()).filter(Boolean) : [];
 
   await executeQuery(
     `UPDATE ${TABLES.STICKER_ASSET_CLASSIFICATION}
      SET llm_subtags = ?, affinity_weight = ?, ambiguous = ?, updated_at = CURRENT_TIMESTAMP
      WHERE asset_id = ?`,
-    [
-      JSON.stringify(normalizedSubtags),
-      normalizedAffinityWeight,
-      normalizedAmbiguous,
-      assetId,
-    ],
+    [JSON.stringify(normalizedSubtags), normalizedAffinityWeight, normalizedAmbiguous, assetId],
     connection,
   );
 

package/app/modules/stickerPackModule/stickerAssetRepository.js

@@ -41,11 +41,7 @@ const normalizeStickerAssetRow = (row) => {
  * @returns {Promise<object|null>} Asset encontrado.
  */
 export async function findStickerAssetBySha256(sha256, connection = null) {
-  const rows = await executeQuery(
-    `SELECT * FROM ${TABLES.STICKER_ASSET} WHERE sha256 = ? LIMIT 1`,
-    [sha256],
-    connection,
-  );
+  const rows = await executeQuery(`SELECT * FROM ${TABLES.STICKER_ASSET} WHERE sha256 = ? LIMIT 1`, [sha256], connection);
   return normalizeStickerAssetRow(rows?.[0] || null);
 }
 
@@ -74,11 +70,7 @@ export async function findStickerAssetsByIds(ids, connection = null) {
   if (!uniqueIds.length) return [];
 
   const placeholders = uniqueIds.map(() => '?').join(', ');
-  const rows = await executeQuery(
-    `SELECT * FROM ${TABLES.STICKER_ASSET} WHERE id IN (${placeholders})`,
-    uniqueIds,
-    connection,
-  );
+  const rows = await executeQuery(`SELECT * FROM ${TABLES.STICKER_ASSET} WHERE id IN (${placeholders})`, uniqueIds, connection);
 
   const normalized = rows.map((row) => normalizeStickerAssetRow(row));
   const byId = new Map(normalized.map((row) => [row.id, row]));
@@ -143,7 +135,10 @@ export async function listStickerAssetsWithoutPack({ search = '', limit = 120, o
   const safeLimit = Math.max(1, Math.min(500, Number(limit) || 120));
   const safeOffset = Math.max(0, Number(offset) || 0);
   const safeLimitWithSentinel = safeLimit + 1;
-  const normalizedSearch = String(search || '').trim().toLowerCase().slice(0, 140);
+  const normalizedSearch = String(search || '')
+    .trim()
+    .toLowerCase()
+    .slice(0, 140);
 
   const whereClauses = ['i.sticker_id IS NULL'];
   const params = [];
@@ -198,7 +193,10 @@ export async function listClassifiedStickerAssetsWithoutPack({ search = '', limi
   const safeLimit = Math.max(1, Math.min(500, Number(limit) || 120));
   const safeOffset = Math.max(0, Number(offset) || 0);
   const safeLimitWithSentinel = safeLimit + 1;
-  const normalizedSearch = String(search || '').trim().toLowerCase().slice(0, 140);
+  const normalizedSearch = String(search || '')
+    .trim()
+    .toLowerCase()
+    .slice(0, 140);
 
   const whereClauses = ['i.sticker_id IS NULL'];
   const params = [];
@@ -274,14 +272,7 @@ export async function countClassifiedStickerAssetsWithoutPack(connection = null)
  * }} [options]
  * @returns {Promise<{ assets: object[], hasMore: boolean, total: number }>}
  */
-export async function listClassifiedStickerAssetsForCuration({
-  limit = 200,
-  offset = 0,
-  includePacked = true,
-  includeUnpacked = true,
-  onlyVersionMismatch = null,
-  connection = null,
-} = {}) {
+export async function listClassifiedStickerAssetsForCuration({ limit = 200, offset = 0, includePacked = true, includeUnpacked = true, onlyVersionMismatch = null, connection = null } = {}) {
   const safeLimit = Math.max(1, Math.min(1000, Number(limit) || 200));
   const safeOffset = Math.max(0, Number(offset) || 0);
   const safeLimitWithSentinel = safeLimit + 1;
@@ -346,17 +337,7 @@ export async function createStickerAsset(asset, connection = null) {
     `INSERT INTO ${TABLES.STICKER_ASSET}
       (id, owner_jid, sha256, mimetype, is_animated, width, height, size_bytes, storage_path)
      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [
-      asset.id,
-      asset.owner_jid,
-      asset.sha256,
-      asset.mimetype,
-      asset.is_animated ? 1 : 0,
-      asset.width ?? null,
-      asset.height ?? null,
-      asset.size_bytes,
-      asset.storage_path,
-    ],
+    [asset.id, asset.owner_jid, asset.sha256, asset.mimetype, asset.is_animated ? 1 : 0, asset.width ?? null, asset.height ?? null, asset.size_bytes, asset.storage_path],
     connection,
   );
 

package/app/modules/stickerPackModule/stickerAssetReprocessQueueRepository.js

@@ -3,13 +3,17 @@ import { randomUUID } from 'node:crypto';
 import { executeQuery, TABLES } from '../../../database/index.js';
 
 const normalizeReason = (value) => {
-  const normalized = String(value || '').trim().toUpperCase();
+  const normalized = String(value || '')
+    .trim()
+    .toUpperCase();
   if (['MODEL_UPGRADE', 'LOW_CONFIDENCE', 'TREND_SHIFT', 'NSFW_REVIEW'].includes(normalized)) return normalized;
   return null;
 };
 
 const normalizeStatus = (value) => {
-  const normalized = String(value || '').trim().toLowerCase();
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
   if (['pending', 'processing', 'completed', 'failed'].includes(normalized)) return normalized;
   return null;
 };
@@ -40,10 +44,7 @@ const normalizeRow = (row) => {
   };
 };
 
-export async function enqueueStickerAssetReprocess(
-  { assetId, reason, priority = 50, scheduledAt = null, maxAttempts = 5 },
-  connection = null,
-) {
+export async function enqueueStickerAssetReprocess({ assetId, reason, priority = 50, scheduledAt = null, maxAttempts = 5 }, connection = null) {
   const normalizedReason = normalizeReason(reason);
   if (!assetId || !normalizedReason) return false;
 
@@ -80,9 +81,7 @@ export async function claimStickerAssetReprocessTask({ reasons = [], allowRetryF
   const normalizedReasons = Array.from(new Set((Array.isArray(reasons) ? reasons : []).map(normalizeReason).filter(Boolean)));
   const reasonFilter = normalizedReasons.length ? `AND reason IN (${normalizedReasons.map(() => '?').join(', ')})` : '';
 
-  const statusClause = allowRetryFailed
-    ? "(status = 'pending' OR (status = 'failed' AND attempts < max_attempts))"
-    : "status = 'pending'";
+  const statusClause = allowRetryFailed ? "(status = 'pending' OR (status = 'failed' AND attempts < max_attempts))" : "status = 'pending'";
 
   await executeQuery(
     `UPDATE ${TABLES.STICKER_ASSET_REPROCESS_QUEUE}
@@ -137,17 +136,13 @@ export async function completeStickerAssetReprocessTask(taskId, connection = nul
   return true;
 }
 
-export async function failStickerAssetReprocessTask(
-  taskId,
-  {
-    error = null,
-    retryDelaySeconds = 0,
-  } = {},
-  connection = null,
-) {
+export async function failStickerAssetReprocessTask(taskId, { error = null, retryDelaySeconds = 0 } = {}, connection = null) {
   if (!taskId) return false;
   const safeDelay = clampInt(retryDelaySeconds, 0, 0, 86400 * 7);
-  const message = String(error || '').trim().slice(0, 255) || null;
+  const message =
+    String(error || '')
+      .trim()
+      .slice(0, 255) || null;
 
   await executeQuery(
     `UPDATE ${TABLES.STICKER_ASSET_REPROCESS_QUEUE}