isnady 0.1.2 → 0.1.4

package/README.md

@@ -8,12 +8,12 @@
 
 <p align="center">
   <a href="https://pypi.org/project/isnady/">
-    <img src="https://img.shields.io/pypi/v/isnady?style=for-the-badge&color=1D4777&logo=pypi&logoColor=white" alt="PyPI">
+    <img src="https://img.shields.io/badge/PyPI-v0.1.4-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
   </a>
   <img src="https://img.shields.io/pypi/pyversions/isnady?style=for-the-badge&color=A47E24&logo=python&logoColor=white" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-5B6878?style=for-the-badge" alt="Platform">
   <a href="https://www.npmjs.com/package/isnady">
-    <img src="https://img.shields.io/npm/v/isnady?style=for-the-badge&color=14304F&logo=npm&label=npm" alt="npm">
+    <img src="https://img.shields.io/badge/npm-v0.1.4-14304F?style=for-the-badge&logo=npm" alt="npm">
   </a>
   <img src="https://img.shields.io/badge/License-MIT-D6B25E?style=for-the-badge" alt="License">
 </p>
@@ -27,6 +27,8 @@
   <a href="#-hadith-scholars">Scholars</a> •
   <a href="#-books">Books</a> •
   <a href="#-shia-rijal">Shia Rijal</a> •
+  <a href="#-statistics">Statistics</a> •
+  <a href="#-learn">Learn</a> •
   <a href="#-search-by-meaning-ai">Meaning (AI)</a> •
   <a href="#-chains-of-transmission">Chains</a> •
   <a href="#-educational-by-design">Educational</a> •
@@ -41,7 +43,7 @@
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/search-arabic.png" alt="Searching النيات finds بالنيات in Sahih al-Bukhari 1, with the chain above the text" width="850">
 </p>
 
-> **Pre-alpha (0.1.2).** Search and chains of transmission work today, on data you import
+> **Pre-alpha (0.1.4).** Search and chains of transmission work today, on data you import
 > in one command. Narrators, scholars, gradings and the rest are being built, in the open.
 
 ---
@@ -88,9 +90,12 @@ everything included, the AI features too:
 
 | System | File |
 |---|---|
-| Windows 10/11 | `isnady-<version>-windows-setup.exe` — Windows may say the publisher is unknown (the app is not signed): *More info → Run anyway* |
+| Windows 10/11 | `isnady-<version>-windows-portable.exe` — Windows may say the publisher is unknown (the app is not signed): *More info → Run anyway* |
 | Linux | `isnady-<version>-linux-x86_64.AppImage` — make it executable (`chmod +x`) and run it |
-| macOS, Apple silicon / Intel | `isnady-<version>-macos-arm64.dmg` / `…-macos-x86_64.dmg` — the first time, right-click the app and choose *Open* (it is not notarized) |
+| macOS, Apple silicon / Intel | `isnady-<version>-macos-arm64.zip` / `…-macos-x86_64.zip` — unzip and run `isnady.app`; the first time, right-click it and choose *Open* (it is not notarized) |
+
+All three are **portable**: nothing is installed, each runs from wherever it is. Put a folder named
+`isnady-data` beside the file and isnady keeps its databases and settings there — isnady on a USB stick.
 
 Put isnady on the desktop and in the applications menu with **Tools → Create Desktop Shortcut** (or
 `iy shortcut`): the shortcut starts isnady the way it is installed — the AppImage, the application, or the
@@ -290,6 +295,43 @@ the Shia narrators are kept apart from the (Sunni) chains: no chain link is matc
 Next: al-Tusi's *Rijal* and *Fihrist*, al-'Allama al-Hilli's *Khulasat al-aqwal*, Ibn Dawud's
 *Rijal*, al-Kashshi's reports, and the Four Books with their chains.
 
