sync: feat: integrate protected BrgyLink chatbot AI service

app.py

@@ -13,6 +13,7 @@ from werkzeug.exceptions import RequestEntityTooLarge
 from utils.anticheat import AntiCheatEngine, AntiCheatIndeterminate, AntiCheatUnavailable
 from utils.predictor import Predictor, PredictorUnavailable
 from utils.verdict import get_verdict
+from chatbot_runtime.service import ChatService
 
 
 load_dotenv()
@@ -28,6 +29,7 @@ AI_SERVICE_TOKEN = os.getenv('AI_SERVICE_TOKEN', '')
 logger.info('Loading the Mission17 TensorFlow CNN verification service.')
 anticheat = AntiCheatEngine()
 predictor = Predictor()
+chatbot = ChatService()
 
 
 def allowed_file(filename):
@@ -166,5 +168,21 @@ def predict():
         return jsonify({'error': 'Processing failed'}), 500
 
 
+@app.route('/chat', methods=['POST'])
+def chat():
+    """Server-to-server BrgyLink AI chatbot endpoint.
+
+    It deliberately accepts only a short message and an optional opaque session
+    identifier. The mobile client never calls this Space directly and resident
+    history or account data is not sent to Hugging Face.
+    """
+    auth_error = require_backend_service_token()
+    if auth_error:
+        return auth_error
+
+    status_code, payload = chatbot.respond(request.get_json(silent=True))
+    return jsonify(payload), status_code
+
+
 if __name__ == '__main__':
     app.run(host='0.0.0.0', port=7860, debug=False)

chatbot_runtime/__init__.py

@@ -0,0 +1,6 @@
+"""Bundled, safety-constrained BrgyLink chatbot runtime.
+
+The source-of-truth project remains the separate BrgyLink-AI-Chatbot
+repository. This package contains the minimal offline runtime required by the
+shared Hugging Face AI service.
+"""

chatbot_runtime/knowledge_base.json

