# TAG Registry — Cross-Page Consistency Tracking
# Every customer-visible claim, feature, or concept is tagged.
# Agents use this to verify consistency across ALL pages and products.
#
# Usage: Before any marketing/UI change, search for the tag and update ALL occurrences.
# After any change, run: "verify all #tag_name references are consistent"
#
# Updated: 2026-03-30

tags:

  # ── Product Claims ──────────────────────────────────────────

  tools_count:
    canonical_value: "39"
    display: "39 ministry tools"
    tooltip_required: true
    tooltip_text: "Actions your AI can take during conversations — like capturing prayer requests, logging visitor contacts, finding small groups, looking up service times, and notifying your staff."
    locations:
      - churchwiseai-web/src/app/pricing/PricingGrid.tsx  # Suite card
      - churchwiseai-web/src/app/page.tsx  # Homepage stats
      - churchwiseai-web/src/app/demo/page.tsx  # Tool inventory
      - churchwiseai-web/src/lib/pricing.ts  # Pricing data
      - churchwiseai-web/src/app/chatbot/page.tsx  # Chatbot product page
      - churchwiseai-web/public/starter-kit/church-ai-starter-kit.pdf  # PDF (needs regen)
    per_tier:
      starter: "12"
      pro: "35"
      suite: "39"

  agent_count:
    canonical_value:
      starter: "2"
      pro: "4"
      suite: "4"
    agent_names:
      all_tiers: ["Care Agent", "Coordinator Agent"]
      pro_suite_only: ["Discipleship Agent", "Stewardship Agent"]
    tooltip_required: true
    locations:
      - churchwiseai-web/src/app/pricing/PricingGrid.tsx
      - churchwiseai-web/src/app/pricing/AgentShowcase.tsx
      - churchwiseai-web/src/app/demo/page.tsx
      - churchwiseai-web/src/lib/pricing.ts
      - churchwiseai-web/src/lib/tier-features.ts
      - churchwiseai-web/src/components/admin/training/AgentOverviewCard.tsx
      - churchwiseai-web/src/app/care/[slug]/page.tsx

  personas:
    description: "Specialized modes within each agent. NOT visible to end users as selectable options — internal routing only."
    per_agent:
      care: ["Pastoral Care", "Prayer Ministry"]
      coordinator: ["Visitor Welcome", "New Members", "Volunteers", "Youth"]
      discipleship: ["Bible Study", "Sermon Prep", "Small Groups"]
      stewardship: ["Giving & Generosity"]
    display_format: "Specializes in: X · Y · Z"
    tooltip_required: false  # shown inline on agent cards
    locations:
      - churchwiseai-web/src/components/admin/training/AgentOverviewCard.tsx
      - churchwiseai-web/src/app/pricing/AgentShowcase.tsx
      - churchwiseai-web/src/lib/agent-type-config.ts  # AGENT_PERSONA_MAP (code truth)

  illustration_count:
    canonical_value: "30,000+"
    source: "unified_rag_content WHERE content_type IN sermon types"
    locations:
      - churchwiseai-web/src/app/pricing/AgentShowcase.tsx
      - churchwiseai-web/src/app/demo/page.tsx
      - churchwiseai-web/src/lib/chatbot-tools.ts  # search_illustrations description
      - churchwiseai-web/public/starter-kit/church-ai-starter-kit.pdf
      - sermon-illustrations/src/app/page.tsx  # ITW homepage

  church_count:
    canonical_value: "218,000+"
    filter: "directory_visible = true"
    NOT: "261K (raw row count)"
    locations:
      - churchwiseai-web/src/app/page.tsx  # Homepage stats
      - churchwiseai-web/public/starter-kit/church-ai-starter-kit.pdf
      - pewsearch/web/src/app/page.tsx  # PewSearch homepage

  theological_traditions:
    canonical_value: "17"
    locations:
      - churchwiseai-web/src/app/page.tsx
      - churchwiseai-web/src/app/pricing/PricingGrid.tsx
      - churchwiseai-web/src/lib/theolenses.ts  # code truth

  # ── Pricing ──────────────────────────────────────────────────

  pricing:
    currency: "USD"
    enforcement: "currency: 'usd' + adaptive_pricing: { enabled: false } on all checkout sessions"
    plans:
      starter_chat: "$14.95/mo"
      starter_voice: "$39.95/mo"
      starter_both: "$49.95/mo"
      pro_chat: "$34.95/mo"
      pro_voice: "$69.95/mo"
      pro_both: "$79.95/mo"
      suite_chat: "$59.95/mo"
      suite_both: "$99.95/mo"
      pewsearch_premium: "$9.95/mo"
      pewsearch_pro_website: "$19.95/mo"
      itw_premium: "$9.95/mo"
      sermonwise_pro: "$19.95/mo"
    trial: "14 days on chat-only plans. No trial on voice/bundle."
    locations:
      - churchwiseai-web/src/lib/pricing.ts
      - churchwiseai-web/src/app/pricing/PricingGrid.tsx
      - C:\dev\PRICING.md  # source of truth

  # ── Features by Tier ────────────────────────────────────────

  tier_features:
    starter_has: ["basic_chatbot", "hosted_chat", "premium_page", "embed_widget"]
    starter_NOT: ["faq_management", "document_upload", "analytics", "widget_customization", "training_simulator", "voice"]
    pro_adds: ["faq_management", "document_upload", "analytics", "widget_customization", "theological_lens_config", "discipleship_agent", "stewardship_agent"]
    suite_adds: ["remove_badge", "api_access", "unlimited_docs", "advanced_analytics"]
    code_truth: "churchwiseai-web/src/lib/tier-config.ts"

  # ── Voice vs Chat ───────────────────────────────────────────

  channel_gating:
    description: "Voice-specific UI elements MUST be hidden on chat-only plans"
    voice_only_elements:
      - "Voice badge on agent cards"
      - "Voice greeting field"
      - "SMS notification phone field"
      - "'Voice + Chatbot' text labels"
      - "Voice greeting in training progress"
      - "Calls tab"
    check: "Search for 'voice', 'Voice', 'Mic', 'Phone', 'SMS', 'call' in all dashboard components and verify each is gated by planIncludesVoice()"

  # ── Denomination Awareness ──────────────────────────────────

  denomination_labels:
    liturgical_traditions: ["Catholic", "Orthodox", "Episcopal", "Anglican", "Lutheran"]
    label_swaps:
      sermon: "Sermon / Homily"
      service: "Mass / Service"
      pastor: "Father / Pastor"
    locations:
      - churchwiseai-web/src/components/admin/training/ThisWeekPanel.tsx
      - churchwiseai-web/src/app/pricing/AgentShowcase.tsx  # demo scenarios

  # ── Demo / Contact Numbers ──────────────────────────────────

  demo_numbers:
    us: "+1 (469) 615-2221"
    canada: "+1 (365) 825-4095"
    NOT: "+1 (888) 603-0316 (that's the sales line)"
    locations:
      - churchwiseai-web/src/app/demo/page.tsx
      - churchwiseai-web/src/app/voice/page.tsx
      - churchwiseai-web/src/app/pricing/page.tsx  # FAQ
      - churchwiseai-web/public/starter-kit/church-ai-starter-kit.pdf

  # ── Jargon Registry ─────────────────────────────────────────

  jargon_forbidden:
    description: "Terms that should NEVER appear in pastor-facing UI without explanation"
    terms:
      - "ministry tools"  # needs tooltip
      - "personas"  # show specialization names instead
      - "Hero Photo"  # say "Church Photo"
      - "Short URL"  # say "Custom web address" or "Vanity URL"
      - "webhook"
      - "API"  # only in Suite context, with explanation
      - "RAG"
      - "LLM"
      - "embedding"
      - "token"  # in admin context
      - "UPSERT"
      - "RPC"
      - "slug"
      - "metadata"
      - variable names with underscores (e.g., "believers_baptism_only")
