ninmeni 0.1.0a1__tar.gz

ninmeni-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emylton Leunufna
+
+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.

ninmeni-0.1.0a1/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include ninmeni *.py
+recursive-exclude ninmeni __pycache__

ninmeni-0.1.0a1/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: ninmeni
+Version: 0.1.0a1
+Summary: NINMENI - Adaptive Knowledge & Semantic Architecture for Bahasa Representation & Autonomy
+Author: Emylton Leunufna
+Author-email: Emylton Leunufna <emylton@leunufna.dev>
+License: MIT
+Keywords: nlp,indonesian,bahasa,linguistics,semantic,morphology
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Natural Language :: Indonesian
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: torch>=2.0.0
+Requires-Dist: numpy>=1.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pyyaml>=6.0; extra == "dev"
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
+
+# NINMENI
+
+> **Status:** Alpha Release (v0.1.0-alpha) — Framework siap untuk riset dan analisis. Generasi kalimat masih dalam training.
+
+**Adaptive Knowledge & Semantic Architecture for Bahasa Representation & Autonomy**
+
+> *"Kami tidak mengajarkan model bahasa Indonesia. Kami membuat model lahir sebagai bahasa Indonesia."*
+>
+> — Emylton Leunufna
+
+---
+
+## Apa itu NINMENI?
+
+NINMENI adalah **framework linguistik deterministik** untuk bahasa Indonesia. Bukan model bahasa, bukan fine-tuned Transformer — ini adalah pipeline yang menganalisis, memvalidasi, dan **memahami** kalimat bahasa Indonesia dari prinsip linguistik pertama.
+
+NINMENI menghasilkan `NinmeniState` — representasi linguistik lengkap yang bisa dikonsumsi oleh **head apapun** yang developer definisikan sendiri.
+
+---
+
+## Pipeline — Enam Primitif
+
+```
+Kalimat (string)
+   ↓
+[ LPS ] Linguistic Parse System        → dekomposisi morfem deterministik (TBBBI)
+   ↓
+[ SFM ] Semantic Field Manifold        → representasi semantik Riemannian dari KBBI
+   ↓
+[ CPE ] Constraint Propagation Engine  → evaluasi constraint linguistik, hitung energi
+   ↓
+[ CMC ] Categorical Meaning Composer   → verifikasi komposisi makna via category theory
+   ↓
+[ TDA ] Topological Dependency Analyzer→ deteksi anomali topologis multi-skala
+   ↓
+[ KRL ] Knowledge Representation Layer → proposisi + frame semantik + resolusi referensi
+   ↓
+[ NinmeniState ]                        → output lengkap: energi, pelanggaran, skor, KRL
+```
+
+---
+
+## Oposisi terhadap Transformer
+
+| Aspek | Transformer | NINMENI |
+|---|---|---|
+| Unit dasar | Subword token (statistik) | Morfem + root + afiks (linguistik) |
+| Representasi | Dense embedding Euclidean | Riemannian manifold (SFM) |
+| Mekanisme inti | Self-attention O(n²) | Constraint propagation O(n·d) |
+| Semantic grounding | Tidak ada (distribusional) | KBBI 71K kata, 10 domain |
+| "Pemahaman" | Hidden state tidak interpretable | Proposisi eksplisit + frame semantik |
+| Referensi | Attention weight tidak transparan | Aturan kompatibilitas + recency |
+| Pelanggaran | Tidak bisa dijelaskan | Tercatat beserta lokasi dan penjelasan |
+
+---
+
+## Cara Pakai
+
+```python
+from ninmeni import NinmeniFramework
+
+fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json")
+
+# Proses kalimat
+state = fw.proses("Hakim menjatuhkan hukuman kepada terdakwa.")
+
+# Skor linguistik
+print(state.skor_linguistik)   # 0.72
+
+# Pelanggaran + lokasi
+for span in state.violation_spans:
+    print(span)
+
+# KRL — pemahaman semantik
+krl = state.krl_result
+print(krl.proposisi)    # JATUH(agen=Hakim, pasien=hukuman, penerima=terdakwa)
+print(krl.frame_nama)   # "HUKUM_PIDANA"
+print(krl.jelaskan())   # Penjelasan bahasa Indonesia lengkap
+```
+
+---
+
+## KRL — Knowledge Representation Layer
+
+KRL adalah Primitif ke-6 yang menjembatani gap antara **validasi linguistik** dan **pemahaman makna**:
+
+- **PropositionalEncoder** — kalimat → `AKSI(agen=X, pasien=Y, lokasi=Z)`
+- **FrameBank** — 12 frame semantik inti Indonesia (JUAL_BELI, HUKUM_PIDANA, KESEHATAN, dst.)
+- **FrameMatcher** — cocokkan proposisi ke frame terbaik (deterministik, bukan similarity embedding)
+- **ReferenceResolver** — "Dia" → anteseden persona terakhir dalam wacana
+
+---
+
+## Struktur Proyek
+
+```
+ninmeni/
+  primitives/
+    lps/     ← Linguistic Parse System
+    sfm/     ← Semantic Field Manifold
+    cpe/     ← Constraint Propagation Engine
+    cmc/     ← Categorical Meaning Composer
+    tda/     ← Topological Dependency Analyzer
+    krl/     ← Knowledge Representation Layer
+  base/
+    state.py ← NinmeniState (output pipeline)
+    head.py  ← NinmeniHead (base class untuk custom head)
+  heads/
+    correctness.py ← CorrectnessEvaluatorHead + LearnedCorrectnessHead
+  config.py        ← NinmeniConfig (domain-specific configuration)
+  framework.py     ← NinmeniFramework (orkestrator utama)
+```
+
+---
+
+## Test Suite
+
+```bash
+# Semua test suite harus PASS sebelum deploy
+py -3.11 tools/framework_diagnostic.py   # 6/6 PASS
+py -3.11 tools/_test_integrasi.py        # PASS
+py -3.11 tools/test_jalur_b.py           # 6/6 PASS
+py -3.11 tools/test_krl.py               # 5/5 PASS
+```
+
+---
+
+## Domain yang Didukung
+
+```python
+from ninmeni import NinmeniFramework, NinmeniConfig
+
+# Domain hukum
+fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json",
+     config=NinmeniConfig.untuk_domain("hukum"))
+
+# Domain: hukum | kesehatan | militer | pertanahan | pendidikan | bisnis
+```
+
+---
+
+## Instalasi
+
+### Dari PyPI (direkomendasikan):
+
+```bash
+pip install ninmeni
+```
+
+### Dari source:
+
+```bash
+git clone https://github.com/rafaelsistems/ninmeni.git
+cd ninmeni
+pip install -e .
+```
+
+### Requirements:
+
+- Python 3.9+
+- PyTorch 2.0+
+- NumPy 1.24+
+
+---
+
+## Quick Start
+
+```python
+from ninmeni.core.model import NinmeniModel, NinmeniConfig
+from ninmeni.linguistic.lps import build_root_vocab
+
+# Build vocab dari corpus
+corpus = ["petani menanam padi di sawah", "ibu memasak nasi di dapur"]
+vocab = build_root_vocab(corpus, min_freq=1)
+
+# Buat model
+config = NinmeniConfig()
+model = NinmeniModel(config, vocab)
+
+# Evaluasi kebenaran kalimat
+scores = model.score(["petani menanam padi di sawah"])
+print(f"Skor kebenaran: {scores['total']}")
+```
+
+---
+
+## Data
+
+- **KBBI:** `kbbi_core_v2.json` — 71,211 kata, 10 domain semantik (tidak termasuk di package)
+- **Python:** 3.9+, PyTorch 2.0+
+
+---
+
+## Penulis
+
+Emylton Leunufna
+
+---
+
+## Lisensi
+
+MIT

