Finish Refuge->Fugee rebrand (DESIGN, mockup, scripts, SKILL)

.agents/skills/refuge/SKILL.md

@@ -1,15 +1,15 @@
 ---
-description: "Refuge — agentic asylum guidance assistant. Full project context and working conventions for Codex."
+description: "Fugee — agentic asylum guidance assistant. Full project context and working conventions for Codex."
 ---
 
-# Refuge — Codex Skill
+# Fugee — Codex Skill
 
-You are the primary coding agent for **Refuge**, a hackathon submission for
+You are the primary coding agent for **Fugee**, a hackathon submission for
 the Hugging Face Build Small Hackathon (June 5–15, 2026).
 
-## What Refuge does
+## What Fugee does
 
-Refuge guides displaced people, asylum seekers, and refugees through a
+Fugee guides displaced people, asylum seekers, and refugees through a
 5-phase agentic flow: language selection → structured interview → situation
 assessment (visible reasoning) → country recommendations → document package.
 

DESIGN.md

@@ -1,5 +1,5 @@
 ---
-name: Refuge
+name: Fugee
 description: A calm, trustworthy guide that helps displaced people understand their legal options, find safe destination countries, and prepare their documentation — the digital equivalent of a knowledgeable, compassionate case worker.
 
 colors:
@@ -66,13 +66,13 @@ components:
   document-item:    { bg: surface, border: "1px line", radius: md, pad: "13px 14px", icon: "38px primary-tint square", action: "38px download button" }
 ---
 
-# Refuge — Design System
+# Fugee — Design System
 
 ## 1. Overview
 
-Refuge is an agentic assistant for displaced people, asylum seekers, and refugees. The people who use it are often frightened, exhausted, and making decisions that affect their safety and their family's future. The design exists to lower that fear, not to impress.
+Fugee is an agentic assistant for displaced people, asylum seekers, and refugees. The people who use it are often frightened, exhausted, and making decisions that affect their safety and their family's future. The design exists to lower that fear, not to impress.
 
-**Brand personality.** Refuge behaves like a knowledgeable, compassionate case worker — patient, clear, never rushed, never alarmist. It is competent without being clinical, warm without being saccharine, serious without being bureaucratic.
+**Brand personality.** Fugee behaves like a knowledgeable, compassionate case worker — patient, clear, never rushed, never alarmist. It is competent without being clinical, warm without being saccharine, serious without being bureaucratic.
 
 **Emotional target.** The first feeling should be *relief*: "someone calm is going to help me, and I am in control here." Every screen should reduce cognitive load and reinforce safety, privacy, and agency.
 
@@ -86,7 +86,7 @@ Refuge is an agentic assistant for displaced people, asylum seekers, and refugee
 - Corporate/government blue, harsh pure white (`#FFF` as the page background), and clinical gray UI.
 - Startup tropes: neon gradients, glassmorphism, oversized rounded everything, emoji as decoration.
 - Chatbot-generic patterns: a lone text box, bouncing 3-dot avatars as the whole personality, dark mode "AI" aesthetics.
-- Anything that feels like a form to be failed. Refuge guides; it does not gate.
+- Anything that feels like a form to be failed. Fugee guides; it does not gate.
 
 ---
 
@@ -94,7 +94,7 @@ Refuge is an agentic assistant for displaced people, asylum seekers, and refugee
 
 Color carries meaning here; it is never decorative for its own sake.
 
