fix(events): store venue placeId + adopt the Shamwari icon (#121)

* fix(events): store the resolved venue placeId, report catalogue misses to fundi-ingestion

createEventForPerson/updateEventForPerson hardcoded placeId: null on every
event, so the built EventVenueCard/VenueVerifyCta (Kweli) surfaces had
nothing to ever resolve. Thread the placeId a DB hit or a promoted OSM
suggestion already carries from location-modal.tsx through the create/edit
forms into the event doc, clearing it if the venue is hand-edited afterward.

Additively, when geocodeAddress() falls through to Nominatim, fire a
best-effort search_miss task at the fundi-ingestion worker so it bulk-seeds
the surrounding area (fuller Overpass/enrichment pass than nhimbe's own
single-pick promotion) for future searches, without blocking this request.

* feat(ui): adopt the hex-cluster mark as the Shamwari/AI icon

New ShamwariIcon (src/components/ui/shamwari-icon.tsx) replaces the generic
lucide Bot glyph everywhere it stood in for the Shamwari assistant: the
description wizard, the "Ask Shamwari" trigger, the search pill, and the
Shamwari answer block in NyuchiSearchView. Left the Sparkles icons on
upgrade-to-pro-alert and the avatar picker's Gravatar button alone — neither
is actually AI-branded.

Idle pulse animation via the harness's motion config (skipped under
prefers-reduced-motion), wrapped in SectionErrorBoundary so a render failure
in the icon can't take an AI-adjacent surface down with it, and defaults to
role="img" + aria-label="Shamwari AI" unless the caller marks it decorative
with aria-hidden (the common case, next to visible "Shamwari" text).

---------

Co-authored-by: Bryan Fawcett <noreply@anthropic.com>

Author: bryanfawcett

CLAUDE.md

@@ -337,6 +337,7 @@ Set in Vercel (prod + preview) and locally in `.env.local`:
 - `SHAMWARI_AI_GATEWAY_URL`, `SHAMWARI_AI_GATEWAY_TOKEN` — Cloudflare AI Gateway base + provider bearer; optional `SHAMWARI_AI_GATEWAY_AUTH_TOKEN` for the authenticated gateway.
 - `RESEND_API_KEY` — server-only; used for transactional email via Resend (`src/lib/email/`). Sends from the verified `notify.mukoko.com` domain (`events@notify.mukoko.com`). When unset, email sends are skipped (never throw).
 - `R2_ACCOUNT_ID`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY` — server-only R2 S3 API credentials for cover-image uploads (`src/lib/r2.ts`). `R2_BUCKET` *(optional)* defaults to `mukoko-storage`. When unset, `/api/media/upload` returns 503 and uploads fall back to a gradient cover.
+- `FUNDI_API_TOKEN` — server-only bearer token for the `fundi-ingestion` Cloudflare Worker's `POST /tasks` endpoint. `src/app/actions/geocode.ts` fires a best-effort `search_miss` task whenever a places-catalogue search falls through to OSM Nominatim, so fundi-ingestion bulk-seeds the surrounding area (Overpass + Plus Codes/what3words/Wikidata/AI-description enrichment) into the shared `places.places`/`entity.entities` collections for next time. When unset, reporting is skipped silently — nhimbe's own address search is unaffected either way. `FUNDI_INGESTION_URL` *(optional)* defaults to `https://fundi-ingestion.nyuchi.dev`.
 - `NEXT_PUBLIC_SITE_URL` — the **primary/canonical** public origin (default `https://events.mukoko.com`). See "Dual-domain" below — this is the single origin all self-referential URLs (canonical tags, OG images, sitemap, robots, JSON-LD, `.well-known` resource) point at, resolved once in `src/lib/site-url.ts` (`SITE_URL`).
 - `NEXT_PUBLIC_ASSETS_URL` *(optional)* — override the R2 assets host (defaults to `https://assets-s001.mukoko.com`).
 - `ADMIN_URL` *(optional)* — where `/admin*` redirects (defaults to `https://admin.events.mukoko.com`). The admin app itself is a separate repo (`nyuchi/mukoko-events-admin`) and Vercel project with its own env.

src/app/actions/events.ts

