Spaces:

build-small-hackathon
/

fugee

Sleeping

helmo Codex commited on Jun 8

Commit

aefd221

1 Parent(s): 465999b

[brand+ux] Rebrand to Fugee, render markdown, branded detailed documents

- Rebrand Refuge -> Fugee across all user-facing text (wordmark, site bar, page
title, agent persona, document headers). Word-boundary replace so the legal
term "Refugee" is untouched. Repo/package name stays "refuge".
- app/mdlite.py: tiny Markdown->HTML (bold/italic/code, #headings, -/1. lists,
paragraphs). Assessment reasoning + chat bubbles now render markdown instead of
showing literal ** and #.
- Documents: branded masthead (Fugee mark + wordmark), Fraunces/Inter web fonts,
page footer + page numbers, nicer headings/steps/contacts styling — for both
the PDF and (wordmark header) the editable Word files.

58 fast tests pass; verified PDF carries the brand + footer and markdown renders.

Co-authored-by: Codex <noreply@openai.com>

Files changed (15) hide show

agent/drafting.py +1 -1
agent/tools/doc_generator.py +33 -10
agent/tools/templates/_head.html +32 -14
agent/tools/templates/action_plan.html +1 -1
agent/tools/templates/emergency_contacts.html +2 -2
agent/tools/templates/personal_statement.html +2 -2
agent/tools/templates/rights_summary_card.html +1 -1
app/app.py +3 -3
app/mdlite.py +71 -0
app/phases/assessment.py +12 -8
app/phases/documents.py +1 -1
app/phases/intake.py +2 -2
app/phases/interview.py +2 -6
app/phases/recommendations.py +2 -2
app/prompts/system.md +2 -2

agent/drafting.py CHANGED Viewed

@@ -12,7 +12,7 @@ from __future__ import annotations
 from agent.events import ErrorEvent, TextDeltaEvent
 from agent.loop import create_loop
-_SYSTEM = """You are Refuge, helping a person draft a first-person PERSONAL STATEMENT
 to support an asylum / refugee claim. Write with dignity, in plain, clear language,
 in {language}.

 from agent.events import ErrorEvent, TextDeltaEvent
 from agent.loop import create_loop
+_SYSTEM = """You are Fugee, helping a person draft a first-person PERSONAL STATEMENT
 to support an asylum / refugee claim. Write with dignity, in plain, clear language,
 in {language}.

agent/tools/doc_generator.py CHANGED Viewed

@@ -78,8 +78,31 @@ def _docx_add_rich(doc: Document, text: str):
                 run.font.color.rgb = _AMBER
 def _new_docx(title: str, subtitle: str) -> Document:
     doc = Document()
     h = doc.add_heading(title, level=0)
     try:
         h.runs[0].font.color.rgb = _TEAL
@@ -93,7 +116,7 @@ def _new_docx(title: str, subtitle: str) -> Document:
 def _pdf_from_html(body_html: str, path: Path):
-    HTML(string=f"<!DOCTYPE html><html><head>{_HEAD}</head><body>{body_html}</body></html>").write_pdf(str(path))
 # -- per-document content ---------------------------------------------------
