@canonry/canonry 5.33.0 → 6.0.0

package/dist/{chunk-GIKWL2BQ.js → chunk-ZO62Z2WN.js}

@@ -291,6 +291,7 @@ import {
   compareSemver,
   competitorBatchRequestSchema,
   competitorDtoSchema,
+  competitorLabelFromDomain,
   competitorLandscapeQuerySchema,
   competitorLandscapeResponseSchema,
   compileBrandAliases,
@@ -720,6 +721,7 @@ import {
   resolveMeasurementRunQueryScope,
   resolveMeasurementRunScope,
   resolveNegativeReviewMaxStars,
+  resolveProjectQualifiedAliases,
   resolveProviderModel,
   resolveRunDispatchModes,
   resolveSnapshotRequestQueries,
@@ -774,6 +776,7 @@ import {
   shareOfVoiceReason,
   shareOfVoiceSummary,
   shiftIsoCalendarDate,
+  simpleMeasurementCompetitorNames,
   simpleMeasurementDefinitionSchema,
   siteAuditLivePageHealthSchema,
   siteAuditPageFactorSchema,
@@ -866,7 +869,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-SJX7XJB6.js";
+} from "./chunk-HAALQW4R.js";
 
 // src/intelligence-service.ts
 import { eq as eq82, desc as desc36, asc as asc15, and as and69, ne as ne14, or as or20, inArray as inArray32, gte as gte22, lte as lte20, isNull as isNull16, sql as sql31, exists } from "drizzle-orm";
@@ -1017,6 +1020,12 @@ var projects = sqliteTable("projects", {
   canonicalDomain: text("canonical_domain").notNull(),
   ownedDomains: text("owned_domains", { mode: "json" }).$type().notNull().default([]),
   aliases: text("aliases", { mode: "json" }).$type().notNull().default([]),
+  /**
+   * Operator-chosen subset of `aliases` that Simple sentiment tells the
+   * evaluator are this brand's own names. Frozen into each Simple run's
+   * sidecar at dispatch; never read by mention detection or query classes.
+   */
+  qualifiedAliases: text("qualified_aliases", { mode: "json" }).$type().notNull().default([]),
   country: text("country").notNull(),
   language: text("language").notNull(),
   tags: text("tags", { mode: "json" }).$type().notNull().default([]),
@@ -8172,6 +8181,16 @@ var MIGRATION_VERSIONS = [
     name: "aero-ledger-conversation-ids",
     statements: [],
     run: dropAeroLedgerConversationKeys
+  },
+  {
+    // Sentiment-only project setting: the aliases the evaluator is told are
+    // the brand's own names. Defaulted, so an older writer that omits it and
+    // every existing project read as not opted in.
+    version: 166,
+    name: "projects-qualified-aliases",
+    statements: [
+      `ALTER TABLE projects ADD COLUMN qualified_aliases TEXT NOT NULL DEFAULT '[]'`
+    ]
   }
 ];
 var AERO_LEDGER_REBUILDS = [
@@ -11275,7 +11294,7 @@ function gapTone(gapCount, totalCount) {
 
 // ../intelligence/src/visibility-score.ts
 function buildVisibilityScore(snapshots, options) {
-  const tooltip = "An LLM used a page on your domain as a source for its answer.";
+  const tooltip = "An AI engine used a page on your domain as a source for its answer.";
   if (snapshots.length === 0) {
     return {
       label: "Citation Coverage",
@@ -11307,13 +11326,13 @@ function buildVisibilityScore(snapshots, options) {
     tooltip,
     trend: [],
     progress: score,
-    providerCoverage: isPartialProviderRun ? `${runApiProviderCount} of ${options.configuredApiProviders.length} providers` : void 0
+    providerCoverage: isPartialProviderRun ? `${runApiProviderCount} of ${options.configuredApiProviders.length} engines` : void 0
   };
 }
 
 // ../intelligence/src/mention-coverage.ts
 function buildMentionCoverage(snapshots, options) {
-  const tooltip = "Your domain or company name was in the answer returned by the LLM.";
+  const tooltip = "Your domain or company name was in the answer returned by the AI engine.";
   if (snapshots.length === 0) {
     return {
       label: "Mention Coverage",
@@ -11345,7 +11364,7 @@ function buildMentionCoverage(snapshots, options) {
     tooltip,
     trend: [],
     progress: score,
-    providerCoverage: isPartialProviderRun ? `${runApiProviderCount} of ${options.configuredApiProviders.length} providers` : void 0
+    providerCoverage: isPartialProviderRun ? `${runApiProviderCount} of ${options.configuredApiProviders.length} engines` : void 0
   };
 }
 
@@ -11379,7 +11398,7 @@ function buildGapQueryScore(snapshots) {
   return {
     label: "Citation Gaps",
     value: `${gapCount}`,
-    delta: `${gapCount} of ${totalCount} queries at risk`,
+    delta: `${gapCount} of ${totalCount} ${totalCount === 1 ? "query" : "queries"}`,
     tone: gapTone(gapCount, totalCount),
     description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} currently cite competitors without citing your domain.` : "No competitive citation gaps detected in the latest visibility run.",
     tooltip,
@@ -11416,7 +11435,7 @@ function buildMentionGapScore(snapshots) {
   return {
     label: "Mention Gaps",
     value: `${gapCount}`,
-    delta: `${gapCount} of ${totalCount} queries at risk`,
+    delta: `${gapCount} of ${totalCount} ${totalCount === 1 ? "query" : "queries"}`,
     tone: gapTone(gapCount, totalCount),
     description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} mention competitors but never your brand.` : "No competitive mention gaps detected in the latest visibility run.",
     tooltip,
@@ -13638,6 +13657,7 @@ function selectSentimentSources(db, projectId, filters) {
         continue;
       }
       const identity = definition.identity;
+      const qualifiedAliases = [...identity.qualifiedAliases ?? []].sort();
       const names = effectiveBrandNames(identity);
       const urls = [identity.canonicalDomain, ...identity.ownedDomains];
       const mentionNotApplicable = !names.length && !urls.some((url) => url.trim());
@@ -13659,7 +13679,7 @@ function selectSentimentSources(db, projectId, filters) {
           language: definition.language,
           queryText: query.queryText,
           revision: null,
-          subject: { key: projectId, name: identity.displayName, aliases: [...names], identityAliases: [], urls: [...urls], mentionNotApplicable },
+          subject: { key: projectId, name: identity.displayName, aliases: [...names], identityAliases: [...qualifiedAliases], urls: [...urls], mentionNotApplicable },
           edges: [edge]
         });
       }
@@ -13844,7 +13864,7 @@ function sentimentClassifierInput(source, definition) {
 }
 
 // ../api-routes/src/sentiment-service.ts
-var DISCLOSURE = "Experimental English sentiment classification. Enabling sends each stored answer's text to TypeSafe with the frozen subject identity (name, aliases and URLs), the tracked query text and query class, the answer engine with its requested and served models, the location, and internal query, subject, Property, group and market identifiers.";
+var DISCLOSURE = "Experimental English sentiment classification. Enabling sends each stored answer's text to TypeSafe with the frozen subject identity (name, aliases, qualified aliases and URLs), the tracked query text and query class, the answer engine with its requested and served models, the location, and internal query, subject, Property, group and market identifiers.";
 var FULL_ROWS = { include: /* @__PURE__ */ new Set(["assessments", "locations"]), limit: null, after: null };
 var COMPACT_ROWS = { include: /* @__PURE__ */ new Set(), limit: null, after: null };
 var OPERATIONAL_OUTCOMES = /* @__PURE__ */ new Set([SentimentOutcomes.pending, SentimentOutcomes.running, SentimentOutcomes["waiting-to-retry"], SentimentOutcomes.failed, SentimentOutcomes.canceled]);
@@ -16866,6 +16886,7 @@ async function projectRoutes(app, opts) {
     const id = crypto9.randomUUID();
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const nextAliases = normalizeProjectAliases(body.displayName, body.aliases ?? []);
+    const qualifiedAliases = body.qualifiedAliases === void 0 ? [] : requireQualifiedAliases({ displayName: body.displayName, aliases: nextAliases }, body.qualifiedAliases, []);
     const inserted = app.db.transaction((tx) => {
       const result = tx.insert(projects).values({
         id,
@@ -16874,6 +16895,7 @@ async function projectRoutes(app, opts) {
         canonicalDomain,
         ownedDomains: body.ownedDomains ?? [],
         aliases: nextAliases,
+        qualifiedAliases,
         country: body.country,
         language: body.language,
         tags: body.tags ?? [],
@@ -16960,6 +16982,9 @@ async function projectRoutes(app, opts) {
     const nextNegativeReviewMaxStars = body.negativeReviewMaxStars !== void 0 ? body.negativeReviewMaxStars : existing ? readNegativeReviewMaxStars(app.db, existing.id) : null;
     const nextMeasurement = body.measurement ?? existing?.measurement ?? DEFAULT_MEASUREMENT_CONFIG;
     const nextAliases = normalizeProjectAliases(body.displayName, body.aliases ?? []);
+    const nextIdentity = { displayName: body.displayName, aliases: nextAliases };
+    const liveCompetitors = existing ? liveCompetitorNames(app.db, existing.id) : [];
+    const nextQualifiedAliases = body.qualifiedAliases !== void 0 ? requireQualifiedAliases(nextIdentity, body.qualifiedAliases, liveCompetitors) : resolveProjectQualifiedAliases(nextIdentity, existing?.qualifiedAliases ?? [], liveCompetitors).value;
     if (existing) {
       const prevAliases = existing.aliases;
       const aliasesChanged = !aliasArraysEqual(prevAliases, nextAliases);
@@ -16969,6 +16994,7 @@ async function projectRoutes(app, opts) {
           canonicalDomain: body.canonicalDomain,
           ownedDomains: body.ownedDomains ?? [],
           aliases: nextAliases,
+          qualifiedAliases: nextQualifiedAliases,
           country: body.country,
           language: body.language,
           tags: body.tags ?? [],
@@ -17007,6 +17033,7 @@ async function projectRoutes(app, opts) {
         canonicalDomain: body.canonicalDomain,
         ownedDomains: body.ownedDomains ?? [],
         aliases: nextAliases,
+        qualifiedAliases: nextQualifiedAliases,
         country: body.country,
         language: body.language,
         tags: body.tags ?? [],
@@ -17195,6 +17222,11 @@ async function projectRoutes(app, opts) {
       eq15(schedules.kind, SchedulableRunKinds["answer-visibility"])
     )).get();
     const notificationRows = app.db.select().from(notifications).where(eq15(notifications.projectId, project.id)).all();
+    const exportedQualifiedAliases = resolveProjectQualifiedAliases(
+      project,
+      project.qualifiedAliases,
+      comps.map((c) => competitorLabelFromDomain(c.domain))
+    ).value;
     const config = {
       apiVersion: "canonry/v1",
       kind: "Project",
@@ -17207,6 +17239,7 @@ async function projectRoutes(app, opts) {
         canonicalDomain: project.canonicalDomain,
         ownedDomains: project.ownedDomains,
         aliases: project.aliases,
+        ...exportedQualifiedAliases.length ? { qualifiedAliases: exportedQualifiedAliases } : {},
         country: project.country,
         language: project.language,
         queries: qs.map((q) => q.query),
@@ -17246,6 +17279,32 @@ function assertProviderModelScope(request, current, next, nextProviders) {
   if (providerModelsEqual(effectiveCurrent, effectiveNext)) return;
   requireScope(request, SETTINGS_WRITE_SCOPE);
 }
+function requireQualifiedAliases(identity, requested, competitorNames) {
+  const resolved = resolveProjectQualifiedAliases(identity, requested, competitorNames);
+  if (resolved.rejected.length > 0) {
+    const reasons = resolved.rejected.map((entry) => `${entry.name} (${entry.reason})`).join(", ");
+    throw validationError(`Rejected qualifiedAliases: ${reasons}`, {
+      rejectedQualifiedAliases: resolved.rejected
+    });
+  }
+  return resolved.value;
+}
+function liveCompetitorNames(db, projectId) {
+  return db.select({ domain: competitors.domain }).from(competitors).where(eq15(competitors.projectId, projectId)).all().map((row) => competitorLabelFromDomain(row.domain));
+}
+function pruneQualifiedAliasesForCompetitors(tx, projectId, now) {
+  const project = tx.select({
+    displayName: projects.displayName,
+    aliases: projects.aliases,
+    qualifiedAliases: projects.qualifiedAliases
+  }).from(projects).where(eq15(projects.id, projectId)).get();
+  if (!project?.qualifiedAliases.length) return [];
+  const kept = resolveProjectQualifiedAliases(project, project.qualifiedAliases, liveCompetitorNames(tx, projectId)).value;
+  const dropped = project.qualifiedAliases.filter((name) => !kept.includes(name));
+  if (dropped.length === 0) return [];
+  tx.update(projects).set({ qualifiedAliases: kept, updatedAt: now }).where(eq15(projects.id, projectId)).run();
+  return dropped;
+}
 function providerModelsEqual(a, b) {
   const aKeys = Object.keys(a);
   if (aKeys.length !== Object.keys(b).length) return false;
@@ -17259,6 +17318,7 @@ function formatProject(row, negativeReviewMaxStars) {
     canonicalDomain: row.canonicalDomain,
     ownedDomains: row.ownedDomains,
     aliases: row.aliases,
+    qualifiedAliases: row.qualifiedAliases,
     country: row.country,
     language: row.language,
     tags: row.tags,
@@ -17977,12 +18037,16 @@ async function competitorRoutes(app) {
           createdAt: now
         }).run();
       }
+      const droppedQualifiedAliases = pruneQualifiedAliasesForCompetitors(tx, project.id, now);
       writeAuditLog(tx, {
         projectId: project.id,
         actor: "api",
         action: "competitors.replaced",
         entityType: "competitor",
-        diff: { competitors: normalizedCompetitors }
+        diff: {
+          competitors: normalizedCompetitors,
+          ...droppedQualifiedAliases.length ? { droppedQualifiedAliases } : {}
+        }
       });
     });
     const rows = app.db.select().from(competitors).where(eq19(competitors.projectId, project.id)).all();
@@ -18009,12 +18073,13 @@ async function competitorRoutes(app) {
           target: [competitors.projectId, competitors.domain]
         }).run();
       }
+      const droppedQualifiedAliases = pruneQualifiedAliasesForCompetitors(tx, project.id, now);
       writeAuditLog(tx, {
         projectId: project.id,
         actor: "api",
         action: "competitors.appended",
         entityType: "competitor",
-        diff: { added }
+        diff: { added, ...droppedQualifiedAliases.length ? { droppedQualifiedAliases } : {} }
       });
     });
     const rows = app.db.select().from(competitors).where(eq19(competitors.projectId, project.id)).all();
@@ -25670,7 +25735,7 @@ function mentionRanking(rows, limit) {
     truncated: eligible.length > limit
   };
 }
-function portfolioResponse(db, active, plan, query) {
+function portfolioResponse(db, active, plan, query, ownDomains) {
   const group = query.groupKey === void 0 ? void 0 : requireGroup2(plan, query.groupKey);
   const run = selectMeasurementQuestionRun(db, active.version.projectId, active, query.runId);
   const requestedTargetKeys = group?.targetKeys ?? plan.targets.map((target) => target.stableKey);
@@ -25766,7 +25831,7 @@ function portfolioResponse(db, active, plan, query) {
     },
     weakestProperties: rows,
     tiedAtWeakest: tie.summary,
-    weakestAnswerSources: weakestAnswerSources([...displayed, ...tie.rows]),
+    weakestAnswerSources: weakestAnswerSources([...displayed, ...tie.rows], ownDomains),
     mentionRanking: mentionRanking(ranked, limit),
     ...marketRollup(plan, { run, evaluator }, group, includeNestedMarkets),
     totalProperties: ranked.length,
@@ -25827,7 +25892,7 @@ function tieNamedInstead(rows) {
   const counted = [...grouped.values()].map((row) => ({ name: row.name, answers: row.answers.size })).sort((left, right) => right.answers - left.answers || compareText13(left.name, right.name));
   return { rows: counted.slice(0, MEASUREMENT_PORTFOLIO_TIE_NAMED_INSTEAD_LIMIT), total: counted.length };
 }
-function weakestAnswerSources(rows) {
+function weakestAnswerSources(rows, ownDomains) {
   const properties = /* @__PURE__ */ new Set();
   const answers = /* @__PURE__ */ new Map();
   for (const row of rows) {
@@ -25835,7 +25900,11 @@ function weakestAnswerSources(rows) {
     for (const answer of row.population.sourceAnswers) answers.set(answer.snapshot.id, answer);
   }
   const domains = domainRows([...answers.values()], MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT);
-  return { properties: properties.size, answers: answers.size, domains: domains.rows, domainTotal: domains.total };
+  let ownDomainAnswers = 0;
+  for (const answer of answers.values()) {
+    if ([...answerDomains(answer)].some((host) => hostMatchesAnyDomain(host, ownDomains))) ownDomainAnswers++;
+  }
+  return { properties: properties.size, answers: answers.size, domains: domains.rows, domainTotal: domains.total, ownDomainAnswers };
 }
 function propertyCompetitorsResponse(db, active, plan, query) {
   const target = requireTarget3(plan, query.targetKey);
@@ -26047,11 +26116,14 @@ function classifyPropertyMove(mention, citation) {
     const down = directions.some((move) => move < 0);
     bucket = up && down ? "mixed" : up ? "improved" : "declined";
   }
+  const signalWithinNoise = (move) => move === null ? null : Math.abs(move) <= MEASUREMENT_CHANGES_NOISE_ANSWERS;
   return {
     mentionAnswersDelta: answersDelta(mention),
     citationAnswersDelta: answersDelta(citation),
     denominatorChanged: baseChanged(mention) || baseChanged(citation),
     withinNoise: changed && withinNoise,
+    mentionWithinNoise: signalWithinNoise(mentionMove),
+    citationWithinNoise: signalWithinNoise(citationMove),
     bucket,
     mentionSize: mentionMove === null ? -1 : Math.abs(mentionMove),
     citationSize: citationMove === null ? -1 : Math.abs(citationMove)
@@ -26140,7 +26212,9 @@ function changesResponse(db, active, plan, query) {
         mentionAnswersDelta: move.mentionAnswersDelta,
         citationAnswersDelta: move.citationAnswersDelta,
         denominatorChanged: move.denominatorChanged,
-        withinNoise: move.withinNoise
+        withinNoise: move.withinNoise,
+        mentionWithinNoise: move.mentionWithinNoise,
+        citationWithinNoise: move.citationWithinNoise
       },
       move
     }];
@@ -26321,7 +26395,7 @@ async function measurementPortfolioReadRoutes(app) {
       const raw = nested === "true" || nested === "false" ? { ...request.query, includeNestedMarkets: nested === "true" } : request.query;
       const query = parseLimitQuery(raw, measurementPortfolioSummaryQuerySchema, "Invalid measurement portfolio summary query");
       const { active, plan } = activeV2Plan2(app.db, project.id, "Portfolio summary");
-      return portfolioResponse(app.db, active, plan, query);
+      return portfolioResponse(app.db, active, plan, query, effectiveDomains(project));
     }
   );
   app.get(
@@ -29708,6 +29782,15 @@ async function applyRoutes(app, opts) {
       specProviders
     );
     const specDispatchModes = config.spec.providerDispatchModes === void 0 ? void 0 : validateProviderDispatchModes(config.spec.providerDispatchModes, opts?.providerAdapters);
+    const specCompetitorNames = normalizeCompetitorList2(config.spec.competitors).map(competitorLabelFromDomain);
+    const specQualifiedAliases = config.spec.qualifiedAliases === void 0 ? void 0 : requireQualifiedAliases(
+      {
+        displayName: config.spec.displayName,
+        aliases: normalizeProjectAliases(config.spec.displayName, config.spec.aliases)
+      },
+      config.spec.qualifiedAliases,
+      specCompetitorNames
+    );
     let resolvedSchedule = null;
     let deleteSchedule = false;
     if (config.spec.schedule) {
@@ -29766,6 +29849,11 @@ async function applyRoutes(app, opts) {
       }
       if (existing) {
         projectId = existing.id;
+        const qualifiedAliases = specQualifiedAliases ?? resolveProjectQualifiedAliases(
+          { displayName: config.spec.displayName, aliases: nextAliases },
+          existing.qualifiedAliases,
+          specCompetitorNames
+        ).value;
         const providerDispatchModes = pruneProviderDispatchModes(
           specDispatchModes ?? existing.providerDispatchModes,
           specProviders,
@@ -29776,6 +29864,7 @@ async function applyRoutes(app, opts) {
           canonicalDomain: config.spec.canonicalDomain,
           ownedDomains: config.spec.ownedDomains ?? [],
           aliases: nextAliases,
+          qualifiedAliases,
           country: config.spec.country,
           language: config.spec.language,
           labels: config.metadata.labels,
@@ -29807,6 +29896,7 @@ async function applyRoutes(app, opts) {
           canonicalDomain: config.spec.canonicalDomain,
           ownedDomains: config.spec.ownedDomains ?? [],
           aliases: nextAliases,
+          qualifiedAliases: specQualifiedAliases ?? [],
           country: config.spec.country,
           language: config.spec.language,
           tags: [],
@@ -29951,6 +30041,7 @@ async function applyRoutes(app, opts) {
       canonicalDomain: project.canonicalDomain,
       ownedDomains: project.ownedDomains,
       aliases: project.aliases,
+      qualifiedAliases: project.qualifiedAliases,
       country: project.country,
       language: project.language,
       tags: project.tags,
@@ -31284,8 +31375,11 @@ function buildRankedList(domains, limit, answerTotal, answersWithSources) {
   const domainTotal = all.length;
   all.sort((a, b) => b.count - a.count || a.domain.localeCompare(b.domain));
   const shownEntries = limit != null && limit < all.length ? all.slice(0, limit) : all;
-  const entries = shownEntries.map((d) => ({
+  let rank = 0;
+  const ranks = all.map((d, i) => rank = i > 0 && d.count === all[i - 1].count ? rank : i + 1);
+  const entries = shownEntries.map((d, i) => ({
     domain: d.domain,
+    rank: ranks[i],
     count: d.count,
     percentage: totalCitedSlots > 0 ? roundRatio(d.count / totalCitedSlots, RatioUnits.fraction) : 0,
     answerShare: answerTotal > 0 ? roundRatio(d.count / answerTotal, RatioUnits.fraction) : 0,
@@ -39426,6 +39520,7 @@ function formatProject2(row, negativeReviewMaxStars) {
     canonicalDomain: row.canonicalDomain,
     ownedDomains: row.ownedDomains,
     aliases: row.aliases,
+    qualifiedAliases: row.qualifiedAliases,
     country: row.country,
     language: row.language,
     tags: row.tags,
@@ -86021,7 +86116,7 @@ var agentProvidersConfiguredCheck = {
         status: CheckStatuses.warn,
         code: "agent-providers.none-configured",
         summary: "No agent LLM provider has credentials configured \u2014 the built-in Aero agent cannot run.",
-        remediation: "Add a key for one of the agent providers (claude, openai, gemini, zai, deepinfra) under `providers.<name>.apiKey` in ~/.canonry/config.yaml, or export its env var (e.g. ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPINFRA_TOKEN).",
+        remediation: "Add a key for one of the agent providers (claude, openai, gemini, zai) under `providers.<name>.apiKey` in ~/.canonry/config.yaml, or export its env var (e.g. ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY).",
         details
       };
     }
@@ -87666,13 +87761,18 @@ async function discoveryRoutes(app, opts) {
             createdAt: now
           }).run();
         }
+        const droppedQualifiedAliases = promotedCompetitors.length ? pruneQualifiedAliasesForCompetitors(tx, project.id, now) : [];
         writeAuditLog(tx, {
           projectId: project.id,
           actor: "api",
           action: "discovery.promoted",
           entityType: "discovery_session",
           entityId: session.id,
-          diff: { queries: promotedQueries, competitors: promotedCompetitors }
+          diff: {
+            queries: promotedQueries,
+            competitors: promotedCompetitors,
+            ...droppedQualifiedAliases.length ? { droppedQualifiedAliases } : {}
+          }
         });
       });
     }
@@ -90373,12 +90473,28 @@ function captureSimpleMeasurementDefinition(db, input) {
     if (definition.queries.some((query) => query.queryClass !== (classifier?.classify(query.queryText) ?? null))) {
       throw validationError("Query classes must match the captured identity and text.");
     }
+    if (definition.identity.qualifiedAliases !== void 0) {
+      const expected = resolveProjectQualifiedAliases(
+        definition.identity,
+        definition.identity.qualifiedAliases,
+        simpleMeasurementCompetitorNames(definition.competitors)
+      ).value;
+      const captured = definition.identity.qualifiedAliases;
+      if (captured.length !== expected.length || captured.some((name, index2) => name !== expected[index2])) {
+        throw validationError("Qualified aliases must be a sorted subset of the captured aliases.");
+      }
+    }
     const existing = tx.select().from(simpleMeasurementDefinitions).where(and68(eq81(simpleMeasurementDefinitions.projectId, input.projectId), eq81(simpleMeasurementDefinitions.runId, input.runId))).get();
     if (existing) {
       const frozen = simpleMeasurementDefinitionSchema.parse(existing.definition);
+      const { qualifiedAliases: _liveQualifiedAliases, ...liveIdentity } = definition.identity;
       const replayDefinition = {
         ...definition,
-        capturedAt: frozen.capturedAt
+        capturedAt: frozen.capturedAt,
+        identity: {
+          ...liveIdentity,
+          ...frozen.identity.qualifiedAliases?.length ? { qualifiedAliases: frozen.identity.qualifiedAliases } : {}
+        }
       };
       const replayChecksum = crypto51.createHash("sha256").update(canonicalSimpleMeasurementDefinitionJson(replayDefinition)).digest("hex");
       if (existing.checksum !== replayChecksum) {