Add fuzzy matching for models import (#367)

Adds fuzzy search functionality to the models import feature, allowing
users to find and filter models more easily by partial name matches. The
hook layer now supports fuzzy matching while maintaining the existing
import workflow, and the UI has been updated to leverage this new
capability. Also includes minor schema refactoring for meter snapshots
and formatting improvements to the release script.

Author: mcowger

packages/backend/drizzle/schema/postgres/meter-snapshots.ts

@@ -1,13 +1,4 @@
-import {
-  pgTable,
-  serial,
-  text,
-  real,
-  integer,
-  bigint,
-  boolean,
-  index,
-} from 'drizzle-orm/pg-core';
+import { pgTable, serial, text, real, integer, bigint, boolean, index } from 'drizzle-orm/pg-core';
 
 export const meterSnapshots = pgTable(
   'meter_snapshots',

packages/frontend/src/hooks/useModels.ts

@@ -4,7 +4,10 @@ import { useToast } from '../contexts/ToastContext';
 
 export interface OrphanGroup {
   modelId: string;
+  /** The alias this group will merge into or create. When set, imports add targets to this alias. */
   existingAlias?: Alias;
+  /** Human-readable reason when an existing alias was matched via fuzzy logic (e.g. "case-insensitive match" or "suffix match"). */
+  matchReason?: string;
   candidates: Array<{ provider: Provider; model: Model }>;
 }
 
@@ -187,6 +190,51 @@ export const useModels = () => {
 
   const filteredAliases = aliases.filter((a) => a.id.toLowerCase().includes(search.toLowerCase()));
 
+  /**
+   * Find an existing alias that matches a given model ID using fuzzy rules:
+   * 1. Exact case-insensitive match (e.g. "MiniMax-M2.7" → alias "minimax-m2.7")
+   * 2. Suffix match: the model ID after stripping a "provider/" prefix matches
+   *    an alias (e.g. "sonar-pro" → alias "perplexity/sonar-pro"), or vice versa
+   *    (e.g. "perplexity/sonar-pro" → alias "sonar-pro").
+   */
+  const findExistingAlias = useCallback(
+    (modelId: string, aliasList: Alias[]): { alias: Alias; reason?: string } | undefined => {
+      const lowerModel = modelId.toLowerCase();
+
+      // 1. Case-insensitive exact match
+      const ciMatch = aliasList.find((a) => a.id.toLowerCase() === lowerModel);
+      if (ciMatch && ciMatch.id !== modelId) {
+        return { alias: ciMatch, reason: `case-insensitive match: ${ciMatch.id}` };
+      }
+      if (ciMatch) {
+        return { alias: ciMatch };
+      }
+
+      // 2. Suffix match — strip provider-style prefix from either side
+      const modelSuffix = modelId.includes('/')
+        ? modelId.substring(modelId.lastIndexOf('/') + 1)
+        : modelId;
+      const modelSuffixLower = modelSuffix.toLowerCase();
+
+      for (const alias of aliasList) {
+        const aliasSuffix = alias.id.includes('/')
+          ? alias.id.substring(alias.id.lastIndexOf('/') + 1)
+          : alias.id;
+        const aliasSuffixLower = aliasSuffix.toLowerCase();
+
+        if (aliasSuffixLower === modelSuffixLower && alias.id !== modelId) {
+          return {
+            alias,
+            reason: `suffix match: ${alias.id}`,
+          };
+        }
+      }
+
+      return undefined;
+    },
+    []
+  );
+
   const handleOpenImport = useCallback(() => {
     // Build set of covered (provider, model) pairs from all alias targets
     const covered = new Set<string>();
@@ -196,25 +244,38 @@ export const useModels = () => {
       });
     });
 
-    // Find orphaned models and group by model.id
+    // Find orphaned models and group by lowercased model.id for case-insensitive grouping
     const orphanMap = new Map<string, Array<{ provider: Provider; model: Model }>>();
+    const canonicalIds = new Map<string, string>(); // lowercase → first-seen original casing
     availableModels.forEach((model) => {
       const key = `${model.providerId}|${model.id}`;
       if (covered.has(key)) return;
 
-      if (!orphanMap.has(model.id)) {
-        orphanMap.set(model.id, []);
+      // Group case-insensitively: use lowercase key but preserve first-seen casing
+      const groupKey = model.id.toLowerCase();
+      if (!canonicalIds.has(groupKey)) {
+        canonicalIds.set(groupKey, model.id);
+      }
+
+      if (!orphanMap.has(groupKey)) {
+        orphanMap.set(groupKey, []);
       }
       const provider = providers.find((p) => p.id === model.providerId);
       if (provider) {
-        orphanMap.get(model.id)!.push({ provider, model });
+        orphanMap.get(groupKey)!.push({ provider, model });
       }
     });
 
     const groups: OrphanGroup[] = [];
-    orphanMap.forEach((candidates, modelId) => {
-      const existingAlias = aliases.find((a) => a.id === modelId);
-      groups.push({ modelId, existingAlias, candidates });
+    orphanMap.forEach((candidates, groupKey) => {
+      const modelId = canonicalIds.get(groupKey) || groupKey;
+      const match = findExistingAlias(modelId, aliases);
+      groups.push({
+        modelId,
+        existingAlias: match?.alias,
+        matchReason: match?.reason,
+        candidates,
+      });
     });
     groups.sort((a, b) => a.modelId.localeCompare(b.modelId));
 
@@ -227,7 +288,7 @@ export const useModels = () => {
     setOrphanGroups(groups);
     setSelectedImports(selections);
     setIsImportModalOpen(true);
-  }, [aliases, availableModels, providers]);
+  }, [aliases, availableModels, providers, findExistingAlias]);
 
   const handleSaveImports = useCallback(async () => {
     setIsImporting(true);

packages/frontend/src/pages/Models.tsx

@@ -2555,9 +2555,16 @@ export const Models = () => {
                           <td className="px-4 py-3 text-left text-text">
                             <div className="font-medium">{group.modelId}</div>
                             {group.existingAlias ? (
-                              <span className="inline-flex rounded border border-border-glass px-2 py-0.5 text-[10px] font-medium uppercase tracking-wider text-primary">
-                                Existing Alias
-                              </span>
+                              <>
+                                <span className="inline-flex rounded border border-border-glass px-2 py-0.5 text-[10px] font-medium uppercase tracking-wider text-primary">
+                                  Existing Alias
+                                </span>
+                                {group.matchReason && (
+                                  <div className="text-[11px] text-text-muted mt-0.5">
+                                    {group.matchReason}
+                                  </div>
+                                )}
+                              </>
                             ) : (
                               <span className="inline-flex rounded border border-border-glass px-2 py-0.5 text-[10px] font-medium uppercase tracking-wider text-text-muted">
                                 New Alias
@@ -2588,7 +2595,14 @@ export const Models = () => {
                                         setSelectedImports(next);
                                       }}
                                     />
-                                    <span className="text-text text-[13px]">{c.provider.name}</span>
+                                    <span className="text-text text-[13px]">
+                                      {c.provider.name}
+                                      {c.model.id !== group.modelId && (
+                                        <span className="text-text-muted ml-1 text-[11px]">
+                                          ({c.model.id})
+                                        </span>
+                                      )}
+                                    </span>
                                   </label>
                                 );
                               })}

scripts/release.ts

@@ -223,10 +223,9 @@ async function followReleaseWorkflow(owner: string, repo: string, version: strin
   execSync(`gh run view ${runId} --repo ${owner}/${repo} --log`, { stdio: 'inherit' });
 
   // Get the final status
-  const result = execSync(
-    `gh run view ${runId} --repo ${owner}/${repo} --json status,conclusion`,
-    { encoding: 'utf-8' }
-  );
+  const result = execSync(`gh run view ${runId} --repo ${owner}/${repo} --json status,conclusion`, {
+    encoding: 'utf-8',
+  });
   const runInfo = JSON.parse(result);
 
   if (runInfo.conclusion === 'success') {
@@ -243,9 +242,13 @@ function sleep(ms: number): Promise<void> {
 
 async function watchWorkflowRun(owner: string, repo: string, runId: string): Promise<void> {
   return new Promise((resolve) => {
-    const child = spawn('gh', ['run', 'watch', runId, '--repo', `${owner}/${repo}`, '--exit-status'], {
-      stdio: 'inherit',
-    });
+    const child = spawn(
+      'gh',
+      ['run', 'watch', runId, '--repo', `${owner}/${repo}`, '--exit-status'],
+      {
+        stdio: 'inherit',
+      }
+    );
 
     child.on('close', (code) => {
       resolve();