@akredit/acik-mcp 0.8.1 → 0.8.2

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

@@ -956,7 +956,7 @@ const taslakDenetleAraci = arac({
             sonuc: {
                 bicimdenGecenler: sonuclar.filter((x) => x.bicimDenetimi === "geçti").map((x) => x.etiket),
                 secenekler: sonuclar,
-                not: "Biçim denetiminden geçti; içerik teyidi: hoca. Sonuç yalnız Akredit'in biçim kurallarına uyulduğunu söyler; içeriğin doğruluğuna ve derse uygunluğuna hoca karar verir.",
+                not: taslakNotu(sonuclar),
                 resmiDayanak: RESMI_DAYANAK,
             },
             kaynak: [KAYNAK_KURALLAR],
@@ -1075,6 +1075,17 @@ export function ayristirOnAyikla(g) {
         ...ek,
     };
 }
+/** Taslak denetiminin notu sonuca göre: hiçbiri geçmediyse "geçti" denmez. */
+function taslakNotu(xs) {
+    const gecen = xs.filter((x) => x.bicimDenetimi === "geçti").map((x) => x.etiket);
+    if (!gecen.length)
+        return "Biçim denetiminden geçmeyen alanlar var; düzeltip yeniden denetleyin. İçerik teyidi: hoca.";
+    const kismi = gecen.length < xs.length
+        ? ` Yalnız şu seçenekler geçti: ${gecen.join(", ")}; öbürlerinde geçmeyen alanlar var.`
+        : "";
+    return `Biçim denetiminden geçti; içerik teyidi: hoca.${kismi} Sonuç yalnız Akredit'in biçim kurallarına uyulduğunu söyler; içeriğin doğruluğuna ve derse uygunluğuna hoca karar verir.`;
+}
+const TUL_TEYIDI = "Haftalık ders saatleri (teori + uygulama + laboratuvar)";
 /**
  * Ayrıştırmanın hemen ardından denetim: tarama sırasında ders başına iki çağrı yerine bir çağrı yeter.
  * Girdi denetimin şemasından geçmezse (sayfa eksik okunduysa) denetim atlanır, asistan bologna_denetle'yi çağırır.
@@ -1095,6 +1106,8 @@ function gomuluDenetim(ders, b) {
         teyitSorulacak: [
             ...(d.degerlendirme.length ? [] : ["Değerlendirme yöntem ve yüzdeleri"]),
             ...(d.kaynaklar?.length || d.kaynakSayisi ? [] : ["Kullanılan kaynaklar"]),
+            // T+U+L yoksa ya da 0+0+0 ise (kayıt yok) iş yükü hesaplanamaz; haftalık saatler hocaya sorulur.
+            ...((tulSaati(d.tul) ?? 0) > 0 ? [] : [TUL_TEYIDI]),
         ],
     };
 }
@@ -1116,11 +1129,14 @@ function prolizMetniSonucu(ham, ek, b) {
     const kaynaklar = [...ek.kaynaklar, ...p.kaynaklar];
     const yetkililer = [...ek.yetkililer, ...p.yetkililer];
     const ad = d.ad ?? ek.dersIpucu?.ad;
+    // 0+0+0 kayıt yok demektir: sayfadaki ya da ipucundaki sıfırdan büyük T+U+L kullanılır, yoksa alan boş kalır.
+    const tul = [d.tul, ek.dersIpucu?.tul].find((t) => (tulSaati(t) ?? 0) > 0);
+    const tulYok = tul === undefined;
     const ders = {
         kod: d.kod ?? ek.dersIpucu?.kod ?? "DERS",
         ...(ad ? { ad } : {}),
         yariyil: d.yariyil,
-        ...(d.tul ? { tul: d.tul } : {}),
+        ...(tul ? { tul } : {}),
         kredi: d.kredi,
         akts: d.akts ?? ek.dersIpucu?.akts ?? null,
         ...(d.guncelleme ? { guncelleme: d.guncelleme } : {}),
@@ -1143,11 +1159,14 @@ function prolizMetniSonucu(ham, ek, b) {
         ])),
     };
     const bosPaket = p.bulunan.length === 0 || (!d.amac && !d.icerik && !d.ciktilar.length && !d.degerlendirme.length);
-    const sonrakiAdim = bosPaket
+    const tulNotu = tulYok
+        ? " T+U+L yok ya da 0+0+0: haftalık ders saatleri (teori + uygulama + laboratuvar) aynı TEK mesajda sorulur; peşin onayda sorulmaz, iş yükü EKSİK kalır."
+        : "";
+    const sonrakiAdim = `${bosPaket
         ? "Boş paket: sayfadaki bütün alanlar boş (denetim.doldurulacak). Hepsini öneriyle doldurun (bologna_alan_rehberi, bologna_taslak_denetle) ve 'öneri' etiketiyle son özette gösterin. Değerlendirme yöntem ve yüzdeleri ile kullanılan kaynaklar hocaya TEK mesajda sorulur; peşin onayda sorulmaz, EKSİK bırakılır. Uydurmayın."
         : d.degerlendirme.length
             ? "Yanıttaki denetim alanı hazırdır; bologna_denetle'yi ayrıca çağırmayın. Değerlendirme sayfadan okundu: hocaya sormayın; taslakta degerlendirmeDayanagi: 'sayfa' ve degerlendirmeKaniti olarak bu yanıttaki degerlendirmeKaniti metnini aynen verin. Yalnız denetim.teyitSorulacak'taki bilgiler hocaya TEK mesajda sorulur. Sonraki çağrılarda ingilizce değerini aynen verin."
-            : "Yanıttaki denetim alanı hazırdır; bologna_denetle'yi ayrıca çağırmayın. Değerlendirme yöntem ve yüzdeleri sayfada yok: hocaya TEK mesajda sorun (peşin onayda EKSİK bırakın), tahmin etmeyin. Sonraki çağrılarda ingilizce değerini aynen verin.";
+            : "Yanıttaki denetim alanı hazırdır; bologna_denetle'yi ayrıca çağırmayın. Değerlendirme yöntem ve yüzdeleri sayfada yok: hocaya TEK mesajda sorun (peşin onayda EKSİK bırakın), tahmin etmeyin. Sonraki çağrılarda ingilizce değerini aynen verin."}${tulNotu}`;
     return {
         sonuc: {
             tur: "ders",
@@ -1176,7 +1195,7 @@ const ayristirAraci = arac({
     ad: "bologna_ayristir",
     baslik: "Bologna sayfasını ayrıştır",
     aciklama: "Yapıştırılan Bologna ders sayfasını ya da program çıktıları sayfasını çözer. Önce Proliz biçimini dener, olmazsa her OBS için genel ayrıştırıcı çalışır (HTML ya da düz metin, Türkçe ya da İngilizce etiketler). Bulunan ve bulunamayan alanları, güven düzeyini söyler. Adres çekmez.",
-    sonrakiAdim: "Yanıttaki denetim alanı varsa bologna_denetle'yi ayrıca çağırmayın: eksikler (denetim.doldurulacak) ve teyit sorulacaklar (denetim.teyitSorulacak) hazırdır. Denetim alanı yoksa ders verisini bologna_denetle'ye verin (girdi hazır: bolognaDenetleGirdisi). Sonraki çağrılarda ingilizce değerini aynen verin. Sayfada değerlendirme yüzdeleri ya da kaynaklar yoksa yalnız bunları hocaya TEK mesajda sorun; yüzdeyi tahmin etmeyin. Uygulama/lab T+U+L'den okunur (U+L > 0 ise var), sorulmaz. Amaç ve içerik sayfada yoksa önden sorulmaz; 'öneri' olarak yazılıp son özette teyide sunulur.",
+    sonrakiAdim: "Yanıttaki denetim alanı varsa bologna_denetle'yi ayrıca çağırmayın: eksikler (denetim.doldurulacak) ve teyit sorulacaklar (denetim.teyitSorulacak) hazırdır. Denetim alanı yoksa ders verisini bologna_denetle'ye verin (girdi hazır: bolognaDenetleGirdisi). Sonraki çağrılarda ingilizce değerini aynen verin. Sayfada değerlendirme yüzdeleri ya da kaynaklar yoksa yalnız bunları hocaya TEK mesajda sorun; yüzdeyi tahmin etmeyin. Uygulama/lab T+U+L'den okunur (U+L > 0 ise var), sorulmaz; T+U+L yok ya da 0+0+0 ise haftalık ders saatleri (teori + uygulama + laboratuvar) aynı TEK mesajda sorulur (peşin onayda sorulmaz, iş yükü EKSİK kalır). Amaç ve içerik sayfada yoksa önden sorulmaz; 'öneri' olarak yazılıp son özette teyide sunulur.",
     kisiselVeriKapsami: BOLOGNA_KAPSAMI,
     kunyeAlanlari: BOLOGNA_KUNYE_ALANLARI,
     onAyikla: ayristirOnAyikla,
@@ -1196,9 +1215,15 @@ const ayristirAraci = arac({
             kod: z.string().trim().min(1).max(30),
             ad: z.string().trim().max(200).optional(),
             akts: z.number().min(0).max(60).optional(),
+            tul: z
+                .string()
+                .trim()
+                .max(20)
+                .optional()
+                .describe("Ders listesindeki T+U+L, ör. '2+1+0'. 0+0+0 kayıt yok demektir."),
         })
             .optional()
-            .describe("Ders listesinden bilinen kod, ad ve AKTS (obs_ders_listesi taramaPlani). Sayfada yoksa bunlar kullanılır; boş pakette ders kodu ve adı sayfada görünmez."),
+            .describe("Ders listesinden bilinen kod, ad, AKTS ve T+U+L (obs_ders_listesi taramaPlani). Sayfada yoksa bunlar kullanılır; boş pakette ders kodu ve adı sayfada görünmez."),
         sayfaIpucu: z
             .object({ prolizMetni: z.boolean(), ingilizce: z.boolean() })
             .optional()

package/dist/apps/acik-mcp/src/kaynak-dogrula.js

@@ -127,11 +127,13 @@ export function yazarEslesir(sorgu, yazarlar) {
     });
 }
 // ---------------------------------------------------------------- Güvenli istek
-async function getir(f, adres) {
+async function getir(f, adres, hata) {
     if (adres.protocol !== "https:" || !IZINLI_HOSTLAR.includes(adres.hostname))
         throw new Error("İzinsiz host");
     if (adres.hostname === "www.googleapis.com" && !adres.pathname.startsWith("/books/"))
         throw new Error("İzinsiz yol");
+    if (adres.hostname === "openlibrary.org" && !OPENLIBRARY_YOLLARI.includes(adres.pathname))
+        throw new Error("İzinsiz yol");
     return sinirli(async () => {
         let y;
         try {
@@ -142,10 +144,13 @@ async function getir(f, adres) {
             });
         }
         catch {
+            hata?.();
             return null;
         }
-        if (!y.ok)
+        if (!y.ok) {
+            hata?.();
             return null;
+        }
         const uzunluk = Number(y.headers.get("content-length") ?? "0");
         if (uzunluk > EN_BUYUK_YANIT)
             return null;
@@ -211,6 +216,18 @@ const OpenLibraryKitap = z.object({
     publish_date: z.string().optional(),
 });
 const OpenLibraryYanit = z.record(z.string(), OpenLibraryKitap);
+const OpenLibraryAramaYanit = z.object({
+    docs: z
+        .array(z.object({
+        key: z.string().regex(/^\/works\/OL\d+W$/u),
+        title: z.string(),
+        author_name: z.array(z.string()).optional(),
+        publish_year: z.array(z.number().int()).optional(),
+        publisher: z.array(z.string()).optional(),
+        isbn: z.array(z.string()).optional(),
+    }))
+        .optional(),
+});
 const GoogleCilt = z.object({
     id: z.string(),
     volumeInfo: z.object({
@@ -301,6 +318,8 @@ function googleKunye(c) {
 // ---------------------------------------------------------------- Sorgular
 const CROSSREF = "https://api.crossref.org/works";
 const OPENLIBRARY = "https://openlibrary.org/api/books";
+const OPENLIBRARY_ARAMA = "https://openlibrary.org/search.json";
+const OPENLIBRARY_YOLLARI = ["/api/books", "/search.json"];
 const GOOGLE = "https://www.googleapis.com/books/v1/volumes";
 const KAYIT_ADI = {
     kitap: "kitap",
@@ -366,18 +385,12 @@ async function isbnIle(f, isbn) {
         : undefined;
     return c ? googleKunye(c) : null;
 }
+/**
+ * Başlık+yazar araması. Sıra: Crossref (makale), Open Library (kitap), Google Books (son çare).
+ * Google'a ulaşılamazsa (kota, HTTP hatası) o katalog atlanır ve bu durum bildirilir.
+ */
 async function baslikIle(f, baslik, yazar, s) {
     const uygun = (k) => baslikEslesir(baslik, k.baslik) && yazarEslesir(yazar, k.yazarlar) && ekDenetim(k, s) === null;
-    const g = new URL(GOOGLE);
-    g.searchParams.set("q", `intitle:${baslik} inauthor:${yazar}`);
-    g.searchParams.set("maxResults", "5");
-    const gy = GoogleYanit.safeParse(await getir(f, g));
-    if (gy.success)
-        for (const x of gy.data.items ?? []) {
-            const k = googleKunye(x);
-            if (baslikEslesir(baslik, x.volumeInfo.title) && uygun(k))
-                return k;
-        }
     const cr = new URL(CROSSREF);
     cr.searchParams.set("query.bibliographic", baslik);
     cr.searchParams.set("query.author", yazar);
@@ -387,9 +400,47 @@ async function baslikIle(f, baslik, yazar, s) {
         for (const e of cy.data.message.items) {
             const k = crossrefKunye(e);
             if (k && uygun(k))
-                return k;
+                return { k, googleUlasilamadi: false };
         }
-    return null;
+    if (s.tur === undefined || s.tur === "kitap" || s.tur === "herhangi") {
+        const ol = new URL(OPENLIBRARY_ARAMA);
+        ol.searchParams.set("title", baslik);
+        ol.searchParams.set("author", yazar);
+        ol.searchParams.set("limit", "10");
+        ol.searchParams.set("fields", "key,title,author_name,publish_year,publisher,isbn");
+        const oy = OpenLibraryAramaYanit.safeParse(await getir(f, ol));
+        if (oy.success)
+            for (const d of oy.data.docs ?? []) {
+                // Yıl verildiyse kaydın baskı yılları (publish_year) arasında geçmeli; ilk yayın yılı tek başına yetmez.
+                // Yıl verilmediyse künyeye yıl yazılmaz (hangi baskı olduğu bilinmez).
+                const yil = s.yil !== undefined && (d.publish_year ?? []).includes(s.yil) ? s.yil : undefined;
+                if (s.yil !== undefined && yil === undefined)
+                    continue;
+                const k = kur({
+                    tur: "kitap",
+                    yazarlar: d.author_name ?? [],
+                    baslik: d.title,
+                    ...(yil ? { yil } : {}),
+                    ...(d.publisher?.length === 1 && d.publisher[0] ? { yayinevi: d.publisher[0] } : {}),
+                }, `https://openlibrary.org${d.key}`, "Open Library");
+                if (uygun(k))
+                    return { k, googleUlasilamadi: false };
+            }
+    }
+    let googleUlasilamadi = false;
+    const g = new URL(GOOGLE);
+    g.searchParams.set("q", `intitle:${baslik} inauthor:${yazar}`);
+    g.searchParams.set("maxResults", "5");
+    const gy = GoogleYanit.safeParse(await getir(f, g, () => {
+        googleUlasilamadi = true;
+    }));
+    if (gy.success)
+        for (const x of gy.data.items ?? []) {
+            const k = googleKunye(x);
+            if (baslikEslesir(baslik, x.volumeInfo.title) && uygun(k))
+                return { k, googleUlasilamadi: false };
+        }
+    return { k: null, googleUlasilamadi };
 }
 const KaynakSorgusu = z
     .object({
@@ -421,11 +472,15 @@ export async function kaynakDogrula(f, k) {
             return bulunamadi("ISBN geçersiz (sağlama basamağı tutmuyor).");
         return sonla(await isbnIle(f, i), "isbn", { ...ek, tur: k.tur ?? "kitap" }, "Bu ISBN Open Library ve Google Books'ta bulunamadı.");
     }
-    return sonla(await baslikIle(f, k.baslik ?? "", k.yazar ?? "", ek), "baslik_yazar", ek, "Bu başlık ve yazarla (tam soyad, verildiyse tür ve yıl) eşleşen eser Google Books ve Crossref kataloglarında bulunamadı. Türkçe kitapların çoğu bu kataloglarda yoktur.");
+    const b = await baslikIle(f, k.baslik ?? "", k.yazar ?? "", ek);
+    return sonla(b.k, "baslik_yazar", ek, b.googleUlasilamadi
+        ? "Bu başlık ve yazarla (tam soyad, verildiyse tür ve yıl) eşleşen eser Crossref ve Open Library kataloglarında bulunamadı; Google Books'a ulaşılamadı (kota ya da bağlantı sorunu), orada aranamadı. Daha sonra yeniden deneyin ya da ISBN ile arayın."
+        : "Bu başlık ve yazarla (tam soyad, verildiyse tür ve yıl) eşleşen eser Crossref, Open Library ve Google Books kataloglarında bulunamadı. Türkçe kitapların çoğu bu kataloglarda yoktur.");
 }
 const KATALOG_KAYNAKLARI = [
     { ad: "Crossref REST API", adres: "https://api.crossref.org" },
     { ad: "Open Library Books API", adres: "https://openlibrary.org/developers/api" },
+    { ad: "Open Library Search API", adres: "https://openlibrary.org/dev/docs/api/search" },
     { ad: "Google Books API", adres: "https://developers.google.com/books" },
 ];
 export const kaynakDogrulaAraci = arac({

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

@@ -2,7 +2,7 @@ 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.8.1";
+export declare const SUNUCU_SURUMU = "0.8.2";
 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.";

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

@@ -6,7 +6,7 @@ import { ACIK_ARACLAR, AKREDIT_NOTU, AracHatasi, DEPO, } from "./araclar.js";
 import { GIRIS_BILGISI_ILETISI, girisBilgisiVar, kisiselVeriIletisi, kisiselVeriTurleri } from "./kisisel-veri.js";
 import { ACIK_ISTEMLER, AKILLI_DOLDURMA_KURALI, istemSemasi } from "./promptlar.js";
 export const SUNUCU_ADI = "akredit-acik";
-export const SUNUCU_SURUMU = "0.8.1";
+export const SUNUCU_SURUMU = "0.8.2";
 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.",
     "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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akredit/acik-mcp",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "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.",