@@ -49,6 +49,15 @@ export interface CreateEventActionInput {
   streetAddress?: string;
   addressLocality?: string;
   addressCountry?: string;
+  /**
+   * The `places.places._id` behind the chosen venue, when the location picker
+   * resolved one (a catalogue hit, or a promoted OSM suggestion) — cleared by
+   * the form the moment someone hand-edits the venue/address fields, since a
+   * stale id would point at the wrong place. Never validated server-side
+   * beyond shape: it's a display/verification link, not an authorization
+   * boundary, and a bad id just makes `EventVenueCard`/Kweli lookups no-op.
+   */
+  placeId?: string | null;
   /** IANA timezone the venue resolves to (e.g. "Africa/Harare"). */
   timezone?: string | null;
   meetingUrl?: string | null;
@@ -213,7 +222,7 @@ export async function createEventForPerson(
     totalAttendeeCount: 0,
     surfaceContext: "mukoko_events",
     location,
-    placeId: null,
+    placeId: input.isOnline ? null : input.placeId?.trim() || null,
     circleId: null,
     calendarId: null,
     offers,
@@ -285,6 +294,8 @@ export interface UpdateEventInput {
   streetAddress?: string;
   addressLocality?: string;
   addressCountry?: string;
+  /** See `CreateEventActionInput.placeId`. */
+  placeId?: string | null;
   /** IANA timezone the venue resolves to (e.g. "Africa/Harare"). */
   timezone?: string | null;
   meetingUrl?: string | null;
@@ -406,6 +417,7 @@ export async function updateEventForPerson(
           },
           timezone: patch.timezone ?? undefined,
         };
+    set.placeId = patch.isOnline ? null : patch.placeId?.trim() || null;
     contentChanged = true;
   }
 

src/app/actions/geocode.ts

@@ -278,6 +278,43 @@ async function searchNominatim(query: string, limit: number): Promise<GeocodeSug
   }
 }
 
+const FUNDI_INGESTION_URL = process.env.FUNDI_INGESTION_URL ?? "https://fundi-ingestion.nyuchi.dev";
+const SEARCH_MISS_RADIUS_METERS = 3000;
+
+/**
+ * Report a places-catalogue miss to the fundi-ingestion worker so it bulk-seeds
+ * the surrounding area from OSM/Overpass for next time (richer enrichment —
+ * Plus Codes, what3words, Wikidata, AI descriptions — than nhimbe's own
+ * single-pick promotion below can do). Fire-and-forget in effect: awaited so a
+ * serverless invocation doesn't get torn down mid-request, but every failure
+ * (missing token, network, non-2xx) is swallowed — a reporting hiccup must
+ * never affect the address search the caller actually asked for.
+ */
+async function reportSearchMiss(query: string, near: GeocodeSuggestion): Promise<void> {
+  const token = process.env.FUNDI_API_TOKEN;
+  if (!token) return;
+  try {
+    await fetch(`${FUNDI_INGESTION_URL}/tasks`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify({
+        region: {
+          kind: "point_radius",
+          center: [near.longitude, near.latitude],
+          radiusMeters: SEARCH_MISS_RADIUS_METERS,
+        },
+        categories: "all",
+        source: { kind: "search_miss", surface: "geocode-address", query },
+      }),
+    });
+  } catch (e) {
+    console.error("[mukoko] reportSearchMiss failed", e);
+  }
+}
+
 /**
  * Geocode a free-text address query.
  *
@@ -299,7 +336,9 @@ export async function geocodeAddress(
   const dbHits = await searchPlacesDb(q, limit);
   if (dbHits.length > 0) return dbHits;
 
-  return searchNominatim(q, limit);
+  const osmHits = await searchNominatim(q, limit);
+  if (osmHits.length > 0) await reportSearchMiss(q, osmHits[0]);
+  return osmHits;
 }
 
 export interface ReverseGeocodeResult {

src/app/events/[id]/edit/edit-event-form.tsx

@@ -89,6 +89,7 @@ export function EditEventForm({ event }: EditEventFormProps) {
   const [selectedTimezone, setSelectedTimezone] = useState<string | null>(
     !wasOnline ? event.timezone ?? null : null,
   );
+  const [placeId, setPlaceId] = useState<string | null>(!wasOnline ? event.placeId ?? null : null);
 
   const [capacity, setCapacity] = useState<number | null>(event.maximumAttendeeCapacity ?? null);
   const [isFree, setIsFree] = useState(!event.offers?.url);
@@ -200,6 +201,7 @@ export function EditEventForm({ event }: EditEventFormProps) {
         isOnline,
         venue: venue.trim(),
         streetAddress: address.trim(),
+        placeId,
         addressLocality: selectedCity?.addressLocality,
         addressCountry: selectedCity?.addressCountry,
         timezone: isOnline ? null : selectedTimezone,
@@ -369,6 +371,8 @@ export function EditEventForm({ event }: EditEventFormProps) {
         setAddress={setAddress}
         selectedCity={selectedCity}
         setSelectedCity={setSelectedCity}
+        placeId={placeId}
+        setPlaceId={setPlaceId}
         cities={cities}
         selectedTimezone={selectedTimezone}
         setSelectedTimezone={setSelectedTimezone}

src/app/events/create/create-event-form.tsx

@@ -161,6 +161,8 @@ export default function CreateEventForm() {
   const [address, setAddress] = useState("");
   const [addressSearch, setAddressSearch] = useState("");
   const [selectedCity, setSelectedCity] = useState<{ addressLocality: string; addressCountry: string } | null>(null);
+  // The places.places._id behind the venue, when the picker resolved one.
+  const [placeId, setPlaceId] = useState<string | null>(null);
   // Resolved from the venue when a location is picked (see LocationModal); an
   // online event or one with no location yet falls back to the organiser's
   // own browser timezone.
@@ -366,6 +368,7 @@ export default function CreateEventForm() {
         isOnline,
         venue: venue.trim(),
         streetAddress: address.trim(),
+        placeId,
         addressLocality: selectedCity?.addressLocality,
         addressCountry: selectedCity?.addressCountry,
         timezone: isOnline ? null : selectedTimezone,
@@ -614,7 +617,7 @@ export default function CreateEventForm() {
 
       {/* Modals */}
       <DateTimeModal isOpen={showDateModal} onClose={() => { setShowDateModal(false); touchForm(); }} eventDate={eventDate} setEventDate={setEventDate} startTime={startTime} setStartTime={setStartTime} endTime={endTime} setEndTime={setEndTime} />