-- **Primary — Deep teal-green `#0E6A58`.** The voice of Refuge. Used for the agent, primary structure (avatars, progress, the roadmap spine), and trust signals. Teal-green reads as safety, growth, and steadiness without the cold authority of corporate blue. `primary-deep #0A5042` is its shadow/pressed companion and the color for text sitting on a teal tint. `primary-tint #E5EFEA` is the agent's "breath" — agent message bubbles, hovers, and quiet surfaces.
+- **Primary — Deep teal-green `#0E6A58`.** The voice of Fugee. Used for the agent, primary structure (avatars, progress, the roadmap spine), and trust signals. Teal-green reads as safety, growth, and steadiness without the cold authority of corporate blue. `primary-deep #0A5042` is its shadow/pressed companion and the color for text sitting on a teal tint. `primary-tint #E5EFEA` is the agent's "breath" — agent message bubbles, hovers, and quiet surfaces.
 - **Secondary — `#2E7D6C`.** A lighter supporting teal used only in gradients (e.g. the assessment progress bar) and subtle accents. Never competes with primary for attention.
 - **Accent — Warm amber `#E07B39`.** The single call-to-action color and the color of *the person* (user message bubbles, their selections). Amber is human warmth and forward motion — a lantern, not an alarm. Reserve it for the one thing you want the person to do next, and for representing the user's own voice. `accent-deep #C26329` handles hover/pressed and the solid drop-shadow under primary buttons. `accent-tint #FBEDE1` fills user bubbles and gentle highlights.
 - **Background — `#F7F5F0`.** Warm off-white, like paper. It makes the whole product feel calmer and more human than stark white and reduces glare for tired eyes.
@@ -110,7 +110,7 @@ Color carries meaning here; it is never decorative for its own sake.
 
 Two families, each with a clear job.
 
-- **Fraunces (display serif)** — the app name, page/section headings, country names, and document titles. Its soft, slightly old-style character is what makes Refuge feel human and institutional-in-a-good-way rather than like an app. Use it at weight 600 for headings, with tight tracking on large sizes.
+- **Fraunces (display serif)** — the app name, page/section headings, country names, and document titles. Its soft, slightly old-style character is what makes Fugee feel human and institutional-in-a-good-way rather than like an app. Use it at weight 600 for headings, with tight tracking on large sizes.
 - **Inter (UI sans)** — everything else: body copy, messages, labels, buttons, data. Chosen for its calm, highly legible letterforms at small sizes and across many languages/scripts.
 
 **Hierarchy & when to use it.**
@@ -140,7 +140,7 @@ Two families, each with a clear job.
 
 ## 5. Elevation & Depth
 
-Depth is **minimal and meaningful**. Refuge is paper-like and flat by default; elevation is used only to lift a true surface (a screen, a menu) off the page, never for decoration.
+Depth is **minimal and meaningful**. Fugee is paper-like and flat by default; elevation is used only to lift a true surface (a screen, a menu) off the page, never for decoration.
 
 - `shadow-sm` — `0 1px 2px rgba(13,46,38,.06)`: avatars, small chips, subtle hover lift on files/cards.
 - `shadow-md` — `0 6px 20px rgba(13,46,38,.08)`: the main "screen" frames that hold each phase.
@@ -175,7 +175,7 @@ Roundness communicates softness and safety here, applied on a consistent scale.
 
 **Phase pill / progress rail (`phase-pill`).** A horizontal row of numbered 22px dots joined by short hairlines. *Done* = filled teal dot with a white check, secondary-color label. *Active* = filled amber dot with a 4px `accent-tint` halo and a bold, full-strength label. *Upcoming* = white dot, `line-strong` border, muted number. On mobile, hide the text and keep the dots. Order for the interview: Intake → Situation → History → Goals → Review.
 