+### 📊 Statistics
+
+Measured in depth, each figure with what it means and how sure it is. Grades are ordered
+categories, so they are never turned into numbers or averaged. The first tab, **Graders**, takes
+the scholars who graded a book (al-Albani, Shu'ayb al-Arna'ut, Zubair 'Ali Za'i, Muhammad Muhyi
+al-Din 'Abd al-Hamid on Sunan Abi Dawud) and shows:
+
+- agreement of every pair — same grade, Cohen's kappa and the ordinal kappa — with 95% intervals,
+  and Krippendorff's alpha for all of them together;
+- a **Dawid–Skene model** of each hadith's true grade: each grader's confusion matrix (how he grades
+  a hadith of each true grade) and, for every hadith, how sure the model is;
+- **strictness** — the classical *mutashaddid* and *mutasahil*, measured by order only, with intervals;
+- the **disputed hadith**, where the scholars are furthest apart — a double-click opens one in its book.
+
+Two graders who agree far too often to be independent (98.1%) count as one voice in the model,
+and the page says so. Results are computed once and kept in a file. `iy stats graders`.
+Narrators, books, hadith, chains, correlations and the models follow, tab by tab.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/statistics.png" alt="Statistics — the graders of Sunan Abi Dawud: Krippendorff's alpha, agreement with intervals, the model's certainty" width="850">
+</p>
+
+### 🎓 Learn
+
+The terms of hadith and its sciences, written for isnady with their classical sources: 81 terms —
+the grades (sahih, hasan, da'if, mawdu', shadhdh, munkar, mu'allal), the kinds of hadith by their
+chain (mutawatir, mursal, munqati', mu'allaq, mudallas …), chain and text (mutaba'a, shahid,
+takhrij, madar), the ways of receiving (sama', ijaza, haddathana, 'an), judging narrators (the
+twelve ranks of Ibn Hajar, thiqa, saduq, majhul, matruk, mudallis), generations, the parts of an
+Arabic name, Imami rijal, the books, and isnady's own measures. Each with its Arabic, a one-line
+and a longer definition in **English or Turkish**, related terms one click away, and its source.
+The grades on every result explain themselves when you point at them. `iy term mursal --lang tr`.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/learn.png" alt="Learn — the term mursal: Arabic, definition, related terms and source" width="850">
+</p>
+
 ### 🧠 Search by meaning (AI)
 
 Choose **Match → By meaning (AI)** to find hadith that say the same thing in other words or in
@@ -404,6 +446,12 @@ each shown on real hadith and real chains — is on the roadmap.
 
 ## 🎨 Appearance
 
+Seven themes, chosen in **Edit → Preferences → Themes** — each shown as a small live isnady window —
+or in **View → Theme**: *Lapis* (lapis and gold of illuminated manuscripts) and *Lapis Night*, which
+"Follow system" switches between; *Paper* (warm cream and ink, for long reading); *Slate* (quiet and
+modern, with a light sidebar); *Emerald*; *Midnight* (deep dark with teal); and *High Contrast*
+(black, white and yellow, for low vision). `iy config set view.theme paper`.
+
 Every script has its own reading font, size, colour and line spacing — Arabic, Latin,
 Cyrillic, Bengali and Tamil today, more as sources in other scripts arrive. The light and
 the dark theme each keep their own colours, and the interface font can be changed too.
@@ -464,6 +512,8 @@ script. The command line never loads Qt.
 | `iy ai build` | `isnady ai build` | Learn the meaning index from the imported texts (`iy ai status` to check) |
 | `iy import najashi FILE` | `isnady catalog import najashi` | al-Najashi's Rijal: Shia narrators read on the Imami scale, and the book |
 | `iy shortcut` | `isnady shortcut --no-desktop` | A desktop and applications-menu shortcut, with isnady's icon |
+| `iy term [NAME]` | `isnady term --search tadlis` | The glossary: a term's meaning, English or Turkish (`--lang tr`) |
+| `iy stats graders` | `isnady stats graders --book abudawud` | The graders of a book in depth: agreement, model, strictness |
 | `iy book [KEY [CHAPTER]]` | `isnady book bukhari 2` | The books; a book's chapters; a chapter read in order |
 | `iy scholar [NAME]` | `isnady scholar albani` | The scholars in the data, or one of them with his measured statistics |
 | `iy tahric BOOK NUMBER` | `isnady tahric bukhari 1` | Other narrations of a hadith in the imported books (takhrij) |
@@ -551,7 +601,7 @@ Python 3.10 or newer and PySide6. The command line alone needs no PySide6.
 
 
 The desktop application of your own system: `pip install ".[ai]" pyinstaller`, then
-`python packaging/build_app.py linux|windows|macos VERSION` (Windows also needs Inno Setup).
+`python packaging/build_app.py linux|windows|macos VERSION`.
 
 ## 📝 License
 

package/index.js

@@ -6,7 +6,7 @@
  * database (used by both the Python and JavaScript packages) exists.
  */
 
-export const version = "0.1.2";
+export const version = "0.1.4";
 export const name = "isnady";
 
 /** Returns basic package information. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isnady",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Hadith search with full isnad chains, narrator biographies, jarh wa ta'dil verdicts and reliability scores",
   "type": "module",
   "main": "./index.js",