@akredit/acik-mcp 0.1.0 → 0.4.0

package/README.md

@@ -1,24 +1,110 @@
 # @akredit/acik-mcp
 
-Yükseköğretimde kalite güvencesi ve akreditasyon işleri için herkese açık MCP sunucusu. Kendi yapay zekâ aracınıza (Claude, Claude Code, Cursor, VS Code) bağlanır ve ona yedi araç verir:
+Yükseköğretimde kalite güvencesi ve akreditasyon işleri için herkese açık, ücretsiz MCP sunucusu. Kendi yapay zekâ aracınıza (Claude, ChatGPT, Claude Code, Cursor, VS Code) bağlanır; hazır başlangıçlar (istemler) ve on sekiz araç verir.
+
+İlke: süreci sıfır kullanıcı müdahalesiyle, hızlıca ama denetimli ve teyitli tamamlamak. Akredit özgür yazılımdır; halüsinasyona yer yoktur.
+
+## İlk 2 dakika
+
+1. Asistanınıza `https://akredit.org/mcp` adresini ekleyin (aşağıda "Bağlantı") ya da yerelde `npx -y @akredit/acik-mcp` çalıştırın.
+2. Yeni sohbette `akredit` yazın ya da hazır başlangıçlardan `akredit` komutunu seçin. Claude'da "+" altında Akredit, Cursor ve Claude Code'da eğik çizgi (/) ile görünür. Görünmüyorsa "Akredit ile başlayalım" yazın.
+3. Odağınızı seçin. Her menünün son satırı "4) Hepsini akıllıca doldur"dur: asistan her alanı kendisi doldurur, denetler, geçmeyeni düzeltir ve sonunda tek özet gösterir. Değiştirmek istediğiniz alanın numarasını yazarsınız; sonradan da kolayca güncellersiniz.
+
+## Hiç bilmeyenler için
+
+Yapay zekâyı ilk kez kullanıyorsanız bu adımları sırayla izleyin. Her adım tek iştir. Menü adları sürüme göre biraz farklı olabilir.
+
+1. Claude'a Akredit'i ekleyin. claude.ai'de sol alttaki adınıza tıklayın, Settings (Ayarlar), sonra Connectors (Bağlayıcılar). Add custom connector düğmesine basın. Ad: Akredit. Adres: `https://akredit.org/mcp`. Add deyin. Listede Akredit görünür.
+2. Yeni sohbet açın ve `akredit` yazın. Ekranda hangi aracı kullanmak istediğinizi soran bir menü görürsünüz. Bologna için 1 yazın.
+3. OBS'nize kendiniz girin. Asistan OBS adresinizi sorar ve tarayıcı aracı varsa sayfayı kenarda açar. Kullanıcı adınızı ve parolanızı yalnız OBS'nin kendi giriş ekranına, kendiniz yazın. Asistana, sohbete ya da Akredit'e asla yazmayın. Doğrulama kodu ve "Ben robot değilim" kutusu da sizindir. Girince asistana yalnız "girdim" yazın.
+4. Kenardaki tarayıcı. Claude in Chrome eklentisi, Claude masaüstü uygulamasının tarayıcı paneli ya da ChatGPT'nin ajan modu sayfayı okuyabilir. Asistan ders listenizi numaralı gösterir, siz dersin numarasını yazarsınız.
+5. Seçin. Asistan eksik alanları listeler. 4 yazarsanız hepsini akıllıca doldurur ve tek özet gösterir; isterseniz alan alan seçenek de görebilirsiniz. Kaynakları size sormaz: ders içeriğine uygun eserleri kendi web aramasıyla bulur, Akredit'in kaynak doğrulayıcısından geçirir ve bağlantısıyla gösterir. Doğrulanamayan kaynak önerilmez.
+6. OBS'ye yazma. Üç yol var: 1) asistan formu doldurur, Kaydet'e siz basarsınız 2) asistan doldurur ve sizin açık izninizle kaydeder (her sekmeden önce özet gösterip "evet" ister ya da bir kez "hepsini kaydet" izni alır) 3) alan alan kopyalarsınız. Tarayıcı aracı yoksa 3. yol kullanılır. Parolanız yine yalnız sizdedir.
+7. Engel olursa. Tarayıcı aracı yoksa, site açılmıyorsa, CAPTCHA ya da oturum düşmesi olursa asistana ne olduğunu yazın; adım adım çözüm verir. Hiçbiri olmazsa yedek yol hep var: OBS'de ders sayfasında Ctrl+A, Ctrl+C, sohbete Ctrl+V.
+
+## Hazır başlangıçlar (istemler)
+
+| İstem | Ne yapar |
+|---|---|
+| `akredit` | Araç menüsü: önce hangi aracı kullanacağınızı sorar (Bologna paketi, öğrenme çıktısı, ÇK/PÇ hesabı, ölçüt rehberi, dil denetimi ya da başka bir araç). |
+| `bologna_doldur` | OBS'nize kendiniz girersiniz; asistan Bologna sayfanızı okur, eksikleri akıllıca tamamlayıp denetler, tek özet gösterir; formu doldurur ya da kopya metni verir. Kaydet'e siz basarsınız ya da açık izninizle asistan basar. |
+| `cikti_yaz` | Ders öğrenme çıktılarını ölçülebilir fiillerle tek adımda yazar ya da iyileştirir, denetler, özet gösterir. |
+| `ck_pc_hesabi` | Excel not tablonuzu yapıştırırsınız; öğrencilere takma ad verilir, ÇK ve PÇ sağlanma düzeyi hesaplanır. |
+| `olcut_rehberi` | YÖKAK, MÜDEK, FEDEK, EPDAD ya da SABAK ölçütünü resmî metniyle bulur, kanıt listesi çıkarır. |
+| `dil_denetimi` | Rapor metnini denetler, bulguları düzeltip yeniden denetler, tek özet gösterir. |
+
+## Araçlar
 
 | Araç | Ne yapar |
 |---|---|
