README.md

metadata

license: mit
title: MitrAnlil Pilot3
sdk: gradio
emoji: 🏢
colorFrom: yellow
colorTo: yellow
short_description: YOK Kanunlar için normatif AI asistanı
sdk_version: 6.20.0

MitrAnlil MCKF v0.8 Multi-Document Corpus

MitrAnlil, yükseköğretim mevzuatı için kaynak gösterimli normatif bilgi asistanıdır. Bu paket v0.7 pre-release mimarisini koruyarak 2547 tek belge yapısından üç belgeli MCKF corpus yapısına geçer.

Indexed Documents

• TR-KANUN-2547 — 2547 sayılı Yükseköğretim Kanunu
• TR-KANUN-2914 — 2914 sayılı Yükseköğretim Personel Kanunu
• TR-KANUN-2809 — 2809 sayılı Yükseköğretim Kurumları Teşkilatı Kanunu

Belge registry:

data/registry/legal_documents.json

Runtime tek corpus kaynağını yükler:

data/mckf/corpus_mckf_ontology.json

2547 per-document çıktıları geriye dönük audit ve regresyon için korunur; legacy chunk/semantic-unit/canonical-concept dosyaları runtime’a geri sokulmamıştır.

Build

python tools/build_mckf_from_source.py --all
python tools/build_mckf_from_source.py --document TR-KANUN-2914
python tools/build_mckf_from_source.py --document TR-KANUN-2809

No-arg legacy mode yalnız TR-KANUN-2547 çıktısını yeniden üretir:

python tools/build_mckf_from_source.py

Runtime Flow

conversation_intent
-> source_router
-> corpus evidence retrieval with document/article scoring
-> deterministic fallback or LLM synthesis from selected evidence only
-> full article/source rendering
-> feedback logging

The source router scores candidate documents before retrieval. Returned candidates expose scoring details including source-router score, document-domain score, semantic-role score, norm-type score, lexical score, structure score, evidence-focus score, cross-document bonus, wrong-document penalty, and generic-article penalty.

RDFox Pilot Layer

Bu sürümde RDFox mimarisi MVP'ye harici RDFox servis bağımlılığı olmadan indirgenmiştir. corpus_mckf_ontology.json tek runtime kaynağı olarak kalır; RDFox uyumlu pilot katman bu kaynaktan üretilir:

data/mckf/rdfox_pilot_manifest.json
data/mckf/rdfox_pilot_triples.nt
data/mckf/rdfox_pilot_rules.dlog

Pilot katman şu dar çekirdeği kapsar:

• Document ingestion
• Semantic Normative Unit parser
• MCKF builder
• Hybrid retrieval: semantic-role/dense-ready, BM25/lexical, concept-role
• Evidence sufficiency gate
• Source-locked generation
• Citation renderer

Runtime'da rdfox_pilot.py beş micro-rule sağlar: deadline priority, procedure chain, exception warning, cross-reference follow ve definition attach. Bu kurallar retrieval skor kırılımına pilot_rule_score ve pilot_rule_hits olarak yansır; RDFox/Datalog karşılığı rdfox_pilot_rules.dlog içinde tutulur.

Verification

Run from this package root:

python -m compileall .
python tools/build_mckf_from_source.py --all
python tools/audit_mckf.py --all
python tools/run_golden_checks.py
python tools/run_multidoc_golden_checks.py
python tools/runtime_health_check.py
python tools/export_feedback_regression_candidates.py

Local verification uses ..\.venv\Scripts\python.exe when python is not on PATH.

Known Limits

• Local verification does not execute external Groq synthesis because GROQ_API_KEY is not present locally.
• 2914 schedule sections are detected as separate ScheduleUnit source units and are retrievable; row-level table semantics are not yet normalized into typed cells.
• The semantic role extractor remains heuristic.
• The system is a source-grounded explanation assistant, not legal advice.