ninmeni-0.1.0a1/README.md

@@ -0,0 +1,202 @@
+# NINMENI
+
+> **Status:** Alpha Release (v0.1.0-alpha) — Framework siap untuk riset dan analisis. Generasi kalimat masih dalam training.
+
+**Adaptive Knowledge & Semantic Architecture for Bahasa Representation & Autonomy**
+
+> *"Kami tidak mengajarkan model bahasa Indonesia. Kami membuat model lahir sebagai bahasa Indonesia."*
+>
+> — Emylton Leunufna
+
+---
+
+## Apa itu NINMENI?
+
+NINMENI adalah **framework linguistik deterministik** untuk bahasa Indonesia. Bukan model bahasa, bukan fine-tuned Transformer — ini adalah pipeline yang menganalisis, memvalidasi, dan **memahami** kalimat bahasa Indonesia dari prinsip linguistik pertama.
+
+NINMENI menghasilkan `NinmeniState` — representasi linguistik lengkap yang bisa dikonsumsi oleh **head apapun** yang developer definisikan sendiri.
+
+---
+
+## Pipeline — Enam Primitif
+
+```
+Kalimat (string)
+   ↓
+[ LPS ] Linguistic Parse System        → dekomposisi morfem deterministik (TBBBI)
+   ↓
+[ SFM ] Semantic Field Manifold        → representasi semantik Riemannian dari KBBI
+   ↓
+[ CPE ] Constraint Propagation Engine  → evaluasi constraint linguistik, hitung energi
+   ↓
+[ CMC ] Categorical Meaning Composer   → verifikasi komposisi makna via category theory
+   ↓
+[ TDA ] Topological Dependency Analyzer→ deteksi anomali topologis multi-skala
+   ↓
+[ KRL ] Knowledge Representation Layer → proposisi + frame semantik + resolusi referensi
+   ↓
+[ NinmeniState ]                        → output lengkap: energi, pelanggaran, skor, KRL
+```
+
+---
+
+## Oposisi terhadap Transformer
+
+| Aspek | Transformer | NINMENI |
+|---|---|---|
+| Unit dasar | Subword token (statistik) | Morfem + root + afiks (linguistik) |
+| Representasi | Dense embedding Euclidean | Riemannian manifold (SFM) |
+| Mekanisme inti | Self-attention O(n²) | Constraint propagation O(n·d) |
+| Semantic grounding | Tidak ada (distribusional) | KBBI 71K kata, 10 domain |
+| "Pemahaman" | Hidden state tidak interpretable | Proposisi eksplisit + frame semantik |
+| Referensi | Attention weight tidak transparan | Aturan kompatibilitas + recency |
+| Pelanggaran | Tidak bisa dijelaskan | Tercatat beserta lokasi dan penjelasan |
+
+---
+
+## Cara Pakai
+
+```python
+from ninmeni import NinmeniFramework
+
+fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json")
+
+# Proses kalimat
+state = fw.proses("Hakim menjatuhkan hukuman kepada terdakwa.")
+
+# Skor linguistik
+print(state.skor_linguistik)   # 0.72
+
+# Pelanggaran + lokasi
+for span in state.violation_spans:
+    print(span)
+
+# KRL — pemahaman semantik
+krl = state.krl_result
+print(krl.proposisi)    # JATUH(agen=Hakim, pasien=hukuman, penerima=terdakwa)
+print(krl.frame_nama)   # "HUKUM_PIDANA"
+print(krl.jelaskan())   # Penjelasan bahasa Indonesia lengkap
+```
+
+---
+
+## KRL — Knowledge Representation Layer
+
+KRL adalah Primitif ke-6 yang menjembatani gap antara **validasi linguistik** dan **pemahaman makna**:
+
+- **PropositionalEncoder** — kalimat → `AKSI(agen=X, pasien=Y, lokasi=Z)`
+- **FrameBank** — 12 frame semantik inti Indonesia (JUAL_BELI, HUKUM_PIDANA, KESEHATAN, dst.)
+- **FrameMatcher** — cocokkan proposisi ke frame terbaik (deterministik, bukan similarity embedding)
+- **ReferenceResolver** — "Dia" → anteseden persona terakhir dalam wacana
+
+---
+
+## Struktur Proyek
+
+```
+ninmeni/
+  primitives/
+    lps/     ← Linguistic Parse System
+    sfm/     ← Semantic Field Manifold
+    cpe/     ← Constraint Propagation Engine
+    cmc/     ← Categorical Meaning Composer
+    tda/     ← Topological Dependency Analyzer
+    krl/     ← Knowledge Representation Layer
+  base/
+    state.py ← NinmeniState (output pipeline)
+    head.py  ← NinmeniHead (base class untuk custom head)
+  heads/
+    correctness.py ← CorrectnessEvaluatorHead + LearnedCorrectnessHead
+  config.py        ← NinmeniConfig (domain-specific configuration)
+  framework.py     ← NinmeniFramework (orkestrator utama)
+```
+
+---
+
+## Test Suite
+
+```bash
+# Semua test suite harus PASS sebelum deploy
+py -3.11 tools/framework_diagnostic.py   # 6/6 PASS
+py -3.11 tools/_test_integrasi.py        # PASS
+py -3.11 tools/test_jalur_b.py           # 6/6 PASS
+py -3.11 tools/test_krl.py               # 5/5 PASS
+```
+
+---
+
+## Domain yang Didukung
+
+```python
+from ninmeni import NinmeniFramework, NinmeniConfig
+
+# Domain hukum
+fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json",
+     config=NinmeniConfig.untuk_domain("hukum"))
+
+# Domain: hukum | kesehatan | militer | pertanahan | pendidikan | bisnis
+```
+
+---
+
+## Instalasi
+
+### Dari PyPI (direkomendasikan):
+
+```bash
+pip install ninmeni
+```
+
+### Dari source:
+
+```bash
+git clone https://github.com/rafaelsistems/ninmeni.git
+cd ninmeni
+pip install -e .
+```
+
+### Requirements:
+
+- Python 3.9+
+- PyTorch 2.0+
+- NumPy 1.24+
+
+---
+
+## Quick Start
+
+```python
+from ninmeni.core.model import NinmeniModel, NinmeniConfig
+from ninmeni.linguistic.lps import build_root_vocab
+
+# Build vocab dari corpus
+corpus = ["petani menanam padi di sawah", "ibu memasak nasi di dapur"]
+vocab = build_root_vocab(corpus, min_freq=1)
+
+# Buat model
+config = NinmeniConfig()
+model = NinmeniModel(config, vocab)
+
+# Evaluasi kebenaran kalimat
+scores = model.score(["petani menanam padi di sawah"])
+print(f"Skor kebenaran: {scores['total']}")
+```
+
+---
+
+## Data
+
+- **KBBI:** `kbbi_core_v2.json` — 71,211 kata, 10 domain semantik (tidak termasuk di package)
+- **Python:** 3.9+, PyTorch 2.0+
+
+---
+
+## Penulis
+
+Emylton Leunufna
+
+---
+
+## Lisensi
+
+MIT

