bhashabid 1.0.0__py3-none-any.whl

bhashabid/__init__.py

@@ -0,0 +1,44 @@
+"""
+Bhashabid (ভাষাবিদ) — Deterministic Bengali Linguistic Coprocessor Engine
+Pure-Python, Zero-LLM, High-Throughput Bengali Natural Language Processor.
+"""
+
+from tools.bn_normalize.repair import repair_text as repair
+from tools.bn_normalize.normalizer import normalize, normalize_text
+from tools.bn_normalize.unicode import canonicalize_unicode, is_nfc_normalized
+from tools.bn_lint.linter import lint_text as lint
+from tools.bn_normalize.lexicon import get_default_lexicon, bengali_edit_distance
+from tools.bn_numbers import format_lakh_crore as format_number, number_to_bangla_words, format_currency_words
+from tools.bn_prosody import scan_line, verify_payar
+
+__version__ = "1.0.0"
+
+def spellcheck(text_or_word: str):
+    """
+    Offline phonetic spellchecker.
+    If a single word is provided, returns list of top correction suggestions.
+    If a sentence/text is provided, returns list of flagged issue dictionaries.
+    """
+    lex = get_default_lexicon()
+    text_or_word = text_or_word.strip()
+    if " " in text_or_word:
+        return lex.audit_text(text_or_word)
+    return lex.suggest_corrections(text_or_word)
+
+__all__ = [
+    "repair",
+    "normalize",
+    "normalize_text",
+    "canonicalize_unicode",
+    "is_nfc_normalized",
+    "lint",
+    "spellcheck",
+    "format_number",
+    "number_to_bangla_words",
+    "format_currency_words",
+    "scan_line",
+    "verify_payar",
+    "get_default_lexicon",
+    "bengali_edit_distance",
+    "__version__"
+]

bhashabid-1.0.0.dist-info/METADATA

