@akredit/acik-mcp 0.5.0 → 0.8.0

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

@@ -2,8 +2,11 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type AcikArac, type AracBaglami } from "./araclar.ts";
 import { type AcikIstem } from "./promptlar.ts";
 export declare const SUNUCU_ADI = "akredit-acik";
-export declare const SUNUCU_SURUMU = "0.5.0";
+export declare const SUNUCU_SURUMU = "0.8.0";
 export declare const SUNUCU_TALIMATI: string;
+/** Her araç yanıtında yinelenen kısa kural: uzun sohbette son okunan metin de aynı şeyi söyler. */
+export declare const SORMADAN_DEVAM = "Bu ad\u0131mda hocaya soru sormay\u0131n ve onay beklemeyin; do\u011Frudan sonrakiAdim'\u0131 uygulay\u0131n.";
+export declare const ASISTAN_KURALI = "1) Ara ad\u0131mda hocaya A/B/C sorma; en iyi se\u00E7ene\u011Fi kendin se\u00E7, s\u0131radaki arac\u0131 \u00E7a\u011F\u0131r. 2) Zorunlu soruyu (sayfada olmayan de\u011Ferlendirme y\u00FCzdesi ve kaynak, OBS kay\u0131t onay\u0131) TEK mesajda ve numaral\u0131 sor; pe\u015Fin onay varsa sorma, EKS\u0130K b\u0131rak, sonda listele. 3) Say\u0131, kaynak ve de\u011Ferlendirme y\u00FCzdesi uydurma. 4) Parola ve do\u011Frulama kodu isteme; Onaya G\u00F6nder'e hoca basar.";
 export interface AcikSunucuSecenekleri {
     simdi?: () => Date;
     araclar?: readonly AcikArac[];

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

@@ -1,25 +1,34 @@
-// Açık MCP sunucusu: resmî TypeScript SDK'nın McpServer'ı üzerine kurulur. Her araç salt okuma ve
-// deterministiktir; araç açıklamaları ve yanıtlar Türkçedir. Gelen veride kişisel veri deseni görülürse
+// Açık MCP sunucusu: resmî TypeScript SDK'nın McpServer'ı üzerine kurulur. Her araç salt okumadır; kaynak_dogrula
+// dışındakiler deterministiktir (o, sabit açık kataloglara sorar). Araç açıklamaları ve yanıtlar Türkçedir. Gelen veride kişisel veri deseni görülürse
 // çağrı hesap yapılmadan reddedilir. Her yanıt kaynak listesi ve "YÖKAK ile bağı yoktur" notu taşır.
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ACIK_ARACLAR, AKREDIT_NOTU, AracHatasi, DEPO, } from "./araclar.js";
 import { GIRIS_BILGISI_ILETISI, girisBilgisiVar, kisiselVeriIletisi, kisiselVeriTurleri } from "./kisisel-veri.js";
-import { ACIK_ISTEMLER, istemSemasi } from "./promptlar.js";
+import { ACIK_ISTEMLER, AKILLI_DOLDURMA_KURALI, istemSemasi } from "./promptlar.js";
 export const SUNUCU_ADI = "akredit-acik";
