Method resolveBrand

server/src/brand-manager.ts:626–746

* Resolve a domain to its canonical brand identity * Follows redirects and resolves through house portfolios

(
    domain: string,
    options: { maxRedirects?: number; skipCache?: boolean } = {}
  )

   * Follows redirects and resolves through house portfolios
   */
  async resolveBrand(
    domain: string,
    options: { maxRedirects?: number; skipCache?: boolean } = {}
  ): Promise<ResolvedBrand | null> {
    const { maxRedirects = 3, skipCache = false } = options;
    const normalizedDomain = domain.replace(/^https?:\/\//, '').replace(/\/$/, '');
    const cacheKey = `resolve:${normalizedDomain}`;

    // Check resolution cache unless explicitly skipped
    if (!skipCache) {
      const cached = this.resolutionCache.get(cacheKey);
      if (cached !== undefined) {
        return cached;
      }
    }

    let currentDomain = normalizedDomain;
    let redirectCount = 0;

    while (redirectCount < maxRedirects) {
      const validationResult = await this.validateDomain(currentDomain, { skipCache });

      if (!validationResult.valid || !validationResult.raw_data) {
        this.resolutionCache.set(cacheKey, null);
        return null;
      }

      const data = validationResult.raw_data as BrandJson;

      switch (validationResult.variant) {
        case 'authoritative_location': {
          const authData = data as AuthoritativeLocationVariant;
          try {
            const url = new URL(authData.authoritative_location);
            currentDomain = url.hostname + url.pathname;
            redirectCount++;
            continue;
          } catch {
            this.resolutionCache.set(cacheKey, null);
            return null;
          }
        }

        case 'house_redirect': {
          const redirectData = data as HouseRedirectVariant;
          currentDomain = redirectData.house;
          redirectCount++;
          continue;
        }

        case 'brand_agent': {
          const agentData = data as BrandAgentVariant;
          const result: ResolvedBrand = {
            canonical_id: currentDomain,
            canonical_domain: currentDomain,
            brand_name: currentDomain, // Agent should provide the name via MCP
            brand_agent_url: agentData.brand_agent.url,
            source: 'brand_json',