-**Messages (`message-agent`, `message-user`).** Agent messages sit left with a 34px teal avatar bearing the white Refuge mark; bubble is `primary-tint` with a 5px-flattened bottom-left corner. User messages sit right with an amber avatar; bubble is `accent-tint` with a flattened bottom-right corner. The *current* agent question is a white bubble with a teal-tint border and `shadow-sm` so it stands out as "this is what we're answering now." A `thinking` indicator (three teal dots, gentle blink) plus a short reassuring phrase ("Refuge is listening") communicates streaming — never a spinner.
+**Messages (`message-agent`, `message-user`).** Agent messages sit left with a 34px teal avatar bearing the white Fugee mark; bubble is `primary-tint` with a 5px-flattened bottom-left corner. User messages sit right with an amber avatar; bubble is `accent-tint` with a flattened bottom-right corner. The *current* agent question is a white bubble with a teal-tint border and `shadow-sm` so it stands out as "this is what we're answering now." A `thinking` indicator (three teal dots, gentle blink) plus a short reassuring phrase ("Fugee is listening") communicates streaming — never a spinner.
 
 **Structured responder.** Below the current question, the answer control adapts to the question via a small segmented switch (Choice / Country / Free text):
 - *Multiple-choice pills* — round, single- or multi-select; selected pill fills teal with a leading check. Comfortable 44px tap height.
@@ -188,7 +188,7 @@ Roundness communicates softness and safety here, applied on a consistent scale.
 
 **Language pill (`language-pill`).** Round, white, hairline border; shows the language in its own script with a small romanized gloss. Selected = filled teal. Used in the intake grid; wraps freely.
 
-**Document item (`document-item`).** A row with a 38px `primary-tint` file-type icon, a bold title + muted meta line (format, pages, languages), and a 38px download button that fills teal on hover. **Checklist items** use a custom 22px checkbox that fills `success` with a white check when ticked; checked rows mute and strike their label. **Document preview** is a white, page-like card with a soft bottom fade; interview-derived values are highlighted with an `accent-tint` "fill" mark to show what Refuge pre-filled.
+**Document item (`document-item`).** A row with a 38px `primary-tint` file-type icon, a bold title + muted meta line (format, pages, languages), and a 38px download button that fills teal on hover. **Checklist items** use a custom 22px checkbox that fills `success` with a white check when ticked; checked rows mute and strike their label. **Document preview** is a white, page-like card with a soft bottom fade; interview-derived values are highlighted with an `accent-tint` "fill" mark to show what Fugee pre-filled.
 
 **Trust note.** A small rounded-full chip with a lock glyph reaffirming privacy. Quiet, persistent, never a modal.
 
@@ -198,7 +198,7 @@ Roundness communicates softness and safety here, applied on a consistent scale.
 
 **Do**
 - Keep one clear primary action (amber) per screen; everything else is secondary or ghost.
-- Use teal for *Refuge's* voice and structure, amber for *the person* and their next step.
+- Use teal for *Fugee's* voice and structure, amber for *the person* and their next step.
 - Show the agent's reasoning openly; prefer a written, progressive "document being thought through" over spinners.
 - Address the person as "you," in plain, respectful, reassuring language. Offer "Save and continue later" wherever the journey is long.
 - Let layouts breathe — honor the spacing scale and the 64px section rhythm.

data/scripts/enrich_downloader.py

@@ -54,7 +54,7 @@ log = logging.getLogger("enrich")
 
 HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "Refuge/1.0 (HuggingFace hackathon; humanitarian AI tool)",
+    "User-Agent": "Fugee/1.0 (HuggingFace hackathon; humanitarian AI tool)",
 }
 
 # ── Step 1: Build ISO3 → UNHCR code mapping ───────────────────────────────────

data/scripts/query_data.py