-      <LocationModal isOpen={showLocationModal} onClose={() => { setShowLocationModal(false); touchForm(); }} isOnline={isOnline} setIsOnline={setIsOnline} meetingPlatform={meetingPlatform} setMeetingPlatform={setMeetingPlatform} meetingUrl={meetingUrl} setMeetingUrl={setMeetingUrl} addressSearch={addressSearch} setAddressSearch={setAddressSearch} venue={venue} setVenue={setVenue} address={address} setAddress={setAddress} selectedCity={selectedCity} setSelectedCity={setSelectedCity} cities={cities} selectedTimezone={selectedTimezone} setSelectedTimezone={setSelectedTimezone} />
+      <LocationModal isOpen={showLocationModal} onClose={() => { setShowLocationModal(false); touchForm(); }} isOnline={isOnline} setIsOnline={setIsOnline} meetingPlatform={meetingPlatform} setMeetingPlatform={setMeetingPlatform} meetingUrl={meetingUrl} setMeetingUrl={setMeetingUrl} addressSearch={addressSearch} setAddressSearch={setAddressSearch} venue={venue} setVenue={setVenue} address={address} setAddress={setAddress} selectedCity={selectedCity} setSelectedCity={setSelectedCity} cities={cities} selectedTimezone={selectedTimezone} setSelectedTimezone={setSelectedTimezone} placeId={placeId} setPlaceId={setPlaceId} />
       <CategoryModal isOpen={showCategoryModal} onClose={() => { setShowCategoryModal(false); touchForm(); }} categories={categories} category={category} setCategory={setCategory} tags={tags} tagInput={tagInput} setTagInput={setTagInput} addTag={addTag} removeTag={removeTag} />
       <DescriptionModal isOpen={showDescriptionModal} onClose={() => { setShowDescriptionModal(false); touchForm(); }} description={description} setDescription={setDescription} eventName={eventName} category={category} isOnline={isOnline} />
       <TicketingModal isOpen={showPriceModal} onClose={() => { setShowPriceModal(false); touchForm(); }} isFree={isFree} setIsFree={setIsFree} ticketUrl={ticketUrl} setTicketUrl={setTicketUrl} />

