George-techie/girl-effect-srh-rag

Safety-aware SRH assistant for adolescent girls in Kenya: governed corpus, measured retrieval, rules-first decision layer # Trusted Aunti — sexual and reproductive health, for adolescent girls in Kenya A safety-aware assistant answering questions about **contraception, sexual health, staying safe, and how to reach a service** — grounded in eight governed documents, with a deterministic safety floor above it. This is a **refined** build. The feedback on the previous one was that it was overengineered in places, and this repository is the answer to that: the same solution philosophy, with every component either justified by a measurement or deleted. ```mermaid flowchart TD USER[" HER MESSAGE "]:::her subgraph OBS["🔒 PRIVACY-SAFE OBSERVABILITY — route · safety · retrieval · LLM calls · latency · validator · journey stage · invariant failures · no message text"] direction TB VAL[" INPUT VALIDATION "]:::det LEXS[" KENYAN LEXICON / LANGUAGE SIGNALS 19 terms · 90 surface forms · risk tags "]:::det DEC{" DETERMINISTIC DECISION + SAFETY FLOOR safeguarding checked first, before any other family 52/52 · recall 1.000 · precision 1.000 "}:::gate SG[" SAFEGUARDING "]:::stop OOS[" OUT OF SCOPE "]:::stop CHAT[" CHAT "]:::model GRD[" FACTUAL / SUPPORT / ACCESS "]:::det SGR["approved response / help pathway 0 LLM calls "]:::stop OOSR["approved boundary response 0 LLM calls "]:::stop CHATR["conversational contract ONE LLM CALL claims nothing "]:::model MT[" MULTI-TURN RESOLUTION only when context-dependent · changes the query, not her message "]:::det QP[" CONDITIONAL QUERY PREP factual / access, where a vocabulary gap was measured "]:::det BGE[" BGE-M3 RETRIEVAL governed SRH corpus local encoder · 1,693 chunks "]:::local TDL[" TRUSTED DATA LOOKUP verified services / contacts table read, never generated "]:::gated GEN[" GROUNDED GENERATION ONE LLM CALL every claim cited "]:::model DV[" DETERMINISTIC VALIDATION fabricated citation · invented number · claimed experience "]:::det end OUT[" HER REPLY "]:::her USER --> VAL --> LEXS --> DEC DEC ==>|"harm · coercion · self-h …