@@ -0,0 +1,891 @@
+{
+  "metadata": {
+    "barangay_name": "Barangay Bagong Pag-asa, San Jacinto",
+    "status": "prototype_draft",
+    "last_updated": "2026-09-21",
+    "important": "Do not publish entries marked needs_staff_verification until an authorized barangay representative has confirmed them.",
+    "languages": [
+      "English",
+      "Tagalog",
+      "Ilocano",
+      "Pangasinan"
+    ],
+    "municipality": "San Jacinto, Pangasinan"
+  },
+  "services": [
+    {
+      "intent": "clearance",
+      "title": "Barangay Clearance",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID"
+      ],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "To request a Barangay Clearance, open Document Requests in BrgyLink, select Barangay Clearance, enter your purpose, attach a clear photo of your valid ID, and submit. You can track progress in the app. For fees and pickup details, please inquire at the barangay office.",
+        "tagalog": "Para humiling ng Barangay Clearance, buksan ang Document Requests sa BrgyLink, piliin ang Barangay Clearance, ilagay ang layunin, mag-attach ng malinaw na photo ng valid ID, at i-submit. Masusubaybayan ang progreso sa app. Para sa mga bayarin at pickup, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno agkiddaw iti Barangay Clearance, lukatan ti Document Requests iti BrgyLink, piliem ti Barangay Clearance, ikabil ti panggep, i-attach ti nalawag a ladawan ti valid ID, ken i-submit. Masubaybayam ti progreso iti app. Para kadagiti bayad ken pickup, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian mangala na Barangay Clearance, lukatan so Document Requests ed BrgyLink, piliyen so Barangay Clearance, ilagay so gagala, i-attach so malinew ya photo na valid ID, tan i-submit. Nayarin bantayan so progreso ed app. Para ed saray bayar tan pickup, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "indigency",
+      "title": "Certificate of Indigency",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID"
+      ],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "To request a Certificate of Indigency, open Document Requests in BrgyLink, choose Certificate of Indigency, state your purpose (e.g., medical or scholarship assistance), attach a valid ID, and submit. For eligibility requirements and processing details, please inquire at the barangay office.",
+        "tagalog": "Para humiling ng Certificate of Indigency, buksan ang Document Requests sa BrgyLink, piliin ang Certificate of Indigency, ilagay ang layunin (hal., medikal o scholarship), mag-attach ng valid ID, at i-submit. Para sa mga kinakailangan at detalye ng proseso, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno agkiddaw iti Certificate of Indigency, lukatan ti Document Requests iti BrgyLink, piliem ti Certificate of Indigency, ibaga ti panggep (kas pagarigan, medikal wenno scholarship), i-attach ti valid ID, ken i-submit. Para kadagiti kasapulan ken detalye ti proseso, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian mangala na Certificate of Indigency, lukatan so Document Requests ed BrgyLink, piliyen so Certificate of Indigency, ilagay so gagala (singa medikal odino scholarship), i-attach so valid ID, tan i-submit. Para ed saray kailangan tan detalye na proseso, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "residency",
+      "title": "Certificate of Residency",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID"
+      ],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "To request a Certificate of Residency, open Document Requests in BrgyLink, select Certificate of Residency, specify your purpose, attach a valid ID, and submit. For requirements and processing details, please inquire at the barangay office.",
+        "tagalog": "Para humiling ng Certificate of Residency, buksan ang Document Requests sa BrgyLink, piliin ang Certificate of Residency, ilagay ang layunin, mag-attach ng valid ID, at i-submit. Para sa mga kinakailangan at detalye ng proseso, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno agkiddaw iti Certificate of Residency, lukatan ti Document Requests iti BrgyLink, piliem ti Certificate of Residency, ibaga ti panggep, i-attach ti valid ID, ken i-submit. Para kadagiti kasapulan ken detalye ti proseso, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian mangala na Certificate of Residency, lukatan so Document Requests ed BrgyLink, piliyen so Certificate of Residency, ilagay so gagala, i-attach so valid ID, tan i-submit. Para ed saray kailangan tan detalye na proseso, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "business_permit",
+      "title": "Barangay Business Clearance",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID"
+      ],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "To apply for a Barangay Business Clearance, open Document Requests in BrgyLink, select Business Clearance, and submit your application. For specific requirements, fees, and processing details, please inquire at the barangay office.",
+        "tagalog": "Para mag-apply ng Barangay Business Clearance, buksan ang Document Requests sa BrgyLink, piliin ang Business Clearance, at i-submit ang application. Para sa mga kinakailangan, bayarin, at detalye ng proseso, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno ag-apply iti Barangay Business Clearance, lukatan ti Document Requests iti BrgyLink, piliem ti Business Clearance, ken i-submit ti aplikasion. Para kadagiti kasapulan, bayad, ken detalye ti proseso, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian man-apply na Barangay Business Clearance, lukatan so Document Requests ed BrgyLink, piliyen so Business Clearance, tan i-submit so aplikasyon. Para ed saray kailangan, bayar, tan detalye na proseso, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "office_hours",
+      "title": "Office Hours and Location",
+      "needs_staff_verification": true,
+      "office_hours": null,
+      "office_address": null,
+      "contact": null,
+      "answer": {
+        "english": "I cannot confirm a physical address or live office schedule. For the location of Barangay Bagong Pag-asa, please check official BrgyLink Announcements or inquire directly with the barangay office. Use the same channels to confirm office hours before visiting.",
+        "tagalog": "Hindi ko makukumpirma ang pisikal na address o kasalukuyang office schedule. Para sa lokasyon ng Barangay Bagong Pag-asa, tingnan ang official Announcements sa BrgyLink o magtanong mismo sa opisina ng barangay. Doon din kumpirmahin ang oras ng opisina bago bumisita.",
+        "ilocano": "Saan a makumpirma ti chatbot ti pisikal a address wenno agdama nga iskediul ti opisina. Para iti lokasion ti Barangay Bagong Pag-asa, kitaem ti opisial nga Announcements iti BrgyLink wenno saludsodem mismo iti opisina ti barangay. Ikumpirmam met ti oras ti opisina sakbay a bumisita.",
+        "pangasinan": "Ag na-confirm na chatbot so pisikal ya address odino kasalukuyan ya schedule na opisina. Para ed lokasyon na Barangay Bagong Pag-asa, nengnengen so opisyal ya Announcements ed BrgyLink odino mantepet mismo ed opisina na barangay. I-confirm met so oras na opisina antes bumisita."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "fees",
+      "title": "Service Fees",
+      "needs_staff_verification": true,
+      "answer": {
+        "english": "Service fees for barangay certificates and clearances vary. For the current fee schedule, please inquire at the barangay office or check the Announcements section in BrgyLink.",
+        "tagalog": "Ang mga bayarin sa sertipiko at clearance ng barangay ay iba-iba. Para sa kasalukuyang listahan ng bayarin, magtanong sa opisina ng barangay o tingnan ang Announcements sa BrgyLink.",
+        "ilocano": "Dagiti bayad kadagiti sertipiko ken clearance ti barangay ket agduduma. Para iti agdama a listaan dagiti bayad, saludsoden iti opisina ti barangay wenno kitaen ti Announcements iti BrgyLink.",
+        "pangasinan": "Saray bayar ed sertipiko tan clearance na barangay et nanduruma. Para ed listaan na saray bayar natan, mantepet ed opisina na barangay odino nengnengen so Announcements ed BrgyLink."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "report_incident",
+      "title": "Complaint or Blotter",
+      "needs_staff_verification": true,
+      "answer": {
+        "english": "To file an incident report, open Blotter Reports in BrgyLink, choose File New Report, select the incident category, enter the details and location, and submit. You can track your report status in the app. For emergencies, call 911.",
+        "tagalog": "Para mag-file ng incident report, buksan ang Blotter Reports sa BrgyLink, piliin ang File New Report, piliin ang kategorya, ilagay ang mga detalye at lokasyon, at i-submit. Masusubaybayan ang status ng report sa app. Para sa emergency, tumawag sa 911.",
+        "ilocano": "Tapno ag-file iti incident report, lukatan ti Blotter Reports iti BrgyLink, piliem ti File New Report, piliem ti kategorya, ikabil dagiti detalye ken lokasion, ken i-submit. Masubaybayam ti status ti report iti app. Para iti emergency, umawag iti 911.",
+        "pangasinan": "Pian man-file na incident report, lukatan so Blotter Reports ed BrgyLink, piliyen so File New Report, piliyen so kategorya, ilagay so saray detalye tan lokasyon, tan i-submit. Nayarin bantayan so status na report ed app. Para ed emergency, tawagan so 911."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "emergency",
+      "title": "Emergency",
+      "needs_staff_verification": true,
+      "emergency_contacts": {
+        "national_emergency": "911",
+        "barangay_tanod": null,
+        "fire": null,
+        "ambulance": null
+      },
+      "answer": {
+        "english": "If there is immediate danger to life or property, call 911 immediately. Do not wait for a chatbot reply. The chatbot cannot dispatch help or contact emergency services for you.",
+        "tagalog": "Kung may agarang panganib sa buhay o ari-arian, tumawag agad sa 911. Huwag maghintay ng sagot ng chatbot. Hindi kayang magpadala ng tulong o tumawag sa emergency services para sa iyo ang chatbot.",
+        "ilocano": "No adda dagus a peggad iti biag wenno sanikua, umawag a dagus iti 911. Saan nga urayen ti sungbat ti chatbot. Saan a makapatulod ti chatbot iti tulong wenno umawag kadagiti emergency services para kenka.",
+        "pangasinan": "No walay tampol ya peligro ed bilay odino kayarian, tawagan ya tampol so 911. Ag-antayan so ebat na chatbot. Ag makapatulod na tulong so chatbot odino ontawag ed emergency services para ed sika."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "garbage",
+      "title": "Garbage Collection",
+      "needs_staff_verification": true,
+      "schedule": null,
+      "answer": {
+        "english": "Garbage collection in Barangay Bagong Pag-asa follows a designated schedule per purok. For your collection day and segregation guidelines, please inquire at the barangay office or check the Announcements section in BrgyLink.",
+        "tagalog": "Ang hakot ng basura sa Barangay Bagong Pag-asa ay may takdang schedule bawat purok. Para sa araw ng koleksyon at mga panuntunan sa segregasyon, magtanong sa opisina ng barangay o tingnan ang Announcements sa BrgyLink.",
+        "ilocano": "Ti panagala ti basura iti Barangay Bagong Pag-asa ket addaan iti naikeddeng nga iskediul tunggal purok. Para iti aldaw ti koleksion ken paglintegan ti segregasion, saludsoden iti opisina ti barangay wenno kitaen ti Announcements iti BrgyLink.",
+        "pangasinan": "Say panangala na basura ed Barangay Bagong Pag-asa et walay niganan ya schedule ed balang purok. Para ed agew na koleksyon tan saray totontonen ed segregasyon, mantepet ed opisina na barangay odino nengnengen so Announcements ed BrgyLink."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "good_moral",
+      "title": "Certificate of Good Moral Character",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID"
+      ],
+      "answer": {
+        "english": "To request a Certificate of Good Moral Character, open Document Requests in BrgyLink, select Good Moral Character, state your purpose, attach a valid ID, and submit. For requirements and processing details, please inquire at the barangay office.",
+        "tagalog": "Para humiling ng Certificate of Good Moral Character, buksan ang Document Requests sa BrgyLink, piliin ang Good Moral Character, ilagay ang layunin, mag-attach ng valid ID, at i-submit. Para sa mga kinakailangan at detalye ng proseso, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno agkiddaw iti Certificate of Good Moral Character, lukatan ti Document Requests iti BrgyLink, piliem ti Good Moral Character, ibaga ti panggep, i-attach ti valid ID, ken i-submit. Para kadagiti kasapulan ken detalye ti proseso, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian mangala na Certificate of Good Moral Character, lukatan so Document Requests ed BrgyLink, piliyen so Good Moral Character, ilagay so gagala, i-attach so valid ID, tan i-submit. Para ed saray kailangan tan detalye na proseso, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "barangay_id",
+      "title": "Barangay ID",
+      "needs_staff_verification": true,
+      "requirements": [
+        "Submit through BrgyLink Document Requests",
+        "Enter the request purpose",
+        "Attach a photo of a valid ID when requested"
+      ],
+      "answer": {
+        "english": "To apply for a Barangay ID, open Document Requests in BrgyLink, select Barangay ID, provide your resident details, and submit. For specific requirements and processing time, please inquire at the barangay office.",
+        "tagalog": "Para mag-apply ng Barangay ID, buksan ang Document Requests sa BrgyLink, piliin ang Barangay ID, ilagay ang iyong mga detalye bilang residente, at i-submit. Para sa mga kinakailangan at oras ng proseso, magtanong sa opisina ng barangay.",
+        "ilocano": "Tapno ag-apply iti Barangay ID, lukatan ti Document Requests iti BrgyLink, piliem ti Barangay ID, ikabil dagiti detalye a kas residente, ken i-submit. Para kadagiti kasapulan ken oras ti proseso, saludsoden iti opisina ti barangay.",
+        "pangasinan": "Pian man-apply na Barangay ID, lukatan so Document Requests ed BrgyLink, piliyen so Barangay ID, ilagay so saray detalye bilang residente, tan i-submit. Para ed saray kailangan tan oras na proseso, mantepet ed opisina na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "document_status",
+      "title": "Document Request Status",
+      "needs_staff_verification": false,
+      "statuses": [
+        "Pending",
+        "Processing",
+        "Ready for Pickup",
+        "Completed",
+        "Rejected"
+      ],
+      "answer": {
+        "english": "To check the status of your document request, open Document Requests in BrgyLink. Your request will show as Pending, Processing, Ready for Pickup (available at the barangay hall), Completed, or Rejected with reason noted.",
+        "tagalog": "Upang suriin ang status ng iyong hiniling na dokumento, buksan ang 'Document Requests' sa BrgyLink. Dito makikita kung ito ay: Pending (nakabinbin), Processing (inaasikaso), Ready for Pickup (maaari nang kunin sa barangay hall), Completed, o Rejected. May kaukulang dahilan din kung sakaling ma-reject ang request.",
+        "ilocano": "Tapno makita ti kasasaad ti kineddawmo a dokumento, lukatan ti 'Document Requests' iti BrgyLink. Dita makitam no: Pending, Processing, Ready for Pickup (mabalinen nga alaen iti barangay hall), Completed, wenno Rejected.",
+        "pangasinan": "Pian nengnengen so status na kineddeng mon dokumento, lukatan so 'Document Requests' diad BrgyLink. Ditan nanengneng no: Pending, Processing, Ready for Pickup (nayari lay alaen ed barangay hall), Completed, odino Rejected."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "registration",
+      "title": "Resident Registration",
+      "needs_staff_verification": false,
+      "steps": [
+        "Tap Create Account",
+        "Enter full name, email, username, phone number, and home address",
+        "Complete email verification"
+      ],
+      "answer": {
+        "english": "To register, begin with your email in Step 1. Enter the six-digit code sent to that email before continuing. Then complete your resident details, upload clear photos of the required government-issued ID, create your password in the final step, accept the Privacy Notice and Terms of Use, and submit the registration for barangay review. Residents must be at least 15 years old. Never share your verification code.",
+        "tagalog": "Para mag-register, magsimula sa email sa Step 1. Ilagay ang anim na digit na code na ipinadala sa email bago magpatuloy. Kumpletuhin ang resident details, mag-upload ng malinaw na larawan ng hinihinging government-issued ID, gumawa ng password sa huling step, tanggapin ang Privacy Notice at Terms of Use, at isumite ang registration para sa barangay review. Kailangan ay hindi bababa sa 15 taong gulang. Huwag ibahagi ang verification code.",
+        "ilocano": "Tapno agparehistro, mangrugi iti email iti Step 1 ken ikabil ti innem a digit a code sakbay a mangtuloy. Kumpletoem dagiti resident details ken mang-upload iti nalawag a ladawan ti government-issued ID. Aramidem ti password iti maudi a step, awatem ti Privacy Notice ken Terms of Use, ken isumitem para iti barangay review. Masapul nga agtawen iti 15 wenno nangatngato. Saan nga ibagbaga ti verification code.",
+        "pangasinan": "Pian mag-register, manggapo ed email ed Step 1 tan isulat so anem ya digit a code antes ontuloy. Kumpletoen so resident details tan mang-upload na malinew ya litrato na government-issued ID. Gawaen so password ed unor ya step, awaten so Privacy Notice tan Terms of Use, tan isumite para ed barangay review. Kasapulan ya 15 taon odino mas matanda. Agmon iter so verification code."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true,
+      "answer_variants": {
+        "id": {
+          "english": "Residents must be at least 15 to register. In the final signup step, select your ID type and take a clear photo: all details must be readable, with no glare, blur, or cut-off edges. Upload the front and back when requested; Passport uses the information page. If you do not have an accepted ID, ask the barangay office what to do. The chatbot cannot approve an ID or bypass the requirement.",
+          "tagalog": "Kailangan ay hindi bababa sa 15 taong gulang para mag-register. Sa huling signup step, piliin ang ID type at kumuha ng malinaw na larawan: nababasa ang detalye, walang glare o blur, at hindi putol ang gilid. I-upload ang front at back kung hinihingi; para sa Passport, information page ang kailangan. Kung walang tinatanggap na ID, magtanong sa opisina ng barangay. Hindi kayang mag-approve ng ID o lumampas sa requirement ang chatbot.",
+          "ilocano": "Masapul nga agtawen iti 15 wenno nangatngato tapno agparehistro. Iti maudi a signup step, piliem ti ID type ken alaem ti nalawag a ladawan: mabasa amin a detalye, awan glare wenno blur, ken saan a naputed ti igid. I-upload ti front ken back no kasapulan; ti Passport ket information page. No awan ti maawat nga ID, agsaludsod iti opisina ti barangay. Saan a maka-approve ti chatbot iti ID wenno makalabsing iti requirement.",
+          "pangasinan": "Kasapulan ya 15 taon odino mas matanda pian mag-register. Ed unor ya signup step, piliyen so ID type tan alaen so malinew ya litrato: nabasa so amin ya detalye, anggapo so glare odino blur, tan agputol so gilid. I-upload so front tan back no kasapulan; say Passport et information page. No anggapoy tinatanggap ya ID, mantepet ed opisina na barangay. Ag maka-approve na ID so chatbot odino makalampas ed requirement."
+        }
+      }
+    },
+    {
+      "intent": "account_help",
+      "title": "Login and Email OTP",
+      "needs_staff_verification": false,
+      "answer": {
+        "english": "For a registration code, check Inbox, Spam, and Junk and make sure the email was entered correctly. Wait for the resend timer in the app before requesting another code; an expired code needs a new request. Do not share the code. If your registration was submitted, wait for barangay review before signing in. For a forgotten password, use Forgot Password on the sign-in screen.",
+        "tagalog": "Para sa registration code, tingnan ang Inbox, Spam, at Junk at tiyaking tama ang email na inilagay. Hintayin ang resend timer sa app bago humiling ulit ng code; kung expired na ang code, humiling ng bago. Huwag ibahagi ang code. Kung naisumite na ang registration, hintayin muna ang barangay review bago mag-sign in. Para sa nakalimutang password, gamitin ang Forgot Password sa sign-in screen.",
+        "ilocano": "No awan ti registration code, kitaem ti Inbox, Spam, ken Junk ken siguraduem a husto ti email. Urayem ti resend timer iti app sakbay a mangkiddaw manen iti code. Saan nga ibagbaga ti code. No naipasa ti registration, urayem ti barangay review sakbay a sumrek.",
+        "pangasinan": "No anggapo so registration code, nengnengen so Inbox, Spam, tan Junk tan seguroen ya duga so email. Antayan so resend timer ed app antes mangikeddeng lamet na code. Agmon iter so code. No naisumite lay registration, antayan so barangay review antes sumrek."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true,
+      "answer_variants": {
+        "password": {
+          "english": "On the sign-in screen, tap Forgot Password, enter the email for your account, and follow the reset instructions sent to it. Check Inbox, Spam, and Junk. Use a newly requested reset link if the old one is invalid or expired. Never send your password or reset link to the chatbot. The chatbot cannot reset your password for you.",
+          "tagalog": "Sa sign-in screen, i-tap ang Forgot Password, ilagay ang email ng account, at sundin ang reset instructions na ipinadala rito. Tingnan ang Inbox, Spam, at Junk. Humiling ng bagong reset link kung invalid o expired na ang luma. Huwag ipadala sa chatbot ang password o reset link. Hindi kayang i-reset ng chatbot ang password para sa iyo.",
+          "ilocano": "Iti sign-in screen, i-tap ti Forgot Password, ikabil ti email ti account, ken surotem ti reset instructions iti email. Kitaem ti Inbox, Spam, ken Junk. Mangikiddaw iti baro a reset link no invalid wenno expired ti daan. Saan nga ipatulod iti chatbot ti password wenno reset link. Saan a ma-reset ti chatbot ti password mo.",
+          "pangasinan": "Ed sign-in screen, i-tap so Forgot Password, isulat so email na account, tan suroten so reset instructions ed email. Nengnengen so Inbox, Spam, tan Junk. Mangikeddeng na balon reset link no invalid odino expired lay daan. Agmon ipatulod ed chatbot so password odino reset link. Ag na-reset na chatbot so password mo."
+        },
+        "otp": {
+          "english": "Check that the signup email is correct and look in Inbox, Spam, and Junk. If the code has not arrived, wait for the app's resend timer, then request a new code. Enter the latest six-digit code; request another if it is expired or invalid. You can edit an incorrect email on the verification screen. Never share your OTP. The chatbot cannot see your code or confirm delivery.",
+          "tagalog": "Tiyaking tama ang signup email at tingnan ang Inbox, Spam, at Junk. Kung wala pa ang code, hintayin ang resend timer sa app at humiling ng bagong code. Ilagay ang pinakabagong anim na digit na code; humiling ulit kung expired o invalid. Maaari mong itama ang email sa verification screen. Huwag ibahagi ang OTP. Hindi nakikita ng chatbot ang code at hindi nito makukumpirma ang delivery.",
+          "ilocano": "Siguraduem a husto ti signup email ken kitaem ti Inbox, Spam, ken Junk. No awan pay ti code, urayem ti resend timer iti app ken mangkiddaw iti baro a code. Ikabil ti kabaruan nga innem a digit a code; mangkiddaw manen no expired wenno invalid. Mabalin a baliwan ti email iti verification screen. Saan nga ibagbaga ti OTP. Saan a makita ti chatbot ti code wenno makumpirma ti delivery.",
+          "pangasinan": "Seguroen ya duga so signup email tan nengnengen so Inbox, Spam, tan Junk. No anggapo ni so code, antayan so resend timer ed app tan mangikeddeng na balon code. Isulat so pinakabalo ya anem ya digit a code; mangikeddeng lamet no expired odino invalid. Nayari ya ontan so email ed verification screen. Agmon iter so OTP. Ag nanengneng na chatbot so code odino nakumpirma so delivery."
+        },
+        "review": {
+          "english": "Email verification does not mean the resident account has been approved. Submitted registrations still need barangay review. If the account is rejected, read any rejection reason shown and contact the barangay office about corrections. If it is approved but you still cannot sign in, check the email and password and report the exact error without sharing credentials. The chatbot cannot see or change your approval status.",
+          "tagalog": "Ang email verification ay hindi pa approval ng resident account. Kailangan pa rin ng barangay review ang naisumiteng registration. Kung rejected, basahin ang ipinakitang rejection reason at magtanong sa opisina ng barangay tungkol sa pagwawasto. Kung approved pero hindi makapasok, tiyaking tama ang email at password at i-report ang eksaktong error nang hindi ibinabahagi ang credentials. Hindi nakikita o nababago ng chatbot ang approval status.",
+          "ilocano": "Ti email verification ket saan pay nga approval ti resident account. Kasapulan pay ti barangay review ti naipasa a registration. No rejected, basaem ti rejection reason a naipakita ken makiuman iti opisina ti barangay maipapan iti panagkorehir. No approved ngem saan a makasrek, kitaem ti email ken password ken i-report ti error nga awan ibagbaga a credentials. Saan a makita wenno baliwan ti chatbot ti approval status.",
+          "pangasinan": "Say email verification et agni approval na resident account. Kasapulan ni so barangay review na naisumiten registration. No rejected, basaen so rejection reason ya nanengneng tan mantepet ed opisina na barangay nipaakar ed panangkorehir. No approved balet agmakasumrek, nengnengen so email tan password tan i-report so error ya agiter na credentials. Ag nanengneng odino nabago na chatbot so approval status."
+        }
+      }
+    },
+    {
+      "intent": "announcements",
+      "title": "Barangay Announcements",
+      "needs_staff_verification": false,
+      "answer": {
+        "english": "For the latest community bulletins, typhoon advisories, health mission schedules, financial aid releases, and public hearings, open the Announcements screen in BrgyLink.",
+        "tagalog": "Para sa pinakabagong balita, bagyo o kalamidad alerts, health center schedules, pamamahagi ng ayuda, at public hearings, buksan ang 'Announcements' screen sa BrgyLink. Regular itong ina-update ng pamahalaang barangay.",
+        "ilocano": "Para kadagiti kabaroan a damag, pakaammo iti bagyo ken kalamidad, iskedyul ti health center, panagiwaras ti ayuda, ken public hearings, lukatan ti 'Announcements' screen iti BrgyLink. Kanayon a mapabaro daytoy ti barangay.",
+        "pangasinan": "Para ed saray balon balita, pakaammo ed bagyo tan kalamidad, iskedyul na health center, panagiwaras na ayuda, tan public hearings, lukatan so 'Announcements' screen diad BrgyLink. Regular yan ina-update na barangay."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "sdg_mission",
+      "title": "Community Initiatives and SDG Missions",
+      "needs_staff_verification": false,
+      "steps": [
+        "Open Community Initiatives",
+        "Select an active program",
+        "Tap Upload Proof",
+        "Capture live photo evidence",
+        "Tap Analyze & Submit"
+      ],
+      "answer": {
+        "english": "Open Civic Tasks & Community Events, choose an active civic task, and use Capture Live Photo to show your participation clearly. Retake unclear photos, then tap Submit Task Proof. Open Profile and Community Mission Submissions to see your own submission status and any rejection reason. Pending is not approval; the chatbot cannot see or change your result. Civic participation does not earn reward points in the current app. Follow the task instructions and do not use unrelated or reused photos.",
+        "tagalog": "Buksan ang Civic Tasks & Community Events, pumili ng aktibong civic task, at gamitin ang Capture Live Photo para malinaw na ipakita ang pakikilahok. Mag-retake kung malabo at i-tap ang Submit Task Proof. Sa Profile, tingnan ang Community Mission Submissions para sa sariling submission status at rejection reason kung mayroon. Hindi pa approval ang Pending; hindi nakikita o nababago ng chatbot ang resulta. Walang reward points ang civic participation sa kasalukuyang app. Sundin ang task instructions at huwag gumamit ng hindi kaugnay o lumang larawan.",
+        "ilocano": "Lukatan ti Civic Tasks & Community Events, piliem ti aktibo a civic task, ken usarem ti Capture Live Photo tapno nalawag ti panagpasetmo. I-retake no saan a nalawag ken i-tap ti Submit Task Proof. Iti Profile, kitaem ti Community Mission Submissions para iti bukodmo a submission status ken rejection reason no adda. Saan pay nga approval ti Pending; saan a makita wenno baliwan ti chatbot ti resulta. Awan ti reward points iti agdama nga app. Surotem dagiti task instructions ken saan nga usaren ti saan a kaugnay wenno daan a ladawan.",
+        "pangasinan": "Lukatan so Civic Tasks & Community Events, piliyen so aktibon civic task, tan usaren so Capture Live Photo pian malinew so pakikiba mo. I-retake no agmalinew tan i-tap so Submit Task Proof. Ed Profile, nengnengen so Community Mission Submissions para ed bukod mon submission status tan rejection reason no wala. Agni approval so Pending; ag nanengneng odino nabago na chatbot so resulta. Anggapoy reward points ed kasalukuyan ya app. Suroten so task instructions tan ag-usar na agkaugnay odino daan ya litrato."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "suggestion",
+      "title": "Suggestions and Feedback",
+      "needs_staff_verification": false,
+      "answer": {
+        "english": "Do you have ideas or feedback to improve our barangay? Use the 'Feedback / Suggestions' feature in BrgyLink to send your thoughts directly to the barangay council. For formal disputes, please file a Blotter Report instead.",
+        "tagalog": "Mayroon ka bang mungkahi o puna para mapabuti ang ating barangay? Gamitin ang feature na 'Feedback / Suggestions' sa BrgyLink upang direktang maipadala ang iyong mensahe sa pamunuan. Para naman sa pormal na reklamo o insidente, gamitin ang 'Blotter Reports'.",
+        "ilocano": "Adda kadi singasingmo wenno feedback tapno mapasayaat ti barangaytayo? Usaren ti 'Feedback / Suggestions' iti BrgyLink tapno maipatulod a direkta kadagiti opisial. Para iti pormal a reklamo, usaren ti 'Blotter Reports'.",
+        "pangasinan": "Wala kasi suhestiyon mo odino feedback pian mas omparakep so barangay tayo? Usaren so 'Feedback / Suggestions' diad BrgyLink pian direktan nipawit ed saray opisyales. Para ed pormal ya reklamo, usaren so 'Blotter Reports'."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "blotter_status",
+      "title": "Blotter Report Tracking",
+      "needs_staff_verification": false,
+      "answer": {
+        "english": "To track the status of your blotter complaint, open 'My Blotter Reports' in BrgyLink to see whether it is Under Review, Scheduled for Mediation, or Resolved. The chatbot cannot access or alter private case records.",
+        "tagalog": "Upang malaman ang estado ng iyong inihain na blotter, buksan ang 'My Blotter Reports' sa BrgyLink app. Dito makikita kung ang ulat ay Under Review, Scheduled for Mediation/Lupon, o Resolved na. Hindi maaaring baguhin o direktang basahin ng chatbot ang lihim na detalye ng iyong blotter.",
+        "ilocano": "Tapno maammuan ti kasasaad ti blottermo, lukatan ti 'My Blotter Reports' iti BrgyLink app. Makitam no daytoy ket Under Review, Para iti Lupon Hearing, wenno Naresolba. Saan a mabalin nga i-display wenno bagian ti chatbot ti personal a detalye ti kasom.",
+        "pangasinan": "Pian naamtaan so estado na blotter mo, lukatan so 'My Blotter Reports' diad BrgyLink app. Ditan nanengneng no say ulat et Under Review, Iskediyul parad Lupon Hearing, odino Na-ayos la. Ag nayarin direkta ya basaen na chatbot so personal ya detalye na blotter mo."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "notifications",
+      "title": "BrgyLink Notifications",
+      "needs_staff_verification": false,
+      "answer": {
+        "english": "BrgyLink sends notifications for updates on your document requests, blotter reports, and urgent community advisories. Ensure notification permissions are enabled for BrgyLink in your phone settings.",
+        "tagalog": "Nagpapadala ang BrgyLink ng in-app at push notifications para sa updates sa iyong document request, status ng blotter, at mahahalagang anunsyo. Siguraduhing pinayagan (Enabled) ang notifications para sa BrgyLink sa settings ng iyong telepono.",
+        "ilocano": "Mangipatulod ti BrgyLink kadagiti notifications para kadagiti update iti document requests, blotter reports, ken anunsio. Siguraduem a naka-Enable ti notifications ti BrgyLink iti settings ti selponmo.",
+        "pangasinan": "Mangi-iiter so BrgyLink na notifications para ed updates ed document requests, blotter reports, tan anunsyo. Seguroen ya aka-Enable so notifications parad BrgyLink diad settings na telepono mo."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "officials",
+      "title": "Barangay Officials",
+      "needs_staff_verification": true,
+      "answer": {
+        "english": "The chatbot does not have a confirmed roster of barangay officials. Please check the barangay office or the Announcements section in BrgyLink for the list of current officials.",
+        "tagalog": "Ang chatbot ay walang kumpirmadong roster ng mga opisyal ng barangay. Tingnan po ang opisina ng barangay o ang Announcements sa BrgyLink para sa listahan ng kasalukuyang mga opisyal.",
+        "ilocano": "Ti chatbot ket awan ti nakumpirma a roster dagiti opisyal ti barangay. Kitaen ti opisina ti barangay wenno ti Announcements iti BrgyLink para iti listaan dagiti agdama nga opisyal.",
+        "pangasinan": "Say chatbot et anggapoy nakumpirman roster na saray opisyal na barangay. Nengnengen so opisina na barangay odino so Announcements ed BrgyLink para ed listaan na saray opisyal natan."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "greeting",
+      "title": "Greeting",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "Hello! I am BrgyLink AI, the virtual assistant for Barangay Bagong Pag-asa, San Jacinto. How can I help you with document requests, blotter reports, announcements, or barangay services today?",
+        "tagalog": "Magandang araw! Ako ang BrgyLink AI, ang virtual assistant ng Barangay Bagong Pag-asa, San Jacinto. Paano kita matutulungan sa mga dokumento, blotter, anunsyo, o serbisyo ng barangay ngayon?",
+        "ilocano": "Naimbag nga aldaw! Siak ni BrgyLink AI, ti virtual assistant ti Barangay Bagong Pag-asa, San Jacinto. Kasano a makatulongak kadagiti dokumento, blotter, anunsio, wenno serbisyo ti barangay tatta?",
+        "pangasinan": "Maabig ya agew! Siak si BrgyLink AI, so virtual assistant na Barangay Bagong Pag-asa, San Jacinto. Panon ta kan natulongan ed saray dokumento, blotter, anunsyo, odino serbisyo na barangay natan?"
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "goodbye",
+      "title": "Goodbye",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "Thank you for using BrgyLink AI! If you need anything else, I am always here to assist. Stay safe and have a wonderful day!",
+        "tagalog": "Maraming salamat sa paggamit ng BrgyLink AI! Kung may iba ka pang katanungan, narito lamang ako handang tumulong. Mag-ingat ka palagi at magandang araw!",
+        "ilocano": "Agyamanak unay iti panagusar iti BrgyLink AI! No adda pay masapulmo, situtulokak a tumulong. Agannadka kanayon ken naimbag nga aldaw!",
+        "pangasinan": "Balbaleg ya salamat ed panangusar mo ed BrgyLink AI! No wala ni ray tepet mo diad ontumbok, wadya ak labat ya ontulong. Man-ingat ka lanang tan maabig ya agew!"
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "thanks",
+      "title": "Thanks",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "You're very welcome! Glad to assist you as a resident of Barangay Bagong Pag-asa. Feel free to ask if you need further guidance.",
+        "tagalog": "Walang anuman! Ikinagagalak kong makatulong sa iyo bilang residente ng Barangay Bagong Pag-asa. Huwag mag-atubiling magtanong kung may kailangan ka pa.",
+        "ilocano": "Awan aniamanna kabsat! Naragsakak a makatulong kenka kas kailian iti Barangay Bagong Pag-asa. Agsaludsodka laeng no adda pay masapulmo.",
+        "pangasinan": "Anggapoy kabaliksan kabaleyan! Maliket ak ya makatulong ed sika bilang residente na Barangay Bagong Pag-asa. Tepet ka labat no wala ni nakaukol mo."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "solo_parent",
+      "title": "Solo Parent",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For information about Solo Parent ID and welfare benefits in Barangay Bagong Pag-asa, please visit the barangay office or check the Announcements section in BrgyLink.",
+        "tagalog": "Para sa impormasyon tungkol sa Solo Parent ID at mga benepisyo sa Barangay Bagong Pag-asa, bumisita sa opisina ng barangay o tingnan ang Announcements sa BrgyLink.",
+        "ilocano": "Para iti impormasion maipapan iti Solo Parent ID ken dagiti benepisio iti Barangay Bagong Pag-asa, bisitaen ti opisina ti barangay wenno kitaen ti Announcements iti BrgyLink.",
+        "pangasinan": "Para ed impormasyon nipaakar ed Solo Parent ID tan saray benepisyo ed Barangay Bagong Pag-asa, bisitaen so opisina na barangay odino nengnengen so Announcements ed BrgyLink."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "senior_citizen",
+      "title": "Senior Citizen",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For information about Senior Citizen ID and OSCA services in Barangay Bagong Pag-asa, please visit the barangay office or check the Announcements section in BrgyLink.",
+        "tagalog": "Para sa impormasyon tungkol sa Senior Citizen ID at mga serbisyo ng OSCA sa Barangay Bagong Pag-asa, bumisita sa opisina ng barangay o tingnan ang Announcements sa BrgyLink.",
+        "ilocano": "Para iti impormasion maipapan iti Senior Citizen ID ken serbisio ti OSCA iti Barangay Bagong Pag-asa, bisitaen ti opisina ti barangay wenno kitaen ti Announcements iti BrgyLink.",
+        "pangasinan": "Para ed impormasyon nipaakar ed Senior Citizen ID tan saray serbisyo na OSCA ed Barangay Bagong Pag-asa, bisitaen so opisina na barangay odino nengnengen so Announcements ed BrgyLink."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "lupon",
+      "title": "Lupon",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For disputes that may be resolved at the barangay level, the Lupon Tagapamayapa handles conciliation and mediation. Please visit the barangay office to file a complaint or inquire about the process.",
+        "tagalog": "Para sa mga alitang maaaring resolbahin sa antas ng barangay, ang Lupon Tagapamayapa ang nag-aasikaso ng conciliation at mediation. Bumisita sa opisina ng barangay para mag-file ng reklamo o magtanong tungkol sa proseso.",
+        "ilocano": "Para kadagiti kolkol a mabalin a marisut iti lebel ti barangay, ti Lupon Tagapamayapa ti mangasikaso iti conciliation ken mediation. Bisitaen ti opisina ti barangay tapno ag-file iti reklamo wenno saludsoden ti proseso.",
+        "pangasinan": "Para ed saray alitan ya nayarin resolbien ed lebel na barangay, say Lupon Tagapamayapa so mangaasikaso na conciliation tan mediation. Bisitaen so opisina na barangay pian man-file na reklamo odino mantepet nipaakar ed proseso."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "aics_assistance",
+      "title": "Aics Assistance",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For financial assistance, medical or burial aid (AICS), relief, or social welfare programs, please visit the Barangay Bagong Pag-asa office to inquire about available services and requirements.",
+        "tagalog": "Para sa tulong pinansyal, medikal o burial aid (AICS), relief, o mga programa ng social welfare, bumisita po sa opisina ng Barangay Bagong Pag-asa para magtanong tungkol sa mga available na serbisyo at kinakailangan.",
+        "ilocano": "Para iti tulong-pinansyal, medikal wenno burial aid (AICS), relief, wenno programa ti social welfare, bisitaen ti opisina ti Barangay Bagong Pag-asa tapno saludsoden dagiti magun-od a serbisio ken kasapulan.",
+        "pangasinan": "Para ed tulong-pinansyal, medikal odino burial aid (AICS), relief, odino saray programa na social welfare, bisitaen so opisina na Barangay Bagong Pag-asa pian mantepet nipaakar ed saray serbisyo tan kailangan."
+      },
+      "verified": false,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "document_request",
+      "title": "Document Request",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "Which document do you need? You can request a Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, or Barangay ID through Document Requests in BrgyLink.",
+        "tagalog": "Anong dokumento po ang kailangan ninyo? Maaari kayong humiling ng Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, o Barangay ID sa pamamagitan ng Document Requests sa BrgyLink.",
+        "ilocano": "Ania a dokumento ti kasapulam? Mabalin ti agkiddaw iti Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, wenno Barangay ID babaen ti Document Requests iti BrgyLink.",
+        "pangasinan": "Antoy dokumento ya kailangan mo? Nayari kayon mangala na Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, odino Barangay ID diad Document Requests ed BrgyLink."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "language_support",
+      "title": "Language Support",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "Yes! I can understand and respond in Pangasinan, Ilocano, and Tagalog (as well as English). Feel free to ask your question in any of these languages!",
+        "tagalog": "Opo! Nakakaintindi at nakakasagot ako sa tatlong pangunahing wika: Tagalog, Ilocano, at Pangasinan (at pati na rin sa English). Maaari kang magtanong sa alinman sa mga wikang ito anumang oras!",
+        "ilocano": "Wen! Makaawat ken makasungbatak iti tallo a kangrunaan a pagsasao: Ilocano, Tagalog, ken Pangasinan (ken kasta met iti English). Mabalinmo ti agsaludsod iti aniaman kadagitoy a wika!",
+        "pangasinan": "On! Makatalos tan makasungbat ak ed taloran manunan salita: Pangasinan, Tagalog, tan Ilocano (tan pati met ed English). Nayari kayon mantepet ed dinanman ed sarayan salita ed anggan anton oras!"
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "about_app",
+      "title": "About App",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "BrgyLink AI can guide you through BrgyLink topics: registration and email verification, password recovery, document requests, blotter reports, feedback, announcements, civic tasks, events, and where to check officials information. You may ask in English, Tagalog, Ilocano, or Pangasinan. I cannot access accounts, passwords, OTPs, IDs, personal submissions, live schedules, or emergency services.",
+        "tagalog": "Makakatulong ang BrgyLink AI sa mga paksa sa BrgyLink: registration at email verification, password recovery, document requests, blotter reports, feedback, announcements, civic tasks, events, at kung saan titingnan ang impormasyon tungkol sa officials. Maaari kang magtanong sa English, Tagalog, Ilocano, o Pangasinan. Hindi ko naa-access ang accounts, passwords, OTPs, IDs, personal submissions, live schedules, o emergency services.",
+        "ilocano": "Makatulong ti BrgyLink AI kadagiti paksa iti BrgyLink: registration ken email verification, password recovery, document requests, blotter reports, feedback, announcements, civic tasks, events, ken sadino a kitaen ti impormasyon maipapan kadagiti officials. Mabalin a mangsaludsod iti English, Tagalog, Ilocano, wenno Pangasinan. Saan a ma-access ti chatbot dagiti account, password, OTP, ID, personal submission, live schedule, wenno emergency services.",
+        "pangasinan": "Nayarin makatulong so BrgyLink AI ed saray paksa ed BrgyLink: registration tan email verification, password recovery, document requests, blotter reports, feedback, announcements, civic tasks, events, tan iner ya nengnengen so impormasyon nipaakar ed officials. Nayarin magtanong ed English, Tagalog, Ilocano, odino Pangasinan. Ag na-access na chatbot so accounts, passwords, OTPs, IDs, personal submissions, live schedules, odino emergency services."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "voter_registration",
+      "title": "Voter Registration",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For voter registration information, please visit the barangay office or COMELEC. Check the Announcements section in BrgyLink for any posted registration schedules.",
+        "tagalog": "Para sa impormasyon tungkol sa voter registration, bumisita sa opisina ng barangay o COMELEC. Tingnan ang Announcements sa BrgyLink para sa mga naka-post na schedule ng registration.",
+        "ilocano": "Para iti impormasion maipapan iti voter registration, bisitaen ti opisina ti barangay wenno COMELEC. Kitaen ti Announcements iti BrgyLink para kadagiti naipablaak nga iskedyul ti registration.",
+        "pangasinan": "Para ed impormasyon nipaakar ed voter registration, bisitaen so opisina na barangay odino COMELEC. Nengnengen so Announcements ed BrgyLink para ed saray aka-post ya schedule na registration."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "health_services",
+      "title": "Health Services",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "For information about health services at the Barangay Health Center, including available programs and schedules, please visit the health center or check the Announcements section in BrgyLink.",
+        "tagalog": "Para sa impormasyon tungkol sa mga serbisyong pangkalusugan sa Barangay Health Center, kasama ang mga programa at schedule, bumisita sa health center o tingnan ang Announcements sa BrgyLink.",
+        "ilocano": "Para iti impormasion maipapan kadagiti serbisio ti salun-at iti Barangay Health Center, agraman dagiti programa ken iskediul, bisitaen ti health center wenno kitaen ti Announcements iti BrgyLink.",
+        "pangasinan": "Para ed impormasyon nipaakar ed saray serbisyo na salud ed Barangay Health Center, kaibay saray programa tan schedule, bisitaen so health center odino nengnengen so Announcements ed BrgyLink."
+      },
+      "verified": false,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "events",
+      "title": "Community Events",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "Open the Events tab under Civic Tasks & Community Events, choose an active event, and read its date, time, location, and instructions. If proof is requested, take a clear participation photo and tap Submit Participation Proof. Submitted is not the same as Approved. Check the app's displayed status or ask the barangay office if no review status is shown. The chatbot cannot see live event details or your personal approval result.",
+        "tagalog": "Buksan ang Events tab sa Civic Tasks & Community Events, pumili ng aktibong event, at basahin ang petsa, oras, lugar, at tagubilin. Kung kailangan ng proof, kumuha ng malinaw na larawan ng pakikilahok at i-tap ang Submit Participation Proof. Hindi pareho ang Submitted at Approved. Tingnan ang status na ipinapakita ng app o magtanong sa opisina ng barangay kung walang review status. Hindi nakikita ng chatbot ang live event details o personal na approval result.",
+        "ilocano": "Lukatan ti Events tab iti Civic Tasks & Community Events, piliem ti aktibo nga event, ken basaem ti petsa, oras, lugar, ken tagubilin. No kasapulan ti proof, alaem ti nalawag a ladawan ti panagpaset ken i-tap ti Submit Participation Proof. Saan nga agpada ti Submitted ken Approved. Kitaem ti status iti app wenno agsaludsod iti opisina ti barangay no awan ti review status. Saan a makita ti chatbot ti live event details wenno personal a approval result.",
+        "pangasinan": "Lukatan so Events tab ed Civic Tasks & Community Events, piliyen so aktibon event, tan basaen so petsa, oras, lugar, tan tagubilin. No kasapulan so proof, alaen so malinew ya litrato na pakikiba tan i-tap so Submit Participation Proof. Agpareho so Submitted tan Approved. Nengnengen so status ed app odino mantepet ed opisina na barangay no anggapo so review status. Ag nanengneng na chatbot so live event details odino personal ya approval result."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "App navigation copy only; event details remain in the live Events screen.",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "fallback",
+      "title": "Fallback",
+      "needs_staff_verification": false,
+      "requirements": [],
+      "fee_php": null,
+      "processing_time": null,
+      "answer": {
+        "english": "I specialize in Barangay Bagong Pag-asa services including Document Requests (Clearance, Indigency, Residency, ID), Blotter Reports, AICS Assistance, Lupon mediation, and Office details. Could you please rephrase or ask about barangay services?",
+        "tagalog": "Ipagpaumanhin mo, hindi ko lubos na naintindihan ang iyong tanong. Makakatulong ako sa mga serbisyo ng Barangay Bagong Pag-asa tulad ng Document Requests (Clearance, Indigency, Residency, ID), Blotter Reports, Ayuda/AICS, Lupon, at Opisina. Maaari mo bang linawin o itanong ang tungkol sa serbisyo ng barangay?",
+        "ilocano": "Dispensaren, saanko unay a naawatan ti saludsodmo. Makatulongak kadagiti serbisyo ti Barangay Bagong Pag-asa kas iti Document Requests (Clearance, Indigency, Residency, ID), Blotter Reports, Ayuda/AICS, Lupon, ken Opisina. Mabalinmo kadi a palawagen wenno agsaludsod maipapan kadagiti serbisyo ti barangay?",
+        "pangasinan": "Pasensya la kabaleyan, agko unay atalosan so tepet mo. Makatulong ak ed saray serbisyo na Barangay Bagong Pag-asa singa Document Requests (Clearance, Indigency, Residency, ID), Blotter Reports, Ayuda/AICS, Lupon, tan Opisina. Nayarim kasi ya ipalinew odino mantepet nipaakar ed serbisyo na barangay?"
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": "2026-09-29T00:00:00Z",
+      "review_notes": "Imported non-service intent",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "out_of_scope",
+      "title": "Out Of Scope",
+      "answer": {
+        "english": "I'm a barangay assistant. I don't know about that.",
+        "tagalog": "Ako ay isang barangay assistant. Hindi ko alam ang tungkol diyan.",
+        "ilocano": "Siak ket barangay assistant. Saanko nga ammo dayta.",
+        "pangasinan": "Siak et barangay assistant. Agko amta itan."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "system_copy",
+      "requires_verification": false
+    },
+    {
+      "intent": "safety_threat",
+      "title": "Safety Threat",
+      "answer": {
+        "english": "Please contact emergency services (911) immediately.",
+        "tagalog": "Mangyaring tumawag sa emergency services (911) kaagad.",
+        "ilocano": "Pangngaasi nga umawag ti emergency services (911) a dagus.",
+        "pangasinan": "Tawagan so emergency services (911) a tampol."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    },
+    {
+      "intent": "medical_non_emergency",
+      "title": "Medical Non Emergency",
+      "answer": {
+        "english": "Please visit the barangay health center during operating hours.",
+        "tagalog": "Mangyaring pumunta sa health center ng barangay habang bukas.",
+        "ilocano": "Pangngaasi nga mapan iti health center ti barangay kabayatan nga lukat.",
+        "pangasinan": "Umapay ed health center na barangay legan na pakanengnengan."
+      },
+      "verified": false,
+      "verified_by": null,
+      "verified_at": null,
+      "expires_at": null,
+      "source": null,
+      "last_reviewed_at": null,
+      "review_notes": "",
+      "content_type": "barangay_fact",
+      "requires_verification": true
+    }
+  ]
+}

chatbot_runtime/service.py

@@ -0,0 +1,121 @@
+"""HTTP-independent request handling for the bundled BrgyLink chatbot."""
+
+import re
+import threading
+import time
+from collections import OrderedDict
+
+from .smart_classifier import (
+    MODEL_VERSION,
+    handle_message,
+    load_model,
+    new_session,
+)
+
+
+LANG_ALIASES = {
+    "en": "english",
+    "english": "english",
+    "fil": "tagalog",
+    "tl": "tagalog",
+    "tagalog": "tagalog",
+    "ilo": "ilocano",
+    "ilocano": "ilocano",
+    "pag": "pangasinan",
+    "pangasinan": "pangasinan",
+}
+LANG_DISPLAY = {
+    "pangasinan": "Pangasinan",
+    "ilocano": "Ilocano",
+    "tagalog": "Tagalog / Filipino",
+    "english": "English",
+}
+SESSION_ID_PATTERN = re.compile(r"[A-Za-z0-9_.-]{1,128}")
+
+
+class ChatService:
+    """Bounded in-memory chat state around the safety-constrained classifier."""
+
+    max_message_length = 2000
+    max_sessions = 1000
+    session_ttl_seconds = 3600
+
+    def __init__(self):
+        self.model = load_model()
+        self.sessions = OrderedDict()
+        self.session_last_seen = {}
+        self.lock = threading.Lock()
+
+    def clear_sessions(self):
+        with self.lock:
+            self.sessions.clear()
+            self.session_last_seen.clear()
+
+    def _prune_sessions(self, now):
+        expired = [
+            key for key, seen in self.session_last_seen.items()
+            if now - seen >= self.session_ttl_seconds
+        ]
+        for key in expired:
+            self.sessions.pop(key, None)
+            self.session_last_seen.pop(key, None)
+        while len(self.sessions) >= self.max_sessions:
+            key, _session = self.sessions.popitem(last=False)
+            self.session_last_seen.pop(key, None)
+
+    def respond(self, payload):
+        """Return a stable (status_code, JSON-safe payload) response tuple."""
+        if not isinstance(payload, dict):
+            return 400, {"error": "A JSON object is required."}
+
+        message = payload.get("message")
+        if not isinstance(message, str) or not message.strip():
+            return 400, {"error": "Please enter a question or message."}
+        message = message.strip()
+        if len(message) > self.max_message_length:
+            return 400, {"error": f"Messages must be at most {self.max_message_length} characters."}
+
+        session_id = payload.get("session_id")
+        if session_id is not None and (
+            not isinstance(session_id, str) or not SESSION_ID_PATTERN.fullmatch(session_id)
+        ):
+            return 400, {
+                "error": "Use a non-personal session_id of 1 to 128 letters, digits, dots, underscores or hyphens."
+            }
+
+        language = payload.get("language")
+        if language is not None:
+            if not isinstance(language, str) or language.lower().strip() not in LANG_ALIASES:
+                return 400, {"error": "Unsupported language."}
+            language = LANG_ALIASES[language.lower().strip()]
+
+        try:
+            started_at = time.time()
+            with self.lock:
+                now = time.monotonic()
+                if session_id and session_id not in self.sessions:
+                    self._prune_sessions(now)
+                    self.sessions[session_id] = new_session()
+                elif session_id and now - self.session_last_seen.get(session_id, 0) >= self.session_ttl_seconds:
+                    self.sessions[session_id] = new_session()
+
+                chat_session = self.sessions[session_id] if session_id else new_session()
+                if session_id:
+                    self.sessions.move_to_end(session_id)
+                    self.session_last_seen[session_id] = now
+                if language:
+                    chat_session["preferred_language"] = language
+                result = handle_message(message, session=chat_session, model=self.model)
+
+            detected_language = result.get("language", "english")
+            return 200, {
+                "response": result["response"],
+                "intent": result.get("intent", "unknown"),
+                "confidence": result.get("similarity", 1.0),
+                "language": detected_language,
+                "language_name": LANG_DISPLAY.get(detected_language, detected_language.capitalize()),
+                "processing_time_ms": round((time.time() - started_at) * 1000, 2),
+                "model_version": MODEL_VERSION,
+            }
+        except Exception:
+            return 500, {"error": "Failed to process chat message. Please try again."}

chatbot_runtime/smart_classifier.py

@@ -0,0 +1,909 @@
+"""
+BrgyLink Smart Classifier v7 — Prototype Multilingual Offline NLP Engine.
+Barangay assistant prototype for Barangay Bagong Pag-asa, San Jacinto.
+Languages supported: Pangasinan, Ilocano, Tagalog, English.
+
+IMPORTANT: This is a prototype. Answers come from knowledge_base.json.
+Unverified facts are flagged. The chatbot does not provide legal or medical
+advice and cannot dispatch emergency services.
+"""
+
+import json
+import hashlib
+import math
+import os
+import pickle
+import re
+import tempfile
+from collections import Counter, defaultdict
+
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+INTENTS_FILE = os.path.join(BASE_DIR, "data", "intents_brgylink_curated.json")
+KB_FILE = os.path.join(BASE_DIR, "knowledge_base.json")
+MODEL_FILE = os.path.join(BASE_DIR, "smart_classifier.pkl")
+MODEL_VERSION = 7
+FALLBACK = "out_of_scope"
+
+# --- Tuned thresholds ---
+CONFIDENCE_THRESHOLD = 0.18        # minimum score to accept an intent
+MARGIN_THRESHOLD = 0.06            # minimum gap between #1 and #2 intents
+
+# ---------------------------------------------------------------------------
+# Document aliases -> standard display name
+# ---------------------------------------------------------------------------
+DOCUMENTS = {
+    "barangay clearance": "Barangay Clearance",
+    "clearance": "Barangay Clearance",
+    "indigency": "Certificate of Indigency",
+    "certificate of indigency": "Certificate of Indigency",
+    "residency": "Certificate of Residency",
+    "certificate of residency": "Certificate of Residency",
+    "business clearance": "Business Clearance",
+    "business permit": "Business Clearance",
+    "good moral": "Certificate of Good Moral Character",
+    "good moral character": "Certificate of Good Moral Character",
+    "barangay id": "Barangay ID",
+    "bgy id": "Barangay ID",
+    "barangay i.d": "Barangay ID",
+    "barangay identification": "Barangay ID",
+}
+
+DOC_TO_INTENT = {
+    "Barangay Clearance": "clearance",
+    "Certificate of Indigency": "indigency",
+    "Certificate of Residency": "residency",
+    "Business Clearance": "business_permit",
+    "Certificate of Good Moral Character": "good_moral",
+    "Barangay ID": "barangay_id",
+}
+
+# ---------------------------------------------------------------------------
+# Alias normalization
+# ---------------------------------------------------------------------------
+ALIASES: list[tuple[re.Pattern, str]] = [
+    (re.compile(r"\bbgy\b"), "barangay"),
+    (re.compile(r"\bbrgy\b"), "barangay"),
+    (re.compile(r"\bcert\b"), "certificate"),
+    (re.compile(r"\bclrnce\b"), "clearance"),
+    (re.compile(r"\bindgncy\b"), "indigency"),
+    (re.compile(r"\bindigensy\b"), "indigency"),
+    (re.compile(r"\bindigincy\b"), "indigency"),
+    (re.compile(r"\bresdncy\b"), "residency"),
+    (re.compile(r"\bbus\.?\s*pmt\b"), "business permit"),
+    (re.compile(r"\bgood\s*moral\b"), "good moral"),
+    (re.compile(r"\bblotter\b"), "blotter report"),
+    (re.compile(r"\baics\b"), "aics assistance"),
+    (re.compile(r"\bdswd\b"), "dswd assistance"),
+    (re.compile(r"\bosca\b"), "osca senior citizen"),
+    (re.compile(r"\bbhc\b"), "barangay health center"),
+    (re.compile(r"\b4ps\b"), "4ps pantawid pamilya"),
+    (re.compile(r"\bsap\b"), "social amelioration program"),
+    (re.compile(r"\bkp\b"), "katarungang pambarangay"),
+    (re.compile(r"\bcomelec\b"), "comelec voter registration"),
+    (re.compile(r"\botp\b"), "one time password otp verification"),
+    (re.compile(r"\bpwd\b"), "person with disability pwd"),
+]
+
+# ---------------------------------------------------------------------------
+# SAFETY-CRITICAL: Pre-classifier keyword rules
+# These ALWAYS override the TF-IDF classifier.
+# ---------------------------------------------------------------------------
+_EMERGENCY_RE = re.compile(
+    r"\b(sunog|apoy|uram|fire|911|ambulance|ambulansya|saklolo|tulong\s+tulong|aksidente|"
+    r"inatake|heart\s*attack|aktibong\s*krimen|hostage|crime\s*in\s*progress|"
+    r"nahulog|drowning|earthquake|lindol|bagyo|typhoon|flood|baha|"
+    r"nawawala\w*\s*(na\s*)?(bata|tao|anak)|kidnap|active\s*shooter|nawawalang|"
+    r"weapons?|active\s*assault|imminent\s*killing|severe\s*bleeding|inability\s*to\s*breathe|"
+    r"unconsciousness|poisoning|binubugbog|binugbog|sinasaksak|may\s*baril|binabaril|"
+    r"assault|sinakal|pinugutan|patay|pinatay|pumatay|self[\s\-]?harm|suicide|"
+    r"papatayin|patayin|gustong\s*mamatay|ayaw\s*(ko\s*)?na\s*mabuhay|kill|nananaksak|"
+    r"nagdudugo|bleeding|hirap\s*huminga|difficulty\s*breathing|"
+    r"(?:cannot|can\s*t|cant|unable\s*to)\s*breathe|"
+    r"(?:not|stopped|stops)\s*breathing|chok(?:e|es|ed|ing)|"
+    r"(?:cannot|can\s*t|cant)\s*catch\s*(?:my|their|his|her|our)?\s*breath|"
+    r"struggling\s*to\s*breathe|gasping\s*(?:for\s*)?air|hurt\s*myself|"
+    r"hindi\s*(?:na\s*)?makahinga|di\s*makahinga|"
+    r"nauubusan\s*(?:ng\s*)?hangin|saan\s*a\s*makaanges|ag\s*makainawa|"
+    r"end\s*my\s*life|wakasan\s*(?:ang\s*)?(?:aking\s*)?buhay)\b",
+    re.IGNORECASE,
+)
+
+_THREAT_RE = re.compile(
+    r"\b(nangbabanta|nagbanta|banta|sinasaktan|inaabuso|"
+    r"domestic\s*violence|violence|abuse\w*|sinaktan|pinagsasaktan|"
+    r"hinoldap|holdup|rape|pangmomolestiya|molestiya|"
+    r"stalker|stalking|nananakit|pinagbabantaan|binabanta|"
+    r"threat\w*|harass\w*|haras\w*|pang-?aabuso|"
+    r"nag-aaway|nag-aalburoto|nagwawala|naghaharas|"
+    r"nagbabanta|nang-?aaway|mangdadakip)\b",
+    re.IGNORECASE,
+)
+
+_MEDICAL_SYMPTOM_RE = re.compile(
+    r"\b(lagnat|fever|ubo|cough|sakit\s*(ng|na)\s*(ulo|tiyan|dibdib|katawan)|"
+    r"pain|masakit|sumasakit|sugat|wound|allergy|"
+    r"hilo|dizzy|diarrhea|vomit|nausea|nilalagnat|may\s*sakit|"
+    r"nahihilo|nasusuka|"
+    r"sore|infection|impeksyon|skin\s*rash|singaw|"
+    r"buntis|pregnant|prenatal|masakit\s*ang|anak\s*ko\s*may\s*sakit|"
+    r"my\s*child\s*(?:has\s*a\s*fever|is\s*sick|needs\s*help))\b",
+    re.IGNORECASE,
+)
+
+_LEGAL_RE = re.compile(
+    r"\b(abogado|lawyer|attorney|legal\s*advice|kaso|court\s*case|"
+    r"legal\s*consultation|fiscal|hukom|judge|demanda|magdemanda|"
+    r"file\s*(?:a\s*)?case|sue|kasuhan|sampahan)\b",
+    re.IGNORECASE,
+)
+
+_OUT_OF_SCOPE_RE = re.compile(
+    r"\b(passport|visa|nbi\s*clearance|psa|birth\s*certificate|"
+    r"driver.?s?\s*license|sss|pag.?ibig|phil\s*health|"
+    r"school\s*enrollment|tuition|"
+    r"basketball|nba|movie|joke|sing\s*(me\s*)?a\s*song|poem|"
+    r"weather\s*in|president\s*of|capital\s*of|recipe|"
+    r"pizza|burger|game|football|calculus|cryptocurrency|bitcoin|stock\s*market|"
+    r"renew\s*(my\s*)?passport|how\s*to\s*cook)\b",
+    re.IGNORECASE,
+)
+
+# App-flow routing is deliberately narrow. These rules only clarify the
+# current BrgyLink registration flow; they run after the safety rules above
+# and do not disclose account-specific information.
+_SIGNUP_OTP_RE = re.compile(
+    r"(?=.*\b(?:otp|one\s*time\s*password|verification\s*code|email\s*code)\b)"
+    r"(?=.*\b(?:sign\s*up|signup|register|registration|mag-?register|rehistro|parehistro)\b)",
+    re.IGNORECASE,
+)
+
+_SIGNUP_RE = re.compile(
+    r"\b(sign\s*up|signup|register|registration|mag\s*register|"
+    r"rehistro|parehistro|agparehistro|magparehistro|panagparehistro)\b"
+)
+_CREATE_ACCOUNT_RE = re.compile(
+    r"\b(create|make|open|new|gumawa|gagawa|agaramid|manggawa)\b.{0,30}\b(?:resident\s*)?account\b|"
+    r"\baccount\b.{0,25}\b(create|make|open|new|gumawa)\b"
+)
+_VOTER_RE = re.compile(r"\b(voters?|vote|voting|botante|comelec|boto|eleksyon)\b")
+_CODE_RE = re.compile(r"\b(otp|verification\s*code|email\s*code|code)\b")
+_CODE_PROBLEM_RE = re.compile(
+    r"\b(expir\w*|incorrect|invalid|wrong|never|missing|resend|"
+    r"not\s*(?:receive\w*|arriv\w*)|did\s*not|didn\s*t|"
+    r"hindi|di\s*dumating|wala|naawat|awan|anggapo|mali|"
+    r"waiting|waited|does\s*not|doesn\s*t)\b"
+)
+_PASSWORD_RE = re.compile(r"\b(password|pass\s*word|pasword)\b")
+_PASSWORD_PROBLEM_RE = re.compile(
+    r"\b(forgot\w*|forget\w*|lost|lose|losing|reset|recover\w*|nakalimut\w*|nalipat\w*|"
+    r"alingwan\w*|wrong|incorrect|invalid|mali|change|palitan)\b"
+)
+_ACCOUNT_RE = re.compile(r"\b(account|login|log\s*in|sign\s*in|sumrek|makapasok)\b")
+_ACCOUNT_REVIEW_RE = re.compile(r"\b(pending|reject\w*|refus\w*|declin\w*|approv\w*|review|submitted|naisumite)\b")
+_OFFICIALS_RE = re.compile(
+    r"\b(kapitan|captain|punong\s*barangay|kagawad|opisyal|officials?|"
+    r"barangay\s*(?:chairman|chairperson|council|leaders?)|councillors?|councilors?|tanod|sk\s*chairman)\b"
+)
+_BARANGAY_LOCATION_RE = re.compile(
+    r"\b(?:where\s*(?:is|are)|saan|nasaan|sadino|iner)\b.{0,30}"
+    r"\b(?:barangay|brgy)\b.{0,30}\bbagong\s*pag\s*asa\b|"
+    r"\bbagong\s*pag\s*asa\b.{0,30}\b(?:location|address|saan|nasaan|sadino|iner)\b"
+)
+_CAPABILITIES_RE = re.compile(
+    r"\b(?:what\s*(?:can|do)\s*(?:you|brgylink)|how\s*can\s*you\s*help|"
+    r"ano\s*(?:ang\s*)?(?:mga\s*)?(?:pwede|puwede|kaya)\s*(?:mong\s*)?gawin|"
+    r"anong\s*(?:mga\s*)?(?:tulong|serbisyo)\s*(?:ang\s*)?(?:kaya|pwede|puwede)|"
+    r"ania\s*(?:dagiti\s*)?(?:mabalin|tulong)|antoy\s*(?:saray\s*)?(?:tulong|sarag))\b"
+)
+_CIVIC_RE = re.compile(r"\b(sdg|civic\s*(?:tasks?|participation)|missions?|community\s*initiative)\b")
+_EVENT_RE = re.compile(r"\b(events?|community\s*activities)\b")
+_ID_RE = re.compile(r"\b(valid\s*id|government\s*(?:issued\s*)?id|passport|driver\w*\s*license)\b")
+_ID_PHOTO_RE = re.compile(
+    r"(?=.*\b(?:id|identification|passport|licen[cs]e)\b)"
+    r"(?=.*\b(?:photos?|pictures?|upload\w*|attach\w*|image|readable|blurry|photograph\w*)\b)"
+)
+# Never confuse a request for private credentials or somebody else's records
+# with help recovering the resident's own password. No records are accessed.
+_PRIVATE_DATA_RE = re.compile(
+    r"\b(?:admin|administrator)\b.{0,30}\b(?:password|credentials|token|secret)\b|"
+    r"\b(?:password|credentials|token|secret)\b.{0,30}\b(?:admin|administrator)\b|"
+    r"\b(?:other|another|all)\s+residents?\b.{0,40}\b(?:ids?|records?|details|data)\b|"
+    r"\b(?:neighbou?r\w*|someone|somebody|another|other)\b.{0,40}\b(?:password|credentials|private\s*records)\b"
+)
+
+# ---------------------------------------------------------------------------
+# Keyword-boost dictionary {pattern: {intent: boost_value}}
+# ---------------------------------------------------------------------------
+KEYWORD_BOOSTS: list[tuple[re.Pattern, dict]] = [
+    # Greetings
+    (re.compile(r"\b(hello|hi|hey|good\s*(morning|afternoon|evening)|kumusta|kamusta|naimbag|maabig|magandang)\b"), {"greeting": 0.50}),
+
+    # Goodbye & Farewell
+    (re.compile(r"\b(paalam|makaalis|agpakada|innakon|goodbye|bye\s*bye|quit|exit|signing\s*off)\b"), {"goodbye": 0.50}),
+    (re.compile(r"\b(salamat|maraming salamat|agyamanak|balbaleg)\b"), {"thanks": 0.25}),
+
+    # Document intents
+    (re.compile(r"\bclearance\b"), {"clearance": 0.30}),
+    (re.compile(r"\bindigenc[yi]\b"), {"indigency": 0.40}),
+    (re.compile(r"\bresidency\b"), {"residency": 0.35}),
+    (re.compile(r"\bkatibayan\s+na\s+nakatira\b"), {"residency": 0.60}),
+    (re.compile(r"\bproof\s+of\s+residen\w*\b"), {"residency": 0.55}),
+    (re.compile(r"\bgood moral\b(?!\s*morning)"), {"good_moral": 0.40}),
+    (re.compile(r"\bbarangay i\.?d\.?\b|\bbgy id\b"), {"barangay_id": 0.50}),
+    (re.compile(r"\bbusiness (clearance|permit)\b"), {"business_permit": 0.40}),
+    (re.compile(r"\b(negosyo|sari.?sari|tindahan)\b"), {"business_permit": 0.25}),
+
+    # Emergency (supplement safety pre-classifier)
+    (re.compile(r"\b(sunog|apoy|uram|fire|911|ambulance|ambulansya)\b"), {"emergency": 0.55}),
+    (re.compile(r"\b(saklolo|tulong.*tulong|aksidente|danger|peligro)\b"), {"emergency": 0.40}),
+
+    # Blotter / complaints / disputes
+    (re.compile(r"\b(blotter|reklamo|magreklamo|ireport|panagreklamo)\b"), {"report_incident": 0.40}),
+    (re.compile(r"\b(ingay|maingay|maingal|makapaingal|riri|away|nakawan|takew)\b"), {"report_incident": 0.35}),
+
+    # Lupon / Katarungang Pambarangay
+    (re.compile(r"\b(lupon|tagapamayapa|katarungang|mediation|conciliation|alitan|kolkol|kolkolan|pangkat)\b"), {"lupon": 0.50}),
+
+    # Assistance / Ayuda / AICS
+    (re.compile(r"\b(aics|ayuda|tulong.?salapi|tulong.?pinansyal|relief|4ps|pantawid|ponpon|burial)\b"), {"aics_assistance": 0.45}),
+
+    # Senior Citizen & Solo Parent
+    (re.compile(r"\b(senior citizen|osca|matatken|lallakay|babbaket)\b"), {"senior_citizen": 0.50}),
+    (re.compile(r"\b(solo parent|single parent|nag.?iisang magulang|agsolsolo a nagannak)\b"), {"solo_parent": 0.50}),
+
+    # Health (but not medical symptoms — those go to safety pre-classifier)
+    (re.compile(r"\b(health center|bhc|bakuna|vaccin\w*|prenatal|gamot|agas|bitamina|salun.?at)\b"), {"health_services": 0.45}),
+
+    # Garbage
+    (re.compile(r"\b(basura|garbage|trash|hakot|panangala na basura|panag.?ala ti basura|kolekta)\b"), {"garbage": 0.50}),
+
+    # Office hours / Location
+    (re.compile(r"\b(office hours|opening times|oras na opisina|oras ti opisina|tanggapan|schedule\s*(ng|na|ti)\s*opisina)\b|\b(?:bukas|open)\b.{0,25}\b(?:opisina|office|barangay hall)\b"), {"office_hours": 0.45}),
+    (re.compile(r"\b(where\s*(?:is|can\s*i\s*find)\s*(?:the\s*)?(?:office|barangay\s*hall)|nasaan\s*(ang\s*)?opisina|saan\s*(so|ti)\s*opisina|address|location\s*(of|ng|na)?\s*(the\s*)?(office|barangay)?)\b"), {"office_hours": 0.45}),
+
+    # Fees — must beat clearance when fee-related words present
+    (re.compile(r"\b(fees?|bayad|bayar|magkano|panpiga|mano ti bayad|mano so bayad|presyo|singil|cost|price|how\s*much)\b"), {"fees": 0.50}),
+
+    # Voter Registration
+    (re.compile(r"\b(voter|botante|comelec|rehistro.*boto|eleksyon)\b"), {"voter_registration": 0.50}),
+
+    # SDG / Community Initiatives
+    (re.compile(r"\b(sdg|community initiative|civic task|tree planting|clean.?up)\b"), {"sdg_mission": 0.50}),
+
+    # Officials
+    (re.compile(r"\b(kapitan|punong barangay|kagawad|opisyal|officials|tanod|sk chairman)\b"), {"officials": 0.45}),
+
+    # Status / Tracking
+    (re.compile(r"\b(status|track|ready for pickup|nasaan na|subaybayan|nabantayan)\b"), {"document_status": 0.30}),
+
+    # About App
+    (re.compile(r"\b(what is brgylink|ano ang brgylink|ania ti brgylink|antoy brgylink|features of brgylink)\b"), {"about_app": 0.50}),
+]
+
+# ---------------------------------------------------------------------------
+# Helper responses (non-factual UI prompts)
+# ---------------------------------------------------------------------------
+HELPER_TEXTS = {
+    "choose_document": {
+        "english": "Which document do you need? You can request a Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, or Barangay ID.",
+        "tagalog": "Anong dokumento po ang kailangan ninyo? Maaari kayong humiling ng Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, o Barangay ID.",
+        "ilocano": "Ania a dokumento ti kasapulam kabsat? Mabalin ti agkiddaw iti Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, wenno Barangay ID.",
+        "pangasinan": "Antoy dokumento ya kasapulan mo kabaleyan? Nayari kayon mangala na Barangay Clearance, Certificate of Indigency, Certificate of Residency, Business Clearance, Certificate of Good Moral Character, odino Barangay ID."
+    },
+    "status": {
+        "english": "Open Document Requests in BrgyLink to check the status of your application (Pending, Processing, Ready for Pickup, Completed, or Rejected). The chatbot cannot access personal request details.",
+        "tagalog": "Buksan ang Document Requests sa BrgyLink upang makita ang status ng iyong request (Pending, Processing, Ready for Pickup, Completed, o Rejected). Hindi maa-access ng chatbot ang personal na request details.",
+        "ilocano": "Lukatan ti Document Requests iti BrgyLink tapno makita ti kasasaad ti kineddawmo a dokumento (Pending, Processing, Ready for Pickup, Completed, wenno Rejected). Saan a maakses ti chatbot ti personal a request details.",
+        "pangasinan": "Lukatan so Document Requests ed BrgyLink pian nengnengen so status na kineddeng mon dokumento (Pending, Processing, Ready for Pickup, Completed, odino Rejected). Ag nayarin aksesan na chatbot so personal ya request details."
+    },
+    "legal_disclaimer": {
+        "english": "The chatbot cannot provide legal advice. For legal concerns, you may visit the barangay office to inquire about Lupon Tagapamayapa (mediation) if the dispute is within barangay jurisdiction, or consult a lawyer for matters beyond barangay scope.",
+        "tagalog": "Hindi makapagbigay ng legal advice ang chatbot. Para sa legal concerns, bumisita sa opisina ng barangay para sa Lupon Tagapamayapa (mediation) kung sakop ng barangay ang usapin, o kumonsulta sa abogado para sa mga bagay na lampas sa sakop ng barangay.",
+        "ilocano": "Saan a makaited ti chatbot iti legal advice. Para kadagiti legal concerns, bisitaem ti opisina ti barangay tapno umammo maipapan iti Lupon Tagapamayapa (mediation) no sakop ti barangay, wenno konsultaem ti abogado para kadagiti saan a sakop.",
+        "pangasinan": "Ag makaiter na legal advice so chatbot. Para ed saray legal concerns, bisitaen so opisina na barangay para ed Lupon Tagapamayapa (mediation) no sakop na barangay, odino konsultaen so abogado para ed saray agtaay ed sakop."
+    },
+    "unverified_disclaimer": {
+        "english": "\n\n(Note: This information is not verified. Please confirm with the barangay office.)",
+        "tagalog": "\n\n(Paalala: Ang impormasyong ito ay hindi pa verified. Pakikumpirma sa opisina ng barangay.)",
+        "ilocano": "\n\n(Pammalagip: Daytoy nga impormasion ket saan pay a verified. Pangngaasi a kumpirmaen iti opisina ti barangay.)",
+        "pangasinan": "\n\n(Paimano: Saya ya impormasyon et agni verified. Kumpirmaen ed opisina na barangay.)"
+    }
+}
+
+
+# ---------------------------------------------------------------------------
+# Knowledge Base Loader
+# ---------------------------------------------------------------------------
+_kb_cache: dict | None = None
+
+def load_knowledge_base() -> dict:
+    """Load knowledge_base.json and index by intent."""
+    global _kb_cache
+    if _kb_cache is not None:
+        return _kb_cache
+    with open(KB_FILE, encoding="utf-8") as f:
+        kb = json.load(f)
+    index = {}
+    for svc in kb.get("services", []):
+        index[svc["intent"]] = svc
+    _kb_cache = index
+    return index
+
+
+def get_kb_answer(intent: str, language: str, variant: str | None = None) -> str:
+    """Get the answer for an intent from the knowledge base.
+
+    Appends an unverified-data disclaimer only when content_type is
+    'barangay_fact' and the entry is not validly verified.
+    System copy (greetings, fallback, etc.) never gets the disclaimer.
+    """
+    kb = load_knowledge_base()
+    entry = kb.get(intent)
+
+    def is_valid_answer(ans):
+        if not isinstance(ans, dict):
+            return False
+        for lang in ["english", "tagalog", "ilocano", "pangasinan"]:
+            if lang not in ans or not isinstance(ans[lang], str) or not ans[lang].strip():
+                return False
+        return True
+
+    if not entry or not is_valid_answer(entry.get("answer")):
+        # Fall through to out_of_scope
+        entry = kb.get("out_of_scope", {})
+
+    answer_obj = entry.get("answer", {})
+    # Variants are still curated KB content, never generated factual answers.
+    candidate = entry.get("answer_variants", {}).get(variant) if variant else None
+    if is_valid_answer(candidate):
+        answer_obj = candidate
+    text = answer_obj.get(language, answer_obj.get("english", ""))
+
+    # Only barangay_fact entries can carry the unverified disclaimer.
+    content_type = entry.get("content_type", "barangay_fact")
+    if content_type != "barangay_fact":
+        return text
+
+    import datetime
+
+    is_verified = entry.get("verified", False)
+
+    # Check verification requirements
+    if is_verified:
+        has_reqs = all(entry.get(f) for f in ["source", "verified_by", "verified_at", "expires_at"])
+        if not has_reqs:
+            is_verified = False
+        else:
+            try:
+                expiry_date = datetime.datetime.fromisoformat(entry["expires_at"].replace("Z", "+00:00"))
+                if datetime.datetime.now(datetime.timezone.utc) > expiry_date:
+                    is_verified = False
+            except (ValueError, TypeError, AttributeError):
+                is_verified = False
+
+    if not is_verified:
+        disclaimer = HELPER_TEXTS["unverified_disclaimer"].get(language, HELPER_TEXTS["unverified_disclaimer"]["english"])
+        if disclaimer not in text:
+            text += disclaimer
+
+    return text
+
+
+# ---------------------------------------------------------------------------
+# Text preprocessing
+# ---------------------------------------------------------------------------
+def apply_aliases(text: str) -> str:
+    for pattern, replacement in ALIASES:
+        text = pattern.sub(replacement, text)
+    return text
+
+
+def normalize(text: str) -> str:
+    return re.sub(r"\s+", " ", re.sub(r"[^\w\s]", " ", text.lower())).strip()
+
+
+def char_ngrams(text: str, ns=(2, 3, 4, 5)) -> Counter:
+    padded = f" {text} "
+    c = Counter()
+    for n in ns:
+        for i in range(len(padded) - n + 1):
+            c[("c", padded[i:i+n])] += 1
+    return c
+
+
+def word_ngrams(tokens: list[str], ns=(1, 2)) -> Counter:
+    c = Counter()
+    for n in ns:
+        for i in range(len(tokens) - n + 1):
+            gram = " ".join(tokens[i:i+n])
+            c[("w", gram)] += 1
+    return c
+
+
+def featurize(text: str) -> Counter:
+    norm = normalize(apply_aliases(normalize(text)))
+    tokens = norm.split()
+    features = char_ngrams(norm)
+    features.update(word_ngrams(tokens))
+    return features
+
+
+# ---------------------------------------------------------------------------
+# Scored Language Detection (Ilocano, Pangasinan, Tagalog, English)
+# ---------------------------------------------------------------------------
+# Short common tokens that overlap between Pangasinan and English.
+# These get reduced weight to prevent English from being classified as Pangasinan.
+_SHORT_PAN_TOKENS = {"ed", "so", "ya", "et", "to", "mi", "yo", "da", "ak", "la"}
+
+_LANG_RULES: dict[str, list[tuple[re.Pattern, float]]] = {
+    "ilocano": [
+        (re.compile(r"\b(dagiti|kadagiti|wenno|ket|tapno|ken|nga|met|pay|laeng|amin|ditoy|daytoy|kaniak|kenka|kadakayo|datayo|dakami|isuda|kasta)\b"), 1.4),
+        (re.compile(r"\b(mabalin|agkiddaw|kasano|wen|saan|apay|sadino|kaano|kaanu|mano ti|anian|ania|anya|masapulko|masapul)\b"), 2.5),
+        (re.compile(r"\b(ilocano|ilokano|siasino|nalipatak|makaanges|ubing|kabsat|kailian|agas|ubbing|kolkol|riri|uram|panagbiag|malungsot|agyamanak|agpakada|innakon|agsapa)\b"), 3.5),
+        (re.compile(r"\b(naimbag|aldaw|bigat|malem|rabii|dios ti agngina|makasungbatak|makaawat)\b"), 3.5),
+        (re.compile(r"\b(mangited|mangaramid|pangngeddeng|panangsalaysay|lukatan|piliem|isumitem|panagkiddaw)\b"), 2.0),
+        # iti/ti get reduced weight to avoid false positives on short text
+        (re.compile(r"\biti\b"), 0.6),
+        (re.compile(r"\bti\b"), 0.4),
+    ],
+    "pangasinan": [
+        # High-confidence Pangasinan markers
+        (re.compile(r"\b(saray|diad|onla|odino|pian|kabaleyan|natan)\b"), 2.5),
+        (re.compile(r"\b(mano so|panon so|antoy|anto|panon|kapigan|kasapulan|amtaen|ugugaw|makapaingal|alitan|kolkolan|apoy|ponpon|mabiin|kailangan koy|panpiga|piga)\b"), 3.2),
+        (re.compile(r"\b(pangasinan|anggapo|agko|siopa|ugaw|makainawa|makatalos|anggad|nayarin|manggawa|man.?ingat|makaalis|balbaleg|maabig|kabuasan|ngarem|agew|labi|masantos)\b"), 3.5),
+        (re.compile(r"\b(say|inkuan|nanengneng|ipaliwawa|piliyen|mangikeddeng|nengnengen|silpin)\b"), 2.0),
+        # Pangasinan pronoun 'ak' (first-person) — medium weight
+        (re.compile(r"\bak\b"), 1.5),
+        # Short tokens that also appear in English — low weight
+        (re.compile(r"\b(ed|so|ya|et|tan|met|labat)\b"), 0.3),
+    ],
+    "tagalog": [
+        (re.compile(r"\b(ang|ng|mga|sa|ay|ko|mo|po|opo|naman|lang|ba|dito|ito|yan|yun|natin|ninyo|amin|atin|nila|siya|sila)\b"), 0.8),
+        (re.compile(r"\b(magandang|kumusta|kamusta|salamat|paalam|sige|walang anuman|pasensya|maraming salamat|ingat po)\b"), 2.0),
+        (re.compile(r"\b(paano|anong|ano|saan|kailan|sino|bakit|hindi|yung|maling|kailangan|gusto|mayroon|magkano|bayad|libre|puwede|maaari)\b"), 2.0),
+        (re.compile(r"\b(tagalog|filipino|pilipino|kumuha|makuha|humiling|ireport|magreklamo|kapitan|kagawad|tanod|nakatira)\b"), 3.0),
+    ],
+}
+
+
+def detect_language(message: str) -> str:
+    """Detect whether text is Ilocano, Pangasinan, Tagalog, or English.
+
+    Uses a scoring system with safety checks against false positives
+    from short overlapping tokens (e.g. 'to', 'so', 'ed' which appear
+    in both English and Pangasinan).
+    """
+    value = normalize(message)
+    tokens = set(value.split())
+
+    scores = {lang: 0.0 for lang in _LANG_RULES}
+    match_counts = {lang: 0 for lang in _LANG_RULES}
+
+    for lang, rules in _LANG_RULES.items():
+        for pattern, weight in rules:
+            matches = len(pattern.findall(value))
+            if matches > 0:
+                scores[lang] += matches * weight
+                match_counts[lang] += matches
+
+    best_lang = max(scores, key=scores.__getitem__)
+    best_score = scores[best_lang]
+
+    # Require a minimum threshold
+    if best_score <= 0.5:
+        return "english"
+
+    # Safety: If Pangasinan won but ALL matching tokens are short/ambiguous,
+    # and there are no high-confidence Pangasinan markers, default to English.
+    if best_lang == "pangasinan":
+        pan_only_short = tokens.issubset(
+            _SHORT_PAN_TOKENS | {t for t in tokens if len(t) <= 3}
+            | set(value.split())
+        )
+        # Check if any high-confidence Pangasinan word is present
+        high_conf_pan = re.search(
+            r"\b(saray|diad|onla|odino|pian|kabaleyan|pangasinan|makatalos|"
+            r"maabig|kabuasan|balbaleg|antoy|panon|kapigan|nayarin|mangikeddeng|"
+            r"nengnengen|say|anggad|ugugaw|kolkolan|panpiga|mabiin)\b",
+            value,
+        )
+        if not high_conf_pan and best_score < 2.0:
+            return "english"
+
+    return best_lang
+
+
+# ---------------------------------------------------------------------------
+# Language switch intent detection
+# ---------------------------------------------------------------------------
+_LANG_SWITCH = re.compile(
+    r"(sagot|sumagot|reply|response|respond|speak|salita|wika|sagutin|usaren|pansalita|answer|isagot).{0,30}"
+    r"(tagalog|filipino|ilocano|ilokano|pangasinan|english|ingles)"
+    r"|(tagalog|filipino|ilocano|ilokano|pangasinan|english|ingles).{0,30}"
+    r"(ang|lang|only|please|lamang|na lang|so usaren|ti usarem)",
+    re.IGNORECASE,
+)
+
+_LANG_SWITCH_ENGLISH = re.compile(
+    r"(answer|reply|speak|respond|talk).{0,20}(in\s+)?(english|ingles)"
+    r"|(english|ingles).{0,20}(please|lang|only|po)",
+    re.IGNORECASE,
+)
+
+def _extract_switch_language(message: str) -> str | None:
+    """Extract the target language from a language-switch request."""
+    value = message.lower()
+    if _LANG_SWITCH_ENGLISH.search(value):
+        return "english"
+    m = _LANG_SWITCH.search(value)
+    if not m:
+        return None
+    full = m.group(0).lower()
+    if "ilocano" in full or "ilokano" in full:
+        return "ilocano"
+    if "pangasinan" in full:
+        return "pangasinan"
+    if "tagalog" in full or "filipino" in full:
+        return "tagalog"
+    if "english" in full or "ingles" in full:
+        return "english"
+    return None
+
+
+def language_switch(message: str) -> bool:
+    return _extract_switch_language(message) is not None
+
+
+# ---------------------------------------------------------------------------
+# Training
+# ---------------------------------------------------------------------------
+def train() -> dict:
+    with open(INTENTS_FILE, "rb") as f:
+        training_bytes = f.read()
+    intents = json.loads(training_bytes)["intents"]
+
+    docs = [(item["tag"], pattern) for item in intents for pattern in item["patterns"]]
+    freq = Counter()
+    features_list = []
+    for _, text in docs:
+        fv = featurize(text)
+        features_list.append(fv)
+        freq.update(fv.keys())
+
+    N = len(docs)
+    idf = {k: math.log((1 + N) / (1 + cnt)) + 1 for k, cnt in freq.items()}
+
+    centroids = defaultdict(Counter)
+    counts = Counter()
+    for (tag, _), fv in zip(docs, features_list):
+        counts[tag] += 1
+        for k, v in fv.items():
+            centroids[tag][k] += v * idf.get(k, 1)
+
+    for tag in centroids:
+        n = counts[tag]
+        for k in centroids[tag]:
+            centroids[tag][k] /= n
+
+    model = {
+        "version": MODEL_VERSION,
+        "training_sha256": hashlib.sha256(training_bytes).hexdigest(),
+        "idf": idf,
+        "centroids": dict(centroids),
+    }
+    # An interrupted training run must not replace a working model with a
+    # partially written pickle. Save alongside the target and atomically swap.
+    fd, temporary_path = tempfile.mkstemp(prefix=".classifier-", dir=os.path.dirname(MODEL_FILE))
+    try:
+        with os.fdopen(fd, "wb") as f:
+            pickle.dump(model, f)
+        os.replace(temporary_path, MODEL_FILE)
+    finally:
+        if os.path.exists(temporary_path):
+            os.unlink(temporary_path)
+    return model
+
+
+def load_model() -> dict:
+    if not os.path.exists(MODEL_FILE):
+        return train()
+    try:
+        with open(MODEL_FILE, "rb") as f:
+            model = pickle.load(f)
+    except (pickle.UnpicklingError, EOFError, ValueError, AttributeError):
+        return train()
+    with open(INTENTS_FILE, "rb") as f:
+        fingerprint = hashlib.sha256(f.read()).hexdigest()
+    if (not isinstance(model, dict) or model.get("version") != MODEL_VERSION
+            or model.get("training_sha256") != fingerprint
+            or not isinstance(model.get("idf"), dict)
+            or not isinstance(model.get("centroids"), dict) or not model["centroids"]):
+        return train()
+    return model
+
+
+def cosine(left: Counter, right: dict) -> float:
+    dot = sum(v * right.get(k, 0) for k, v in left.items())
+    a = math.sqrt(sum(x * x for x in left.values()))
+    b = math.sqrt(sum(x * x for x in right.values()))
+    return dot / (a * b) if a and b else 0.0
+
+
+def compute_boost(value: str) -> dict[str, float]:
+    boost = defaultdict(float)
+    for pattern, intent_boosts in KEYWORD_BOOSTS:
+        if pattern.search(value):
+            for intent, amount in intent_boosts.items():
+                boost[intent] += amount
+    return boost
+
+
+def document_in(message: str) -> str | None:
+    value = normalize(apply_aliases(normalize(message)))
+    # Don't match "cert" alone — too ambiguous
+    return next((doc for key, doc in DOCUMENTS.items() if key != "cert" and key in value), None)
+
+
+def new_session() -> dict:
+    return {
+        "preferred_language": None,
+        "pending": None,
+        "selected_document": None,
+        "last_intent": None,
+        "turn_count": 0,
+    }
+
+
+def classify(message: str, model: dict) -> tuple[str, float, float]:
+    """Classify a message. Returns (intent, score, margin).
+
+    margin is the gap between the top intent and the runner-up.
+    """
+    fv = featurize(message)
+    vec = {k: v * model["idf"].get(k, 1) for k, v in fv.items()}
+    boost = compute_boost(normalize(message))
+
+    ranked = sorted(
+        (
+            (tag, cosine(vec, centroid) + boost.get(tag, 0))
+            for tag, centroid in model["centroids"].items()
+        ),
+        key=lambda x: x[1],
+        reverse=True,
+    )
+    intent, score = ranked[0]
+    runner_up_score = ranked[1][1] if len(ranked) > 1 else 0.0
+    margin = score - runner_up_score
+
+    # Strict threshold + margin requirement
+    if score < CONFIDENCE_THRESHOLD or margin < MARGIN_THRESHOLD:
+        return FALLBACK, score, margin
+
+    return intent, score, margin
+
+
+def _build(intent: str, score: float, language: str, response: str, session: dict) -> dict:
+    session["last_intent"] = intent
+    session["turn_count"] = session.get("turn_count", 0) + 1
+    return {
+        "intent": intent,
+        "similarity": round(score, 4),
+        "language": language,
+        "response": response,
+        "session": session,
+    }
+
+
+# ---------------------------------------------------------------------------
+# Main message handler
+# ---------------------------------------------------------------------------
+def handle_message(message: str, session: dict | None = None, model: dict | None = None) -> dict:
+    session = session or new_session()
+    model = model or load_model()
+    value = normalize(message)
+
+    # Reset command
+    if value in {"reset", "restart", "clear", "start over"}:
+        session.clear()
+        session.update(new_session())
+        return _build("reset", 1.0, "english", "Conversation reset.", session)
+
+    # --- Language detection ---
+    detected = detect_language(message)
+    language = session.get("preferred_language") or detected
+
+    # Language switch request
+    switch_lang = _extract_switch_language(message)
+    if switch_lang:
+        language = switch_lang
+        session["preferred_language"] = language
+
+    # ===================================================================
+    # SAFETY PRE-CLASSIFIER — always runs first, overrides everything
+    # ===================================================================
+
+    # 1. Emergency (life-threatening)
+    if _EMERGENCY_RE.search(value):
+        resp = get_kb_answer("emergency", language)
+        return _build("emergency", 1.0, language, resp, session)
+
+    # 2. Threats, violence, abuse, self-harm
+    if _THREAT_RE.search(value):
+        resp = get_kb_answer("safety_threat", language)
+        return _build("safety_threat", 1.0, language, resp, session)
+
+    # 3. Medical symptoms (non-emergency) — route to health guidance
+    if _MEDICAL_SYMPTOM_RE.search(value):
+        # Check if also emergency-level
+        resp = get_kb_answer("medical_non_emergency", language)
+        return _build("medical_non_emergency", 1.0, language, resp, session)
+
+    # 4. Legal questions
+    if _LEGAL_RE.search(value):
+        resp = HELPER_TEXTS["legal_disclaimer"][language]
+        return _build("legal_disclaimer", 1.0, language, resp, session)
+
+    # 5. Obvious out-of-scope topics
+    # Passport/licence *upload* guidance for signup is in scope, not advice
+    # about obtaining or renewing those national documents.
+    signup_id = bool((_SIGNUP_RE.search(value) or _CREATE_ACCOUNT_RE.search(value)) and _ID_RE.search(value))
+    national_document_request = re.search(
+        r"\b(renew|renewal|apply\s*for|obtain|get\s*(?:a|my))\b.{0,25}\b(passport|license)\b|"
+        r"\b(passport|license)\b.{0,25}\b(renew|renewal)\b", value
+    )
+    scope_value = _ID_RE.sub("", value) if signup_id and not national_document_request else value
+    if _PRIVATE_DATA_RE.search(value) or _OUT_OF_SCOPE_RE.search(scope_value):
+        resp = get_kb_answer("out_of_scope", language)
+        return _build("out_of_scope", 1.0, language, resp, session)
+
+    # Explicit app concepts resolve common short wording without lowering the
+    # classifier's uncertainty threshold. Recovery wins over signup timing.
+    if _CODE_RE.search(value) and _CODE_PROBLEM_RE.search(value):
+        return _build("account_help", 0.98, language, get_kb_answer("account_help", language, "otp"), session)
+    if _PASSWORD_RE.search(value) and (_PASSWORD_PROBLEM_RE.search(value) or re.search(r"\bagko\s*amta\b", value)):
+        return _build("account_help", 0.98, language, get_kb_answer("account_help", language, "password"), session)
+    signup_question = bool(_SIGNUP_RE.search(value) or _CREATE_ACCOUNT_RE.search(value))
+    if (_ACCOUNT_RE.search(value) or signup_question) and _ACCOUNT_REVIEW_RE.search(value):
+        return _build("account_help", 0.98, language, get_kb_answer("account_help", language, "review"), session)
+    if _ACCOUNT_RE.search(value) and not signup_question:
+        variant = "review" if _ACCOUNT_REVIEW_RE.search(value) else None
+        return _build("account_help", 0.98, language, get_kb_answer("account_help", language, variant), session)
+    if _EVENT_RE.search(value):
+        return _build("events", 0.98, language, get_kb_answer("events", language), session)
+    if _CIVIC_RE.search(value):
+        return _build("sdg_mission", 0.98, language, get_kb_answer("sdg_mission", language), session)
+    if _OFFICIALS_RE.search(value):
+        return _build("officials", 0.98, language, get_kb_answer("officials", language), session)
+    if _BARANGAY_LOCATION_RE.search(value):
+        return _build("office_hours", 0.98, language, get_kb_answer("office_hours", language), session)
+    if _CAPABILITIES_RE.search(value):
+        return _build("about_app", 0.98, language, get_kb_answer("about_app", language), session)
+    if _SIGNUP_RE.search(value) and _VOTER_RE.search(value):
+        return _build("voter_registration", 0.98, language, get_kb_answer("voter_registration", language), session)
+    if _SIGNUP_OTP_RE.search(value) and not _VOTER_RE.search(value):
+        resp = get_kb_answer("registration", language)
+        return _build("registration", 0.98, language, resp, session)
+    if signup_question and not _VOTER_RE.search(value):
+        variant = "id" if _ID_RE.search(value) else None
+        return _build("registration", 0.98, language, get_kb_answer("registration", language, variant), session)
+    if _ID_RE.search(value) and re.search(r"\b(?:\d{1,2}|minor|age)\b", value):
+        return _build("registration", 0.98, language, get_kb_answer("registration", language, "id"), session)
+    if _ID_PHOTO_RE.search(value):
+        return _build("registration", 0.98, language, get_kb_answer("registration", language, "id"), session)
+
+    # ===================================================================
+    # COMPOUND QUERY DETECTION
+    # ===================================================================
+
+    # "How much for clearance?" / "bayad sa clearance" → fees, not clearance
+    _COMPOUND_FEE_RE = re.compile(
+        r"\b(fees?|bayad|bayar|magkano|panpiga|cost|price|singil|how\s*much|mano)\b"
+        r".{0,30}\b(clearance|indigency|residency|good moral|barangay id|business|permit|certificate|sertipiko|dokumento)\b",
+        re.IGNORECASE,
+    )
+    _COMPOUND_FEE_RE2 = re.compile(
+        r"\b(clearance|indigency|residency|good moral|barangay id|business|permit|certificate|sertipiko|dokumento)\b"
+        r".{0,30}\b(fees?|bayad|bayar|magkano|panpiga|cost|price|singil|how\s*much|mano)\b",
+        re.IGNORECASE,
+    )
+    if _COMPOUND_FEE_RE.search(value) or _COMPOUND_FEE_RE2.search(value):
+        doc = document_in(message)
+        if doc:
+            session["selected_document"] = doc
+        resp = get_kb_answer("fees", language)
+        return _build("fees", 0.95, language, resp, session)
+
+    # "clearance for business" → business_permit
+    if re.search(r"\bclearance\b.{0,20}\bbusiness\b|\bbusiness\b.{0,20}\bclearance\b", value):
+        resp = get_kb_answer("business_permit", language)
+        return _build("business_permit", 0.95, language, resp, session)
+
+    # ===================================================================
+    # TF-IDF CLASSIFIER
+    # ===================================================================
+    intent, score, margin = classify(message, model)
+
+    # Blotter status check
+    if re.search(r"\b(blotter|reklamo|complaint|incident report)\b", value) and \
+       re.search(r"\b(status|track|history|nasaan|naitala|in-process|update|naasikaso|pakaamta)\b", value):
+        resp = get_kb_answer("blotter_status", language)
+        return _build("blotter_status", score, language, resp, session)
+
+    # Document status check — but only if the message is clearly about status
+    _STATUS_RE = re.compile(
+        r"\b(status|track|ready for pickup|nasaan na|pending ba|approved na|processing na|rejected|"
+        r"kailan makukuha|kailan maaayos|done na|naaprubaran|subaybayan|nabantayan)\b",
+        re.IGNORECASE,
+    )
+    _DOC_OR_NAME_RE = re.compile(
+        r"\b(document|dokumento|request|hiniling|kineddaw|inkerew|"
+        r"clearance|indigency|residency|business|good\s*moral|barangay\s*id|sertipiko|certificate)\b",
+        re.IGNORECASE,
+    )
+    if _STATUS_RE.search(value) and (intent == "document_status" or _DOC_OR_NAME_RE.search(value)):
+        resp = get_kb_answer("document_status", language)
+        return _build("document_status", score, language, resp, session)
+
+    # Single-word / short document direct route
+    document = document_in(message)
+    if document and len(value.split()) <= 4 and not session.get("pending"):
+        session["selected_document"] = document
+        doc_intent = DOC_TO_INTENT.get(document, "document_request")
+        resp = get_kb_answer(doc_intent, language)
+        return _build(doc_intent, 1.0, language, resp, session)
+
+    # Resolve pending document choice
+    if session.get("pending") == "document_choice" and document:
+        session["pending"] = None
+        session["selected_document"] = document
+        doc_intent = DOC_TO_INTENT.get(document, "document_request")
+        resp = get_kb_answer(doc_intent, language)
+        return _build(doc_intent, 1.0, language, resp, session)
+
+    # Lupon mediation
+    if re.search(r"\b(lupon|katarungang pambarangay|mediation|pangkat|alitan|kolkol|kolkolan)\b", value):
+        resp = get_kb_answer("lupon", language)
+        return _build("lupon", score, language, resp, session)
+
+    # Generic document request
+    generic_doc = bool(re.search(
+        r"\b(file|apply|request|submit|humiling|mag.?file|magfile|kailangan|masapul|kasapulan|mangikeddeng)\b.{0,30}\b(document|dokumento|certificate|sertipiko|cert)\b"
+        r"|\b(document|dokumento|certificate|sertipiko)\b.{0,30}\b(file|apply|request|submit|kailangan|masapul|mangikeddeng)\b",
+        value,
+    ))
+    if generic_doc and not document:
+        session["pending"] = "document_choice"
+        return _build("document_request", score, language, HELPER_TEXTS["choose_document"][language], session)
+
+    # Named document mentioned
+    if document and intent not in {"fees", FALLBACK}:
+        session["selected_document"] = document
+        doc_intent = DOC_TO_INTENT.get(document, intent)
+        resp = get_kb_answer(doc_intent, language)
+        return _build(doc_intent, score, language, resp, session)
+
+    # ===================================================================
+    # ANSWER FROM KNOWLEDGE BASE
+    # ===================================================================
+    if switch_lang and intent in {FALLBACK, "fallback", "language_support"}:
+        intent = "language_support"
+    elif intent == "fallback":
+        intent = FALLBACK
+    resp = get_kb_answer(intent, language)
+    return _build(intent, score, language, resp, session)
+
+
+if __name__ == "__main__":
+    m = train()
+    total_patterns = sum(
+        len(i["patterns"])
+        for i in json.load(open(INTENTS_FILE, encoding="utf-8"))["intents"]
+    )
+    print(
+        f"BrgyLink Smart Classifier v{MODEL_VERSION} (prototype) trained -> {MODEL_FILE}\n"
+        f"  Intents : {len(m['centroids'])}\n"
+        f"  Patterns: {total_patterns}\n"
+        f"  Features: {len(m['idf'])} unique TF-IDF keys\n"
+        f"  Languages: Pangasinan, Ilocano, Tagalog, English\n"
+        f"  Note: This is a prototype. Answers sourced from knowledge_base.json."
+    )

test_app.py

@@ -71,6 +71,7 @@ class AIServerTests(unittest.TestCase):
         service.app.config['TESTING'] = True
         service.anticheat = ReadyAntiCheat()
         service.predictor = ReadyPredictor()
+        service.chatbot.clear_sessions()
         self.client = service.app.test_client()
         self.headers = {'Authorization': 'Bearer test-service-token'}
 
@@ -160,6 +161,27 @@ class AIServerTests(unittest.TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertEqual(service.anticheat.register_calls, 0)
 
+    def test_chat_requires_service_token_and_preserves_safety_overrides(self):
+        self.assertEqual(self.client.post('/chat', json={'message': 'hello'}).status_code, 401)
+        response = self.client.post(
+            '/chat',
+            headers=self.headers,
+            json={'message': 'Speak English, my baby cannot breathe'},
+        )
+        self.assertEqual(response.status_code, 200)
+        payload = response.get_json()
+        self.assertEqual(payload['intent'], 'emergency')
+        self.assertEqual(payload['language'], 'english')
+        self.assertNotIn('details', payload)
+
+    def test_chat_rejects_invalid_payloads_without_affecting_predict(self):
+        self.assertEqual(self.client.post('/chat', headers=self.headers, json={}).status_code, 400)
+        self.assertEqual(
+            self.client.post('/chat', headers=self.headers, json={'message': 'x' * 2001}).status_code,
+            400,
+        )
+        self.assertEqual(self.post_image().status_code, 200)
+
 
 if __name__ == '__main__':
     unittest.main()