ninmeni-0.1.0a1/ninmeni/__init__.py

@@ -0,0 +1,48 @@
+"""
+NINMENI — Framework linguistik native untuk bahasa Indonesia.
+Adaptive Knowledge & Semantic Architecture for Representation & Autonomy
+
+Author: Emylton Leunufna
+
+API Utama (framework baru):
+    from ninmeni import NinmeniFramework
+    fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json")
+    state = fw.proses("Makanan tradisional khas Dompu sangat lezat.")
+
+Lima Primitif:
+    ninmeni.primitives.lps  — Linguistic Parse System
+    ninmeni.primitives.sfm  — Semantic Field Manifold
+    ninmeni.primitives.cpe  — Constraint Propagation Engine
+    ninmeni.primitives.cmc  — Categorical Meaning Composer
+    ninmeni.primitives.tda  — Topological Dependency Analyzer
+"""
+
+from ninmeni.framework import NinmeniFramework
+from ninmeni.config import NinmeniConfig
+from ninmeni.base.state import NinmeniState, MorfemState, PelanggaranConstraint
+from ninmeni.base.head import NinmeniHead
+
+from ninmeni.primitives.lps import LPSParser, Morfem, KelasKata, PeranGramatikal
+from ninmeni.primitives.sfm import SemanticManifold, LexiconLoader
+from ninmeni.primitives.cpe import CPEngine
+from ninmeni.primitives.cmc import CMComposer
+from ninmeni.primitives.tda import TDAnalyzer
+from ninmeni.primitives.krl import KRLayer, KRLResult, Proposisi, Frame, FrameBank
+
+__version__ = "1.0.0"
+__author__  = "Emylton Leunufna"
+
+__all__ = [
+    # Framework API
+    "NinmeniFramework", "NinmeniConfig",
+    # Base
+    "NinmeniState", "MorfemState", "PelanggaranConstraint", "NinmeniHead",
+    # Primitif
+    "LPSParser", "Morfem", "KelasKata", "PeranGramatikal",
+    "SemanticManifold", "LexiconLoader",
+    "CPEngine",
+    "CMComposer",
+    "TDAnalyzer",
+    # KRL — Knowledge Representation Layer
+    "KRLayer", "KRLResult", "Proposisi", "Frame", "FrameBank",
+]