-| `olcut_ara` | YÖKAK ya da program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçütlerinde, EPDAD göstergelerinde ve programa özgü konularda arar. |
-| `olcut_getir` | Bir ölçütün resmî metnini, üst ve alt ölçütlerini, varsa göstergelerini ve programa özgü konularını kaynak sayfasıyla getirir. |
+| `olcut_ara` | YÖKAK ya da program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçütlerinde arar. |
+| `olcut_getir` | Bir ölçütün resmî metnini kaynak sayfasıyla getirir. |
 | `olgunluk_duzeyleri` | Alt ölçütün olgunluk düzeylerini ve örnek kanıtlarını getirir. |
-| `oz_degerlendirme_iskeleti` | Öz değerlendirme raporu iskeletini çıkarır; her bölüm EKSİK işaretli ve gereken kanıt türleriyle gelir. |
-| `bologna_denetle` | Bologna ders bilgisini eksik ve tutarsız alanlar için denetler. |
+| `oz_degerlendirme_iskeleti` | Öz değerlendirme raporu iskeletini çıkarır; her bölüm EKSİK işaretli gelir. |
+| `bologna_ayristir` | Yapıştırılan ya da tarayıcıyla okunan Bologna sayfasını çözer. Önce Proliz, olmazsa her OBS için genel ayrıştırıcı (HTML ya da düz metin, Türkçe ya da İngilizce). Bulunan ve bulunamayan alanları ve güven düzeyini söyler. Adres çekmez. |
+| `bologna_denetle` | Bologna ders paketini denetler; boş, zayıf ve tamam alanları numaralı verir. |
+| `bologna_alan_rehberi` | Bir alanın doldurma kurallarını, sınırlarını, kalıplarını ve Bloom fiillerini verir. |
+| `bologna_taslak_denetle` | Asistanın yazdığı 1-3 seçeneği kurallarla denetler: geçer ya da eksik nedenleri. Toplamları kendisi hesaplar. |
+| `is_yuku_oner` | AKTS ve T+U+L'den toplamı hedefe tam eşit üç iş yükü dağılımı önerir. |
+| `bologna_durum` | Seçilen alanların bütününe bakar: kaç alan kaldı, tamamlandı mı. |
+| `bologna_kopya_metni` | Seçilen alanları OBS'ye alan alan kopyalanacak düz metin olarak verir. |
+| `kaynak_bicimle` | Kitap ya da makale bilgisini APA 7'ye benzer künyeye çevirir; eksik bilgiyi [EKSİK] yazar, uydurmaz. |
+| `kaynak_dogrula` | DOI, ISBN ya da başlık ile yazarı açık kataloglarda (Crossref, Open Library, Google Books) arar. Bulursa doğrulanmış künye ve bağlantı, bulamazsa "doğrulanamadı" döner; doğrulanamayan kaynak önerilmez. |
+| `not_tablosu_ayristir` | Excel ya da CSV not tablosunu ÇK/PÇ hesabına hazırlar; ad ve numara sütunlarını atıp öğrencilere takma ad verir, başlıklardan soru ve çıktı eşlemesini sezer. |
 | `ck_pc_hesapla` | Ders öğrenme çıktısı ve program çıktısı sağlanma düzeyini hesaplar. |
 | `rapor_dil_denetle` | Rapor metninde kanıtsız üstünlük, belirsiz özne gibi dil sorunlarını işaretler. |
