Changelog

Version History

Track all changes, improvements, and bug fixes across Mizan versions. Format follows Keep a Changelog and Semantic Versioning.

v0.2.0

Unreleased

In Development

Islamic Knowledge Library

LibrarySpace, TextSource, TextChunk entities with pgvector support
Semantic search API: POST /api/v1/search/semantic
Similar verses endpoint: GET /api/v1/verses/{surah}/{verse}/similar
IEmbeddingService interface with SentenceTransformer, Gemini, and Cascade implementations
Cascade embedding service: primary provider with automatic fallback and dimension guard
Configurable embedding settings: EMBEDDING_PROVIDER, EMBEDDING_MODEL, GEMINI_API_KEY

Data Pipeline Scripts

ingest_tanzil.py: populate 114 surahs and 6,236 verses from Tanzil XML with juz/hizb/manzil/sajdah metadata
embed_quran.py: batch-generate verse embeddings for all 6,236 verses

Frontend Pages

/search page: semantic search UI with Arabic-aware input, source-type toggles, similarity slider (50-95%), animated result cards
/library page: create spaces, add text sources, trigger indexing, retry/delete with live status badges
API client extended with library and search methods
TypeScript types for Library and SemanticSearch responses
Navigation updated with Search and Library links

Playground Improvements

Verse selector loads all 114 surahs dynamically from API (with graceful fallback)
Removed mock delay; playground calls live API for analysis and Abjad calculations

Bug Fixes

getSurahList(): backend returns plain array, not {surahs, total} - mapping corrected
analyzeVerse(): URL corrected from /api/v1/analyze/verse/ to /api/v1/analysis/verse/{surah}/{verse}

v0.1.0

January 2025

Latest Release

Core Features

Letter Counting: Traditional, Uthmani Full, No Wasla methods (Al-Fatiha = 139 letters, Basmalah = 19 letters)
Word Counting: whitespace-delimited Tanzil standard (Al-Fatiha = 29 words)
Abjad Calculator: Mashriqi and Maghribi numeral systems (Allah = 66, Basmalah = 786)
Verse Navigation: 114 surahs, 6,236 verses with validation and metadata

Domain Layer

VerseLocation, AbjadValue, SurahMetadata, TextChecksum value objects
Verse and Surah entities
AbjadCalculator, LetterCounter, WordCounter domain services
AbjadSystem, LetterCountMethod, ScriptType, RevelationType enumerations

Infrastructure

PostgreSQL with async support (asyncpg)
Redis caching layer
SQLAlchemy ORM models with Alembic migrations
FastAPI REST API with health, verse, and analysis endpoints
OpenAPI documentation auto-generated
Hexagonal Architecture with SOLID principles

Testing & Quality

138 unit tests with property-based testing (Hypothesis)
Verified against Tanzil.net, Quran.com, IslamWeb, and classical scholarship
MyPy strict type checking, Ruff linting

Try Latest Features Contribute