ninmeni-0.1.0a1/ninmeni/__main__.py

@@ -0,0 +1,7 @@
+"""
+Entrypoint untuk `py -m ninmeni`.
+"""
+import sys
+from ninmeni.cli import main
+
+sys.exit(main())

ninmeni-0.1.0a1/ninmeni/base/__init__.py

@@ -0,0 +1,5 @@
+"""NINMENI Framework — Base Classes."""
+from ninmeni.base.state import NinmeniState, MorfemState, PelanggaranConstraint
+from ninmeni.base.head import NinmeniHead
+
+__all__ = ["NinmeniState", "MorfemState", "PelanggaranConstraint", "NinmeniHead"]

ninmeni-0.1.0a1/ninmeni/base/head.py

@@ -0,0 +1,69 @@
+"""
+NinmeniHead — base class untuk semua head yang dibangun di atas NINMENI Framework.
+
+Developer mendefinisikan head mereka sendiri untuk task spesifik.
+Framework hanya menyediakan NinmeniState sebagai input — head menentukan output.
+"""
+
+from __future__ import annotations
+from abc import ABC, abstractmethod
+from typing import Any, Dict
+import torch.nn as nn
+
+from ninmeni.base.state import NinmeniState
+
+
+class NinmeniHead(ABC, nn.Module):
+    """
+    Base class untuk semua head yang dibangun di atas NINMENI Framework.
+
+    Framework menjamin:
+    - Input selalu berupa NinmeniState yang kaya informasi linguistik
+    - Setiap field NinmeniState punya makna eksplisit
+
+    Developer tentukan sendiri:
+    - Objective training
+    - Format output
+    - Task spesifik (evaluasi, klasifikasi, retrieval, dll.)
+
+    LARANGAN di dalam head:
+    - Tidak boleh menggunakan nn.MultiheadAttention
+    - Tidak boleh menggunakan TransformerEncoder/Decoder
+    - Tidak boleh melakukan next-token prediction
+    """
+
+    @abstractmethod
+    def forward(self, state: NinmeniState) -> Dict[str, Any]:
+        """
+        Proses NinmeniState dan kembalikan output sesuai task.
+
+        Args:
+            state: NinmeniState lengkap dari pipeline NINMENI
+
+        Returns:
+            dict output — format ditentukan oleh developer
+        """
+        ...
+
+    def cek_prinsip(self) -> None:
+        """
+        Cek apakah implementasi head melanggar prinsip NINMENI.
+        Dipanggil saat inisialisasi.
+        """
+        for name, module in self.named_modules():
+            if isinstance(module, nn.MultiheadAttention):
+                raise RuntimeError(
+                    f"⚠️  PELANGGARAN PRINSIP NINMENI\n"
+                    f"   Modul '{name}' menggunakan nn.MultiheadAttention.\n"
+                    f"   Ini melanggar prinsip: mekanisme utama harus constraint propagation,\n"
+                    f"   bukan self-attention O(n²).\n"
+                    f"   Ganti dengan CPE (Constraint Propagation Engine)."
+                )
+            cls_name = type(module).__name__
+            if "Transformer" in cls_name:
+                raise RuntimeError(
+                    f"⚠️  PELANGGARAN PRINSIP NINMENI\n"
+                    f"   Modul '{name}' adalah komponen Transformer ({cls_name}).\n"
+                    f"   NINMENI harus 100% berlawanan paradigma dengan Transformer/Mamba.\n"
+                    f"   Lihat docs/NINMENI_FRAMEWORK_SPEC.md untuk alternatif."
+                )