+| `kurulum_yardimi` | Bağlayıcı ekleme ve OBS'ye tarayıcıyla giriş için istemciye göre adım adım rehber. |
+| `engel_coz` | Tarayıcı aracı yok, site açılmıyor, CAPTCHA, çerçeve, oturum düşmesi gibi engeller için numaralı çözüm adımları. |
+
+Sunucu model çağırmaz ve metin üretmez. Bologna seçeneklerini sizin asistanınız yazar; Akredit kural ve kalıp verir, yazılanı denetler, sayıları hesaplar. Kurallar Akredit'in iç kurallarıdır, resmî ölçüt değildir; kurumunuzun yönergesi önceliklidir.
+
+## Örnek konuşma (kurgu ders)
+
+```
+Hoca:     akredit
+Asistan:  Bugün neye odaklanalım? 1) Bologna paketi 2) Öğrenme çıktısı 3) ÇK/PÇ 4) Ölçüt rehberi 5) Dil denetimi
+Hoca:     1
+Asistan:  Önce bir kural: kullanıcı adınızı ve parolanızı yalnız OBS'nin kendi ekranına, kendiniz yazın.
+          Bana asla yazmayın. OBS adresiniz nedir?
+Hoca:     obs.kurgu.edu.tr
+Asistan:  OBS giriş ekranını kenarda açtım. Bilgilerinizi oraya yazın, bitince bana yalnız "girdim" yazın.
+Hoca:     girdim
+Asistan:  Dersleriniz: 1) KRG204 Kurgu Ölçme Yöntemleri 2) KRG305 Kurgu Veri Çözümlemesi. Hangisi?
+Hoca:     1
+Asistan:  Sayfayı okudum. 9 alan eksik ya da zayıf:
+          1) Amaç (boş) 2) İçerik (8 kelime) 3) Çıktılar (2 var, 8-12 olmalı) 4) Haftalar (3 var) ...
+          1) Alan alan seçenek göstereyim 2) Yalnız boşlar 3) Kendim seçeyim 4) Hepsini akıllıca doldur (önerilen)
+Hoca:     4
+Asistan:  Şu alanları şöyle doldurdum, hepsi denetimden geçti:
+          1) Amaç: "Bu ders, kurgu ölçme kavramlarını ..." (66 kelime)
+          2) İçerik: ... 3) Çıktılar: 8 çıktı ... 9) Kaynaklar: 2 eser, ikisi de katalogda doğrulandı:
+             Deneme, C. (2019). Kurgu istatistiği. Kurgu Akademi. https://books.google.com/books?id=...
+          Değiştirmek istediğiniz alanın numarasını yazın; yoksa devam diyebilirsiniz.
+          Bunları daha sonra da kolayca güncelleyebilirsiniz.
+Hoca:     devam
+Asistan:  OBS'ye nasıl yazalım? 1) Formu ben doldurayım, Kaydet'e siz basın
+          2) Formu ben doldurup kaydedeyim (her sekmeden önce evet isterim) 3) Alan alan kopyalayın
+          4) Hepsini akıllıca doldur ve kaydet (önerilen)
+Hoca:     4
+Asistan:  Bütün sekmeleri doldurup kaydetmem için izin veriyor musunuz? hepsini kaydet / hayır
+Hoca:     hepsini kaydet
+Asistan:  Üç sekmeyi doldurdum ve kaydettim. Dersi Verenler satırına dokunmadım.
+Asistan:  Sayfayı yeniden okudum ve denetledim: Tamamlandı.
+```
 
-## Salt okuma
+## Salt okuma ve güvenlik
 
 - Bütün araçlar salt okumadır ve aynı girdiye aynı sonucu verir.
 - Hesap ve anahtar gerekmez. Kurum verisine erişmez, hiçbir yere yazmaz, yapay zekâ modeli çağırmaz.
+- Giriş bilgisi hiç girmez: parola, doğrulama kodu ya da oturum çerezi görülürse çağrı reddedilir, değer yanıta yazılmaz. İstemler asistana hocadan giriş bilgisi istemeyi yasaklar. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e hoca basar ya da hocanın açık izniyle asistan basar; onaya gönderimi hoca yapar.
 - Ölçüt metinleri resmî belgeden alınmıştır. Her yanıt kaynağını (belge adresi, sayfa, SHA-256) taşır. Belgeden alınamayan metin DOĞRULANMADI olarak döner.
 - Sayılar yalnız hesaptan gelir; araçlar metin uydurmaz.
-- Araçlara öğrenci adı, numarası ya da başka kişisel veri göndermeyin. Bağladığınız yapay zekâ hizmeti girdiyi kendi koşullarıyla işler.
+- Bologna sayfasındaki Dersi Verenler, Dersin Yardımcıları ve Koordinatör satırları hocanın kendi sayfasında yayımlanmış görev bilgisidir: olduğu gibi okunur, korunur ve OBS'ye geri yazılırken değiştirilmez. Bologna araçlarında yalnız giriş bilgisi reddedilir.
+- Öğrenci verisi takma adla işlenir: `not_tablosu_ayristir` ad, soyad ve numara sütunlarını hesaplamadan önce bellekte atar ve o1, o2 takma adı verir; not tablosu ve ÇK/PÇ araçlarında kalan ad ya da numara reddedilir. Öbür araçlarda T.C. kimlik numarası, öğrenci numarası ve IBAN reddedilir.
+- Sunucu istek içeriğini günlüğe yazmaz.
+- Kaynakçadaki yazar adları yayımlanmış künyedir; kaynak alanlarında serbesttir. Kaynak uydurulmaz: asistan web aramasıyla aday bulur, her adayı `kaynak_dogrula` ile katalogda doğrular ve yalnız doğrulananı bağlantısıyla önerir.
+- Sunucu kullanıcıdan adres almaz. Bologna sayfasını siz yapıştırırsınız ya da asistanınız kendi tarayıcı veya web aracıyla okur.
+- Dış istek: `kaynak_dogrula` yalnız api.crossref.org, openlibrary.org ve www.googleapis.com (Books) adreslerine sorar; sunucuyu kendiniz barındırıyorsanız bu üç adrese HTTPS çıkışı açık olmalıdır. Bağladığınız yapay zekâ hizmeti girdiyi kendi koşullarıyla işler.
 
 ## Bağlantı
 
@@ -42,7 +128,7 @@ Uzak sunucu:
 claude mcp add --transport http akredit https://akredit.org/mcp
 ```
 
-Yerel sunucu (Node.js 22.18 ya da üstü):
+Yerel sunucu (npm paketi `@akredit/acik-mcp`, Node.js 22.18 ya da üstü):
 
 ```bash
 claude mcp add akredit -- npx -y @akredit/acik-mcp

