@akredit/acik-mcp 0.4.0 → 0.5.0

package/dist/apps/acik-mcp/src/genel-ayristir.d.ts

@@ -1,9 +1,18 @@
-export type GenelAlan = "kod" | "ad" | "yariyil" | "tul" | "kredi" | "akts" | "dil" | "tur" | "onKosul" | "amac" | "icerik" | "yontem" | "notlar" | "ciktilar" | "haftalar" | "degerlendirme" | "isyuku" | "kaynaklar" | "kisi";
+export type GenelAlan = "kod" | "ad" | "yariyil" | "tul" | "kredi" | "akts" | "dil" | "tur" | "onKosul" | "amac" | "icerik" | "yontem" | "notlar" | "ciktilar" | "haftalar" | "degerlendirme" | "isyuku" | "kaynaklar" | "katki" | "dersYapisi" | "kisi";
 /** Bir hücre ya da satır başı bir etiket mi? Tam eşleşme (sondaki iki nokta ve parantez yok sayılır). */
 export declare function etiketAlani(s: string): GenelAlan | null;
 export type Satir = string[];
 /** HTML ya da düz metni satır ve hücrelere çevirir. Tablo hücreleri sekmeyle ayrılır. */
 export declare function satirlara(girdi: string): Satir[];
+/**
+ * Sekmeli satırlardan ÖÇ-PÇ katkı matrisi: başlıkta en az iki P kodu, altında Ö satırları. Değerler "1"-"5" ya da
+ * boş. Başlıkta satır etiketi sütunu yoksa veri satırları bir sütun kaydırılır. Bulunamazsa boş nesne.
+ */
+export declare function katkiMatrisi(satirlar: Satir[]): Record<string, Record<string, string>>;
+/** Sayfada İngilizce alan var mı (İngilizce etiket ya da "(İngilizce)" alanı). Bologna araçlarının ingilizce değeri. */
+export declare function ingilizceAlanVar(girdi: string): boolean;
+/** Proliz ders sayfasının düz metni mi (Ctrl+A, Ctrl+C)? */
+export declare function prolizMetniMi(girdi: string): boolean;
 export interface Bolum {
     alan: GenelAlan;
     /** Sayfadaki etiket, olduğu gibi (ör. "Dersi Verenler"). */

package/dist/apps/acik-mcp/src/genel-ayristir.js

@@ -4,6 +4,9 @@
 //
 // Kişi satırları (Dersi Veren, Instructor, e-posta, telefon) ayrıştırmadan önce bellekte atılır. Kaynaklar
 // bölümü künye olarak ayrı alınır (yazar adları yayımlanmış künyedir).
+//
+// Düz metin (dış inceleme 2026-11-05): tarayıcıda Ctrl+A, Ctrl+C ile kopyalanan sayfada tablolar sekmeyle ayrılır.
+// ÖÇ-PÇ katkı matrisi ve ders yapısı bu sekmeli metinden de okunur; Proliz sayfasının düz metni tanınır.
 import { metin as htmlMetni, sayi } from "../../../packages/baglayicilar/src/bologna-proliz/ayristir.js";
 /** Etiketler küçük harfle, Türkçe karakterle yazılır. Uzun etiket önce denenir. */
 const ETIKETLER = {
@@ -101,6 +104,19 @@ const ETIKETLER = {
         "recommended sources",
         "reading list",
     ],
+    katki: [
+        "program çıktısına katkı",
+        "program çıktısına katkısı",
+        "prg.çıktısına katkısı",
+        "prg. çıktısına katkısı",
+        "program çıktılarına katkı",
+        "dersin program çıktılarına katkısı",
+        "öğrenme çıktılarının program çıktılarına katkısı",
+        "ders öğrenme çıktıları ve program çıktıları ilişkisi",
+        "contribution to program outcomes",
+        "contribution of learning outcomes to programme outcomes",
+    ],
+    dersYapisi: ["ders yapısı", "dersin yapısı", "ders kategorisi", "course structure", "course category"],
     kisi: [
         "dersi veren",
         "dersi verenler",
@@ -157,6 +173,19 @@ function onekEtiketi(s) {
     const alan = etiketAlani(m[1]);
     return alan ? { alan, kalan: m[2] ?? "" } : null;
 }
+/** Program çıktısı kodu (P1, PÇ2, PO3) ve ders çıktısı kodu (Ö1, ÖÇ2, LO3) ya da "Tüm" satırı. */
+const P_KODU = /^(?:P|PÇ|PC|PO|PY)\s*-?\s*(\d{1,2})$/iu;
+const O_KODU = /^(?:Ö|ÖÇ|DÖÇ|LO|CLO|ÇK)\s*-?\s*(\d{1,2})$|^(Tüm|All)$/iu;
+/** Katkı matrisinin başlık ya da değer satırı mı? Böyle satırlarda boş hücre "-" olarak korunur (sütun hizası). */
+function matrisSatiri(h) {
+    if (h.filter((x) => P_KODU.test(x)).length >= 2)
+        return true;
+    const ilk = h.findIndex((x) => x !== "");
+    return (ilk >= 0 &&
+        O_KODU.test(h[ilk] ?? "") &&
+        h.length - ilk >= 3 &&
+        h.slice(ilk + 1).every((x) => x === "" || /^[1-5-]$/u.test(x)));
+}
 /** HTML ya da düz metni satır ve hücrelere çevirir. Tablo hücreleri sekmeyle ayrılır. */
 export function satirlara(girdi) {
     const htmlMi = /<\/?(table|tr|td|th|p|div|br|li|h\d|body|span)\b/iu.test(girdi);
@@ -174,11 +203,51 @@ export function satirlara(girdi) {
         : girdi;
     return duz
         .split(/\r?\n/u)
-        .map((s) => s
-        .split("\t")
-        .map((h) => h.replace(/\s+/gu, " ").trim())
-        .filter(Boolean))
-        .filter((r) => r.length > 0);
+        .map((s) => {
+        const h = s.split("\t").map((x) => x.replace(/\s+/gu, " ").trim());
+        return matrisSatiri(h) ? h.map((x) => x || "-") : h.filter(Boolean);
+    })
+        .filter((r) => r.some((x) => x && x !== "-"));
+}
+/**
+ * Sekmeli satırlardan ÖÇ-PÇ katkı matrisi: başlıkta en az iki P kodu, altında Ö satırları. Değerler "1"-"5" ya da
+ * boş. Başlıkta satır etiketi sütunu yoksa veri satırları bir sütun kaydırılır. Bulunamazsa boş nesne.
+ */
+export function katkiMatrisi(satirlar) {
+    for (let i = 0; i < satirlar.length; i++) {
+        const baslik = satirlar[i] ?? [];
+        const sutunlar = baslik
+            .map((h, j) => ({ j, m: h.match(P_KODU) }))
+            .filter((x) => x.m !== null);
+        if (sutunlar.length < 2)
+            continue;
+        const kayma = P_KODU.test(baslik[0] ?? "") ? 1 : 0;
+        const sonuc = {};
+        for (let k = i + 1; k < satirlar.length; k++) {
+            const r = satirlar[k] ?? [];
+            const m = (r[0] ?? "").match(O_KODU);
+            if (!m)
+                break;
+            const anahtar = m[2] ? "Tüm" : `Ö${Number(m[1])}`;
+            sonuc[anahtar] = Object.fromEntries(sutunlar.map(({ j, m: pm }) => {
+                const v = (r[j + kayma] ?? "").trim();
+                return [`P${Number(pm[1])}`, /^[1-5]$/u.test(v) ? v : ""];
+            }));
+        }
+        if (Object.keys(sonuc).length)
+            return sonuc;
+    }
+    return {};
+}
+const INGILIZCE_ALAN = /\b(course objectives?|learning outcomes|course contents?|weekly (topics|schedule|subjects)|ects workload|assessment methods?|teaching methods|course description)\b|\(\s*([iİ]ngilizce|english)\s*\)|[iİ]ngilizce (amaç|içerik|adı)/iu;
+/** Sayfada İngilizce alan var mı (İngilizce etiket ya da "(İngilizce)" alanı). Bologna araçlarının ingilizce değeri. */
+export function ingilizceAlanVar(girdi) {
+    return INGILIZCE_ALAN.test(girdi.slice(0, 400_000));
+}
+const PROLIZ_METNI = /Yarıyıl\s*\t\s*Kodu|Prg\.\s*Çıktısına\s*Katkısı|Sür\.\s*Kalkınma\s*Amaçları|Semester\s*\t\s*Code/iu;
+/** Proliz ders sayfasının düz metni mi (Ctrl+A, Ctrl+C)? */
+export function prolizMetniMi(girdi) {
+    return !/<\/?(table|tr|td)\b/iu.test(girdi) && PROLIZ_METNI.test(girdi);
 }
 /**
  * Satırları etiketli bölümlere ayırır. Başlık satırı (bütün hücreleri etiket olan) bir sonraki satırla
@@ -277,6 +346,8 @@ const ALAN_ADI = {
     degerlendirme: "Değerlendirme",
     isyuku: "AKTS iş yükü",
     kaynaklar: "Kaynaklar",
+    katki: "Program çıktısına katkı",
+    dersYapisi: "Ders yapısı",
 };
 export const GENEL_ALAN_ADLARI = ALAN_ADI;
 const sayilar = (s) => [...s.replace(/(\d),(\d)/gu, "$1.$2").matchAll(/(?<![\p{L}\d])%?\s*(\d+(?:\.\d+)?)/gu)].map((m) => Number(m[1]));
@@ -360,6 +431,11 @@ export function genelAyristir(girdi, kaynakSayisi = 0) {
             toplam: n.length >= 3 ? (n[2] ?? null) : s !== null && sure !== null ? s * sure : null,
         };
     });
+    const katki = katkiMatrisi(satirlar);
+    const dersYapisi = satirTablosu("dersYapisi")
+        .map(adVeSayilar)
+        .filter((x) => x.ad && /\p{L}/u.test(x.ad) && x.n.length >= 1 && !TOPLAM.test(x.ad))
+        .map(({ ad, n }) => ({ alan: ad, yuzde: n.at(-1) ?? null }));
     const bilgiler = {
         ...(tekDeger("dil") ? { dil: tekDeger("dil") } : {}),
         ...(tekDeger("tur") ? { tur: tekDeger("tur") } : {}),
@@ -379,10 +455,10 @@ export function genelAyristir(girdi, kaynakSayisi = 0) {
         ciktilar,
         degerlendirme,
         isyuku,
-        dersYapisi: [],
+        dersYapisi,
         haftalar: haftaKonulari.length,
         haftaKonulari,
-        katki: {},
+        katki,
     };
     const varMi = {
         kod: Boolean(ders.kod),
@@ -402,6 +478,8 @@ export function genelAyristir(girdi, kaynakSayisi = 0) {
         degerlendirme: degerlendirme.length > 0,
         isyuku: isyuku.length > 0,
         kaynaklar: kaynakSayisi > 0,
+        katki: Object.keys(katki).length > 0,
+        dersYapisi: dersYapisi.length > 0,
     };
     const bulunan = Object.keys(varMi).filter((k) => varMi[k]);
     const bulunamayan = Object.keys(varMi).filter((k) => !varMi[k]);

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

@@ -17,11 +17,29 @@ export interface AcikHttpSecenekleri {
     };
     /** Günlük yazıcı. Varsayılan: stdout'a tek satır JSON. */
     gunluk?: (k: GunlukKaydi) => void;
-    /** Ters vekilin yazdığı istemci adresi başlığı. Varsayılan x-forwarded-for. */
-    adresBasligi?: string;
+    /**
+     * x-forwarded-for listesinde sondan kaç öğenin güvenilen vekillerce yazıldığı. Varsayılan 1: istemci adresi
+     * listenin son öğesidir (vekil gerçek adresi sona ekler; baştaki öğeler istemcinin kendi yazdığıdır, sahtelenebilir).
+     */
+    guvenilenVekil?: number;
+    /** kaynak_dogrula için adres başına ayrı kova (dış katalog sorgusu pahalıdır). Varsayılan dakikada 5. */
+    kaynakHizi?: {
+        kapasite: number;
+        saniyede: number;
+    };
 }
+/**
+ * İstemci adresi. Sıra: cf-connecting-ip (Cloudflare yazar, istemci değiştiremez), x-real-ip (ters vekil yazar),
+ * x-forwarded-for'un sondan `guvenilenVekil`. öğesi. İlk öğe asla kullanılmaz: istemci onu istediği gibi yazabilir.
+ * Not: cf-connecting-ip'ye ancak köken sunucuya yalnız Cloudflare üzerinden erişiliyorsa güvenilebilir.
+ */
+export declare function istemciAdresi(basliklar: Headers, guvenilenVekil?: number): string;
 export declare const CORS_BASLIKLARI: Record<string, string>;
-/** Süreç içi kova. Adres sayısı sınırlıdır; dolan tablo en eski kayıtlardan boşaltılır. */
+/**
+ * Süreç içi kova. Adres sayısı sınırlıdır. Tablo dolunca önce süresi geçmiş (jetonu yeniden dolmuş, yani yeni
+ * gelen bir adresle aynı durumdaki) kayıtlar silinir; yine doluysa yeni adres reddedilir. Böylece çok sayıda sahte
+ * adresle eski kayıtları itip gerçek adreslerin sayacı sıfırlanamaz.
+ */
 export declare class AdresKovasi {
     private kovalar;
     private kapasite;
@@ -32,5 +50,15 @@ export declare class AdresKovasi {
         izin: boolean;
         bekle: number;
     };
+    /** Jetonu yeniden kapasiteye dolmuş kayıtları siler. */
+    temizle(simdiMs: number): void;
+    get boyut(): number;
 }
+/** Gövdeyi bayt sayarak okur; sınır aşılınca akışı iptal eder. content-length olmasa da (chunked) bellek sınırlı kalır. */
+export declare function govdeOku(istek: Request, enBuyuk: number): Promise<{
+    tur: "tamam";
+    tampon: Uint8Array;
+} | {
+    tur: "buyuk";
+}>;
 export declare function acikMcpIsleyici(s?: AcikHttpSecenekleri): (istek: Request) => Promise<Response>;

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

@@ -6,6 +6,26 @@
 // Sınırlar: gövde en çok 512 KB; adres başına kova (varsayılan 60 istek, saniyede 1 dolar).
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 import { acikSunucu } from "./sunucu.js";
+/**
+ * İstemci adresi. Sıra: cf-connecting-ip (Cloudflare yazar, istemci değiştiremez), x-real-ip (ters vekil yazar),
+ * x-forwarded-for'un sondan `guvenilenVekil`. öğesi. İlk öğe asla kullanılmaz: istemci onu istediği gibi yazabilir.
+ * Not: cf-connecting-ip'ye ancak köken sunucuya yalnız Cloudflare üzerinden erişiliyorsa güvenilebilir.
+ */
+export function istemciAdresi(basliklar, guvenilenVekil = 1) {
+    const cf = basliklar.get("cf-connecting-ip")?.trim();
+    if (cf)
+        return cf.slice(0, 64);
+    const gercek = basliklar.get("x-real-ip")?.trim();
+    if (gercek)
+        return gercek.slice(0, 64);
+    const liste = (basliklar.get("x-forwarded-for") ?? "")
+        .split(",")
+        .map((x) => x.trim())
+        .filter(Boolean);
+    const n = Math.max(1, Math.floor(guvenilenVekil));
+    const adres = liste.length >= n ? liste[liste.length - n] : undefined;
+    return adres ? adres.slice(0, 64) : "bilinmeyen";
+}
 export const CORS_BASLIKLARI = {
     "access-control-allow-origin": "*",
     "access-control-allow-methods": "POST, GET, OPTIONS",
@@ -18,7 +38,11 @@ const json = (govde, durum, ek = {}) => new Response(JSON.stringify(govde), {
     headers: { "content-type": "application/json; charset=utf-8", ...CORS_BASLIKLARI, ...ek },
 });
 const rpcHata = (durum, code, message, ek = {}) => json({ jsonrpc: "2.0", id: null, error: { code, message } }, durum, ek);
-/** Süreç içi kova. Adres sayısı sınırlıdır; dolan tablo en eski kayıtlardan boşaltılır. */
+/**
+ * Süreç içi kova. Adres sayısı sınırlıdır. Tablo dolunca önce süresi geçmiş (jetonu yeniden dolmuş, yani yeni
+ * gelen bir adresle aynı durumdaki) kayıtlar silinir; yine doluysa yeni adres reddedilir. Böylece çok sayıda sahte
+ * adresle eski kayıtları itip gerçek adreslerin sayacı sıfırlanamaz.
+ */
 export class AdresKovasi {
     kovalar = new Map();
     kapasite;
@@ -32,11 +56,10 @@ export class AdresKovasi {
     al(adres, simdiMs) {
         let k = this.kovalar.get(adres);
         if (!k) {
-            if (this.kovalar.size >= this.enCokAdres) {
-                const ilk = this.kovalar.keys().next().value;
-                if (ilk !== undefined)
-                    this.kovalar.delete(ilk);
-            }
+            if (this.kovalar.size >= this.enCokAdres)
+                this.temizle(simdiMs);
+            if (this.kovalar.size >= this.enCokAdres)
+                return { izin: false, bekle: Math.ceil(1 / this.saniyede) };
             k = { jeton: this.kapasite, son: simdiMs };
             this.kovalar.set(adres, k);
         }
@@ -47,6 +70,44 @@ export class AdresKovasi {
         k.jeton -= 1;
         return { izin: true, bekle: 0 };
     }
+    /** Jetonu yeniden kapasiteye dolmuş kayıtları siler. */
+    temizle(simdiMs) {
+        for (const [a, k] of this.kovalar)
+            if (k.jeton + ((simdiMs - k.son) / 1000) * this.saniyede >= this.kapasite)
+                this.kovalar.delete(a);
+    }
+    get boyut() {
+        return this.kovalar.size;
+    }
+}
+/** Gövdeyi bayt sayarak okur; sınır aşılınca akışı iptal eder. content-length olmasa da (chunked) bellek sınırlı kalır. */
+export async function govdeOku(istek, enBuyuk) {
+    const uzunluk = Number(istek.headers.get("content-length") ?? "0");
+    if (uzunluk > enBuyuk)
+        return { tur: "buyuk" };
+    if (!istek.body)
+        return { tur: "tamam", tampon: new Uint8Array(0) };
+    const okuyucu = istek.body.getReader();
+    const parcalar = [];
+    let toplam = 0;
+    for (;;) {
+        const { done, value } = await okuyucu.read();
+        if (done)
+            break;
+        toplam += value.byteLength;
+        if (toplam > enBuyuk) {
+            await okuyucu.cancel().catch(() => { });
+            return { tur: "buyuk" };
+        }
+        parcalar.push(value);
+    }
+    const tampon = new Uint8Array(toplam);
+    let i = 0;
+    for (const p of parcalar) {
+        tampon.set(p, i);
+        i += p.byteLength;
+    }
+    return { tur: "tamam", tampon };
 }
 /** Gövdeden günlüğe yazılacak tek bilgi: yöntem ve (tools/call ya da prompts/get ise) araç ya da istem adı. İçerik okunmaz. */
 function yontemVeArac(govde) {
@@ -68,7 +129,8 @@ export function acikMcpIsleyici(s = {}) {
     const enBuyuk = s.enBuyukGovde ?? 512 * 1024;
     const kova = new AdresKovasi(s.hiz?.kapasite ?? 60, s.hiz?.saniyede ?? 1);
     const gunluk = s.gunluk ?? ((k) => console.info(JSON.stringify({ olay: "acik_mcp", ...k })));
-    const adresBasligi = s.adresBasligi ?? "x-forwarded-for";
+    const guvenilenVekil = s.guvenilenVekil ?? 1;
+    const kaynakKovasi = new AdresKovasi(s.kaynakHizi?.kapasite ?? 5, s.kaynakHizi?.saniyede ?? 5 / 60);
     return async (istek) => {
         const bas = performance.now();
         let kayit = { yontem: istek.method, arac: null, boyut: 0 };
@@ -89,20 +151,17 @@ export function acikMcpIsleyici(s = {}) {
             return bitir(json({
                 hata: "Bu adres bir MCP sunucusudur. Yapay zekâ istemcinize bağlayıcı olarak ekleyin: https://akredit.org/mcp-kullan",
             }, 405, { allow: "POST, OPTIONS" }));
-        const adres = (istek.headers.get(adresBasligi) ?? "").split(",")[0]?.trim() || "bilinmeyen";
+        const adres = istemciAdresi(istek.headers, guvenilenVekil);
         const h = kova.al(adres, simdi().getTime());
         if (!h.izin)
             return bitir(rpcHata(429, -32000, "Çok fazla istek. Biraz bekleyip yeniden deneyin.", { "retry-after": String(h.bekle) }));
-        const uzunluk = Number(istek.headers.get("content-length") ?? "0");
-        if (uzunluk > enBuyuk)
-            return bitir(rpcHata(413, -32600, "İstek çok büyük. Veriyi bölerek gönderin."));
         let metin;
         try {
-            const tampon = await istek.arrayBuffer();
-            kayit.boyut = tampon.byteLength;
-            if (tampon.byteLength > enBuyuk)
+            const g = await govdeOku(istek, enBuyuk);
+            if (g.tur === "buyuk")
                 return bitir(rpcHata(413, -32600, "İstek çok büyük. Veriyi bölerek gönderin."));
-            metin = new TextDecoder().decode(tampon);
+            kayit.boyut = g.tampon.byteLength;
+            metin = new TextDecoder().decode(g.tampon);
         }
         catch {
             return bitir(rpcHata(400, -32700, "İstek okunamadı."));
@@ -115,6 +174,18 @@ export function acikMcpIsleyici(s = {}) {
             return bitir(rpcHata(400, -32700, "İleti JSON değil."));
         }
         kayit = { ...kayit, ...yontemVeArac(govde) };
+        // Dış katalog sorgusu yapan araç için adres başına ayrı, sıkı kota (toplu istekte her çağrı sayılır).
+        const kaynakCagrisi = (Array.isArray(govde) ? govde : [govde]).filter((x) => x &&
+            typeof x === "object" &&
+            x.method === "tools/call" &&
+            x.params?.name === "kaynak_dogrula").length;
+        for (let i = 0; i < kaynakCagrisi; i++) {
+            const k = kaynakKovasi.al(adres, simdi().getTime());
+            if (!k.izin)
+                return bitir(rpcHata(429, -32000, "Kaynak doğrulama için kısa sürede çok fazla istek geldi. Bir dakika bekleyip yeniden deneyin.", {
+                    "retry-after": String(k.bekle),
+                }));
+        }
         const sunucu = acikSunucu({ simdi });
         const tasima = new WebStandardStreamableHTTPServerTransport({
             sessionIdGenerator: undefined,

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

@@ -3,6 +3,7 @@ export * from "./bologna.ts";
 export * from "./genel-ayristir.ts";
 export * from "./http.ts";
 export * from "./kaynak.ts";
+export * from "./kaynak-dogrula.ts";
 export * from "./kisisel-veri.ts";
 export * from "./not-tablosu.ts";
 export * from "./promptlar.ts";

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

@@ -5,6 +5,7 @@ export * from "./bologna.js";
 export * from "./genel-ayristir.js";
 export * from "./http.js";
 export * from "./kaynak.js";
+export * from "./kaynak-dogrula.js";
 export * from "./kisisel-veri.js";
 export * from "./not-tablosu.js";
 export * from "./promptlar.js";

package/dist/apps/acik-mcp/src/kaynak-dogrula.d.ts

@@ -2,29 +2,62 @@ import { z } from "zod";
 export declare const IZINLI_HOSTLAR: readonly ["api.crossref.org", "openlibrary.org", "www.googleapis.com"];
 export declare const ZAMAN_ASIMI_MS = 8000;
 export declare const EN_BUYUK_YANIT = 1000000;
+/** Çağrı başına en çok kaynak. */
+export declare const EN_COK_KAYNAK = 5;
+/** Süreç genelinde aynı anda en çok dış istek. */
+export declare const ESZAMANLI_DIS_ISTEK = 4;
+/** Süreç genelindeki dış istek semaforu. Sınır doluysa sıra bekler. */
+export declare function sinirli<T>(is: () => Promise<T>): Promise<T>;
+/** Katalog kaydının imzası: künye ve bağlantı üzerinden HMAC-SHA256 (ilk 32 onaltılık hane). */
+export declare function kaynakImzasi(kunye: string, baglanti: string): string;
+/** İmza bu sürecin kaynak_dogrula çıktısına mı ait? */
+export declare function kaynakImzasiDogru(kunye: string, baglanti: string, imza: string): boolean;
 /** "https://doi.org/10.x/y", "doi:10.x/y" ya da "10.x/y" → "10.x/y". Geçersizse null. */
 export declare function doiTemizle(d: string): string | null;
 /** ISBN-10 ya da ISBN-13; tire ve boşluk atılır, denetim basamağı sınanır. Geçersizse null. */
 export declare function isbnTemizle(i: string): string | null;
 /** Karşılaştırma için sadeleştirme: küçük harf, Türkçe harfler düz, noktalama yok. */
 export declare function sadele(s: string): string[];
-/** Sorgu başlığının sözcüklerinin en az %80'i bulunan başlıkta var mı, ve bulunanın en az %60'ı sorguda var mı. */
+/**
+ * Sorgu başlığının sözcüklerinin en az %80'i bulunan başlıkta var mı, ve bulunanın en az %60'ı sorguda var mı.
+ * Kısa (en çok iki sözcüklü) başlıklarda ("Veri Yapıları", "Genel Kimya") sözcük kümeleri birebir aynı olmalı.
+ */
 export declare function baslikEslesir(sorgu: string, bulunan: string): boolean;
-/** Sorgudaki yazar soyadı (son sözcük ya da virgülden önceki kısım) bulunan yazarlardan birinde geçiyor mu. */
+/**
+ * Sorgudaki yazar soyadı (son sözcük ya da virgülden önceki kısım) bulunan yazarlardan birinde TAM belirteç olarak
+ * geçiyor mu. Alt dize yetmez: "Yılmaz" sorgusu "Yılmazer" ile eşleşmez.
+ */
 export declare function yazarEslesir(sorgu: string, yazarlar: string[]): boolean;
+/** Yanıt gövdesini bayt sayarak okur; sınır aşılırsa akışı iptal edip null döner. */
+export declare function sinirliMetin(y: Response, enBuyuk: number): Promise<string | null>;
+export type KayitTuru = "kitap" | "makale" | "kitap_bolumu" | "diger";
 export interface Dogrulanmis {
-    durum: "dogrulandi";
+    durum: "katalogda_bulundu";
     kunye: string;
     eksikler: string[];
     baglanti: string;
     katalog: "Crossref" | "Open Library" | "Google Books";
+    kayitTuru: KayitTuru;
     baslik: string;
     yazarlar: string[];
     yil?: number | string;
+    /** Neyle eşleşti: DOI, ISBN ya da başlık + tam soyad (+ yıl, tür). */
+    kimlik_eslesmesi: {
+        yontem: "doi" | "isbn" | "baslik_yazar";
+        denetlenen: string[];
+    };
+    /** Künyede eksik alan var mı (yayınevi, yıl...). Eksik alan [EKSİK] kalır. */
+    bibliyografik_tamlik: "tam" | "eksik";
+    /** Katalogda bulunmak, ders kaynağı olarak uygun olmak demek değildir. */
+    ders_kaynagi_uygunlugu: "hoca karar verir";
+    /** Bologna araçlarında doğrulanmış kaynak kanıtı. */
+    imza: string;
 }
 export interface Dogrulanamadi {
-    durum: "dogrulanamadi";
+    durum: "bulunamadi";
     neden: string;
+    /** Hoca eseri kendisi biliyorsa yalnız "hoca_beyani" etiketiyle yazılabilir. */
+    hocaBeyani: string;
 }
 export type DogrulamaSonucu = Dogrulanmis | Dogrulanamadi;
 declare const KaynakSorgusu: z.ZodObject<{
@@ -32,6 +65,13 @@ declare const KaynakSorgusu: z.ZodObject<{
     isbn: z.ZodOptional<z.ZodString>;
     baslik: z.ZodOptional<z.ZodString>;
     yazar: z.ZodOptional<z.ZodString>;
+    tur: z.ZodOptional<z.ZodEnum<{
+        kitap: "kitap";
+        makale: "makale";
+        kitap_bolumu: "kitap_bolumu";
+        herhangi: "herhangi";
+    }>>;
+    yil: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type KaynakSorgusuT = z.infer<typeof KaynakSorgusu>;
 /** Tek kaynağı doğrular. DOI önce, sonra ISBN, sonra başlık+yazar. */
@@ -42,6 +82,13 @@ export declare const kaynakDogrulaAraci: import("./temel.ts").AcikArac<z.ZodObje
         isbn: z.ZodOptional<z.ZodString>;
         baslik: z.ZodOptional<z.ZodString>;
         yazar: z.ZodOptional<z.ZodString>;
+        tur: z.ZodOptional<z.ZodEnum<{
+            kitap: "kitap";
+            makale: "makale";
+            kitap_bolumu: "kitap_bolumu";
+            herhangi: "herhangi";
+        }>>;
+        yil: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>>;
 export {};