src/components/modals/location-modal.tsx

@@ -40,6 +40,9 @@ interface LocationModalProps {
   /** IANA timezone the venue resolves to — drives what "3pm" means on submit. */
   selectedTimezone: string | null;
   setSelectedTimezone: (value: string | null) => void;
+  /** The resolved `places.places._id` behind the venue, when there is one. */
+  placeId: string | null;
+  setPlaceId: (value: string | null) => void;
 }
 
 export function LocationModal({
@@ -62,6 +65,8 @@ export function LocationModal({
   cities,
   selectedTimezone,
   setSelectedTimezone,
+  placeId,
+  setPlaceId,
 }: LocationModalProps) {
   return (
     <ResponsiveModal open={isOpen} onOpenChange={(open) => { if (!open) onClose(); }} title="Event Location">
@@ -158,16 +163,20 @@ export function LocationModal({
                   } else {
                     setSelectedTimezone(null);
                   }
-                  // Promote a confirmed OSM/Nominatim pick into the places
-                  // catalogue so the next search for this venue hits the DB
-                  // tier first — best-effort, fire-and-forget.
-                  if (
-                    components.source === "osm" &&
+                  if (components.source === "db") {
+                    // Already a real places.places._id.
+                    setPlaceId(components.placeId);
+                  } else if (
                     components.osmType &&
                     components.osmId !== undefined &&
                     components.latitude !== undefined &&
                     components.longitude !== undefined
                   ) {
+                    // The suggestion's placeId is a synthetic "osm:type/id"
+                    // placeholder until promoted — swap it for the real
+                    // places.places._id once ensurePlaceFromOsmSuggestion
+                    // creates (or finds) the catalogue row.
+                    setPlaceId(null);
                     ensurePlaceFromOsmSuggestion({
                       name: components.venue,
                       address: components.address,
@@ -177,11 +186,16 @@ export function LocationModal({
                       longitude: components.longitude,
                       osmType: components.osmType,
                       osmId: components.osmId,
-                    });
+                    }).then((resolvedId) => setPlaceId(resolvedId));
+                  } else {
+                    setPlaceId(null);
                   }
                 }}
                 placeholder="Search for a venue or address..."
               />
+              {placeId && (
+                <p className="text-xs text-text-tertiary mt-2">Matched to the places catalogue</p>
+              )}
             </div>
 
             {/* Divider */}
@@ -198,7 +212,7 @@ export function LocationModal({
                 inputMode="text"
                 autoComplete="organization"
                 value={venue}
-                onChange={(e) => setVenue(e.target.value)}
+                onChange={(e) => { setVenue(e.target.value); setPlaceId(null); }}
                 placeholder="e.g., Rainbow Towers Hotel"
                 className="w-full px-4 py-3 bg-surface text-foreground placeholder:text-text-tertiary rounded-xl border border-border outline-none focus-visible:ring-2 focus-visible:ring-ring/50 text-base"
               />
@@ -210,7 +224,7 @@ export function LocationModal({
                 inputMode="text"
                 autoComplete="street-address"
                 value={address}
-                onChange={(e) => setAddress(e.target.value)}
+                onChange={(e) => { setAddress(e.target.value); setPlaceId(null); }}
                 placeholder="Street address"
                 className="w-full px-4 py-3 bg-surface text-foreground placeholder:text-text-tertiary rounded-xl border border-border outline-none focus-visible:ring-2 focus-visible:ring-ring/50 text-base"
               />

src/components/ui/ai-description-wizard.tsx

@@ -1,10 +1,11 @@
 "use client";
 
 import { useEffect, useRef, useState } from "react";
-import { Bot, ArrowRight, ArrowLeft, Loader2, RefreshCw, Check, X } from "lucide-react";
+import { ArrowRight, ArrowLeft, Loader2, RefreshCw, Check, X } from "lucide-react";
 import { Button } from "./button";
 import { Textarea } from "./textarea";
 import { Badge } from "./badge";
+import { ShamwariIcon } from "./shamwari-icon";
 import { UpgradeToProAlert } from "./upgrade-to-pro-alert";
 import type { DescriptionContext, GeneratedDescription } from "@/lib/api";
 import { generateEventDescription, regenerateEventDescription } from "@/app/actions/ai";
@@ -274,7 +275,7 @@ export function AIDescriptionWizard({
               <div className="flex items-center gap-3">
                 <div className="w-10 h-10 rounded-xl bg-primary/20 flex items-center justify-center">
                   {/* Shamwari AI glyph — sodalite mineral (intelligence, depth) */}
-                  <Bot className="dikdik w-5 h-5" />
+                  <ShamwariIcon className="dikdik w-5 h-5" aria-hidden="true" />
                 </div>
                 <div>
                   <h3 className="font-semibold">Shamwari</h3>
@@ -401,7 +402,7 @@ export function AIDescriptionWizard({
             <div className="flex items-center gap-3">
               <div className="w-10 h-10 rounded-xl bg-primary/20 flex items-center justify-center">
                 {/* Shamwari AI glyph — sodalite mineral (intelligence, depth) */}
-                <Bot className="dikdik w-5 h-5" />
+                <ShamwariIcon className="dikdik w-5 h-5" aria-hidden="true" />
               </div>
               <div>
                 <h3 className="font-semibold">Shamwari</h3>
@@ -481,7 +482,7 @@ export function AIDescriptionWizard({
               </>
             ) : isLastStep ? (
               <>
-                <Bot className="w-4 h-4" />
+                <ShamwariIcon className="w-4 h-4" aria-hidden="true" />
                 Generate Description
               </>
             ) : (
@@ -525,7 +526,7 @@ export function AIDescriptionBadge({
         className="inline-flex items-center gap-1.5 px-3 py-1.5 bg-primary/10 hover:bg-primary/20 text-primary rounded-xl text-xs font-medium transition-colors border border-primary/20 h-auto min-h-0"
         title="Ask Shamwari to help write your description"
       >
-        <Bot className="w-3.5 h-3.5" />
+        <ShamwariIcon className="w-3.5 h-3.5" aria-hidden="true" />
         Ask Shamwari
         <Badge variant="default" className="ml-0.5 px-1.5 py-0 text-[10px] leading-4">
           Pro

src/components/ui/nyuchi-search-view.tsx

@@ -1,8 +1,9 @@
 "use client";
 
 import * as React from "react";
-import { Search, X, Bot, Loader2, Clock, TrendingUp } from "lucide-react";
+import { Search, X, Loader2, Clock, TrendingUp } from "lucide-react";
 import { cn } from "@/lib/utils";
+import { ShamwariIcon } from "@/components/ui/shamwari-icon";
 import { useNyuchiHarness } from "@/components/ui/harness";
 import { FilterBar, type FilterOption } from "@/components/ui/filter-bar";
 import { NyuchiListingCard, type NyuchiListingMeta } from "@/components/ui/nyuchi-listing-card";
@@ -161,7 +162,7 @@ export function NyuchiSearchView({
       {/* Shamwari AI summary */}
       {aiSummary && (
         <div className="flex items-start gap-3 rounded-[var(--radius-lg,14px)] border border-primary/20 bg-primary/10 p-4">
-          <Bot className="mt-0.5 size-5 shrink-0 text-primary" aria-hidden />
+          <ShamwariIcon className="mt-0.5 size-5 shrink-0 text-primary" aria-hidden />
           <p className="text-sm leading-relaxed text-foreground">{aiSummary}</p>
         </div>
       )}

src/components/ui/search-pill.tsx

@@ -1,7 +1,8 @@
 import * as React from "react";
 import Link from "next/link";
-import { Search, Bot } from "lucide-react";
+import { Search } from "lucide-react";
 import { cn } from "@/lib/utils";
+import { ShamwariIcon } from "@/components/ui/shamwari-icon";
 
 interface SearchPillProps {
   /** Where the pill routes. Defaults to the AI search page. */
@@ -49,7 +50,7 @@ function SearchPill({
       <span className="duiker">{placeholder}</span>
       <span className="impala" aria-hidden />
       <span className="springbok">
-        <Bot className="w-[11px] h-[11px]" strokeWidth={2.2} aria-hidden />
+        <ShamwariIcon className="w-[11px] h-[11px]" strokeWidth={2.2} aria-hidden />
         AI
       </span>
     </Link>