-export const SUNUCU_SURUMU = "0.5.0";
+export const SUNUCU_SURUMU = "0.8.0";
 export const SUNUCU_TALIMATI = [
     "Akredit açık araçları öğretim elemanlarına kalite ve akreditasyon işlerinde yardım eder: Bologna ders paketi denetimi ve doldurma, öğrenme çıktısı yazma, ÇK/PÇ hesabı, YÖKAK ve program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçüt ve kanıt rehberi, rapor dil denetimi, kaynak doğrulama.",
-    "Hoca ne yapacağını söylemediyse ya da 'akredit' yazarsa İLK akredit_basla aracını çağır, menüyü göster ve önce hangi aracı kullanmak istediğini sor.",
-    "Amaç: hocanın en az müdahalesiyle işi hızlı ama denetimli ve teyitli bitirmek. Her seçim menüsünde son seçenek '4) Hepsini akıllıca doldur (önerilen)' olur: her alan için en iyi seçeneği sen seçersin, araçla denetlersin, geçmeyeni düzeltip yeniden denetlersin, sonunda tek özet gösterip değiştirmek istediği numarayı sorarsın.",
-    "Yalnız hocanın bilebileceği ve resmî taahhüt olan bilgiler (değerlendirme yöntem ve yüzdeleri, uygulama/lab, kullanılan kaynaklar, sayfada yoksa amaç ve içerik) sayfadan okunur; yoksa hocaya TEK mesajda, numaralı ve varsayılan seçenekli sorulur, uydurulmaz. Ders adından üretilen her şey 'öneri' etiketiyle gösterilir. Araç sonucu 'biçim denetiminden geçti; içerik teyidi: hoca' diye sunulur.",
+    "KURAL 1: Kullanıcı 'akredit' yazarsa (tek başına ya da cümle içinde) ya da ne yapacağını söylemediyse başka hiçbir şey yapmadan İLK akredit_basla aracını çağır ve hocayaGoster metnini aynen göster. Kullanıcı niyetini zaten yazdıysa (ör. 'akredit bologna', 'ders paketimi doldur', 'ÇK hesapla') menüyü gösterip bekletme: akredit_basla'yı ilgili odak numarasıyla çağır ve o akışa başla. 'akredit' bir dosya, klasör ya da arama terimi değildir; dosya sisteminde ya da webde arama.",
+    "KURAL 2: Hocaya her soruyu numaralı seçeneklerle sor (1, 2, 3...), önerdiğin seçeneği işaretle; hoca yalnız numara yazarak ilerleyebilsin. Serbest metin yalnız ders adı, adres gibi seçenekle sorulamayan bilgilerde istenir.",
+    "KURAL 3: Bologna seçilirse ve tarayıcı aracın varsa ilk iş OBS'yi açmaktır: hocadan yalnız OBS adresini iste (bilmiyorsa üniversite adını), adresi hemen tarayıcıda aç; ders adını ve paketi hocaya sorma, OBS'den oku.",
+    "KURAL 4: Önce sen tara, sonra öner. Ders listesi açılınca 'hangi ders?' diye sorma; obs_ders_listesi'ni çağır, bütün derslerin paketlerini oku, eksikleri say, kısa özetle ve 'önerilen' seçenekle gel (örneğin 1) en eksikten başlayıp hepsini kapatalım). Eksik yoksa 'eksik görünmüyor' de ve kaliteyi artıracak somut öneriler ver.",
+    "KURAL 5: Ara adımda hocaya soru sorma; varsayılan ya da en iyi seçeneği kendin seç ve sıradaki aracı çağır. Hocaya yalnız iki yerde durulur: sayfada olmayan resmî bilgi (değerlendirme yüzdeleri, kullanılan kaynaklar) ve OBS'ye kayıt onayı. Bu ikisi de TEK mesajdır; peşin onay varsa ikisi de yoktur (KURAL 7).",
+    "KURAL 6: Her araç yanıtında hocayaSimdiSor var. false ise hocaya soru yazmayın, onay beklemeyin, doğrudan sonrakiAdim'ı uygulayın; yalnız true olduğunda ya da zorunlu teyit/kayıt onayında durun.",
+    "KURAL 7: Peşin onay (tam otonom kip). Hoca 'hepsini yap ve kaydet', 'sen hallet', 'sormadan kaydet' gibi bir sözle baştan onay verdiyse o sözü Bologna araçlarına pesinOnay olarak olduğu gibi ver ve ara durak yapma: tara, doldur, OBS'ye yaz, Kaydet'e bas, geri oku, obs_karsilastir ile doğrula, sonda TEK rapor ver (yazılanlar, EKSİK kalanlar, geri okuma sonucu). Sayfada olmayan değerlendirme yüzdesi ve kaynağı sorma da uydurma da: EKSİK bırak. Yalnız OBS giriş ekranı, CAPTCHA, dur ve ikinci fark için dur. Onaya Gönder yine hocadadır; itirazı olan alanı hoca OBS'de düzeltir ya da sana numarasını yazar.",
+    "Amaç: hocanın en az müdahalesiyle işi hızlı ama denetimli ve teyitli bitirmek. " + AKILLI_DOLDURMA_KURALI,
+    "Yalnız hocanın bilebileceği ve resmî taahhüt olan bilgiler (değerlendirme yöntem ve yüzdeleri, kullanılan kaynaklar) sayfadan okunur; yoksa hocaya TEK mesajda, numaralı sorulur, uydurulmaz; yüzdeye varsayılan konmaz. Uygulama/lab sorulmaz, T+U+L'den okunur. Amaç ve içerik sayfada yoksa önden sorulmaz; 'öneri' olarak yazılıp son özette teyide sunulur. Ders adından üretilen her şey 'öneri' etiketiyle gösterilir. Araç sonucu 'biçim denetiminden geçti; içerik teyidi: hoca' diye sunulur.",
     "Giriş bilgisi: hocadan kullanıcı adı, parola, doğrulama kodu ya da çerez asla isteme. Sunucu bunları istemez; görülürse çağrıyı reddeder ve kaydetmez. Hoca yazarsa kullanma, araçlara gönderme, silmesini ve parolasını değiştirmesini öner. Hoca giriş bilgisini yalnız OBS'nin kendi ekranına kendisi yazar. CAPTCHA'yı hoca çözer.",
-    "OBS'ye yazma: önce alan alan önceki ve yeni değer özetini göster, hoca bir kez 'kaydet' der; ancak ondan sonra Kaydet'e basarsın. Kayıttan sonra sayfayı geri okuyup obs_karsilastir ile doğrula; ders kodu ya da dönem değişmişse yazmayı durdur. Doğrulanmamış kaynak ve teyitsiz değerlendirme yüzdesi yazılmaz. Onaya Gönder düğmesine hoca basar.",
-    "Tarayıcı aracın varsa OBS sayfasını okuyup formu doldurabilirsin; yoksa ya da engel çıkarsa engel_coz ve kurulum_yardimi araçlarının adımlarını hocaya sırayla, tek tek göster. Tarayıcı yoksa OBS'ye yazma alan alan kopyalamaya düşer.",
+    "OBS'ye yazma: önce alan alan önceki ve yeni değer özetini göster, hoca bir kez 'kaydet' ya da özetin altındaki 1'i (OBS'ye yaz ve kaydet) yazar; ancak ondan sonra Kaydet'e basarsın (peşin onay varsa KURAL 7 geçerlidir: bu durak yoktur, özet sondaki raporda verilir). Kayıttan sonra sayfayı geri okuyup obs_karsilastir ile doğrula; ders kodu ya da dönem değişmişse yazmayı durdur. Doğrulanmamış kaynak ve teyitsiz değerlendirme yüzdesi yazılmaz. Onaya Gönder düğmesine hoca basar.",
+    "Tarayıcı aracın varsa OBS sayfasını okuyup formu doldurabilirsin. Yoksa kopyalamaya geçmeden önce Chrome eklentisini (Claude in Chrome) kurdurmayı öner: engel_coz(tarayici_araci_yok) adımlarını tek tek göster; otonom akış ancak eklentiyle çalışır. Hoca kurmak istemezse ya da istemcide eklenti yoksa OBS'ye yazma alan alan kopyalamaya düşer. Engel çıkarsa engel_coz ve kurulum_yardimi adımlarını sırayla göster.",
     "Sunucu model çağırmaz ve metin üretmez: seçenekleri sen yazarsın, sunucu kural ve kalıp verir, denetler ve sayıları hesaplar. Sayıları yalnız araç sonucundan al.",
     "Bologna sayfasındaki Dersi Verenler, Yardımcılar ve Koordinatör satırları yayımlanmış görev bilgisidir: olduğu gibi okunur, korunur, değiştirilmez. Öğrenci adı ve numarası sohbete yapıştırılmaz: not tablosunda yalnız not sütunları olur; kimlik sütunu görülürse tablo işlenmez. Sunucu istek içeriğini günlüğe yazmaz.",
     "Kaynak: önce sayfadaki ve hocanın kullandığı kaynaklar. Öneri gerekirse kendi web arama aracınla aday bul, kaynak_dogrula ile sorgula, yalnız 'katalogda_bulundu' dönenleri künyesi ve bağlantısıyla 'öneri' olarak göster; uygunluğuna hoca karar verir. Katalogda bulunmayanı kendin önerme; hoca kullandığını söylerse 'hoca_beyani' olarak yaz. Ölçüt metnini yalnız olcut_getir sonucundan alıntılayın; DOĞRULANMADI ya da 'Belgeden okunamadı' işaretli metni tahminle doldurmayın. Programın disiplinini kurum seçer. Kanıtı olmayan cümle EKSİK kalır. Kitap, kişi, tarih uydurmayın.",
     "Sunucu kullanıcıdan adres çekmez: Bologna sayfasını hoca yapıştırır ya da siz kendi web aracınızla okursunuz. Tek dış istek kaynak_dogrula'nın sabit katalog adresleridir (Crossref, Open Library, Google Books). Onay ve dış kuruma gönderim hocadadır. Akredit'in YÖKAK ile bağı yoktur.",
 ].join(" ");
