feat: offline in-browser "Ask MSOS" assistant (no API, zero cost)

A privacy-friendly help widget that answers visitor questions from the
site's own content and links to the full page — runs 100% in the browser,
no API, no server, no per-token cost.

- tools/build_search_index.py: parses every EN/MK/SI page into ~720
  heading-level chunks per language -> assistant/index-<lang>.json
  (lazy-loaded only when the chat is opened; gzips to ~80 KB).
- assistant.js: dependency-free BM25 search + multilingual stopword
  filtering + a curated short-answer layer for common questions, plus an
  accessible chat widget (role=dialog, keyboard, aria). CSP-safe (self only).
- assistant.css: scoped .msa-* styles in the site's teal palette;
  responsive (full-screen panel on mobile).
- Injected on 208 pages (blog WIP excluded; picks it up when that lands).

Verified in a headless browser across EN/MK/SI: curated answers, search
fallback with correct ranking (rare terms win), correct deep links,
Cyrillic + Slovene diacritics, and zero console errors. Curated MK/SI
answers are machine-drafted — proofread before launch.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

mk/about-us/index.html

@@ -422,5 +422,7 @@
 <!-- END_FOOTER -->
     
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/become-a-member/index.html

@@ -607,5 +607,7 @@
     <script src="../../main.js"></script>
     <script src="../../member-form.js"></script>
 
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/cookie-policy/index.html

@@ -314,5 +314,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/faq/index.html

@@ -529,5 +529,7 @@
 </footer>
 <!-- END_FOOTER -->
 
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/gallery/index.html

@@ -382,5 +382,7 @@
 </footer>
 <!-- END_FOOTER -->
 
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/a-table-full-of-macedonia/index.html

@@ -391,5 +391,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/history-you-can-still-walk-through/index.html

@@ -397,5 +397,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/index.html

@@ -364,5 +364,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/music-dance-and-the-moments-that-bring-us-together/index.html

@@ -397,5 +397,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/ohrid-more-than-a-postcard/index.html

@@ -389,5 +389,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/skopje-a-city-of-many-layers/index.html

@@ -379,5 +379,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-macedonia/welcome-to-macedonia/index.html

@@ -376,5 +376,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/a-first-taste-of-slovenian-food/index.html

@@ -381,5 +381,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/index.html

@@ -364,5 +364,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/lake-bled-beyond-the-famous-view/index.html

@@ -377,5 +377,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/ljubljana-through-our-eyes/index.html

@@ -367,5 +367,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/slovenian-habits-that-may-surprise-you/index.html

@@ -398,5 +398,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/slovenias-stories-in-stone-and-tradition/index.html

@@ -383,5 +383,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/get-to-know-slovenia/welcome-to-slovenia/index.html

@@ -354,5 +354,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/index.html

@@ -533,5 +533,7 @@
 <!-- END_FOOTER -->
 
     <script src="../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/legal/index.html

@@ -289,5 +289,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/msos-hub/index.html

@@ -406,5 +406,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/news/index.html

@@ -469,5 +469,7 @@
     <script src="../../main.js"></script>
     <script src="../../news-filter.js"></script>
 
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/news/proof-of-means-updated-2026/index.html

@@ -295,5 +295,7 @@
 
     <script src="../../../main.js"></script>
 
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/privacy-policy/index.html

@@ -357,5 +357,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/humanitarian-tournament-in-maribor/index.html

@@ -378,5 +378,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/in-memory-of-frosina-kulakova/index.html

@@ -320,5 +320,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/in-memory-of-the-kochani-victims/index.html

@@ -331,5 +331,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/index.html

@@ -427,5 +427,7 @@
     <!-- Поврзување до главната JS-датотека -->
     
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/macedonian-student-night-in-ljubljana/index.html

@@ -383,5 +383,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/meet-student-slovenia-2023/index.html

@@ -404,5 +404,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/meet-student-slovenia-2024/index.html

@@ -403,5 +403,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/morning-coffee-in-front-of-ctk/index.html

@@ -367,5 +367,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/paint-and-wine-at-sunset/index.html

@@ -360,5 +360,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/projects/watching-handball-together-in-slovenia/index.html

@@ -346,5 +346,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/academic-life/index.html

@@ -358,5 +358,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/administrative-basics/index.html

@@ -355,5 +355,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/admission-and-enrolment/index.html

@@ -356,5 +356,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/application-deadlines/index.html

@@ -353,5 +353,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/arrival-checklist/index.html

@@ -371,5 +371,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/bachelor-application/index.html

@@ -383,5 +383,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/choose-a-programme/index.html

@@ -374,5 +374,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/complete-student-journey/index.html

@@ -399,5 +399,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/document-preparation/index.html

@@ -348,5 +348,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/evs-application-guide/index.html

@@ -366,5 +366,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/healthcare-in-slovenia/index.html

@@ -409,5 +409,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/index.html

@@ -513,5 +513,7 @@
     <script src="../../main.js"></script>
     <script src="../../student-guide.js"></script>
     <script src="../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/master-application/index.html

@@ -360,5 +360,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/means-accommodation-address/index.html

@@ -432,5 +432,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/my-route/index.html

@@ -261,5 +261,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../my-route.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/official-sources-and-checklists/index.html

@@ -387,5 +387,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/prepare-to-move/index.html

@@ -404,5 +404,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/recognition-of-education/index.html

@@ -349,5 +349,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/renew-change-graduate/index.html

@@ -358,5 +358,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/rm-si-3-health-insurance/index.html

@@ -398,5 +398,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-accommodation/index.html

@@ -398,5 +398,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-budget/index.html

@@ -368,5 +368,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-meals/index.html

@@ -356,5 +356,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-organisations-and-extracurriculars/index.html

@@ -393,5 +393,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-residence-permit/index.html

@@ -410,5 +410,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-transport/index.html

@@ -377,5 +377,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/student-work/index.html

@@ -351,5 +351,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/study-cities/index.html

@@ -383,5 +383,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/tuition-and-scholarships/index.html

@@ -353,5 +353,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/visa-and-residence-explained/index.html

@@ -380,5 +380,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/wellbeing-and-community/index.html

@@ -347,5 +347,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/student-welcome-guide/where-to-apply-for-residence/index.html

@@ -418,5 +418,7 @@
 
     <script src="../../../main.js"></script>
     <script src="../../../guide-feedback.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/support/index.html

@@ -423,5 +423,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>

mk/timeline-and-milestones/index.html

@@ -503,5 +503,7 @@
 <!-- END_FOOTER -->
 
     <script src="../../main.js"></script>
+<link rel="stylesheet" href="/assistant.css">
+<script src="/assistant.js" defer></script>
 </body>
 </html>