@@ -101,7 +124,7 @@ def _pdf_from_html(body_html: str, path: Path):
 def _statement_body_html(text: str) -> str:
     return (
         "<h1>Personal Statement</h1>"
-        '<p class="sub">In support of an application for refugee status · Prepared with Refuge</p>'
         f"{_html_with_placeholders(text)}"
         '<p class="note">Fields in amber are placeholders for you to complete. You can edit any part '
         "of this statement in the Word (.docx) version.</p>"
@@ -150,7 +173,7 @@ def generate(session, statement: str | None = None, out_dir: Path | None = None)
     # 1. Personal statement (LLM-drafted) — PDF + DOCX
     ps_pdf, ps_docx = out_dir / "personal_statement.pdf", out_dir / "personal_statement.docx"
     _pdf_from_html(_statement_body_html(stmt), ps_pdf)
-    d = _new_docx("Personal Statement", "In support of an application for refugee status · Prepared with Refuge")
     _docx_add_rich(d, stmt)
     d.save(str(ps_docx))
     docs.append(GeneratedDoc("personal_statement", "Personal statement (editable)",
@@ -159,13 +182,13 @@ def generate(session, statement: str | None = None, out_dir: Path | None = None)
     # 2. Action plan
     country, intro, steps = _action_plan_blocks(session, rec)
     ap_html = (f"<h1>Action Plan — {html.escape(country)}</h1>"
-               '<p class="sub">Step-by-step roadmap · Prepared with Refuge</p>'
                f"<p>{html.escape(intro)}</p>" +
                "".join(f'<p class="step"><b>Step {i}.</b> {html.escape(str(s))}</p>'
                        for i, s in enumerate(steps, 1)))
     ap_pdf, ap_docx = out_dir / "action_plan.pdf", out_dir / "action_plan.docx"
     _pdf_from_html(ap_html, ap_pdf)
-    d = _new_docx(f"Action Plan — {country}", "Step-by-step roadmap · Prepared with Refuge")
     d.add_paragraph(intro)
     for i, s in enumerate(steps, 1):
         d.add_paragraph(f"Step {i}. {s}", style="List Number" if "List Number" in [s.name for s in d.styles] else None)
@@ -176,14 +199,14 @@ def generate(session, statement: str | None = None, out_dir: Path | None = None)
     office = (rec or {}).get("unhcrOffice") or "Nearest UNHCR office"
     orgs = _orgs(rec)
     ec_html = ("<h1>Emergency Contacts</h1>"
-               '<p class="sub">UNHCR offices &amp; legal aid · Prepared with Refuge</p>'
                f"<h2>{html.escape(country)}</h2><p>UNHCR office: {html.escape(office)}</p>"
                "<h2>Legal aid &amp; support</h2>" +
                ("".join(f'<div class="org"><b>{html.escape(n)}</b><span>{html.escape(u)}</span></div>' for n, u in orgs)
                 or "<p>Ask the UNHCR office for registered legal-aid partners.</p>"))
     ec_pdf, ec_docx = out_dir / "emergency_contacts.pdf", out_dir / "emergency_contacts.docx"
     _pdf_from_html(ec_html, ec_pdf)
-    d = _new_docx("Emergency Contacts", "UNHCR offices & legal aid · Prepared with Refuge")
     d.add_paragraph(f"{country} — UNHCR office: {office}")
     for n, u in orgs:
         d.add_paragraph(f"{n} — {u}")
@@ -193,7 +216,7 @@ def generate(session, statement: str | None = None, out_dir: Path | None = None)
     # 4. Rights summary card
     grounds = ", ".join(session.assessment.convention_grounds) if session.assessment.convention_grounds else "to be confirmed"
     rc_html = ("<h1>Your Rights — Summary Card</h1>"
-               '<p class="sub">Key protections · Prepared with Refuge</p>'
                "<h2>Non-refoulement</h2><p>You cannot be forced back to a country where your life or freedom "
                "would be at serious risk (1951 Refugee Convention).</p>"
                "<h2>While your claim is decided</h2><ul>"
@@ -205,7 +228,7 @@ def generate(session, statement: str | None = None, out_dir: Path | None = None)
                f"Seeking protection in: {html.escape(country)} · Grounds: {html.escape(grounds)}</p>")
     rc_pdf, rc_docx = out_dir / "rights_summary_card.pdf", out_dir / "rights_summary_card.docx"
     _pdf_from_html(rc_html, rc_pdf)
-    d = _new_docx("Your Rights — Summary Card", "Key protections · Prepared with Refuge")
     d.add_paragraph("Non-refoulement: you cannot be forced back to a country where your life or freedom "
                     "would be at serious risk (1951 Refugee Convention).")
     for r in ["The right to seek asylum and a fair hearing.",
@@ -241,7 +264,7 @@ def preview_statement_html(session, statement: str | None = None) -> str:
     """Head-less personal-statement snippet for the on-screen preview."""
     stmt = statement or fallback_statement(session)
     return ('<article class="doc"><h4>Personal Statement</h4>'
-            '<p class="doc__sub">In support of an application for refugee status · Prepared with Refuge</p>'
             f"{_html_with_placeholders(stmt)}</article>")

                 run.font.color.rgb = _AMBER
+# Branded masthead (the Fugee mark + wordmark) shown atop every PDF.
+_LOGO_SVG = (
+    '<svg class="logo" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">'
+    '<circle cx="16" cy="16" r="15.5" fill="#0E6A58"/>'
+    '<path d="M16 7l7 6.5V25h-4.6v-6.2h-4.8V25H9V13.5L16 7z" fill="#fff"/>'
+    '<circle cx="16" cy="13.6" r="1.7" fill="#E07B39"/></svg>'
+)
+_BRAND = (
+    f'<div class="brand">{_LOGO_SVG}<span class="name">Fugee</span>'
+    '<span class="tag">Safe guidance for people on the move</span></div>'
+)
 def _new_docx(title: str, subtitle: str) -> Document:
     doc = Document()
+    # Branded wordmark + rule (a logo image would need a raster asset; the
+    # wordmark keeps the package self-contained).
+    brand = doc.add_paragraph()
+    run = brand.add_run("Fugee")
+    run.bold = True
+    run.font.size = Pt(20)
+    run.font.color.rgb = _TEAL
+    tag = brand.add_run("   Safe guidance for people on the move")
+    tag.font.size = Pt(9)
+    tag.font.color.rgb = RGBColor(0x6B, 0x72, 0x80)
     h = doc.add_heading(title, level=0)
     try:
         h.runs[0].font.color.rgb = _TEAL
 def _pdf_from_html(body_html: str, path: Path):
+    HTML(string=f"<!DOCTYPE html><html><head>{_HEAD}</head><body>{_BRAND}{body_html}</body></html>").write_pdf(str(path))
 # -- per-document content ---------------------------------------------------
 def _statement_body_html(text: str) -> str:
     return (
         "<h1>Personal Statement</h1>"
+        '<p class="sub">In support of an application for refugee status · Prepared with Fugee</p>'
         f"{_html_with_placeholders(text)}"
         '<p class="note">Fields in amber are placeholders for you to complete. You can edit any part '
         "of this statement in the Word (.docx) version.</p>"
     # 1. Personal statement (LLM-drafted) — PDF + DOCX
     ps_pdf, ps_docx = out_dir / "personal_statement.pdf", out_dir / "personal_statement.docx"
     _pdf_from_html(_statement_body_html(stmt), ps_pdf)
+    d = _new_docx("Personal Statement", "In support of an application for refugee status · Prepared with Fugee")
     _docx_add_rich(d, stmt)
     d.save(str(ps_docx))
     docs.append(GeneratedDoc("personal_statement", "Personal statement (editable)",
     # 2. Action plan
     country, intro, steps = _action_plan_blocks(session, rec)
     ap_html = (f"<h1>Action Plan — {html.escape(country)}</h1>"
+               '<p class="sub">Step-by-step roadmap · Prepared with Fugee</p>'
                f"<p>{html.escape(intro)}</p>" +
                "".join(f'<p class="step"><b>Step {i}.</b> {html.escape(str(s))}</p>'
                        for i, s in enumerate(steps, 1)))
     ap_pdf, ap_docx = out_dir / "action_plan.pdf", out_dir / "action_plan.docx"
     _pdf_from_html(ap_html, ap_pdf)
+    d = _new_docx(f"Action Plan — {country}", "Step-by-step roadmap · Prepared with Fugee")
     d.add_paragraph(intro)
     for i, s in enumerate(steps, 1):
         d.add_paragraph(f"Step {i}. {s}", style="List Number" if "List Number" in [s.name for s in d.styles] else None)
     office = (rec or {}).get("unhcrOffice") or "Nearest UNHCR office"
     orgs = _orgs(rec)
     ec_html = ("<h1>Emergency Contacts</h1>"
+               '<p class="sub">UNHCR offices &amp; legal aid · Prepared with Fugee</p>'
                f"<h2>{html.escape(country)}</h2><p>UNHCR office: {html.escape(office)}</p>"
                "<h2>Legal aid &amp; support</h2>" +
                ("".join(f'<div class="org"><b>{html.escape(n)}</b><span>{html.escape(u)}</span></div>' for n, u in orgs)
                 or "<p>Ask the UNHCR office for registered legal-aid partners.</p>"))
     ec_pdf, ec_docx = out_dir / "emergency_contacts.pdf", out_dir / "emergency_contacts.docx"
     _pdf_from_html(ec_html, ec_pdf)
+    d = _new_docx("Emergency Contacts", "UNHCR offices & legal aid · Prepared with Fugee")
     d.add_paragraph(f"{country} — UNHCR office: {office}")
     for n, u in orgs:
         d.add_paragraph(f"{n} — {u}")
     # 4. Rights summary card
     grounds = ", ".join(session.assessment.convention_grounds) if session.assessment.convention_grounds else "to be confirmed"
     rc_html = ("<h1>Your Rights — Summary Card</h1>"
+               '<p class="sub">Key protections · Prepared with Fugee</p>'
                "<h2>Non-refoulement</h2><p>You cannot be forced back to a country where your life or freedom "
                "would be at serious risk (1951 Refugee Convention).</p>"
                "<h2>While your claim is decided</h2><ul>"
                f"Seeking protection in: {html.escape(country)} · Grounds: {html.escape(grounds)}</p>")
     rc_pdf, rc_docx = out_dir / "rights_summary_card.pdf", out_dir / "rights_summary_card.docx"
     _pdf_from_html(rc_html, rc_pdf)
+    d = _new_docx("Your Rights — Summary Card", "Key protections · Prepared with Fugee")
     d.add_paragraph("Non-refoulement: you cannot be forced back to a country where your life or freedom "
                     "would be at serious risk (1951 Refugee Convention).")
     for r in ["The right to seek asylum and a fair hearing.",
     """Head-less personal-statement snippet for the on-screen preview."""
     stmt = statement or fallback_statement(session)
     return ('<article class="doc"><h4>Personal Statement</h4>'
+            '<p class="doc__sub">In support of an application for refugee status · Prepared with Fugee</p>'
             f"{_html_with_placeholders(stmt)}</article>")

agent/tools/templates/_head.html CHANGED Viewed

@@ -1,30 +1,48 @@
 <meta charset="utf-8" />
 <style>
-  @page { size: A4; margin: 22mm 20mm; }
   :root {
-    --primary: #0E6A58; --primary-deep: #0A5042; --accent-tint: #FBEDE1;
-    --text: #1A1A1A; --muted: #6B7280; --line: #E7E2D8;
   }
   * { box-sizing: border-box; }
   body { font-family: "Inter", "Helvetica Neue", Arial, sans-serif; color: var(--text);
-    font-size: 12pt; line-height: 1.6; }
   h1, h2, h3, h4 { font-family: "Fraunces", Georgia, "Times New Roman", serif; color: var(--primary-deep);
     margin: 0 0 4px; line-height: 1.2; }
-  h1 { font-size: 22pt; }
-  h2 { font-size: 15pt; margin-top: 18px; }
-  .sub { color: var(--muted); font-size: 10pt; margin: 0 0 16px; letter-spacing: .02em; }
   p { margin: 0 0 11px; }
   .fill { background: var(--accent-tint); color: #7a431a; padding: 0 4px; border-radius: 3px; font-weight: 600; }
-  .blank { display: inline-block; min-width: 120px; border-bottom: 1px solid #999; }
-  .divider { height: 1px; background: var(--line); margin: 14px 0; }
-  .note { color: var(--muted); font-size: 9.5pt; margin-top: 20px; border-top: 1px solid var(--line); padding-top: 8px; }
   ul, ol { margin: 0 0 11px; padding-left: 20px; }
   li { margin-bottom: 6px; }
-  .step { margin-bottom: 12px; }
   .step b { color: var(--primary-deep); }
-  .chip { display: inline-block; background: #E5EFEA; color: var(--primary-deep); font-size: 9.5pt;
-    padding: 2px 8px; border-radius: 999px; margin-right: 4px; }
   .org { margin-bottom: 8px; }
-  .org b { display: block; }
   .org span { color: var(--muted); font-size: 10pt; }
 </style>

 <meta charset="utf-8" />
 <style>
+  @import url('https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,500;9..144,600;9..144,700&family=Inter:wght@400;500;600;700&display=swap');
+  @page {
+    size: A4; margin: 24mm 20mm 20mm;
+    @bottom-center {
+      content: "Prepared with Fugee · Safe guidance for people on the move";
+      font-family: "Inter", sans-serif; font-size: 8pt; color: #9aa0ab;
+    }
+    @bottom-right { content: "Page " counter(page) " of " counter(pages);
+      font-family: "Inter", sans-serif; font-size: 8pt; color: #9aa0ab; }
+  }
   :root {
+    --primary: #0E6A58; --primary-deep: #0A5042; --accent: #E07B39; --accent-tint: #FBEDE1;
+    --text: #1A1A1A; --muted: #6B7280; --line: #E7E2D8; --tint: #E5EFEA;
   }
   * { box-sizing: border-box; }
   body { font-family: "Inter", "Helvetica Neue", Arial, sans-serif; color: var(--text);
+    font-size: 11.5pt; line-height: 1.65; }
+  /* Branded masthead */
+  .brand { display: flex; align-items: center; gap: 10px; padding-bottom: 12px;
+    border-bottom: 2px solid var(--primary); margin-bottom: 22px; }
+  .brand .logo { width: 30px; height: 30px; flex: 0 0 auto; }
+  .brand .name { font-family: "Fraunces", Georgia, serif; font-weight: 700; font-size: 19pt;
+    color: var(--primary-deep); letter-spacing: -.01em; }
+  .brand .tag { margin-left: auto; font-size: 8.5pt; letter-spacing: .12em; text-transform: uppercase; color: var(--muted); }
   h1, h2, h3, h4 { font-family: "Fraunces", Georgia, "Times New Roman", serif; color: var(--primary-deep);
     margin: 0 0 4px; line-height: 1.2; }
+  h1 { font-size: 23pt; }
+  h2 { font-size: 14pt; margin-top: 20px; padding-bottom: 3px; border-bottom: 1px solid var(--line); }
+  .sub { color: var(--muted); font-size: 10pt; margin: 0 0 18px; letter-spacing: .02em; }
   p { margin: 0 0 11px; }
   .fill { background: var(--accent-tint); color: #7a431a; padding: 0 4px; border-radius: 3px; font-weight: 600; }
+  .blank { display: inline-block; min-width: 130px; border-bottom: 1px solid #999; }
+  .divider { height: 1px; background: var(--line); margin: 16px 0; }
+  .note { color: var(--muted); font-size: 9.5pt; margin-top: 22px; border-top: 1px solid var(--line); padding-top: 8px; }
   ul, ol { margin: 0 0 11px; padding-left: 20px; }
   li { margin-bottom: 6px; }
+  .step { margin-bottom: 14px; padding-left: 14px; border-left: 3px solid var(--tint); }
   .step b { color: var(--primary-deep); }
+  .chip { display: inline-block; background: var(--tint); color: var(--primary-deep); font-size: 9.5pt;
+    padding: 2px 9px; border-radius: 999px; margin-right: 4px; }
   .org { margin-bottom: 8px; }
+  .org b { display: block; color: var(--primary-deep); }
   .org span { color: var(--muted); font-size: 10pt; }
 </style>

agent/tools/templates/action_plan.html CHANGED Viewed

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Action Plan — %%selected_country%%</h1>
-  <p class="sub">A step-by-step roadmap to seek asylum · Prepared with Refuge</p>
   <p>This plan is for seeking protection in %%selected_country%%. Processing typically
   takes %%processing%%. UNHCR presence: %%unhcr_office%%.</p>

 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Action Plan — %%selected_country%%</h1>
+  <p class="sub">A step-by-step roadmap to seek asylum · Prepared with Fugee</p>
   <p>This plan is for seeking protection in %%selected_country%%. Processing typically
   takes %%processing%%. UNHCR presence: %%unhcr_office%%.</p>

agent/tools/templates/emergency_contacts.html CHANGED Viewed

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Emergency Contacts</h1>
-  <p class="sub">UNHCR offices &amp; legal aid · Prepared with Refuge</p>
   <h2>%%selected_country%%</h2>
   <p>UNHCR office: %%unhcr_office%%</p>
@@ -17,6 +17,6 @@
     <li>You have the right to request a translator and free legal assistance.</li>
   </ul>
-  <p class="note">Contacts are drawn from the curated Refuge country reference.
   Verify details locally where possible.</p>
 </body></html>

 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Emergency Contacts</h1>
+  <p class="sub">UNHCR offices &amp; legal aid · Prepared with Fugee</p>
   <h2>%%selected_country%%</h2>
   <p>UNHCR office: %%unhcr_office%%</p>
     <li>You have the right to request a translator and free legal assistance.</li>
   </ul>
+  <p class="note">Contacts are drawn from the curated Fugee country reference.
   Verify details locally where possible.</p>
 </body></html>

agent/tools/templates/personal_statement.html CHANGED Viewed

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Personal Statement</h1>
-  <p class="sub">In support of an application for refugee status · Prepared with Refuge</p>
   <p>My name is %%full_name%%. I am a national of %%origin_country%%. I am currently
   in %%current_country%%%%family_clause%%.</p>
@@ -16,6 +16,6 @@
   circumstances described above. I am asking for protection and the right not to be
   returned to a place where my life or freedom would be threatened.</p>
-  <p class="note">Fields highlighted in amber were pre-filled from what you told Refuge.
   Anything left blank is for you to complete. You can edit any part of this statement.</p>
 </body></html>

 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Personal Statement</h1>
+  <p class="sub">In support of an application for refugee status · Prepared with Fugee</p>
   <p>My name is %%full_name%%. I am a national of %%origin_country%%. I am currently
   in %%current_country%%%%family_clause%%.</p>
   circumstances described above. I am asking for protection and the right not to be
   returned to a place where my life or freedom would be threatened.</p>
+  <p class="note">Fields highlighted in amber were pre-filled from what you told Fugee.
   Anything left blank is for you to complete. You can edit any part of this statement.</p>
 </body></html>

agent/tools/templates/rights_summary_card.html CHANGED Viewed

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Your Rights — Summary Card</h1>
-  <p class="sub">Key protections for people seeking asylum · Prepared with Refuge</p>
   <h2>Non-refoulement</h2>
   <p>You cannot be forced back to a country where your life or freedom would be at

 <!DOCTYPE html>
 <html lang="en"><head>%%HEAD%%</head><body>
   <h1>Your Rights — Summary Card</h1>
+  <p class="sub">Key protections for people seeking asylum · Prepared with Fugee</p>
   <h2>Non-refoulement</h2>
   <p>You cannot be forced back to a country where your life or freedom would be at

app/app.py CHANGED Viewed

@@ -1,4 +1,4 @@
-"""app/app.py — Refuge Gradio entrypoint.
 Run locally with::
@@ -110,7 +110,7 @@ _LOGO_SVG = (
 SITE_BAR_HTML = f"""
 <header id="site-bar"><div class="inner">
   {_LOGO_SVG}
-  <span class="name">Refuge</span>
   <span class="tag">Safe guidance for people on the move</span>
   <nav class="nav"><span>Intake</span><span>Interview</span><span>Assessment</span>
     <span>Recommendations</span><span>Documents</span></nav>
@@ -133,7 +133,7 @@ def _ready_for_assessment(session) -> bool:
 def build_app() -> gr.Blocks:
-    with gr.Blocks(title="Refuge", analytics_enabled=False) as demo:
         gr.HTML(SITE_BAR_HTML)
         # Session + loop state shared across phases so each screen sees the same
         # session object.

+"""app/app.py — Fugee Gradio entrypoint.
 Run locally with::
 SITE_BAR_HTML = f"""
 <header id="site-bar"><div class="inner">
   {_LOGO_SVG}
+  <span class="name">Fugee</span>
   <span class="tag">Safe guidance for people on the move</span>
   <nav class="nav"><span>Intake</span><span>Interview</span><span>Assessment</span>
     <span>Recommendations</span><span>Documents</span></nav>
 def build_app() -> gr.Blocks:
+    with gr.Blocks(title="Fugee", analytics_enabled=False) as demo:
         gr.HTML(SITE_BAR_HTML)
         # Session + loop state shared across phases so each screen sees the same
         # session object.

app/mdlite.py ADDED Viewed

	@@ -0,0 +1,71 @@

+"""app/mdlite.py — tiny, dependency-free Markdown → HTML for streamed model text.
+Handles what small models actually emit: **bold**, *italic*, `code`, # headings,
+- / * bullet lists, 1. numbered lists, and blank-line paragraphs. Everything is
+HTML-escaped first, so it is safe to render model output.
+"""
+from __future__ import annotations
+import html
+import re
+_BOLD = re.compile(r"\*\*(.+?)\*\*")
+_ITALIC = re.compile(r"(?<!\*)\*(?!\s)(.+?)(?<!\s)\*(?!\*)")
+_CODE = re.compile(r"`([^`]+)`")
+_H = re.compile(r"^(#{1,6})\s+(.*)$")
+_UL = re.compile(r"^\s*[-*]\s+(.*)$")
+_OL = re.compile(r"^\s*\d+[.)]\s+(.*)$")
+def inline(text: str) -> str:
+    s = html.escape(text)
+    s = _BOLD.sub(r"<strong>\1</strong>", s)
+    s = _ITALIC.sub(r"<em>\1</em>", s)
+    s = _CODE.sub(r"<code>\1</code>", s)
+    return s
+def md_to_html(text: str) -> str:
+    text = (text or "").strip()
+    if not text:
+        return ""
+    lines = text.split("\n")
+    out: list[str] = []
+    i = 0
+    while i < len(lines):
+        line = lines[i].rstrip()
+        if not line.strip():
+            i += 1
+            continue
+        h = _H.match(line)
+        if h:
+            out.append(f"<h4>{inline(h.group(2))}</h4>")
+            i += 1
+            continue
+        if _UL.match(line):
+            items = []
+            while i < len(lines) and _UL.match(lines[i]):
+                items.append(f"<li>{inline(_UL.match(lines[i]).group(1))}</li>")
+                i += 1
+            out.append("<ul>" + "".join(items) + "</ul>")
+            continue
+        if _OL.match(line):
+            items = []
+            while i < len(lines) and _OL.match(lines[i]):
+                items.append(f"<li>{inline(_OL.match(lines[i]).group(1))}</li>")
+                i += 1
+            out.append("<ol>" + "".join(items) + "</ol>")
+            continue
+        para = [line]
+        i += 1
+        while i < len(lines) and lines[i].strip() and not (
+            _H.match(lines[i]) or _UL.match(lines[i]) or _OL.match(lines[i])
+        ):
+            para.append(lines[i].rstrip())
+            i += 1
+        out.append("<p>" + inline(" ".join(para)) + "</p>")
+    return "\n".join(out)
+__all__ = ["md_to_html", "inline"]

app/phases/assessment.py CHANGED Viewed

@@ -21,6 +21,7 @@ from agent.tools.asylum_stats import asylum_stats_tool
 from agent.tools.country_lookup import country_lookup_tool, lookup_country
 from agent.tools.guideline_search import guideline_search_tool
 from app.assessment_parse import parse_assessment
 from app.phases.interview import advance_to
 from app.prompt_loader import compose
 from app.state.session import SessionState, State
@@ -68,10 +69,15 @@ ASSESSMENT_CSS = """
   background:linear-gradient(90deg,var(--primary),var(--secondary)); transition:width .6s cubic-bezier(.4,0,.1,1); }
 .assess .tool-chip { display:inline-flex; align-items:center; gap:7px; margin-top:10px; font-size:12.5px;
   font-weight:600; color:var(--primary-deep); background:var(--primary-tint); padding:5px 11px; border-radius:var(--r-full); }
-.reason-doc { font-size:14.5px; line-height:1.75; color:var(--text-secondary); }
-.reason-doc .ln { display:block; margin-bottom:10px; padding-left:18px; position:relative; }
-.reason-doc .ln::before { content:""; position:absolute; left:0; top:9px; width:7px; height:7px; border-radius:50%; background:var(--primary); opacity:.5; }
-.reason-doc .ln strong { color:var(--text); font-weight:600; }
 #assess-proceed-row { padding:18px clamp(18px,4vw,28px); border-top:1px solid var(--line); justify-content:flex-end; }
 #assess-proceed, #assess-proceed button { background:var(--accent) !important; color:var(--on-accent) !important;
   box-shadow:0 2px 0 var(--accent-deep) !important; border:0 !important; font-weight:600 !important;
@@ -113,10 +119,8 @@ def render_facts(session: SessionState) -> str:
 def render_reason(text: str) -> str:
     visible, _ = parse_assessment(text)
     if not visible.strip():
-        visible = "Beginning your assessment…"
-    paras = [p.strip() for p in visible.split("\n") if p.strip()]
-    lns = "".join(f'<span class="ln">{html.escape(p)}</span>' for p in paras)
-    return f'<div class="reason-doc">{lns}</div>'
 def render_progress(pct: int, status: str = "") -> str:

 from agent.tools.country_lookup import country_lookup_tool, lookup_country
 from agent.tools.guideline_search import guideline_search_tool
 from app.assessment_parse import parse_assessment
+from app.mdlite import md_to_html
 from app.phases.interview import advance_to
 from app.prompt_loader import compose
 from app.state.session import SessionState, State
   background:linear-gradient(90deg,var(--primary),var(--secondary)); transition:width .6s cubic-bezier(.4,0,.1,1); }
 .assess .tool-chip { display:inline-flex; align-items:center; gap:7px; margin-top:10px; font-size:12.5px;
   font-weight:600; color:var(--primary-deep); background:var(--primary-tint); padding:5px 11px; border-radius:var(--r-full); }
+.reason-doc { font-size:14.5px; line-height:1.7; color:var(--text-secondary); }
+.reason-doc p { margin:0 0 12px; }
+.reason-doc h4 { font-family:var(--font-ui); font-size:14px; font-weight:700; color:var(--text);
+  margin:18px 0 8px; letter-spacing:.01em; }
+.reason-doc strong { color:var(--text); font-weight:600; }
+.reason-doc em { font-style:italic; }
+.reason-doc ul, .reason-doc ol { margin:0 0 12px; padding-left:20px; }
+.reason-doc li { margin-bottom:6px; }
+.reason-doc code { background:var(--primary-tint); padding:1px 5px; border-radius:4px; font-size:13px; }
 #assess-proceed-row { padding:18px clamp(18px,4vw,28px); border-top:1px solid var(--line); justify-content:flex-end; }
 #assess-proceed, #assess-proceed button { background:var(--accent) !important; color:var(--on-accent) !important;
   box-shadow:0 2px 0 var(--accent-deep) !important; border:0 !important; font-weight:600 !important;
 def render_reason(text: str) -> str:
     visible, _ = parse_assessment(text)
     if not visible.strip():
+        return '<div class="reason-doc"><p>Beginning your assessment…</p></div>'
+    return f'<div class="reason-doc">{md_to_html(visible)}</div>'
 def render_progress(pct: int, status: str = "") -> str:

app/phases/documents.py CHANGED Viewed

@@ -19,7 +19,7 @@ from app.state.session import SessionState
 # Evidence checklist: (label, sublabel, document_available key or None).
 CHECKLIST = [
-    ("Personal statement", "Drafted by Refuge · ready", "_always"),
     ("Identity document or sworn statement", "Passport, national ID, or a sworn statement", "passport"),
     ("Proof of journey / entry", "Tickets, stamps, or a written account", "travel"),
     ("Photos or messages showing the threat", "Optional, but strengthens your claim", "evidence"),

 # Evidence checklist: (label, sublabel, document_available key or None).
 CHECKLIST = [
+    ("Personal statement", "Drafted by Fugee · ready", "_always"),
     ("Identity document or sworn statement", "Passport, national ID, or a sworn statement", "passport"),
     ("Proof of journey / entry", "Tickets, stamps, or a written account", "travel"),
     ("Photos or messages showing the threat", "Optional, but strengthens your claim", "evidence"),

app/phases/intake.py CHANGED Viewed

@@ -1,6 +1,6 @@
 """app/phases/intake.py — Phase 1 intake + language selection (T030-T032).
-Matches mockup.html #phase-1: a calm welcome with the Refuge wordmark, a
 topographic backdrop, a grid of language pills each in its own script, an amber
 "Begin in <language>" primary action, and a persistent privacy trust note.
@@ -100,7 +100,7 @@ _HEADER_HTML = f"""
     <div class="intake-logo" aria-hidden="true">
       <svg width="64" height="64" viewBox="0 0 32 32" fill="none"><circle cx="16" cy="16" r="15.5" fill="#0E6A58"/><circle cx="16" cy="16" r="15.5" stroke="#0A5042"/><path d="M16 7l7 6.5V25h-4.6v-6.2h-4.8V25H9V13.5L16 7z" fill="#fff"/><circle cx="16" cy="13.6" r="1.7" fill="#E07B39"/></svg>
     </div>
-    <h1 class="intake-h1">Refuge</h1>
     <p class="intake-tagline">Safe guidance for people on the move</p>
     <p class="intake-lbl">Choose your language</p>
   </div>

 """app/phases/intake.py — Phase 1 intake + language selection (T030-T032).
+Matches mockup.html #phase-1: a calm welcome with the Fugee wordmark, a
 topographic backdrop, a grid of language pills each in its own script, an amber
 "Begin in <language>" primary action, and a persistent privacy trust note.
     <div class="intake-logo" aria-hidden="true">
       <svg width="64" height="64" viewBox="0 0 32 32" fill="none"><circle cx="16" cy="16" r="15.5" fill="#0E6A58"/><circle cx="16" cy="16" r="15.5" stroke="#0A5042"/><path d="M16 7l7 6.5V25h-4.6v-6.2h-4.8V25H9V13.5L16 7z" fill="#fff"/><circle cx="16" cy="13.6" r="1.7" fill="#E07B39"/></svg>
     </div>
+    <h1 class="intake-h1">Fugee</h1>
     <p class="intake-tagline">Safe guidance for people on the move</p>
     <p class="intake-lbl">Choose your language</p>
   </div>

app/phases/interview.py CHANGED Viewed

@@ -17,6 +17,7 @@ import gradio as gr
 from agent.events import TextDeltaEvent
 from agent.loop import create_loop
 from app.countries import country_choices, country_name
 from app.prompt_loader import load_prompt
 from app.interview_script import (
@@ -102,13 +103,8 @@ def render_rail(state: State) -> str:
     return f'<div class="iv-rail" aria-label="Interview progress">{"".join(pills)}</div>'
-def _bold(escaped: str) -> str:
-    """Render **markdown bold** (used for review summary labels)."""
-    return re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", escaped)
 def _bubble(role: str, text: str, current: bool = False) -> str:
-    safe = _bold(html.escape(text)).replace("\n", "<br>")
     if role == "user":
         return ('<div class="iv-msg iv-msg--user"><div class="iv-msg__av"><span>You</span></div>'
                 f'<div class="iv-msg__bubble">{safe}</div></div>')

 from agent.events import TextDeltaEvent
 from agent.loop import create_loop
+from app import mdlite
 from app.countries import country_choices, country_name
 from app.prompt_loader import load_prompt
 from app.interview_script import (
     return f'<div class="iv-rail" aria-label="Interview progress">{"".join(pills)}</div>'
 def _bubble(role: str, text: str, current: bool = False) -> str:
+    safe = mdlite.inline(text).replace("\n", "<br>")
     if role == "user":
         return ('<div class="iv-msg iv-msg--user"><div class="iv-msg__av"><span>You</span></div>'
                 f'<div class="iv-msg__bubble">{safe}</div></div>')

app/phases/recommendations.py CHANGED Viewed

@@ -133,7 +133,7 @@ def card_body_html(rec: dict) -> str:
     )
     docs = rec.get("requiredDocuments") or []
     prep_items = "".join(f"<li>{html.escape(str(d))}</li>" for d in docs) or \
-        "<li>Refuge will help you gather what you need.</li>"
     return (
         '<div class="ccard__top">'
         f'<span class="ccard__flag">{flag}</span>'
@@ -170,7 +170,7 @@ def roadmap_html(rec: dict | None) -> str:
          "protects you from being returned.",
          unhcr_contact, "1–4 weeks for appointment"),
         ("File your asylum claim",
-         "Submit your personal statement and supporting evidence. Refuge has "
          "already drafted these for you.",
          "Asylum authority / RSD unit", "Same week as registration"),
         ("Refugee status interview (RSD)",

     )
     docs = rec.get("requiredDocuments") or []
     prep_items = "".join(f"<li>{html.escape(str(d))}</li>" for d in docs) or \
+        "<li>Fugee will help you gather what you need.</li>"
     return (
         '<div class="ccard__top">'
         f'<span class="ccard__flag">{flag}</span>'
          "protects you from being returned.",
          unhcr_contact, "1–4 weeks for appointment"),
         ("File your asylum claim",
+         "Submit your personal statement and supporting evidence. Fugee has "
          "already drafted these for you.",
          "Asylum authority / RSD unit", "Same week as registration"),
         ("Refugee status interview (RSD)",

app/prompts/system.md CHANGED Viewed

@@ -1,4 +1,4 @@
-You are **Refuge**, a calm, knowledgeable, and compassionate guide for people
 who have been forced to leave their homes — displaced people, asylum seekers,
 and refugees. You behave like a trusted, experienced case worker: patient,
 clear, never rushed, never alarmist. Your purpose is to lower fear and give the
@@ -6,7 +6,7 @@ person back a sense of control over their situation.
 ## Who you are talking to
-The person using Refuge may be frightened, exhausted, and making decisions that
 affect their safety and their family's future. They may be reading in a second
 or third language, on a phone, under stress. Treat every message as if it comes
 from someone who deserves dignity, patience, and honesty.

+You are **Fugee**, a calm, knowledgeable, and compassionate guide for people
 who have been forced to leave their homes — displaced people, asylum seekers,
 and refugees. You behave like a trusted, experienced case worker: patient,
 clear, never rushed, never alarmist. Your purpose is to lower fear and give the
 ## Who you are talking to
+The person using Fugee may be frightened, exhausted, and making decisions that
 affect their safety and their family's future. They may be reading in a second
 or third language, on a phone, under stress. Treat every message as if it comes
 from someone who deserves dignity, patience, and honesty.