@@ -1,7 +1,7 @@
 """
 UNHCR Data Query Helper
 ========================
-Used internally by Refuge's country_lookup tool.
+Used internally by Fugee's country_lookup tool.
 Queries the local processed JSON files — no network required at runtime.
 
 This is the query layer between the agent tools and the downloaded data.
@@ -317,11 +317,11 @@ def get_footnotes(country_code: str) -> list[str]:
     ]
 
 
-# ── Composite: full country profile for Refuge ───────────────────────────────
+# ── Composite: full country profile for Fugee ───────────────────────────────
 
 @dataclass
 class CountryProfile:
-    """Everything Refuge needs about a potential asylum country for a given origin."""
+    """Everything Fugee needs about a potential asylum country for a given origin."""
     country: CountryInfo
     latest_acceptance_rate: Optional[AcceptanceRate]
     application_trend: list[dict]          # last 5 years of applications

data/scripts/refresh_data.py

@@ -77,7 +77,7 @@ def run_downloader(args: list[str]):
 
 
 def main():
-    parser = argparse.ArgumentParser(description="Refresh UNHCR data for Refuge.")
+    parser = argparse.ArgumentParser(description="Refresh UNHCR data for Fugee.")
     parser.add_argument("--full",     action="store_true", help="Re-download all endpoints")
     parser.add_argument("--nowcast",  action="store_true", help="Refresh nowcasting only")
     parser.add_argument("--check",    action="store_true", help="Check data freshness and exit")

data/scripts/unhcr_downloader.py

@@ -156,7 +156,7 @@ ENDPOINTS = {
         "paginated": True,
         "refresh_frequency": "annual",
         "refuge_use": (
-            "THE most important endpoint for Refuge. "
+            "THE most important endpoint for Fugee. "
             "Acceptance rates per origin × asylum country pair. "
             "Used in Phase 3 assessment to score country recommendations. "
             "E.g. 'Ethiopians in Kenya: 78% total protection rate (2023)'."
@@ -402,7 +402,7 @@ def download_endpoint(name: str, cfg: dict, year_from: int | None = None) -> dic
     clean_params = {key_map.get(k, k): v for k, v in params.items()}
 
     with httpx.Client(
-        headers={"Accept": "application/json", "User-Agent": "Refuge/1.0 (hackathon; contact via HF)"},
+        headers={"Accept": "application/json", "User-Agent": "Fugee/1.0 (hackathon; contact via HF)"},
         follow_redirects=True,
     ) as client:
         if cfg["paginated"]:
@@ -455,7 +455,7 @@ def update_manifest(summaries: list[dict]):
 
 def main():
     parser = argparse.ArgumentParser(
-        description="Download UNHCR Refugee Statistics API data for Refuge."
+        description="Download UNHCR Refugee Statistics API data for Fugee."
     )
     parser.add_argument("--all",       action="store_true", help="Download all endpoints")
     parser.add_argument("--refresh",   action="store_true", help="Re-download annual endpoints only")

mockup.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-<title>Refuge — Design Walkthrough</title>
+<title>Fugee — Design Walkthrough</title>
 <link rel="preconnect" href="https://fonts.googleapis.com" />
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
 <link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,400;9..144,500;9..144,600;9..144,700&family=Inter:wght@400;450;500;600;700&display=swap" rel="stylesheet" />
@@ -388,7 +388,7 @@
       <span class="brand__mark" aria-hidden="true">
         <svg width="30" height="30" viewBox="0 0 32 32" fill="none"><circle cx="16" cy="16" r="15" 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>
       </span>
-      <span class="brand__name">Refuge</span>
+      <span class="brand__name">Fugee</span>
       <span class="brand__tag">Design Walkthrough</span>
     </a>
     <nav class="nav" aria-label="Phases">
@@ -431,7 +431,7 @@
           <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>Refuge</h1>
+          <h1>Fugee</h1>
           <p class="intake__tagline">Safe guidance for people on the move</p>
 
           <p class="intake__lbl">Choose your language</p>
@@ -502,7 +502,7 @@
           <div class="msg__av" aria-hidden="true"><svg width="18" height="18" viewBox="0 0 32 32"><path d="M16 7l7 6.5V25h-4.6v-6.2h-4.8V25H9V13.5L16 7z" fill="#fff"/></svg></div>
           <div class="msg__bubble">I understand, and I'm sorry you've had to go through this. I want to be sure I understand your situation fully. <strong>What is the primary reason you had to leave your home?</strong></div>
         </div>
-        <div class="thinking" aria-live="polite"><span class="dots"><i></i><i></i><i></i></span> Refuge is listening</div>
+        <div class="thinking" aria-live="polite"><span class="dots"><i></i><i></i><i></i></span> Fugee is listening</div>
       </div>
 
       <!-- structured responder -->
@@ -544,7 +544,7 @@
 
         <!-- text -->
         <div class="mode" data-pane="text">
-          <textarea class="freetext" placeholder="Take your time. You can write in any language — Refuge will understand. Describe what happened in your own words.">In November, armed men came to our village. They were looking for people connected to the opposition. My husband was taken and we have not heard from him since.</textarea>
+          <textarea class="freetext" placeholder="Take your time. You can write in any language — Fugee will understand. Describe what happened in your own words.">In November, armed men came to our village. They were looking for people connected to the opposition. My husband was taken and we have not heard from him since.</textarea>
         </div>
 
         <div class="responder__foot">
@@ -629,7 +629,7 @@
               <summary><span class="caret">▸</span> What you need to prepare</summary>
               <ul>
                 <li>Any identity document from Ethiopia (or a sworn statement if none)</li>
-                <li>Written personal statement — Refuge drafts this for you</li>
+                <li>Written personal statement — Fugee drafts this for you</li>
                 <li>Names &amp; ages of children traveling with you</li>
                 <li>Any evidence of the threat (photos, messages, witness names)</li>
               </ul>
@@ -712,7 +712,7 @@
               <div class="step__num">2</div>
               <div class="step__body">
                 <h4>File your asylum claim</h4>
-                <p>Submit your personal statement and supporting evidence. Refuge has already drafted these for you.</p>
+                <p>Submit your personal statement and supporting evidence. Fugee has already drafted these for you.</p>
                 <div class="step__meta">
                   <span class="tag-s">RSD unit, Dept. of Refugee Services</span>
                   <span class="tag-s">⏱ Same week as registration</span>
@@ -772,7 +772,7 @@
           <p class="pkg__lbl">Preview · Personal statement</p>
           <article class="doc">
             <h4>Personal Statement</h4>
-            <p class="doc__sub">In support of an application for refugee status · Prepared with Refuge</p>
+            <p class="doc__sub">In support of an application for refugee status · Prepared with Fugee</p>
             <p>My name is <span class="fill">[full name]</span>. I am a national of <span class="fill">Ethiopia</span>, born in <span class="fill">[town]</span>. I am currently in <span class="fill">Gedaref, Sudan</span>, traveling with my <span class="fill">two children</span>.</p>
             <div class="doc__divider"></div>
             <p>I left my home because of <span class="fill">political and ethnic persecution</span>. In November, armed men came to our village searching for people connected to the opposition. My husband was taken and we have not heard from him since…</p>
@@ -792,7 +792,7 @@
             <label class="check">
               <input type="checkbox" checked />
               <span class="box"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><path d="M20 6L9 17l-5-5"/></svg></span>
-              <span class="check__txt">Personal statement <small>Drafted by Refuge · ready</small></span>
+              <span class="check__txt">Personal statement <small>Drafted by Fugee · ready</small></span>
             </label>
             <label class="check">
               <input type="checkbox" checked />
@@ -852,7 +852,7 @@
   </section>
 
   <div class="footer">
-    <span class="brand__name">Refuge</span> — Safe guidance for people on the move.<br />
+    <span class="brand__name">Fugee</span> — Safe guidance for people on the move.<br />
     Design walkthrough · all five phases · not a live application.
   </div>
 </main>

requirements.txt

@@ -1,4 +1,4 @@
-# Refuge — Python dependencies (pure-Python, no Node.js)
+# Fugee — Python dependencies (pure-Python, no Node.js)
 # Versions pinned to one release before the latest available on 2026-06-07.
 # Do not upgrade during a phase without explicit developer approval (ARCHITECTURE.md).