@supericons/mcp 0.4.10 → 0.4.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.11 - 2026-06-28
+
+### Fixed
+
+- improved `recommend_icons` for Supericons (`si`) brand and logo slots so exact AI tool logos such as OpenAI Codex, Lovable, Kickbacks.ai, and xAI rank correctly
+
 ## 0.4.10 - 2026-06-27
 
 ### Added

package/generated/motion-lab-baseline.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generated_at": "2026-06-27T17:17:55.388Z",
+  "generated_at": "2026-06-28T08:12:34.465Z",
   "presets": [
     {
       "preset": "bounce",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supericons/mcp",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "mcpName": "io.github.curlymolelabs/supericons",
   "description": "MCP server for Supericons: multilingual semantic SVG icon search and recommendations for AI coding agents.",
   "type": "module",

package/public/product-facts.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-06-27T16:34:16.739Z",
-  "freeIconCount": 21367,
+  "generatedAt": "2026-06-28T06:24:29.474Z",
+  "freeIconCount": 21371,
   "freeLibraryCount": 11,
   "premiumCollectionCount": 8,
   "premiumIconCount": 400,

package/recommend-icons.js

@@ -29,9 +29,9 @@ const multilingualExpansionTerms = [...cjkSearchTerms, ...multilingualSearchAlia
 const SLOT_SEARCH_CONCURRENCY = 2;
 const SLOT_QUERY_CONCURRENCY = 1;
 
-const GENERIC_SLOT_WORDS = new Set([
-  'action',
-  'button',
+const GENERIC_SLOT_WORDS = new Set([
+  'action',
+  'button',
   'buttons',
   'control',
   'controls',
@@ -45,10 +45,33 @@ const GENERIC_SLOT_WORDS = new Set([
   'tab',
   'tabs',
   'ui',
-  'view',
-]);
-
-const VARIANT_PENALTIES = Object.freeze([
+  'view',
+]);
+
+const BRAND_LOGO_WORDS = new Set([
+  'brand',
+  'brands',
+  'logo',
+  'logos',
+  'mark',
+  'wordmark',
+]);
+
+const BRAND_LOGO_GENERIC_WORDS = new Set([
+  ...GENERIC_SLOT_WORDS,
+  ...BRAND_LOGO_WORDS,
+  'app',
+  'application',
+  'company',
+  'hero',
+  'page',
+  'product',
+  'site',
+  'title',
+  'website',
+]);
+
+const VARIANT_PENALTIES = Object.freeze([
   { token: 'circle', pattern: /circle/i, penalty: 12 },
   { token: 'square', pattern: /square/i, penalty: 12 },
   { token: 'dash', pattern: /dash/i, penalty: 5 },
@@ -966,20 +989,55 @@ function normalizeToken(token) {
   return value;
 }
 
-function tokenizeText(value) {
-  const normalized = normalizeText(value);
-  if (!normalized) return [];
-  const tokens = normalized.split(' ');
-  return dedupe([...tokens, ...tokens.map(normalizeToken)]);
-}
-
-function dedupe(values) {
-  return [...new Set(values.filter(Boolean))];
-}
-
-function buildDirectLocalizedIntentTerms(value) {
-  const text = String(value || '');
-  return DIRECT_LOCALIZED_INTENT_RULES
+function tokenizeText(value) {
+  const normalized = normalizeText(value);
+  if (!normalized) return [];
+  const tokens = normalized.split(' ');
+  return dedupe([...tokens, ...tokens.map(normalizeToken)]);
+}
+
+function dedupe(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+
+function stripBrandLogoWords(value) {
+  return tokenizeText(value)
+    .filter((token) => !BRAND_LOGO_WORDS.has(token))
+    .join(' ');
+}
+
+function hasSpecificBrandTerms(value) {
+  return tokenizeText(stripBrandLogoWords(value))
+    .some((token) => !BRAND_LOGO_GENERIC_WORDS.has(token));
+}
+
+function isBrandLogoRecommendation(task, slot, library) {
+  if (library === 'si') return true;
+  const text = normalizeText(`${slot} ${task}`);
+  const namesLogoOrBrand = /\b(logos?|brands?|wordmark|mark)\b/.test(text);
+  return namesLogoOrBrand && hasSpecificBrandTerms(slot);
+}
+
+function buildBrandLogoQueryVariants(task, slot, library) {
+  if (!isBrandLogoRecommendation(task, slot, library)) return [];
+
+  const rawSlot = String(slot || '').trim();
+  const normalizedSlot = normalizeText(slot);
+  const strippedSlot = stripBrandLogoWords(slot);
+  const usefulTokens = tokenizeText(strippedSlot)
+    .filter((token) => !BRAND_LOGO_GENERIC_WORDS.has(token));
+
+  return dedupe([
+    rawSlot,
+    normalizedSlot,
+    strippedSlot,
+    ...usefulTokens,
+  ]);
+}
+
+function buildDirectLocalizedIntentTerms(value) {
+  const text = String(value || '');
+  return DIRECT_LOCALIZED_INTENT_RULES
     .filter((rule) => rule.pattern.test(text))
     .flatMap((rule) => rule.terms);
 }
@@ -1108,7 +1166,7 @@ function buildSlotQueryVariants(task, slot, locale = null) {
   return dedupe(variants).slice(0, 12);
 }
 
-function scoreLexicalFit(icon, intentTerms, slotLabel, taskLabel = '') {
+function scoreLexicalFit(icon, intentTerms, slotLabel, taskLabel = '') {
   const tokens = new Set([
     ...tokenizeText(icon.id),
     ...tokenizeText(icon.name),
@@ -1147,10 +1205,77 @@ function scoreLexicalFit(icon, intentTerms, slotLabel, taskLabel = '') {
     score += 26;
   }
 
-  return score;
-}
-
-function getVariantPenalty(icon, intentTerms = []) {
+  return score;
+}
+
+function collectBrandCandidateTexts(icon, semanticRecord) {
+  const semanticValues = semanticRecord ? [
+    semanticRecord.label,
+    semanticRecord.source_name,
+    semanticRecord.slug,
+    semanticRecord.name,
+    semanticRecord.meaning,
+    semanticRecord.purpose,
+    ...(semanticRecord.aliases || []),
+    ...(semanticRecord.synonyms || []),
+    ...(semanticRecord.search_terms || []),
+    ...(semanticRecord.semantic_tags || []),
+  ] : [];
+
+  return dedupe([
+    icon.id,
+    icon.name,
+    `${icon.lib}:${icon.id}`,
+    ...(icon.aliases || []),
+    ...(icon.synonyms || []),
+    ...(icon.searchTerms || []),
+    ...(icon.semanticTags || []),
+    ...(icon.semantic?.aliases || []),
+    ...(icon.semantic?.synonyms || []),
+    ...(icon.semantic?.search_terms || []),
+    ...(icon.semantic?.semantic_tags || []),
+    ...semanticValues,
+  ].map((value) => normalizeText(value)).filter(Boolean));
+}
+
+function getBrandLogoMatchBonus(icon, semanticRecord, slotLabel, taskLabel, library) {
+  if (!isBrandLogoRecommendation(taskLabel, slotLabel, library)) return 0;
+
+  const slotCandidates = buildBrandLogoQueryVariants(taskLabel, slotLabel, library)
+    .map((value) => normalizeText(value))
+    .filter((value) => value.length >= 2);
+  const iconCandidates = collectBrandCandidateTexts(icon, semanticRecord);
+  const iconTokens = new Set(iconCandidates.flatMap(tokenizeText));
+  const meaningfulSlotTokens = dedupe(
+    slotCandidates
+      .flatMap(tokenizeText)
+      .filter((token) => !BRAND_LOGO_GENERIC_WORDS.has(token))
+  );
+
+  let best = 0;
+  for (const slotCandidate of slotCandidates) {
+    for (const iconCandidate of iconCandidates) {
+      if (slotCandidate === iconCandidate) {
+        best = Math.max(best, 360);
+      } else if (slotCandidate.length >= 3 && iconCandidate.includes(slotCandidate)) {
+        best = Math.max(best, 260);
+      } else if (iconCandidate.length >= 3 && slotCandidate.includes(iconCandidate)) {
+        best = Math.max(best, 180);
+      }
+    }
+  }
+
+  const overlapCount = meaningfulSlotTokens.filter((token) => iconTokens.has(token)).length;
+  if (meaningfulSlotTokens.length > 0 && overlapCount === meaningfulSlotTokens.length) {
+    best = Math.max(best, 220 + overlapCount * 20);
+  } else {
+    best = Math.max(best, overlapCount * 30);
+  }
+
+  return best;
+}
+
+function getVariantPenalty(icon, intentTerms = []) {
   const normalizedId = normalizeText(icon.id);
   const requestedTerms = buildRequestedTermSet(intentTerms);
   let penalty = 0;
@@ -1327,7 +1452,10 @@ export async function recommendIconsForTask({
       ...buildLocalizedVariants(slotLabel, locale).flatMap(tokenizeText),
       ...buildDirectLocalizedIntentTerms(slotLabel),
     ]);
-    const queryVariants = buildSlotQueryVariants(task, slotLabel, locale).slice(0, locale ? 8 : 4);
+    const queryVariants = dedupe([
+      ...buildBrandLogoQueryVariants(task, slotLabel, library),
+      ...buildSlotQueryVariants(task, slotLabel, locale),
+    ]).slice(0, locale ? 8 : 4);
     const pooledIcons = [];
     const seen = new Set();
 
@@ -1358,9 +1486,10 @@ export async function recommendIconsForTask({
       .map((icon, index) => {
         const semanticRecord = getSemanticRecordForIcon(semanticMap, icon);
         const semanticQuery = queryVariants.join(' ');
-        const semanticScore = semanticRecord ? scoreSemanticAlignment(semanticQuery, semanticRecord) * 3 : 0;
-        const lexicalScore = scoreLexicalFit(icon, intentTerms, slotLabel, task);
-        const semanticBonus = semanticRecord ? 6 : 0;
+        const semanticScore = semanticRecord ? scoreSemanticAlignment(semanticQuery, semanticRecord) * 3 : 0;
+        const lexicalScore = scoreLexicalFit(icon, intentTerms, slotLabel, task);
+        const brandLogoMatchBonus = getBrandLogoMatchBonus(icon, semanticRecord, slotLabel, task, library);
+        const semanticBonus = semanticRecord ? 6 : 0;
         const variantPenalty = getVariantPenalty(icon, requestedVariantTerms);
         const brandPenalty = getBrandPenalty(icon, requestedVariantTerms);
         const slotPreferenceBonus = getSlotPreferenceBonus(icon, slotLabel, intentTerms, library, requestedVariantTerms);
@@ -1375,9 +1504,10 @@ export async function recommendIconsForTask({
           brandPenalty,
           slotPreferenceBonus,
           totalScore:
-            semanticScore +
-            lexicalScore +
-            semanticBonus +
+            semanticScore +
+            lexicalScore +
+            brandLogoMatchBonus +
+            semanticBonus +
             slotPreferenceBonus +
             intentAdjustment.boost -
             intentAdjustment.penalty -

package/runtime/supericons-ai-taxonomy.js

@@ -317,8 +317,8 @@ export const SUPERICONS_AI_ICON_TAXONOMY = Object.freeze({
   ),
   'si:x-ai': taxonomy(
     'model-platforms-ai-labs',
-    ['foundation-model', 'grok', 'ai-lab'],
-    ['model-provider', 'llm', 'xai']
+    ['foundation-model', 'grok', 'grok-imagine', 'ai-lab'],
+    ['model-provider', 'llm', 'image-generation', 'video-generation', 'xai']
   ),
   'si:xiaomi-mimo': taxonomy(
     'model-platforms-ai-labs',

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/curlymolelabs/supericons",
     "source": "github"
   },
-  "version": "0.4.10",
+  "version": "0.4.11",
   "remotes": [
     {
       "type": "streamable-http",
@@ -18,7 +18,7 @@
     {
       "registryType": "npm",
       "identifier": "@supericons/mcp",
-      "version": "0.4.10",
+      "version": "0.4.11",
       "transport": {
         "type": "stdio"
       }