package/dist/apps/acik-mcp/src/araclar.d.ts

@@ -1,31 +1,5 @@
-import { z } from "zod";
-export declare const DEPO = "https://github.com/tialkan/akredit";
-/** Her yanıtta yer alan not. */
-export declare const AKREDIT_NOTU = "Akredit ba\u011F\u0131ms\u0131z, a\u00E7\u0131k kaynak bir ara\u00E7t\u0131r; Y\u00D6KAK ile ba\u011F\u0131 yoktur. Sonu\u00E7lar resm\u00EE de\u011Ferlendirme yerine ge\u00E7mez; beyan ve karar kurumdad\u0131r.";
-export interface Kaynak {
-    ad: string;
-    adres: string;
-    sayfa?: number | null;
-    sha256?: string | null;
-    erisimTarihi?: string;
-}
-export interface AracSonucu {
-    sonuc: unknown;
-    kaynak: Kaynak[];
-}
-export interface AracBaglami {
-    simdi: () => Date;
-}
-export interface AcikArac<S extends z.ZodObject = z.ZodObject> {
-    ad: string;
-    baslik: string;
-    aciklama: string;
-    girdi: S;
-    calistir: (girdi: z.infer<S>, b: AracBaglami) => AracSonucu;
-}
-/** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
-export declare class AracHatasi extends Error {
-}
+import { type AcikArac } from "./temel.ts";
+export * from "./temel.ts";
 /** Düzey tanımı belgeden ayrılamayan gösterge için dönen değer; tanım uydurulmaz. */
 export declare const OKUNAMADI = "Belgeden okunamad\u0131";
 export declare const ACIK_ARACLAR: readonly AcikArac[];

package/dist/apps/acik-mcp/src/araclar.js

@@ -2,17 +2,17 @@
 // durum yok. Ölçüt metni yalnız resmî belgeden çıkarılmış çerçeve verisinden gelir (ilke 6); belgeden
 // alınamayan metin DOĞRULANMADI olarak döner. Sayılar yalnız @akredit/olcme hesabından gelir (ilke 2).
 // Öz değerlendirme iskeleti metin yazmaz: her bölüm EKSİK işaretiyle ve gereken kanıt türleriyle döner (ilke 1).
-import { bolognaDenetle, dilDenetle, } from "../../../packages/cekirdek/src/index.js";
+import { dilDenetle } from "../../../packages/cekirdek/src/index.js";
 import { belgeAdi, DOGRULANMADI, EPDAD_DERECELENDIRME_ANAHTARI, olcutEkleri, ozguBagi, ozguBolumListesi, PROGRAM_BELGELERI, PROGRAM_CERCEVELERI, tumOlcutler, YOKAK_KIDR_3_2_1, YOKAK_KURUMSAL_3_3, } from "../../../packages/cerceveler/src/index.js";
 import { dersiOlc, HESAP_SURUMU } from "../../../packages/olcme/src/index.js";
 import { z } from "zod";
