Skip to main content

Liberty Mutual Auto — Rebrand Context

Liberty Mutual is the customer-facing brand. Safeco is the integration carrier slug we still use for code paths, database lookups, and vendor contracts. This page exists so future contributors do not "fix" intentional Safeco references.

Brand vs. integration​

  • Customer-facing brand: Liberty Mutual.
  • Integration carrier slug: safeco — used in DB, code, env vars, ACORD namespaces, and vendor URLs.
  • The brand and the integration slug are intentionally decoupled.

Why APIs and identifiers still say safeco​

These are stable technical identifiers, not branding. They are kept because changing them would break runtime resolution, vendor contracts, or local databases.

  • API route prefixes: /ghcms/safeco/*, /session/safeco-*, @Controller({ path: 'ghcms/safeco' }).
  • Carrier slug 'safeco' in DB and slug-keyed lookups in code.
  • Package alias @goosehead-fastlane/carriers/safeco, lib folder libs/apis/carriers/safeco/, tsconfig path.
  • Code identifiers and file names: SafecoController, SafecoCarrierModule, SafecoAutoFlow, useSafecoRate*, useSafecoSseChannel, safeco-*-block.tsx, etc.
  • ACORD/XML fields and namespaces: com.safeco_*. Vendor contract terms.
  • Carrier API URLs: api.safeco.com, test.aspire.safeco.com, client.qa.safeco.com, now.agent.safeco.com.
  • Env vars: SAFECO_HYDRA_*, SAFECO_USERNAME, SAFECO_PASSWORD, etc.
  • Feature flag keys: safeco_texas_hydra_flow, safeco_mock_api_enabled, safeco_crn_proxy, safeco_auto_texas. Visible labels were rebranded; keys did not change.

Customer-facing URL​

  • Active URL: /carriers/liberty-mutual/auto/*.
  • Legacy URL: /carriers/safeco/auto/* is kept only as a redirect target (preserves sub-path, query, and hash).
  • The legacy URL must not be reused for anything else.

Active vs. standalone seeds​

Subtask 4 of the rebrand updated only the active seeds invoked from prisma/seed.ts. Standalone or manual seeds outside that entrypoint were intentionally not touched.

Active seeds (rebranded for visible Liberty Mutual labels):

  • prisma/seeds/carriers.seed.ts
  • prisma/seeds/ghcms-carrier-mappings.seed.ts
  • prisma/seeds/forms.seed.ts
  • prisma/seeds/safeco-forms.seed.ts
  • prisma/seeds/ghcms-forms-coverages.seed.ts
  • prisma/seeds/feature-flags.seed.ts

Out of scope (not in prisma/seed.ts, predate the rebrand, leave alone unless explicitly extending scope):

  • prisma/seeds/safeco-tx.seed.ts
  • prisma/seeds/safeco-base.seed.ts
  • prisma/seeds/safeco-handlers.seed.ts
  • prisma/seeds/sample-safeco-rules.seed.ts
  • prisma/seeds/add-safeco-*.seed.ts (option/section/page/question metadata, default options, Texas override scope)

Local DB sync migration​

A review-only Prisma migration at prisma/migrations/20260505204500_liberty_mutual_visible_branding/migration.sql updates only visible columns in fastlane.carriers, fastlane.forms, fastlane.form_overrides, and fastlane.ghcms_feature_flags. It does not change slugs, ids, keys, or technical metadata. Rollback SQL is included as comments. It is not auto-applied; review and apply per environment policy.

  • Visible UI: change copy in portal/admin components and stories that assert on copy.
  • Active seeds: update name/description/visible metadata only. Keep slugs, ids, keys, and 'safeco' carrier slug.
  • DB rows: extend or follow the existing review-only migration; never edit slugs/keys.
  • Tests: update fixtures and assertions that read display strings; leave fixtures that exercise carrier resolution by slug.
  • Docs: cross-link from apps/docs/docs/carriers/safeco/auto/index.md instead of renaming the existing Safeco docs tree.