+/** Her araç yanıtında yinelenen kısa kural: uzun sohbette son okunan metin de aynı şeyi söyler. */
+export const SORMADAN_DEVAM = "Bu adımda hocaya soru sormayın ve onay beklemeyin; doğrudan sonrakiAdim'ı uygulayın.";
+export const ASISTAN_KURALI = "1) Ara adımda hocaya A/B/C sorma; en iyi seçeneği kendin seç, sıradaki aracı çağır. 2) Zorunlu soruyu (sayfada olmayan değerlendirme yüzdesi ve kaynak, OBS kayıt onayı) TEK mesajda ve numaralı sor; peşin onay varsa sorma, EKSİK bırak, sonda listele. 3) Sayı, kaynak ve değerlendirme yüzdesi uydurma. 4) Parola ve doğrulama kodu isteme; Onaya Gönder'e hoca basar.";
 const metinSonuc = (veri, isError = false) => ({
     content: [{ type: "text", text: JSON.stringify(veri, null, 2) }],
     structuredContent: veri,
@@ -68,6 +77,9 @@ function basari(a, s, atilan, ileti) {
         veri: {
             sonuc: s.sonuc,
             sonrakiAdim: s.sonrakiAdim ?? a.sonrakiAdim,
+            hocayaSimdiSor: s.hocayaSimdiSor ?? a.hocayaSimdiSor ?? false,
+            ...((s.hocayaSimdiSor ?? a.hocayaSimdiSor) ? {} : { simdiYap: SORMADAN_DEVAM }),
+            asistanKurali: ASISTAN_KURALI,
             ...(atilan.length
                 ? { atilan: ileti ?? `Şu kısımlar okunmadan atıldı, hiçbir yere yazılmadı: ${atilan.join(", ")}.` }
                 : {}),

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

@@ -15,6 +15,8 @@ export interface AracSonucu {
     kaynak: Kaynak[];
     /** Asistana bir sonraki adım önerisi; verilmezse aracın varsayılanı kullanılır. */
     sonrakiAdim?: string;
+    /** Bu adımda hocaya bir şey sorulmalı mı; verilmezse aracın varsayılanı (o da yoksa false). */
+    hocayaSimdiSor?: boolean;
 }
 export interface AracBaglami {
     simdi: () => Date;
@@ -28,6 +30,8 @@ export interface AcikArac<S extends z.ZodObject = z.ZodObject> {
     girdi: S;
     /** Yanıtta dönen varsayılan "sonraki adım" önerisi. */
     sonrakiAdim: string;
+    /** Yanıttaki hocayaSimdiSor bayrağının varsayılanı: true yalnız hocanın karar verdiği duraklarda. */
+    hocayaSimdiSor?: boolean;
     /** Kişisel veri reddinde iletiye eklenecek, bu araca özgü ipucu. */
     kisiselVeriIpucu?: string;
     /**
@@ -56,4 +60,8 @@ export declare const arac: <S extends z.ZodObject>(a: AcikArac<S>) => AcikArac<S
 /** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
 export declare class AracHatasi extends Error {
 }
+export declare function pesinOnayVar(metin: string | undefined): boolean;
+export declare const PESIN_ONAY_ACIKLAMASI = "Hocan\u0131n pe\u015Fin onay\u0131, kendi s\u00F6zleriyle oldu\u011Fu gibi (\u00F6r. 'hepsini yap ve kaydet'). Varsa ve kay\u0131t s\u00F6z\u00FC i\u00E7eriyorsa ara durak olmadan yaz\u0131l\u0131p kaydedilir; sonda tek rapor verilir. Olumsuz s\u00F6z ('kaydetme', 'kaydetmeden \u00F6nce sor') onay say\u0131lmaz. Onaya G\u00F6nder hocada kal\u0131r.";
 export declare const KOD_KAYNAGI: (yol: string, ad: string) => Kaynak;
+/** Tarama raporunun numaralı seçenekleri: tek kaynak. obs_ders_listesi'nin raporBicimi ve istem metni bunu kullanır. */
+export declare const TARAMA_SECENEKLERI: readonly ["1) Eksikleri en çok olandan başlayarak hepsini kapatalım (önerilen)", "2) Yalnız en eksik dersi tamamlayalım", "3) Kalite önerilerini de uygulayalım", "4) Dersi ben seçeyim"];

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

@@ -7,4 +7,36 @@ export const arac = (a) => a;
 /** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
 export class AracHatasi extends Error {
 }
+/**
+ * Peşin onay (tam otonom kip): hoca başta bir kez "hepsini yap ve kaydet" der; asistan ara durak olmadan tarar, doldurur,
+ * OBS'ye kaydeder, geri okuyup doğrular ve sonda tek rapor verir. Onay hocanın kendi sözleriyle verilir ve kayda
+ * geçer (ilke 3); metinde kayıt/yetki sözü yoksa onay sayılmaz. Onaya Gönder yine hocadadır; bilinmeyen resmî bilgi
+ * uydurulmaz, EKSİK bırakılıp raporda listelenir (ilke 2).
+ */
+// Kurucu kararı (12.11.2026): onay için kayıt ya da yetki sözü zorunludur. "hepsini tara", "otonom", "sormadan"
+// tek başına iş tarifidir, OBS'ye kayıt izni değildir.
+const PESIN_ONAY = /kaydet|sen hallet|tam yetki|onayl[ıi]yorum/iu;
+/**
+ * Olumsuz söz onay değildir: "kaydetme", "kaydetmeden önce sor", "sen halletme", "OBS'ye yazma", "onaylamıyorum",
+ * "istemiyorum", "hayır", "değil". Ad-fiil ("kaydetmek") olumsuz sayılmaz; "kaydetmeni" gibi belirsiz biçimler
+ * bilerek olumsuz sayılır: kuşkuda onay yoktur, hocaya bir kez sorulur (ilke 3).
+ */
+const PESIN_ONAY_OLUMSUZ = /kaydetme(?!k)|halletme(?!k)|(?<!\p{L})(yazma|yapma)(?!k)|onaylam[ıi]yorum|istem[ie]yorum|(?<!\p{L})istemem|verm[ie]yorum|(?<!\p{L})(hay[ıi]r|de[ğg]il)(?!\p{L})/iu;
+export function pesinOnayVar(metin) {
+    if (!metin || metin.trim().length < 3)
+        return false;
+    // Büyük harfle yazılan Türkçe metin (DEĞİL, HAYIR) için ayrıca Türkçe küçük harfle de bakılır.
+    const kucuk = metin.toLocaleLowerCase("tr");
+    if (PESIN_ONAY_OLUMSUZ.test(metin) || PESIN_ONAY_OLUMSUZ.test(kucuk))
+        return false;
+    return PESIN_ONAY.test(metin) || PESIN_ONAY.test(kucuk);
+}
+export const PESIN_ONAY_ACIKLAMASI = "Hocanın peşin onayı, kendi sözleriyle olduğu gibi (ör. 'hepsini yap ve kaydet'). Varsa ve kayıt sözü içeriyorsa ara durak olmadan yazılıp kaydedilir; sonda tek rapor verilir. Olumsuz söz ('kaydetme', 'kaydetmeden önce sor') onay sayılmaz. Onaya Gönder hocada kalır.";
 export const KOD_KAYNAGI = (yol, ad) => ({ ad, adres: `${DEPO}/tree/main/${yol}` });
+/** Tarama raporunun numaralı seçenekleri: tek kaynak. obs_ders_listesi'nin raporBicimi ve istem metni bunu kullanır. */
+export const TARAMA_SECENEKLERI = [
+    "1) Eksikleri en çok olandan başlayarak hepsini kapatalım (önerilen)",
+    "2) Yalnız en eksik dersi tamamlayalım",
+    "3) Kalite önerilerini de uygulayalım",
+    "4) Dersi ben seçeyim",
+];

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

@@ -34,15 +34,26 @@ const ISTEMCI_ADI = {
     claude_code: "Claude Code",
 };
 const BAGLAYICI = {
-    // Anthropic yardım belgesi "Get started with custom connectors using remote MCP" (erişim 2026-11-05).
+    // Anthropic yardım belgesi "Get started with custom connectors using remote MCP" (erişim 2026-11-05). Türkçe
+    // arayüz adları Claude masaüstünün Türkçe ekranından (apps/web/public/gorsel/kurulum, 12.11.2026); İngilizce
+    // arayüz için karşılığı parantezde.
     claude_web: [
         ["claude.ai adresine girin ve oturum açın.", "Sol tarafta sohbet listesi, ortada yazı kutusu."],
-        ["Customize (Özelleştir), ardından Connectors (Bağlayıcılar) bölümünü açın.", "Bağlı araçların listesi."],
-        ["+ Add düğmesine, ardından Add custom connector seçeneğine basın.", "Ad ve adres soran pencere."],
-        [`Ad olarak Akredit, adres olarak ${MCP_ADRESI} yazın ve Continue deyin.`, "Kimlik doğrulama seçenekleri."],
-        ["Authentication altında No sign in seçin ve Add deyin.", "Listede Akredit görünür."],
+        ["Ayarlar'da Bağdaştırıcılar (Connectors) bölümünü açın.", "Bağdaştırıcılar listesi."],
         [
-            "Ücretsiz planda tek özel bağlayıcı eklenebilir. Team ve Enterprise planlarında bağlayıcıyı kuruluş sahibi ekler; siz Connectors listesinde Akredit'i bulup Connect dersiniz.",
+            "Sağ üstte + Ekle (Add), ardından Özel bağdaştırıcı ekle (Add custom connector) seçin.",
+            "Ad ve adres soran pencere.",
+        ],
+        [
+            `Ad olarak Akredit, adres olarak ${MCP_ADRESI} yazın ve Devam et (Continue) deyin.`,
+            "Kimlik doğrulama seçenekleri.",
+        ],
+        [
+            "Oturum açma olmadan (No sign in) seçeneğini bırakın ve Ekle (Add) deyin. 'Sunucu URL'sine sahip herkes kullanabilir' uyarısı normaldir.",
+            "Listede Akredit görünür.",
+        ],
+        [
+            "Ücretsiz planda tek özel bağdaştırıcı eklenebilir. Team ve Enterprise planlarında bağdaştırıcıyı kuruluş sahibi ekler; siz Bağdaştırıcılar listesinde Akredit'i bulup Bağlan (Connect) dersiniz.",
             undefined,
         ],
         [
@@ -57,15 +68,18 @@ const BAGLAYICI = {
     ],
     claude_masaustu: [
         ["Claude masaüstü uygulamasını açın ve oturum açın.", "claude.ai ile aynı görünüm."],
-        ["Customize (Özelleştir), ardından Connectors (Bağlayıcılar) bölümünü açın.", "Bağlayıcı listesi."],
         [
-            `+ Add, Add custom connector ile ad Akredit, adres ${MCP_ADRESI} yazın; Authentication altında No sign in seçip Add deyin.`,
+            "Sol alttaki çark simgesinden Ayarlar'ı açın, soldan Bağdaştırıcılar'ı (Connectors) seçin.",
+            "Bağdaştırıcılar listesi.",
+        ],
+        [
+            `+ Ekle, Özel bağdaştırıcı ekle (Add custom connector) ile ad Akredit, adres ${MCP_ADRESI} yazın; Devam et, sonra Oturum açma olmadan (No sign in) ile Ekle deyin.`,
             "Listede Akredit görünür.",
         ],
         ["Yeni sohbette akredit yazın. Menü gelmezse Akredit araçlarıyla Bologna paketimi denetle yazın.", "Odak menüsü."],
     ],
     claude_chrome: [
-        ["Önce Claude'a Akredit bağlayıcısını ekleyin (Claude web adımları).", "Sohbette Akredit açık."],
+        ["Önce Claude'a Akredit bağdaştırıcısını ekleyin (Claude web adımları).", "Sohbette Akredit açık."],
         [
             "Chrome tarayıcısını açın. Chrome Web Mağazası'nda Claude eklentisini arayın (Claude in Chrome).",
             "Eklentinin sayfası.",
@@ -156,8 +170,8 @@ const TARAYICI = {
             "OBS ana sayfası.",
         ],
         [
-            "Asistana 'girdim' yazın. Asistan ders listesini ve Bologna sayfasını okur.",
-            "Ders listesi sohbette numaralı görünür.",
+            "Asistana 'girdim' yazın. Asistan ders listesini okur ve bütün derslerinizin Bologna sayfasını tarar.",
+            "Eksikler ve öneriler sohbette tek listede görünür.",
         ],
     ],
     claude_chrome: [
@@ -171,7 +185,10 @@ const TARAYICI = {
             "Asistan sayfayı okumak için izin isteyebilir; onaylayın.",
             true,
         ],
-        ["Asistan ders listesini okur, dersinizi numarasıyla seçersiniz.", "Ders bilgi paketi alanları."],
+        [
+            "Asistan ders listesini okur ve bütün derslerinizi tarar; hangi dersle başlanacağını numarayla seçersiniz.",
+            "Eksiklerin ve önerilerin tek listesi.",
+        ],
         [
             "Asistan formu doldurursa her alanı gözle denetleyin. Kaydet'e siz basarsınız; isterseniz açık izninizle asistan basar. Onaya Gönder düğmesine siz basarsınız.",
             "OBS'nin kayıt iletisi.",
@@ -336,6 +353,8 @@ export const kurulumYardimiAraci = arac({
     ad: "kurulum_yardimi",
     baslik: "Kurulum yardımı",
     aciklama: "Akredit bağlayıcısını eklemek ve OBS'ye tarayıcıyla girmek için istemciye göre adım adım rehber verir: Claude web ve masaüstü, Claude in Chrome, ChatGPT, Cursor, VS Code, Claude Code. Her adımda ekranda ne görüleceğini söyler.",
+    // Adımlar hocayla tek tek yürür; her adımda hocanın "oldu" demesi beklenir.
+    hocayaSimdiSor: true,
     sonrakiAdim: "Adımları hocaya tek tek gösterin: bir adım verin, 'oldu' demesini bekleyin, sonra sıradakine geçin. 'değişebilir' işaretli menü adını 'sizde biraz farklı olabilir' diye söyleyin. Giriş kuralını hocaya bir kez açıkça söyleyin.",
     girdi: z.object({
         istemci: z.enum(ISTEMCILER).describe("Hocanın kullandığı asistan"),
@@ -355,6 +374,14 @@ export const kurulumYardimiAraci = arac({
         kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit kurulum rehberi")],
     }),
 });
+/** Asistanın hocaya sormadan önce kendisinin deneyeceği toparlama; yalnız giriş, CAPTCHA ve kurulum hocadadır. */
+const KENDI_TOPARLAMA = {
+    cerceve: "Hocaya 'yeni sekmede açın' demeden önce: sayfadaki iframe'in src adresini okuyup o adrese kendiniz gidin ve sayfayı yeniden okuyun. Giriş ekranına düşerseniz adımlara geçin.",
+    sayfa_okunamiyor: "Hocaya söylemeden önce: sayfadaki sekmeleri (Ders Bilgileri, Öğrenme Çıktıları, Ders Akışı, Katkı) sırayla açıp metinlerini birleştirin ve bologna_ayristir'ı yeniden çağırın. Hâlâ temel alanlar okunamıyorsa adımlara geçin.",
+    kaydet_basilamiyor: "Önce kendiniz: sayfayı aşağı kaydırıp sekmenin kendi Kaydet düğmesini arayın, açık uyarı penceresi varsa okuyun. Hata iletisi bir alanı gösteriyorsa onu düzeltin (onaylanan içerik değişmeden). Olmazsa adımlara geçin.",
+    oturum_dustu: "Taslağı kaybetmeyin: hemen bologna_kopya_metni ile yedek metni alın. Hocaya tek mesajda 'Oturum düştü; OBS sekmesinde yeniden girip girdim yazın, kaldığım yerden sürdürürüm' deyin ve aynı mesajda kopya metnini verin.",
+    site_acilmiyor: "Önce kendiniz: adresi http/https ve www'lü/www'süz deneyin, kurumun OBS sayfasını web aramasıyla bulun. Olmazsa adımlara geçin.",
+};
 export const engelCozAraci = arac({
     ad: "engel_coz",
     baslik: "Engel çöz",
@@ -370,12 +397,19 @@ export const engelCozAraci = arac({
         return {
             sonuc: {
                 engel: e.ad,
+                ...(KENDI_TOPARLAMA[engel] ? { asistanOnceKendisiDener: KENDI_TOPARLAMA[engel] } : {}),
                 girisKurali: GIRIS_KURALI_HOCAYA,
                 adimlar: numarala([...ozel, ...e.adimlar]),
                 ...(e.yedek ? { yedekYol: numarala(KOPYALA_YAPISTIR) } : {}),
                 obsyeYazmaYedegi: "Tarayıcı aracı yoksa asistan bologna_kopya_metni ile alan alan kopyalanacak metni verir; siz OBS'de ilgili kutuya yapıştırıp Kaydet'e basarsınız.",
             },
             kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit engel çözme rehberi")],
+            ...(KENDI_TOPARLAMA[engel] && engel !== "oturum_dustu"
+                ? {
+                    hocayaSimdiSor: false,
+                    sonrakiAdim: "Önce asistanOnceKendisiDener'i hocaya sormadan uygulayın. Çözülmezse adımları hocaya tek tek gösterin. Parola, doğrulama kodu ya da çerez istemeyin.",
+                }
+                : { hocayaSimdiSor: true }),
         };
     },
 });

package/dist/packages/baglayicilar/src/bologna-proliz/ayristir.js

@@ -3,14 +3,16 @@
 const VARLIKLAR = { nbsp: " ", amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
 const ETIKET = /<(?:[^>"']|"[^"]*"|'[^']*')*>/g;
 const BETIK = /<(script|style)\b(?:[^>"']|"[^"]*"|'[^']*')*>[\s\S]*?<\/\1>/gi;
+/** Sayısal karakter başvurusu; geçersiz kod noktası (ör. `&#99999999;`) hata atmaz, olduğu gibi kalır. */
+const kodNoktasi = (n, ham) => Number.isInteger(n) && n >= 0 && n <= 0x10ffff ? String.fromCodePoint(n) : ham;
 /** HTML parçasını düz metne çevirir. */
 export function metin(html) {
     return html
         .replace(BETIK, "")
         .replace(/<br\s*\/?>/gi, " ")
         .replace(ETIKET, " ")
-        .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
-        .replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(Number.parseInt(n, 16)))
+        .replace(/&#(\d+);/g, (m, n) => kodNoktasi(Number(n), m))
+        .replace(/&#x([0-9a-f]+);/gi, (m, n) => kodNoktasi(Number.parseInt(n, 16), m))
         .replace(/&([a-z]+);/gi, (m, a) => VARLIKLAR[a.toLowerCase()] ?? m)
         .replace(/\s+/g, " ")
         .trim();

package/dist/packages/cekirdek/src/bologna/taslak.js

@@ -1,4 +1,5 @@
-// Bologna ders sayfası taslağı denetimi (K1-K12 ve diğer kurallar).
+// Bologna ders sayfası taslağı denetimi (K2-K10, K12 ve diğer kurallar). K1 (ders adıyla tutarlılık, başka
+// dersten kopya) ve K11 (başka dersin yöntem metniyle aynılık) tek taslaktan denetlenemez; burada yoktur.
 // apps/cli/lib/bologna-taslak.mjs `taslakDenetle` işlevinin saf, tipli taşıması. Mesajlar aynen korunur:
 // CLI'deki "K8: metin" dizesi burada { kural: "K8", aciklama: "metin" } olur.
 //
@@ -22,6 +23,11 @@ const kelime = (s) => String(s ?? "")
 const bos = (s) => /^\s*(-|\.|yok|)\s*$/i.test(String(s ?? ""));
 // ASCII'ye düşürülmüş Türkçe kelimeler (talimat bölüm 6). CLI ile aynı ifade.
 const ASCII_TURKCE = /\b(icin|haftalik|ogrenme|ogrenci|ciktilar[ıi]?|ciktisi|bilisim|kaynag[ıi]|devam[ıi]|uygulamali|notlar[ıi]n[ıi]|incelenmesi|gelistirme|yazilim|programlamanin|tasarim[ıi]?|olusturma|degerlendirme|sinav[ıi]?|calisma|donem|guvenlik|baglant[ıi])\b/i;
+// "guncel" set: aynı kelime listesi, Türkçe harfleri de kelime harfi sayan sınırlarla. CLI ifadesindeki `\b`
+// ASCII dışı harfi kelime sınırı sayar; bu yüzden doğru yazılmış "devamını", "notlarının" kelimelerinin içinde
+// "devamı", "notlarını" eşleşir ve hoca yanlış yere hata alır. Burada "ı" ile yazılan doğru biçimler ve zaten
+// doğru yazılmış olan "incelenmesi" aranmaz.
+const ASCII_TURKCE_GUNCEL = /(?<![\p{L}\p{N}_])(icin|haftalik|ogrenme|ogrenci|ciktilar[ıi]?|ciktisi|bilisim|kaynag[ıi]|devami|uygulamali|notlarini|gelistirme|yazilim|programlamanin|tasarim[ıi]?|olusturma|degerlendirme|sinav[ıi]?|calisma|donem|guvenlik|baglant[ıi])(?![\p{L}\p{N}_])/giu;
 // Ölçülemeyen çıktı kalıpları (K4). "gösterebilir", "açıklayabilir" geçerlidir.
 const OLCULEMEZ = /(bilgi sahibi olur|hakkında bilgi|fikir sahibi olur|(^|\s)(öğrenir|kavrar|anlar|bilir))\.?\s*$/i;
 const ZAYIF = /farkındalık/i;
@@ -213,7 +219,7 @@ export function taslakDenetle(t, secenek = {}) {
         ...cik.map((c) => c.tr),
         ...haftalar.flatMap((h) => [h.konu?.tr, h.onHazirlik, h.dokuman]),
     ].filter(Boolean);
-    const tumu = new RegExp(ASCII_TURKCE, "gi");
+    const tumu = guncel ? ASCII_TURKCE_GUNCEL : new RegExp(ASCII_TURKCE, "gi");
     const ascii = [...new Set(trMetinler.flatMap((m) => [...String(m).matchAll(tumu)].map((x) => x[0])))];
     if (ascii.length)
         hata("Türkçe", `Türkçe karakteri düşürülmüş kelimeler: ${ascii.slice(0, 10).join(", ")}.`);

package/dist/packages/cekirdek/src/karar/katman.d.ts

@@ -50,8 +50,8 @@ export declare function sureliOnayUygunMu(s: KatmanSonucu): boolean;
 /** Toplu onay yalnız katman 2 dışındaki önerilerde olur. */
 export declare function topluOnayaUygunMu(s: KatmanSonucu): boolean;
 /**
- * Katman 2 bir kararın kabul edilebilirliği: politika ya da süre dayanağı reddedilir, kararı veren
- * kişi ve kartta geçen süre bulunmalıdır.
+ * Katman 2 bir kararın kabul edilebilirliği: politika ya da süre dayanağı ve toplu onay reddedilir.
+ * Her katmanda kararı veren kişi yazılmalıdır. Kartta geçen süre burada denetlenmez.
  */
 export declare function zorunluKararDenetle(s: KatmanSonucu, karar: {
     dayanak: "dogrudan" | "politika" | "sure";

package/dist/packages/cekirdek/src/karar/katman.js

@@ -59,8 +59,8 @@ export function topluOnayaUygunMu(s) {
     return !s.devredilemez;
 }
 /**
- * Katman 2 bir kararın kabul edilebilirliği: politika ya da süre dayanağı reddedilir, kararı veren
- * kişi ve kartta geçen süre bulunmalıdır.
+ * Katman 2 bir kararın kabul edilebilirliği: politika ya da süre dayanağı ve toplu onay reddedilir.
+ * Her katmanda kararı veren kişi yazılmalıdır. Kartta geçen süre burada denetlenmez.
  */
 export function zorunluKararDenetle(s, karar) {
     const hatalar = [];

package/dist/packages/cekirdek/src/turkce.d.ts

@@ -1,7 +1,5 @@
 /** Türkçe kurallarıyla küçük harfe çevirir: "İ" → "i", "I" → "ı". */
 export declare function kucukHarf(metin: string): string;
-/** Türkçe kurallarıyla büyük harfe çevirir: "i" → "İ", "ı" → "I". */
-export declare function buyukHarf(metin: string): string;
 /**
  * Karşılaştırma için normalleştirir: Unicode NFC, Türkçe küçük harf, tipografik tırnak ve tireler,
  * yumuşak tire, satır sonunda bölünmüş kelimeler ve boşluklar. Anlamı değiştirmez, harf düşürmez.

package/dist/packages/cekirdek/src/turkce.js

@@ -9,10 +9,6 @@ const SATIR_SONU_BOLME = /(\p{Ll})-\s*\n\s*(\p{Ll})/gu;
 export function kucukHarf(metin) {
     return metin.toLocaleLowerCase("tr-TR");
 }
-/** Türkçe kurallarıyla büyük harfe çevirir: "i" → "İ", "ı" → "I". */
-export function buyukHarf(metin) {
-    return metin.toLocaleUpperCase("tr-TR");
-}
 /**
  * Karşılaştırma için normalleştirir: Unicode NFC, Türkçe küçük harf, tipografik tırnak ve tireler,
  * yumuşak tire, satır sonunda bölünmüş kelimeler ve boşluklar. Anlamı değiştirmez, harf düşürmez.

package/dist/packages/olcme/src/girdi.d.ts

@@ -0,0 +1,3 @@
+import type { DersOlcmeVerisi } from "../../cekirdek/src/index.js";
+/** Hesabı bozacak girdi sorunları; boş dizi ise girdi tutarlıdır. İletiler Türkçe ve kullanıcıya gösterilebilir. */
+export declare function olcmeGirdiSorunlari(v: DersOlcmeVerisi): string[];

package/dist/packages/olcme/src/girdi.js

@@ -0,0 +1,55 @@
+// Ölçme girdisinin tutarlılık denetimi (kurucu kararı 12.11.2026, review.md madde 2). dersiOlc bozuk girdiyi
+// sessizce hesaplıyordu: tam puanı aşan puan %100'ün üstünde başarı, yinelenen satırda sonuncunun kazanması,
+// bilinmeyen araç/soruya yazılan puanın atılıp öğrencinin 0 sayılması, aynı ÇK'nın PÇ'ye iki kez girmesi.
+// Bu işlev hesaptan önce çağrılır; sorun varsa hesap yapılmaz, hocaya ne olduğunu ve ne yapılacağını söyler.
+// Saf: IO yok. dersiOlc'nin kendisi değişmez (HESAP_SURUMU aynı kalır).
+const EN_COK = 10;
+/** Hesabı bozacak girdi sorunları; boş dizi ise girdi tutarlıdır. İletiler Türkçe ve kullanıcıya gösterilebilir. */
+export function olcmeGirdiSorunlari(v) {
+    const sorunlar = [];
+    const ekle = (s) => sorunlar.push(s);
+    const ckSay = new Map();
+    for (const c of v.ciktilar)
+        ckSay.set(c.kod, (ckSay.get(c.kod) ?? 0) + 1);
+    for (const [kod, n] of ckSay)
+        if (n > 1)
+            ekle(`Ders çıktısı ${kod} ${n} kez yazılmış. Her çıktıyı bir kez yazın.`);
+    const araclar = new Map();
+    for (const a of v.araclar) {
+        if (araclar.has(a.id))
+            ekle(`Ölçme aracı ${a.id} birden çok kez yazılmış. Her aracı bir kez yazın.`);
+        const sorular = new Map();
+        for (const q of a.sorular) {
+            if (sorular.has(q.no))
+                ekle(`${a.id} içinde ${q.no}. soru birden çok kez yazılmış.`);
+            sorular.set(q.no, q.tamPuan);
+            for (const e of q.eslemeler)
+                if (!ckSay.has(e.ciktiKod))
+                    ekle(`${a.id} ${q.no}. soru, listede olmayan ${e.ciktiKod} çıktısına eşlenmiş. Çıktıyı ekleyin ya da eşlemeyi düzeltin.`);
+        }
+        araclar.set(a.id, sorular);
+    }
+    const gorulen = new Set();
+    for (const p of v.puanlar) {
+        const sorular = araclar.get(p.aracId);
+        if (!sorular) {
+            ekle(`${p.ogrenci} için tanımsız ${p.aracId} aracına puan yazılmış. Aracı ekleyin ya da satırı silin.`);
+            continue;
+        }
+        const tam = sorular.get(p.soruNo);
+        // Sorusuz araçta (toplam puan) soru numarası denetlenmez.
+        if (sorular.size > 0 && tam === undefined) {
+            ekle(`${p.ogrenci} için ${p.aracId} aracında olmayan ${p.soruNo}. soruya puan yazılmış.`);
+            continue;
+        }
+        const anahtar = `${p.ogrenci}\u0000${p.aracId}\u0000${p.soruNo}`;
+        if (gorulen.has(anahtar))
+            ekle(`${p.ogrenci} için ${p.aracId} ${p.soruNo}. soru puanı birden çok kez yazılmış.`);
+        gorulen.add(anahtar);
+        if (p.puan !== null && tam !== undefined && p.puan > tam)
+            ekle(`${p.ogrenci} için ${p.aracId} ${p.soruNo}. soru puanı (${p.puan}) tam puanı (${tam}) aşıyor.`);
+    }
+    return sorunlar.length > EN_COK
+        ? [...sorunlar.slice(0, EN_COK), `ve ${sorunlar.length - EN_COK} sorun daha.`]
+        : sorunlar;
+}

package/dist/packages/olcme/src/index.d.ts

@@ -1,5 +1,6 @@
 export declare const PAKET = "./index.js";
 export { dersiOlc, ORNEK_HARF_TABLOSU } from "./ders.ts";
+export { olcmeGirdiSorunlari } from "./girdi.ts";
 export * from "./istatistik.ts";
 export * from "./kok-neden.ts";
 export * from "./program.ts";

package/dist/packages/olcme/src/index.js

@@ -2,6 +2,7 @@
 // Kapsam ve kabul ölçütleri: plan/ip/IP-06-olcme-motoru.md · Yöntem: docs/olcme-yontemi.md
 export const PAKET = "./index.js";
 export { dersiOlc, ORNEK_HARF_TABLOSU } from "./ders.js";
+export { olcmeGirdiSorunlari } from "./girdi.js";
 export * from "./istatistik.js";
 export * from "./kok-neden.js";
 export * from "./program.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akredit/acik-mcp",
-  "version": "0.5.0",
+  "version": "0.8.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Herkese açık Akredit MCP sunucusu: hesapsız, salt okuma, deterministik araçlar (ölçüt, Bologna denetimi, ÇK/PÇ hesabı, rapor dil denetimi). Kurum verisine erişmez, model çağırmaz.",
@@ -13,6 +13,12 @@
     "akts"
   ],
   "homepage": "https://akredit.org/mcp-kullan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tialkan/akredit.git",
+    "directory": "apps/acik-mcp"
+  },
+  "bugs": "https://github.com/tialkan/akredit/issues",
   "engines": {
     "node": ">=22.18"
   },