-export const DEPO = "https://github.com/tialkan/akredit";
-/** Her yanıtta yer alan not. */
-export const AKREDIT_NOTU = "Akredit bağımsız, açık kaynak bir araçtır; YÖKAK ile bağı yoktur. Sonuçlar resmî değerlendirme yerine geçmez; beyan ve karar kurumdadır.";
-const arac = (a) => a;
-/** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
-export class AracHatasi extends Error {
-}
+import { BOLOGNA_ARACLARI, bolognaDenetleAraci } from "./bologna.js";
+import { kaynakBicimleAraci } from "./kaynak.js";
+import { kaynakDogrulaAraci } from "./kaynak-dogrula.js";
+import { notTablosuAyristirAraci } from "./not-tablosu.js";
+import { AracHatasi, arac, DEPO, KOD_KAYNAGI } from "./temel.js";
+import { engelCozAraci, kurulumYardimiAraci } from "./yardim.js";
+export * from "./temel.js";
 // ---------------------------------------------------------------- Çerçeve yardımcıları
 const BELGE_ADI = {
     [YOKAK_KURUMSAL_3_3.kaynak?.dosya ?? ""]: "YÖKAK Değerlendirme Programları Kılavuzu 3.3, Ek-1 Dereceli Değerlendirme Anahtarı",
@@ -77,7 +77,6 @@ function belgeKaynagi(c, dosya, sayfa) {
     };
 }
 const olcutKaynagi = (c, o) => belgeKaynagi(c, o.kaynakDosya, o.kaynakSayfa);
-const KOD_KAYNAGI = (yol, ad) => ({ ad, adres: `${DEPO}/tree/main/${yol}` });
 function olcutBul(c, kod) {
     const k = kod.trim().toLocaleUpperCase("tr").replace(/\.$/u, "");
     const o = tumOlcutler(c.olcutler).find((x) => x.kod === k);
@@ -91,7 +90,8 @@ const metinGoster = (o) => (o.metinDurumu === "dogrulanmadi" ? DOGRULANMADI : o.
 const olcutAra = arac({
     ad: "olcut_ara",
     baslik: "Ölçüt ara (YÖKAK ve program akreditasyonu)",
-    aciklama: "YÖKAK 3.3 ya da bir program akreditasyonu çerçevesinin (MÜDEK, FEDEK, SABAK, EPDAD) ölçüt ağacında kod, başlık ya da metinde geçen ifadeye göre arar. Program çerçevelerinde EPDAD göstergeleri ile MÜDEK EK-1 ve FEDEK programa özgü konular da aranır. Metinler resmî belgeden çıkarılmıştır; belgeden alınamayan metin DOĞRULANMADI olarak döner.",
+    aciklama: "YÖKAK ya da program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçütlerinde sözcük ya da kodla arar. Metinler resmî belgeden alınır; alınamayan metin DOĞRULANMADI döner.",
+    sonrakiAdim: "Hocaya en uygun 2-3 sonucu numaralı gösterin; seçtiği ölçütün tam metni için olcut_getir'i çağırın.",
     girdi: z.object({
         sorgu: z.string().trim().min(1).max(200).describe("Aranacak ifade ya da kod, ör. 'paydaş katılımı' ya da 'B.3'"),
         cerceve: cerceveGirdisi,
@@ -171,7 +171,8 @@ const olcutAra = arac({
 const olcutGetir = arac({
     ad: "olcut_getir",
     baslik: "Ölçütü getir (YÖKAK ve program akreditasyonu)",
-    aciklama: "Bir ölçütün resmî metnini, kaynak belgesini, sayfasını ve belgenin SHA-256 özetini döndürür. Alt ölçütlerin listesi ve üst ölçüt de gelir. EPDAD alt standartlarında göstergeler ve dörtlü düzey tanımları gelir (belgeden ayrılamayan tanım 'Belgeden okunamadı' döner). MÜDEK 5.1 ve FEDEK 10.1'de disipline ya da programa özgü bölümlerin listesi gelir; bölüm kodu verilirse o bölümün konuları da gelir. Belgeden alınamayan metin DOĞRULANMADI olarak döner; tahminle doldurulmaz.",
+    aciklama: "Bir ölçütün resmî metnini kaynak belge, sayfa ve dosya özetiyle getirir; üst ve alt ölçütler, EPDAD göstergeleri, MÜDEK ve FEDEK programa özgü bölümleri de gelir. Metin tahminle doldurulmaz.",
+    sonrakiAdim: "Alt ölçütse olgunluk_duzeyleri ile düzeyleri ve örnek kanıtları gösterin. Hocaya sorun: 1) örnek kanıtlar 2) başka ölçüt 3) öz değerlendirme iskeleti.",
     girdi: z.object({
         kod: z
             .string()
@@ -235,7 +236,8 @@ const olcutGetir = arac({
 const olgunlukDuzeyleri = arac({
     ad: "olgunluk_duzeyleri",
     baslik: "Alt ölçüt olgunluk düzeyleri ve örnek kanıtlar",
-    aciklama: "Bir alt ölçütün (ör. 'B.1.2') dereceli değerlendirme anahtarındaki 1-5 olgunluk düzeyi metinlerini ve belgedeki örnek kanıtları döndürür. Düzeyi siz ya da kurumunuz belirler; bu araç düzey önermez.",
+    aciklama: "Bir YÖKAK alt ölçütünün (ör. B.1.2) 1-5 olgunluk düzeyi metinlerini ve örnek kanıtlarını getirir. Düzey önermez; düzeye kurum kanıtla karar verir.",
+    sonrakiAdim: "Örnek kanıtları hocanın elindekilerle eşleştirin: her kanıt için 1) var 2) yok 3) emin değilim diye sorun. Yok olanlar EKSİK kalır.",
     girdi: z.object({ kod: z.string().trim().min(1).max(20).describe("Alt ölçüt kodu, ör. 'B.1.2'") }),
     calistir: ({ kod }) => {
         const CERCEVE = YOKAK_KURUMSAL_3_3;
@@ -265,7 +267,8 @@ const olgunlukDuzeyleri = arac({
 const ozDegerlendirmeIskeleti = arac({
     ad: "oz_degerlendirme_iskeleti",
     baslik: "Öz değerlendirme raporu iskeleti",
-    aciklama: "KİDR 3.2.1 şablonuna göre rapor bölümlerini, her bölümün ölçüt ve alt ölçütlerini ve gereken örnek kanıtları döndürür. Metin yazmaz: her alt ölçüt EKSİK işaretiyle gelir, kanıt bağlandıkça doldurulur.",
+    aciklama: "Öz değerlendirme raporunun (KİDR 3.2.1) bölümlerini, alt ölçütlerini ve gereken örnek kanıtları verir. Metin yazmaz; her bölüm EKSİK gelir.",
+    sonrakiAdim: "Hocanın yazdığı bölüm metnini rapor_dil_denetle ile denetleyin. Kanıtı olmayan cümle EKSİK kalır.",
     girdi: z.object({
         bolum: z
             .enum(["A", "B", "C", "D"])
@@ -308,112 +311,15 @@ const ozDegerlendirmeIskeleti = arac({
         };
     },
 });
-// ---------------------------------------------------------------- Bologna denetimi
-const sayiYaDaBos = z.number().nullable().default(null);
-const BolognaDersGirdisi = z.object({
-    kod: z.string().trim().min(1).max(30),
-    ad: z.string().max(200).optional(),
-    zorunlu: z.boolean().default(true),
-    yariyil: z.number().int().min(1).max(16).nullable().default(null),
-    tul: z.string().max(20).optional().describe("Teori+Uygulama+Laboratuvar, ör. '2+1+0'"),
-    kredi: sayiYaDaBos,
-    akts: sayiYaDaBos,
-    guncelleme: z.string().max(20).optional().describe("Son güncelleme tarihi, GG.AA.YYYY"),
-    ciktilar: z
-        .array(z.object({ kod: z.string().max(20), metin: z.string().max(1000) }))
-        .max(40)
-        .default([]),
-    degerlendirme: z
-        .array(z.object({ ad: z.string().max(200), sayi: sayiYaDaBos, katki: sayiYaDaBos }))
-        .max(40)
-        .default([]),
-    isyuku: z
-        .array(z.object({ ad: z.string().max(200), sayi: sayiYaDaBos, sure: sayiYaDaBos, toplam: sayiYaDaBos }))
-        .max(40)
-        .default([]),
-    dersYapisi: z
-        .array(z.object({ alan: z.string().max(200), yuzde: sayiYaDaBos }))
-        .max(20)
-        .default([]),
-    haftalar: z.number().int().min(0).max(30).default(0).describe("Haftalık konu satırı sayısı"),
-    katki: z
-        .record(z.string().max(20), z.record(z.string().max(20), z.string().max(5)))
-        .default({})
-        .describe("Ders çıktısı ya da 'Tüm' satırı → program çıktısı kodu → katkı değeri ('1'-'5', '' ya da '-')"),
-});
-const bolognaDenetleAraci = arac({
-    ad: "bologna_denetle",
-    baslik: "Bologna ders bilgisini denetle",
-    aciklama: "Yapıştırdığınız ders bilgi paketi verisini (AKTS, iş yükü, değerlendirme, öğrenme çıktıları, katkı tablosu) Akredit'in Bologna kurallarıyla denetler: AKTS-iş yükü uyumu, değerlendirme toplamı, eksik çıktı, güncellik, matris tutarlılığı. Kurallar resmî ölçüt değildir; tutarsızlığı işaretler, kararı komisyon verir.",
-    girdi: z.object({
-        ders: BolognaDersGirdisi,
-        programCiktilari: z
-            .array(z.object({ kod: z.string().max(20), metin: z.string().max(1000) }))
-            .max(40)
-            .optional()
-            .describe("Program çıktıları; verilirse program düzeyindeki kurallar da çalışır"),
-        matrisSatiri: z
-            .record(z.string().max(20), z.string().max(5))
-            .optional()
-            .describe("Program matrisinde bu dersin satırı: program çıktısı kodu → değer"),
-        aktsSaat: z
-            .tuple([z.number().min(1), z.number().max(60)])
-            .optional()
-            .describe("AKTS başına saat aralığı; varsayılan [25, 30]"),
-    }),
-    calistir: ({ ders, programCiktilari, matrisSatiri, aktsSaat }, b) => {
-        const sayfa = {
-            ...ders,
-            ad: ders.ad ?? ders.kod,
-            bilgiler: {},
-        };
-        const pkodlar = Object.keys(matrisSatiri ?? {});
-        const veri = {
-            adres: "kullanici-girdisi",
-            okundu: b.simdi().toISOString(),
-            programCiktilari: programCiktilari ?? [],
-            matris: {
-                pkodlar,
-                dersler: matrisSatiri
-                    ? [
-                        {
-                            kod: ders.kod,
-                            ad: ders.ad ?? ders.kod,
-                            zorunlu: ders.zorunlu,
-                            grup: null,
-                            yariyil: ders.yariyil,
-                            grupBasligi: false,
-                            degerler: matrisSatiri,
-                        },
-                    ]
-                    : [],
-            },
-            tyycIsaret: null,
-            dersler: [{ ...sayfa, zorunlu: ders.zorunlu, bos: false, kaynak: "kullanici-girdisi" }],
-        };
-        let bulgular = bolognaDenetle(veri, { simdi: b.simdi().getTime(), ...(aktsSaat ? { aktsSaat } : {}) });
-        // Program düzeyi kuralları yalnız program çıktıları verildiyse anlamlıdır.
-        if (!programCiktilari)
-            bulgular = bulgular.filter((x) => x.konu !== "-");
-        return {
-            sonuc: {
-                ders: ders.kod,
-                hataSayisi: bulgular.filter((x) => x.duzey === "hata").length,
-                uyariSayisi: bulgular.filter((x) => x.duzey === "uyari").length,
-                bulgular,
-                not: "Kurallar Akredit'in iç kurallarıdır, resmî ölçüt değildir. Düzeltme kararını ders sorumlusu ve komisyon verir.",
-            },
-            kaynak: [KOD_KAYNAGI("packages/cekirdek/src/bologna/denetim.ts", "Akredit Bologna denetim kuralları")],
-        };
-    },
-});
 // ---------------------------------------------------------------- ÇK/PÇ sağlanma hesabı
 const kimlik = z.string().trim().min(1).max(30);
 const ANONIM = /^(?![0-9]{7,}$)[\p{L}\p{N}_.-]{1,24}$/u;
 const ckPcHesapla = arac({
     ad: "ck_pc_hesapla",
+    kisiselVeriKapsami: "tam",
     baslik: "ÇK ve PÇ sağlanma düzeyi hesabı",
-    aciklama: "Anonim puan tablosundan ders öğrenme çıktısı (ÇK) başarısını ve program çıktısı (PÇ) sağlanma düzeyini hesaplar (@akredit/olcme). Öğrenci kimliği yerine 'o1', 'o2' gibi takma ad kullanın; numara ve ad kabul edilmez. Öğrenci bazında sonuç dönmez, yalnız toplu değerler döner.",
+    aciklama: "Takma adlı puan tablosundan ders öğrenme çıktısı (ÇK) başarısını ve program çıktısı (PÇ) sağlanma düzeyini hesaplar. Öğrenci adı ve numarası kabul edilmez; yalnız toplu sonuç döner.",
+    sonrakiAdim: "Sonucu tablo olarak gösterin, sayıları yalnız bu yanıttan alın. Eşiğin altında kalan çıktılar için hocaya sorun: 1) iyileştirme notu yaz 2) başka eşikle yeniden hesapla 3) bitir.",
     girdi: z.object({
         dersKodu: kimlik,
         donem: z.string().trim().min(1).max(40).describe("ör. '2025-2026 Güz'"),
@@ -511,7 +417,8 @@ const ckPcHesapla = arac({
 const raporDilDenetle = arac({
     ad: "rapor_dil_denetle",
     baslik: "Rapor dil denetimi",
-    aciklama: "Öz değerlendirme ya da faaliyet raporu metnini dil kurallarıyla denetler: kanıtsız üstünlük ifadesi, ölçüsüz nicelik, yazıyla sayı, öznesiz eylem, dönem ve tarih tutarlılığı. Metni değiştirmez, yalnız işaretler. Paragrafları boş satırla ayırın.",
+    aciklama: "Rapor metnindeki dil sorunlarını işaretler: kanıtsız üstünlük, ölçüsüz nicelik, öznesiz eylem, dönem ve tarih tutarsızlığı. Metni değiştirmez.",
+    sonrakiAdim: "Her bulgu için 2-3 numaralı düzeltme seçeneği sunun (uydurma sayı ya da kanıt eklemeden); hoca seçince düzeltilmiş metni yeniden denetleyin.",
     girdi: z.object({
         metin: z.string().min(1).max(60_000),
         donem: z
@@ -543,6 +450,12 @@ export const ACIK_ARACLAR = [
     olgunlukDuzeyleri,
     ozDegerlendirmeIskeleti,
     bolognaDenetleAraci,
+    ...BOLOGNA_ARACLARI,
+    kaynakBicimleAraci,
+    kaynakDogrulaAraci,
+    notTablosuAyristirAraci,
     ckPcHesapla,
     raporDilDenetle,
+    kurulumYardimiAraci,
+    engelCozAraci,
 ];

package/dist/apps/acik-mcp/src/bologna.d.ts

@@ -0,0 +1,209 @@
+import { type Bulgu } from "../../../packages/cekirdek/src/index.js";
+import { z } from "zod";
+import { type AcikArac } from "./temel.ts";
+export declare const ALAN_KODLARI: readonly ["amac", "icerik", "yontem", "notlar", "onKosul", "ciktilar", "degerlendirme", "isyuku", "dersYapisi", "haftalar", "katki", "ska", "kaynaklar", "yetkililer"];
+export type AlanKodu = (typeof ALAN_KODLARI)[number];
+interface AlanBilgisi {
+    ad: string;
+    /** OBS düzenleme ekranındaki sekme (Proliz). */
+    sekme: string;
+    kurallar: string[];
+    sinir?: Record<string, number | string>;
+    kaliplar: string[];
+    yasaklar: string[];
+    /** MCP bu alanı taşıyabilir mi (kişisel veri sınırı). */
+    mcpTasir: boolean;
+}
+/** Akredit'in Bologna doldurma kuralları (packages/cekirdek/src/bologna/taslak.ts, apps/cli/skills/bologna-doldur). */
+export declare const ALANLAR: Record<AlanKodu, AlanBilgisi>;
+/** Bloom'un yenilenmiş sınıflaması düzeylerine göre örnek fiiller. Akredit örneğidir, resmî liste değildir. */
+export declare const BLOOM_FIILLERI: {
+    duzey: string;
+    fiiller: string[];
+}[];
+/** Bir taslak bulgusunun hangi alana ait olduğu. "genel" birden çok alana değen bulgudur. */
+export declare function bulguAlani(b: Bulgu): AlanKodu | "temel" | "genel";
+declare const TaslakAlanlari: z.ZodObject<{
+    amac: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    icerik: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    yontem: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    notlar: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    onKosul: z.ZodOptional<z.ZodString>;
+    ciktilar: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kod: z.ZodString;
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+        tur: z.ZodEnum<{
+            Bilgi: "Bilgi";
+            Beceri: "Beceri";
+            Yetkinlik: "Yetkinlik";
+        }>;
+    }, z.core.$strip>>>;
+    degerlendirme: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ad: z.ZodString;
+        sayi: z.ZodNumber;
+        katki: z.ZodNumber;
+    }, z.core.$strip>>>;
+    isyuku: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ad: z.ZodString;
+        sayi: z.ZodNumber;
+        sure: z.ZodNumber;
+    }, z.core.$strip>>>;
+    dersYapisi: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        alan: z.ZodString;
+        yuzde: z.ZodNumber;
+    }, z.core.$strip>>>;
+    haftalar: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        hafta: z.ZodNumber;
+        konu: z.ZodObject<{
+            tr: z.ZodString;
+            en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        onHazirlik: z.ZodString;
+        dokuman: z.ZodString;
+    }, z.core.$strip>>>;
+    katki: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodNull, z.ZodLiteral<"">]>>>>;
+    ska: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    kaynaklar: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kaynakSayisi: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type TaslakAlanlariT = z.infer<typeof TaslakAlanlari>;
+export interface Yetkili {
+    /** Sayfadaki etiket, ör. "Dersi Verenler". */
+    rol: string;
+    /** Sayfadaki değer, olduğu gibi. */
+    deger: string;
+}
+declare const DersTemeli: z.ZodObject<{
+    kod: z.ZodOptional<z.ZodString>;
+    ad: z.ZodOptional<z.ZodString>;
+    akts: z.ZodOptional<z.ZodNumber>;
+    tul: z.ZodOptional<z.ZodString>;
+    bolen: z.ZodDefault<z.ZodNumber>;
+    yetkililer: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rol: z.ZodString;
+        deger: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type DersTemeliT = z.infer<typeof DersTemeli>;
+/** Taslak alanlarını cekirdek kurallarıyla denetler; yalnız verilen alanların bulgularını alan alan döndürür. */
+export declare function alanBulgulari(ders: DersTemeliT, alanlar: TaslakAlanlariT, s: {
+    ingilizce: boolean;
+    programCiktilari?: string[] | undefined;
+}): Map<AlanKodu | "genel", Bulgu[]>;
+/** Bütün sayılar burada hesaplanır; asistan toplam yazmaz (ilke 2). */
+export declare function bolognaHesabi(ders: DersTemeliT, alanlar: TaslakAlanlariT): {
+    isyuku: {
+        satirlar: {
+            ad: string;
+            sayi: number;
+            sure: number;
+            toplam: number;
+        }[];
+        toplam: number;
+        hedef: number | null;
+        fark: number | null;
+        aktsBasinaSaat: number | null;
+        dersSuresiHaftalikBeklenen: number | null;
+        dersSuresiHaftalikVerilen: number | null;
+        aciklama: string;
+    } | null;
+    degerlendirmeToplami: number | null;
+    dersYapisiToplami: number | null;
+    ciktiSayisi: number | null;
+    haftaSayisi: number | null;
+};
+export declare const bolognaDenetleAraci: AcikArac<z.ZodObject<{
+    ders: z.ZodObject<{
+        kod: z.ZodString;
+        ad: z.ZodOptional<z.ZodString>;
+        zorunlu: z.ZodDefault<z.ZodBoolean>;
+        yariyil: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        tul: z.ZodOptional<z.ZodString>;
+        kredi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        akts: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        guncelleme: z.ZodOptional<z.ZodString>;
+        amac: z.ZodOptional<z.ZodString>;
+        icerik: z.ZodOptional<z.ZodString>;
+        yontem: z.ZodOptional<z.ZodString>;
+        notlar: z.ZodOptional<z.ZodString>;
+        kaynakSayisi: z.ZodOptional<z.ZodNumber>;
+        kaynaklar: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        yetkililer: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rol: z.ZodString;
+            deger: z.ZodString;
+        }, z.core.$strip>>>;
+        ciktilar: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kod: z.ZodString;
+            metin: z.ZodString;
+        }, z.core.$strip>>>;
+        degerlendirme: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ad: z.ZodString;
+            sayi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            katki: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        isyuku: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ad: z.ZodString;
+            sayi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            sure: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            toplam: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        dersYapisi: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            alan: z.ZodString;
+            yuzde: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        haftalar: z.ZodDefault<z.ZodNumber>;
+        katki: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>;
+    programCiktilari: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kod: z.ZodString;
+        metin: z.ZodString;
+    }, z.core.$strip>>>;
+    matrisSatiri: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    aktsSaat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strip>>;
+/** Proliz sayfası mı: üst bilgi tablosu ("Yarıyıl, Kodu") ya da program çıktıları tablosu. */
+export declare function prolizMi(html: string): boolean;
+/**
+ * Yapıştırılan HTML'den görev satırlarını (Dersi Verenler, Yardımcılar, Koordinatör) yetkililer listesine, kaynak
+ * satırlarını künye listesine ayırır. Değerler olduğu gibi korunur; hiçbir şey atılmaz.
+ */
+export declare function bolognaSatirAyikla(html: string): {
+    html: string;
+    yetkililer: Yetkili[];
+    kaynaklar: string[];
+};
+/** bologna_ayristir ön ayıklaması: yalnız giriş bilgisi (oturum kimliği, parola kutusu, çerez) atılır. */
+export declare function ayristirOnAyikla(g: unknown): {
+    girdi: unknown;
+    atilan: string[];
+    ileti?: string;
+};
+/** Hedefe tam eşit iş yükü dağılımları (deterministik). Son tek satır artığı alır, böylece toplam tam tutar. */
+export declare function isYukuDagilimlari(akts: number, tul: string, hafta?: number, bolen?: number): {
+    secenek: number;
+    ad: string;
+    aciklama: string;
+    isyuku: {
+        ad: string;
+        sayi: number;
+        sure: number;
+    }[];
+    toplam: number;
+    hedef: number;
+    tamEsit: boolean;
+}[];
+export declare const BOLOGNA_ARACLARI: readonly AcikArac[];
+export {};