@@ -0,0 +1,279 @@
+Metadata-Version: 2.4
+Name: bhashabid
+Version: 1.0.0
+Summary: The Deterministic Bengali linguistic coprocessor engine & progressive skill layer with a Supervised Self-Learning Distillation Loop.
+Author-email: Ashikur Rahman Bhuiyan <ashikur.bhuiyan@brainstation-23.com>, Bhashabid Contributors <contributors@bhashabid.org>
+License: MIT
+Project-URL: Homepage, https://github.com/ashik1291/bhashabid
+Project-URL: Bug Tracker, https://github.com/ashik1291/bhashabid/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Bengali
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.txt
+Requires-Dist: pyyaml>=6.0
+Dynamic: license-file
+
+# Bhashabid (ভাষাবিদ) — The Deterministic Bengali Language Coprocessor Engine
+
+### *Deterministic Bengali linguistic coprocessor engine & progressive skill layer with a Supervised Self-Learning Distillation Loop.*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python: >=3.10](https://img.shields.io/badge/Python-3.10%2B-green.svg)](https://python.org)
+[![Version: v1.0.0](https://img.shields.io/badge/Version-v1.0.0-blue.svg)](https://github.com/ashik1291/bhashabid)
+[![Tests: 102 Passing](https://img.shields.io/badge/Tests-102%20Passing-brightgreen.svg)](eval/unit)
+[![Proven Knowledge: 48 Reviewed Cards](https://img.shields.io/badge/P2%20Provenance-48%2F48%20Cards%20Reviewed-blueviolet.svg)](knowledge/cards)
+[![Core Skill Token Budget: 298 BPE](https://img.shields.io/badge/Core%20Budget-298%20%2F%20390%20Tokens-success.svg)](skills/bangla-expert/SKILL.md)
+
+> **Bhashabid** (ভাষাবিদ) is the **first-ever open-source Bengali language coprocessor engine** featuring a **constitutionally supervised self-learning loop**. Operating as an external cognitive and deterministic coprocessor without retraining model weights, it continuously harvests real-world anomalies, synthesizes candidate rules, and distills high-level invariants under human verification (Principle P2) and a strict < 390 token ceiling—systematically elevating the accuracy, orthography, and native fluency of AI-generated Bengali across **17 specialized professional sectors**.
+
+---
+
+## 🎯 What Bhashabid Does & What Problem It Solves Uniquely
+
+### The Fundamental Problem with Frontier LLMs in Bengali
+Frontier large language models (GPT-4o, Claude 3.5 Sonnet, Gemini 1.5 Pro, DeepSeek V3) possess vast latent Bengali vocabularies, but their generative decoders suffer from four structural vulnerabilities:
+1. **English Syntactic Calquing**: Literal translation of English passive voice using *"দ্বারা"* (*"খাদ্যমূল্য বৃদ্ধির দ্বারা চালিত"*), clumsy modal verbs, and unidiomatic idioms (*"ঝোপের চারপাশে পেটানো"* for *beat around the bush*).
+2. **Honorific & Register Discordance**: Inconsistent pronominal and verbal honorific agreement (mixing informal *তারা* with honorific *দিয়েছিলেন*, or *তুমি* with *নেন*), and breaking *Sadhu-Cholito* harmony (*Guru-chandali* दोष).
+3. **Probabilistic Failure on Exact Rules**: LLMs frequently predict incorrect compound numerals (*"নব্বই নয়"* instead of *"নিরানব্বই"*), format currency with Western 3-digit commas instead of South Asian lakh/crore commas (`1,234,567` instead of `১২,৩৪,৫৬৭`), and fail to terminate sentences with Dari (`।`).
+4. **Context Window Dilution**: Conventional approaches dump 10,000+ token monolithic prompt guides into the context window, causing catastrophic instruction forgetting and ballooning API costs.
+
+### How Bhashabid Solves This Uniquely
+Bhashabid does not attempt to train a new model from scratch. Instead, it pairs with frontier models as a **high-speed, deterministic coprocessor and progressive skill layer**:
+- **Deterministic Offloading via Python & MCP**: Exact rules (0–99 irregular numbers, lakh/crore currency words, Unicode NFC normalization, Dari punctuation, 14-akshar Payar metric scansion) run in local Python algorithms at **500,000 words/second with 100% mathematical precision and $0.00 token cost**.
+- **Progressive Disclosure (< 390 Token Budget)**: The core skill kernel is strictly programmatically capped at **< 390 tokens** (currently **298 true BPE tokens** on `cl100k_base`). Deep domain knowledge is segmented into **9 isolated reference guides** loaded strictly on demand.
+- **Closed-Loop Learning Flywheel (Principle P2)**: When real-world scraping or practice runs encounter linguistic anomalies, candidate cards are synthesized automatically. Before entering production, every single card must undergo **cryptographic human native-speaker review (P2)** with SHA-256 signature verification.
+
+---
+
+## 📊 Side-by-Side Comparison: Frontier LLMs vs. Bhashabid
+
+| Linguistic Dimension | Where Frontier Models Fail (Raw LLM) | What Bhashabid Enforces (Coprocessor) | Concrete Real-World Example |
+| :--- | :--- | :--- | :--- |
+| **1. Irregular Cardinal Numbers** | Compounds numbers literally or uses decimal digit translation (*নব্বই নয়*). | Deterministic lookup for all 0–99 irregular cardinals, fractions (*দেড়, আড়াই*). | Input `99` ➔ Raw: *"নব্বই নয়"* ❌ <br>Bhashabid: **"নিরানব্বই"** ✔️ |
+| **2. South Asian Currency Grouping** | Western 3-digit comma grouping (`1,234,567.50`). | Exact South Asian lakh/crore grouping and currency in words. | Input `1234567.50` ➔ Raw: *"1,234,567.50"* ❌ <br>Bhashabid: **"১২,৩৪,৫৬৭.৫০ (বারো লাখ চৌত্রিশ হাজার পাঁচশত সাতষট্টি টাকা পঞ্চাশ পয়সা)"** ✔️ |
+| **3. English Passive Voice Calques** | Translates passives with *"দ্বারা"* (*"দ্বারা চালিত"*, *"দ্বারা অনুষ্ঠিত"*). | Real-time static linter converts passive calques into natural active causal phrasing. | Raw: *"খাদ্যমূল্য বৃদ্ধির দ্বারা চালিত"* ❌ <br>Bhashabid: **"খাদ্যপণ্যের মূল্যবৃদ্ধির কারণে... দাঁড়িয়েছে"** ✔️ |
+| **4. Pronominal & Verbal Honorifics** | Mismatches subject pronouns and verb honorific levels (*"তারা ফেরত দিয়েছিলেন"*). | Enforces strict grammatical concordance (*তারা ... ফেরত দিয়েছিল* vs *তাঁরা ... ফেরত দিয়েছিলেন*). | Raw: *"তারা অর্থ ফেরত দিয়েছিলেন"* ❌ <br>Bhashabid: **"তাঁরা সেই অর্থ ফেরত দিয়েছিলেন"** ✔️ |
+| **5. Judicial Writ Formulas (Article 102)** | Hallucinates colloquial phrases (*"জিজ্ঞেস করে রুল দিয়েছে"*). | Enforces Supreme Court of Bangladesh canonical Rule Nisi and prayer formulas. | Raw: *"কেন বেআইনি হবে না জিজ্ঞেস করে রুল দিয়েছে"* ❌ <br>Bhashabid: **"কেন বেআইনি ঘোষণা করা হবে না, তা জানতে চেয়ে রুল জারি করেছেন"** ✔️ |
+| **6. Administrative Memos & Petitions** | Calques *"Dear Sir"* as *"প্রিয় মহাশয়"*; uses broken closings. | Enforces *Bangladesh Secretariat Instructions* (*সচিবালয় নির্দেশমালা*). | Raw: *"প্রিয় মহাশয়, আশা করি ভালো আছেন"* ❌ <br>Bhashabid: **"বরাবর... বিষয়:... জনাব, বিনীত নিবেদন এই যে..."** ✔️ |
+| **7. Customer Support & Omnichannel** | Produces hybrid Banglish jargon (*"টিকেট রিজলভ করতে এজেন্ট এসাইন করা হয়েছে"*). | Standardizes professional customer care Bengali while preserving tracking IDs (`TCK-942`). | Raw: *"Query ক্লোজ করা হয়েছে, ফিডব্যাক দিন"* ❌ <br>Bhashabid: **"আপনার অভিযোগ ট্র্যাকিং নম্বর TCK-942 দ্রুত সমাধানের লক্ষ্যে পর্যালোচনা করা হচ্ছে"** ✔️ |
+| **8. MFS & FinTech Protocols** | Translates wallet terms literally or generates unsafe financial instructions. | Formulates Bangladesh Bank PSD & MRA compliant digital wallet disclosures. | Raw: *"ক্যাশ আউট ফি চার্জ করা হবে"* ❌ <br>Bhashabid: **"প্রতি হাজারে নির্ধারিত ক্যাশ-আউট চার্জ প্রযোজ্য হবে"** ✔️ |
+| **9. Bangla Academy Orthography** | Spells foreign loanwords with *"ষ"* (*ষ্টেশন, পোষ্ট*); uses long *"ী"* in non-tatsama words (*পাখী*). | Deterministically normalizes text to modern Bangla Academy standards. | Raw: *"রেল ষ্টেশনে পাখী ডাকছে"* ❌ <br>Bhashabid: **"রেল স্টেশনে পাখি ডাকছে"** ✔️ |
+| **10. Sentence Punctuation** | Terminates sentences with ASCII periods (`.`) instead of Dari (`।`). | Deterministically converts sentence-ending periods to Dari while protecting decimal numbers (`৩.১৪`). | Raw: *"তিনি বাড়ি গেলেন."* ❌ <br>Bhashabid: **"তিনি বাড়ি গেলেন।"** ✔️ |
+| **11. Classical 14-Akshar Payar Scansion** | Emits pseudo-verse with arbitrary line breaks and broken syllable rhythm. | Deterministic phonological syllabifier (*মুক্তদল* vs *রুদ্ধদল*) verifies exact 8+6=14 akshar Payar cadence. | Raw: Broken 17-syllable prose line ❌ <br>Bhashabid: **Validates exact 8+6=14 akshar Payar couplets** ✔️ |
+| **12. Land Registry & Deeds (Saf-Kabala)** | Uses informal phrasing (*"জমির বিক্রির কাগজ"*). | Enforces statutory Registration Act deed taxonomy (সাফ-কবলা, মৌজা, খতিয়ান, দাগ নং, চৌহদ্দি). | Raw: *"জমির বিক্রির কাগজ হস্তান্তর করলাম"* ❌ <br>Bhashabid: **"রেজিস্ট্রিকৃত সাফ-কবলা বিক্রয় দলিলমূলে চূড়ান্ত দখল বুঝিয়ে দেওয়া হলো"** ✔️ |
+| **13. Disaster Warning & Cyclone Signals** | Translates storm surge as *"ঝড় বৃদ্ধি"*; hallucinates warning signals. | Enforces official BMD maritime warning signals (মহাবিপদ সংকেত ১-১০) and canonical *জলোচ্ছ্বাস*. | Raw: *"উপকূলীয় অঞ্চলে ঝড় বৃদ্ধি দেখা যেতে পারে"* ❌ <br>Bhashabid: **"উপকূলীয় জেলাসমূহে ৫-৭ ফুট উচ্চতার জলোচ্ছ্বাসের আশঙ্কা রহিয়াছে"** ✔️ |
+| **14. NCTB Creative Pedagogy** | Generates arbitrary essay prompts without cognitive grading. | Formulates canonical NCTB 4-tier Bloom's taxonomy framework (উদ্দীপক, জ্ঞান, অনুধাবন, প্রয়োগ, উচ্চতর দক্ষতা). | Raw: Unstructured single essay prompts ❌ <br>Bhashabid: **Structured 4-tier rubric (ক/খ/গ/ঘ)** ✔️ |
+
+---
+
+## 🏛️ The 4 Pioneering Architectural Pillars
+
+```mermaid
+graph TD
+    UserReq["User Prompt / AI Agent Task"] --> Router["Core Skill Kernel (298 BPE Tokens)"]
+    
+    subgraph Pillar1 ["Pillar 1: Programmatic Token Ceiling"]
+        Router -->|"Strict Budget Guard (< 390)"| ActiveContext["298 True BPE Tokens (cl100k)"]
+    end
+    
+    subgraph Pillar3 ["Pillar 3: Modular Domain Isolation"]
+        Router -.->|"On-Demand Only"| LegalGuide["constitutional_writs.md (0 tokens if unrelated)"]
+        Router -.->|"On-Demand Only"| BankingGuide["journalism_domains.md (0 tokens if unrelated)"]
+        Router -.->|"On-Demand Only"| FinTechGuide["ecommerce_fintech_civic.md (0 tokens if unrelated)"]
+        Router -.->|"On-Demand Only"| CreativeGuide["creative_writing.md (0 tokens if unrelated)"]
+    end
+    
+    subgraph Pillar4 ["Pillar 4: Deterministic MCP Offloading"]
+        ActiveContext ==>|"Zero Token Cost ($0.00)"| FastPython["Python Engine (500k words/sec)"]
+        FastPython --> ExactNum["Exact 0-99 Numbers (নিরানব্বই)"]
+        FastPython --> LakhCrore["Lakh/Crore Comma Grouping (১২,৩৪,৫৬৭)"]
+        FastPython --> UnicodeNFC["Unicode NFC & Dari (।) Normalizer"]
+        FastPython --> ProsodyPayar["14-Akshar Payar Syllabic Verifier"]
+    end
+    
+    subgraph Pillar2 ["Pillar 2: Supervised Self-Learning Loop"]
+        RealWorldAnomalies["Harvester: Real-World Scraped Corpora"] --> Synthesizer["tools/card_synthesizer.py"]
+        Synthesizer --> ReviewP2["Human Native Sign-Off Gate (Principle P2)"]
+        ReviewP2 --> Distiller["tools/skill_distiller.py"]
+        Distiller -->|"Extracts Invariants: 1 rule covers 50k phrases"| CoreInvariants["Zero-Bloat Invariant Updates"]
+        CoreInvariants --> Router
+    end
+```
+
+### 1. Hard Programmatic Token Ceiling (< 390 Tokens Core Budget)
+- **Problem**: Monolithic linguistic system prompts (5,000–20,000 tokens) cause severe context dilution, high latency, and high API expenses.
+- **Solution**: The root skill kernel (`skills/bangla-expert/SKILL.md` and `.cursor/rules/bangla-expert.mdc`) is hard-capped programmatically under **390 tokens** (currently **298 true BPE tokens** on `cl100k_base`). It contains only universal structural invariants; domain reference files are retrieved via progressive disclosure.
+
+### 2. Generalization Over Memorization (Supervised Closed-Loop Learning)
+- **Problem**: Manually appending example sentences to prompts causes prompt bloat. Un-gated autonomous self-learning leads to hallucinated grammar rules.
+- **Solution**: Bhashabid executes a closed loop (`harvest` ➔ `synthesize-cards` ➔ `human review (P2)` ➔ `distill`). A single high-level invariant covers tens of thousands of sentence permutations. Knowledge cards cannot enter production without **cryptographic human sign-off**.
+
+### 3. Modular Domain Isolation (9 Progressive Guides)
+- **Problem**: Exposing all specialized vocabularies simultaneously confuses model style and wastes tokens.
+- **Solution**: 17 sectors are organized into **9 isolated reference guides**. An agent writing poetry burns **0.0 prompt tokens** on Supreme Court writ rules or central bank banking regulations.
+
+### 4. Deterministic Python Offloading via MCP ($0.00 Token Cost)
+- **Problem**: LLMs struggle with mathematical lookups, comma spacing, and phonological syllable counting.
+- **Solution**: Bhashabid offloads deterministic operations to local Python algorithms via the **Model Context Protocol (MCP)** and CLI at **500,000 words/second**, with **100% mathematical precision and 0 prompt tokens burned**.
+
+---
+
+## 📚 The 17 Supported Professional Sectors
+
+Bhashabid provides comprehensive domain standards across **17 specialized professional sectors**:
+
+| # | Sector | Authoritative Standards & Coverage | Reference Guide |
+| :---: | :--- | :--- | :--- |
+| **1** | **Constitutional Law & Writs** | Constitution of Bangladesh (Article 102), Supreme Court precedents, Rule Nisi show-cause orders, writ prayers (*Habeas Corpus, Mandamus, Certiorari*). | [`constitutional_writs.md`](skills/bangla-expert/references/constitutional_writs.md) |
+| **2** | **Macroeconomics & Banking** | Bangladesh Bank Monetary Policy statements, prudential regulations, *নীতি সুদহার*, *মূল্যস্ফীতি*, active causal financial reporting. | [`journalism_domains.md`](skills/bangla-expert/references/journalism_domains.md) |
+| **3** | **Healthcare & Epidemiology** | Bangla Academy Medical Dictionary, DGHS guidelines, precise clinical dosage intervals, non-stigmatizing mental health phrasing. | [`academic_legal_medical.md`](skills/bangla-expert/references/academic_legal_medical.md) |
+| **4** | **Administrative Governance & Memos** | *Bangladesh Secretariat Instructions* (*সচিবালয় নির্দেশমালা*), formal administrative petitions, opening and closing protocols. | [`official_letters.md`](skills/bangla-expert/references/official_letters.md) |
+| **5** | **Creative Fiction & Spoken Dialogue** | Bangla Academy Standard Grammar, living spoken Cholito (*কথ্য রীতি*), action-embedded dialogue tags, sensory imagery. | [`creative_writing.md`](skills/bangla-expert/references/creative_writing.md) |
+| **6** | **Classical Poetry & Prosody** | Rabindranath Tagore & Probodh Chandra Sen prosody canon, Dalabritta, Matrabritta, 14-akshar Payar couplets (8+6). | [`creative_writing.md`](skills/bangla-expert/references/creative_writing.md) |
+| **7** | **Academic Research & Methodology** | Peer-reviewed citation standards, academic transliteration with Latin in parentheses, thesis structure. | [`academic_legal_medical.md`](skills/bangla-expert/references/academic_legal_medical.md) |
+| **8** | **Land Registry & Deeds** | Transfer of Property Act 1882, Registration Act 1908, Sub-Kabala conveyance, Heba, CS/SA/RS/BS Khatian, plot boundaries (*চৌহদ্দি*). | [`academic_legal_medical.md`](skills/bangla-expert/references/academic_legal_medical.md) |
+| **9** | **Agronomy & Disaster Management** | Department of Agricultural Extension (DAE), BMD official cyclone warning signals (1-10 মহাবিপদ সংকেত), storm surge (*জলোচ্ছ্বাস*). | [`academic_legal_medical.md`](skills/bangla-expert/references/academic_legal_medical.md) |
+| **10** | **ICT & Software Engineering** | Bangladesh Computer Council (BCC) computing standards, Unicode NFC canonical normalization, open-source localization. | [`orthography.md`](skills/bangla-expert/references/orthography.md) |
+| **11** | **Education & NCTB Pedagogy** | National Curriculum and Textbook Board (NCTB) 4-tier Creative Questioning taxonomy (উদ্দীপক, জ্ঞান, অনুধাবন, প্রয়োগ, উচ্চতর দক্ষতা). | [`academic_legal_medical.md`](skills/bangla-expert/references/academic_legal_medical.md) |
+| **12** | **Translation & Calque Naturalization** | De-calquing passive voice (*দ্বারা*), naturalizing English idioms (*বাগধারা ও প্রবচন*), semantic tri-layer model (*অভিধা, লক্ষণা, ব্যঞ্জনা*). | [`grammar_registers.md`](skills/bangla-expert/references/grammar_registers.md) |
+| **13** | **Consumer E-Commerce & Retail Logistics** *(NEW)* | Consumers' Rights Protection Act 2009, e-CAB guidelines, escrow settlement, refund honorific concordance (*তারা বনাম তাঁরা*), courier tracking. | [`ecommerce_fintech_civic.md`](skills/bangla-expert/references/ecommerce_fintech_civic.md) |
+| **14** | **Customer Support & Omnichannel Messaging** *(NEW)* | Telecom & omnichannel standards, administrative ticketing resolution nomenclature, preserving alphanumeric tracking IDs (`TCK-942`). | [`ecommerce_fintech_civic.md`](skills/bangla-expert/references/ecommerce_fintech_civic.md) |
+| **15** | **MFS, Microfinance & Grassroots FinTech** *(NEW)* | Bangladesh Bank Payment Systems Dept (PSD) MFS guidelines, Microcredit Regulatory Authority (MRA) rules, fraud prevention warnings. | [`ecommerce_fintech_civic.md`](skills/bangla-expert/references/ecommerce_fintech_civic.md) |
+| **16** | **Citizen Digital Services & Smart Governance** *(NEW)* | Aspire to Innovate (a2i) Citizen Service Standards, Bangladesh National Portal style, National ID (NID) registration rules, Citizen Charters. | [`ecommerce_fintech_civic.md`](skills/bangla-expert/references/ecommerce_fintech_civic.md) |
+| **17** | **Mass Media & Digital Journalism** *(NEW)* | Bangladesh Press Council Code of Ethics & Stylebook, Press Institute of Bangladesh (PIB) standards, neutral reporting attribution. | [`journalism_domains.md`](skills/bangla-expert/references/journalism_domains.md) |
+
+---
+
+## 🧪 Proven Accuracy & Verification Metrics
+
+Bhashabid enforces an anti-self-deception testing philosophy (Principle P8). Every mistake discovered in practice is preserved in a permanent regression ledger and executed on every commit:
+
+| Verification Suite | Target | Observed Result | Status |
+| :--- | :---: | :---: | :---: |
+| **Automated Unit & Regression Suite** | 100% Pass | **102 / 102 Tests Passing** | ![Pass](https://img.shields.io/badge/Unit%20Tests-102%2F102%20Pass-brightgreen.svg) |
+| **Principle P2 Provenance Integrity** | 100% Signed | **48 / 48 Cards Reviewed** | ![P2](https://img.shields.io/badge/P2%20Provenance-48%2F48%20Reviewed-blueviolet.svg) |
+| **Core Skill Token Footprint** | < 390 Tokens | **298 True BPE Tokens** (`cl100k_base`) | ![Tokens](https://img.shields.io/badge/BPE%20Tokens-298%20%2F%20390-success.svg) |
+| **Invariant Duplicate Collisions** | 0 Collisions | **0 Duplicate Titles / Summaries / Examples** | ![Duplicates](https://img.shields.io/badge/Duplicates-0-brightgreen.svg) |
+| **Irregular Number Precision (0–99)** | 100.0% | **100.0% Deterministic Match** | ![Numbers](https://img.shields.io/badge/Numeral%20Accuracy-100%25-brightgreen.svg) |
+| **Sentence-Ending Dari Enforcement** | 100.0% | **100.0% (Decimal Protected)** | ![Punctuation](https://img.shields.io/badge/Punctuation-100%25-brightgreen.svg) |
+| **Guru-chandali Concordance Trapping** | 100.0% | **100.0% Trapped with Bidirectional Fixes** | ![Linter](https://img.shields.io/badge/Linter-100%25-brightgreen.svg) |
+| **Execution Throughput (Local Python)** | > 100k wps | **~500,000 words/second ($0.00 cost)** | ![Performance](https://img.shields.io/badge/Speed-500k%20words%2Fsec-blue.svg) |
+
+---
+
+## 🚀 How to Use Bhashabid Today
+
+### 1. 1-Command Skill Installation (Antigravity, Claude, Cursor)
+Install the progressive skill along with **all 9 specialized reference guides** into your coding environment:
+```bash
+# Install globally to all detected environments (Antigravity, Claude, and Cursor)
+bhashabid install-skill --target all
+
+# Or install specifically:
+bhashabid install-skill --target antigravity
+bhashabid install-skill --target claude
+bhashabid install-skill --target cursor
+
+# Uninstall cleanly at any time:
+bhashabid uninstall-skill --target all
+```
+
+### 2. Standalone All-In-One Prompt (ChatGPT, Claude Web, Gemini Web, DeepSeek)
+If you are using a web browser interface and cannot install files, copy the single self-contained prompt:
+👉 **[`skills/bangla-expert/STANDALONE_ALL_IN_ONE.md`](skills/bangla-expert/STANDALONE_ALL_IN_ONE.md)**
+
+Paste it into ChatGPT Custom Instructions, Claude System Prompts, or Gemini to immediately eliminate machine-translation calques.
+
+### 3. Model Context Protocol (MCP) Server
+Expose Bhashabid's deterministic tools via stdio MCP for Claude Desktop, Cursor, Windsurf, or Zed:
+```bash
+bhashabid-mcp
+# or: bhashabid mcp
+```
+**Exposed Deterministic Tools**:
+- `convert_number`: Irregular 0–99 cardinal words, currency words, South Asian comma grouping.
+- `normalize_text`: Unicode NFC canonical decomposition, Dari punctuation, Bangla Academy vowel rules.
+- `lint_text`: Static analysis for Guru-chandali, honorific discordance, and 20+ English calques.
+- `prosody_scan`: Classical scansion (Dalabritta, Matrabritta, Aksharbritta) and 14-akshar Payar validation.
+- `generate_writ_prayer`: Drafts Article 102 High Court constitutional writ prayers in statutory Bengali.
+
+### 4. Command-Line Interface (CLI)
+Install globally from PyPI:
+```bash
+pip install bhashabid
+```
+Run any linguistic task instantly:
+```bash
+# Convert numbers to authentic Bengali words
+bhashabid number 99 --format words
+# Output: নিরানব্বই
+
+# Format currency in South Asian lakh/crore
+bhashabid number 1234567.50 --format currency
+# Output: বারো লাখ চৌত্রিশ হাজার পাঁচশত সাতষট্টি টাকা পঞ্চাশ পয়সা
+
+# Lint text for grammatical, honorific, and calque errors
+bhashabid lint "তারা সেই অর্থ ফেরত দিয়েছিলেন এবং বিষয়টি বিদ্যুৎ দ্বারা চালিত."
+
+# Verify 14-akshar Payar poetic metre (8+6)
+bhashabid prosody "কাশীদাস কহে সাধু শুনে পুণ্যবান" --verify-payar
+
+# Draft High Court constitutional writ prayers
+bhashabid writ --remedy "detention" --subject "জনাব করিম" --authority "স্বরাষ্ট্র সচিব"
+
+# List candidate knowledge cards awaiting human sign-off (Principle P2)
+bhashabid review --list
+```
+
+### 5. Python SDK
+```python
+from tools.bn_numbers import number_to_bangla_words, format_lakh_crore
+from tools.bn_normalize import normalize
+from tools.bn_lint import lint_text
+from tools.bn_prosody import verify_payar
+
+# Deterministic numerals
+print(number_to_bangla_words(99))  # "নিরানব্বই"
+
+# Orthography & Punctuation
+print(normalize("ডাক্তার সাহেব ৩.১৪ গ্রাম ওষুধ দিলেন."))
+# "ডাক্তার সাহেব ৩.১৪ গ্রাম ওষুধ দিলেন।"
+
+# Linter checks with bidirectional repair suggestions
+issues = lint_text("তুমি সিদ্ধান্ত নেন")
+for issue in issues:
+    print(issue.suggestion)  # তুমি সিদ্ধান্ত নাও / আপনি সিদ্ধান্ত নেন
+```
+
+---
+
+## 🛡️ Constitutional Governance (Principle P2 & P8)
+
+1. **Principle P2 (Human Provenance Gate)**: No knowledge card enters production without authenticated native-speaker review, non-empty verified exemplars, and cryptographic SHA-256 signatures. **48 / 48 cards (100%)** are authenticated by lead human arbiter `Ashikur Rahman Bhuiyan`.
+2. **Principle P4 (Deterministic Tools for Rules)**: Rules that can be computed with discrete mathematics or grammars are implemented in code, not left to probabilistic prompt guesses.
+3. **Principle P8 (Anti-Self-Deception & Memory)**: Flaws detected across real-world corpora are permanently logged in [`memory/mistakes/ledger.jsonl`](memory/mistakes/ledger.jsonl) and sealed as automated unit tests in [`eval/unit/`](eval/unit/).
+
+---
+
+## 📖 Wiki & Documentation Hub
+
+Comprehensive architectural specifications, domain style guides, and developer workflows:
+- [Wiki Home & Overview](docs/wiki/Home.md)
+- [Getting Started & Installation Guide](docs/wiki/Getting-Started.md)
+- [The 17 Specialized Professional Sectors](docs/wiki/The-17-Professional-Sectors.md)
+- [Model Context Protocol (MCP) Guide](docs/wiki/Model-Context-Protocol-MCP.md)
+- [Poetic Prosody & Payar Scansion Specification](docs/wiki/Poetic-Prosody-&-Payar.md)
+- [Article 102 Constitutional Writs Guide](docs/wiki/Constitutional-Writs-Article-102.md)
+- [Principle P2 Provenance & Human Review Protocol](docs/wiki/Principle-P2-Provenance-&-Review.md)
+- [Centralized Linguistic Review Hub](docs/review_queue/README.md)
+- [Pending Human Reviews Dashboard](docs/review_queue/PENDING_REVIEWS.md)
+
+---
+
+## 📄 License
+
+This project is licensed under the permissive terms of the **[MIT License](LICENSE)**. See the `LICENSE` file for full copyright and permission notices.

bhashabid-1.0.0.dist-info/RECORD

@@ -0,0 +1,69 @@
+bhashabid/__init__.py,sha256=4H5Eec0DpI3sx3kz-9vV2GPi0H0JG2Yd8Oed8VRhAU4,1481
+bhashabid-1.0.0.dist-info/licenses/LICENSE,sha256=1CuXjR9DCQnQB8D9ZRIEfF2iw6VGXWM3zt5caRX9m-k,1110
+bhashabid-1.0.0.dist-info/licenses/LICENSE.txt,sha256=1CuXjR9DCQnQB8D9ZRIEfF2iw6VGXWM3zt5caRX9m-k,1110
+tools/__init__.py,sha256=r-eyI7M1T1zmkn4KCzEpktERHyHHEuxS0vzcMnnSljY,26
+tools/adversarial_generator.py,sha256=nPZqLtCURr3CJSy8vKcMvqX8cwVweeXQJh2rVkh5b5g,5175
+tools/audit_duplicates.py,sha256=wWNF3r3jPkteifrCeEbQT5LQd8s3BpxkBwJ6Nrojti4,3092
+tools/autonomous_scraper.py,sha256=dIQo7l5NA-MY2Ejgv1GOT5pudqk3OEYLQPtg1MktqiA,28230
+tools/card_synthesizer.py,sha256=lfzr7qMsgCBNMZKLx8FDADc7pIg1IjxLLmn0R3-PHiI,22658
+tools/cli.py,sha256=paUxOFi1U2sFPu9zgj6gbLYrY5b-WRHKvvAjUIa64Qo,27521
+tools/corpus_harvester.py,sha256=fSWOqDWtEr-aHS4MhoX6vuO-b-RSlNZcUtw9Vu-6LgY,12450
+tools/daily_practice_runner.py,sha256=6lKEoDlmIqqClmPUFU35C0EZIbO6B1EjHLQcqawZ3WU,31431
+tools/generate_infographic_poster.py,sha256=4Si92SnEH2f1-jCpjLO2QxFstJBYXhfcRJdsvSJMf-k,14753
+tools/human_reviewer.py,sha256=DtesF8r9jLxm2I_gTM5Y6J5srLddjlxwu9-YePQ8dt8,8557
+tools/learning_benchmark_ledger.py,sha256=EiyxKC39Y_zsCcFoiNF6Psz03YkaCBeGLY8xrX2LVrM,10017
+tools/learning_curve_validator.py,sha256=oL2NsKziFmf1yrbuAl9Cu-G5upaMM6CztjGpuuDZ0hE,7565
+tools/mistake_synthesizer.py,sha256=To1cc1yW_j-qOi60fIw3Ao78nMGKw5ySsKSfLJk-RCk,25704
+tools/review_packet_generator.py,sha256=te2nrP9aYR8JyO1p3cqilcBl_Gjuk3giqcjnKhqivrI,5532
+tools/skill_distiller.py,sha256=Z6m9cm-EOWljsgFhlEQl5xYcaN2lxH9tvdGeiVg6s3E,5497
+tools/skill_installer.py,sha256=KejNQEVs7BACfgSsGD9n99im56CbU3kP1H-dOaG5tkM,23754
+tools/verify_provenance.py,sha256=Yju7Ttowk-ZE5ECN2gcIS5upf5Tjt-FcnJ_2JnHCd4g,2765
+tools/assets/adapters/claude/claude_system_prompt.txt,sha256=H0ColI-Xll8P9uz58PXH-KIcwvX2eizZce1dvwVqGQ0,873
+tools/assets/adapters/cursor/bangla-expert.mdc,sha256=0tgmeWmMugN4RGSw63D6Xfwr0DIKW6MBhMo_YqGlADU,2163
+tools/assets/lexicon/bn_vocab_78k.txt.gz,sha256=tuv_p_-8siVzyaODi42QbmTuxYVO2Hkg3ss6OxC6Vug,314225
+tools/assets/skills/bangla-expert/SKILL.md,sha256=0YmZem2vZvXYDVbZJzC9VgT8pTeZfXqRG_BuwYSwkPA,2282
+tools/assets/skills/bangla-expert/STANDALONE_ALL_IN_ONE.md,sha256=6x2h14cmJ5xiX5MxutSdO-Y3V_XZsOFBfNYDN7Xo0Jk,9596
+tools/assets/skills/bangla-expert/references/academic_legal_medical.md,sha256=gLw8tgRcW4hu0O4lxc6VbybNDsldJcczFCe-kCuc3FA,5965
+tools/assets/skills/bangla-expert/references/constitutional_writs.md,sha256=uQUXHhbXeKXe_HYuZYPij-i0RHTXqYuwdsWyRyqCsRE,6247
+tools/assets/skills/bangla-expert/references/creative_writing.md,sha256=8sniM2asp1FAXg0S1uBJRbVUPuqDALaUpluRS1A-6DE,5103
+tools/assets/skills/bangla-expert/references/ecommerce_fintech_civic.md,sha256=Q98r5bzJO7xWymZrlnQh6PjvzNro-S_z4pDO1XTAJxE,4203
+tools/assets/skills/bangla-expert/references/grammar_registers.md,sha256=kcOAIyt-yf92FdglEe_Ove0udCNBwAKJXqyORByaIcE,1121
+tools/assets/skills/bangla-expert/references/journalism_domains.md,sha256=P8Fkt_hCEB6BhzslVV8oQFo9GtVhc3-nnsJQVpSOVYc,2113
+tools/assets/skills/bangla-expert/references/numerals.md,sha256=PerC1Tco57n8WWdJdXaz7qYgBDC136mJez1iQ5X5keg,3109
+tools/assets/skills/bangla-expert/references/official_letters.md,sha256=tXEMYg0EtuXdIy8heINm1CXATPkGfOZBMJxUUW4uyI8,2751
+tools/assets/skills/bangla-expert/references/orthography.md,sha256=jP5-XurnrU2FiszUDzjRKgujA7xbcjCim4sdeci7Niw,1090
+tools/bn_legal/__init__.py,sha256=4mRhovvTMOtqY_jcoBPW8HcMPbUMbXDXX_5jq8C8dXw,271
+tools/bn_legal/writs.py,sha256=W_mGPyI-8YdwFgTHGzFsticFhuzDevoSTkpB-XgPaQg,11387
+tools/bn_lint/__init__.py,sha256=O-gsTo7dpJJSBG7G4zitiFJSWJtlrgG3ax89o6QV9eU,170
+tools/bn_lint/calques.py,sha256=ACOOEuIAEGU071SZb2t5zfn68anSTisQalLsh0UcxXQ,8906
+tools/bn_lint/guru_chandali.py,sha256=c2Bksr2s2NOIRZflbRPPlfXoSQsqHh3PTqAK9APuEsE,4660
+tools/bn_lint/honorifics.py,sha256=sVsBagNVRGEZUdvpG6QgNnMXmo38rPupQTZ7Jov97DU,16962
+tools/bn_lint/linter.py,sha256=Y7p8VRo0et7Ad69cXTO-f9WjuNYreXPfrGJoTs2L7rA,915
+tools/bn_lint/models.py,sha256=jVgMBVZFnfhTe3bnnFzaDy3raUBtM24fiaX_9mNM_70,335
+tools/bn_normalize/__init__.py,sha256=HzlIa1f5-Gqq-JnjU24ImCtMUqCda2x9qPyiRrOgsV4,638
+tools/bn_normalize/lexicon.py,sha256=OvxMxaOAW8GEMYQR3JwaVxqzyGfaxOlr-cZonuu6S6A,14203
+tools/bn_normalize/normalizer.py,sha256=fIZXnWcMQxpvF9AXdf3lIk_XCHSYzqP7kLPSG94XHCc,1545
+tools/bn_normalize/orthography.py,sha256=GIi19ID5-qyOsJcFV5oM9_KE6N8r3Iv3IwA4YTWYW_0,8751
+tools/bn_normalize/profiles.py,sha256=BQQzcGMrRM2C6T3kby7_3l6tdB20nJVhPRMKlS0VR0Q,1345
+tools/bn_normalize/punctuation.py,sha256=AEdZln-4Qxtw4FRy1_vEMflPtkh5f3QPpVRYun4olwQ,3544
+tools/bn_normalize/repair.py,sha256=ohU7DQe9_g76ux2u5reV8kkDKR5JtrdSWKVkhTeK1G4,15551
+tools/bn_normalize/unicode.py,sha256=k3qGxqv9Tms1q7J_TObzyQwrfd3k7VSvXUtUlJXat_Q,2563
+tools/bn_numbers/__init__.py,sha256=AlhYBcoIt6rtiBna7wnti4THSnKhmoCuvVG8Wi14CRE,734
+tools/bn_numbers/currency.py,sha256=ztYNkJxv9GUU1Mba4nZVAq5XhWm1hmoNc8gF99Mkofw,1754
+tools/bn_numbers/dates.py,sha256=TTWYuO1Q_x3Zho_urwPFTJT7oAuNm2eYZFC3yHTxFvE,1648
+tools/bn_numbers/decimals.py,sha256=sPEcUxEgA2dqCmWnadKnFAGhTbl5pJlHHVsL2dh7d-8,1524
+tools/bn_numbers/digits.py,sha256=qbBqHEDqBmbdUBlgFJ7h0h2IAXWt0Z9tx0FzwlJ2PkQ,1950
+tools/bn_numbers/fractions.py,sha256=F8PUHpL8HcVIlc3cwURftIXMPp9LSAStZEsDDbkR7_8,2347
+tools/bn_numbers/ordinals.py,sha256=-gg4aCUxTCuKON-vAbuSyUF4o4urfGKDF0cW5HwcKqs,1435
+tools/bn_numbers/words.py,sha256=63_tz2SsfX8p4iYMrxrS0t2HD2dooa78ChLjBWofzUU,5656
+tools/bn_prosody/__init__.py,sha256=sMRYWvJCKW5ZqfDyLgZK1U6dqLNUZv_mhwqgx_Aq2Rs,418
+tools/bn_prosody/metre.py,sha256=hpfdXRq5KbYxRdFkadCiXEBnZzi33JyIcYShkn2gIIM,4888
+tools/bn_prosody/syllable.py,sha256=n1nG9WKo6lLaoVoy9UFaZKX0ZftKMbs7GT60iNTxrOY,4856
+tools/mcp_server/__init__.py,sha256=fwHD4DZKCxMBqJAAvdVQi0gVNiUzLaiinelYZJF6RYE,125
+tools/mcp_server/__main__.py,sha256=HGIVnrDGBNp3i2GDDDeyl_ldSz3eFDS652B7pJNLZ_8,121
+tools/mcp_server/server.py,sha256=LsJs0b-hpf5noQiqi5aPBOXtYlfPqLRB-0SfGZzUZ2k,13893
+bhashabid-1.0.0.dist-info/METADATA,sha256=gZsCKMkY3sWcA9kt7Ntm13ZlsSo3OhTo4WgfyOmZre8,28111
+bhashabid-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+bhashabid-1.0.0.dist-info/entry_points.txt,sha256=7tZw5ZCdnsziMVMP85rB01GMhOCDNSZ2wZ1GI_4RkzA,90
+bhashabid-1.0.0.dist-info/top_level.txt,sha256=GtJVrIkKLu4XkaRvdGew3IL6utK3DtkdacTTsx65niI,16
+bhashabid-1.0.0.dist-info/RECORD,,

bhashabid-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bhashabid-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+bhashabid = tools.cli:main
+bhashabid-mcp = tools.mcp_server.server:main

bhashabid-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Md. Ashikur Rahman Bhuiyan and Bhashabid Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bhashabid-1.0.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Md. Ashikur Rahman Bhuiyan and Bhashabid Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bhashabid-1.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+bhashabid
+tools

tools/__init__.py

@@ -0,0 +1 @@
+# Bhashabid Tools Package

tools/adversarial_generator.py

@@ -0,0 +1,122 @@
+# tools/adversarial_generator.py
+# Dynamic Adversarial Perturbation & Multi-Domain Linguistic Stress Generator
+import random
+import re
+from typing import List, Tuple, Dict
+
+# Known common LLM corruption patterns across Bengali sectors
+ORTHOGRAPHIC_PERTURBATIONS = [
+    ("পোস্ট", "পোষ্ট"),
+    ("মাস্টার", "মাষ্টার"),
+    ("স্টেশন", "ষ্টেশন"),
+    ("স্টাফ", "ষ্টাফ"),
+    ("বাড়ি", "বাড়ী"),
+    ("শ্রেণি", "শ্রেণী"),
+    ("পাখি", "পাখী"),
+    ("বেশি", "বেশী"),
+    ("ইতিমধ্যে", "ইতোমধ্যে"),
+    ("পুরস্কার", "পুরষ্কার"),
+    ("গীতাঞ্জলি", "গীতাঞ্জলী"),
+    ("শ্রদ্ধাঞ্জলি", "শ্রদ্ধাঞ্জলী"),
+    ("প্রমিত", "প্রমীত"),
+]
+
+SYNTACTIC_CALQUES = [
+    ("কারণে", "দ্বারা চালিত হয়ে"),
+    ("পরিচালিত হচ্ছে", "দ্বারা পরিচালিত হইতেছে"),
+    ("অনুষ্ঠিত হয়", "দ্বারা অনুষ্ঠিত করা হয়"),
+    ("নেতৃত্বে", "কর্তৃক চালিত হয়ে"),
+    ("সিদ্ধান্ত গৃহীত হয়", "সিদ্ধান্ত নেওয়া হয়েছে"),
+    ("সবশেষে", "দিনের শেষে"),
+]
+
+SADHU_CHOLITO_INJECTIONS = [
+    ("হয়েছে", "হইয়াছে"),
+    ("করেছেন", "করিয়াছেন"),
+    ("করছে", "করিতেছে"),
+    ("হবে", "হইবে"),
+    ("বললেন", "বলিলেন"),
+    ("যাচ্ছে", "যাইতেছে"),
+]
+
+NUMERAL_CORRUPTIONS = [
+    ("১", "1"),
+    ("২", "2"),
+    ("৩", "3"),
+    ("৪", "4"),
+    ("৫", "5"),
+    ("৬", "6"),
+    ("৭", "7"),
+    ("৮", "8"),
+    ("৯", "9"),
+    ("০", "0"),
+]
+
+class AdversarialGenerator:
+    """
+    Generates dynamic linguistic perturbations, synthetic edge cases,
+    and adversarial sentence variants to ensure continuous learning and
+    prevent stagnation on static benchmark data.
+    """
+
+    def __init__(self, seed: int = None):
+        if seed is not None:
+            random.seed(seed)
+
+    def perturb_orthography(self, text: str) -> Tuple[str, str]:
+        """Injects non-standard or pre-1992 spelling variants common in LLMs."""
+        for clean, flawed in ORTHOGRAPHIC_PERTURBATIONS:
+            if clean in text:
+                return text.replace(clean, flawed, 1), f"Orthographic corruption: '{clean}' -> '{flawed}'"
+        return text, "No orthographic pattern found"
+
+    def perturb_calque(self, text: str) -> Tuple[str, str]:
+        """Injects literal English passive syntax calques."""
+        for clean, flawed in SYNTACTIC_CALQUES:
+            if clean in text:
+                return text.replace(clean, flawed, 1), f"Syntactic calque: '{clean}' -> '{flawed}'"
+        return text, "No syntactic calque pattern found"
+
+    def perturb_sadhu_cholito_mix(self, text: str) -> Tuple[str, str]:
+        """Injects Guru-Chondali (Sadhu/Cholito verb clash) defect."""
+        for cholito, sadhu in SADHU_CHOLITO_INJECTIONS:
+            if cholito in text:
+                # Replace only first occurrence so rest remains Cholito, creating a clash
+                return text.replace(cholito, sadhu, 1), f"Guru-Chondali clash: injected Sadhu '{sadhu}' into Cholito sentence"
+        return text, "No verb clash pattern found"
+
+    def perturb_unicode(self, text: str) -> Tuple[str, str]:
+        """Injects non-NFC decomposed Bengali Unicode (e.g. split O-kar into E-kar + Aa-kar)."""
+        # Bengali O-kar is \u09cb; decomposed is \u09c7\u09be
+        if "\u09cb" in text:
+            return text.replace("\u09cb", "\u09c7\u09be", 1), "Unicode decomposition: NFC O-kar converted to split [E-kar + Aa-kar]"
+        return text, "No decomposable vowel found"
+
+    def generate_dynamic_batch(self, base_sentences: List[Tuple[str, str, str]], sample_size: int = 25) -> List[Tuple[str, str, str]]:
+        """
+        Takes base sentences (domain, text, category) and synthesizes fresh,
+        adversarial test cases for practice rounds.
+        """
+        if not base_sentences:
+            return []
+
+        selected = random.sample(base_sentences, min(len(base_sentences), sample_size))
+        dynamic_batch = []
+
+        methods = [
+            self.perturb_orthography,
+            self.perturb_calque,
+            self.perturb_sadhu_cholito_mix,
+            self.perturb_unicode
+        ]
+
+        for domain, text, cat in selected:
+            # 50% chance of introducing an adversarial perturbation
+            if random.random() > 0.5:
+                method = random.choice(methods)
+                perturbed_text, label = method(text)
+                dynamic_batch.append((domain, perturbed_text, f"DYNAMIC_ADVERSARIAL: {label}"))
+            else:
+                dynamic_batch.append((domain, text, cat))
+
+        return dynamic_batch

tools/assets/adapters/claude/claude_system_prompt.txt

@@ -0,0 +1,9 @@
+You are an expert native Bengali linguist adhering to Bangla Academy standard orthography.
+
+Operating Rules:
+1. Standard Cholito Register: Never mix Sadhu participles (করিয়া, আসিয়া) with Cholito verbs.
+2. Honorific Concordance: Strictly match verbs with pronouns (আপনি -> করেন, তুমি -> করো, তুই -> করিস).
+3. Orthography: Foreign loanwords take 'স'/'স্ট' (স্টেশন, পোস্ট), non-tatsama words take short 'ি' (পাখি, বাড়ি).
+4. Numerals: 0-99 numbers have irregular spellings (৯৯ = নিরানব্বই). Group digits as ১২,৩৪,৫৬৭.
+5. Punctuation: Use Bengali Dari (।) for sentence endings. Preserve decimals (৩.১৪).
+6. Natural Syntax: Translate idioms culturally (ভাবানুবাদ), never literal English calques.